@falai/agent 0.9.0 → 1.0.0

package/dist/cjs/core/ResponseEngine.js

@@ -0,0 +1,202 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ResponseEngine = void 0;
+const PromptComposer_1 = require("./PromptComposer");
+const template_1 = require("../utils/template");
+class ResponseEngine {
+    responseSchemaForRoute(route, currentStep, agentSchema) {
+        const base = {
+            type: "object",
+            properties: {
+                message: { type: "string", description: "Final user-facing message" },
+            },
+            required: ["message"],
+            additionalProperties: false,
+        };
+        // Add data field only if route has responseOutputSchema
+        if (route.responseOutputSchema) {
+            base.properties.data = route.responseOutputSchema;
+        }
+        // Add collect fields from current step using agent-level schema
+        if (currentStep?.collect && agentSchema?.properties) {
+            for (const field of currentStep.collect) {
+                const fieldSchema = agentSchema.properties[field];
+                if (fieldSchema) {
+                    base.properties[field] = fieldSchema;
+                }
+            }
+        }
+        return base;
+    }
+    async buildResponsePrompt(params) {
+        const { route, currentStep, rules, prohibitions, directives, history, lastMessage, agentOptions, combinedGuidelines, combinedTerms, context, session, agentSchema, } = params;
+        const templateContext = (0, template_1.createTemplateContext)({ context, session, history });
+        const pc = new PromptComposer_1.PromptComposer(templateContext);
+        // Create combined agent options with route overrides
+        let effectiveAgentOptions = agentOptions;
+        if (agentOptions && (route.identity || route.personality)) {
+            // Route identity and personality override agent versions
+            effectiveAgentOptions = {
+                ...agentOptions,
+                ...(route.identity && { identity: route.identity }),
+                ...(route.personality && { personality: route.personality }),
+            };
+        }
+        if (effectiveAgentOptions) {
+            await pc.addAgentMeta(effectiveAgentOptions);
+        }
+        await pc.addInstruction(`Route: ${route.title}${route.description ? ` — ${route.description}` : ""}`);
+        if (currentStep.prompt) {
+            await pc.addInstruction(`Guideline for your response (adapt to the conversation):\n${await (0, template_1.render)(currentStep.prompt, templateContext)}`);
+        }
+        if (rules.length)
+            await pc.addInstruction(`Rules:\n- ${rules.join("\n- ")}`);
+        if (prohibitions.length)
+            await pc.addInstruction(`Prohibitions:\n- ${prohibitions.join("\n- ")}`);
+        await pc.addDirectives(directives);
+        await pc.addKnowledgeBase(agentOptions?.knowledgeBase, route.getKnowledgeBase());
+        // Add combined guidelines (agent + route)
+        if (combinedGuidelines && combinedGuidelines.length > 0) {
+            await pc.addGuidelines(combinedGuidelines);
+        }
+        // Add combined terms (agent + route)
+        if (combinedTerms && combinedTerms.length > 0) {
+            await pc.addGlossary(combinedTerms);
+        }
+        await pc.addInteractionHistory(history);
+        await pc.addLastMessage(lastMessage);
+        // Add data collection instructions - include ALL route fields, not just current step
+        if (agentSchema?.properties) {
+            // Collect all fields from route's required and optional fields
+            const allRouteFields = new Set();
+            // Add route required fields
+            if (route.requiredFields) {
+                route.requiredFields.forEach(field => allRouteFields.add(String(field)));
+            }
+            // Add route optional fields
+            if (route.optionalFields) {
+                route.optionalFields.forEach(field => allRouteFields.add(String(field)));
+            }
+            // Add current step's collect fields (in case they're not in route fields)
+            if (currentStep?.collect) {
+                currentStep.collect.forEach(field => allRouteFields.add(String(field)));
+            }
+            if (allRouteFields.size > 0) {
+                const stepCollectFields = new Set(currentStep?.collect?.map(f => String(f)) || []);
+                const fieldDescriptions = [];
+                for (const field of allRouteFields) {
+                    const fieldSchema = agentSchema.properties[field];
+                    if (fieldSchema) {
+                        const fieldName = field;
+                        const fieldDesc = fieldSchema.description || fieldName;
+                        const fieldType = Array.isArray(fieldSchema.type) ? fieldSchema.type[0] : fieldSchema.type;
+                        let fieldInfo = `  • ${fieldName} (${fieldType})`;
+                        // Add enum values if present
+                        if (fieldSchema.enum && Array.isArray(fieldSchema.enum)) {
+                            fieldInfo += ` [${fieldSchema.enum.join(' | ')}]`;
+                        }
+                        // Add description
+                        fieldInfo += `: ${fieldDesc}`;
+                        // Mark if this is the current step's focus
+                        if (stepCollectFields.has(field)) {
+                            fieldInfo += ` ← FOCUS FOR THIS STEP`;
+                        }
+                        fieldDescriptions.push(fieldInfo);
+                    }
+                }
+                if (fieldDescriptions.length > 0) {
+                    const instruction = [
+                        `## Data Collection Rules`,
+                        ``,
+                        `CRITICAL: You MUST extract ALL relevant information from the user's message, not just what this step asks for.`,
+                        ``,
+                        `Available fields to extract:`,
+                        ...fieldDescriptions,
+                        ``,
+                        `**How to collect data:**`,
+                        `1. Read the user's message carefully`,
+                        `2. Extract EVERY piece of information that matches ANY field above`,
+                        `3. Users often provide multiple details at once (e.g., "I need a checkup next Tuesday at 2 PM")`,
+                        `4. Include ALL extracted fields in your JSON response as top-level properties`,
+                        `5. Field names must match EXACTLY as shown above`,
+                        `6. Only include fields that the user actually mentioned`,
+                        ``,
+                        `**Example:** If user says "I need a checkup next Tuesday at 2 PM", extract:`,
+                        `- appointmentType: "checkup"`,
+                        `- preferredDate: "next Tuesday"`,
+                        `- preferredTime: "2 PM"`,
+                    ].join('\n');
+                    await pc.addInstruction(instruction);
+                }
+            }
+        }
+        // Add response format instructions with explicit JSON structure
+        // Generate example JSON based on actual schema fields
+        const exampleFields = ['  "message": "your response to the user"'];
+        if (agentSchema?.properties) {
+            // Collect all fields from route's required and optional fields
+            const allRouteFields = new Set();
+            if (route.requiredFields) {
+                route.requiredFields.forEach(field => allRouteFields.add(String(field)));
+            }
+            if (route.optionalFields) {
+                route.optionalFields.forEach(field => allRouteFields.add(String(field)));
+            }
+            if (currentStep?.collect) {
+                currentStep.collect.forEach(field => allRouteFields.add(String(field)));
+            }
+            // Generate example values for each field
+            for (const field of allRouteFields) {
+                const fieldSchema = agentSchema.properties[field];
+                if (fieldSchema) {
+                    const fieldType = Array.isArray(fieldSchema.type) ? fieldSchema.type[0] : fieldSchema.type;
+                    let exampleValue = '"value if extracted"';
+                    // Generate type-appropriate example
+                    if (fieldSchema.enum && Array.isArray(fieldSchema.enum) && fieldSchema.enum.length > 0) {
+                        exampleValue = `"${fieldSchema.enum[0]}"`;
+                    }
+                    else if (fieldType === 'string') {
+                        exampleValue = '"extracted value"';
+                    }
+                    else if (fieldType === 'number' || fieldType === 'integer') {
+                        exampleValue = '0';
+                    }
+                    else if (fieldType === 'boolean') {
+                        exampleValue = 'true';
+                    }
+                    exampleFields.push(`  "${field}": ${exampleValue}`);
+                }
+            }
+        }
+        await pc.addInstruction([
+            `## Response Format`,
+            ``,
+            `You MUST return ONLY valid JSON in this exact format:`,
+            `{`,
+            ...exampleFields.map((f, i) => i < exampleFields.length - 1 ? `${f},` : f),
+            `}`,
+            ``,
+            `CRITICAL RULES:`,
+            `- Return ONLY the JSON object, no other text`,
+            `- The "message" field is REQUIRED and must contain your response to the user`,
+            `- Include ALL extracted data fields as top-level properties`,
+            `- Only include data fields that were actually mentioned by the user`,
+            `- Do not wrap the JSON in markdown code blocks`,
+            `- Do not add any explanatory text before or after the JSON`,
+        ].join('\n'));
+        return pc.build();
+    }
+    async buildFallbackPrompt(params) {
+        const { history, agentOptions, terms, guidelines, context, session } = params;
+        const templateContext = (0, template_1.createTemplateContext)({ context, session, history });
+        const pc = new PromptComposer_1.PromptComposer(templateContext);
+        await pc.addAgentMeta(agentOptions);
+        await pc.addInteractionHistory(history);
+        await pc.addGlossary(terms);
+        await pc.addGuidelines(guidelines);
+        await pc.addKnowledgeBase(agentOptions.knowledgeBase);
+        return pc.build();
+    }
+}
+exports.ResponseEngine = ResponseEngine;
+//# sourceMappingURL=ResponseEngine.js.map

package/dist/cjs/core/ResponseEngine.js.map

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

package/dist/{src → cjs}/core/ResponseModal.d.ts

@@ -76,6 +76,8 @@ export declare class ResponseModal<TContext = unknown, TData = unknown> {
     private readonly options?;
     private readonly responseEngine;
     private readonly responsePipeline;
+    private readonly batchExecutor;
+    private readonly batchPromptBuilder;
     constructor(agent: Agent<TContext, TData>, options?: ResponseModalOptions | undefined);
     /**
      * Generate a non-streaming response using unified logic
@@ -103,6 +105,11 @@ export declare class ResponseModal<TContext = unknown, TData = unknown> {
      * @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
@@ -114,16 +121,59 @@ export declare class ResponseModal<TContext = unknown, TData = unknown> {
      * @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;
+    /**
+     * Execute a batch of steps with a single LLM call
+     *
+     * This method:
+     * 1. Executes all prepare hooks for steps in the batch (in order)
+     * 2. Builds a combined prompt using BatchPromptBuilder
+     * 3. Makes a single LLM call
+     * 4. Collects data from the response for all steps
+     * 5. Executes all finalize hooks for steps in the batch (in order)
+     *
+     * @private
+     * **Validates: Requirements 1.1, 4.4, 5.1, 5.2**
+     */
+    private executeBatchResponse;
+    /**
+     * Build response schema for batch execution
+     * @private
+     */
+    private buildBatchResponseSchema;
+    /**
+     * Collect available tools from all steps in the batch
+     * @private
+     */
+    private collectBatchAvailableTools;
     /**
      * Unified streaming response generation
      * @private
      */
     private generateUnifiedStreamingResponse;
+    /**
+     * Stream a batch response with multiple steps
+     *
+     * Similar to executeBatchResponse but streams the LLM response.
+     *
+     * @private
+     */
+    private streamBatchResponse;
     /**
        * Execute prepare function for current step if available
        * @private
@@ -180,13 +230,14 @@ export declare class ResponseModal<TContext = unknown, TData = unknown> {
      */
     private finalizeSession;
     /**
-     * Find an available tool by name for the given route
-     * Route-level tools take precedence over agent-level tools
+     * 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
+     * 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;

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

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