@librechat/agents 3.1.88 → 3.1.90

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

@@ -1,8 +1,15 @@
 import { DynamicStructuredTool } from '@langchain/core/tools';
 import type * as t from '@/types';
 import { Constants } from '@/common';
+export { appendCodeSessionFileSummary, stripCodeSessionFileSummary, } from '@/tools/CodeSessionFileSummary';
 export declare const getCodeBaseURL: () => string;
 export declare const emptyOutputMessage = "stdout: Empty. Ensure you're writing output explicitly.\n";
+export declare const CODE_ARTIFACT_PATH_GUIDANCE = "Persist handoff artifacts in `/mnt/data` with standard extensions (.json/.txt/.csv/.tsv/.log/.parquet/.png/.jpg/.pdf/.xlsx); failed executions do not register new files; `/tmp` and odd extensions are same-call scratch only, not later-call storage.";
+export declare const BASH_SHELL_GUIDANCE = "Bash: multi-line files use heredoc/printf; run Python via python3 -c/heredoc, not bare Python.";
+export declare const TMP_SCRATCH_OUTPUT_REMINDER = "Note: /tmp files are same-call scratch only and were not persisted; use /mnt/data for files needed later.";
+export declare const FAILED_EXECUTION_FILE_REMINDER = "Note: any files written during this failed call were not registered for later calls; fix the error and rerun before relying on them.";
+export declare function appendTmpScratchReminder(output: string, code: string): string;
+export declare function appendFailedExecutionFileReminder(output: string, code: string): string;
 export declare const CodeExecutionToolSchema: {
     readonly type: "object";
     readonly properties: {
@@ -13,7 +20,7 @@ export declare const CodeExecutionToolSchema: {
         };
         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 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- Prior /mnt/data files are available and can be modified in place.\n- Persist handoff artifacts in `/mnt/data` with standard extensions (.json/.txt/.csv/.tsv/.log/.parquet/.png/.jpg/.pdf/.xlsx); failed executions do not register new files; `/tmp` and odd extensions are same-call scratch only, not later-call storage.\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";
@@ -45,7 +52,7 @@ export declare const CodeExecutionToolDefinition: {
             };
             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 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- Prior /mnt/data files are available and can be modified in place.\n- Persist handoff artifacts in `/mnt/data` with standard extensions (.json/.txt/.csv/.tsv/.log/.parquet/.png/.jpg/.pdf/.xlsx); failed executions do not register new files; `/tmp` and odd extensions are same-call scratch only, not later-call storage.\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";
@@ -58,5 +65,5 @@ export declare const CodeExecutionToolDefinition: {
         readonly required: readonly ["lang", "code"];
     };
 };
-declare function createCodeExecutionTool(params?: t.CodeExecutionToolParams): DynamicStructuredTool;
+declare function createCodeExecutionTool(params?: t.CodeExecutionToolParams | null): DynamicStructuredTool;
 export { createCodeExecutionTool };

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

@@ -0,0 +1,3 @@
+import type * as t from '@/types';
+export declare function stripCodeSessionFileSummary(output: string): string;
+export declare function appendCodeSessionFileSummary(output: string, files: t.FileRefs | undefined): string;

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

@@ -87,14 +87,14 @@ export declare function executeTools(toolCalls: t.PTCToolCall[], toolMap: t.Tool
 /**
  * Formats the completed response for the agent.
  *
- * Output is stdout/stderr only — see `CodeExecutor.ts`. The
- * artifact still carries every file so the host's session map
- * stays in sync; the LLM doesn't see them in the tool result text.
+ * Output includes stdout/stderr plus a compact session-file summary
+ * when artifacts were persisted. The artifact still carries every
+ * file so the host's session map stays in sync.
  *
  * @param response - The completed API response
  * @returns Tuple of [formatted string, artifact]
  */
-export declare function formatCompletedResponse(response: t.ProgrammaticExecutionResponse): [string, t.ProgrammaticExecutionArtifact];
+export declare function formatCompletedResponse(response: t.ProgrammaticExecutionResponse, sourceCode?: string): [string, t.ProgrammaticExecutionArtifact];
 /**
  * Creates a Programmatic Tool Calling tool for complex multi-tool workflows.
  *

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

@@ -16,11 +16,13 @@ export type SubagentExecuteParams = {
      */
     parentToolCallId?: string;
     /**
-     * Snapshot of the parent invocation's `config.configurable` at the
-     * spawn-tool call site. Inherited verbatim into the child workflow's
-     * `configurable` so host-set fields (`requestBody`, `user`,
-     * `userMCPAuthMap`, etc.) propagate — fixing MCP body-placeholder
-     * substitution and per-user lookups for subagent tool calls.
+     * Snapshot of the parent invocation's host `config.configurable` at
+     * the spawn-tool call site. Host-set fields (`requestBody`, `user`,
+     * `userMCPAuthMap`, etc.) propagate into the child workflow's
+     * `configurable` — fixing MCP body-placeholder substitution and
+     * per-user lookups for subagent tool calls. LangGraph runtime keys
+     * (`__pregel_*`, checkpoint bookkeeping) are intentionally not
+     * inherited; the child graph recreates its own runtime config.
      *
      * Inheritance details (verified empirically against LangGraph):
      *   - host-set keys propagate as-is into the child's tool dispatches;
@@ -120,6 +122,7 @@ export declare class SubagentExecutor {
      */
     private createForwarderCallback;
 }
+export declare function sanitizeForwardedSubagentUpdateData(eventName: string, data: unknown): unknown;
 /**
  * Produces a short single-line label for an arbitrary forwarded child event.
  * Used to populate {@link SubagentUpdateEvent.label} so the host UI can show

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

@@ -44,6 +44,13 @@ export type EagerEventToolExecution = {
     args: Record<string, unknown>;
     request: ToolCallRequest;
     promise: Promise<EagerEventToolExecutionOutcome>;
+    /**
+     * True when the streaming eager path already emitted the user-visible
+     * ON_RUN_STEP_COMPLETED event for this call. ToolNode still consumes the
+     * result later to mutate graph state in provider-safe order, but skips
+     * duplicate completion emission.
+     */
+    completionDispatched?: boolean;
 };
 export type EagerEventToolCallChunkState = {
     id?: string;
@@ -160,6 +167,8 @@ export type ToolEndEvent = {
     /** The content index of the tool call */
     index: number;
     type?: 'tool_call';
+    /** True when the stream eager path surfaced this completion before ToolNode finalized graph state. */
+    eager?: boolean;
 };
 /**
  * Closed set of resource kinds for sandbox file caching. Defined as a
@@ -275,9 +284,8 @@ export type FileRef = {
      * `true` when the codeapi sandbox echoed this entry as an unchanged
      * passthrough of an input the caller already owns (skill files,
      * downloaded inputs whose hash matched the baseline, inherited
-     * `.dirkeep` markers). The tool-result formatter renders these as
-     * "Available files" rather than "Generated files" so the LLM doesn't
-     * conflate infrastructure inputs with newly-produced outputs.
+     * `.dirkeep` markers). The host can use this flag to skip
+     * post-processing work for files the caller already owns.
      */
     inherited?: true;
 };

package/dist/types/utils/events.d.ts

@@ -4,7 +4,7 @@ import type { AgentLogEvent } from '@/types/graph';
  * Safely dispatches a custom event and properly awaits it to avoid
  * race conditions where events are dispatched after run cleanup.
  */
-export declare function safeDispatchCustomEvent(event: string, payload: unknown, config?: RunnableConfig): Promise<void>;
+export declare function safeDispatchCustomEvent(event: string, payload: unknown, config?: RunnableConfig): Promise<boolean | void>;
 /**
  * Fire-and-forget diagnostic log event.
  * Debug-level logs are gated behind AGENT_DEBUG_LOGGING=true to avoid

package/package.json

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