Composio powers 1000+ toolkits, tool search, context management, authentication, and a sandboxed workbench to help you build AI agents that turn intent into action.
Mirrored from https://github.com/Camo67/composio.git
Synced Nov 22, 14:30 UTC
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>