@falai/agent 0.8.0 → 0.9.0-alpha-1

package/dist/cjs/{core → src/core}/Route.js

@@ -6,39 +6,75 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.Route = void 0;
 const Step_1 = require("./Step");
 const id_1 = require("../utils/id");
+const constants_1 = require("../constants");
 /**
  * Represents a conversational route/journey
  */
 class Route {
     constructor(options) {
         this.guidelines = [];
+        this.terms = [];
+        this.tools = [];
+        this.knowledgeBase = {};
         // Use provided ID or generate a deterministic one from the title
         this.id = options.id || (0, id_1.generateRouteId)(options.title);
         this.title = options.title;
         this.description = options.description;
+        this.identity = options.identity;
+        this.personality = options.personality;
         this.conditions = options.conditions || [];
-        this.domains = options.domains;
         this.rules = options.rules || [];
         this.prohibitions = options.prohibitions || [];
-        this.initialStep = new Step_1.Step(this.id, options.initialStep?.instructions || "Initial step", options.initialStep?.id, options.initialStep?.collect, options.initialStep?.skipIf, options.initialStep?.requires, options.initialStep?.instructions);
+        // 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_1.Step(this.id, initialStepOptions);
         // Store endStep spec (will be used when route completes)
         this.endStepSpec = options.endStep || {
-            instructions: "Summarize what was accomplished and confirm completion based on the conversation history and collected data",
+            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.schema = options.schema;
         this.initialData = options.initialData;
         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((tool) => {
+                this.createTool(tool);
+            });
+        }
         // Build sequential steps if provided
-        if (options.steps && options.steps.length > 0) {
-            this.buildSequentialSteps(options.steps);
+        if (stepsToChain.length > 0) {
+            this.buildSequentialSteps(stepsToChain);
         }
     }
     /**
@@ -46,14 +82,15 @@ class Route {
      * @private
      */
     buildSequentialSteps(steps) {
-        // Import END_ROUTE dynamically to avoid circular dependency
-        const END_ROUTE = Symbol.for("END_ROUTE");
-        let currentStep = this.initialStep;
+        let currentStep = this.initialStep.asStepResult();
         for (const step of steps) {
-            currentStep = currentStep.nextStep(step);
+            if (step === constants_1.END_ROUTE) {
+                currentStep.nextStep({ step: constants_1.END_ROUTE });
+            }
+            else {
+                currentStep = currentStep.nextStep(step);
+            }
         }
-        // End the route
-        currentStep.nextStep({ step: END_ROUTE });
     }
     /**
      * Create a guideline specific to this route
@@ -66,6 +103,27 @@ class Route {
         });
         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) {
+        this.tools.push(tool);
+        return this;
+    }
+    /**
+     * Register multiple tools for this route
+     */
+    registerTools(tools) {
+        tools.forEach((tool) => this.createTool(tool));
+        return this;
+    }
     /**
      * Get all guidelines for this route
      */
@@ -73,11 +131,22 @@ class Route {
         return [...this.guidelines];
     }
     /**
-     * Get allowed domain names for this route
-     * @returns Array of domain names, or undefined if all domains are allowed
+     * 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
      */
-    getDomains() {
-        return this.domains ? [...this.domains] : undefined;
+    getKnowledgeBase() {
+        return { ...this.knowledgeBase };
     }
     /**
      * Get rules for this route
@@ -103,6 +172,9 @@ class Route {
     getResponseOutputSchema() {
         return this.responseOutputSchema;
     }
+    getSteps() {
+        return this.getAllSteps();
+    }
     /**
      * Get route reference
      */
@@ -126,10 +198,9 @@ class Route {
             visited.add(current.id);
             steps.push(current);
             // Add target steps from transitions
-            for (const transition of current.getTransitions()) {
-                const target = transition.getTarget();
-                if (target && !visited.has(target.id)) {
-                    queue.push(target);
+            for (const nextStep of current.getTransitions()) {
+                if (nextStep && !visited.has(nextStep.id)) {
+                    queue.push(nextStep);
                 }
             }
         }
@@ -161,11 +232,36 @@ class Route {
             lines.push(`  - ${step.id}${step.description ? `: ${step.description}` : ""}`);
             const transitions = step.getTransitions();
             for (const transition of transitions) {
-                lines.push(`    -> ${transition.describe()}`);
+                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);
+        }
+    }
     /**
      * Evaluate the onComplete handler and return transition config
      * @param session - Current session step

package/dist/cjs/src/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/{core → cjs/src/core}/RoutingEngine.d.ts

@@ -1,10 +1,10 @@
-import type { Event } from "../types/history";
+import type { Event, AgentOptions, StructuredSchema, RoutingDecision, SessionState, AiProvider } from "../types";
 import type { Route } from "./Route";
 import type { Step } from "./Step";
-import type { StructuredSchema } from "../types/schema";
-import type { RoutingDecision } from "../types/routing";
-import type { SessionStep } from "../types/session";
-import type { AiProvider } from "../types/ai";
+export interface CandidateStep<TContext = unknown, TData = unknown> {
+    step: Step<TContext, TData>;
+    isRouteComplete?: boolean;
+}
 export interface RoutingDecisionOutput {
     context: string;
     routes: Record<string, number>;
@@ -24,7 +24,27 @@ export interface RoutingEngineOptions {
     switchThreshold?: number;
     maxCandidates?: number;
 }
-export declare class RoutingEngine<TContext = unknown> {
+export interface BuildStepSelectionPromptParams<TContext = unknown, TData = unknown> {
+    route: Route<TContext, TData>;
+    currentStep: Step<TContext, TData> | undefined;
+    candidates: CandidateStep<TContext, TData>[];
+    data: Partial<TData>;
+    history: Event[];
+    lastMessage: string;
+    agentOptions?: AgentOptions<TContext>;
+    context?: TContext;
+    session?: SessionState<TData>;
+}
+export interface BuildRoutingPromptParams<TContext = unknown, TData = unknown> {
+    history: Event[];
+    routes: Route<TContext, TData>[];
+    lastMessage: string;
+    agentOptions?: AgentOptions<TContext>;
+    session?: SessionState<TData>;
+    activeRouteSteps?: Step<TContext, TData>[];
+    context?: TContext;
+}
+export declare class RoutingEngine<TContext = unknown, TData = unknown> {
     private readonly options?;
     constructor(options?: RoutingEngineOptions | undefined);
     /**
@@ -42,13 +62,7 @@ export declare class RoutingEngine<TContext = unknown> {
      * Identify valid next candidate steps based on current step and collected data
      * Returns step with isRouteComplete flag if route is complete (all steps skipped + has END_ROUTE transition)
      */
-    getCandidateSteps<TData = unknown>(route: Route<TContext, TData>, currentStep: Step<TContext, TData> | undefined, data: Partial<TData>): Array<{
-        step: Step<TContext, TData>;
-        condition?: string;
-        requires?: string[];
-        collectFields?: string[];
-        isRouteComplete?: boolean;
-    }>;
+    getCandidateSteps<TData = unknown>(route: Route<TContext, TData>, currentStep: Step<TContext, TData> | undefined, data: Partial<TData>): 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).
@@ -56,15 +70,10 @@ export declare class RoutingEngine<TContext = unknown> {
      * OPTIMIZATION: If there's only 1 route, skips route scoring and only does step selection.
      */
     decideRouteAndStep(params: {
-        routes: Route<TContext, unknown>[];
-        session: SessionStep;
+        routes: Route<TContext, TData>[];
+        session: SessionState<TData>;
         history: Event[];
-        agentMeta?: {
-            name?: string;
-            goal?: string;
-            description?: string;
-            personality?: string;
-        };
+        agentOptions?: AgentOptions<TContext>;
         provider: AiProvider;
         context: TContext;
         signal?: AbortSignal;
@@ -72,7 +81,7 @@ export declare class RoutingEngine<TContext = unknown> {
         selectedRoute?: Route<TContext>;
         selectedStep?: Step<TContext>;
         responseDirectives?: string[];
-        session: SessionStep;
+        session: SessionState<TData>;
         isRouteComplete?: boolean;
     }>;
     /**
@@ -85,22 +94,8 @@ export declare class RoutingEngine<TContext = unknown> {
      * @private
      */
     private buildStepSelectionSchema;
-    buildDynamicRoutingSchema(routes: Route<TContext>[], extrasSchema?: StructuredSchema, activeRouteSteps?: {
-        stepId: string;
-        description: string;
-    }[]): StructuredSchema;
-    buildRoutingPrompt(history: Event[], routes: Route<TContext>[], lastMessage: string, agentMeta?: {
-        name?: string;
-        goal?: string;
-        description?: string;
-        personality?: string;
-    }, session?: SessionStep, activeRouteSteps?: Array<{
-        stepId: string;
-        description: string;
-        condition?: string;
-        requires?: string[];
-        collectFields?: string[];
-    }>): string;
+    buildDynamicRoutingSchema(routes: Route<TContext, TData>[], extrasSchema?: StructuredSchema, activeRouteSteps?: Step<TContext, TData>[]): StructuredSchema;
+    buildRoutingPrompt(params: BuildRoutingPromptParams<TContext, TData>): Promise<string>;
     decideRouteFromScores(output: RoutingDecision): {
         routeId: string;
         maxScore: number;

package/dist/cjs/src/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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"}