@falai/agent 3.4.4 → 4.0.0-alpha.1

package/dist/core/DirectiveChainTracker.js

@@ -1,117 +0,0 @@
-/**
- * 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 { FlowConfigurationError } from "./Step.js";
-import { logger } from "../utils/index.js";
-/**
- * Tracks directive chain depth within a single turn.
- * Create one instance per turn; discard at turn end.
- */
-export 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 });
-            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 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}`);
-        }
-        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 = [];
-    }
-}
-/**
- * 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/core/DirectiveChainTracker.js.map

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

package/dist/core/Events.d.ts

@@ -1,26 +0,0 @@
-/**
- * Event utilities and helpers
- */
-import type { Event, EmittedEvent, MessageEventData, HistoryMessage, MessageData, HistoryItem, History } from "../types/index.js";
-/**
- * Convert a simple JSON history message to an internal Event
- */
-export declare function convertHistoryMessage<TData = unknown>(message: HistoryMessage<TData>): Event<MessageEventData>;
-/**
- * Convert an array of history messages to Events
- */
-export declare function convertHistoryToEvents<TData = unknown>(history: HistoryMessage<TData>[]): Event[];
-/**
- * Adapt an event for inclusion in prompts
- * Transforms event data into a serializable format
- */
-export declare function adaptEvent(e: Event | EmittedEvent): string;
-/**
- * Convert MessageData to HistoryItem
- */
-export declare function convertMessageDataToHistoryItem(message: MessageData): HistoryItem;
-/**
- * Convert an array of MessageData to History (HistoryItem[])
- */
-export declare function convertMessagesToHistory(messages: MessageData[]): History;
-//# sourceMappingURL=Events.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"Events.d.ts","sourceRoot":"","sources":["../../src/core/Events.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EACV,KAAK,EACL,YAAY,EACZ,gBAAgB,EAEhB,cAAc,EACd,WAAW,EACX,WAAW,EACX,OAAO,EACR,MAAM,mBAAmB,CAAC;AAG3B;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,GAAG,OAAO,EACnD,OAAO,EAAE,cAAc,CAAC,KAAK,CAAC,GAC7B,KAAK,CAAC,gBAAgB,CAAC,CAczB;AAkBD;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,GAAG,OAAO,EACpD,OAAO,EAAE,cAAc,CAAC,KAAK,CAAC,EAAE,GAC/B,KAAK,EAAE,CAET;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,CAAC,EAAE,KAAK,GAAG,YAAY,GAAG,MAAM,CA6C1D;AAED;;GAEG;AACH,wBAAgB,+BAA+B,CAC7C,OAAO,EAAE,WAAW,GACnB,WAAW,CAsCb;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,WAAW,EAAE,GAAG,OAAO,CAEzE"}

package/dist/core/Events.js

@@ -1,137 +0,0 @@
-/**
- * Event utilities and helpers
- */
-import { EventKind, MessageRole } from "../types/index.js";
-/**
- * Convert a simple JSON history message to an internal Event
- */
-export function convertHistoryMessage(message) {
-    return {
-        kind: EventKind.MESSAGE,
-        source: message.role,
-        data: {
-            participant: {
-                display_name: message.name || getDefaultName(message.role),
-            },
-            message: message.content,
-            session: message.session,
-        },
-        timestamp: message.timestamp || new Date().toISOString(),
-        id: message.metadata?.id,
-    };
-}
-/**
- * Get default participant name for a role
- */
-function getDefaultName(role) {
-    switch (role) {
-        case MessageRole.USER:
-            return "User";
-        case MessageRole.ASSISTANT:
-            return "Assistant";
-        case MessageRole.SYSTEM:
-            return "System";
-        default:
-            return "Unknown";
-    }
-}
-/**
- * Convert an array of history messages to Events
- */
-export function convertHistoryToEvents(history) {
-    return history.map(convertHistoryMessage);
-}
-/**
- * Adapt an event for inclusion in prompts
- * Transforms event data into a serializable format
- */
-export function adaptEvent(e) {
-    let data = e.data;
-    if (e.kind === EventKind.MESSAGE) {
-        const messageData = e.data;
-        if (messageData.flagged) {
-            data = {
-                participant: messageData.participant.display_name,
-                message: "<N/A>",
-                censored: true,
-                reasons: messageData.tags,
-            };
-        }
-        else {
-            data = {
-                participant: messageData.participant.display_name,
-                message: messageData.message,
-            };
-        }
-    }
-    if (e.kind === EventKind.TOOL) {
-        const toolData = e.data;
-        data = {
-            tool_calls: toolData.tool_calls.map((tc) => ({
-                tool_id: tc.tool_id,
-                arguments: tc.arguments,
-                result: tc.result.data,
-            })),
-        };
-    }
-    const sourceMap = {
-        [MessageRole.USER]: "user",
-        [MessageRole.ASSISTANT]: "assistant",
-        [MessageRole.AGENT]: "agent",
-        [MessageRole.SYSTEM]: "system",
-    };
-    return JSON.stringify({
-        event_kind: e.kind,
-        event_source: sourceMap[e.source],
-        data,
-    });
-}
-/**
- * Convert MessageData to HistoryItem
- */
-export function convertMessageDataToHistoryItem(message) {
-    switch (message.role) {
-        case MessageRole.USER:
-            return {
-                role: "user",
-                content: message.content,
-            };
-        case MessageRole.ASSISTANT:
-            return {
-                role: "assistant",
-                content: message.content,
-                tool_calls: message.toolCalls?.map((tc, index) => ({
-                    id: `call_${index}`, // Generate an ID since MessageData doesn't have tool call IDs
-                    name: tc.toolName,
-                    arguments: tc.arguments,
-                })),
-            };
-        case MessageRole.AGENT:
-            // Agent role typically represents tool execution results
-            // Since we don't have tool_call_id in MessageData, we'll use a placeholder
-            return {
-                role: "tool",
-                tool_call_id: "unknown", // MessageData doesn't store tool call IDs
-                name: "unknown_tool",
-                content: message.content,
-            };
-        case MessageRole.SYSTEM:
-            return {
-                role: "system",
-                content: message.content,
-            };
-        default:
-            // Fallback for unknown roles
-            return {
-                role: "system",
-                content: message.content,
-            };
-    }
-}
-/**
- * Convert an array of MessageData to History (HistoryItem[])
- */
-export function convertMessagesToHistory(messages) {
-    return messages.map(convertMessageDataToHistoryItem);
-}
-//# sourceMappingURL=Events.js.map

package/dist/core/Events.js.map

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

package/dist/core/Flow.d.ts

@@ -1,183 +0,0 @@
-/**
- * Flow (Journey) DSL implementation
- */
-import type { FlowOptions, FlowRef, StepOptions, FlowLifecycleHooks, StructuredSchema, Instruction, Tool, TemplateContext, ConditionEvaluationResult, Directive } from "../types/index.js";
-import type { ConditionWhen, ConditionIf } from "../types/flow.js";
-import { Step } from "./Step.js";
-import { Agent } from './Agent.js';
-/**
- * Represents a conversational flow/journey
- */
-export declare class Flow<TContext = unknown, TData = unknown> {
-    readonly id: string;
-    readonly title: string;
-    readonly description?: string;
-    readonly when?: ConditionWhen;
-    readonly if?: ConditionIf<TContext, TData>;
-    private readonly _initialStep;
-    readonly responseOutputSchema?: StructuredSchema;
-    readonly initialData?: Partial<TData>;
-    readonly requiredFields?: (keyof TData)[];
-    readonly optionalFields?: (keyof TData)[];
-    readonly onComplete?: string;
-    readonly reentrant: boolean;
-    readonly hooks?: FlowLifecycleHooks<TContext, TData>;
-    routingExtrasSchema?: StructuredSchema;
-    instructions: Instruction<TContext, TData>[];
-    tools: Tool<TContext, TData>[];
-    knowledgeBase: Record<string, unknown>;
-    /** Get the initial (first) step of this flow. */
-    get initialStep(): Step<TContext, TData>;
-    private parentAgent?;
-    /**
-     * Tracks whether this flow has participated in at least one turn.
-     * Used to emit a DEBUG warning when `addStep` mutates the graph mid-session.
-     * @internal Set by the pipeline after the first turn involving this flow.
-     */
-    _hasHandledTurn: boolean;
-    constructor(options: FlowOptions<TContext, TData>, parentAgent?: Agent<TContext, TData>);
-    /**
-     * Build a sequential step machine from an array of steps
-     * The last step in the array is the implicit terminus of the flow.
-     * @private
-     */
-    private buildSequentialSteps;
-    /**
-     * Imperatively add a step to this flow after construction.
-     *
-     * Applies the same construction-time validations as declarative `steps: [...]`
-     * registration (auto-step shape, `reply` exclusivity, `branches` validation,
-     * schema lookups). Connects the new step as a successor of the current last
-     * step in the flow.
-     *
-     * When called after the agent has handled a turn, emits a DEBUG-level warning
-     * that the flow graph is being mutated mid-session; the operation still succeeds.
-     *
-     * @param options - Step configuration
-     * @returns The newly created and registered Step
-     *
-     * **Validates: Requirements 8.7, 26.1–26.5**
-     */
-    addStep(options: StepOptions<TContext, TData>): Step<TContext, TData>;
-    /**
-     * Find the last step in the sequential chain (the terminal step with no transitions).
-     * If multiple terminal steps exist (branching), returns the one visited last in BFS order.
-     * @private
-     */
-    private getLastStep;
-    /**
-     * Evaluate when/if conditions using the v2 split logic.
-     * `if` (code predicate) evaluates first (free); `when` (AI) evaluates only when `if` passes.
-     * `if` predicates use AND semantics. Non-`!` `when` strings use OR semantics;
-     * `!` strings are exclusions where any match inhibits activation.
-     * When both fields are set, the passing `if` gate and AI match are combined with AND.
-     */
-    evaluateWhen(templateContext: TemplateContext<TContext, TData>): Promise<ConditionEvaluationResult>;
-    /**
-     * Create an instruction specific to this flow.
-     */
-    createInstruction(instruction: Instruction<TContext, TData>): this;
-    /**
-     * Register a tool for this flow
-     */
-    createTool(tool: Tool<TContext, TData>): this;
-    /**
-     * Register multiple tools for this flow
-     */
-    registerTools(tools: Tool<TContext, TData>[]): this;
-    /**
-     * Add a tool to this flow using the ToolManager API
-     * Creates and adds the tool to flow scope in one operation
-     */
-    addTool(tool: Tool<TContext, TData>): this;
-    /**
-     * Get all instructions for this flow
-     */
-    getInstructions(): Instruction<TContext, TData>[];
-    /**
-     * Get all tools for this flow
-     */
-    getTools(): Tool<TContext, TData>[];
-    /**
-     * Get optional extras schema requested during routing
-     */
-    getRoutingExtrasSchema(): StructuredSchema | undefined;
-    /**
-     * Get optional structured response schema for this flow's message
-     */
-    getResponseOutputSchema(): StructuredSchema | undefined;
-    getSteps(): Step<TContext, TData>[];
-    /**
-     * Get flow reference
-     */
-    getRef(): FlowRef;
-    /**
-     * Get all steps in this flow (via traversal from initial step)
-     */
-    getAllSteps(): Step<TContext, TData>[];
-    /**
-     * Get a specific step by ID
-     * @param stepId - The step ID to find
-     * @returns The step if found, undefined otherwise
-     */
-    getStep(stepId: string): Step<TContext, TData> | undefined;
-    /**
-     * Get a description of the flow structure for debugging
-     */
-    describe(): string;
-    /**
-     * Handle data updates for this flow, calling the onDataUpdate hook if configured
-     * @param data - New collected data
-     * @param previousCollected - Previously collected data
-     * @returns Modified data after hook processing, or original data if no hook
-     */
-    handleDataUpdate(data: Partial<TData>, previousCollected: Partial<TData>): Promise<Partial<TData>>;
-    /**
-     * Handle context updates for this flow, calling the onContextUpdate hook if configured
-     * @param newContext - New context
-     * @param previousContext - Previous context
-     */
-    handleContextUpdate(newContext: TContext, previousContext: TContext): Promise<void>;
-    /**
-     * Export flow configuration as FlowOptions for copying/cloning
-     * @returns FlowOptions that can be used to create a new flow with identical configuration
-     */
-    toOptions(): FlowOptions<TContext, TData>;
-    /**
-     * Check if this flow is complete based on the provided data
-     * @param data - Currently collected agent-level data
-     * @returns true if all required fields are present, false otherwise
-     *
-     * Note: Flows with no requiredFields (whether they have optionalFields or not)
-     * are never complete based on data — they complete when the last step finishes (implicit terminus).
-     */
-    isComplete(data: Partial<TData>): boolean;
-    /**
-     * Get the list of missing required fields for this flow
-     * @param data - Currently collected agent-level data
-     * @returns Array of missing required field keys
-     */
-    getMissingRequiredFields(data: Partial<TData>): (keyof TData)[];
-    /**
-     * Get the completion progress for this flow as a percentage
-     * @param data - Currently collected agent-level data
-     * @returns Completion progress as a number between 0 and 1
-     *
-     * Note: Must be consistent with isComplete() logic
-     */
-    getCompletionProgress(data: Partial<TData>): number;
-    /**
-     * Evaluate the onComplete handler and return a Directive.
-     *
-     * In v2, top-level `onComplete` is desugared to `hooks.onComplete` at
-     * construction time. This method delegates to `hooks.onComplete` when set.
-     *
-     * @param session - Current session step
-     * @param context - Agent context
-     * @returns Directive or undefined if no transition
-     */
-    evaluateOnComplete(session: {
-        data?: Partial<TData>;
-    }, context?: TContext): Promise<Directive<TContext, TData> | undefined>;
-}
-//# sourceMappingURL=Flow.d.ts.map

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

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