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
Docs: Migration, dogfooding fixes (#2287)
Sushmitha Mallesh4076de404929
diff --git a/fern/docs.yml b/fern/docs.ymlindex 6fe3a33f6..5647a702d 100644--- a/fern/docs.yml+++ b/fern/docs.yml@@ -329,6 +329,16 @@ navigation:- page: Using as a native toolpath: pages/dist/tool-router/using-as-a-native-tool.mdxslug: using-as-a-native-tool+ - section: Resources+ icon: fa-light fa-book+ skip-slug: true+ contents:+ - section: Migration Guides+ slug: migration-guide+ contents:+ - page: Beta to Stable Migration+ path: pages/dist/tool-router/migration/tool-router-beta-to-stable.mdx+ slug: tool-router/migration-guide/beta-to-stable- tab: providerslayout:- section: Supported Providersdiff --git a/fern/pages/src/tool-router/migration/tool-router-beta-to-stable.mdx b/fern/pages/src/tool-router/migration/tool-router-beta-to-stable.mdxnew file mode 100644index 000000000..8c7683133--- /dev/null+++ b/fern/pages/src/tool-router/migration/tool-router-beta-to-stable.mdx@@ -0,0 +1,84 @@+---+title: Migration from the beta release version+subtitle: Migrate from Tool Router beta to the stable version+image: "https://og.composio.dev/api/og?title=Tool%20Router%20Migration"+keywords: "tool router migration"+hide-nav-links: false+---+The stable version includes improved session management, multiple configuring options, and enhanced authentication capabilities.++## The basics++<Steps>+ <Step title="Upgrade composio package">+ Upgrade to the latest stable version:+ <CodeGroup>+ ```bash title="Python" for="python"+ pip install --upgrade composio+ ```+ ```bash title="TypeScript" for="typescript"+ npm install @composio/core@latest+ ```+ </CodeGroup>+ </Step>+ <Step title="Update session creation">+ <CodeGroup>+ ```python title="Python" for="python"+ # Beta (before)+ session = composio.experimental.tool_router.create_session(+ user_id="[email protected]"+ )++ # Stable (after)+ session = composio.create(+ user_id="[email protected]"+ )+ ```+ ```typescript title="TypeScript" for="typescript"+ // Beta (before)+ const session = await composio.experimental.toolRouter.createSession('user_123');++ // Stable (after)+ const session = await composio.create('user_123');+ ```+ </CodeGroup>+ </Step>+ <Step title="Moving users (optional)">+ If you have existing users on tool router and you don't want them to authenticate again:+ - Search for the Auth config created by Tool Router for that connected account. See [Connected Accounts](/docs/connected-accounts) to fetch existing accounts programmatically.+ - While creating a session configure to use this Auth config.+ - You need to repeat this for each toolkit you want to enable for that session.+ <CodeGroup>+ ```python title="Python" for="python"+ session = composio.create(+ user_id="user_123",+ auth_configs={+ "github": "ac_your_github_config",+ "slack": "ac_your_slack_config"+ }+ )+ ```+ ```typescript title="TypeScript" for="typescript"+ const session = await composio.create('user_123',+ {+ authConfigs: {+ github: "ac_your_github_config",+ slack: "ac_your_slack_config",+ },+ }+ );+ ```+ </CodeGroup>+ </Step>+ <Step title="Explore new capabilities">+ Check out these new features available in the stable version:++ - **[Native tools](/tool-router/using-as-a-native-tool)**: Use Tool Router with any AI framework+ - **Better [session](/tool-router/users-and-sessions) and [auth](/tool-router/authentication) config**+ - **[Multi-account support](/tool-router/managing-multiple-accounts)**: Manage multiple accounts per user seamlessly+ - **[Manual authentication](/tool-router/manually-authenticating-users)**: Control when and how users authenticate+ - **[Custom auth](/tool-router/using-custom-auth-configs)**: Support for toolkits that don't have composio managed auth+ - **[White labeling](/tool-router/white-labeling-authentication)**: Customize authentication screens with your branding+ </Step>+</Steps>+diff --git a/fern/snippets/tool-router/python/mcp-openai.py b/fern/snippets/tool-router/python/mcp-openai.pyindex e3596b612..c68472bd5 100644--- a/fern/snippets/tool-router/python/mcp-openai.py+++ b/fern/snippets/tool-router/python/mcp-openai.py@@ -22,10 +22,7 @@ agent = Agent("You are a helpful assistant with access to external tools. ""Always use the available tools to complete user requests instead of just explaining how to do them."),- model="gpt-5.1",- model_settings=ModelSettings(- reasoning={"effort": "low"},- ),+ model="gpt-5.2",tools=[HostedMCPTool(tool_config={diff --git a/fern/snippets/tool-router/python/quickstart-mcp-openai.py b/fern/snippets/tool-router/python/quickstart-mcp-openai.pyindex 53435135e..d02a8b222 100644--- a/fern/snippets/tool-router/python/quickstart-mcp-openai.py+++ b/fern/snippets/tool-router/python/quickstart-mcp-openai.py@@ -15,10 +15,7 @@ session = composio.create(user_id=user_id)agent = Agent(name="Personal Assistant",instructions="You are a helpful personal assistant. Use Composio tools to take action.",- model="gpt-5.1",- model_settings= ModelSettings(- reasoning={"effort": "low"},- ),+ model="gpt-5.2",tools=[HostedMCPTool(tool_config={diff --git a/fern/snippets/tool-router/typescript/mcp-openai.ts b/fern/snippets/tool-router/typescript/mcp-openai.tsindex f2082daea..8d1661849 100644--- a/fern/snippets/tool-router/typescript/mcp-openai.ts+++ b/fern/snippets/tool-router/typescript/mcp-openai.ts@@ -15,8 +15,7 @@ const agent = new Agent({instructions:"You are a helpful assistant with access to external tools. " +"Always use the available tools to complete user requests instead of just explaining how to do them.",- model: "gpt-5.1",- modelSettings: { reasoning: { effort: "low" } },+ model: "gpt-5.2",tools: [hostedMcpTool({serverLabel: "composio",diff --git a/fern/snippets/tool-router/typescript/quickstart-mcp-openai.ts b/fern/snippets/tool-router/typescript/quickstart-mcp-openai.tsindex 2a2232118..8ac06aeb3 100644--- a/fern/snippets/tool-router/typescript/quickstart-mcp-openai.ts+++ b/fern/snippets/tool-router/typescript/quickstart-mcp-openai.ts@@ -12,10 +12,7 @@ const { mcp } = await composio.create(userId);const agent = new Agent({name: "Personal Assistant",instructions: "You are a helpful personal assistant. Use Composio tools to take action.",- model: "gpt-5.1",- modelSettings: {- reasoning: { effort: "low" },- },+ model: "gpt-5.2",tools: [hostedMcpTool({serverLabel: "composio",