@falai/agent 0.9.0 → 1.0.0

package/dist/core/Route.js

@@ -0,0 +1,537 @@
+/**
+ * Route (Journey) DSL implementation
+ */
+import { createConditionEvaluator, generateRouteId, logger } from "../utils";
+import { Step } from "./Step";
+import { END_ROUTE } from "../constants";
+/**
+ * Represents a conversational route/journey
+ */
+export class Route {
+    constructor(options, parentAgent) {
+        this.guidelines = [];
+        this.terms = [];
+        this.tools = [];
+        this.knowledgeBase = {};
+        // Use provided ID or generate a deterministic one from the title
+        this.id = options.id || generateRouteId(options.title);
+        this.title = options.title;
+        this.description = options.description;
+        this.identity = options.identity;
+        this.personality = options.personality;
+        this.when = options.when;
+        this.skipIf = options.skipIf;
+        this.rules = options.rules || [];
+        this.prohibitions = options.prohibitions || [];
+        // Store reference to parent agent for ToolManager access
+        this.parentAgent = parentAgent;
+        // Handle initial step logic
+        let initialStepOptions = options.initialStep;
+        let stepsToChain = [];
+        if (options.steps && options.steps.length > 0) {
+            // If steps are provided but no initialStep, use first step as initial
+            if (!options.initialStep) {
+                initialStepOptions = options.steps[0];
+                stepsToChain = options.steps.slice(1);
+            }
+            else {
+                // Both initialStep and steps provided - chain steps after initial
+                stepsToChain = options.steps;
+            }
+        }
+        this.initialStep = new Step(this.id, initialStepOptions, this.parentAgent);
+        // Store endStep spec (will be used when route completes)
+        this.endStepSpec = options.endStep || {
+            prompt: "Summarize what was accomplished and confirm completion based on the conversation history and collected data",
+        };
+        this.routingExtrasSchema = options.routingExtrasSchema;
+        this.responseOutputSchema = options.responseOutputSchema;
+        this.initialData = options.initialData;
+        this.requiredFields = options.requiredFields;
+        this.optionalFields = options.optionalFields;
+        this.onComplete = options.onComplete;
+        this.hooks = options.hooks;
+        // Initialize knowledge base
+        if (options.knowledgeBase) {
+            this.knowledgeBase = { ...options.knowledgeBase };
+        }
+        // Initialize guidelines from options
+        if (options.guidelines) {
+            options.guidelines.forEach((guideline) => {
+                this.createGuideline(guideline);
+            });
+        }
+        // Initialize terms from options
+        if (options.terms) {
+            options.terms.forEach((term) => {
+                this.createTerm(term);
+            });
+        }
+        // Initialize tools from options
+        if (options.tools) {
+            options.tools.forEach((toolRef) => {
+                if (typeof toolRef === 'string') {
+                    // Tool ID - try to resolve from ToolManager
+                    if (this.parentAgent?.tool) {
+                        const registeredTool = this.parentAgent.tool.find(toolRef);
+                        if (registeredTool) {
+                            this.createTool(registeredTool);
+                        }
+                        else {
+                            // Tool not found - log warning but don't fail
+                            logger.warn(`[Route] Tool ID '${toolRef}' not found in any scope for route ${this.title}`);
+                        }
+                    }
+                    else {
+                        logger.warn(`[Route] No agent available to resolve tool ID '${toolRef}' for route ${this.title}`);
+                    }
+                }
+                else {
+                    // Inline tool object - validate and use directly
+                    if (toolRef && toolRef.id && typeof toolRef.handler === 'function') {
+                        this.createTool(toolRef);
+                    }
+                    else {
+                        logger.warn(`[Route] Invalid inline tool object in route ${this.title}:`, toolRef);
+                    }
+                }
+            });
+        }
+        // Build sequential steps if provided
+        if (stepsToChain.length > 0) {
+            this.buildSequentialSteps(stepsToChain);
+        }
+    }
+    /**
+     * Build a sequential step machine from an array of steps
+     * @private
+     */
+    buildSequentialSteps(steps) {
+        let currentStepResult = this.initialStep.asStepResult();
+        for (const step of steps) {
+            if (step === END_ROUTE) {
+                currentStepResult.nextStep({ step: END_ROUTE });
+            }
+            else {
+                currentStepResult = currentStepResult.nextStep(step);
+            }
+        }
+    }
+    /**
+     * Evaluate the when condition for this route
+     * @param templateContext - Context for condition evaluation
+     * @returns Evaluation result with programmatic result and AI context strings
+     */
+    async evaluateWhen(templateContext) {
+        if (!this.when) {
+            return {
+                programmaticResult: true, // No condition means always eligible
+                aiContextStrings: [],
+                hasProgrammaticConditions: false,
+            };
+        }
+        const evaluator = createConditionEvaluator(templateContext);
+        return await evaluator.evaluateCondition(this.when, 'AND');
+    }
+    /**
+     * Evaluate the skipIf condition for this route
+     * @param templateContext - Context for condition evaluation
+     * @returns Evaluation result with programmatic result and AI context strings
+     */
+    async evaluateSkipIf(templateContext) {
+        if (!this.skipIf) {
+            return {
+                programmaticResult: false, // No skipIf means never skip
+                aiContextStrings: [],
+                hasProgrammaticConditions: false,
+            };
+        }
+        const evaluator = createConditionEvaluator(templateContext);
+        return await evaluator.evaluateCondition(this.skipIf, 'OR');
+    }
+    /**
+     * Create a guideline specific to this route
+     */
+    createGuideline(guideline) {
+        this.guidelines.push({
+            ...guideline,
+            id: guideline.id || `guideline_${this.id}_${this.guidelines.length}`,
+            enabled: guideline.enabled !== false, // Default to true
+        });
+        return this;
+    }
+    /**
+     * Create a term for the route's domain glossary
+     */
+    createTerm(term) {
+        this.terms.push(term);
+        return this;
+    }
+    /**
+     * Register a tool for this route
+     */
+    createTool(tool) {
+        // Validate tool before adding
+        if (!tool || !tool.id || !tool.handler) {
+            throw new Error(`Invalid tool: must have id and handler properties`);
+        }
+        this.tools.push(tool);
+        return this;
+    }
+    /**
+     * Register multiple tools for this route
+     */
+    registerTools(tools) {
+        tools.forEach((tool) => this.createTool(tool));
+        return this;
+    }
+    /**
+     * Add a tool to this route using the ToolManager API
+     * Creates and adds the tool to route scope in one operation
+     */
+    addTool(tool) {
+        if (this.parentAgent && this.parentAgent.tool) {
+            // Use ToolManager to add to route scope - no casting needed with unified interface
+            this.parentAgent.tool.addToRoute(this, tool);
+        }
+        else {
+            // Fallback: add tool directly to route tools
+            this.createTool(tool);
+        }
+        return this;
+    }
+    /**
+     * Get all guidelines for this route
+     */
+    getGuidelines() {
+        return [...this.guidelines];
+    }
+    /**
+     * Evaluate and match active guidelines based on their conditions
+     * Returns guidelines that should be active given the current context
+     */
+    async evaluateGuidelines(context, session, history) {
+        const templateContext = { context, session, history, data: session?.data };
+        const evaluator = createConditionEvaluator(templateContext);
+        const matches = [];
+        for (const guideline of this.guidelines) {
+            // Skip disabled guidelines
+            if (guideline.enabled === false) {
+                continue;
+            }
+            if (guideline.condition) {
+                const evaluation = await evaluator.evaluateCondition(guideline.condition, 'AND');
+                // Include guideline if:
+                // 1. No programmatic conditions (only strings) - always active
+                // 2. Programmatic conditions evaluate to true
+                if (!evaluation.hasProgrammaticConditions || evaluation.programmaticResult) {
+                    const rationale = evaluation.aiContextStrings.length > 0
+                        ? `Condition met: ${evaluation.aiContextStrings.join(" AND ")}`
+                        : evaluation.hasProgrammaticConditions
+                            ? "Programmatic condition evaluated to true"
+                            : "Always active (no conditions)";
+                    matches.push({
+                        guideline,
+                        rationale
+                    });
+                }
+            }
+            else {
+                // No condition means always active
+                matches.push({
+                    guideline,
+                    rationale: "Always active (no conditions)"
+                });
+            }
+        }
+        return matches;
+    }
+    /**
+     * Get all terms for this route
+     */
+    getTerms() {
+        return [...this.terms];
+    }
+    /**
+     * Get all tools for this route
+     */
+    getTools() {
+        return [...this.tools];
+    }
+    /**
+     * Get the route's knowledge base
+     */
+    getKnowledgeBase() {
+        return { ...this.knowledgeBase };
+    }
+    /**
+     * Get rules for this route
+     */
+    getRules() {
+        return [...this.rules];
+    }
+    /**
+     * Get prohibitions for this route
+     */
+    getProhibitions() {
+        return [...this.prohibitions];
+    }
+    /**
+     * Get optional extras schema requested during routing
+     */
+    getRoutingExtrasSchema() {
+        return this.routingExtrasSchema;
+    }
+    /**
+     * Get optional structured response schema for this route's message
+     */
+    getResponseOutputSchema() {
+        return this.responseOutputSchema;
+    }
+    getSteps() {
+        return this.getAllSteps();
+    }
+    /**
+     * Get route reference
+     */
+    getRef() {
+        return {
+            id: this.id,
+        };
+    }
+    /**
+     * Get all steps in this route (via traversal from initial step)
+     */
+    getAllSteps() {
+        const visited = new Set();
+        const steps = [];
+        const queue = [this.initialStep];
+        while (queue.length > 0) {
+            const current = queue.shift();
+            if (visited.has(current.id)) {
+                continue;
+            }
+            visited.add(current.id);
+            steps.push(current);
+            // Add target steps from transitions
+            for (const nextStep of current.getTransitions()) {
+                if (nextStep && !visited.has(nextStep.id)) {
+                    queue.push(nextStep);
+                }
+            }
+        }
+        return steps;
+    }
+    /**
+     * Get a specific step by ID
+     * @param stepId - The step ID to find
+     * @returns The step if found, undefined otherwise
+     */
+    getStep(stepId) {
+        const steps = this.getAllSteps();
+        return steps.find((step) => step.id === stepId);
+    }
+    /**
+     * Get a description of the route structure for debugging
+     */
+    describe() {
+        const lines = [
+            `Route: ${this.title}`,
+            `ID: ${this.id}`,
+            `Description: ${this.description || "N/A"}`,
+            `When: ${this.when ? (typeof this.when === 'string' ? this.when : Array.isArray(this.when) ? '[Array]' : '[Function]') : "None"}`,
+            `SkipIf: ${this.skipIf ? (typeof this.skipIf === 'string' ? this.skipIf : Array.isArray(this.skipIf) ? '[Array]' : '[Function]') : "None"}`,
+            "",
+            "Steps:",
+        ];
+        const steps = this.getAllSteps();
+        for (const step of steps) {
+            lines.push(`  - ${step.id}${step.description ? `: ${step.description}` : ""}`);
+            const transitions = step.getTransitions();
+            for (const transition of transitions) {
+                lines.push(`    -> ${transition.id}${transition.description ? `: ${transition.description}` : ""}`);
+            }
+        }
+        return lines.join("\n");
+    }
+    /**
+     * Handle data updates for this route, 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
+     */
+    async handleDataUpdate(data, previousCollected) {
+        // Call route-specific onDataUpdate hook if configured
+        if (this.hooks?.onDataUpdate) {
+            return await this.hooks.onDataUpdate(data, previousCollected);
+        }
+        // Return original data if no hook
+        return data;
+    }
+    /**
+     * Handle context updates for this route, calling the onContextUpdate hook if configured
+     * @param newContext - New context
+     * @param previousContext - Previous context
+     */
+    async handleContextUpdate(newContext, previousContext) {
+        // Call route-specific onContextUpdate hook if configured
+        if (this.hooks?.onContextUpdate) {
+            await this.hooks.onContextUpdate(newContext, previousContext);
+        }
+    }
+    /**
+     * Export route configuration as RouteOptions for copying/cloning
+     * @returns RouteOptions that can be used to create a new route with identical configuration
+     */
+    toOptions() {
+        // Convert steps to StepOptions
+        const steps = this.getAllSteps()
+            .filter(step => step.id !== this.initialStep.id) // Exclude initial step
+            .map(step => ({
+            id: step.id,
+            description: step.description,
+            prompt: step.prompt,
+            tools: step.tools,
+            prepare: step.prepare,
+            finalize: step.finalize,
+            collect: step.collect,
+            skipIf: step.skipIf,
+            requires: step.requires,
+            when: step.when,
+            guidelines: step.getGuidelines(),
+        }));
+        return {
+            id: this.id,
+            title: this.title,
+            description: this.description,
+            identity: this.identity,
+            personality: this.personality,
+            when: this.when,
+            skipIf: this.skipIf,
+            guidelines: this.getGuidelines(),
+            terms: this.getTerms(),
+            tools: this.getTools(),
+            rules: this.rules,
+            prohibitions: this.prohibitions,
+            routingExtrasSchema: this.routingExtrasSchema,
+            responseOutputSchema: this.responseOutputSchema,
+            requiredFields: this.requiredFields,
+            optionalFields: this.optionalFields,
+            initialData: this.initialData,
+            steps: steps.length > 0 ? steps : undefined,
+            initialStep: {
+                id: this.initialStep.id,
+                description: this.initialStep.description,
+                prompt: this.initialStep.prompt,
+                tools: this.initialStep.tools,
+                prepare: this.initialStep.prepare,
+                finalize: this.initialStep.finalize,
+                collect: this.initialStep.collect,
+                skipIf: this.initialStep.skipIf,
+                requires: this.initialStep.requires,
+                when: this.initialStep.when,
+                guidelines: this.initialStep.getGuidelines(),
+            },
+            endStep: this.endStepSpec,
+            onComplete: this.onComplete,
+            hooks: this.hooks,
+            knowledgeBase: this.knowledgeBase,
+        };
+    }
+    /**
+     * Check if this route 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: Routes with no requiredFields AND no optionalFields are never complete
+     * based on data (they complete via END_ROUTE). Routes with only optionalFields
+     * are always complete (optional data doesn't block completion).
+     */
+    isComplete(data) {
+        // If route has required fields, check if they're all collected
+        if (this.requiredFields && this.requiredFields.length > 0) {
+            return this.requiredFields.every(field => {
+                const value = data[field];
+                return value !== undefined && value !== null && value !== '';
+            });
+        }
+        // If route has optional fields but no required fields, it's always complete
+        if (this.optionalFields && this.optionalFields.length > 0) {
+            return true;
+        }
+        // No required or optional fields - route doesn't complete based on data
+        // It can only complete by reaching END_ROUTE in step flow
+        return false;
+    }
+    /**
+     * Get the list of missing required fields for this route
+     * @param data - Currently collected agent-level data
+     * @returns Array of missing required field keys
+     */
+    getMissingRequiredFields(data) {
+        if (!this.requiredFields || this.requiredFields.length === 0) {
+            return [];
+        }
+        return this.requiredFields.filter(field => {
+            const value = data[field];
+            return value === undefined || value === null || value === '';
+        });
+    }
+    /**
+     * Get the completion progress for this route 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) {
+        // If route has required fields, calculate progress
+        if (this.requiredFields && this.requiredFields.length > 0) {
+            const completedFields = this.requiredFields.filter(field => {
+                const value = data[field];
+                return value !== undefined && value !== null && value !== '';
+            });
+            return completedFields.length / this.requiredFields.length;
+        }
+        // If route has optional fields but no required fields, it's always complete
+        if (this.optionalFields && this.optionalFields.length > 0) {
+            return 1;
+        }
+        // No required or optional fields - route doesn't complete based on data
+        // Progress is 0 (must reach END_ROUTE in step flow)
+        return 0;
+    }
+    /**
+     * Evaluate the onComplete handler and return transition config
+     * @param session - Current session step
+     * @param context - Agent context
+     * @returns Transition config or undefined if no transition
+     */
+    async evaluateOnComplete(session, context) {
+        if (!this.onComplete) {
+            return undefined;
+        }
+        // String form: just route ID/title
+        if (typeof this.onComplete === "string") {
+            return {
+                nextStep: this.onComplete,
+            };
+        }
+        // Function form: execute and normalize result
+        if (typeof this.onComplete === "function") {
+            const result = await this.onComplete(session, context);
+            if (!result) {
+                return undefined;
+            }
+            if (typeof result === "string") {
+                return {
+                    nextStep: result,
+                };
+            }
+            return result;
+        }
+        // Object form: return as-is
+        return this.onComplete;
+    }
+}
+//# sourceMappingURL=Route.js.map

package/dist/core/Route.js.map

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

package/dist/{src/core → core}/RoutingEngine.d.ts

@@ -1,4 +1,4 @@
-import type { Event, AgentOptions, StructuredSchema, RoutingDecision, SessionState, AiProvider } from "../types";
+import type { Event, AgentOptions, StructuredSchema, RoutingDecision, SessionState, AiProvider, TemplateContext } from "../types";
 import type { Route } from "./Route";
 import type { Step } from "./Step";
 export interface CandidateStep<TContext = unknown, TData = unknown> {
@@ -34,6 +34,7 @@ export interface BuildStepSelectionPromptParams<TContext = unknown, TData = unkn
     agentOptions?: AgentOptions<TContext, TData>;
     context?: TContext;
     session?: SessionState<TData>;
+    stepConditionContext?: string[];
 }
 export interface BuildRoutingPromptParams<TContext = unknown, TData = unknown> {
     history: Event[];
@@ -43,10 +44,16 @@ export interface BuildRoutingPromptParams<TContext = unknown, TData = unknown> {
     session?: SessionState<TData>;
     activeRouteSteps?: Step<TContext, TData>[];
     context?: TContext;
+    routeConditionContext?: string[];
 }
 export declare class RoutingEngine<TContext = unknown, TData = unknown> {
     private readonly options?;
     constructor(options?: RoutingEngineOptions | undefined);
+    /**
+     * Enter a route if not already in it, merging initial data
+     * @private
+     */
+    private enterRouteIfNeeded;
     /**
      * Optimized decision for single-route scenarios
      * Skips route scoring and only does step selection
@@ -54,15 +61,17 @@ export declare class RoutingEngine<TContext = unknown, TData = unknown> {
      */
     private decideSingleRouteStep;
     /**
-     * Recursively traverse step chain to find first non-skipped step or END_ROUTE
+     * Recursively traverse step chain to find first non-skipped step or END_ROUTE using new condition evaluation
      * @private
      */
-    private findFirstValidStepRecursive;
+    private findFirstValidStepRecursiveWithConditions;
     /**
-     * Identify valid next candidate steps based on current step and collected data
+     * Identify valid next candidate steps using new condition evaluation system
      * Returns step with isRouteComplete flag if route is complete (all steps skipped + has END_ROUTE transition)
+     *
+     * NEW: Automatically completes route when all required fields are collected
      */
-    getCandidateSteps(route: Route<TContext, TData>, currentStep: Step<TContext, TData> | undefined, data: Partial<TData>): CandidateStep<TContext, TData>[];
+    getCandidateStepsWithConditions(route: Route<TContext, TData>, currentStep: Step<TContext, TData> | undefined, templateContext: TemplateContext<TContext, TData>): Promise<CandidateStep<TContext, TData>[]>;
     /**
      * Full routing orchestration: builds prompt and schema, calls AI, selects route/step,
      * and updates the session (including initialData merge when entering a new route).
@@ -86,6 +95,26 @@ export declare class RoutingEngine<TContext = unknown, TData = unknown> {
         isRouteComplete?: boolean;
         completedRoutes?: Route<TContext, TData>[];
     }>;
+    /**
+     * Filter routes based on skipIf conditions
+     * @param routes - All available routes
+     * @param templateContext - Context for condition evaluation
+     * @returns Object with eligible routes and collected AI context strings
+     */
+    filterRoutesBySkipIf(routes: Route<TContext, TData>[], templateContext: TemplateContext<TContext, TData>): Promise<{
+        eligibleRoutes: Route<TContext, TData>[];
+        aiContextStrings: string[];
+    }>;
+    /**
+     * Filter routes based on when conditions
+     * @param routes - Routes that passed skipIf filtering
+     * @param templateContext - Context for condition evaluation
+     * @returns Object with eligible routes and collected AI context strings
+     */
+    filterRoutesByWhen(routes: Route<TContext, TData>[], templateContext: TemplateContext<TContext, TData>): Promise<{
+        eligibleRoutes: Route<TContext, TData>[];
+        aiContextStrings: string[];
+    }>;
     /**
      * Evaluate all routes for completion based on collected data
      * @param routes - All available routes
@@ -103,6 +132,7 @@ export declare class RoutingEngine<TContext = unknown, TData = unknown> {
     /**
      * Find the best route to continue based on completion status and user intent
      * Prioritizes routes that are partially complete but not finished
+     * IMPORTANT: Completed routes are excluded to prevent re-entering finished tasks
      * @param routes - All available routes
      * @param data - Currently collected agent-level data
      * @param routeScores - AI-generated route scores from routing decision

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

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