Skip to content

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 Upadhyay82549999140f
diff --git a/python/examples/tool_router/direct_tools_preset.py b/python/examples/tool_router/direct_tools_preset.py
index ea44714c0..efaf49060 100644
--- a/python/examples/tool_router/direct_tools_preset.py
+++ b/python/examples/tool_router/direct_tools_preset.py
@@ -32,7 +32,7 @@ composio = Composio(
require_env("OPENAI_API_KEY")
session = composio.create(
- user_id=f"direct-tools-example-{os.getpid()}",
+ user_id="direct-tools-example-user",
session_preset="direct_tools",
toolkits=["hackernews"],
tools={"hackernews": {"enable": ["HACKERNEWS_GET_USER"]}},
diff --git a/python/examples/tool_router/preload.py b/python/examples/tool_router/preload.py
index 22739bfd3..0db8d8686 100644
--- a/python/examples/tool_router/preload.py
+++ b/python/examples/tool_router/preload.py
@@ -131,7 +131,7 @@ def get_account_audit_log(input: AccountInput, ctx):
session = composio.create(
- user_id=f"preload-example-{os.getpid()}",
+ user_id="preload-example-user",
toolkits=["hackernews"],
tools={"hackernews": {"enable": ["HACKERNEWS_GET_USER"]}},
preload={"tools": ["HACKERNEWS_GET_USER"]},
diff --git a/ts/examples/tool-router/src/custom-tools-agent.ts b/ts/examples/tool-router/src/custom-tools-agent.ts
index 9149add75..00be15a0c 100644
--- a/ts/examples/tool-router/src/custom-tools-agent.ts
+++ b/ts/examples/tool-router/src/custom-tools-agent.ts
@@ -169,7 +169,7 @@ const composio = new Composio({
provider: new OpenAIAgentsProvider(),
});
-const session = await composio.create(`agent-e2e-${Date.now()}`, {
+const session = await composio.create("custom-tools-agent-user", {
toolkits: ["weathermap", "gmail"],
manageConnections: false,
experimental: {
diff --git a/ts/examples/tool-router/src/custom-tools-e2e.ts b/ts/examples/tool-router/src/custom-tools-e2e.ts
index 831761e50..f35c13350 100644
--- a/ts/examples/tool-router/src/custom-tools-e2e.ts
+++ b/ts/examples/tool-router/src/custom-tools-e2e.ts
@@ -146,7 +146,7 @@ const userManagement = experimental_createToolkit("USER_MANAGEMENT", {
const composio = new Composio({ apiKey, baseURL: baseURL ?? undefined });
async function main() {
- const userId = `e2e-custom-${Date.now()}`;
+ const userId = "custom-tools-e2e-user";
console.log(`\nCreating session for user: ${userId}`);
console.log(`Base URL: ${baseURL ?? "(default)"}\n`);
diff --git a/ts/examples/tool-router/src/direct-tools-preset.ts b/ts/examples/tool-router/src/direct-tools-preset.ts
index 81af694f6..10474c808 100644
--- a/ts/examples/tool-router/src/direct-tools-preset.ts
+++ b/ts/examples/tool-router/src/direct-tools-preset.ts
@@ -31,7 +31,7 @@ const composio = new Composio({
provider: new OpenAIAgentsProvider(),
});
-const session = await composio.create(`direct-tools-example-${Date.now()}`, {
+const session = await composio.create('direct-tools-example-user', {
sessionPreset: 'direct_tools',
toolkits: ['hackernews'],
tools: {
@@ -51,7 +51,7 @@ const agent = new Agent({
name: 'Direct Tools Demo Agent',
instructions:
'Use the provided direct tools. The session is configured without Tool Router meta/helper tools.',
- model: process.env.OPENAI_MODEL ?? 'gpt-5.1',
+ model: process.env.OPENAI_MODEL ?? 'gpt-5.5',
tools,
});
diff --git a/ts/examples/tool-router/src/preload.ts b/ts/examples/tool-router/src/preload.ts
index 317a3d24a..6110e47f1 100644
--- a/ts/examples/tool-router/src/preload.ts
+++ b/ts/examples/tool-router/src/preload.ts
@@ -111,7 +111,7 @@ const composio = new Composio({
provider: new OpenAIAgentsProvider(),
});
-const session = await composio.create(`preload-example-${Date.now()}`, {
+const session = await composio.create('preload-example-user', {
toolkits: ['hackernews'],
tools: {
hackernews: {
@@ -138,7 +138,7 @@ const agent = new Agent({
name: 'Preload Demo Agent',
instructions:
'Use the provided direct tools. Do not search for tools first; the needed tools are already loaded.',
- model: process.env.OPENAI_MODEL ?? 'gpt-5.1',
+ model: process.env.OPENAI_MODEL ?? 'gpt-5.5',
tools,
});
diff --git a/ts/packages/core/src/models/ToolRouterSession.ts b/ts/packages/core/src/models/ToolRouterSession.ts
index 28f9df677..6b9ee0bb4 100644
--- a/ts/packages/core/src/models/ToolRouterSession.ts
+++ b/ts/packages/core/src/models/ToolRouterSession.ts
@@ -138,12 +138,12 @@ export class ToolRouterSession<
if (customTool) {
return executeCustomTool(customTool, input, this.sessionContext!);
}
- return ToolsModel.executeSessionTool(
+ return this.executeBackendSessionTool(
+ ToolsModel,
toolSlug,
- { sessionId: this.sessionId, arguments: input },
+ input,
modifiers,
toolBySlug.get(toolSlug.toUpperCase()),
- { experimental: this.inlineExecuteExperimental() }
);
};
@@ -481,6 +481,21 @@ export class ToolRouterSession<
return this.inlineCustomToolsPayload as SessionSearchParams.Experimental | undefined;
}
+ private executeBackendSessionTool(
+ ToolsModel: Tools<TToolCollection, TTool, TProvider>,
+ toolSlug: string,
+ input: Record<string, unknown>,
+ modifiers?: SessionMetaToolOptions,
+ tool?: Tool
+ ): Promise<ToolExecuteResponse> {
+ const body = { sessionId: this.sessionId, arguments: input };
+ const experimental = this.inlineExecuteExperimental();
+ if (experimental) {
+ return ToolsModel.executeSessionTool(toolSlug, body, modifiers, tool, { experimental });
+ }
+ return ToolsModel.executeSessionTool(toolSlug, body, modifiers, tool);
+ }
+
/** Parse an individual tool item from COMPOSIO_MULTI_EXECUTE_TOOL's tools array */
private parseToolItem(item: unknown): { tool_slug: string; arguments: Record<string, unknown> } {
if (typeof item !== 'object' || item === null) {
@@ -508,12 +523,12 @@ export class ToolRouterSession<
const toolItems = input.tools as unknown[];
if (!Array.isArray(toolItems) || toolItems.length === 0) {
// Fallback: send to backend as-is
- return ToolsModel.executeSessionTool(
+ return this.executeBackendSessionTool(
+ ToolsModel,
COMPOSIO_MULTI_EXECUTE_TOOL,
- { sessionId: this.sessionId, arguments: input },
+ input,
modifiers,
- multiExecuteTool,
- { experimental: this.inlineExecuteExperimental() }
+ multiExecuteTool
);
}
@@ -533,12 +548,12 @@ export class ToolRouterSession<
// All remote — just forward entire payload
if (localItems.length === 0) {
- return ToolsModel.executeSessionTool(
+ return this.executeBackendSessionTool(
+ ToolsModel,
COMPOSIO_MULTI_EXECUTE_TOOL,
- { sessionId: this.sessionId, arguments: input },
+ input,
modifiers,
- multiExecuteTool,
- { experimental: this.inlineExecuteExperimental() }
+ multiExecuteTool
);
}
@@ -554,12 +569,12 @@ export class ToolRouterSession<
if (remoteIndices.length > 0) {
const remoteToolItems = remoteIndices.map(i => toolItems[i]);
const remoteInput = { ...input, tools: remoteToolItems };
- remotePromise = ToolsModel.executeSessionTool(
+ remotePromise = this.executeBackendSessionTool(
+ ToolsModel,
COMPOSIO_MULTI_EXECUTE_TOOL,
- { sessionId: this.sessionId, arguments: remoteInput },
+ remoteInput,
modifiers,
- multiExecuteTool,
- { experimental: this.inlineExecuteExperimental() }
+ multiExecuteTool
);
}