@falai/agent 3.4.4 → 4.0.0-alpha.1

package/dist/core/SignalCoordinator.d.ts

@@ -1,103 +0,0 @@
-/**
- * SignalCoordinator owns the signal pre/post phase orchestration for a turn:
- *
- * - `runPrePhase()` / `runPostPhase()` — delegation to the SignalProcessor,
- *   returning a stable empty shape when no processor is configured.
- * - `applyPositionDirective()` — applies a pre-phase directive's position
- *   field (goTo, goToStep, complete, abort, reset) as the turn's routing
- *   decision, discarding the router's result.
- * - `applyPostPhase()` — runs the post phase and applies its directive to
- *   the turn result in one step: session updates, pendingDirective for
- *   position fields (no mid-turn re-entry per D6), and the reply override
- *   of the user-visible message.
- */
-import type { Directive, Event, SessionState } from "../types/index.js";
-import type { SignalFiring } from "../types/signals.js";
-import type { SignalProcessor } from "./SignalProcessor.js";
-import type { Flow } from "./Flow.js";
-import type { Step } from "./Step.js";
-/** Result of a signal phase run (pre or post). */
-export interface SignalPhaseResult<TContext = unknown, TData = unknown> {
-    firings: SignalFiring<TContext, TData>[];
-    updatedSession: SessionState<TData>;
-    mergedDirective: Directive<TContext, TData> | undefined;
-}
-export declare class SignalCoordinator<TContext = unknown, TData = unknown> {
-    private readonly deps;
-    constructor(deps: {
-        getFlows: () => Flow<TContext, TData>[];
-        signalProcessor?: SignalProcessor<TContext, TData>;
-    });
-    /** Whether a signal processor is configured (zero-cost path when absent). */
-    get enabled(): boolean;
-    /**
-     * PRE-SIGNAL PHASE — Evaluates pre/both signals in parallel with routing.
-     *
-     * Delegates to `signalProcessor.runPreSignalPhase(...)` when configured.
-     * When no signal processor is present (zero-cost path), returns a stable
-     * empty shape so callers don't need to branch.
-     *
-     * @requirements 2.1, 2.3, 8.6, 13.3
-     */
-    runPrePhase(session: SessionState<TData>, context: TContext, history: Event[]): Promise<SignalPhaseResult<TContext, TData>>;
-    /**
-     * POST-SIGNAL PHASE — Evaluates post/both signals after finalize/onComplete.
-     *
-     * Delegates to `signalProcessor.runPostSignalPhase(...)` when configured.
-     * When no signal processor is present, returns a stable empty shape.
-     *
-     * Post-phase signals see the complete turn result: assistant message in history,
-     * collected data, tool results. Position directives from this phase set
-     * `session.pendingDirective` (no mid-turn re-entry per D6 decision).
-     *
-     * Pre-LLM-only fields (`appendPrompt`, `injectTools`, `halt`) are already
-     * dropped inside `runPostSignalPhase` per Phase 4.5 — this seam does NOT
-     * re-introduce them.
-     *
-     * @requirements 9.1, 9.2, 9.3, 9.4
-     */
-    runPostPhase(session: SessionState<TData>, context: TContext, history: Event[]): Promise<SignalPhaseResult<TContext, TData>>;
-    /**
-     * Run the post phase and apply its merged directive to the turn result:
-     * session updates from the phase, `pendingDirective` for position fields
-     * (Requirement 9.3, no mid-turn re-entry per D6), and the reply override
-     * of the user-visible message (undefined means "leave it unchanged"; an
-     * empty string is an explicit replacement).
-     *
-     * @requirements 9.1, 9.2, 9.3, 9.4
-     */
-    applyPostPhase(params: {
-        session: SessionState<TData>;
-        context: TContext;
-        historyEvents: Event[];
-        message: string;
-    }): Promise<{
-        session: SessionState<TData>;
-        message: string;
-        firings: SignalFiring<TContext, TData>[];
-        /** True when the directive's `reply` replaced the message. */
-        replyOverridden: boolean;
-    }>;
-    /**
-     * Apply a signal's position directive (goTo, goToStep, complete, abort, reset).
-     * Discards routing result and uses the signal's position decision.
-     *
-     * @requirements 8.3
-     */
-    applyPositionDirective(signalResult: {
-        firings: SignalFiring<TContext, TData>[];
-        updatedSession: SessionState<TData>;
-        mergedDirective: Directive<TContext, TData> | undefined;
-    }): {
-        selectedFlow?: Flow<TContext, TData>;
-        selectedStep?: Step<TContext, TData>;
-        responseDirectives?: string[];
-        session: SessionState<TData>;
-        isFlowComplete: boolean;
-        signalFirings?: SignalFiring<TContext, TData>[];
-        signalPreDirective?: Directive<TContext, TData>;
-        signalHalted?: boolean;
-        signalHaltReply?: string;
-    };
-}
-//# sourceMappingURL=SignalCoordinator.d.ts.map

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

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

package/dist/core/SignalCoordinator.js

@@ -1,203 +0,0 @@
-/**
- * SignalCoordinator owns the signal pre/post phase orchestration for a turn:
- *
- * - `runPrePhase()` / `runPostPhase()` — delegation to the SignalProcessor,
- *   returning a stable empty shape when no processor is configured.
- * - `applyPositionDirective()` — applies a pre-phase directive's position
- *   field (goTo, goToStep, complete, abort, reset) as the turn's routing
- *   decision, discarding the router's result.
- * - `applyPostPhase()` — runs the post phase and applies its directive to
- *   the turn result in one step: session updates, pendingDirective for
- *   position fields (no mid-turn re-entry per D6), and the reply override
- *   of the user-visible message.
- */
-import { hasDirectivePositionField } from "./ResponsePipeline.js";
-import { enterFlow, enterStep, mergeCollected, logger } from "../utils/index.js";
-export class SignalCoordinator {
-    constructor(deps) {
-        this.deps = deps;
-    }
-    /** Whether a signal processor is configured (zero-cost path when absent). */
-    get enabled() {
-        return this.deps.signalProcessor !== undefined;
-    }
-    /**
-     * PRE-SIGNAL PHASE — Evaluates pre/both signals in parallel with routing.
-     *
-     * Delegates to `signalProcessor.runPreSignalPhase(...)` when configured.
-     * When no signal processor is present (zero-cost path), returns a stable
-     * empty shape so callers don't need to branch.
-     *
-     * @requirements 2.1, 2.3, 8.6, 13.3
-     */
-    async runPrePhase(session, context, history) {
-        if (!this.deps.signalProcessor) {
-            return { firings: [], updatedSession: session, mergedDirective: undefined };
-        }
-        const result = await this.deps.signalProcessor.runPreSignalPhase({ session, history, context });
-        return {
-            firings: result.firings,
-            updatedSession: result.updatedSession,
-            mergedDirective: result.mergedDirective,
-        };
-    }
-    /**
-     * POST-SIGNAL PHASE — Evaluates post/both signals after finalize/onComplete.
-     *
-     * Delegates to `signalProcessor.runPostSignalPhase(...)` when configured.
-     * When no signal processor is present, returns a stable empty shape.
-     *
-     * Post-phase signals see the complete turn result: assistant message in history,
-     * collected data, tool results. Position directives from this phase set
-     * `session.pendingDirective` (no mid-turn re-entry per D6 decision).
-     *
-     * Pre-LLM-only fields (`appendPrompt`, `injectTools`, `halt`) are already
-     * dropped inside `runPostSignalPhase` per Phase 4.5 — this seam does NOT
-     * re-introduce them.
-     *
-     * @requirements 9.1, 9.2, 9.3, 9.4
-     */
-    async runPostPhase(session, context, history) {
-        if (!this.deps.signalProcessor) {
-            return { firings: [], updatedSession: session, mergedDirective: undefined };
-        }
-        const result = await this.deps.signalProcessor.runPostSignalPhase({ session, history, context });
-        return {
-            firings: result.firings,
-            updatedSession: result.updatedSession,
-            mergedDirective: result.mergedDirective,
-        };
-    }
-    /**
-     * Run the post phase and apply its merged directive to the turn result:
-     * session updates from the phase, `pendingDirective` for position fields
-     * (Requirement 9.3, no mid-turn re-entry per D6), and the reply override
-     * of the user-visible message (undefined means "leave it unchanged"; an
-     * empty string is an explicit replacement).
-     *
-     * @requirements 9.1, 9.2, 9.3, 9.4
-     */
-    async applyPostPhase(params) {
-        const postResult = await this.runPostPhase(params.session, params.context, params.historyEvents);
-        let session = postResult.updatedSession;
-        // Requirement 9.3: Post-phase position directive sets session.pendingDirective
-        if (postResult.mergedDirective && hasDirectivePositionField(postResult.mergedDirective)) {
-            session = { ...session, pendingDirective: postResult.mergedDirective };
-        }
-        const replyOverridden = postResult.mergedDirective?.reply !== undefined;
-        const message = replyOverridden
-            ? postResult.mergedDirective.reply
-            : params.message;
-        return { session, message, firings: postResult.firings, replyOverridden };
-    }
-    /**
-     * Apply a signal's position directive (goTo, goToStep, complete, abort, reset).
-     * Discards routing result and uses the signal's position decision.
-     *
-     * @requirements 8.3
-     */
-    applyPositionDirective(signalResult) {
-        const directive = signalResult.mergedDirective;
-        let session = signalResult.updatedSession;
-        const flows = this.deps.getFlows();
-        let selectedFlow;
-        let selectedStep;
-        let isFlowComplete = false;
-        // Apply data updates if present alongside position
-        if (directive.dataUpdate) {
-            session = mergeCollected(session, directive.dataUpdate);
-        }
-        if (directive.goTo) {
-            const flowTarget = typeof directive.goTo === 'string'
-                ? directive.goTo
-                : directive.goTo.flow ?? directive.goTo.step;
-            if (flowTarget) {
-                const targetFlow = flows.find(f => f.id === flowTarget || f.title === flowTarget);
-                if (targetFlow) {
-                    session = enterFlow(session, targetFlow.id, targetFlow.title);
-                    selectedFlow = targetFlow;
-                    if (typeof directive.goTo === 'object' && directive.goTo.step) {
-                        const targetStep = targetFlow.getStep(directive.goTo.step);
-                        if (targetStep) {
-                            session = enterStep(session, targetStep.id, targetStep.description);
-                            selectedStep = targetStep;
-                        }
-                    }
-                }
-                else {
-                    logger.warn(`[Signals] Pre-phase goTo target not found: "${flowTarget}". Falling back to no flow.`);
-                }
-            }
-        }
-        else if (directive.goToStep) {
-            const stepTarget = typeof directive.goToStep === 'string'
-                ? directive.goToStep
-                : directive.goToStep.step;
-            const flowTarget = typeof directive.goToStep === 'object'
-                ? directive.goToStep.flow
-                : undefined;
-            if (flowTarget) {
-                const targetFlow = flows.find(f => f.id === flowTarget || f.title === flowTarget);
-                if (targetFlow) {
-                    session = enterFlow(session, targetFlow.id, targetFlow.title);
-                    selectedFlow = targetFlow;
-                    const targetStep = targetFlow.getStep(stepTarget);
-                    if (targetStep) {
-                        session = enterStep(session, targetStep.id, targetStep.description);
-                        selectedStep = targetStep;
-                    }
-                }
-            }
-            else if (session.currentFlow) {
-                const currentFlow = flows.find(f => f.id === session.currentFlow?.id);
-                if (currentFlow) {
-                    selectedFlow = currentFlow;
-                    const targetStep = currentFlow.getStep(stepTarget);
-                    if (targetStep) {
-                        session = enterStep(session, targetStep.id, targetStep.description);
-                        selectedStep = targetStep;
-                    }
-                }
-            }
-        }
-        else if (directive.complete) {
-            isFlowComplete = true;
-        }
-        else if (directive.abort) {
-            // Abort — no flow, session cleared or marked
-            isFlowComplete = true;
-        }
-        else if (directive.reset) {
-            if (session.currentFlow) {
-                const currentFlow = flows.find(f => f.id === session.currentFlow?.id);
-                if (currentFlow) {
-                    selectedFlow = currentFlow;
-                    const resetStep = typeof directive.reset === 'object' && directive.reset.step
-                        ? directive.reset.step
-                        : undefined;
-                    if (resetStep) {
-                        const targetStep = currentFlow.getStep(resetStep);
-                        if (targetStep) {
-                            session = enterStep(session, targetStep.id, targetStep.description);
-                            selectedStep = targetStep;
-                        }
-                    }
-                    else {
-                        const initialStep = currentFlow.initialStep;
-                        session = enterStep(session, initialStep.id, initialStep.description);
-                        selectedStep = initialStep;
-                    }
-                }
-            }
-        }
-        return {
-            selectedFlow,
-            selectedStep,
-            session,
-            isFlowComplete,
-            signalFirings: signalResult.firings,
-            signalPreDirective: signalResult.mergedDirective || undefined,
-        };
-    }
-}
-//# sourceMappingURL=SignalCoordinator.js.map

package/dist/core/SignalCoordinator.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"SignalCoordinator.js","sourceRoot":"","sources":["../../src/core/SignalCoordinator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAOH,OAAO,EAAE,yBAAyB,EAAE,MAAM,uBAAuB,CAAC;AAClE,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AASjF,MAAM,OAAO,iBAAiB;IAC1B,YACqB,IAGhB;QAHgB,SAAI,GAAJ,IAAI,CAGpB;IACD,CAAC;IAEL,6EAA6E;IAC7E,IAAI,OAAO;QACP,OAAO,IAAI,CAAC,IAAI,CAAC,eAAe,KAAK,SAAS,CAAC;IACnD,CAAC;IAED;;;;;;;;OAQG;IACH,KAAK,CAAC,WAAW,CACb,OAA4B,EAC5B,OAAiB,EACjB,OAAgB;QAEhB,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,eAAe,EAAE,CAAC;YAC7B,OAAO,EAAE,OAAO,EAAE,EAAE,EAAE,cAAc,EAAE,OAAO,EAAE,eAAe,EAAE,SAAS,EAAE,CAAC;QAChF,CAAC;QACD,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,eAAe,CAAC,iBAAiB,CAAC,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC,CAAC;QAChG,OAAO;YACH,OAAO,EAAE,MAAM,CAAC,OAAO;YACvB,cAAc,EAAE,MAAM,CAAC,cAAc;YACrC,eAAe,EAAE,MAAM,CAAC,eAAe;SAC1C,CAAC;IACN,CAAC;IAED;;;;;;;;;;;;;;;OAeG;IACH,KAAK,CAAC,YAAY,CACd,OAA4B,EAC5B,OAAiB,EACjB,OAAgB;QAEhB,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,eAAe,EAAE,CAAC;YAC7B,OAAO,EAAE,OAAO,EAAE,EAAE,EAAE,cAAc,EAAE,OAAO,EAAE,eAAe,EAAE,SAAS,EAAE,CAAC;QAChF,CAAC;QACD,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,eAAe,CAAC,kBAAkB,CAAC,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC,CAAC;QACjG,OAAO;YACH,OAAO,EAAE,MAAM,CAAC,OAAO;YACvB,cAAc,EAAE,MAAM,CAAC,cAAc;YACrC,eAAe,EAAE,MAAM,CAAC,eAAe;SAC1C,CAAC;IACN,CAAC;IAED;;;;;;;;OAQG;IACH,KAAK,CAAC,cAAc,CAAC,MAKpB;QAOG,MAAM,UAAU,GAAG,MAAM,IAAI,CAAC,YAAY,CACtC,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,aAAa,CACvD,CAAC;QACF,IAAI,OAAO,GAAG,UAAU,CAAC,cAAc,CAAC;QAExC,+EAA+E;QAC/E,IAAI,UAAU,CAAC,eAAe,IAAI,yBAAyB,CAAC,UAAU,CAAC,eAAe,CAAC,EAAE,CAAC;YACtF,OAAO,GAAG,EAAE,GAAG,OAAO,EAAE,gBAAgB,EAAE,UAAU,CAAC,eAAe,EAAE,CAAC;QAC3E,CAAC;QAED,MAAM,eAAe,GAAG,UAAU,CAAC,eAAe,EAAE,KAAK,KAAK,SAAS,CAAC;QACxE,MAAM,OAAO,GAAG,eAAe;YAC3B,CAAC,CAAC,UAAU,CAAC,eAAgB,CAAC,KAAM;YACpC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC;QAErB,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,UAAU,CAAC,OAAO,EAAE,eAAe,EAAE,CAAC;IAC9E,CAAC;IAED;;;;;OAKG;IACH,sBAAsB,CAClB,YAIC;QAYD,MAAM,SAAS,GAAG,YAAY,CAAC,eAAgB,CAAC;QAChD,IAAI,OAAO,GAAG,YAAY,CAAC,cAAc,CAAC;QAC1C,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC;QACnC,IAAI,YAA+C,CAAC;QACpD,IAAI,YAA+C,CAAC;QACpD,IAAI,cAAc,GAAG,KAAK,CAAC;QAE3B,mDAAmD;QACnD,IAAI,SAAS,CAAC,UAAU,EAAE,CAAC;YACvB,OAAO,GAAG,cAAc,CAAC,OAAO,EAAE,SAAS,CAAC,UAAU,CAAC,CAAC;QAC5D,CAAC;QAED,IAAI,SAAS,CAAC,IAAI,EAAE,CAAC;YACjB,MAAM,UAAU,GAAG,OAAO,SAAS,CAAC,IAAI,KAAK,QAAQ;gBACjD,CAAC,CAAC,SAAS,CAAC,IAAI;gBAChB,CAAC,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,IAAI,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC;YAEjD,IAAI,UAAU,EAAE,CAAC;gBACb,MAAM,UAAU,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,UAAU,IAAI,CAAC,CAAC,KAAK,KAAK,UAAU,CAAC,CAAC;gBAClF,IAAI,UAAU,EAAE,CAAC;oBACb,OAAO,GAAG,SAAS,CAAC,OAAO,EAAE,UAAU,CAAC,EAAE,EAAE,UAAU,CAAC,KAAK,CAAC,CAAC;oBAC9D,YAAY,GAAG,UAAU,CAAC;oBAE1B,IAAI,OAAO,SAAS,CAAC,IAAI,KAAK,QAAQ,IAAI,SAAS,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;wBAC5D,MAAM,UAAU,GAAG,UAAU,CAAC,OAAO,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;wBAC3D,IAAI,UAAU,EAAE,CAAC;4BACb,OAAO,GAAG,SAAS,CAAC,OAAO,EAAE,UAAU,CAAC,EAAE,EAAE,UAAU,CAAC,WAAW,CAAC,CAAC;4BACpE,YAAY,GAAG,UAAU,CAAC;wBAC9B,CAAC;oBACL,CAAC;gBACL,CAAC;qBAAM,CAAC;oBACJ,MAAM,CAAC,IAAI,CAAC,+CAA+C,UAAU,6BAA6B,CAAC,CAAC;gBACxG,CAAC;YACL,CAAC;QACL,CAAC;aAAM,IAAI,SAAS,CAAC,QAAQ,EAAE,CAAC;YAC5B,MAAM,UAAU,GAAG,OAAO,SAAS,CAAC,QAAQ,KAAK,QAAQ;gBACrD,CAAC,CAAC,SAAS,CAAC,QAAQ;gBACpB,CAAC,CAAC,SAAS,CAAC,QAAQ,CAAC,IAAI,CAAC;YAC9B,MAAM,UAAU,GAAG,OAAO,SAAS,CAAC,QAAQ,KAAK,QAAQ;gBACrD,CAAC,CAAC,SAAS,CAAC,QAAQ,CAAC,IAAI;gBACzB,CAAC,CAAC,SAAS,CAAC;YAEhB,IAAI,UAAU,EAAE,CAAC;gBACb,MAAM,UAAU,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,UAAU,IAAI,CAAC,CAAC,KAAK,KAAK,UAAU,CAAC,CAAC;gBAClF,IAAI,UAAU,EAAE,CAAC;oBACb,OAAO,GAAG,SAAS,CAAC,OAAO,EAAE,UAAU,CAAC,EAAE,EAAE,UAAU,CAAC,KAAK,CAAC,CAAC;oBAC9D,YAAY,GAAG,UAAU,CAAC;oBAC1B,MAAM,UAAU,GAAG,UAAU,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;oBAClD,IAAI,UAAU,EAAE,CAAC;wBACb,OAAO,GAAG,SAAS,CAAC,OAAO,EAAE,UAAU,CAAC,EAAE,EAAE,UAAU,CAAC,WAAW,CAAC,CAAC;wBACpE,YAAY,GAAG,UAAU,CAAC;oBAC9B,CAAC;gBACL,CAAC;YACL,CAAC;iBAAM,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;gBAC7B,MAAM,WAAW,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,OAAO,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;gBACtE,IAAI,WAAW,EAAE,CAAC;oBACd,YAAY,GAAG,WAAW,CAAC;oBAC3B,MAAM,UAAU,GAAG,WAAW,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;oBACnD,IAAI,UAAU,EAAE,CAAC;wBACb,OAAO,GAAG,SAAS,CAAC,OAAO,EAAE,UAAU,CAAC,EAAE,EAAE,UAAU,CAAC,WAAW,CAAC,CAAC;wBACpE,YAAY,GAAG,UAAU,CAAC;oBAC9B,CAAC;gBACL,CAAC;YACL,CAAC;QACL,CAAC;aAAM,IAAI,SAAS,CAAC,QAAQ,EAAE,CAAC;YAC5B,cAAc,GAAG,IAAI,CAAC;QAC1B,CAAC;aAAM,IAAI,SAAS,CAAC,KAAK,EAAE,CAAC;YACzB,6CAA6C;YAC7C,cAAc,GAAG,IAAI,CAAC;QAC1B,CAAC;aAAM,IAAI,SAAS,CAAC,KAAK,EAAE,CAAC;YACzB,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;gBACtB,MAAM,WAAW,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,OAAO,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;gBACtE,IAAI,WAAW,EAAE,CAAC;oBACd,YAAY,GAAG,WAAW,CAAC;oBAC3B,MAAM,SAAS,GAAG,OAAO,SAAS,CAAC,KAAK,KAAK,QAAQ,IAAI,SAAS,CAAC,KAAK,CAAC,IAAI;wBACzE,CAAC,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI;wBACtB,CAAC,CAAC,SAAS,CAAC;oBAChB,IAAI,SAAS,EAAE,CAAC;wBACZ,MAAM,UAAU,GAAG,WAAW,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;wBAClD,IAAI,UAAU,EAAE,CAAC;4BACb,OAAO,GAAG,SAAS,CAAC,OAAO,EAAE,UAAU,CAAC,EAAE,EAAE,UAAU,CAAC,WAAW,CAAC,CAAC;4BACpE,YAAY,GAAG,UAAU,CAAC;wBAC9B,CAAC;oBACL,CAAC;yBAAM,CAAC;wBACJ,MAAM,WAAW,GAAG,WAAW,CAAC,WAAW,CAAC;wBAC5C,OAAO,GAAG,SAAS,CAAC,OAAO,EAAE,WAAW,CAAC,EAAE,EAAE,WAAW,CAAC,WAAW,CAAC,CAAC;wBACtE,YAAY,GAAG,WAAW,CAAC;oBAC/B,CAAC;gBACL,CAAC;YACL,CAAC;QACL,CAAC;QAED,OAAO;YACH,YAAY;YACZ,YAAY;YACZ,OAAO;YACP,cAAc;YACd,aAAa,EAAE,YAAY,CAAC,OAAO;YACnC,kBAAkB,EAAE,YAAY,CAAC,eAAe,IAAI,SAAS;SAChE,CAAC;IACN,CAAC;CACJ"}

package/dist/core/SignalEvaluator.d.ts

@@ -1,86 +0,0 @@
-/**
- * SignalEvaluator — Batched AI classifier + extraction for signals.
- *
- * Handles:
- * - `evaluateIf`: code-first predicate evaluation (AND semantics, short-circuit)
- * - `evaluateSignals`: single batched provider call for detection + extraction
- * - `buildSignalClassifierPrompt` / `buildMergedSchema`: prompt & schema construction
- *
- * @module SignalEvaluator
- */
-import type { AiProvider } from "../types/ai.js";
-import type { Event } from "../types/history.js";
-import type { SessionState } from "../types/session.js";
-import type { Signal, SignalPredicate, SignalPredicateContext } from "../types/signals.js";
-export interface SignalEvaluationResult {
-    matched: boolean;
-    reason?: string;
-    extracted?: unknown;
-}
-export interface EvaluateSignalsParams<TContext = unknown, TData = unknown> {
-    signals: Signal<TContext, TData, any>[];
-    session: SessionState<TData>;
-    history: Event[];
-    context: TContext;
-}
-/**
- * Builds the classifier prompt for a batch of signals.
- *
- * Splits `when` entries with the shared ConditionWhen parser:
- * - Positive entries → "TRIGGER WHEN (ANY matches)"
- * - `!` entries → prefix stripped, "DO NOT TRIGGER WHEN (ANY inhibits)"
- *
- * Extraction schemas render under "WHEN MATCHED, EXTRACT".
- * Unconditional + extract signals render under "ALWAYS EXTRACT".
- */
-export declare function buildSignalClassifierPrompt<TContext = unknown, TData = unknown>(signals: Signal<TContext, TData, any>[], history: Event[], _context: TContext): string;
-/**
- * Builds the merged JSON schema for the classifier response.
- *
- * Shape: `{ signals: [{ id, matched, reason?, extracted? }, ...] }`
- * where `extracted` is only present for signals with `extract` set.
- */
-export declare function buildMergedSchema<TContext = unknown, TData = unknown>(signals: Signal<TContext, TData, any>[]): Record<string, unknown>;
-export declare class SignalEvaluator<TContext = unknown, TData = unknown> {
-    private readonly provider;
-    constructor(provider: AiProvider);
-    /**
-     * Code-first predicate evaluation with AND semantics and short-circuit.
-     *
-     * Normalizes predicates to an array. Awaits each; returns false on first
-     * falsy result. Catches throws/rejections, logs at ERROR with predicate
-     * index, and returns false (signal treated as non-match).
-     */
-    evaluateIf(predicates: SignalPredicate<TContext, TData> | SignalPredicate<TContext, TData>[], ctx: SignalPredicateContext<TContext, TData>): Promise<boolean>;
-    /**
-     * Batched AI classifier + extraction call (Algorithm 3).
-     *
-     * Builds the classifier prompt and merged schema, makes a single provider
-     * call, and parses the response into an id → result map. Any signal absent
-     * from the response defaults to `{ matched: false }`. Provider errors are
-     * caught and logged; all signals default to non-match.
-     */
-    evaluateSignals(params: EvaluateSignalsParams<TContext, TData>): Promise<Record<string, SignalEvaluationResult>>;
-    /**
-     * Parallel batched evaluation. Splits signals into batches of `batchSize`,
-     * evaluates each batch via `evaluateSignals` in parallel using `Promise.all`,
-     * and merges all result maps into a single record.
-     *
-     * No key collisions because signal ids are unique within a phase.
-     */
-    evaluateSignalsBatched(params: {
-        signals: Signal<TContext, TData, any>[];
-        batchSize?: number;
-        session: SessionState<TData>;
-        history: Event[];
-        context: TContext;
-    }): Promise<Record<string, SignalEvaluationResult>>;
-}
-/**
- * Splits an array into fixed-size chunks.
- *
- * Returns an array of sub-arrays, each of at most `batchSize` elements.
- * The last chunk may be shorter. Returns an empty array when `items` is empty.
- */
-export declare function splitIntoBatches<T>(items: T[], batchSize: number): T[][];
-//# sourceMappingURL=SignalEvaluator.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"SignalEvaluator.d.ts","sourceRoot":"","sources":["../../src/core/SignalEvaluator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AACjD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,qBAAqB,CAAC;AACjD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,KAAK,EACR,MAAM,EACN,eAAe,EACf,sBAAsB,EACzB,MAAM,qBAAqB,CAAC;AAQ7B,MAAM,WAAW,sBAAsB;IACnC,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,OAAO,CAAC;CACvB;AAED,MAAM,WAAW,qBAAqB,CAAC,QAAQ,GAAG,OAAO,EAAE,KAAK,GAAG,OAAO;IAEtE,OAAO,EAAE,MAAM,CAAC,QAAQ,EAAE,KAAK,EAAE,GAAG,CAAC,EAAE,CAAC;IACxC,OAAO,EAAE,YAAY,CAAC,KAAK,CAAC,CAAC;IAC7B,OAAO,EAAE,KAAK,EAAE,CAAC;IACjB,OAAO,EAAE,QAAQ,CAAC;CACrB;AAMD;;;;;;;;;GASG;AACH,wBAAgB,2BAA2B,CAAC,QAAQ,GAAG,OAAO,EAAE,KAAK,GAAG,OAAO,EAE3E,OAAO,EAAE,MAAM,CAAC,QAAQ,EAAE,KAAK,EAAE,GAAG,CAAC,EAAE,EACvC,OAAO,EAAE,KAAK,EAAE,EAChB,QAAQ,EAAE,QAAQ,GACnB,MAAM,CAkFR;AAMD;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,GAAG,OAAO,EAAE,KAAK,GAAG,OAAO,EAEjE,OAAO,EAAE,MAAM,CAAC,QAAQ,EAAE,KAAK,EAAE,GAAG,CAAC,EAAE,GACxC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAoCzB;AAMD,qBAAa,eAAe,CAAC,QAAQ,GAAG,OAAO,EAAE,KAAK,GAAG,OAAO;IAChD,OAAO,CAAC,QAAQ,CAAC,QAAQ;gBAAR,QAAQ,EAAE,UAAU;IAEjD;;;;;;OAMG;IACG,UAAU,CACZ,UAAU,EAAE,eAAe,CAAC,QAAQ,EAAE,KAAK,CAAC,GAAG,eAAe,CAAC,QAAQ,EAAE,KAAK,CAAC,EAAE,EACjF,GAAG,EAAE,sBAAsB,CAAC,QAAQ,EAAE,KAAK,CAAC,GAC7C,OAAO,CAAC,OAAO,CAAC;IAMnB;;;;;;;OAOG;IACG,eAAe,CACjB,MAAM,EAAE,qBAAqB,CAAC,QAAQ,EAAE,KAAK,CAAC,GAC/C,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,sBAAsB,CAAC,CAAC;IAsDlD;;;;;;OAMG;IACG,sBAAsB,CAAC,MAAM,EAAE;QAEjC,OAAO,EAAE,MAAM,CAAC,QAAQ,EAAE,KAAK,EAAE,GAAG,CAAC,EAAE,CAAC;QACxC,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,OAAO,EAAE,YAAY,CAAC,KAAK,CAAC,CAAC;QAC7B,OAAO,EAAE,KAAK,EAAE,CAAC;QACjB,OAAO,EAAE,QAAQ,CAAC;KACrB,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,sBAAsB,CAAC,CAAC;CAoBtD;AAMD;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE,SAAS,EAAE,MAAM,GAAG,CAAC,EAAE,EAAE,CAQxE"}