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
*/