@devries-cameron20 / composio Mirror · read-only / commits / 038d1fbfa
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, 07:15 UTC

chore(release): prepare Python 0.30.0 and SDK changelogs (#5064)

Prepare Python 0.30.0 for the merged session-hooks API and document the coordinated TypeScript 0.27.0 release. Synchronize Python core, all 13 provider versions, and the generated uv lockfile. The changelog includes blocked proxy-response migration examples and Anthropic 0.11.6 dependency cleanup. Validation: release-workflow guard, agent-guidance validators, frozen pnpm install, locked Python release tools, all 28 Python distributions built without isolation, all 28 passed twine check, all 14 wheel versions checked, and changelog formatting/diff checks. The standalone changelog-discovery test could not load the worktree's ungenerated Fumadocs collections; hosted docs validation will cover the site. Release order: merge this preparation, verify the refreshed Changesets release PR, merge it, then tag the final merged next commit as py@0.30.0. Verify PyPI and npm publication separately. Review the full diff before submitting. Known inherited CI finding: Python workspace audit reports uv 0.11.33 / PYSEC-2026-4321, also present on unchanged next in run 39777027889. CrewAI CLI constrains uv>=0.11.6,<0.12.dev0, excluding the 0.13.4 fix; a targeted lock upgrade is unsatisfiable. This PR changes no third-party dependency or audit exception. Admin merge proceeds under the release authorization after functional checks; the audit remains visibly failing.

Alberto Schiabel committed Oct 22, 2026 at 16:32 UTC 038d1fbfa5121fa63fee6f19fcde2a545d720a48
30 files changed +86 -37
docs/content/changelog/10-22-26-session-hooks-sdk-releases.mdx new
+49
@@ -0,0 +1,49 @@
1 +---
2 +title: 'SDK releases: session hooks in Python 0.30.0 and TypeScript 0.27.0'
3 +description: 'Block tool calls or results with session hooks, inspect hook outcomes, and handle blocked proxy requests.'
4 +date: '2026-10-22'
5 +---
6 +
7 +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.
8 +
9 +### Release versions
10 +
11 +| SDK | Version |
12 +| -------------------------------- | -------- |
13 +| Python `composio` | `0.30.0` |
14 +| TypeScript `@composio/core` | `0.27.0` |
15 +| TypeScript `@composio/slim` | `0.27.0` |
16 +| TypeScript `@composio/anthropic` | `0.11.6` |
17 +
18 +All 13 Python provider packages are released at `0.30.0`.
19 +
20 +### What's new
21 +
22 +- **Session hooks.** Pass `hooks` when you create or update a session. Hooks can run before execution or after execution, and can apply to selected toolkits. Updating `hooks` replaces the whole list; `None` in Python or `null` in TypeScript removes every hook. You cannot combine `hooks` with `experimental.session_config_id` in Python or `experimental.sessionConfigId` in TypeScript in the same call.
23 +- **Hook outcomes.** Session execution returns `result_type="blocked"` in Python or `resultType: 'blocked'` in TypeScript when a hook blocks a call or result. The response contains empty `data`, the hook's message in `error`, and `block_reason` or `blockReason`. When hooks apply, inspect `hook_results` or `hookResults` for their outcomes. Provider integrations return blocked execution as a failed tool call with the hook's message.
24 +
25 +### Migration notes
26 +
27 +<Callout type="warn">
28 + Session proxy execution now distinguishes completed requests from blocked requests. A blocked
29 + request has no HTTP response. Check the result type before reading HTTP response fields.
30 +</Callout>
31 +
32 +In Python, replace direct access to a proxy response's `status` with a result-type check:
33 +
34 +Before: `print(response.status)`.
35 +
36 +After: `print(response["status"] if response["result_type"] == "completed" else response["message"])`.
37 +
38 +In TypeScript, make the equivalent check:
39 +
40 +Before: `console.log(response.status)`.
41 +
42 +After: `console.log(response.resultType === 'completed' ? response.status : response.message)`.
43 +
44 +This applies to `session.proxy_execute()` and `ctx.proxy_execute()` in Python, and `session.proxyExecute()` and `ctx.proxyExecute()` in TypeScript.
45 +
46 +### Bug fixes
47 +
48 +- **Python custom-tool annotations.** `@composio.experimental.tool` reports unresolved input annotations when you register the tool, with the affected parameter and the original resolution error.
49 +- **Anthropic provider dependencies.** The TypeScript Anthropic provider removes its unused `@mastra/mcp` peer dependency, avoiding unrelated packages during installation.
python/composio/__version__.py
+1 -1
@@ -1 +1 @@
1 -__version__ = "0.29.1"
1 +__version__ = "0.30.0"
python/providers/anthropic/pyproject.toml
+1 -1
@@ -1,6 +1,6 @@
1 [project]
2 name = "composio-anthropic"
3 -version = "0.29.1"
3 +version = "0.30.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.29.1",
11 + version="0.30.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.29.1"
3 +version = "0.30.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.29.1",
11 + version="0.30.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.29.1"
3 +version = "0.30.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.29.1",
11 + version="0.30.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.29.1"
3 +version = "0.30.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.29.1",
9 + version="0.30.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.29.1"
3 +version = "0.30.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.29.1",
11 + version="0.30.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.29.1"
3 +version = "0.30.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.29.1",
11 + version="0.30.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.29.1"
3 +version = "0.30.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.29.1",
11 + version="0.30.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.29.1"
3 +version = "0.30.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.29.1",
11 + version="0.30.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.29.1"
3 +version = "0.30.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.29.1",
11 + version="0.30.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.29.1"
3 +version = "0.30.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.29.1",
11 + version="0.30.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.29.1"
3 +version = "0.30.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.29.1",
11 + version="0.30.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.29.1"
3 +version = "0.30.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.29.1",
11 + version="0.30.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.29.1"
3 +version = "0.30.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.29.1",
11 + version="0.30.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.29.1"
3 +version = "0.30.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
@@ -765,7 +765,7 @@ wheels = [
765
766 [[package]]
767 name = "composio"
768 -version = "0.29.1"
768 +version = "0.30.0"
769 source = { editable = "python" }
770 dependencies = [
771 { name = "certifi" },
@@ -842,7 +842,7 @@ release = [
842
843 [[package]]
844 name = "composio-anthropic"
845 -version = "0.29.1"
845 +version = "0.30.0"
846 source = { editable = "python/providers/anthropic" }
847 dependencies = [
848 { name = "anthropic" },
@@ -871,7 +871,7 @@ wheels = [
871
872 [[package]]
873 name = "composio-crewai"
874 -version = "0.29.1"
874 +version = "0.30.0"
875 source = { editable = "python/providers/crewai" }
876 dependencies = [
877 { name = "composio" },
@@ -886,7 +886,7 @@ requires-dist = [
886
887 [[package]]
888 name = "composio-gemini"
889 -version = "0.29.1"
889 +version = "0.30.0"
890 source = { virtual = "python/providers/gemini" }
891 dependencies = [
892 { name = "composio" },
@@ -901,7 +901,7 @@ requires-dist = [
901
902 [[package]]
903 name = "composio-google"
904 -version = "0.29.1"
904 +version = "0.30.0"
905 source = { editable = "python/providers/google" }
906 dependencies = [
907 { name = "composio" },
@@ -916,7 +916,7 @@ requires-dist = [
916
917 [[package]]
918 name = "composio-google-adk"
919 -version = "0.29.1"
919 +version = "0.30.0"
920 source = { editable = "python/providers/google_adk" }
921 dependencies = [
922 { name = "composio" },
@@ -931,7 +931,7 @@ requires-dist = [
931
932 [[package]]
933 name = "composio-langchain"
934 -version = "0.29.1"
934 +version = "0.30.0"
935 source = { editable = "python/providers/langchain" }
936 dependencies = [
937 { name = "composio" },
@@ -946,7 +946,7 @@ requires-dist = [
946
947 [[package]]
948 name = "composio-openai"
949 -version = "0.29.1"
949 +version = "0.30.0"
950 source = { editable = "python/providers/openai" }
951 dependencies = [
952 { name = "composio" },
@@ -961,7 +961,7 @@ requires-dist = [
961
962 [[package]]
963 name = "composio-openai-agents"
964 -version = "0.29.1"
964 +version = "0.30.0"
965 source = { editable = "python/providers/openai_agents" }
966 dependencies = [
967 { name = "composio" },