@falai/agent 0.1.0-alpha2

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

@@ -0,0 +1,222 @@
+/**
+ * ResponseModal handles all response generation logic for the Agent
+ * Provides both streaming and non-streaming response generation with unified logic
+ */
+import type { AgentResponse, AgentResponseStreamChunk, History, SessionState, StepRef } from "../types";
+import type { Agent } from "./Agent";
+import { ResponseEngine } from "./ResponseEngine";
+import { ResponsePipeline } from "./ResponsePipeline";
+/**
+ * Configuration options for ResponseModal
+ */
+export interface ResponseModalOptions {
+    /** Maximum number of tool loops allowed during response generation */
+    maxToolLoops?: number;
+    /** Enable automatic session saving after response generation */
+    enableAutoSave?: boolean;
+    /** Enable debug mode for detailed logging */
+    debugMode?: boolean;
+}
+/**
+ * Parameters for respond and respondStream methods
+ */
+export interface RespondParams<TContext = unknown, TData = unknown> extends Record<string, unknown> {
+    history: History;
+    step?: StepRef;
+    session?: SessionState<TData>;
+    contextOverride?: Partial<TContext>;
+    signal?: AbortSignal;
+}
+/**
+ * Options for the modern stream() method
+ */
+export interface StreamOptions<TContext = unknown> {
+    contextOverride?: Partial<TContext>;
+    signal?: AbortSignal;
+    history?: History;
+}
+/**
+ * Options for the modern generate() method
+ */
+export interface GenerateOptions<TContext = unknown> {
+    contextOverride?: Partial<TContext>;
+    signal?: AbortSignal;
+    history?: History;
+}
+/**
+ * Error details for response generation failures
+ */
+interface ResponseGenerationErrorDetails {
+    originalError?: unknown;
+    params?: Record<string, unknown>;
+    phase?: string;
+    context?: Record<string, unknown>;
+}
+/**
+ * Error class for response generation failures
+ */
+export declare class ResponseGenerationError extends Error {
+    readonly details?: ResponseGenerationErrorDetails | undefined;
+    constructor(message: string, details?: ResponseGenerationErrorDetails | undefined);
+    /**
+     * Create a ResponseGenerationError from an unknown error
+     */
+    static fromError(error: unknown, phase: string, params?: Record<string, unknown>, context?: Record<string, unknown>): ResponseGenerationError;
+    /**
+     * Check if an error is a ResponseGenerationError
+     */
+    static isResponseGenerationError(error: unknown): error is ResponseGenerationError;
+}
+/**
+ * ResponseModal class that encapsulates all response generation logic
+ * Uses unified approach for both streaming and non-streaming responses
+ */
+export declare class ResponseModal<TContext = unknown, TData = unknown> {
+    private readonly agent;
+    private readonly options?;
+    private readonly responseEngine;
+    private readonly responsePipeline;
+    constructor(agent: Agent<TContext, TData>, options?: ResponseModalOptions | undefined);
+    /**
+     * Generate a non-streaming response using unified logic
+     */
+    respond(params: RespondParams<TContext, TData>): Promise<AgentResponse<TData>>;
+    /**
+     * Generate a streaming response using unified logic
+     */
+    respondStream(params: RespondParams<TContext, TData>): AsyncGenerator<AgentResponseStreamChunk<TData>>;
+    /**
+     * Modern streaming API - simple interface like chat()
+     */
+    stream(message?: string, options?: StreamOptions<TContext>): AsyncGenerator<AgentResponseStreamChunk<TData>>;
+    /**
+     * Modern non-streaming API - equivalent to chat() but more explicit
+     */
+    generate(message?: string, options?: GenerateOptions<TContext>): Promise<AgentResponse<TData>>;
+    /**
+     * Get the response engine instance
+     * @internal
+     */
+    getResponseEngine(): ResponseEngine<TContext, TData>;
+    /**
+     * Get the response pipeline instance
+     * @internal
+     */
+    getResponsePipeline(): ResponsePipeline<TContext, TData>;
+    /**
+     * Get the ToolManager instance from the agent
+     * @private
+     */
+    private getToolManager;
+    /**
+     * Unified response preparation - handles context setup, session management, and routing
+     * This consolidates common logic between streaming and non-streaming responses
+     * @private
+     */
+    private prepareUnifiedResponseContext;
+    /**
+     * Unified routing and step selection logic using ResponsePipeline for optimization
+     * @private
+     */
+    private handleUnifiedRoutingAndStepSelection;
+    /**
+     * Check if a route should pre-extract data before determining the initial step
+     * @private
+     */
+    private shouldPreExtractData;
+    /**
+     * Pre-extract data from user message when entering a route
+     * This allows skipping steps whose data is already provided
+     * @private
+     */
+    private preExtractRouteData;
+    /**
+     * Unified response generation for non-streaming responses
+     * @private
+     */
+    private generateUnifiedResponse;
+    /**
+     * Unified streaming response generation
+     * @private
+     */
+    private generateUnifiedStreamingResponse;
+    /**
+       * Execute prepare function for current step if available
+       * @private
+       */
+    private executeStepPrepare;
+    /**
+     * Execute finalize function for current step if available
+     * @private
+     */
+    private executeStepFinalize;
+    /**
+     * Process route response with unified tool execution and data collection
+     * @private
+     */
+    private processRouteResponse;
+    /**
+     * Process route streaming response with unified tool execution and data collection
+     * @private
+     */
+    private processRouteStreamingResponse;
+    /**
+     * Unified tool execution logic with loop handling
+     * Consolidates the complex tool execution logic from both streaming and non-streaming responses
+     * @private
+     */
+    private executeUnifiedToolLoop; /**
+     * Unified data collection from AI response
+     * @private
+     */
+    private collectDataFromResponse;
+    /**
+     * Handle route completion logic
+     * @private
+     */
+    private handleRouteCompletion;
+    /**
+     * Stream route completion response
+     * @private
+     */
+    private streamRouteCompletion;
+    /**
+     * Generate fallback response when no routes are available
+     * @private
+     */
+    private generateFallbackResponse;
+    /**
+     * Stream fallback response when no routes are available
+     * @private
+     */
+    private streamFallbackResponse;
+    /**
+     * Handle session persistence and finalization
+     * @private
+     */
+    private finalizeSession;
+    /**
+     * Find an available tool by name for the given route using ToolManager
+     * Delegates to ToolManager for unified tool resolution
+     * @private
+     */
+    private findAvailableTool;
+    /**
+     * Collect all available tools for the given route and step context using ToolManager
+     * Delegates to ToolManager for unified tool resolution and deduplication
+     * @private
+     */
+    private collectAvailableTools;
+    /**
+     * Execute a prepare or finalize function/tool
+     * @private
+     */
+    private executePrepareFinalize;
+    /**
+     * Merge terms with route-specific taking precedence on conflicts
+     * @private
+     */
+    private mergeTerms;
+}
+export {};
+//# sourceMappingURL=ResponseModal.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ResponseModal.d.ts","sourceRoot":"","sources":["../../../src/core/ResponseModal.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EACR,aAAa,EACb,wBAAwB,EACxB,OAAO,EACP,YAAY,EACZ,OAAO,EAOV,MAAM,UAAU,CAAC;AAElB,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAGrC,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAMtD;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACjC,sEAAsE;IACtE,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,gEAAgE;IAChE,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,6CAA6C;IAC7C,SAAS,CAAC,EAAE,OAAO,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa,CAAC,QAAQ,GAAG,OAAO,EAAE,KAAK,GAAG,OAAO,CAAE,SAAQ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAC/F,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,OAAO,CAAC,EAAE,YAAY,CAAC,KAAK,CAAC,CAAC;IAC9B,eAAe,CAAC,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC;IACpC,MAAM,CAAC,EAAE,WAAW,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa,CAAC,QAAQ,GAAG,OAAO;IAC7C,eAAe,CAAC,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC;IACpC,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,OAAO,CAAC,EAAE,OAAO,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe,CAAC,QAAQ,GAAG,OAAO;IAC/C,eAAe,CAAC,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC;IACpC,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,OAAO,CAAC,EAAE,OAAO,CAAC;CACrB;AAED;;GAEG;AACH,UAAU,8BAA8B;IACpC,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACrC;AAED;;GAEG;AACH,qBAAa,uBAAwB,SAAQ,KAAK;aAG1B,OAAO,CAAC,EAAE,8BAA8B;gBADxD,OAAO,EAAE,MAAM,EACC,OAAO,CAAC,EAAE,8BAA8B,YAAA;IAW5D;;OAEG;IACH,MAAM,CAAC,SAAS,CACZ,KAAK,EAAE,OAAO,EACd,KAAK,EAAE,MAAM,EACb,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAClC,uBAAuB;IAQ1B;;OAEG;IACH,MAAM,CAAC,yBAAyB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,uBAAuB;CAGrF;AAeD;;;GAGG;AACH,qBAAa,aAAa,CAAC,QAAQ,GAAG,OAAO,EAAE,KAAK,GAAG,OAAO;IAKtD,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC;IAL7B,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAkC;IACjE,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAoC;gBAGhD,KAAK,EAAE,KAAK,CAAC,QAAQ,EAAE,KAAK,CAAC,EAC7B,OAAO,CAAC,EAAE,oBAAoB,YAAA;IAkBnD;;OAEG;IACG,OAAO,CAAC,MAAM,EAAE,aAAa,CAAC,QAAQ,EAAE,KAAK,CAAC,GAAG,OAAO,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC;IAoBpF;;OAEG;IACI,aAAa,CAAC,MAAM,EAAE,aAAa,CAAC,QAAQ,EAAE,KAAK,CAAC,GAAG,cAAc,CAAC,wBAAwB,CAAC,KAAK,CAAC,CAAC;IAuB7G;;OAEG;IACI,MAAM,CACT,OAAO,CAAC,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE,aAAa,CAAC,QAAQ,CAAC,GAClC,cAAc,CAAC,wBAAwB,CAAC,KAAK,CAAC,CAAC;IAgDlD;;OAEG;IACG,QAAQ,CACV,OAAO,CAAC,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE,eAAe,CAAC,QAAQ,CAAC,GACpC,OAAO,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC;IA8ChC;;;OAGG;IACH,iBAAiB,IAAI,cAAc,CAAC,QAAQ,EAAE,KAAK,CAAC;IAIpD;;;OAGG;IACH,mBAAmB,IAAI,gBAAgB,CAAC,QAAQ,EAAE,KAAK,CAAC;IAIxD;;;OAGG;IACH,OAAO,CAAC,cAAc;IActB;;;;OAIG;YACW,6BAA6B;IAqG3C;;;OAGG;YACW,oCAAoC;IAuFlD;;;OAGG;IACH,OAAO,CAAC,oBAAoB;IAkB5B;;;;OAIG;YACW,mBAAmB;IA+DjC;;;OAGG;YACW,uBAAuB;IA6ErC;;;OAGG;YACY,gCAAgC;IA2C/C;;;SAGK;YACS,kBAAkB;IAqBhC;;;OAGG;YACW,mBAAmB;IAuBjC;;;OAGG;YACW,oBAAoB;IA8HlC;;;OAGG;YACY,6BAA6B;IAkI5C;;;;OAIG;YACW,sBAAsB,EA0Q/B;;;OAGF;YACW,uBAAuB;IAsFrC;;;OAGG;YACW,qBAAqB;IA+GnC;;;OAGG;YACY,qBAAqB;IA0GpC;;;OAGG;YACW,wBAAwB;IAwCtC;;;OAGG;YACY,sBAAsB;IAqDrC;;;OAGG;YACW,eAAe;IA0B7B;;;;OAIG;IACH,OAAO,CAAC,iBAAiB;IA4BzB;;;;OAIG;IACH,OAAO,CAAC,qBAAqB;IAqF7B;;;OAGG;YACW,sBAAsB;IAiGpC;;;OAGG;IACH,OAAO,CAAC,UAAU;CAsBrB"}