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

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