Python SDK 0.29.1: certificate and dependency hardening
This patch release hardens how the Python SDK and its providers resolve dependencies. It has no API changes.Release versions
All 13 Python provider packages are released at
0.29.1.
What’s changed
certifi>=2026.10.19is now required. That bundle removes the emSign ECC Root CA - G3 root after eight eMudhra intermediate keys were compromised. Older bundles still trust certificates issued under it.- Third-party dependencies have upper bounds. Each range stops before the first major version that wasn’t released yet when the cap was set, or before
1.0for packages still on0.x. A future major line can’t install until the SDK raises the cap. Ranges can still span majors that already exist:openai>=2.48.0,<4allows 2.x and 3.x, andanthropic>=0.120.0,<3allows 0.x through 2.x.certifistays uncapped so CA bundle updates always install. pysheris pinned to1.0.8. The trigger client depends on it, and it has had no release since 2022. Its transport is capped atwebsocket-client<2.- Releases come from a locked build. Packages are built only from locked dependencies and published with PyPI trusted publishing, so each file on PyPI carries an attestation linking it to the GitHub workflow that built it.
Python SDK 0.29.0: toolkit warnings and provider argument fixes
The Python SDK now warns when the API reports that a toolkit version you use is deprecated. This release also fixes tool argument serialization and preserves more of your schemas across providers.Release versions
All 13 Python provider packages are released at
0.29.0.
What’s new
- Toolkit deprecation warnings. The SDK warns once per process for each deprecated toolkit version reported through the
Composio-Deprecated-Toolkitsresponse header. The warning names the version, its sunset date, and how to pin a newer version. See toolkit versioning.
Migration notes
If you constructHttpClient directly, replace the credential keywords with an auth value:
Before: HttpClient(provider="openai", api_key=key).
After: HttpClient(provider="openai", auth=ProjectAuth(key)), importing ProjectAuth from composio_client.
For organization and project routing, replace scope headers with scope=Scope(organization_id=org_id, project_id=project_id), importing Scope from composio_client. Remove default_query from direct client construction.
Bug fixes
- Pydantic aliases. Tool execution serializes Pydantic arguments with their declared aliases, including nested models and explicit serialization aliases.
- Provider arguments. AutoGen and Google ADK preserve and validate free-form arguments instead of dropping them. OpenAI Agents preserves the source schema’s
additionalProperties. See the provider behavior changes and limitations. - Google ADK nested arrays. The provider preserves nested array item schemas instead of replacing them with a flat string schema.
SDK releases: session hooks in Python 0.30.0 and TypeScript 0.27.0
You can now attach hooks to a session to block a tool call before it runs or block its result before your agent sees it.Release versions
All 13 Python provider packages are released at
0.30.0.
What’s new
- Session hooks. Pass
hookswhen you create or update a session. Hooks can run before execution or after execution, and can apply to selected toolkits. Updatinghooksreplaces the whole list;Nonein Python ornullin TypeScript removes every hook. You cannot combinehookswithexperimental.session_config_idin Python orexperimental.sessionConfigIdin TypeScript in the same call. - Hook outcomes. Session execution returns
result_type="blocked"in Python orresultType: 'blocked'in TypeScript when a hook blocks a call or result. The response contains emptydata, the hook’s message inerror, andblock_reasonorblockReason. When hooks apply, inspecthook_resultsorhookResultsfor their outcomes. Provider integrations return blocked execution as a failed tool call with the hook’s message.
Migration notes
In Python, replace direct access to a proxy response’sstatus with a result-type check:
Before: print(response.status).
After: print(response["status"] if response["result_type"] == "completed" else response["message"]).
In TypeScript, make the equivalent check:
Before: console.log(response.status).
After: console.log(response.resultType === 'completed' ? response.status : response.message).
This applies to session.proxy_execute() and ctx.proxy_execute() in Python, and session.proxyExecute() and ctx.proxyExecute() in TypeScript.
Bug fixes
- Python custom-tool annotations.
@composio.experimental.toolreports unresolved input annotations when you register the tool, with the affected parameter and the original resolution error. - Anthropic provider dependencies. The TypeScript Anthropic provider removes its unused
@mastra/mcppeer dependency, avoiding unrelated packages during installation.
TypeScript SDK 0.26.0: toolkit warnings and provider schema fixes
The TypeScript SDK now warns when the API reports that a toolkit version you use is deprecated. This release also preserves more of your tool schemas and arguments across providers.Release versions
What’s new
- Toolkit deprecation warnings. The SDK warns once per process for each deprecated toolkit version reported through the
Composio-Deprecated-Toolkitsresponse header. The warning names the version, its sunset date, and how to pin a newer version. See toolkit versioning. - Zod v4 schema builder. Import
jsonSchemaToZodorjsonSchemaToZodShapefrom@composio/json-schema-to-zod/v4to build classic Zod v4 schemas. The root entry continues to build Zod v3 schemas. The v4 builder requires Zod4.1.13or newer and preserves schema annotations in metadata forz.toJSONSchema(). - Provider schema preservation. The TypeScript Vercel and LlamaIndex providers now give the model the tool’s JSON Schema directly, preserving keywords such as
format,contentEncoding, andcontentMediaType. Claude Agent SDK uses the new Zod v4 builder to preserve those annotations. Existing tool argument validation stays in place.
Migration notes
- TypeScript client access. Read credentials from
composio.getConfig()instead ofcomposio.getClient().apiKey,.userApiKey, or.orgApiKey. The client also removes.logger. ItsbaseURL,maxRetries,timeout, andlogLevelare read-only; derive a client withwithOptions()to change them. For example, replacecomposio.getClient().maxRetries = 0withconst client = composio.getClient().withOptions({ maxRetries: 0 })and use the derived client for those calls. - TypeScript custom headers. Replace
COMPOSIO_CUSTOM_HEADERSwith the SDK’sdefaultHeadersoption. Credential and scope headers indefaultHeadersorcreateSession({ headers })are folded into SDK configuration and no longer appear undergetConfig().defaultHeaders. Supply at most one ofx-api-key,x-user-api-key, orx-org-api-key; multiple credential headers now throw. Per-call client headers cannot override credentials or scope. WithapiKey: nulland only an organization API key, API calls, trigger authorization, andsession.mcp.headersnow consistently carryx-org-api-key. - Vercel tool schemas.
tool.inputSchemais now an AI SDKSchema. Replace directtool.inputSchema.safeParse(value)calls withasSchema(tool.inputSchema).validate(value), importingasSchemafromai. - Claude Agent SDK and Zod v4. Upgrade Zod to
4.1.13or newer before upgrading@composio/claude-agent-sdk. Older Zod v4 versions do not provide the shared metadata registry the builder needs. - Deprecated TypeScript connection data. For
customConnectionDatawithS2S_OAUTH2, supplyval.access_token, which the API requires.
Bug fixes
- Strict TypeScript tool schemas. OpenAPI
nullableis converted into a nullable type or a null branch. Unsupported string formats, includinguri, custom formats, andpath, are removed before strict requests reach the model provider. This prevents a single tool schema from causing the whole request to fail. - String argument validation. TypeScript checks a string as base64 only when its
contentEncodingisbase64. Fields withformat: "binary"or another encoding, such asbase16, accept plain strings instead of being rejected as invalid base64. - Zod v3 validation paths. Errors inside nested object properties report each property name once, including errors from
patternProperties,additionalProperties, andoneOf.