@devries-cameron20 / composio Mirror · read-only / commits / df1c8ec8f
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 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" },