@falai/agent 0.1.0-alpha2

package/dist/cjs/src/types/template.d.ts

@@ -0,0 +1,88 @@
+import type { SessionState } from "./session";
+import type { Event, MessageRole } from "./history";
+/**
+ * Context object passed to template functions for dynamic rendering.
+ */
+export interface TemplateContext<TContext = unknown, TData = unknown> {
+    /**
+     * The agent's static or dynamically-provided context.
+     */
+    context?: TContext;
+    /**
+     * The current session state, including collected data.
+     */
+    session?: SessionState<TData>;
+    /**
+     * The recent interaction history.
+     */
+    history?: Event[];
+    /**
+     * The data collected in the current route.
+     * A convenience alias for `session.data`.
+     */
+    data: Partial<TData>;
+    /**
+     * Helper methods for working with history and context.
+     */
+    helpers: {
+        /**
+         * Get the last message from history, optionally filtered by role.
+         * @param role - Optional role to filter by (user, assistant, etc.)
+         * @returns The message content or undefined if not found
+         */
+        getLastMessage(role?: MessageRole): string | undefined;
+        /**
+         * Get the last user message from history.
+         * @returns The user message content or undefined if not found
+         */
+        getLastUserMessage(): string | undefined;
+        /**
+         * Get the last assistant message from history.
+         * @returns The assistant message content or undefined if not found
+         */
+        getLastAssistantMessage(): string | undefined;
+        /**
+         * Get all messages from history, optionally filtered by role.
+         * @param role - Optional role to filter by
+         * @returns Array of message contents
+         */
+        getMessages(role?: MessageRole): string[];
+        /**
+         * Check if the last message contains any of the given keywords.
+         * @param keywords - Keywords to search for
+         * @param caseSensitive - Whether to perform case-sensitive search (default: false)
+         * @returns True if any keyword is found
+         */
+        lastMessageContains(keywords: string | string[], caseSensitive?: boolean): boolean;
+    };
+}
+/**
+ * Represents a string that can be either a literal or a function
+ * that dynamically generates a string from context.
+ */
+export type Template<TContext = unknown, TData = unknown> = string | ((params: TemplateContext<TContext, TData>) => string | Promise<string>);
+/**
+ * Represents a condition that can be used for routing decisions.
+ * Supports strings (AI context only), boolean functions (programmatic evaluation),
+ * and arrays of either for complex condition logic.
+ */
+export type ConditionTemplate<TContext = unknown, TData = unknown> = string | ((params: TemplateContext<TContext, TData>) => boolean | Promise<boolean>) | ConditionTemplate<TContext, TData>[];
+/**
+ * Result of condition evaluation containing both programmatic results
+ * and AI context strings.
+ */
+export interface ConditionEvaluationResult {
+    /** Result of function evaluations only */
+    programmaticResult: boolean;
+    /** String values for AI context */
+    aiContextStrings: string[];
+    /** Whether any functions were evaluated */
+    hasProgrammaticConditions: boolean;
+    /** Detailed evaluation information for debugging */
+    evaluationDetails?: {
+        condition: string;
+        result?: boolean;
+        type: 'string' | 'function' | 'array';
+    }[];
+}
+//# sourceMappingURL=template.d.ts.map

package/dist/cjs/src/types/template.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"template.d.ts","sourceRoot":"","sources":["../../../../src/types/template.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAC9C,OAAO,KAAK,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAEpD;;GAEG;AACH,MAAM,WAAW,eAAe,CAAC,QAAQ,GAAG,OAAO,EAAE,KAAK,GAAG,OAAO;IAClE;;OAEG;IACH,OAAO,CAAC,EAAE,QAAQ,CAAC;IAEnB;;OAEG;IACH,OAAO,CAAC,EAAE,YAAY,CAAC,KAAK,CAAC,CAAC;IAE9B;;OAEG;IACH,OAAO,CAAC,EAAE,KAAK,EAAE,CAAC;IAElB;;;OAGG;IACH,IAAI,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;IAErB;;OAEG;IACH,OAAO,EAAE;QACP;;;;WAIG;QACH,cAAc,CAAC,IAAI,CAAC,EAAE,WAAW,GAAG,MAAM,GAAG,SAAS,CAAC;QAEvD;;;WAGG;QACH,kBAAkB,IAAI,MAAM,GAAG,SAAS,CAAC;QAEzC;;;WAGG;QACH,uBAAuB,IAAI,MAAM,GAAG,SAAS,CAAC;QAE9C;;;;WAIG;QACH,WAAW,CAAC,IAAI,CAAC,EAAE,WAAW,GAAG,MAAM,EAAE,CAAC;QAE1C;;;;;WAKG;QACH,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE,EAAE,aAAa,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC;KACpF,CAAC;CACH;AAED;;;GAGG;AACH,MAAM,MAAM,QAAQ,CAAC,QAAQ,GAAG,OAAO,EAAE,KAAK,GAAG,OAAO,IACpD,MAAM,GACN,CAAC,CAAC,MAAM,EAAE,eAAe,CAAC,QAAQ,EAAE,KAAK,CAAC,KAAK,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC;AAE7E;;;;GAIG;AACH,MAAM,MAAM,iBAAiB,CAAC,QAAQ,GAAG,OAAO,EAAE,KAAK,GAAG,OAAO,IAC7D,MAAM,GACN,CAAC,CAAC,MAAM,EAAE,eAAe,CAAC,QAAQ,EAAE,KAAK,CAAC,KAAK,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC,GAC1E,iBAAiB,CAAC,QAAQ,EAAE,KAAK,CAAC,EAAE,CAAC;AAEzC;;;GAGG;AACH,MAAM,WAAW,yBAAyB;IACxC,0CAA0C;IAC1C,kBAAkB,EAAE,OAAO,CAAC;IAC5B,mCAAmC;IACnC,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B,2CAA2C;IAC3C,yBAAyB,EAAE,OAAO,CAAC;IACnC,oDAAoD;IACpD,iBAAiB,CAAC,EAAE;QAClB,SAAS,EAAE,MAAM,CAAC;QAClB,MAAM,CAAC,EAAE,OAAO,CAAC;QACjB,IAAI,EAAE,QAAQ,GAAG,UAAU,GAAG,OAAO,CAAC;KACvC,EAAE,CAAC;CACL"}

package/dist/cjs/src/types/template.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=template.js.map

package/dist/cjs/src/types/template.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"template.js","sourceRoot":"","sources":["../../../../src/types/template.ts"],"names":[],"mappings":""}

package/dist/cjs/src/types/tool.d.ts

@@ -0,0 +1,130 @@
+/**
+ * Tool system type definitions
+ */
+import type { Event, StepRef, ValidationResult } from "./index";
+/**
+ * Context provided to tool handlers
+ */
+export interface ToolContext<TContext = any, TData = any> {
+    /** The agent's context data */
+    context: TContext;
+    /** Complete agent-level data collected so far */
+    data: Partial<TData>;
+    /** Interaction history */
+    history: Event[];
+    /** Current step reference (if in a route) */
+    step?: StepRef;
+    /** Additional metadata */
+    metadata?: Record<string, unknown>;
+    /** Update the agent's context (triggers lifecycle hooks if configured) */
+    updateContext: (updates: Partial<TContext>) => Promise<void>;
+    /** Update the agent's collected data (triggers lifecycle hooks if configured) */
+    updateData: (updates: Partial<TData>) => Promise<void>;
+    /** Get a specific field from collected data */
+    getField<K extends keyof TData>(key: K): TData[K] | undefined;
+    /** Set a specific field in collected data */
+    setField<K extends keyof TData>(key: K, value: TData[K]): Promise<void>;
+    /** Check if a field exists in collected data */
+    hasField<K extends keyof TData>(key: K): boolean;
+}
+/**
+ * Result returned by a tool
+ */
+export interface ToolResult<TResultData = any, TContext = any, TData = any> {
+    /** The result data */
+    data?: TResultData;
+    /** Optional context update to be merged with current context */
+    contextUpdate?: Partial<TContext>;
+    /** Optional agent-level data update to be merged with collected data */
+    dataUpdate?: Partial<TData>;
+    /** Success indicator */
+    success?: boolean;
+    /** Error message if operation failed */
+    error?: string;
+    /** Optional metadata about the execution */
+    meta?: Record<string, unknown>;
+}
+/**
+ * Handler function for a tool
+ */
+export type ToolHandler<TContext = any, TData = any, TResult = any> = (context: ToolContext<TContext, TData>, args?: Record<string, unknown>) => Promise<TResult | ToolResult<TResult, TContext, TData>> | TResult | ToolResult<TResult, TContext, TData>;
+/**
+ * Tool definition - plain object interface
+ */
+export interface Tool<TContext = any, TData = any, TResult = any> {
+    /** Tool identifier */
+    id: string;
+    /** Tool display name (shown to AI models) */
+    name?: string;
+    /** Tool handler function */
+    handler: ToolHandler<TContext, TData, TResult>;
+    /** Description of what the tool does (for AI discovery) */
+    description?: string;
+    /** Parameter schema or description */
+    parameters?: unknown;
+}
+/**
+ * Tool execution result
+ */
+export interface ToolExecutionResult {
+    success: boolean;
+    data?: unknown;
+    error?: string;
+    contextUpdate?: Record<string, unknown>;
+    dataUpdate?: Record<string, unknown>;
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Tool scope enumeration
+ */
+export declare enum ToolScope {
+    AGENT = "agent",
+    ROUTE = "route",
+    STEP = "step",
+    REGISTERED = "registered",
+    ALL = "all"
+}
+/**
+ * Configuration for data enrichment tools
+ */
+export interface DataEnrichmentConfig<TContext, TData, TFields extends keyof TData> {
+    id: string;
+    name?: string;
+    description?: string;
+    fields: TFields[];
+    enricher: (context: TContext, data: Pick<TData, TFields>) => Promise<Partial<TData>> | Partial<TData>;
+}
+/**
+ * Configuration for validation tools
+ */
+export interface ValidationConfig<TContext, TData, TFields extends keyof TData> {
+    id: string;
+    name?: string;
+    description?: string;
+    fields: TFields[];
+    validator: (context: TContext, data: Pick<TData, TFields>) => Promise<ValidationResult> | ValidationResult;
+}
+/**
+ * Configuration for API call tools
+ */
+export interface ApiCallConfig<TContext, TData, TResult> {
+    id: string;
+    name?: string;
+    description?: string;
+    endpoint: string | ((context: TContext, data: Partial<TData>) => string);
+    method?: 'GET' | 'POST' | 'PUT' | 'DELETE';
+    headers?: Record<string, string> | ((context: TContext) => Record<string, string>);
+    body?: (context: TContext, data: Partial<TData>, args?: Record<string, unknown>) => unknown;
+    transform?: (response: unknown) => TResult;
+}
+/**
+ * Configuration for computation tools
+ */
+export interface ComputationConfig<TContext, TData, TResult> {
+    id: string;
+    name?: string;
+    description?: string;
+    inputs: (keyof TData)[];
+    compute: (context: TContext, inputs: Partial<TData>, args?: Record<string, unknown>) => Promise<TResult> | TResult;
+}
+//# sourceMappingURL=tool.d.ts.map

package/dist/cjs/src/types/tool.d.ts.map

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

package/dist/cjs/src/types/tool.js

@@ -0,0 +1,19 @@
+"use strict";
+/* eslint @typescript-eslint/no-explicit-any: "off"*/
+/**
+ * Tool system type definitions
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ToolScope = void 0;
+/**
+ * Tool scope enumeration
+ */
+var ToolScope;
+(function (ToolScope) {
+    ToolScope["AGENT"] = "agent";
+    ToolScope["ROUTE"] = "route";
+    ToolScope["STEP"] = "step";
+    ToolScope["REGISTERED"] = "registered";
+    ToolScope["ALL"] = "all";
+})(ToolScope || (exports.ToolScope = ToolScope = {}));
+//# sourceMappingURL=tool.js.map

package/dist/cjs/src/types/tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool.js","sourceRoot":"","sources":["../../../../src/types/tool.ts"],"names":[],"mappings":";AAAA,qDAAqD;AACrD;;GAEG;;;AAsGH;;GAEG;AACH,IAAY,SAMX;AAND,WAAY,SAAS;IACnB,4BAAe,CAAA;IACf,4BAAe,CAAA;IACf,0BAAa,CAAA;IACb,sCAAyB,CAAA;IACzB,wBAAW,CAAA;AACb,CAAC,EANW,SAAS,yBAAT,SAAS,QAMpB"}

package/dist/cjs/src/utils/clone.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Deep clone utility to avoid adding large dependencies like lodash.
+ * Handles objects, arrays, dates, and primitives.
+ * @param obj - The object to clone
+ * @returns A deep copy of the object
+ */
+export declare function cloneDeep<T>(obj: T): T;
+//# sourceMappingURL=clone.d.ts.map

package/dist/cjs/src/utils/clone.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"clone.d.ts","sourceRoot":"","sources":["../../../../src/utils/clone.ts"],"names":[],"mappings":"AACA;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,CA0BtC"}

package/dist/cjs/src/utils/clone.js

@@ -0,0 +1,32 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.cloneDeep = cloneDeep;
+/**
+ * Deep clone utility to avoid adding large dependencies like lodash.
+ * Handles objects, arrays, dates, and primitives.
+ * @param obj - The object to clone
+ * @returns A deep copy of the object
+ */
+function cloneDeep(obj) {
+    if (obj === null || typeof obj !== "object") {
+        return obj;
+    }
+    if (obj instanceof Date) {
+        return new Date(obj.getTime());
+    }
+    if (Array.isArray(obj)) {
+        const arrCopy = [];
+        for (let i = 0; i < obj.length; i++) {
+            arrCopy[i] = cloneDeep(obj[i]);
+        }
+        return arrCopy;
+    }
+    const objCopy = {};
+    for (const key in obj) {
+        if (Object.prototype.hasOwnProperty.call(obj, key)) {
+            objCopy[key] = cloneDeep(obj[key]);
+        }
+    }
+    return objCopy;
+}
+//# sourceMappingURL=clone.js.map

package/dist/cjs/src/utils/clone.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"clone.js","sourceRoot":"","sources":["../../../../src/utils/clone.ts"],"names":[],"mappings":";;AAOA,8BA0BC;AAhCD;;;;;GAKG;AACH,SAAgB,SAAS,CAAI,GAAM;IACjC,IAAI,GAAG,KAAK,IAAI,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;QAC5C,OAAO,GAAG,CAAC;IACb,CAAC;IAED,IAAI,GAAG,YAAY,IAAI,EAAE,CAAC;QACxB,OAAO,IAAI,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,CAAM,CAAC;IACtC,CAAC;IAED,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;QACvB,MAAM,OAAO,GAAc,EAAE,CAAC;QAC9B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,GAAG,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YAEpC,OAAO,CAAC,CAAC,CAAC,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;QACjC,CAAC;QACD,OAAO,OAAY,CAAC;IACtB,CAAC;IAED,MAAM,OAAO,GAA4B,EAAE,CAAC;IAC5C,KAAK,MAAM,GAAG,IAAI,GAAG,EAAE,CAAC;QACtB,IAAI,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,CAAC,EAAE,CAAC;YACnD,OAAO,CAAC,GAAG,CAAC,GAAG,SAAS,CAAE,GAA+B,CAAC,GAAG,CAAC,CAAC,CAAC;QAClE,CAAC;IACH,CAAC;IAED,OAAO,OAAY,CAAC;AACtB,CAAC"}

package/dist/cjs/src/utils/condition.d.ts

@@ -0,0 +1,38 @@
+import type { TemplateContext, ConditionTemplate, ConditionEvaluationResult } from "../types/template";
+/**
+ * Utility class for evaluating ConditionTemplate instances.
+ * Handles mixed string/function conditions and separates programmatic
+ * evaluation from AI context collection.
+ */
+export declare class ConditionEvaluator<TContext = unknown, TData = unknown> {
+    private templateContext;
+    constructor(templateContext: TemplateContext<TContext, TData>);
+    /**
+     * Evaluates a condition template and returns both programmatic results
+     * and AI context strings.
+     *
+     * @param condition The condition to evaluate
+     * @param logic Logic to apply for arrays ('AND' for when conditions, 'OR' for skipIf)
+     * @returns Evaluation result with programmatic result and AI context
+     */
+    evaluateCondition(condition: ConditionTemplate<TContext, TData>, logic?: 'AND' | 'OR'): Promise<ConditionEvaluationResult>;
+    /**
+     * Evaluates an array of conditions with the specified logic.
+     */
+    private evaluateArrayCondition;
+}
+/**
+ * Utility function to create a ConditionEvaluator instance.
+ * Ensures the template context has helpers included.
+ */
+export declare function createConditionEvaluator<TContext = unknown, TData = unknown>(templateContext: Omit<Partial<TemplateContext<TContext, TData>>, 'helpers'>): ConditionEvaluator<TContext, TData>;
+/**
+ * Utility function to extract AI context strings from a condition without evaluation.
+ * Useful for collecting context strings for prompt generation.
+ */
+export declare function extractAIContextStrings<TContext = unknown, TData = unknown>(condition: ConditionTemplate<TContext, TData>): string[];
+/**
+ * Utility function to check if a condition has any programmatic components.
+ */
+export declare function hasProgrammaticConditions<TContext = unknown, TData = unknown>(condition: ConditionTemplate<TContext, TData>): boolean;
+//# sourceMappingURL=condition.d.ts.map

package/dist/cjs/src/utils/condition.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"condition.d.ts","sourceRoot":"","sources":["../../../../src/utils/condition.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,iBAAiB,EAAE,yBAAyB,EAAE,MAAM,mBAAmB,CAAC;AAIvG;;;;GAIG;AACH,qBAAa,kBAAkB,CAAC,QAAQ,GAAG,OAAO,EAAE,KAAK,GAAG,OAAO;IACrD,OAAO,CAAC,eAAe;gBAAf,eAAe,EAAE,eAAe,CAAC,QAAQ,EAAE,KAAK,CAAC;IAErE;;;;;;;OAOG;IACG,iBAAiB,CACrB,SAAS,EAAE,iBAAiB,CAAC,QAAQ,EAAE,KAAK,CAAC,EAC7C,KAAK,GAAE,KAAK,GAAG,IAAY,GAC1B,OAAO,CAAC,yBAAyB,CAAC;IA4DrC;;OAEG;YACW,sBAAsB;CAkDrC;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,CAAC,QAAQ,GAAG,OAAO,EAAE,KAAK,GAAG,OAAO,EAC1E,eAAe,EAAE,IAAI,CAAC,OAAO,CAAC,eAAe,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC,EAAE,SAAS,CAAC,GAC1E,kBAAkB,CAAC,QAAQ,EAAE,KAAK,CAAC,CAGrC;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,QAAQ,GAAG,OAAO,EAAE,KAAK,GAAG,OAAO,EACzE,SAAS,EAAE,iBAAiB,CAAC,QAAQ,EAAE,KAAK,CAAC,GAC5C,MAAM,EAAE,CAiBV;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CAAC,QAAQ,GAAG,OAAO,EAAE,KAAK,GAAG,OAAO,EAC3E,SAAS,EAAE,iBAAiB,CAAC,QAAQ,EAAE,KAAK,CAAC,GAC5C,OAAO,CAUT"}

package/dist/cjs/src/utils/condition.js

@@ -0,0 +1,168 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ConditionEvaluator = void 0;
+exports.createConditionEvaluator = createConditionEvaluator;
+exports.extractAIContextStrings = extractAIContextStrings;
+exports.hasProgrammaticConditions = hasProgrammaticConditions;
+const template_1 = require("./template");
+const logger_1 = require("./logger");
+/**
+ * Utility class for evaluating ConditionTemplate instances.
+ * Handles mixed string/function conditions and separates programmatic
+ * evaluation from AI context collection.
+ */
+class ConditionEvaluator {
+    constructor(templateContext) {
+        this.templateContext = templateContext;
+    }
+    /**
+     * Evaluates a condition template and returns both programmatic results
+     * and AI context strings.
+     *
+     * @param condition The condition to evaluate
+     * @param logic Logic to apply for arrays ('AND' for when conditions, 'OR' for skipIf)
+     * @returns Evaluation result with programmatic result and AI context
+     */
+    async evaluateCondition(condition, logic = 'AND') {
+        const result = {
+            programmaticResult: logic === 'AND' ? true : false,
+            aiContextStrings: [],
+            hasProgrammaticConditions: false,
+            evaluationDetails: []
+        };
+        if (!condition) {
+            return result;
+        }
+        // Handle array conditions
+        if (Array.isArray(condition)) {
+            return this.evaluateArrayCondition(condition, logic);
+        }
+        // Handle string conditions (AI context only)
+        if (typeof condition === 'string') {
+            result.aiContextStrings.push(condition);
+            result.evaluationDetails?.push({
+                condition: condition,
+                type: 'string'
+            });
+            // For string conditions, programmatic result depends on logic:
+            // AND logic: true (doesn't affect result)
+            // OR logic: false (doesn't trigger skip)
+            result.programmaticResult = logic === 'AND' ? true : false;
+            return result;
+        }
+        // Handle function conditions (programmatic evaluation)
+        if (typeof condition === 'function') {
+            result.hasProgrammaticConditions = true;
+            try {
+                const functionResult = await condition(this.templateContext);
+                result.programmaticResult = Boolean(functionResult);
+                result.evaluationDetails?.push({
+                    condition: condition.toString(),
+                    result: result.programmaticResult,
+                    type: 'function'
+                });
+            }
+            catch (error) {
+                // Log error and default to false for safety
+                logger_1.logger.warn('Condition function evaluation failed:', error);
+                result.programmaticResult = false;
+                result.evaluationDetails?.push({
+                    condition: condition.toString(),
+                    result: false,
+                    type: 'function'
+                });
+            }
+            return result;
+        }
+        // Fallback for unexpected types
+        logger_1.logger.warn('Unexpected condition type:', typeof condition);
+        return result;
+    }
+    /**
+     * Evaluates an array of conditions with the specified logic.
+     */
+    async evaluateArrayCondition(conditions, logic) {
+        const result = {
+            programmaticResult: logic === 'AND' ? true : false,
+            aiContextStrings: [],
+            hasProgrammaticConditions: false,
+            evaluationDetails: [{
+                    condition: `Array[${conditions.length}]`,
+                    type: 'array'
+                }]
+        };
+        const functionResults = [];
+        for (const condition of conditions) {
+            const conditionResult = await this.evaluateCondition(condition, logic);
+            // Collect AI context strings
+            result.aiContextStrings.push(...conditionResult.aiContextStrings);
+            // Track if we have programmatic conditions
+            if (conditionResult.hasProgrammaticConditions) {
+                result.hasProgrammaticConditions = true;
+                functionResults.push(conditionResult.programmaticResult);
+            }
+            // Merge evaluation details
+            if (conditionResult.evaluationDetails) {
+                result.evaluationDetails?.push(...conditionResult.evaluationDetails);
+            }
+        }
+        // Apply logic to function results only
+        if (functionResults.length > 0) {
+            if (logic === 'AND') {
+                result.programmaticResult = functionResults.every(r => r);
+            }
+            else { // OR
+                result.programmaticResult = functionResults.some(r => r);
+            }
+        }
+        else {
+            // No programmatic conditions, result depends on logic:
+            // AND: true (no functions to fail)
+            // OR: false (no functions to succeed)
+            result.programmaticResult = logic === 'AND' ? true : false;
+        }
+        return result;
+    }
+}
+exports.ConditionEvaluator = ConditionEvaluator;
+/**
+ * Utility function to create a ConditionEvaluator instance.
+ * Ensures the template context has helpers included.
+ */
+function createConditionEvaluator(templateContext) {
+    const contextWithHelpers = (0, template_1.createTemplateContext)(templateContext);
+    return new ConditionEvaluator(contextWithHelpers);
+}
+/**
+ * Utility function to extract AI context strings from a condition without evaluation.
+ * Useful for collecting context strings for prompt generation.
+ */
+function extractAIContextStrings(condition) {
+    const contextStrings = [];
+    if (!condition) {
+        return contextStrings;
+    }
+    if (Array.isArray(condition)) {
+        for (const subCondition of condition) {
+            contextStrings.push(...extractAIContextStrings(subCondition));
+        }
+    }
+    else if (typeof condition === 'string') {
+        contextStrings.push(condition);
+    }
+    // Functions don't contribute to AI context
+    return contextStrings;
+}
+/**
+ * Utility function to check if a condition has any programmatic components.
+ */
+function hasProgrammaticConditions(condition) {
+    if (!condition) {
+        return false;
+    }
+    if (Array.isArray(condition)) {
+        return condition.some(subCondition => hasProgrammaticConditions(subCondition));
+    }
+    return typeof condition === 'function';
+}
+//# sourceMappingURL=condition.js.map

package/dist/cjs/src/utils/condition.js.map

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

package/dist/cjs/src/utils/event.d.ts

@@ -0,0 +1,6 @@
+import { type Event } from "../types";
+/**
+ * Helper to extract last message from history
+ */
+export declare function getLastMessageFromHistory(history: Event[]): string;
+//# sourceMappingURL=event.d.ts.map

package/dist/cjs/src/utils/event.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event.d.ts","sourceRoot":"","sources":["../../../../src/utils/event.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,KAAK,EAAa,MAAM,UAAU,CAAC;AACjD;;GAEG;AACH,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,KAAK,EAAE,GAAG,MAAM,CAWlE"}

package/dist/cjs/src/utils/event.js

@@ -0,0 +1,20 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getLastMessageFromHistory = getLastMessageFromHistory;
+const types_1 = require("../types");
+/**
+ * Helper to extract last message from history
+ */
+function getLastMessageFromHistory(history) {
+    for (let i = history.length - 1; i >= 0; i--) {
+        const event = history[i];
+        if (event.kind === types_1.EventKind.MESSAGE) {
+            if (!event.data || !("message" in event.data)) {
+                continue;
+            }
+            return event.data.message;
+        }
+    }
+    return "";
+}
+//# sourceMappingURL=event.js.map

package/dist/cjs/src/utils/event.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"event.js","sourceRoot":"","sources":["../../../../src/utils/event.ts"],"names":[],"mappings":";;AAIA,8DAWC;AAfD,oCAAiD;AACjD;;GAEG;AACH,SAAgB,yBAAyB,CAAC,OAAgB;IACxD,KAAK,IAAI,CAAC,GAAG,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;QAC7C,MAAM,KAAK,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;QACzB,IAAI,KAAK,CAAC,IAAI,KAAK,iBAAS,CAAC,OAAO,EAAE,CAAC;YACrC,IAAI,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC,CAAC,SAAS,IAAI,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;gBAC9C,SAAS;YACX,CAAC;YACD,OAAO,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC;QAC5B,CAAC;IACH,CAAC;IACD,OAAO,EAAE,CAAC;AACZ,CAAC"}

package/dist/cjs/src/utils/history.d.ts

@@ -0,0 +1,60 @@
+/**
+ * History normalization utilities
+ * Convert simplified history format to internal Event format
+ */
+import type { Event, MessageEventData, ToolEventData, StatusEventData } from "../types";
+import type { History, HistoryItem } from "../types/history";
+/**
+ * Convert a simplified history item to an internal Event
+ * @param item - The HistoryItem to convert
+ * @returns Event with proper type-safe structure
+ * @throws Error if the history item is malformed or has invalid data
+ */
+export declare function historyItemToEvent(item: HistoryItem): Event<MessageEventData | ToolEventData | StatusEventData>;
+/**
+ * Convert an array of HistoryItems to Events
+ * @param history - Array of HistoryItems to convert
+ * @returns Array of Events with proper type-safe structure
+ * @throws Error if any history item is malformed
+ */
+export declare function historyToEvents(history: History): Event<MessageEventData | ToolEventData | StatusEventData>[];
+/**
+ * Convert an Event back to a HistoryItem
+ * @param event - The Event to convert
+ * @returns HistoryItem with simplified structure
+ * @throws Error if the event is malformed or has invalid data
+ */
+export declare function eventToHistoryItem(event: Event): HistoryItem;
+/**
+ * Convert an array of Events back to HistoryItems
+ * @param events - Array of Events to convert
+ * @returns Array of HistoryItems with simplified structure
+ * @throws Error if any event is malformed
+ */
+export declare function eventsToHistory(events: Event[]): History;
+/**
+ * Normalize a simplified history array to internal Event array
+ * @deprecated Use historyToEvents instead
+ */
+export declare function normalizeHistory(history: History): Event[];
+/**
+ * Helper function to create a user message
+ */
+export declare function userMessage(content: string, name?: string): HistoryItem;
+/**
+ * Helper function to create an assistant message
+ */
+export declare function assistantMessage(content: string | null, toolCalls?: Array<{
+    id: string;
+    name: string;
+    arguments: Record<string, unknown>;
+}>): HistoryItem;
+/**
+ * Helper function to create a tool message
+ */
+export declare function toolMessage(toolCallId: string, name: string, content: unknown): HistoryItem;
+/**
+ * Helper function to create a system message
+ */
+export declare function systemMessage(content: string): HistoryItem;
+//# sourceMappingURL=history.d.ts.map

package/dist/cjs/src/utils/history.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"history.d.ts","sourceRoot":"","sources":["../../../../src/utils/history.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,gBAAgB,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAExF,OAAO,KAAK,EAAE,OAAO,EAAE,WAAW,EAA0D,MAAM,kBAAkB,CAAC;AAErH;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,WAAW,GAAG,KAAK,CAAC,gBAAgB,GAAG,aAAa,GAAG,eAAe,CAAC,CAgH/G;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,OAAO,GAAG,KAAK,CAAC,gBAAgB,GAAG,aAAa,GAAG,eAAe,CAAC,EAAE,CAY7G;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,KAAK,GAAG,WAAW,CAmF5D;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,KAAK,EAAE,GAAG,OAAO,CAYxD;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,OAAO,GAAG,KAAK,EAAE,CAE1D;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,WAAW,CAEvE;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,MAAM,GAAG,IAAI,EACtB,SAAS,CAAC,EAAE,KAAK,CAAC;IAChB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC,CAAC,GACD,WAAW,CAEb;AAED;;GAEG;AACH,wBAAgB,WAAW,CACzB,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,OAAO,GACf,WAAW,CAEb;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,WAAW,CAE1D"}