@falai/agent 1.2.7 → 2.0.0

package/dist/cjs/core/BranchEvaluator.js

@@ -0,0 +1,130 @@
+"use strict";
+/**
+ * Branch Evaluator — Resolution Algorithm (Algorithm 2 from design.md)
+ *
+ * Pure function that evaluates a BranchMap in declaration order.
+ * Code-first evaluation: `if` predicates run before `when` (AI) conditions
+ * to save tokens. First matching entry wins.
+ *
+ * @module BranchEvaluator
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createAiConditionEvaluator = createAiConditionEvaluator;
+exports.evaluateBranches = evaluateBranches;
+const utils_1 = require("../utils");
+/**
+ * Creates an `AiConditionEvaluator` bound to a provider and conversation context.
+ *
+ * Reuses the same evaluation pattern as `step.when` array forms: condition
+ * strings are passed to the AI provider for evaluation against the conversation
+ * history. No new prompt scaffolding — the provider evaluates whether the
+ * conditions are met based on the conversation so far.
+ *
+ * String form (`when: "some condition"`) is normalized to a single-element
+ * array by the caller (`evaluateBranches`) for uniformity before reaching
+ * this function.
+ *
+ * @param provider - The AI provider to use for condition evaluation
+ * @param history - Conversation history (events) for context
+ * @param context - Agent-level context
+ * @returns An `AiConditionEvaluator` function
+ */
+function createAiConditionEvaluator(provider, history, context) {
+    return async (conditions) => {
+        if (conditions.length === 0) {
+            return true;
+        }
+        const conditionText = conditions.length === 1
+            ? conditions[0]
+            : conditions.map((c, i) => `${i + 1}. ${c}`).join("\n");
+        const prompt = [
+            "Evaluate whether the following condition(s) are met based on the conversation so far.",
+            "",
+            "Condition(s):",
+            conditionText,
+            "",
+            "Return JSON with a single boolean field `result`: true if ALL conditions are satisfied, false otherwise.",
+        ].join("\n");
+        const result = await provider.generateMessage({
+            prompt,
+            history: (0, utils_1.eventsToHistory)(history),
+            context,
+            parameters: {
+                jsonSchema: {
+                    type: "object",
+                    properties: {
+                        result: {
+                            type: "boolean",
+                            description: "Whether all conditions are met based on the conversation context",
+                        },
+                    },
+                    required: ["result"],
+                    additionalProperties: false,
+                },
+                schemaName: "condition_evaluation",
+            },
+        });
+        return result.structured?.result ?? false;
+    };
+}
+/**
+ * Evaluates a BranchMap in declaration order, returning the first matching
+ * entry's `then` value, or `undefined` if no entry matches.
+ *
+ * Resolution rules per entry:
+ * 1. Unconditional (no `when`, no `if`) → return `then` immediately.
+ * 2. `if` first: normalize to array, await each predicate, short-circuit on first falsy.
+ * 3. `when` second: only if `if` passed (or absent); call evaluateAi with condition strings.
+ * 4. Both passed (or only one set and it passed) → return `then`.
+ *
+ * Errors in predicates or AI evaluation are caught, logged at ERROR, and
+ * cause `evaluateBranches` to return `undefined` (graceful degradation).
+ */
+async function evaluateBranches(branches, ctx, evaluateAi) {
+    try {
+        for (let i = 0; i < branches.length; i++) {
+            const entry = branches[i];
+            // Unconditional fallback: entry has neither `when` nor `if`.
+            // Validation guarantees this is the LAST entry.
+            if (!entry.when && !entry.if) {
+                return entry.then;
+            }
+            // Code predicate first (free evaluation)
+            if (entry.if) {
+                const predicates = Array.isArray(entry.if)
+                    ? entry.if
+                    : [entry.if];
+                let ifPassed = true;
+                for (const predicate of predicates) {
+                    const result = await predicate(ctx);
+                    if (!result) {
+                        ifPassed = false;
+                        break;
+                    }
+                }
+                if (!ifPassed) {
+                    continue; // skip this entry; do NOT evaluate `when`
+                }
+            }
+            // AI condition (costs tokens — only reached if `if` passed or was absent)
+            if (entry.when) {
+                const conditions = Array.isArray(entry.when)
+                    ? entry.when
+                    : [entry.when];
+                const aiResult = await evaluateAi(conditions);
+                if (!aiResult) {
+                    continue; // skip this entry
+                }
+            }
+            // Both passed (or only one was set and it passed)
+            return entry.then;
+        }
+        // No entry matched
+        return undefined;
+    }
+    catch (error) {
+        utils_1.logger.error(`[BranchEvaluator] Error during branch evaluation: ${error instanceof Error ? error.message : String(error)}`);
+        return undefined;
+    }
+}
+//# sourceMappingURL=BranchEvaluator.js.map

package/dist/cjs/core/BranchEvaluator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"BranchEvaluator.js","sourceRoot":"","sources":["../../../src/core/BranchEvaluator.ts"],"names":[],"mappings":";AAAA;;;;;;;;GAQG;;AAuCH,gEA6CC;AAeD,4CA2DC;AApJD,oCAAmD;AAYnD;;;;;;;;;;;;;;;;GAgBG;AACH,SAAgB,0BAA0B,CACtC,QAAoB,EACpB,OAAgB,EAChB,OAAiB;IAEjB,OAAO,KAAK,EAAE,UAAoB,EAAoB,EAAE;QACpD,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC1B,OAAO,IAAI,CAAC;QAChB,CAAC;QAED,MAAM,aAAa,GAAG,UAAU,CAAC,MAAM,KAAK,CAAC;YACzC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC;YACf,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAE5D,MAAM,MAAM,GAAG;YACX,uFAAuF;YACvF,EAAE;YACF,eAAe;YACf,aAAa;YACb,EAAE;YACF,0GAA0G;SAC7G,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAEb,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,eAAe,CAAgC;YACzE,MAAM;YACN,OAAO,EAAE,IAAA,uBAAe,EAAC,OAAO,CAAC;YACjC,OAAO;YACP,UAAU,EAAE;gBACR,UAAU,EAAE;oBACR,IAAI,EAAE,QAAQ;oBACd,UAAU,EAAE;wBACR,MAAM,EAAE;4BACJ,IAAI,EAAE,SAAS;4BACf,WAAW,EAAE,kEAAkE;yBAClF;qBACJ;oBACD,QAAQ,EAAE,CAAC,QAAQ,CAAC;oBACpB,oBAAoB,EAAE,KAAK;iBAC9B;gBACD,UAAU,EAAE,sBAAsB;aACrC;SACJ,CAAC,CAAC;QAEH,OAAO,MAAM,CAAC,UAAU,EAAE,MAAM,IAAI,KAAK,CAAC;IAC9C,CAAC,CAAC;AACN,CAAC;AAED;;;;;;;;;;;;GAYG;AACI,KAAK,UAAU,gBAAgB,CAClC,QAAoC,EACpC,GAA4C,EAC5C,UAAgC;IAEhC,IAAI,CAAC;QACD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,QAAQ,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YACvC,MAAM,KAAK,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;YAE1B,6DAA6D;YAC7D,gDAAgD;YAChD,IAAI,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,EAAE,EAAE,CAAC;gBAC3B,OAAO,KAAK,CAAC,IAAI,CAAC;YACtB,CAAC;YAED,yCAAyC;YACzC,IAAI,KAAK,CAAC,EAAE,EAAE,CAAC;gBACX,MAAM,UAAU,GAAuC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;oBAC1E,CAAC,CAAC,KAAK,CAAC,EAAE;oBACV,CAAC,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;gBAEjB,IAAI,QAAQ,GAAG,IAAI,CAAC;gBACpB,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;oBACjC,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,GAAG,CAAC,CAAC;oBACpC,IAAI,CAAC,MAAM,EAAE,CAAC;wBACV,QAAQ,GAAG,KAAK,CAAC;wBACjB,MAAM;oBACV,CAAC;gBACL,CAAC;gBAED,IAAI,CAAC,QAAQ,EAAE,CAAC;oBACZ,SAAS,CAAC,0CAA0C;gBACxD,CAAC;YACL,CAAC;YAED,0EAA0E;YAC1E,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC;gBACb,MAAM,UAAU,GAAa,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC;oBAClD,CAAC,CAAC,KAAK,CAAC,IAAI;oBACZ,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;gBAEnB,MAAM,QAAQ,GAAG,MAAM,UAAU,CAAC,UAAU,CAAC,CAAC;gBAC9C,IAAI,CAAC,QAAQ,EAAE,CAAC;oBACZ,SAAS,CAAC,kBAAkB;gBAChC,CAAC;YACL,CAAC;YAED,kDAAkD;YAClD,OAAO,KAAK,CAAC,IAAI,CAAC;QACtB,CAAC;QAED,mBAAmB;QACnB,OAAO,SAAS,CAAC;IACrB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACb,cAAM,CAAC,KAAK,CACR,qDAAqD,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAChH,CAAC;QACF,OAAO,SAAS,CAAC;IACrB,CAAC;AACL,CAAC"}

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

@@ -0,0 +1,88 @@
+/**
+ * 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/cjs/core/DirectiveBus.d.ts.map

@@ -0,0 +1 @@
+{"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/cjs/core/DirectiveBus.js

@@ -0,0 +1,196 @@
+"use strict";
+/**
+ * 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**
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DirectiveBus = void 0;
+const flow_namespace_1 = require("./flow-namespace");
+const utils_1 = require("../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();
+ * ```
+ */
+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++,
+        });
+        utils_1.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_namespace_1.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];
+                }
+                utils_1.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_namespace_1.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(", ");
+            utils_1.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(", ");
+            utils_1.logger.debug(`[DirectiveBus] Multiple reply fields in one turn — using last emission. Emitters: ${emitterIds}`);
+        }
+    }
+}
+exports.DirectiveBus = DirectiveBus;
+//# sourceMappingURL=DirectiveBus.js.map

package/dist/cjs/core/DirectiveBus.js.map

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

package/dist/cjs/core/DirectiveChainTracker.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Per-turn directive chain depth tracker.
+ *
+ * When directives chain (e.g., tool emits goTo → flow.onEnter emits goTo →
+ * flow.onComplete emits complete.next → …), the chain can theoretically loop
+ * forever. This tracker counts each directive application within a single turn
+ * and throws `FlowConfigurationError` when the configured cap is exceeded.
+ *
+ * Chain breakers (`abort` mid-chain) stop counting and apply the
+ * chain-terminating directive immediately.
+ *
+ * Validates: Requirements 22.1, 22.2, 22.3
+ */
+import type { Directive } from "../types/flow";
+/**
+ * Entry in the directive chain log — records what was emitted and by whom.
+ */
+export interface DirectiveChainEntry {
+    /** Human-readable description of the directive (e.g., "goTo:Booking", "complete", "abort:timeout") */
+    description: string;
+    /** Identifier of the emitter (e.g., "tool:lookup_order", "hook:onEnter", "pending") */
+    emitter: string;
+}
+/**
+ * Tracks directive chain depth within a single turn.
+ * Create one instance per turn; discard at turn end.
+ */
+export declare class DirectiveChainTracker {
+    private chain;
+    private readonly maxDepth;
+    constructor(maxDirectiveChain: number);
+    /**
+     * Record a directive application in the chain.
+     * Throws `FlowConfigurationError` if the chain exceeds `maxDirectiveChain`.
+     *
+     * @param directive - The directive being applied
+     * @param emitter - Identifier of the emitter (for diagnostics)
+     * @returns `true` if the directive is a chain breaker (abort) — caller should
+     *          apply it and stop the chain without further counting.
+     */
+    record(directive: Directive, emitter: string): boolean;
+    /** Current chain depth. */
+    get depth(): number;
+    /** The full chain log (read-only). */
+    get entries(): ReadonlyArray<DirectiveChainEntry>;
+    /** Reset the tracker (e.g., for testing or if the turn is restarted). */
+    reset(): void;
+}
+//# sourceMappingURL=DirectiveChainTracker.d.ts.map

package/dist/cjs/core/DirectiveChainTracker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DirectiveChainTracker.d.ts","sourceRoot":"","sources":["../../../src/core/DirectiveChainTracker.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAIH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAE/C;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAChC,sGAAsG;IACtG,WAAW,EAAE,MAAM,CAAC;IACpB,uFAAuF;IACvF,OAAO,EAAE,MAAM,CAAC;CACnB;AAED;;;GAGG;AACH,qBAAa,qBAAqB;IAC9B,OAAO,CAAC,KAAK,CAA6B;IAC1C,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;gBAEtB,iBAAiB,EAAE,MAAM;IAIrC;;;;;;;;OAQG;IACH,MAAM,CAAC,SAAS,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO;IAkCtD,2BAA2B;IAC3B,IAAI,KAAK,IAAI,MAAM,CAElB;IAED,sCAAsC;IACtC,IAAI,OAAO,IAAI,aAAa,CAAC,mBAAmB,CAAC,CAEhD;IAED,yEAAyE;IACzE,KAAK,IAAI,IAAI;CAGhB"}

package/dist/cjs/core/DirectiveChainTracker.js

@@ -0,0 +1,121 @@
+"use strict";
+/**
+ * Per-turn directive chain depth tracker.
+ *
+ * When directives chain (e.g., tool emits goTo → flow.onEnter emits goTo →
+ * flow.onComplete emits complete.next → …), the chain can theoretically loop
+ * forever. This tracker counts each directive application within a single turn
+ * and throws `FlowConfigurationError` when the configured cap is exceeded.
+ *
+ * Chain breakers (`abort` mid-chain) stop counting and apply the
+ * chain-terminating directive immediately.
+ *
+ * Validates: Requirements 22.1, 22.2, 22.3
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DirectiveChainTracker = void 0;
+const Step_1 = require("./Step");
+const utils_1 = require("../utils");
+/**
+ * Tracks directive chain depth within a single turn.
+ * Create one instance per turn; discard at turn end.
+ */
+class DirectiveChainTracker {
+    constructor(maxDirectiveChain) {
+        this.chain = [];
+        this.maxDepth = maxDirectiveChain;
+    }
+    /**
+     * Record a directive application in the chain.
+     * Throws `FlowConfigurationError` if the chain exceeds `maxDirectiveChain`.
+     *
+     * @param directive - The directive being applied
+     * @param emitter - Identifier of the emitter (for diagnostics)
+     * @returns `true` if the directive is a chain breaker (abort) — caller should
+     *          apply it and stop the chain without further counting.
+     */
+    record(directive, emitter) {
+        const description = describeDirective(directive);
+        // Check if this is a chain breaker (abort)
+        if (directive.abort !== undefined) {
+            this.chain.push({ description, emitter });
+            utils_1.logger.debug(`[DirectiveChainTracker] Chain breaker (abort) at depth ${this.chain.length}: ${description} from ${emitter}`);
+            return true; // Chain breaker — apply and stop
+        }
+        this.chain.push({ description, emitter });
+        if (this.chain.length > this.maxDepth) {
+            const chainDescription = this.chain
+                .map((entry, i) => `  ${i + 1}. ${entry.description} (from: ${entry.emitter})`)
+                .join("\n");
+            throw new Step_1.FlowConfigurationError(`[FlowConfigurationError] Directive chain cycle detected: ` +
+                `chain depth (${this.chain.length}) exceeded maxDirectiveChain (${this.maxDepth}). ` +
+                `Review flow hooks and tool handlers for circular redirections.\n` +
+                `Chain (in emission order):\n${chainDescription}`);
+        }
+        utils_1.logger.debug(`[DirectiveChainTracker] Chain depth ${this.chain.length}/${this.maxDepth}: ${description} from ${emitter}`);
+        return false; // Not a chain breaker — continue normally
+    }
+    /** Current chain depth. */
+    get depth() {
+        return this.chain.length;
+    }
+    /** The full chain log (read-only). */
+    get entries() {
+        return this.chain;
+    }
+    /** Reset the tracker (e.g., for testing or if the turn is restarted). */
+    reset() {
+        this.chain = [];
+    }
+}
+exports.DirectiveChainTracker = DirectiveChainTracker;
+/**
+ * Produce a human-readable one-line description of a directive for diagnostics.
+ */
+function describeDirective(directive) {
+    if (directive.abort !== undefined) {
+        const reason = typeof directive.abort === "string"
+            ? directive.abort
+            : typeof directive.abort === "object"
+                ? directive.abort.reason
+                : "";
+        return `abort${reason ? `:${reason}` : ""}`;
+    }
+    if (directive.goTo !== undefined) {
+        const target = typeof directive.goTo === "string"
+            ? directive.goTo
+            : typeof directive.goTo === "object"
+                ? directive.goTo.flow ?? "(no flow)"
+                : "";
+        return `goTo:${target}`;
+    }
+    if (directive.goToStep !== undefined) {
+        const target = typeof directive.goToStep === "string"
+            ? directive.goToStep
+            : typeof directive.goToStep === "object"
+                ? directive.goToStep.step
+                : "";
+        return `goToStep:${target}`;
+    }
+    if (directive.complete !== undefined) {
+        if (directive.complete === true)
+            return "complete";
+        if (typeof directive.complete === "object" && directive.complete.next) {
+            return "complete(chained)";
+        }
+        return "complete";
+    }
+    if (directive.reset !== undefined) {
+        return "reset";
+    }
+    // State-only or reply-only directive
+    const parts = [];
+    if (directive.reply)
+        parts.push("reply");
+    if (directive.dataUpdate)
+        parts.push("dataUpdate");
+    if (directive.contextUpdate)
+        parts.push("contextUpdate");
+    return parts.length > 0 ? parts.join("+") : "(empty)";
+}
+//# sourceMappingURL=DirectiveChainTracker.js.map

package/dist/cjs/core/DirectiveChainTracker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DirectiveChainTracker.js","sourceRoot":"","sources":["../../../src/core/DirectiveChainTracker.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;GAYG;;;AAEH,iCAAgD;AAChD,oCAAkC;AAalC;;;GAGG;AACH,MAAa,qBAAqB;IAI9B,YAAY,iBAAyB;QAH7B,UAAK,GAA0B,EAAE,CAAC;QAItC,IAAI,CAAC,QAAQ,GAAG,iBAAiB,CAAC;IACtC,CAAC;IAED;;;;;;;;OAQG;IACH,MAAM,CAAC,SAAoB,EAAE,OAAe;QACxC,MAAM,WAAW,GAAG,iBAAiB,CAAC,SAAS,CAAC,CAAC;QAEjD,2CAA2C;QAC3C,IAAI,SAAS,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;YAChC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,WAAW,EAAE,OAAO,EAAE,CAAC,CAAC;YAC1C,cAAM,CAAC,KAAK,CACR,0DAA0D,IAAI,CAAC,KAAK,CAAC,MAAM,KAAK,WAAW,SAAS,OAAO,EAAE,CAChH,CAAC;YACF,OAAO,IAAI,CAAC,CAAC,iCAAiC;QAClD,CAAC;QAED,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,WAAW,EAAE,OAAO,EAAE,CAAC,CAAC;QAE1C,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,IAAI,CAAC,QAAQ,EAAE,CAAC;YACpC,MAAM,gBAAgB,GAAG,IAAI,CAAC,KAAK;iBAC9B,GAAG,CAAC,CAAC,KAAK,EAAE,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,KAAK,CAAC,WAAW,WAAW,KAAK,CAAC,OAAO,GAAG,CAAC;iBAC9E,IAAI,CAAC,IAAI,CAAC,CAAC;YAEhB,MAAM,IAAI,6BAAsB,CAC5B,2DAA2D;gBAC3D,gBAAgB,IAAI,CAAC,KAAK,CAAC,MAAM,iCAAiC,IAAI,CAAC,QAAQ,KAAK;gBACpF,kEAAkE;gBAClE,+BAA+B,gBAAgB,EAAE,CACpD,CAAC;QACN,CAAC;QAED,cAAM,CAAC,KAAK,CACR,uCAAuC,IAAI,CAAC,KAAK,CAAC,MAAM,IAAI,IAAI,CAAC,QAAQ,KAAK,WAAW,SAAS,OAAO,EAAE,CAC9G,CAAC;QAEF,OAAO,KAAK,CAAC,CAAC,0CAA0C;IAC5D,CAAC;IAED,2BAA2B;IAC3B,IAAI,KAAK;QACL,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC;IAC7B,CAAC;IAED,sCAAsC;IACtC,IAAI,OAAO;QACP,OAAO,IAAI,CAAC,KAAK,CAAC;IACtB,CAAC;IAED,yEAAyE;IACzE,KAAK;QACD,IAAI,CAAC,KAAK,GAAG,EAAE,CAAC;IACpB,CAAC;CACJ;AAjED,sDAiEC;AAED;;GAEG;AACH,SAAS,iBAAiB,CAAC,SAAoB;IAC3C,IAAI,SAAS,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;QAChC,MAAM,MAAM,GAAG,OAAO,SAAS,CAAC,KAAK,KAAK,QAAQ;YAC9C,CAAC,CAAC,SAAS,CAAC,KAAK;YACjB,CAAC,CAAC,OAAO,SAAS,CAAC,KAAK,KAAK,QAAQ;gBACjC,CAAC,CAAC,SAAS,CAAC,KAAK,CAAC,MAAM;gBACxB,CAAC,CAAC,EAAE,CAAC;QACb,OAAO,QAAQ,MAAM,CAAC,CAAC,CAAC,IAAI,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;IAChD,CAAC;IACD,IAAI,SAAS,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;QAC/B,MAAM,MAAM,GAAG,OAAO,SAAS,CAAC,IAAI,KAAK,QAAQ;YAC7C,CAAC,CAAC,SAAS,CAAC,IAAI;YAChB,CAAC,CAAC,OAAO,SAAS,CAAC,IAAI,KAAK,QAAQ;gBAChC,CAAC,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,IAAI,WAAW;gBACpC,CAAC,CAAC,EAAE,CAAC;QACb,OAAO,QAAQ,MAAM,EAAE,CAAC;IAC5B,CAAC;IACD,IAAI,SAAS,CAAC,QAAQ,KAAK,SAAS,EAAE,CAAC;QACnC,MAAM,MAAM,GAAG,OAAO,SAAS,CAAC,QAAQ,KAAK,QAAQ;YACjD,CAAC,CAAC,SAAS,CAAC,QAAQ;YACpB,CAAC,CAAC,OAAO,SAAS,CAAC,QAAQ,KAAK,QAAQ;gBACpC,CAAC,CAAC,SAAS,CAAC,QAAQ,CAAC,IAAI;gBACzB,CAAC,CAAC,EAAE,CAAC;QACb,OAAO,YAAY,MAAM,EAAE,CAAC;IAChC,CAAC;IACD,IAAI,SAAS,CAAC,QAAQ,KAAK,SAAS,EAAE,CAAC;QACnC,IAAI,SAAS,CAAC,QAAQ,KAAK,IAAI;YAAE,OAAO,UAAU,CAAC;QACnD,IAAI,OAAO,SAAS,CAAC,QAAQ,KAAK,QAAQ,IAAI,SAAS,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;YACpE,OAAO,mBAAmB,CAAC;QAC/B,CAAC;QACD,OAAO,UAAU,CAAC;IACtB,CAAC;IACD,IAAI,SAAS,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;QAChC,OAAO,OAAO,CAAC;IACnB,CAAC;IACD,qCAAqC;IACrC,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,IAAI,SAAS,CAAC,KAAK;QAAE,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACzC,IAAI,SAAS,CAAC,UAAU;QAAE,KAAK,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;IACnD,IAAI,SAAS,CAAC,aAAa;QAAE,KAAK,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;IACzD,OAAO,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;AAC1D,CAAC"}