Composio powers 1000+ toolkits, tool search, context management, authentication, and a sandboxed workbench to help you build AI agents that turn intent into action.
| 1 | --- |
| 2 | title: "TypeScript SDK 0.12.0 and Python SDK 0.16.0" |
| 3 | description: "TypeScript SDK 0.12.0 adds request cancellation and becomes ESM-only. Python SDK 0.16.0 fixes file transfer, retries, schema handling, and provider aliases." |
| 4 | date: "2026-06-25" |
| 5 | --- |
| 6 | |
| 7 | This release improves failure handling on both SDKs. TypeScript callers can cancel a request rather than waiting for a slow network operation. Python fixes file handling, request timeouts, retry safety, and schema compatibility that could otherwise produce incorrect tool calls. |
| 8 | |
| 9 | ### SDK versions |
| 10 | |
| 11 | | SDK | Version | |
| 12 | | --- | --- | |
| 13 | | TypeScript `@composio/core` | `0.12.0` | |
| 14 | | Python `composio` | `0.16.0` | |
| 15 | |
| 16 | ### TypeScript: request cancellation and ESM-only packages |
| 17 | |
| 18 | Public TypeScript SDK methods accept a trailing `{ signal?: AbortSignal }` request-options argument. Caller-initiated aborts are normalized to `ComposioRequestCancelledError`, including custom tools that cooperatively use `SessionContext.signal`. |
| 19 | |
| 20 | <Callout type="warn"> |
| 21 | **Breaking change** |
| 22 | |
| 23 | The TypeScript SDK packages are ESM-only in `0.12.0`. Use Node.js `22.22.3` or newer and ESM imports. The SDK no longer ships `.cjs` artifacts or its prior CommonJS compatibility layer. |
| 24 | </Callout> |
| 25 | |
| 26 | **Before:** |
| 27 | |
| 28 | ```javascript |
| 29 | const { Composio } = require('@composio/core'); |
| 30 | ``` |
| 31 | |
| 32 | **After:** |
| 33 | |
| 34 | ```javascript |
| 35 | import { Composio } from '@composio/core'; |
| 36 | ``` |
| 37 | |
| 38 | The deprecated auth-config `uuid` response field was also removed. Use the canonical `id` field instead. |
| 39 | |
| 40 | ### TypeScript improvements |
| 41 | |
| 42 | - `authConfigs.list()` adds `search` and `showDisabled` filters. |
| 43 | - Tool schema handling preserves and resolves internal `$defs` and `$ref` values for automatic file upload and download. |
| 44 | - Custom tools correctly convert both Zod 3 and Zod 4 schemas to JSON Schema. |
| 45 | - The Anthropic provider sanitizes unsupported input-schema property names and restores the original tool arguments before execution. |
| 46 | |
| 47 | ### Python fixes |
| 48 | |
| 49 | - File fields hidden behind `$ref` or `$defs` are resolved before automatic upload and download handling. |
| 50 | - `tools.execute()` and `tools.proxy()` no longer retry non-idempotent writes, preventing duplicate side effects after timeouts, 429s, or 5xx responses. |
| 51 | - Session file transfers and presigned S3 requests now use bounded connect and read timeouts, surfacing typed file errors rather than hanging. |
| 52 | - Provider tool schemas safely alias Python-invalid parameter names, preserve the original names for execution, and avoid mutating OpenAI Agents source schemas. |