Composio powers 1000+ toolkits, tool search, context management, authentication, and a sandboxed workbench to help you build AI agents that turn intent into action.
Docs: Migration, dogfooding fixes (#2287)
Sushmitha Mallesh committed
Dec 18, 2025 at 05:15 UTC
4076de40492911d7ac221cce7f5f86ea8afd86d4
6 files changed
+98
-14
fern/docs.yml
+10
@@ -329,6 +329,16 @@ navigation:
329
- page: Using as a native tool
330
path: pages/dist/tool-router/using-as-a-native-tool.mdx
331
slug: using-as-a-native-tool
332
+ - section: Resources
333
+ icon: fa-light fa-book
334
+ skip-slug: true
335
+ contents:
336
+ - section: Migration Guides
337
+ slug: migration-guide
338
+ contents:
339
+ - page: Beta to Stable Migration
340
+ path: pages/dist/tool-router/migration/tool-router-beta-to-stable.mdx
341
+ slug: tool-router/migration-guide/beta-to-stable
342
- tab: providers
343
layout:
344
- section: Supported Providers
fern/pages/src/tool-router/migration/tool-router-beta-to-stable.mdx
new
+84
@@ -0,0 +1,84 @@
1
+---
2
+title: Migration from the beta release version
3
+subtitle: Migrate from Tool Router beta to the stable version
4
+image: "https://og.composio.dev/api/og?title=Tool%20Router%20Migration"
5
+keywords: "tool router migration"
6
+hide-nav-links: false
7
+---
8
+The stable version includes improved session management, multiple configuring options, and enhanced authentication capabilities.
9
+
10
+## The basics
11
+
12
+<Steps>
13
+ <Step title="Upgrade composio package">
14
+ Upgrade to the latest stable version:
15
+ <CodeGroup>
16
+ ```bash title="Python" for="python"
17
+ pip install --upgrade composio
18
+ ```
19
+ ```bash title="TypeScript" for="typescript"
20
+ npm install @composio/core@latest
21
+ ```
22
+ </CodeGroup>
23
+ </Step>
24
+ <Step title="Update session creation">
25
+ <CodeGroup>
26
+ ```python title="Python" for="python"
27
+ # Beta (before)
28
+ session = composio.experimental.tool_router.create_session(
29
+ user_id="user@example.com"
30
+ )
31
+
32
+ # Stable (after)
33
+ session = composio.create(
34
+ user_id="user@example.com"
35
+ )
36
+ ```
37
+ ```typescript title="TypeScript" for="typescript"
38
+ // Beta (before)
39
+ const session = await composio.experimental.toolRouter.createSession('user_123');
40
+
41
+ // Stable (after)
42
+ const session = await composio.create('user_123');
43
+ ```
44
+ </CodeGroup>
45
+ </Step>
46
+ <Step title="Moving users (optional)">
47
+ If you have existing users on tool router and you don't want them to authenticate again:
48
+ - Search for the Auth config created by Tool Router for that connected account. See [Connected Accounts](/docs/connected-accounts) to fetch existing accounts programmatically.
49
+ - While creating a session configure to use this Auth config.
50
+ - You need to repeat this for each toolkit you want to enable for that session.
51
+ <CodeGroup>
52
+ ```python title="Python" for="python"
53
+ session = composio.create(
54
+ user_id="user_123",
55
+ auth_configs={
56
+ "github": "ac_your_github_config",
57
+ "slack": "ac_your_slack_config"
58
+ }
59
+ )
60
+ ```
61
+ ```typescript title="TypeScript" for="typescript"
62
+ const session = await composio.create('user_123',
63
+ {
64
+ authConfigs: {
65
+ github: "ac_your_github_config",
66
+ slack: "ac_your_slack_config",
67
+ },
68
+ }
69
+ );
70
+ ```
71
+ </CodeGroup>
72
+ </Step>
73
+ <Step title="Explore new capabilities">
74
+ Check out these new features available in the stable version:
75
+
76
+ - **[Native tools](/tool-router/using-as-a-native-tool)**: Use Tool Router with any AI framework
77
+ - **Better [session](/tool-router/users-and-sessions) and [auth](/tool-router/authentication) config**
78
+ - **[Multi-account support](/tool-router/managing-multiple-accounts)**: Manage multiple accounts per user seamlessly
79
+ - **[Manual authentication](/tool-router/manually-authenticating-users)**: Control when and how users authenticate
80
+ - **[Custom auth](/tool-router/using-custom-auth-configs)**: Support for toolkits that don't have composio managed auth
81
+ - **[White labeling](/tool-router/white-labeling-authentication)**: Customize authentication screens with your branding
82
+ </Step>
83
+</Steps>
84
+
fern/snippets/tool-router/python/mcp-openai.py
+1
-4
@@ -22,10 +22,7 @@ agent = Agent(
22
"You are a helpful assistant with access to external tools. "
23
"Always use the available tools to complete user requests instead of just explaining how to do them."
24
),
25
- model="gpt-5.1",
26
- model_settings=ModelSettings(
27
- reasoning={"effort": "low"},
28
- ),
25
+ model="gpt-5.2",
26
tools=[
27
HostedMCPTool(
28
tool_config={
fern/snippets/tool-router/python/quickstart-mcp-openai.py
+1
-4
@@ -15,10 +15,7 @@ session = composio.create(user_id=user_id)
15
agent = Agent(
16
name="Personal Assistant",
17
instructions="You are a helpful personal assistant. Use Composio tools to take action.",
18
- model="gpt-5.1",
19
- model_settings= ModelSettings(
20
- reasoning={"effort": "low"},
21
- ),
18
+ model="gpt-5.2",
19
tools=[
20
HostedMCPTool(
21
tool_config={
fern/snippets/tool-router/typescript/mcp-openai.ts
+1
-2
@@ -15,8 +15,7 @@ const agent = new Agent({
15
instructions:
16
"You are a helpful assistant with access to external tools. " +
17
"Always use the available tools to complete user requests instead of just explaining how to do them.",
18
- model: "gpt-5.1",
19
- modelSettings: { reasoning: { effort: "low" } },
18
+ model: "gpt-5.2",
19
tools: [
20
hostedMcpTool({
21
serverLabel: "composio",
fern/snippets/tool-router/typescript/quickstart-mcp-openai.ts
+1
-4
@@ -12,10 +12,7 @@ const { mcp } = await composio.create(userId);
12
const agent = new Agent({
13
name: "Personal Assistant",
14
instructions: "You are a helpful personal assistant. Use Composio tools to take action.",
15
- model: "gpt-5.1",
16
- modelSettings: {
17
- reasoning: { effort: "low" },
18
- },
15
+ model: "gpt-5.2",
16
tools: [
17
hostedMcpTool({
18
serverLabel: "composio",