@goreal-ai/echo-pdk-cli 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 Echo PDK
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,81 @@
+# @goreal-ai/echo-pdk-cli
+
+**Echo PDK CLI** - Command-line interface for Echo, a Domain Specific Language for dynamic prompt templating.
+
+## Installation
+
+```bash
+npm install -g @goreal-ai/echo-pdk-cli
+# or
+npx @goreal-ai/echo-pdk-cli <command>
+```
+
+## Commands
+
+### Render a Template
+
+```bash
+echopdk render template.echo --context context.json
+```
+
+Renders an Echo template with the provided context and outputs the result.
+
+**Options:**
+- `--context, -c` - Path to JSON file with context variables
+- `--output, -o` - Output file (defaults to stdout)
+
+### Validate Syntax
+
+```bash
+echopdk validate template.echo
+```
+
+Validates the syntax of an Echo template without rendering it.
+
+## Example
+
+**template.echo:**
+```
+Hello {{name}}!
+
+[#IF {{role}} #equals(admin)]
+You have full access.
+[ELSE]
+Welcome to our platform.
+[END IF]
+```
+
+**context.json:**
+```json
+{
+  "name": "Alice",
+  "role": "admin"
+}
+```
+
+**Run:**
+```bash
+echopdk render template.echo -c context.json
+```
+
+**Output:**
+```
+Hello Alice!
+
+You have full access.
+```
+
+## Related Packages
+
+| Package | Description |
+|---------|-------------|
+| [@goreal-ai/echo-pdk](https://www.npmjs.com/package/@goreal-ai/echo-pdk) | Core rendering engine |
+| [@goreal-ai/echo-pdk-language](https://www.npmjs.com/package/@goreal-ai/echo-pdk-language) | Language definition and schema |
+
+## Documentation
+
+Full documentation available at [GitHub](https://github.com/GoReal-AI/echo-pdk)
+
+## License
+
+MIT

package/dist/commands/render.d.ts

@@ -0,0 +1,21 @@
+/**
+ * @fileoverview Render Command - Render an Echo template
+ *
+ * Usage:
+ *   echopdk render template.echo --context '{"name": "Alice"}'
+ *   echopdk render template.echo --context-file context.json
+ *   echopdk render template.echo --context-file context.json --output result.txt
+ */
+interface RenderOptions {
+    context?: string;
+    contextFile?: string;
+    output?: string;
+    strict?: boolean;
+    trim?: boolean;
+}
+/**
+ * Render command handler.
+ */
+export declare function renderCommand(templatePath: string, options: RenderOptions): Promise<void>;
+export {};
+//# sourceMappingURL=render.d.ts.map

package/dist/commands/render.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"render.d.ts","sourceRoot":"","sources":["../../src/commands/render.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAWH,UAAU,aAAa;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAMD;;GAEG;AACH,wBAAsB,aAAa,CACjC,YAAY,EAAE,MAAM,EACpB,OAAO,EAAE,aAAa,GACrB,OAAO,CAAC,IAAI,CAAC,CA0Cf"}

package/dist/commands/render.js

@@ -0,0 +1,122 @@
+/**
+ * @fileoverview Render Command - Render an Echo template
+ *
+ * Usage:
+ *   echopdk render template.echo --context '{"name": "Alice"}'
+ *   echopdk render template.echo --context-file context.json
+ *   echopdk render template.echo --context-file context.json --output result.txt
+ */
+import { readFile, writeFile } from 'fs/promises';
+import { createEcho } from '@goreal-ai/echo-pdk';
+import chalk from 'chalk';
+import ora from 'ora';
+// =============================================================================
+// COMMAND IMPLEMENTATION
+// =============================================================================
+/**
+ * Render command handler.
+ */
+export async function renderCommand(templatePath, options) {
+    const spinner = ora('Rendering template...').start();
+    try {
+        // 1. Load template
+        const template = await loadTemplate(templatePath);
+        // 2. Load context
+        const context = await loadContext(options);
+        // 3. Create Echo instance
+        const echo = createEcho({
+            strict: options.strict,
+        });
+        // 4. Render
+        spinner.text = 'Rendering...';
+        const result = await echo.render(template, context);
+        // 5. Apply post-processing
+        let output = result;
+        if (options.trim) {
+            output = output.trim();
+        }
+        spinner.succeed('Template rendered successfully');
+        // 6. Output result
+        if (options.output) {
+            await writeFile(options.output, output, 'utf-8');
+            console.log(chalk.green(`Output written to: ${options.output}`));
+        }
+        else {
+            console.log('\n' + chalk.bold('Output:'));
+            console.log(chalk.gray('─'.repeat(40)));
+            console.log(output);
+            console.log(chalk.gray('─'.repeat(40)));
+        }
+    }
+    catch (error) {
+        spinner.fail('Render failed');
+        console.error(chalk.red(error.message));
+        process.exit(1);
+    }
+}
+// =============================================================================
+// HELPERS
+// =============================================================================
+/**
+ * Load template from file.
+ */
+async function loadTemplate(path) {
+    try {
+        return await readFile(path, 'utf-8');
+    }
+    catch (error) {
+        throw new Error(`Failed to load template: ${path}`);
+    }
+}
+/**
+ * Load context from options.
+ */
+async function loadContext(options) {
+    // From --context JSON string
+    if (options.context) {
+        try {
+            return JSON.parse(options.context);
+        }
+        catch {
+            throw new Error('Invalid JSON in --context option');
+        }
+    }
+    // From --context-file
+    if (options.contextFile) {
+        try {
+            const content = await readFile(options.contextFile, 'utf-8');
+            return JSON.parse(content);
+        }
+        catch {
+            throw new Error(`Failed to load context file: ${options.contextFile}`);
+        }
+    }
+    // No context provided
+    return {};
+}
+// =============================================================================
+// IMPLEMENTATION NOTES
+// =============================================================================
+/*
+NEXT STEPS TO IMPLEMENT:
+
+1. STREAMING OUTPUT
+   For large templates, stream the output instead of buffering.
+
+2. ENVIRONMENT VARIABLES
+   Support reading context from environment:
+   --env prefix=MY_VAR_
+
+3. MULTIPLE TEMPLATES
+   Support glob patterns for batch rendering:
+   echopdk render "templates/*.echo" --context-file context.json --output-dir dist/
+
+4. STDIN INPUT
+   Support reading template from stdin:
+   cat template.echo | echopdk render - --context '{"name": "Alice"}'
+
+5. PROGRESS REPORTING
+   For AI judge conditions, show progress:
+   "Evaluating AI conditions... (3/5)"
+*/
+//# sourceMappingURL=render.js.map

package/dist/commands/render.js.map

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

package/dist/commands/validate.d.ts

@@ -0,0 +1,16 @@
+/**
+ * @fileoverview Validate Command - Validate Echo template syntax
+ *
+ * Usage:
+ *   echopdk validate template.echo
+ *   echopdk validate template.echo --strict
+ */
+interface ValidateOptions {
+    strict?: boolean;
+}
+/**
+ * Validate command handler.
+ */
+export declare function validateCommand(templatePath: string, options: ValidateOptions): Promise<void>;
+export {};
+//# sourceMappingURL=validate.d.ts.map

package/dist/commands/validate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../../src/commands/validate.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAUH,UAAU,eAAe;IACvB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAMD;;GAEG;AACH,wBAAsB,eAAe,CACnC,YAAY,EAAE,MAAM,EACpB,OAAO,EAAE,eAAe,GACvB,OAAO,CAAC,IAAI,CAAC,CAkDf"}

package/dist/commands/validate.js

@@ -0,0 +1,118 @@
+/**
+ * @fileoverview Validate Command - Validate Echo template syntax
+ *
+ * Usage:
+ *   echopdk validate template.echo
+ *   echopdk validate template.echo --strict
+ */
+import { readFile } from 'fs/promises';
+import { createEcho } from '@goreal-ai/echo-pdk';
+import chalk from 'chalk';
+// =============================================================================
+// COMMAND IMPLEMENTATION
+// =============================================================================
+/**
+ * Validate command handler.
+ */
+export async function validateCommand(templatePath, options) {
+    try {
+        // 1. Load template
+        const template = await loadTemplate(templatePath);
+        // 2. Create Echo instance
+        const echo = createEcho();
+        // 3. Validate
+        const result = echo.validate(template);
+        // 4. Report results
+        if (result.valid) {
+            console.log(chalk.green('✓') + ` ${templatePath} is valid`);
+            // Show warnings if any
+            if (result.warnings.length > 0) {
+                console.log('\n' + chalk.yellow('Warnings:'));
+                for (const warning of result.warnings) {
+                    printDiagnostic(warning, 'warning', template);
+                }
+                if (options.strict) {
+                    console.log(chalk.yellow('\n⚠ Warnings treated as errors in strict mode'));
+                    process.exit(1);
+                }
+            }
+        }
+        else {
+            console.log(chalk.red('✗') + ` ${templatePath} has errors`);
+            console.log('\n' + chalk.red('Errors:'));
+            for (const error of result.errors) {
+                printDiagnostic(error, 'error', template);
+            }
+            if (result.warnings.length > 0) {
+                console.log('\n' + chalk.yellow('Warnings:'));
+                for (const warning of result.warnings) {
+                    printDiagnostic(warning, 'warning', template);
+                }
+            }
+            process.exit(1);
+        }
+    }
+    catch (error) {
+        console.error(chalk.red('Error: ') + error.message);
+        process.exit(1);
+    }
+}
+// =============================================================================
+// HELPERS
+// =============================================================================
+/**
+ * Load template from file.
+ */
+async function loadTemplate(path) {
+    try {
+        return await readFile(path, 'utf-8');
+    }
+    catch (error) {
+        throw new Error(`Failed to load template: ${path}`);
+    }
+}
+/**
+ * Print a diagnostic (error or warning) with source context.
+ */
+function printDiagnostic(diagnostic, type, source) {
+    const color = type === 'error' ? chalk.red : chalk.yellow;
+    const symbol = type === 'error' ? '✗' : '⚠';
+    console.log(`\n${color(symbol)} [${diagnostic.code}] ${diagnostic.message}`);
+    if (diagnostic.location) {
+        const { startLine, startColumn } = diagnostic.location;
+        const lines = source.split('\n');
+        const line = lines[startLine - 1];
+        if (line) {
+            console.log(chalk.gray(`  ${startLine} │ `) + line);
+            console.log(chalk.gray(`    │ `) + ' '.repeat(startColumn - 1) + color('^'));
+        }
+    }
+}
+// =============================================================================
+// IMPLEMENTATION NOTES
+// =============================================================================
+/*
+NEXT STEPS TO IMPLEMENT:
+
+1. GLOB PATTERNS
+   Support validating multiple files:
+   echopdk validate "templates/*.echo"
+
+2. JSON/SARIF OUTPUT
+   For CI integration:
+   echopdk validate template.echo --format json
+   echopdk validate template.echo --format sarif
+
+3. FIX SUGGESTIONS
+   Some errors might be auto-fixable:
+   echopdk validate template.echo --fix
+
+4. WATCH MODE
+   Re-validate on file changes:
+   echopdk validate template.echo --watch
+
+5. CUSTOM RULES
+   Load validation rules from config:
+   echopdk validate template.echo --config echo.config.yaml
+*/
+//# sourceMappingURL=validate.js.map

package/dist/commands/validate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.js","sourceRoot":"","sources":["../../src/commands/validate.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACvC,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACjD,OAAO,KAAK,MAAM,OAAO,CAAC;AAU1B,gFAAgF;AAChF,yBAAyB;AACzB,gFAAgF;AAEhF;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,YAAoB,EACpB,OAAwB;IAExB,IAAI,CAAC;QACH,mBAAmB;QACnB,MAAM,QAAQ,GAAG,MAAM,YAAY,CAAC,YAAY,CAAC,CAAC;QAElD,0BAA0B;QAC1B,MAAM,IAAI,GAAG,UAAU,EAAE,CAAC;QAE1B,cAAc;QACd,MAAM,MAAM,GAAG,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;QAEvC,oBAAoB;QACpB,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;YACjB,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,IAAI,YAAY,WAAW,CAAC,CAAC;YAE5D,uBAAuB;YACvB,IAAI,MAAM,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAC/B,OAAO,CAAC,GAAG,CAAC,IAAI,GAAG,KAAK,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,CAAC;gBAC9C,KAAK,MAAM,OAAO,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;oBACtC,eAAe,CAAC,OAAO,EAAE,SAAS,EAAE,QAAQ,CAAC,CAAC;gBAChD,CAAC;gBAED,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;oBACnB,OAAO,CAAC,GAAG,CACT,KAAK,CAAC,MAAM,CAAC,+CAA+C,CAAC,CAC9D,CAAC;oBACF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;gBAClB,CAAC;YACH,CAAC;QACH,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,IAAI,YAAY,aAAa,CAAC,CAAC;YAC5D,OAAO,CAAC,GAAG,CAAC,IAAI,GAAG,KAAK,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC;YAEzC,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;gBAClC,eAAe,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC;YAC5C,CAAC;YAED,IAAI,MAAM,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAC/B,OAAO,CAAC,GAAG,CAAC,IAAI,GAAG,KAAK,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,CAAC;gBAC9C,KAAK,MAAM,OAAO,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;oBACtC,eAAe,CAAC,OAAO,EAAE,SAAS,EAAE,QAAQ,CAAC,CAAC;gBAChD,CAAC;YACH,CAAC;YAED,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;IACH,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,SAAS,CAAC,GAAI,KAAe,CAAC,OAAO,CAAC,CAAC;QAC/D,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC;AAED,gFAAgF;AAChF,UAAU;AACV,gFAAgF;AAEhF;;GAEG;AACH,KAAK,UAAU,YAAY,CAAC,IAAY;IACtC,IAAI,CAAC;QACH,OAAO,MAAM,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IACvC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CAAC,4BAA4B,IAAI,EAAE,CAAC,CAAC;IACtD,CAAC;AACH,CAAC;AAED;;GAEG;AACH,SAAS,eAAe,CACtB,UAAoG,EACpG,IAAyB,EACzB,MAAc;IAEd,MAAM,KAAK,GAAG,IAAI,KAAK,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC;IAC1D,MAAM,MAAM,GAAG,IAAI,KAAK,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC;IAE5C,OAAO,CAAC,GAAG,CAAC,KAAK,KAAK,CAAC,MAAM,CAAC,KAAK,UAAU,CAAC,IAAI,KAAK,UAAU,CAAC,OAAO,EAAE,CAAC,CAAC;IAE7E,IAAI,UAAU,CAAC,QAAQ,EAAE,CAAC;QACxB,MAAM,EAAE,SAAS,EAAE,WAAW,EAAE,GAAG,UAAU,CAAC,QAAQ,CAAC;QACvD,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACjC,MAAM,IAAI,GAAG,KAAK,CAAC,SAAS,GAAG,CAAC,CAAC,CAAC;QAElC,IAAI,IAAI,EAAE,CAAC;YACT,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,SAAS,KAAK,CAAC,GAAG,IAAI,CAAC,CAAC;YACpD,OAAO,CAAC,GAAG,CACT,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,GAAG,CAAC,MAAM,CAAC,WAAW,GAAG,CAAC,CAAC,GAAG,KAAK,CAAC,GAAG,CAAC,CAChE,CAAC;QACJ,CAAC;IACH,CAAC;AACH,CAAC;AAED,gFAAgF;AAChF,uBAAuB;AACvB,gFAAgF;AAEhF;;;;;;;;;;;;;;;;;;;;;;;EAuBE"}

package/dist/index.d.ts

@@ -0,0 +1,15 @@
+#!/usr/bin/env node
+/**
+ * @fileoverview Echo CLI - Command-line interface
+ *
+ * This is the main entry point for the Echo CLI.
+ * It uses Commander.js to define commands and options.
+ *
+ * COMMANDS:
+ * - render: Render a template with context
+ * - validate: Validate template syntax
+ * - debug: Show AST and evaluation trace
+ * - watch: Watch mode for development
+ */
+export {};
+//# 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":";AACA;;;;;;;;;;;GAWG"}

package/dist/index.js

@@ -0,0 +1,74 @@
+#!/usr/bin/env node
+/**
+ * @fileoverview Echo CLI - Command-line interface
+ *
+ * This is the main entry point for the Echo CLI.
+ * It uses Commander.js to define commands and options.
+ *
+ * COMMANDS:
+ * - render: Render a template with context
+ * - validate: Validate template syntax
+ * - debug: Show AST and evaluation trace
+ * - watch: Watch mode for development
+ */
+import { Command } from 'commander';
+import { renderCommand } from './commands/render.js';
+import { validateCommand } from './commands/validate.js';
+// =============================================================================
+// CLI SETUP
+// =============================================================================
+const program = new Command();
+program
+    .name('echopdk')
+    .description('Echo PDK - Dynamic prompt templating DSL')
+    .version('0.1.0');
+// =============================================================================
+// COMMANDS
+// =============================================================================
+// Render command
+program
+    .command('render <template>')
+    .description('Render an Echo template with context')
+    .option('-c, --context <json>', 'Context as JSON string')
+    .option('-f, --context-file <path>', 'Path to context JSON file')
+    .option('-o, --output <path>', 'Output file path (stdout if not specified)')
+    .option('--strict', 'Fail on any error', false)
+    .option('--trim', 'Trim whitespace from output', false)
+    .action(renderCommand);
+// Validate command
+program
+    .command('validate <template>')
+    .description('Validate an Echo template syntax')
+    .option('--strict', 'Treat warnings as errors', false)
+    .action(validateCommand);
+// Debug command
+program
+    .command('debug <template>')
+    .description('Show AST and evaluation trace for a template')
+    .option('-c, --context <json>', 'Context as JSON string')
+    .option('-f, --context-file <path>', 'Path to context JSON file')
+    .option('--ast', 'Show only the AST')
+    .option('--tokens', 'Show only the tokens')
+    .action(async (template, options) => {
+    // TODO: Implement debug command
+    console.log('Debug command not yet implemented');
+    console.log('Template:', template);
+    console.log('Options:', options);
+});
+// Watch command
+program
+    .command('watch <template>')
+    .description('Watch mode - re-render on file changes')
+    .option('-c, --context <json>', 'Context as JSON string')
+    .option('-f, --context-file <path>', 'Path to context JSON file')
+    .action(async (template, options) => {
+    // TODO: Implement watch command
+    console.log('Watch command not yet implemented');
+    console.log('Template:', template);
+    console.log('Options:', options);
+});
+// =============================================================================
+// RUN
+// =============================================================================
+program.parse();
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAEzD,gFAAgF;AAChF,YAAY;AACZ,gFAAgF;AAEhF,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;AAE9B,OAAO;KACJ,IAAI,CAAC,SAAS,CAAC;KACf,WAAW,CAAC,0CAA0C,CAAC;KACvD,OAAO,CAAC,OAAO,CAAC,CAAC;AAEpB,gFAAgF;AAChF,WAAW;AACX,gFAAgF;AAEhF,iBAAiB;AACjB,OAAO;KACJ,OAAO,CAAC,mBAAmB,CAAC;KAC5B,WAAW,CAAC,sCAAsC,CAAC;KACnD,MAAM,CAAC,sBAAsB,EAAE,wBAAwB,CAAC;KACxD,MAAM,CAAC,2BAA2B,EAAE,2BAA2B,CAAC;KAChE,MAAM,CAAC,qBAAqB,EAAE,4CAA4C,CAAC;KAC3E,MAAM,CAAC,UAAU,EAAE,mBAAmB,EAAE,KAAK,CAAC;KAC9C,MAAM,CAAC,QAAQ,EAAE,6BAA6B,EAAE,KAAK,CAAC;KACtD,MAAM,CAAC,aAAa,CAAC,CAAC;AAEzB,mBAAmB;AACnB,OAAO;KACJ,OAAO,CAAC,qBAAqB,CAAC;KAC9B,WAAW,CAAC,kCAAkC,CAAC;KAC/C,MAAM,CAAC,UAAU,EAAE,0BAA0B,EAAE,KAAK,CAAC;KACrD,MAAM,CAAC,eAAe,CAAC,CAAC;AAE3B,gBAAgB;AAChB,OAAO;KACJ,OAAO,CAAC,kBAAkB,CAAC;KAC3B,WAAW,CAAC,8CAA8C,CAAC;KAC3D,MAAM,CAAC,sBAAsB,EAAE,wBAAwB,CAAC;KACxD,MAAM,CAAC,2BAA2B,EAAE,2BAA2B,CAAC;KAChE,MAAM,CAAC,OAAO,EAAE,mBAAmB,CAAC;KACpC,MAAM,CAAC,UAAU,EAAE,sBAAsB,CAAC;KAC1C,MAAM,CAAC,KAAK,EAAE,QAAgB,EAAE,OAAgC,EAAE,EAAE;IACnE,gCAAgC;IAChC,OAAO,CAAC,GAAG,CAAC,mCAAmC,CAAC,CAAC;IACjD,OAAO,CAAC,GAAG,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC;IACnC,OAAO,CAAC,GAAG,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;AACnC,CAAC,CAAC,CAAC;AAEL,gBAAgB;AAChB,OAAO;KACJ,OAAO,CAAC,kBAAkB,CAAC;KAC3B,WAAW,CAAC,wCAAwC,CAAC;KACrD,MAAM,CAAC,sBAAsB,EAAE,wBAAwB,CAAC;KACxD,MAAM,CAAC,2BAA2B,EAAE,2BAA2B,CAAC;KAChE,MAAM,CAAC,KAAK,EAAE,QAAgB,EAAE,OAAgC,EAAE,EAAE;IACnE,gCAAgC;IAChC,OAAO,CAAC,GAAG,CAAC,mCAAmC,CAAC,CAAC;IACjD,OAAO,CAAC,GAAG,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC;IACnC,OAAO,CAAC,GAAG,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;AACnC,CAAC,CAAC,CAAC;AAEL,gFAAgF;AAChF,MAAM;AACN,gFAAgF;AAEhF,OAAO,CAAC,KAAK,EAAE,CAAC"}

package/package.json

@@ -0,0 +1,53 @@
+{
+  "name": "@goreal-ai/echo-pdk-cli",
+  "version": "0.1.0",
+  "description": "Echo PDK command-line interface",
+  "type": "module",
+  "bin": {
+    "echopdk": "./dist/index.js"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/GoReal-AI/echo-pdk.git",
+    "directory": "packages/cli"
+  },
+  "bugs": {
+    "url": "https://github.com/GoReal-AI/echo-pdk/issues"
+  },
+  "homepage": "https://github.com/GoReal-AI/echo-pdk#readme",
+  "author": "GoReal.AI",
+  "dependencies": {
+    "commander": "^12.0.0",
+    "chalk": "^5.3.0",
+    "ora": "^8.0.0",
+    "@goreal-ai/echo-pdk": "0.2.3"
+  },
+  "devDependencies": {
+    "@types/node": "^20.10.0",
+    "typescript": "^5.3.0",
+    "vitest": "^2.0.0"
+  },
+  "keywords": [
+    "echo",
+    "pdk",
+    "cli",
+    "prompt"
+  ],
+  "license": "MIT",
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "lint": "eslint src --ext .ts",
+    "lint:fix": "eslint src --ext .ts --fix",
+    "typecheck": "tsc --noEmit",
+    "clean": "rm -rf dist"
+  }
+}