Composio powers 1000+ toolkits, tool search, context management, authentication, and a sandboxed workbench to help you build AI agents that turn intent into action.
TypeScript agentic-aiagentsaiai-agentsaiagentsdeveloper-toolsfunction-callinggpt-4javascriptjsllmllmopsmcppythonremote-mcp-serverssetypescript
Fix missing workbench options in session config (#2272)
Musthaq Ahamaddf1c8ec8f418
diff --git a/fern/pages/src/changelog/12-15-25.md b/fern/pages/src/changelog/12-15-25.mdindex 5e732f694..b59cd1fea 100644--- a/fern/pages/src/changelog/12-15-25.md+++ b/fern/pages/src/changelog/12-15-25.md@@ -1,7 +1,7 @@# Tool Router is Generally Available in TS and PY SDKs**Release Date:** December 15, 2025-**Python SDK Version:** 0.10.0+**Python SDK Version:** 0.10.1**TypeScript SDK Version:** 0.3.0## Major Features Addeddiff --git a/python/composio/core/models/tool_router.py b/python/composio/core/models/tool_router.pyindex 2b5a1e0d5..aa527d45f 100644--- a/python/composio/core/models/tool_router.py+++ b/python/composio/core/models/tool_router.py@@ -105,13 +105,13 @@ ToolRouterToolsConfig = t.Union[]-class ToolRouterExecutionConfig(te.TypedDict, total=False):- """Configuration for execution settings in tool router session.+class ToolRouterWorkbenchConfig(te.TypedDict, total=False):+ """Configuration for workbench settings in tool router session.Attributes:enable_proxy_execution: Whether to allow proxy execute calls in the workbench.If False, prevents arbitrary HTTP requests.- auto_offload_threshold: Maximum execution time for workbench operations in seconds.+ auto_offload_threshold: Maximum execution payload size to offload to workbench."""enable_proxy_execution: bool@@ -656,7 +656,7 @@ class ToolRouter(Resource, t.Generic[TProvider]):] = None,auth_configs: t.Optional[t.Dict[str, str]] = None,connected_accounts: t.Optional[t.Dict[str, str]] = None,- execution: t.Optional[ToolRouterExecutionConfig] = None,+ workbench: t.Optional[ToolRouterWorkbenchConfig] = None,) -> ToolRouterSession[TProvider]:"""Create a new tool router session for a user.@@ -703,12 +703,12 @@ class ToolRouter(Resource, t.Generic[TProvider]):Example: {'github': 'ac_xxx', 'slack': 'ac_yyy'}:param connected_accounts: Optional mapping of toolkit slug to connected account ID.Example: {'github': 'ca_xxx', 'slack': 'ca_yyy'}- :param execution: Optional execution configuration (ToolRouterExecutionConfig).+ :param workbench: Optional workbench configuration (ToolRouterWorkbenchConfig).Dict with:- 'enable_proxy_execution' (bool): Whether to allow proxy executecalls in the workbench. If False, prevents arbitrary HTTP requests.- - 'auto_offload_threshold' (int): Maximum execution time for- workbench operations in seconds.+ - 'auto_offload_threshold' (int): Maximum execution payload size to+ offload to workbench.Example: {'enable_proxy_execution': False, 'auto_offload_threshold': 300}:return: Tool router session object@@ -757,10 +757,10 @@ class ToolRouter(Resource, t.Generic[TProvider]):})- # Create a session with execution config+ # Create a session with workbench configsession = tool_router.create(user_id='user_123',- execution={+ workbench={'enable_proxy_execution': False,'auto_offload_threshold': 300}@@ -842,19 +842,19 @@ class ToolRouter(Resource, t.Generic[TProvider]):if tags is not None:create_params["tags"] = tags- if execution is not None:+ if workbench is not None:execution_payload: t.Dict[str, t.Any] = {}- if "enable_proxy_execution" in execution:- execution_payload["enable_proxy_execution"] = execution[+ if "enable_proxy_execution" in workbench:+ execution_payload["enable_proxy_execution"] = workbench["enable_proxy_execution"]- if "auto_offload_threshold" in execution:+ if "auto_offload_threshold" in workbench:execution_payload["auto_offload_threshold"] = int(- execution["auto_offload_threshold"]+ workbench["auto_offload_threshold"])if execution_payload:- create_params["execution"] = execution_payload+ create_params["workbench"] = execution_payload# Make API call to create sessionsession = self._client.tool_router.session.create(**create_params)@@ -920,7 +920,7 @@ __all__ = ["ToolRouterToolsTagsConfig","ToolRouterToolsConfig","ToolRouterManageConnectionsConfig",- "ToolRouterExecutionConfig",+ "ToolRouterWorkbenchConfig","ToolkitConnectionState","ToolkitConnectionsDetails","ToolRouterMCPServerConfig",diff --git a/python/docs/tool-router.md b/python/docs/tool-router.mdindex b2153ad34..32b620c4d 100644--- a/python/docs/tool-router.md+++ b/python/docs/tool-router.md@@ -215,17 +215,17 @@ session = composio.tool_router.create()```-### `execution`+### `workbench`-Configure tool execution behavior:+Configure workbench behavior:```pythonsession = composio.tool_router.create(user_id='user_123',toolkits=['gmail'],- execution={+ workbench={'enable_proxy_execution': False, # Whether to allow proxy execute calls in workbench- 'auto_offload_threshold': 300 # Maximum execution time in seconds+ 'auto_offload_threshold': 300 # Maximum execution payload size to offload to workbench})```@@ -679,12 +679,12 @@ manage_connections: Union[ToolRouterManageConnectionsConfig # {'enable': True, 'callback_url': 'https://...'}]-# Execution configuration-ToolRouterExecutionConfig = TypedDict('ToolRouterExecutionConfig', {+# Workbench configuration+ToolRouterWorkbenchConfig = TypedDict('ToolRouterWorkbenchConfig', {'enable_proxy_execution': bool, # Whether to allow proxy execute calls- 'auto_offload_threshold': int # Maximum execution time in seconds+ 'auto_offload_threshold': int # Maximum execution payload size to offload to workbench})-execution: ToolRouterExecutionConfig+workbench: ToolRouterWorkbenchConfig```diff --git a/python/providers/anthropic/pyproject.toml b/python/providers/anthropic/pyproject.tomlindex c46f3ca87..3859e25cf 100644--- a/python/providers/anthropic/pyproject.toml+++ b/python/providers/anthropic/pyproject.toml@@ -1,6 +1,6 @@[project]name = "composio-anthropic"-version = "0.10.0"+version = "0.10.1"description = "Use Composio to get an array of tools with your Anthropic LLMs."readme = "README.md"requires-python = ">=3.10,<4"diff --git a/python/providers/anthropic/setup.py b/python/providers/anthropic/setup.pyindex ff24b8fa0..f0a14341c 100644--- a/python/providers/anthropic/setup.py+++ b/python/providers/anthropic/setup.py@@ -8,7 +8,7 @@ from setuptools import setupsetup(name="composio_anthropic",- version="0.10.0",+ version="0.10.1",author="Composio",author_email="[email protected]",description="Use Composio to get an array of tools with your Anthropic LLMs.",diff --git a/python/providers/autogen/pyproject.toml b/python/providers/autogen/pyproject.tomlindex b10512b37..f87668e51 100644--- a/python/providers/autogen/pyproject.toml+++ b/python/providers/autogen/pyproject.toml@@ -1,6 +1,6 @@[project]name = "composio-autogen"-version = "0.10.0"+version = "0.10.1"description = "Use Composio to get an array of tools with your autogen agent."readme = "README.md"requires-python = ">=3.9,<4"diff --git a/python/providers/autogen/setup.py b/python/providers/autogen/setup.pyindex 09eaa9e86..4b0f022c9 100644--- a/python/providers/autogen/setup.py+++ b/python/providers/autogen/setup.py@@ -8,7 +8,7 @@ from setuptools import setupsetup(name="composio_autogen",- version="0.10.0",+ version="0.10.1",author="Composio",author_email="[email protected]",description="Use Composio to get an array of tools with your Autogen agent.",diff --git a/python/providers/crewai/pyproject.toml b/python/providers/crewai/pyproject.tomlindex d08faca04..a3260e3c8 100644--- a/python/providers/crewai/pyproject.toml+++ b/python/providers/crewai/pyproject.toml@@ -1,6 +1,6 @@[project]name = "composio-crewai"-version = "0.10.0"+version = "0.10.1"description = "Use Composio to get an array of tools with your CrewAI agent."readme = "README.md"requires-python = ">=3.9,<4"diff --git a/python/providers/crewai/setup.py b/python/providers/crewai/setup.pyindex 773b472a9..1c5d257d0 100644--- a/python/providers/crewai/setup.py+++ b/python/providers/crewai/setup.py@@ -6,7 +6,7 @@ from setuptools import setupsetup(name="composio_crewai",- version="0.10.0",+ version="0.10.1",author="Composio",author_email="[email protected]",description="Use Composio to get an array of tools with your CrewAI agent.",diff --git a/python/providers/gemini/pyproject.toml b/python/providers/gemini/pyproject.tomlindex 2096dd5d2..a11e435d2 100644--- a/python/providers/gemini/pyproject.toml+++ b/python/providers/gemini/pyproject.toml@@ -1,6 +1,6 @@[project]name = "composio-gemini"-version = "0.10.0"+version = "0.10.1"description = "Use Composio to get an array of tools with your Gemini agent."readme = "README.md"requires-python = ">=3.9,<4"diff --git a/python/providers/gemini/setup.py b/python/providers/gemini/setup.pyindex 46d6a54de..b72669d4b 100644--- a/python/providers/gemini/setup.py+++ b/python/providers/gemini/setup.py@@ -8,7 +8,7 @@ from setuptools import setupsetup(name="composio_gemini",- version="0.10.0",+ version="0.10.1",author="Composio",author_email="[email protected]",description="Use Composio to get an array of tools with your Gemini agent.",diff --git a/python/providers/google/pyproject.toml b/python/providers/google/pyproject.tomlindex 91ea80dfb..992f72e54 100644--- a/python/providers/google/pyproject.toml+++ b/python/providers/google/pyproject.toml@@ -1,6 +1,6 @@[project]name = "composio-google"-version = "0.10.0"+version = "0.10.1"description = "Use Composio to get an array of tools with your Google AI Python Gemini model."readme = "README.md"requires-python = ">=3.9,<4"diff --git a/python/providers/google/setup.py b/python/providers/google/setup.pyindex bba2b0f7e..2f630be7a 100644--- a/python/providers/google/setup.py+++ b/python/providers/google/setup.py@@ -8,7 +8,7 @@ from setuptools import setupsetup(name="composio_google",- version="0.10.0",+ version="0.10.1",author="Composio",author_email="[email protected]",description="Use Composio to get an array of tools with your Google AI Python Gemini model.",diff --git a/python/providers/google_adk/pyproject.toml b/python/providers/google_adk/pyproject.tomlindex 24512d995..91a20ba6a 100644--- a/python/providers/google_adk/pyproject.toml+++ b/python/providers/google_adk/pyproject.toml@@ -1,6 +1,6 @@[project]name = "composio-google-adk"-version = "0.10.0"+version = "0.10.1"description = "Use Composio to get an array of tools with your Google AI Python Gemini model."readme = "README.md"requires-python = ">=3.9,<4"diff --git a/python/providers/google_adk/setup.py b/python/providers/google_adk/setup.pyindex 8efefaf75..61923b725 100644--- a/python/providers/google_adk/setup.py+++ b/python/providers/google_adk/setup.py@@ -8,7 +8,7 @@ from setuptools import setupsetup(name="composio_google_adk",- version="0.10.0",+ version="0.10.1",author="Composio",author_email="[email protected]",description="Use Composio to get an array of tools with your Google AI Python Gemini model.",diff --git a/python/providers/langchain/pyproject.toml b/python/providers/langchain/pyproject.tomlindex 460d45e65..48d3b05a4 100644--- a/python/providers/langchain/pyproject.toml+++ b/python/providers/langchain/pyproject.toml@@ -1,6 +1,6 @@[project]name = "composio-langchain"-version = "0.10.0"+version = "0.10.1"description = "Use Composio to get an array of tools with your Langchain agent."readme = "README.md"requires-python = ">=3.9,<4"diff --git a/python/providers/langchain/setup.py b/python/providers/langchain/setup.pyindex 024b57bd6..6526e4c88 100644--- a/python/providers/langchain/setup.py+++ b/python/providers/langchain/setup.py@@ -8,7 +8,7 @@ from setuptools import setupsetup(name="composio_langchain",- version="0.10.0",+ version="0.10.1",author="composio",author_email="[email protected]",description="Use Composio to get an array of tools with your Langchain agent.",diff --git a/python/providers/langgraph/pyproject.toml b/python/providers/langgraph/pyproject.tomlindex 41c919ef5..fc432226e 100644--- a/python/providers/langgraph/pyproject.toml+++ b/python/providers/langgraph/pyproject.toml@@ -1,6 +1,6 @@[project]name = "composio-langgraph"-version = "0.10.0"+version = "0.10.1"description = "Use Composio to get array of tools with LangGraph Agent Workflows."readme = "README.md"requires-python = ">=3.9,<4"diff --git a/python/providers/langgraph/setup.py b/python/providers/langgraph/setup.pyindex 5772fdac3..87ee23b79 100644--- a/python/providers/langgraph/setup.py+++ b/python/providers/langgraph/setup.py@@ -8,7 +8,7 @@ from setuptools import setupsetup(name="composio_langgraph",- version="0.10.0",+ version="0.10.1",author="composio",author_email="[email protected]",description="Use Composio to get array of tools with LangGraph Agent Workflows",diff --git a/python/providers/llamaindex/pyproject.toml b/python/providers/llamaindex/pyproject.tomlindex ccf816f9e..c88710578 100644--- a/python/providers/llamaindex/pyproject.toml+++ b/python/providers/llamaindex/pyproject.toml@@ -1,6 +1,6 @@[project]name = "composio-llamaindex"-version = "0.10.0"+version = "0.10.1"description = "Use Composio to get array of tools with LlamaIndex Agent Workflows."readme = "README.md"requires-python = ">=3.9,<4"diff --git a/python/providers/llamaindex/setup.py b/python/providers/llamaindex/setup.pyindex 845353380..cc17fc3bb 100644--- a/python/providers/llamaindex/setup.py+++ b/python/providers/llamaindex/setup.py@@ -8,7 +8,7 @@ from setuptools import setupsetup(name="composio_llamaindex",- version="0.10.0",+ version="0.10.1",author="composio",author_email="[email protected]",description="Use Composio to get array of tools with LlamaIndex Agent Workflows",diff --git a/python/providers/openai/pyproject.toml b/python/providers/openai/pyproject.tomlindex a4885fb86..de062fe33 100644--- a/python/providers/openai/pyproject.toml+++ b/python/providers/openai/pyproject.toml@@ -1,6 +1,6 @@[project]name = "composio-openai"-version = "0.10.0"+version = "0.10.1"description = "Use Composio to get an array of tools with your OpenAI Function Call."readme = "README.md"requires-python = ">=3.9,<4"diff --git a/python/providers/openai/setup.py b/python/providers/openai/setup.pyindex 6bfd27071..21c27df27 100644--- a/python/providers/openai/setup.py+++ b/python/providers/openai/setup.py@@ -8,7 +8,7 @@ from setuptools import setupsetup(name="composio_openai",- version="0.10.0",+ version="0.10.1",author="Composio",author_email="[email protected]",description="Use Composio to get an array of tools with your OpenAI Function Call.",diff --git a/python/providers/openai_agents/pyproject.toml b/python/providers/openai_agents/pyproject.tomlindex 8b0802684..3f8ca3818 100644--- a/python/providers/openai_agents/pyproject.toml+++ b/python/providers/openai_agents/pyproject.toml@@ -1,6 +1,6 @@[project]name = "composio-openai-agents"-version = "0.10.0"+version = "0.10.1"description = "Use Composio to get array of strongly typed tools for OpenAI Agents"readme = "README.md"requires-python = ">=3.9,<4"diff --git a/python/providers/openai_agents/setup.py b/python/providers/openai_agents/setup.pyindex a3151e68e..cbddd75aa 100644--- a/python/providers/openai_agents/setup.py+++ b/python/providers/openai_agents/setup.py@@ -8,7 +8,7 @@ from setuptools import find_packages, setupsetup(name="composio_openai_agents",- version="0.10.0",+ version="0.10.1",author="Composio",author_email="[email protected]",description="Use Composio to get array of strongly typed tools for OpenAI Agents",diff --git a/python/pyproject.toml b/python/pyproject.tomlindex f73864b4a..d5d394bb0 100644--- a/python/pyproject.toml+++ b/python/pyproject.toml@@ -1,6 +1,6 @@[project]name = "composio"-version = "0.10.0"+version = "0.10.1"description = "SDK for integrating Composio with your applications."readme = "README.md"requires-python = ">=3.10,<4"diff --git a/python/tests/test_tool_router.py b/python/tests/test_tool_router.pyindex 410b263ce..c5b0629f5 100644--- a/python/tests/test_tool_router.py+++ b/python/tests/test_tool_router.py@@ -273,20 +273,20 @@ class TestToolRouter:kwargs = call_args.kwargsassert kwargs["connected_accounts"] == {"github": "ca_xxx", "slack": "ca_yyy"}- def test_create_session_with_execution_config(self, tool_router, mock_client):- """Test creating a session with execution configuration."""+ def test_create_session_with_workbench_config(self, tool_router, mock_client):+ """Test creating a session with workbench configuration."""session = tool_router.create(user_id="user_123",- execution={"enable_proxy_execution": False, "auto_offload_threshold": 300},+ workbench={"enable_proxy_execution": False, "auto_offload_threshold": 300},)assert session.session_id == "session_123"call_args = mock_client.tool_router.session.create.call_argskwargs = call_args.kwargs- assert "execution" in kwargs- assert kwargs["execution"]["enable_proxy_execution"] is False- assert kwargs["execution"]["auto_offload_threshold"] == 300+ assert "workbench" in kwargs+ assert kwargs["workbench"]["enable_proxy_execution"] is False+ assert kwargs["workbench"]["auto_offload_threshold"] == 300def test_create_session_complex_config(self, tool_router, mock_client):"""Test creating a session with complex configuration."""@@ -303,7 +303,7 @@ class TestToolRouter:},auth_configs={"github": "ac_xxx"},connected_accounts={"slack": "ca_yyy"},- execution={"enable_proxy_execution": True, "auto_offload_threshold": 600},+ workbench={"enable_proxy_execution": True, "auto_offload_threshold": 600},)assert session.session_id == "session_123"@@ -319,7 +319,7 @@ class TestToolRouter:assert "manage_connections" in kwargsassert "auth_configs" in kwargsassert "connected_accounts" in kwargs- assert "execution" in kwargs+ assert "workbench" in kwargsdef test_create_session_raises_error_without_provider(self, mock_client):"""Test that creating a session without provider raises an error when calling tools()."""diff --git a/uv.lock b/uv.lockindex 77c50ad0f..38c2a11e1 100644--- a/uv.lock+++ b/uv.lock@@ -477,7 +477,7 @@ wheels = [[[package]]name = "composio"-version = "0.9.5rc3"+version = "0.10.0"source = { virtual = "python" }dependencies = [{ name = "composio-client" },@@ -532,7 +532,7 @@ dev = [[[package]]name = "composio-anthropic"-version = "0.9.5rc3"+version = "0.10.0"source = { virtual = "python/providers/anthropic" }dependencies = [{ name = "anthropic" },@@ -564,7 +564,7 @@ wheels = [[[package]]name = "composio-crewai"-version = "0.9.5rc3"+version = "0.10.0"source = { virtual = "python/providers/crewai" }dependencies = [{ name = "composio" },@@ -579,7 +579,7 @@ requires-dist = [[[package]]name = "composio-gemini"-version = "0.9.5rc3"+version = "0.10.0"source = { virtual = "python/providers/gemini" }dependencies = [{ name = "composio" },@@ -594,7 +594,7 @@ requires-dist = [[[package]]name = "composio-google"-version = "0.9.5rc3"+version = "0.10.0"source = { virtual = "python/providers/google" }dependencies = [{ name = "composio" },@@ -609,7 +609,7 @@ requires-dist = [[[package]]name = "composio-google-adk"-version = "0.9.5rc3"+version = "0.10.0"source = { virtual = "python/providers/google_adk" }dependencies = [{ name = "composio" },@@ -624,7 +624,7 @@ requires-dist = [[[package]]name = "composio-langchain"-version = "0.9.5rc3"+version = "0.10.0"source = { virtual = "python/providers/langchain" }dependencies = [{ name = "composio" },@@ -639,7 +639,7 @@ requires-dist = [[[package]]name = "composio-openai"-version = "0.9.5rc3"+version = "0.10.0"source = { virtual = "python/providers/openai" }dependencies = [{ name = "composio" },@@ -654,7 +654,7 @@ requires-dist = [[[package]]name = "composio-openai-agents"-version = "0.9.5rc3"+version = "0.10.0"source = { virtual = "python/providers/openai_agents" }dependencies = [{ name = "composio" },