@devries-cameron20 / composio-1 / commits / a0252303b
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.

chore(release): prepare Python 0.31.0 and SDK changelog (#5198)

This PR: - builds on [PR #5195](https://github.com/ComposioHQ/composio/pull/5195) ([Glen review](https://app.tryglen.com/ComposioHQ/composio/pull/5195)). - synchronizes Python core, runtime metadata, all 13 providers, and `uv.lock` at `0.31.0`. - documents TypeScript `0.28.0`, Anthropic `0.11.7`, Python `0.31.0`, custom MCP toolkits, trigger delivery, fixes, and client migration notes. - leaves TypeScript versions to the existing Changesets release PR #5070. Python publishes from `py@0.31.0` after the release commits merge. Validation: release metadata profile and changeset validation passed; Python 3.12 built all 28 wheel/sdist artifacts with locked build tools, and every artifact passed `twine check`. All wheels include `py.typed`. The complete metadata and changelog diff was reviewed locally. Designated reviewer: @jkomyno. Please review the full diff before merging.

Alberto Schiabel committed Nov 3, 2026 at 16:18 UTC a0252303b8fd50aa59a17530fb9a1689b81c8c9b
30 files changed +83 -37
docs/content/changelog/11-03-26-sdk-releases.mdx new
+46
@@ -0,0 +1,46 @@
1 +---
2 +title: 'SDK releases: custom toolkits in Python 0.31.0 and TypeScript 0.28.0'
3 +description: 'Create private custom MCP toolkits, configure trigger polling, and upgrade to Composio client 2.0.1.'
4 +date: '2026-11-03'
5 +---
6 +
7 +You can now create custom MCP toolkits for a single user or share them across your project. Both SDKs use Composio client `2.0.1`.
8 +
9 +### Release versions
10 +
11 +| SDK | Version |
12 +| -------------------------------- | -------- |
13 +| Python `composio` | `0.31.0` |
14 +| TypeScript `@composio/core` | `0.28.0` |
15 +| TypeScript `@composio/slim` | `0.28.0` |
16 +| TypeScript `@composio/anthropic` | `0.11.7` |
17 +
18 +All 13 Python provider packages are released at `0.31.0`.
19 +
20 +### What's new
21 +
22 +- **Custom MCP toolkits.** Use `composio.experimental.custom_toolkits.create()` in Python or `composio.experimental.customToolkits.create()` in TypeScript. Set `user_id` or `userId` to a user ID for a private toolkit, or to `'all'` to share it across the project. Creation returns a generated slug and, when available, a connect link for a private toolkit. Store the slug and pass it to `update()` to change the name, logo, or API key input copy. TypeScript also accepts `additionalFields.genericId` for headers that use `{{generic_id}}`.
23 +- **Trigger delivery and polling.** Pass `type` to choose webhook or polling delivery for a trigger that supports both. Set `polling_interval` in Python or `pollingInterval` in TypeScript to choose the minutes between polls. Created and listed instances include their delivery type, polling interval, and fallback reason. Trigger type metadata reports supported delivery types and whether webhook endpoint setup is required.
24 +- **Session policies.** TypeScript `sessionConfigs.get()` preserves `require_approval` lists and accepts policy entries that contain only approval requirements. Toolkit metadata also exposes `meta.appUrl` when the API returns it.
25 +- **Anthropic compatibility.** The TypeScript Anthropic provider accepts `@anthropic-ai/sdk` `^0.135.0`.
26 +
27 +### Migration notes
28 +
29 +<Callout type="warn">
30 + Composio client `2.0.1` changes direct API client access and automatic retries for writes. Review
31 + the steps below if you call the underlying client or relied on retries for POST and PATCH
32 + requests.
33 +</Callout>
34 +
35 +1. **Custom toolkit registration.** `upsert()` still works, but warns once per process that it is deprecated. Before: register a toolkit with a caller-chosen slug through `upsert()`. After: call `create()`, store its returned slug, and use `update(slug, ...)` for later metadata changes. The server URL, auth schemes, and owning user cannot change after creation; delete and create the toolkit again to change them.
36 +2. **Write retries.** POST and PATCH requests are sent once by default. A write may complete on the server even when its response is lost, so retry only when you can prevent duplicate side effects. Reads keep their retry behavior. On the TypeScript client returned by `getClient()`, opt a write into retries with that call's `maxRetries` option.
37 +3. **Direct TypeScript client calls.** Replace `client.request(...)` with `client.get(path, options)` for GET requests, retaining the relevant query and request options. For other HTTP methods, use `post`, `patch`, `put`, or `delete`. Resource classes, `Composio.Tools`-style statics, namespace-member types, `Composio.Composio`, and `Composio.DEFAULT_TIMEOUT` are removed. Import types from `@composio/client/resources/*` without `.js` or `.mjs` suffixes, and use indexed access for nested types.
38 +4. **Session config search.** TypeScript `sessionConfigs.list()` ignores the deprecated `search` option and warns when you set it. Filter the returned `items` by name instead.
39 +
40 +### Bug fixes
41 +
42 +- **Local upload MIME types.** Files uploaded from local paths use the MIME type of their extension instead of always using `application/octet-stream`. Python and TypeScript use the same extension table. Files supplied as `File` objects or URLs keep the MIME type they carry.
43 +- **Python downloaded filenames.** Files downloaded from extensionless URLs use the extension corresponding to a known response MIME type, including formats such as CSV and PowerPoint. Unknown MIME types leave the generated filename extensionless.
44 +- **Python schema defaults.** Default coercion handles schemas whose `type` is a list, including nullable types.
45 +- **Python Gemini execution.** Manual function-call handling uses the user or session you supply, and rejects ambiguous ownership instead of choosing the last user to fetch tools. See the [Gemini provider fix](/docs/changelog/2026/10/27).
46 +- **TypeScript session authorization.** Sessions returned by `create()` and `use()` accept the already-supported `experimental` authorization options in their public types.
python/composio/__version__.py
+1 -1
@@ -1 +1 @@
1 -__version__ = "0.30.0"
1 +__version__ = "0.31.0"
python/providers/anthropic/pyproject.toml
+1 -1
@@ -1,6 +1,6 @@
1 [project]
2 name = "composio-anthropic"
3 -version = "0.30.0"
3 +version = "0.31.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.30.0",
11 + version="0.31.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.30.0"
3 +version = "0.31.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.30.0",
11 + version="0.31.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.30.0"
3 +version = "0.31.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.30.0",
11 + version="0.31.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.30.0"
3 +version = "0.31.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.30.0",
9 + version="0.31.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.30.0"
3 +version = "0.31.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.30.0",
11 + version="0.31.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.30.0"
3 +version = "0.31.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.30.0",
11 + version="0.31.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.30.0"
3 +version = "0.31.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.30.0",
11 + version="0.31.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.30.0"
3 +version = "0.31.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.30.0",
11 + version="0.31.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.30.0"
3 +version = "0.31.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.30.0",
11 + version="0.31.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.30.0"
3 +version = "0.31.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.30.0",
11 + version="0.31.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.30.0"
3 +version = "0.31.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.30.0",
11 + version="0.31.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.30.0"
3 +version = "0.31.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.30.0",
11 + version="0.31.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.30.0"
3 +version = "0.31.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.30.0",
11 + version="0.31.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.30.0"
3 +version = "0.31.0"
4 description = "SDK for integrating Composio with your applications."
5 readme = "README.md"
6 requires-python = ">=3.11,<3.16"
uv.lock
+9 -9
@@ -1,5 +1,5 @@
1 version = 1
2 -revision = 3
2 +revision = 5
3 requires-python = ">=3.11, <3.16"
4 resolution-markers = [
5 "python_full_version >= '3.15'",
@@ -490,7 +490,7 @@ wheels = [
490
491 [[package]]
492 name = "composio"
493 -version = "0.30.0"
493 +version = "0.31.0"
494 source = { editable = "python" }
495 dependencies = [
496 { name = "certifi" },
@@ -571,7 +571,7 @@ release = [
571
572 [[package]]
573 name = "composio-anthropic"
574 -version = "0.30.0"
574 +version = "0.31.0"
575 source = { editable = "python/providers/anthropic" }
576 dependencies = [
577 { name = "anthropic" },
@@ -600,7 +600,7 @@ wheels = [
600
601 [[package]]
602 name = "composio-gemini"
603 -version = "0.30.0"
603 +version = "0.31.0"
604 source = { virtual = "python/providers/gemini" }
605 dependencies = [
606 { name = "composio" },
@@ -615,7 +615,7 @@ requires-dist = [
615
616 [[package]]
617 name = "composio-google"
618 -version = "0.30.0"
618 +version = "0.31.0"
619 source = { editable = "python/providers/google" }
620 dependencies = [
621 { name = "composio" },
@@ -630,7 +630,7 @@ requires-dist = [
630
631 [[package]]
632 name = "composio-google-adk"
633 -version = "0.30.0"
633 +version = "0.31.0"
634 source = { editable = "python/providers/google_adk" }
635 dependencies = [
636 { name = "composio" },
@@ -645,7 +645,7 @@ requires-dist = [
645
646 [[package]]
647 name = "composio-langchain"
648 -version = "0.30.0"
648 +version = "0.31.0"
649 source = { editable = "python/providers/langchain" }
650 dependencies = [
651 { name = "composio" },
@@ -660,7 +660,7 @@ requires-dist = [
660
661 [[package]]
662 name = "composio-openai"
663 -version = "0.30.0"
663 +version = "0.31.0"
664 source = { editable = "python/providers/openai" }
665 dependencies = [
666 { name = "composio" },
@@ -675,7 +675,7 @@ requires-dist = [
675
676 [[package]]
677 name = "composio-openai-agents"
678 -version = "0.30.0"
678 +version = "0.31.0"
679 source = { editable = "python/providers/openai_agents" }
680 dependencies = [
681 { name = "composio" },