Skip to content

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

chore(deps): bump composio client SDKs (TS alpha.74, Py 1.41.0) (#3609)

Alberto Schiabela0bef5d986d5
diff --git a/.changeset/bump-composio-client-alpha74.md b/.changeset/bump-composio-client-alpha74.md
new file mode 100644
index 000000000..645db442d
--- /dev/null
+++ b/.changeset/bump-composio-client-alpha74.md
@@ -0,0 +1,6 @@
+---
+'@composio/core': minor
+'@composio/cli': minor
+---
+
+Bump `@composio/client` to `0.1.0-alpha.74`.
diff --git a/AGENTS.md b/AGENTS.md
index de0dd37dd..2e05e917a 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -237,4 +237,24 @@ mise lock --platform linux-x64,linux-arm64,macos-arm64,macos-x64
Commit `mise.lock` with the version bump. The "Prerequisites" section in `ts/docs/internal/release.md` references `mise.toml` so it stays current automatically.
+### When Bumping the Generated SDK Client (`@composio/client` / `composio-client`)
+
+The Stainless-generated clients are published from separate repos (`ComposioHQ/composio-base-ts` → `@composio/client` on npm; `ComposioHQ/composio-base-py` → `composio-client` on PyPI). **Nothing auto-bumps them here** — there is no Stainless→consumer bot, and Dependabot does not touch the pnpm `catalog:` pin (TS) or the exact `composio-client==` pin (Python). Bumping is manual, and the pin lives in **multiple files that must move together**:
+
+1. **Confirm the version is actually published first.** Check `npm view @composio/client version` / `pip index versions composio-client`. The Python PyPI publish in `composio-base-py` can fail silently (e.g. `403 Forbidden` from a stale `PYPI_TOKEN`) even when the GitHub release/tag exists — verify the package resolves before bumping.
+
+2. **TypeScript** — edit the catalog pin, refresh the lockfile, add a changeset:
+ ```bash
+ # edit pnpm-workspace.yaml -> catalog: '@composio/client'
+ pnpm install --lockfile-only # updates pnpm-lock.yaml
+ # add a patch changeset for @composio/core and @composio/cli (both consume it)
+ ```
+
+3. **Python** — the pin lives in **three** places; update all of them or `uv sync` / published metadata will be inconsistent:
+ - `python/pyproject.toml` (`dependencies`)
+ - `python/setup.py` (`install_requires`) — easy to miss; setuptools fallback metadata
+ - root `uv.lock` — regenerate from the workspace root: `uv lock --upgrade-package composio-client`
+
+4. **A version bump is not enough across a breaking regen.** The generated client can remove or restructure modules between releases (e.g. `composio-client` 1.41.0 deleted `types.tool_router_create_session_params`), which surfaces as an *import-time* `ModuleNotFoundError` that reds every job importing the SDK. After bumping, actually import/typecheck the consuming code (`uv run --package composio python -c "import composio"`, `pnpm typecheck`) and migrate any references the new client dropped. Prefer decoupling from churny generated types — define small local TypedDicts instead of importing internal client submodules.
+
This monorepo uses pnpm workspaces and Turbo for efficient builds and development.
diff --git a/pnpm-lock.yaml b/pnpm-lock.yaml
index 0d21147b3..9d93e9289 100644
--- a/pnpm-lock.yaml
+++ b/pnpm-lock.yaml
@@ -25,8 +25,8 @@ catalogs:
specifier: ^4.20250917.0
version: 4.20260218.0
'@composio/client':
- specifier: 0.1.0-alpha.72
- version: 0.1.0-alpha.72
+ specifier: 0.1.0-alpha.74
+ version: 0.1.0-alpha.74
'@effect/cli':
specifier: ^0.73.2
version: 0.73.2
@@ -1061,7 +1061,7 @@ importers:
version: link:../cli-local-tools
'@composio/client':
specifier: 'catalog:'
- version: 0.1.0-alpha.72
+ version: 0.1.0-alpha.74
'@composio/core':
specifier: workspace:*
version: link:../core
@@ -1231,7 +1231,7 @@ importers:
dependencies:
'@composio/client':
specifier: 'catalog:'
- version: 0.1.0-alpha.72
+ version: 0.1.0-alpha.74
'@composio/json-schema-to-zod':
specifier: workspace:*
version: link:../json-schema-to-zod
@@ -1894,8 +1894,8 @@ packages:
resolution: {integrity: sha512-ooWCrlZP11i8GImSjTHYHLkvFDP48nS4+204nGb1RiX/WXYHmJA2III9/e2DWVabCESdW7hBAEzHRqUn9OUVvQ==}
engines: {node: '>=0.1.90'}
- '@composio/[email protected]':
- resolution: {integrity: sha512-2WYXgdlMvhoaJCsaSfyMAYGQ2tS5l2Fqdh2cMRqNi8NybIoOkFZy2ApBJJOoQwqfpUr41VymMW6FtiNQm7JavQ==}
+ '@composio/[email protected]':
+ resolution: {integrity: sha512-/EHJsFxCpWfRxNvXURRrGVZfJSltSpN4Gkd9M9Cl5gPOirG+NpbXf2B8d4B72H87m7cnOguMKjOH42ogQ84/Ww==}
'@cspotcode/[email protected]':
resolution: {integrity: sha512-IchNf6dN4tHoMFIn/7OE8LWZ19Y6q/67Bmf6vnGREv8RSbBVb9LPJxEcnwrcwX6ixSvaiGoomAUvu4YSxXrVgw==}
@@ -7019,7 +7019,7 @@ snapshots:
'@colors/[email protected]':
optional: true
- '@composio/[email protected]': {}
+ '@composio/[email protected]': {}
'@cspotcode/[email protected]':
dependencies:
diff --git a/pnpm-workspace.yaml b/pnpm-workspace.yaml
index 8d21a68e9..77b69469d 100644
--- a/pnpm-workspace.yaml
+++ b/pnpm-workspace.yaml
@@ -22,7 +22,7 @@ catalog:
'@clack/prompts': '^1.0.1'
'@cloudflare/vitest-pool-workers': 0.16.12
'@cloudflare/workers-types': ^4.20250917.0
- '@composio/client': 0.1.0-alpha.72
+ '@composio/client': 0.1.0-alpha.74
'@effect/cli': ^0.73.2
'@effect/eslint-plugin': ^0.3.2
'@effect/language-service': ^0.74.0
diff --git a/python/composio/core/models/mcp.py b/python/composio/core/models/mcp.py
index 2e4f17050..582d126f0 100644
--- a/python/composio/core/models/mcp.py
+++ b/python/composio/core/models/mcp.py
@@ -10,7 +10,6 @@ import typing as t
import typing_extensions as te
from composio_client.types.mcp.custom_create_response import CustomCreateResponse
-from composio_client.types.tool_router_create_session_params import ConfigToolkit
from composio.client import HttpClient
from composio.core.models.base import Resource
@@ -20,6 +19,23 @@ from composio.utils.pydantic import none_to_omit
# Data Types (matching TypeScript specification)
+class ConfigToolkit(te.TypedDict, total=False):
+ """Toolkit configuration for an MCP server.
+
+ Defined locally rather than imported from ``composio_client``: the generated
+ client removed ``types.tool_router_create_session_params.ConfigToolkit`` in
+ 1.41.0 when the tool-router session schema was redesigned. The MCP surface
+ only needs the toolkit slug and optional auth config, so we keep our own
+ minimal shape and stay decoupled from tool-router regen churn.
+ """
+
+ toolkit: te.Required[str]
+ """Toolkit identifier (e.g., gmail, slack, github)."""
+
+ auth_config_id: str
+ """Specific auth configuration ID for this toolkit."""
+
+
class MCPCreateResponse(CustomCreateResponse):
"""MCP Create Response with generate method (extends CustomCreateResponse)."""
diff --git a/python/pyproject.toml b/python/pyproject.toml
index bdc955c54..81fedf883 100644
--- a/python/pyproject.toml
+++ b/python/pyproject.toml
@@ -7,7 +7,7 @@ requires-python = ">=3.10,<4"
dependencies = [
"pysher>=1.0.8",
"pydantic>=2.6.4",
- "composio-client==1.39.0",
+ "composio-client==1.41.0",
"typing-extensions>=4.0.0",
"openai",
"json-schema-to-pydantic>=0.4.8",
diff --git a/python/setup.py b/python/setup.py
index 18e44c179..bdb8da1f2 100644
--- a/python/setup.py
+++ b/python/setup.py
@@ -25,7 +25,7 @@ setup(
install_requires=[
"pysher>=1.0.8",
"pydantic>=2.6.4",
- "composio-client==1.39.0",
+ "composio-client==1.41.0",
"typing-extensions>=4.0.0",
"openai",
"json-schema-to-pydantic>=0.4.8",
diff --git a/uv.lock b/uv.lock
index 6d15ffc46..542847485 100644
--- a/uv.lock
+++ b/uv.lock
@@ -622,7 +622,7 @@ dev = [
[package.metadata]
requires-dist = [
- { name = "composio-client", specifier = "==1.39.0" },
+ { name = "composio-client", specifier = "==1.41.0" },
{ name = "json-schema-to-pydantic", specifier = ">=0.4.8" },
{ name = "openai" },
{ name = "pydantic", specifier = ">=2.6.4" },
@@ -664,7 +664,7 @@ requires-dist = [
[[package]]
name = "composio-client"
-version = "1.39.0"
+version = "1.41.0"
source = { registry = "https://pypi.org/simple" }
dependencies = [
{ name = "anyio" },
@@ -674,9 +674,9 @@ dependencies = [
{ name = "sniffio" },
{ name = "typing-extensions" },
]
-sdist = { url = "https://files.pythonhosted.org/packages/0d/78/efc71b2df0d580c4550ee60644193644ae3ddc06fc89f3fc92998db6393c/composio_client-1.39.0.tar.gz", hash = "sha256:2086493925117b956a3166da18414925cb50829172c8211591137fcdc3d60c7d", size = 248246, upload-time = "2026-05-12T14:28:13.071Z" }
+sdist = { url = "https://files.pythonhosted.org/packages/2a/b1/3eaeb0bf6f45a5a4114c0464479aab3181b4676644cf84ff08ab7ef389e2/composio_client-1.41.0.tar.gz", hash = "sha256:5b37205123b38a4568d6a75c4227d38929b8f9526adc8d0810281733e547d8a6", size = 244988, upload-time = "2026-06-19T12:15:31.258Z" }
wheels = [
- { url = "https://files.pythonhosted.org/packages/88/59/f4ddca56b9f02c8fed3277584111a687c9be986d0d2e8b421c80a20caa03/composio_client-1.39.0-py3-none-any.whl", hash = "sha256:bf6050dc0d523bd1e9d52e39e162f5b23bd029aa441b5c4a18e1751aae58571d", size = 284163, upload-time = "2026-05-12T14:28:11.681Z" },
+ { url = "https://files.pythonhosted.org/packages/78/34/8841fcc4da6e4ccb74daac47c4714607f9314240c5bf43a0ef653f758e50/composio_client-1.41.0-py3-none-any.whl", hash = "sha256:18344f1b9209c56c25258c87c9a2f0423553690c94a4e62fb933072f76b37cd1", size = 276180, upload-time = "2026-06-19T12:15:29.949Z" },
]
[[package]]