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 22, 17:00 UTC
Fix missing workbench options in session config (#2272)
Musthaq Ahamad committed
Dec 16, 2025 at 15:46 UTC
df1c8ec8f4180ac52acb1a43a24a97fd8b4a194f
28 files changed
+65
-65
fern/pages/src/changelog/12-15-25.md
+1
-1
@@ -1,7 +1,7 @@
1
# Tool Router is Generally Available in TS and PY SDKs
2
3
**Release Date:** December 15, 2025
4
-**Python SDK Version:** 0.10.0
4
+**Python SDK Version:** 0.10.1
5
**TypeScript SDK Version:** 0.3.0
6
7
## Major Features Added
python/composio/core/models/tool_router.py
+16
-16
@@ -105,13 +105,13 @@ ToolRouterToolsConfig = t.Union[
105
]
106
107
108
-class ToolRouterExecutionConfig(te.TypedDict, total=False):
109
- """Configuration for execution settings in tool router session.
108
+class ToolRouterWorkbenchConfig(te.TypedDict, total=False):
109
+ """Configuration for workbench settings in tool router session.
110
111
Attributes:
112
enable_proxy_execution: Whether to allow proxy execute calls in the workbench.
113
If False, prevents arbitrary HTTP requests.
114
- auto_offload_threshold: Maximum execution time for workbench operations in seconds.
114
+ auto_offload_threshold: Maximum execution payload size to offload to workbench.
115
"""
116
117
enable_proxy_execution: bool
@@ -656,7 +656,7 @@ class ToolRouter(Resource, t.Generic[TProvider]):
656
] = None,
657
auth_configs: t.Optional[t.Dict[str, str]] = None,
658
connected_accounts: t.Optional[t.Dict[str, str]] = None,
659
- execution: t.Optional[ToolRouterExecutionConfig] = None,
659
+ workbench: t.Optional[ToolRouterWorkbenchConfig] = None,
660
) -> ToolRouterSession[TProvider]:
661
"""
662
Create a new tool router session for a user.
@@ -703,12 +703,12 @@ class ToolRouter(Resource, t.Generic[TProvider]):
703
Example: {'github': 'ac_xxx', 'slack': 'ac_yyy'}
704
:param connected_accounts: Optional mapping of toolkit slug to connected account ID.
705
Example: {'github': 'ca_xxx', 'slack': 'ca_yyy'}
706
- :param execution: Optional execution configuration (ToolRouterExecutionConfig).
706
+ :param workbench: Optional workbench configuration (ToolRouterWorkbenchConfig).
707
Dict with:
708
- 'enable_proxy_execution' (bool): Whether to allow proxy execute
709
calls in the workbench. If False, prevents arbitrary HTTP requests.
710
- - 'auto_offload_threshold' (int): Maximum execution time for
711
- workbench operations in seconds.
710
+ - 'auto_offload_threshold' (int): Maximum execution payload size to
711
+ offload to workbench.
712
Example: {'enable_proxy_execution': False, 'auto_offload_threshold': 300}
713
:return: Tool router session object
714
@@ -757,10 +757,10 @@ class ToolRouter(Resource, t.Generic[TProvider]):
757
}
758
)
759
760
- # Create a session with execution config
760
+ # Create a session with workbench config
761
session = tool_router.create(
762
user_id='user_123',
763
- execution={
763
+ workbench={
764
'enable_proxy_execution': False,
765
'auto_offload_threshold': 300
766
}
@@ -842,19 +842,19 @@ class ToolRouter(Resource, t.Generic[TProvider]):
842
if tags is not None:
843
create_params["tags"] = tags
844
845
- if execution is not None:
845
+ if workbench is not None:
846
execution_payload: t.Dict[str, t.Any] = {}
847
- if "enable_proxy_execution" in execution:
848
- execution_payload["enable_proxy_execution"] = execution[
847
+ if "enable_proxy_execution" in workbench:
848
+ execution_payload["enable_proxy_execution"] = workbench[
849
"enable_proxy_execution"
850
]
851
- if "auto_offload_threshold" in execution:
851
+ if "auto_offload_threshold" in workbench:
852
execution_payload["auto_offload_threshold"] = int(
853
- execution["auto_offload_threshold"]
853
+ workbench["auto_offload_threshold"]
854
)
855
856
if execution_payload:
857
- create_params["execution"] = execution_payload
857
+ create_params["workbench"] = execution_payload
858
859
# Make API call to create session
860
session = self._client.tool_router.session.create(**create_params)
@@ -920,7 +920,7 @@ __all__ = [
920
"ToolRouterToolsTagsConfig",
921
"ToolRouterToolsConfig",
922
"ToolRouterManageConnectionsConfig",
923
- "ToolRouterExecutionConfig",
923
+ "ToolRouterWorkbenchConfig",
924
"ToolkitConnectionState",
925
"ToolkitConnectionsDetails",
926
"ToolRouterMCPServerConfig",
python/docs/tool-router.md
+8
-8
@@ -215,17 +215,17 @@ session = composio.tool_router.create(
215
)
216
```
217
218
-### `execution`
218
+### `workbench`
219
220
-Configure tool execution behavior:
220
+Configure workbench behavior:
221
222
```python
223
session = composio.tool_router.create(
224
user_id='user_123',
225
toolkits=['gmail'],
226
- execution={
226
+ workbench={
227
'enable_proxy_execution': False, # Whether to allow proxy execute calls in workbench
228
- 'auto_offload_threshold': 300 # Maximum execution time in seconds
228
+ 'auto_offload_threshold': 300 # Maximum execution payload size to offload to workbench
229
}
230
)
231
```
@@ -679,12 +679,12 @@ manage_connections: Union[
679
ToolRouterManageConnectionsConfig # {'enable': True, 'callback_url': 'https://...'}
680
]
681
682
-# Execution configuration
683
-ToolRouterExecutionConfig = TypedDict('ToolRouterExecutionConfig', {
682
+# Workbench configuration
683
+ToolRouterWorkbenchConfig = TypedDict('ToolRouterWorkbenchConfig', {
684
'enable_proxy_execution': bool, # Whether to allow proxy execute calls
685
- 'auto_offload_threshold': int # Maximum execution time in seconds
685
+ 'auto_offload_threshold': int # Maximum execution payload size to offload to workbench
686
})
687
688
-execution: ToolRouterExecutionConfig
688
+workbench: ToolRouterWorkbenchConfig
689
```
690
python/providers/anthropic/pyproject.toml
+1
-1
@@ -1,6 +1,6 @@
1
[project]
2
name = "composio-anthropic"
3
-version = "0.10.0"
3
+version = "0.10.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.10.0",
11
+ version="0.10.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.10.0"
3
+version = "0.10.1"
4
description = "Use Composio to get an array of tools with your autogen agent."
5
readme = "README.md"
6
requires-python = ">=3.9,<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.10.0",
11
+ version="0.10.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/crewai/pyproject.toml
+1
-1
@@ -1,6 +1,6 @@
1
[project]
2
name = "composio-crewai"
3
-version = "0.10.0"
3
+version = "0.10.1"
4
description = "Use Composio to get an array of tools with your CrewAI agent."
5
readme = "README.md"
6
requires-python = ">=3.9,<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.10.0",
9
+ version="0.10.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.10.0"
3
+version = "0.10.1"
4
description = "Use Composio to get an array of tools with your Gemini agent."
5
readme = "README.md"
6
requires-python = ">=3.9,<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.10.0",
11
+ version="0.10.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.10.0"
3
+version = "0.10.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.9,<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.10.0",
11
+ version="0.10.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.10.0"
3
+version = "0.10.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.9,<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.10.0",
11
+ version="0.10.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.10.0"
3
+version = "0.10.1"
4
description = "Use Composio to get an array of tools with your Langchain agent."
5
readme = "README.md"
6
requires-python = ">=3.9,<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.10.0",
11
+ version="0.10.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.10.0"
3
+version = "0.10.1"
4
description = "Use Composio to get array of tools with LangGraph Agent Workflows."
5
readme = "README.md"
6
requires-python = ">=3.9,<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.10.0",
11
+ version="0.10.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.10.0"
3
+version = "0.10.1"
4
description = "Use Composio to get array of tools with LlamaIndex Agent Workflows."
5
readme = "README.md"
6
requires-python = ">=3.9,<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.10.0",
11
+ version="0.10.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.10.0"
3
+version = "0.10.1"
4
description = "Use Composio to get an array of tools with your OpenAI Function Call."
5
readme = "README.md"
6
requires-python = ">=3.9,<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.10.0",
11
+ version="0.10.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.10.0"
3
+version = "0.10.1"
4
description = "Use Composio to get array of strongly typed tools for OpenAI Agents"
5
readme = "README.md"
6
requires-python = ">=3.9,<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.10.0",
11
+ version="0.10.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.10.0"
3
+version = "0.10.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
+8
-8
@@ -273,20 +273,20 @@ class TestToolRouter:
273
kwargs = call_args.kwargs
274
assert kwargs["connected_accounts"] == {"github": "ca_xxx", "slack": "ca_yyy"}
275
276
- def test_create_session_with_execution_config(self, tool_router, mock_client):
277
- """Test creating a session with execution configuration."""
276
+ def test_create_session_with_workbench_config(self, tool_router, mock_client):
277
+ """Test creating a session with workbench configuration."""
278
session = tool_router.create(
279
user_id="user_123",
280
- execution={"enable_proxy_execution": False, "auto_offload_threshold": 300},
280
+ workbench={"enable_proxy_execution": False, "auto_offload_threshold": 300},
281
)
282
283
assert session.session_id == "session_123"
284
285
call_args = mock_client.tool_router.session.create.call_args
286
kwargs = call_args.kwargs
287
- assert "execution" in kwargs
288
- assert kwargs["execution"]["enable_proxy_execution"] is False
289
- assert kwargs["execution"]["auto_offload_threshold"] == 300
287
+ assert "workbench" in kwargs
288
+ assert kwargs["workbench"]["enable_proxy_execution"] is False
289
+ assert kwargs["workbench"]["auto_offload_threshold"] == 300
290
291
def test_create_session_complex_config(self, tool_router, mock_client):
292
"""Test creating a session with complex configuration."""
@@ -303,7 +303,7 @@ class TestToolRouter:
303
},
304
auth_configs={"github": "ac_xxx"},
305
connected_accounts={"slack": "ca_yyy"},
306
- execution={"enable_proxy_execution": True, "auto_offload_threshold": 600},
306
+ workbench={"enable_proxy_execution": True, "auto_offload_threshold": 600},
307
)
308
309
assert session.session_id == "session_123"
@@ -319,7 +319,7 @@ class TestToolRouter:
319
assert "manage_connections" in kwargs
320
assert "auth_configs" in kwargs
321
assert "connected_accounts" in kwargs
322
- assert "execution" in kwargs
322
+ assert "workbench" in kwargs
323
324
def test_create_session_raises_error_without_provider(self, mock_client):
325
"""Test that creating a session without provider raises an error when calling tools()."""
uv.lock
+9
-9
@@ -477,7 +477,7 @@ wheels = [
477
478
[[package]]
479
name = "composio"
480
-version = "0.9.5rc3"
480
+version = "0.10.0"
481
source = { virtual = "python" }
482
dependencies = [
483
{ name = "composio-client" },
@@ -532,7 +532,7 @@ dev = [
532
533
[[package]]
534
name = "composio-anthropic"
535
-version = "0.9.5rc3"
535
+version = "0.10.0"
536
source = { virtual = "python/providers/anthropic" }
537
dependencies = [
538
{ name = "anthropic" },
@@ -564,7 +564,7 @@ wheels = [
564
565
[[package]]
566
name = "composio-crewai"
567
-version = "0.9.5rc3"
567
+version = "0.10.0"
568
source = { virtual = "python/providers/crewai" }
569
dependencies = [
570
{ name = "composio" },
@@ -579,7 +579,7 @@ requires-dist = [
579
580
[[package]]
581
name = "composio-gemini"
582
-version = "0.9.5rc3"
582
+version = "0.10.0"
583
source = { virtual = "python/providers/gemini" }
584
dependencies = [
585
{ name = "composio" },
@@ -594,7 +594,7 @@ requires-dist = [
594
595
[[package]]
596
name = "composio-google"
597
-version = "0.9.5rc3"
597
+version = "0.10.0"
598
source = { virtual = "python/providers/google" }
599
dependencies = [
600
{ name = "composio" },
@@ -609,7 +609,7 @@ requires-dist = [
609
610
[[package]]
611
name = "composio-google-adk"
612
-version = "0.9.5rc3"
612
+version = "0.10.0"
613
source = { virtual = "python/providers/google_adk" }
614
dependencies = [
615
{ name = "composio" },
@@ -624,7 +624,7 @@ requires-dist = [
624
625
[[package]]
626
name = "composio-langchain"
627
-version = "0.9.5rc3"
627
+version = "0.10.0"
628
source = { virtual = "python/providers/langchain" }
629
dependencies = [
630
{ name = "composio" },
@@ -639,7 +639,7 @@ requires-dist = [
639
640
[[package]]
641
name = "composio-openai"
642
-version = "0.9.5rc3"
642
+version = "0.10.0"
643
source = { virtual = "python/providers/openai" }
644
dependencies = [
645
{ name = "composio" },
@@ -654,7 +654,7 @@ requires-dist = [
654
655
[[package]]
656
name = "composio-openai-agents"
657
-version = "0.9.5rc3"
657
+version = "0.10.0"
658
source = { virtual = "python/providers/openai_agents" }
659
dependencies = [
660
{ name = "composio" },