@devries-cameron20 / composio Mirror · read-only / commits / af242d96f
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.

Mirrored from https://github.com/Camo67/composio.git

Synced Nov 22, 18:15 UTC

session fixes

Sushmithamallesh committed Dec 3, 2025 at 20:14 UTC af242d96f9465ba173828283e712dca4a0a9a926
14 files changed +216 -119
fern/pages/src/tool-router/manually-authenticating-users.mdx
+6 -9
@@ -15,14 +15,13 @@ Disable the `COMPOSIO_MANAGE_CONNECTIONS` meta-tool so the agent doesn't prompt
15
16 <CodeGroup>
17 ```python
18 -session = await composio.create_session(
18 +session = await composio.create(
19 user="pg-user-550e8400-e29b-41d4",
20 manage_connections=False,
21 )
22 ```
23 ```typescript
24 -const session = await composio.createSession({
25 - user: "pg-user-550e8400-e29b-41d4",
24 +const session = await composio.create("pg-user-550e8400-e29b-41d4", {
25 manageConnections: false,
26 });
27 ```
@@ -134,7 +133,7 @@ A common pattern is to verify all required connections before starting the agent
133 ```python
134 required_toolkits = ["gmail", "googlecalendar", "linear", "slack"]
135
137 -session = await composio.create_session(
136 +session = await composio.create(
137 user=user_id,
138 manage_connections=False,
139 )
@@ -163,8 +162,7 @@ tools = await session.tools()
162 ```typescript
163 const requiredToolkits = ["gmail", "googlecalendar", "linear", "slack"];
164
166 -const session = await composio.createSession({
167 - user: userId,
165 +const session = await composio.create(userId, {
166 manageConnections: false,
167 });
168
@@ -198,7 +196,7 @@ To use a specific account, pass it in the session config:
196
197 <CodeGroup>
198 ```python
201 -session = await composio.create_session(
199 +session = await composio.create(
200 user=user_id,
201 connected_accounts={
202 "gmail": "ca_specific_account_id",
@@ -206,8 +204,7 @@ session = await composio.create_session(
204 )
205 ```
206 ```typescript
209 -const session = await composio.createSession({
210 - user: userId,
207 +const session = await composio.create(userId, {
208 connectedAccounts: {
209 gmail: "ca_specific_account_id",
210 },
fern/pages/src/tool-router/using-in-chat-authentication.mdx
+6 -10
@@ -19,14 +19,12 @@ In-chat auth is enabled by default. The `COMPOSIO_MANAGE_CONNECTIONS` meta-tool
19
20 <CodeGroup>
21 ```python
22 -session = await composio.create_session(
22 +session = await composio.create(
23 user="pg-user-550e8400-e29b-41d4",
24 )
25 ```
26 ```typescript
27 -const session = await composio.createSession({
28 - user: "pg-user-550e8400-e29b-41d4",
29 -});
27 +const { mcp } = await composio.create("pg-user-550e8400-e29b-41d4");
28 ```
29 </CodeGroup>
30
@@ -36,7 +34,7 @@ Redirect users to a specific page after authentication:
34
35 <CodeGroup>
36 ```python
39 -session = await composio.create_session(
37 +session = await composio.create(
38 user="pg-user-550e8400-e29b-41d4",
39 manage_connections={
40 "callback_url": "https://yourapp.com/chat"
@@ -44,8 +42,7 @@ session = await composio.create_session(
42 )
43 ```
44 ```typescript
47 -const session = await composio.createSession({
48 - user: "pg-user-550e8400-e29b-41d4",
45 +const { mcp } = await composio.create("pg-user-550e8400-e29b-41d4", {
46 manageConnections: {
47 callbackUrl: "https://yourapp.com/chat",
48 },
@@ -59,14 +56,13 @@ To manage authentication outside of chat, disable the `COMPOSIO_MANAGE_CONNECTIO
56
57 <CodeGroup>
58 ```python
62 -session = await composio.create_session(
59 +session = await composio.create(
60 user="pg-user-550e8400-e29b-41d4",
61 manage_connections=False,
62 )
63 ```
64 ```typescript
68 -const session = await composio.createSession({
69 - user: "pg-user-550e8400-e29b-41d4",
65 +const { mcp } = await composio.create("pg-user-550e8400-e29b-41d4", {
66 manageConnections: false,
67 });
68 ```
fern/pages/src/tool-router/white-labeling-authentication.mdx
+4 -6
@@ -48,7 +48,7 @@ Pass your auth config ID in the session:
48
49 <CodeGroup>
50 ```python
51 -session = await composio.create_session(
51 +session = await composio.create(
52 user="pg-user-550e8400-e29b-41d4",
53 auth_configs={
54 "github": "ac_your_github_config"
@@ -56,8 +56,7 @@ session = await composio.create_session(
56 )
57 ```
58 ```typescript
59 -const session = await composio.createSession({
60 - user: "pg-user-550e8400-e29b-41d4",
59 +const session = await composio.create("pg-user-550e8400-e29b-41d4", {
60 authConfigs: {
61 github: "ac_your_github_config",
62 },
@@ -75,7 +74,7 @@ You can white-label some toolkits while using Composio's default credentials for
74
75 <CodeGroup>
76 ```python
78 -session = await composio.create_session(
77 +session = await composio.create(
78 user="pg-user-550e8400-e29b-41d4",
79 auth_configs={
80 "github": "ac_your_github_config",
@@ -85,8 +84,7 @@ session = await composio.create_session(
84 )
85 ```
86 ```typescript
88 -const session = await composio.createSession({
89 - user: "pg-user-550e8400-e29b-41d4",
87 +const session = await composio.create("pg-user-550e8400-e29b-41d4", {
88 authConfigs: {
89 github: "ac_your_github_config",
90 slack: "ac_your_slack_config",
fern/snippets/tool-router/python/anthropic-mcp.py new
+18
@@ -0,0 +1,18 @@
1 +from composio import Composio
2 +from anthropic_agents import Agent, run
3 +
4 +composio = Composio(api_key="your-api-key")
5 +
6 +session = composio.create(user_id="pg-user-550e8400-e29b-41d4")
7 +
8 +agent = Agent(
9 + name="Personal Assistant",
10 + instructions="You are a helpful personal assistant.",
11 + mcp_servers=[session.mcp.url]
12 +)
13 +
14 +result = run(
15 + agent,
16 + "Summarize all the emails in my Gmail inbox today"
17 +)
18 +print(result.final_output)
fern/snippets/tool-router/python/in-chat-auth.py
+7 -4
@@ -2,12 +2,12 @@ import asyncio
2 from composio import Composio
3 from agents import Agent, Runner, HostedMCPTool
4
5 -composio = Composio()
5 +composio = Composio(api_key="your-composio-api-key")
6
7 async def chat():
8 - session = await composio.create_session(
9 - user="pg-user-550e8400-e29b-41d4",
10 - )
8 + print("Creating Tool Router session...")
9 + session = await composio.create("pg-user-550e8400-e29b-41d4")
10 + print(f"Tool Router session created: {session.mcp.url}")
11
12 agent = Agent(
13 name="GitHub Assistant",
@@ -19,6 +19,9 @@ async def chat():
19 "server_label": "composio",
20 "server_url": session.mcp.url,
21 "require_approval": "never",
22 + "headers": {
23 + "x-api-key": "your-composio-api-key",
24 + },
25 }
26 )
27 ],
fern/snippets/tool-router/python/manual-auth.py
+2 -2
@@ -1,13 +1,13 @@
1 import asyncio
2 from composio import Composio
3
4 -composio = Composio()
4 +composio = Composio(api_key="your-composio-api-key")
5
6 user_id = "pg-user-550e8400-e29b-41d4"
7 required_toolkits = ["gmail", "googlecalendar", "linear", "slack"]
8
9 async def main():
10 - session = await composio.create_session(
10 + session = await composio.create(
11 user=user_id,
12 manage_connections=False,
13 )
fern/snippets/tool-router/python/openai-agents.py new
+22
@@ -0,0 +1,22 @@
1 +from composio import Composio
2 +from composio_openai_agents import OpenAIAgentsProvider
3 +from agents import Agent, Runner
4 +
5 +composio = Composio(
6 + api_key="your-api-key",
7 + provider=OpenAIAgentsProvider()
8 +)
9 +
10 +session = composio.create(user_id="pg-user-550e8400-e29b-41d4")
11 +
12 +agent = Agent(
13 + name="Personal Assistant",
14 + instructions="You are a helpful personal assistant.",
15 + tools=session.tools()
16 +)
17 +
18 +result = Runner.run_sync(
19 + agent,
20 + "Summarize all the emails in my Gmail inbox today"
21 +)
22 +print(result.final_output)
fern/snippets/tool-router/python/quickstart.py
+28 -37
@@ -1,42 +1,33 @@
1 -import asyncio
2 -import os
1 from composio import Composio
4 -from composio_openai_agents import OpenAIAgentsProvider
2 from agents import Agent, Runner, HostedMCPTool
3
7 -async def main() -> None:
8 - # Initialize Composio and create Tool Router session
9 - composio = Composio(
10 - api_key=os.getenv("COMPOSIO_API_KEY"), # Uses env var by default
11 - provider=OpenAIAgentsProvider()
12 - )
13 - session = composio.experimental.tool_router.create_session(
14 - user_id="user@example.com",
15 - toolkits=["gmail", "github"] # Optional: Limit available toolkits
16 - )
17 -
18 - # Set up OpenAI agent with Tool Router MCP endpoint
19 - agent = Agent(
20 - name="Assistant",
21 - instructions="You are a helpful assistant that can access Gmail and GitHub. "
22 - "Help users fetch emails, create issues, manage pull requests, and more.",
23 - tools=[
24 - HostedMCPTool(
25 - tool_config={
26 - "type": "mcp",
27 - "server_label": "tool_router",
28 - "server_url": session['url'],
29 - "require_approval": "never",
30 - }
31 - )
32 - ],
33 - )
4 +composio = Composio(api_key="your-composio-api-key")
5
35 - # Execute the agent
36 - result = await Runner.run(
37 - agent,
38 - "Fetch the contributors to composiohq/composio github repository and email the list to user@example.com"
39 - )
40 - print(result.final_output)
6 +print("Creating Tool Router session...")
7 +session = composio.create("pg-user-550e8400-e29b-41d4")
8 +print(f"Tool Router session created: {session.mcp.url}")
9
42 -asyncio.run(main())
\ No newline at end of file
10 +agent = Agent(
11 + name="Personal Assistant",
12 + instructions="You are a helpful personal assistant.",
13 + tools=[
14 + HostedMCPTool(
15 + tool_config={
16 + "type": "mcp",
17 + "server_label": "composio",
18 + "server_url": session.mcp.url,
19 + "require_approval": "never",
20 + "headers": {
21 + "x-api-key": "your-composio-api-key",
22 + },
23 + }
24 + )
25 + ],
26 +)
27 +
28 +print("Running the OpenAI agent to fetch gmail inbox")
29 +result = Runner.run_sync(
30 + agent,
31 + "Summarize all the emails in my Gmail inbox today"
32 +)
33 +print(result.final_output)
fern/snippets/tool-router/typescript/anthropic-mcp.ts new
+18
@@ -0,0 +1,18 @@
1 +import { Composio } from "@composio/core";
2 +import { Agent, run } from "@anthropic-ai/agent";
3 +
4 +const composio = new Composio({ apiKey: "your-api-key" });
5 +
6 +const { mcp } = await composio.create("pg-user-550e8400-e29b-41d4");
7 +
8 +const agent = new Agent({
9 + name: "Personal Assistant",
10 + instructions: "You are a helpful personal assistant.",
11 + mcpServers: [mcp.url],
12 +});
13 +
14 +const result = await run(
15 + agent,
16 + "Summarize all the emails in my Gmail inbox today"
17 +);
18 +console.log(result.finalOutput);
fern/snippets/tool-router/typescript/in-chat-auth.ts
+16 -8
@@ -1,19 +1,27 @@
1 -import { Composio } from "@composio/core";
2 -import { VercelProvider } from "@composio/vercel";
1 import { openai } from "@ai-sdk/openai";
2 +import { experimental_createMCPClient as createMCPClient } from "@ai-sdk/mcp";
3 +import { Composio } from "@composio/core";
4 import { generateText } from "ai";
5 import * as readline from "readline";
6
7 -const composio = new Composio({
8 - provider: new VercelProvider(),
9 -});
7 +const composio = new Composio({ apiKey: "your-composio-api-key" });
8
9 async function chat() {
12 - const session = await composio.createSession({
13 - user: "pg-user-550e8400-e29b-41d4",
10 + console.log("Creating Tool Router session...");
11 + const { mcp } = await composio.create("pg-user-550e8400-e29b-41d4");
12 + console.log(`Tool Router session created: ${mcp.url}`);
13 +
14 + const client = await createMCPClient({
15 + transport: {
16 + type: "http",
17 + url: mcp.url,
18 + headers: {
19 + "x-api-key": "your-composio-api-key",
20 + },
21 + },
22 });
23
16 - const tools = await session.tools();
24 + const tools = await client.tools();
25 const messages: { role: "user" | "assistant"; content: string }[] = [];
26
27 const rl = readline.createInterface({
fern/snippets/tool-router/typescript/manual-auth.ts
+2 -6
@@ -1,16 +1,12 @@
1 import { Composio } from "@composio/core";
2 -import { VercelProvider } from "@composio/vercel";
2
4 -const composio = new Composio({
5 - provider: new VercelProvider(),
6 -});
3 +const composio = new Composio({ apiKey: "your-composio-api-key" });
4
5 const userId = "pg-user-550e8400-e29b-41d4";
6 const requiredToolkits = ["gmail", "googlecalendar", "linear", "slack"];
7
8 async function main() {
12 - const session = await composio.createSession({
13 - user: userId,
9 + const session = await composio.create(userId, {
10 manageConnections: false,
11 });
12
fern/snippets/tool-router/typescript/openai-agents.ts new
+22
@@ -0,0 +1,22 @@
1 +import { Composio } from "@composio/core";
2 +import { OpenAIAgentsProvider } from "@composio/openai-agents";
3 +import { Agent, run } from "@openai/agents";
4 +
5 +const composio = new Composio({
6 + apiKey: "your-api-key",
7 + provider: new OpenAIAgentsProvider(),
8 +});
9 +
10 +const { tools } = await composio.create("pg-user-550e8400-e29b-41d4");
11 +
12 +const agent = new Agent({
13 + name: "Personal Assistant",
14 + instructions: "You are a helpful personal assistant.",
15 + tools: await tools(),
16 +});
17 +
18 +const result = await run(
19 + agent,
20 + "Summarize all the emails in my Gmail inbox today"
21 +);
22 +console.log(result.finalOutput);
fern/snippets/tool-router/typescript/quickstart.ts
+25 -37
@@ -1,41 +1,29 @@
1 -import { Composio } from '@composio/core';
2 -import { OpenAIAgentsProvider } from '@composio/openai-agents';
3 -import { Agent, hostedMcpTool, run } from '@openai/agents';
1 +import { Composio } from "@composio/core";
2 +import { Agent, hostedMcpTool, run } from "@openai/agents";
3
5 -async function main() {
6 - // Initialize Composio with OpenAI Agents Provider
7 - const composio = new Composio({
8 - apiKey: process.env.COMPOSIO_API_KEY,
9 - provider: new OpenAIAgentsProvider()
10 - });
4 +const composio = new Composio({ apiKey: "your-composio-api-key" });
5
12 - // Create a Tool Router session for your user
13 - const session = await composio.experimental.toolRouter.createSession(
14 - 'user@example.com',
15 - {
16 - toolkits: ['gmail', 'github'] // Optional: Limit available toolkits
17 - }
18 - );
6 +console.log("Creating Tool Router session...");
7 +const { mcp } = await composio.create("pg-user-550e8400-e29b-41d4");
8 +console.log(`Tool Router session created: ${mcp.url}`);
9
20 - // Create an agent with Tool Router MCP endpoint
21 - const agent = new Agent({
22 - name: 'Assistant',
23 - instructions: 'You are a helpful assistant that can access Gmail and GitHub. Help users fetch emails, create issues, manage pull requests, and more.',
24 - tools: [
25 - hostedMcpTool({
26 - serverLabel: 'tool_router',
27 - serverUrl: session.url,
28 - }),
29 - ],
30 - });
10 +const agent = new Agent({
11 + name: "Personal Assistant",
12 + instructions: "You are a helpful personal assistant.",
13 + tools: [
14 + hostedMcpTool({
15 + serverLabel: "composio",
16 + serverUrl: mcp.url,
17 + headers: {
18 + "x-api-key": "your-composio-api-key",
19 + },
20 + }),
21 + ],
22 +});
23
32 - // Execute the agent
33 - const result = await run(
34 - agent,
35 - 'Fetch the contributors to composiohq/composio github repository and email the list to user@example.com'
36 - );
37 -
38 - console.log(result.finalOutput);
39 -}
40 -
41 -main();
\ No newline at end of file
24 +console.log("Running the OpenAI agent to fetch gmail inbox");
25 +const result = await run(
26 + agent,
27 + "Summarize all the emails in my Gmail inbox today"
28 +);
29 +console.log(result.finalOutput);
fern/snippets/tool-router/typescript/vercel.ts new
+40
@@ -0,0 +1,40 @@
1 +import { openai } from "@ai-sdk/openai";
2 +import { experimental_createMCPClient as createMCPClient } from "@ai-sdk/mcp";
3 +import { Composio } from "@composio/core";
4 +import { stepCountIs, streamText } from "ai";
5 +
6 +const composio = new Composio({ apiKey: "your-composio-api-key" });
7 +
8 +console.log("Creating Tool Router session...");
9 +const { mcp } = await composio.create("pg-user-550e8400-e29b-41d4");
10 +console.log(`Tool Router session created: ${mcp.url}`);
11 +
12 +const client = await createMCPClient({
13 + transport: {
14 + type: "http",
15 + url: mcp.url,
16 + headers: {
17 + "x-api-key": "your-composio-api-key",
18 + },
19 + },
20 +});
21 +
22 +const tools = await client.tools();
23 +
24 +const stream = await streamText({
25 + model: openai("gpt-4o"),
26 + prompt: "Summarize all the emails in my Gmail inbox today",
27 + stopWhen: stepCountIs(10),
28 + onStepFinish: (step) => {
29 + if (step.toolCalls.length > 0) {
30 + for (const toolCall of step.toolCalls) {
31 + console.log(`Executed ${toolCall.toolName}`);
32 + }
33 + }
34 + },
35 + tools,
36 +});
37 +
38 +for await (const textPart of stream.textStream) {
39 + process.stdout.write(textPart);
40 +}