Composio powers 1000+ toolkits, tool search, context management, authentication, and a sandboxed workbench to help you build AI agents that turn intent into action.
feat(sdk): expose custom toolkits outside the experimental namespace (PLEN-4879)
Custom toolkits are no longer experimental: add composio.customToolkits (TS) and composio.custom_toolkits (Python). The experimental paths are deprecated aliases of the same object. Drops the pilot wording from docstrings and regenerates the TypeScript SDK reference. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01H6YzWpsJUx7GVXrFfgStg6
Bharath committed
Nov 10, 2026 at 05:03 UTC
6f8a704f1640d2ffef58d17f406bf232a2ccb3f6
14 files changed
+96
-71
.changeset/custom-toolkits-top-level.md
new
+7
@@ -0,0 +1,7 @@
1
+---
2
+'@composio/core': minor
3
+'@composio/slim': minor
4
+'@composio/python-sdk': minor
5
+---
6
+
7
+Custom toolkits are no longer experimental. Use `composio.customToolkits` in TypeScript and `composio.custom_toolkits` in Python. `composio.experimental.customToolkits` and `composio.experimental.custom_toolkits` are deprecated aliases of the same object and keep working. Python also exports the class as `CustomToolkits`; `ExperimentalCustomToolkits` stays as an alias.
docs/content/reference/sdk-reference/typescript/composio.mdx
+1
@@ -54,6 +54,7 @@ const composio = new Composio({
54
| `authConfigs` | `AuthConfigs` | Manage authentication configurations for toolkits |
55
| `connectedAccounts` | `ConnectedAccounts` | Manage authenticated connections |
56
| `create` | `(...) => Promise<Session>` | Creates a new tool router session for a user. Use `sessionPreset: SessionPreset.DIRECT_TOOLS` when all needed tools should be exposed directly; see `ToolRouterCreateSessionConfig`. |
57
+| `customToolkits` | `CustomToolkits` | Register and manage project-owned custom toolkits, such as a remote MCP server (`create()` / `update()` / `sync()` / `delete()`). |
58
| `experimental` | `Experimental` | Experimental SDK methods whose shape may change in future releases. Prefer domain-specific mounts (for example `composio.connectedAccounts.updateAcl(...)`) when available; this namespace keeps compatibility aliases while APIs are experimental. Stateless experimental factories (e.g. `experimental_createTool`) stay at the top level. |
59
| `files` | `Files` | Upload and download files |
60
| `keyring` | `Keyring` | Public transfer keys of the organization's customer-managed keyring |
docs/content/reference/sdk-reference/typescript/custom-toolkits.mdx
+6
-11
@@ -1,6 +1,6 @@
1
---
2
title: "CustomToolkits"
3
-description: "`composio.experimental.customToolkits` — toolkits your project registers from its own app or MCP server, with their own auth configs and connected accounts. **Experimental — custom toolkits are in pilot; shape may change.** These live on the Composio platform. They are unrelated to the in-process toolkits built with `experimental_createToolkit()`, which run inside your application."
3
+description: "`composio.customToolkits` — toolkits your project registers from its own app or MCP server, with their own auth configs and connected accounts. These live on the Composio platform. They are unrelated to the in-process toolkits built with `experimental_createToolkit()`, which run inside your application."
4
---
5
6
## Usage
@@ -17,7 +17,6 @@ const result = await composio.customToolkits.list();
17
### create()
18
19
Creates a custom MCP toolkit and returns its generated slug.
20
-**Experimental — custom toolkits are in pilot; shape may change.**
20
21
Set `userId` to `'all'` to share the toolkit with every user in the
22
project, or to a user ID to make it private to that user. `mcpUrl`,
@@ -43,7 +42,7 @@ async create(params: CustomToolkitCreateParams, requestOptions?: ComposioRequest
42
**Example**
43
44
```typescript
46
-const { slug, connectLink } = await composio.experimental.customToolkits.create({
45
+const { slug, connectLink } = await composio.customToolkits.create({
46
name: 'Internal API',
47
mcpUrl: 'https://mcp.internal.example.com/mcp',
48
authSchemes: [
@@ -60,7 +59,6 @@ const { slug, connectLink } = await composio.experimental.customToolkits.create(
59
Deletes a custom toolkit owned by the project, with its tools, auth
60
configs and connected accounts. The credentials behind those connected
61
accounts are revoked in background jobs (`revokeJobIds`).
63
-**Experimental — custom toolkits are in pilot; shape may change.**
62
63
Composio-managed toolkits cannot be deleted; the API answers 403.
64
@@ -82,7 +80,7 @@ async delete(slug: string, requestOptions?: ComposioRequestOptions): Promise<Cus
80
**Example**
81
82
```typescript
85
-const result = await composio.experimental.customToolkits.delete('CUSTOM_MY_TOOLKIT');
83
+const result = await composio.customToolkits.delete('CUSTOM_MY_TOOLKIT');
84
console.log(result.connectedAccountsDeleted);
85
```
86
@@ -92,7 +90,6 @@ console.log(result.connectedAccountsDeleted);
90
91
Re-fetches the tool definitions of a custom toolkit from its remote MCP
92
server. Call it when automatic sync fails or the remote tools change.
95
-**Experimental — custom toolkits are in pilot; shape may change.**
93
94
```typescript
95
async sync(slug: string, params?: CustomToolkitSyncParams, requestOptions?: ComposioRequestOptions): Promise<CustomToolkitSyncResponse>
@@ -113,7 +110,7 @@ async sync(slug: string, params?: CustomToolkitSyncParams, requestOptions?: Comp
110
**Example**
111
112
```typescript
116
-const { version, syncedCount } = await composio.experimental.customToolkits.sync(
113
+const { version, syncedCount } = await composio.customToolkits.sync(
114
'CUSTOM_MY_TOOLKIT',
115
{ connectedAccountId: 'ca_abc123' }
116
);
@@ -125,7 +122,6 @@ const { version, syncedCount } = await composio.experimental.customToolkits.sync
122
123
Updates a custom toolkit's name, logo or API key field copy. Omitted
124
fields keep their current value.
128
-**Experimental — custom toolkits are in pilot; shape may change.**
125
126
On a project with 2FA enabled, updating a private toolkit requires the
127
`userId` it is private to.
@@ -149,7 +145,7 @@ async update(slug: string, params: CustomToolkitUpdateParams, requestOptions?: C
145
**Example**
146
147
```typescript
152
-await composio.experimental.customToolkits.update('CUSTOM_INTERNAL_API_K7F2Q', {
148
+await composio.customToolkits.update('CUSTOM_INTERNAL_API_K7F2Q', {
149
name: 'Internal API (prod)',
150
userId: 'user_123',
151
});
@@ -167,7 +163,6 @@ Use `create()` for a new toolkit and `update(slug, ...)` to change
163
164
Creates a custom toolkit, or updates its display metadata (name, API key
165
field copy) when the project already owns a toolkit with this slug.
170
-**Experimental — custom toolkits are in pilot; shape may change.**
166
167
`mcpUrl` and `authSchemes` cannot change on an existing toolkit:
168
re-sending them unchanged is a no-op, and changing them fails with a 409.
@@ -191,7 +186,7 @@ async upsert(params: CustomToolkitUpsertParams, requestOptions?: ComposioRequest
186
**Example**
187
188
```typescript
194
-await composio.experimental.customToolkits.upsert({
189
+await composio.customToolkits.upsert({
190
slug: 'INTERNAL_API',
191
toolkitConfig: {
192
name: 'Internal API',
docs/content/reference/sdk-reference/typescript/experimental.mdx
+1
-1
@@ -16,7 +16,7 @@ const result = await composio.experimental.list();
16
17
| Name | Type | Description |
18
|------|------|-------------|
19
-| `customToolkits` | `CustomToolkits` | Register and manage project-owned custom toolkits (`create()` / `update()` / `sync()` / `delete()`). **Experimental — custom toolkits are in pilot; shape may change.** |
19
+| `customToolkits` | `CustomToolkits` | Same object as `composio.customToolkits`. |
20
| `usage` | `Usage` | Project-scoped usage metering (`summary()` / `breakdown()`). **Experimental — shape may change in future releases.** |
21
22
## Methods
docs/content/reference/sdk-reference/typescript/index.mdx
+1
-1
@@ -14,7 +14,7 @@ description: "Complete API reference for the Composio TypeScript SDK (@composio/
14
| [`Composio`](/reference/sdk-reference/typescript/composio) | This is the core class for Composio. |
15
| [`AuthConfigs`](/reference/sdk-reference/typescript/auth-configs) | AuthConfigs class |
16
| [`ConnectedAccounts`](/reference/sdk-reference/typescript/connected-accounts) | ConnectedAccounts class |
17
-| [`CustomToolkits`](/reference/sdk-reference/typescript/custom-toolkits) | `composio.experimental.customToolkits` — toolkits your project registers |
17
+| [`CustomToolkits`](/reference/sdk-reference/typescript/custom-toolkits) | `composio.customToolkits` — toolkits your project registers |
18
| [`Keyring`](/reference/sdk-reference/typescript/keyring) | `composio.keyring` — the organization's customer-managed keyring. |
19
| [`Logs`](/reference/sdk-reference/typescript/logs) | `composio.logs` — tool-execution logs. |
20
| [`SessionConfigs`](/reference/sdk-reference/typescript/session-configs) | `composio.sessionConfigs` — saved, reusable Session configs. |
python/composio/core/models/__init__.py
+2
@@ -15,6 +15,7 @@ from .custom_tool_types import (
15
ToolRouterSessionProxyExecuteResponse,
16
)
17
from .experimental import (
18
+ CustomToolkits,
19
ExperimentalAPI,
20
ExperimentalCustomToolkits,
21
ExperimentalUsage,
@@ -61,6 +62,7 @@ __all__ = [
62
"ConnectionState",
63
"ConnectionStatusEnum",
64
"CustomTool",
65
+ "CustomToolkits",
66
"ExperimentalAPI",
67
"ExperimentalCustomToolkits",
68
"ExperimentalToolkit",
python/composio/core/models/experimental.py
+19
-20
@@ -135,7 +135,7 @@ class ExperimentalUsage:
135
136
137
_UPSERT_DEPRECATION = (
138
- "experimental.custom_toolkits.upsert() is deprecated. Use create() for a "
138
+ "custom_toolkits.upsert() is deprecated. Use create() for a "
139
"new toolkit and update(slug, ...) to change its name, logo or API key field."
140
)
141
@@ -143,11 +143,9 @@ _UPSERT_DEPRECATION = (
143
_upsert_warning_emitted = False
144
145
146
-class ExperimentalCustomToolkits:
147
- """Project-owned custom toolkits, accessed via
148
- ``composio.experimental.custom_toolkits``.
146
+class CustomToolkits:
147
+ """Project-owned custom toolkits, accessed via ``composio.custom_toolkits``.
148
150
- Experimental — custom toolkits are in pilot and the shape may change.
149
These toolkits are registered in your Composio project from your own app
150
or MCP server, with their own auth configs and connected accounts. They
151
are unrelated to the in-process toolkits built with
@@ -162,8 +160,8 @@ class ExperimentalCustomToolkits:
160
161
if self._client is None:
162
raise exceptions.ValidationError(
165
- "experimental.custom_toolkits requires a Composio client. Access "
166
- "it via composio.experimental.custom_toolkits.create(...)."
163
+ "custom_toolkits requires a Composio client. Access it via "
164
+ "composio.custom_toolkits.create(...)."
165
)
166
return self._client
167
@@ -173,7 +171,6 @@ class ExperimentalCustomToolkits:
171
) -> custom_create_toolkit_response.CustomCreateToolkitResponse:
172
"""
173
Create a custom MCP toolkit and return its generated slug.
176
- Experimental — shape may change.
174
175
Set ``user_id`` to ``"all"`` to share the toolkit with every user in
176
the project, or to a user ID to make it private to that user.
@@ -191,7 +188,7 @@ class ExperimentalCustomToolkits:
188
``connect_link`` to send that user to (else ``None``).
189
190
Example:
194
- toolkit = composio.experimental.custom_toolkits.create(
191
+ toolkit = composio.custom_toolkits.create(
192
name="Internal API",
193
mcp_url="https://mcp.internal.example.com/mcp",
194
auth_schemes=[
@@ -212,7 +209,7 @@ class ExperimentalCustomToolkits:
209
) -> custom_update_toolkits_response.CustomUpdateToolkitsResponse:
210
"""
211
Update a custom toolkit's name, logo or API key field copy. Omitted
215
- fields keep their current value. Experimental — shape may change.
212
+ fields keep their current value.
213
214
On a project with 2FA enabled, updating a private toolkit requires the
215
``user_id`` it is private to.
@@ -226,7 +223,7 @@ class ExperimentalCustomToolkits:
223
:return: ``success``.
224
225
Example:
229
- composio.experimental.custom_toolkits.update(
226
+ composio.custom_toolkits.update(
227
"CUSTOM_INTERNAL_API_K7F2Q",
228
name="Internal API (prod)",
229
user_id="user_123",
@@ -242,7 +239,6 @@ class ExperimentalCustomToolkits:
239
"""
240
Create a custom toolkit, or update its display metadata (name, API key
241
field copy) when the project already owns one with this slug.
245
- Experimental — shape may change.
242
243
.. deprecated::
244
Use :meth:`create` for a new toolkit and :meth:`update` to change
@@ -261,7 +257,7 @@ class ExperimentalCustomToolkits:
257
:return: The toolkit's ``slug``.
258
259
Example:
264
- composio.experimental.custom_toolkits.upsert(
260
+ composio.custom_toolkits.upsert(
261
slug="INTERNAL_API",
262
toolkit_config={
263
"name": "Internal API",
@@ -293,7 +289,6 @@ class ExperimentalCustomToolkits:
289
"""
290
Re-fetch a custom toolkit's tool definitions from its remote MCP
291
server. Call it when automatic sync fails or the remote tools change.
296
- Experimental — shape may change.
292
293
:param slug: The custom toolkit slug (``CUSTOM_...``).
294
:param connected_account_id: Connected account to use when fetching
@@ -301,7 +296,7 @@ class ExperimentalCustomToolkits:
296
:return: The toolkit ``version`` and ``synced_count``.
297
298
Example:
304
- result = composio.experimental.custom_toolkits.sync("CUSTOM_MY_TOOLKIT")
299
+ result = composio.custom_toolkits.sync("CUSTOM_MY_TOOLKIT")
300
print(result.synced_count)
301
"""
302
return self._require_client().custom.sync(
@@ -316,17 +311,21 @@ class ExperimentalCustomToolkits:
311
configs and connected accounts. The credentials behind those
312
connected accounts are revoked in background jobs
313
(``revoke_job_ids``). Composio-managed toolkits cannot be deleted
319
- (API 403). Experimental — shape may change.
314
+ (API 403).
315
316
:param slug: The custom toolkit slug (``CUSTOM_...``).
317
:return: What was deleted.
318
319
Example:
325
- composio.experimental.custom_toolkits.delete("CUSTOM_MY_TOOLKIT")
320
+ composio.custom_toolkits.delete("CUSTOM_MY_TOOLKIT")
321
"""
322
return self._require_client().custom.delete_toolkit(slug)
323
324
325
+ExperimentalCustomToolkits = CustomToolkits
326
+"""Deprecated alias of :class:`CustomToolkits`."""
327
+
328
+
329
class ExperimentalAPI:
330
"""Experimental APIs accessed via ``composio.experimental``.
331
@@ -340,13 +339,13 @@ class ExperimentalAPI:
339
usage: ExperimentalUsage
340
"""Project usage metering. Experimental — shape may change."""
341
343
- custom_toolkits: ExperimentalCustomToolkits
344
- """Project-owned custom toolkits. Experimental — shape may change."""
342
+ custom_toolkits: CustomToolkits
343
+ """Deprecated: use ``composio.custom_toolkits``, the same object."""
344
345
def __init__(self, client: t.Optional[HttpClient] = None) -> None:
346
self._client = client
347
self.usage = ExperimentalUsage(client=client)
349
- self.custom_toolkits = ExperimentalCustomToolkits(client=client)
348
+ self.custom_toolkits = CustomToolkits(client=client)
349
350
def update_acl(
351
self,
python/composio/sdk.py
+3
@@ -329,6 +329,9 @@ class Composio(t.Generic[TTool, TToolCollection], WithLogger):
329
from composio.core.models.experimental import ExperimentalAPI
330
331
self.experimental = ExperimentalAPI(client=self._client)
332
+ # Custom toolkits graduated from experimental; experimental.custom_toolkits
333
+ # is a deprecated alias of this same object.
334
+ self.custom_toolkits = self.experimental.custom_toolkits
335
336
# Sessions API — the canonical entrypoint for creating tool sessions.
337
# Surfaced as `composio.sessions`; `composio.tool_router` is a
python/tests/test_sdk.py
+10
-5
@@ -109,16 +109,21 @@ class TestComposioSDK:
109
assert composio.logs._client is composio._client
110
111
def test_sdk_mounts_keyring_and_custom_toolkits(self):
112
- from composio.core.models import ExperimentalCustomToolkits, Keyring
112
+ from composio.core.models import (
113
+ CustomToolkits,
114
+ ExperimentalCustomToolkits,
115
+ Keyring,
116
+ )
117
118
composio = Composio(api_key="test-key")
119
120
assert isinstance(composio.keyring, Keyring)
121
assert composio.keyring._client is composio._client
118
- assert isinstance(
119
- composio.experimental.custom_toolkits, ExperimentalCustomToolkits
120
- )
121
- assert composio.experimental.custom_toolkits._client is composio._client
122
+ assert isinstance(composio.custom_toolkits, CustomToolkits)
123
+ assert composio.custom_toolkits._client is composio._client
124
+ # Deprecated paths keep working and resolve to the same object.
125
+ assert composio.experimental.custom_toolkits is composio.custom_toolkits
126
+ assert ExperimentalCustomToolkits is CustomToolkits
127
128
def test_sdk_has_required_attributes(self):
129
"""Test that SDK has required attributes after initialization."""
ts/packages/core/src/composio.ts
+12
@@ -8,6 +8,7 @@ import { Triggers } from './models/Triggers';
8
import { AuthConfigs } from './models/AuthConfigs';
9
import { ConnectedAccounts } from './models/ConnectedAccounts';
10
import { Experimental } from './models/Experimental';
11
+import { CustomToolkits } from './models/CustomToolkits';
12
import { MCP } from './models/MCP';
13
import { Webhooks } from './models/Webhooks';
14
import { Logs } from './models/Logs';
@@ -353,6 +354,16 @@ export class Composio<
354
logs: Logs;
355
/** Public transfer keys of the organization's customer-managed keyring */
356
keyring: Keyring;
357
+ /**
358
+ * Register and manage project-owned custom toolkits, such as a remote MCP
359
+ * server (`create()` / `update()` / `sync()` / `delete()`).
360
+ *
361
+ * @example
362
+ * ```typescript
363
+ * await composio.customToolkits.sync('CUSTOM_MY_TOOLKIT');
364
+ * ```
365
+ */
366
+ customToolkits: CustomToolkits;
367
/**
368
* Experimental SDK methods whose shape may change in future releases.
369
* Prefer domain-specific mounts (for example
@@ -576,6 +587,7 @@ export class Composio<
587
this.logs = new Logs(this.client);
588
this.keyring = new Keyring(this.client);
589
this.experimental = new Experimental(this.client);
590
+ this.customToolkits = this.experimental.customToolkits;
591
this.sessions = new Sessions(this.client, this.config);
592
this.toolRouter = this.sessions;
593
this.sessionConfigs = new SessionConfigs(this.client);
ts/packages/core/src/models/CustomToolkits.ts
+11
-17
@@ -1,7 +1,6 @@
1
/**
2
- * @fileoverview `composio.experimental.customToolkits`: register and manage
2
+ * @fileoverview `composio.customToolkits`: register and manage
3
* project-owned custom toolkits.
4
- * **Experimental — custom toolkits are in pilot; shape may change.**
4
*
5
* @module CustomToolkits
6
*/
@@ -39,14 +38,14 @@ import {
38
} from '../utils/transformers/customToolkits';
39
40
const UPSERT_DEPRECATION =
42
- '[Deprecation] composio.experimental.customToolkits.upsert() is deprecated. ' +
41
+ '[Deprecation] composio.customToolkits.upsert() is deprecated. ' +
42
'Use create() for a new toolkit and update(slug, ...) to change its name, logo or API key field.';
43
let _upsertDeprecationWarned = false;
44
45
/**
47
- * `composio.experimental.customToolkits` — toolkits your project registers
46
+ * `composio.customToolkits` — toolkits your project registers
47
* from its own app or MCP server, with their own auth configs and connected
49
- * accounts. **Experimental — custom toolkits are in pilot; shape may change.**
48
+ * accounts.
49
*
50
* These live on the Composio platform. They are unrelated to the in-process
51
* toolkits built with `experimental_createToolkit()`, which run inside your
@@ -54,13 +53,13 @@ let _upsertDeprecationWarned = false;
53
*
54
* @example
55
* ```typescript
57
- * const { slug } = await composio.experimental.customToolkits.create({
56
+ * const { slug } = await composio.customToolkits.create({
57
* name: 'My Toolkit',
58
* mcpUrl: 'https://mcp.example.com/mcp',
59
* authSchemes: [{ mode: 'DCR_OAUTH', discoveryUrl: 'https://mcp.example.com/.well-known/oauth-authorization-server' }],
60
* userId: 'all',
61
* });
63
- * await composio.experimental.customToolkits.update(slug, { name: 'My Renamed Toolkit' });
62
+ * await composio.customToolkits.update(slug, { name: 'My Renamed Toolkit' });
63
* ```
64
*/
65
export class CustomToolkits {
@@ -73,7 +72,6 @@ export class CustomToolkits {
72
73
/**
74
* Creates a custom MCP toolkit and returns its generated slug.
76
- * **Experimental — custom toolkits are in pilot; shape may change.**
75
*
76
* Set `userId` to `'all'` to share the toolkit with every user in the
77
* project, or to a user ID to make it private to that user. `mcpUrl`,
@@ -87,7 +85,7 @@ export class CustomToolkits {
85
*
86
* @example
87
* ```typescript
90
- * const { slug, connectLink } = await composio.experimental.customToolkits.create({
88
+ * const { slug, connectLink } = await composio.customToolkits.create({
89
* name: 'Internal API',
90
* mcpUrl: 'https://mcp.internal.example.com/mcp',
91
* authSchemes: [
@@ -118,7 +116,6 @@ export class CustomToolkits {
116
/**
117
* Updates a custom toolkit's name, logo or API key field copy. Omitted
118
* fields keep their current value.
121
- * **Experimental — custom toolkits are in pilot; shape may change.**
119
*
120
* On a project with 2FA enabled, updating a private toolkit requires the
121
* `userId` it is private to.
@@ -130,7 +127,7 @@ export class CustomToolkits {
127
*
128
* @example
129
* ```typescript
133
- * await composio.experimental.customToolkits.update('CUSTOM_INTERNAL_API_K7F2Q', {
130
+ * await composio.customToolkits.update('CUSTOM_INTERNAL_API_K7F2Q', {
131
* name: 'Internal API (prod)',
132
* userId: 'user_123',
133
* });
@@ -158,7 +155,6 @@ export class CustomToolkits {
155
/**
156
* Creates a custom toolkit, or updates its display metadata (name, API key
157
* field copy) when the project already owns a toolkit with this slug.
161
- * **Experimental — custom toolkits are in pilot; shape may change.**
158
*
159
* `mcpUrl` and `authSchemes` cannot change on an existing toolkit:
160
* re-sending them unchanged is a no-op, and changing them fails with a 409.
@@ -170,7 +166,7 @@ export class CustomToolkits {
166
*
167
* @example
168
* ```typescript
173
- * await composio.experimental.customToolkits.upsert({
169
+ * await composio.customToolkits.upsert({
170
* slug: 'INTERNAL_API',
171
* toolkitConfig: {
172
* name: 'Internal API',
@@ -211,7 +207,6 @@ export class CustomToolkits {
207
/**
208
* Re-fetches the tool definitions of a custom toolkit from its remote MCP
209
* server. Call it when automatic sync fails or the remote tools change.
214
- * **Experimental — custom toolkits are in pilot; shape may change.**
210
*
211
* @param {string} slug - The custom toolkit slug (`CUSTOM_...`)
212
* @param {CustomToolkitSyncParams} [params] - Optional connected account to fetch the definitions with
@@ -220,7 +215,7 @@ export class CustomToolkits {
215
*
216
* @example
217
* ```typescript
223
- * const { version, syncedCount } = await composio.experimental.customToolkits.sync(
218
+ * const { version, syncedCount } = await composio.customToolkits.sync(
219
* 'CUSTOM_MY_TOOLKIT',
220
* { connectedAccountId: 'ca_abc123' }
221
* );
@@ -249,7 +244,6 @@ export class CustomToolkits {
244
* Deletes a custom toolkit owned by the project, with its tools, auth
245
* configs and connected accounts. The credentials behind those connected
246
* accounts are revoked in background jobs (`revokeJobIds`).
252
- * **Experimental — custom toolkits are in pilot; shape may change.**
247
*
248
* Composio-managed toolkits cannot be deleted; the API answers 403.
249
*
@@ -258,7 +252,7 @@ export class CustomToolkits {
252
*
253
* @example
254
* ```typescript
261
- * const result = await composio.experimental.customToolkits.delete('CUSTOM_MY_TOOLKIT');
255
+ * const result = await composio.customToolkits.delete('CUSTOM_MY_TOOLKIT');
256
* console.log(result.connectedAccountsDeleted);
257
* ```
258
*/
ts/packages/core/src/models/Experimental.ts
+2
-7
@@ -144,13 +144,8 @@ export class Experimental {
144
usage: Usage;
145
146
/**
147
- * Register and manage project-owned custom toolkits (`create()` / `update()` / `sync()` / `delete()`).
148
- * **Experimental — custom toolkits are in pilot; shape may change.**
149
- *
150
- * @example
151
- * ```typescript
152
- * await composio.experimental.customToolkits.sync('CUSTOM_MY_TOOLKIT');
153
- * ```
147
+ * Same object as `composio.customToolkits`.
148
+ * @deprecated Use `composio.customToolkits` instead. Custom toolkits are no longer experimental; this alias is kept for backwards compatibility.
149
*/
150
customToolkits: CustomToolkits;
151
ts/packages/core/src/types/customToolkits.types.ts
+4
-9
@@ -8,7 +8,6 @@ export type CustomToolkitApiKeyField = z.infer<typeof CustomToolkitApiKeyFieldSc
8
9
/**
10
* How end users authenticate to a custom toolkit.
11
- * **Experimental — custom toolkits are in pilot; shape may change.**
11
*/
12
export const CustomToolkitAuthSchemeSchema = z.discriminatedUnion('mode', [
13
z.object({ mode: z.literal('NO_AUTH') }),
@@ -50,8 +49,7 @@ const CustomToolkitLogoFileSchema = z.object({
49
export type CustomToolkitLogoFile = z.infer<typeof CustomToolkitLogoFileSchema>;
50
51
/**
53
- * Params for `composio.experimental.customToolkits.create()`.
54
- * **Experimental — custom toolkits are in pilot; shape may change.**
52
+ * Params for `composio.customToolkits.create()`.
53
*/
54
export const CustomToolkitCreateParamsSchema = z.object({
55
/** Human-readable toolkit name. */
@@ -90,8 +88,7 @@ export const CustomToolkitCreateResponseSchema = z.object({
88
export type CustomToolkitCreateResponse = z.infer<typeof CustomToolkitCreateResponseSchema>;
89
90
/**
93
- * Params for `composio.experimental.customToolkits.update()`.
94
- * **Experimental — custom toolkits are in pilot; shape may change.**
91
+ * Params for `composio.customToolkits.update()`.
92
*/
93
export const CustomToolkitUpdateParamsSchema = z
94
.object({
@@ -117,8 +114,7 @@ export const CustomToolkitUpdateResponseSchema = z.object({
114
export type CustomToolkitUpdateResponse = z.infer<typeof CustomToolkitUpdateResponseSchema>;
115
116
/**
120
- * Params for `composio.experimental.customToolkits.upsert()`.
121
- * **Experimental — custom toolkits are in pilot; shape may change.**
117
+ * Params for `composio.customToolkits.upsert()`.
118
*
119
* @deprecated Use `CustomToolkitCreateParams` with `create()`.
120
*/
@@ -152,8 +148,7 @@ export const CustomToolkitUpsertResponseSchema = z.object({
148
export type CustomToolkitUpsertResponse = z.infer<typeof CustomToolkitUpsertResponseSchema>;
149
150
/**
155
- * Params for `composio.experimental.customToolkits.sync()`.
156
- * **Experimental — custom toolkits are in pilot; shape may change.**
151
+ * Params for `composio.customToolkits.sync()`.
152
*/
153
export const CustomToolkitSyncParamsSchema = z.object({
154
/** Connected account to use when fetching the remote tool definitions. */
ts/packages/core/test/models/customToolkits.test.ts
+17
@@ -1,9 +1,11 @@
1
import { describe, it, expect, vi, beforeEach } from 'vitest';
2
import ComposioClient from '@composio/client';
3
+import { Composio } from '../../src/composio';
4
import { CustomToolkits } from '../../src/models/CustomToolkits';
5
import { Experimental } from '../../src/models/Experimental';
6
import { telemetry } from '../../src/telemetry/Telemetry';
7
import { ValidationError } from '../../src/errors/ValidationErrors';
8
+import { MockProvider } from '../utils/mocks/provider.mock';
9
10
vi.mock('../../src/telemetry/Telemetry', () => ({
11
telemetry: {
@@ -21,6 +23,21 @@ const createMockClient = () => ({
23
},
24
});
25
26
+describe('composio.customToolkits', () => {
27
+ it('is the same object as the deprecated composio.experimental.customToolkits', () => {
28
+ const composio = new Composio({
29
+ apiKey: 'ak_test',
30
+ baseURL: 'https://api.test.com',
31
+ provider: new MockProvider(),
32
+ allowTracking: false,
33
+ disableVersionCheck: true,
34
+ });
35
+
36
+ expect(composio.customToolkits).toBeInstanceOf(CustomToolkits);
37
+ expect(composio.experimental.customToolkits).toBe(composio.customToolkits);
38
+ });
39
+});
40
+
41
describe('Experimental.customToolkits', () => {
42
let customToolkits: CustomToolkits;
43
let mockClient: ReturnType<typeof createMockClient>;