@devries-cameron20 / composio Mirror · read-only / commits / a550aeb28
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

Chore: Move tool router out of experimental and remove depreacted mcp (#2267)

Musthaq Ahamad committed Dec 13, 2025 at 12:58 UTC a550aeb289cbffbdc192d3046a18d0b11114330c
18 files changed +113 -123
python/composio/sdk.py
+16 -17
@@ -37,17 +37,16 @@ class SDKConfig(te.TypedDict):
37 toolkit_versions: te.NotRequired[ToolkitVersionParam]
38
39
40 -class ExperimentalNamespace:
41 - """Namespace for experimental Composio features."""
40 +# class ExperimentalNamespace:
41 +# """Namespace for experimental Composio features."""
42
43 - def __init__(self, tool_router: ToolRouter):
44 - """
45 - Initialize experimental namespace.
43 +# def __init__(self, tool_router: ToolRouter):
44 +# """
45 +# Initialize experimental namespace.
46
47 - :param tool_router: Experimental ToolRouter instance
48 - """
49 - self.create = tool_router.create
50 - self.use = tool_router.use
47 +# :param tool_router: Experimental ToolRouter instance
48 +# """
49 +# self.tool_router = tool_router
50
51
52 class Composio(t.Generic[TProvider], WithLogger):
@@ -57,7 +56,7 @@ class Composio(t.Generic[TProvider], WithLogger):
56
57 tools: Tools[TProvider]
58 tool_router: ToolRouter[TProvider]
60 - experimental: ExperimentalNamespace
59 + # experimental: ExperimentalNamespace
60
61 def __init__(
62 self,
@@ -102,20 +101,20 @@ class Composio(t.Generic[TProvider], WithLogger):
101 file_download_dir=kwargs.get("file_download_dir"),
102 toolkit_versions=toolkit_versions,
103 )
105 - self.tool_router = ToolRouter(
106 - client=self._client,
107 - provider=self.provider,
108 - )
104 +
105 self.toolkits = Toolkits(client=self._client)
106 self.triggers = Triggers(client=self._client, toolkit_versions=toolkit_versions)
107 self.auth_configs = AuthConfigs(client=self._client)
108 self.connected_accounts = ConnectedAccounts(client=self._client)
109 self.mcp = MCP(client=self._client)
110
115 - # Initialize experimental features
116 - self.experimental = ExperimentalNamespace(
117 - tool_router=self.tool_router,
111 + # initialize tool router methods
112 + self.tool_router = ToolRouter(
113 + client=self._client,
114 + provider=self.provider,
115 )
116 + self.create = self.tool_router.create
117 + self.use = self.tool_router.use
118
119 @property
120 def client(self):
python/examples/tool_router/authorize.py
+1 -1
@@ -19,7 +19,7 @@ if not api_key:
19 composio = Composio(api_key=api_key)
20
21 # Create a tool router session
22 -session = composio.tool_router.create(
22 +session = composio.create(
23 user_id="user_123",
24 toolkits=["github", "gmail"],
25 )
python/examples/tool_router/claude_agent.py
+1 -1
@@ -3,7 +3,7 @@ from claude_agent_sdk import query, ClaudeAgentOptions
3 import asyncio
4
5 composio = Composio()
6 -session = composio.experimental.create(
6 +session = composio.create(
7 user_id="user_123",
8 )
9
python/examples/tool_router/crewai_agent.py
+1 -1
@@ -4,7 +4,7 @@ from crewai.mcp import MCPServerHTTP
4
5
6 composio = Composio()
7 -session = composio.experimental.create(
7 +session = composio.create(
8 user_id="user_123",
9 )
10
python/examples/tool_router/langchain_agent.py
+1 -1
@@ -5,7 +5,7 @@ from langchain_openai.chat_models import ChatOpenAI
5 import asyncio
6
7 composio = Composio()
8 -session = composio.experimental.create(
8 +session = composio.create(
9 user_id="user_123",
10 )
11
python/examples/tool_router/openai_agents.py
+1 -1
@@ -2,7 +2,7 @@ from composio import Composio
2 from agents import Agent, Runner, HostedMCPTool
3
4 composio = Composio()
5 -session = composio.experimental.create(
5 +session = composio.create(
6 user_id="user_123",
7 )
8
python/examples/tool_router/tool_router_mcp.py
+1 -1
@@ -25,7 +25,7 @@ async def main():
25 composio = Composio(api_key=api_key, provider=OpenAIAgentsProvider())
26
27 # Create a tool router session
28 - session = composio.tool_router.create(
28 + session = composio.create(
29 user_id="user_123",
30 toolkits=["github", "gmail"],
31 )
python/examples/tool_router/toolkits.py
+1 -1
@@ -11,7 +11,7 @@ composio = Composio()
11
12 # Create a tool router session
13 # When manage_connections is enabled, tools for managing connections are included
14 -session = composio.tool_router.create(
14 +session = composio.create(
15 user_id="pg-test-37ee710c-d5be-4775-91f2-a8e06b937d9b",
16 manage_connections=True,
17 )
python/examples/tool_router/tools.py
+1 -1
@@ -19,7 +19,7 @@ async def main():
19
20 # Create a tool router session for a specific user
21 # This creates an isolated session with tools for the specified toolkits
22 - session = composio.tool_router.create(
22 + session = composio.create(
23 user_id="user_123",
24 toolkits=["gmail"],
25 )
ts/docs/api/tool-router.md
+38 -38
@@ -39,7 +39,7 @@ import { Composio } from '@composio/core';
39 const composio = new Composio();
40
41 // Create a session for a user with access to Gmail tools
42 -const session = await composio.experimental.create('user_123', {
42 +const session = await composio.create('user_123', {
43 toolkits: ['gmail']
44 });
45
@@ -60,7 +60,7 @@ const composio = new Composio({
60 });
61
62 // Create a session for a user with access to Gmail tools
63 -const session = await composio.experimental.create('user_123', {
63 +const session = await composio.create('user_123', {
64 toolkits: ['gmail']
65 });
66
@@ -72,7 +72,7 @@ const tools = await session.tools();
72
73 ### Basic Session Creation
74
75 -Use `composio.experimental.create()` to create a new Tool Router session:
75 +Use `composio.create()` to create a new Tool Router session:
76
77 ```typescript
78 import { Composio } from '@composio/core';
@@ -80,7 +80,7 @@ import { Composio } from '@composio/core';
80 const composio = new Composio();
81
82 // Create a session with Gmail access
83 -const session = await composio.experimental.create('user_123', {
83 +const session = await composio.create('user_123', {
84 toolkits: ['gmail']
85 });
86
@@ -90,10 +90,10 @@ console.log('MCP URL:', session.mcp.url);
90
91 ### Using an Existing Session
92
93 -If you have an existing session ID, you can retrieve it using `composio.toolRouter.use()`:
93 +If you have an existing session ID, you can retrieve it using `composio.use()`:
94
95 ```typescript
96 -const session = await composio.toolRouter.use('existing_session_id');
96 +const session = await composio.use('existing_session_id');
97
98 // Access session properties
99 console.log(session.sessionId);
@@ -110,18 +110,18 @@ Specify which toolkits to enable or disable in the session.
110
111 ```typescript
112 // Simple array of toolkit slugs to enable
113 -const session = await composio.experimental.create('user_123', {
113 +const session = await composio.create('user_123', {
114 toolkits: ['gmail', 'slack', 'github']
115 });
116
117 // Explicit enabled configuration
118 -const session = await composio.experimental.create('user_123', {
119 - toolkits: { enabled: ['gmail', 'slack'] }
118 +const session = await composio.create('user_123', {
119 + toolkits: { enable: ['gmail', 'slack'] }
120 });
121
122 // Disable specific toolkits (enable all others)
123 -const session = await composio.experimental.create('user_123', {
124 - toolkits: { disabled: ['calendar'] }
123 +const session = await composio.create('user_123', {
124 + toolkits: { disable: ['calendar'] }
125 });
126 ```
127
@@ -130,14 +130,14 @@ const session = await composio.experimental.create('user_123', {
130 Fine-grained control over which tools are available within toolkits. Configure tools per toolkit using the toolkit slug as the key.
131
132 ```typescript
133 -const session = await composio.experimental.create('user_123', {
133 +const session = await composio.create('user_123', {
134 toolkits: ['gmail', 'slack'],
135 tools: {
136 // Configure tools per toolkit
137 gmail: ['gmail_fetch_emails', 'gmail_send_email'], // Only these tools
138 - // OR use enabled/disabled objects
139 - // gmail: { enabled: ['gmail_fetch_emails'] }
140 - // gmail: { disabled: ['gmail_delete_email'] }
138 + // OR use enable/disable objects
139 + // gmail: { enable: ['gmail_fetch_emails'] }
140 + // gmail: { disable: ['gmail_delete_email'] }
141
142 // You can also set tags per toolkit to override global tags
143 slack: { tags: ['readOnlyHint'] }
@@ -150,7 +150,7 @@ const session = await composio.experimental.create('user_123', {
150 Global tags to filter tools by their behavior hints. Tags can be overridden per toolkit in the `tools` configuration.
151
152 ```typescript
153 -const session = await composio.experimental.create('user_123', {
153 +const session = await composio.create('user_123', {
154 toolkits: ['gmail', 'github'],
155 // Global tags applied to all toolkits
156 tags: ['readOnlyHint', 'idempotentHint']
@@ -167,7 +167,7 @@ Available tags:
167 Map toolkits to specific authentication configurations:
168
169 ```typescript
170 -const session = await composio.experimental.create('user_123', {
170 +const session = await composio.create('user_123', {
171 toolkits: ['gmail', 'github'],
172 authConfigs: {
173 gmail: 'ac_gmail_work',
@@ -181,7 +181,7 @@ const session = await composio.experimental.create('user_123', {
181 Map toolkits to specific connected account IDs:
182
183 ```typescript
184 -const session = await composio.experimental.create('user_123', {
184 +const session = await composio.create('user_123', {
185 toolkits: ['gmail'],
186 connectedAccounts: {
187 gmail: 'ca_abc123'
@@ -195,16 +195,16 @@ Control how connections are managed within the session:
195
196 ```typescript
197 // Boolean: enable/disable automatic connection management
198 -const session = await composio.experimental.create('user_123', {
198 +const session = await composio.create('user_123', {
199 toolkits: ['gmail'],
200 manageConnections: true // default
201 });
202
203 // Object: fine-grained control
204 -const session = await composio.experimental.create('user_123', {
204 +const session = await composio.create('user_123', {
205 toolkits: ['gmail'],
206 manageConnections: {
207 - enabled: true,
207 + enable: true,
208 callbackUrl: 'https://your-app.com/auth/callback'
209 }
210 });
@@ -215,10 +215,10 @@ const session = await composio.experimental.create('user_123', {
215 Configure workbench behavior for tool execution:
216
217 ```typescript
218 -const session = await composio.experimental.create('user_123', {
218 +const session = await composio.create('user_123', {
219 toolkits: ['gmail'],
220 workbench: {
221 - proxyExecutionEnabled: true,
221 + enableProxyExecution: true,
222 autoOffloadThreshold: 400000 // Automatically offload to workbench if response > 400k characters
223 }
224 });
@@ -332,7 +332,7 @@ const composio = new Composio({
332 provider: new VercelProvider(),
333 });
334
335 -const session = await composio.experimental.create('user_123', {
335 +const session = await composio.create('user_123', {
336 toolkits: ['gmail']
337 });
338
@@ -362,12 +362,12 @@ import { stepCountIs, streamText } from 'ai';
362
363 // No provider needed when using MCP
364 const composio = new Composio();
365 -const { mcp } = await composio.experimental.create('user_123', {
365 +const { mcp } = await composio.create('user_123', {
366 toolkits: ['gmail'],
367 manageConnections: true,
368 tools: {
369 gmail: {
370 - disabled: ['gmail_send_email'], // Disable specific tools
370 + disable: ['gmail_send_email'], // Disable specific tools
371 }
372 }
373 });
@@ -419,7 +419,7 @@ const llm = new ChatOpenAI({
419 model: "gpt-4o",
420 });
421
422 -const session = await composio.experimental.create('user_123', {
422 +const session = await composio.create('user_123', {
423 toolkits: ['gmail']
424 });
425
@@ -458,7 +458,7 @@ import { Composio } from '@composio/core';
458 // No provider needed when using MCP
459 const composio = new Composio();
460
461 -const session = await composio.experimental.create('user_123', {
461 +const session = await composio.create('user_123', {
462 toolkits: ['gmail']
463 });
464
@@ -501,7 +501,7 @@ import { Composio } from '@composio/core';
501 // No provider needed when using MCP
502 const composio = new Composio();
503
504 -const session = await composio.experimental.create('user_123', {
504 +const session = await composio.create('user_123', {
505 toolkits: ['gmail']
506 });
507
@@ -535,7 +535,7 @@ When a user needs to connect a toolkit, use the `authorize()` method:
535 import { Composio } from '@composio/core';
536
537 const composio = new Composio();
538 -const session = await composio.experimental.create('user_123', {
538 +const session = await composio.create('user_123', {
539 toolkits: ['gmail']
540 });
541
@@ -566,7 +566,7 @@ Use the `toolkits()` method to check connection states:
566 import { Composio } from '@composio/core';
567
568 const composio = new Composio();
569 -const session = await composio.experimental.create('user_123');
569 +const session = await composio.create('user_123');
570
571 // Get all toolkits
572 const toolkits = await session.toolkits();
@@ -643,13 +643,13 @@ const tools = await session.tools(modifiers);
643
644 ```typescript
645 // Store session ID after creation
646 -const session = await composio.experimental.create('user_123', config);
646 +const session = await composio.create('user_123', config);
647 await redis.set(`session:user_123`, session.sessionId);
648
649 // Retrieve existing session
650 const sessionId = await redis.get(`session:user_123`);
651 if (sessionId) {
652 - const session = await composio.toolRouter.use(sessionId);
652 + const session = await composio.use(sessionId);
653 }
654 ```
655
@@ -659,22 +659,22 @@ if (sessionId) {
659
660 ```typescript
661 interface ToolRouterCreateSessionConfig {
662 - toolkits?: string[] | { enabled: string[] } | { disabled: string[] };
662 + toolkits?: string[] | { enable: string[] } | { disable: string[] };
663 tools?: Record<string,
664 string[] |
665 - { enabled: string[] } |
666 - { disabled: string[] } |
665 + { enable: string[] } |
666 + { disable: string[] } |
667 { tags: ('readOnlyHint' | 'destructiveHint' | 'idempotentHint')[] }
668 >;
669 tags?: ('readOnlyHint' | 'destructiveHint' | 'idempotentHint')[];
670 authConfigs?: Record<string, string>;
671 connectedAccounts?: Record<string, string>;
672 manageConnections?: boolean | {
673 - enabled?: boolean;
673 + enable?: boolean;
674 callbackUrl?: string;
675 };
676 workbench?: {
677 - proxyExecutionEnabled?: boolean;
677 + enableProxyExecution?: boolean;
678 autoOffloadThreshold?: number;
679 };
680 }
ts/examples/tool-router/src/authorize.ts
+1 -1
@@ -1,7 +1,7 @@
1 import { Composio } from '@composio/core';
2
3 const composio = new Composio();
4 -const session = await composio.experimental.create('user_123', { toolkits: ['gmail'] });
4 +const session = await composio.create('user_123', { toolkits: ['gmail'] });
5 const connectionRequest = await session.authorize("gmail");
6
7 console.log(connectionRequest);
ts/examples/tool-router/src/claude-agents-sdk.ts
+1 -1
@@ -4,7 +4,7 @@ import 'dotenv/config';
4
5 const composio = new Composio();
6
7 -const session = await composio.experimental.create('user_123', { toolkits: ['gmail'] });
7 +const session = await composio.create('user_123', { toolkits: ['gmail'] });
8
9 const stream = await query({
10 prompt: 'Use composio tools to fetch my last email from gmail',
ts/examples/tool-router/src/index.ts
+1 -1
@@ -7,7 +7,7 @@ import { modifiers } from './logger';
7 const composio = new Composio({
8 provider: new VercelProvider(),
9 });
10 -const session = await composio.experimental.create('user_123', { toolkits: ['gmail'] });
10 +const session = await composio.create('user_123', { toolkits: ['gmail'] });
11
12
13 const tools = await session.tools(modifiers);
ts/examples/tool-router/src/langchain.ts
+1 -1
@@ -12,7 +12,7 @@ const llm = new ChatOpenAI({
12 })
13
14 async function main() {
15 - const session = await composio.experimental.create('user_123', { toolkits: ['gmail'] });
15 + const session = await composio.create('user_123', { toolkits: ['gmail'] });
16
17 const client = new MultiServerMCPClient({
18 math: {
ts/examples/tool-router/src/mcp.ts
+2 -2
@@ -6,12 +6,12 @@ import ora from 'ora';
6
7 const composio = new Composio();
8 const trProgress = ora("Creating tool router session...").start();
9 -const { mcp } = await composio.experimental.create('dhawal', {
9 +const { mcp } = await composio.create('dhawal', {
10 toolkits: ['gmail'],
11 manageConnections: true,
12 tools: {
13 'gmail': {
14 - enabled: ['gmail_search_emails'],
14 + enable: ['gmail_search_emails'],
15 }
16 }
17 });
ts/examples/tool-router/src/openai-agents.ts
+2 -1
@@ -3,7 +3,8 @@ import { Composio } from "@composio/core";
3 import { Agent, run, hostedMcpTool } from "@openai/agents";
4 import { createInterface } from "node:readline/promises";
5
6 -const { mcp } = await new Composio().toolRouter.create("default");
6 +const composio = await new Composio()
7 +const {mcp} = await composio.create("default");
8
9 const agent = new Agent({
10 name: "Personal Assistant",
ts/examples/tool-router/src/toolkits.ts
+1 -1
@@ -2,7 +2,7 @@ import { Composio } from '@composio/core';
2
3 const composio = new Composio();
4
5 -const session = await composio.experimental.create('user_123');
5 +const session = await composio.create('user_123');
6
7 const toolkits = await session.toolkits({ toolkits: ["github"]});
8
ts/packages/core/src/composio.ts
+42 -52
@@ -151,54 +151,46 @@ export class Composio<
151 * @experimental
152 */
153 toolRouter: ToolRouter<unknown, unknown, TProvider>;
154 -
154 /**
156 - * Experimental features
155 + * Creates a new tool router session for a user.
156 + *
157 + * @param userId {string} The user id to create the session for
158 + * @param config {ToolRouterConfig} The config for the tool router session
159 + * @returns {Promise<ToolRouterSession<TToolCollection, TTool, TProvider>>} The tool router session
160 + *
161 + * @example
162 + * ```typescript
163 + * import { Composio } from '@composio/core';
164 + *
165 + * const composio = new Composio();
166 + * const userId = 'user_123';
167 + *
168 + * const session = await composio.create(userId, {
169 + * manageConnections: true,
170 + * });
171 + *
172 + * console.log(session.sessionId);
173 + * console.log(session.url);
174 + * console.log(session.tools());
175 + * ```
176 */
158 - experimental: {
159 - /**
160 - * Creates a new tool router session for a user.
161 - *
162 - * @param userId {string} The user id to create the session for
163 - * @param config {ToolRouterConfig} The config for the tool router session
164 - * @returns {Promise<ToolRouterSession<TToolCollection, TTool, TProvider>>} The tool router session
165 - *
166 - * @example
167 - * ```typescript
168 - * import { Composio } from '@composio/core';
169 - *
170 - * const composio = new Composio();
171 - * const userId = 'user_123';
172 - *
173 - * const session = await composio.create(userId, {
174 - * manageConnections: true,
175 - * });
176 - *
177 - * console.log(session.sessionId);
178 - * console.log(session.url);
179 - * console.log(session.tools());
180 - * ```
181 - */
182 - create: (
183 - userId: string,
184 - routerConfig?: ToolRouterCreateSessionConfig
185 - ) => Promise<ToolRouterSession<unknown, unknown, TProvider>>;
177 + create: (
178 + userId: string,
179 + routerConfig?: ToolRouterCreateSessionConfig
180 + ) => Promise<ToolRouterSession<unknown, unknown, TProvider>>;
181
187 - /**
188 - * Use an existing tool router session
189 - *
190 - * @param id {string} The id of the session to use
191 - * @returns {Promise<ToolRouterSession<TToolCollection, TTool, TProvider>>} The tool router session
192 - */
193 - use: (id: string) => Promise<ToolRouterSession<unknown, unknown, TProvider>>;
194 - };
182 + /**
183 + * Use an existing tool router session
184 + *
185 + * @param id {string} The id of the session to use
186 + * @returns {Promise<ToolRouterSession<TToolCollection, TTool, TProvider>>} The tool router session
187 + */
188 + use: (id: string) => Promise<ToolRouterSession<unknown, unknown, TProvider>>;
189
190 /**
197 - * Deprecated features
191 + * Experimental features
192 */
199 - deprecated: {
200 - mcp: DeprecatedMCP<TProvider>;
201 - };
193 + experimental: {};
194
195 /**
196 * Creates a new instance of the Composio SDK.
@@ -280,6 +272,14 @@ export class Composio<
272 this.files = new Files(this.client);
273 this.connectedAccounts = new ConnectedAccounts(this.client);
274 this.toolRouter = new ToolRouter(this.client, this.config);
275 + this.toolRouter.create.bind(this.toolRouter);
276 + this.toolRouter.use.bind(this.toolRouter);
277 +
278 + /**
279 + * Initialize tool router methods
280 + */
281 + this.create = this.toolRouter.create;
282 + this.use = this.toolRouter.use;
283
284 /**
285 * Initialize Experimental features
@@ -296,16 +296,6 @@ export class Composio<
296 },
297 };
298
299 - /**
300 - * Initialize Deprecated features
301 - */
302 - this.deprecated = {
303 - /**
304 - * @deprecated this feature will be removed soon, use `composio.mcp`
305 - */
306 - mcp: new DeprecatedMCP(this.client, this.provider),
307 - };
308 -
299 /**
300 * Initialize the client telemetry.
301 */