@falai/agent 3.4.5 → 4.0.0-alpha.10

package/dist/core/SignalEvaluator.js

@@ -1,312 +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 { eventsToHistory, logger } from "../utils/index.js";
-import { splitWhenConditions, evaluateIfPredicates } from "../utils/condition.js";
-// ──────────────────────────────────────────────────────────────────────────────
-// Prompt builder (exported for testing)
-// ──────────────────────────────────────────────────────────────────────────────
-/**
- * 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 function buildSignalClassifierPrompt(
-// eslint-disable-next-line @typescript-eslint/no-explicit-any
-signals, history, _context) {
-    const header = [
-        "You are evaluating signals for this conversation.",
-        "",
-        "For each signal, decide whether it matched based on the most recent user message AND the conversation context. Be conservative: only mark a signal matched when there is CLEAR, EXPLICIT evidence.",
-        "Positive TRIGGER WHEN entries are alternatives: ANY one positive entry can trigger the signal. DO NOT TRIGGER WHEN entries are exclusions: ANY one exclusion inhibits the signal.",
-    ].join("\n");
-    const signalBlocks = [];
-    for (const signal of signals) {
-        const id = signal.id ?? "unknown";
-        const title = signal.title ?? id;
-        const lines = [];
-        // Header
-        lines.push(`- SIGNAL "${id}" | "${title}"`);
-        // Description
-        if (signal.description) {
-            lines.push(`  DESCRIPTION: ${signal.description}`);
-        }
-        // Split when entries
-        const whenConditions = splitWhenConditions(signal.when);
-        const positiveEntries = whenConditions.positive;
-        const negativeEntries = whenConditions.negative;
-        const isUnconditional = positiveEntries.length === 0 && negativeEntries.length === 0;
-        if (isUnconditional && signal.extract) {
-            // Unconditional + extract → ALWAYS EXTRACT
-            lines.push(`  ALWAYS EXTRACT`);
-        }
-        else if (positiveEntries.length > 0) {
-            lines.push(`  TRIGGER WHEN (ANY matches):`);
-            for (const entry of positiveEntries) {
-                lines.push(`    • ${entry}`);
-            }
-        }
-        else if (negativeEntries.length > 0) {
-            lines.push(`  TRIGGER WHEN: no positive condition; trigger unless an exclusion matches.`);
-        }
-        if (negativeEntries.length > 0) {
-            lines.push(`  DO NOT TRIGGER WHEN (ANY inhibits):`);
-            for (const entry of negativeEntries) {
-                lines.push(`    • ${entry}`);
-            }
-        }
-        // Extraction schema
-        if (signal.extract) {
-            lines.push(`  WHEN MATCHED, EXTRACT:`);
-            const schemaLines = renderExtractionSchema(signal.extract);
-            for (const line of schemaLines) {
-                lines.push(`    • ${line}`);
-            }
-        }
-        signalBlocks.push(lines.join("\n"));
-    }
-    // Render conversation history
-    const historySection = renderHistoryForClassifier(history);
-    const outputInstructions = [
-        "# OUTPUT",
-        "For each signal, return:",
-        "  { id, matched, reason (required when matched=true) }",
-        "  + extracted fields (when signal defines extraction and matched=true)",
-    ].join("\n");
-    return [
-        header,
-        "",
-        "# SIGNALS",
-        "",
-        signalBlocks.join("\n\n"),
-        "",
-        historySection,
-        "",
-        outputInstructions,
-    ].join("\n");
-}
-// ──────────────────────────────────────────────────────────────────────────────
-// Schema builder (exported for testing)
-// ──────────────────────────────────────────────────────────────────────────────
-/**
- * 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 function buildMergedSchema(
-// eslint-disable-next-line @typescript-eslint/no-explicit-any
-signals) {
-    const signalEntrySchemas = signals.map(signal => {
-        const entry = {
-            type: "object",
-            properties: {
-                id: { type: "string", description: "Signal identifier" },
-                matched: { type: "boolean", description: "Whether the signal matched" },
-                reason: { type: "string", description: "Reason for the match (required when matched=true)" },
-            },
-            required: ["id", "matched"],
-            additionalProperties: false,
-        };
-        // Add extracted field only when signal has extract schema
-        if (signal.extract) {
-            entry.properties.extracted = signal.extract;
-            entry.additionalProperties = false;
-        }
-        return entry;
-    });
-    return {
-        type: "object",
-        properties: {
-            signals: {
-                type: "array",
-                items: {
-                    anyOf: signalEntrySchemas,
-                },
-                description: "Evaluation results for each signal",
-            },
-        },
-        required: ["signals"],
-        additionalProperties: false,
-    };
-}
-// ──────────────────────────────────────────────────────────────────────────────
-// SignalEvaluator class
-// ──────────────────────────────────────────────────────────────────────────────
-export class SignalEvaluator {
-    constructor(provider) {
-        this.provider = provider;
-    }
-    /**
-     * 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).
-     */
-    async evaluateIf(predicates, ctx) {
-        return evaluateIfPredicates(predicates, ctx, "Signals");
-    }
-    /**
-     * 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.
-     */
-    async evaluateSignals(params) {
-        const { signals, history, context } = params;
-        // Build prompt and schema
-        const prompt = buildSignalClassifierPrompt(signals, history, context);
-        const jsonSchema = buildMergedSchema(signals);
-        try {
-            const response = await this.provider.generateMessage({
-                prompt,
-                history: eventsToHistory(history),
-                context,
-                parameters: {
-                    jsonSchema,
-                    schemaName: "signal_evaluation",
-                },
-            });
-            // Parse response into id → result map
-            const results = {};
-            const entries = response.structured?.signals ?? [];
-            for (const entry of entries) {
-                results[entry.id] = {
-                    matched: entry.matched,
-                    reason: entry.matched ? entry.reason : undefined,
-                    extracted: entry.matched ? entry.extracted : undefined,
-                };
-            }
-            // Defensive defaults: any signal absent from the response → matched: false
-            for (const signal of signals) {
-                const id = signal.id ?? "unknown";
-                if (!results[id]) {
-                    results[id] = { matched: false };
-                }
-            }
-            return results;
-        }
-        catch (error) {
-            logger.error(`[Signals] Classifier call failed: ${error instanceof Error ? error.message : String(error)}`);
-            // On provider error, all signals default to non-match
-            const results = {};
-            for (const signal of signals) {
-                const id = signal.id ?? "unknown";
-                results[id] = { matched: false };
-            }
-            return results;
-        }
-    }
-    /**
-     * 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.
-     */
-    async evaluateSignalsBatched(params) {
-        const { signals, batchSize = 10, session, history, context } = params;
-        if (signals.length === 0)
-            return {};
-        const batches = splitIntoBatches(signals, batchSize);
-        const batchResults = await Promise.all(batches.map(batch => this.evaluateSignals({ signals: batch, session, history, context })));
-        // Merge all batch result maps into a single record
-        const merged = {};
-        for (const result of batchResults) {
-            Object.assign(merged, result);
-        }
-        return merged;
-    }
-}
-// ──────────────────────────────────────────────────────────────────────────────
-// Batch helper (exported for testing)
-// ──────────────────────────────────────────────────────────────────────────────
-/**
- * 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 function splitIntoBatches(items, batchSize) {
-    if (items.length === 0)
-        return [];
-    const batches = [];
-    for (let i = 0; i < items.length; i += batchSize) {
-        batches.push(items.slice(i, i + batchSize));
-    }
-    return batches;
-}
-// ──────────────────────────────────────────────────────────────────────────────
-// Internal helpers
-// ──────────────────────────────────────────────────────────────────────────────
-/**
- * Render extraction schema properties as human-readable lines for the prompt.
- * Lists each property's name, type, and constraints (enum, min/max, format).
- */
-function renderExtractionSchema(schema) {
-    const lines = [];
-    const properties = schema.properties;
-    if (!properties)
-        return lines;
-    for (const [name, fieldSchema] of Object.entries(properties)) {
-        if (!fieldSchema || typeof fieldSchema !== "object")
-            continue;
-        const type = fieldSchema.type ?? "unknown";
-        let line = `${name} (${type})`;
-        // Add constraints
-        const constraints = [];
-        if (fieldSchema.enum && Array.isArray(fieldSchema.enum)) {
-            constraints.push(fieldSchema.enum.join("|"));
-        }
-        if (fieldSchema.minimum !== undefined || fieldSchema.maximum !== undefined) {
-            const min = fieldSchema.minimum !== undefined ? `${fieldSchema.minimum}` : "";
-            const max = fieldSchema.maximum !== undefined ? `${fieldSchema.maximum}` : "";
-            constraints.push(`${min}-${max}`);
-        }
-        if (fieldSchema.format) {
-            constraints.push(fieldSchema.format);
-        }
-        if (constraints.length > 0) {
-            line += `, ${constraints.join(", ")}`;
-        }
-        // Add description
-        if (fieldSchema.description) {
-            line += `: ${fieldSchema.description}`;
-        }
-        lines.push(line);
-    }
-    return lines;
-}
-/**
- * Render conversation history into a simple text block for the classifier prompt.
- */
-function renderHistoryForClassifier(history) {
-    if (history.length === 0)
-        return "# CONVERSATION HISTORY\n(empty)";
-    const lines = ["# CONVERSATION HISTORY"];
-    for (const event of history) {
-        const source = event.source ?? "unknown";
-        const data = event.data;
-        const message = data?.message ?? "";
-        if (message) {
-            lines.push(`${source}: ${message}`);
-        }
-    }
-    return lines.join("\n");
-}
-//# sourceMappingURL=SignalEvaluator.js.map

package/dist/core/SignalEvaluator.js.map

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

package/dist/core/SignalProcessor.d.ts

@@ -1,152 +0,0 @@
-/**
- * SignalProcessor — Orchestration for signal phase execution.
- *
- * Owns:
- * - `behaviorAllowsExecution`: Behavior gating (Algorithm 2)
- * - `recordTrigger`: Immutable session update for trigger state
- * - `buildSignalContext`: Constructs the handler context (D-Q12 writers)
- * - `runPhase` / `runPreSignalPhase` / `runPostSignalPhase`: Phase orchestration (Algorithm 1)
- *
- * @module SignalProcessor
- */
-import type { AiProvider } from "../types/ai.js";
-import type { Event } from "../types/history.js";
-import type { SessionState } from "../types/session.js";
-import type { Directive } from "../types/flow.js";
-import type { Signal, SignalContext, SignalDirective, SignalFiring, SignalTriggerState } from "../types/signals.js";
-import type { SignalEvaluator } from "./SignalEvaluator.js";
-/**
- * Determines whether a signal's behavior gating allows execution this turn.
- *
- * Algorithm 2 from the design document:
- * - `'always'` (or unset) → always allowed
- * - `'once'` → allowed only if no prior trigger exists
- * - `'cooldown'` → allowed when elapsed time since last trigger >= cooldownMs;
- *   when `cooldownMs` is missing, treated as `'always'` (misconfigured)
- * - Missing trigger (first-time) → allowed regardless of behavior
- *
- * Pure function; no I/O.
- *
- * @param signal - The signal definition (with id, behavior, cooldownMs)
- * @param trigger - The existing trigger state from `session.signals.triggers[signal.id]`, or undefined
- * @returns true if the signal is allowed to execute
- *
- * @requirements 5.1, 5.2, 5.3, 5.4
- */
-export declare function behaviorAllowsExecution<TContext = unknown, TData = unknown>(signal: Signal<TContext, TData, any>, trigger: SignalTriggerState | undefined): boolean;
-/**
- * Records a signal trigger on the session, returning a new session object
- * (immutable update — never mutates input).
- *
- * - On first trigger: sets `firstTriggeredAt` and `lastTriggeredAt` to now,
- *   `count = 1`, plus `lastReason` and `lastPhase`.
- * - On subsequent triggers: leaves `firstTriggeredAt` unchanged, increments
- *   `count`, updates `lastTriggeredAt`, `lastReason`, `lastPhase`.
- *
- * @param session - Current session state (not mutated)
- * @param signal - The signal that fired
- * @param reason - The match reason (AI rationale, 'code-only', or 'unconditional')
- * @param phase - The phase in which the signal fired
- * @returns A new session with updated `signals.triggers[signal.id]`
- *
- * @requirements 10.1, 10.2
- */
-export declare function recordTrigger<TData = unknown>(session: SessionState<TData>, signal: Signal<any, TData, any>, reason: string, phase: 'pre' | 'post'): SessionState<TData>;
-/**
- * Parameters for building the SignalContext.
- */
-export interface BuildSignalContextParams<TContext = unknown, TData = unknown, TExtract = void> {
-    signal: Signal<TContext, TData, TExtract>;
-    reason: string;
-    extracted: TExtract extends void ? undefined : TExtract;
-    phase: 'pre' | 'post';
-    session: SessionState<TData>;
-    context: TContext;
-    history: Event[];
-    /** Turn-local directive bus — `dispatch` pushes onto this array. */
-    directiveBus: SignalDirective<TContext, TData>[];
-    /** Session updater — called when handler invokes `updateContext`. */
-    onUpdateSession: (updatedSession: SessionState<TData>) => void;
-}
-/**
- * Builds the `SignalContext` passed to signal handlers.
- *
- * - `updateContext` and `updateData` replicate the ToolContext D-Q12 writer
- *   pattern: shallow-merge partial updates into the session, call the
- *   `onUpdateSession` callback so the processor can track mutations.
- * - `dispatch` pushes a `SignalDirective` onto the turn-local bus.
- * - `lastUserMessage` is derived from the last user-role event in history.
- * - `triggeredAt` is set to `new Date()` at construction time.
- * - `matched` is always `true` (literal type).
- *
- * @requirements 6.1, 6.2, 6.3
- */
-export declare function buildSignalContext<TContext = unknown, TData = unknown, TExtract = void>(params: BuildSignalContextParams<TContext, TData, TExtract>): SignalContext<TContext, TData, TExtract>;
-/**
- * SignalProcessor — Orchestrates signal phase execution.
- *
- * Constructed only when `options.signals` is non-empty (Requirement 2.3).
- * Owns the full Algorithm 1 lifecycle: filtering, gating, evaluation,
- * handler invocation, directive collection, and state persistence.
- */
-export declare class SignalProcessor<TContext = unknown, TData = unknown> {
-    private readonly signals;
-    private readonly provider;
-    private readonly evaluator;
-    private readonly options;
-    constructor(signals: Signal<TContext, TData, any>[], provider: AiProvider, evaluator: SignalEvaluator<TContext, TData>, options: {
-        batchSize: number;
-    });
-    /** @internal Expose internals for testability. */
-    get _internals(): {
-        signals: Signal<TContext, TData, any>[];
-        provider: AiProvider;
-        evaluator: SignalEvaluator<TContext, TData>;
-        options: {
-            batchSize: number;
-        };
-    };
-    /**
-     * Pre-signal phase. Delegates to `runPhase('pre', ...)`.
-     * Return type narrows `mergedDirective` to `Directive | undefined`.
-     */
-    runPreSignalPhase(params: {
-        session: SessionState<TData>;
-        history: Event[];
-        context: TContext;
-    }): Promise<{
-        mergedDirective?: Directive<TContext, TData>;
-        firings: SignalFiring<TContext, TData>[];
-        updatedSession: SessionState<TData>;
-    }>;
-    /**
-     * Post-signal phase. Delegates to `runPhase('post', ...)`.
-     * Return type narrows `mergedDirective` to `Directive | undefined`.
-     * Pre-LLM-only fields (`appendPrompt`, `injectTools`, `halt`) are
-     * already dropped inside `runPhase` for the post phase.
-     */
-    runPostSignalPhase(params: {
-        session: SessionState<TData>;
-        history: Event[];
-        context: TContext;
-    }): Promise<{
-        mergedDirective?: Directive<TContext, TData>;
-        firings: SignalFiring<TContext, TData>[];
-        updatedSession: SessionState<TData>;
-    }>;
-    private runPhase;
-    /**
-     * Merges an array of signal directives into a single directive.
-     *
-     * Merge strategy (matches Algorithm 4 / AutoChainExecutor pattern):
-     * - Position fields (`goTo`, `goToStep`, `complete`, `abort`, `reset`, `halt`): last-write-wins
-     * - `reply`: last-write-wins
-     * - `appendPrompt`: array-concat
-     * - `injectTools`: array-concat
-     * - `dataUpdate`: shallow-merge (later values overwrite earlier for same key)
-     * - `contextUpdate`: shallow-merge
-     * - `stopOtherSignals`: OR (any true → true)
-     */
-    private mergeDirectives;
-}
-//# sourceMappingURL=SignalProcessor.d.ts.map

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

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