@devries-cameron20 / composio Mirror · read-only / commits / 6f8a704f1
Fork 0

Composio powers 1000+ toolkits, tool search, context management, authentication, and a sandboxed workbench to help you build AI agents that turn intent into action.

Mirrored from https://github.com/Camo67/composio.git

Synced Nov 21, 06:00 UTC

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>;