@devries-cameron20 / composio-1 / commits / 0f3f5c72c
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.

Restore original tool-router-beta migration guide content

Sushmithamallesh committed Jan 22, 2026 at 11:34 UTC 0f3f5c72c89eea9f315807f90ca53295b85dcb5e
2 files changed +96 -22
docs/content/docs/index.mdx
+1 -1
@@ -80,7 +80,7 @@ Composio works with any AI framework. Pick your preferred SDK:
80 <ProviderCard name="LlamaIndex" href="/docs/providers/llamaindex" logo="/images/providers/llamaIndex-logo.svg" languages={["Python", "TypeScript"]} />
81 <ProviderCard name="OpenAI Agents" href="/docs/providers/openai-agents" logo="/images/providers/openai-logo.svg" logoDark="/images/providers/openai-logo-dark.svg" languages={["Python"]} />
82 <ProviderCard name="CrewAI" href="/docs/providers/crewai" logo="/images/providers/crewai-logo.svg" languages={["Python"]} />
83 - <ProviderCard name="Mastra" href="/docs/providers/mastra" logo="/images/providers/mastra-logo.svg" languages={["TypeScript"]} />
83 + <ProviderCard name="Mastra" href="/docs/providers/mastra" logo="/images/providers/mastra-logo.svg" logoDark="/images/providers/mastra-logo-dark.svg" languages={["TypeScript"]} />
84 <ProviderCard name="Build your own" href="/docs/providers/custom-providers" icon={<Blocks size={32} />} languages={["Python", "TypeScript"]} />
85 </ProviderGrid>
86
docs/content/docs/migration-guide/tool-router-beta.mdx
+95 -21
@@ -1,39 +1,113 @@
1 ---
2 -title: Tool Router Beta to Stable Migration
3 -description: Migrate from Tool Router Beta to the stable release
2 +title: Beta to Stable Migration
3 +description: Migrate from Tool Router beta to the stable version
4 +keywords: [upgrade, migrate, experimental, beta]
5 ---
6
6 -This guide helps you migrate from the Tool Router Beta to the stable release.
7 +The stable version includes improved session management, multiple configuring options, and enhanced authentication capabilities.
8
8 -## Breaking changes
9 +## The basics
10
10 -### Session creation
11 +<Steps>
12 +<Step>
13 +### Upgrade composio package
14
12 -The `create` method now accepts a user ID directly instead of an options object:
15 +Upgrade to the latest stable version:
16
17 +<Tabs groupId="language" items={['Python', 'TypeScript']} persist>
18 +<Tab value="Python">
19 +```bash
20 +pip install --upgrade composio
21 +```
22 +</Tab>
23 +<Tab value="TypeScript">
24 +```bash
25 +npm install @composio/core@latest
26 +```
27 +</Tab>
28 +</Tabs>
29 +</Step>
30 +
31 +<Step>
32 +### Update session creation
33 +
34 +<Tabs groupId="language" items={['Python', 'TypeScript']} persist>
35 +<Tab value="Python">
36 +```python
37 +# Beta (before)
38 +session = composio.experimental.tool_router.create_session(
39 + user_id="user@example.com"
40 +)
41 +
42 +# Stable (after)
43 +session = composio.create(
44 + user_id="user@example.com"
45 +)
46 +```
47 +</Tab>
48 +<Tab value="TypeScript">
49 ```typescript
15 -// Before (Beta)
16 -const session = await composio.create({ userId: 'user_123' });
50 +// @noErrors
51 +// Beta (before)
52 +const session = await composio.experimental.toolRouter.createSession('user_123');
53
18 -// After (Stable)
54 +// Stable (after)
55 const session = await composio.create('user_123');
56 ```
57 +</Tab>
58 +</Tabs>
59 +</Step>
60
22 -### Tool fetching
61 +<Step>
62 +### Moving users (optional)
63
24 -Tools are now fetched from the session object:
64 +If you have existing users on tool router and you don't want them to authenticate again:
65 +- Tool Router will auto-detect auth configs and connected accounts it created (from the beta version).
66 +- If you have custom auth configs (not created by Tool Router):
67 + - Search for the Auth config for that connected account. See [Connected Accounts](/docs/connected-accounts) to fetch existing accounts programmatically.
68 + - While creating a session configure to use this Auth config.
69 + - You need to repeat this for each toolkit you want to enable for that session.
70
71 +<Tabs groupId="language" items={['Python', 'TypeScript']} persist>
72 +<Tab value="Python">
73 +```python
74 +session = composio.create(
75 + user_id="user_123",
76 + auth_configs={
77 + "github": "ac_your_github_config",
78 + "slack": "ac_your_slack_config"
79 + }
80 +)
81 +```
82 +</Tab>
83 +<Tab value="TypeScript">
84 ```typescript
27 -// Before (Beta)
28 -const tools = await composio.tools.get('user_123', { toolkits: ['GITHUB'] });
29 -
30 -// After (Stable)
31 -const session = await composio.create('user_123');
32 -const tools = await session.tools();
85 +import { Composio } from '@composio/core';
86 +const composio = new Composio({ apiKey: 'your_api_key' });
87 +// ---cut---
88 +const session = await composio.create('user_123',
89 + {
90 + authConfigs: {
91 + github: "ac_your_github_config",
92 + slack: "ac_your_slack_config",
93 + },
94 + }
95 +);
96 ```
97 +</Tab>
98 +</Tabs>
99 +</Step>
100 +
101 +<Step>
102 +### Explore new capabilities
103
35 -## New features
104 +Check out these new features available in the stable version:
105
37 -- Simplified session-based API
38 -- Built-in provider support for popular AI frameworks
39 -- Improved type safety and error handling
106 +- **[Native tools](/tool-router/using-as-a-native-tool)**: Use Tool Router with any AI framework
107 +- **Better [session](/docs/users-and-sessions) and [auth](/docs/authentication) config**
108 +- **[Multi-account support](/tool-router/managing-multiple-accounts)**: Manage multiple accounts per user seamlessly
109 +- **[Manual authentication](/tool-router/manually-authenticating-users)**: Control when and how users authenticate
110 +- **[Custom auth](/tool-router/using-custom-auth-configs)**: Support for toolkits that don't have composio managed auth
111 +- **[White labeling](/tool-router/white-labeling-authentication)**: Customize authentication screens with your branding
112 +</Step>
113 +</Steps>