@falai/agent 0.4.1 → 0.5.1

package/dist/core/PreparationEngine.js

@@ -1,349 +0,0 @@
-/**
- * PreparationEngine - Handles the preparation iteration loop
- *
- * This engine implements the core Parlant/Emcie architecture:
- * 1. Before generating a message, run preparation iterations
- * 2. Each iteration:
- *    - Match guidelines against current context
- *    - Walk the state machine and execute tool transitions
- *    - Execute tools when conditions are met
- *    - Update context from tool results
- *    - Check if prepared to respond
- * 3. After preparation, the AI generates the final message
- *
- * The AI NEVER sees tools - tools execute automatically based on:
- * - State machine transitions ({ toolState: tool })
- * - Guideline matching with associated tools
- */
-import { ConditionEvaluator } from "./ConditionEvaluator";
-export class PreparationEngine {
-    /**
-     * Run a list of async jobs with a concurrency limit, preserving order of results.
-     */
-    async processWithConcurrency(tasks, runner, concurrency) {
-        const results = new Array(tasks.length);
-        let nextIndex = 0;
-        const workers = [];
-        const runNext = async () => {
-            const current = nextIndex++;
-            if (current >= tasks.length) {
-                return;
-            }
-            try {
-                results[current] = await runner(tasks[current]);
-            }
-            finally {
-                await runNext();
-            }
-        };
-        const workerCount = Math.min(concurrency, tasks.length);
-        for (let i = 0; i < workerCount; i++) {
-            workers.push(runNext());
-        }
-        await Promise.all(workers);
-        return results;
-    }
-    constructor(ai, options) {
-        if (ai) {
-            this.conditionEvaluator = new ConditionEvaluator(ai);
-        }
-        this.maxParallelLlmCalls = options?.maxParallelLlmCalls ?? 4;
-        this.maxParallelTools = options?.maxParallelTools ?? 8;
-    }
-    /**
-     * Run preparation iterations before message generation
-     *
-     * This is the core engine that executes tools automatically
-     * based on state machine transitions and guideline matching.
-     */
-    async prepare(preparationContext) {
-        const iterations = [];
-        let currentContext = { ...preparationContext.context };
-        const allToolExecutions = [];
-        let preparedToRespond = false;
-        // Run preparation iterations
-        for (let i = 0; i < preparationContext.maxIterations && !preparedToRespond; i++) {
-            const iteration = await this.runIteration({
-                iterationNumber: i + 1,
-                history: preparationContext.history,
-                currentState: preparationContext.currentState,
-                context: currentContext,
-                routes: preparationContext.routes,
-                guidelines: preparationContext.guidelines,
-            });
-            iterations.push(iteration);
-            allToolExecutions.push(...iteration.executedTools);
-            // Update context from tool results
-            if (Object.keys(iteration.contextUpdates).length > 0) {
-                currentContext = {
-                    ...currentContext,
-                    ...iteration.contextUpdates,
-                };
-            }
-            // Check if we're prepared to respond
-            // We're prepared if:
-            // 1. No tools were executed in this iteration (nothing left to do)
-            // 2. OR we've reached max iterations
-            // 3. OR iteration explicitly set preparedToRespond to true
-            if (iteration.executedTools.length === 0 ||
-                i === preparationContext.maxIterations - 1 ||
-                iteration.preparedToRespond) {
-                preparedToRespond = true;
-            }
-        }
-        return {
-            iterations,
-            finalContext: currentContext,
-            toolExecutions: allToolExecutions,
-            preparedToRespond,
-        };
-    }
-    /**
-     * Run a single preparation iteration
-     */
-    async runIteration(params) {
-        const executedTools = [];
-        const contextUpdates = {};
-        const matchedGuidelines = [];
-        // Step 1: Match guidelines against current context
-        const matchedResults = await this.matchGuidelines(params.guidelines, params.context, params.history);
-        matchedGuidelines.push(...matchedResults);
-        // Step 2: Execute tools from matched guidelines
-        // Guidelines with associated tools should execute those tools
-        const guidelineToolCalls = [];
-        for (const match of matchedGuidelines) {
-            if (match.guideline.tools && match.guideline.tools.length > 0) {
-                for (const tool of match.guideline.tools) {
-                    const t = tool;
-                    guidelineToolCalls.push(() => this.executeTool(t, params.context, params.history));
-                }
-            }
-        }
-        if (guidelineToolCalls.length > 0) {
-            const results = await this.processWithConcurrency(guidelineToolCalls, (fn) => fn(), this.maxParallelTools);
-            for (const toolResult of results) {
-                if (toolResult) {
-                    executedTools.push(toolResult);
-                    if (toolResult.result && typeof toolResult.result === "object") {
-                        const result = toolResult.result;
-                        if (result.contextUpdate) {
-                            Object.assign(contextUpdates, result.contextUpdate);
-                        }
-                    }
-                }
-            }
-        }
-        // Step 3: Walk state machine and execute tool transitions
-        // Find current route and state, then execute any toolState transitions
-        if (params.currentState?.id) {
-            const currentRoute = params.routes.find((r) => r.id === params.currentState.routeId);
-            if (currentRoute) {
-                const toolResults = await this.executeStateToolTransitions(currentRoute, params.currentState, params.context, params.history);
-                executedTools.push(...toolResults);
-                // Update context from state tool results
-                for (const toolResult of toolResults) {
-                    if (toolResult.result && typeof toolResult.result === "object") {
-                        const result = toolResult.result;
-                        if (result.contextUpdate) {
-                            Object.assign(contextUpdates, result.contextUpdate);
-                        }
-                    }
-                }
-            }
-        }
-        return {
-            iterationNumber: params.iterationNumber,
-            matchedGuidelines,
-            executedTools,
-            contextUpdates,
-            preparedToRespond: false, // Will be determined by caller
-        };
-    }
-    /**
-     * Match guidelines against current context
-     *
-     * Evaluates guideline conditions against the current context and history
-     * using AI to determine relevance and priority
-     */
-    async matchGuidelines(guidelines, context, history) {
-        const alwaysMatches = guidelines.filter((g) => g.enabled !== false && !g.condition);
-        const conditional = guidelines.filter((g) => g.enabled !== false && g.condition);
-        const matches = alwaysMatches.map((guideline) => ({
-            guideline,
-            rationale: "Guideline has no condition - always active",
-        }));
-        if (!this.conditionEvaluator) {
-            // No AI available, match all enabled guidelines with conditions
-            for (const guideline of conditional) {
-                matches.push({
-                    guideline,
-                    rationale: "AI not available - defaulting to match",
-                });
-            }
-            return matches;
-        }
-        // Evaluate conditional guidelines with limited parallelism
-        const workers = conditional.map((guideline) => async () => {
-            const evaluation = await this.conditionEvaluator.evaluateGuidelineCondition(guideline, context, history);
-            if (evaluation.matches) {
-                return {
-                    guideline,
-                    rationale: evaluation.rationale || "Condition evaluated as true",
-                };
-            }
-            return null;
-        });
-        const evaluated = await this.processWithConcurrency(workers, (w) => w(), this.maxParallelLlmCalls);
-        for (const r of evaluated) {
-            if (r) {
-                matches.push(r);
-            }
-        }
-        return matches;
-    }
-    /**
-     * Execute a single tool
-     */
-    async executeTool(tool, context, history) {
-        try {
-            // Extract arguments from context and history
-            let args;
-            if (this.conditionEvaluator && tool.parameters) {
-                // Use AI-powered extraction if available
-                const extraction = await this.conditionEvaluator.extractToolArguments(tool, context, history);
-                args = extraction.arguments;
-            }
-            else {
-                // Fallback to simple extraction
-                args = this.conditionEvaluator
-                    ? this.conditionEvaluator.simpleArgumentExtraction(tool, context)
-                    : [];
-            }
-            // Execute the tool handler
-            const result = await tool.handler({
-                context,
-                history,
-                updateContext: async (_updates) => {
-                    // Context updates are handled separately in the preparation loop
-                    // This is a no-op placeholder
-                },
-            }, ...args);
-            return {
-                toolName: tool.name,
-                arguments: { args }, // Wrap array in object for logging
-                result,
-                success: true,
-            };
-        }
-        catch (error) {
-            console.error(`[PreparationEngine] Tool execution failed: ${tool.name}`, error);
-            return {
-                toolName: tool.name,
-                arguments: {},
-                result: null,
-                success: false,
-                error: error instanceof Error ? error.message : String(error),
-            };
-        }
-    }
-    /**
-     * Execute tool transitions in the state machine
-     *
-     * Walks through state transitions and executes tools when
-     * reaching a { toolState: tool } transition
-     */
-    async executeStateToolTransitions(route, currentStateRef, context, history) {
-        const executedTools = [];
-        // Get the current state from the route or use initial state
-        let stateToWalk;
-        try {
-            const foundState = route.getState(currentStateRef.id);
-            if (foundState) {
-                stateToWalk = foundState;
-            }
-            else {
-                stateToWalk = route.initialState;
-            }
-        }
-        catch {
-            // If any error occurs, fallback to initial state
-            stateToWalk = route.initialState;
-        }
-        // Walk the state machine starting from the determined state
-        const toolResults = await this.walkStateChain(stateToWalk, context, history, new Set() // Track visited states to prevent loops
-        );
-        executedTools.push(...toolResults);
-        return executedTools;
-    }
-    /**
-     * Walk through a chain of states, executing tools along the way
-     */
-    async walkStateChain(state, context, history, visited) {
-        const executedTools = [];
-        // Prevent infinite loops
-        if (visited.has(state.id)) {
-            return executedTools;
-        }
-        visited.add(state.id);
-        // Get all transitions from this state
-        const transitions = state.getTransitions();
-        // Process each transition
-        for (const transition of transitions) {
-            // Check if transition has a condition
-            if (transition.hasCondition()) {
-                // Evaluate condition
-                const shouldFollow = await this.evaluateTransitionCondition(transition, context, history);
-                if (!shouldFollow) {
-                    continue; // Skip this transition
-                }
-            }
-            // Check if this is a toolState transition
-            if (transition.spec.toolState) {
-                // Execute the tool
-                const toolResult = await this.executeTool(transition.spec.toolState, context, history);
-                if (toolResult) {
-                    executedTools.push(toolResult);
-                    // Update context with tool results for next transitions
-                    if (toolResult.result && typeof toolResult.result === "object") {
-                        const result = toolResult.result;
-                        if (result.contextUpdate) {
-                            context = {
-                                ...context,
-                                ...result.contextUpdate,
-                            };
-                        }
-                    }
-                }
-            }
-            // Get the target state and recursively walk it
-            const targetState = transition.getTarget();
-            if (targetState && !visited.has(targetState.id)) {
-                const childResults = await this.walkStateChain(targetState, context, history, visited);
-                executedTools.push(...childResults);
-            }
-        }
-        return executedTools;
-    }
-    /**
-     * Evaluate a transition condition
-     */
-    async evaluateTransitionCondition(transition, context, history) {
-        if (!transition.condition) {
-            return true; // No condition = always follow
-        }
-        // If no AI evaluator available, default to true
-        if (!this.conditionEvaluator) {
-            return true;
-        }
-        try {
-            const evaluation = await this.conditionEvaluator.evaluateTransitionCondition(transition.condition, context, history);
-            return evaluation.shouldFollow;
-        }
-        catch (error) {
-            console.error(`[PreparationEngine] Failed to evaluate transition condition`, error);
-            // On error, default to false (don't follow)
-            return false;
-        }
-    }
-}
-//# sourceMappingURL=PreparationEngine.js.map

package/dist/core/PreparationEngine.js.map

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

package/dist/core/PromptBuilder.d.ts

@@ -1,136 +0,0 @@
-/**
- * Prompt construction and management
- */
-import type { Event, EmittedEvent } from "../types/history";
-import type { Term, Capability, GuidelineMatch } from "../types/agent";
-import type { PromptSection, ContextVariableValue } from "../types/prompt";
-import { SectionStatus } from "../types/prompt";
-/**
- * Built-in section identifiers
- */
-export declare enum BuiltInSection {
-    AGENT_IDENTITY = "agent_identity",
-    CUSTOMER_IDENTITY = "customer_identity",
-    INTERACTION_HISTORY = "interaction_history",
-    CONTEXT_VARIABLES = "context_variables",
-    GLOSSARY = "glossary",
-    GUIDELINE_DESCRIPTIONS = "guideline_descriptions",
-    GUIDELINES = "guidelines",
-    STAGED_EVENTS = "staged_events",
-    ROUTES = "routes",
-    OBSERVATIONS = "observations",
-    CAPABILITIES = "capabilities",
-    ACTIVE_ROUTES = "active_routes",
-    DOMAINS = "domains"
-}
-/**
- * Customer/user information
- */
-export interface Customer {
-    name: string;
-    id?: string;
-}
-/**
- * Agent information for prompt building
- */
-export interface AgentInfo {
-    name: string;
-    description?: string;
-}
-/**
- * Builds prompts from composable sections
- */
-export declare class PromptBuilder {
-    private sections;
-    private onBuild?;
-    private cachedResults;
-    constructor(onBuild?: (prompt: string) => void);
-    /**
-     * Build the final prompt from all sections
-     */
-    build(): string;
-    /**
-     * Add a section to the prompt
-     */
-    addSection(name: string | BuiltInSection, template: string, props?: Record<string, unknown>, status?: SectionStatus): this;
-    /**
-     * Edit an existing section
-     */
-    editSection(name: string | BuiltInSection, editor: (section: PromptSection) => PromptSection): this;
-    /**
-     * Get section status
-     */
-    sectionStatus(name: string | BuiltInSection): SectionStatus;
-    /**
-     * Add agent identity section
-     */
-    addAgentIdentity(agent: AgentInfo): this;
-    /**
-     * Add customer identity section
-     */
-    addCustomerIdentity(customer: Customer): this;
-    /**
-     * Add interaction history section
-     */
-    addInteractionHistory(events: Event[], stagedEvents?: EmittedEvent[]): this;
-    /**
-     * Add interaction history with special handling for message generation
-     */
-    addInteractionHistoryForMessageGeneration(events: Event[], stagedEvents?: EmittedEvent[]): this;
-    /**
-     * Add context variables section
-     */
-    addContextVariables(variables: ContextVariableValue[]): this;
-    /**
-     * Add glossary section
-     */
-    addGlossary(terms: Term[]): this;
-    /**
-     * Add staged tool events section
-     */
-    addStagedToolEvents(events: EmittedEvent[]): this;
-    /**
-     * Add guidelines for message generation
-     */
-    addGuidelinesForMessageGeneration(guidelines: GuidelineMatch[]): this;
-    /**
-     * Add capabilities section for message generation
-     */
-    addCapabilitiesForMessageGeneration(capabilities: Capability[]): this;
-    /**
-     * Add observations for disambiguation
-     */
-    addObservations(observations: Array<{
-        description: string;
-        routes: Array<{
-            title: string;
-        }>;
-    }>): this;
-    /**
-     * Add active routes information
-     */
-    addActiveRoutes(routes: Array<{
-        title: string;
-        description?: string;
-        conditions: string[];
-        domains?: string[];
-        rules?: string[];
-        prohibitions?: string[];
-    }>): this;
-    /**
-     * Add domains (tools) information
-     */
-    addDomains(domains: Record<string, Record<string, unknown>>): this;
-    /**
-     * Add JSON response schema instructions
-     *
-     * NOTE: toolCalls are NOT included. Tools execute automatically based on
-     * state transitions and guideline matching, NOT based on AI decisions.
-     */
-    addJsonResponseSchema(): this;
-    private formatTemplate;
-    private gatherInteractionEvents;
-    private lastAgentMessageNote;
-    private contextVariablesToJson;
-}
-//# sourceMappingURL=PromptBuilder.d.ts.map

package/dist/core/PromptBuilder.d.ts.map

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