dynamic-api-workflow 1.0.0

package/dist/engine/utils/file-cache.d.ts

@@ -0,0 +1,31 @@
+/**
+ * File cache with modification time tracking
+ */
+declare class FileCache {
+    private cache;
+    private baseDir;
+    constructor(baseDir: string);
+    /**
+     * Get file content, using cache if file hasn't been modified
+     */
+    get(filePath: string): Promise<string>;
+    /**
+     * Clear cache for a specific file
+     */
+    invalidate(filePath: string): void;
+    /**
+     * Clear entire cache
+     */
+    clear(): void;
+    /**
+     * Get cache statistics
+     */
+    getStats(): {
+        size: number;
+        entries: string[];
+    };
+}
+export declare const promptCache: FileCache;
+export declare const schemaCache: FileCache;
+export default FileCache;
+//# sourceMappingURL=file-cache.d.ts.map

package/dist/engine/utils/file-cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-cache.d.ts","sourceRoot":"","sources":["../../../engine/utils/file-cache.ts"],"names":[],"mappings":"AASA;;GAEG;AACH,cAAM,SAAS;IACX,OAAO,CAAC,KAAK,CAAiC;IAC9C,OAAO,CAAC,OAAO,CAAS;gBAEZ,OAAO,EAAE,MAAM;IAI3B;;OAEG;IACG,GAAG,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IA8B5C;;OAEG;IACH,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAKlC;;OAEG;IACH,KAAK,IAAI,IAAI;IAIb;;OAEG;IACH,QAAQ;;;;CAMX;AAGD,eAAO,MAAM,WAAW,WAAmE,CAAC;AAC5F,eAAO,MAAM,WAAW,WAAmE,CAAC;AAE5F,eAAe,SAAS,CAAC"}

package/dist/engine/utils/file-cache.js

@@ -0,0 +1,68 @@
+import fs from 'fs/promises';
+import path from 'path';
+import logger from './logger.js';
+/**
+ * File cache with modification time tracking
+ */
+class FileCache {
+    cache = new Map();
+    baseDir;
+    constructor(baseDir) {
+        this.baseDir = baseDir;
+    }
+    /**
+     * Get file content, using cache if file hasn't been modified
+     */
+    async get(filePath) {
+        const fullPath = path.isAbsolute(filePath) ? filePath : path.join(this.baseDir, filePath);
+        try {
+            const stats = await fs.stat(fullPath);
+            const cached = this.cache.get(fullPath);
+            // Return cached content if file hasn't been modified
+            if (cached && cached.mtime === stats.mtimeMs) {
+                logger.debug('File cache hit', { file: fullPath });
+                return cached.content;
+            }
+            // Load file content
+            const content = await fs.readFile(fullPath, 'utf-8');
+            // Update cache
+            this.cache.set(fullPath, {
+                content,
+                mtime: stats.mtimeMs,
+            });
+            logger.debug('File cache miss, loaded from disk', { file: fullPath });
+            return content;
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            throw new Error(`Failed to read file '${fullPath}': ${message}`);
+        }
+    }
+    /**
+     * Clear cache for a specific file
+     */
+    invalidate(filePath) {
+        const fullPath = path.isAbsolute(filePath) ? filePath : path.join(this.baseDir, filePath);
+        this.cache.delete(fullPath);
+    }
+    /**
+     * Clear entire cache
+     */
+    clear() {
+        this.cache.clear();
+    }
+    /**
+     * Get cache statistics
+     */
+    getStats() {
+        return {
+            size: this.cache.size,
+            entries: Array.from(this.cache.keys()),
+        };
+    }
+}
+// Create singleton instances for different file types
+export const promptCache = new FileCache(process.env.PROMPTS_DIR || './src/source/prompts');
+export const schemaCache = new FileCache(process.env.SCHEMAS_DIR || './src/source/schemas');
+export default FileCache;
+//# sourceMappingURL=file-cache.js.map

package/dist/engine/utils/file-cache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-cache.js","sourceRoot":"","sources":["../../../engine/utils/file-cache.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,aAAa,CAAC;AAC7B,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,MAAM,MAAM,aAAa,CAAC;AAOjC;;GAEG;AACH,MAAM,SAAS;IACH,KAAK,GAAG,IAAI,GAAG,EAAsB,CAAC;IACtC,OAAO,CAAS;IAExB,YAAY,OAAe;QACvB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IAC3B,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,GAAG,CAAC,QAAgB;QACtB,MAAM,QAAQ,GAAG,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;QAE1F,IAAI,CAAC;YACD,MAAM,KAAK,GAAG,MAAM,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;YACtC,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;YAExC,qDAAqD;YACrD,IAAI,MAAM,IAAI,MAAM,CAAC,KAAK,KAAK,KAAK,CAAC,OAAO,EAAE,CAAC;gBAC3C,MAAM,CAAC,KAAK,CAAC,gBAAgB,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC;gBACnD,OAAO,MAAM,CAAC,OAAO,CAAC;YAC1B,CAAC;YAED,oBAAoB;YACpB,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;YAErD,eAAe;YACf,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,QAAQ,EAAE;gBACrB,OAAO;gBACP,KAAK,EAAE,KAAK,CAAC,OAAO;aACvB,CAAC,CAAC;YAEH,MAAM,CAAC,KAAK,CAAC,mCAAmC,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC;YACtE,OAAO,OAAO,CAAC;QACnB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACb,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YACvE,MAAM,IAAI,KAAK,CAAC,wBAAwB,QAAQ,MAAM,OAAO,EAAE,CAAC,CAAC;QACrE,CAAC;IACL,CAAC;IAED;;OAEG;IACH,UAAU,CAAC,QAAgB;QACvB,MAAM,QAAQ,GAAG,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;QAC1F,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IAChC,CAAC;IAED;;OAEG;IACH,KAAK;QACD,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;IACvB,CAAC;IAED;;OAEG;IACH,QAAQ;QACJ,OAAO;YACH,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI;YACrB,OAAO,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;SACzC,CAAC;IACN,CAAC;CACJ;AAED,sDAAsD;AACtD,MAAM,CAAC,MAAM,WAAW,GAAG,IAAI,SAAS,CAAC,OAAO,CAAC,GAAG,CAAC,WAAW,IAAI,sBAAsB,CAAC,CAAC;AAC5F,MAAM,CAAC,MAAM,WAAW,GAAG,IAAI,SAAS,CAAC,OAAO,CAAC,GAAG,CAAC,WAAW,IAAI,sBAAsB,CAAC,CAAC;AAE5F,eAAe,SAAS,CAAC"}

package/dist/engine/utils/file-resolver.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Resolve file path for code or prompt files
+ *
+ * Files are always local to the endpoint folder:
+ * - code files: src/endpoints/<path>/codes/<filename>
+ * - prompt files: src/endpoints/<path>/prompts/<filename>
+ *
+ * For shared utilities, code files can import from @workflow/plugins/...
+ * which maps to src/plugins/...
+ *
+ * @param filename - The filename from YAML
+ * @param endpointPath - The endpoint folder path relative to src/endpoints
+ * @param type - 'codes' or 'prompts'
+ */
+export declare function resolveFilePath(filename: string, endpointPath: string, type: 'codes' | 'prompts'): string;
+/**
+ * Extract endpoint path from route
+ * Converts route like "/users/:id" to folder path "users/[id]"
+ */
+export declare function routeToEndpointPath(route: string): string;
+//# sourceMappingURL=file-resolver.d.ts.map

package/dist/engine/utils/file-resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-resolver.d.ts","sourceRoot":"","sources":["../../../engine/utils/file-resolver.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;;;;GAaG;AACH,wBAAgB,eAAe,CAC3B,QAAQ,EAAE,MAAM,EAChB,YAAY,EAAE,MAAM,EACpB,IAAI,EAAE,OAAO,GAAG,SAAS,GAC1B,MAAM,CAGR;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAOzD"}

package/dist/engine/utils/file-resolver.js

@@ -0,0 +1,33 @@
+import path from 'path';
+const workflowsDir = process.env.WORKFLOWS_DIR || './src';
+/**
+ * Resolve file path for code or prompt files
+ *
+ * Files are always local to the endpoint folder:
+ * - code files: src/endpoints/<path>/codes/<filename>
+ * - prompt files: src/endpoints/<path>/prompts/<filename>
+ *
+ * For shared utilities, code files can import from @workflow/plugins/...
+ * which maps to src/plugins/...
+ *
+ * @param filename - The filename from YAML
+ * @param endpointPath - The endpoint folder path relative to src/endpoints
+ * @param type - 'codes' or 'prompts'
+ */
+export function resolveFilePath(filename, endpointPath, type) {
+    // All files are local to the endpoint
+    return path.join(process.cwd(), workflowsDir, 'endpoints', endpointPath, type, filename);
+}
+/**
+ * Extract endpoint path from route
+ * Converts route like "/users/:id" to folder path "users/[id]"
+ */
+export function routeToEndpointPath(route) {
+    // Remove leading slash and convert :param to [param]
+    return route
+        .replace(/^\//, '')
+        .split('/')
+        .map(segment => segment.startsWith(':') ? `[${segment.slice(1)}]` : segment)
+        .join('/');
+}
+//# sourceMappingURL=file-resolver.js.map

package/dist/engine/utils/file-resolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-resolver.js","sourceRoot":"","sources":["../../../engine/utils/file-resolver.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,MAAM,CAAC;AAExB,MAAM,YAAY,GAAG,OAAO,CAAC,GAAG,CAAC,aAAa,IAAI,OAAO,CAAC;AAE1D;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,eAAe,CAC3B,QAAgB,EAChB,YAAoB,EACpB,IAAyB;IAEzB,sCAAsC;IACtC,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,YAAY,EAAE,WAAW,EAAE,YAAY,EAAE,IAAI,EAAE,QAAQ,CAAC,CAAC;AAC7F,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,mBAAmB,CAAC,KAAa;IAC7C,qDAAqD;IACrD,OAAO,KAAK;SACP,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC;SAClB,KAAK,CAAC,GAAG,CAAC;SACV,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC;SAC3E,IAAI,CAAC,GAAG,CAAC,CAAC;AACnB,CAAC"}

package/dist/engine/utils/jsonpath.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Evaluate a JSONPath expression against data
+ */
+export declare function evaluate(path: string, data: unknown): unknown;
+/**
+ * Evaluate multiple JSONPath expressions
+ */
+export declare function evaluateAll(mapping: Record<string, string>, data: unknown): Record<string, unknown>;
+/**
+ * Check if a JSONPath expression is valid syntax
+ */
+export declare function isValidPath(path: string): boolean;
+//# sourceMappingURL=jsonpath.d.ts.map

package/dist/engine/utils/jsonpath.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"jsonpath.d.ts","sourceRoot":"","sources":["../../../engine/utils/jsonpath.ts"],"names":[],"mappings":"AAGA;;GAEG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,OAAO,CAQ7D;AAED;;GAEG;AACH,wBAAgB,WAAW,CACvB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC/B,IAAI,EAAE,OAAO,GACd,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAQzB;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAOjD"}

package/dist/engine/utils/jsonpath.js

@@ -0,0 +1,38 @@
+import { JSONPath } from 'jsonpath-plus';
+import { ErrorCode } from '../types/index.js';
+/**
+ * Evaluate a JSONPath expression against data
+ */
+export function evaluate(path, data) {
+    try {
+        const result = JSONPath({ path, json: data, wrap: false });
+        return result;
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        throw new Error(`${ErrorCode.JSONPATH_ERROR}: Failed to evaluate path '${path}': ${message}`);
+    }
+}
+/**
+ * Evaluate multiple JSONPath expressions
+ */
+export function evaluateAll(mapping, data) {
+    const result = {};
+    for (const [key, path] of Object.entries(mapping)) {
+        result[key] = evaluate(path, data);
+    }
+    return result;
+}
+/**
+ * Check if a JSONPath expression is valid syntax
+ */
+export function isValidPath(path) {
+    try {
+        JSONPath({ path, json: {}, wrap: false });
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=jsonpath.js.map

package/dist/engine/utils/jsonpath.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"jsonpath.js","sourceRoot":"","sources":["../../../engine/utils/jsonpath.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAE9C;;GAEG;AACH,MAAM,UAAU,QAAQ,CAAC,IAAY,EAAE,IAAa;IAChD,IAAI,CAAC;QACD,MAAM,MAAM,GAAG,QAAQ,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,IAAsB,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;QAC7E,OAAO,MAAM,CAAC;IAClB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACb,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACvE,MAAM,IAAI,KAAK,CAAC,GAAG,SAAS,CAAC,cAAc,8BAA8B,IAAI,MAAM,OAAO,EAAE,CAAC,CAAC;IAClG,CAAC;AACL,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,WAAW,CACvB,OAA+B,EAC/B,IAAa;IAEb,MAAM,MAAM,GAA4B,EAAE,CAAC;IAE3C,KAAK,MAAM,CAAC,GAAG,EAAE,IAAI,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;QAChD,MAAM,CAAC,GAAG,CAAC,GAAG,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IACvC,CAAC;IAED,OAAO,MAAM,CAAC;AAClB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,WAAW,CAAC,IAAY;IACpC,IAAI,CAAC;QACD,QAAQ,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;QAC1C,OAAO,IAAI,CAAC;IAChB,CAAC;IAAC,MAAM,CAAC;QACL,OAAO,KAAK,CAAC;IACjB,CAAC;AACL,CAAC"}

package/dist/engine/utils/logger.d.ts

@@ -0,0 +1,11 @@
+import winston from 'winston';
+/**
+ * Create winston logger with appropriate format
+ */
+declare const logger: winston.Logger;
+/**
+ * Create a child logger with additional context
+ */
+export declare function createLogger(context: Record<string, unknown>): winston.Logger;
+export default logger;
+//# sourceMappingURL=logger.d.ts.map

package/dist/engine/utils/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../../engine/utils/logger.ts"],"names":[],"mappings":"AAAA,OAAO,OAAO,MAAM,SAAS,CAAC;AAK9B;;GAEG;AACH,QAAA,MAAM,MAAM,gBAaV,CAAC;AAEH;;GAEG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,kBAE5D;AAED,eAAe,MAAM,CAAC"}

package/dist/engine/utils/logger.js

@@ -0,0 +1,24 @@
+import winston from 'winston';
+const logLevel = process.env.LOG_LEVEL || 'info';
+const isProduction = process.env.NODE_ENV === 'production';
+/**
+ * Create winston logger with appropriate format
+ */
+const logger = winston.createLogger({
+    level: logLevel,
+    format: isProduction
+        ? winston.format.json()
+        : winston.format.combine(winston.format.colorize(), winston.format.timestamp({ format: 'YYYY-MM-DD HH:mm:ss' }), winston.format.printf(({ timestamp, level, message, ...meta }) => {
+            const metaStr = Object.keys(meta).length ? JSON.stringify(meta, null, 2) : '';
+            return `${timestamp} [${level}]: ${message} ${metaStr}`;
+        })),
+    transports: [new winston.transports.Console()],
+});
+/**
+ * Create a child logger with additional context
+ */
+export function createLogger(context) {
+    return logger.child(context);
+}
+export default logger;
+//# sourceMappingURL=logger.js.map

package/dist/engine/utils/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../../engine/utils/logger.ts"],"names":[],"mappings":"AAAA,OAAO,OAAO,MAAM,SAAS,CAAC;AAE9B,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,SAAS,IAAI,MAAM,CAAC;AACjD,MAAM,YAAY,GAAG,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,YAAY,CAAC;AAE3D;;GAEG;AACH,MAAM,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IAChC,KAAK,EAAE,QAAQ;IACf,MAAM,EAAE,YAAY;QAChB,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,EAAE;QACvB,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,CACpB,OAAO,CAAC,MAAM,CAAC,QAAQ,EAAE,EACzB,OAAO,CAAC,MAAM,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,qBAAqB,EAAE,CAAC,EAC3D,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,SAAS,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,IAAI,EAAE,EAAE,EAAE;YAC7D,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;YAC9E,OAAO,GAAG,SAAS,KAAK,KAAK,MAAM,OAAO,IAAI,OAAO,EAAE,CAAC;QAC5D,CAAC,CAAC,CACL;IACL,UAAU,EAAE,CAAC,IAAI,OAAO,CAAC,UAAU,CAAC,OAAO,EAAE,CAAC;CACjD,CAAC,CAAC;AAEH;;GAEG;AACH,MAAM,UAAU,YAAY,CAAC,OAAgC;IACzD,OAAO,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;AACjC,CAAC;AAED,eAAe,MAAM,CAAC"}

package/dist/engine/utils/metrics.d.ts

@@ -0,0 +1,6 @@
+import type { NodeMetrics } from '../types/index.js';
+/**
+ * Display metrics in a tabular format
+ */
+export declare function displayMetrics(metrics: NodeMetrics[]): void;
+//# sourceMappingURL=metrics.d.ts.map

package/dist/engine/utils/metrics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"metrics.d.ts","sourceRoot":"","sources":["../../../engine/utils/metrics.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAKrD;;GAEG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,WAAW,EAAE,GAAG,IAAI,CAwF3D"}

package/dist/engine/utils/metrics.js

@@ -0,0 +1,82 @@
+import logger from './logger.js';
+import { getModelCost } from '../config/llm-costs.js';
+/**
+ * Display metrics in a tabular format
+ */
+export function displayMetrics(metrics) {
+    if (metrics.length === 0) {
+        return;
+    }
+    console.log('\n📊 Pipeline Metrics:');
+    console.log('─'.repeat(80));
+    // Header
+    console.log(padRight('Node ID', 25) +
+        padRight('Type', 12) +
+        padRight('Runtime', 12) +
+        padRight('Tokens (in/out)', 20) +
+        padRight('Cost ($)', 12));
+    console.log('─'.repeat(80));
+    // Calculate totals
+    let totalTime = 0;
+    let totalInputTokens = 0;
+    let totalOutputTokens = 0;
+    let totalCost = 0;
+    // Rows
+    for (const metric of metrics) {
+        const runtimeSeconds = (metric.executionTimeMs / 1000).toFixed(2);
+        const runtime = `${runtimeSeconds}s`;
+        let tokens = '-';
+        let costStr = '-';
+        let cost = 0;
+        if (metric.inputTokens !== undefined || metric.outputTokens !== undefined) {
+            const inputStr = metric.inputTokens?.toString() || '0';
+            const outputStr = metric.outputTokens?.toString() || '0';
+            tokens = `${inputStr} / ${outputStr}`;
+        }
+        if (metric.nodeType === 'llm' && metric.model) {
+            const modelCosts = getModelCost(metric.model);
+            const inputCost = ((metric.inputTokens || 0) / 1_000_000) * modelCosts.inputCostPer1M;
+            const outputCost = ((metric.outputTokens || 0) / 1_000_000) * modelCosts.outputCostPer1M;
+            const cachedCost = ((metric.cachedTokens || 0) / 1_000_000) * (modelCosts.cachedInputCostPer1M || 0);
+            cost = inputCost + outputCost + cachedCost;
+            costStr = `$${cost.toFixed(6)}`;
+        }
+        console.log(padRight(metric.nodeId, 25) +
+            padRight(metric.nodeType, 12) +
+            padRight(runtime, 12) +
+            padRight(tokens, 20) +
+            padRight(costStr, 12));
+        totalTime += metric.executionTimeMs;
+        totalInputTokens += metric.inputTokens || 0;
+        totalOutputTokens += metric.outputTokens || 0;
+        totalCost += cost;
+    }
+    // Footer with totals
+    console.log('─'.repeat(80));
+    const totalRuntimeSeconds = (totalTime / 1000).toFixed(2);
+    const totalTokens = totalInputTokens > 0 || totalOutputTokens > 0
+        ? `${totalInputTokens} / ${totalOutputTokens}`
+        : '-';
+    console.log(padRight('TOTAL', 25) +
+        padRight('', 12) +
+        padRight(`${totalRuntimeSeconds}s`, 12) +
+        padRight(totalTokens, 20) +
+        padRight(`$${totalCost.toFixed(6)}`, 12));
+    console.log('─'.repeat(80));
+    console.log('');
+    // Log summary to logger
+    logger.info('Pipeline execution metrics', {
+        totalExecutionTimeMs: totalTime.toFixed(2),
+        totalInputTokens,
+        totalOutputTokens,
+        totalCost: totalCost.toFixed(6),
+        nodeCount: metrics.length,
+    });
+}
+/**
+ * Pad string to the right
+ */
+function padRight(str, length) {
+    return str.padEnd(length, ' ');
+}
+//# sourceMappingURL=metrics.js.map

package/dist/engine/utils/metrics.js.map

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

package/dist/engine/utils/schema-validator.d.ts

@@ -0,0 +1,10 @@
+import type { ValidationResult } from '../types/index.js';
+/**
+ * Validate data against a JSON schema
+ */
+export declare function validateSchema(data: unknown, schema: Record<string, unknown> | string): Promise<ValidationResult>;
+/**
+ * Check if a schema is valid JSON Schema
+ */
+export declare function isValidSchema(schema: unknown): boolean;
+//# sourceMappingURL=schema-validator.d.ts.map

package/dist/engine/utils/schema-validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-validator.d.ts","sourceRoot":"","sources":["../../../engine/utils/schema-validator.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAK1D;;GAEG;AACH,wBAAsB,cAAc,CAChC,IAAI,EAAE,OAAO,EACb,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,GACzC,OAAO,CAAC,gBAAgB,CAAC,CA+B3B;AAoBD;;GAEG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,OAAO,GAAG,OAAO,CAOtD"}

package/dist/engine/utils/schema-validator.js

@@ -0,0 +1,61 @@
+import Ajv from 'ajv';
+import { schemaCache } from './file-cache.js';
+const ajv = new Ajv({ allErrors: true });
+/**
+ * Validate data against a JSON schema
+ */
+export async function validateSchema(data, schema) {
+    let schemaObj;
+    // Load schema from file if it's a string path
+    if (typeof schema === 'string') {
+        const schemaContent = await schemaCache.get(schema);
+        schemaObj = JSON.parse(schemaContent);
+    }
+    else {
+        schemaObj = schema;
+    }
+    // Compile and validate
+    const validate = ajv.compile(schemaObj);
+    const valid = validate(data);
+    if (valid) {
+        return { valid: true };
+    }
+    // Format errors
+    const errors = (validate.errors || []).map((error) => ({
+        code: 'SCHEMA_VALIDATION_ERROR',
+        message: formatErrorMessage(error),
+        path: error.instancePath,
+        details: error,
+    }));
+    return {
+        valid: false,
+        errors,
+    };
+}
+/**
+ * Format Ajv error into human-readable message
+ */
+function formatErrorMessage(error) {
+    const { instancePath, message, params } = error;
+    const path = instancePath || 'root';
+    if (error.keyword === 'required') {
+        return `${path} ${message}: ${params.missingProperty}`;
+    }
+    if (error.keyword === 'type') {
+        return `${path} ${message}`;
+    }
+    return `${path}: ${message}`;
+}
+/**
+ * Check if a schema is valid JSON Schema
+ */
+export function isValidSchema(schema) {
+    try {
+        ajv.compile(schema);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=schema-validator.js.map

package/dist/engine/utils/schema-validator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-validator.js","sourceRoot":"","sources":["../../../engine/utils/schema-validator.ts"],"names":[],"mappings":"AAAA,OAAO,GAAoB,MAAM,KAAK,CAAC;AAEvC,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAE9C,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;AAEzC;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAChC,IAAa,EACb,MAAwC;IAExC,IAAI,SAAkC,CAAC;IAEvC,8CAA8C;IAC9C,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;QAC7B,MAAM,aAAa,GAAG,MAAM,WAAW,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QACpD,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC;IAC1C,CAAC;SAAM,CAAC;QACJ,SAAS,GAAG,MAAM,CAAC;IACvB,CAAC;IAED,uBAAuB;IACvB,MAAM,QAAQ,GAAG,GAAG,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IACxC,MAAM,KAAK,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC;IAE7B,IAAI,KAAK,EAAE,CAAC;QACR,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;IAC3B,CAAC;IAED,gBAAgB;IAChB,MAAM,MAAM,GAAG,CAAC,QAAQ,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,KAAkB,EAAE,EAAE,CAAC,CAAC;QAChE,IAAI,EAAE,yBAAyB;QAC/B,OAAO,EAAE,kBAAkB,CAAC,KAAK,CAAC;QAClC,IAAI,EAAE,KAAK,CAAC,YAAY;QACxB,OAAO,EAAE,KAAK;KACjB,CAAC,CAAC,CAAC;IAEJ,OAAO;QACH,KAAK,EAAE,KAAK;QACZ,MAAM;KACT,CAAC;AACN,CAAC;AAED;;GAEG;AACH,SAAS,kBAAkB,CAAC,KAAkB;IAC1C,MAAM,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,KAAK,CAAC;IAChD,MAAM,IAAI,GAAG,YAAY,IAAI,MAAM,CAAC;IAEpC,IAAI,KAAK,CAAC,OAAO,KAAK,UAAU,EAAE,CAAC;QAC/B,OAAO,GAAG,IAAI,IAAI,OAAO,KAAM,MAAsC,CAAC,eAAe,EAAE,CAAC;IAC5F,CAAC;IAED,IAAI,KAAK,CAAC,OAAO,KAAK,MAAM,EAAE,CAAC;QAC3B,OAAO,GAAG,IAAI,IAAI,OAAO,EAAE,CAAC;IAChC,CAAC;IAED,OAAO,GAAG,IAAI,KAAK,OAAO,EAAE,CAAC;AACjC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,aAAa,CAAC,MAAe;IACzC,IAAI,CAAC;QACD,GAAG,CAAC,OAAO,CAAC,MAAiC,CAAC,CAAC;QAC/C,OAAO,IAAI,CAAC;IAChB,CAAC;IAAC,MAAM,CAAC;QACL,OAAO,KAAK,CAAC;IACjB,CAAC;AACL,CAAC"}

package/package.json

@@ -0,0 +1,53 @@
+{
+  "name": "dynamic-api-workflow",
+  "version": "1.0.0",
+  "description": "TypeScript-based dynamic API workflow engine that creates configurable endpoints from YAML definitions",
+  "main": "dist/engine/index.js",
+  "bin": {
+    "dynamic-api-workflow": "./dist/engine/cli.js"
+  },
+  "files": [
+    "dist/engine",
+    "README.md"
+  ],
+  "type": "module",
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsx engine/scripts/cleanup-port.ts && tsx --watch engine/cli.ts",
+    "create-endpoint": "tsx engine/scripts/create-endpoint.ts",
+    "start": "node dist/engine/cli.js",
+    "validate": "tsx engine/scripts/validate-workflows.ts",
+    "scan-deps": "tsx engine/scripts/scan-deps.ts",
+    "lint": "eslint engine/",
+    "format": "prettier --write \"engine/**/*.ts\""
+  },
+  "keywords": [
+    "api",
+    "workflow",
+    "llm",
+    "automation",
+    "yaml"
+  ],
+  "author": "",
+  "license": "ISC",
+  "dependencies": {
+    "@google/generative-ai": "^0.21.0",
+    "@xmldom/xmldom": "^0.8.11",
+    "ajv": "^8.12.0",
+    "dotenv": "^16.4.1",
+    "express": "^4.18.2",
+    "jsonpath-plus": "^10.2.0",
+    "winston": "^3.11.0",
+    "yaml": "^2.3.4"
+  },
+  "devDependencies": {
+    "@types/express": "^4.17.21",
+    "@types/node": "^20.11.5",
+    "@typescript-eslint/eslint-plugin": "^6.19.0",
+    "@typescript-eslint/parser": "^6.19.0",
+    "eslint": "^8.56.0",
+    "prettier": "^3.2.4",
+    "tsx": "^4.7.0",
+    "typescript": "^5.3.3"
+  }
+}