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

feat(py): add tool router session deletion

Release Python 0.17.1 with Tool Router session deletion support.

Alberto Schiabel committed Jun 28, 2026 at 22:59 UTC 9901e01a80de1d389b3f030b12ff07e590294cbb
33 files changed +211 -45
python/CHANGELOG.md
+8
@@ -7,6 +7,14 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
7
8 > Versions between `0.8.11` and `0.13.0` were released without CHANGELOG entries. See the [Git commit log](https://github.com/ComposioHQ/composio/commits/next/python) for changes in that window.
9
10 +## [0.17.1] - 2026-06-28
11 +
12 +### Added
13 +- **Tool Router session deletion**: delete sessions from Python via `composio.sessions.delete(session_id)` or `session.delete()`, matching the TypeScript SDK surface.
14 +
15 +### Changed
16 +- Bumped the Python SDK and provider packages from `0.17.0` to `0.17.1`.
17 +
18 ## [0.17.0] - 2026-06-26
19
20 ### Added
python/composio/__version__.py
+1 -1
@@ -1 +1 @@
1 -__version__ = "0.17.0"
1 +__version__ = "0.17.1"
python/composio/core/models/__init__.py
+2
@@ -12,6 +12,7 @@ from .mcp import MCP
12 from .tool_router import ToolRouter
13 from .tool_router_constants import SESSION_PRESET_DIRECT_TOOLS
14 from .tool_router_session import ToolRouterSession
15 +from .tool_router_session_delete import ToolRouterSessionDeleteResponse
16 from .tool_router_session_files import RemoteFile, ToolRouterSessionFilesMount
17 from .toolkits import Toolkits
18 from .tools import Tools
@@ -45,6 +46,7 @@ __all__ = [
46 "SingleConnectedAccountDetailedResponse",
47 "ToolRouter",
48 "ToolRouterSession",
49 + "ToolRouterSessionDeleteResponse",
50 "ToolRouterSessionFilesMount",
51 "Toolkits",
52 "Tools",
python/composio/core/models/tool_router.py
+23 -9
@@ -22,7 +22,6 @@ from composio_client.types.tool_router.session_retrieve_response import (
22 )
23
24 from composio.client import HttpClient
25 -from composio.exceptions import InvalidParams
25 from composio.core.models.base import Resource
26 from composio.core.models.custom_tool import (
27 ExperimentalToolkit,
@@ -30,29 +29,34 @@ from composio.core.models.custom_tool import (
29 build_custom_tools_map,
30 build_custom_tools_map_from_response,
31 get_preloaded_custom_tool_slugs,
33 - serialize_custom_tools,
32 serialize_custom_toolkits,
33 + serialize_custom_tools,
34 )
35 from composio.core.models.custom_tool_types import (
36 CustomTool,
37 CustomToolsMap,
38 InlineCustomToolsWirePayload,
39 )
41 -from composio.core.models.tool_router_session import (
42 - ToolRouterSession,
43 - ToolRouterSessionPreloadConfig,
44 - ToolRouterSessionWithMcp,
40 +from composio.core.models.inline_custom_tools_payload import (
41 + inline_custom_tools_attach_experimental,
42 )
46 -from composio.core.models.tool_router_session_files import ToolRouterSessionFilesMount
43 from composio.core.models.tool_router_constants import (
44 PRELOAD_TOOLS_ALL,
45 SESSION_PRESET_DIRECT_TOOLS,
46 )
51 -from composio.core.models.inline_custom_tools_payload import (
52 - inline_custom_tools_attach_experimental,
47 +from composio.core.models.tool_router_session import (
48 + ToolRouterSession,
49 + ToolRouterSessionPreloadConfig,
50 + ToolRouterSessionWithMcp,
51 +)
52 +from composio.core.models.tool_router_session_delete import (
53 + ToolRouterSessionDeleteResponse,
54 + delete_tool_router_session,
55 )
56 +from composio.core.models.tool_router_session_files import ToolRouterSessionFilesMount
57 from composio.core.provider import TTool, TToolCollection
58 from composio.core.provider.base import BaseProvider
59 +from composio.exceptions import InvalidParams
60
61 # Type alias for MCP tag literals
62 ToolRouterTag = t.Literal[
@@ -1274,11 +1278,21 @@ class ToolRouter(Resource, t.Generic[TTool, TToolCollection]):
1278 inline_custom_tools_payload=inline_custom_tools_payload,
1279 )
1280
1281 + def delete(self, session_id: str) -> ToolRouterSessionDeleteResponse:
1282 + """
1283 + Delete a tool router session by ID.
1284 +
1285 + Deleted sessions immediately stop being retrievable or executable. A
1286 + missing or already-deleted session surfaces the backend 404.
1287 + """
1288 + return delete_tool_router_session(self._client, session_id)
1289 +
1290
1291 __all__ = [
1292 "ToolRouter",
1293 "ToolRouterSession",
1294 "ToolRouterSessionWithMcp",
1295 + "ToolRouterSessionDeleteResponse",
1296 "ToolRouterSessionExperimental",
1297 "ToolRouterToolkitsEnableConfig",
1298 "ToolRouterToolkitsDisableConfig",
python/composio/core/models/tool_router_session.py
+14 -1
@@ -36,7 +36,6 @@ from composio.client.types import Tool
36 from composio.core.models._modifiers import Modifiers, apply_modifier_by_type
37 from composio.core.models.connected_accounts import ConnectionRequest
38 from composio.core.models.custom_tool import find_custom_tool_map_entry_by_final_slug
39 -from composio.core.models.experimental import ACL_ONLY_FOR_SHARED_ERROR_FRAGMENT
39 from composio.core.models.custom_tool_execution import (
40 execute_custom_tool,
41 find_custom_tool,
@@ -48,11 +47,16 @@ from composio.core.models.custom_tool_types import (
47 RegisteredCustomTool,
48 RegisteredCustomToolkit,
49 )
50 +from composio.core.models.experimental import ACL_ONLY_FOR_SHARED_ERROR_FRAGMENT
51 from composio.core.models.inline_custom_tools_payload import (
52 inline_custom_tools_execute_experimental,
53 inline_custom_tools_search_experimental,
54 )
55 from composio.core.models.session_context import SessionContextImpl, proxy_execute_impl
56 +from composio.core.models.tool_router_session_delete import (
57 + ToolRouterSessionDeleteResponse,
58 + delete_tool_router_session,
59 +)
60 from composio.core.models.tools import ToolExecuteParams, ToolExecutionResponse
61 from composio.core.provider import TTool, TToolCollection
62 from composio.core.provider.base import BaseProvider
@@ -886,6 +890,15 @@ class ToolRouterSession(t.Generic[TTool, TToolCollection]):
890 )
891 self.preload = _session_preload_config(response.config.preload)
892
893 + def delete(self) -> ToolRouterSessionDeleteResponse:
894 + """
895 + Delete this session.
896 +
897 + Deleted sessions immediately stop being retrievable or executable. An
898 + already-deleted session surfaces the backend 404.
899 + """
900 + return delete_tool_router_session(self._client, self.session_id)
901 +
902
903 class ToolRouterSessionWithMcp(ToolRouterSession[TTool, TToolCollection]):
904 """A :class:`ToolRouterSession` whose hosted MCP endpoint is exposed.
python/composio/core/models/tool_router_session_delete.py new
+39
@@ -0,0 +1,39 @@
1 +"""Tool router session deletion helper."""
2 +
3 +from __future__ import annotations
4 +
5 +import typing as t
6 +from urllib.parse import quote
7 +
8 +import typing_extensions as te
9 +
10 +from composio.client import HttpClient
11 +from composio.exceptions import ValidationError
12 +
13 +
14 +class ToolRouterSessionDeleteResponse(te.TypedDict):
15 + """Response returned when a tool router session is deleted."""
16 +
17 + session_id: str
18 + deleted: t.Literal[True]
19 +
20 +
21 +def delete_tool_router_session(
22 + client: HttpClient,
23 + session_id: str,
24 +) -> ToolRouterSessionDeleteResponse:
25 + """Delete a tool router session by ID."""
26 + response = client.delete(
27 + f"/api/v3.1/tool_router/session/{quote(session_id, safe='')}",
28 + cast_to=t.Dict[str, t.Any],
29 + )
30 +
31 + response_session_id = response.get("session_id")
32 + deleted = response.get("deleted")
33 + if not isinstance(response_session_id, str) or deleted is not True:
34 + raise ValidationError("Invalid tool router session delete response")
35 +
36 + return {
37 + "session_id": response_session_id,
38 + "deleted": True,
39 + }
python/providers/anthropic/pyproject.toml
+1 -1
@@ -1,6 +1,6 @@
1 [project]
2 name = "composio-anthropic"
3 -version = "0.17.0"
3 +version = "0.17.1"
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.17.0",
11 + version="0.17.1",
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.17.0"
3 +version = "0.17.1"
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.17.0",
11 + version="0.17.1",
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.17.0"
3 +version = "0.17.1"
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.17.0",
11 + version="0.17.1",
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.17.0"
3 +version = "0.17.1"
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.17.0",
9 + version="0.17.1",
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.17.0"
3 +version = "0.17.1"
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.17.0",
11 + version="0.17.1",
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.17.0"
3 +version = "0.17.1"
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.17.0",
11 + version="0.17.1",
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.17.0"
3 +version = "0.17.1"
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.17.0",
11 + version="0.17.1",
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.17.0"
3 +version = "0.17.1"
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.17.0",
11 + version="0.17.1",
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.17.0"
3 +version = "0.17.1"
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.17.0",
11 + version="0.17.1",
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.17.0"
3 +version = "0.17.1"
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.17.0",
11 + version="0.17.1",
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.17.0"
3 +version = "0.17.1"
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.17.0",
11 + version="0.17.1",
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.17.0"
3 +version = "0.17.1"
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.17.0",
11 + version="0.17.1",
12 author="Composio",
13 author_email="tech@composio.dev",
14 description="Use Composio to get array of strongly typed tools for OpenAI Agents",
python/pyproject.toml
+1 -1
@@ -1,6 +1,6 @@
1 [project]
2 name = "composio"
3 -version = "0.17.0"
3 +version = "0.17.1"
4 description = "SDK for integrating Composio with your applications."
5 readme = "README.md"
6 requires-python = ">=3.10,<4"
python/tests/test_tool_router.py
+90
@@ -1,11 +1,14 @@
1 """Test ToolRouter functionality."""
2
3 +import typing as t
4 from unittest.mock import MagicMock, patch
5
6 +import httpx
7 import pytest
8 from composio_client import omit
9 from pydantic import BaseModel, Field
10
11 +from composio.client import HttpClient
12 from composio.core.models.experimental import ExperimentalAPI
13 from composio.core.models.tool_router import (
14 SESSION_PRESET_DIRECT_TOOLS,
@@ -170,6 +173,73 @@ class TestToolRouter:
173 assert isinstance(session, ToolRouterSessionWithMcp)
174 assert session.mcp.url == "https://mcp.example.com/session_123"
175
176 + def test_delete_session_by_id(self, tool_router, mock_client):
177 + """delete() removes a session by ID."""
178 + mock_client.delete.return_value = {
179 + "session_id": "session_123",
180 + "deleted": True,
181 + }
182 +
183 + result = tool_router.delete("session_123")
184 +
185 + mock_client.delete.assert_called_once_with(
186 + "/api/v3.1/tool_router/session/session_123",
187 + cast_to=t.Dict[str, t.Any],
188 + )
189 + assert result == {
190 + "session_id": "session_123",
191 + "deleted": True,
192 + }
193 +
194 + def test_delete_session_by_id_escapes_session_id(self, tool_router, mock_client):
195 + """delete() URL-encodes session IDs before calling the raw endpoint."""
196 + mock_client.delete.return_value = {
197 + "session_id": "session/with spaces",
198 + "deleted": True,
199 + }
200 +
201 + tool_router.delete("session/with spaces")
202 +
203 + mock_client.delete.assert_called_once_with(
204 + "/api/v3.1/tool_router/session/session%2Fwith%20spaces",
205 + cast_to=t.Dict[str, t.Any],
206 + )
207 +
208 + def test_delete_session_by_id_calls_raw_http_endpoint(self):
209 + """delete() works with the low-level Stainless HTTP client."""
210 + requests: t.List[httpx.Request] = []
211 +
212 + def handler(request: httpx.Request) -> httpx.Response:
213 + requests.append(request)
214 + return httpx.Response(
215 + 200,
216 + json={
217 + "session_id": "session/with spaces",
218 + "deleted": True,
219 + },
220 + )
221 +
222 + client = HttpClient(
223 + provider="test",
224 + api_key="sk-test",
225 + base_url="https://backend.invalid",
226 + http_client=httpx.Client(transport=httpx.MockTransport(handler)),
227 + )
228 + tool_router = ToolRouter(client=client, provider=MagicMock())
229 +
230 + result = tool_router.delete("session/with spaces")
231 +
232 + assert result == {
233 + "session_id": "session/with spaces",
234 + "deleted": True,
235 + }
236 + assert len(requests) == 1
237 + assert requests[0].method == "DELETE"
238 + assert (
239 + str(requests[0].url)
240 + == "https://backend.invalid/api/v3.1/tool_router/session/session%2Fwith%20spaces"
241 + )
242 +
243 def test_create_session_with_toolkits_list(self, tool_router, mock_client):
244 """Test creating a session with toolkits as a list."""
245 session = tool_router.create(user_id="user_123", toolkits=["github", "slack"])
@@ -1029,12 +1099,32 @@ class TestToolRouter:
1099 assert callable(session.tools)
1100 assert callable(session.authorize)
1101 assert callable(session.toolkits)
1102 + assert callable(session.delete)
1103 assert session.preload.tools == ["GMAIL_FETCH_EMAILS"]
1104
1105 mock_client.tool_router.session.retrieve.assert_called_once_with("session_123")
1106 mock_client.tool_router.session.attach.assert_not_called()
1107 mock_client.post.assert_not_called()
1108
1109 + def test_session_delete(self, tool_router, mock_client):
1110 + """Session delete removes the current session."""
1111 + mock_client.delete.return_value = {
1112 + "session_id": "session_123",
1113 + "deleted": True,
1114 + }
1115 + session = tool_router.use(session_id="session_123")
1116 +
1117 + result = session.delete()
1118 +
1119 + mock_client.delete.assert_called_once_with(
1120 + "/api/v3.1/tool_router/session/session_123",
1121 + cast_to=t.Dict[str, t.Any],
1122 + )
1123 + assert result == {
1124 + "session_id": "session_123",
1125 + "deleted": True,
1126 + }
1127 +
1128 def test_use_session_with_custom_tools(self, tool_router, mock_client):
1129 """Test attaching custom tools when reusing a session."""
1130
uv.lock
+9 -9
@@ -711,7 +711,7 @@ wheels = [
711
712 [[package]]
713 name = "composio"
714 -version = "0.17.0"
714 +version = "0.17.1"
715 source = { editable = "python" }
716 dependencies = [
717 { name = "composio-client" },
@@ -768,7 +768,7 @@ dev = [
768
769 [[package]]
770 name = "composio-anthropic"
771 -version = "0.17.0"
771 +version = "0.17.1"
772 source = { editable = "python/providers/anthropic" }
773 dependencies = [
774 { name = "anthropic" },
@@ -800,7 +800,7 @@ wheels = [
800
801 [[package]]
802 name = "composio-crewai"
803 -version = "0.17.0"
803 +version = "0.17.1"
804 source = { editable = "python/providers/crewai" }
805 dependencies = [
806 { name = "composio" },
@@ -815,7 +815,7 @@ requires-dist = [
815
816 [[package]]
817 name = "composio-gemini"
818 -version = "0.17.0"
818 +version = "0.17.1"
819 source = { virtual = "python/providers/gemini" }
820 dependencies = [
821 { name = "composio" },
@@ -830,7 +830,7 @@ requires-dist = [
830
831 [[package]]
832 name = "composio-google"
833 -version = "0.17.0"
833 +version = "0.17.1"
834 source = { editable = "python/providers/google" }
835 dependencies = [
836 { name = "composio" },
@@ -845,7 +845,7 @@ requires-dist = [
845
846 [[package]]
847 name = "composio-google-adk"
848 -version = "0.17.0"
848 +version = "0.17.1"
849 source = { editable = "python/providers/google_adk" }
850 dependencies = [
851 { name = "composio" },
@@ -860,7 +860,7 @@ requires-dist = [
860
861 [[package]]
862 name = "composio-langchain"
863 -version = "0.17.0"
863 +version = "0.17.1"
864 source = { editable = "python/providers/langchain" }
865 dependencies = [
866 { name = "composio" },
@@ -875,7 +875,7 @@ requires-dist = [
875
876 [[package]]
877 name = "composio-openai"
878 -version = "0.17.0"
878 +version = "0.17.1"
879 source = { editable = "python/providers/openai" }
880 dependencies = [
881 { name = "composio" },
@@ -890,7 +890,7 @@ requires-dist = [
890
891 [[package]]
892 name = "composio-openai-agents"
893 -version = "0.17.0"
893 +version = "0.17.1"
894 source = { editable = "python/providers/openai_agents" }
895 dependencies = [
896 { name = "composio" },