@devries-cameron20 / composio Mirror · read-only / commits / bee262971
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, 08:30 UTC

chore: release Python 0.28.0, TypeScript 0.25.0, and CLI 0.4.5 (#4916)

## Summary Prepare Python SDK 0.28.0, TypeScript SDK 0.25.0, and CLI 0.4.5 with a shared public changelog. The SDK minor releases add session approval requests and continuations, change identity-header override handling, and move TypeScript executeMeta request options to its fourth argument. CLI changes are request/error-handling fixes and internal refactors, so its release is a patch. Synchronize Python core and all 13 provider versions, regenerate uv.lock with pinned uv, and finalize the CLI changelog. Consolidate useful documentation from #4867, #4866, #4822, and #4699, updating approval continuation guidance; the older Instant charge paragraph is superseded by the current spending guide. Update the docs site's core SDK dependency to the published 0.24.0 so its examples compile. ## Validation - All 28 Python wheels/sdists built, passed twine check, and agree on version 0.28.0 and Python 3.11–3.15 support. - A fresh Python wheel consumer passed imports, typing-marker and approval-continuation checks, and uv pip check. - Documentation production build passed, including Twoslash examples; 21 focused docs tests and both docs/SDK link validators passed. - Release workflow metadata, Changesets, agent skills, and skill-routing validators passed. - ECR quota failures are explicitly waived by the release owner. - The optional Python audit reports the existing CrewAI → MCP CVE-2026-59951, also failing on next at 79c2d1d. CrewAI's latest release still pins mcp~=1.28.1, excluding the published fixes. This release does not change that dependency or add an audit exclusion.

Alberto Schiabel committed Oct 16, 2026 at 03:07 UTC bee262971d7eb1a64322386e7ba0fb5b661dfbcf
40 files changed +199 -45
docs/bun.lock
+7 -5
@@ -50,7 +50,7 @@
50 "@anthropic-ai/sdk": "^0.115.0",
51 "@composio/anthropic": "^0.11.4",
52 "@composio/claude-agent-sdk": "^0.12.1",
53 - "@composio/core": "^0.23.0",
53 + "@composio/core": "^0.24.0",
54 "@composio/google": "^0.12.0",
55 "@composio/langchain": "^0.11.1",
56 "@composio/llamaindex": "^0.11.1",
@@ -213,9 +213,9 @@
213
214 "@composio/claude-agent-sdk": ["@composio/claude-agent-sdk@0.12.1", "", { "dependencies": { "zod": "^4.5.4" }, "peerDependencies": { "@anthropic-ai/claude-agent-sdk": "^0.3.199", "@composio/core": ">=0.10.0 <1.0.0 || >=1.0.0-beta.0 <1.0.0" } }, "sha512-lHKvycugdyXnliURfNovzT0xQVvMpo5ulHsHEYOSRU++KiI9vGQ6bFFcVi+GAkxJy9FEz8TGmt/JkZ/3gs2MXQ=="],
215
216 - "@composio/client": ["@composio/client@2.0.0-rc.11", "", {}, "sha512-jACnskE/mH0dETIBY5C8wpbeszlr1UdPH+y5bCB+CYome2zPVXi41V5bEF+vCDOowOTXhT37y3uyWsezB8gkkw=="],
216 + "@composio/client": ["@composio/client@2.0.0-rc.14", "", { "peerDependencies": { "effect": "*" }, "optionalPeers": ["effect"] }, "sha512-AI8peOJpZjIZOC5+7uWeaQSgjwU9XsMHLXmHLrO3xE4qREb17pT1rb64AcaY9N4VFAevg321yLGA08RKCmcWDw=="],
217
218 - "@composio/core": ["@composio/core@0.23.0", "", { "dependencies": { "@composio/client": "2.0.0-rc.11", "@composio/json-schema-to-zod": "0.3.4", "@types/json-schema": "^7.0.15", "is-fs-case-sensitive": "^2.0.0", "openai": "^7.21.0", "picocolors": "^1.1.1", "pusher-js": "^8.6.0", "semver": "^7.8.5", "undici": "^7.29.1", "zod-to-json-schema": "^3.25.2" }, "peerDependencies": { "zod": ">=3.25.76 <5" } }, "sha512-ugIzIPlM7EAiVQGdkl50BZbgpZfO7vyqfJaMKiqp3MZoTQb4FSFKnjC1eLAQ5kWW/nhQysnuR79zHhsbXQWfaA=="],
218 + "@composio/core": ["@composio/core@0.24.0", "", { "dependencies": { "@composio/client": "2.0.0-rc.14", "@composio/json-schema-to-zod": "0.3.4", "@types/json-schema": "^7.0.15", "is-fs-case-sensitive": "^2.0.0", "openai": "^7.31.0", "picocolors": "^1.1.1", "pusher-js": "^8.6.0", "semver": "^7.8.5", "undici": "^7.30.0", "zod-to-json-schema": "^3.25.2" }, "peerDependencies": { "zod": ">=3.25.76 <5" } }, "sha512-WJpZDZ2SQjp1/zSSg8zM+J0zJ0ONcqFPb8Fb3FJKTMXzSf9Wa40GrnAIt2DE00Ydbe6dpsh0MocJEZu4C2oIuA=="],
219
220 "@composio/google": ["@composio/google@0.12.0", "", { "peerDependencies": { "@composio/core": ">=0.16.0 <1.0.0 || >=1.0.0-beta.0 <1.0.0", "@google/genai": "^1.1.0" } }, "sha512-VYVd7F3Nu0b/bxZgQLMb2mR8A2bPNTSKBx3SqJtMOZsJ7Gayu7JE+ZmZtJq8fFXGUmGRoqpwoopwudNpq7GS+w=="],
221
@@ -1903,7 +1903,7 @@
1903
1904 "uc.micro": ["uc.micro@2.1.0", "", {}, "sha512-ARDJmphmdvUk6Glw7y9DQ2bFkKBHwQHLi2lsaH6PPmz/Ka9sFOBsBluozhDltWmnv9u/cF6Rt87znRTPV+yp/A=="],
1905
1906 - "undici": ["undici@7.29.1", "", {}, "sha512-RYONW2MeafgYlkVOKYKkA/Ag7BmXqgIWCa8t1m0JcxrQg9pI9lEqRhAOruOBCbAohOa/gkCF+iPi9hrgvTzu6Q=="],
1906 + "undici": ["undici@7.30.1", "", {}, "sha512-03KrMbjIFDWQR5RNPrSw3bd1r12JpyFQl9/yxjUbJtqkjmllqC5lFjZh6ujeuJCKr8EOQvRW872Oy/az+nLYxg=="],
1907
1908 "undici-types": ["undici-types@8.9.0", "", {}, "sha512-KTDyRTYX8sWmKXAikPHHSyc63CRPETMctyjKFupcC6OBLXT3xsN0e9aF7m+mIXutFWpUXuedtowG7iLOzp0kQg=="],
1909
@@ -1995,6 +1995,8 @@
1995
1996 "@ai-sdk/gateway/@ai-sdk/provider-utils": ["@ai-sdk/provider-utils@5.0.12", "", { "dependencies": { "@ai-sdk/provider": "4.0.3", "@standard-schema/spec": "^1.1.0", "@workflow/serde": "4.1.0", "eventsource-parser": "^3.0.8" }, "peerDependencies": { "zod": "^3.25.76 || ^4.1.8" } }, "sha512-bbhlOgHeYwrIGheLkM6fhS8hVger8uFPmcOLg+kxc9EFh7y30XYorWhthlYAgpadO3SJhFZrIcEknN7qEqEVvA=="],
1997
1998 + "@ai-sdk/provider-utils/undici": ["undici@7.29.1", "", {}, "sha512-RYONW2MeafgYlkVOKYKkA/Ag7BmXqgIWCa8t1m0JcxrQg9pI9lEqRhAOruOBCbAohOa/gkCF+iPi9hrgvTzu6Q=="],
1999 +
2000 "@ai-sdk/provider-utils-v5/@ai-sdk/provider": ["@ai-sdk/provider@2.0.3", "", { "dependencies": { "json-schema": "^0.4.0" } }, "sha512-h88OPkavHTiN9tMn2l5awAznGB0lXzjcLhgR1/rvjB2zlLprsNxbM2tt6OJsHUxduLC3klq0/eqaSf6fX5XVww=="],
2001
2002 "@ai-sdk/provider-utils-v6/@ai-sdk/provider": ["@ai-sdk/provider@3.0.14", "", { "dependencies": { "json-schema": "^0.4.0" } }, "sha512-5X1k57JBJ4H7H1QjX7CnJYAB1I19r/trVZTMcSms7/kLNZ8RaU4Nt2agcwZzv82Hfx6Q7/TOLU7agAKeFfc8cA=="],
@@ -2007,7 +2009,7 @@
2009
2010 "@ai-sdk/ui-utils-v5/@ai-sdk/provider-utils": ["@ai-sdk/provider-utils@2.2.8", "", { "dependencies": { "@ai-sdk/provider": "1.1.3", "nanoid": "^3.3.8", "secure-json-parse": "^2.7.0" }, "peerDependencies": { "zod": "^3.23.8" } }, "sha512-fqhG+4sCVv8x7nFzYnFo19ryhAa3w096Kmc3hWxMQfW/TubPOmt3A6tYZhl4mUfQWWQMsuSkLrtjlWuXBVSGQA=="],
2011
2010 - "@composio/core/openai": ["openai@7.21.0", "", { "peerDependencies": { "@aws-sdk/credential-provider-node": ">=3.972.0 <4", "@smithy/hash-node": ">=4.3.0 <5", "@smithy/signature-v4": ">=5.4.0 <6", "undici": ">=5 <9", "ws": "^8.21.0", "zod": "^3.25 || ^4.0" }, "optionalPeers": ["@aws-sdk/credential-provider-node", "@smithy/hash-node", "@smithy/signature-v4", "undici", "ws", "zod"] }, "sha512-APwDcMhduWCSkKDLF4VZtAC5MGLRdJ0l+PUirz2fuSPXo/LNfEe8OuJVWOk8iJbO55sd8F5aOXvx8cfR5Eax1g=="],
2012 + "@composio/core/openai": ["openai@7.34.0", "", { "peerDependencies": { "@aws-sdk/credential-provider-node": ">=3.972.0 <4", "@smithy/hash-node": ">=4.3.0 <5", "@smithy/signature-v4": ">=5.4.0 <6", "undici": ">=5 <9", "ws": "^8.21.0", "zod": "^3.25 || ^4.0" }, "optionalPeers": ["@aws-sdk/credential-provider-node", "@smithy/hash-node", "@smithy/signature-v4", "undici", "ws", "zod"] }, "sha512-PMwuTQ/3cVyWZJOVpb6bzlrQj17uImlnUGQWqh5zHlN/snwK5ww4ZUHW8NYGtH6f9PQOEPxyD/f8WJVIHp1q2A=="],
2013
2014 "@floating-ui/react-dom/@floating-ui/dom": ["@floating-ui/dom@1.8.0", "", { "dependencies": { "@floating-ui/core": "^1.8.0", "@floating-ui/utils": "^0.2.12" } }, "sha512-yXSrzeHZBTZadLOlfyhCkJHNeLJnHRnRInwdZ40L7ZiaAtrBwoYlsDrX3v5zB1Utk7CLfzcOVnVVWoXEky7Ceg=="],
2015
docs/content/changelog/10-16-26-sdk-cli-releases.mdx new
+42
@@ -0,0 +1,42 @@
1 +---
2 +title: 'Session tool approvals, Python 3.15 support, and CLI request fixes'
3 +description: 'Require approval before session tools run, answer input requests in both SDKs, and avoid retrying CLI mutations.'
4 +date: '2026-10-16'
5 +---
6 +
7 +You can now require approval before selected session tools run and send the answers back through either SDK.
8 +
9 +### Release versions
10 +
11 +| SDK | Version |
12 +| --- | --- |
13 +| Python `composio` | `0.28.0` |
14 +| TypeScript `@composio/core` | `0.25.0` |
15 +| TypeScript `@composio/slim` | `0.25.0` |
16 +| CLI `composio` | `0.4.5` |
17 +
18 +All 13 Python provider packages are released at `0.28.0`.
19 +
20 +### What's new
21 +
22 +- **Session tool approvals.** Set `requireApproval` (`require_approval` in Python) on session toolkit, tool, or tag filters. When a call needs input, catch `ComposioToolInputRequiredError` (`ToolInputRequiredError` in Python), display its `inputRequests` (`input_requests`), and wait for the person's answers. Repeat the call with `inputResponses` and `requestState` (`input_responses` and `request_state`). Forward decline and cancel answers unchanged. Both tool execution and meta-tool execution support this flow.
23 +- **MCP approval fallback.** Set `experimental.noElicitationSupportFallback` (`experimental.no_elicitation_support_fallback` in Python) to `deny` or `allow` to choose what happens when the MCP client cannot ask for approval.
24 +- **Python versions.** The Python SDK supports Python 3.11 through 3.15.
25 +
26 +### Migration notes
27 +
28 +<Callout type="warn">
29 +TypeScript `session.executeMeta()` now takes input-response options as its third argument. Move request options to the fourth argument.
30 +</Callout>
31 +
32 +Before: `session.executeMeta(slug, args, requestOptions)`.
33 +
34 +After: `session.executeMeta(slug, args, undefined, requestOptions)`.
35 +
36 +Both SDKs now pass product and runtime identity through the API client's `identity` option. Remove identity headers such as `x-source`, `x-framework`, `x-sdk-version`, and `x-client-*` from custom default or request headers: the client now rejects attempts to override its identity headers instead of silently replacing them. In TypeScript, Cloudflare Workers and Vercel Edge with Node.js compatibility enabled report their actual runtime, and custom provider names that cannot be sent as header values are reported as `unknown`.
37 +
38 +### Bug fixes
39 +
40 +- **TypeScript trigger subscriptions.** `triggers.unsubscribe()` closes the realtime connection, cancels an in-progress subscription, and does not create a connection when called before subscribing. Concurrent subscriptions share a connection. Rejected asynchronous trigger handlers are logged without becoming unhandled rejections.
41 +- **CLI request handling.** Only API reads that are safe to repeat are retried. Mutating calls are sent once, preventing a timeout from repeating a side effect. Commands validate the response fields they use while tolerating unrelated API changes.
42 +- **CLI command errors.** Commands that require login report a consistent usage error. Project-resolution failures retain their specific error type. The `dev` group's `--user-id` and `--project-name` flags work before or after the subcommand, and unsupported flags fail with a usage error.
docs/content/docs/configuring-sessions.mdx
+43 -1
@@ -119,6 +119,12 @@ The SDK never retries without the config or falls back to an unrestricted sessio
119
120 In TypeScript, `session.config` exposes the configuration returned by the server. Call `session.update()` to change selected fields. It preserves omitted fields, updates `session.config` in place, and returns the updated configuration. See [Updating a session](/docs/how-composio-works#how-sessions-behave) for an example.
121
122 +`ToolRouterSessionConfig` and `ToolRouterSessionConfigHistoryConfig` use the API client's types. The SDK returns the config as sent by the API, without validating `instant` at runtime or removing `premium_usage`. `instant` is always present as `false` or a policy object. Use `ToolRouterSessionConfig['instant']` when you need its TypeScript type.
123 +
124 +When inspecting a returned config, handle `toolkits` and individual `tools` entries that contain only `require_approval`, without `enabled` or `disabled`. `tags` can also carry `require_approval`, and the config can include `proxy_execute`. These fields also appear in configurations returned by `session.listConfigHistory()`.
125 +
126 +In Python, `session.config.instant` is a model when it contains a policy. Read its fields with attribute access rather than dictionary indexing, just as you do for [Instant charges](/docs/instant-tools#return-the-charge-with-a-call).
127 +
128 <Callout>
129 If you implement the TypeScript `Session` interface yourself, include the required `config` member. Sessions created by the SDK provide it automatically.
130 </Callout>
@@ -948,7 +954,7 @@ await session.update({ manageConnections: { callbackUrl: null } });
954
955 ### Clearing a block with null
956
951 -Passing `null` (`None` in Python) for a whole block removes the stored override and the session falls back to the default for that block. Every policy block accepts it: `toolkits`, `tools`, `tags`, `authConfigs`, `connectedAccounts`, `preload`, `manageConnections`, `sandbox`, `multiAccount`, `search`, `execute`, and `experimental`.
957 +Passing `null` (`None` in Python) for a whole block removes the stored override and the session falls back to the default for that block. Every policy block accepts it: `toolkits`, `tools`, `tags`, `authConfigs`, `connectedAccounts`, `preload`, `manageConnections`, `sandbox`, `proxyExecute`, `multiAccount`, `search`, `execute`, and `experimental`.
958
959 <Tabs groupId="language" items={['Python', 'TypeScript']} persist>
960 <Tab value="Python">
@@ -1120,6 +1126,42 @@ const tools = await session.tools();
1126 </Tab>
1127 </Tabs>
1128
1129 +### executeMeta() / execute_meta()
1130 +
1131 +Run a `COMPOSIO_*` [meta tool](/toolkits/meta-tools) directly from your session with a slug and optional arguments:
1132 +
1133 +<Tabs groupId="language" items={['Python', 'TypeScript']} persist>
1134 +<Tab value="Python">
1135 +```python
1136 +from composio import Composio
1137 +
1138 +composio = Composio(api_key="your_api_key")
1139 +session = composio.create("user_123")
1140 +result = session.execute_meta(
1141 + "COMPOSIO_SEARCH_TOOLS",
1142 + arguments={"queries": [{"use_case": "send an email"}]},
1143 +)
1144 +print(result.data, result.result_type)
1145 +```
1146 +</Tab>
1147 +<Tab value="TypeScript">
1148 +```typescript
1149 +import { Composio } from '@composio/core';
1150 +const composio = new Composio({ apiKey: 'your_api_key' });
1151 +const session = await composio.create("user_123");
1152 +// ---cut---
1153 +const result = await session.executeMeta("COMPOSIO_SEARCH_TOOLS", {
1154 + queries: [{ use_case: "send an email" }],
1155 +});
1156 +console.log(result.data, result.resultType);
1157 +```
1158 +</Tab>
1159 +</Tabs>
1160 +
1161 +The exported `ToolRouterSessionMetaToolSlug` type lists the accepted slugs. The response includes `resultType` (`result_type` in Python). If execution needs input, such as approval, the SDK raises `ComposioToolInputRequiredError` (`ToolInputRequiredError` in Python). Calls are sent once without retries, so retry only when the operation is safe to repeat.
1162 +
1163 +`COMPOSIO_MULTI_EXECUTE_TOOL` calls through this method run on the backend. Custom tools named in those calls are not executed in your process.
1164 +
1165 ### authorize()
1166
1167 Manually authenticate a user to a toolkit outside of the chat flow.
docs/content/docs/extending-sessions/proxy-execute.mdx
+36
@@ -75,6 +75,40 @@ The `endpoint` is appended to the base URL, and many base URLs already include a
75 Proxy execute rejects cross-domain requests. The `endpoint` must resolve to the same domain as the toolkit's connected account (a GitHub connection can only call `api.github.com` paths). This is an intentional security boundary, not a quota, so you can't work around it by reshaping the request.
76 </Callout>
77
78 +## Exposing proxy execution to your agent
79 +
80 +Set `proxyExecute: true` (`proxy_execute=True` in Python) when creating a Session to expose the `COMPOSIO_PROXY_EXECUTE` meta tool:
81 +
82 +<Tabs groupId="language" items={['Python', 'TypeScript']} persist>
83 +<Tab value="Python">
84 +```python
85 +from composio import Composio
86 +
87 +composio = Composio(api_key="your_api_key")
88 +session = composio.create("user_123", toolkits=["github"], proxy_execute=True)
89 +```
90 +</Tab>
91 +<Tab value="TypeScript">
92 +```typescript
93 +import { Composio } from '@composio/core';
94 +const composio = new Composio({ apiKey: 'your_api_key' });
95 +// ---cut---
96 +const session = await composio.create("user_123", {
97 + toolkits: ["github"],
98 + proxyExecute: true,
99 +});
100 +```
101 +</Tab>
102 +</Tabs>
103 +
104 +The option also accepts `{ enable: true }` (`{"enable": True}` in Python). If you omit it at creation, the meta tool is off and `sandbox.enableProxyExecution` (`sandbox.enable_proxy_execution` in Python) controls the sandbox's `proxy_execute()` helper.
105 +
106 +Change the setting with `session.update({ proxyExecute: false })` or Python `session.update(proxy_execute=False)`. Disabling it also disables the sandbox helper. Pass `null` (`None` in Python) on update to remove the stored setting.
107 +
108 +<Callout type="warn">
109 +At creation, the API rejects a disabled proxy setting combined with an enabled sandbox proxy setting. Disable both, or omit the sandbox proxy setting.
110 +</Callout>
111 +
112 ## Session restrictions
113
114 Proxy execute follows the session's toolkit lists: a call for a toolkit outside `toolkits.enable` or inside `toolkits.disable` is rejected with the same error a blocked tool call gets, including from the session's sandbox.
@@ -166,6 +200,8 @@ Don't set the `Authorization` header yourself through `parameters`. Composio inj
200
201 `status` and `data` reflect exactly what the toolkit API returned, so check `status` and branch on the common failures.
202
203 +If the call needs user input before it can run, the SDK raises `ToolInputRequiredError` in Python or `ComposioToolInputRequiredError` in TypeScript instead of returning an HTTP response. Nothing was executed. See [Handling requests for user input](/docs/how-composio-works#handling-requests-for-user-input) for the error fields and continuation state.
204 +
205 | Status | Typical cause | How to resolve |
206 |---|---|---|
207 | `400 Bad Request` | Malformed endpoint path, invalid body, or unsupported `method`. | Check the upstream API docs for the expected shape. The proxy doesn't validate upstream schemas. |
docs/content/docs/how-composio-works.mdx
+14
@@ -128,6 +128,20 @@ const result = await session.execute("COMPOSIO_SEARCH_TOOLS", { queries: [{ use_
128
129 Do not execute session tools with `tools.execute()`, or by passing a user ID to a provider's `handle_tool_calls` helper — both take the direct execution path, which does not carry your session, and meta-tools fail there with `"can only be called inside a tool-router session"`. The [OpenAI](/docs/providers/openai) and [Anthropic](/docs/providers/anthropic) helpers also accept the session itself (`handle_tool_calls(response=response, session=session)` in Python, `handleToolCalls(session, response)` in TypeScript), which routes through the session while keeping provider argument normalization.
130
131 +Read `result.result_type` in Python or `result.resultType` in TypeScript to distinguish `completed` from `failed`. A failed execution can have an empty `error`, so checking `error` alone doesn't tell you whether the tool succeeded. If you pass a custom TypeScript `ToolCallSession` to a provider, its `execute()` method must return `resultType`; providers use it to determine `successful`.
132 +
133 +#### Handling requests for user input
134 +
135 +A session tool can request user input, such as an approval, before it runs. In Python, catch `ToolInputRequiredError` from `composio.exceptions`. In TypeScript, catch `ComposioToolInputRequiredError` from `@composio/core`. The error carries the questions on `input_requests` / `inputRequests` and opaque continuation state on `request_state` / `requestState`.
136 +
137 +This also applies to provider-wrapped session tools, `session.proxy_execute()` / `session.proxyExecute()`, and the session execution helpers passed to custom tools. Present the questions to your user rather than treating the error as an empty tool result.
138 +
139 +<Callout type="warn">
140 +An input-required call has not executed and is not retried. To resume `session.execute()` or `session.executeMeta()` in TypeScript, repeat the call with `inputResponses` and `requestState`. In Python, repeat `session.execute()` or `session.execute_meta()` with `input_responses` and `request_state`. Wait for the person's answers and forward decline and cancel responses unchanged. Keep the continuation state unchanged; it is excluded from logs and serialized error output, so read it directly from the error object.
141 +</Callout>
142 +
143 +The TypeScript Google and Cloudflare providers also accept `executeToolCall(session, toolCall)`. Pass the Session that produced the tools to preserve its execution settings. Passing a user ID uses direct execution.
144 +
145 ## Sandbox
146
147 Handle large responses and bulk operations in the remote sandbox. Instead of stuffing long tool responses into the model context, the agent reads files, searches outputs, writes Python, transforms data, and calls Composio tools in bulk.
docs/content/docs/instant-tools.mdx
+2
@@ -300,6 +300,8 @@ Instant support is **per tool**. A toolkit supporting Instant does not mean ever
300
301 Follow `next_cursor` when listing tools or toolkits, including pages with no Instant matches. Instant metadata is absent for older toolkit versions and ineligible tools. Neither `no_auth` nor `composio_managed_auth_schemes` indicates Instant support.
302
303 +You can also change price reporting on an existing Session with `session.update(instant={"return_prices_in_search": True})` in Python or `await session.update({ instant: { returnPricesInSearch: true } })` in TypeScript.
304 +
305 ## Know which account runs the tool
306
307 Composio uses your user's connection first, then an available shared connection, then an Instant account. Only calls through an Instant account incur an Instant charge. Your provider may separately bill calls made with your own account.
docs/content/docs/migration-guide/mcp-servers-to-sessions.mdx
+4
@@ -8,6 +8,10 @@ written: "June 2026"
8 This guide is for developers using Composio's **MCP servers** (`composio.mcp.create` /
9 `composio.mcp.generate`, the "Single Toolkit MCP" flow) who want to migrate to **sessions**.
10
11 +<Callout type="warn">
12 +`composio.mcp.generate()` warns once that its URLs depend on the deprecated `include_composio_helper_actions` query parameter. Use a Session's `session.mcp.url` instead, as shown below.
13 +</Callout>
14 +
15 Sessions are the next generation of the same idea: you still get an MCP URL that any MCP-compatible
16 client connects to — but instead of standing up and managing a separate server config per toolkit,
17 you create a session that handles tool discovery, authentication, context, and versioning for you.
docs/content/docs/providers/google.mdx
+2
@@ -17,6 +17,8 @@ In Python, the Gemini provider (`composio_gemini`) wraps Composio tools as typed
17
18 Object arguments that declare no properties preserve arbitrary nested keys in both providers. The TypeScript provider also adds `type: "object"` to schema nodes that declare `properties` without a type, which is the shape Gemini expects for object schemas.
19
20 +If you use the Python `composio_google` provider with a manual Gemini loop, pass the Session to `composio.provider.execute_tool_call(session=session, function_call=function_call)` or `composio.provider.handle_response(session=session, response=response)`. Both helpers execute through that Session. Calls with `user_id` use direct execution for tools fetched with `tools.get()`. The `composio_gemini` callables in the example below already carry the Session.
21 +
22 <Steps>
23 <Step>
24 **Install**
docs/content/docs/providers/openai.mdx
+4
@@ -406,6 +406,10 @@ The OpenAI integration ships three providers, one per API surface:
406 - **`OpenAIProvider`** for the Chat Completions API. This is the SDK default, so `new Composio()` with no provider uses it. You keep the full message list and append each assistant message plus its `tool` results yourself.
407 - **`OpenAIAgentsProvider`** for the Agents SDK. Tools come with execution wired in, so the SDK runs the loop for you.
408
409 +<Callout type="warn">
410 +`@composio/openai` no longer includes Assistants API helpers. Migrate Assistants integrations to the Responses API with `OpenAIResponsesProvider`, using the Responses example above.
411 +</Callout>
412 +
413 **Strict mode.** Pass `strict: true` or `strict=True` to `OpenAIResponsesProvider` or `OpenAIAgentsProvider` to normalize each tool's input schema for [structured outputs](https://platform.openai.com/docs/guides/structured-outputs). Every object lists all of its properties in `required` and is closed, while optional properties stay available but accept `null`. A `null` is dropped before the tool runs unless the tool's own schema accepts `null` for that parameter. Tools whose schema strict mode cannot express, such as objects that accept arbitrary keys, `allOf`, `prefixItems`, or unresolved `$ref`s, are sent without strict mode and log a warning.
414
415 <Tabs groupId="language" items={["Python", "TypeScript"]} persist>
docs/package.json
+1 -1
@@ -84,7 +84,7 @@
84 "@anthropic-ai/sdk": "^0.115.0",
85 "@composio/anthropic": "^0.11.4",
86 "@composio/claude-agent-sdk": "^0.12.1",
87 - "@composio/core": "^0.23.0",
87 + "@composio/core": "^0.24.0",
88 "@composio/google": "^0.12.0",
89 "@composio/langchain": "^0.11.1",
90 "@composio/llamaindex": "^0.11.1",
python/composio/__version__.py
+1 -1
@@ -1 +1 @@
1 -__version__ = "0.27.0"
1 +__version__ = "0.28.0"
python/providers/anthropic/pyproject.toml
+1 -1
@@ -1,6 +1,6 @@
1 [project]
2 name = "composio-anthropic"
3 -version = "0.27.0"
3 +version = "0.28.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.27.0",
11 + version="0.28.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.27.0"
3 +version = "0.28.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.27.0",
11 + version="0.28.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.27.0"
3 +version = "0.28.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.27.0",
11 + version="0.28.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.27.0"
3 +version = "0.28.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.27.0",
9 + version="0.28.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.27.0"
3 +version = "0.28.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.27.0",
11 + version="0.28.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.27.0"
3 +version = "0.28.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.27.0",
11 + version="0.28.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.27.0"
3 +version = "0.28.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.27.0",
11 + version="0.28.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.27.0"
3 +version = "0.28.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.27.0",
11 + version="0.28.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.27.0"
3 +version = "0.28.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.27.0",
11 + version="0.28.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.27.0"
3 +version = "0.28.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.27.0",
11 + version="0.28.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.27.0"
3 +version = "0.28.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.27.0",
11 + version="0.28.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.27.0"
3 +version = "0.28.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.27.0",
11 + version="0.28.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.27.0"
3 +version = "0.28.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.27.0",
11 + version="0.28.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.27.0"
3 +version = "0.28.0"
4 description = "SDK for integrating Composio with your applications."
5 readme = "README.md"
6 requires-python = ">=3.11,<3.16"
ts/packages/cli/CHANGELOG.md
+7 -1
@@ -1,9 +1,15 @@
1 # @composio/cli
2
3 -## Unreleased
3 +## 0.4.5
4
5 ### Patch Changes
6
7 +- Retry only API reads that are safe to repeat. Mutating calls are sent once,
8 + including when a request times out after the server may have acted.
9 +- Commands that require login now fail consistently with a usage error.
10 + Project-resolution failures retain their specific error type.
11 +- Tolerate API response fields the command does not consume while continuing
12 + to validate fields used for output, credentials, and cached data.
13 - The CLI now uses `@composio/client@2.0.0-rc.17` (up from `2.0.0-rc.14`). No
14 command changes.
15 - API requests now carry the CLI's product, version and runtime headers through
uv.lock
+9 -9
@@ -723,7 +723,7 @@ wheels = [
723
724 [[package]]
725 name = "composio"
726 -version = "0.27.0"
726 +version = "0.28.0"
727 source = { editable = "python" }
728 dependencies = [
729 { name = "composio-client" },
@@ -788,7 +788,7 @@ dev = [
788
789 [[package]]
790 name = "composio-anthropic"
791 -version = "0.27.0"
791 +version = "0.28.0"
792 source = { editable = "python/providers/anthropic" }
793 dependencies = [
794 { name = "anthropic" },
@@ -817,7 +817,7 @@ wheels = [
817
818 [[package]]
819 name = "composio-crewai"
820 -version = "0.27.0"
820 +version = "0.28.0"
821 source = { editable = "python/providers/crewai" }
822 dependencies = [
823 { name = "composio" },
@@ -832,7 +832,7 @@ requires-dist = [
832
833 [[package]]
834 name = "composio-gemini"
835 -version = "0.27.0"
835 +version = "0.28.0"
836 source = { virtual = "python/providers/gemini" }
837 dependencies = [
838 { name = "composio" },
@@ -847,7 +847,7 @@ requires-dist = [
847
848 [[package]]
849 name = "composio-google"
850 -version = "0.27.0"
850 +version = "0.28.0"
851 source = { editable = "python/providers/google" }
852 dependencies = [
853 { name = "composio" },
@@ -862,7 +862,7 @@ requires-dist = [
862
863 [[package]]
864 name = "composio-google-adk"
865 -version = "0.27.0"
865 +version = "0.28.0"
866 source = { editable = "python/providers/google_adk" }
867 dependencies = [
868 { name = "composio" },
@@ -877,7 +877,7 @@ requires-dist = [
877
878 [[package]]
879 name = "composio-langchain"
880 -version = "0.27.0"
880 +version = "0.28.0"
881 source = { editable = "python/providers/langchain" }
882 dependencies = [
883 { name = "composio" },
@@ -892,7 +892,7 @@ requires-dist = [
892
893 [[package]]
894 name = "composio-openai"
895 -version = "0.27.0"
895 +version = "0.28.0"
896 source = { editable = "python/providers/openai" }
897 dependencies = [
898 { name = "composio" },
@@ -907,7 +907,7 @@ requires-dist = [
907
908 [[package]]
909 name = "composio-openai-agents"
910 -version = "0.27.0"
910 +version = "0.28.0"
911 source = { editable = "python/providers/openai_agents" }
912 dependencies = [
913 { name = "composio" },