@librechat/agents 3.1.24 → 3.1.26

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

@@ -1,5 +1,6 @@
 import { DynamicStructuredTool } from '@langchain/core/tools';
 import type * as t from '@/types';
+import { Constants } from '@/common';
 export declare const imageExtRegex: RegExp;
 export declare const getCodeBaseURL: () => string;
 export declare const CodeExecutionToolSchema: {
@@ -24,5 +25,33 @@ export declare const CodeExecutionToolSchema: {
     };
     readonly required: readonly ["lang", "code"];
 };
+export declare const CodeExecutionToolDescription: string;
+export declare const CodeExecutionToolName = Constants.EXECUTE_CODE;
+export declare const CodeExecutionToolDefinition: {
+    readonly name: Constants.EXECUTE_CODE;
+    readonly description: string;
+    readonly schema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly lang: {
+                readonly type: "string";
+                readonly enum: readonly ["py", "js", "ts", "c", "cpp", "java", "php", "rs", "go", "d", "f90", "r"];
+                readonly description: "The programming language or runtime to execute the code in.";
+            };
+            readonly code: {
+                readonly type: "string";
+                readonly description: "The complete, self-contained code to execute, without any truncation or minimization.\n- The environment is stateless; variables and imports don't persist between executions.\n- Generated files from previous executions are automatically available in \"/mnt/data/\".\n- Files from previous executions are automatically available and can be modified in place.\n- Input code **IS ALREADY** displayed to the user, so **DO NOT** repeat it in your response unless asked.\n- Output code **IS NOT** displayed to the user, so **DO** write all desired output explicitly.\n- IMPORTANT: You MUST explicitly print/output ALL results you want the user to see.\n- py: This is not a Jupyter notebook environment. Use `print()` for all outputs.\n- py: Matplotlib: Use `plt.savefig()` to save plots as files.\n- js: use the `console` or `process` methods for all outputs.\n- r: IMPORTANT: No X11 display available. ALL graphics MUST use Cairo library (library(Cairo)).\n- Other languages: use appropriate output functions.";
+            };
+            readonly args: {
+                readonly type: "array";
+                readonly items: {
+                    readonly type: "string";
+                };
+                readonly description: "Additional arguments to execute the code with. This should only be used if the input code requires additional arguments to run.";
+            };
+        };
+        readonly required: readonly ["lang", "code"];
+    };
+};
 declare function createCodeExecutionTool(params?: t.CodeExecutionToolParams): DynamicStructuredTool;
 export { createCodeExecutionTool };

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

@@ -64,3 +64,40 @@ export declare const WebSearchToolSchema: {
     };
     readonly required: readonly ["query"];
 };
+export declare const WebSearchToolName = "web_search";
+export declare const WebSearchToolDescription = "Real-time search. Results have required citation anchors.\n\nNote: Use ONCE per reply unless instructed otherwise.\n\nAnchors:\n- \\ue202turnXtypeY\n- X = turn idx, type = 'search' | 'news' | 'image' | 'ref', Y = item idx\n\nSpecial Markers:\n- \\ue203...\\ue204 \u2014 highlight start/end of cited text (for Standalone or Group citations)\n- \\ue200...\\ue201 \u2014 group block (e.g. \\ue200\\ue202turn0search1\\ue202turn0news2\\ue201)\n\n**CITE EVERY NON-OBVIOUS FACT/QUOTE:**\nUse anchor marker(s) immediately after the statement:\n- Standalone: \"Pure functions produce same output. \\ue202turn0search0\"\n- Standalone (multiple): \"Today's News \\ue202turn0search0\\ue202turn0news0\"\n- Highlight: \"\\ue203Highlight text.\\ue204\\ue202turn0news1\"\n- Group: \"Sources. \\ue200\\ue202turn0search0\\ue202turn0news1\\ue201\"\n- Group Highlight: \"\\ue203Highlight for group.\\ue204 \\ue200\\ue202turn0search0\\ue202turn0news1\\ue201\"\n- Image: \"See photo \\ue202turn0image0.\"\n\n**NEVER use markdown links, [1], or footnotes. CITE ONLY with anchors provided.**";
+export declare const WebSearchToolDefinition: {
+    readonly name: "web_search";
+    readonly description: "Real-time search. Results have required citation anchors.\n\nNote: Use ONCE per reply unless instructed otherwise.\n\nAnchors:\n- \\ue202turnXtypeY\n- X = turn idx, type = 'search' | 'news' | 'image' | 'ref', Y = item idx\n\nSpecial Markers:\n- \\ue203...\\ue204 — highlight start/end of cited text (for Standalone or Group citations)\n- \\ue200...\\ue201 — group block (e.g. \\ue200\\ue202turn0search1\\ue202turn0news2\\ue201)\n\n**CITE EVERY NON-OBVIOUS FACT/QUOTE:**\nUse anchor marker(s) immediately after the statement:\n- Standalone: \"Pure functions produce same output. \\ue202turn0search0\"\n- Standalone (multiple): \"Today's News \\ue202turn0search0\\ue202turn0news0\"\n- Highlight: \"\\ue203Highlight text.\\ue204\\ue202turn0news1\"\n- Group: \"Sources. \\ue200\\ue202turn0search0\\ue202turn0news1\\ue201\"\n- Group Highlight: \"\\ue203Highlight for group.\\ue204 \\ue200\\ue202turn0search0\\ue202turn0news1\\ue201\"\n- Image: \"See photo \\ue202turn0image0.\"\n\n**NEVER use markdown links, [1], or footnotes. CITE ONLY with anchors provided.**";
+    readonly schema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly query: {
+                readonly type: "string";
+                readonly description: string;
+            };
+            readonly date: {
+                readonly type: "string";
+                readonly enum: DATE_RANGE[];
+                readonly description: "Date range for search results.";
+            };
+            readonly country: {
+                readonly type: "string";
+                readonly description: string;
+            };
+            readonly images: {
+                readonly type: "boolean";
+                readonly description: "Whether to also run an image search.";
+            };
+            readonly videos: {
+                readonly type: "boolean";
+                readonly description: "Whether to also run a video search.";
+            };
+            readonly news: {
+                readonly type: "boolean";
+                readonly description: "Whether to also run a news search.";
+            };
+        };
+        readonly required: readonly ["query"];
+    };
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@librechat/agents",
-  "version": "3.1.24",
+  "version": "3.1.26",
   "main": "./dist/cjs/main.cjs",
   "module": "./dist/esm/main.mjs",
   "types": "./dist/types/index.d.ts",

package/src/tools/Calculator.ts

@@ -1,7 +1,11 @@
 import { Tool } from '@langchain/core/tools';
 import * as math from 'mathjs';
 
-/** Calculator tool schema for structured input */
+export const CalculatorToolName = 'calculator';
+
+export const CalculatorToolDescription =
+  'Useful for getting the result of a math expression. The input to this tool should be a valid mathematical expression that could be executed by a simple calculator.';
+
 export const CalculatorSchema = {
   type: 'object',
   properties: {
@@ -13,6 +17,12 @@ export const CalculatorSchema = {
   required: ['input'],
 } as const;
 
+export const CalculatorToolDefinition = {
+  name: CalculatorToolName,
+  description: CalculatorToolDescription,
+  schema: CalculatorSchema,
+} as const;
+
 export class Calculator extends Tool {
   static lc_name(): string {
     return 'Calculator';
@@ -22,7 +32,7 @@ export class Calculator extends Tool {
     return [...super.lc_namespace, 'calculator'];
   }
 
-  name = 'calculator';
+  name = CalculatorToolName;
 
   async _call(input: string): Promise<string> {
     try {
@@ -32,6 +42,5 @@ export class Calculator extends Tool {
     }
   }
 
-  description =
-    'Useful for getting the result of a math expression. The input to this tool should be a valid mathematical expression that could be executed by a simple calculator.';
+  description = CalculatorToolDescription;
 }

package/src/tools/CodeExecutor.ts

@@ -74,6 +74,23 @@ const EXEC_ENDPOINT = `${baseEndpoint}/exec`;
 
 type SupportedLanguage = (typeof SUPPORTED_LANGUAGES)[number];
 
+export const CodeExecutionToolDescription = `
+Runs code and returns stdout/stderr output from a stateless execution environment, similar to running scripts in a command-line interface. Each execution is isolated and independent.
+
+Usage:
+- No network access available.
+- Generated files are automatically delivered; **DO NOT** provide download links.
+- NEVER use this tool to execute malicious code.
+`.trim();
+
+export const CodeExecutionToolName = Constants.EXECUTE_CODE;
+
+export const CodeExecutionToolDefinition = {
+  name: CodeExecutionToolName,
+  description: CodeExecutionToolDescription,
+  schema: CodeExecutionToolSchema,
+} as const;
+
 function createCodeExecutionTool(
   params: t.CodeExecutionToolParams = {}
 ): DynamicStructuredTool {
@@ -86,15 +103,6 @@ function createCodeExecutionTool(
     throw new Error('No API key provided for code execution tool.');
   }
 
-  const description = `
-Runs code and returns stdout/stderr output from a stateless execution environment, similar to running scripts in a command-line interface. Each execution is isolated and independent.
-
-Usage:
-- No network access available.
-- Generated files are automatically delivered; **DO NOT** provide download links.
-- NEVER use this tool to execute malicious code.
-`.trim();
-
   return tool(
     async (rawInput, config) => {
       const { lang, code, ...rest } = rawInput as {
@@ -229,8 +237,8 @@ Usage:
       }
     },
     {
-      name: Constants.EXECUTE_CODE,
-      description,
+      name: CodeExecutionToolName,
+      description: CodeExecutionToolDescription,
       schema: CodeExecutionToolSchema,
       responseFormat: Constants.CONTENT_AND_ARTIFACT,
     }

package/src/tools/ToolNode.ts

@@ -319,8 +319,9 @@ export class ToolNode<T = any> extends RunnableCallable<T, T> {
             : JSON.stringify(result.content);
         toolMessage = new ToolMessage({
           status: 'success',
-          content: contentString,
           name: toolName,
+          content: contentString,
+          artifact: result.artifact,
           tool_call_id: result.toolCallId,
         });
       }

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,
     }