@elizaos/core 2.0.0-alpha.52 → 2.0.0-alpha.53

package/dist/utils/prompt-batcher/batcher.d.ts

@@ -0,0 +1,159 @@
+import type { Memory } from "../../types/memory";
+import { type BatcherResult, type BatcherStats, type ContextResolver, type DrainMeta, type PreCallbackHandler, type PromptSection } from "../../types/prompt-batcher";
+import type { IAgentRuntime } from "../../types/runtime";
+import type { SchemaRow } from "../../types/state";
+import type { PromptDispatcher } from "./dispatcher";
+import { type PromptBatcherSettings } from "./shared";
+export declare class PromptBatcher {
+    private readonly runtime;
+    private readonly dispatcher;
+    private readonly settings;
+    private readonly sections;
+    private readonly pendingResults;
+    private readonly contextResolvers;
+    private readonly preCallbackHandlers;
+    private readonly messageBuffers;
+    private readonly processedMessageIds;
+    private readonly processedMessageOrder;
+    private readonly affinityLocks;
+    private readonly lastRunAt;
+    private readonly inMemoryCache;
+    private readonly stats;
+    private enabled;
+    private disposed;
+    private readonly affinityTaskIds;
+    constructor(runtime: IAgentRuntime, dispatcher: PromptDispatcher, settings: PromptBatcherSettings);
+    /**
+     * Register a section and return a promise that resolves when the section is first
+     * delivered (or null if the section ID already existed). Resolves with BatcherResult
+     * so callers get { fields, meta }. WHY: Thenable API lets consumers await or .then()
+     * instead of relying only on onResult callbacks; meta carries drain context (fallbackUsed, etc.).
+     */
+    addSection(section: PromptSection): Promise<BatcherResult | null>;
+    removeSection(id: string): void;
+    registerContextResolver(slug: string, resolver: ContextResolver): void;
+    registerPreCallbackHandler(handler: PreCallbackHandler): void;
+    getPreCallbackHandlers(actionName: string): PreCallbackHandler[];
+    /**
+     * Buffer a message for batching and optionally trigger drains for message-relevant affinities (default, room:X, audit:X).
+     * No-arg tick() is a no-op. WHY: no background timer; only message cadence or task-driven drains run. Autonomy is not drained here (task-driven only).
+     */
+    tick(message?: Memory): void;
+    private _shouldDrainAffinity;
+    drain(): Promise<void>;
+    dispose(): void;
+    invalidateCache(sectionId: string): void;
+    invalidateAllCaches(): void;
+    getStats(): BatcherStats;
+    askOnce(id: string, opts: {
+        preamble: string;
+        schema: SchemaRow[];
+        fallback?: Record<string, unknown>;
+        providers?: string[];
+        model?: "small" | "large";
+        cacheTtlMs?: number;
+        staleWhileRevalidate?: boolean;
+        forceRegenerate?: boolean;
+        shouldRun?: (runtime: IAgentRuntime) => Promise<boolean> | boolean;
+        validate?: (fields: Record<string, unknown>) => Record<string, unknown> | null;
+        maxRetries?: number;
+        execOptions?: {
+            temperature?: number;
+            maxTokens?: number;
+            stopSequences?: string[];
+        };
+    }): Promise<Record<string, unknown>>;
+    /**
+     * Register a per-drain section and return a promise of the first result. Resolves with
+     * { fields, meta } or null (duplicate ID). onResult is optional; when provided, it is
+     * still invoked so fire-and-forget or recurring use (e.g. think()) is unchanged.
+     * WHY: Linear await + if (result) { ... } is easier than a large onResult callback;
+     * generic T lets callers get typed result.fields without casting.
+     */
+    onDrain<T = Record<string, unknown>>(id: string, opts: {
+        preamble: string;
+        schema: SchemaRow[];
+        onResult?: (fields: Record<string, unknown>, meta: DrainMeta) => void | Promise<void>;
+        fallback?: Record<string, unknown>;
+        providers?: string[];
+        model?: "small" | "large";
+        room?: string;
+        shouldRun?: (runtime: IAgentRuntime) => Promise<boolean> | boolean;
+        validate?: (fields: Record<string, unknown>) => Record<string, unknown> | null;
+        maxRetries?: number;
+        execOptions?: {
+            temperature?: number;
+            maxTokens?: number;
+            stopSequences?: string[];
+        };
+    }): Promise<BatcherResult<T> | null>;
+    think(id: string, opts: {
+        contextBuilder: (runtime: IAgentRuntime, messages: Memory[]) => Promise<string> | string;
+        preamble: string;
+        schema: SchemaRow[];
+        onResult: (fields: Record<string, unknown>, meta: DrainMeta) => void | Promise<void>;
+        fallback?: Record<string, unknown>;
+        minCycleMs?: number;
+        model?: "small" | "large";
+        shouldRun?: (runtime: IAgentRuntime) => Promise<boolean> | boolean;
+        validate?: (fields: Record<string, unknown>) => Record<string, unknown> | null;
+        maxRetries?: number;
+        execOptions?: {
+            temperature?: number;
+            maxTokens?: number;
+            stopSequences?: string[];
+        };
+    }): void;
+    askNow(id: string, opts: {
+        preamble: string;
+        schema: SchemaRow[];
+        fallback: Record<string, unknown>;
+        providers?: string[];
+        model?: "small" | "large";
+        room?: string;
+        validate?: (fields: Record<string, unknown>) => Record<string, unknown> | null;
+        maxRetries?: number;
+        execOptions?: {
+            temperature?: number;
+            maxTokens?: number;
+            stopSequences?: string[];
+        };
+    }): Promise<Record<string, unknown>>;
+    private _pushMessage;
+    private _getActiveAffinityKeys;
+    /**
+     * Returns the ideal tick interval for an affinity group: min of recurring sections' minCycleMs,
+     * capped by maxDrainIntervalMs. If no recurring sections, returns maxDrainIntervalMs.
+     */
+    getIdealTickInterval(affinityKey: string): number;
+    /** Returns the number of sections with the given affinity key. */
+    getSectionCountForAffinity(affinityKey: string): number;
+    /** WHY create a task per affinity: task system owns WHEN (interval, pause/resume); batcher owns WHAT runs during drain. One BATCHER_DRAIN task per affinity so each group has its own schedule. */
+    private _ensureAffinityTask;
+    private _syncAffinityTask;
+    private _removeAffinityTask;
+    drainAffinityGroup(affinityKey: string): Promise<void>;
+    private _drainAffinityGroupUnlocked;
+    private _runDrainPass;
+    private _metaForSection;
+    private _resolveContext;
+    private _getMessagesForAffinity;
+    /**
+     * Deliver a section result: optionally run onResult, then resolve or reject the
+     * section's promise. Resolve with { fields, meta } so the thenable API gets a
+     * single object. WHY: Consistent result shape; callers can .catch() when we reject.
+     * Guard pending.resolved so we never resolve and reject the same promise (e.g. if
+     * onResult throws we reject and return; if we later delivered again we would skip resolve).
+     */
+    private _deliverSectionResult;
+    private _fallbackForSection;
+    private _normalizeFallback;
+    private _checkCache;
+    private _writeCache;
+    private _runValidate;
+    private _retrySection;
+    private _emitDrainLog;
+    private _cacheKey;
+    private _validateProviders;
+}
+//# sourceMappingURL=batcher.d.ts.map

package/dist/utils/prompt-batcher/batcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"batcher.d.ts","sourceRoot":"","sources":["../../../src/utils/prompt-batcher/batcher.ts"],"names":[],"mappings":"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"}

package/dist/utils/prompt-batcher/dispatcher.d.ts

@@ -0,0 +1,15 @@
+import type { ResolvedSection } from "../../types/prompt-batcher";
+import type { IAgentRuntime } from "../../types/runtime";
+import { type DispatchOutcome, type PromptDispatcherSettings } from "./shared";
+export declare class PromptDispatcher {
+    private readonly settings;
+    constructor(settings: PromptDispatcherSettings);
+    dispatch(resolved: ResolvedSection[], runtime: IAgentRuntime): Promise<DispatchOutcome>;
+    private _buildCallPlans;
+    private _splitByModelPreference;
+    private _packingTokenLimit;
+    private _priorityRank;
+    private _buildPrompt;
+    private _mergeExecOptions;
+}
+//# sourceMappingURL=dispatcher.d.ts.map

package/dist/utils/prompt-batcher/dispatcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dispatcher.d.ts","sourceRoot":"","sources":["../../../src/utils/prompt-batcher/dispatcher.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAClE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,EAIN,KAAK,eAAe,EACpB,KAAK,wBAAwB,EAG7B,MAAM,UAAU,CAAC;AAElB,qBAAa,gBAAgB;IAChB,OAAO,CAAC,QAAQ,CAAC,QAAQ;gBAAR,QAAQ,EAAE,wBAAwB;IAEzD,QAAQ,CACb,QAAQ,EAAE,eAAe,EAAE,EAC3B,OAAO,EAAE,aAAa,GACpB,OAAO,CAAC,eAAe,CAAC;IA0F3B,OAAO,CAAC,eAAe;IAmFvB,OAAO,CAAC,uBAAuB;IAwC/B,OAAO,CAAC,kBAAkB;IAe1B,OAAO,CAAC,aAAa;IAMrB,OAAO,CAAC,YAAY;IAiCpB,OAAO,CAAC,iBAAiB;CAoCzB"}

package/dist/utils/prompt-batcher/shared.d.ts

@@ -0,0 +1,68 @@
+import type { Memory } from "../../types/memory";
+import type { BatcherResult, PromptSection, ResolvedSection } from "../../types/prompt-batcher";
+import type { IAgentRuntime } from "../../types/runtime";
+import type { SchemaRow, State } from "../../types/state";
+export type Deferred<T> = {
+    resolve: (value: T) => void;
+    reject: (reason?: unknown) => void;
+};
+export type CacheEntry = {
+    fields: Record<string, unknown>;
+    expiresAt: number;
+};
+/** Tracks a section's promise. resolved guards so we never resolve and reject the same deferred. */
+export type PendingResult = {
+    deferred: Deferred<BatcherResult | null>;
+    resolved: boolean;
+};
+export type DispatchCallMeta = {
+    model: "small" | "large";
+    sectionIds: string[];
+    estimatedTokens: number;
+    durationMs: number;
+    success: boolean;
+    retried: boolean;
+    fallbackUsed: string[];
+};
+export type DispatchOutcome = {
+    results: Map<string, Record<string, unknown>>;
+    calls: DispatchCallMeta[];
+};
+export type CallPlan = {
+    sections: ResolvedSection[];
+    model: "small" | "large";
+    totalEstimatedTokens: number;
+    priority: "background" | "normal" | "immediate";
+};
+export type PromptDispatcherSettings = {
+    packingDensity: number;
+    maxTokensPerCall: number;
+    maxParallelCalls: number;
+    modelSeparation: number;
+    maxSectionsPerCall: number;
+};
+export type PromptBatcherSettings = {
+    batchSize: number;
+    maxDrainIntervalMs: number;
+    maxSectionsPerCall: number;
+    packingDensity: number;
+    maxTokensPerCall: number;
+    maxParallelCalls: number;
+    modelSeparation: number;
+};
+export declare class Semaphore {
+    private permits;
+    private queue;
+    constructor(count: number);
+    acquire(): Promise<void>;
+    release(): void;
+}
+export declare function sanitizeIdentifier(value: string): string;
+export declare function clampRetryCount(value: number | undefined): number;
+export declare function createMinimalState(context: string): State;
+export declare function buildCharacterContext(runtime: IAgentRuntime): string;
+export declare function getSourceMessageId(message: Memory): string;
+export declare function pickFields(fields: Record<string, unknown> | null | undefined, schema: SchemaRow[]): Record<string, unknown>;
+export declare function hasMeaningfulSectionDrift(existing: PromptSection, incoming: PromptSection): boolean;
+export declare function rollingAverage(current: number, count: number, nextValue: number): number;
+//# sourceMappingURL=shared.d.ts.map

package/dist/utils/prompt-batcher/shared.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared.d.ts","sourceRoot":"","sources":["../../../src/utils/prompt-batcher/shared.ts"],"names":[],"mappings":"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"}

package/dist/utils/prompt-batcher.d.ts

@@ -0,0 +1,5 @@
+export { BatcherDisposedError, type BatcherStats, type ContextResolver, type DrainLog, type DrainMeta, type PreCallbackHandler, type PromptSection, type ResolvedSection, type SectionFrequency, } from "../types/prompt-batcher";
+export { PromptBatcher } from "./prompt-batcher/batcher.js";
+export { PromptDispatcher } from "./prompt-batcher/dispatcher.js";
+export { pickFields } from "./prompt-batcher/shared.js";
+//# sourceMappingURL=prompt-batcher.d.ts.map

package/dist/utils/prompt-batcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt-batcher.d.ts","sourceRoot":"","sources":["../../src/utils/prompt-batcher.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,oBAAoB,EACpB,KAAK,YAAY,EACjB,KAAK,eAAe,EACpB,KAAK,QAAQ,EACb,KAAK,SAAS,EACd,KAAK,kBAAkB,EACvB,KAAK,aAAa,EAClB,KAAK,eAAe,EACpB,KAAK,gBAAgB,GACrB,MAAM,yBAAyB,CAAC;AAEjC,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAC5D,OAAO,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AAClE,OAAO,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC"}

package/dist/utils/server-health.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Server health check utilities for waiting for servers to be ready
+ */
+export interface ServerHealthOptions {
+    port: number;
+    endpoint?: string;
+    maxWaitTime?: number;
+    pollInterval?: number;
+    requestTimeout?: number;
+    host?: string;
+    protocol?: "http" | "https";
+}
+/**
+ * Error thrown when server fails to become ready within the timeout
+ */
+export declare class ServerHealthError extends Error {
+    readonly url: string;
+    readonly cause?: Error | undefined;
+    constructor(message: string, url: string, cause?: Error | undefined);
+}
+/**
+ * Wait for server to be ready by polling health endpoint
+ *
+ * @param options - Configuration options for server health check
+ * @throws ServerHealthError if server doesn't become ready within maxWaitTime
+ */
+export declare function waitForServerReady(options: ServerHealthOptions): Promise<void>;
+/**
+ * Simple ping check for server availability (no stabilization wait)
+ *
+ * @param options - Configuration options for server ping
+ * @returns true if server responds with 2xx, false otherwise
+ */
+export declare function pingServer(options: ServerHealthOptions): Promise<boolean>;
+//# sourceMappingURL=server-health.d.ts.map

package/dist/utils/server-health.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server-health.d.ts","sourceRoot":"","sources":["../../src/utils/server-health.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,WAAW,mBAAmB;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;CAC5B;AAED;;GAEG;AACH,qBAAa,iBAAkB,SAAQ,KAAK;aAG1B,GAAG,EAAE,MAAM;aACX,KAAK,CAAC,EAAE,KAAK;gBAF7B,OAAO,EAAE,MAAM,EACC,GAAG,EAAE,MAAM,EACX,KAAK,CAAC,EAAE,KAAK,YAAA;CAK9B;AAoCD;;;;;GAKG;AACH,wBAAsB,kBAAkB,CACvC,OAAO,EAAE,mBAAmB,GAC1B,OAAO,CAAC,IAAI,CAAC,CA6Bf;AAED;;;;;GAKG;AACH,wBAAsB,UAAU,CAC/B,OAAO,EAAE,mBAAmB,GAC1B,OAAO,CAAC,OAAO,CAAC,CAKlB"}

package/dist/utils/slice-to-fit-budget.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Choose how many items to include so estimated character total stays within a
+ * target budget.
+ *
+ * WHY: Providers often fetch a superset of data, then need to keep prompt size
+ * bounded. One fetch + in-memory selection avoids extra DB round trips while
+ * still adapting to item size (short items -> more fit, long items -> fewer).
+ */
+export declare function sliceToFitBudget<T>(items: T[], estimateChars: (item: T) => number, targetChars: number, options?: {
+    fromEnd?: boolean;
+}): T[];
+//# sourceMappingURL=slice-to-fit-budget.d.ts.map

package/dist/utils/slice-to-fit-budget.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"slice-to-fit-budget.d.ts","sourceRoot":"","sources":["../../src/utils/slice-to-fit-budget.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,wBAAgB,gBAAgB,CAAC,CAAC,EACjC,KAAK,EAAE,CAAC,EAAE,EACV,aAAa,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,MAAM,EAClC,WAAW,EAAE,MAAM,EACnB,OAAO,CAAC,EAAE;IAAE,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,GAC7B,CAAC,EAAE,CA6BL"}

package/dist/utils/streaming.d.ts

@@ -0,0 +1,267 @@
+/**
+ * Streaming utilities for filtering and extracting streamable content.
+ *
+ * This module provides implementations of {@link IStreamExtractor}:
+ * - PassthroughExtractor - Simple passthrough (no filtering)
+ * - XmlTagExtractor - Extract content from a specific XML tag
+ * - ResponseStreamExtractor - Action-aware XML (for DefaultMessageService)
+ * - ActionStreamFilter - Content-type aware filter (for action handlers)
+ *
+ * For the interface definition, see types/streaming.ts.
+ * Implementations can use these or create their own extractors.
+ */
+import type { IStreamExtractor } from "../types/streaming";
+/** Error codes for streaming operations */
+export type StreamErrorCode = "CHUNK_TOO_LARGE" | "BUFFER_OVERFLOW" | "PARSE_ERROR" | "TIMEOUT" | "ABORTED";
+/**
+ * Standardized error class for streaming operations.
+ * Provides structured error codes for easier handling.
+ */
+export declare class StreamError extends Error {
+    readonly code: StreamErrorCode;
+    readonly details?: Record<string, unknown>;
+    constructor(code: StreamErrorCode, message: string, details?: Record<string, unknown>);
+    /** Check if an error is a StreamError */
+    static isStreamError(error: unknown): error is StreamError;
+}
+/**
+ * Streams all content as-is without any filtering.
+ * Use when LLM output is already in the desired format (e.g., plain text responses).
+ */
+export declare class PassthroughExtractor implements IStreamExtractor {
+    get done(): boolean;
+    push(chunk: string): string;
+    reset(): void;
+}
+/**
+ * Extracts content from a specific XML tag, streaming it progressively.
+ * Use when you have a simple XML format like `<response><text>content</text></response>`.
+ *
+ * @example
+ * ```ts
+ * const extractor = new XmlTagExtractor('text');
+ * extractor.push('<response><text>Hello'); // Returns 'Hel' (keeps margin for split tags)
+ * extractor.push(' world!</text></response>'); // Returns 'lo world!'
+ * ```
+ */
+export declare class XmlTagExtractor implements IStreamExtractor {
+    private readonly openTag;
+    private readonly closeTag;
+    private buffer;
+    private insideTag;
+    private finished;
+    constructor(tagName: string);
+    get done(): boolean;
+    push(chunk: string): string;
+    reset(): void;
+}
+/**
+ * Extracts streamable text from XML-structured LLM responses with action-based routing.
+ *
+ * This is the default implementation used by DefaultMessageService.
+ * It understands the `<actions>` tag to determine whether to stream `<text>` content.
+ *
+ * Strategy:
+ * - Parse <actions> to determine if response is direct (REPLY) or delegated (other actions)
+ * - If direct: stream <text> content immediately
+ * - If delegated: skip <text> (action handler will generate its own response via ActionStreamFilter)
+ *
+ * For simpler use cases without action routing, use {@link XmlTagExtractor} instead.
+ */
+export declare class ResponseStreamExtractor implements IStreamExtractor {
+    private static readonly STREAM_TAGS;
+    private static readonly OPEN_TEXT_TAG;
+    private static readonly CLOSE_TEXT_TAG;
+    private buffer;
+    private insideTag;
+    private currentTag;
+    private finished;
+    private responseStrategy;
+    get done(): boolean;
+    reset(): void;
+    push(chunk: string): string;
+    /** Detect response strategy from <actions> tag using pre-compiled regex */
+    private detectResponseStrategy;
+    /** Parse comma-separated actions */
+    private parseActions;
+    /** Check if actions represent a direct reply */
+    private isDirectReply;
+    /** Determine if a tag should be streamed based on strategy */
+    private shouldStreamTag;
+}
+/**
+ * Filters action handler output for streaming.
+ * Used by runtime.ts processActions() for each action's useModel calls.
+ *
+ * Auto-detects content type from first non-whitespace character:
+ * - JSON (starts with { or [) → Don't stream (structured data for parsing)
+ * - XML (starts with <) → Look for <text> tag and stream its content
+ * - Plain text → Stream immediately
+ */
+export declare class ActionStreamFilter implements IStreamExtractor {
+    private buffer;
+    private decided;
+    private contentType;
+    private insideTextTag;
+    private finished;
+    get done(): boolean;
+    reset(): void;
+    push(chunk: string): string;
+    /** Detect content type from first non-whitespace character */
+    private detectContentType;
+    /** Handle plain text - stream everything */
+    private handlePlainText;
+    /** Handle XML content - extract and stream <text> tag content */
+    private handleXml;
+}
+/**
+ * Passthrough extractor that can be marked complete externally.
+ *
+ * WHY: When using ValidationStreamExtractor inside dynamicPromptExecFromState,
+ * extraction/completion is handled internally. But the outer streaming context
+ * still needs to know when streaming is complete for retry/fallback logic.
+ *
+ * This extractor passes through all content and provides a markComplete() method
+ * that the caller can invoke when the underlying operation completes successfully.
+ *
+ * @example
+ * ```ts
+ * const extractor = new MarkableExtractor();
+ * const ctx = createStreamingContext(extractor, callback);
+ *
+ * const result = await dynamicPromptExecFromState({ ... });
+ * if (result) {
+ *   extractor.markComplete(); // Signal success
+ * }
+ *
+ * if (ctx.isComplete()) {
+ *   // Now returns true after markComplete()
+ * }
+ * ```
+ */
+export declare class MarkableExtractor implements IStreamExtractor {
+    private _done;
+    get done(): boolean;
+    push(chunk: string): string;
+    flush(): string;
+    reset(): void;
+    /**
+     * Mark the extractor as complete.
+     * WHY: Called by the outer code when the underlying operation completes
+     * successfully. This allows isComplete() to return true for retry/fallback logic.
+     */
+    markComplete(): void;
+}
+import type { SchemaRow, StreamEvent } from "../types/state";
+import type { IStreamingRetryState } from "../types/streaming";
+/**
+ * Extractor state machine for validation-aware streaming.
+ */
+export type ExtractorState = "streaming" | "validating" | "retrying" | "complete" | "failed";
+/**
+ * Per-field state tracking for progressive validation.
+ */
+export type FieldState = "pending" | "partial" | "complete" | "invalid";
+/**
+ * Configuration for ValidationStreamExtractor.
+ */
+export interface ValidationStreamExtractorConfig {
+    /** Validation level (0-3) */
+    level: 0 | 1 | 2 | 3;
+    /** Schema rows with field definitions */
+    schema: SchemaRow[];
+    /** Which fields to stream to the consumer */
+    streamFields: string[];
+    /** Expected validation codes per field */
+    expectedCodes: Map<string, string>;
+    /** Callback for streaming chunks */
+    onChunk: (chunk: string, field?: string) => void;
+    /** Rich event callback for sophisticated consumers */
+    onEvent?: (event: StreamEvent) => void;
+    /** Abort signal for cancellation */
+    abortSignal?: AbortSignal;
+    /** Whether the consumer has an onEvent handler */
+    hasRichConsumer?: boolean;
+}
+/**
+ * Diagnosis result for error analysis.
+ */
+export interface ValidationDiagnosis {
+    /** Fields that were never started */
+    missingFields: string[];
+    /** Fields with wrong validation codes */
+    invalidFields: string[];
+    /** Fields that started but didn't complete */
+    incompleteFields: string[];
+}
+/**
+ * Validation-aware stream extractor for dynamicPromptExecFromState.
+ *
+ * WHY THIS EXISTS:
+ * LLMs can silently truncate output when they hit token limits. This is catastrophic
+ * for structured outputs - you might get half a JSON object. Traditional streaming
+ * has no validation - you might stream half a broken response.
+ *
+ * This extractor bridges the gap: it enables streaming while detecting truncation.
+ * It uses "validation codes" - random UUIDs that the LLM must echo. If the echoed
+ * code matches, we know that part wasn't truncated.
+ *
+ * VALIDATION LEVELS:
+ * - Level 0 (Trusted): No codes, stream immediately. Fast but no safety.
+ * - Level 1 (Progressive): Per-field codes, emit as each field validates.
+ * - Level 2 (First Checkpoint): Code at start only, buffer until validated.
+ * - Level 3 (Full): Codes at start AND end, maximum safety.
+ */
+export declare class ValidationStreamExtractor implements IStreamExtractor {
+    private readonly config;
+    private buffer;
+    private fieldContents;
+    private validatedFields;
+    private emittedContent;
+    private fieldStates;
+    private state;
+    constructor(config: ValidationStreamExtractorConfig);
+    get done(): boolean;
+    push(chunk: string): string;
+    flush(): string;
+    reset(): void;
+    /**
+     * Signal a retry attempt. Returns info about validated fields for smart retry prompts.
+     */
+    signalRetry(retryCount: number): {
+        validatedFields: string[];
+    };
+    /**
+     * Signal an unrecoverable error.
+     */
+    signalError(message: string): void;
+    /**
+     * Get fields that passed validation (for smart retry context).
+     */
+    getValidatedFields(): Map<string, string>;
+    /**
+     * Diagnose what went wrong for error reporting.
+     */
+    diagnose(): ValidationDiagnosis;
+    /**
+     * Get current extractor state.
+     */
+    getState(): ExtractorState;
+    private extractFieldContents;
+    private checkPerFieldEmission;
+    private checkValidationCode;
+    private emitFieldContent;
+    private emitEvent;
+}
+import type { StreamingContext } from "../streaming-context";
+/**
+ * Creates a streaming retry state from an extractor.
+ */
+export declare function createStreamingRetryState(extractor: IStreamExtractor): IStreamingRetryState & {
+    appendText: (text: string) => void;
+};
+/**
+ * Creates a complete streaming context with retry state management.
+ */
+export declare function createStreamingContext(extractor: IStreamExtractor, onStreamChunk: (chunk: string, messageId?: string) => Promise<void>, messageId?: string): StreamingContext & IStreamingRetryState;
+//# sourceMappingURL=streaming.d.ts.map

package/dist/utils/streaming.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"streaming.d.ts","sourceRoot":"","sources":["../../src/utils/streaming.ts"],"names":[],"mappings":"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"}

package/dist/utils/text-normalize.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Text normalization helpers for prompt/context assembly.
+ *
+ * WHY: Several runtime paths need to turn mixed nested values into stable,
+ * human-readable text blocks. Keeping this logic in one place makes prompt
+ * construction more predictable and avoids each caller inventing slightly
+ * different null/array/object coercion rules.
+ */
+/**
+ * Flatten a mixed nested value into text fragments.
+ *
+ * - Arrays are recursively flattened
+ * - Empty/nullish values are dropped
+ * - Strings are trimmed
+ * - Objects become `key: value` fragments
+ * - Scalars are stringified
+ */
+export declare function flattenTextValues(value: unknown): string[];
+/**
+ * Convert a mixed nested value into a multi-line text block.
+ */
+export declare function toMultilineText(value: unknown): string;
+//# sourceMappingURL=text-normalize.d.ts.map

package/dist/utils/text-normalize.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"text-normalize.d.ts","sourceRoot":"","sources":["../../src/utils/text-normalize.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,EAAE,CAwB1D;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAEtD"}

package/dist/utils/text-splitting.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Splits text into the first sentence and the rest of the text.
+ * Handles common abbreviations to avoid false positives.
+ */
+export declare function extractFirstSentence(text: string): {
+    first: string;
+    rest: string;
+};
+/**
+ * Checks if the text likely contains a complete first sentence.
+ * Useful for streaming to know when to call extractFirstSentence.
+ */
+export declare function hasFirstSentence(text: string): boolean;
+//# sourceMappingURL=text-splitting.d.ts.map

package/dist/utils/text-splitting.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"text-splitting.d.ts","sourceRoot":"","sources":["../../src/utils/text-splitting.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG;IAClD,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;CACd,CAiEA;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAGtD"}