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, 19:45 UTC
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" },