@goreal-ai/echo-pdk 0.1.0

package/dist/evaluator/evaluator.js

@@ -0,0 +1,407 @@
+/**
+ * @fileoverview Echo Evaluator - Condition evaluation engine
+ *
+ * This file implements the evaluator for Echo DSL.
+ * The evaluator processes the AST and determines which nodes should be rendered
+ * based on the provided context and condition evaluation.
+ *
+ * KEY OPTIMIZATION: AI JUDGE PARALLELIZATION
+ * Before evaluating the AST, we:
+ * 1. Collect ALL #ai_judge conditions from the tree
+ * 2. Evaluate them in parallel using Promise.all
+ * 3. Cache the results
+ * 4. Use cached results during tree evaluation
+ *
+ * This prevents sequential blocking on AI calls.
+ */
+import { collectAiJudgeConditions } from '../parser/ast.js';
+import { getOperator } from './operators.js';
+/**
+ * Resolve a variable path from context.
+ *
+ * Supports:
+ * - Simple: "name" -> context.name
+ * - Nested: "user.name" -> context.user.name
+ * - Array: "items[0]" -> context.items[0]
+ * - Mixed: "users[0].name" -> context.users[0].name
+ *
+ * @param path - The variable path
+ * @param context - The context object
+ * @param options - Resolution options
+ * @returns The resolved value or undefined
+ *
+ * @example
+ * ```typescript
+ * const context = { user: { name: 'Alice' }, items: [1, 2, 3] };
+ * resolveVariable('user.name', context); // 'Alice'
+ * resolveVariable('items[0]', context);  // 1
+ * ```
+ */
+export function resolveVariable(path, context, options = {}) {
+    const { strict = false } = options;
+    // Handle array access within parts: "items[0].name" -> ["items[0]", "name"]
+    // Then further split "items[0]" into array access
+    const parts = path.split('.');
+    let current = context;
+    for (const part of parts) {
+        if (current === undefined || current === null) {
+            return undefined;
+        }
+        // Validate array access patterns before splitting
+        // This catches malformed patterns like items[], items[abc], items[-1]
+        if (strict) {
+            validateArrayAccessPattern(part, path);
+        }
+        // Check for array access pattern: "items[0]" or "items[0][1]"
+        const segments = part.split(/(\[\d+\])/g).filter(Boolean);
+        for (const segment of segments) {
+            if (current === undefined || current === null) {
+                return undefined;
+            }
+            const arrayMatch = segment.match(/^\[(\d+)\]$/);
+            if (arrayMatch && arrayMatch[1]) {
+                // Array index access
+                const index = parseInt(arrayMatch[1], 10);
+                if (Array.isArray(current)) {
+                    current = current[index];
+                }
+                else {
+                    if (strict) {
+                        throw new Error(`Cannot access index [${index}] on non-array value in path "${path}"`);
+                    }
+                    return undefined;
+                }
+            }
+            else {
+                // Property access
+                current = current[segment];
+            }
+        }
+    }
+    return current;
+}
+/**
+ * Validate array access patterns in a path segment.
+ * Throws descriptive errors for malformed patterns in strict mode.
+ *
+ * @param segment - A single path segment (e.g., "items[0]" or "name")
+ * @param fullPath - The full path for error messages
+ */
+function validateArrayAccessPattern(segment, fullPath) {
+    // Find all bracket patterns in the segment
+    const bracketPattern = /\[([^\]]*)\]/g;
+    let match;
+    while ((match = bracketPattern.exec(segment)) !== null) {
+        const bracketContent = match[1] ?? '';
+        // Empty brackets: items[]
+        if (bracketContent === '') {
+            throw new Error(`Invalid array access "[]" in path "${fullPath}". Array index must be a non-negative integer.`);
+        }
+        // Non-numeric content: items[abc]
+        if (!/^\d+$/.test(bracketContent)) {
+            // Check for negative index
+            if (/^-\d+$/.test(bracketContent)) {
+                throw new Error(`Invalid array access "[${bracketContent}]" in path "${fullPath}". Negative indices are not supported.`);
+            }
+            throw new Error(`Invalid array access "[${bracketContent}]" in path "${fullPath}". Array index must be a non-negative integer.`);
+        }
+    }
+    // Check for unclosed brackets: items[0
+    const openBrackets = (segment.match(/\[/g) || []).length;
+    const closeBrackets = (segment.match(/\]/g) || []).length;
+    if (openBrackets !== closeBrackets) {
+        throw new Error(`Malformed array access in path "${fullPath}". Unclosed or unmatched brackets.`);
+    }
+}
+// =============================================================================
+// CONDITION EVALUATION
+// =============================================================================
+/**
+ * Evaluate a condition expression.
+ *
+ * @param condition - The condition to evaluate
+ * @param ctx - The evaluation context
+ * @returns true if condition is satisfied
+ */
+export async function evaluateCondition(condition, ctx) {
+    // Get the variable value
+    const value = resolveVariable(condition.variable, ctx.variables, {
+        strict: ctx.config.strict,
+    });
+    // Check for pre-resolved AI judge result
+    if (condition.isAiJudge) {
+        const cacheKey = createAiJudgeCacheKey(condition.variable, value, condition.argument);
+        const cached = ctx.aiJudgeResults.get(cacheKey);
+        if (cached !== undefined) {
+            return cached;
+        }
+        // Fall through to operator evaluation if not cached
+    }
+    // Get the operator (strip # if present)
+    const operatorName = condition.operator.replace(/^#/, '');
+    const operator = ctx.operators.get(operatorName) ?? getOperator(operatorName);
+    if (!operator) {
+        // Unknown operator - treat as false in lenient mode, throw in strict
+        if (ctx.config.strict) {
+            throw new Error(`Unknown operator: #${operatorName}`);
+        }
+        return false;
+    }
+    // Evaluate the operator
+    try {
+        const result = await operator.handler(value, condition.argument);
+        return result;
+    }
+    catch (error) {
+        if (ctx.config.strict) {
+            throw error;
+        }
+        // Lenient mode: treat errors as false
+        return false;
+    }
+}
+/**
+ * Create a cache key for AI judge results.
+ */
+function createAiJudgeCacheKey(variable, value, argument) {
+    return JSON.stringify({ variable, value, argument });
+}
+// =============================================================================
+// AI JUDGE PARALLEL EVALUATION
+// =============================================================================
+/**
+ * Pre-evaluate all AI judge conditions in parallel.
+ *
+ * This is the key optimization for performance.
+ * Call this before evaluating the AST to pre-resolve all AI conditions.
+ *
+ * @param ast - The AST to scan for AI judges
+ * @param ctx - The evaluation context (will be mutated with results)
+ */
+export async function preEvaluateAiJudges(ast, ctx) {
+    // Collect all AI judge conditions
+    const aiJudges = collectAiJudgeConditions(ast);
+    if (aiJudges.length === 0) {
+        return;
+    }
+    // Prepare evaluation promises
+    const evaluations = aiJudges.map(async ({ condition }) => {
+        const value = resolveVariable(condition.variable, ctx.variables, {
+            strict: ctx.config.strict,
+        });
+        const cacheKey = createAiJudgeCacheKey(condition.variable, value, condition.argument);
+        // Skip if already cached
+        if (ctx.aiJudgeResults.has(cacheKey)) {
+            return;
+        }
+        // Evaluate using the AI judge operator
+        const operator = ctx.operators.get('ai_judge') ?? getOperator('ai_judge');
+        if (!operator) {
+            throw new Error('AI Judge operator not available');
+        }
+        try {
+            const result = await operator.handler(value, condition.argument);
+            ctx.aiJudgeResults.set(cacheKey, result);
+        }
+        catch (error) {
+            // Handle AI evaluation error
+            if (ctx.config.strict) {
+                throw error;
+            }
+            // Lenient: default to false
+            ctx.aiJudgeResults.set(cacheKey, false);
+        }
+    });
+    // Evaluate all in parallel
+    await Promise.all(evaluations);
+}
+// =============================================================================
+// AST EVALUATION
+// =============================================================================
+/**
+ * Evaluate a conditional node and determine which branch to render.
+ *
+ * @param node - The conditional node
+ * @param ctx - The evaluation context
+ * @returns The nodes to render (empty if condition is false with no else)
+ */
+export async function evaluateConditional(node, ctx) {
+    // Evaluate the main condition
+    const conditionResult = await evaluateCondition(node.condition, ctx);
+    if (conditionResult) {
+        return node.consequent;
+    }
+    // Check alternate (ELSE IF or ELSE)
+    if (node.alternate) {
+        if (Array.isArray(node.alternate)) {
+            // ELSE branch
+            return node.alternate;
+        }
+        else {
+            // ELSE IF branch (recursive)
+            return evaluateConditional(node.alternate, ctx);
+        }
+    }
+    // No matching branch
+    return [];
+}
+/**
+ * Evaluate a single AST node.
+ *
+ * @param node - The node to evaluate
+ * @param ctx - The evaluation context
+ * @returns Array of nodes to render (may be empty, one, or many)
+ */
+async function evaluateNode(node, ctx) {
+    switch (node.type) {
+        case 'text':
+            // Text nodes pass through unchanged
+            return [node];
+        case 'variable':
+            // Variable nodes pass through unchanged (resolved during rendering)
+            return [node];
+        case 'conditional': {
+            // Evaluate condition and get selected branch
+            const branchNodes = await evaluateConditional(node, ctx);
+            // Recursively evaluate the selected branch
+            return evaluateNodes(branchNodes, ctx);
+        }
+        case 'section': {
+            // Store section in context for later [#INCLUDE] references
+            ctx.sections.set(node.name, node.body);
+            // Sections are not rendered inline
+            return [];
+        }
+        case 'import':
+            // Import handling: In a full implementation, we would:
+            // 1. Read the imported file
+            // 2. Parse it
+            // 3. Evaluate and inline the result
+            // For now, we pass through and let the renderer warn
+            return [node];
+        case 'include': {
+            // Include handling: inline the section content
+            const includeNode = node;
+            const sectionContent = ctx.sections.get(includeNode.name);
+            if (sectionContent) {
+                // Recursively evaluate the section content
+                return evaluateNodes(sectionContent, ctx);
+            }
+            // Section not found - pass through and let renderer warn
+            if (ctx.config.strict) {
+                throw new Error(`Section not found: ${includeNode.name}`);
+            }
+            return [];
+        }
+        default: {
+            // Exhaustiveness check
+            const _exhaustive = node;
+            throw new Error(`Unknown node type: ${_exhaustive.type}`);
+        }
+    }
+}
+/**
+ * Evaluate an array of AST nodes.
+ *
+ * @param nodes - The nodes to evaluate
+ * @param ctx - The evaluation context
+ * @returns Flattened array of nodes to render
+ */
+async function evaluateNodes(nodes, ctx) {
+    const results = [];
+    for (const node of nodes) {
+        const evaluated = await evaluateNode(node, ctx);
+        results.push(...evaluated);
+    }
+    return results;
+}
+// =============================================================================
+// SECTION COLLECTION (First Pass)
+// =============================================================================
+/**
+ * Collect all section definitions from the AST.
+ * This is a first pass to ensure sections are available before includes.
+ *
+ * @param nodes - The AST nodes to scan
+ * @param sections - Map to store section definitions
+ */
+function collectSections(nodes, sections) {
+    for (const node of nodes) {
+        if (node.type === 'section') {
+            const sectionNode = node;
+            sections.set(sectionNode.name, sectionNode.body);
+            // Also scan inside the section for nested sections
+            collectSections(sectionNode.body, sections);
+        }
+        else if (node.type === 'conditional') {
+            const conditionalNode = node;
+            collectSections(conditionalNode.consequent, sections);
+            if (conditionalNode.alternate) {
+                if (Array.isArray(conditionalNode.alternate)) {
+                    collectSections(conditionalNode.alternate, sections);
+                }
+                else {
+                    collectSections([conditionalNode.alternate], sections);
+                }
+            }
+        }
+    }
+}
+// =============================================================================
+// MAIN EVALUATE FUNCTION
+// =============================================================================
+/**
+ * Evaluate an AST with the given context.
+ *
+ * This is the main entry point for AST evaluation. It:
+ * 1. Collects section definitions (first pass)
+ * 2. Pre-evaluates AI judge conditions in parallel
+ * 3. Evaluates the AST and selects conditional branches
+ * 4. Returns a flattened AST ready for rendering
+ *
+ * @param ast - The AST to evaluate
+ * @param context - Variable context
+ * @param config - Echo configuration
+ * @param operators - Custom operators (from plugins)
+ * @returns Evaluated AST and section map
+ *
+ * @example
+ * ```typescript
+ * const result = await evaluate(ast, { name: 'Alice', age: 25 });
+ * console.log(result.ast); // Flattened, evaluated AST
+ * ```
+ */
+export async function evaluate(ast, context, config = {}, operators = new Map()) {
+    // Create evaluation context
+    const ctx = {
+        variables: context,
+        aiJudgeResults: new Map(),
+        config,
+        sections: new Map(),
+        operators,
+    };
+    // First pass: collect all section definitions
+    collectSections(ast, ctx.sections);
+    // Pre-evaluate AI judges in parallel (optimization!)
+    await preEvaluateAiJudges(ast, ctx);
+    // Second pass: evaluate the AST
+    const evaluatedAst = await evaluateNodes(ast, ctx);
+    return { ast: evaluatedAst, sections: ctx.sections };
+}
+/**
+ * Create an evaluation context manually.
+ * Useful for advanced use cases where you need more control.
+ *
+ * @param options - Context options
+ * @returns A new EvaluationContext
+ */
+export function createEvaluationContext(options) {
+    return {
+        variables: options.variables,
+        aiJudgeResults: new Map(),
+        config: options.config ?? {},
+        sections: new Map(),
+        operators: options.operators ?? new Map(),
+    };
+}
+//# sourceMappingURL=evaluator.js.map

package/dist/evaluator/evaluator.js.map

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

package/dist/evaluator/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * @fileoverview Evaluator module exports
+ */
+export { evaluate, evaluateCondition, evaluateConditional, resolveVariable, preEvaluateAiJudges, createEvaluationContext, } from './evaluator.js';
+export type { EvaluationContext, EvaluatedNode } from './evaluator.js';
+export { builtinOperators, getOperator, isAsyncOperator, equalsOperator, containsOperator, existsOperator, matchesOperator, gtOperator, gteOperator, ltOperator, lteOperator, inOperator, aiJudgeOperator, } from './operators.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/evaluator/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/evaluator/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EACL,QAAQ,EACR,iBAAiB,EACjB,mBAAmB,EACnB,eAAe,EACf,mBAAmB,EACnB,uBAAuB,GACxB,MAAM,gBAAgB,CAAC;AAExB,YAAY,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAEvE,OAAO,EACL,gBAAgB,EAChB,WAAW,EACX,eAAe,EAEf,cAAc,EACd,gBAAgB,EAChB,cAAc,EACd,eAAe,EACf,UAAU,EACV,WAAW,EACX,UAAU,EACV,WAAW,EACX,UAAU,EACV,eAAe,GAChB,MAAM,gBAAgB,CAAC"}

package/dist/evaluator/index.js

@@ -0,0 +1,8 @@
+/**
+ * @fileoverview Evaluator module exports
+ */
+export { evaluate, evaluateCondition, evaluateConditional, resolveVariable, preEvaluateAiJudges, createEvaluationContext, } from './evaluator.js';
+export { builtinOperators, getOperator, isAsyncOperator, 
+// Individual operators for testing
+equalsOperator, containsOperator, existsOperator, matchesOperator, gtOperator, gteOperator, ltOperator, lteOperator, inOperator, aiJudgeOperator, } from './operators.js';
+//# sourceMappingURL=index.js.map

package/dist/evaluator/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/evaluator/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EACL,QAAQ,EACR,iBAAiB,EACjB,mBAAmB,EACnB,eAAe,EACf,mBAAmB,EACnB,uBAAuB,GACxB,MAAM,gBAAgB,CAAC;AAIxB,OAAO,EACL,gBAAgB,EAChB,WAAW,EACX,eAAe;AACf,mCAAmC;AACnC,cAAc,EACd,gBAAgB,EAChB,cAAc,EACd,eAAe,EACf,UAAU,EACV,WAAW,EACX,UAAU,EACV,WAAW,EACX,UAAU,EACV,eAAe,GAChB,MAAM,gBAAgB,CAAC"}

package/dist/evaluator/operators.d.ts

@@ -0,0 +1,105 @@
+/**
+ * @fileoverview Built-in Operators for Echo DSL
+ *
+ * This file implements all built-in operators for the Echo DSL.
+ * Operators are used in conditions: [#IF {{var}} #operator(arg)]
+ *
+ * IMPLEMENTATION GUIDE:
+ *
+ * Each operator is a function that:
+ * - Takes a value (the variable being tested)
+ * - Takes an optional argument (the operator parameter)
+ * - Returns a boolean (or Promise<boolean> for async operators)
+ *
+ * BUILT-IN OPERATORS:
+ * - #equals(value)     - Exact equality
+ * - #contains(value)   - String/array contains
+ * - #exists            - Value is defined and not empty
+ * - #matches(regex)    - Regex pattern match
+ * - #gt(n), #lt(n)     - Greater than, less than
+ * - #gte(n), #lte(n)   - Greater/less than or equal
+ * - #in(a,b,c)         - Value is in list
+ * - #ai_judge(question) - LLM-evaluated condition
+ */
+import type { OperatorDefinition } from '../types.js';
+/**
+ * #equals - Exact equality check
+ *
+ * @example {{genre}} #equals(Horror)
+ */
+export declare const equalsOperator: OperatorDefinition;
+/**
+ * #contains - Check if string/array contains a value
+ *
+ * @example {{companions}} #contains(Shimon)
+ */
+export declare const containsOperator: OperatorDefinition;
+/**
+ * #exists - Check if value is defined and not empty
+ *
+ * @example {{user.preferences}} #exists
+ */
+export declare const existsOperator: OperatorDefinition;
+/**
+ * #matches - Regex pattern match
+ *
+ * @example {{email}} #matches(.*@.*)
+ */
+export declare const matchesOperator: OperatorDefinition;
+/**
+ * #greater_than - Greater than (alias: #gt)
+ *
+ * @example {{age}} #greater_than(18)
+ */
+export declare const gtOperator: OperatorDefinition;
+/**
+ * #greater_than_or_equal - Greater than or equal (alias: #gte)
+ */
+export declare const gteOperator: OperatorDefinition;
+/**
+ * #less_than - Less than (alias: #lt)
+ */
+export declare const ltOperator: OperatorDefinition;
+/**
+ * #less_than_or_equal - Less than or equal (alias: #lte)
+ */
+export declare const lteOperator: OperatorDefinition;
+/**
+ * #one_of - Check if value is in a list (alias: #in)
+ *
+ * @example {{status}} #one_of(active,pending,completed)
+ */
+export declare const inOperator: OperatorDefinition;
+/**
+ * #ai_judge - LLM-evaluated boolean condition
+ *
+ * This operator queries an LLM to evaluate a boolean condition.
+ * It's async and results are cached for performance.
+ *
+ * @example {{content}} #ai_judge(Is this appropriate for children?)
+ */
+export declare const aiJudgeOperator: OperatorDefinition;
+/**
+ * All built-in operators.
+ *
+ * Operators have readable names for low-coders and short aliases for developers.
+ * Both forms work identically:
+ *   - #greater_than(10) or #gt(10)
+ *   - #one_of(a,b,c) or #in(a,b,c)
+ */
+export declare const builtinOperators: Record<string, OperatorDefinition>;
+/**
+ * Get an operator by name.
+ *
+ * @param name - The operator name (without #)
+ * @returns The operator definition or undefined
+ */
+export declare function getOperator(name: string): OperatorDefinition | undefined;
+/**
+ * Check if an operator is async (AI-based).
+ *
+ * @param name - The operator name
+ * @returns true if the operator is async
+ */
+export declare function isAsyncOperator(name: string): boolean;
+//# sourceMappingURL=operators.d.ts.map

package/dist/evaluator/operators.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"operators.d.ts","sourceRoot":"","sources":["../../src/evaluator/operators.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAMtD;;;;GAIG;AACH,eAAO,MAAM,cAAc,EAAE,kBAgB5B,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,gBAAgB,EAAE,kBAsB9B,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,cAAc,EAAE,kBAe5B,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,eAAe,EAAE,kBAoB7B,CAAC;AAMF;;;;GAIG;AACH,eAAO,MAAM,UAAU,EAAE,kBAexB,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,WAAW,EAAE,kBAezB,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,UAAU,EAAE,kBAexB,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,WAAW,EAAE,kBAezB,CAAC;AAMF;;;;GAIG;AACH,eAAO,MAAM,UAAU,EAAE,kBAuBxB,CAAC;AAMF;;;;;;;GAOG;AACH,eAAO,MAAM,eAAe,EAAE,kBA+B7B,CAAC;AAMF;;;;;;;GAOG;AACH,eAAO,MAAM,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAmB/D,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,kBAAkB,GAAG,SAAS,CAExE;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAGrD"}