@falai/agent 2.6.1 → 3.0.0

package/dist/cjs/utils/retry.d.ts

@@ -1,67 +0,0 @@
-export interface RetryOptions<T> {
-    operation: () => Promise<T>;
-    maxRetries: number;
-    delay: (attempt: number) => number;
-    onRetry?: (attempt: number, error: unknown) => void;
-    onFailure?: (error: unknown) => boolean;
-}
-/** Provider timeout (ms) + retry count, after defaults are applied. */
-export interface RetryConfig {
-    timeout: number;
-    retries: number;
-}
-/**
- * Normalize a provider's optional retry config against the defaults. `timeout`
- * uses `||` (a 0ms timeout is degenerate — it aborts every call immediately — so
- * fall back to the default), while `retries` uses `??` so an explicit
- * `retries: 0` (disable retries) is honored rather than treated as unset. Single
- * definition so this distinction can't drift between providers.
- */
-export declare function resolveRetryConfig(input?: {
-    timeout?: number;
-    retries?: number;
-}): RetryConfig;
-export declare function retry<T>(options: RetryOptions<T>): Promise<T>;
-/**
- * Combine abort signals into one that aborts as soon as any input aborts.
- * `undefined` inputs are skipped, so a caller can pass an optional caller-signal
- * alongside a required per-attempt one. Returns the sole signal when only one is
- * present (no wrapper), or `undefined` when none are.
- *
- * Prefers the platform `AbortSignal.any`, which cleans up its listeners via weak
- * refs — so merging onto a long-lived caller signal that's reused across many
- * calls can't accumulate listeners. Falls back to a manual controller on older
- * runtimes (< Node 20.3); there the listeners live until a source aborts or is
- * garbage-collected, which is fine for the usual per-request signal.
- */
-export declare function combineAbortSignals(...signals: Array<AbortSignal | undefined>): AbortSignal | undefined;
-export declare const withTimeoutAndRetry: <T>(operation: (signal: AbortSignal) => Promise<T>, timeoutMs?: number, maxRetries?: number, operationName?: string) => Promise<T>;
-export interface StreamRetryOptions {
-    /** Maximum number of retries after the first attempt. Defaults to 3. */
-    maxRetries?: number;
-    /** Backoff before the next attempt, in ms. Defaults to capped exponential. */
-    delay?: (attempt: number) => number;
-    /** Label used in retry logs. */
-    operationName?: string;
-    /**
-     * Max ms to wait for the *first* chunk (time-to-first-token) before treating
-     * the attempt as failed. Guards a provider that opens a stream and then
-     * stalls. Only the first chunk is bounded — later chunks are unbounded so a
-     * long but healthy stream is never cut off. `0`/omitted disables the deadline.
-     */
-    firstChunkTimeoutMs?: number;
-}
-/**
- * Streaming analog of {@link withTimeoutAndRetry}. Re-runs an async-generator
- * factory as long as it fails *before yielding its first chunk* — an empty
- * completion that throws "No response", an error while establishing the stream,
- * or (with `firstChunkTimeoutMs`) a stall before the first token. Once any chunk
- * has been yielded the stream is committed and further errors propagate, so a
- * retry can never double-emit deltas the consumer has already received.
- *
- * This mirrors the non-streaming path, where the provider throws on an empty
- * completion inside `withTimeoutAndRetry` and is retried on the same model
- * before the caller falls through to backup models.
- */
-export declare function withStreamRetry<T>(factory: (signal: AbortSignal) => AsyncGenerator<T>, options?: StreamRetryOptions): AsyncGenerator<T>;
-//# sourceMappingURL=retry.d.ts.map

package/dist/cjs/utils/retry.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"retry.d.ts","sourceRoot":"","sources":["../../../src/utils/retry.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,YAAY,CAAC,CAAC;IAC7B,SAAS,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,CAAC;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,MAAM,CAAC;IACnC,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;IACpD,SAAS,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,OAAO,CAAC;CACzC;AAED,uEAAuE;AACvE,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;CACjB;AAOD;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,CAAC,EAAE;IACzC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,GAAG,WAAW,CAKd;AAED,wBAAsB,KAAK,CAAC,CAAC,EAAE,OAAO,EAAE,YAAY,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CA8BnE;AAMD;;;;;;;;;;;GAWG;AACH,wBAAgB,mBAAmB,CACjC,GAAG,OAAO,EAAE,KAAK,CAAC,WAAW,GAAG,SAAS,CAAC,GACzC,WAAW,GAAG,SAAS,CAgBzB;AAED,eAAO,MAAM,mBAAmB,GAAU,CAAC,EACzC,WAAW,CAAC,MAAM,EAAE,WAAW,KAAK,OAAO,CAAC,CAAC,CAAC,EAC9C,YAAW,MAAc,EACzB,aAAY,MAAU,EACtB,gBAAe,MAAuB,KACrC,OAAO,CAAC,CAAC,CAiDX,CAAC;AAEF,MAAM,WAAW,kBAAkB;IACjC,wEAAwE;IACxE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,8EAA8E;IAC9E,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,MAAM,CAAC;IACpC,gCAAgC;IAChC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB;;;;;OAKG;IACH,mBAAmB,CAAC,EAAE,MAAM,CAAC;CAC9B;AAuBD;;;;;;;;;;;GAWG;AACH,wBAAuB,eAAe,CAAC,CAAC,EACtC,OAAO,EAAE,CAAC,MAAM,EAAE,WAAW,KAAK,cAAc,CAAC,CAAC,CAAC,EACnD,OAAO,GAAE,kBAAuB,GAC/B,cAAc,CAAC,CAAC,CAAC,CAwDnB"}

package/dist/cjs/utils/retry.js

@@ -1,201 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.withTimeoutAndRetry = void 0;
-exports.resolveRetryConfig = resolveRetryConfig;
-exports.retry = retry;
-exports.combineAbortSignals = combineAbortSignals;
-exports.withStreamRetry = withStreamRetry;
-/**
- * Retry utility with exponential backoff
- */
-const logger_1 = require("./logger");
-const DEFAULT_RETRY_CONFIG = {
-    timeout: 60000,
-    retries: 3,
-};
-/**
- * Normalize a provider's optional retry config against the defaults. `timeout`
- * uses `||` (a 0ms timeout is degenerate — it aborts every call immediately — so
- * fall back to the default), while `retries` uses `??` so an explicit
- * `retries: 0` (disable retries) is honored rather than treated as unset. Single
- * definition so this distinction can't drift between providers.
- */
-function resolveRetryConfig(input) {
-    return {
-        timeout: input?.timeout || DEFAULT_RETRY_CONFIG.timeout,
-        retries: input?.retries ?? DEFAULT_RETRY_CONFIG.retries,
-    };
-}
-async function retry(options) {
-    const { operation, maxRetries, delay, onRetry, onFailure } = options;
-    let lastError;
-    for (let attempt = 0; attempt <= maxRetries; attempt++) {
-        try {
-            return await operation();
-        }
-        catch (error) {
-            lastError = error;
-            if (attempt === maxRetries) {
-                const shouldRethrow = onFailure ? onFailure(lastError) : true;
-                if (shouldRethrow) {
-                    throw lastError;
-                }
-                break;
-            }
-            if (onRetry) {
-                onRetry(attempt, lastError);
-            }
-            const delayMs = delay(attempt);
-            await new Promise((resolve) => setTimeout(resolve, delayMs));
-        }
-    }
-    // eslint-disable-next-line @typescript-eslint/only-throw-error
-    throw lastError ?? new Error("Operation failed");
-}
-/** Capped exponential backoff (1s, 2s, 4s, … max 5s) shared by the retry helpers. */
-const defaultBackoff = (attempt) => Math.min(1000 * Math.pow(2, attempt), 5000);
-/**
- * Combine abort signals into one that aborts as soon as any input aborts.
- * `undefined` inputs are skipped, so a caller can pass an optional caller-signal
- * alongside a required per-attempt one. Returns the sole signal when only one is
- * present (no wrapper), or `undefined` when none are.
- *
- * Prefers the platform `AbortSignal.any`, which cleans up its listeners via weak
- * refs — so merging onto a long-lived caller signal that's reused across many
- * calls can't accumulate listeners. Falls back to a manual controller on older
- * runtimes (< Node 20.3); there the listeners live until a source aborts or is
- * garbage-collected, which is fine for the usual per-request signal.
- */
-function combineAbortSignals(...signals) {
-    const present = signals.filter((s) => s != null);
-    if (present.length <= 1)
-        return present[0];
-    if (typeof AbortSignal.any === "function")
-        return AbortSignal.any(present);
-    const controller = new AbortController();
-    for (const signal of present) {
-        if (signal.aborted) {
-            controller.abort(signal.reason);
-            break;
-        }
-        signal.addEventListener("abort", () => controller.abort(signal.reason), {
-            once: true,
-        });
-    }
-    return controller.signal;
-}
-const withTimeoutAndRetry = async (operation, timeoutMs = 60000, maxRetries = 3, operationName = "AI operation") => {
-    const createTimeoutOperation = () => async () => {
-        const controller = new AbortController();
-        const timeoutId = setTimeout(() => {
-            controller.abort();
-        }, timeoutMs);
-        try {
-            // Hand the operation the timeout signal so the in-flight upstream call is
-            // actually cancelled when the deadline fires — otherwise the abandoned
-            // attempt keeps running while the retry stacks a second concurrent call.
-            const result = await Promise.race([
-                operation(controller.signal),
-                new Promise((_, reject) => {
-                    controller.signal.addEventListener("abort", () => {
-                        reject(new Error(`Operation timed out after ${timeoutMs}ms`));
-                    });
-                }),
-            ]);
-            clearTimeout(timeoutId);
-            return result;
-        }
-        catch (error) {
-            clearTimeout(timeoutId);
-            throw error;
-        }
-    };
-    return retry({
-        operation: createTimeoutOperation(),
-        maxRetries,
-        delay: defaultBackoff,
-        onRetry: (attempt, error) => {
-            const message = error instanceof Error ? error.message : String(error);
-            logger_1.logger.error(`[${operationName}] Failed attempt ${attempt + 1}:`, message);
-            const delay = defaultBackoff(attempt);
-            logger_1.logger.debug(`[${operationName}] Retrying in ${delay}ms...`);
-            logger_1.logger.debug(`[${operationName}] Attempt ${attempt + 2}/${maxRetries + 1}`);
-        },
-        onFailure: (_error) => {
-            logger_1.logger.error(`[${operationName}] All ${maxRetries + 1} attempts failed`);
-            return true;
-        },
-    });
-};
-exports.withTimeoutAndRetry = withTimeoutAndRetry;
-/** Reject if `next` hasn't settled within `timeoutMs`; always clears its timer. */
-function raceFirstChunk(next, timeoutMs, operationName) {
-    let timer;
-    const timeout = new Promise((_, reject) => {
-        timer = setTimeout(() => reject(new Error(`[${operationName}] Stream timed out: no first chunk within ${timeoutMs}ms`)), timeoutMs);
-    });
-    return Promise.race([next, timeout]).finally(() => clearTimeout(timer));
-}
-/**
- * Streaming analog of {@link withTimeoutAndRetry}. Re-runs an async-generator
- * factory as long as it fails *before yielding its first chunk* — an empty
- * completion that throws "No response", an error while establishing the stream,
- * or (with `firstChunkTimeoutMs`) a stall before the first token. Once any chunk
- * has been yielded the stream is committed and further errors propagate, so a
- * retry can never double-emit deltas the consumer has already received.
- *
- * This mirrors the non-streaming path, where the provider throws on an empty
- * completion inside `withTimeoutAndRetry` and is retried on the same model
- * before the caller falls through to backup models.
- */
-async function* withStreamRetry(factory, options = {}) {
-    const { maxRetries = 3, delay = defaultBackoff, operationName = "AI stream", firstChunkTimeoutMs, } = options;
-    for (let attempt = 0; attempt <= maxRetries; attempt++) {
-        // One controller per attempt: aborting it on abandon cancels the upstream
-        // SDK call so a retry can't stack a second concurrent stream.
-        const controller = new AbortController();
-        const iterator = factory(controller.signal);
-        let yielded = false;
-        let completed = false;
-        try {
-            // Drive the iterator by hand so the first chunk can be raced against a
-            // deadline; for-await would give no hook for that.
-            for (;;) {
-                const result = !yielded && firstChunkTimeoutMs
-                    ? await raceFirstChunk(iterator.next(), firstChunkTimeoutMs, operationName)
-                    : await iterator.next();
-                if (result.done) {
-                    completed = true;
-                    return;
-                }
-                yielded = true;
-                yield result.value;
-            }
-        }
-        catch (error) {
-            // Can't retry once deltas are out, and don't retry past the budget.
-            if (yielded || attempt === maxRetries) {
-                throw error;
-            }
-            const message = error instanceof Error ? error.message : String(error);
-            logger_1.logger.error(`[${operationName}] Failed attempt ${attempt + 1}:`, message);
-            const delayMs = delay(attempt);
-            logger_1.logger.debug(`[${operationName}] Retrying in ${delayMs}ms... (attempt ${attempt + 2}/${maxRetries + 1})`);
-            await new Promise((resolve) => setTimeout(resolve, delayMs));
-        }
-        finally {
-            // Abandoning an attempt (first-chunk timeout, pre-yield error before a
-            // retry, or a consumer that breaks early): abort the upstream SDK call
-            // first so it's actually torn down — not left running while we retry —
-            // then dispose the iterator. Aborting also unblocks a stalled
-            // iterator.next() so return() can run the generator's cleanup. Both are
-            // fire-and-forget: a wedged generator's return() may never settle, so we
-            // must not await it.
-            if (!completed) {
-                controller.abort();
-                void iterator.return?.(undefined)?.catch(() => undefined);
-            }
-        }
-    }
-}
-//# sourceMappingURL=retry.js.map

package/dist/cjs/utils/retry.js.map

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

package/dist/core/DirectiveBus.d.ts

@@ -1,88 +0,0 @@
-/**
- * DirectiveBus — per-turn collection mechanism for directives emitted by
- * hooks, tools, and branches.
- *
- * Two phases per turn:
- * 1. Pre-LLM: collects from `prepare` hooks and `onEnter` hooks.
- * 2. Post-LLM: collects from `finalize`, tools via `executeToolCalls`,
- *    branches via `evaluateBranches`.
- *
- * Each entry is stamped with an emitter ID for debug logging. At phase
- * boundaries, the bus contents are merged using `flow.merge` and the
- * result is returned via `drain()`.
- *
- * Algorithm 4: position precedence `abort > complete > goTo/goToStep > reset`,
- * ties broken by emission order (last wins).
- *
- * **Validates: Requirements 1.3, 10.4, 10.5, 10.6**
- */
-import type { Directive } from "../types/flow";
-/** Phase of the turn pipeline the bus is currently collecting for. */
-export type DirectiveBusPhase = "pre-llm" | "post-llm";
-/** A single entry on the bus, stamped with its emitter for debug logging. */
-export interface DirectiveBusEntry<TContext = unknown, TData = unknown> {
-    directive: Directive<TContext, TData>;
-    emitterId: string;
-    phase: DirectiveBusPhase;
-    /** Monotonically increasing emission index within the phase. */
-    order: number;
-}
-/**
- * Per-turn directive collection bus.
- *
- * Usage:
- * ```ts
- * const bus = new DirectiveBus();
- * bus.setPhase('pre-llm');
- * bus.emit({ goTo: 'Booking' }, 'step.onEnter:ask_date');
- * bus.emit({ appendPrompt: ['Be concise.'] }, 'step.prepare:ask_date');
- * const merged = bus.drain(); // merges all collected directives
- * bus.setPhase('post-llm');
- * // ... collect post-LLM emissions ...
- * const postMerged = bus.drain();
- * ```
- */
-export declare class DirectiveBus<TContext = unknown, TData = unknown> {
-    private entries;
-    private currentPhase;
-    private orderCounter;
-    /** Set the current collection phase. Resets the order counter for the new phase. */
-    setPhase(phase: DirectiveBusPhase): void;
-    /** Get the current phase. */
-    getPhase(): DirectiveBusPhase;
-    /**
-     * Emit a directive onto the bus.
-     *
-     * @param directive - The directive to collect.
-     * @param emitterId - Human-readable identifier of the emitter (for debug logging).
-     */
-    emit(directive: Directive<TContext, TData>, emitterId: string): void;
-    /**
-     * Drain the bus: merge all collected directives for the current phase
-     * using Algorithm 4 (position precedence, last-wins tie-breaking,
-     * shallow-merge for state writes).
-     *
-     * Returns `undefined` if no directives were collected.
-     * After draining, the entries for the current phase are cleared.
-     */
-    drain(): Directive<TContext, TData> | undefined;
-    /**
-     * Drain ALL entries regardless of phase. Used for final turn cleanup.
-     * Returns `undefined` if no directives were collected.
-     */
-    drainAll(): Directive<TContext, TData> | undefined;
-    /** Clear all collected entries and reset the bus for a new turn. */
-    clear(): void;
-    /** Get the number of entries currently on the bus. */
-    get size(): number;
-    /** Get all entries (for inspection/testing). */
-    getEntries(): ReadonlyArray<DirectiveBusEntry<TContext, TData>>;
-    /** Check if the bus has any entries for the current phase. */
-    hasEntries(): boolean;
-    /**
-     * Log debug-level conflict warnings when multiple emitters set position
-     * fields or reply fields in the same phase.
-     */
-    private logConflicts;
-}
-//# sourceMappingURL=DirectiveBus.d.ts.map

package/dist/core/DirectiveBus.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"DirectiveBus.d.ts","sourceRoot":"","sources":["../../src/core/DirectiveBus.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAI/C,sEAAsE;AACtE,MAAM,MAAM,iBAAiB,GAAG,SAAS,GAAG,UAAU,CAAC;AAEvD,6EAA6E;AAC7E,MAAM,WAAW,iBAAiB,CAAC,QAAQ,GAAG,OAAO,EAAE,KAAK,GAAG,OAAO;IAClE,SAAS,EAAE,SAAS,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;IACtC,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,iBAAiB,CAAC;IACzB,gEAAgE;IAChE,KAAK,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;;;;;;;;;GAcG;AACH,qBAAa,YAAY,CAAC,QAAQ,GAAG,OAAO,EAAE,KAAK,GAAG,OAAO;IACzD,OAAO,CAAC,OAAO,CAA4C;IAC3D,OAAO,CAAC,YAAY,CAAgC;IACpD,OAAO,CAAC,YAAY,CAAK;IAEzB,oFAAoF;IACpF,QAAQ,CAAC,KAAK,EAAE,iBAAiB,GAAG,IAAI;IAMxC,6BAA6B;IAC7B,QAAQ,IAAI,iBAAiB;IAI7B;;;;;OAKG;IACH,IAAI,CAAC,SAAS,EAAE,SAAS,CAAC,QAAQ,EAAE,KAAK,CAAC,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI;IAyBpE;;;;;;;OAOG;IACH,KAAK,IAAI,SAAS,CAAC,QAAQ,EAAE,KAAK,CAAC,GAAG,SAAS;IA4D/C;;;OAGG;IACH,QAAQ,IAAI,SAAS,CAAC,QAAQ,EAAE,KAAK,CAAC,GAAG,SAAS;IAgBlD,oEAAoE;IACpE,KAAK,IAAI,IAAI;IAMb,sDAAsD;IACtD,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,gDAAgD;IAChD,UAAU,IAAI,aAAa,CAAC,iBAAiB,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;IAI/D,8DAA8D;IAC9D,UAAU,IAAI,OAAO;IAMrB;;;OAGG;IACH,OAAO,CAAC,YAAY;CAiCvB"}

package/dist/core/DirectiveBus.js

@@ -1,192 +0,0 @@
-/**
- * DirectiveBus — per-turn collection mechanism for directives emitted by
- * hooks, tools, and branches.
- *
- * Two phases per turn:
- * 1. Pre-LLM: collects from `prepare` hooks and `onEnter` hooks.
- * 2. Post-LLM: collects from `finalize`, tools via `executeToolCalls`,
- *    branches via `evaluateBranches`.
- *
- * Each entry is stamped with an emitter ID for debug logging. At phase
- * boundaries, the bus contents are merged using `flow.merge` and the
- * result is returned via `drain()`.
- *
- * Algorithm 4: position precedence `abort > complete > goTo/goToStep > reset`,
- * ties broken by emission order (last wins).
- *
- * **Validates: Requirements 1.3, 10.4, 10.5, 10.6**
- */
-import { flow } from "./flow-namespace";
-import { logger } from "../utils";
-/**
- * Per-turn directive collection bus.
- *
- * Usage:
- * ```ts
- * const bus = new DirectiveBus();
- * bus.setPhase('pre-llm');
- * bus.emit({ goTo: 'Booking' }, 'step.onEnter:ask_date');
- * bus.emit({ appendPrompt: ['Be concise.'] }, 'step.prepare:ask_date');
- * const merged = bus.drain(); // merges all collected directives
- * bus.setPhase('post-llm');
- * // ... collect post-LLM emissions ...
- * const postMerged = bus.drain();
- * ```
- */
-export class DirectiveBus {
-    constructor() {
-        this.entries = [];
-        this.currentPhase = "pre-llm";
-        this.orderCounter = 0;
-    }
-    /** Set the current collection phase. Resets the order counter for the new phase. */
-    setPhase(phase) {
-        this.currentPhase = phase;
-        // Order counter is NOT reset — emission order is global within the turn
-        // so that cross-phase comparisons (if ever needed) remain consistent.
-    }
-    /** Get the current phase. */
-    getPhase() {
-        return this.currentPhase;
-    }
-    /**
-     * Emit a directive onto the bus.
-     *
-     * @param directive - The directive to collect.
-     * @param emitterId - Human-readable identifier of the emitter (for debug logging).
-     */
-    emit(directive, emitterId) {
-        if (!directive || typeof directive !== "object" || Array.isArray(directive)) {
-            return; // Silently ignore non-object values (void returns from hooks)
-        }
-        // Check if the directive has any meaningful fields set
-        const hasFields = Object.keys(directive).some((k) => directive[k] !== undefined);
-        if (!hasFields) {
-            return; // Empty directive — nothing to collect
-        }
-        this.entries.push({
-            directive,
-            emitterId,
-            phase: this.currentPhase,
-            order: this.orderCounter++,
-        });
-        logger.debug(`[DirectiveBus] Collected directive from "${emitterId}" (phase=${this.currentPhase}, order=${this.orderCounter - 1})`);
-    }
-    /**
-     * Drain the bus: merge all collected directives for the current phase
-     * using Algorithm 4 (position precedence, last-wins tie-breaking,
-     * shallow-merge for state writes).
-     *
-     * Returns `undefined` if no directives were collected.
-     * After draining, the entries for the current phase are cleared.
-     */
-    drain() {
-        const phaseEntries = this.entries.filter((e) => e.phase === this.currentPhase);
-        if (phaseEntries.length === 0) {
-            return undefined;
-        }
-        // Log conflicts when multiple emitters set position or reply fields
-        this.logConflicts(phaseEntries);
-        // Merge all directives in emission order using flow.merge (pairwise reduction).
-        // flow.merge implements Algorithm 4: position precedence with last-wins tie-breaking.
-        let merged = phaseEntries[0].directive;
-        for (let i = 1; i < phaseEntries.length; i++) {
-            merged = flow.merge(merged, phaseEntries[i].directive);
-        }
-        // Strip pre-LLM-only fields from post-LLM phase emissions
-        if (this.currentPhase === "post-llm") {
-            const asAny = merged;
-            const preLlmFields = ["appendPrompt", "injectTools", "halt"];
-            // Identify which fields are present BEFORE stripping (the merge may
-            // alias phaseEntries[0].directive when there is a single emitter, so
-            // we must collect emitter names first).
-            const droppedFields = [];
-            for (const f of preLlmFields) {
-                if (asAny[f] !== undefined) {
-                    droppedFields.push(f);
-                }
-            }
-            if (droppedFields.length > 0) {
-                // Identify emitters that contributed the dropped fields.
-                const emitters = phaseEntries
-                    .filter((e) => {
-                    const d = e.directive;
-                    return droppedFields.some((f) => d[f] !== undefined);
-                })
-                    .map((e) => e.emitterId);
-                // Now strip the fields from the merged result.
-                for (const f of droppedFields) {
-                    delete asAny[f];
-                }
-                logger.debug(`[DirectiveBus] Dropped pre-LLM-only fields [${droppedFields.join(", ")}] from post-LLM emitters: ${emitters.join(", ")}`);
-            }
-        }
-        // Clear entries for the drained phase
-        this.entries = this.entries.filter((e) => e.phase !== this.currentPhase);
-        return merged;
-    }
-    /**
-     * Drain ALL entries regardless of phase. Used for final turn cleanup.
-     * Returns `undefined` if no directives were collected.
-     */
-    drainAll() {
-        if (this.entries.length === 0) {
-            return undefined;
-        }
-        this.logConflicts(this.entries);
-        let merged = this.entries[0].directive;
-        for (let i = 1; i < this.entries.length; i++) {
-            merged = flow.merge(merged, this.entries[i].directive);
-        }
-        this.entries = [];
-        return merged;
-    }
-    /** Clear all collected entries and reset the bus for a new turn. */
-    clear() {
-        this.entries = [];
-        this.orderCounter = 0;
-        this.currentPhase = "pre-llm";
-    }
-    /** Get the number of entries currently on the bus. */
-    get size() {
-        return this.entries.length;
-    }
-    /** Get all entries (for inspection/testing). */
-    getEntries() {
-        return this.entries;
-    }
-    /** Check if the bus has any entries for the current phase. */
-    hasEntries() {
-        return this.entries.some((e) => e.phase === this.currentPhase);
-    }
-    // ─── Private helpers ─────────────────────────────────────────────────────
-    /**
-     * Log debug-level conflict warnings when multiple emitters set position
-     * fields or reply fields in the same phase.
-     */
-    logConflicts(entries) {
-        // Check for position field conflicts
-        const positionEmitters = [];
-        for (const entry of entries) {
-            const d = entry.directive;
-            for (const field of ["abort", "complete", "goTo", "goToStep", "reset"]) {
-                if (d[field] !== undefined) {
-                    positionEmitters.push({ emitterId: entry.emitterId, field });
-                }
-            }
-        }
-        if (positionEmitters.length > 1) {
-            const details = positionEmitters
-                .map((e) => `${e.emitterId}(${e.field})`)
-                .join(", ");
-            logger.debug(`[DirectiveBus] Multiple position fields in one turn — conflict resolution applied. Emitters: ${details}`);
-        }
-        // Check for reply conflicts
-        const replyEmitters = entries.filter((e) => e.directive.reply !== undefined);
-        if (replyEmitters.length > 1) {
-            const emitterIds = replyEmitters.map((e) => e.emitterId).join(", ");
-            logger.debug(`[DirectiveBus] Multiple reply fields in one turn — using last emission. Emitters: ${emitterIds}`);
-        }
-    }
-}
-//# sourceMappingURL=DirectiveBus.js.map

package/dist/core/DirectiveBus.js.map

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

package/dist/providers/errorClassification.d.ts

@@ -1,61 +0,0 @@
-/**
- * Shared provider error utilities: classification of SDK/HTTP errors onto
- * normalized ProviderErrorCode values, backup-model eligibility, and
- * wrapping of terminal failures in ProviderError.
- *
- * The classification is derived once and reused for both backup-model
- * decisions and final error wrapping, so the two can never drift apart.
- */
-import { ProviderError, type ProviderErrorCode } from "../types/errors";
-/**
- * Shape of errors with status/code properties thrown by provider SDKs
- */
-export interface ErrorWithStatus {
-    status?: number;
-    code?: string;
-    message?: string;
-    type?: string;
-}
-/**
- * Type guard to check if error is ErrorWithStatus
- */
-export declare function isErrorWithStatus(error: unknown): error is ErrorWithStatus;
-/**
- * Safely extract error message
- */
-export declare function getErrorMessage(error: unknown): string;
-/**
- * Provider-specific signals treated as "overloaded/unavailable", in
- * addition to the shared defaults (HTTP 500/503 and the common message
- * substrings below).
- */
-export interface ErrorClassificationOptions {
-    /** Extra HTTP statuses treated as overloaded (e.g. Anthropic's 529) */
-    overloadedStatuses?: readonly number[];
-    /** Error `code` values treated as overloaded/unavailable (e.g. "model_not_found") */
-    overloadedCodes?: readonly string[];
-    /** Error `type` values treated as overloaded (e.g. Anthropic's "overloaded_error") */
-    overloadedTypes?: readonly string[];
-    /** Extra message substrings treated as overloaded (e.g. OpenRouter's "capacity") */
-    overloadedMessages?: readonly string[];
-}
-/**
- * Classify an unknown error into a normalized ProviderErrorCode.
- *
- * Overload/availability checks run first so that backup-model decisions
- * (rate_limited/overloaded) match the historical shouldUseBackupModel
- * predicate exactly.
- */
-export declare function classifyProviderError(error: unknown, options?: ErrorClassificationOptions): ProviderErrorCode;
-/**
- * Whether an error code qualifies for trying backup models.
- * Mirrors the historical shouldUseBackupModel predicate.
- */
-export declare function isBackupEligible(code: ProviderErrorCode): boolean;
-/**
- * Wrap a terminal failure (after retries/backup exhaustion) in a
- * normalized ProviderError, preserving the original error as `cause`.
- * Already-wrapped errors pass through untouched.
- */
-export declare function toProviderError(error: unknown, provider: string, options?: ErrorClassificationOptions): ProviderError;
-//# sourceMappingURL=errorClassification.d.ts.map

package/dist/providers/errorClassification.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"errorClassification.d.ts","sourceRoot":"","sources":["../../src/providers/errorClassification.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,aAAa,EAAE,KAAK,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAExE;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,eAAe,CAM1E;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAQtD;AAED;;;;GAIG;AACH,MAAM,WAAW,0BAA0B;IACzC,uEAAuE;IACvE,kBAAkB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACvC,qFAAqF;IACrF,eAAe,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACpC,sFAAsF;IACtF,eAAe,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACpC,oFAAoF;IACpF,kBAAkB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CACxC;AAaD;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,OAAO,EACd,OAAO,GAAE,0BAA+B,GACvC,iBAAiB,CA4DnB;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,iBAAiB,GAAG,OAAO,CAEjE;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAC7B,KAAK,EAAE,OAAO,EACd,QAAQ,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE,0BAA0B,GACnC,aAAa,CAUf"}