@librechat/agents 3.0.65 → 3.0.67

package/dist/types/tools/{ToolSearchRegex.d.ts → ToolSearch.d.ts}

@@ -1,19 +1,18 @@
 import { z } from 'zod';
 import { DynamicStructuredTool } from '@langchain/core/tools';
 import type * as t from '@/types';
-declare const ToolSearchRegexSchema: z.ZodObject<{
+/** Zod schema type for tool search parameters */
+type ToolSearchSchema = z.ZodObject<{
     query: z.ZodString;
-    fields: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodEnum<["name", "description", "parameters"]>, "many">>>;
+    fields: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodEnum<['name', 'description', 'parameters']>>>>;
     max_results: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
-}, "strip", z.ZodTypeAny, {
-    query: string;
-    fields: ("name" | "description" | "parameters")[];
-    max_results: number;
-}, {
-    query: string;
-    fields?: ("name" | "description" | "parameters")[] | undefined;
-    max_results?: number | undefined;
 }>;
+/**
+ * Creates the Zod schema with dynamic query description based on mode.
+ * @param mode - The search mode determining query interpretation
+ * @returns Zod schema for tool search parameters
+ */
+declare function createToolSearchSchema(mode: t.ToolSearchMode): ToolSearchSchema;
 /**
  * Escapes special regex characters in a string to use as a literal pattern.
  * @param pattern - The string to escape
@@ -50,11 +49,25 @@ declare function sanitizeRegex(pattern: string): {
     wasEscaped: boolean;
 };
 /**
- * Creates a Tool Search Regex tool for discovering tools from a large registry.
+ * Performs safe local substring search without regex.
+ * Uses case-insensitive String.includes() for complete safety against ReDoS.
+ * @param tools - Array of tool metadata to search
+ * @param query - The search term (treated as literal substring)
+ * @param fields - Which fields to search
+ * @param maxResults - Maximum results to return
+ * @returns Search response with matching tools
+ */
+declare function performLocalSearch(tools: t.ToolMetadata[], query: string, fields: string[], maxResults: number): t.ToolSearchResponse;
+/**
+ * Creates a Tool Search tool for discovering tools from a large registry.
  *
  * This tool enables AI agents to dynamically discover tools from a large library
  * without loading all tool definitions into the LLM context window. The agent
- * can search for relevant tools on-demand using regex patterns.
+ * can search for relevant tools on-demand.
+ *
+ * **Modes:**
+ * - `code_interpreter` (default): Uses external sandbox for regex search. Safer for complex patterns.
+ * - `local`: Uses safe substring matching locally. No network call, faster, completely safe from ReDoS.
  *
  * The tool registry can be provided either:
  * 1. At initialization time via params.toolRegistry
@@ -64,17 +77,14 @@ declare function sanitizeRegex(pattern: string): {
  * @returns A LangChain DynamicStructuredTool for tool searching
  *
  * @example
- * // Option 1: Registry at initialization
- * const tool = createToolSearchRegexTool({ apiKey, toolRegistry });
- * await tool.invoke({ query: 'expense' });
+ * // Option 1: Code interpreter mode (regex via sandbox)
+ * const tool = createToolSearch({ apiKey, toolRegistry });
+ * await tool.invoke({ query: 'expense.*report' });
  *
  * @example
- * // Option 2: Registry at runtime
- * const tool = createToolSearchRegexTool({ apiKey });
- * await tool.invoke(
- *   { query: 'expense' },
- *   { configurable: { toolRegistry, onlyDeferred: true } }
- * );
+ * // Option 2: Local mode (safe substring search, no API key needed)
+ * const tool = createToolSearch({ mode: 'local', toolRegistry });
+ * await tool.invoke({ query: 'expense' });
  */
-declare function createToolSearchRegexTool(initParams?: t.ToolSearchRegexParams): DynamicStructuredTool<typeof ToolSearchRegexSchema>;
-export { createToolSearchRegexTool, sanitizeRegex, escapeRegexSpecialChars, isDangerousPattern, countNestedGroups, hasNestedQuantifiers, };
+declare function createToolSearch(initParams?: t.ToolSearchParams): DynamicStructuredTool<ReturnType<typeof createToolSearchSchema>>;
+export { createToolSearch, performLocalSearch, sanitizeRegex, escapeRegexSpecialChars, isDangerousPattern, countNestedGroups, hasNestedQuantifiers, };

package/dist/types/types/tools.d.ts

@@ -99,12 +99,16 @@ export type ProgrammaticCache = {
     toolMap: ToolMap;
     toolDefs: LCTool[];
 };
+/** Search mode: code_interpreter uses external sandbox, local uses safe substring matching */
+export type ToolSearchMode = 'code_interpreter' | 'local';
 /** Parameters for creating a Tool Search Regex tool */
-export type ToolSearchRegexParams = {
+export type ToolSearchParams = {
     apiKey?: string;
     toolRegistry?: LCToolRegistry;
     onlyDeferred?: boolean;
     baseUrl?: string;
+    /** Search mode: 'code_interpreter' (default) uses sandbox for regex, 'local' uses safe substring matching */
+    mode?: ToolSearchMode;
     [key: string]: unknown;
 };
 /** Simplified tool metadata for search purposes */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@librechat/agents",
-  "version": "3.0.65",
+  "version": "3.0.67",
   "main": "./dist/cjs/main.cjs",
   "module": "./dist/esm/main.mjs",
   "types": "./dist/types/index.d.ts",
@@ -57,7 +57,7 @@
     "memory": "node -r dotenv/config --loader ./tsconfig-paths-bootstrap.mjs --experimental-specifier-resolution=node ./src/scripts/memory.ts --provider 'openAI' --name 'Jo' --location 'New York, NY'",
     "tool": "node --trace-warnings -r dotenv/config --loader ./tsconfig-paths-bootstrap.mjs --experimental-specifier-resolution=node ./src/scripts/tools.ts --provider 'openrouter' --name 'Jo' --location 'New York, NY'",
     "search": "node -r dotenv/config --loader ./tsconfig-paths-bootstrap.mjs --experimental-specifier-resolution=node ./src/scripts/search.ts --provider 'bedrock' --name 'Jo' --location 'New York, NY'",
-    "tool_search_regex": "node -r dotenv/config --loader ./tsconfig-paths-bootstrap.mjs --experimental-specifier-resolution=node ./src/scripts/tool_search_regex.ts",
+    "tool_search": "node -r dotenv/config --loader ./tsconfig-paths-bootstrap.mjs --experimental-specifier-resolution=node ./src/scripts/tool_search.ts",
     "programmatic_exec": "node -r dotenv/config --loader ./tsconfig-paths-bootstrap.mjs --experimental-specifier-resolution=node ./src/scripts/programmatic_exec.ts",
     "code_exec_ptc": "node -r dotenv/config --loader ./tsconfig-paths-bootstrap.mjs --experimental-specifier-resolution=node ./src/scripts/code_exec_ptc.ts --provider 'openAI' --name 'Jo' --location 'New York, NY'",
     "programmatic_exec_agent": "node -r dotenv/config --loader ./tsconfig-paths-bootstrap.mjs --experimental-specifier-resolution=node ./src/scripts/programmatic_exec_agent.ts --provider 'openAI' --name 'Jo' --location 'New York, NY'",

package/src/agents/AgentContext.ts

@@ -151,10 +151,13 @@ export class AgentContext {
   useLegacyContent: boolean = false;
   /**
    * Handoff context when this agent receives control via handoff.
-   * Contains source agent name for system message identity context.
+   * Contains source and parallel execution info for system message context.
    */
   handoffContext?: {
+    /** Source agent that transferred control */
     sourceAgentName: string;
+    /** Names of sibling agents executing in parallel (empty if sequential) */
+    parallelSiblings: string[];
   };
 
   constructor({
@@ -345,22 +348,26 @@ export class AgentContext {
    * This helps the agent understand its role in the multi-agent workflow.
    */
   private buildIdentityPreamble(): string {
-    /** Only include preamble if we have handoff context (indicates multi-agent workflow) */
     if (!this.handoffContext) return '';
 
-    /** Use name (falls back to agentId if not provided) */
     const displayName = this.name ?? this.agentId;
+    const { sourceAgentName, parallelSiblings } = this.handoffContext;
+    const isParallel = parallelSiblings.length > 0;
 
     const lines: string[] = [];
-    lines.push('## Agent Context');
-    lines.push(`You are the "${displayName}" agent.`);
+    lines.push('## Multi-Agent Workflow');
+    lines.push(
+      `You are "${displayName}", transferred from "${sourceAgentName}".`
+    );
 
-    if (this.handoffContext.sourceAgentName) {
-      lines.push(
-        `Control was transferred to you from the "${this.handoffContext.sourceAgentName}" agent.`
-      );
+    if (isParallel) {
+      lines.push(`Running in parallel with: ${parallelSiblings.join(', ')}.`);
     }
 
+    lines.push(
+      'Execute only tasks relevant to your role. Routing is already handled if requested, unless you can route further.'
+    );
+
     return lines.join('\n');
   }
 
@@ -525,10 +532,11 @@ export class AgentContext {
    * Sets the handoff context for this agent.
    * Call this when the agent receives control via handoff from another agent.
    * Marks system runnable as stale to include handoff context in system message.
-   * @param sourceAgentName - The name of the agent that handed off to this agent
+   * @param sourceAgentName - Name of the agent that transferred control
+   * @param parallelSiblings - Names of other agents executing in parallel with this one
    */
-  setHandoffContext(sourceAgentName: string): void {
-    this.handoffContext = { sourceAgentName };
+  setHandoffContext(sourceAgentName: string, parallelSiblings: string[]): void {
+    this.handoffContext = { sourceAgentName, parallelSiblings };
     this.systemRunnableStale = true;
   }
 

package/src/common/enum.ts

@@ -159,7 +159,7 @@ export enum Callback {
 export enum Constants {
   OFFICIAL_CODE_BASEURL = 'https://api.librechat.ai/v1',
   EXECUTE_CODE = 'execute_code',
-  TOOL_SEARCH_REGEX = 'tool_search_regex',
+  TOOL_SEARCH = 'tool_search',
   PROGRAMMATIC_TOOL_CALLING = 'run_tools_with_code',
   WEB_SEARCH = 'web_search',
   CONTENT_AND_ARTIFACT = 'content_and_artifact',

package/src/graphs/MultiAgentGraph.ts

@@ -497,15 +497,15 @@ export class MultiAgentGraph extends StandardGraph {
 
   /**
    * Detects if the current agent is receiving a handoff and processes the messages accordingly.
-   * Returns filtered messages with the transfer tool call/message removed, plus any instructions
-   * and source agent information extracted from the transfer.
+   * Returns filtered messages with the transfer tool call/message removed, plus any instructions,
+   * source agent, and parallel sibling information extracted from the transfer.
    *
    * Supports both single handoffs (last message is the transfer) and parallel handoffs
    * (multiple transfer ToolMessages, need to find the one targeting this agent).
    *
    * @param messages - Current state messages
    * @param agentId - The agent ID to check for handoff reception
-   * @returns Object with filtered messages, extracted instructions, and source agent, or null if not a handoff
+   * @returns Object with filtered messages, extracted instructions, source agent, and parallel siblings
    */
   private processHandoffReception(
     messages: BaseMessage[],
@@ -514,6 +514,7 @@ export class MultiAgentGraph extends StandardGraph {
     filteredMessages: BaseMessage[];
     instructions: string | null;
     sourceAgentName: string | null;
+    parallelSiblings: string[];
   } | null {
     if (messages.length === 0) return null;
 
@@ -575,6 +576,17 @@ export class MultiAgentGraph extends StandardGraph {
     const sourceAgentName =
       typeof handoffSourceName === 'string' ? handoffSourceName : null;
 
+    /** Extract parallel siblings (set by ToolNode for parallel handoffs) */
+    const rawSiblings = toolMessage.additional_kwargs.handoff_parallel_siblings;
+    const siblingIds: string[] = Array.isArray(rawSiblings)
+      ? rawSiblings.filter((s): s is string => typeof s === 'string')
+      : [];
+    /** Convert IDs to display names */
+    const parallelSiblings = siblingIds.map((id) => {
+      const ctx = this.agentContexts.get(id);
+      return ctx?.name ?? id;
+    });
+
     /** Get the tool_call_id to find and filter the AI message's tool call */
     const toolCallId = toolMessage.tool_call_id;
 
@@ -648,7 +660,12 @@ export class MultiAgentGraph extends StandardGraph {
       filteredMessages.push(msg);
     }
 
-    return { filteredMessages, instructions, sourceAgentName };
+    return {
+      filteredMessages,
+      instructions,
+      sourceAgentName,
+      parallelSiblings,
+    };
   }
 
   /**
@@ -736,12 +753,16 @@ export class MultiAgentGraph extends StandardGraph {
         );
 
         if (handoffContext !== null) {
-          const { filteredMessages, instructions, sourceAgentName } =
-            handoffContext;
+          const {
+            filteredMessages,
+            instructions,
+            sourceAgentName,
+            parallelSiblings,
+          } = handoffContext;
 
           /**
            * Set handoff context on the receiving agent.
-           * This updates the system message to include agent identity info.
+           * Uses pre-computed graph position for depth and parallel info.
            */
           const agentContext = this.agentContexts.get(agentId);
           if (
@@ -749,7 +770,7 @@ export class MultiAgentGraph extends StandardGraph {
             sourceAgentName != null &&
             sourceAgentName !== ''
           ) {
-            agentContext.setHandoffContext(sourceAgentName);
+            agentContext.setHandoffContext(sourceAgentName, parallelSiblings);
           }
 
           /** Build messages for the receiving agent */

package/src/index.ts

@@ -12,7 +12,7 @@ export * from './graphs';
 export * from './tools/Calculator';
 export * from './tools/CodeExecutor';
 export * from './tools/ProgrammaticToolCalling';
-export * from './tools/ToolSearchRegex';
+export * from './tools/ToolSearch';
 export * from './tools/handlers';
 export * from './tools/search';
 

package/src/messages/__tests__/tools.test.ts

@@ -41,7 +41,7 @@ describe('Tool Discovery Functions', () => {
     return new ToolMessage({
       content: `Found ${discoveredTools.length} tools`,
       tool_call_id: toolCallId,
-      name: Constants.TOOL_SEARCH_REGEX,
+      name: Constants.TOOL_SEARCH,
       artifact: {
         tool_references: discoveredTools.map((name) => ({
           tool_name: name,
@@ -79,7 +79,7 @@ describe('Tool Discovery Functions', () => {
         createAIMessage('Searching...', [
           {
             id: 'call_1',
-            name: Constants.TOOL_SEARCH_REGEX,
+            name: Constants.TOOL_SEARCH,
             args: { pattern: 'database' },
           },
         ]),
@@ -97,12 +97,12 @@ describe('Tool Discovery Functions', () => {
         createAIMessage('Searching...', [
           {
             id: 'call_1',
-            name: Constants.TOOL_SEARCH_REGEX,
+            name: Constants.TOOL_SEARCH,
             args: { pattern: 'database' },
           },
           {
             id: 'call_2',
-            name: Constants.TOOL_SEARCH_REGEX,
+            name: Constants.TOOL_SEARCH,
             args: { pattern: 'file' },
           },
         ]),
@@ -137,7 +137,7 @@ describe('Tool Discovery Functions', () => {
         new ToolMessage({
           content: 'Some result',
           tool_call_id: 'orphan_call',
-          name: Constants.TOOL_SEARCH_REGEX,
+          name: Constants.TOOL_SEARCH,
         }),
       ];
 
@@ -153,7 +153,7 @@ describe('Tool Discovery Functions', () => {
         createAIMessage('Searching...', [
           {
             id: 'old_call',
-            name: Constants.TOOL_SEARCH_REGEX,
+            name: Constants.TOOL_SEARCH,
             args: { pattern: 'old' },
           },
         ]),
@@ -163,7 +163,7 @@ describe('Tool Discovery Functions', () => {
         createAIMessage('Searching again...', [
           {
             id: 'new_call',
-            name: Constants.TOOL_SEARCH_REGEX,
+            name: Constants.TOOL_SEARCH,
             args: { pattern: 'new' },
           },
         ]),
@@ -182,7 +182,7 @@ describe('Tool Discovery Functions', () => {
         createAIMessage('Working...', [
           {
             id: 'search_call',
-            name: Constants.TOOL_SEARCH_REGEX,
+            name: Constants.TOOL_SEARCH,
             args: { pattern: 'test' },
           },
           { id: 'other_call', name: 'get_weather', args: { city: 'NYC' } },
@@ -202,14 +202,14 @@ describe('Tool Discovery Functions', () => {
         createAIMessage('Searching...', [
           {
             id: 'call_1',
-            name: Constants.TOOL_SEARCH_REGEX,
+            name: Constants.TOOL_SEARCH,
             args: { pattern: 'xyz' },
           },
         ]),
         new ToolMessage({
           content: 'No tools found',
           tool_call_id: 'call_1',
-          name: Constants.TOOL_SEARCH_REGEX,
+          name: Constants.TOOL_SEARCH,
           artifact: {
             tool_references: [],
             metadata: { total_searched: 10, pattern: 'xyz' },
@@ -228,14 +228,14 @@ describe('Tool Discovery Functions', () => {
         createAIMessage('Searching...', [
           {
             id: 'call_1',
-            name: Constants.TOOL_SEARCH_REGEX,
+            name: Constants.TOOL_SEARCH,
             args: { pattern: 'test' },
           },
         ]),
         new ToolMessage({
           content: 'Error occurred',
           tool_call_id: 'call_1',
-          name: Constants.TOOL_SEARCH_REGEX,
+          name: Constants.TOOL_SEARCH,
           // No artifact
         }),
       ];
@@ -251,7 +251,7 @@ describe('Tool Discovery Functions', () => {
         createAIMessage('Searching...', [
           {
             id: 'call_1',
-            name: Constants.TOOL_SEARCH_REGEX,
+            name: Constants.TOOL_SEARCH,
             args: { pattern: 'test' },
           },
         ]),
@@ -271,7 +271,7 @@ describe('Tool Discovery Functions', () => {
         createAIMessage('First search', [
           {
             id: 'first_call',
-            name: Constants.TOOL_SEARCH_REGEX,
+            name: Constants.TOOL_SEARCH,
             args: { pattern: 'first' },
           },
         ]),
@@ -280,7 +280,7 @@ describe('Tool Discovery Functions', () => {
         createAIMessage('Second search', [
           {
             id: 'second_call',
-            name: Constants.TOOL_SEARCH_REGEX,
+            name: Constants.TOOL_SEARCH,
             args: { pattern: 'second' },
           },
         ]),
@@ -301,7 +301,7 @@ describe('Tool Discovery Functions', () => {
         createAIMessage('Searching...', [
           {
             id: 'call_1',
-            name: Constants.TOOL_SEARCH_REGEX,
+            name: Constants.TOOL_SEARCH,
             args: { pattern: 'test' },
           },
         ]),
@@ -335,7 +335,7 @@ describe('Tool Discovery Functions', () => {
         new ToolMessage({
           content: 'Result',
           tool_call_id: 'orphan',
-          name: Constants.TOOL_SEARCH_REGEX,
+          name: Constants.TOOL_SEARCH,
         }),
       ];
 
@@ -364,7 +364,7 @@ describe('Tool Discovery Functions', () => {
         createAIMessage('Working...', [
           {
             id: 'search_call',
-            name: Constants.TOOL_SEARCH_REGEX,
+            name: Constants.TOOL_SEARCH,
             args: { pattern: 'test' },
           },
           { id: 'weather_call', name: 'get_weather', args: { city: 'NYC' } },
@@ -384,7 +384,7 @@ describe('Tool Discovery Functions', () => {
         createAIMessage('Searching...', [
           {
             id: 'old_call',
-            name: Constants.TOOL_SEARCH_REGEX,
+            name: Constants.TOOL_SEARCH,
             args: { pattern: 'old' },
           },
         ]),
@@ -410,7 +410,7 @@ describe('Tool Discovery Functions', () => {
         createAIMessage('Searching...', [
           {
             id: 'call_1',
-            name: Constants.TOOL_SEARCH_REGEX,
+            name: Constants.TOOL_SEARCH,
             args: { pattern: 'test' },
           },
         ]),
@@ -446,7 +446,7 @@ describe('Tool Discovery Functions', () => {
         createAIMessage('Searching...', [
           {
             id: 'call_1',
-            name: Constants.TOOL_SEARCH_REGEX,
+            name: Constants.TOOL_SEARCH,
             args: { pattern: 'test' },
           },
         ]),

package/src/messages/tools.ts

@@ -43,7 +43,7 @@ export function extractToolDiscoveries(messages: BaseMessage[]): string[] {
   for (let i = latestAIParentIndex + 1; i < messages.length; i++) {
     const msg = messages[i];
     if (!(msg instanceof ToolMessage)) continue;
-    if (msg.name !== Constants.TOOL_SEARCH_REGEX) continue;
+    if (msg.name !== Constants.TOOL_SEARCH) continue;
     if (!toolCallIds.has(msg.tool_call_id)) continue;
 
     // This is a tool search result from the current turn
@@ -88,7 +88,7 @@ export function hasToolSearchInCurrentTurn(messages: BaseMessage[]): boolean {
     const msg = messages[i];
     if (
       msg instanceof ToolMessage &&
-      msg.name === Constants.TOOL_SEARCH_REGEX &&
+      msg.name === Constants.TOOL_SEARCH &&
       toolCallIds.has(msg.tool_call_id)
     ) {
       return true;

package/src/scripts/programmatic_exec_agent.ts

@@ -23,7 +23,7 @@ import type { RunnableConfig } from '@langchain/core/runnables';
 import type * as t from '@/types';
 import { createCodeExecutionTool } from '@/tools/CodeExecutor';
 import { createProgrammaticToolCallingTool } from '@/tools/ProgrammaticToolCalling';
-import { createToolSearchRegexTool } from '@/tools/ToolSearchRegex';
+import { createToolSearch } from '@/tools/ToolSearch';
 import { getLLMConfig } from '@/utils/llmConfig';
 import { getArgs } from '@/scripts/args';
 import { Run } from '@/run';
@@ -40,7 +40,7 @@ import {
 
 /**
  * Tool registry only needs business logic tools that require filtering.
- * Special tools (execute_code, run_tools_with_code, tool_search_regex)
+ * Special tools (execute_code, run_tools_with_code, tool_search)
  * are always bound directly to the LLM and don't need registry entries.
  */
 function createAgentToolRegistry(): t.LCToolRegistry {
@@ -73,7 +73,7 @@ async function main(): Promise<void> {
   // Create special tools (PTC, code execution, tool search)
   const codeExecTool = createCodeExecutionTool();
   const ptcTool = createProgrammaticToolCallingTool();
-  const toolSearchTool = createToolSearchRegexTool();
+  const toolSearchTool = createToolSearch();
 
   // Build complete tool list and map
   const allTools = [...mockTools, codeExecTool, ptcTool, toolSearchTool];
@@ -199,7 +199,7 @@ Use the run_tools_with_code tool to do this efficiently - don't call each tool s
   console.log('='.repeat(70));
   console.log('\nKey observations:');
   console.log(
-    '1. LLM only sees tools with allowed_callers including "direct" (get_weather, execute_code, run_tools_with_code, tool_search_regex)'
+    '1. LLM only sees tools with allowed_callers including "direct" (get_weather, execute_code, run_tools_with_code, tool_search)'
   );
   console.log(
     '2. When PTC is invoked, ToolNode automatically injects programmatic tools (get_team_members, get_expenses, get_weather)'

package/src/scripts/{tool_search_regex.ts → tool_search.ts}

@@ -1,7 +1,7 @@
-// src/scripts/tool_search_regex.ts
+// src/scripts/tool_search.ts
 /**
  * Test script for the Tool Search Regex tool.
- * Run with: npm run tool_search_regex
+ * Run with: npm run tool_search
  *
  * Demonstrates runtime registry injection - the tool registry is passed
  * at invocation time, not at initialization time.
@@ -9,7 +9,7 @@
 import { config } from 'dotenv';
 config();
 
-import { createToolSearchRegexTool } from '@/tools/ToolSearchRegex';
+import { createToolSearch } from '@/tools/ToolSearch';
 import type { LCToolRegistry } from '@/types';
 import { createToolSearchToolRegistry } from '@/test/mockTools';
 
@@ -22,7 +22,7 @@ interface RunTestOptions {
 }
 
 async function runTest(
-  searchTool: ReturnType<typeof createToolSearchRegexTool>,
+  searchTool: ReturnType<typeof createToolSearch>,
   testName: string,
   query: string,
   options: RunTestOptions
@@ -82,7 +82,7 @@ async function main(): Promise<void> {
   );
 
   console.log('\nCreating Tool Search Regex tool WITH registry for testing...');
-  const searchTool = createToolSearchRegexTool({ apiKey, toolRegistry });
+  const searchTool = createToolSearch({ apiKey, toolRegistry });
   console.log('Tool created successfully!');
   console.log(
     'Note: In production, ToolNode injects toolRegistry via params when invoked through the graph.\n'

package/src/tools/ToolNode.ts

@@ -132,7 +132,7 @@ export class ToolNode<T = any> extends RunnableCallable<T, T> {
           toolMap,
           toolDefs,
         };
-      } else if (call.name === Constants.TOOL_SEARCH_REGEX) {
+      } else if (call.name === Constants.TOOL_SEARCH) {
         invokeParams = {
           ...invokeParams,
           toolRegistry: this.toolRegistry,
@@ -346,11 +346,29 @@ export class ToolNode<T = any> extends RunnableCallable<T, T> {
        * This enables LLM-initiated parallel execution when calling multiple
        * transfer tools simultaneously.
        */
-      const sends = handoffCommands.map((cmd) => {
-        /** Extract destination - handle both string and array formats */
+
+      /** Collect all destinations for sibling tracking */
+      const allDestinations = handoffCommands.map((cmd) => {
         const goto = cmd.goto;
-        const destination =
-          typeof goto === 'string' ? goto : (goto as string[])[0];
+        return typeof goto === 'string' ? goto : (goto as string[])[0];
+      });
+
+      const sends = handoffCommands.map((cmd, idx) => {
+        const destination = allDestinations[idx];
+        /** Get siblings (other destinations, not this one) */
+        const siblings = allDestinations.filter((d) => d !== destination);
+
+        /** Add siblings to ToolMessage additional_kwargs */
+        const update = cmd.update as { messages?: BaseMessage[] } | undefined;
+        if (update && update.messages) {
+          for (const msg of update.messages) {
+            if (msg.getType() === 'tool') {
+              (msg as ToolMessage).additional_kwargs.handoff_parallel_siblings =
+                siblings;
+            }
+          }
+        }
+
         return new Send(destination, cmd.update);
       });