@goreal-ai/echo-pdk 0.1.0

package/dist/parser/ast.js

@@ -0,0 +1,260 @@
+/**
+ * @fileoverview AST Utilities - Node creation and traversal
+ *
+ * This file provides utility functions for working with the Echo AST.
+ * Includes factory functions for creating nodes and visitor pattern helpers.
+ *
+ * IMPLEMENTATION GUIDE:
+ *
+ * 1. NODE FACTORIES
+ *    Factory functions ensure consistent node creation with proper defaults.
+ *
+ * 2. VISITOR PATTERN
+ *    Implement a visitor for AST traversal. This is the primary way to:
+ *    - Collect AI judge conditions
+ *    - Evaluate nodes
+ *    - Transform the AST
+ *
+ * 3. AST UTILITIES
+ *    - Clone nodes (deep copy)
+ *    - Find nodes by type
+ *    - Pretty print for debugging
+ */
+// =============================================================================
+// NODE FACTORY FUNCTIONS
+// =============================================================================
+/**
+ * Create a TextNode.
+ */
+export function createTextNode(value, location) {
+    return {
+        type: 'text',
+        value,
+        location,
+    };
+}
+/**
+ * Create a VariableNode.
+ */
+export function createVariableNode(path, location, defaultValue) {
+    return {
+        type: 'variable',
+        path,
+        defaultValue,
+        location,
+    };
+}
+/**
+ * Create a ConditionalNode.
+ */
+export function createConditionalNode(condition, consequent, location, alternate) {
+    return {
+        type: 'conditional',
+        condition,
+        consequent,
+        alternate,
+        location,
+    };
+}
+/**
+ * Create a ConditionExpr.
+ */
+export function createConditionExpr(variable, operator, argument) {
+    return {
+        variable,
+        operator,
+        argument,
+        isAiJudge: operator === 'ai_judge',
+    };
+}
+/**
+ * Create a SectionNode.
+ */
+export function createSectionNode(name, body, location) {
+    return {
+        type: 'section',
+        name,
+        body,
+        location,
+    };
+}
+/**
+ * Create an ImportNode.
+ */
+export function createImportNode(path, location) {
+    return {
+        type: 'import',
+        path,
+        location,
+    };
+}
+/**
+ * Create an IncludeNode.
+ */
+export function createIncludeNode(name, location) {
+    return {
+        type: 'include',
+        name,
+        location,
+    };
+}
+/**
+ * Walk an AST node with a visitor.
+ *
+ * @param node - The AST node to visit
+ * @param visitor - The visitor implementation
+ * @returns The result from the visitor (if any)
+ */
+export function visitNode(node, visitor) {
+    switch (node.type) {
+        case 'text':
+            return visitor.visitText?.(node);
+        case 'variable':
+            return visitor.visitVariable?.(node);
+        case 'conditional':
+            return visitor.visitConditional?.(node);
+        case 'section':
+            return visitor.visitSection?.(node);
+        case 'import':
+            return visitor.visitImport?.(node);
+        case 'include':
+            return visitor.visitInclude?.(node);
+        default: {
+            // Exhaustiveness check
+            const _exhaustive = node;
+            throw new Error(`Unknown node type: ${_exhaustive.type}`);
+        }
+    }
+}
+/**
+ * Walk an array of AST nodes with a visitor.
+ *
+ * @param nodes - The AST nodes to visit
+ * @param visitor - The visitor implementation
+ * @returns Array of results from the visitor
+ */
+export function visitNodes(nodes, visitor) {
+    return nodes.map((node) => visitNode(node, visitor));
+}
+// =============================================================================
+// AST UTILITIES
+// =============================================================================
+/**
+ * Collect all AI judge conditions from an AST.
+ * This is used for parallel optimization.
+ *
+ * @param ast - The AST to search
+ * @returns Array of AI judge conditions with their locations
+ */
+export function collectAiJudgeConditions(ast) {
+    const results = [];
+    const visitor = {
+        visitConditional(node) {
+            // Check this node's condition
+            if (node.condition.isAiJudge) {
+                results.push({
+                    condition: node.condition,
+                    location: node.location,
+                });
+            }
+            // Recurse into children
+            visitNodes(node.consequent, visitor);
+            if (node.alternate) {
+                if (Array.isArray(node.alternate)) {
+                    visitNodes(node.alternate, visitor);
+                }
+                else {
+                    visitNode(node.alternate, visitor);
+                }
+            }
+        },
+        visitSection(node) {
+            visitNodes(node.body, visitor);
+        },
+    };
+    visitNodes(ast, visitor);
+    return results;
+}
+/**
+ * Deep clone an AST node.
+ *
+ * @param node - The node to clone
+ * @returns A deep copy of the node
+ */
+export function cloneNode(node) {
+    return JSON.parse(JSON.stringify(node));
+}
+/**
+ * Pretty print an AST for debugging.
+ *
+ * @param ast - The AST to print
+ * @param indent - Current indentation level
+ * @returns Formatted string representation
+ */
+export function prettyPrint(ast, indent = 0) {
+    const pad = '  '.repeat(indent);
+    const lines = [];
+    for (const node of ast) {
+        switch (node.type) {
+            case 'text':
+                lines.push(`${pad}TEXT: "${node.value.slice(0, 50)}..."`);
+                break;
+            case 'variable':
+                lines.push(`${pad}VAR: {{${node.path}}}${node.defaultValue ? ` ?? "${node.defaultValue}"` : ''}`);
+                break;
+            case 'conditional':
+                lines.push(`${pad}IF: {{${node.condition.variable}}} #${node.condition.operator}(${node.condition.argument ?? ''})`);
+                lines.push(prettyPrint(node.consequent, indent + 1));
+                if (node.alternate) {
+                    if (Array.isArray(node.alternate)) {
+                        lines.push(`${pad}ELSE:`);
+                        lines.push(prettyPrint(node.alternate, indent + 1));
+                    }
+                    else {
+                        lines.push(`${pad}ELSE IF:`);
+                        lines.push(prettyPrint([node.alternate], indent + 1));
+                    }
+                }
+                lines.push(`${pad}END IF`);
+                break;
+            case 'section':
+                lines.push(`${pad}SECTION: ${node.name}`);
+                lines.push(prettyPrint(node.body, indent + 1));
+                lines.push(`${pad}END SECTION`);
+                break;
+            case 'import':
+                lines.push(`${pad}IMPORT: ${node.path}`);
+                break;
+            case 'include':
+                lines.push(`${pad}INCLUDE: ${node.name}`);
+                break;
+        }
+    }
+    return lines.join('\n');
+}
+// =============================================================================
+// IMPLEMENTATION NOTES
+// =============================================================================
+/*
+NEXT STEPS TO IMPLEMENT:
+
+1. SOURCE LOCATION HELPERS
+   - mergeLocations(start, end) - Combine two locations
+   - formatLocation(loc) - Human-readable format
+
+2. AST TRANSFORMATION
+   - Implement a transformer pattern for modifying AST
+   - Useful for optimizations and plugin transforms
+
+3. VALIDATION HELPERS
+   - isValidVariablePath(path) - Check syntax of variable paths
+   - findUndefinedVariables(ast, context) - Find missing variables
+
+4. TESTS
+   Create ast.test.ts with tests for:
+   - Factory functions
+   - Visitor pattern
+   - AI judge collection
+   - Pretty printing
+*/
+//# sourceMappingURL=ast.js.map

package/dist/parser/ast.js.map

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

package/dist/parser/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * @fileoverview Parser module exports
+ */
+export { tokenize, EchoLexer } from './lexer.js';
+export { parse, getTokenLocation } from './parser.js';
+export { createTextNode, createVariableNode, createConditionalNode, createConditionExpr, createSectionNode, createImportNode, createIncludeNode, visitNode, visitNodes, collectAiJudgeConditions, cloneNode, prettyPrint, } from './ast.js';
+export type { ASTVisitor } from './ast.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/parser/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AACjD,OAAO,EAAE,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AACtD,OAAO,EAEL,cAAc,EACd,kBAAkB,EAClB,qBAAqB,EACrB,mBAAmB,EACnB,iBAAiB,EACjB,gBAAgB,EAChB,iBAAiB,EAEjB,SAAS,EACT,UAAU,EAEV,wBAAwB,EACxB,SAAS,EACT,WAAW,GACZ,MAAM,UAAU,CAAC;AAElB,YAAY,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC"}

package/dist/parser/index.js

@@ -0,0 +1,13 @@
+/**
+ * @fileoverview Parser module exports
+ */
+export { tokenize, EchoLexer } from './lexer.js';
+export { parse, getTokenLocation } from './parser.js';
+export { 
+// Node factories
+createTextNode, createVariableNode, createConditionalNode, createConditionExpr, createSectionNode, createImportNode, createIncludeNode, 
+// Visitor
+visitNode, visitNodes, 
+// Utilities
+collectAiJudgeConditions, cloneNode, prettyPrint, } from './ast.js';
+//# sourceMappingURL=index.js.map

package/dist/parser/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/parser/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AACjD,OAAO,EAAE,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AACtD,OAAO;AACL,iBAAiB;AACjB,cAAc,EACd,kBAAkB,EAClB,qBAAqB,EACrB,mBAAmB,EACnB,iBAAiB,EACjB,gBAAgB,EAChB,iBAAiB;AACjB,UAAU;AACV,SAAS,EACT,UAAU;AACV,YAAY;AACZ,wBAAwB,EACxB,SAAS,EACT,WAAW,GACZ,MAAM,UAAU,CAAC"}

package/dist/parser/lexer.d.ts

@@ -0,0 +1,199 @@
+/**
+ * @fileoverview Echo DSL Lexer - Multi-Mode Tokenization
+ *
+ * This file implements the lexer (tokenizer) for Echo DSL using Chevrotain.
+ * Uses multi-mode lexing to handle context-sensitive token recognition.
+ *
+ * LEXER MODES:
+ * - DEFAULT_MODE: Normal text content, looking for directives and variables
+ * - DIRECTIVE_MODE: Inside [#IF ...], [#SECTION ...], etc.
+ * - VARIABLE_MODE: Inside {{ ... }}
+ *
+ * TOKEN STREAM EXAMPLE:
+ *
+ * Input: "Hello {{name}}! [#IF {{age}} #gt(18)]Adult[END IF]"
+ *
+ * Tokens:
+ *   TEXT("Hello ")
+ *   VARIABLE_OPEN("{{")
+ *   IDENTIFIER("name")
+ *   VARIABLE_CLOSE("}}")
+ *   TEXT("! ")
+ *   IF_OPEN("[#IF")
+ *   VARIABLE_OPEN("{{")
+ *   IDENTIFIER("age")
+ *   VARIABLE_CLOSE("}}")
+ *   OPERATOR("#gt")
+ *   LPAREN("(")
+ *   NUMBER("18")
+ *   RPAREN(")")
+ *   CLOSE_BRACKET("]")
+ *   TEXT("Adult")
+ *   END_IF("[END IF]")
+ */
+import { Lexer, type TokenType } from 'chevrotain';
+/**
+ * Category for variable open tokens ({{)
+ */
+export declare const VariableOpen: TokenType;
+/**
+ * Category for variable close tokens (}})
+ */
+export declare const VariableClose: TokenType;
+/**
+ * [END IF] - End of conditional block
+ */
+export declare const EndIf: TokenType;
+/**
+ * [END SECTION] - End of section definition
+ */
+export declare const EndSection: TokenType;
+/**
+ * [ELSE] - Else branch (complete token)
+ */
+export declare const Else: TokenType;
+/**
+ * [#IF - Start of conditional (followed by condition)
+ */
+export declare const IfOpen: TokenType;
+/**
+ * [ELSE IF - Else-if branch (followed by condition)
+ */
+export declare const ElseIf: TokenType;
+/**
+ * [#SECTION - Section definition (followed by name="value")
+ */
+export declare const SectionOpen: TokenType;
+/**
+ * [#IMPORT - Import directive (followed by path)
+ */
+export declare const Import: TokenType;
+/**
+ * [#INCLUDE - Include directive (followed by section name)
+ */
+export declare const Include: TokenType;
+/**
+ * ] - End of directive (pops back to DEFAULT_MODE)
+ */
+export declare const CloseBracket: TokenType;
+/**
+ * Operator - #equals, #contains, #ai_judge, etc.
+ */
+export declare const Operator: TokenType;
+/**
+ * Identifier - variable names, section names, etc.
+ * Supports nested paths: user.name, items[0]
+ */
+export declare const Identifier: TokenType;
+/**
+ * String literal - "value" or 'value'
+ */
+export declare const StringLiteral: TokenType;
+/**
+ * Number literal - integers and decimals
+ */
+export declare const NumberLiteral: TokenType;
+/**
+ * ( - Left parenthesis for operator arguments
+ * Pushes to OPERATOR_ARG_MODE to capture free-form text
+ */
+export declare const LParen: TokenType;
+/**
+ * ) - Right parenthesis for operator arguments (in DIRECTIVE_MODE)
+ */
+export declare const RParen: TokenType;
+/**
+ * Operator argument text - captures everything until closing paren.
+ * This allows natural text like "My Girlfriend" without quotes.
+ */
+export declare const OperatorArgText: TokenType;
+/**
+ * , - Comma separator in argument lists
+ */
+export declare const Comma: TokenType;
+/**
+ * = - Equals sign for attribute assignment (name="value")
+ */
+export declare const Equals: TokenType;
+/**
+ * ?? - Default value operator
+ */
+export declare const DefaultOp: TokenType;
+/**
+ * Whitespace - skipped in directive and variable modes
+ */
+export declare const WhiteSpace: TokenType;
+/**
+ * Text - Plain text content.
+ *
+ * Matches any character sequence that doesn't start a special Echo construct.
+ * The lexer must stop when encountering:
+ * - `{{` (variable start)
+ * - `[#` (directive start: [#IF, [#SECTION, [#IMPORT, [#INCLUDE)
+ * - `[E` (branch/end markers: [ELSE], [ELSE IF, [END IF], [END SECTION])
+ *
+ * REGEX BREAKDOWN: /(?:[^\[{]|\[(?![#E])|\{(?!\{))+/
+ *
+ *   (?:                    Non-capturing group containing three alternatives:
+ *   │
+ *   ├─ [^\[{]              Alt 1: Any character EXCEPT '[' or '{'
+ *   │                            These are safe - no special meaning
+ *   │
+ *   ├─ \[(?![#E])          Alt 2: A '[' NOT followed by '#' or 'E'
+ *   │   │                        Allows: [x, [1, [anything-else
+ *   │   └─ (?![#E])              Negative lookahead excludes:
+ *   │                              - [# (directives like [#IF)
+ *   │                              - [E (branches like [ELSE], [END IF])
+ *   │
+ *   └─ \{(?!\{)            Alt 3: A '{' NOT followed by another '{'
+ *       │                        Allows: single { in text
+ *       └─ (?!\{)                Negative lookahead excludes:
+ *                                  - {{ (variable start)
+ *   )+                     One or more matches (greedy)
+ *
+ * EXAMPLES:
+ *   "Hello world"     → matches entirely (no special chars)
+ *   "Hello {{name}}"  → matches "Hello " then stops at {{
+ *   "Price: $[100]"   → matches entirely ([1 is not [# or [E)
+ *   "Use {braces}"    → matches entirely (single { is allowed)
+ *   "[#IF ..."        → matches nothing (starts with [#)
+ */
+export declare const Text: TokenType;
+/**
+ * All unique tokens (for parser configuration).
+ * Includes category tokens and all mode-specific variants.
+ *
+ * IMPORTANT: Category tokens must come BEFORE their child tokens
+ * in this array for Chevrotain to properly recognize them.
+ */
+export declare const allTokens: TokenType[];
+/**
+ * The Echo multi-mode lexer instance.
+ * Uses different token sets depending on the current lexing context.
+ */
+export declare const EchoLexer: Lexer;
+/**
+ * Tokenize an Echo template.
+ *
+ * @param template - The template string to tokenize
+ * @returns Lexer result with tokens and errors
+ *
+ * @example
+ * ```typescript
+ * const result = tokenize('Hello {{name}}!');
+ * if (result.errors.length > 0) {
+ *   console.error('Lexer errors:', result.errors);
+ * } else {
+ *   console.log('Tokens:', result.tokens);
+ * }
+ * ```
+ */
+export declare function tokenize(template: string): import("chevrotain").ILexingResult;
+/**
+ * Format lexer errors for display.
+ *
+ * @param errors - Lexer errors from tokenize()
+ * @returns Formatted error messages
+ */
+export declare function formatLexerErrors(errors: ReturnType<typeof tokenize>['errors']): string[];
+//# sourceMappingURL=lexer.d.ts.map

package/dist/parser/lexer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lexer.d.ts","sourceRoot":"","sources":["../../src/parser/lexer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AAEH,OAAO,EAEL,KAAK,EACL,KAAK,SAAS,EAEf,MAAM,YAAY,CAAC;AAYpB;;GAEG;AACH,eAAO,MAAM,YAAY,WAGvB,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,aAAa,WAGxB,CAAC;AAMH;;GAEG;AACH,eAAO,MAAM,KAAK,WAGhB,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,UAAU,WAGrB,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,IAAI,WAGf,CAAC;AAMH;;GAEG;AACH,eAAO,MAAM,MAAM,WAIjB,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,MAAM,WAIjB,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,WAAW,WAItB,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,MAAM,WAIjB,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,OAAO,WAIlB,CAAC;AAoDH;;GAEG;AACH,eAAO,MAAM,YAAY,WAIvB,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,QAAQ,WAGnB,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,UAAU,WAGrB,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,aAAa,WAGxB,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,aAAa,WAGxB,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,MAAM,WAIjB,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,MAAM,WAGjB,CAAC;AAYH;;;GAGG;AACH,eAAO,MAAM,eAAe,WAG1B,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,KAAK,WAGhB,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,MAAM,WAGjB,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,SAAS,WAGpB,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,UAAU,WAIrB,CAAC;AAMH;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,eAAO,MAAM,IAAI,WAIf,CAAC;AA2GH;;;;;;GAMG;AACH,eAAO,MAAM,SAAS,EAAE,SAAS,EA4ChC,CAAC;AAMF;;;GAGG;AACH,eAAO,MAAM,SAAS,OAMpB,CAAC;AAMH;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,QAAQ,CAAC,QAAQ,EAAE,MAAM,sCAExC;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,UAAU,CAAC,OAAO,QAAQ,CAAC,CAAC,QAAQ,CAAC,GAC5C,MAAM,EAAE,CAMV"}