Composio powers 1000+ toolkits, tool search, context management, authentication, and a sandboxed workbench to help you build AI agents that turn intent into action.
TypeScript agentic-aiagentsaiai-agentsaiagentsdeveloper-toolsfunction-callinggpt-4javascriptjsllmllmopsmcppythonremote-mcp-serverssetypescript
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.pyindex 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_routerclass 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: ExperimentalNamespacedef __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@propertydef client(self):diff --git a/python/examples/tool_router/authorize.py b/python/examples/tool_router/authorize.pyindex 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.pyindex 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, ClaudeAgentOptionsimport asynciocomposio = 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.pyindex 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 MCPServerHTTPcomposio = 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.pyindex 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 ChatOpenAIimport asynciocomposio = 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.pyindex 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 Composiofrom agents import Agent, Runner, HostedMCPToolcomposio = 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.pyindex 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.pyindex 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.pyindex 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.mdindex 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:```typescriptimport { 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 propertiesconsole.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 toolkitgmail: ['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 tagsslack: { 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 toolkitstags: ['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 MCPconst 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 MCPconst 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 MCPconst 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 toolkitsconst 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 sessionconst 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) {```typescriptinterface 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.tsindex 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.tsindex 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.tsindex 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.tsindex 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.tsindex 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.tsindex 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.tsindex 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.tsindex 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.*/