Composio powers 1000+ toolkits, tool search, context management, authentication, and a sandboxed workbench to help you build AI agents that turn intent into action.
Address ToolRouter example review comments
Dhawal Upadhyay committed
May 6, 2026 at 18:28 UTC
82549999140fb1defa24663d6554b913239b33cb
7 files changed
+38
-23
python/examples/tool_router/direct_tools_preset.py
+1
-1
@@ -32,7 +32,7 @@ composio = Composio(
32
require_env("OPENAI_API_KEY")
33
34
session = composio.create(
35
- user_id=f"direct-tools-example-{os.getpid()}",
35
+ user_id="direct-tools-example-user",
36
session_preset="direct_tools",
37
toolkits=["hackernews"],
38
tools={"hackernews": {"enable": ["HACKERNEWS_GET_USER"]}},
python/examples/tool_router/preload.py
+1
-1
@@ -131,7 +131,7 @@ def get_account_audit_log(input: AccountInput, ctx):
131
132
133
session = composio.create(
134
- user_id=f"preload-example-{os.getpid()}",
134
+ user_id="preload-example-user",
135
toolkits=["hackernews"],
136
tools={"hackernews": {"enable": ["HACKERNEWS_GET_USER"]}},
137
preload={"tools": ["HACKERNEWS_GET_USER"]},
ts/examples/tool-router/src/custom-tools-agent.ts
+1
-1
@@ -169,7 +169,7 @@ const composio = new Composio({
169
provider: new OpenAIAgentsProvider(),
170
});
171
172
-const session = await composio.create(`agent-e2e-${Date.now()}`, {
172
+const session = await composio.create("custom-tools-agent-user", {
173
toolkits: ["weathermap", "gmail"],
174
manageConnections: false,
175
experimental: {
ts/examples/tool-router/src/custom-tools-e2e.ts
+1
-1
@@ -146,7 +146,7 @@ const userManagement = experimental_createToolkit("USER_MANAGEMENT", {
146
const composio = new Composio({ apiKey, baseURL: baseURL ?? undefined });
147
148
async function main() {
149
- const userId = `e2e-custom-${Date.now()}`;
149
+ const userId = "custom-tools-e2e-user";
150
console.log(`\nCreating session for user: ${userId}`);
151
console.log(`Base URL: ${baseURL ?? "(default)"}\n`);
152
ts/examples/tool-router/src/direct-tools-preset.ts
+2
-2
@@ -31,7 +31,7 @@ const composio = new Composio({
31
provider: new OpenAIAgentsProvider(),
32
});
33
34
-const session = await composio.create(`direct-tools-example-${Date.now()}`, {
34
+const session = await composio.create('direct-tools-example-user', {
35
sessionPreset: 'direct_tools',
36
toolkits: ['hackernews'],
37
tools: {
@@ -51,7 +51,7 @@ const agent = new Agent({
51
name: 'Direct Tools Demo Agent',
52
instructions:
53
'Use the provided direct tools. The session is configured without Tool Router meta/helper tools.',
54
- model: process.env.OPENAI_MODEL ?? 'gpt-5.1',
54
+ model: process.env.OPENAI_MODEL ?? 'gpt-5.5',
55
tools,
56
});
57
ts/examples/tool-router/src/preload.ts
+2
-2
@@ -111,7 +111,7 @@ const composio = new Composio({
111
provider: new OpenAIAgentsProvider(),
112
});
113
114
-const session = await composio.create(`preload-example-${Date.now()}`, {
114
+const session = await composio.create('preload-example-user', {
115
toolkits: ['hackernews'],
116
tools: {
117
hackernews: {
@@ -138,7 +138,7 @@ const agent = new Agent({
138
name: 'Preload Demo Agent',
139
instructions:
140
'Use the provided direct tools. Do not search for tools first; the needed tools are already loaded.',
141
- model: process.env.OPENAI_MODEL ?? 'gpt-5.1',
141
+ model: process.env.OPENAI_MODEL ?? 'gpt-5.5',
142
tools,
143
});
144
ts/packages/core/src/models/ToolRouterSession.ts
+30
-15
@@ -138,12 +138,12 @@ export class ToolRouterSession<
138
if (customTool) {
139
return executeCustomTool(customTool, input, this.sessionContext!);
140
}
141
- return ToolsModel.executeSessionTool(
141
+ return this.executeBackendSessionTool(
142
+ ToolsModel,
143
toolSlug,
143
- { sessionId: this.sessionId, arguments: input },
144
+ input,
145
modifiers,
146
toolBySlug.get(toolSlug.toUpperCase()),
146
- { experimental: this.inlineExecuteExperimental() }
147
);
148
};
149
@@ -481,6 +481,21 @@ export class ToolRouterSession<
481
return this.inlineCustomToolsPayload as SessionSearchParams.Experimental | undefined;
482
}
483
484
+ private executeBackendSessionTool(
485
+ ToolsModel: Tools<TToolCollection, TTool, TProvider>,
486
+ toolSlug: string,
487
+ input: Record<string, unknown>,
488
+ modifiers?: SessionMetaToolOptions,
489
+ tool?: Tool
490
+ ): Promise<ToolExecuteResponse> {
491
+ const body = { sessionId: this.sessionId, arguments: input };
492
+ const experimental = this.inlineExecuteExperimental();
493
+ if (experimental) {
494
+ return ToolsModel.executeSessionTool(toolSlug, body, modifiers, tool, { experimental });
495
+ }
496
+ return ToolsModel.executeSessionTool(toolSlug, body, modifiers, tool);
497
+ }
498
+
499
/** Parse an individual tool item from COMPOSIO_MULTI_EXECUTE_TOOL's tools array */
500
private parseToolItem(item: unknown): { tool_slug: string; arguments: Record<string, unknown> } {
501
if (typeof item !== 'object' || item === null) {
@@ -508,12 +523,12 @@ export class ToolRouterSession<
523
const toolItems = input.tools as unknown[];
524
if (!Array.isArray(toolItems) || toolItems.length === 0) {
525
// Fallback: send to backend as-is
511
- return ToolsModel.executeSessionTool(
526
+ return this.executeBackendSessionTool(
527
+ ToolsModel,
528
COMPOSIO_MULTI_EXECUTE_TOOL,
513
- { sessionId: this.sessionId, arguments: input },
529
+ input,
530
modifiers,
515
- multiExecuteTool,
516
- { experimental: this.inlineExecuteExperimental() }
531
+ multiExecuteTool
532
);
533
}
534
@@ -533,12 +548,12 @@ export class ToolRouterSession<
548
549
// All remote — just forward entire payload
550
if (localItems.length === 0) {
536
- return ToolsModel.executeSessionTool(
551
+ return this.executeBackendSessionTool(
552
+ ToolsModel,
553
COMPOSIO_MULTI_EXECUTE_TOOL,
538
- { sessionId: this.sessionId, arguments: input },
554
+ input,
555
modifiers,
540
- multiExecuteTool,
541
- { experimental: this.inlineExecuteExperimental() }
556
+ multiExecuteTool
557
);
558
}
559
@@ -554,12 +569,12 @@ export class ToolRouterSession<
569
if (remoteIndices.length > 0) {
570
const remoteToolItems = remoteIndices.map(i => toolItems[i]);
571
const remoteInput = { ...input, tools: remoteToolItems };
557
- remotePromise = ToolsModel.executeSessionTool(
572
+ remotePromise = this.executeBackendSessionTool(
573
+ ToolsModel,
574
COMPOSIO_MULTI_EXECUTE_TOOL,
559
- { sessionId: this.sessionId, arguments: remoteInput },
575
+ remoteInput,
576
modifiers,
561
- multiExecuteTool,
562
- { experimental: this.inlineExecuteExperimental() }
577
+ multiExecuteTool
578
);
579
}
580