@goreal-ai/echo-pdk 0.1.0

package/dist/evaluator/operators.js

@@ -0,0 +1,371 @@
+/**
+ * @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
+ */
+// =============================================================================
+// COMPARISON OPERATORS
+// =============================================================================
+/**
+ * #equals - Exact equality check
+ *
+ * @example {{genre}} #equals(Horror)
+ */
+export const equalsOperator = {
+    type: 'comparison',
+    description: 'Exact equality check',
+    example: '{{genre}} #equals(Horror)',
+    autocomplete: {
+        trigger: '#eq',
+        snippet: '#equals($1)',
+    },
+    handler: (value, argument) => {
+        // Handle string comparison (case-insensitive by default)
+        if (typeof value === 'string' && typeof argument === 'string') {
+            return value.toLowerCase() === argument.toLowerCase();
+        }
+        // Strict equality for other types
+        return value === argument;
+    },
+};
+/**
+ * #contains - Check if string/array contains a value
+ *
+ * @example {{companions}} #contains(Shimon)
+ */
+export const containsOperator = {
+    type: 'comparison',
+    description: 'Check if string or array contains value',
+    example: '{{companions}} #contains(Shimon)',
+    autocomplete: {
+        trigger: '#con',
+        snippet: '#contains($1)',
+    },
+    handler: (value, argument) => {
+        if (typeof value === 'string' && typeof argument === 'string') {
+            return value.toLowerCase().includes(argument.toLowerCase());
+        }
+        if (Array.isArray(value)) {
+            return value.some((item) => {
+                if (typeof item === 'string' && typeof argument === 'string') {
+                    return item.toLowerCase() === argument.toLowerCase();
+                }
+                return item === argument;
+            });
+        }
+        return false;
+    },
+};
+/**
+ * #exists - Check if value is defined and not empty
+ *
+ * @example {{user.preferences}} #exists
+ */
+export const existsOperator = {
+    type: 'unary',
+    description: 'Check if variable is defined and not empty',
+    example: '{{user.preferences}} #exists',
+    autocomplete: {
+        trigger: '#ex',
+        snippet: '#exists',
+    },
+    handler: (value) => {
+        if (value === undefined || value === null)
+            return false;
+        if (typeof value === 'string')
+            return value.length > 0;
+        if (Array.isArray(value))
+            return value.length > 0;
+        if (typeof value === 'object')
+            return Object.keys(value).length > 0;
+        return true;
+    },
+};
+/**
+ * #matches - Regex pattern match
+ *
+ * @example {{email}} #matches(.*@.*)
+ */
+export const matchesOperator = {
+    type: 'comparison',
+    description: 'Regex pattern matching',
+    example: '{{email}} #matches(.*@.*)',
+    autocomplete: {
+        trigger: '#mat',
+        snippet: '#matches($1)',
+    },
+    handler: (value, pattern) => {
+        if (typeof value !== 'string' || typeof pattern !== 'string') {
+            return false;
+        }
+        try {
+            const regex = new RegExp(pattern);
+            return regex.test(value);
+        }
+        catch {
+            // Invalid regex pattern
+            return false;
+        }
+    },
+};
+// =============================================================================
+// NUMERIC OPERATORS
+// =============================================================================
+/**
+ * #greater_than - Greater than (alias: #gt)
+ *
+ * @example {{age}} #greater_than(18)
+ */
+export const gtOperator = {
+    type: 'comparison',
+    description: 'Greater than comparison',
+    example: '{{age}} #greater_than(18)',
+    autocomplete: {
+        trigger: '#greater',
+        snippet: '#greater_than($1)',
+    },
+    handler: (value, threshold) => {
+        const num = typeof value === 'string' ? parseFloat(value) : value;
+        const thresh = typeof threshold === 'string' ? parseFloat(threshold) : threshold;
+        if (typeof num !== 'number' || typeof thresh !== 'number')
+            return false;
+        if (isNaN(num) || isNaN(thresh))
+            return false;
+        return num > thresh;
+    },
+};
+/**
+ * #greater_than_or_equal - Greater than or equal (alias: #gte)
+ */
+export const gteOperator = {
+    type: 'comparison',
+    description: 'Greater than or equal comparison',
+    example: '{{age}} #greater_than_or_equal(18)',
+    autocomplete: {
+        trigger: '#greater_than_or',
+        snippet: '#greater_than_or_equal($1)',
+    },
+    handler: (value, threshold) => {
+        const num = typeof value === 'string' ? parseFloat(value) : value;
+        const thresh = typeof threshold === 'string' ? parseFloat(threshold) : threshold;
+        if (typeof num !== 'number' || typeof thresh !== 'number')
+            return false;
+        if (isNaN(num) || isNaN(thresh))
+            return false;
+        return num >= thresh;
+    },
+};
+/**
+ * #less_than - Less than (alias: #lt)
+ */
+export const ltOperator = {
+    type: 'comparison',
+    description: 'Less than comparison',
+    example: '{{count}} #less_than(10)',
+    autocomplete: {
+        trigger: '#less',
+        snippet: '#less_than($1)',
+    },
+    handler: (value, threshold) => {
+        const num = typeof value === 'string' ? parseFloat(value) : value;
+        const thresh = typeof threshold === 'string' ? parseFloat(threshold) : threshold;
+        if (typeof num !== 'number' || typeof thresh !== 'number')
+            return false;
+        if (isNaN(num) || isNaN(thresh))
+            return false;
+        return num < thresh;
+    },
+};
+/**
+ * #less_than_or_equal - Less than or equal (alias: #lte)
+ */
+export const lteOperator = {
+    type: 'comparison',
+    description: 'Less than or equal comparison',
+    example: '{{count}} #less_than_or_equal(10)',
+    autocomplete: {
+        trigger: '#less_than_or',
+        snippet: '#less_than_or_equal($1)',
+    },
+    handler: (value, threshold) => {
+        const num = typeof value === 'string' ? parseFloat(value) : value;
+        const thresh = typeof threshold === 'string' ? parseFloat(threshold) : threshold;
+        if (typeof num !== 'number' || typeof thresh !== 'number')
+            return false;
+        if (isNaN(num) || isNaN(thresh))
+            return false;
+        return num <= thresh;
+    },
+};
+// =============================================================================
+// LIST OPERATORS
+// =============================================================================
+/**
+ * #one_of - Check if value is in a list (alias: #in)
+ *
+ * @example {{status}} #one_of(active,pending,completed)
+ */
+export const inOperator = {
+    type: 'comparison',
+    description: 'Check if value is one of the given options',
+    example: '{{status}} #one_of(active,pending,completed)',
+    autocomplete: {
+        trigger: '#one',
+        snippet: '#one_of($1)',
+    },
+    handler: (value, list) => {
+        // List can be passed as array or comma-separated string
+        let items;
+        if (Array.isArray(list)) {
+            items = list;
+        }
+        else if (typeof list === 'string') {
+            items = list.split(',').map((s) => s.trim());
+        }
+        else {
+            return false;
+        }
+        // Check if value is in list
+        const valueStr = String(value).toLowerCase();
+        return items.some((item) => String(item).toLowerCase() === valueStr);
+    },
+};
+// =============================================================================
+// AI OPERATOR (ASYNC)
+// =============================================================================
+/**
+ * #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 const aiJudgeOperator = {
+    type: 'ai',
+    description: 'LLM-evaluated boolean condition',
+    example: '{{content}} #ai_judge(Is this appropriate for children?)',
+    autocomplete: {
+        trigger: '#ai',
+        snippet: '#ai_judge($1)',
+    },
+    handler: async (_value, _question) => {
+        // TODO: Implement AI judge
+        //
+        // IMPLEMENTATION STEPS:
+        // 1. Get the AI provider from context (passed via closure or config)
+        // 2. Construct prompt asking for yes/no answer
+        // 3. Call the AI provider
+        // 4. Parse response as boolean
+        // 5. Cache result for identical value+question combinations
+        //
+        // PROMPT TEMPLATE:
+        // "Given the following value: {value}
+        //  Answer this question with only 'yes' or 'no':
+        //  {question}"
+        //
+        // CACHING:
+        // Cache key = hash(value + question)
+        // Cache should be per-render to avoid stale data across renders
+        throw new Error('AI Judge not implemented. Configure aiProvider in EchoConfig.');
+    },
+};
+// =============================================================================
+// OPERATOR REGISTRY
+// =============================================================================
+/**
+ * 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 const builtinOperators = {
+    // Comparison operators (readable names)
+    equals: equalsOperator,
+    contains: containsOperator,
+    exists: existsOperator,
+    matches: matchesOperator,
+    greater_than: gtOperator,
+    greater_than_or_equal: gteOperator,
+    less_than: ltOperator,
+    less_than_or_equal: lteOperator,
+    one_of: inOperator,
+    ai_judge: aiJudgeOperator,
+    // Short aliases for developers
+    gt: gtOperator,
+    gte: gteOperator,
+    lt: ltOperator,
+    lte: lteOperator,
+    in: inOperator,
+};
+/**
+ * Get an operator by name.
+ *
+ * @param name - The operator name (without #)
+ * @returns The operator definition or undefined
+ */
+export function getOperator(name) {
+    return builtinOperators[name];
+}
+/**
+ * Check if an operator is async (AI-based).
+ *
+ * @param name - The operator name
+ * @returns true if the operator is async
+ */
+export function isAsyncOperator(name) {
+    const op = getOperator(name);
+    return op?.type === 'ai';
+}
+// =============================================================================
+// IMPLEMENTATION NOTES
+// =============================================================================
+/*
+NEXT STEPS TO IMPLEMENT:
+
+1. AI JUDGE IMPLEMENTATION
+   - Create ai-judge/provider.ts for AI provider abstraction
+   - Implement OpenAI adapter
+   - Add caching layer
+   - Handle timeouts and errors gracefully
+
+2. OPERATOR CONTEXT
+   The ai_judge operator needs access to the AI provider.
+   Options:
+   - Pass context as third argument to handler
+   - Use closure to capture config
+   - Create factory function that returns configured handler
+
+3. ERROR HANDLING
+   - Invalid regex in #matches should not crash
+   - Type mismatches should return false (not throw)
+   - AI errors should be recoverable
+
+4. TESTS
+   Create operators.test.ts with tests for:
+   - Each operator with various inputs
+   - Edge cases (null, undefined, empty)
+   - Type coercion behavior
+   - Async operator mocking
+*/
+//# sourceMappingURL=operators.js.map

package/dist/evaluator/operators.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,115 @@
+/**
+ * @fileoverview Echo PDK Core - Main entry point
+ *
+ * This is the main entry point for @goreal-ai/echo-pdk.
+ * It exports the createEcho factory function and all public types.
+ *
+ * @example
+ * ```typescript
+ * import { createEcho } from '@goreal-ai/echo-pdk';
+ *
+ * const echo = createEcho({
+ *   strict: false,
+ *   aiProvider: {
+ *     type: 'openai',
+ *     apiKey: process.env.OPENAI_API_KEY,
+ *   }
+ * });
+ *
+ * const result = await echo.render(template, { name: 'Alice' });
+ * ```
+ */
+export type { ASTNode, TextNode, VariableNode, ConditionalNode, SectionNode, ImportNode, IncludeNode, ConditionExpr, SourceLocation, EchoConfig, AIProviderConfig, ParseResult, ValidationResult, EchoError, EchoWarning, OperatorDefinition, OperatorHandler, EchoPlugin, Echo, } from './types.js';
+import type { Echo, EchoConfig, EchoPlugin } from './types.js';
+export { parse } from './parser/parser.js';
+export { evaluate, resolveVariable, type ResolveVariableOptions, } from './evaluator/evaluator.js';
+export { render, renderTemplate, formatErrors } from './renderer/renderer.js';
+export { builtinOperators, getOperator } from './evaluator/operators.js';
+export { createTextNode, createVariableNode, createConditionalNode, createConditionExpr, createSectionNode, createImportNode, createIncludeNode, collectAiJudgeConditions, visitNode, visitNodes, prettyPrint, } from './parser/ast.js';
+/**
+ * Creates a new Echo instance with the given configuration.
+ *
+ * The Echo instance provides methods for parsing, validating, and rendering
+ * Echo templates with support for:
+ * - Variable interpolation: {{name}}, {{user.email}}
+ * - Conditionals: [#IF {{var}} #operator(arg)]...[END IF]
+ * - Sections: [#SECTION name="x"]...[END SECTION]
+ * - Includes: [#INCLUDE section_name]
+ * - AI-powered conditions: #ai_judge(question)
+ *
+ * @param config - Configuration options for the Echo instance
+ * @returns A configured Echo instance
+ *
+ * @example Basic usage
+ * ```typescript
+ * import { createEcho } from '@goreal-ai/echo-pdk';
+ *
+ * const echo = createEcho();
+ * const output = await echo.render('Hello {{name}}!', { name: 'World' });
+ * // Output: "Hello World!"
+ * ```
+ *
+ * @example With AI provider
+ * ```typescript
+ * const echo = createEcho({
+ *   aiProvider: {
+ *     type: 'openai',
+ *     apiKey: process.env.OPENAI_API_KEY,
+ *     model: 'gpt-4o-mini',
+ *   }
+ * });
+ *
+ * const template = `
+ * [#IF {{content}} #ai_judge(Is this appropriate for children?)]
+ *   Safe content: {{content}}
+ * [ELSE]
+ *   Content flagged for review.
+ * [END IF]
+ * `;
+ *
+ * const output = await echo.render(template, { content: userContent });
+ * ```
+ *
+ * @example With plugins
+ * ```typescript
+ * const echo = createEcho();
+ *
+ * echo.loadPlugin({
+ *   name: 'custom-operators',
+ *   version: '1.0.0',
+ *   operators: {
+ *     isEmpty: {
+ *       type: 'unary',
+ *       handler: (value) => !value || value === '',
+ *       description: 'Check if value is empty',
+ *     }
+ *   }
+ * });
+ * ```
+ */
+export declare function createEcho(config?: EchoConfig): Echo;
+/**
+ * Helper function for defining plugins with type safety.
+ *
+ * @param plugin - The plugin definition
+ * @returns The same plugin (for type inference)
+ *
+ * @example
+ * ```typescript
+ * import { definePlugin } from '@goreal-ai/echo-pdk';
+ *
+ * export default definePlugin({
+ *   name: 'my-operators',
+ *   version: '1.0.0',
+ *   operators: {
+ *     isEmpty: {
+ *       type: 'unary',
+ *       handler: (value) => !value,
+ *       description: 'Check if value is empty'
+ *     }
+ *   }
+ * });
+ * ```
+ */
+export declare function definePlugin(plugin: EchoPlugin): EchoPlugin;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAGH,YAAY,EAEV,OAAO,EACP,QAAQ,EACR,YAAY,EACZ,eAAe,EACf,WAAW,EACX,UAAU,EACV,WAAW,EACX,aAAa,EACb,cAAc,EAEd,UAAU,EACV,gBAAgB,EAEhB,WAAW,EACX,gBAAgB,EAChB,SAAS,EACT,WAAW,EAEX,kBAAkB,EAClB,eAAe,EACf,UAAU,EAEV,IAAI,GACL,MAAM,YAAY,CAAC;AAEpB,OAAO,KAAK,EACV,IAAI,EACJ,UAAU,EAIV,UAAU,EAGX,MAAM,YAAY,CAAC;AAUpB,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAC3C,OAAO,EACL,QAAQ,EACR,eAAe,EACf,KAAK,sBAAsB,GAC5B,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,MAAM,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAC9E,OAAO,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AACzE,OAAO,EACL,cAAc,EACd,kBAAkB,EAClB,qBAAqB,EACrB,mBAAmB,EACnB,iBAAiB,EACjB,gBAAgB,EAChB,iBAAiB,EACjB,wBAAwB,EACxB,SAAS,EACT,UAAU,EACV,WAAW,GACZ,MAAM,iBAAiB,CAAC;AAQzB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4DG;AACH,wBAAgB,UAAU,CAAC,MAAM,GAAE,UAAe,GAAG,IAAI,CA+IxD;AAuLD;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,UAAU,GAAG,UAAU,CAE3D"}