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" },