Skip to content

Composio powers 1000+ toolkits, tool search, context management, authentication, and a sandboxed workbench to help you build AI agents that turn intent into action.

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.md
index 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 Added
diff --git a/python/composio/core/models/tool_router.py b/python/composio/core/models/tool_router.py
index 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 execute
calls 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 config
session = 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 session
session = 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.md
index 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:
```python
session = 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.toml
index 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.py
index ff24b8fa0..f0a14341c 100644
--- a/python/providers/anthropic/setup.py
+++ b/python/providers/anthropic/setup.py
@@ -8,7 +8,7 @@ from setuptools import setup
setup(
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.toml
index 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.py
index 09eaa9e86..4b0f022c9 100644
--- a/python/providers/autogen/setup.py
+++ b/python/providers/autogen/setup.py
@@ -8,7 +8,7 @@ from setuptools import setup
setup(
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.toml
index 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.py
index 773b472a9..1c5d257d0 100644
--- a/python/providers/crewai/setup.py
+++ b/python/providers/crewai/setup.py
@@ -6,7 +6,7 @@ from setuptools import setup
setup(
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.toml
index 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.py
index 46d6a54de..b72669d4b 100644
--- a/python/providers/gemini/setup.py
+++ b/python/providers/gemini/setup.py
@@ -8,7 +8,7 @@ from setuptools import setup
setup(
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.toml
index 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.py
index bba2b0f7e..2f630be7a 100644
--- a/python/providers/google/setup.py
+++ b/python/providers/google/setup.py
@@ -8,7 +8,7 @@ from setuptools import setup
setup(
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.toml
index 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.py
index 8efefaf75..61923b725 100644
--- a/python/providers/google_adk/setup.py
+++ b/python/providers/google_adk/setup.py
@@ -8,7 +8,7 @@ from setuptools import setup
setup(
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.toml
index 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.py
index 024b57bd6..6526e4c88 100644
--- a/python/providers/langchain/setup.py
+++ b/python/providers/langchain/setup.py
@@ -8,7 +8,7 @@ from setuptools import setup
setup(
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.toml
index 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.py
index 5772fdac3..87ee23b79 100644
--- a/python/providers/langgraph/setup.py
+++ b/python/providers/langgraph/setup.py
@@ -8,7 +8,7 @@ from setuptools import setup
setup(
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.toml
index 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.py
index 845353380..cc17fc3bb 100644
--- a/python/providers/llamaindex/setup.py
+++ b/python/providers/llamaindex/setup.py
@@ -8,7 +8,7 @@ from setuptools import setup
setup(
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.toml
index 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.py
index 6bfd27071..21c27df27 100644
--- a/python/providers/openai/setup.py
+++ b/python/providers/openai/setup.py
@@ -8,7 +8,7 @@ from setuptools import setup
setup(
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.toml
index 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.py
index 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, setup
setup(
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.toml
index 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.py
index 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.kwargs
assert 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_args
kwargs = 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"] == 300
def 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 kwargs
assert "auth_configs" in kwargs
assert "connected_accounts" in kwargs
- assert "execution" in kwargs
+ assert "workbench" in kwargs
def 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.lock
index 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" },