@falai/agent 0.8.0 → 0.9.0-alpha-1

package/dist/cjs/src/core/ResponsePipeline.js

@@ -0,0 +1,446 @@
+"use strict";
+/**
+ * Response processing utilities shared between respond() and respondStream() methods
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ResponsePipeline = void 0;
+const history_1 = require("../types/history");
+const utils_1 = require("../utils");
+const ToolExecutor_1 = require("../core/ToolExecutor");
+const constants_1 = require("../constants");
+/**
+ * Shared response processing logic between respond() and respondStream() methods
+ */
+class ResponsePipeline {
+    constructor(options, routes, tools, routingEngine, updateContext, updateData) {
+        this.options = options;
+        this.routes = routes;
+        this.tools = tools;
+        this.routingEngine = routingEngine;
+        this.updateContext = updateContext;
+        this.updateData = updateData;
+    }
+    /**
+     * Prepare context and session for response generation
+     */
+    async prepareResponseContext(params) {
+        const { contextOverride, session } = params;
+        // Get current context (may fetch from provider)
+        let currentContext = await this.getContext();
+        // Call beforeRespond hook if configured
+        if (this.options.hooks?.beforeRespond && currentContext !== undefined) {
+            currentContext = await this.options.hooks.beforeRespond(currentContext);
+            // Update stored context with the result from beforeRespond
+            this.context = currentContext;
+        }
+        // Merge context with override
+        const effectiveContext = {
+            ...currentContext,
+            ...contextOverride,
+        };
+        // Initialize or get session (use current session if available)
+        const targetSession = session || this.currentSession || (0, utils_1.createSession)();
+        return {
+            effectiveContext,
+            session: targetSession,
+        };
+    }
+    /**
+     * Handle routing and step selection logic
+     */
+    async handleRoutingAndStepSelection(params) {
+        const { session, history, context, signal } = params;
+        // PHASE 2: ROUTING + STEP SELECTION - Determine which route and step to use (combined)
+        let selectedRoute;
+        let responseDirectives;
+        let selectedStep;
+        let isRouteComplete = false;
+        let targetSession = session;
+        // Check for pending transition from previous route completion
+        if (targetSession.pendingTransition) {
+            const targetRoute = this.routes.find((r) => r.id === targetSession.pendingTransition?.targetRouteId);
+            if (targetRoute) {
+                utils_1.logger.debug(`[ResponseHandler] Auto-transitioning from pending transition to route: ${targetRoute.title}`);
+                // Clear pending transition and enter new route
+                targetSession = {
+                    ...targetSession,
+                    pendingTransition: undefined,
+                };
+                targetSession = (0, utils_1.enterRoute)(targetSession, targetRoute.id, targetRoute.title);
+                // Merge initial data if available
+                if (targetRoute.initialData) {
+                    targetSession = (0, utils_1.mergeCollected)(targetSession, targetRoute.initialData);
+                }
+                selectedRoute = targetRoute;
+            }
+            else {
+                utils_1.logger.warn(`[ResponseHandler] Pending transition target route not found: ${targetSession.pendingTransition.targetRouteId}`);
+                // Clear invalid transition
+                targetSession = {
+                    ...targetSession,
+                    pendingTransition: undefined,
+                };
+            }
+        }
+        // If no pending transition or transition handled, do normal routing
+        if (this.routes.length > 0 && !selectedRoute) {
+            const orchestration = await this.routingEngine.decideRouteAndStep({
+                routes: this.routes,
+                session: targetSession,
+                history,
+                agentOptions: this.options,
+                provider: this.options.provider,
+                context,
+                signal,
+            });
+            selectedRoute = orchestration.selectedRoute;
+            selectedStep = orchestration.selectedStep;
+            responseDirectives = orchestration.responseDirectives;
+            targetSession = orchestration.session;
+            isRouteComplete = orchestration.isRouteComplete || false;
+            // Log if route is complete
+            if (isRouteComplete) {
+                utils_1.logger.debug(`[ResponseHandler] Route complete: all required data collected, END_ROUTE reached`);
+            }
+        }
+        return {
+            selectedRoute,
+            selectedStep,
+            responseDirectives,
+            session: targetSession,
+            isRouteComplete,
+        };
+    }
+    /**
+     * Determine next step and update session
+     */
+    determineNextStep(params) {
+        const { selectedRoute, selectedStep, session, isRouteComplete } = params;
+        if (!selectedRoute || isRouteComplete) {
+            return { nextStep: undefined, session };
+        }
+        let nextStep;
+        // If we have a selected step from the combined routing decision, use it
+        if (selectedStep) {
+            nextStep = selectedStep;
+        }
+        else {
+            // New route or no step selected - get initial step or first valid step
+            const candidates = this.routingEngine.getCandidateSteps(selectedRoute, undefined, session.data || {});
+            if (candidates.length > 0) {
+                nextStep = candidates[0].step;
+                utils_1.logger.debug(`[ResponseHandler] Using first valid step: ${nextStep.id} for new route`);
+            }
+            else {
+                // Fallback to initial step even if it should be skipped
+                nextStep = selectedRoute.initialStep;
+                utils_1.logger.warn(`[ResponseHandler] No valid steps found, using initial step: ${nextStep.id}`);
+            }
+        }
+        // Update session with next step
+        const updatedSession = (0, utils_1.enterStep)(session, nextStep.id, nextStep.description);
+        utils_1.logger.debug(`[ResponseHandler] Entered step: ${nextStep.id}`);
+        return { nextStep, session: updatedSession };
+    }
+    /**
+     * Execute tool calls and handle results
+     */
+    async executeToolCalls(params) {
+        const { toolCalls, selectedRoute, context, session, history, isStreaming = false, } = params;
+        if (toolCalls.length === 0) {
+            return { session, toolCalls: undefined };
+        }
+        utils_1.logger.debug(`[ResponseHandler] Executing ${toolCalls.length} ${isStreaming ? "streaming " : ""}tool calls`);
+        let updatedSession = session;
+        const executedToolCalls = [];
+        for (const toolCall of toolCalls) {
+            const tool = this.findAvailableTool(toolCall.toolName, selectedRoute);
+            if (!tool) {
+                utils_1.logger.warn(`[ResponseHandler] Tool not found: ${toolCall.toolName}`);
+                continue;
+            }
+            const toolExecutor = new ToolExecutor_1.ToolExecutor();
+            const result = await toolExecutor.executeTool({
+                tool,
+                context,
+                updateContext: this.updateContext,
+                history,
+                data: updatedSession.data,
+            });
+            executedToolCalls.push(toolCall);
+            // Update context with tool results
+            if (result.contextUpdate) {
+                await this.updateContext(result.contextUpdate);
+            }
+            // Update collected data with tool results
+            if (result.dataUpdate) {
+                updatedSession = await this.updateData(updatedSession, result.dataUpdate);
+                utils_1.logger.debug(`[ResponseHandler] ${isStreaming ? "Streaming " : ""}Tool updated collected data:`, result.dataUpdate);
+            }
+            utils_1.logger.debug(`[ResponseHandler] Executed ${isStreaming ? "streaming " : ""}tool: ${result.toolName} (success: ${result.success})`);
+        }
+        return {
+            session: updatedSession,
+            toolCalls: executedToolCalls.length > 0 ? executedToolCalls : undefined,
+        };
+    }
+    /**
+     * Execute tool loop for follow-up tool calls
+     */
+    async executeToolLoop(params) {
+        const { initialToolCalls, selectedRoute, nextStep, responsePrompt, history, context, session, responseSchema, isStreaming = false, } = params;
+        const MAX_TOOL_LOOPS = 5;
+        let toolLoopCount = 0;
+        let currentToolCalls = initialToolCalls;
+        let hasToolCalls = currentToolCalls && currentToolCalls.length > 0;
+        let currentSession = session;
+        while (hasToolCalls && toolLoopCount < MAX_TOOL_LOOPS) {
+            toolLoopCount++;
+            utils_1.logger.debug(`[ResponseHandler] Starting ${isStreaming ? "streaming " : ""}tool loop ${toolLoopCount}/${MAX_TOOL_LOOPS}`);
+            // Add tool execution results to history so AI knows what happened
+            const toolResultsEvents = [];
+            for (const toolCall of currentToolCalls || []) {
+                const tool = this.findAvailableTool(toolCall.toolName, selectedRoute);
+                if (tool) {
+                    toolResultsEvents.push({
+                        kind: history_1.EventKind.TOOL,
+                        source: history_1.MessageRole.AGENT,
+                        timestamp: new Date().toISOString(),
+                        data: {
+                            tool_calls: [
+                                {
+                                    tool_id: toolCall.toolName,
+                                    arguments: toolCall.arguments,
+                                    result: {
+                                        data: "Tool executed successfully",
+                                    },
+                                },
+                            ],
+                        },
+                    });
+                }
+            }
+            // Create updated history with tool results
+            const updatedHistory = [...history, ...toolResultsEvents];
+            // Make follow-up AI call to see if more tools are needed
+            const followUpResult = await this.options.provider.generateMessage({
+                prompt: responsePrompt,
+                history: updatedHistory,
+                context,
+                tools: this.collectAvailableTools(selectedRoute, nextStep),
+                parameters: {
+                    jsonSchema: responseSchema,
+                    schemaName: isStreaming ? "tool_followup_streaming" : "tool_followup",
+                },
+            });
+            // Check if follow-up call has more tool calls
+            const followUpToolCalls = followUpResult.structured?.toolCalls;
+            hasToolCalls = followUpToolCalls && followUpToolCalls.length > 0;
+            if (hasToolCalls) {
+                utils_1.logger.debug(`[ResponseHandler] Follow-up call produced ${followUpToolCalls.length} additional tool calls`);
+                // Execute the follow-up tool calls
+                const toolResult = await this.executeToolCalls({
+                    toolCalls: followUpToolCalls,
+                    selectedRoute,
+                    context,
+                    session: currentSession,
+                    history: updatedHistory,
+                    isStreaming,
+                });
+                currentSession = toolResult.session;
+                currentToolCalls = followUpToolCalls;
+            }
+            else {
+                utils_1.logger.debug(`[ResponseHandler] ${isStreaming ? "Streaming " : ""}Tool loop completed after ${toolLoopCount} iterations`);
+                // Update final toolCalls from follow-up result if no more tools
+                currentToolCalls = followUpToolCalls || [];
+                break;
+            }
+        }
+        if (toolLoopCount >= MAX_TOOL_LOOPS) {
+            utils_1.logger.warn(`[ResponseHandler] ${isStreaming ? "Streaming " : ""}Tool loop limit reached (${MAX_TOOL_LOOPS}), stopping`);
+        }
+        return {
+            session: currentSession,
+            toolCalls: currentToolCalls,
+        };
+    }
+    /**
+     * Handle data collection from structured response
+     */
+    async handleDataCollection(params) {
+        const { structured, nextStep, session } = params;
+        if (!structured || !nextStep.collect) {
+            return { session };
+        }
+        const collectedData = {};
+        // The structured response includes both base fields and collected extraction fields
+        const structuredData = structured;
+        for (const field of nextStep.collect) {
+            if (field in structuredData) {
+                collectedData[field] = structuredData[field];
+            }
+        }
+        let updatedSession = session;
+        if (Object.keys(collectedData).length > 0) {
+            updatedSession = await this.updateData(session, collectedData);
+            utils_1.logger.debug(`[ResponseHandler] Collected data:`, collectedData);
+        }
+        return {
+            session: updatedSession,
+            collectedData,
+        };
+    }
+    /**
+     * Handle context updates from structured response
+     */
+    async handleContextUpdate(structured) {
+        if (structured &&
+            typeof structured === "object" &&
+            "contextUpdate" in structured) {
+            await this.updateContext(structured
+                .contextUpdate);
+        }
+    }
+    /**
+     * Handle route completion logic
+     */
+    async handleRouteCompletion(params) {
+        const { selectedRoute, session, context, history } = params;
+        // Check for onComplete transition
+        const transitionConfig = await selectedRoute.evaluateOnComplete({ data: session.data }, context);
+        if (transitionConfig) {
+            // Find target route by ID or title
+            const targetRoute = this.routes.find((r) => r.id === transitionConfig.nextStep ||
+                r.title === transitionConfig.nextStep);
+            if (targetRoute) {
+                const templateContext = {
+                    context,
+                    session,
+                    history,
+                };
+                const renderedCondition = (await (0, utils_1.render)(transitionConfig.condition, templateContext)) ||
+                    (typeof transitionConfig.condition === "string"
+                        ? transitionConfig.condition
+                        : "");
+                // Set pending transition in session
+                const updatedSession = {
+                    ...session,
+                    pendingTransition: {
+                        targetRouteId: targetRoute.id,
+                        condition: renderedCondition,
+                        reason: "route_complete",
+                    },
+                };
+                utils_1.logger.debug(`[ResponseHandler] Route ${selectedRoute.title} completed with pending transition to: ${targetRoute.title}`);
+                return { session: updatedSession, hasTransition: true };
+            }
+            else {
+                utils_1.logger.warn(`[ResponseHandler] Route ${selectedRoute.title} completed but target route not found: ${transitionConfig.nextStep}`);
+            }
+        }
+        // Set step to END_ROUTE marker
+        const updatedSession = (0, utils_1.enterStep)(session, constants_1.END_ROUTE_ID, "Route completed");
+        utils_1.logger.debug(`[ResponseHandler] Route ${selectedRoute.title} completed. Entered END_ROUTE step.`);
+        return { session: updatedSession, hasTransition: false };
+    }
+    /**
+     * Find an available tool by name for the given route
+     */
+    findAvailableTool(toolName, route) {
+        // Check route-level tools first (if route provided)
+        if (route) {
+            const routeTool = route
+                .getTools()
+                .find((tool) => tool.id === toolName || tool.name === toolName);
+            if (routeTool)
+                return routeTool;
+        }
+        // Fall back to agent-level tools
+        return this.tools.find((tool) => tool.id === toolName || tool.name === toolName);
+    }
+    /**
+     * Collect all available tools for the given route and step context
+     */
+    collectAvailableTools(route, step) {
+        const availableTools = new Map();
+        // Add agent-level tools
+        this.tools.forEach((tool) => {
+            availableTools.set(tool.id, tool);
+        });
+        // Add route-level tools (these take precedence)
+        if (route) {
+            route.getTools().forEach((tool) => {
+                availableTools.set(tool.id, tool);
+            });
+        }
+        // Filter by step-level allowed tools if specified
+        if (step?.tools) {
+            const allowedToolIds = new Set();
+            const stepTools = [];
+            for (const toolRef of step.tools) {
+                if (typeof toolRef === "string") {
+                    // Reference to registered tool
+                    allowedToolIds.add(toolRef);
+                }
+                else {
+                    // Inline tool definition
+                    if (toolRef.id) {
+                        allowedToolIds.add(toolRef.id);
+                        stepTools.push(toolRef);
+                    }
+                }
+            }
+            // If step specifies tools, only include those
+            if (allowedToolIds.size > 0) {
+                const filteredTools = new Map();
+                for (const toolId of allowedToolIds) {
+                    const tool = availableTools.get(toolId);
+                    if (tool) {
+                        filteredTools.set(toolId, tool);
+                    }
+                }
+                // Add inline tools
+                stepTools.forEach((tool) => {
+                    if (tool.id) {
+                        filteredTools.set(tool.id, tool);
+                    }
+                });
+                availableTools.clear();
+                filteredTools.forEach((tool, id) => availableTools.set(id, tool));
+            }
+        }
+        // Convert to the format expected by AI providers
+        return Array.from(availableTools.values()).map((tool) => ({
+            id: tool.id,
+            description: tool.description,
+            parameters: tool.parameters,
+        }));
+    }
+    /**
+     * Get current context (fetches from provider if configured)
+     */
+    async getContext() {
+        // If context provider is configured, use it to fetch fresh context
+        if (this.options.contextProvider) {
+            return await this.options.contextProvider();
+        }
+        // Otherwise return the stored context
+        return this.context;
+    }
+    // Setters for context and current session (needed for beforeRespond hook)
+    setContext(context) {
+        this.context = context;
+    }
+    setCurrentSession(session) {
+        this.currentSession = session;
+    }
+    getStoredContext() {
+        return this.context;
+    }
+    getCurrentSession() {
+        return this.currentSession;
+    }
+}
+exports.ResponsePipeline = ResponsePipeline;
+//# sourceMappingURL=ResponsePipeline.js.map

package/dist/cjs/src/core/ResponsePipeline.js.map

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

package/dist/cjs/src/core/Route.d.ts

@@ -0,0 +1,126 @@
+/**
+ * Route (Journey) DSL implementation
+ */
+import type { RouteOptions, RouteRef, StepOptions, RouteTransitionConfig, RouteCompletionHandler, RouteLifecycleHooks, StructuredSchema, Guideline, Term, Tool, Template } from "../types";
+import { Step } from "./Step";
+/**
+ * Represents a conversational route/journey
+ */
+export declare class Route<TContext = unknown, TData = unknown> {
+    readonly id: string;
+    readonly title: string;
+    readonly description?: string;
+    readonly identity?: Template<TContext, TData>;
+    readonly personality?: Template<TContext, TData>;
+    readonly conditions: Template<TContext, TData>[];
+    readonly rules: Template<TContext, TData>[];
+    readonly prohibitions: Template<TContext, TData>[];
+    readonly initialStep: Step<TContext, TData>;
+    readonly endStepSpec: Omit<StepOptions<TContext, TData>, "step" | "condition" | "skipIf">;
+    readonly responseOutputSchema?: StructuredSchema;
+    readonly schema?: StructuredSchema;
+    readonly initialData?: Partial<TData>;
+    readonly onComplete?: string | RouteTransitionConfig<TContext, TData> | RouteCompletionHandler<TContext, TData>;
+    readonly hooks?: RouteLifecycleHooks<TContext, TData>;
+    routingExtrasSchema?: StructuredSchema;
+    guidelines: Guideline<TContext>[];
+    terms: Term<TContext>[];
+    tools: Tool<TContext, unknown[], unknown, TData>[];
+    knowledgeBase: Record<string, unknown>;
+    constructor(options: RouteOptions<TContext, TData>);
+    /**
+     * Build a sequential step machine from an array of steps
+     * @private
+     */
+    private buildSequentialSteps;
+    /**
+     * Create a guideline specific to this route
+     */
+    createGuideline(guideline: Guideline<TContext>): this;
+    /**
+     * Create a term for the route's domain glossary
+     */
+    createTerm(term: Term<TContext>): this;
+    /**
+     * Register a tool for this route
+     */
+    createTool(tool: Tool<TContext, unknown[], unknown, TData>): this;
+    /**
+     * Register multiple tools for this route
+     */
+    registerTools(tools: Tool<TContext, unknown[], unknown, TData>[]): this;
+    /**
+     * Get all guidelines for this route
+     */
+    getGuidelines(): Guideline<TContext>[];
+    /**
+     * Get all terms for this route
+     */
+    getTerms(): Term<TContext>[];
+    /**
+     * Get all tools for this route
+     */
+    getTools(): Tool<TContext, unknown[], unknown, TData>[];
+    /**
+     * Get the route's knowledge base
+     */
+    getKnowledgeBase(): Record<string, unknown>;
+    /**
+     * Get rules for this route
+     */
+    getRules(): Template<TContext, TData>[];
+    /**
+     * Get prohibitions for this route
+     */
+    getProhibitions(): Template<TContext, TData>[];
+    /**
+     * Get optional extras schema requested during routing
+     */
+    getRoutingExtrasSchema(): StructuredSchema | undefined;
+    /**
+     * Get optional structured response schema for this route's message
+     */
+    getResponseOutputSchema(): StructuredSchema | undefined;
+    getSteps(): Step<TContext, TData>[];
+    /**
+     * Get route reference
+     */
+    getRef(): RouteRef;
+    /**
+     * Get all steps in this route (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 route structure for debugging
+     */
+    describe(): string;
+    /**
+     * 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
+     */
+    handleDataUpdate(data: Partial<TData>, previousCollected: Partial<TData>): Promise<Partial<TData>>;
+    /**
+     * Handle context updates for this route, calling the onContextUpdate hook if configured
+     * @param newContext - New context
+     * @param previousContext - Previous context
+     */
+    handleContextUpdate(newContext: TContext, previousContext: TContext): Promise<void>;
+    /**
+     * 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
+     */
+    evaluateOnComplete(session: {
+        data?: Partial<TData>;
+    }, context?: TContext): Promise<RouteTransitionConfig<TContext, TData> | undefined>;
+}
+//# sourceMappingURL=Route.d.ts.map

package/dist/cjs/src/core/Route.d.ts.map

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