@falai/agent 2.6.1 → 3.0.0

package/dist/providers/errorClassification.js

@@ -1,116 +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 } from "../types/errors";
-/**
- * Type guard to check if error is ErrorWithStatus
- */
-export function isErrorWithStatus(error) {
-    return (typeof error === "object" &&
-        error !== null &&
-        ("status" in error || "code" in error || "message" in error));
-}
-/**
- * Safely extract error message
- */
-export function getErrorMessage(error) {
-    if (error instanceof Error) {
-        return error.message;
-    }
-    if (isErrorWithStatus(error) && error.message) {
-        return error.message;
-    }
-    return String(error);
-}
-/**
- * Message substrings every provider historically treated as
- * overloaded/unavailable for backup-model purposes.
- */
-const DEFAULT_OVERLOADED_MESSAGES = [
-    "overloaded",
-    "unavailable",
-    "internal error",
-    "Internal error",
-];
-/**
- * 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 function classifyProviderError(error, options = {}) {
-    if (!isErrorWithStatus(error)) {
-        return "unknown";
-    }
-    const { status, code, type } = error;
-    const message = getErrorMessage(error);
-    // Server errors / overload
-    if (status === 500 || status === 503) {
-        return "overloaded";
-    }
-    // Rate limiting
-    if (status === 429) {
-        return "rate_limited";
-    }
-    // Provider-specific overload/unavailability signals
-    if (status !== undefined && options.overloadedStatuses?.includes(status)) {
-        return "overloaded";
-    }
-    if (code !== undefined && options.overloadedCodes?.includes(code)) {
-        return "overloaded";
-    }
-    if (type !== undefined && options.overloadedTypes?.includes(type)) {
-        return "overloaded";
-    }
-    const overloadedMessages = options.overloadedMessages
-        ? [...DEFAULT_OVERLOADED_MESSAGES, ...options.overloadedMessages]
-        : DEFAULT_OVERLOADED_MESSAGES;
-    if (overloadedMessages.some((pattern) => message.includes(pattern))) {
-        return "overloaded";
-    }
-    // Non-retriable classifications (never triggered backup models)
-    if (status === 401 || status === 403) {
-        return "auth";
-    }
-    if (status === 400 || status === 404 || status === 422) {
-        return "invalid_request";
-    }
-    if (status === 408 ||
-        message.includes("timed out") ||
-        message.includes("timeout")) {
-        return "timeout";
-    }
-    if (message.includes("fetch failed") ||
-        message.includes("ECONNREFUSED") ||
-        message.includes("ECONNRESET") ||
-        message.includes("ETIMEDOUT") ||
-        message.includes("network")) {
-        return "network";
-    }
-    return "unknown";
-}
-/**
- * Whether an error code qualifies for trying backup models.
- * Mirrors the historical shouldUseBackupModel predicate.
- */
-export function isBackupEligible(code) {
-    return code === "rate_limited" || code === "overloaded";
-}
-/**
- * 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 function toProviderError(error, provider, options) {
-    if (error instanceof ProviderError) {
-        return error;
-    }
-    return new ProviderError(classifyProviderError(error, options), provider, getErrorMessage(error), error);
-}
-//# sourceMappingURL=errorClassification.js.map

package/dist/providers/errorClassification.js.map

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

package/dist/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/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/utils/retry.js

@@ -1,193 +0,0 @@
-/**
- * Retry utility with exponential backoff
- */
-import { logger } from './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.
- */
-export function resolveRetryConfig(input) {
-    return {
-        timeout: input?.timeout || DEFAULT_RETRY_CONFIG.timeout,
-        retries: input?.retries ?? DEFAULT_RETRY_CONFIG.retries,
-    };
-}
-export 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.
- */
-export 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;
-}
-export 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.error(`[${operationName}] Failed attempt ${attempt + 1}:`, message);
-            const delay = defaultBackoff(attempt);
-            logger.debug(`[${operationName}] Retrying in ${delay}ms...`);
-            logger.debug(`[${operationName}] Attempt ${attempt + 2}/${maxRetries + 1}`);
-        },
-        onFailure: (_error) => {
-            logger.error(`[${operationName}] All ${maxRetries + 1} attempts failed`);
-            return true;
-        },
-    });
-};
-/** 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.
- */
-export 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.error(`[${operationName}] Failed attempt ${attempt + 1}:`, message);
-            const delayMs = delay(attempt);
-            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/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/src/core/DirectiveBus.ts

@@ -1,248 +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";
-import { flow } from "./flow-namespace";
-import { logger } from "../utils";
-
-/** 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 class DirectiveBus<TContext = unknown, TData = unknown> {
-    private entries: DirectiveBusEntry<TContext, TData>[] = [];
-    private currentPhase: DirectiveBusPhase = "pre-llm";
-    private orderCounter = 0;
-
-    /** Set the current collection phase. Resets the order counter for the new phase. */
-    setPhase(phase: DirectiveBusPhase): void {
-        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(): DirectiveBusPhase {
-        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: Directive<TContext, TData>, emitterId: string): void {
-        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 as Record<string, unknown>)[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(): Directive<TContext, TData> | undefined {
-        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: Directive<TContext, TData> = 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 as Record<string, unknown>;
-            const preLlmFields = ["appendPrompt", "injectTools", "halt"] as const;
-
-            // 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: string[] = [];
-            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 as Record<string, unknown>;
-                        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(): Directive<TContext, TData> | undefined {
-        if (this.entries.length === 0) {
-            return undefined;
-        }
-
-        this.logConflicts(this.entries);
-
-        let merged: Directive<TContext, TData> = 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(): void {
-        this.entries = [];
-        this.orderCounter = 0;
-        this.currentPhase = "pre-llm";
-    }
-
-    /** Get the number of entries currently on the bus. */
-    get size(): number {
-        return this.entries.length;
-    }
-
-    /** Get all entries (for inspection/testing). */
-    getEntries(): ReadonlyArray<DirectiveBusEntry<TContext, TData>> {
-        return this.entries;
-    }
-
-    /** Check if the bus has any entries for the current phase. */
-    hasEntries(): boolean {
-        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.
-     */
-    private logConflicts(
-        entries: DirectiveBusEntry<TContext, TData>[]
-    ): void {
-        // Check for position field conflicts
-        const positionEmitters: Array<{ emitterId: string; field: string }> = [];
-        for (const entry of entries) {
-            const d = entry.directive as Record<string, unknown>;
-            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 as Record<string, unknown>).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}`
-            );
-        }
-    }
-}