@devries-cameron20 / composio-1 / commits / f22ab2684
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.

revert: "chore(release): publish SDK packages (#5261)" (#5275)

This PR: - reverts https://github.com/ComposioHQ/composio/pull/5261, which merged but was never tagged or published: the tag gate recorded it as `Abandoned` (fixed in https://github.com/ComposioHQ/composio/pull/5274) - restores the eight consumed changesets and the pre-release versions, so the next release request plans the same release again - unblocks the release request, which refuses to plan while `next` carries an untagged release plan Merge after https://github.com/ComposioHQ/composio/pull/5274, then request the release again. That new release PR needs a fresh approval.

Alberto Schiabel committed Nov 9, 2026 at 12:59 UTC f22ab26848dbcc600131fb0b1d7261ab576ebb48
54 files changed +115 -399
.changeset/composio-client-update.md new
+5
@@ -0,0 +1,5 @@
1 +---
2 +'@composio/core': patch
3 +---
4 +
5 +Update @composio/client to 2.1.0 to include the latest API changes.
.changeset/custom-toolkit-mcp-url.md new
+6
@@ -0,0 +1,6 @@
1 +---
2 +'@composio/core': minor
3 +'@composio/slim': minor
4 +---
5 +
6 +Breaking (experimental API): `composio.experimental.customToolkits.create()` and `upsert()` take the MCP server URL as `mcpUrl` instead of `appUrl`, and send it to the API as `mcp_url`.
.changeset/local-tools-rename.md new
+6
@@ -0,0 +1,6 @@
1 +---
2 +'@composio/core': minor
3 +'@composio/slim': minor
4 +---
5 +
6 +Renames in-process custom tools to local tools, so they are no longer confused with the server-side custom toolkits on `composio.experimental.customToolkits`. Pass `experimental.localTools` and `experimental.localToolkits` to `composio.create()`, and `localTools` and `localToolkits` to `composio.use()`. List them with `session.localTools()` and `session.localToolkits()`. The types are now `LocalTool`, `LocalToolkit`, `RegisteredLocalTool`, `RegisteredLocalToolkit`, `CreateLocalToolParams`, `CreateLocalToolkitParams` and `LocalToolExecuteFn`. The `customTools` and `customToolkits` options, the `session.customTools()` and `session.customToolkits()` methods, and the `Custom*` type names are deprecated and keep working. Passing both a new option and its deprecated alias throws `ValidationError`. The request sent to the API is unchanged.
.changeset/python-client-2-1-0.md new
+5
@@ -0,0 +1,5 @@
1 +---
2 +'@composio/python-sdk': minor
3 +---
4 +
5 +Update `composio-client` to 2.1.0. Breaking (experimental API): `composio.experimental.custom_toolkits.create()` and `upsert()` take the MCP server URL as `mcp_url` instead of `app_url`.
.changeset/python-local-tools-rename.md new
+5
@@ -0,0 +1,5 @@
1 +---
2 +'@composio/python-sdk': minor
3 +---
4 +
5 +Renames in-process custom tools to local tools, so they are no longer confused with the server-side custom toolkits on `composio.experimental.custom_toolkits`. Pass `experimental={"local_tools": ..., "local_toolkits": ...}` to `composio.create()`, and `local_tools=` and `local_toolkits=` to `composio.use()`. List them with `session.local_tools()` and `session.local_toolkits()`. The types are now `LocalTool`, `LocalToolkit`, `RegisteredLocalTool` and `RegisteredLocalToolkit`. The `custom_tools` and `custom_toolkits` options and session methods still work but emit `ComposioDeprecationWarning`, and the `Custom*` type names remain as aliases. Passing both a new option and its deprecated alias raises `InvalidParams`. The request sent to the API is unchanged.
.changeset/python-missing-api-key-message.md new
+5
@@ -0,0 +1,5 @@
1 +---
2 +'@composio/python-sdk': patch
3 +---
4 +
5 +The error for a missing API key now explains how to set `COMPOSIO_API_KEY` or pass `api_key=`, and links to where to get a project API key, instead of suggesting `composio login`, which the Python package doesn't install.
.changeset/python-rate-limit-handling.md new
+5
@@ -0,0 +1,5 @@
1 +---
2 +'@composio/python-sdk': minor
3 +---
4 +
5 +`wait_for_connection()` handles rate limits: the delay between polls grows from 1 to 5 seconds, and a poll rejected with a 429 waits as long as its `Retry-After` header asks (up to the timeout) and polls again instead of failing the wait. A NaN timeout now times out instead of polling forever.
.changeset/sdk-rate-limit-handling.md new
+5
@@ -0,0 +1,5 @@
1 +---
2 +'@composio/core': minor
3 +---
4 +
5 +Handle rate limits better: `tools.execute()` reuses tool schemas instead of fetching one per call, `waitForConnection()` backs off between polls and waits out a 429, and tool fetches and executions rejected with a 429 throw `ComposioToolFetchRateLimitError` or `ComposioToolExecutionRateLimitError` (check with `isComposioRateLimitError`).
.github/sdk-release-plan.json deleted
-186
@@ -1,186 +0,0 @@
1 -{
2 - "id": "42277262745",
3 - "inputBase": "e970677aa69f4526009bb535a58d006ca7368e9a",
4 - "requestedBy": "jkomyno",
5 - "issue": 5260,
6 - "date": "2026-11-06",
7 - "plan": {
8 - "schemaVersion": 1,
9 - "inputFingerprint": "ca87e5d8d9b4b77af52b8258910a562e111182fb3bb36d2567068d7352ea091b",
10 - "choices": {
11 - "typescript": "auto",
12 - "python": "auto",
13 - "channel": "stable",
14 - "run": "42277262745"
15 - },
16 - "recommended": [
17 - {
18 - "name": "@composio/core",
19 - "type": "minor",
20 - "oldVersion": "0.28.0",
21 - "newVersion": "0.29.0",
22 - "changesets": [
23 - "composio-client-update",
24 - "custom-toolkit-mcp-url",
25 - "local-tools-rename",
26 - "sdk-rate-limit-handling"
27 - ],
28 - "language": "typescript"
29 - },
30 - {
31 - "name": "@composio/python-sdk",
32 - "type": "minor",
33 - "oldVersion": "0.31.0",
34 - "newVersion": "0.32.0",
35 - "changesets": [
36 - "python-client-2-1-0",
37 - "python-local-tools-rename",
38 - "python-missing-api-key-message",
39 - "python-rate-limit-handling"
40 - ],
41 - "language": "python"
42 - },
43 - {
44 - "name": "@composio/slim",
45 - "type": "minor",
46 - "oldVersion": "0.28.0",
47 - "newVersion": "0.29.0",
48 - "changesets": [
49 - "custom-toolkit-mcp-url",
50 - "local-tools-rename"
51 - ],
52 - "language": "typescript"
53 - }
54 - ],
55 - "releases": [
56 - {
57 - "name": "@composio/core",
58 - "type": "minor",
59 - "oldVersion": "0.28.0",
60 - "newVersion": "0.29.0",
61 - "changesets": [
62 - "composio-client-update",
63 - "custom-toolkit-mcp-url",
64 - "local-tools-rename",
65 - "sdk-rate-limit-handling"
66 - ],
67 - "language": "typescript"
68 - },
69 - {
70 - "name": "@composio/python-sdk",
71 - "type": "minor",
72 - "oldVersion": "0.31.0",
73 - "newVersion": "0.32.0",
74 - "changesets": [
75 - "python-client-2-1-0",
76 - "python-local-tools-rename",
77 - "python-missing-api-key-message",
78 - "python-rate-limit-handling"
79 - ],
80 - "language": "python"
81 - },
82 - {
83 - "name": "@composio/slim",
84 - "type": "minor",
85 - "oldVersion": "0.28.0",
86 - "newVersion": "0.29.0",
87 - "changesets": [
88 - "custom-toolkit-mcp-url",
89 - "local-tools-rename"
90 - ],
91 - "language": "typescript"
92 - }
93 - ],
94 - "changesets": [
95 - {
96 - "id": "composio-client-update",
97 - "summary": "Update @composio/client to 2.1.0 to include the latest API changes.",
98 - "releases": [
99 - {
100 - "name": "@composio/core",
101 - "type": "patch"
102 - }
103 - ]
104 - },
105 - {
106 - "id": "custom-toolkit-mcp-url",
107 - "summary": "Breaking (experimental API): `composio.experimental.customToolkits.create()` and `upsert()` take the MCP server URL as `mcpUrl` instead of `appUrl`, and send it to the API as `mcp_url`.",
108 - "releases": [
109 - {
110 - "name": "@composio/core",
111 - "type": "minor"
112 - },
113 - {
114 - "name": "@composio/slim",
115 - "type": "minor"
116 - }
117 - ]
118 - },
119 - {
120 - "id": "local-tools-rename",
121 - "summary": "Renames in-process custom tools to local tools, so they are no longer confused with the server-side custom toolkits on `composio.experimental.customToolkits`. Pass `experimental.localTools` and `experimental.localToolkits` to `composio.create()`, and `localTools` and `localToolkits` to `composio.use()`. List them with `session.localTools()` and `session.localToolkits()`. The types are now `LocalTool`, `LocalToolkit`, `RegisteredLocalTool`, `RegisteredLocalToolkit`, `CreateLocalToolParams`, `CreateLocalToolkitParams` and `LocalToolExecuteFn`. The `customTools` and `customToolkits` options, the `session.customTools()` and `session.customToolkits()` methods, and the `Custom*` type names are deprecated and keep working. Passing both a new option and its deprecated alias throws `ValidationError`. The request sent to the API is unchanged.",
122 - "releases": [
123 - {
124 - "name": "@composio/core",
125 - "type": "minor"
126 - },
127 - {
128 - "name": "@composio/slim",
129 - "type": "minor"
130 - }
131 - ]
132 - },
133 - {
134 - "id": "python-client-2-1-0",
135 - "summary": "Update `composio-client` to 2.1.0. Breaking (experimental API): `composio.experimental.custom_toolkits.create()` and `upsert()` take the MCP server URL as `mcp_url` instead of `app_url`.",
136 - "releases": [
137 - {
138 - "name": "@composio/python-sdk",
139 - "type": "minor"
140 - }
141 - ]
142 - },
143 - {
144 - "id": "python-local-tools-rename",
145 - "summary": "Renames in-process custom tools to local tools, so they are no longer confused with the server-side custom toolkits on `composio.experimental.custom_toolkits`. Pass `experimental={\"local_tools\": ..., \"local_toolkits\": ...}` to `composio.create()`, and `local_tools=` and `local_toolkits=` to `composio.use()`. List them with `session.local_tools()` and `session.local_toolkits()`. The types are now `LocalTool`, `LocalToolkit`, `RegisteredLocalTool` and `RegisteredLocalToolkit`. The `custom_tools` and `custom_toolkits` options and session methods still work but emit `ComposioDeprecationWarning`, and the `Custom*` type names remain as aliases. Passing both a new option and its deprecated alias raises `InvalidParams`. The request sent to the API is unchanged.",
146 - "releases": [
147 - {
148 - "name": "@composio/python-sdk",
149 - "type": "minor"
150 - }
151 - ]
152 - },
153 - {
154 - "id": "python-missing-api-key-message",
155 - "summary": "The error for a missing API key now explains how to set `COMPOSIO_API_KEY` or pass `api_key=`, and links to where to get a project API key, instead of suggesting `composio login`, which the Python package doesn't install.",
156 - "releases": [
157 - {
158 - "name": "@composio/python-sdk",
159 - "type": "patch"
160 - }
161 - ]
162 - },
163 - {
164 - "id": "python-rate-limit-handling",
165 - "summary": "`wait_for_connection()` handles rate limits: the delay between polls grows from 1 to 5 seconds, and a poll rejected with a 429 waits as long as its `Retry-After` header asks (up to the timeout) and polls again instead of failing the wait. A NaN timeout now times out instead of polling forever.",
166 - "releases": [
167 - {
168 - "name": "@composio/python-sdk",
169 - "type": "minor"
170 - }
171 - ]
172 - },
173 - {
174 - "id": "sdk-rate-limit-handling",
175 - "summary": "Handle rate limits better: `tools.execute()` reuses tool schemas instead of fetching one per call, `waitForConnection()` backs off between polls and waits out a 429, and tool fetches and executions rejected with a 429 throw `ComposioToolFetchRateLimitError` or `ComposioToolExecutionRateLimitError` (check with `isComposioRateLimitError`).",
176 - "releases": [
177 - {
178 - "name": "@composio/core",
179 - "type": "minor"
180 - }
181 - ]
182 - }
183 - ],
184 - "retainedChangesets": []
185 - }
186 -}
docs/content/changelog/11-06-26-sdk-42277262745.mdx deleted
-34
@@ -1,34 +0,0 @@
1 ----
2 -title: "SDK release 42277262745"
3 -date: "2026-11-06"
4 -sdkRelease: "42277262745"
5 -sdkReleaseTargets: {"@composio/core":"0.29.0","@composio/python-sdk":"0.32.0","@composio/slim":"0.29.0"}
6 ----
7 -
8 -See the [release request](https://github.com/ComposioHQ/composio/issues/5260) for publication status.
9 -
10 -### SDK Versions
11 -
12 -| SDK | Version |
13 -| --- | --- |
14 -| TypeScript `@composio/core` | `0.29.0` |
15 -| Python `composio` | `0.32.0` |
16 -| TypeScript `@composio/slim` | `0.29.0` |
17 -
18 -### Changes
19 -
20 -Update @composio/client to 2.1.0 to include the latest API changes.
21 -
22 -Breaking (experimental API): `composio.experimental.customToolkits.create()` and `upsert()` take the MCP server URL as `mcpUrl` instead of `appUrl`, and send it to the API as `mcp_url`.
23 -
24 -Renames in-process custom tools to local tools, so they are no longer confused with the server-side custom toolkits on `composio.experimental.customToolkits`. Pass `experimental.localTools` and `experimental.localToolkits` to `composio.create()`, and `localTools` and `localToolkits` to `composio.use()`. List them with `session.localTools()` and `session.localToolkits()`. The types are now `LocalTool`, `LocalToolkit`, `RegisteredLocalTool`, `RegisteredLocalToolkit`, `CreateLocalToolParams`, `CreateLocalToolkitParams` and `LocalToolExecuteFn`. The `customTools` and `customToolkits` options, the `session.customTools()` and `session.customToolkits()` methods, and the `Custom*` type names are deprecated and keep working. Passing both a new option and its deprecated alias throws `ValidationError`. The request sent to the API is unchanged.
25 -
26 -Update `composio-client` to 2.1.0. Breaking (experimental API): `composio.experimental.custom_toolkits.create()` and `upsert()` take the MCP server URL as `mcp_url` instead of `app_url`.
27 -
28 -Renames in-process custom tools to local tools, so they are no longer confused with the server-side custom toolkits on `composio.experimental.custom_toolkits`. Pass `experimental={"local_tools": ..., "local_toolkits": ...}` to `composio.create()`, and `local_tools=` and `local_toolkits=` to `composio.use()`. List them with `session.local_tools()` and `session.local_toolkits()`. The types are now `LocalTool`, `LocalToolkit`, `RegisteredLocalTool` and `RegisteredLocalToolkit`. The `custom_tools` and `custom_toolkits` options and session methods still work but emit `ComposioDeprecationWarning`, and the `Custom*` type names remain as aliases. Passing both a new option and its deprecated alias raises `InvalidParams`. The request sent to the API is unchanged.
29 -
30 -The error for a missing API key now explains how to set `COMPOSIO_API_KEY` or pass `api_key=`, and links to where to get a project API key, instead of suggesting `composio login`, which the Python package doesn't install.
31 -
32 -`wait_for_connection()` handles rate limits: the delay between polls grows from 1 to 5 seconds, and a poll rejected with a 429 waits as long as its `Retry-After` header asks (up to the timeout) and polls again instead of failing the wait. A NaN timeout now times out instead of polling forever.
33 -
34 -Handle rate limits better: `tools.execute()` reuses tool schemas instead of fetching one per call, `waitForConnection()` backs off between polls and waits out a 429, and tool fetches and executions rejected with a 429 throw `ComposioToolFetchRateLimitError` or `ComposioToolExecutionRateLimitError` (check with `isComposioRateLimitError`).
docs/content/reference/sdk-reference/python/connected-accounts.mdx
+1 -1
@@ -262,4 +262,4 @@ def wait_for_connection(id: str, timeout: float | None = ...) -> connected_accou
262
263 ---
264
265 -[View source](https://github.com/composiohq/composio/blob/next/python/composio/core/models/connected_accounts.py#L396)
265 +[View source](https://github.com/composiohq/composio/blob/next/python/composio/core/models/connected_accounts.py#L355)
docs/content/reference/sdk-reference/python/session.mdx
+4 -38
@@ -170,43 +170,9 @@ print(result.result_type, result.data)
170
171 ---
172
173 -### local_tools()
174 -
175 -List all local tools registered in this session. Returns tools with their final slugs, schemas, and resolved toolkit.
176 -
177 -```python
178 -def local_tools(toolkit: str | None = ...) -> List[RegisteredLocalTool]
179 -```
180 -
181 -**Parameters**
182 -
183 -| Name | Type |
184 -|------|------|
185 -| `toolkit?` | `str \| None` |
186 -
187 -**Returns**
188 -
189 -`List[RegisteredLocalTool]` — Array of registered local tools
190 -
191 ----
192 -
193 -### local_toolkits()
194 -
195 -List all toolkits of local tools registered in this session. Returns toolkits with their tools showing final slugs.
196 -
197 -```python
198 -def local_toolkits() -> List[RegisteredLocalToolkit]
199 -```
200 -
201 -**Returns**
202 -
203 -`List[RegisteredLocalToolkit]`
204 -
205 ----
206 -
173 ### custom_tools()
174
209 -Deprecated alias for `local_tools`.
175 +List all custom tools registered in this session. Returns tools with their final slugs, schemas, and resolved toolkit.
176
177 ```python
178 def custom_tools(toolkit: str | None = ...) -> List[RegisteredCustomTool]
@@ -220,13 +186,13 @@ def custom_tools(toolkit: str | None = ...) -> List[RegisteredCustomTool]
186
187 **Returns**
188
223 -`List[RegisteredCustomTool]`
189 +`List[RegisteredCustomTool]` — Array of registered custom tools
190
191 ---
192
193 ### custom_toolkits()
194
229 -Deprecated alias for `local_toolkits`.
195 +List all custom toolkits registered in this session. Returns toolkits with their tools showing final slugs.
196
197 ```python
198 def custom_toolkits() -> List[RegisteredCustomToolkit]
@@ -344,4 +310,4 @@ def delete() -> ToolRouterSessionDeleteResponse
310
311 ---
312
347 -[View source](https://github.com/composiohq/composio/blob/next/python/composio/core/models/tool_router_session.py#L322)
313 +[View source](https://github.com/composiohq/composio/blob/next/python/composio/core/models/tool_router_session.py#L311)
docs/content/reference/sdk-reference/python/triggers.mdx
+2 -4
@@ -100,7 +100,7 @@ def list(cursor: str | None = ..., limit: int | None = ..., toolkit_slugs: list[
100 Create a trigger instance
101
102 ```python
103 -def create(slug: str, user_id: str | None = ..., connected_account_id: str | None = ..., trigger_config: Dict[str, Any | None] = ..., type: Literal['webhook', 'poll' | None] = ..., polling_interval: int | None = ...) -> trigger_instance_upsert_response.TriggerInstanceUpsertRes...
103 +def create(slug: str, user_id: str | None = ..., connected_account_id: str | None = ..., trigger_config: Dict[str, Any | None] = ...) -> trigger_instance_upsert_response.TriggerInstanceUpsertRes...
104 ```
105
106 **Parameters**
@@ -111,12 +111,10 @@ def create(slug: str, user_id: str | None = ..., connected_account_id: str | Non
111 | `user_id?` | `str \| None` |
112 | `connected_account_id?` | `str \| None` |
113 | `trigger_config?` | `Dict[str, Any \| None]` |
114 -| `type?` | `Literal['webhook', 'poll' \| None]` |
115 -| `polling_interval?` | `int \| None` |
114
115 **Returns**
116
119 -`trigger_instance_upsert_response.TriggerInstanceUpsertRes...` — The trigger instance, with the `type` it uses, the `fallback_reason` when it polls after a webhook was unavailable, and its `polling_interval`
117 +`trigger_instance_upsert_response.TriggerInstanceUpsertRes...` — The trigger instance
118
119 ---
120
docs/content/reference/sdk-reference/typescript/composio.mdx
+1 -1
@@ -66,7 +66,7 @@ const composio = new Composio({
66 | `toolRouter` | `ToolRouter` | Legacy alias for `composio.sessions`. |
67 | `tools` | `Tools` | List, retrieve, and execute tools |
68 | `triggers` | `Triggers` | Manage webhook triggers and event subscriptions |
69 -| `use` | `(...) => Promise<Session>` | Use an existing tool router session |
69 +| `use` | `(id: string, options: \{ customToolkits?: CustomToolkit[]; customTools?: CustomTool[]; mcp: true \}, requestOptions: ComposioRequestOptions) => Promise<Session>` | Use an existing tool router session |
70 | `webhooks` | `Webhooks` | Manage the project's webhook subscription (`webhooks.subscriptions`) and inbound per-toolkit webhook endpoints (`webhooks.endpoints`). |
71
72 ## Methods
docs/content/reference/sdk-reference/typescript/connected-accounts.mdx
+2 -2
@@ -540,8 +540,8 @@ const disabledAccount = await composio.connectedAccounts.updateStatus('conn_abc1
540
541 Waits for a connection request to complete and become active.
542
543 -This method polls the Composio API, backing off from 1 second to 5 seconds between polls,
544 -to check the status of a connection until it either becomes active, enters a terminal error state, or times out.
543 +This method continuously polls the Composio API to check the status of a connection
544 +until it either becomes active, enters a terminal error state, or times out.
545
546 ```typescript
547 async waitForConnection(connectedAccountId: string, timeout?: number): Promise<ConnectedAccountRetrieveResponse>
docs/content/reference/sdk-reference/typescript/custom-toolkits.mdx
+4 -4
@@ -20,7 +20,7 @@ Creates a custom MCP toolkit and returns its generated slug.
20 **Experimental — custom toolkits are in pilot; shape may change.**
21
22 Set `userId` to `'all'` to share the toolkit with every user in the
23 -project, or to a user ID to make it private to that user. `mcpUrl`,
23 +project, or to a user ID to make it private to that user. `appUrl`,
24 `authSchemes` and `userId` cannot change later: delete and re-create the
25 toolkit instead. For a private toolkit, `connectLink` is where to send
26 that user to connect.
@@ -45,7 +45,7 @@ async create(params: CustomToolkitCreateParams, requestOptions?: ComposioRequest
45 ```typescript
46 const { slug, connectLink } = await composio.experimental.customToolkits.create({
47 name: 'Internal API',
48 - mcpUrl: 'https://mcp.internal.example.com/mcp',
48 + appUrl: 'https://mcp.internal.example.com/mcp',
49 authSchemes: [
50 { mode: 'API_KEY', headers: { Authorization: 'Bearer {{generic_api_key}}' } },
51 ],
@@ -169,7 +169,7 @@ Creates a custom toolkit, or updates its display metadata (name, API key
169 field copy) when the project already owns a toolkit with this slug.
170 **Experimental — custom toolkits are in pilot; shape may change.**
171
172 -`mcpUrl` and `authSchemes` cannot change on an existing toolkit:
172 +`appUrl` and `authSchemes` cannot change on an existing toolkit:
173 re-sending them unchanged is a no-op, and changing them fails with a 409.
174 Delete and re-register the toolkit instead, which revokes its connections.
175
@@ -195,7 +195,7 @@ await composio.experimental.customToolkits.upsert({
195 slug: 'INTERNAL_API',
196 toolkitConfig: {
197 name: 'Internal API',
198 - mcpUrl: 'https://mcp.internal.example.com/mcp',
198 + appUrl: 'https://mcp.internal.example.com/mcp',
199 authSchemes: [
200 { mode: 'API_KEY', headers: { Authorization: 'Bearer {{generic_api_key}}' } },
201 ],
docs/content/reference/sdk-reference/typescript/session.mdx
+10 -48
@@ -52,30 +52,28 @@ async authorize(toolkit: string, options?: { callbackUrl?: string; alias?: strin
52
53 ---
54
55 -### customToolkits() (deprecated)
55 +### customToolkits()
56
57 -<Callout type="warn" title="Deprecated">
58 -Use `localToolkits()` instead.
59 -</Callout>
57 +List all custom toolkits registered in this session.
58 +Returns toolkits with their tools showing final slugs.
59
60 ```typescript
62 -customToolkits(): RegisteredLocalToolkit[]
61 +customToolkits(): RegisteredCustomToolkit[]
62 ```
63
64 **Returns**
65
67 -`RegisteredLocalToolkit[]`
66 +`RegisteredCustomToolkit[]` — Array of registered custom toolkits
67
68 ---
69
71 -### customTools() (deprecated)
70 +### customTools()
71
73 -<Callout type="warn" title="Deprecated">
74 -Use `localTools()` instead.
75 -</Callout>
72 +List all custom tools registered in this session.
73 +Returns tools with their final slugs, schemas, and resolved toolkit.
74
75 ```typescript
78 -customTools(options?: { toolkit?: string }): RegisteredLocalTool[]
76 +customTools(options?: { toolkit?: string }): RegisteredCustomTool[]
77 ```
78
79 **Parameters**
@@ -86,7 +84,7 @@ customTools(options?: { toolkit?: string }): RegisteredLocalTool[]
84
85 **Returns**
86
89 -`RegisteredLocalTool[]`
87 +`RegisteredCustomTool[]` — Array of registered custom tools
88
89 ---
90
@@ -249,42 +247,6 @@ console.log(items[1].config.toolkits);
247
248 ---
249
252 -### localToolkits()
253 -
254 -List all toolkits of local tools registered in this session.
255 -Returns toolkits with their tools showing final slugs.
256 -
257 -```typescript
258 -localToolkits(): RegisteredLocalToolkit[]
259 -```
260 -
261 -**Returns**
262 -
263 -`RegisteredLocalToolkit[]` — Array of registered toolkits of local tools
264 -
265 ----
266 -
267 -### localTools()
268 -
269 -List all local tools registered in this session.
270 -Returns tools with their final slugs, schemas, and resolved toolkit.
271 -
272 -```typescript
273 -localTools(options?: { toolkit?: string }): RegisteredLocalTool[]
274 -```
275 -
276 -**Parameters**
277 -
278 -| Name | Type |
279 -|------|------|
280 -| `options?` | `\{ toolkit?: string \}` |
281 -
282 -**Returns**
283 -
284 -`RegisteredLocalTool[]` — Array of registered local tools
285 -
286 ----
287 -
250 ### proxyExecute()
251
252 Proxy an API call through Composio's auth layer using the session's connected account.
docs/content/reference/sdk-reference/typescript/sessions.mdx
+6 -6
@@ -74,8 +74,8 @@ const session = await composio.sessions.create('user_123', {
74 toolkits: ['gmail'],
75 manageConnections: true,
76 experimental: {
77 - localTools: [myLocalTool],
78 - localToolkits: [myLocalToolkit],
77 + customTools: [myCustomTool],
78 + customToolkits: [myToolkit],
79 },
80 });
81
@@ -126,7 +126,7 @@ origins is logged, so native tools keep working.
126 **Overload 1**
127
128 ```typescript
129 -async use(id: string, options: LocalToolsOptions & { mcp: true }, requestOptions?: ComposioRequestOptions): Promise<Session<TToolCollection, TTool, TProvider>>
129 +async use(id: string, options: { customTools?: CustomTool[]; customToolkits?: CustomToolkit[]; mcp: true }, requestOptions?: ComposioRequestOptions): Promise<Session<TToolCollection, TTool, TProvider>>
130 ```
131
132 **Parameters**
@@ -134,7 +134,7 @@ async use(id: string, options: LocalToolsOptions & { mcp: true }, requestOptions
134 | Name | Type | Description |
135 |------|------|-------------|
136 | `id` | `string` | \{string\} The id of the session to use |
137 -| `options` | `LocalToolsOptions & \{ mcp: true \}` | \{object\} Optional session reuse options |
137 +| `options` | `\{ customTools?: CustomTool[]; customToolkits?: CustomToolkit[]; mcp: true \}` | |
138 | `requestOptions?` | `ComposioRequestOptions` | |
139
140 **Returns**
@@ -144,7 +144,7 @@ async use(id: string, options: LocalToolsOptions & { mcp: true }, requestOptions
144 **Overload 2**
145
146 ```typescript
147 -async use(id: string, options?: LocalToolsOptions & { mcp?: boolean }, requestOptions?: ComposioRequestOptions): Promise<SessionWithoutMcp<TToolCollection, TTool, TProvider>>
147 +async use(id: string, options?: { customTools?: CustomTool[]; customToolkits?: CustomToolkit[]; mcp?: boolean }, requestOptions?: ComposioRequestOptions): Promise<SessionWithoutMcp<TToolCollection, TTool, TProvider>>
148 ```
149
150 **Parameters**
@@ -152,7 +152,7 @@ async use(id: string, options?: LocalToolsOptions & { mcp?: boolean }, requestOp
152 | Name | Type | Description |
153 |------|------|-------------|
154 | `id` | `string` | \{string\} The id of the session to use |
155 -| `options?` | `LocalToolsOptions & \{ mcp?: boolean \}` | \{object\} Optional session reuse options |
155 +| `options?` | `\{ customTools?: CustomTool[]; customToolkits?: CustomToolkit[]; mcp?: boolean \}` | |
156 | `requestOptions?` | `ComposioRequestOptions` | |
157
158 **Returns**
docs/content/reference/sdk-reference/typescript/tools.mdx
+4 -4
@@ -225,8 +225,8 @@ Retrieves a specific tool by its slug from the Composio API.
225 This method fetches a single tool in raw format without provider-specific wrapping,
226 providing direct access to the tool's schema and metadata. Tool versions are controlled
227 at the Composio SDK initialization level through the `toolkitVersions` configuration.
228 -Experimental local tools are session-scoped; attach them when creating or reusing a
229 -Tool Router session, then use `session.tools()`, `session.localTools()`, or
228 +Local experimental custom tools are session-scoped; attach them when creating or reusing a
229 +Tool Router session, then use `session.tools()`, `session.customTools()`, or
230 `session.execute()`.
231
232 ```typescript
@@ -288,9 +288,9 @@ console.log({
288 Lists Composio API tools available to the SDK.
289
290 This method fetches remote Composio tools from the API in raw format. The response can be
291 -filtered and modified as needed. Experimental local tools are session-scoped; attach
291 +filtered and modified as needed. Local experimental custom tools are session-scoped; attach
292 them when creating or reusing a Tool Router session, then use `session.tools()`,
293 -`session.localTools()`, or `session.execute()`.
293 +`session.customTools()`, or `session.execute()`.
294 It provides access to the underlying tool data without provider-specific wrapping.
295
296 ```typescript
python/CHANGELOG.md deleted
-13
@@ -1,13 +0,0 @@
1 -# @composio/python-sdk
2 -
3 -## 0.32.0
4 -
5 -### Minor Changes
6 -
7 -- e970677: Update `composio-client` to 2.1.0. Breaking (experimental API): `composio.experimental.custom_toolkits.create()` and `upsert()` take the MCP server URL as `mcp_url` instead of `app_url`.
8 -- e970677: Renames in-process custom tools to local tools, so they are no longer confused with the server-side custom toolkits on `composio.experimental.custom_toolkits`. Pass `experimental={"local_tools": ..., "local_toolkits": ...}` to `composio.create()`, and `local_tools=` and `local_toolkits=` to `composio.use()`. List them with `session.local_tools()` and `session.local_toolkits()`. The types are now `LocalTool`, `LocalToolkit`, `RegisteredLocalTool` and `RegisteredLocalToolkit`. The `custom_tools` and `custom_toolkits` options and session methods still work but emit `ComposioDeprecationWarning`, and the `Custom*` type names remain as aliases. Passing both a new option and its deprecated alias raises `InvalidParams`. The request sent to the API is unchanged.
9 -- e970677: `wait_for_connection()` handles rate limits: the delay between polls grows from 1 to 5 seconds, and a poll rejected with a 429 waits as long as its `Retry-After` header asks (up to the timeout) and polls again instead of failing the wait. A NaN timeout now times out instead of polling forever.
10 -
11 -### Patch Changes
12 -
13 -- e970677: The error for a missing API key now explains how to set `COMPOSIO_API_KEY` or pass `api_key=`, and links to where to get a project API key, instead of suggesting `composio login`, which the Python package doesn't install.
python/composio/__version__.py
+1 -1
@@ -1 +1 @@
1 -__version__ = "0.32.0"
1 +__version__ = "0.31.0"
python/package.json
+1 -1
@@ -1,5 +1,5 @@
1 {
2 "name": "@composio/python-sdk",
3 - "version": "0.32.0",
3 + "version": "0.31.0",
4 "private": true
5 }
python/providers/anthropic/pyproject.toml
+1 -1
@@ -1,6 +1,6 @@
1 [project]
2 name = "composio-anthropic"
3 -version = "0.32.0"
3 +version = "0.31.0"
4 description = "Use Composio to get an array of tools with your Anthropic LLMs."
5 readme = "README.md"
6 requires-python = ">=3.11,<3.16"
python/providers/anthropic/setup.py
+1 -1
@@ -8,7 +8,7 @@ from setuptools import setup
8
9 setup(
10 name="composio_anthropic",
11 - version="0.32.0",
11 + version="0.31.0",
12 author="Composio",
13 author_email="tech@composio.dev",
14 description="Use Composio to get an array of tools with your Anthropic LLMs.",
python/providers/autogen/pyproject.toml
+1 -1
@@ -1,6 +1,6 @@
1 [project]
2 name = "composio-autogen"
3 -version = "0.32.0"
3 +version = "0.31.0"
4 description = "Use Composio to get an array of tools with your autogen agent."
5 readme = "README.md"
6 requires-python = ">=3.11,<3.16"
python/providers/autogen/setup.py
+1 -1
@@ -8,7 +8,7 @@ from setuptools import setup
8
9 setup(
10 name="composio_autogen",
11 - version="0.32.0",
11 + version="0.31.0",
12 author="Composio",
13 author_email="tech@composio.dev",
14 description="Use Composio to get an array of tools with your Autogen agent.",
python/providers/claude_agent_sdk/pyproject.toml
+1 -1
@@ -1,6 +1,6 @@
1 [project]
2 name = "composio-claude-agent-sdk"
3 -version = "0.32.0"
3 +version = "0.31.0"
4 description = "Use Composio to get an array of tools with Claude Code Agents SDK."
5 readme = "README.md"
6 requires-python = ">=3.11,<3.16"
python/providers/claude_agent_sdk/setup.py
+1 -1
@@ -8,7 +8,7 @@ from setuptools import find_packages, setup
8
9 setup(
10 name="composio_claude_agent_sdk",
11 - version="0.32.0",
11 + version="0.31.0",
12 author="Composio",
13 author_email="tech@composio.dev",
14 description="Use Composio to get array of tools for Claude Agent SDK",
python/providers/crewai/pyproject.toml
+1 -1
@@ -1,6 +1,6 @@
1 [project]
2 name = "composio-crewai"
3 -version = "0.32.0"
3 +version = "0.31.0"
4 description = "Use Composio to get an array of tools with your CrewAI agent."
5 readme = "README.md"
6 requires-python = ">=3.11,<3.16"
python/providers/crewai/setup.py
+1 -1
@@ -6,7 +6,7 @@ from setuptools import setup
6
7 setup(
8 name="composio_crewai",
9 - version="0.32.0",
9 + version="0.31.0",
10 author="Composio",
11 author_email="tech@composio.dev",
12 description="Use Composio to get an array of tools with your CrewAI agent.",
python/providers/gemini/pyproject.toml
+1 -1
@@ -1,6 +1,6 @@
1 [project]
2 name = "composio-gemini"
3 -version = "0.32.0"
3 +version = "0.31.0"
4 description = "Use Composio to get an array of tools with your Gemini agent."
5 readme = "README.md"
6 requires-python = ">=3.11,<3.16"
python/providers/gemini/setup.py
+1 -1
@@ -8,7 +8,7 @@ from setuptools import setup
8
9 setup(
10 name="composio_gemini",
11 - version="0.32.0",
11 + version="0.31.0",
12 author="Composio",
13 author_email="tech@composio.dev",
14 description="Use Composio to get an array of tools with your Gemini agent.",
python/providers/google/pyproject.toml
+1 -1
@@ -1,6 +1,6 @@
1 [project]
2 name = "composio-google"
3 -version = "0.32.0"
3 +version = "0.31.0"
4 description = "Use Composio to get an array of tools with your Google AI Python Gemini model."
5 readme = "README.md"
6 requires-python = ">=3.11,<3.16"
python/providers/google/setup.py
+1 -1
@@ -8,7 +8,7 @@ from setuptools import setup
8
9 setup(
10 name="composio_google",
11 - version="0.32.0",
11 + version="0.31.0",
12 author="Composio",
13 author_email="tech@composio.dev",
14 description="Use Composio to get an array of tools with your Google AI Python Gemini model.",
python/providers/google_adk/pyproject.toml
+1 -1
@@ -1,6 +1,6 @@
1 [project]
2 name = "composio-google-adk"
3 -version = "0.32.0"
3 +version = "0.31.0"
4 description = "Use Composio to get an array of tools with your Google AI Python Gemini model."
5 readme = "README.md"
6 requires-python = ">=3.11,<3.16"
python/providers/google_adk/setup.py
+1 -1
@@ -8,7 +8,7 @@ from setuptools import setup
8
9 setup(
10 name="composio_google_adk",
11 - version="0.32.0",
11 + version="0.31.0",
12 author="Composio",
13 author_email="tech@composio.dev",
14 description="Use Composio to get an array of tools with your Google AI Python Gemini model.",
python/providers/langchain/pyproject.toml
+1 -1
@@ -1,6 +1,6 @@
1 [project]
2 name = "composio-langchain"
3 -version = "0.32.0"
3 +version = "0.31.0"
4 description = "Use Composio to get an array of tools with your Langchain agent."
5 readme = "README.md"
6 requires-python = ">=3.11,<3.16"
python/providers/langchain/setup.py
+1 -1
@@ -8,7 +8,7 @@ from setuptools import setup
8
9 setup(
10 name="composio_langchain",
11 - version="0.32.0",
11 + version="0.31.0",
12 author="composio",
13 author_email="tech@composio.dev",
14 description="Use Composio to get an array of tools with your Langchain agent.",
python/providers/langgraph/pyproject.toml
+1 -1
@@ -1,6 +1,6 @@
1 [project]
2 name = "composio-langgraph"
3 -version = "0.32.0"
3 +version = "0.31.0"
4 description = "Use Composio to get array of tools with LangGraph Agent Workflows."
5 readme = "README.md"
6 requires-python = ">=3.11,<3.16"
python/providers/langgraph/setup.py
+1 -1
@@ -8,7 +8,7 @@ from setuptools import setup
8
9 setup(
10 name="composio_langgraph",
11 - version="0.32.0",
11 + version="0.31.0",
12 author="composio",
13 author_email="tech@composio.dev",
14 description="Use Composio to get array of tools with LangGraph Agent Workflows",
python/providers/llamaindex/pyproject.toml
+1 -1
@@ -1,6 +1,6 @@
1 [project]
2 name = "composio-llamaindex"
3 -version = "0.32.0"
3 +version = "0.31.0"
4 description = "Use Composio to get array of tools with LlamaIndex Agent Workflows."
5 readme = "README.md"
6 requires-python = ">=3.11,<3.16"
python/providers/llamaindex/setup.py
+1 -1
@@ -8,7 +8,7 @@ from setuptools import setup
8
9 setup(
10 name="composio_llamaindex",
11 - version="0.32.0",
11 + version="0.31.0",
12 author="composio",
13 author_email="tech@composio.dev",
14 description="Use Composio to get array of tools with LlamaIndex Agent Workflows",
python/providers/openai/pyproject.toml
+1 -1
@@ -1,6 +1,6 @@
1 [project]
2 name = "composio-openai"
3 -version = "0.32.0"
3 +version = "0.31.0"
4 description = "Use Composio to get an array of tools with your OpenAI Function Call."
5 readme = "README.md"
6 requires-python = ">=3.11,<3.16"
python/providers/openai/setup.py
+1 -1
@@ -8,7 +8,7 @@ from setuptools import setup
8
9 setup(
10 name="composio_openai",
11 - version="0.32.0",
11 + version="0.31.0",
12 author="Composio",
13 author_email="tech@composio.dev",
14 description="Use Composio to get an array of tools with your OpenAI Function Call.",
python/providers/openai_agents/pyproject.toml
+1 -1
@@ -1,6 +1,6 @@
1 [project]
2 name = "composio-openai-agents"
3 -version = "0.32.0"
3 +version = "0.31.0"
4 description = "Use Composio to get array of strongly typed tools for OpenAI Agents"
5 readme = "README.md"
6 requires-python = ">=3.11,<3.16"
python/providers/openai_agents/setup.py
+1 -1
@@ -8,7 +8,7 @@ from setuptools import find_packages, setup
8
9 setup(
10 name="composio_openai_agents",
11 - version="0.32.0",
11 + version="0.31.0",
12 author="Composio",
13 author_email="tech@composio.dev",
14 description="Use Composio to get array of strongly typed tools for OpenAI Agents",
python/providers/typesafe/pyproject.toml
+1 -1
@@ -1,6 +1,6 @@
1 [project]
2 name = "composio-typesafe"
3 -version = "0.32.0"
3 +version = "0.31.0"
4 description = "Use Composio tools with TypeSafe's Jev model: a tool call, a partial call, or an abstention, each with a confidence score."
5 readme = "README.md"
6 requires-python = ">=3.11,<3.16"
python/providers/typesafe/setup.py
+1 -1
@@ -8,7 +8,7 @@ from setuptools import setup
8
9 setup(
10 name="composio_typesafe",
11 - version="0.32.0",
11 + version="0.31.0",
12 author="Composio",
13 author_email="tech@composio.dev",
14 description="Use Composio tools with TypeSafe's Jev model: a tool call, a partial call, or an abstention, each with a confidence score.",
python/pyproject.toml
+1 -1
@@ -1,6 +1,6 @@
1 [project]
2 name = "composio"
3 -version = "0.32.0"
3 +version = "0.31.0"
4 description = "SDK for integrating Composio with your applications."
5 readme = "README.md"
6 requires-python = ">=3.11,<3.16"
ts/packages/core/CHANGELOG.md
-12
@@ -1,17 +1,5 @@
1 # @composio/core
2
3 -## 0.29.0
4 -
5 -### Minor Changes
6 -
7 -- ab90421: Breaking (experimental API): `composio.experimental.customToolkits.create()` and `upsert()` take the MCP server URL as `mcpUrl` instead of `appUrl`, and send it to the API as `mcp_url`.
8 -- b53b07a: Renames in-process custom tools to local tools, so they are no longer confused with the server-side custom toolkits on `composio.experimental.customToolkits`. Pass `experimental.localTools` and `experimental.localToolkits` to `composio.create()`, and `localTools` and `localToolkits` to `composio.use()`. List them with `session.localTools()` and `session.localToolkits()`. The types are now `LocalTool`, `LocalToolkit`, `RegisteredLocalTool`, `RegisteredLocalToolkit`, `CreateLocalToolParams`, `CreateLocalToolkitParams` and `LocalToolExecuteFn`. The `customTools` and `customToolkits` options, the `session.customTools()` and `session.customToolkits()` methods, and the `Custom*` type names are deprecated and keep working. Passing both a new option and its deprecated alias throws `ValidationError`. The request sent to the API is unchanged.
9 -- c7ee771: Handle rate limits better: `tools.execute()` reuses tool schemas instead of fetching one per call, `waitForConnection()` backs off between polls and waits out a 429, and tool fetches and executions rejected with a 429 throw `ComposioToolFetchRateLimitError` or `ComposioToolExecutionRateLimitError` (check with `isComposioRateLimitError`).
10 -
11 -### Patch Changes
12 -
13 -- ab90421: Update @composio/client to 2.1.0 to include the latest API changes.
14 -
3 ## 0.28.0
4
5 ### Minor Changes
ts/packages/core/package.json
+1 -1
@@ -4,7 +4,7 @@
4 "engines": {
5 "node": ">=22.22.3"
6 },
7 - "version": "0.29.0",
7 + "version": "0.28.0",
8 "description": "",
9 "main": "src/index.ts",
10 "publishConfig": {
ts/packages/slim/CHANGELOG.md
-7
@@ -1,12 +1,5 @@
1 # @composio/slim
2
3 -## 0.29.0
4 -
5 -### Minor Changes
6 -
7 -- ab90421: Breaking (experimental API): `composio.experimental.customToolkits.create()` and `upsert()` take the MCP server URL as `mcpUrl` instead of `appUrl`, and send it to the API as `mcp_url`.
8 -- b53b07a: Renames in-process custom tools to local tools, so they are no longer confused with the server-side custom toolkits on `composio.experimental.customToolkits`. Pass `experimental.localTools` and `experimental.localToolkits` to `composio.create()`, and `localTools` and `localToolkits` to `composio.use()`. List them with `session.localTools()` and `session.localToolkits()`. The types are now `LocalTool`, `LocalToolkit`, `RegisteredLocalTool`, `RegisteredLocalToolkit`, `CreateLocalToolParams`, `CreateLocalToolkitParams` and `LocalToolExecuteFn`. The `customTools` and `customToolkits` options, the `session.customTools()` and `session.customToolkits()` methods, and the `Custom*` type names are deprecated and keep working. Passing both a new option and its deprecated alias throws `ValidationError`. The request sent to the API is unchanged.
9 -
3 ## 0.28.0
4
5 ### Minor Changes
ts/packages/slim/package.json
+1 -1
@@ -4,7 +4,7 @@
4 "engines": {
5 "node": ">=22.22.3"
6 },
7 - "version": "0.29.0",
7 + "version": "0.28.0",
8 "description": "Slim Composio core package without packaged source or docs",
9 "main": "dist/index.mjs",
10 "publishConfig": {
uv.lock
+8 -8
@@ -490,7 +490,7 @@ wheels = [
490
491 [[package]]
492 name = "composio"
493 -version = "0.32.0"
493 +version = "0.31.0"
494 source = { editable = "python" }
495 dependencies = [
496 { name = "certifi" },
@@ -571,7 +571,7 @@ release = [
571
572 [[package]]
573 name = "composio-anthropic"
574 -version = "0.32.0"
574 +version = "0.31.0"
575 source = { editable = "python/providers/anthropic" }
576 dependencies = [
577 { name = "anthropic" },
@@ -600,7 +600,7 @@ wheels = [
600
601 [[package]]
602 name = "composio-gemini"
603 -version = "0.32.0"
603 +version = "0.31.0"
604 source = { virtual = "python/providers/gemini" }
605 dependencies = [
606 { name = "composio" },
@@ -615,7 +615,7 @@ requires-dist = [
615
616 [[package]]
617 name = "composio-google"
618 -version = "0.32.0"
618 +version = "0.31.0"
619 source = { editable = "python/providers/google" }
620 dependencies = [
621 { name = "composio" },
@@ -630,7 +630,7 @@ requires-dist = [
630
631 [[package]]
632 name = "composio-google-adk"
633 -version = "0.32.0"
633 +version = "0.31.0"
634 source = { editable = "python/providers/google_adk" }
635 dependencies = [
636 { name = "composio" },
@@ -645,7 +645,7 @@ requires-dist = [
645
646 [[package]]
647 name = "composio-langchain"
648 -version = "0.32.0"
648 +version = "0.31.0"
649 source = { editable = "python/providers/langchain" }
650 dependencies = [
651 { name = "composio" },
@@ -660,7 +660,7 @@ requires-dist = [
660
661 [[package]]
662 name = "composio-openai"
663 -version = "0.32.0"
663 +version = "0.31.0"
664 source = { editable = "python/providers/openai" }
665 dependencies = [
666 { name = "composio" },
@@ -675,7 +675,7 @@ requires-dist = [
675
676 [[package]]
677 name = "composio-openai-agents"
678 -version = "0.32.0"
678 +version = "0.31.0"
679 source = { editable = "python/providers/openai_agents" }
680 dependencies = [
681 { name = "composio" },