@librechat/agents 3.1.25 → 3.1.27

package/src/tools/ProgrammaticToolCalling.ts

@@ -32,7 +32,7 @@ const DEFAULT_TIMEOUT = 60000;
 // Schema
 // ============================================================================
 
-const ProgrammaticToolCallingSchema = {
+export const ProgrammaticToolCallingSchema = {
   type: 'object',
   properties: {
     code: {
@@ -80,6 +80,34 @@ Rules:
   required: ['code'],
 } as const;
 
+export const ProgrammaticToolCallingName = Constants.PROGRAMMATIC_TOOL_CALLING;
+
+export const ProgrammaticToolCallingDescription = `
+Run tools via Python code. Auto-wrapped in async context—just use \`await\` directly.
+
+CRITICAL - STATELESS: Each call is a fresh interpreter. Variables/imports do NOT persist.
+Complete your ENTIRE workflow in ONE call: fetch → process → save. No splitting across calls.
+
+Rules:
+- Everything in ONE code block—no state carries over between executions
+- Do NOT define \`async def main()\` or call \`asyncio.run()\`—just write code with await
+- Tools are pre-defined—DO NOT write function definitions
+- Only \`print()\` output returns; tool results are raw dicts/lists/strings
+- Generated files are automatically available in /mnt/data/ for subsequent executions
+- Tool names normalized: hyphens→underscores, keywords get \`_tool\` suffix
+
+When to use: loops, conditionals, parallel (\`asyncio.gather\`), multi-step pipelines.
+
+Example (complete pipeline):
+  data = await query_db(sql="..."); df = process(data); await save_to_sheet(data=df); print("Done")
+`.trim();
+
+export const ProgrammaticToolCallingDefinition = {
+  name: ProgrammaticToolCallingName,
+  description: ProgrammaticToolCallingDescription,
+  schema: ProgrammaticToolCallingSchema,
+} as const;
+
 // ============================================================================
 // Helper Functions
 // ============================================================================

package/src/tools/ToolSearch.ts

@@ -33,6 +33,49 @@ config();
 /** Maximum allowed regex pattern length */
 const MAX_PATTERN_LENGTH = 200;
 
+export const ToolSearchToolName = Constants.TOOL_SEARCH;
+
+export const ToolSearchToolDescription =
+  'Searches deferred tools using BM25 ranking. Multi-word queries supported. Use mcp_server param to filter by server.';
+
+export const ToolSearchToolSchema = {
+  type: 'object',
+  properties: {
+    query: {
+      type: 'string',
+      maxLength: MAX_PATTERN_LENGTH,
+      default: '',
+      description:
+        'Search term to find in tool names and descriptions. Case-insensitive substring matching. Optional if mcp_server is provided.',
+    },
+    fields: {
+      type: 'array',
+      items: { type: 'string', enum: ['name', 'description', 'parameters'] },
+      default: ['name', 'description'],
+      description: 'Which fields to search. Default: name and description',
+    },
+    max_results: {
+      type: 'integer',
+      minimum: 1,
+      maximum: 50,
+      default: 10,
+      description: 'Maximum number of matching tools to return',
+    },
+    mcp_server: {
+      oneOf: [{ type: 'string' }, { type: 'array', items: { type: 'string' } }],
+      description:
+        'Filter to tools from specific MCP server(s). Can be a single server name or array of names. If provided without a query, lists all tools from those servers.',
+    },
+  },
+  required: [],
+} as const;
+
+export const ToolSearchToolDefinition = {
+  name: ToolSearchToolName,
+  description: ToolSearchToolDescription,
+  schema: ToolSearchToolSchema,
+} as const;
+
 /** Maximum allowed regex nesting depth */
 const MAX_REGEX_COMPLEXITY = 5;
 

package/src/tools/search/schema.ts

@@ -80,3 +80,34 @@ export const WebSearchToolSchema = {
   },
   required: ['query'],
 } as const;
+
+export const WebSearchToolName = 'web_search';
+
+export const WebSearchToolDescription = `Real-time search. Results have required citation anchors.
+
+Note: Use ONCE per reply unless instructed otherwise.
+
+Anchors:
+- \\ue202turnXtypeY
+- X = turn idx, type = 'search' | 'news' | 'image' | 'ref', Y = item idx
+
+Special Markers:
+- \\ue203...\\ue204 — highlight start/end of cited text (for Standalone or Group citations)
+- \\ue200...\\ue201 — group block (e.g. \\ue200\\ue202turn0search1\\ue202turn0news2\\ue201)
+
+**CITE EVERY NON-OBVIOUS FACT/QUOTE:**
+Use anchor marker(s) immediately after the statement:
+- Standalone: "Pure functions produce same output. \\ue202turn0search0"
+- Standalone (multiple): "Today's News \\ue202turn0search0\\ue202turn0news0"
+- Highlight: "\\ue203Highlight text.\\ue204\\ue202turn0news1"
+- Group: "Sources. \\ue200\\ue202turn0search0\\ue202turn0news1\\ue201"
+- Group Highlight: "\\ue203Highlight for group.\\ue204 \\ue200\\ue202turn0search0\\ue202turn0news1\\ue201"
+- Image: "See photo \\ue202turn0image0."
+
+**NEVER use markdown links, [1], or footnotes. CITE ONLY with anchors provided.**`;
+
+export const WebSearchToolDefinition = {
+  name: WebSearchToolName,
+  description: WebSearchToolDescription,
+  schema: WebSearchToolSchema,
+} as const;

package/src/tools/search/tool.ts

@@ -2,13 +2,15 @@ import { tool, DynamicStructuredTool } from '@langchain/core/tools';
 import type { RunnableConfig } from '@langchain/core/runnables';
 import type * as t from './types';
 import {
-  DATE_RANGE,
-  querySchema,
-  dateSchema,
+  WebSearchToolDescription,
+  WebSearchToolName,
   countrySchema,
   imagesSchema,
   videosSchema,
+  querySchema,
+  dateSchema,
   newsSchema,
+  DATE_RANGE,
 } from './schema';
 import { createSearchAPI, createSourceProcessor } from './search';
 import { createSerperScraper } from './serper-scraper';
@@ -295,30 +297,8 @@ function createTool({
       return [output, { [Constants.WEB_SEARCH]: data }];
     },
     {
-      name: Constants.WEB_SEARCH,
-      description: `Real-time search. Results have required citation anchors.
-
-Note: Use ONCE per reply unless instructed otherwise.
-
-Anchors:
-- \\ue202turnXtypeY
-- X = turn idx, type = 'search' | 'news' | 'image' | 'ref', Y = item idx
-
-Special Markers:
-- \\ue203...\\ue204 — highlight start/end of cited text (for Standalone or Group citations)
-- \\ue200...\\ue201 — group block (e.g. \\ue200\\ue202turn0search1\\ue202turn0news2\\ue201)
-
-**CITE EVERY NON-OBVIOUS FACT/QUOTE:**
-Use anchor marker(s) immediately after the statement:
-- Standalone: "Pure functions produce same output. \\ue202turn0search0"
-- Standalone (multiple): "Today's News \\ue202turn0search0\\ue202turn0news0"
-- Highlight: "\\ue203Highlight text.\\ue204\\ue202turn0news1"
-- Group: "Sources. \\ue200\\ue202turn0search0\\ue202turn0news1\\ue201"
-- Group Highlight: "\\ue203Highlight for group.\\ue204 \\ue200\\ue202turn0search0\\ue202turn0news1\\ue201"
-- Image: "See photo \\ue202turn0image0."
-
-**NEVER use markdown links, [1], or footnotes. CITE ONLY with anchors provided.**
-`.trim(),
+      name: WebSearchToolName,
+      description: WebSearchToolDescription,
       schema: schema,
       responseFormat: Constants.CONTENT_AND_ARTIFACT,
     }