@devries-cameron20 / composio-1 / commits / 4076de404
Fork 0

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",