@falai/agent 0.3.25 → 0.4.0

package/dist/core/ConditionEvaluator.d.ts

@@ -0,0 +1,72 @@
+/**
+ * ConditionEvaluator - Handles AI-powered condition evaluation
+ *
+ * This class is responsible for:
+ * - Evaluating guideline conditions
+ * - Evaluating transition conditions
+ * - Extracting tool arguments from context and history
+ */
+import type { Event, AiProvider } from "../types/index";
+import type { Guideline } from "../types/agent";
+import type { ToolRef } from "../types/tool";
+/**
+ * Result of guideline condition evaluation
+ */
+export interface GuidelineEvaluationResult {
+    matches: boolean;
+    rationale?: string;
+}
+/**
+ * Result of transition condition evaluation
+ */
+export interface TransitionEvaluationResult {
+    shouldFollow: boolean;
+    rationale?: string;
+}
+/**
+ * Result of tool argument extraction
+ */
+export interface ArgumentExtractionResult {
+    arguments: unknown[];
+    rationale?: string;
+}
+/**
+ * ConditionEvaluator - Evaluates conditions using AI
+ */
+export declare class ConditionEvaluator<TContext = unknown> {
+    private readonly ai;
+    constructor(ai: AiProvider);
+    /**
+     * Evaluate a guideline condition against context and history
+     */
+    evaluateGuidelineCondition(guideline: Guideline, context: TContext, history: Event[]): Promise<GuidelineEvaluationResult>;
+    /**
+     * Evaluate a transition condition
+     */
+    evaluateTransitionCondition(condition: string, context: TContext, history: Event[]): Promise<TransitionEvaluationResult>;
+    /**
+     * Extract tool arguments from context and history
+     */
+    extractToolArguments(tool: ToolRef<TContext, unknown[], unknown>, context: TContext, history: Event[]): Promise<ArgumentExtractionResult>;
+    /**
+     * Simple argument extraction from context (fallback)
+     */
+    simpleArgumentExtraction(tool: ToolRef<TContext, unknown[], unknown>, context: TContext): unknown[];
+    /**
+     * Extract recent messages from history
+     */
+    private extractRecentMessages;
+    /**
+     * Parse guideline evaluation from text response (fallback)
+     */
+    private parseGuidelineResponse;
+    /**
+     * Parse transition evaluation from text response (fallback)
+     */
+    private parseTransitionResponse;
+    /**
+     * Parse argument extraction from text response (fallback)
+     */
+    private parseArgumentResponse;
+}
+//# sourceMappingURL=ConditionEvaluator.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ConditionEvaluator.d.ts","sourceRoot":"","sources":["../../src/core/ConditionEvaluator.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,UAAU,EAAoB,MAAM,gBAAgB,CAAC;AAE1E,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAE7C;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACxC,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,0BAA0B;IACzC,YAAY,EAAE,OAAO,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,SAAS,EAAE,OAAO,EAAE,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AA0BD;;GAEG;AACH,qBAAa,kBAAkB,CAAC,QAAQ,GAAG,OAAO;IACpC,OAAO,CAAC,QAAQ,CAAC,EAAE;gBAAF,EAAE,EAAE,UAAU;IAE3C;;OAEG;IACG,0BAA0B,CAC9B,SAAS,EAAE,SAAS,EACpB,OAAO,EAAE,QAAQ,EACjB,OAAO,EAAE,KAAK,EAAE,GACf,OAAO,CAAC,yBAAyB,CAAC;IA0DrC;;OAEG;IACG,2BAA2B,CAC/B,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,QAAQ,EACjB,OAAO,EAAE,KAAK,EAAE,GACf,OAAO,CAAC,0BAA0B,CAAC;IAyDtC;;OAEG;IACG,oBAAoB,CACxB,IAAI,EAAE,OAAO,CAAC,QAAQ,EAAE,OAAO,EAAE,EAAE,OAAO,CAAC,EAC3C,OAAO,EAAE,QAAQ,EACjB,OAAO,EAAE,KAAK,EAAE,GACf,OAAO,CAAC,wBAAwB,CAAC;IAiEpC;;OAEG;IACH,wBAAwB,CACtB,IAAI,EAAE,OAAO,CAAC,QAAQ,EAAE,OAAO,EAAE,EAAE,OAAO,CAAC,EAC3C,OAAO,EAAE,QAAQ,GAChB,OAAO,EAAE;IAgCZ;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAc7B;;OAEG;IACH,OAAO,CAAC,sBAAsB;IAW9B;;OAEG;IACH,OAAO,CAAC,uBAAuB;IAc/B;;OAEG;IACH,OAAO,CAAC,qBAAqB;CAsB9B"}

package/dist/core/ConditionEvaluator.js

@@ -0,0 +1,268 @@
+/**
+ * ConditionEvaluator - Handles AI-powered condition evaluation
+ *
+ * This class is responsible for:
+ * - Evaluating guideline conditions
+ * - Evaluating transition conditions
+ * - Extracting tool arguments from context and history
+ */
+import { EventKind } from "../types/history";
+/**
+ * ConditionEvaluator - Evaluates conditions using AI
+ */
+export class ConditionEvaluator {
+    constructor(ai) {
+        this.ai = ai;
+    }
+    /**
+     * Evaluate a guideline condition against context and history
+     */
+    async evaluateGuidelineCondition(guideline, context, history) {
+        try {
+            const recentMessages = this.extractRecentMessages(history);
+            const prompt = `You are evaluating whether a guideline condition is met.
+
+Guideline Condition: ${guideline.condition}
+Action: ${guideline.action}
+
+Current Context:
+${JSON.stringify(context, null, 2)}
+
+Recent Conversation:
+${recentMessages || "(No recent messages)"}
+
+Evaluate whether the guideline condition is currently met based on the context and conversation.
+
+Your response must be a JSON object with this exact structure:
+{
+  "matches": boolean (true or false),
+  "rationale": string (brief explanation)
+}`;
+            const result = await this.ai.generateMessage({
+                prompt,
+                history,
+                context,
+                parameters: {
+                    jsonMode: true,
+                    maxOutputTokens: 500,
+                },
+            });
+            // Parse structured response
+            if (result.structured) {
+                return {
+                    matches: result.structured.matches === true,
+                    rationale: result.structured.rationale,
+                };
+            }
+            // Fallback parsing
+            return this.parseGuidelineResponse(result.message);
+        }
+        catch (error) {
+            console.error(`[ConditionEvaluator] Failed to evaluate guideline condition: ${guideline.id}`, error);
+            return {
+                matches: false,
+                rationale: "Failed to evaluate condition",
+            };
+        }
+    }
+    /**
+     * Evaluate a transition condition
+     */
+    async evaluateTransitionCondition(condition, context, history) {
+        try {
+            const recentMessages = this.extractRecentMessages(history);
+            const prompt = `You are evaluating whether a state transition condition is met.
+
+Transition Condition: ${condition}
+
+Current Context:
+${JSON.stringify(context, null, 2)}
+
+Recent Conversation:
+${recentMessages || "(No recent messages)"}
+
+Evaluate whether this transition should be followed based on the condition, context, and conversation.
+
+Your response must be a JSON object with this exact structure:
+{
+  "shouldFollow": boolean (true or false),
+  "rationale": string (brief explanation)
+}`;
+            const result = await this.ai.generateMessage({
+                prompt,
+                history,
+                context,
+                parameters: {
+                    jsonMode: true,
+                    maxOutputTokens: 300,
+                },
+            });
+            // Parse structured response
+            if (result.structured) {
+                return {
+                    shouldFollow: result.structured.shouldFollow === true,
+                    rationale: result.structured.rationale,
+                };
+            }
+            // Fallback parsing
+            return this.parseTransitionResponse(result.message);
+        }
+        catch (error) {
+            console.error(`[ConditionEvaluator] Failed to evaluate transition condition`, error);
+            return {
+                shouldFollow: false,
+                rationale: "Failed to evaluate condition",
+            };
+        }
+    }
+    /**
+     * Extract tool arguments from context and history
+     */
+    async extractToolArguments(tool, context, history) {
+        try {
+            const recentMessages = this.extractRecentMessages(history);
+            const prompt = `You are extracting arguments for a tool call.
+
+Tool: ${tool.name}
+Description: ${tool.description || "No description"}
+Parameters: ${JSON.stringify(tool.parameters, null, 2)}
+
+Current Context:
+${JSON.stringify(context, null, 2)}
+
+Recent Conversation:
+${recentMessages || "(No recent messages)"}
+
+Extract the arguments needed to call this tool based on the context and conversation.
+If a parameter is not available, use null or a reasonable default value.
+
+Your response must be a JSON object with this exact structure:
+{
+  "arguments": [arg1, arg2, ...] (array of argument values),
+  "rationale": string (optional explanation)
+}`;
+            const result = await this.ai.generateMessage({
+                prompt,
+                history,
+                context,
+                parameters: {
+                    jsonMode: true,
+                    maxOutputTokens: 500,
+                },
+            });
+            // Parse structured response
+            if (result.structured) {
+                if (result.structured.arguments &&
+                    Array.isArray(result.structured.arguments)) {
+                    return {
+                        arguments: result.structured.arguments,
+                        rationale: result.structured.rationale,
+                    };
+                }
+            }
+            // Fallback: try to parse from message
+            return this.parseArgumentResponse(result.message);
+        }
+        catch (error) {
+            console.error(`[ConditionEvaluator] Failed to extract tool arguments: ${tool.name}`, error);
+            return {
+                arguments: [],
+                rationale: "Failed to extract arguments",
+            };
+        }
+    }
+    /**
+     * Simple argument extraction from context (fallback)
+     */
+    simpleArgumentExtraction(tool, context) {
+        const contextObj = context;
+        const args = [];
+        // If parameters is an object with properties, try to match context keys
+        if (tool.parameters &&
+            typeof tool.parameters === "object" &&
+            !Array.isArray(tool.parameters)) {
+            const params = tool.parameters;
+            // Try to match parameter names with context keys
+            for (const [paramName, paramDef] of Object.entries(params)) {
+                if (contextObj[paramName] !== undefined) {
+                    args.push(contextObj[paramName]);
+                }
+                else if (typeof paramDef === "object" &&
+                    paramDef !== null &&
+                    "default" in paramDef &&
+                    typeof paramDef.default !== "undefined") {
+                    args.push(paramDef.default);
+                }
+            }
+        }
+        return args;
+    }
+    // Private helper methods
+    /**
+     * Extract recent messages from history
+     */
+    extractRecentMessages(history, count = 5) {
+        return history
+            .slice(-count)
+            .map((event) => {
+            if (event.kind === EventKind.MESSAGE) {
+                const data = event.data;
+                return `${data.participant.display_name}: ${data.message}`;
+            }
+            return null;
+        })
+            .filter((msg) => msg !== null)
+            .join("\n");
+    }
+    /**
+     * Parse guideline evaluation from text response (fallback)
+     */
+    parseGuidelineResponse(message) {
+        const lowerMessage = message.toLowerCase();
+        const matches = lowerMessage.includes("true") || lowerMessage.includes('"matches": true');
+        return {
+            matches,
+            rationale: matches ? "Parsed from text response" : "Condition not met",
+        };
+    }
+    /**
+     * Parse transition evaluation from text response (fallback)
+     */
+    parseTransitionResponse(message) {
+        const lowerMessage = message.toLowerCase();
+        const shouldFollow = lowerMessage.includes("true") ||
+            lowerMessage.includes('"shouldfollow": true');
+        return {
+            shouldFollow,
+            rationale: shouldFollow
+                ? "Parsed from text response"
+                : "Condition not met",
+        };
+    }
+    /**
+     * Parse argument extraction from text response (fallback)
+     */
+    parseArgumentResponse(message) {
+        try {
+            // Try to extract JSON from the message
+            const jsonMatch = message.match(/\{[\s\S]*\}/);
+            if (jsonMatch) {
+                const parsed = JSON.parse(jsonMatch[0]);
+                if (parsed.arguments && Array.isArray(parsed.arguments)) {
+                    return {
+                        arguments: parsed.arguments,
+                        rationale: parsed.rationale,
+                    };
+                }
+            }
+        }
+        catch {
+            // Ignore parse errors
+        }
+        return {
+            arguments: [],
+            rationale: "Failed to parse arguments from response",
+        };
+    }
+}
+//# sourceMappingURL=ConditionEvaluator.js.map

package/dist/core/ConditionEvaluator.js.map

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

package/dist/core/PreparationEngine.d.ts

@@ -0,0 +1,105 @@
+/**
+ * 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 type { Event, StateRef, AiProvider } from "../types/index";
+import type { Guideline, GuidelineMatch } from "../types/agent";
+import type { Route } from "./Route";
+/**
+ * Tool execution result
+ */
+export interface ToolExecutionResult {
+    toolName: string;
+    arguments: Record<string, unknown>;
+    result: unknown;
+    success: boolean;
+    error?: string;
+}
+/**
+ * Preparation iteration state
+ */
+export interface IterationState {
+    iterationNumber: number;
+    matchedGuidelines: GuidelineMatch[];
+    executedTools: ToolExecutionResult[];
+    contextUpdates: Record<string, unknown>;
+    preparedToRespond: boolean;
+}
+/**
+ * Preparation context
+ */
+export interface PreparationContext<TContext = unknown> {
+    history: Event[];
+    currentState?: StateRef;
+    context: TContext;
+    routes: Route<TContext>[];
+    guidelines: Guideline[];
+    maxIterations: number;
+}
+/**
+ * Preparation result
+ */
+export interface PreparationResult<TContext = unknown> {
+    iterations: IterationState[];
+    finalContext: TContext;
+    toolExecutions: ToolExecutionResult[];
+    preparedToRespond: boolean;
+}
+/**
+ * PreparationEngine - Executes the preparation iteration loop
+ */
+export declare class PreparationEngine<TContext = unknown> {
+    private readonly conditionEvaluator?;
+    constructor(ai?: AiProvider);
+    /**
+     * Run preparation iterations before message generation
+     *
+     * This is the core engine that executes tools automatically
+     * based on state machine transitions and guideline matching.
+     */
+    prepare(preparationContext: PreparationContext<TContext>): Promise<PreparationResult<TContext>>;
+    /**
+     * Run a single preparation iteration
+     */
+    private runIteration;
+    /**
+     * Match guidelines against current context
+     *
+     * Evaluates guideline conditions against the current context and history
+     * using AI to determine relevance and priority
+     */
+    private matchGuidelines;
+    /**
+     * Execute a single tool
+     */
+    private executeTool;
+    /**
+     * Execute tool transitions in the state machine
+     *
+     * Walks through state transitions and executes tools when
+     * reaching a { toolState: tool } transition
+     */
+    private executeStateToolTransitions;
+    /**
+     * Walk through a chain of states, executing tools along the way
+     */
+    private walkStateChain;
+    /**
+     * Evaluate a transition condition
+     */
+    private evaluateTransitionCondition;
+}
+//# sourceMappingURL=PreparationEngine.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"PreparationEngine.d.ts","sourceRoot":"","sources":["../../src/core/PreparationEngine.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAClE,OAAO,KAAK,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAEhE,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAIrC;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,MAAM,EAAE,OAAO,CAAC;IAChB,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,eAAe,EAAE,MAAM,CAAC;IACxB,iBAAiB,EAAE,cAAc,EAAE,CAAC;IACpC,aAAa,EAAE,mBAAmB,EAAE,CAAC;IACrC,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACxC,iBAAiB,EAAE,OAAO,CAAC;CAC5B;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB,CAAC,QAAQ,GAAG,OAAO;IACpD,OAAO,EAAE,KAAK,EAAE,CAAC;IACjB,YAAY,CAAC,EAAE,QAAQ,CAAC;IACxB,OAAO,EAAE,QAAQ,CAAC;IAClB,MAAM,EAAE,KAAK,CAAC,QAAQ,CAAC,EAAE,CAAC;IAC1B,UAAU,EAAE,SAAS,EAAE,CAAC;IACxB,aAAa,EAAE,MAAM,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB,CAAC,QAAQ,GAAG,OAAO;IACnD,UAAU,EAAE,cAAc,EAAE,CAAC;IAC7B,YAAY,EAAE,QAAQ,CAAC;IACvB,cAAc,EAAE,mBAAmB,EAAE,CAAC;IACtC,iBAAiB,EAAE,OAAO,CAAC;CAC5B;AAED;;GAEG;AACH,qBAAa,iBAAiB,CAAC,QAAQ,GAAG,OAAO;IAC/C,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAC,CAA+B;gBAEvD,EAAE,CAAC,EAAE,UAAU;IAM3B;;;;;OAKG;IACG,OAAO,CACX,kBAAkB,EAAE,kBAAkB,CAAC,QAAQ,CAAC,GAC/C,OAAO,CAAC,iBAAiB,CAAC,QAAQ,CAAC,CAAC;IAsDvC;;OAEG;YACW,YAAY;IAkF1B;;;;;OAKG;YACW,eAAe;IAkD7B;;OAEG;YACW,WAAW;IA0DzB;;;;;OAKG;YACW,2BAA2B;IAoCzC;;OAEG;YACW,cAAc;IA0E5B;;OAEG;YACW,2BAA2B;CAgC1C"}