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

chore(release): publish SDK packages (#5278)

<!-- sdk-release-note-exempt: This release PR applies previously reviewed SDK changes and only updates release metadata and generated documentation. --> A stable release: npm moves `latest` to these versions. ## What gets released | Package | Version | Bump | Changesets | | --- | --- | --- | --- | | `@composio/core` | 0.28.0 → **0.29.0** | minor | `composio-client-update`, `custom-toolkit-mcp-url`, `local-tools-rename`, `sdk-rate-limit-handling` | | Python SDK (`composio` and every provider) | 0.31.0 → **0.32.0** | minor | `python-client-2-1-0`, `python-local-tools-rename`, `python-missing-api-key-message`, `python-rate-limit-handling` | | `@composio/slim` | 0.28.0 → **0.29.0** | minor | `custom-toolkit-mcp-url`, `local-tools-rename` | ## Changesets consumed - `.changeset/composio-client-update.md` (`@composio/core` patch): Update @composio/client to 2.1.0 to include the latest API changes. - `.changeset/custom-toolkit-mcp-url.md` (`@composio/core` minor, `@composio/slim` minor): 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` (`@composio/core` minor, `@composio/slim` minor): 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 \`expe… - `.changeset/python-client-2-1-0.md` (Python SDK (`composio` and every provider) minor): 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` (Python SDK (`composio` and every provider) minor): 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": ...,… - `.changeset/python-missing-api-key-message.md` (Python SDK (`composio` and every provider) patch): 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 pa… - `.changeset/python-rate-limit-handling.md` (Python SDK (`composio` and every provider) minor): \`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 p… - `.changeset/sdk-rate-limit-handling.md` (`@composio/core` minor): 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 r… ## Changelog and docs edits - Docs changelog entry: [`docs/content/changelog/11-09-26-sdk-42589989280.mdx`](https://github.com/ComposioHQ/composio/blob/sdk-release/batch-42589989280/docs/content/changelog/11-09-26-sdk-42589989280.mdx). - Package changelogs: [`python/CHANGELOG.md`](https://github.com/ComposioHQ/composio/blob/sdk-release/batch-42589989280/python/CHANGELOG.md), [`ts/packages/core/CHANGELOG.md`](https://github.com/ComposioHQ/composio/blob/sdk-release/batch-42589989280/ts/packages/core/CHANGELOG.md), [`ts/packages/slim/CHANGELOG.md`](https://github.com/ComposioHQ/composio/blob/sdk-release/batch-42589989280/ts/packages/slim/CHANGELOG.md). - Regenerated API references: [`docs/content/reference/sdk-reference/python/`](https://github.com/ComposioHQ/composio/tree/sdk-release/batch-42589989280/docs/content/reference/sdk-reference/python/), [`docs/content/reference/sdk-reference/typescript/`](https://github.com/ComposioHQ/composio/tree/sdk-release/batch-42589989280/docs/content/reference/sdk-reference/typescript/). ## How this ships 1. Release source is frozen at f22ab26848dbcc600131fb0b1d7261ab576ebb48. Later `next` commits and their changesets wait for the next release. 2. Review the diff and approve this head. Approval must come from a writer other than the requester (@jkomyno). Do not push to this branch: the tag step only accepts the release bot's commit. To change the notes, fix the changesets on `next`, close this PR and request a new release. 3. After approval and green checks, merge this PR. The release workflow rechecks the approval and tags this exact head `sdk-release/42589989280`; if the check fails, it creates no tag and asks you to revert this PR and request the release again. 4. The tag run publishes the exact files the `SDK candidate` checks built and the `SDK candidate smoke` checks installed on this PR. If a publish job fails, use "Re-run failed jobs" on that run. 5. After publishing, the bot opens a docs PR that pins the released npm versions, so twoslash checks the docs against them. Request: https://github.com/ComposioHQ/composio/issues/5277 Planning run: https://github.com/ComposioHQ/composio/actions/runs/42589989280 Co-authored-by: sdkrelease[bot] <294075132+sdkrelease[bot]@users.noreply.github.com>

sdkrelease[bot] committed Nov 9, 2026 at 13:32 UTC 5738b0d59bab9aced57332a834a9fda7757fe108
54 files changed +399 -115
.changeset/composio-client-update.md deleted
-5
@@ -1,5 +0,0 @@
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 deleted
-6
@@ -1,6 +0,0 @@
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 deleted
-6
@@ -1,6 +0,0 @@
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 deleted
-5
@@ -1,5 +0,0 @@
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 deleted
-5
@@ -1,5 +0,0 @@
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 deleted
-5
@@ -1,5 +0,0 @@
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 deleted
-5
@@ -1,5 +0,0 @@
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 deleted
-5
@@ -1,5 +0,0 @@
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 new
+186
@@ -0,0 +1,186 @@
1 +{
2 + "id": "42589989280",
3 + "inputBase": "f22ab26848dbcc600131fb0b1d7261ab576ebb48",
4 + "requestedBy": "jkomyno",
5 + "issue": 5277,
6 + "date": "2026-11-09",
7 + "plan": {
8 + "schemaVersion": 1,
9 + "inputFingerprint": "ca87e5d8d9b4b77af52b8258910a562e111182fb3bb36d2567068d7352ea091b",
10 + "choices": {
11 + "typescript": "auto",
12 + "python": "auto",
13 + "channel": "stable",
14 + "run": "42589989280"
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-09-26-sdk-42589989280.mdx new
+34
@@ -0,0 +1,34 @@
1 +---
2 +title: "SDK release 42589989280"
3 +date: "2026-11-09"
4 +sdkRelease: "42589989280"
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/5277) 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#L355)
265 +[View source](https://github.com/composiohq/composio/blob/next/python/composio/core/models/connected_accounts.py#L396)
docs/content/reference/sdk-reference/python/session.mdx
+38 -4
@@ -170,9 +170,43 @@ 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 +
207 ### custom_tools()
208
175 -List all custom tools registered in this session. Returns tools with their final slugs, schemas, and resolved toolkit.
209 +Deprecated alias for `local_tools`.
210
211 ```python
212 def custom_tools(toolkit: str | None = ...) -> List[RegisteredCustomTool]
@@ -186,13 +220,13 @@ def custom_tools(toolkit: str | None = ...) -> List[RegisteredCustomTool]
220
221 **Returns**
222
189 -`List[RegisteredCustomTool]` — Array of registered custom tools
223 +`List[RegisteredCustomTool]`
224
225 ---
226
227 ### custom_toolkits()
228
195 -List all custom toolkits registered in this session. Returns toolkits with their tools showing final slugs.
229 +Deprecated alias for `local_toolkits`.
230
231 ```python
232 def custom_toolkits() -> List[RegisteredCustomToolkit]
@@ -310,4 +344,4 @@ def delete() -> ToolRouterSessionDeleteResponse
344
345 ---
346
313 -[View source](https://github.com/composiohq/composio/blob/next/python/composio/core/models/tool_router_session.py#L311)
347 +[View source](https://github.com/composiohq/composio/blob/next/python/composio/core/models/tool_router_session.py#L322)
docs/content/reference/sdk-reference/python/triggers.mdx
+4 -2
@@ -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] = ...) -> 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] = ..., type: Literal['webhook', 'poll' | None] = ..., polling_interval: int | None = ...) -> trigger_instance_upsert_response.TriggerInstanceUpsertRes...
104 ```
105
106 **Parameters**
@@ -111,10 +111,12 @@ 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` |
116
117 **Returns**
118
117 -`trigger_instance_upsert_response.TriggerInstanceUpsertRes...` — The trigger instance
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`
120
121 ---
122
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` | `(id: string, options: \{ customToolkits?: CustomToolkit[]; customTools?: CustomTool[]; mcp: true \}, requestOptions: ComposioRequestOptions) => Promise<Session>` | Use an existing tool router session |
69 +| `use` | `(...) => 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 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.
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.
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. `appUrl`,
23 +project, or to a user ID to make it private to that user. `mcpUrl`,
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 - appUrl: 'https://mcp.internal.example.com/mcp',
48 + mcpUrl: '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 -`appUrl` and `authSchemes` cannot change on an existing toolkit:
172 +`mcpUrl` 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 - appUrl: 'https://mcp.internal.example.com/mcp',
198 + mcpUrl: '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
+48 -10
@@ -52,28 +52,30 @@ async authorize(toolkit: string, options?: { callbackUrl?: string; alias?: strin
52
53 ---
54
55 -### customToolkits()
55 +### customToolkits() (deprecated)
56
57 -List all custom toolkits registered in this session.
58 -Returns toolkits with their tools showing final slugs.
57 +<Callout type="warn" title="Deprecated">
58 +Use `localToolkits()` instead.
59 +</Callout>
60
61 ```typescript
61 -customToolkits(): RegisteredCustomToolkit[]
62 +customToolkits(): RegisteredLocalToolkit[]
63 ```
64
65 **Returns**
66
66 -`RegisteredCustomToolkit[]` — Array of registered custom toolkits
67 +`RegisteredLocalToolkit[]`
68
69 ---
70
70 -### customTools()
71 +### customTools() (deprecated)
72
72 -List all custom tools registered in this session.
73 -Returns tools with their final slugs, schemas, and resolved toolkit.
73 +<Callout type="warn" title="Deprecated">
74 +Use `localTools()` instead.
75 +</Callout>
76
77 ```typescript
76 -customTools(options?: { toolkit?: string }): RegisteredCustomTool[]
78 +customTools(options?: { toolkit?: string }): RegisteredLocalTool[]
79 ```
80
81 **Parameters**
@@ -84,7 +86,7 @@ customTools(options?: { toolkit?: string }): RegisteredCustomTool[]
86
87 **Returns**
88
87 -`RegisteredCustomTool[]` — Array of registered custom tools
89 +`RegisteredLocalTool[]`
90
91 ---
92
@@ -247,6 +249,42 @@ console.log(items[1].config.toolkits);
249
250 ---
251
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 +
288 ### proxyExecute()
289
290 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 - customTools: [myCustomTool],
78 - customToolkits: [myToolkit],
77 + localTools: [myLocalTool],
78 + localToolkits: [myLocalToolkit],
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: { customTools?: CustomTool[]; customToolkits?: CustomToolkit[]; mcp: true }, requestOptions?: ComposioRequestOptions): Promise<Session<TToolCollection, TTool, TProvider>>
129 +async use(id: string, options: LocalToolsOptions & { mcp: true }, requestOptions?: ComposioRequestOptions): Promise<Session<TToolCollection, TTool, TProvider>>
130 ```
131
132 **Parameters**
@@ -134,7 +134,7 @@ async use(id: string, options: { customTools?: CustomTool[]; customToolkits?: Cu
134 | Name | Type | Description |
135 |------|------|-------------|
136 | `id` | `string` | \{string\} The id of the session to use |
137 -| `options` | `\{ customTools?: CustomTool[]; customToolkits?: CustomToolkit[]; mcp: true \}` | |
137 +| `options` | `LocalToolsOptions & \{ mcp: true \}` | \{object\} Optional session reuse options |
138 | `requestOptions?` | `ComposioRequestOptions` | |
139
140 **Returns**
@@ -144,7 +144,7 @@ async use(id: string, options: { customTools?: CustomTool[]; customToolkits?: Cu
144 **Overload 2**
145
146 ```typescript
147 -async use(id: string, options?: { customTools?: CustomTool[]; customToolkits?: CustomToolkit[]; mcp?: boolean }, requestOptions?: ComposioRequestOptions): Promise<SessionWithoutMcp<TToolCollection, TTool, TProvider>>
147 +async use(id: string, options?: LocalToolsOptions & { mcp?: boolean }, requestOptions?: ComposioRequestOptions): Promise<SessionWithoutMcp<TToolCollection, TTool, TProvider>>
148 ```
149
150 **Parameters**
@@ -152,7 +152,7 @@ async use(id: string, options?: { customTools?: CustomTool[]; customToolkits?: C
152 | Name | Type | Description |
153 |------|------|-------------|
154 | `id` | `string` | \{string\} The id of the session to use |
155 -| `options?` | `\{ customTools?: CustomTool[]; customToolkits?: CustomToolkit[]; mcp?: boolean \}` | |
155 +| `options?` | `LocalToolsOptions & \{ mcp?: boolean \}` | \{object\} Optional session reuse options |
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 -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
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
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. Local experimental custom tools are session-scoped; attach
291 +filtered and modified as needed. Experimental local tools are session-scoped; attach
292 them when creating or reusing a Tool Router session, then use `session.tools()`,
293 -`session.customTools()`, or `session.execute()`.
293 +`session.localTools()`, or `session.execute()`.
294 It provides access to the underlying tool data without provider-specific wrapping.
295
296 ```typescript
python/CHANGELOG.md new
+13
@@ -0,0 +1,13 @@
1 +# @composio/python-sdk
2 +
3 +## 0.32.0
4 +
5 +### Minor Changes
6 +
7 +- f22ab26: 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 +- f22ab26: 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 +- f22ab26: `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 +- f22ab26: 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.31.0"
1 +__version__ = "0.32.0"
python/package.json
+1 -1
@@ -1,5 +1,5 @@
1 {
2 "name": "@composio/python-sdk",
3 - "version": "0.31.0",
3 + "version": "0.32.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.31.0"
3 +version = "0.32.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.31.0",
11 + version="0.32.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.31.0"
3 +version = "0.32.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.31.0",
11 + version="0.32.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.31.0"
3 +version = "0.32.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.31.0",
11 + version="0.32.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.31.0"
3 +version = "0.32.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.31.0",
9 + version="0.32.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.31.0"
3 +version = "0.32.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.31.0",
11 + version="0.32.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.31.0"
3 +version = "0.32.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.31.0",
11 + version="0.32.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.31.0"
3 +version = "0.32.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.31.0",
11 + version="0.32.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.31.0"
3 +version = "0.32.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.31.0",
11 + version="0.32.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.31.0"
3 +version = "0.32.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.31.0",
11 + version="0.32.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.31.0"
3 +version = "0.32.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.31.0",
11 + version="0.32.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.31.0"
3 +version = "0.32.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.31.0",
11 + version="0.32.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.31.0"
3 +version = "0.32.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.31.0",
11 + version="0.32.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.31.0"
3 +version = "0.32.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.31.0",
11 + version="0.32.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.31.0"
3 +version = "0.32.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,5 +1,17 @@
1 # @composio/core
2
3 +## 0.29.0
4 +
5 +### Minor Changes
6 +
7 +- f22ab26: 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 +- f22ab26: 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 +- f22ab26: 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 +- f22ab26: Update @composio/client to 2.1.0 to include the latest API changes.
14 +
15 ## 0.28.0
16
17 ### Minor Changes
ts/packages/core/package.json
+1 -1
@@ -4,7 +4,7 @@
4 "engines": {
5 "node": ">=22.22.3"
6 },
7 - "version": "0.28.0",
7 + "version": "0.29.0",
8 "description": "",
9 "main": "src/index.ts",
10 "publishConfig": {
ts/packages/slim/CHANGELOG.md
+7
@@ -1,5 +1,12 @@
1 # @composio/slim
2
3 +## 0.29.0
4 +
5 +### Minor Changes
6 +
7 +- f22ab26: 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 +- f22ab26: 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 +
10 ## 0.28.0
11
12 ### Minor Changes
ts/packages/slim/package.json
+1 -1
@@ -4,7 +4,7 @@
4 "engines": {
5 "node": ">=22.22.3"
6 },
7 - "version": "0.28.0",
7 + "version": "0.29.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.31.0"
493 +version = "0.32.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.31.0"
574 +version = "0.32.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.31.0"
603 +version = "0.32.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.31.0"
618 +version = "0.32.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.31.0"
633 +version = "0.32.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.31.0"
648 +version = "0.32.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.31.0"
663 +version = "0.32.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.31.0"
678 +version = "0.32.0"
679 source = { editable = "python/providers/openai_agents" }
680 dependencies = [
681 { name = "composio" },