@librechat/agents 3.9.4 → 3.9.6

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

@@ -464,6 +464,14 @@ export type ArtifactDeliveryFailure = {
     delivered: number;
     failed: number;
 };
+export type ArtifactTruncationReason = 'max_files' | 'depth' | 'size' | 'path' | 'unreadable';
+export type ArtifactTruncation = {
+    code: 'artifact_truncated';
+    reasons: Partial<Record<ArtifactTruncationReason, number>>;
+    /** Up to 20 relative paths omitted from the response. */
+    skipped: string[];
+    skipped_count: number;
+};
 export type ExecuteResult = {
     /**
      * Execution session id — the (transient) sandbox run that produced
@@ -477,6 +485,7 @@ export type ExecuteResult = {
     /** Persisted input paths explicitly removed during this execution. */
     deleted_files?: string[];
     artifact_delivery?: ArtifactDeliveryFailure;
+    artifact_truncation?: ArtifactTruncation;
     /**
      * Durable runtime session id echoed by a stateful Code API backend
      * (hash of tenant+user+hint). Additive; absent on stateless servers.
@@ -1245,6 +1254,7 @@ export type ProgrammaticExecutionResponse = {
     /** Persisted input paths explicitly removed during this execution. */
     deleted_files?: string[];
     artifact_delivery?: ArtifactDeliveryFailure;
+    artifact_truncation?: ArtifactTruncation;
     /** Durable runtime session echo from a stateful backend (additive). */
     runtime_session_id?: string;
     runtime_status?: 'new' | 'reused';
@@ -1261,6 +1271,7 @@ export type ProgrammaticExecutionArtifact = {
     /** Persisted input paths explicitly removed during this execution. */
     deleted_files?: string[];
     artifact_delivery?: ArtifactDeliveryFailure;
+    artifact_truncation?: ArtifactTruncation;
     /** Durable runtime session echo from a stateful backend (additive). */
     runtime_session_id?: string;
     runtime_status?: 'new' | 'reused';
@@ -1328,6 +1339,7 @@ export type CodeExecutionArtifact = {
     /** Persisted input paths explicitly removed during this execution. */
     deleted_files?: string[];
     artifact_delivery?: ArtifactDeliveryFailure;
+    artifact_truncation?: ArtifactTruncation;
     /** Durable runtime session echo from a stateful backend (additive). */
     runtime_session_id?: string;
     runtime_status?: 'new' | 'reused';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@librechat/agents",
-  "version": "3.9.4",
+  "version": "3.9.6",
   "reova": {
     "enabled": true,
     "endpoint": "https://telemetry.reo.dev/data"

package/src/stream.ts

@@ -56,6 +56,7 @@ import {
   truncateToolResultContent,
 } from '@/utils/truncation';
 import { resolveToolOutcome, outcomeFieldsFromResult } from '@/tools/intentArg';
+import { formatToolErrorContent } from '@/tools/toolErrorContent';
 import { snapshotValidatedModelChunk } from '@/graphs/acceptedModelResponse';
 import { TOOL_OUTPUT_REF_PATTERN } from '@/tools/toolOutputReferences';
 import { PreparedSubagentError } from '@/tools/preparedSubagents';
@@ -940,9 +941,10 @@ async function dispatchEagerToolCompletions(args: {
     }
     let output: string;
     if (result.status === 'error') {
-      output = truncateToolResultContent(
-        `Error: ${result.errorMessage ?? 'Unknown error'}\n Please fix your mistakes.`,
-        maxToolResultChars
+      output = formatToolErrorContent(
+        result.errorMessage,
+        maxToolResultChars,
+        graph.config?.signal
       );
     } else if (typeof result.content === 'string') {
       output = truncateToolResultContent(result.content, maxToolResultChars);

package/src/tools/ArtifactTruncation.ts

@@ -0,0 +1,85 @@
+import type { ArtifactTruncation, ArtifactTruncationReason } from '@/types';
+
+const MAX_REPORTED_TRUNCATED_PATHS = 20;
+const ARTIFACT_TRUNCATION_REASONS = new Set<string>([
+  'max_files',
+  'depth',
+  'size',
+  'path',
+  'unreadable',
+]);
+
+function isNonNegativeInteger(value: unknown): value is number {
+  return typeof value === 'number' && Number.isSafeInteger(value) && value >= 0;
+}
+
+export function normalizeArtifactTruncation(
+  value: unknown
+): ArtifactTruncation | undefined {
+  if (value == null || typeof value !== 'object' || Array.isArray(value)) {
+    return undefined;
+  }
+
+  const candidate = value as Partial<ArtifactTruncation>;
+  if (
+    candidate.code !== 'artifact_truncated' ||
+    !isNonNegativeInteger(candidate.skipped_count) ||
+    candidate.skipped_count === 0 ||
+    candidate.reasons == null ||
+    typeof candidate.reasons !== 'object' ||
+    Array.isArray(candidate.reasons) ||
+    !Array.isArray(candidate.skipped) ||
+    candidate.skipped.length > MAX_REPORTED_TRUNCATED_PATHS ||
+    candidate.skipped.length > candidate.skipped_count ||
+    candidate.skipped.some((path) => typeof path !== 'string')
+  ) {
+    return undefined;
+  }
+
+  const reasons: ArtifactTruncation['reasons'] = {};
+  let reasonTotal = 0;
+  for (const [reason, count] of Object.entries(candidate.reasons)) {
+    if (
+      !ARTIFACT_TRUNCATION_REASONS.has(reason) ||
+      !isNonNegativeInteger(count)
+    ) {
+      return undefined;
+    }
+    reasonTotal += count;
+    if (reasonTotal > candidate.skipped_count) {
+      return undefined;
+    }
+    reasons[reason as ArtifactTruncationReason] = count;
+  }
+
+  if (reasonTotal !== candidate.skipped_count) {
+    return undefined;
+  }
+
+  return {
+    code: candidate.code,
+    reasons,
+    skipped: [...candidate.skipped],
+    skipped_count: candidate.skipped_count,
+  };
+}
+
+export function appendArtifactTruncationWarning(
+  output: string,
+  truncation: ArtifactTruncation | undefined
+): string {
+  if (truncation == null) {
+    return output;
+  }
+
+  const reasons = Object.entries(truncation.reasons)
+    .map(([reason, count]) => `${reason}: ${count}`)
+    .join(', ');
+  const shown = truncation.skipped.length;
+  const paths =
+    shown > 0
+      ? ` Not delivered: ${truncation.skipped.join(', ')}${shown < truncation.skipped_count ? ` (${shown} of ${truncation.skipped_count} shown)` : ''}.`
+      : '';
+  const warning = `Note: ${truncation.skipped_count} file(s) were omitted from delivery${reasons ? ` (${reasons})` : ''}.${paths} Write fewer files per execution or combine them into an archive. The code itself ran; do not rerun automatically because it may have had side effects.`;
+  return `${output.trimEnd()}\n${warning}\n`;
+}

package/src/tools/BashExecutor.ts

@@ -23,14 +23,18 @@ import {
   appendArtifactDeliveryWarning,
   normalizeArtifactDeliveryFailure,
 } from '@/tools/ArtifactDelivery';
-import { logCodeApiDiagnostic } from '@/tools/diagnostics';
+import {
+  appendArtifactTruncationWarning,
+  normalizeArtifactTruncation,
+} from '@/tools/ArtifactTruncation';
 import { appendExecutionArtifactFileSummary } from '@/tools/CodeSessionFileSummary';
 import { resolveAttachedWorkspaceInstanceId } from '@/tools/workspaceIdentity';
+import { prepareBashProgrammaticCode } from './BashProgrammaticToolCalling';
+import { logCodeApiDiagnostic } from '@/tools/diagnostics';
+import { makeRequest } from './ProgrammaticToolCalling';
 import { resolveFetchProxyAgent } from '@/utils/proxy';
 import { INTENT_PROPERTY } from '@/tools/intentArg';
 import { Constants } from '@/common';
-import { prepareBashProgrammaticCode } from './BashProgrammaticToolCalling';
-import { makeRequest } from './ProgrammaticToolCalling';
 
 config();
 
@@ -407,6 +411,13 @@ function createBashExecutionTool(
           outputWithReminder,
           artifactDelivery
         );
+        const artifactTruncation = normalizeArtifactTruncation(
+          result.artifact_truncation
+        );
+        const outputWithWarnings = appendArtifactTruncationWarning(
+          outputWithDeliveryWarning,
+          artifactTruncation
+        );
         const hasFiles = result.files != null && result.files.length > 0;
         const deletionEcho =
           result.deleted_files != null
@@ -422,11 +433,11 @@ function createBashExecutionTool(
         return [
           hasWorkspace
             ? appendExecutionArtifactFileSummary(
-              outputWithDeliveryWarning,
+              outputWithWarnings,
               result.files
             )
             : appendCodeSessionFileSummary(
-              outputWithDeliveryWarning,
+              outputWithWarnings,
               result.files
             ),
           (hasFiles
@@ -436,6 +447,9 @@ function createBashExecutionTool(
               ...(artifactDelivery != null
                 ? { artifact_delivery: artifactDelivery }
                 : {}),
+              ...(artifactTruncation != null
+                ? { artifact_truncation: artifactTruncation }
+                : {}),
               ...deletionEcho,
               ...runtimeEcho,
             }
@@ -444,6 +458,9 @@ function createBashExecutionTool(
               ...(artifactDelivery != null
                 ? { artifact_delivery: artifactDelivery }
                 : {}),
+              ...(artifactTruncation != null
+                ? { artifact_truncation: artifactTruncation }
+                : {}),
               ...deletionEcho,
               ...runtimeEcho,
             }) satisfies t.CodeExecutionArtifact,

package/src/tools/CodeExecutor.ts

@@ -9,6 +9,10 @@ import {
   appendArtifactDeliveryWarning,
   normalizeArtifactDeliveryFailure,
 } from '@/tools/ArtifactDelivery';
+import {
+  appendArtifactTruncationWarning,
+  normalizeArtifactTruncation,
+} from '@/tools/ArtifactTruncation';
 import {
   describeCodeApiError,
   logCodeApiDiagnostic,
@@ -671,6 +675,13 @@ function createCodeExecutionTool(
           outputWithReminder,
           artifactDelivery
         );
+        const artifactTruncation = normalizeArtifactTruncation(
+          result.artifact_truncation
+        );
+        const outputWithWarnings = appendArtifactTruncationWarning(
+          outputWithDeliveryWarning,
+          artifactTruncation
+        );
         const hasFiles = result.files != null && result.files.length > 0;
         const deletionEcho =
           result.deleted_files != null
@@ -687,7 +698,7 @@ function createCodeExecutionTool(
             }
             : {};
         return [
-          appendCodeSessionFileSummary(outputWithDeliveryWarning, result.files),
+          appendCodeSessionFileSummary(outputWithWarnings, result.files),
           (hasFiles
             ? {
               session_id: result.session_id,
@@ -695,6 +706,9 @@ function createCodeExecutionTool(
               ...(artifactDelivery != null
                 ? { artifact_delivery: artifactDelivery }
                 : {}),
+              ...(artifactTruncation != null
+                ? { artifact_truncation: artifactTruncation }
+                : {}),
               ...deletionEcho,
               ...runtimeEcho,
             }
@@ -703,6 +717,9 @@ function createCodeExecutionTool(
               ...(artifactDelivery != null
                 ? { artifact_delivery: artifactDelivery }
                 : {}),
+              ...(artifactTruncation != null
+                ? { artifact_truncation: artifactTruncation }
+                : {}),
               ...deletionEcho,
               ...runtimeEcho,
             }) satisfies t.CodeExecutionArtifact,

package/src/tools/ProgrammaticToolCalling.ts

@@ -22,7 +22,6 @@ import {
   resolveCodeApiAuthHeaders,
   selectRuntimeSessionHint,
 } from './CodeExecutor';
-import { appendExecutionArtifactFileSummary } from './CodeSessionFileSummary';
 import {
   assertUnambiguousIdentifiers,
   projectProgrammaticToolMap,
@@ -39,10 +38,15 @@ import {
   appendArtifactDeliveryWarning,
   normalizeArtifactDeliveryFailure,
 } from '@/tools/ArtifactDelivery';
+import {
+  appendArtifactTruncationWarning,
+  normalizeArtifactTruncation,
+} from '@/tools/ArtifactTruncation';
 import {
   describeCodeApiError,
   logCodeApiDiagnostic,
 } from '@/tools/diagnostics';
+import { appendExecutionArtifactFileSummary } from './CodeSessionFileSummary';
 import { resolveFetchProxyAgent } from '@/utils/proxy';
 import { INTENT_PROPERTY } from '@/tools/intentArg';
 import { Constants } from '@/common';
@@ -946,11 +950,18 @@ export function formatCompletedResponse(
     outputWithReminder,
     artifactDelivery
   );
+  const artifactTruncation = normalizeArtifactTruncation(
+    response.artifact_truncation
+  );
+  const outputWithWarnings = appendArtifactTruncationWarning(
+    outputWithDeliveryWarning,
+    artifactTruncation
+  );
 
   return [
     filePersistence === 'execution'
-      ? appendExecutionArtifactFileSummary(outputWithDeliveryWarning, response.files)
-      : appendCodeSessionFileSummary(outputWithDeliveryWarning, response.files),
+      ? appendExecutionArtifactFileSummary(outputWithWarnings, response.files)
+      : appendCodeSessionFileSummary(outputWithWarnings, response.files),
     {
       session_id: response.session_id,
       files: response.files,
@@ -960,6 +971,9 @@ export function formatCompletedResponse(
       ...(artifactDelivery != null
         ? { artifact_delivery: artifactDelivery }
         : {}),
+      ...(artifactTruncation != null
+        ? { artifact_truncation: artifactTruncation }
+        : {}),
       ...(response.runtime_session_id != null
         ? {
           runtime_session_id: response.runtime_session_id,

package/src/tools/ToolNode.ts

@@ -129,6 +129,7 @@ import {
   resolveLocalExecutionTools,
 } from '@/tools/local';
 import { stripCodeSessionFileSummary } from '@/tools/CodeSessionFileSummary';
+import { formatToolErrorContent } from '@/tools/toolErrorContent';
 import { Constants, GraphEvents, CODE_EXECUTION_TOOLS } from '@/common';
 import { PreparedSubagentError } from '@/tools/preparedSubagents';
 import { attachRunStepResumeState } from '@/tools/runStepResume';
@@ -2201,9 +2202,11 @@ export class ToolNode<T = any> extends RunnableCallable<T, T> {
           });
         }
       }
-      const errorContent = truncateToolResultContent(
-        `Error: ${e.message}\n Please fix your mistakes.`,
-        this.maxToolResultChars
+      const errorContent = formatToolErrorContent(
+        e.message,
+        this.maxToolResultChars,
+        config.signal,
+        e
       );
       const refMeta =
         unresolvedRefs.length > 0
@@ -4461,9 +4464,10 @@ export class ToolNode<T = any> extends RunnableCallable<T, T> {
         let finalToolOutput: unknown = result.content;
 
         if (result.status === 'error') {
-          contentString = truncateToolResultContent(
-            `Error: ${result.errorMessage ?? 'Unknown error'}\n Please fix your mistakes.`,
-            this.maxToolResultChars
+          contentString = formatToolErrorContent(
+            result.errorMessage,
+            this.maxToolResultChars,
+            config.signal
           );
           /**
            * Error results bypass registration but stamp the
@@ -4977,9 +4981,10 @@ export class ToolNode<T = any> extends RunnableCallable<T, T> {
   ): Promise<boolean> {
     const output =
       result.status === 'error'
-        ? truncateToolResultContent(
-          `Error: ${result.errorMessage ?? 'Unknown error'}\n Please fix your mistakes.`,
-          this.maxToolResultChars
+        ? formatToolErrorContent(
+          result.errorMessage,
+          this.maxToolResultChars,
+          config.signal
         )
         : serializeToolOutputWithinLimits(
           result.content,

package/src/tools/toolErrorContent.ts

@@ -0,0 +1,48 @@
+import { PreparedSubagentError } from '@/tools/preparedSubagents';
+import { truncateToolResultContent } from '@/utils/truncation';
+import { StreamLimitExceededError } from '@/llm/streamLimits';
+
+export const STOPPED_RUN_TOOL_ERROR =
+  'STOP. The user doesn\'t want to proceed with this tool use. ' +
+  'The run was stopped; the tool may not have completed, and its effects should not be assumed. ' +
+  'STOP what you are doing and wait for the user to tell you how to proceed.';
+
+/** A host result only carries error text, so require the run signal as well. */
+function isStoppedRunToolError(
+  message: string | undefined,
+  signal?: AbortSignal,
+  error?: Error
+): boolean {
+  if (
+    signal?.aborted !== true ||
+    signal.reason instanceof StreamLimitExceededError ||
+    signal.reason instanceof PreparedSubagentError
+  ) {
+    return false;
+  }
+  if (
+    (error != null && error === signal.reason) ||
+    (error instanceof Error &&
+      (error.name === 'AbortError' ||
+        ('code' in error &&
+          (error.code === 'ABORT_ERR' || error.code === 'ERR_CANCELED'))))
+  ) {
+    return true;
+  }
+  return (
+    message != null &&
+    /AbortError|(?:operation|request|stream) was aborted/i.test(message)
+  );
+}
+
+export function formatToolErrorContent(
+  message: string | undefined,
+  maxChars: number,
+  signal?: AbortSignal,
+  error?: Error
+): string {
+  const content = isStoppedRunToolError(message, signal, error)
+    ? STOPPED_RUN_TOOL_ERROR
+    : `Error: ${message ?? 'Unknown error'}\n Please fix your mistakes.`;
+  return truncateToolResultContent(content, maxChars);
+}

package/src/types/tools.ts

@@ -497,6 +497,21 @@ export type ArtifactDeliveryFailure = {
   failed: number;
 };
 
+export type ArtifactTruncationReason =
+  | 'max_files'
+  | 'depth'
+  | 'size'
+  | 'path'
+  | 'unreadable';
+
+export type ArtifactTruncation = {
+  code: 'artifact_truncated';
+  reasons: Partial<Record<ArtifactTruncationReason, number>>;
+  /** Up to 20 relative paths omitted from the response. */
+  skipped: string[];
+  skipped_count: number;
+};
+
 export type ExecuteResult = {
   /**
    * Execution session id — the (transient) sandbox run that produced
@@ -510,6 +525,7 @@ export type ExecuteResult = {
   /** Persisted input paths explicitly removed during this execution. */
   deleted_files?: string[];
   artifact_delivery?: ArtifactDeliveryFailure;
+  artifact_truncation?: ArtifactTruncation;
   /**
    * Durable runtime session id echoed by a stateful Code API backend
    * (hash of tenant+user+hint). Additive; absent on stateless servers.
@@ -1356,6 +1372,7 @@ export type ProgrammaticExecutionResponse = {
   /** Persisted input paths explicitly removed during this execution. */
   deleted_files?: string[];
   artifact_delivery?: ArtifactDeliveryFailure;
+  artifact_truncation?: ArtifactTruncation;
 
   /** Durable runtime session echo from a stateful backend (additive). */
   runtime_session_id?: string;
@@ -1375,6 +1392,7 @@ export type ProgrammaticExecutionArtifact = {
   /** Persisted input paths explicitly removed during this execution. */
   deleted_files?: string[];
   artifact_delivery?: ArtifactDeliveryFailure;
+  artifact_truncation?: ArtifactTruncation;
   /** Durable runtime session echo from a stateful backend (additive). */
   runtime_session_id?: string;
   runtime_status?: 'new' | 'reused';
@@ -1457,6 +1475,7 @@ export type CodeExecutionArtifact = {
   /** Persisted input paths explicitly removed during this execution. */
   deleted_files?: string[];
   artifact_delivery?: ArtifactDeliveryFailure;
+  artifact_truncation?: ArtifactTruncation;
   /** Durable runtime session echo from a stateful backend (additive). */
   runtime_session_id?: string;
   runtime_status?: 'new' | 'reused';