@falai/agent 0.8.1 → 0.9.0-alpha-1

package/dist/{core → src/core}/RoutingEngine.js

@@ -1,7 +1,9 @@
-import { enterRoute, mergeCollected } from "../types/session";
+import { enterRoute, mergeCollected } from "../utils";
 import { PromptComposer } from "./PromptComposer";
 import { getLastMessageFromHistory } from "../utils/event";
 import { logger } from "../utils/logger";
+import { render } from "../utils/template";
+import { END_ROUTE_ID } from "../constants";
 export class RoutingEngine {
     constructor(options) {
         this.options = options;
@@ -12,7 +14,7 @@ export class RoutingEngine {
      * @private
      */
     async decideSingleRouteStep(params) {
-        const { route, session, history, agentMeta, provider, context, signal } = params;
+        const { route, session, history, agentOptions, provider, context, signal } = params;
         let updatedSession = session;
         const selectedRoute = route;
         // Enter route if not already in it
@@ -58,8 +60,18 @@ export class RoutingEngine {
         }
         // Multiple candidates - use AI to select best step
         const lastUserMessage = getLastMessageFromHistory(history);
-        const stepPrompt = this.buildStepSelectionPrompt(route, currentStep, candidates, updatedSession.data || {}, history, lastUserMessage, agentMeta);
-        const stepSchema = this.buildStepSelectionSchema(candidates.map((c) => c.step.id));
+        const stepPrompt = await this.buildStepSelectionPrompt({
+            route,
+            currentStep,
+            candidates,
+            data: updatedSession.data || {},
+            history,
+            lastMessage: lastUserMessage,
+            agentOptions,
+            context,
+            session: updatedSession,
+        });
+        const stepSchema = this.buildStepSelectionSchema(candidates.map((c) => c.step));
         const stepResult = await provider.generateMessage({
             prompt: stepPrompt,
             history,
@@ -71,9 +83,9 @@ export class RoutingEngine {
             },
         });
         const selectedStepId = stepResult.structured?.selectedStepId;
-        const selectedStep = candidates.find((c) => c.step.id === selectedStepId)?.step;
+        const selectedStep = candidates.find((c) => c.step.id === selectedStepId);
         if (selectedStep) {
-            logger.debug(`[RoutingEngine] Single-route: AI selected step: ${selectedStep.id}`);
+            logger.debug(`[RoutingEngine] Single-route: AI selected step: ${selectedStep.step.id}`);
             logger.debug(`[RoutingEngine] Single-route: Reasoning: ${stepResult.structured?.reasoning}`);
         }
         else {
@@ -81,7 +93,7 @@ export class RoutingEngine {
         }
         return {
             selectedRoute,
-            selectedStep: selectedStep || candidates[0].step,
+            selectedStep: selectedStep?.step || candidates[0].step,
             responseDirectives: stepResult.structured?.responseDirectives,
             session: updatedSession,
         };
@@ -98,11 +110,9 @@ export class RoutingEngine {
         visited.add(currentStep.id);
         const transitions = currentStep.getTransitions();
         for (const transition of transitions) {
-            const target = transition.getTarget();
+            const target = transition;
             // Check for END_ROUTE transition
-            if (!target &&
-                transition.spec.step &&
-                typeof transition.spec.step === "symbol") {
+            if (target && target.id === END_ROUTE_ID) {
                 // Found END_ROUTE - route is complete
                 return {
                     isRouteComplete: true,
@@ -115,7 +125,7 @@ export class RoutingEngine {
                 logger.debug(`[RoutingEngine] Found valid step after skipping: ${target.id}`);
                 return {
                     step: target,
-                    condition: transition.condition,
+                    isRouteComplete: false,
                 };
             }
             // Target should be skipped too - recurse deeper
@@ -143,21 +153,16 @@ export class RoutingEngine {
                 if (result.isRouteComplete) {
                     // All steps are skipped and we reached END_ROUTE
                     logger.debug(`[RoutingEngine] Route complete on entry: all steps skipped, END_ROUTE reached`);
-                    return [
-                        {
-                            step: initialStep,
-                            condition: "Route complete - all data collected on entry",
-                            isRouteComplete: true,
-                        },
-                    ];
+                    candidates.push({
+                        step: initialStep,
+                        isRouteComplete: true,
+                    });
                 }
                 else if (result.step) {
                     // Found a non-skipped step
                     candidates.push({
                         step: result.step,
-                        condition: result.condition,
-                        requires: result.step.requires,
-                        collectFields: result.step.collectFields,
+                        isRouteComplete: result.isRouteComplete || false,
                     });
                 }
                 // If no step found and not complete, fall through to return empty candidates
@@ -165,8 +170,7 @@ export class RoutingEngine {
             else {
                 candidates.push({
                     step: initialStep,
-                    requires: initialStep.requires,
-                    collectFields: initialStep.collectFields,
+                    isRouteComplete: false,
                 });
             }
             return candidates;
@@ -174,11 +178,9 @@ export class RoutingEngine {
         const transitions = currentStep.getTransitions();
         let hasEndRoute = false;
         for (const transition of transitions) {
-            const target = transition.getTarget();
+            const target = transition;
             // Check for END_ROUTE transition (no target step)
-            if (!target &&
-                transition.spec.step &&
-                typeof transition.spec.step === "symbol") {
+            if (target && target.id === END_ROUTE_ID) {
                 hasEndRoute = true;
                 continue;
             }
@@ -196,18 +198,14 @@ export class RoutingEngine {
                     // Found a non-skipped step deeper in the chain
                     candidates.push({
                         step: result.step,
-                        condition: result.condition || transition.condition,
-                        requires: result.step.requires,
-                        collectFields: result.step.collectFields,
+                        isRouteComplete: result.isRouteComplete || false,
                     });
                 }
                 continue;
             }
             candidates.push({
                 step: target,
-                condition: transition.condition,
-                requires: target.requires,
-                collectFields: target.collectFields,
+                isRouteComplete: hasEndRoute || false,
             });
         }
         // If no valid candidates found
@@ -219,7 +217,6 @@ export class RoutingEngine {
                 return [
                     {
                         step: currentStep,
-                        condition: "Route complete - all data collected",
                         isRouteComplete: true,
                     },
                 ];
@@ -228,9 +225,7 @@ export class RoutingEngine {
             if (!currentStep.shouldSkip(data)) {
                 candidates.push({
                     step: currentStep,
-                    condition: "Continue in current step (no valid transitions)",
-                    requires: currentStep.requires,
-                    collectFields: currentStep.collectFields,
+                    isRouteComplete: hasEndRoute || false,
                 });
             }
         }
@@ -243,7 +238,7 @@ export class RoutingEngine {
      * OPTIMIZATION: If there's only 1 route, skips route scoring and only does step selection.
      */
     async decideRouteAndStep(params) {
-        const { routes, session, history, agentMeta, provider, context, signal } = params;
+        const { routes, session, history, agentOptions, provider, context, signal, } = params;
         if (routes.length === 0) {
             return { session };
         }
@@ -253,7 +248,7 @@ export class RoutingEngine {
                 route: routes[0],
                 session,
                 history,
-                agentMeta,
+                agentOptions,
                 provider,
                 context,
                 signal,
@@ -278,19 +273,21 @@ export class RoutingEngine {
                     activeRouteSteps = undefined;
                 }
                 else {
-                    activeRouteSteps = candidates.map((c) => ({
-                        stepId: c.step.id,
-                        description: c.step.description || "",
-                        condition: c.condition,
-                        requires: c.requires,
-                        collectFields: c.collectFields,
-                    }));
+                    activeRouteSteps = candidates.map((c) => c.step);
                     logger.debug(`[RoutingEngine] Found ${activeRouteSteps.length} candidate steps for active route`);
                 }
             }
         }
         const routingSchema = this.buildDynamicRoutingSchema(routes, undefined, activeRouteSteps);
-        const routingPrompt = this.buildRoutingPrompt(history, routes, lastUserMessage, agentMeta, session, activeRouteSteps);
+        const routingPrompt = await this.buildRoutingPrompt({
+            history,
+            routes,
+            lastMessage: lastUserMessage,
+            agentOptions,
+            session,
+            activeRouteSteps,
+            context,
+        });
         const routingResult = await provider.generateMessage({
             prompt: routingPrompt,
             history,
@@ -347,57 +344,56 @@ export class RoutingEngine {
      * Build prompt for step selection within a single route
      * @private
      */
-    buildStepSelectionPrompt(route, currentStep, candidates, data, history, lastMessage, agentMeta) {
-        const pc = new PromptComposer();
+    async buildStepSelectionPrompt(params) {
+        const { route, currentStep, candidates, data, history, lastMessage, agentOptions, context, session, } = params;
+        const templateContext = { context, session, history };
+        const pc = new PromptComposer(templateContext);
         // Add agent metadata
-        if (agentMeta?.name || agentMeta?.goal || agentMeta?.description) {
-            pc.addAgentMeta({
-                name: agentMeta?.name || "Agent",
-                description: agentMeta?.description,
-                goal: agentMeta?.goal,
-            });
+        if (agentOptions) {
+            await pc.addAgentMeta(agentOptions);
         }
-        const personality = agentMeta?.personality || "Tone: brief, natural, 1-2 short sentences.";
-        pc.addPersonality(personality);
         // Add route context
-        pc.addInstruction(`Active Route: ${route.title}\nDescription: ${route.description || "N/A"}`);
+        await pc.addInstruction(`Active Route: ${route.title}\nDescription: ${route.description || "N/A"}`);
         // Add current step context
         if (currentStep) {
-            pc.addInstruction(`Current Step: ${currentStep.id}\nDescription: ${currentStep.description || "N/A"}`);
+            await pc.addInstruction(`Current Step: ${currentStep.id}\nDescription: ${currentStep.description || "N/A"}`);
         }
         else {
-            pc.addInstruction("Current Step: None (entering route)");
+            await pc.addInstruction("Current Step: None (entering route)");
         }
         // Add collected data context
         if (Object.keys(data).length > 0) {
-            pc.addInstruction(`Collected Data So Far:\n${JSON.stringify(data, null, 2)}`);
+            await pc.addInstruction(`Collected Data So Far:\n${JSON.stringify(data, null, 2)}`);
         }
         else {
-            pc.addInstruction("Collected Data: None yet");
+            await pc.addInstruction("Collected Data: None yet");
         }
         // Add conversation history
-        pc.addInteractionHistory(history);
-        pc.addLastMessage(lastMessage);
+        await pc.addInteractionHistory(history);
+        await pc.addLastMessage(lastMessage);
         // Add candidate steps
-        const stepDescriptions = candidates.map((candidate, idx) => {
+        const stepDescriptions = [];
+        for (const candidate of candidates) {
+            const idx = candidates.indexOf(candidate);
             const parts = [
                 `${idx + 1}. Step ID: ${candidate.step.id}`,
                 `   Description: ${candidate.step.description || "N/A"}`,
             ];
-            if (candidate.condition) {
-                parts.push(`   Condition: ${candidate.condition}`);
+            if (candidate.step.when) {
+                const renderedWhen = await render(candidate.step.when, templateContext);
+                parts.push(`   When this step should be completed: ${renderedWhen}`);
             }
-            if (candidate.requires && candidate.requires.length > 0) {
-                parts.push(`   Required Data: ${candidate.requires.join(", ")}`);
+            if (candidate.step.requires && candidate.step.requires.length > 0) {
+                parts.push(`   Required Data: ${candidate.step.requires.join(", ")}`);
             }
-            if (candidate.collectFields && candidate.collectFields.length > 0) {
-                parts.push(`   Collects: ${candidate.collectFields.join(", ")}`);
+            if (candidate.step.collect && candidate.step.collect.length > 0) {
+                parts.push(`   Collects: ${candidate.step.collect.join(", ")}`);
             }
-            return parts.join("\n");
-        });
-        pc.addInstruction(`Available Steps to Transition To:\n${stepDescriptions.join("\n\n")}`);
-        // Add decision instructions
-        pc.addInstruction([
+            stepDescriptions.push(parts.join("\n"));
+        }
+        await pc.addInstruction(`Available Steps to Transition To:\n${stepDescriptions.join("\n\n")}`);
+        // Add decision prompt
+        await pc.addInstruction([
             "Task: Decide which step to transition to based on:",
             "1. The user's current message and intent",
             "2. The conversation history and context",
@@ -419,7 +415,7 @@ export class RoutingEngine {
      * Build schema for step selection
      * @private
      */
-    buildStepSelectionSchema(validStepIds) {
+    buildStepSelectionSchema(validSteps) {
         return {
             description: "Step transition decision based on conversation context and collected data",
             type: "object",
@@ -433,7 +429,7 @@ export class RoutingEngine {
                     type: "string",
                     nullable: false,
                     description: "The ID of the selected step to transition to",
-                    enum: validStepIds,
+                    enum: validSteps.map((s) => s.id),
                 },
                 responseDirectives: {
                     type: "array",
@@ -489,7 +485,7 @@ export class RoutingEngine {
                 type: "string",
                 nullable: false,
                 description: "The step ID to transition to within the active route (required if continuing in current route)",
-                enum: activeRouteSteps.map((s) => s.stepId),
+                enum: activeRouteSteps.map((s) => s.id),
             };
             base.properties.stepReasoning = {
                 type: "string",
@@ -508,18 +504,14 @@ export class RoutingEngine {
         }
         return base;
     }
-    buildRoutingPrompt(history, routes, lastMessage, agentMeta, session, activeRouteSteps) {
-        const pc = new PromptComposer();
-        if (agentMeta?.name || agentMeta?.goal || agentMeta?.description) {
-            pc.addAgentMeta({
-                name: agentMeta?.name || "Agent",
-                description: agentMeta?.description,
-                goal: agentMeta?.goal,
-            });
+    async buildRoutingPrompt(params) {
+        const { history, routes, lastMessage, agentOptions, session, activeRouteSteps, context, } = params;
+        const templateContext = { context, session, history };
+        const pc = new PromptComposer(templateContext);
+        if (agentOptions) {
+            await pc.addAgentMeta(agentOptions);
         }
-        const personality = agentMeta?.personality || "Tone: brief, natural, 1-2 short sentences.";
-        pc.addPersonality(personality);
-        pc.addInstruction("Task: Intent analysis and route scoring (0-100). Score ALL listed routes.");
+        await pc.addInstruction("Task: Intent analysis and route scoring (0-100). Score ALL listed routes.");
         // Add session context if available
         if (session?.currentRoute) {
             const sessionInfo = [
@@ -536,43 +528,45 @@ export class RoutingEngine {
                 sessionInfo.push(`- Collected data: ${JSON.stringify(session.data)}`);
             }
             sessionInfo.push("Note: User is mid-conversation. They may want to continue current route or switch to a new one based on their intent.");
-            pc.addInstruction(sessionInfo.join("\n"));
+            await pc.addInstruction(sessionInfo.join("\n"));
             // Add available steps for the active route
             if (activeRouteSteps && activeRouteSteps.length > 0) {
                 const stepInfo = [
                     "",
                     "Available steps in active route (choose one to transition to):",
                 ];
-                activeRouteSteps.forEach((step, idx) => {
-                    stepInfo.push(`${idx + 1}. Step: ${step.stepId}`);
+                for (const step of activeRouteSteps) {
+                    const idx = activeRouteSteps.indexOf(step);
+                    stepInfo.push(`${idx + 1}. Step: ${step.id}`);
                     if (step.description) {
                         stepInfo.push(`   Description: ${step.description}`);
                     }
-                    if (step.condition) {
-                        stepInfo.push(`   Condition: ${step.condition}`);
+                    const renderedWhen = await render(step.when, templateContext);
+                    if (step.when) {
+                        stepInfo.push(`   When this step should be completed: ${renderedWhen}`);
                     }
                     if (step.requires && step.requires.length > 0) {
                         stepInfo.push(`   Required data: ${step.requires.join(", ")}`);
                     }
-                    if (step.collectFields && step.collectFields.length > 0) {
-                        stepInfo.push(`   Will collect: ${step.collectFields.join(", ")}`);
+                    if (step.collect && step.collect.length > 0) {
+                        stepInfo.push(`   Will collect: ${step.collect.join(", ")}`);
                     }
-                });
+                }
                 stepInfo.push("");
                 stepInfo.push("IMPORTANT: You MUST select a step to transition to. Evaluate which step makes the most sense based on:");
                 stepInfo.push("- The conversation flow and what's been collected");
                 stepInfo.push("- What data is still needed vs already present");
                 stepInfo.push("- The logical next step in the conversation");
                 stepInfo.push("- Whether conditions for steps are met");
-                pc.addInstruction(stepInfo.join("\n"));
+                await pc.addInstruction(stepInfo.join("\n"));
             }
         }
-        pc.addInteractionHistory(history);
-        pc.addLastMessage(lastMessage);
+        await pc.addInteractionHistory(history);
+        await pc.addLastMessage(lastMessage);
         // Cast to unknown to satisfy generic constraints in composer
         // This is safe because PromptComposer only reads route metadata (id, title, description)
-        pc.addRoutingOverview(routes);
-        pc.addInstruction([
+        await pc.addRoutingOverview(routes);
+        await pc.addInstruction([
             "Scoring rules:",
             "- 90-100: explicit keywords + clear intent",
             "- 70-89: strong contextual evidence + relevant keywords",

package/dist/src/core/RoutingEngine.js.map

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

package/dist/src/core/SessionManager.d.ts

@@ -0,0 +1,76 @@
+/**
+ * SessionManager - Simplified session management with history
+ *
+ * Provides a clean, pragmatic API for managing sessions and conversation history
+ * in both server and client environments.
+ */
+import type { SessionState } from "../types/session";
+import type { History } from "../types/history";
+import { PersistenceManager } from "./PersistenceManager";
+import type { PersistenceAdapter } from "../types/persistence";
+/**
+ * SessionManager handles session lifecycle and conversation history
+ */
+export declare class SessionManager<TData = unknown> {
+    private currentSession?;
+    private persistenceManager?;
+    constructor(persistenceManagerOrAdapter?: PersistenceManager<TData> | PersistenceAdapter<TData>);
+    /**
+     * Core method: getOrCreate handles both existing and new sessions
+     * Works for sessionIds that exist, don't exist, or auto-generated IDs
+     */
+    getOrCreate(sessionId?: string): Promise<SessionState<TData>>;
+    /**
+     * Create a new session with optional custom ID
+     */
+    private create;
+    /**
+     * Add a message to the session history
+     */
+    addMessage(role: "user" | "assistant", content: string, name?: string): Promise<void>;
+    /**
+     * Get the current conversation history
+     */
+    getHistory(): History;
+    /**
+     * Set the entire conversation history
+     */
+    setHistory(history: History): void;
+    /**
+     * Clear all conversation history
+     */
+    clearHistory(): void;
+    /**
+     * Save the current session to persistence
+     */
+    save(): Promise<void>;
+    /**
+     * Delete the current session from persistence
+     */
+    delete(): Promise<void>;
+    /**
+     * Get the current session
+     */
+    get current(): SessionState<TData> | undefined;
+    /**
+     * Get the current session ID
+     */
+    get id(): string | undefined;
+    /**
+     * Get collected data from the current session
+     */
+    getData<T = TData>(): Partial<T> | undefined;
+    /**
+     * Set/merge data into the current session
+     */
+    setData<T = TData>(data: Partial<T>): Promise<void>;
+    /**
+     * Reset the session (creates new session, optionally preserving history)
+     */
+    reset(preserveHistory?: boolean): Promise<SessionState<TData>>;
+    /**
+     * Get the persistence manager (for testing purposes)
+     */
+    getPersistenceManager(): PersistenceManager<TData> | undefined;
+}
+//# sourceMappingURL=SessionManager.d.ts.map

package/dist/src/core/SessionManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SessionManager.d.ts","sourceRoot":"","sources":["../../../src/core/SessionManager.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,KAAK,EAAE,OAAO,EAAe,MAAM,kBAAkB,CAAC;AAC7D,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAE/D;;GAEG;AACH,qBAAa,cAAc,CAAC,KAAK,GAAG,OAAO;IACzC,OAAO,CAAC,cAAc,CAAC,CAAsB;IAC7C,OAAO,CAAC,kBAAkB,CAAC,CAA4B;gBAGrD,2BAA2B,CAAC,EACxB,kBAAkB,CAAC,KAAK,CAAC,GACzB,kBAAkB,CAAC,KAAK,CAAC;IAe/B;;;OAGG;IACG,WAAW,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC;IA0BnE;;OAEG;YACW,MAAM;IA2BpB;;OAEG;IACG,UAAU,CACd,IAAI,EAAE,MAAM,GAAG,WAAW,EAC1B,OAAO,EAAE,MAAM,EACf,IAAI,CAAC,EAAE,MAAM,GACZ,OAAO,CAAC,IAAI,CAAC;IAoBhB;;OAEG;IACH,UAAU,IAAI,OAAO;IAIrB;;OAEG;IACH,UAAU,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;IAOlC;;OAEG;IACH,YAAY,IAAI,IAAI;IAOpB;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAS3B;;OAEG;IACG,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;IAO7B;;OAEG;IACH,IAAI,OAAO,IAAI,YAAY,CAAC,KAAK,CAAC,GAAG,SAAS,CAE7C;IAED;;OAEG;IACH,IAAI,EAAE,IAAI,MAAM,GAAG,SAAS,CAE3B;IAED;;OAEG;IACH,OAAO,CAAC,CAAC,GAAG,KAAK,KAAK,OAAO,CAAC,CAAC,CAAC,GAAG,SAAS;IAI5C;;OAEG;IACG,OAAO,CAAC,CAAC,GAAG,KAAK,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAazD;;OAEG;IACG,KAAK,CAAC,eAAe,UAAQ,GAAG,OAAO,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC;IAqBlE;;OAEG;IACH,qBAAqB,IAAI,kBAAkB,CAAC,KAAK,CAAC,GAAG,SAAS;CAG/D"}