@librechat/agents 3.1.86 → 3.1.88

package/src/tools/eagerEventExecution.ts

@@ -0,0 +1,153 @@
+import type * as t from '@/types';
+
+export function coerceRecordArgs(
+  args: unknown
+): Record<string, unknown> | undefined {
+  if (typeof args === 'string') {
+    try {
+      const parsed = JSON.parse(args) as unknown;
+      return coerceRecordArgs(parsed);
+    } catch {
+      return undefined;
+    }
+  }
+
+  if (args === null || typeof args !== 'object' || Array.isArray(args)) {
+    return undefined;
+  }
+
+  return args as Record<string, unknown>;
+}
+
+export function stableStringify(value: unknown): string {
+  if (Array.isArray(value)) {
+    return `[${value.map((item) => stableStringify(item)).join(',')}]`;
+  }
+
+  if (value !== null && typeof value === 'object') {
+    const record = value as Record<string, unknown>;
+    const keys = Object.keys(record).sort();
+    return `{${keys
+      .map((key) => `${JSON.stringify(key)}:${stableStringify(record[key])}`)
+      .join(',')}}`;
+  }
+
+  return JSON.stringify(value);
+}
+
+export function recordArgsEqual(
+  left: Record<string, unknown>,
+  right: Record<string, unknown>
+): boolean {
+  return stableStringify(left) === stableStringify(right);
+}
+
+export function normalizeError(error: unknown): Error {
+  return error instanceof Error ? error : new Error(String(error));
+}
+
+export type ToolExecutionPlanCall = {
+  id?: string;
+  name: string;
+  args: unknown;
+  stepId?: string;
+  codeSessionContext?: t.ToolCallRequest['codeSessionContext'];
+};
+
+export type ToolExecutionRequestPlan = {
+  allRequests: t.ToolCallRequest[];
+  requests: t.ToolCallRequest[];
+  rejectedResults: t.ToolExecuteResult[];
+};
+
+export function buildToolExecutionRequestPlan(args: {
+  toolCalls: ToolExecutionPlanCall[];
+  usageCount: Map<string, number>;
+  invalidArgsBehavior?: 'abort' | 'error-result';
+  recordTurn?: (toolName: string, turn: number, callId: string) => void;
+}): ToolExecutionRequestPlan | undefined {
+  const invalidArgsBehavior = args.invalidArgsBehavior ?? 'abort';
+  const prepared: Array<{
+    id: string;
+    name: string;
+    args: Record<string, unknown>;
+    stepId?: string;
+    codeSessionContext?: t.ToolCallRequest['codeSessionContext'];
+    rejectedErrorMessage?: string;
+  }> = [];
+
+  for (const toolCall of args.toolCalls) {
+    if (
+      toolCall.id == null ||
+      toolCall.id === '' ||
+      toolCall.name === ''
+    ) {
+      return undefined;
+    }
+    const coercedArgs = coerceRecordArgs(toolCall.args);
+    if (coercedArgs == null) {
+      if (invalidArgsBehavior === 'abort') {
+        return undefined;
+      }
+      prepared.push({
+        id: toolCall.id,
+        name: toolCall.name,
+        args: {},
+        stepId: toolCall.stepId,
+        codeSessionContext: toolCall.codeSessionContext,
+        rejectedErrorMessage:
+          'Invalid tool call arguments: expected a JSON object.',
+      });
+      continue;
+    }
+    prepared.push({
+      id: toolCall.id,
+      name: toolCall.name,
+      args: coercedArgs,
+      stepId: toolCall.stepId,
+      codeSessionContext: toolCall.codeSessionContext,
+    });
+  }
+
+  const nextUsageCount = new Map(args.usageCount);
+  const allRequests = prepared.map((toolCall): t.ToolCallRequest => {
+    const turn = nextUsageCount.get(toolCall.name) ?? 0;
+    nextUsageCount.set(toolCall.name, turn + 1);
+    const request: t.ToolCallRequest = {
+      id: toolCall.id,
+      name: toolCall.name,
+      args: toolCall.args,
+      stepId: toolCall.stepId,
+      turn,
+    };
+    if (toolCall.codeSessionContext != null) {
+      request.codeSessionContext = toolCall.codeSessionContext;
+    }
+    return request;
+  });
+  const requests = allRequests.filter(
+    (_, index) => prepared[index].rejectedErrorMessage == null
+  );
+  const rejectedResults = prepared.flatMap((toolCall) => {
+    if (toolCall.rejectedErrorMessage == null) {
+      return [];
+    }
+    return [
+      {
+        toolCallId: toolCall.id,
+        status: 'error' as const,
+        content: '',
+        errorMessage: toolCall.rejectedErrorMessage,
+      },
+    ];
+  });
+
+  for (const [toolName, count] of nextUsageCount) {
+    args.usageCount.set(toolName, count);
+  }
+  for (const request of allRequests) {
+    args.recordTurn?.(request.name, request.turn ?? 0, request.id);
+  }
+
+  return { allRequests, requests, rejectedResults };
+}

package/src/tools/handlers.ts

@@ -118,10 +118,14 @@ export async function handleToolCallChunks({
     );
   }
 
-  await graph.dispatchRunStepDelta(stepId, {
-    type: StepTypes.TOOL_CALLS,
-    tool_calls: toolCallChunks,
-  });
+  await graph.dispatchRunStepDelta(
+    stepId,
+    {
+      type: StepTypes.TOOL_CALLS,
+      tool_calls: toolCallChunks,
+    },
+    metadata
+  );
 }
 
 export const handleToolCalls = async (

package/src/tools/streamedToolCallSeals.ts

@@ -0,0 +1,57 @@
+export const STREAMED_TOOL_CALL_ADAPTER_METADATA_KEY =
+  'lc_streamed_tool_call_adapter';
+export const STREAMED_TOOL_CALL_SEAL_METADATA_KEY =
+  'lc_streamed_tool_call_seal';
+export const OPENAI_RESPONSES_STREAMED_TOOL_CALL_ADAPTER = 'openai_responses';
+
+export type StreamedToolCallAdapter =
+  typeof OPENAI_RESPONSES_STREAMED_TOOL_CALL_ADAPTER;
+
+export type StreamedToolCallSeal =
+  | {
+      kind: 'single';
+      id?: string;
+      index?: number;
+    }
+  | {
+      kind: 'all';
+    };
+
+export function getStreamedToolCallAdapter(
+  metadata: Record<string, unknown> | undefined
+): StreamedToolCallAdapter | undefined {
+  if (
+    metadata?.[STREAMED_TOOL_CALL_ADAPTER_METADATA_KEY] ===
+    OPENAI_RESPONSES_STREAMED_TOOL_CALL_ADAPTER
+  ) {
+    return OPENAI_RESPONSES_STREAMED_TOOL_CALL_ADAPTER;
+  }
+  return undefined;
+}
+
+export function getStreamedToolCallSeal(
+  metadata: Record<string, unknown> | undefined
+): StreamedToolCallSeal | undefined {
+  const seal = metadata?.[STREAMED_TOOL_CALL_SEAL_METADATA_KEY];
+  if (seal == null || typeof seal !== 'object') {
+    return undefined;
+  }
+  if (!('kind' in seal)) {
+    return undefined;
+  }
+  if (seal.kind === 'all') {
+    return { kind: 'all' };
+  }
+  if (seal.kind !== 'single') {
+    return undefined;
+  }
+  const id = 'id' in seal && typeof seal.id === 'string' ? seal.id : undefined;
+  const index =
+    'index' in seal && typeof seal.index === 'number'
+      ? seal.index
+      : undefined;
+  if (id == null && index == null) {
+    return undefined;
+  }
+  return { kind: 'single', id, index };
+}

package/src/types/hitl.ts

@@ -327,6 +327,10 @@ export interface RunInterruptResult<TPayload = HumanInterruptPayload> {
   interruptId: string;
   /** `thread_id` the run was bound to — required to resume. */
   threadId?: string;
+  /** LangGraph checkpoint id that contains the paused interrupt task. */
+  checkpointId?: string;
+  /** LangGraph checkpoint namespace for the paused interrupt task. */
+  checkpointNs?: string;
   /** Structured payload describing what needs human input. */
   payload: TPayload;
 }

package/src/types/run.ts

@@ -15,6 +15,7 @@ import type {
   ToolSessionMap,
   ToolExecutionConfig,
   ToolOutputReferencesConfig,
+  EagerEventToolExecutionConfig,
 } from '@/types/tools';
 import type { HumanInTheLoopConfig } from '@/types/hitl';
 import type { HookRegistry } from '@/hooks';
@@ -161,6 +162,16 @@ export type RunConfig = {
    * placeholders. Disabled by default so existing runs are unaffected.
    */
   toolOutputReferences?: ToolOutputReferencesConfig;
+  /**
+   * Opt-in latency optimization for event-driven tools. When enabled,
+   * the streaming layer may start a tool call as soon as it sees a
+   * complete, parseable tool call; ToolNode still waits for the final
+   * assistant message before appending ToolMessages, preserving provider
+   * ordering. The SDK automatically falls back to normal batch dispatch
+   * when hooks, HITL, output references, or ambiguous stream shapes make
+   * eager dispatch unsafe.
+   */
+  eagerEventToolExecution?: EagerEventToolExecutionConfig;
   /**
    * Selects the execution backend for built-in code tools. Omit this to keep
    * the remote LibreChat Code API sandbox. Set `{ engine: 'local' }` to run

package/src/types/tools.ts

@@ -29,6 +29,36 @@ export type ToolRefs = {
 
 export type ToolRefGenerator = (tool_calls: ToolCall[]) => ToolRefs;
 
+export type EagerEventToolExecutionConfig = {
+  /**
+   * When enabled, event-driven tool calls may be started from the
+   * streaming layer as soon as the SDK observes a complete tool call.
+   * Results are still held until ToolNode materializes the final
+   * ToolMessages so provider message ordering is preserved.
+   */
+  enabled?: boolean;
+};
+
+export type EagerEventToolExecutionOutcome =
+  | { results: ToolExecuteResult[]; error?: undefined }
+  | { results?: undefined; error: Error };
+
+export type EagerEventToolExecution = {
+  toolCallId: string;
+  toolName: string;
+  args: Record<string, unknown>;
+  request: ToolCallRequest;
+  promise: Promise<EagerEventToolExecutionOutcome>;
+};
+
+export type EagerEventToolCallChunkState = {
+  id?: string;
+  name?: string;
+  argsText: string;
+  index?: number;
+  lastArgsFragment?: string;
+};
+
 export type ToolNodeOptions = {
   name?: string;
   tags?: string[];
@@ -51,6 +81,12 @@ export type ToolNodeOptions = {
   agentId?: string;
   /** Tool names that must be executed directly (via runTool) even in event-driven mode (e.g., graph-managed handoff tools) */
   directToolNames?: Set<string>;
+  /** Opt-in eager execution for event-driven tool calls. */
+  eagerEventToolExecution?: EagerEventToolExecutionConfig;
+  /** Shared per-run eager execution registry populated by the stream handler. */
+  eagerEventToolExecutions?: Map<string, EagerEventToolExecution>;
+  /** Shared per-run per-tool turn counter used by eager and normal event dispatch. */
+  eagerEventToolUsageCount?: Map<string, number>;
   /**
    * Hook registry for PreToolUse/PostToolUse/PostToolUseFailure/
    * PermissionDenied lifecycle hooks. Fires for **every** tool the

package/dist/cjs/llm/text.cjs

@@ -1,69 +0,0 @@
-'use strict';
-
-class TextStream {
-    text;
-    currentIndex;
-    minChunkSize;
-    maxChunkSize;
-    delay;
-    firstWordChunk;
-    constructor(text, options = {}) {
-        this.text = text;
-        this.currentIndex = 0;
-        this.minChunkSize = options.minChunkSize ?? 4;
-        this.maxChunkSize = options.maxChunkSize ?? 8;
-        this.delay = options.delay ?? 20;
-        this.firstWordChunk = options.firstWordChunk ?? true;
-    }
-    randomInt(min, max) {
-        return Math.floor(Math.random() * (max - min)) + min;
-    }
-    static BOUNDARIES = new Set([
-        ' ',
-        '.',
-        ',',
-        '!',
-        '?',
-        ';',
-        ':',
-    ]);
-    findFirstWordBoundary(text, minSize) {
-        if (minSize >= text.length)
-            return text.length;
-        // Ensure we meet the minimum size first
-        let pos = minSize;
-        // Look forward until we find a boundary
-        while (pos < text.length) {
-            if (TextStream.BOUNDARIES.has(text[pos])) {
-                return pos + 1; // Include the boundary character
-            }
-            pos++;
-        }
-        return text.length; // If no boundary found, return entire remaining text
-    }
-    async *generateText(signal, progressCallback) {
-        const { delay, minChunkSize, maxChunkSize } = this;
-        while (this.currentIndex < this.text.length) {
-            if (signal?.aborted === true) {
-                break;
-            }
-            await new Promise((resolve) => setTimeout(resolve, delay));
-            const remainingText = this.text.slice(this.currentIndex);
-            let chunkSize;
-            if (this.firstWordChunk) {
-                chunkSize = this.findFirstWordBoundary(remainingText, minChunkSize);
-            }
-            else {
-                const remainingChars = remainingText.length;
-                chunkSize = Math.min(this.randomInt(minChunkSize, maxChunkSize + 1), remainingChars);
-            }
-            const chunk = this.text.slice(this.currentIndex, this.currentIndex + chunkSize);
-            progressCallback?.(chunk);
-            yield chunk;
-            this.currentIndex += chunkSize;
-        }
-    }
-}
-
-exports.TextStream = TextStream;
-//# sourceMappingURL=text.cjs.map

package/dist/cjs/llm/text.cjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"text.cjs","sources":["../../../src/llm/text.ts"],"sourcesContent":["export interface TextStreamOptions {\n  minChunkSize?: number;\n  maxChunkSize?: number;\n  delay?: number;\n  firstWordChunk?: boolean;\n}\n\nexport type ProgressCallback = (chunk: string) => void;\nexport type PostChunkCallback = (chunk: string) => void;\n\nexport class TextStream {\n  private text: string;\n  private currentIndex: number;\n  private minChunkSize: number;\n  private maxChunkSize: number;\n  private delay: number;\n  private firstWordChunk: boolean;\n\n  constructor(text: string, options: TextStreamOptions = {}) {\n    this.text = text;\n    this.currentIndex = 0;\n    this.minChunkSize = options.minChunkSize ?? 4;\n    this.maxChunkSize = options.maxChunkSize ?? 8;\n    this.delay = options.delay ?? 20;\n    this.firstWordChunk = options.firstWordChunk ?? true;\n  }\n\n  private randomInt(min: number, max: number): number {\n    return Math.floor(Math.random() * (max - min)) + min;\n  }\n\n  private static readonly BOUNDARIES = new Set([\n    ' ',\n    '.',\n    ',',\n    '!',\n    '?',\n    ';',\n    ':',\n  ]);\n\n  private findFirstWordBoundary(text: string, minSize: number): number {\n    if (minSize >= text.length) return text.length;\n\n    // Ensure we meet the minimum size first\n    let pos = minSize;\n\n    // Look forward until we find a boundary\n    while (pos < text.length) {\n      if (TextStream.BOUNDARIES.has(text[pos])) {\n        return pos + 1; // Include the boundary character\n      }\n      pos++;\n    }\n\n    return text.length; // If no boundary found, return entire remaining text\n  }\n\n  async *generateText(\n    signal?: AbortSignal,\n    progressCallback?: ProgressCallback\n  ): AsyncGenerator<string, void, unknown> {\n    const { delay, minChunkSize, maxChunkSize } = this;\n\n    while (this.currentIndex < this.text.length) {\n      if (signal?.aborted === true) {\n        break;\n      }\n      await new Promise((resolve) => setTimeout(resolve, delay));\n\n      const remainingText = this.text.slice(this.currentIndex);\n      let chunkSize: number;\n\n      if (this.firstWordChunk) {\n        chunkSize = this.findFirstWordBoundary(remainingText, minChunkSize);\n      } else {\n        const remainingChars = remainingText.length;\n        chunkSize = Math.min(\n          this.randomInt(minChunkSize, maxChunkSize + 1),\n          remainingChars\n        );\n      }\n\n      const chunk = this.text.slice(\n        this.currentIndex,\n        this.currentIndex + chunkSize\n      );\n      progressCallback?.(chunk);\n\n      yield chunk;\n      this.currentIndex += chunkSize;\n    }\n  }\n}\n"],"names":[],"mappings":";;MAUa,UAAU,CAAA;AACb,IAAA,IAAI;AACJ,IAAA,YAAY;AACZ,IAAA,YAAY;AACZ,IAAA,YAAY;AACZ,IAAA,KAAK;AACL,IAAA,cAAc;IAEtB,WAAA,CAAY,IAAY,EAAE,OAAA,GAA6B,EAAE,EAAA;AACvD,QAAA,IAAI,CAAC,IAAI,GAAG,IAAI;AAChB,QAAA,IAAI,CAAC,YAAY,GAAG,CAAC;QACrB,IAAI,CAAC,YAAY,GAAG,OAAO,CAAC,YAAY,IAAI,CAAC;QAC7C,IAAI,CAAC,YAAY,GAAG,OAAO,CAAC,YAAY,IAAI,CAAC;QAC7C,IAAI,CAAC,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,EAAE;QAChC,IAAI,CAAC,cAAc,GAAG,OAAO,CAAC,cAAc,IAAI,IAAI;IACtD;IAEQ,SAAS,CAAC,GAAW,EAAE,GAAW,EAAA;AACxC,QAAA,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,GAAG,GAAG,GAAG,CAAC,CAAC,GAAG,GAAG;IACtD;AAEQ,IAAA,OAAgB,UAAU,GAAG,IAAI,GAAG,CAAC;QAC3C,GAAG;QACH,GAAG;QACH,GAAG;QACH,GAAG;QACH,GAAG;QACH,GAAG;QACH,GAAG;AACJ,KAAA,CAAC;IAEM,qBAAqB,CAAC,IAAY,EAAE,OAAe,EAAA;AACzD,QAAA,IAAI,OAAO,IAAI,IAAI,CAAC,MAAM;YAAE,OAAO,IAAI,CAAC,MAAM;;QAG9C,IAAI,GAAG,GAAG,OAAO;;AAGjB,QAAA,OAAO,GAAG,GAAG,IAAI,CAAC,MAAM,EAAE;AACxB,YAAA,IAAI,UAAU,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE;AACxC,gBAAA,OAAO,GAAG,GAAG,CAAC,CAAC;YACjB;AACA,YAAA,GAAG,EAAE;QACP;AAEA,QAAA,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB;AAEA,IAAA,OAAO,YAAY,CACjB,MAAoB,EACpB,gBAAmC,EAAA;QAEnC,MAAM,EAAE,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,GAAG,IAAI;QAElD,OAAO,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE;AAC3C,YAAA,IAAI,MAAM,EAAE,OAAO,KAAK,IAAI,EAAE;gBAC5B;YACF;AACA,YAAA,MAAM,IAAI,OAAO,CAAC,CAAC,OAAO,KAAK,UAAU,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;AAE1D,YAAA,MAAM,aAAa,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,YAAY,CAAC;AACxD,YAAA,IAAI,SAAiB;AAErB,YAAA,IAAI,IAAI,CAAC,cAAc,EAAE;gBACvB,SAAS,GAAG,IAAI,CAAC,qBAAqB,CAAC,aAAa,EAAE,YAAY,CAAC;YACrE;iBAAO;AACL,gBAAA,MAAM,cAAc,GAAG,aAAa,CAAC,MAAM;AAC3C,gBAAA,SAAS,GAAG,IAAI,CAAC,GAAG,CAClB,IAAI,CAAC,SAAS,CAAC,YAAY,EAAE,YAAY,GAAG,CAAC,CAAC,EAC9C,cAAc,CACf;YACH;AAEA,YAAA,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,CAC3B,IAAI,CAAC,YAAY,EACjB,IAAI,CAAC,YAAY,GAAG,SAAS,CAC9B;AACD,YAAA,gBAAgB,GAAG,KAAK,CAAC;AAEzB,YAAA,MAAM,KAAK;AACX,YAAA,IAAI,CAAC,YAAY,IAAI,SAAS;QAChC;IACF;;;;;"}

package/dist/esm/llm/text.mjs

@@ -1,67 +0,0 @@
-class TextStream {
-    text;
-    currentIndex;
-    minChunkSize;
-    maxChunkSize;
-    delay;
-    firstWordChunk;
-    constructor(text, options = {}) {
-        this.text = text;
-        this.currentIndex = 0;
-        this.minChunkSize = options.minChunkSize ?? 4;
-        this.maxChunkSize = options.maxChunkSize ?? 8;
-        this.delay = options.delay ?? 20;
-        this.firstWordChunk = options.firstWordChunk ?? true;
-    }
-    randomInt(min, max) {
-        return Math.floor(Math.random() * (max - min)) + min;
-    }
-    static BOUNDARIES = new Set([
-        ' ',
-        '.',
-        ',',
-        '!',
-        '?',
-        ';',
-        ':',
-    ]);
-    findFirstWordBoundary(text, minSize) {
-        if (minSize >= text.length)
-            return text.length;
-        // Ensure we meet the minimum size first
-        let pos = minSize;
-        // Look forward until we find a boundary
-        while (pos < text.length) {
-            if (TextStream.BOUNDARIES.has(text[pos])) {
-                return pos + 1; // Include the boundary character
-            }
-            pos++;
-        }
-        return text.length; // If no boundary found, return entire remaining text
-    }
-    async *generateText(signal, progressCallback) {
-        const { delay, minChunkSize, maxChunkSize } = this;
-        while (this.currentIndex < this.text.length) {
-            if (signal?.aborted === true) {
-                break;
-            }
-            await new Promise((resolve) => setTimeout(resolve, delay));
-            const remainingText = this.text.slice(this.currentIndex);
-            let chunkSize;
-            if (this.firstWordChunk) {
-                chunkSize = this.findFirstWordBoundary(remainingText, minChunkSize);
-            }
-            else {
-                const remainingChars = remainingText.length;
-                chunkSize = Math.min(this.randomInt(minChunkSize, maxChunkSize + 1), remainingChars);
-            }
-            const chunk = this.text.slice(this.currentIndex, this.currentIndex + chunkSize);
-            progressCallback?.(chunk);
-            yield chunk;
-            this.currentIndex += chunkSize;
-        }
-    }
-}
-
-export { TextStream };
-//# sourceMappingURL=text.mjs.map

package/dist/esm/llm/text.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"text.mjs","sources":["../../../src/llm/text.ts"],"sourcesContent":["export interface TextStreamOptions {\n  minChunkSize?: number;\n  maxChunkSize?: number;\n  delay?: number;\n  firstWordChunk?: boolean;\n}\n\nexport type ProgressCallback = (chunk: string) => void;\nexport type PostChunkCallback = (chunk: string) => void;\n\nexport class TextStream {\n  private text: string;\n  private currentIndex: number;\n  private minChunkSize: number;\n  private maxChunkSize: number;\n  private delay: number;\n  private firstWordChunk: boolean;\n\n  constructor(text: string, options: TextStreamOptions = {}) {\n    this.text = text;\n    this.currentIndex = 0;\n    this.minChunkSize = options.minChunkSize ?? 4;\n    this.maxChunkSize = options.maxChunkSize ?? 8;\n    this.delay = options.delay ?? 20;\n    this.firstWordChunk = options.firstWordChunk ?? true;\n  }\n\n  private randomInt(min: number, max: number): number {\n    return Math.floor(Math.random() * (max - min)) + min;\n  }\n\n  private static readonly BOUNDARIES = new Set([\n    ' ',\n    '.',\n    ',',\n    '!',\n    '?',\n    ';',\n    ':',\n  ]);\n\n  private findFirstWordBoundary(text: string, minSize: number): number {\n    if (minSize >= text.length) return text.length;\n\n    // Ensure we meet the minimum size first\n    let pos = minSize;\n\n    // Look forward until we find a boundary\n    while (pos < text.length) {\n      if (TextStream.BOUNDARIES.has(text[pos])) {\n        return pos + 1; // Include the boundary character\n      }\n      pos++;\n    }\n\n    return text.length; // If no boundary found, return entire remaining text\n  }\n\n  async *generateText(\n    signal?: AbortSignal,\n    progressCallback?: ProgressCallback\n  ): AsyncGenerator<string, void, unknown> {\n    const { delay, minChunkSize, maxChunkSize } = this;\n\n    while (this.currentIndex < this.text.length) {\n      if (signal?.aborted === true) {\n        break;\n      }\n      await new Promise((resolve) => setTimeout(resolve, delay));\n\n      const remainingText = this.text.slice(this.currentIndex);\n      let chunkSize: number;\n\n      if (this.firstWordChunk) {\n        chunkSize = this.findFirstWordBoundary(remainingText, minChunkSize);\n      } else {\n        const remainingChars = remainingText.length;\n        chunkSize = Math.min(\n          this.randomInt(minChunkSize, maxChunkSize + 1),\n          remainingChars\n        );\n      }\n\n      const chunk = this.text.slice(\n        this.currentIndex,\n        this.currentIndex + chunkSize\n      );\n      progressCallback?.(chunk);\n\n      yield chunk;\n      this.currentIndex += chunkSize;\n    }\n  }\n}\n"],"names":[],"mappings":"MAUa,UAAU,CAAA;AACb,IAAA,IAAI;AACJ,IAAA,YAAY;AACZ,IAAA,YAAY;AACZ,IAAA,YAAY;AACZ,IAAA,KAAK;AACL,IAAA,cAAc;IAEtB,WAAA,CAAY,IAAY,EAAE,OAAA,GAA6B,EAAE,EAAA;AACvD,QAAA,IAAI,CAAC,IAAI,GAAG,IAAI;AAChB,QAAA,IAAI,CAAC,YAAY,GAAG,CAAC;QACrB,IAAI,CAAC,YAAY,GAAG,OAAO,CAAC,YAAY,IAAI,CAAC;QAC7C,IAAI,CAAC,YAAY,GAAG,OAAO,CAAC,YAAY,IAAI,CAAC;QAC7C,IAAI,CAAC,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,EAAE;QAChC,IAAI,CAAC,cAAc,GAAG,OAAO,CAAC,cAAc,IAAI,IAAI;IACtD;IAEQ,SAAS,CAAC,GAAW,EAAE,GAAW,EAAA;AACxC,QAAA,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,GAAG,GAAG,GAAG,CAAC,CAAC,GAAG,GAAG;IACtD;AAEQ,IAAA,OAAgB,UAAU,GAAG,IAAI,GAAG,CAAC;QAC3C,GAAG;QACH,GAAG;QACH,GAAG;QACH,GAAG;QACH,GAAG;QACH,GAAG;QACH,GAAG;AACJ,KAAA,CAAC;IAEM,qBAAqB,CAAC,IAAY,EAAE,OAAe,EAAA;AACzD,QAAA,IAAI,OAAO,IAAI,IAAI,CAAC,MAAM;YAAE,OAAO,IAAI,CAAC,MAAM;;QAG9C,IAAI,GAAG,GAAG,OAAO;;AAGjB,QAAA,OAAO,GAAG,GAAG,IAAI,CAAC,MAAM,EAAE;AACxB,YAAA,IAAI,UAAU,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE;AACxC,gBAAA,OAAO,GAAG,GAAG,CAAC,CAAC;YACjB;AACA,YAAA,GAAG,EAAE;QACP;AAEA,QAAA,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB;AAEA,IAAA,OAAO,YAAY,CACjB,MAAoB,EACpB,gBAAmC,EAAA;QAEnC,MAAM,EAAE,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,GAAG,IAAI;QAElD,OAAO,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE;AAC3C,YAAA,IAAI,MAAM,EAAE,OAAO,KAAK,IAAI,EAAE;gBAC5B;YACF;AACA,YAAA,MAAM,IAAI,OAAO,CAAC,CAAC,OAAO,KAAK,UAAU,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;AAE1D,YAAA,MAAM,aAAa,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,YAAY,CAAC;AACxD,YAAA,IAAI,SAAiB;AAErB,YAAA,IAAI,IAAI,CAAC,cAAc,EAAE;gBACvB,SAAS,GAAG,IAAI,CAAC,qBAAqB,CAAC,aAAa,EAAE,YAAY,CAAC;YACrE;iBAAO;AACL,gBAAA,MAAM,cAAc,GAAG,aAAa,CAAC,MAAM;AAC3C,gBAAA,SAAS,GAAG,IAAI,CAAC,GAAG,CAClB,IAAI,CAAC,SAAS,CAAC,YAAY,EAAE,YAAY,GAAG,CAAC,CAAC,EAC9C,cAAc,CACf;YACH;AAEA,YAAA,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,CAC3B,IAAI,CAAC,YAAY,EACjB,IAAI,CAAC,YAAY,GAAG,SAAS,CAC9B;AACD,YAAA,gBAAgB,GAAG,KAAK,CAAC;AAEzB,YAAA,MAAM,KAAK;AACX,YAAA,IAAI,CAAC,YAAY,IAAI,SAAS;QAChC;IACF;;;;;"}