@devries-cameron20 / composio Mirror · read-only
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

next
mdx 52 lines 2.42 KB
Raw
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.