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.

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

Musthaq Ahamada550aeb289cb
diff --git a/python/composio/sdk.py b/python/composio/sdk.py
index d714ae565..cf1217e93 100644
--- a/python/composio/sdk.py
+++ b/python/composio/sdk.py
@@ -37,17 +37,16 @@ class SDKConfig(te.TypedDict):
toolkit_versions: te.NotRequired[ToolkitVersionParam]
-class ExperimentalNamespace:
- """Namespace for experimental Composio features."""
+# class ExperimentalNamespace:
+# """Namespace for experimental Composio features."""
- def __init__(self, tool_router: ToolRouter):
- """
- Initialize experimental namespace.
+# def __init__(self, tool_router: ToolRouter):
+# """
+# Initialize experimental namespace.
- :param tool_router: Experimental ToolRouter instance
- """
- self.create = tool_router.create
- self.use = tool_router.use
+# :param tool_router: Experimental ToolRouter instance
+# """
+# self.tool_router = tool_router
class Composio(t.Generic[TProvider], WithLogger):
@@ -57,7 +56,7 @@ class Composio(t.Generic[TProvider], WithLogger):
tools: Tools[TProvider]
tool_router: ToolRouter[TProvider]
- experimental: ExperimentalNamespace
+ # experimental: ExperimentalNamespace
def __init__(
self,
@@ -102,20 +101,20 @@ class Composio(t.Generic[TProvider], WithLogger):
file_download_dir=kwargs.get("file_download_dir"),
toolkit_versions=toolkit_versions,
)
- self.tool_router = ToolRouter(
- client=self._client,
- provider=self.provider,
- )
+
self.toolkits = Toolkits(client=self._client)
self.triggers = Triggers(client=self._client, toolkit_versions=toolkit_versions)
self.auth_configs = AuthConfigs(client=self._client)
self.connected_accounts = ConnectedAccounts(client=self._client)
self.mcp = MCP(client=self._client)
- # Initialize experimental features
- self.experimental = ExperimentalNamespace(
- tool_router=self.tool_router,
+ # initialize tool router methods
+ self.tool_router = ToolRouter(
+ client=self._client,
+ provider=self.provider,
)
+ self.create = self.tool_router.create
+ self.use = self.tool_router.use
@property
def client(self):
diff --git a/python/examples/tool_router/authorize.py b/python/examples/tool_router/authorize.py
index 4aa8039b7..19659ff6c 100644
--- a/python/examples/tool_router/authorize.py
+++ b/python/examples/tool_router/authorize.py
@@ -19,7 +19,7 @@ if not api_key:
composio = Composio(api_key=api_key)
# Create a tool router session
-session = composio.tool_router.create(
+session = composio.create(
user_id="user_123",
toolkits=["github", "gmail"],
)
diff --git a/python/examples/tool_router/claude_agent.py b/python/examples/tool_router/claude_agent.py
index 3ef212f28..a635aa35e 100644
--- a/python/examples/tool_router/claude_agent.py
+++ b/python/examples/tool_router/claude_agent.py
@@ -3,7 +3,7 @@ from claude_agent_sdk import query, ClaudeAgentOptions
import asyncio
composio = Composio()
-session = composio.experimental.create(
+session = composio.create(
user_id="user_123",
)
diff --git a/python/examples/tool_router/crewai_agent.py b/python/examples/tool_router/crewai_agent.py
index 61ce5ace3..e671e8b6c 100644
--- a/python/examples/tool_router/crewai_agent.py
+++ b/python/examples/tool_router/crewai_agent.py
@@ -4,7 +4,7 @@ from crewai.mcp import MCPServerHTTP
composio = Composio()
-session = composio.experimental.create(
+session = composio.create(
user_id="user_123",
)
diff --git a/python/examples/tool_router/langchain_agent.py b/python/examples/tool_router/langchain_agent.py
index 894670020..81b37bcf1 100644
--- a/python/examples/tool_router/langchain_agent.py
+++ b/python/examples/tool_router/langchain_agent.py
@@ -5,7 +5,7 @@ from langchain_openai.chat_models import ChatOpenAI
import asyncio
composio = Composio()
-session = composio.experimental.create(
+session = composio.create(
user_id="user_123",
)
diff --git a/python/examples/tool_router/openai_agents.py b/python/examples/tool_router/openai_agents.py
index 733e63766..72153aa05 100644
--- a/python/examples/tool_router/openai_agents.py
+++ b/python/examples/tool_router/openai_agents.py
@@ -2,7 +2,7 @@ from composio import Composio
from agents import Agent, Runner, HostedMCPTool
composio = Composio()
-session = composio.experimental.create(
+session = composio.create(
user_id="user_123",
)
diff --git a/python/examples/tool_router/tool_router_mcp.py b/python/examples/tool_router/tool_router_mcp.py
index 3d4b39d30..66a9c7ddf 100644
--- a/python/examples/tool_router/tool_router_mcp.py
+++ b/python/examples/tool_router/tool_router_mcp.py
@@ -25,7 +25,7 @@ async def main():
composio = Composio(api_key=api_key, provider=OpenAIAgentsProvider())
# Create a tool router session
- session = composio.tool_router.create(
+ session = composio.create(
user_id="user_123",
toolkits=["github", "gmail"],
)
diff --git a/python/examples/tool_router/toolkits.py b/python/examples/tool_router/toolkits.py
index 22818d82f..a87b470af 100644
--- a/python/examples/tool_router/toolkits.py
+++ b/python/examples/tool_router/toolkits.py
@@ -11,7 +11,7 @@ composio = Composio()
# Create a tool router session
# When manage_connections is enabled, tools for managing connections are included
-session = composio.tool_router.create(
+session = composio.create(
user_id="pg-test-37ee710c-d5be-4775-91f2-a8e06b937d9b",
manage_connections=True,
)
diff --git a/python/examples/tool_router/tools.py b/python/examples/tool_router/tools.py
index 1c61826b7..823bb75d1 100644
--- a/python/examples/tool_router/tools.py
+++ b/python/examples/tool_router/tools.py
@@ -19,7 +19,7 @@ async def main():
# Create a tool router session for a specific user
# This creates an isolated session with tools for the specified toolkits
- session = composio.tool_router.create(
+ session = composio.create(
user_id="user_123",
toolkits=["gmail"],
)
diff --git a/ts/docs/api/tool-router.md b/ts/docs/api/tool-router.md
index 9d1b012fb..2451e9015 100644
--- a/ts/docs/api/tool-router.md
+++ b/ts/docs/api/tool-router.md
@@ -39,7 +39,7 @@ import { Composio } from '@composio/core';
const composio = new Composio();
// Create a session for a user with access to Gmail tools
-const session = await composio.experimental.create('user_123', {
+const session = await composio.create('user_123', {
toolkits: ['gmail']
});
@@ -60,7 +60,7 @@ const composio = new Composio({
});
// Create a session for a user with access to Gmail tools
-const session = await composio.experimental.create('user_123', {
+const session = await composio.create('user_123', {
toolkits: ['gmail']
});
@@ -72,7 +72,7 @@ const tools = await session.tools();
### Basic Session Creation
-Use `composio.experimental.create()` to create a new Tool Router session:
+Use `composio.create()` to create a new Tool Router session:
```typescript
import { Composio } from '@composio/core';
@@ -80,7 +80,7 @@ import { Composio } from '@composio/core';
const composio = new Composio();
// Create a session with Gmail access
-const session = await composio.experimental.create('user_123', {
+const session = await composio.create('user_123', {
toolkits: ['gmail']
});
@@ -90,10 +90,10 @@ console.log('MCP URL:', session.mcp.url);
### Using an Existing Session
-If you have an existing session ID, you can retrieve it using `composio.toolRouter.use()`:
+If you have an existing session ID, you can retrieve it using `composio.use()`:
```typescript
-const session = await composio.toolRouter.use('existing_session_id');
+const session = await composio.use('existing_session_id');
// Access session properties
console.log(session.sessionId);
@@ -110,18 +110,18 @@ Specify which toolkits to enable or disable in the session.
```typescript
// Simple array of toolkit slugs to enable
-const session = await composio.experimental.create('user_123', {
+const session = await composio.create('user_123', {
toolkits: ['gmail', 'slack', 'github']
});
// Explicit enabled configuration
-const session = await composio.experimental.create('user_123', {
- toolkits: { enabled: ['gmail', 'slack'] }
+const session = await composio.create('user_123', {
+ toolkits: { enable: ['gmail', 'slack'] }
});
// Disable specific toolkits (enable all others)
-const session = await composio.experimental.create('user_123', {
- toolkits: { disabled: ['calendar'] }
+const session = await composio.create('user_123', {
+ toolkits: { disable: ['calendar'] }
});
```
@@ -130,14 +130,14 @@ const session = await composio.experimental.create('user_123', {
Fine-grained control over which tools are available within toolkits. Configure tools per toolkit using the toolkit slug as the key.
```typescript
-const session = await composio.experimental.create('user_123', {
+const session = await composio.create('user_123', {
toolkits: ['gmail', 'slack'],
tools: {
// Configure tools per toolkit
gmail: ['gmail_fetch_emails', 'gmail_send_email'], // Only these tools
- // OR use enabled/disabled objects
- // gmail: { enabled: ['gmail_fetch_emails'] }
- // gmail: { disabled: ['gmail_delete_email'] }
+ // OR use enable/disable objects
+ // gmail: { enable: ['gmail_fetch_emails'] }
+ // gmail: { disable: ['gmail_delete_email'] }
// You can also set tags per toolkit to override global tags
slack: { tags: ['readOnlyHint'] }
@@ -150,7 +150,7 @@ const session = await composio.experimental.create('user_123', {
Global tags to filter tools by their behavior hints. Tags can be overridden per toolkit in the `tools` configuration.
```typescript
-const session = await composio.experimental.create('user_123', {
+const session = await composio.create('user_123', {
toolkits: ['gmail', 'github'],
// Global tags applied to all toolkits
tags: ['readOnlyHint', 'idempotentHint']
@@ -167,7 +167,7 @@ Available tags:
Map toolkits to specific authentication configurations:
```typescript
-const session = await composio.experimental.create('user_123', {
+const session = await composio.create('user_123', {
toolkits: ['gmail', 'github'],
authConfigs: {
gmail: 'ac_gmail_work',
@@ -181,7 +181,7 @@ const session = await composio.experimental.create('user_123', {
Map toolkits to specific connected account IDs:
```typescript
-const session = await composio.experimental.create('user_123', {
+const session = await composio.create('user_123', {
toolkits: ['gmail'],
connectedAccounts: {
gmail: 'ca_abc123'
@@ -195,16 +195,16 @@ Control how connections are managed within the session:
```typescript
// Boolean: enable/disable automatic connection management
-const session = await composio.experimental.create('user_123', {
+const session = await composio.create('user_123', {
toolkits: ['gmail'],
manageConnections: true // default
});
// Object: fine-grained control
-const session = await composio.experimental.create('user_123', {
+const session = await composio.create('user_123', {
toolkits: ['gmail'],
manageConnections: {
- enabled: true,
+ enable: true,
callbackUrl: 'https://your-app.com/auth/callback'
}
});
@@ -215,10 +215,10 @@ const session = await composio.experimental.create('user_123', {
Configure workbench behavior for tool execution:
```typescript
-const session = await composio.experimental.create('user_123', {
+const session = await composio.create('user_123', {
toolkits: ['gmail'],
workbench: {
- proxyExecutionEnabled: true,
+ enableProxyExecution: true,
autoOffloadThreshold: 400000 // Automatically offload to workbench if response > 400k characters
}
});
@@ -332,7 +332,7 @@ const composio = new Composio({
provider: new VercelProvider(),
});
-const session = await composio.experimental.create('user_123', {
+const session = await composio.create('user_123', {
toolkits: ['gmail']
});
@@ -362,12 +362,12 @@ import { stepCountIs, streamText } from 'ai';
// No provider needed when using MCP
const composio = new Composio();
-const { mcp } = await composio.experimental.create('user_123', {
+const { mcp } = await composio.create('user_123', {
toolkits: ['gmail'],
manageConnections: true,
tools: {
gmail: {
- disabled: ['gmail_send_email'], // Disable specific tools
+ disable: ['gmail_send_email'], // Disable specific tools
}
}
});
@@ -419,7 +419,7 @@ const llm = new ChatOpenAI({
model: "gpt-4o",
});
-const session = await composio.experimental.create('user_123', {
+const session = await composio.create('user_123', {
toolkits: ['gmail']
});
@@ -458,7 +458,7 @@ import { Composio } from '@composio/core';
// No provider needed when using MCP
const composio = new Composio();
-const session = await composio.experimental.create('user_123', {
+const session = await composio.create('user_123', {
toolkits: ['gmail']
});
@@ -501,7 +501,7 @@ import { Composio } from '@composio/core';
// No provider needed when using MCP
const composio = new Composio();
-const session = await composio.experimental.create('user_123', {
+const session = await composio.create('user_123', {
toolkits: ['gmail']
});
@@ -535,7 +535,7 @@ When a user needs to connect a toolkit, use the `authorize()` method:
import { Composio } from '@composio/core';
const composio = new Composio();
-const session = await composio.experimental.create('user_123', {
+const session = await composio.create('user_123', {
toolkits: ['gmail']
});
@@ -566,7 +566,7 @@ Use the `toolkits()` method to check connection states:
import { Composio } from '@composio/core';
const composio = new Composio();
-const session = await composio.experimental.create('user_123');
+const session = await composio.create('user_123');
// Get all toolkits
const toolkits = await session.toolkits();
@@ -643,13 +643,13 @@ const tools = await session.tools(modifiers);
```typescript
// Store session ID after creation
-const session = await composio.experimental.create('user_123', config);
+const session = await composio.create('user_123', config);
await redis.set(`session:user_123`, session.sessionId);
// Retrieve existing session
const sessionId = await redis.get(`session:user_123`);
if (sessionId) {
- const session = await composio.toolRouter.use(sessionId);
+ const session = await composio.use(sessionId);
}
```
@@ -659,22 +659,22 @@ if (sessionId) {
```typescript
interface ToolRouterCreateSessionConfig {
- toolkits?: string[] | { enabled: string[] } | { disabled: string[] };
+ toolkits?: string[] | { enable: string[] } | { disable: string[] };
tools?: Record<string,
string[] |
- { enabled: string[] } |
- { disabled: string[] } |
+ { enable: string[] } |
+ { disable: string[] } |
{ tags: ('readOnlyHint' | 'destructiveHint' | 'idempotentHint')[] }
>;
tags?: ('readOnlyHint' | 'destructiveHint' | 'idempotentHint')[];
authConfigs?: Record<string, string>;
connectedAccounts?: Record<string, string>;
manageConnections?: boolean | {
- enabled?: boolean;
+ enable?: boolean;
callbackUrl?: string;
};
workbench?: {
- proxyExecutionEnabled?: boolean;
+ enableProxyExecution?: boolean;
autoOffloadThreshold?: number;
};
}
diff --git a/ts/examples/tool-router/src/authorize.ts b/ts/examples/tool-router/src/authorize.ts
index e4644c566..f14d33b0e 100644
--- a/ts/examples/tool-router/src/authorize.ts
+++ b/ts/examples/tool-router/src/authorize.ts
@@ -1,7 +1,7 @@
import { Composio } from '@composio/core';
const composio = new Composio();
-const session = await composio.experimental.create('user_123', { toolkits: ['gmail'] });
+const session = await composio.create('user_123', { toolkits: ['gmail'] });
const connectionRequest = await session.authorize("gmail");
console.log(connectionRequest);
diff --git a/ts/examples/tool-router/src/claude-agents-sdk.ts b/ts/examples/tool-router/src/claude-agents-sdk.ts
index 0453a3787..bf7739150 100644
--- a/ts/examples/tool-router/src/claude-agents-sdk.ts
+++ b/ts/examples/tool-router/src/claude-agents-sdk.ts
@@ -4,7 +4,7 @@ import 'dotenv/config';
const composio = new Composio();
-const session = await composio.experimental.create('user_123', { toolkits: ['gmail'] });
+const session = await composio.create('user_123', { toolkits: ['gmail'] });
const stream = await query({
prompt: 'Use composio tools to fetch my last email from gmail',
diff --git a/ts/examples/tool-router/src/index.ts b/ts/examples/tool-router/src/index.ts
index 0bd173946..df109c4b2 100644
--- a/ts/examples/tool-router/src/index.ts
+++ b/ts/examples/tool-router/src/index.ts
@@ -7,7 +7,7 @@ import { modifiers } from './logger';
const composio = new Composio({
provider: new VercelProvider(),
});
-const session = await composio.experimental.create('user_123', { toolkits: ['gmail'] });
+const session = await composio.create('user_123', { toolkits: ['gmail'] });
const tools = await session.tools(modifiers);
diff --git a/ts/examples/tool-router/src/langchain.ts b/ts/examples/tool-router/src/langchain.ts
index 77a81482c..0fed09909 100644
--- a/ts/examples/tool-router/src/langchain.ts
+++ b/ts/examples/tool-router/src/langchain.ts
@@ -12,7 +12,7 @@ const llm = new ChatOpenAI({
})
async function main() {
- const session = await composio.experimental.create('user_123', { toolkits: ['gmail'] });
+ const session = await composio.create('user_123', { toolkits: ['gmail'] });
const client = new MultiServerMCPClient({
math: {
diff --git a/ts/examples/tool-router/src/mcp.ts b/ts/examples/tool-router/src/mcp.ts
index 0947100f1..22adcbf61 100644
--- a/ts/examples/tool-router/src/mcp.ts
+++ b/ts/examples/tool-router/src/mcp.ts
@@ -6,12 +6,12 @@ import ora from 'ora';
const composio = new Composio();
const trProgress = ora("Creating tool router session...").start();
-const { mcp } = await composio.experimental.create('dhawal', {
+const { mcp } = await composio.create('dhawal', {
toolkits: ['gmail'],
manageConnections: true,
tools: {
'gmail': {
- enabled: ['gmail_search_emails'],
+ enable: ['gmail_search_emails'],
}
}
});
diff --git a/ts/examples/tool-router/src/openai-agents.ts b/ts/examples/tool-router/src/openai-agents.ts
index e2ccee3fe..fc6159697 100644
--- a/ts/examples/tool-router/src/openai-agents.ts
+++ b/ts/examples/tool-router/src/openai-agents.ts
@@ -3,7 +3,8 @@ import { Composio } from "@composio/core";
import { Agent, run, hostedMcpTool } from "@openai/agents";
import { createInterface } from "node:readline/promises";
-const { mcp } = await new Composio().toolRouter.create("default");
+const composio = await new Composio()
+const {mcp} = await composio.create("default");
const agent = new Agent({
name: "Personal Assistant",
diff --git a/ts/examples/tool-router/src/toolkits.ts b/ts/examples/tool-router/src/toolkits.ts
index 2eec42b95..ea853f7a5 100644
--- a/ts/examples/tool-router/src/toolkits.ts
+++ b/ts/examples/tool-router/src/toolkits.ts
@@ -2,7 +2,7 @@ import { Composio } from '@composio/core';
const composio = new Composio();
-const session = await composio.experimental.create('user_123');
+const session = await composio.create('user_123');
const toolkits = await session.toolkits({ toolkits: ["github"]});
diff --git a/ts/packages/core/src/composio.ts b/ts/packages/core/src/composio.ts
index 690682bcd..ec81b2e92 100644
--- a/ts/packages/core/src/composio.ts
+++ b/ts/packages/core/src/composio.ts
@@ -151,54 +151,46 @@ export class Composio<
* @experimental
*/
toolRouter: ToolRouter<unknown, unknown, TProvider>;
-
/**
- * Experimental features
+ * Creates a new tool router session for a user.
+ *
+ * @param userId {string} The user id to create the session for
+ * @param config {ToolRouterConfig} The config for the tool router session
+ * @returns {Promise<ToolRouterSession<TToolCollection, TTool, TProvider>>} The tool router session
+ *
+ * @example
+ * ```typescript
+ * import { Composio } from '@composio/core';
+ *
+ * const composio = new Composio();
+ * const userId = 'user_123';
+ *
+ * const session = await composio.create(userId, {
+ * manageConnections: true,
+ * });
+ *
+ * console.log(session.sessionId);
+ * console.log(session.url);
+ * console.log(session.tools());
+ * ```
*/
- experimental: {
- /**
- * Creates a new tool router session for a user.
- *
- * @param userId {string} The user id to create the session for
- * @param config {ToolRouterConfig} The config for the tool router session
- * @returns {Promise<ToolRouterSession<TToolCollection, TTool, TProvider>>} The tool router session
- *
- * @example
- * ```typescript
- * import { Composio } from '@composio/core';
- *
- * const composio = new Composio();
- * const userId = 'user_123';
- *
- * const session = await composio.create(userId, {
- * manageConnections: true,
- * });
- *
- * console.log(session.sessionId);
- * console.log(session.url);
- * console.log(session.tools());
- * ```
- */
- create: (
- userId: string,
- routerConfig?: ToolRouterCreateSessionConfig
- ) => Promise<ToolRouterSession<unknown, unknown, TProvider>>;
+ create: (
+ userId: string,
+ routerConfig?: ToolRouterCreateSessionConfig
+ ) => Promise<ToolRouterSession<unknown, unknown, TProvider>>;
- /**
- * Use an existing tool router session
- *
- * @param id {string} The id of the session to use
- * @returns {Promise<ToolRouterSession<TToolCollection, TTool, TProvider>>} The tool router session
- */
- use: (id: string) => Promise<ToolRouterSession<unknown, unknown, TProvider>>;
- };
+ /**
+ * Use an existing tool router session
+ *
+ * @param id {string} The id of the session to use
+ * @returns {Promise<ToolRouterSession<TToolCollection, TTool, TProvider>>} The tool router session
+ */
+ use: (id: string) => Promise<ToolRouterSession<unknown, unknown, TProvider>>;
/**
- * Deprecated features
+ * Experimental features
*/
- deprecated: {
- mcp: DeprecatedMCP<TProvider>;
- };
+ experimental: {};
/**
* Creates a new instance of the Composio SDK.
@@ -280,6 +272,14 @@ export class Composio<
this.files = new Files(this.client);
this.connectedAccounts = new ConnectedAccounts(this.client);
this.toolRouter = new ToolRouter(this.client, this.config);
+ this.toolRouter.create.bind(this.toolRouter);
+ this.toolRouter.use.bind(this.toolRouter);
+
+ /**
+ * Initialize tool router methods
+ */
+ this.create = this.toolRouter.create;
+ this.use = this.toolRouter.use;
/**
* Initialize Experimental features
@@ -296,16 +296,6 @@ export class Composio<
},
};
- /**
- * Initialize Deprecated features
- */
- this.deprecated = {
- /**
- * @deprecated this feature will be removed soon, use `composio.mcp`
- */
- mcp: new DeprecatedMCP(this.client, this.provider),
- };
-
/**
* Initialize the client telemetry.
*/