@devries-cameron20 / composio Mirror · read-only / commits / 3e73dad32
Fork 0

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

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

Synced Nov 21, 03:37 UTC

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

<!-- 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/anthropic` | 0.11.7 → **0.11.8** | patch | `anthropic-tool-result-correlation`, `tidy-dependency-consolidation` | | `@composio/claude-agent-sdk` | 0.13.0 → **0.13.1** | patch | `tidy-dependency-consolidation` | | `@composio/core` | 0.29.0 → **0.30.0** | minor | `all-bags-begin`, `composio-client-update`, `custom-toolkits-top-level`, `files-request-cancellation`, `fix-connection-polling-deadline`, `session-execution-types`, `tidy-dependency-consolidation`, `tolerate-malformed-tool-schemas`, `tool-error-details-parity`, `tool-execution-error-details`, `trigger-toolkit-filter-underscore` | | `@composio/experimental` | 0.2.8 → **0.2.9** | patch | `tidy-dependency-consolidation` | | `@composio/google` | 0.12.0 → **0.13.0** | minor | `google-parameters-json-schema` | | `@composio/json-schema-to-zod` | 0.4.0 → **0.4.1** | patch | `tidy-dependency-consolidation` | | `@composio/langchain` | 0.11.2 → **0.11.3** | patch | `tidy-dependency-consolidation` | | `@composio/mastra` | 0.10.6 → **0.10.7** | patch | `tidy-dependency-consolidation` | | `@composio/openai-agents` | 0.11.2 → **0.11.3** | patch | `openai-agents-dependency-compatibility` | | Python SDK (`composio` and every provider) | 0.32.0 → **0.33.0** | minor | `anthropic-tool-result-correlation`, `blocked-session-result-type`, `claude-agent-sdk-wheel-tests`, `composio-client-update`, `custom-tool-coroutine-check`, `custom-toolkits-top-level`, `fix-connection-polling-deadline`, `google-python-vertex-schema`, `openai-agents-dependency-compatibility`, `python-trigger-toolkit-filter-underscore`, `session-execution-types`, `tidy-dependency-consolidation`, `tool-error-details-parity` | | `@composio/slim` | 0.29.0 → **0.30.0** | minor | `all-bags-begin`, `custom-toolkits-top-level`, `session-execution-types`, `tidy-dependency-consolidation` | | `@composio/typesafe` | 0.1.1 → **0.1.2** | patch | `tidy-dependency-consolidation` | ## Changesets consumed - `.changeset/all-bags-begin.md` (`@composio/core` patch, `@composio/slim` patch): Allow \`RemoteFile.save\(\)\` to save to an explicit path when the home directory cannot be resolved. - `.changeset/anthropic-tool-result-correlation.md` (Python SDK (`composio` and every provider) patch, `@composio/anthropic` patch): Preserve the originating \`tool\_use\_id\` in Python Anthropic tool results and retain session execution status, log IDs, and returned Instant charges in provider execution results. Clarify the TypeScrip… - `.changeset/blocked-session-result-type.md` (Python SDK (`composio` and every provider) patch): Include \`blocked\` in the Python session execution result type so blocked results can be parsed by \`ToolRouterSessionExecuteResponse\`. - `.changeset/claude-agent-sdk-wheel-tests.md` (Python SDK (`composio` and every provider) patch): Exclude the Claude Agent SDK provider's tests package from its wheel to avoid shadowing consuming projects' tests. - `.changeset/composio-client-update.md` (`@composio/core` patch, Python SDK (`composio` and every provider) patch): Update the API client dependencies to 2.1.33 to include the latest API changes. - `.changeset/custom-tool-coroutine-check.md` (Python SDK (`composio` and every provider) patch): Stop emitting a \`DeprecationWarning\` on Python 3.14+ when registering custom tools. The async-function check now uses \`inspect.iscoroutinefunction\`, and async tools are still rejected as before. - `.changeset/custom-toolkits-top-level.md` (`@composio/core` minor, `@composio/slim` minor, Python SDK (`composio` and every provider) minor): Custom toolkits are no longer experimental. Use \`composio.customToolkits\` in TypeScript and \`composio.custom\_toolkits\` in Python. \`composio.experimental.customToolkits\` and \`composio.experimental.cus… - `.changeset/files-request-cancellation.md` (`@composio/core` patch): Let \`composio.files.upload\(\)\` and \`composio.files.download\(\)\` be cancelled. Both now accept trailing request options \(\`{ signal }\`\), like the other SDK methods that do HTTP I/O. The signal reaches th… - `.changeset/fix-connection-polling-deadline.md` (`@composio/core` patch, Python SDK (`composio` and every provider) patch): Stop connection polling at the deadline after a rate-limited response. When a \`429\` with \`Retry-After\` reaches the timeout, \`waitForConnection\(\)\` and \`wait\_for\_connection\(\)\` now time out instead of s… - `.changeset/google-parameters-json-schema.md` (`@composio/google` minor): Fix Gemini rejecting Composio tools with a 400 such as \`Unknown name "examples"\`. \`wrapTool\` and \`wrapTools\` now put each tool's schema in \`parametersJsonSchema\` instead of \`parameters\`, so JSON Sche… - `.changeset/google-python-vertex-schema.md` (Python SDK (`composio` and every provider) patch): Fix \`composio\_google\` raising \`ParseError\` while wrapping tools whose schemas use JSON Schema keywords outside the Vertex AI \`Schema\` subset, such as \`human\_parameter\_name\`, \`examples\`, \`const\`, \`one… - `.changeset/openai-agents-dependency-compatibility.md` (`@composio/openai-agents` patch, Python SDK (`composio` and every provider) patch): Allow OpenAI Agents SDK 0.21 in the TypeScript provider's peer dependencies. Require composio 0.32.0 or newer for the Python OpenAI Agents provider so installs cannot retain an older core. - `.changeset/python-trigger-toolkit-filter-underscore.md` (Python SDK (`composio` and every provider) patch): Match the \`toolkit\` filter of trigger subscriptions for toolkits whose slug contains an underscore - `.changeset/session-execution-types.md` (`@composio/core` patch, `@composio/slim` patch, Python SDK (`composio` and every provider) patch): Use generated client types for inline local-tool payloads and share Python result handling between session tool and meta-tool execution. Public methods and request and response shapes are unchanged. - `.changeset/tidy-dependency-consolidation.md` (`@composio/core` patch, `@composio/slim` patch, `@composio/experimental` patch, `@composio/json-schema-to-zod` patch, `@composio/anthropic` patch, `@composio/claude-agent-sdk` patch, `@composio/mastra` patch, `@composio/langchain` patch, `@composio/typesafe` patch, Python SDK (`composio` and every provider) patch): Update runtime dependencies, require patched Zod 4 releases where used directly, support Anthropic SDK 1.6, and update the AutoGen provider's FLAML dependency. Preserve Zod 3 compatibility fixtures a… - `.changeset/tolerate-malformed-tool-schemas.md` (`@composio/core` patch): Tolerate malformed tool schemas instead of failing a whole toolkit's tool list. \`getRawComposioTools\` and the raw list path previously ran every tool's parameters through the strict schema validator … - `.changeset/tool-error-details-parity.md` (`@composio/core` minor, Python SDK (`composio` and every provider) minor): Surface the server's error details on every API failure, not only the default \`tools.execute\` path. - `.changeset/tool-execution-error-details.md` (`@composio/core` minor): Surface the API's error details when \`tools.execute\` fails. \`ComposioError\` now declares \`statusCode\` and \`requestId\`, read from the \`@composio/client\` \`APIError\` it wraps unless passed explicitly, a… - `.changeset/trigger-toolkit-filter-underscore.md` (`@composio/core` patch): Match the \`toolkits\` filter of \`triggers.subscribe\(\)\` for toolkits whose slug contains an underscore ## Changelog and docs edits - Docs changelog entry: [`docs/content/changelog/11-17-26-sdk-44070813467.mdx`](https://github.com/ComposioHQ/composio/blob/sdk-release/batch-44070813467/docs/content/changelog/11-17-26-sdk-44070813467.mdx). - Package changelogs: [`python/CHANGELOG.md`](https://github.com/ComposioHQ/composio/blob/sdk-release/batch-44070813467/python/CHANGELOG.md), [`ts/packages/core/CHANGELOG.md`](https://github.com/ComposioHQ/composio/blob/sdk-release/batch-44070813467/ts/packages/core/CHANGELOG.md), [`ts/packages/experimental/CHANGELOG.md`](https://github.com/ComposioHQ/composio/blob/sdk-release/batch-44070813467/ts/packages/experimental/CHANGELOG.md), [`ts/packages/json-schema-to-zod/CHANGELOG.md`](https://github.com/ComposioHQ/composio/blob/sdk-release/batch-44070813467/ts/packages/json-schema-to-zod/CHANGELOG.md), [`ts/packages/providers/anthropic/CHANGELOG.md`](https://github.com/ComposioHQ/composio/blob/sdk-release/batch-44070813467/ts/packages/providers/anthropic/CHANGELOG.md), [`ts/packages/providers/claude-agent-sdk/CHANGELOG.md`](https://github.com/ComposioHQ/composio/blob/sdk-release/batch-44070813467/ts/packages/providers/claude-agent-sdk/CHANGELOG.md), [`ts/packages/providers/google/CHANGELOG.md`](https://github.com/ComposioHQ/composio/blob/sdk-release/batch-44070813467/ts/packages/providers/google/CHANGELOG.md), [`ts/packages/providers/langchain/CHANGELOG.md`](https://github.com/ComposioHQ/composio/blob/sdk-release/batch-44070813467/ts/packages/providers/langchain/CHANGELOG.md), [`ts/packages/providers/mastra/CHANGELOG.md`](https://github.com/ComposioHQ/composio/blob/sdk-release/batch-44070813467/ts/packages/providers/mastra/CHANGELOG.md), [`ts/packages/providers/openai-agents/CHANGELOG.md`](https://github.com/ComposioHQ/composio/blob/sdk-release/batch-44070813467/ts/packages/providers/openai-agents/CHANGELOG.md), [`ts/packages/providers/typesafe/CHANGELOG.md`](https://github.com/ComposioHQ/composio/blob/sdk-release/batch-44070813467/ts/packages/providers/typesafe/CHANGELOG.md), [`ts/packages/slim/CHANGELOG.md`](https://github.com/ComposioHQ/composio/blob/sdk-release/batch-44070813467/ts/packages/slim/CHANGELOG.md). - Regenerated API references: [`docs/content/reference/sdk-reference/python/`](https://github.com/ComposioHQ/composio/tree/sdk-release/batch-44070813467/docs/content/reference/sdk-reference/python/), [`docs/content/reference/sdk-reference/typescript/`](https://github.com/ComposioHQ/composio/tree/sdk-release/batch-44070813467/docs/content/reference/sdk-reference/typescript/). ## How this ships 1. Release source is frozen at 63fda4e63479824c73cd689b5593722590174656. 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/44070813467`; 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/5437 Planning run: https://github.com/ComposioHQ/composio/actions/runs/44070813467 Co-authored-by: sdkrelease[bot] <294075132+sdkrelease[bot]@users.noreply.github.com>

sdkrelease[bot] committed Nov 17, 2026 at 19:46 UTC 3e73dad323445fabd9e26af9840553f9bc9b913c
74 files changed +728 -239
.changeset/all-bags-begin.md deleted
-6
@@ -1,6 +0,0 @@
1 ----
2 -'@composio/core': patch
3 -'@composio/slim': patch
4 ----
5 -
6 -Allow `RemoteFile.save()` to save to an explicit path when the home directory cannot be resolved.
.changeset/anthropic-tool-result-correlation.md deleted
-6
@@ -1,6 +0,0 @@
1 ----
2 -'@composio/python-sdk': patch
3 -'@composio/anthropic': patch
4 ----
5 -
6 -Preserve the originating `tool_use_id` in Python Anthropic tool results and retain session execution status, log IDs, and returned Instant charges in provider execution results. Clarify the TypeScript Anthropic helpers' existing result projection and message correlation in their API documentation.
.changeset/blocked-session-result-type.md deleted
-5
@@ -1,5 +0,0 @@
1 ----
2 -'@composio/python-sdk': patch
3 ----
4 -
5 -Include `blocked` in the Python session execution result type so blocked results can be parsed by `ToolRouterSessionExecuteResponse`.
.changeset/claude-agent-sdk-wheel-tests.md deleted
-5
@@ -1,5 +0,0 @@
1 ----
2 -'@composio/python-sdk': patch
3 ----
4 -
5 -Exclude the Claude Agent SDK provider's tests package from its wheel to avoid shadowing consuming projects' tests.
.changeset/composio-client-update.md deleted
-6
@@ -1,6 +0,0 @@
1 ----
2 -'@composio/core': patch
3 -'@composio/python-sdk': patch
4 ----
5 -
6 -Update the API client dependencies to 2.1.33 to include the latest API changes.
.changeset/custom-tool-coroutine-check.md deleted
-5
@@ -1,5 +0,0 @@
1 ----
2 -'@composio/python-sdk': patch
3 ----
4 -
5 -Stop emitting a `DeprecationWarning` on Python 3.14+ when registering custom tools. The async-function check now uses `inspect.iscoroutinefunction`, and async tools are still rejected as before.
.changeset/custom-toolkits-top-level.md deleted
-7
@@ -1,7 +0,0 @@
1 ----
2 -'@composio/core': minor
3 -'@composio/slim': minor
4 -'@composio/python-sdk': minor
5 ----
6 -
7 -Custom toolkits are no longer experimental. Use `composio.customToolkits` in TypeScript and `composio.custom_toolkits` in Python. `composio.experimental.customToolkits` and `composio.experimental.custom_toolkits` are deprecated aliases of the same object and keep working. Python also exports the class as `CustomToolkits`; `ExperimentalCustomToolkits` stays as an alias.
.changeset/files-request-cancellation.md deleted
-5
@@ -1,5 +0,0 @@
1 ----
2 -'@composio/core': patch
3 ----
4 -
5 -Let `composio.files.upload()` and `composio.files.download()` be cancelled. Both now accept trailing request options (`{ signal }`), like the other SDK methods that do HTTP I/O. The signal reaches the presigned-URL request and the S3 transfer, and an aborted call rejects with `ComposioRequestCancelledError` instead of running to completion. Calls cancelled by `AbortSignal.timeout()` or by `abort(reason)` during a direct S3 transfer now also reject with `ComposioRequestCancelledError` rather than the signal's raw reason.
.changeset/fix-connection-polling-deadline.md deleted
-6
@@ -1,6 +0,0 @@
1 ----
2 -'@composio/core': patch
3 -'@composio/python-sdk': patch
4 ----
5 -
6 -Stop connection polling at the deadline after a rate-limited response. When a `429` with `Retry-After` reaches the timeout, `waitForConnection()` and `wait_for_connection()` now time out instead of sending another status request with a fresh client retry cycle.
.changeset/google-parameters-json-schema.md deleted
-5
@@ -1,5 +0,0 @@
1 ----
2 -'@composio/google': minor
3 ----
4 -
5 -Fix Gemini rejecting Composio tools with a 400 such as `Unknown name "examples"`. `wrapTool` and `wrapTools` now put each tool's schema in `parametersJsonSchema` instead of `parameters`, so JSON Schema keywords that Composio tools carry, such as `examples`, `const`, `null` types, and integer enums, reach Gemini intact. The `@google/genai` peer dependency now requires `^1.6.0`, the first release that supports `parametersJsonSchema` on function declarations.
.changeset/google-python-vertex-schema.md deleted
-5
@@ -1,5 +0,0 @@
1 ----
2 -'@composio/python-sdk': patch
3 ----
4 -
5 -Fix `composio_google` raising `ParseError` while wrapping tools whose schemas use JSON Schema keywords outside the Vertex AI `Schema` subset, such as `human_parameter_name`, `examples`, `const`, `oneOf`, type lists, and non-string enums. `wrap_tool` now reduces each schema to that subset: it drops unsupported keywords, turns `oneOf` into `anyOf`, a `null` type or enum member into `nullable`, a string `const` into a one-value `enum`, and moves non-string enum values into the description.
.changeset/openai-agents-dependency-compatibility.md deleted
-6
@@ -1,6 +0,0 @@
1 ----
2 -'@composio/openai-agents': patch
3 -'@composio/python-sdk': patch
4 ----
5 -
6 -Allow OpenAI Agents SDK 0.21 in the TypeScript provider's peer dependencies. Require composio 0.32.0 or newer for the Python OpenAI Agents provider so installs cannot retain an older core.
.changeset/python-trigger-toolkit-filter-underscore.md deleted
-7
@@ -1,7 +0,0 @@
1 ----
2 -'@composio/python-sdk': patch
3 ----
4 -
5 -Match the `toolkit` filter of trigger subscriptions for toolkits whose slug contains an underscore
6 -
7 -The toolkit of an incoming event is derived from the first `_` segment of its trigger slug, so `ONE_DRIVE_FILE_CREATED_TRIGGER` was attributed to `ONE` and `handle(toolkit="one_drive")` skipped every OneDrive event. The same happened to `launch_darkly` and `agent_mail`. A `toolkit` filter now also matches when the trigger slug starts with `<toolkit>_`.
.changeset/session-execution-types.md deleted
-7
@@ -1,7 +0,0 @@
1 ----
2 -'@composio/core': patch
3 -'@composio/slim': patch
4 -'@composio/python-sdk': patch
5 ----
6 -
7 -Use generated client types for inline local-tool payloads and share Python result handling between session tool and meta-tool execution. Public methods and request and response shapes are unchanged.
.changeset/tidy-dependency-consolidation.md deleted
-14
@@ -1,14 +0,0 @@
1 ----
2 -'@composio/core': patch
3 -'@composio/slim': patch
4 -'@composio/experimental': patch
5 -'@composio/json-schema-to-zod': patch
6 -'@composio/anthropic': patch
7 -'@composio/claude-agent-sdk': patch
8 -'@composio/mastra': patch
9 -'@composio/langchain': patch
10 -'@composio/typesafe': patch
11 -'@composio/python-sdk': patch
12 ----
13 -
14 -Update runtime dependencies, require patched Zod 4 releases where used directly, support Anthropic SDK 1.6, and update the AutoGen provider's FLAML dependency. Preserve Zod 3 compatibility fixtures and existing framework version boundaries.
.changeset/tolerate-malformed-tool-schemas.md deleted
-5
@@ -1,5 +0,0 @@
1 ----
2 -'@composio/core': patch
3 ----
4 -
5 -Tolerate malformed tool schemas instead of failing a whole toolkit's tool list. `getRawComposioTools` and the raw list path previously ran every tool's parameters through the strict schema validator with `parse`, so one tool whose schema used a valid-but-unusual JSON Schema shape — a boolean schema node (`items: true`, still emitted by MCP toolkits), a draft-04 boolean `exclusiveMinimum`/`exclusiveMaximum`, or a bare combinator root with no `type: "object"` — threw a `ZodError` and returned no tools at all for that toolkit (8 of 1562 toolkits ship such tools). Those shapes are now rewritten into the strict subset, preserving their meaning (`true` becomes `{}`, `false` becomes `{ not: {} }` — coercing it to `{}` would invert the schema). If a schema still cannot be repaired, the tool is skipped with a warning when its *input* schema failed — providers build their call schema from it, so a tool without one is not callable — and returned without the *output* schema when only that side failed. Identity-field failures stay loud.
\ No newline at end of file
.changeset/tool-error-details-parity.md deleted
-10
@@ -1,10 +0,0 @@
1 ----
2 -'@composio/core': minor
3 -'@composio/python-sdk': minor
4 ----
5 -
6 -Surface the server's error details on every API failure, not only the default `tools.execute` path.
7 -
8 -**TypeScript:** `apiErrorCode` is now on `ComposioError`, derived from the `APIError` cause like `statusCode` and `requestId`, so every SDK wrapper gets it. The 429 branch, the 1803 connected-account branch, tool-fetch failures, and session/Tool Router execution now use the server's message, `suggested_fix`, status, and numeric code. Failures that never reached the API keep their original reason in the message. `ComposioConnectedAccountNotFoundError` keeps its 404 default but uses the server's status when it wraps an API error. Server-controlled error text is stripped of control characters and ANSI/OSC escapes before it reaches a message or terminal output.
9 -
10 -**Python:** status errors raised by the SDK now expose `api_error_code`, `suggested_fix`, and `possible_fixes`, and `api_error_details(error)` gives type checkers a typed view of them. `possible_fixes` uses the server's `suggested_fix` when present and otherwise returns guidance for the HTTP status, so 401, 402, 403, 410, and 5xx no longer suggest checking the tool slug and arguments. Server-controlled text is sanitized before it reaches a message. The message already carries the server's explanation; a regression test now locks that. A tool-fetch 400/404 mapped to `ToolNotFoundError` now appends the server's message.
.changeset/tool-execution-error-details.md deleted
-19
@@ -1,19 +0,0 @@
1 ----
2 -'@composio/core': minor
3 ----
4 -
5 -Surface the API's error details when `tools.execute` fails. `ComposioError` now declares `statusCode` and `requestId`, read from the `@composio/client` `APIError` it wraps unless passed explicitly, and `ComposioToolExecutionError` adds `apiErrorCode`, the numeric `error.code` the API sent. `code` stays the SDK's `TS-SDK::` code. Branch on `error.statusCode` (for example `410`) instead of matching message text.
6 -
7 -**Behavior change:** a rejected execution's message now ends with the server's message, and its `possibleFixes` come from the server's `suggested_fix`.
8 -
9 -```ts
10 -// before
11 -error.message; // 'Error executing the tool GITHUB_GET_REPOS'
12 -error.possibleFixes; // ['Ensure the tool slug is correct and the input arguments for the tool is valid']
13 -
14 -// now
15 -error.message; // 'Error executing the tool GITHUB_GET_REPOS: <the API error message>'
16 -error.possibleFixes; // ['<the API suggested_fix>']
17 -```
18 -
19 -Without a `suggested_fix`, the fix depends on the HTTP status: a 401, 402, 403, 410 or 5xx no longer suggests checking the tool slug and arguments. A response that is not the API error envelope keeps the old message. `ComposioConnectedAccountNotFoundError` (API code 1803) now keeps the client error as `cause`, and errors that wrap an `APIError` cause, such as `ComposioToolFetchError`, now carry its `statusCode` and `requestId`. `ComposioAPIServerErrorBody` is now the client's `APIErrorBody`, where `request_id` and `suggested_fix` are optional, as the API sends them.
.changeset/trigger-toolkit-filter-underscore.md deleted
-7
@@ -1,7 +0,0 @@
1 ----
2 -'@composio/core': patch
3 ----
4 -
5 -Match the `toolkits` filter of `triggers.subscribe()` for toolkits whose slug contains an underscore
6 -
7 -The toolkit of an incoming event is derived from the first `_` segment of its trigger slug, so `ONE_DRIVE_FILE_CREATED_TRIGGER` was attributed to `ONE` and `subscribe(fn, { toolkits: ['one_drive'] })` dropped every OneDrive event. The same happened to `launch_darkly` and `agent_mail`. A `toolkits` entry now also matches when the trigger slug starts with `<toolkit>_`.
.github/sdk-release-plan.json
+451 -55
@@ -1,110 +1,390 @@
1 {
2 - "id": "42589989280",
3 - "inputBase": "f22ab26848dbcc600131fb0b1d7261ab576ebb48",
2 + "id": "44070813467",
3 + "inputBase": "63fda4e63479824c73cd689b5593722590174656",
4 "requestedBy": "jkomyno",
5 - "issue": 5277,
6 - "date": "2026-11-09",
5 + "issue": 5437,
6 + "date": "2026-11-17",
7 "plan": {
8 "schemaVersion": 1,
9 - "inputFingerprint": "ca87e5d8d9b4b77af52b8258910a562e111182fb3bb36d2567068d7352ea091b",
9 + "inputFingerprint": "1393db64535236e941eaf52d6ca13964a8ec289dfb15fccb9bd1b5d84808af3e",
10 "choices": {
11 "typescript": "auto",
12 "python": "auto",
13 "channel": "stable",
14 - "run": "42589989280"
14 + "run": "44070813467"
15 },
16 "recommended": [
17 + {
18 + "name": "@composio/anthropic",
19 + "type": "patch",
20 + "oldVersion": "0.11.7",
21 + "newVersion": "0.11.8",
22 + "changesets": [
23 + "anthropic-tool-result-correlation",
24 + "tidy-dependency-consolidation"
25 + ],
26 + "language": "typescript"
27 + },
28 + {
29 + "name": "@composio/claude-agent-sdk",
30 + "type": "patch",
31 + "oldVersion": "0.13.0",
32 + "newVersion": "0.13.1",
33 + "changesets": [
34 + "tidy-dependency-consolidation"
35 + ],
36 + "language": "typescript"
37 + },
38 {
39 "name": "@composio/core",
40 "type": "minor",
20 - "oldVersion": "0.28.0",
21 - "newVersion": "0.29.0",
41 + "oldVersion": "0.29.0",
42 + "newVersion": "0.30.0",
43 "changesets": [
44 + "all-bags-begin",
45 "composio-client-update",
24 - "custom-toolkit-mcp-url",
25 - "local-tools-rename",
26 - "sdk-rate-limit-handling"
46 + "custom-toolkits-top-level",
47 + "files-request-cancellation",
48 + "fix-connection-polling-deadline",
49 + "session-execution-types",
50 + "tidy-dependency-consolidation",
51 + "tolerate-malformed-tool-schemas",
52 + "tool-error-details-parity",
53 + "tool-execution-error-details",
54 + "trigger-toolkit-filter-underscore"
55 + ],
56 + "language": "typescript"
57 + },
58 + {
59 + "name": "@composio/experimental",
60 + "type": "patch",
61 + "oldVersion": "0.2.8",
62 + "newVersion": "0.2.9",
63 + "changesets": [
64 + "tidy-dependency-consolidation"
65 + ],
66 + "language": "typescript"
67 + },
68 + {
69 + "name": "@composio/google",
70 + "type": "minor",
71 + "oldVersion": "0.12.0",
72 + "newVersion": "0.13.0",
73 + "changesets": [
74 + "google-parameters-json-schema"
75 + ],
76 + "language": "typescript"
77 + },
78 + {
79 + "name": "@composio/json-schema-to-zod",
80 + "type": "patch",
81 + "oldVersion": "0.4.0",
82 + "newVersion": "0.4.1",
83 + "changesets": [
84 + "tidy-dependency-consolidation"
85 + ],
86 + "language": "typescript"
87 + },
88 + {
89 + "name": "@composio/langchain",
90 + "type": "patch",
91 + "oldVersion": "0.11.2",
92 + "newVersion": "0.11.3",
93 + "changesets": [
94 + "tidy-dependency-consolidation"
95 + ],
96 + "language": "typescript"
97 + },
98 + {
99 + "name": "@composio/mastra",
100 + "type": "patch",
101 + "oldVersion": "0.10.6",
102 + "newVersion": "0.10.7",
103 + "changesets": [
104 + "tidy-dependency-consolidation"
105 + ],
106 + "language": "typescript"
107 + },
108 + {
109 + "name": "@composio/openai-agents",
110 + "type": "patch",
111 + "oldVersion": "0.11.2",
112 + "newVersion": "0.11.3",
113 + "changesets": [
114 + "openai-agents-dependency-compatibility"
115 ],
116 "language": "typescript"
117 },
118 {
119 "name": "@composio/python-sdk",
120 "type": "minor",
33 - "oldVersion": "0.31.0",
34 - "newVersion": "0.32.0",
121 + "oldVersion": "0.32.0",
122 + "newVersion": "0.33.0",
123 "changesets": [
36 - "python-client-2-1-0",
37 - "python-local-tools-rename",
38 - "python-missing-api-key-message",
39 - "python-rate-limit-handling"
124 + "anthropic-tool-result-correlation",
125 + "blocked-session-result-type",
126 + "claude-agent-sdk-wheel-tests",
127 + "composio-client-update",
128 + "custom-tool-coroutine-check",
129 + "custom-toolkits-top-level",
130 + "fix-connection-polling-deadline",
131 + "google-python-vertex-schema",
132 + "openai-agents-dependency-compatibility",
133 + "python-trigger-toolkit-filter-underscore",
134 + "session-execution-types",
135 + "tidy-dependency-consolidation",
136 + "tool-error-details-parity"
137 ],
138 "language": "python"
139 },
140 {
141 "name": "@composio/slim",
142 "type": "minor",
46 - "oldVersion": "0.28.0",
47 - "newVersion": "0.29.0",
143 + "oldVersion": "0.29.0",
144 + "newVersion": "0.30.0",
145 + "changesets": [
146 + "all-bags-begin",
147 + "custom-toolkits-top-level",
148 + "session-execution-types",
149 + "tidy-dependency-consolidation"
150 + ],
151 + "language": "typescript"
152 + },
153 + {
154 + "name": "@composio/typesafe",
155 + "type": "patch",
156 + "oldVersion": "0.1.1",
157 + "newVersion": "0.1.2",
158 "changesets": [
49 - "custom-toolkit-mcp-url",
50 - "local-tools-rename"
159 + "tidy-dependency-consolidation"
160 ],
161 "language": "typescript"
162 }
163 ],
164 "releases": [
165 + {
166 + "name": "@composio/anthropic",
167 + "type": "patch",
168 + "oldVersion": "0.11.7",
169 + "newVersion": "0.11.8",
170 + "changesets": [
171 + "anthropic-tool-result-correlation",
172 + "tidy-dependency-consolidation"
173 + ],
174 + "language": "typescript"
175 + },
176 + {
177 + "name": "@composio/claude-agent-sdk",
178 + "type": "patch",
179 + "oldVersion": "0.13.0",
180 + "newVersion": "0.13.1",
181 + "changesets": [
182 + "tidy-dependency-consolidation"
183 + ],
184 + "language": "typescript"
185 + },
186 {
187 "name": "@composio/core",
188 "type": "minor",
59 - "oldVersion": "0.28.0",
60 - "newVersion": "0.29.0",
189 + "oldVersion": "0.29.0",
190 + "newVersion": "0.30.0",
191 "changesets": [
192 + "all-bags-begin",
193 "composio-client-update",
63 - "custom-toolkit-mcp-url",
64 - "local-tools-rename",
65 - "sdk-rate-limit-handling"
194 + "custom-toolkits-top-level",
195 + "files-request-cancellation",
196 + "fix-connection-polling-deadline",
197 + "session-execution-types",
198 + "tidy-dependency-consolidation",
199 + "tolerate-malformed-tool-schemas",
200 + "tool-error-details-parity",
201 + "tool-execution-error-details",
202 + "trigger-toolkit-filter-underscore"
203 + ],
204 + "language": "typescript"
205 + },
206 + {
207 + "name": "@composio/experimental",
208 + "type": "patch",
209 + "oldVersion": "0.2.8",
210 + "newVersion": "0.2.9",
211 + "changesets": [
212 + "tidy-dependency-consolidation"
213 + ],
214 + "language": "typescript"
215 + },
216 + {
217 + "name": "@composio/google",
218 + "type": "minor",
219 + "oldVersion": "0.12.0",
220 + "newVersion": "0.13.0",
221 + "changesets": [
222 + "google-parameters-json-schema"
223 + ],
224 + "language": "typescript"
225 + },
226 + {
227 + "name": "@composio/json-schema-to-zod",
228 + "type": "patch",
229 + "oldVersion": "0.4.0",
230 + "newVersion": "0.4.1",
231 + "changesets": [
232 + "tidy-dependency-consolidation"
233 + ],
234 + "language": "typescript"
235 + },
236 + {
237 + "name": "@composio/langchain",
238 + "type": "patch",
239 + "oldVersion": "0.11.2",
240 + "newVersion": "0.11.3",
241 + "changesets": [
242 + "tidy-dependency-consolidation"
243 + ],
244 + "language": "typescript"
245 + },
246 + {
247 + "name": "@composio/mastra",
248 + "type": "patch",
249 + "oldVersion": "0.10.6",
250 + "newVersion": "0.10.7",
251 + "changesets": [
252 + "tidy-dependency-consolidation"
253 + ],
254 + "language": "typescript"
255 + },
256 + {
257 + "name": "@composio/openai-agents",
258 + "type": "patch",
259 + "oldVersion": "0.11.2",
260 + "newVersion": "0.11.3",
261 + "changesets": [
262 + "openai-agents-dependency-compatibility"
263 ],
264 "language": "typescript"
265 },
266 {
267 "name": "@composio/python-sdk",
268 "type": "minor",
72 - "oldVersion": "0.31.0",
73 - "newVersion": "0.32.0",
269 + "oldVersion": "0.32.0",
270 + "newVersion": "0.33.0",
271 "changesets": [
75 - "python-client-2-1-0",
76 - "python-local-tools-rename",
77 - "python-missing-api-key-message",
78 - "python-rate-limit-handling"
272 + "anthropic-tool-result-correlation",
273 + "blocked-session-result-type",
274 + "claude-agent-sdk-wheel-tests",
275 + "composio-client-update",
276 + "custom-tool-coroutine-check",
277 + "custom-toolkits-top-level",
278 + "fix-connection-polling-deadline",
279 + "google-python-vertex-schema",
280 + "openai-agents-dependency-compatibility",
281 + "python-trigger-toolkit-filter-underscore",
282 + "session-execution-types",
283 + "tidy-dependency-consolidation",
284 + "tool-error-details-parity"
285 ],
286 "language": "python"
287 },
288 {
289 "name": "@composio/slim",
290 "type": "minor",
85 - "oldVersion": "0.28.0",
86 - "newVersion": "0.29.0",
291 + "oldVersion": "0.29.0",
292 + "newVersion": "0.30.0",
293 + "changesets": [
294 + "all-bags-begin",
295 + "custom-toolkits-top-level",
296 + "session-execution-types",
297 + "tidy-dependency-consolidation"
298 + ],
299 + "language": "typescript"
300 + },
301 + {
302 + "name": "@composio/typesafe",
303 + "type": "patch",
304 + "oldVersion": "0.1.1",
305 + "newVersion": "0.1.2",
306 "changesets": [
88 - "custom-toolkit-mcp-url",
89 - "local-tools-rename"
307 + "tidy-dependency-consolidation"
308 ],
309 "language": "typescript"
310 }
311 ],
312 "changesets": [
313 + {
314 + "id": "all-bags-begin",
315 + "summary": "Allow `RemoteFile.save()` to save to an explicit path when the home directory cannot be resolved.",
316 + "releases": [
317 + {
318 + "name": "@composio/core",
319 + "type": "patch"
320 + },
321 + {
322 + "name": "@composio/slim",
323 + "type": "patch"
324 + }
325 + ]
326 + },
327 + {
328 + "id": "anthropic-tool-result-correlation",
329 + "summary": "Preserve the originating `tool_use_id` in Python Anthropic tool results and retain session execution status, log IDs, and returned Instant charges in provider execution results. Clarify the TypeScript Anthropic helpers' existing result projection and message correlation in their API documentation.",
330 + "releases": [
331 + {
332 + "name": "@composio/python-sdk",
333 + "type": "patch"
334 + },
335 + {
336 + "name": "@composio/anthropic",
337 + "type": "patch"
338 + }
339 + ]
340 + },
341 + {
342 + "id": "blocked-session-result-type",
343 + "summary": "Include `blocked` in the Python session execution result type so blocked results can be parsed by `ToolRouterSessionExecuteResponse`.",
344 + "releases": [
345 + {
346 + "name": "@composio/python-sdk",
347 + "type": "patch"
348 + }
349 + ]
350 + },
351 + {
352 + "id": "claude-agent-sdk-wheel-tests",
353 + "summary": "Exclude the Claude Agent SDK provider's tests package from its wheel to avoid shadowing consuming projects' tests.",
354 + "releases": [
355 + {
356 + "name": "@composio/python-sdk",
357 + "type": "patch"
358 + }
359 + ]
360 + },
361 {
362 "id": "composio-client-update",
97 - "summary": "Update @composio/client to 2.1.0 to include the latest API changes.",
363 + "summary": "Update the API client dependencies to 2.1.33 to include the latest API changes.",
364 "releases": [
365 {
366 "name": "@composio/core",
367 "type": "patch"
368 + },
369 + {
370 + "name": "@composio/python-sdk",
371 + "type": "patch"
372 }
373 ]
374 },
375 {
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`.",
376 + "id": "custom-tool-coroutine-check",
377 + "summary": "Stop emitting a `DeprecationWarning` on Python 3.14+ when registering custom tools. The async-function check now uses `inspect.iscoroutinefunction`, and async tools are still rejected as before.",
378 + "releases": [
379 + {
380 + "name": "@composio/python-sdk",
381 + "type": "patch"
382 + }
383 + ]
384 + },
385 + {
386 + "id": "custom-toolkits-top-level",
387 + "summary": "Custom toolkits are no longer experimental. Use `composio.customToolkits` in TypeScript and `composio.custom_toolkits` in Python. `composio.experimental.customToolkits` and `composio.experimental.custom_toolkits` are deprecated aliases of the same object and keep working. Python also exports the class as `CustomToolkits`; `ExperimentalCustomToolkits` stays as an alias.",
388 "releases": [
389 {
390 "name": "@composio/core",
@@ -113,47 +393,139 @@
393 {
394 "name": "@composio/slim",
395 "type": "minor"
396 + },
397 + {
398 + "name": "@composio/python-sdk",
399 + "type": "minor"
400 }
401 ]
402 },
403 {
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.",
404 + "id": "files-request-cancellation",
405 + "summary": "Let `composio.files.upload()` and `composio.files.download()` be cancelled. Both now accept trailing request options (`{ signal }`), like the other SDK methods that do HTTP I/O. The signal reaches the presigned-URL request and the S3 transfer, and an aborted call rejects with `ComposioRequestCancelledError` instead of running to completion. Calls cancelled by `AbortSignal.timeout()` or by `abort(reason)` during a direct S3 transfer now also reject with `ComposioRequestCancelledError` rather than the signal's raw reason.",
406 "releases": [
407 {
408 "name": "@composio/core",
125 - "type": "minor"
409 + "type": "patch"
410 + }
411 + ]
412 + },
413 + {
414 + "id": "fix-connection-polling-deadline",
415 + "summary": "Stop connection polling at the deadline after a rate-limited response. When a `429` with `Retry-After` reaches the timeout, `waitForConnection()` and `wait_for_connection()` now time out instead of sending another status request with a fresh client retry cycle.",
416 + "releases": [
417 + {
418 + "name": "@composio/core",
419 + "type": "patch"
420 },
421 {
128 - "name": "@composio/slim",
422 + "name": "@composio/python-sdk",
423 + "type": "patch"
424 + }
425 + ]
426 + },
427 + {
428 + "id": "google-parameters-json-schema",
429 + "summary": "Fix Gemini rejecting Composio tools with a 400 such as `Unknown name \"examples\"`. `wrapTool` and `wrapTools` now put each tool's schema in `parametersJsonSchema` instead of `parameters`, so JSON Schema keywords that Composio tools carry, such as `examples`, `const`, `null` types, and integer enums, reach Gemini intact. The `@google/genai` peer dependency now requires `^1.6.0`, the first release that supports `parametersJsonSchema` on function declarations.",
430 + "releases": [
431 + {
432 + "name": "@composio/google",
433 "type": "minor"
434 }
435 ]
436 },
437 {
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`.",
438 + "id": "google-python-vertex-schema",
439 + "summary": "Fix `composio_google` raising `ParseError` while wrapping tools whose schemas use JSON Schema keywords outside the Vertex AI `Schema` subset, such as `human_parameter_name`, `examples`, `const`, `oneOf`, type lists, and non-string enums. `wrap_tool` now reduces each schema to that subset: it drops unsupported keywords, turns `oneOf` into `anyOf`, a `null` type or enum member into `nullable`, a string `const` into a one-value `enum`, and moves non-string enum values into the description.",
440 "releases": [
441 {
442 "name": "@composio/python-sdk",
139 - "type": "minor"
443 + "type": "patch"
444 }
445 ]
446 },
447 {
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.",
448 + "id": "openai-agents-dependency-compatibility",
449 + "summary": "Allow OpenAI Agents SDK 0.21 in the TypeScript provider's peer dependencies. Require composio 0.32.0 or newer for the Python OpenAI Agents provider so installs cannot retain an older core.",
450 "releases": [
451 + {
452 + "name": "@composio/openai-agents",
453 + "type": "patch"
454 + },
455 {
456 "name": "@composio/python-sdk",
149 - "type": "minor"
457 + "type": "patch"
458 + }
459 + ]
460 + },
461 + {
462 + "id": "python-trigger-toolkit-filter-underscore",
463 + "summary": "Match the `toolkit` filter of trigger subscriptions for toolkits whose slug contains an underscore\n\nThe toolkit of an incoming event is derived from the first `_` segment of its trigger slug, so `ONE_DRIVE_FILE_CREATED_TRIGGER` was attributed to `ONE` and `handle(toolkit=\"one_drive\")` skipped every OneDrive event. The same happened to `launch_darkly` and `agent_mail`. A `toolkit` filter now also matches when the trigger slug starts with `<toolkit>_`.",
464 + "releases": [
465 + {
466 + "name": "@composio/python-sdk",
467 + "type": "patch"
468 + }
469 + ]
470 + },
471 + {
472 + "id": "session-execution-types",
473 + "summary": "Use generated client types for inline local-tool payloads and share Python result handling between session tool and meta-tool execution. Public methods and request and response shapes are unchanged.",
474 + "releases": [
475 + {
476 + "name": "@composio/core",
477 + "type": "patch"
478 + },
479 + {
480 + "name": "@composio/slim",
481 + "type": "patch"
482 + },
483 + {
484 + "name": "@composio/python-sdk",
485 + "type": "patch"
486 }
487 ]
488 },
489 {
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.",
490 + "id": "tidy-dependency-consolidation",
491 + "summary": "Update runtime dependencies, require patched Zod 4 releases where used directly, support Anthropic SDK 1.6, and update the AutoGen provider's FLAML dependency. Preserve Zod 3 compatibility fixtures and existing framework version boundaries.",
492 "releases": [
493 + {
494 + "name": "@composio/core",
495 + "type": "patch"
496 + },
497 + {
498 + "name": "@composio/slim",
499 + "type": "patch"
500 + },
501 + {
502 + "name": "@composio/experimental",
503 + "type": "patch"
504 + },
505 + {
506 + "name": "@composio/json-schema-to-zod",
507 + "type": "patch"
508 + },
509 + {
510 + "name": "@composio/anthropic",
511 + "type": "patch"
512 + },
513 + {
514 + "name": "@composio/claude-agent-sdk",
515 + "type": "patch"
516 + },
517 + {
518 + "name": "@composio/mastra",
519 + "type": "patch"
520 + },
521 + {
522 + "name": "@composio/langchain",
523 + "type": "patch"
524 + },
525 + {
526 + "name": "@composio/typesafe",
527 + "type": "patch"
528 + },
529 {
530 "name": "@composio/python-sdk",
531 "type": "patch"
@@ -161,9 +533,23 @@
533 ]
534 },
535 {
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.",
536 + "id": "tolerate-malformed-tool-schemas",
537 + "summary": "Tolerate malformed tool schemas instead of failing a whole toolkit's tool list. `getRawComposioTools` and the raw list path previously ran every tool's parameters through the strict schema validator with `parse`, so one tool whose schema used a valid-but-unusual JSON Schema shape — a boolean schema node (`items: true`, still emitted by MCP toolkits), a draft-04 boolean `exclusiveMinimum`/`exclusiveMaximum`, or a bare combinator root with no `type: \"object\"` — threw a `ZodError` and returned no tools at all for that toolkit (8 of 1562 toolkits ship such tools). Those shapes are now rewritten into the strict subset, preserving their meaning (`true` becomes `{}`, `false` becomes `{ not: {} }` — coercing it to `{}` would invert the schema). If a schema still cannot be repaired, the tool is skipped with a warning when its *input* schema failed — providers build their call schema from it, so a tool without one is not callable — and returned without the *output* schema when only that side failed. Identity-field failures stay loud.",
538 "releases": [
539 + {
540 + "name": "@composio/core",
541 + "type": "patch"
542 + }
543 + ]
544 + },
545 + {
546 + "id": "tool-error-details-parity",
547 + "summary": "Surface the server's error details on every API failure, not only the default `tools.execute` path.\n\n**TypeScript:** `apiErrorCode` is now on `ComposioError`, derived from the `APIError` cause like `statusCode` and `requestId`, so every SDK wrapper gets it. The 429 branch, the 1803 connected-account branch, tool-fetch failures, and session/Tool Router execution now use the server's message, `suggested_fix`, status, and numeric code. Failures that never reached the API keep their original reason in the message. `ComposioConnectedAccountNotFoundError` keeps its 404 default but uses the server's status when it wraps an API error. Server-controlled error text is stripped of control characters and ANSI/OSC escapes before it reaches a message or terminal output.\n\n**Python:** status errors raised by the SDK now expose `api_error_code`, `suggested_fix`, and `possible_fixes`, and `api_error_details(error)` gives type checkers a typed view of them. `possible_fixes` uses the server's `suggested_fix` when present and otherwise returns guidance for the HTTP status, so 401, 402, 403, 410, and 5xx no longer suggest checking the tool slug and arguments. Server-controlled text is sanitized before it reaches a message. The message already carries the server's explanation; a regression test now locks that. A tool-fetch 400/404 mapped to `ToolNotFoundError` now appends the server's message.",
548 + "releases": [
549 + {
550 + "name": "@composio/core",
551 + "type": "minor"
552 + },
553 {
554 "name": "@composio/python-sdk",
555 "type": "minor"
@@ -171,14 +557,24 @@
557 ]
558 },
559 {
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`).",
560 + "id": "tool-execution-error-details",
561 + "summary": "Surface the API's error details when `tools.execute` fails. `ComposioError` now declares `statusCode` and `requestId`, read from the `@composio/client` `APIError` it wraps unless passed explicitly, and `ComposioToolExecutionError` adds `apiErrorCode`, the numeric `error.code` the API sent. `code` stays the SDK's `TS-SDK::` code. Branch on `error.statusCode` (for example `410`) instead of matching message text.\n\n**Behavior change:** a rejected execution's message now ends with the server's message, and its `possibleFixes` come from the server's `suggested_fix`.\n\n```ts\n// before\nerror.message; // 'Error executing the tool GITHUB_GET_REPOS'\nerror.possibleFixes; // ['Ensure the tool slug is correct and the input arguments for the tool is valid']\n\n// now\nerror.message; // 'Error executing the tool GITHUB_GET_REPOS: <the API error message>'\nerror.possibleFixes; // ['<the API suggested_fix>']\n```\n\nWithout a `suggested_fix`, the fix depends on the HTTP status: a 401, 402, 403, 410 or 5xx no longer suggests checking the tool slug and arguments. A response that is not the API error envelope keeps the old message. `ComposioConnectedAccountNotFoundError` (API code 1803) now keeps the client error as `cause`, and errors that wrap an `APIError` cause, such as `ComposioToolFetchError`, now carry its `statusCode` and `requestId`. `ComposioAPIServerErrorBody` is now the client's `APIErrorBody`, where `request_id` and `suggested_fix` are optional, as the API sends them.",
562 "releases": [
563 {
564 "name": "@composio/core",
565 "type": "minor"
566 }
567 ]
568 + },
569 + {
570 + "id": "trigger-toolkit-filter-underscore",
571 + "summary": "Match the `toolkits` filter of `triggers.subscribe()` for toolkits whose slug contains an underscore\n\nThe toolkit of an incoming event is derived from the first `_` segment of its trigger slug, so `ONE_DRIVE_FILE_CREATED_TRIGGER` was attributed to `ONE` and `subscribe(fn, { toolkits: ['one_drive'] })` dropped every OneDrive event. The same happened to `launch_darkly` and `agent_mail`. A `toolkits` entry now also matches when the trigger slug starts with `<toolkit>_`.",
572 + "releases": [
573 + {
574 + "name": "@composio/core",
575 + "type": "patch"
576 + }
577 + ]
578 }
579 ],
580 "retainedChangesets": []
docs/content/changelog/11-17-26-sdk-44070813467.mdx new
+87
@@ -0,0 +1,87 @@
1 +---
2 +title: "SDK release 44070813467"
3 +date: "2026-11-17"
4 +sdkRelease: "44070813467"
5 +sdkReleaseTargets: {"@composio/anthropic":"0.11.8","@composio/claude-agent-sdk":"0.13.1","@composio/core":"0.30.0","@composio/experimental":"0.2.9","@composio/google":"0.13.0","@composio/json-schema-to-zod":"0.4.1","@composio/langchain":"0.11.3","@composio/mastra":"0.10.7","@composio/openai-agents":"0.11.3","@composio/python-sdk":"0.33.0","@composio/slim":"0.30.0","@composio/typesafe":"0.1.2"}
6 +---
7 +
8 +See the [release request](https://github.com/ComposioHQ/composio/issues/5437) for publication status.
9 +
10 +### SDK Versions
11 +
12 +| SDK | Version |
13 +| --- | --- |
14 +| TypeScript `@composio/anthropic` | `0.11.8` |
15 +| TypeScript `@composio/claude-agent-sdk` | `0.13.1` |
16 +| TypeScript `@composio/core` | `0.30.0` |
17 +| TypeScript `@composio/experimental` | `0.2.9` |
18 +| TypeScript `@composio/google` | `0.13.0` |
19 +| TypeScript `@composio/json-schema-to-zod` | `0.4.1` |
20 +| TypeScript `@composio/langchain` | `0.11.3` |
21 +| TypeScript `@composio/mastra` | `0.10.7` |
22 +| TypeScript `@composio/openai-agents` | `0.11.3` |
23 +| Python `composio` | `0.33.0` |
24 +| TypeScript `@composio/slim` | `0.30.0` |
25 +| TypeScript `@composio/typesafe` | `0.1.2` |
26 +
27 +### Changes
28 +
29 +Allow `RemoteFile.save()` to save to an explicit path when the home directory cannot be resolved.
30 +
31 +Preserve the originating `tool_use_id` in Python Anthropic tool results and retain session execution status, log IDs, and returned Instant charges in provider execution results. Clarify the TypeScript Anthropic helpers' existing result projection and message correlation in their API documentation.
32 +
33 +Include `blocked` in the Python session execution result type so blocked results can be parsed by `ToolRouterSessionExecuteResponse`.
34 +
35 +Exclude the Claude Agent SDK provider's tests package from its wheel to avoid shadowing consuming projects' tests.
36 +
37 +Update the API client dependencies to 2.1.33 to include the latest API changes.
38 +
39 +Stop emitting a `DeprecationWarning` on Python 3.14+ when registering custom tools. The async-function check now uses `inspect.iscoroutinefunction`, and async tools are still rejected as before.
40 +
41 +Custom toolkits are no longer experimental. Use `composio.customToolkits` in TypeScript and `composio.custom_toolkits` in Python. `composio.experimental.customToolkits` and `composio.experimental.custom_toolkits` are deprecated aliases of the same object and keep working. Python also exports the class as `CustomToolkits`; `ExperimentalCustomToolkits` stays as an alias.
42 +
43 +Let `composio.files.upload()` and `composio.files.download()` be cancelled. Both now accept trailing request options (`{ signal }`), like the other SDK methods that do HTTP I/O. The signal reaches the presigned-URL request and the S3 transfer, and an aborted call rejects with `ComposioRequestCancelledError` instead of running to completion. Calls cancelled by `AbortSignal.timeout()` or by `abort(reason)` during a direct S3 transfer now also reject with `ComposioRequestCancelledError` rather than the signal's raw reason.
44 +
45 +Stop connection polling at the deadline after a rate-limited response. When a `429` with `Retry-After` reaches the timeout, `waitForConnection()` and `wait_for_connection()` now time out instead of sending another status request with a fresh client retry cycle.
46 +
47 +Fix Gemini rejecting Composio tools with a 400 such as `Unknown name "examples"`. `wrapTool` and `wrapTools` now put each tool's schema in `parametersJsonSchema` instead of `parameters`, so JSON Schema keywords that Composio tools carry, such as `examples`, `const`, `null` types, and integer enums, reach Gemini intact. The `@google/genai` peer dependency now requires `^1.6.0`, the first release that supports `parametersJsonSchema` on function declarations.
48 +
49 +Fix `composio_google` raising `ParseError` while wrapping tools whose schemas use JSON Schema keywords outside the Vertex AI `Schema` subset, such as `human_parameter_name`, `examples`, `const`, `oneOf`, type lists, and non-string enums. `wrap_tool` now reduces each schema to that subset: it drops unsupported keywords, turns `oneOf` into `anyOf`, a `null` type or enum member into `nullable`, a string `const` into a one-value `enum`, and moves non-string enum values into the description.
50 +
51 +Allow OpenAI Agents SDK 0.21 in the TypeScript provider's peer dependencies. Require composio 0.32.0 or newer for the Python OpenAI Agents provider so installs cannot retain an older core.
52 +
53 +Match the `toolkit` filter of trigger subscriptions for toolkits whose slug contains an underscore
54 +
55 +The toolkit of an incoming event is derived from the first `_` segment of its trigger slug, so `ONE_DRIVE_FILE_CREATED_TRIGGER` was attributed to `ONE` and `handle(toolkit="one_drive")` skipped every OneDrive event. The same happened to `launch_darkly` and `agent_mail`. A `toolkit` filter now also matches when the trigger slug starts with `<toolkit>_`.
56 +
57 +Use generated client types for inline local-tool payloads and share Python result handling between session tool and meta-tool execution. Public methods and request and response shapes are unchanged.
58 +
59 +Update runtime dependencies, require patched Zod 4 releases where used directly, support Anthropic SDK 1.6, and update the AutoGen provider's FLAML dependency. Preserve Zod 3 compatibility fixtures and existing framework version boundaries.
60 +
61 +Tolerate malformed tool schemas instead of failing a whole toolkit's tool list. `getRawComposioTools` and the raw list path previously ran every tool's parameters through the strict schema validator with `parse`, so one tool whose schema used a valid-but-unusual JSON Schema shape — a boolean schema node (`items: true`, still emitted by MCP toolkits), a draft-04 boolean `exclusiveMinimum`/`exclusiveMaximum`, or a bare combinator root with no `type: "object"` — threw a `ZodError` and returned no tools at all for that toolkit (8 of 1562 toolkits ship such tools). Those shapes are now rewritten into the strict subset, preserving their meaning (`true` becomes `{}`, `false` becomes `{ not: {} }` — coercing it to `{}` would invert the schema). If a schema still cannot be repaired, the tool is skipped with a warning when its *input* schema failed — providers build their call schema from it, so a tool without one is not callable — and returned without the *output* schema when only that side failed. Identity-field failures stay loud.
62 +
63 +Surface the server's error details on every API failure, not only the default `tools.execute` path.
64 +
65 +**TypeScript:** `apiErrorCode` is now on `ComposioError`, derived from the `APIError` cause like `statusCode` and `requestId`, so every SDK wrapper gets it. The 429 branch, the 1803 connected-account branch, tool-fetch failures, and session/Tool Router execution now use the server's message, `suggested_fix`, status, and numeric code. Failures that never reached the API keep their original reason in the message. `ComposioConnectedAccountNotFoundError` keeps its 404 default but uses the server's status when it wraps an API error. Server-controlled error text is stripped of control characters and ANSI/OSC escapes before it reaches a message or terminal output.
66 +
67 +**Python:** status errors raised by the SDK now expose `api_error_code`, `suggested_fix`, and `possible_fixes`, and `api_error_details(error)` gives type checkers a typed view of them. `possible_fixes` uses the server's `suggested_fix` when present and otherwise returns guidance for the HTTP status, so 401, 402, 403, 410, and 5xx no longer suggest checking the tool slug and arguments. Server-controlled text is sanitized before it reaches a message. The message already carries the server's explanation; a regression test now locks that. A tool-fetch 400/404 mapped to `ToolNotFoundError` now appends the server's message.
68 +
69 +Surface the API's error details when `tools.execute` fails. `ComposioError` now declares `statusCode` and `requestId`, read from the `@composio/client` `APIError` it wraps unless passed explicitly, and `ComposioToolExecutionError` adds `apiErrorCode`, the numeric `error.code` the API sent. `code` stays the SDK's `TS-SDK::` code. Branch on `error.statusCode` (for example `410`) instead of matching message text.
70 +
71 +**Behavior change:** a rejected execution's message now ends with the server's message, and its `possibleFixes` come from the server's `suggested_fix`.
72 +
73 +```ts
74 +// before
75 +error.message; // 'Error executing the tool GITHUB_GET_REPOS'
76 +error.possibleFixes; // ['Ensure the tool slug is correct and the input arguments for the tool is valid']
77 +
78 +// now
79 +error.message; // 'Error executing the tool GITHUB_GET_REPOS: <the API error message>'
80 +error.possibleFixes; // ['<the API suggested_fix>']
81 +```
82 +
83 +Without a `suggested_fix`, the fix depends on the HTTP status: a 401, 402, 403, 410 or 5xx no longer suggests checking the tool slug and arguments. A response that is not the API error envelope keeps the old message. `ComposioConnectedAccountNotFoundError` (API code 1803) now keeps the client error as `cause`, and errors that wrap an `APIError` cause, such as `ComposioToolFetchError`, now carry its `statusCode` and `requestId`. `ComposioAPIServerErrorBody` is now the client's `APIErrorBody`, where `request_id` and `suggested_fix` are optional, as the API sends them.
84 +
85 +Match the `toolkits` filter of `triggers.subscribe()` for toolkits whose slug contains an underscore
86 +
87 +The toolkit of an incoming event is derived from the first `_` segment of its trigger slug, so `ONE_DRIVE_FILE_CREATED_TRIGGER` was attributed to `ONE` and `subscribe(fn, { toolkits: ['one_drive'] })` dropped every OneDrive event. The same happened to `launch_darkly` and `agent_mail`. A `toolkits` entry now also matches when the trigger slug starts with `<toolkit>_`.
python/CHANGELOG.md
+28
@@ -1,5 +1,33 @@
1 # @composio/python-sdk
2
3 +## 0.33.0
4 +
5 +### Minor Changes
6 +
7 +- 6f8a704: Custom toolkits are no longer experimental. Use `composio.customToolkits` in TypeScript and `composio.custom_toolkits` in Python. `composio.experimental.customToolkits` and `composio.experimental.custom_toolkits` are deprecated aliases of the same object and keep working. Python also exports the class as `CustomToolkits`; `ExperimentalCustomToolkits` stays as an alias.
8 +- 84fb5ba: Surface the server's error details on every API failure, not only the default `tools.execute` path.
9 +
10 + **TypeScript:** `apiErrorCode` is now on `ComposioError`, derived from the `APIError` cause like `statusCode` and `requestId`, so every SDK wrapper gets it. The 429 branch, the 1803 connected-account branch, tool-fetch failures, and session/Tool Router execution now use the server's message, `suggested_fix`, status, and numeric code. Failures that never reached the API keep their original reason in the message. `ComposioConnectedAccountNotFoundError` keeps its 404 default but uses the server's status when it wraps an API error. Server-controlled error text is stripped of control characters and ANSI/OSC escapes before it reaches a message or terminal output.
11 +
12 + **Python:** status errors raised by the SDK now expose `api_error_code`, `suggested_fix`, and `possible_fixes`, and `api_error_details(error)` gives type checkers a typed view of them. `possible_fixes` uses the server's `suggested_fix` when present and otherwise returns guidance for the HTTP status, so 401, 402, 403, 410, and 5xx no longer suggest checking the tool slug and arguments. Server-controlled text is sanitized before it reaches a message. The message already carries the server's explanation; a regression test now locks that. A tool-fetch 400/404 mapped to `ToolNotFoundError` now appends the server's message.
13 +
14 +### Patch Changes
15 +
16 +- 55d8924: Preserve the originating `tool_use_id` in Python Anthropic tool results and retain session execution status, log IDs, and returned Instant charges in provider execution results. Clarify the TypeScript Anthropic helpers' existing result projection and message correlation in their API documentation.
17 +- f74ef60: Include `blocked` in the Python session execution result type so blocked results can be parsed by `ToolRouterSessionExecuteResponse`.
18 +- 54949b2: Exclude the Claude Agent SDK provider's tests package from its wheel to avoid shadowing consuming projects' tests.
19 +- 19a7a09: Update the API client dependencies to 2.1.33 to include the latest API changes.
20 +- 6dde98e: Stop emitting a `DeprecationWarning` on Python 3.14+ when registering custom tools. The async-function check now uses `inspect.iscoroutinefunction`, and async tools are still rejected as before.
21 +- 23360bb: Stop connection polling at the deadline after a rate-limited response. When a `429` with `Retry-After` reaches the timeout, `waitForConnection()` and `wait_for_connection()` now time out instead of sending another status request with a fresh client retry cycle.
22 +- 495be0f: Fix `composio_google` raising `ParseError` while wrapping tools whose schemas use JSON Schema keywords outside the Vertex AI `Schema` subset, such as `human_parameter_name`, `examples`, `const`, `oneOf`, type lists, and non-string enums. `wrap_tool` now reduces each schema to that subset: it drops unsupported keywords, turns `oneOf` into `anyOf`, a `null` type or enum member into `nullable`, a string `const` into a one-value `enum`, and moves non-string enum values into the description.
23 +- 39fc590: Allow OpenAI Agents SDK 0.21 in the TypeScript provider's peer dependencies. Require composio 0.32.0 or newer for the Python OpenAI Agents provider so installs cannot retain an older core.
24 +- bd26f32: Match the `toolkit` filter of trigger subscriptions for toolkits whose slug contains an underscore
25 +
26 + The toolkit of an incoming event is derived from the first `_` segment of its trigger slug, so `ONE_DRIVE_FILE_CREATED_TRIGGER` was attributed to `ONE` and `handle(toolkit="one_drive")` skipped every OneDrive event. The same happened to `launch_darkly` and `agent_mail`. A `toolkit` filter now also matches when the trigger slug starts with `<toolkit>_`.
27 +
28 +- 4ee12da: Use generated client types for inline local-tool payloads and share Python result handling between session tool and meta-tool execution. Public methods and request and response shapes are unchanged.
29 +- d5c1861: Update runtime dependencies, require patched Zod 4 releases where used directly, support Anthropic SDK 1.6, and update the AutoGen provider's FLAML dependency. Preserve Zod 3 compatibility fixtures and existing framework version boundaries.
30 +
31 ## 0.32.0
32
33 ### Minor Changes
python/composio/__version__.py
+1 -1
@@ -1 +1 @@
1 -__version__ = "0.32.0"
1 +__version__ = "0.33.0"
python/package.json
+1 -1
@@ -1,5 +1,5 @@
1 {
2 "name": "@composio/python-sdk",
3 - "version": "0.32.0",
3 + "version": "0.33.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.33.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.33.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.33.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.33.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.33.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.33.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.33.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.33.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.33.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.33.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.33.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.33.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.33.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.33.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.33.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.33.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.33.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.33.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.33.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.33.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.33.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.33.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.33.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.33.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.33.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.33.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.33.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
+43
@@ -1,5 +1,48 @@
1 # @composio/core
2
3 +## 0.30.0
4 +
5 +### Minor Changes
6 +
7 +- 6f8a704: Custom toolkits are no longer experimental. Use `composio.customToolkits` in TypeScript and `composio.custom_toolkits` in Python. `composio.experimental.customToolkits` and `composio.experimental.custom_toolkits` are deprecated aliases of the same object and keep working. Python also exports the class as `CustomToolkits`; `ExperimentalCustomToolkits` stays as an alias.
8 +- 84fb5ba: Surface the server's error details on every API failure, not only the default `tools.execute` path.
9 +
10 + **TypeScript:** `apiErrorCode` is now on `ComposioError`, derived from the `APIError` cause like `statusCode` and `requestId`, so every SDK wrapper gets it. The 429 branch, the 1803 connected-account branch, tool-fetch failures, and session/Tool Router execution now use the server's message, `suggested_fix`, status, and numeric code. Failures that never reached the API keep their original reason in the message. `ComposioConnectedAccountNotFoundError` keeps its 404 default but uses the server's status when it wraps an API error. Server-controlled error text is stripped of control characters and ANSI/OSC escapes before it reaches a message or terminal output.
11 +
12 + **Python:** status errors raised by the SDK now expose `api_error_code`, `suggested_fix`, and `possible_fixes`, and `api_error_details(error)` gives type checkers a typed view of them. `possible_fixes` uses the server's `suggested_fix` when present and otherwise returns guidance for the HTTP status, so 401, 402, 403, 410, and 5xx no longer suggest checking the tool slug and arguments. Server-controlled text is sanitized before it reaches a message. The message already carries the server's explanation; a regression test now locks that. A tool-fetch 400/404 mapped to `ToolNotFoundError` now appends the server's message.
13 +
14 +- be92189: Surface the API's error details when `tools.execute` fails. `ComposioError` now declares `statusCode` and `requestId`, read from the `@composio/client` `APIError` it wraps unless passed explicitly, and `ComposioToolExecutionError` adds `apiErrorCode`, the numeric `error.code` the API sent. `code` stays the SDK's `TS-SDK::` code. Branch on `error.statusCode` (for example `410`) instead of matching message text.
15 +
16 + **Behavior change:** a rejected execution's message now ends with the server's message, and its `possibleFixes` come from the server's `suggested_fix`.
17 +
18 + ```ts
19 + // before
20 + error.message; // 'Error executing the tool GITHUB_GET_REPOS'
21 + error.possibleFixes; // ['Ensure the tool slug is correct and the input arguments for the tool is valid']
22 +
23 + // now
24 + error.message; // 'Error executing the tool GITHUB_GET_REPOS: <the API error message>'
25 + error.possibleFixes; // ['<the API suggested_fix>']
26 + ```
27 +
28 + Without a `suggested_fix`, the fix depends on the HTTP status: a 401, 402, 403, 410 or 5xx no longer suggests checking the tool slug and arguments. A response that is not the API error envelope keeps the old message. `ComposioConnectedAccountNotFoundError` (API code 1803) now keeps the client error as `cause`, and errors that wrap an `APIError` cause, such as `ComposioToolFetchError`, now carry its `statusCode` and `requestId`. `ComposioAPIServerErrorBody` is now the client's `APIErrorBody`, where `request_id` and `suggested_fix` are optional, as the API sends them.
29 +
30 +### Patch Changes
31 +
32 +- 41c4666: Allow `RemoteFile.save()` to save to an explicit path when the home directory cannot be resolved.
33 +- 19a7a09: Update the API client dependencies to 2.1.33 to include the latest API changes.
34 +- 24dfd33: Let `composio.files.upload()` and `composio.files.download()` be cancelled. Both now accept trailing request options (`{ signal }`), like the other SDK methods that do HTTP I/O. The signal reaches the presigned-URL request and the S3 transfer, and an aborted call rejects with `ComposioRequestCancelledError` instead of running to completion. Calls cancelled by `AbortSignal.timeout()` or by `abort(reason)` during a direct S3 transfer now also reject with `ComposioRequestCancelledError` rather than the signal's raw reason.
35 +- 23360bb: Stop connection polling at the deadline after a rate-limited response. When a `429` with `Retry-After` reaches the timeout, `waitForConnection()` and `wait_for_connection()` now time out instead of sending another status request with a fresh client retry cycle.
36 +- 4ee12da: Use generated client types for inline local-tool payloads and share Python result handling between session tool and meta-tool execution. Public methods and request and response shapes are unchanged.
37 +- d5c1861: Update runtime dependencies, require patched Zod 4 releases where used directly, support Anthropic SDK 1.6, and update the AutoGen provider's FLAML dependency. Preserve Zod 3 compatibility fixtures and existing framework version boundaries.
38 +- 6aa3f31: Tolerate malformed tool schemas instead of failing a whole toolkit's tool list. `getRawComposioTools` and the raw list path previously ran every tool's parameters through the strict schema validator with `parse`, so one tool whose schema used a valid-but-unusual JSON Schema shape — a boolean schema node (`items: true`, still emitted by MCP toolkits), a draft-04 boolean `exclusiveMinimum`/`exclusiveMaximum`, or a bare combinator root with no `type: "object"` — threw a `ZodError` and returned no tools at all for that toolkit (8 of 1562 toolkits ship such tools). Those shapes are now rewritten into the strict subset, preserving their meaning (`true` becomes `{}`, `false` becomes `{ not: {} }` — coercing it to `{}` would invert the schema). If a schema still cannot be repaired, the tool is skipped with a warning when its _input_ schema failed — providers build their call schema from it, so a tool without one is not callable — and returned without the _output_ schema when only that side failed. Identity-field failures stay loud.
39 +- b2b9d38: Match the `toolkits` filter of `triggers.subscribe()` for toolkits whose slug contains an underscore
40 +
41 + The toolkit of an incoming event is derived from the first `_` segment of its trigger slug, so `ONE_DRIVE_FILE_CREATED_TRIGGER` was attributed to `ONE` and `subscribe(fn, { toolkits: ['one_drive'] })` dropped every OneDrive event. The same happened to `launch_darkly` and `agent_mail`. A `toolkits` entry now also matches when the trigger slug starts with `<toolkit>_`.
42 +
43 +- Updated dependencies [d5c1861]
44 + - @composio/json-schema-to-zod@0.4.1
45 +
46 ## 0.29.0
47
48 ### 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.30.0",
8 "description": "",
9 "main": "src/index.ts",
10 "publishConfig": {
ts/packages/experimental/CHANGELOG.md
+6
@@ -1,5 +1,11 @@
1 # @composio/experimental
2
3 +## 0.2.9
4 +
5 +### Patch Changes
6 +
7 +- d5c1861: Update runtime dependencies, require patched Zod 4 releases where used directly, support Anthropic SDK 1.6, and update the AutoGen provider's FLAML dependency. Preserve Zod 3 compatibility fixtures and existing framework version boundaries.
8 +
9 ## 0.2.8
10
11 ### Patch Changes
ts/packages/experimental/package.json
+1 -1
@@ -1,6 +1,6 @@
1 {
2 "name": "@composio/experimental",
3 - "version": "0.2.8",
3 + "version": "0.2.9",
4 "description": "Experimental Composio integrations and helpers",
5 "main": "src/index.ts",
6 "type": "module",
ts/packages/json-schema-to-zod/CHANGELOG.md
+6
@@ -1,5 +1,11 @@
1 # @composio/json-schema-to-zod
2
3 +## 0.4.1
4 +
5 +### Patch Changes
6 +
7 +- d5c1861: Update runtime dependencies, require patched Zod 4 releases where used directly, support Anthropic SDK 1.6, and update the AutoGen provider's FLAML dependency. Preserve Zod 3 compatibility fixtures and existing framework version boundaries.
8 +
9 ## 0.4.0
10
11 ### Minor Changes
ts/packages/json-schema-to-zod/package.json
+1 -1
@@ -1,6 +1,6 @@
1 {
2 "name": "@composio/json-schema-to-zod",
3 - "version": "0.4.0",
3 + "version": "0.4.1",
4 "description": "",
5 "main": "src/index.ts",
6 "type": "module",
ts/packages/providers/anthropic/CHANGELOG.md
+7
@@ -1,5 +1,12 @@
1 # @composio/anthropic
2
3 +## 0.11.8
4 +
5 +### Patch Changes
6 +
7 +- 55d8924: Preserve the originating `tool_use_id` in Python Anthropic tool results and retain session execution status, log IDs, and returned Instant charges in provider execution results. Clarify the TypeScript Anthropic helpers' existing result projection and message correlation in their API documentation.
8 +- d5c1861: Update runtime dependencies, require patched Zod 4 releases where used directly, support Anthropic SDK 1.6, and update the AutoGen provider's FLAML dependency. Preserve Zod 3 compatibility fixtures and existing framework version boundaries.
9 +
10 ## 0.11.7
11
12 ### Patch Changes
ts/packages/providers/anthropic/package.json
+1 -1
@@ -1,6 +1,6 @@
1 {
2 "name": "@composio/anthropic",
3 - "version": "0.11.7",
3 + "version": "0.11.8",
4 "description": "Non-Agentic Provider for Anthropic in Composio SDK",
5 "main": "src/index.ts",
6 "type": "module",
ts/packages/providers/claude-agent-sdk/CHANGELOG.md
+8
@@ -1,5 +1,13 @@
1 # @composio/claude-code-agents
2
3 +## 0.13.1
4 +
5 +### Patch Changes
6 +
7 +- d5c1861: Update runtime dependencies, require patched Zod 4 releases where used directly, support Anthropic SDK 1.6, and update the AutoGen provider's FLAML dependency. Preserve Zod 3 compatibility fixtures and existing framework version boundaries.
8 +- Updated dependencies [d5c1861]
9 + - @composio/json-schema-to-zod@0.4.1
10 +
11 ## 0.13.0
12
13 ### Minor Changes
ts/packages/providers/claude-agent-sdk/package.json
+1 -1
@@ -1,6 +1,6 @@
1 {
2 "name": "@composio/claude-agent-sdk",
3 - "version": "0.13.0",
3 + "version": "0.13.1",
4 "description": "Composio provider for Claude Agent SDK",
5 "main": "src/index.ts",
6 "type": "module",
ts/packages/providers/google/CHANGELOG.md
+6
@@ -1,5 +1,11 @@
1 # @composio/google
2
3 +## 0.13.0
4 +
5 +### Minor Changes
6 +
7 +- 495be0f: Fix Gemini rejecting Composio tools with a 400 such as `Unknown name "examples"`. `wrapTool` and `wrapTools` now put each tool's schema in `parametersJsonSchema` instead of `parameters`, so JSON Schema keywords that Composio tools carry, such as `examples`, `const`, `null` types, and integer enums, reach Gemini intact. The `@google/genai` peer dependency now requires `^1.6.0`, the first release that supports `parametersJsonSchema` on function declarations.
8 +
9 ## 0.12.0
10
11 ### Minor Changes
ts/packages/providers/google/package.json
+1 -1
@@ -1,6 +1,6 @@
1 {
2 "name": "@composio/google",
3 - "version": "0.12.0",
3 + "version": "0.13.0",
4 "description": "Google GenAI Provider for Composio SDK",
5 "main": "src/index.ts",
6 "type": "module",
ts/packages/providers/langchain/CHANGELOG.md
+6
@@ -1,5 +1,11 @@
1 # @composio/langchain
2
3 +## 0.11.3
4 +
5 +### Patch Changes
6 +
7 +- d5c1861: Update runtime dependencies, require patched Zod 4 releases where used directly, support Anthropic SDK 1.6, and update the AutoGen provider's FLAML dependency. Preserve Zod 3 compatibility fixtures and existing framework version boundaries.
8 +
9 ## 0.11.2
10
11 ### Patch Changes
ts/packages/providers/langchain/package.json
+1 -1
@@ -1,6 +1,6 @@
1 {
2 "name": "@composio/langchain",
3 - "version": "0.11.2",
3 + "version": "0.11.3",
4 "description": "",
5 "main": "dist/index.js",
6 "type": "module",
ts/packages/providers/mastra/CHANGELOG.md
+6
@@ -1,5 +1,11 @@
1 # @composio/mastra
2
3 +## 0.10.7
4 +
5 +### Patch Changes
6 +
7 +- d5c1861: Update runtime dependencies, require patched Zod 4 releases where used directly, support Anthropic SDK 1.6, and update the AutoGen provider's FLAML dependency. Preserve Zod 3 compatibility fixtures and existing framework version boundaries.
8 +
9 ## 0.10.6
10
11 ### Patch Changes
ts/packages/providers/mastra/package.json
+1 -1
@@ -1,6 +1,6 @@
1 {
2 "name": "@composio/mastra",
3 - "version": "0.10.6",
3 + "version": "0.10.7",
4 "description": "Agentic Provider for mastra in Composio SDK",
5 "main": "src/index.ts",
6 "type": "module",
ts/packages/providers/openai-agents/CHANGELOG.md
+6
@@ -1,5 +1,11 @@
1 # @composio/openai-agents
2
3 +## 0.11.3
4 +
5 +### Patch Changes
6 +
7 +- 39fc590: Allow OpenAI Agents SDK 0.21 in the TypeScript provider's peer dependencies. Require composio 0.32.0 or newer for the Python OpenAI Agents provider so installs cannot retain an older core.
8 +
9 ## 0.11.2
10
11 ### Patch Changes
ts/packages/providers/openai-agents/package.json
+1 -1
@@ -1,6 +1,6 @@
1 {
2 "name": "@composio/openai-agents",
3 - "version": "0.11.2",
3 + "version": "0.11.3",
4 "description": "",
5 "main": "src/index.ts",
6 "type": "module",
ts/packages/providers/typesafe/CHANGELOG.md
+6
@@ -1,5 +1,11 @@
1 # @composio/typesafe
2
3 +## 0.1.2
4 +
5 +### Patch Changes
6 +
7 +- d5c1861: Update runtime dependencies, require patched Zod 4 releases where used directly, support Anthropic SDK 1.6, and update the AutoGen provider's FLAML dependency. Preserve Zod 3 compatibility fixtures and existing framework version boundaries.
8 +
9 ## 0.1.1
10
11 ### Patch Changes
ts/packages/providers/typesafe/package.json
+1 -1
@@ -1,6 +1,6 @@
1 {
2 "name": "@composio/typesafe",
3 - "version": "0.1.1",
3 + "version": "0.1.2",
4 "description": "TypeSafe (Jev) Provider for Composio SDK",
5 "main": "src/index.ts",
6 "type": "module",
ts/packages/slim/CHANGELOG.md
+14
@@ -1,5 +1,19 @@
1 # @composio/slim
2
3 +## 0.30.0
4 +
5 +### Minor Changes
6 +
7 +- 6f8a704: Custom toolkits are no longer experimental. Use `composio.customToolkits` in TypeScript and `composio.custom_toolkits` in Python. `composio.experimental.customToolkits` and `composio.experimental.custom_toolkits` are deprecated aliases of the same object and keep working. Python also exports the class as `CustomToolkits`; `ExperimentalCustomToolkits` stays as an alias.
8 +
9 +### Patch Changes
10 +
11 +- 41c4666: Allow `RemoteFile.save()` to save to an explicit path when the home directory cannot be resolved.
12 +- 4ee12da: Use generated client types for inline local-tool payloads and share Python result handling between session tool and meta-tool execution. Public methods and request and response shapes are unchanged.
13 +- d5c1861: Update runtime dependencies, require patched Zod 4 releases where used directly, support Anthropic SDK 1.6, and update the AutoGen provider's FLAML dependency. Preserve Zod 3 compatibility fixtures and existing framework version boundaries.
14 +- Updated dependencies [d5c1861]
15 + - @composio/json-schema-to-zod@0.4.1
16 +
17 ## 0.29.0
18
19 ### 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.30.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.33.0"
494 source = { editable = "python" }
495 dependencies = [
496 { name = "certifi" },
@@ -575,7 +575,7 @@ release = [
575
576 [[package]]
577 name = "composio-anthropic"
578 -version = "0.32.0"
578 +version = "0.33.0"
579 source = { editable = "python/providers/anthropic" }
580 dependencies = [
581 { name = "anthropic" },
@@ -604,7 +604,7 @@ wheels = [
604
605 [[package]]
606 name = "composio-gemini"
607 -version = "0.32.0"
607 +version = "0.33.0"
608 source = { virtual = "python/providers/gemini" }
609 dependencies = [
610 { name = "composio" },
@@ -619,7 +619,7 @@ requires-dist = [
619
620 [[package]]
621 name = "composio-google"
622 -version = "0.32.0"
622 +version = "0.33.0"
623 source = { editable = "python/providers/google" }
624 dependencies = [
625 { name = "composio" },
@@ -634,7 +634,7 @@ requires-dist = [
634
635 [[package]]
636 name = "composio-google-adk"
637 -version = "0.32.0"
637 +version = "0.33.0"
638 source = { editable = "python/providers/google_adk" }
639 dependencies = [
640 { name = "composio" },
@@ -649,7 +649,7 @@ requires-dist = [
649
650 [[package]]
651 name = "composio-langchain"
652 -version = "0.32.0"
652 +version = "0.33.0"
653 source = { editable = "python/providers/langchain" }
654 dependencies = [
655 { name = "composio" },
@@ -664,7 +664,7 @@ requires-dist = [
664
665 [[package]]
666 name = "composio-openai"
667 -version = "0.32.0"
667 +version = "0.33.0"
668 source = { editable = "python/providers/openai" }
669 dependencies = [
670 { name = "composio" },
@@ -679,7 +679,7 @@ requires-dist = [
679
680 [[package]]
681 name = "composio-openai-agents"
682 -version = "0.32.0"
682 +version = "0.33.0"
683 source = { editable = "python/providers/openai_agents" }
684 dependencies = [
685 { name = "composio" },