Composio powers 1000+ toolkits, tool search, context management, authentication, and a sandboxed workbench to help you build AI agents that turn intent into action.
refactor(python): remove dead CustomToolkit dataclass
CustomToolkit was the old frozen dataclass that nobody creates anymore. ExperimentalToolkit (via composio.experimental.Toolkit()) is the only toolkit type. Removes all Union[CustomToolkit, ExperimentalToolkit] noise. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Dhawal Upadhyay committed
Mar 23, 2026 at 17:11 UTC
8b0e618b6401cfb0de3ef400e80df477338afba6
5 files changed
+10
-30
python/composio/__init__.py
+2
-2
@@ -1,7 +1,7 @@
1
from .__version__ import __version__
2
+from .core.models.custom_tool import ExperimentalToolkit
3
from .core.models.custom_tool_types import (
4
CustomTool,
4
- CustomToolkit,
5
SessionContext,
6
)
7
from .core.models.tool_router_session_files import RemoteFile
@@ -31,7 +31,7 @@ from .sdk import Composio
31
__all__ = (
32
"Composio",
33
"CustomTool",
34
- "CustomToolkit",
34
+ "ExperimentalToolkit",
35
"RemoteFile",
36
"SessionContext",
37
"ConnectionExpiredEvent",
python/composio/core/models/__init__.py
-2
@@ -3,7 +3,6 @@ from .connected_accounts import ConnectedAccounts
3
from .custom_tool import ExperimentalAPI, ExperimentalToolkit
4
from .custom_tool_types import (
5
CustomTool,
6
- CustomToolkit,
6
ProxyExecuteResponse,
7
RegisteredCustomTool,
8
RegisteredCustomToolkit,
@@ -34,7 +33,6 @@ __all__ = [
33
"ConnectionState",
34
"ConnectionStatusEnum",
35
"CustomTool",
37
- "CustomToolkit",
36
"ExperimentalAPI",
37
"ExperimentalToolkit",
38
"MCP",
python/composio/core/models/custom_tool.py
+5
-6
@@ -54,7 +54,6 @@ from .custom_tool_types import (
54
SLUG_REGEX,
55
CustomTool,
56
CustomToolExecuteFn,
57
- CustomToolkit,
57
CustomToolsMap,
58
CustomToolsMapEntry,
59
)
@@ -490,7 +489,7 @@ def serialize_custom_tools(tools: t.List[CustomTool]) -> t.List[t.Dict[str, t.An
489
490
491
def serialize_custom_toolkits(
493
- toolkits: t.Sequence[t.Union[CustomToolkit, ExperimentalToolkit]],
492
+ toolkits: t.Sequence[ExperimentalToolkit],
493
) -> t.List[t.Dict[str, t.Any]]:
494
"""Serialize custom toolkits into the format expected by the backend."""
495
result = []
@@ -524,7 +523,7 @@ def serialize_custom_toolkits(
523
524
def build_custom_tools_map(
525
tools: t.List[CustomTool],
527
- toolkits: t.Optional[t.List[t.Union[CustomToolkit, ExperimentalToolkit]]] = None,
526
+ toolkits: t.Optional[t.List[ExperimentalToolkit]] = None,
527
) -> CustomToolsMap:
528
"""Build a CustomToolsMap from custom tools and toolkits."""
529
by_final_slug: t.Dict[str, CustomToolsMapEntry] = {}
@@ -578,13 +577,13 @@ def build_custom_tools_map(
577
return CustomToolsMap(
578
by_final_slug=by_final_slug,
579
by_original_slug=by_original_slug,
581
- toolkits=list(toolkits) if toolkits else None, # type: ignore[arg-type]
580
+ toolkits=list(toolkits) if toolkits else None,
581
)
582
583
584
def build_custom_tools_map_from_response(
585
tools: t.List[CustomTool],
587
- toolkits: t.Optional[t.List[t.Union[CustomToolkit, ExperimentalToolkit]]],
586
+ toolkits: t.Optional[t.List[ExperimentalToolkit]],
587
experimental: t.Optional[SessionCreateResponseExperimental],
588
) -> CustomToolsMap:
589
"""Build a CustomToolsMap using the slug/original_slug mapping from the backend response."""
@@ -638,5 +637,5 @@ def build_custom_tools_map_from_response(
637
return CustomToolsMap(
638
by_final_slug=by_final_slug,
639
by_original_slug=by_original_slug,
641
- toolkits=list(toolkits) if toolkits else None, # type: ignore[arg-type]
640
+ toolkits=list(toolkits) if toolkits else None,
641
)
python/composio/core/models/custom_tool_types.py
+1
-15
@@ -97,20 +97,6 @@ class CustomTool:
97
output_schema: t.Optional[t.Dict[str, t.Any]] = None
98
99
100
-@dataclass(frozen=True)
101
-class CustomToolkit:
102
- """Custom toolkit definition returned from ``composio.experimental.Toolkit()``.
103
-
104
- Pass to ``composio.create(user_id, experimental={"custom_toolkits": [...]})``
105
- to bind to a session.
106
- """
107
-
108
- slug: str
109
- name: str
110
- description: str
111
- tools: t.Tuple[CustomTool, ...]
112
-
113
-
100
# ────────────────────────────────────────────────────────────────
101
# Internal routing map types
102
# ────────────────────────────────────────────────────────────────
@@ -131,7 +117,7 @@ class CustomToolsMap:
117
118
by_final_slug: t.Dict[str, CustomToolsMapEntry] = field(default_factory=dict)
119
by_original_slug: t.Dict[str, CustomToolsMapEntry] = field(default_factory=dict)
134
- toolkits: t.Optional[t.List[CustomToolkit]] = None
120
+ toolkits: t.Optional[t.List[t.Any]] = None
121
122
123
# ────────────────────────────────────────────────────────────────
python/composio/core/models/tool_router.py
+2
-5
@@ -25,7 +25,6 @@ from composio.core.models.custom_tool import (
25
)
26
from composio.core.models.custom_tool_types import (
27
CustomTool,
28
- CustomToolkit,
28
CustomToolsMap,
29
)
30
from composio.core.models.tool_router_session import ToolRouterSession
@@ -195,7 +194,7 @@ class ToolRouterExperimentalConfig(te.TypedDict, total=False):
194
195
assistive_prompt: ToolRouterAssistivePromptConfig
196
custom_tools: t.List["CustomTool"]
198
- custom_toolkits: t.List[t.Union["CustomToolkit", "ExperimentalToolkit"]]
197
+ custom_toolkits: t.List["ExperimentalToolkit"]
198
199
200
@dataclass
@@ -712,9 +711,7 @@ class ToolRouter(Resource, t.Generic[TTool, TToolCollection]):
711
# Map SDK's experimental.assistive_prompt.user_timezone to API's
712
# experimental.assistive_prompt_config.user_timezone
713
custom_tools: t.Optional[t.List[CustomTool]] = None
715
- custom_toolkits: t.Optional[
716
- t.List[t.Union[CustomToolkit, ExperimentalToolkit]]
717
- ] = None
714
+ custom_toolkits: t.Optional[t.List[ExperimentalToolkit]] = None
715
716
if experimental is not None:
717
experimental_payload: t.Dict[str, t.Any] = {}