@devries-cameron20 / composio-1 / commits / 7ffe795b3
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.24.0 and SDK changelog (#4622)

Prepare Python SDK and all 13 provider packages at 0.24.0, regenerate the uv lockfile, and add the September 24 changelog covering Python 0.24.0 and TypeScript core/slim 0.21.0. The notes cover premium usage policies, default Session update fixes, file destination validation, Python auth-config response types, and TypeScript saved Session configs and hosted-account search results. The TypeScript version remains managed by Changesets in #4609; this entry fixes its missing-changelog release check. Validation: release-workflow checks, Changesets validation, agent-guidance validators, Prettier, and git diff checks pass locally. Python wheel/sdist builds and hosted CI are checked before release.

Alberto Schiabel committed Sep 24, 2026 at 13:56 UTC 7ffe795b3751e4ecbd9fe53ef37ec22b8f400edd
30 files changed +70 -37
docs/content/changelog/09-24-26-sdk-releases.mdx new
+33
@@ -0,0 +1,33 @@
1 +---
2 +title: 'Python SDK 0.24.0 and TypeScript SDK 0.21.0 add Session policies and fixes'
3 +description: 'Control premium usage in both SDKs, use saved Session configs in TypeScript, and get fixes for Session updates and file downloads.'
4 +date: '2026-09-24'
5 +---
6 +
7 +Both SDKs add experimental premium usage policies and fix default Session updates. TypeScript also adds saved Session configs and hosted-account details in search results.
8 +
9 +### Release versions
10 +
11 +| SDK | Version |
12 +| --------------------------- | -------- |
13 +| Python `composio` | `0.24.0` |
14 +| TypeScript `@composio/core` | `0.21.0` |
15 +| TypeScript `@composio/slim` | `0.21.0` |
16 +
17 +### Premium usage policies
18 +
19 +Set `premiumUsage` in TypeScript or `premium_usage` in Python when creating or updating a Session to control billed tool execution. Pass `false` (`False` in Python) to disable it, or a policy object to restrict eligible toolkits and tools. Your project must allow premium usage. Passing a policy object re-enables premium usage on a Session where it was disabled.
20 +
21 +### Saved Session configs in TypeScript
22 +
23 +- Read saved configs with `composio.sessionConfigs.list()` and `composio.sessionConfigs.get()`.
24 +- Apply a saved config through `experimental.sessionConfigId` when creating or updating a Session. Read its source metadata through `session.experimental.sourceSessionConfig`.
25 +- Config IDs cannot be combined with inline access fields: `toolkits`, `tools`, or `tags`, plus `experimental.customTools` and `experimental.customToolkits` on create. Invalid combinations fail before a request is sent.
26 +- Search results expose `hostedAccount.allowedToolSlugs` on toolkit connection statuses for Composio hosted accounts.
27 +
28 +### Fixes
29 +
30 +- **Session updates in both SDKs:** `session.update()` no longer sends `expected_config_version` by default, fixing the API's rejection of ordinary updates. Updates use last writer wins. To request a conditional update where the API supports it, pass `expectedConfigVersion` in TypeScript or `expected_config_version` in Python explicitly.
31 +- **File saves in both SDKs:** unsafe server-supplied mount paths now raise validation errors before creating directories or writing files. This includes paths that resolve to a directory or its parent and filenames with trailing dots exposed by stripping Unicode whitespace.
32 +- **TypeScript downloads:** `RemoteFile.save()` validates its default destination before downloading content, so an invalid mount path fails without a network request.
33 +- **Python auth configs:** update, delete, enable, and disable methods now declare the client's concrete response types, including their `success` and `message` fields.
python/composio/__version__.py
+1 -1
@@ -1 +1 @@
1 -__version__ = "0.23.0"
1 +__version__ = "0.24.0"
python/providers/anthropic/pyproject.toml
+1 -1
@@ -1,6 +1,6 @@
1 [project]
2 name = "composio-anthropic"
3 -version = "0.23.0"
3 +version = "0.24.0"
4 description = "Use Composio to get an array of tools with your Anthropic LLMs."
5 readme = "README.md"
6 requires-python = ">=3.10,<4"
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.23.0",
11 + version="0.24.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.23.0"
3 +version = "0.24.0"
4 description = "Use Composio to get an array of tools with your autogen agent."
5 readme = "README.md"
6 requires-python = ">=3.10,<4"
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.23.0",
11 + version="0.24.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.23.0"
3 +version = "0.24.0"
4 description = "Use Composio to get an array of tools with Claude Code Agents SDK."
5 readme = "README.md"
6 requires-python = ">=3.10,<4"
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.23.0",
11 + version="0.24.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.23.0"
3 +version = "0.24.0"
4 description = "Use Composio to get an array of tools with your CrewAI agent."
5 readme = "README.md"
6 requires-python = ">=3.10,<4"
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.23.0",
9 + version="0.24.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.23.0"
3 +version = "0.24.0"
4 description = "Use Composio to get an array of tools with your Gemini agent."
5 readme = "README.md"
6 requires-python = ">=3.10,<4"
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.23.0",
11 + version="0.24.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.23.0"
3 +version = "0.24.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.10,<4"
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.23.0",
11 + version="0.24.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.23.0"
3 +version = "0.24.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.10,<4"
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.23.0",
11 + version="0.24.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.23.0"
3 +version = "0.24.0"
4 description = "Use Composio to get an array of tools with your Langchain agent."
5 readme = "README.md"
6 requires-python = ">=3.10,<4"
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.23.0",
11 + version="0.24.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.23.0"
3 +version = "0.24.0"
4 description = "Use Composio to get array of tools with LangGraph Agent Workflows."
5 readme = "README.md"
6 requires-python = ">=3.10,<4"
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.23.0",
11 + version="0.24.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.23.0"
3 +version = "0.24.0"
4 description = "Use Composio to get array of tools with LlamaIndex Agent Workflows."
5 readme = "README.md"
6 requires-python = ">=3.10,<4"
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.23.0",
11 + version="0.24.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.23.0"
3 +version = "0.24.0"
4 description = "Use Composio to get an array of tools with your OpenAI Function Call."
5 readme = "README.md"
6 requires-python = ">=3.10,<4"
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.23.0",
11 + version="0.24.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.23.0"
3 +version = "0.24.0"
4 description = "Use Composio to get array of strongly typed tools for OpenAI Agents"
5 readme = "README.md"
6 requires-python = ">=3.10,<4"
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.23.0",
11 + version="0.24.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.23.0"
3 +version = "0.24.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.10,<4"
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.23.0",
11 + version="0.24.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.23.0"
3 +version = "0.24.0"
4 description = "SDK for integrating Composio with your applications."
5 readme = "README.md"
6 requires-python = ">=3.10,<4"
uv.lock
+9 -9
@@ -786,7 +786,7 @@ wheels = [
786
787 [[package]]
788 name = "composio"
789 -version = "0.23.0"
789 +version = "0.24.0"
790 source = { editable = "python" }
791 dependencies = [
792 { name = "composio-client" },
@@ -851,7 +851,7 @@ dev = [
851
852 [[package]]
853 name = "composio-anthropic"
854 -version = "0.23.0"
854 +version = "0.24.0"
855 source = { editable = "python/providers/anthropic" }
856 dependencies = [
857 { name = "anthropic" },
@@ -880,7 +880,7 @@ wheels = [
880
881 [[package]]
882 name = "composio-crewai"
883 -version = "0.23.0"
883 +version = "0.24.0"
884 source = { editable = "python/providers/crewai" }
885 dependencies = [
886 { name = "composio" },
@@ -895,7 +895,7 @@ requires-dist = [
895
896 [[package]]
897 name = "composio-gemini"
898 -version = "0.23.0"
898 +version = "0.24.0"
899 source = { virtual = "python/providers/gemini" }
900 dependencies = [
901 { name = "composio" },
@@ -910,7 +910,7 @@ requires-dist = [
910
911 [[package]]
912 name = "composio-google"
913 -version = "0.23.0"
913 +version = "0.24.0"
914 source = { editable = "python/providers/google" }
915 dependencies = [
916 { name = "composio" },
@@ -925,7 +925,7 @@ requires-dist = [
925
926 [[package]]
927 name = "composio-google-adk"
928 -version = "0.23.0"
928 +version = "0.24.0"
929 source = { editable = "python/providers/google_adk" }
930 dependencies = [
931 { name = "composio" },
@@ -940,7 +940,7 @@ requires-dist = [
940
941 [[package]]
942 name = "composio-langchain"
943 -version = "0.23.0"
943 +version = "0.24.0"
944 source = { editable = "python/providers/langchain" }
945 dependencies = [
946 { name = "composio" },
@@ -955,7 +955,7 @@ requires-dist = [
955
956 [[package]]
957 name = "composio-openai"
958 -version = "0.23.0"
958 +version = "0.24.0"
959 source = { editable = "python/providers/openai" }
960 dependencies = [
961 { name = "composio" },
@@ -970,7 +970,7 @@ requires-dist = [
970
971 [[package]]
972 name = "composio-openai-agents"
973 -version = "0.23.0"
973 +version = "0.24.0"
974 source = { editable = "python/providers/openai_agents" }
975 dependencies = [
976 { name = "composio" },