@principal-ai/subsystems-core 0.29.0

package/dist/execution/ExecutionLoader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ExecutionLoader.d.ts","sourceRoot":"","sources":["../../src/execution/ExecutionLoader.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,sCAAsC,CAAC;AAC9E,OAAO,EAAsB,KAAK,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAE9E;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,6DAA6D;IAC7D,IAAI,EAAE,MAAM,CAAC;IACb,sCAAsC;IACtC,IAAI,EAAE,MAAM,CAAC;IACb,0CAA0C;IAC1C,IAAI,EAAE,aAAa,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,qCAAqC;IACrC,UAAU,EAAE,aAAa,EAAE,CAAC;IAC5B,wCAAwC;IACxC,MAAM,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAChD;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,qBAAa,eAAe;IAKd,OAAO,CAAC,SAAS;IAJ7B,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,aAAa,CAAoB;IACzD,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,mBAAmB,CAAgB;IAC3D,OAAO,CAAC,SAAS,CAAqB;gBAElB,SAAS,EAAE,iBAAiB;IAIhD;;;;;OAKG;IACG,qBAAqB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAU9D;;;;;OAKG;IACG,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAiBxD;;;;;;;;OAQG;IACG,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC;IAkC9E;;;;;;;OAOG;IACG,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAsE5D;;;;;OAKG;IACH,yBAAyB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM;IAIlD;;;;;;;;OAQG;IACG,wBAAwB,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,GAAE,MAAU,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAgCxF;;;;;;;;OAQG;IACG,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,GAAE,MAAU,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAuB3F;;OAEG;IACH,OAAO,CAAC,eAAe;IAIvB;;OAEG;IACH,OAAO,CAAC,4BAA4B;CAGrC;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CACnC,SAAS,EAAE,iBAAiB,GAC3B,eAAe,CAEjB"}

package/dist/execution/ExecutionLoader.js

@@ -0,0 +1,266 @@
+"use strict";
+/**
+ * Execution loader for managing execution artifact files
+ *
+ * Supports loading execution files (.otel.json) from __executions__/ folders
+ * using the adapter pattern for environment-agnostic file operations.
+ *
+ * Automatically handles both OTLP standard format and legacy formats
+ * through ExecutionValidator conversion.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createExecutionLoader = exports.ExecutionLoader = void 0;
+const ExecutionValidator_1 = require("./ExecutionValidator");
+/**
+ * Loader for managing execution artifact files from __executions__/ folders
+ *
+ * @example
+ * ```typescript
+ * const loader = new ExecutionLoader(fsAdapter);
+ *
+ * // Check if __executions__/ exists
+ * if (await loader.hasExecutionDirectory('/path/to/project')) {
+ *   // Load all execution files
+ *   const result = await loader.loadAll('/path/to/project');
+ *   console.log(`Loaded ${result.executions.length} executions`);
+ *
+ *   // Load specific execution
+ *   const execution = await loader.loadByName('test-run', '/path/to/project');
+ * }
+ * ```
+ */
+class ExecutionLoader {
+    constructor(fsAdapter) {
+        this.fsAdapter = fsAdapter;
+        this.validator = new ExecutionValidator_1.ExecutionValidator();
+    }
+    /**
+     * Check if __executions__/ directory exists
+     *
+     * @param baseDir - Base directory to search from
+     * @returns True if __executions__/ directory exists
+     */
+    async hasExecutionDirectory(baseDir) {
+        const executionPath = this.fsAdapter.join(baseDir, ExecutionLoader.EXECUTION_DIR);
+        const exists = await this.fsAdapter.exists(executionPath);
+        if (!exists)
+            return false;
+        return await this.fsAdapter.isDirectory(executionPath);
+    }
+    /**
+     * List all available execution names in __executions__/ folder
+     *
+     * @param baseDir - Base directory containing __executions__/ folder
+     * @returns Array of execution names (without .otel.json extensions)
+     */
+    async listExecutions(baseDir) {
+        if (!(await this.hasExecutionDirectory(baseDir))) {
+            return [];
+        }
+        const executionPath = this.fsAdapter.join(baseDir, ExecutionLoader.EXECUTION_DIR);
+        const files = await this.fsAdapter.readDir(executionPath);
+        return files
+            .filter((f) => this.isExecutionFile(f))
+            .map((f) => this.getExecutionNameFromFilename(f))
+            .sort();
+    }
+    /**
+     * Load a specific execution by name
+     *
+     * Automatically handles OTLP format conversion through ExecutionValidator.
+     *
+     * @param name - Execution name (without .otel.json extension)
+     * @param baseDir - Base directory containing __executions__/ folder
+     * @returns Execution file or null if not found/invalid
+     */
+    async loadByName(name, baseDir) {
+        if (!(await this.hasExecutionDirectory(baseDir))) {
+            return null;
+        }
+        const executionPath = this.fsAdapter.join(baseDir, ExecutionLoader.EXECUTION_DIR);
+        const filename = `${name}${ExecutionLoader.EXECUTION_EXTENSION}`;
+        const fullPath = this.fsAdapter.join(executionPath, filename);
+        if (!(await this.fsAdapter.exists(fullPath))) {
+            return null;
+        }
+        try {
+            const content = await this.fsAdapter.readFile(fullPath);
+            const parsed = JSON.parse(content);
+            // Use validateOrThrow to both validate and get converted ExecutionData
+            const data = this.validator.validateOrThrow(parsed, fullPath);
+            return {
+                name,
+                path: fullPath,
+                data,
+            };
+        }
+        catch (error) {
+            // File exists but couldn't be read, parsed, or validated
+            return null;
+        }
+    }
+    /**
+     * Load all executions from __executions__/ folder
+     *
+     * Automatically handles OTLP format conversion for all files.
+     *
+     * @param baseDir - Base directory containing __executions__/ folder
+     * @returns Result containing all loaded executions and any errors
+     */
+    async loadAll(baseDir) {
+        const result = {
+            executions: [],
+            errors: [],
+        };
+        if (!(await this.hasExecutionDirectory(baseDir))) {
+            result.errors.push({
+                file: '__executions__',
+                error: 'Execution directory __executions__/ not found',
+            });
+            return result;
+        }
+        const executionPath = this.fsAdapter.join(baseDir, ExecutionLoader.EXECUTION_DIR);
+        const files = await this.fsAdapter.readDir(executionPath);
+        for (const filename of files) {
+            if (!this.isExecutionFile(filename)) {
+                continue; // Skip non-.otel.json files
+            }
+            const fullPath = this.fsAdapter.join(executionPath, filename);
+            const name = this.getExecutionNameFromFilename(filename);
+            try {
+                const content = await this.fsAdapter.readFile(fullPath);
+                const parsed = JSON.parse(content);
+                // Validate and convert OTLP format if needed
+                const validationResult = this.validator.validate(parsed, fullPath);
+                if (validationResult.valid) {
+                    // Use validateOrThrow to get converted ExecutionData
+                    const data = this.validator.validateOrThrow(parsed, fullPath);
+                    result.executions.push({
+                        name,
+                        path: fullPath,
+                        data,
+                    });
+                }
+                else {
+                    // Collect validation errors
+                    const errorMessages = validationResult.errors
+                        .map((e) => `${e.path}: ${e.message}`)
+                        .join('; ');
+                    result.errors.push({
+                        file: filename,
+                        error: `Validation failed: ${errorMessages}`,
+                    });
+                }
+            }
+            catch (error) {
+                const errorMessage = error instanceof Error ? error.message : String(error);
+                result.errors.push({
+                    file: filename,
+                    error: `Failed to read/parse file: ${errorMessage}`,
+                });
+            }
+        }
+        // Sort executions by name for consistent ordering
+        result.executions.sort((a, b) => a.name.localeCompare(b.name));
+        return result;
+    }
+    /**
+     * Get the execution directory path
+     *
+     * @param baseDir - Base directory
+     * @returns Full path to __executions__/ directory
+     */
+    getExecutionDirectoryPath(baseDir) {
+        return this.fsAdapter.join(baseDir, ExecutionLoader.EXECUTION_DIR);
+    }
+    /**
+     * Search for __executions__/ directories recursively in a project
+     *
+     * Useful for monorepos where executions might be in multiple packages.
+     *
+     * @param baseDir - Base directory to search from
+     * @param maxDepth - Maximum directory depth to search (default: 3)
+     * @returns Array of paths to __executions__/ directories
+     */
+    async findExecutionDirectories(baseDir, maxDepth = 3) {
+        const found = [];
+        const search = async (dir, depth) => {
+            if (depth > maxDepth)
+                return;
+            try {
+                const items = await this.fsAdapter.readDir(dir);
+                for (const item of items) {
+                    const fullPath = this.fsAdapter.join(dir, item);
+                    if (!(await this.fsAdapter.isDirectory(fullPath)))
+                        continue;
+                    // Skip node_modules and hidden directories
+                    if (item === 'node_modules' || item.startsWith('.'))
+                        continue;
+                    if (item === ExecutionLoader.EXECUTION_DIR) {
+                        found.push(fullPath);
+                    }
+                    else {
+                        await search(fullPath, depth + 1);
+                    }
+                }
+            }
+            catch (error) {
+                // Skip directories we can't read
+            }
+        };
+        await search(baseDir, 0);
+        return found;
+    }
+    /**
+     * Load all executions from multiple __executions__/ directories
+     *
+     * Useful for monorepos where executions are spread across packages.
+     *
+     * @param baseDir - Base directory to search from
+     * @param maxDepth - Maximum directory depth to search (default: 3)
+     * @returns Result containing all loaded executions and any errors
+     */
+    async loadAllRecursive(baseDir, maxDepth = 3) {
+        const result = {
+            executions: [],
+            errors: [],
+        };
+        const directories = await this.findExecutionDirectories(baseDir, maxDepth);
+        for (const execDir of directories) {
+            // Get parent directory for loadAll
+            const parentDir = this.fsAdapter.dirname(execDir);
+            const dirResult = await this.loadAll(parentDir);
+            result.executions.push(...dirResult.executions);
+            result.errors.push(...dirResult.errors);
+        }
+        // Sort by name
+        result.executions.sort((a, b) => a.name.localeCompare(b.name));
+        return result;
+    }
+    /**
+     * Check if a filename is an execution file
+     */
+    isExecutionFile(filename) {
+        return filename.endsWith(ExecutionLoader.EXECUTION_EXTENSION);
+    }
+    /**
+     * Extract execution name from filename
+     */
+    getExecutionNameFromFilename(filename) {
+        return filename.replace(ExecutionLoader.EXECUTION_EXTENSION, '');
+    }
+}
+ExecutionLoader.EXECUTION_DIR = '__executions__';
+ExecutionLoader.EXECUTION_EXTENSION = '.otel.json';
+exports.ExecutionLoader = ExecutionLoader;
+/**
+ * Create a new execution loader instance
+ *
+ * @param fsAdapter - File system adapter for environment-agnostic operations
+ * @returns ExecutionLoader instance
+ */
+function createExecutionLoader(fsAdapter) {
+    return new ExecutionLoader(fsAdapter);
+}
+exports.createExecutionLoader = createExecutionLoader;
+//# sourceMappingURL=ExecutionLoader.js.map

package/dist/execution/ExecutionLoader.js.map

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

package/dist/execution/ExecutionValidator.d.ts

@@ -0,0 +1,94 @@
+/**
+ * Execution File Validator
+ *
+ * Validates execution files in OTLP (OpenTelemetry Protocol) JSON format.
+ * Accepts standard OTLP format and converts it to internal ExecutionData structure.
+ */
+import type { IExportTraceServiceRequest } from '@opentelemetry/otlp-transformer/build/src/trace/internal-types';
+/**
+ * OTLP data format (standard OpenTelemetry Protocol format)
+ */
+export type OtlpData = IExportTraceServiceRequest;
+/**
+ * Execution data structure (as expected by ExecutionLoader and UI components)
+ */
+export interface ExecutionData {
+    metadata?: {
+        status?: string;
+        testName?: string;
+        sessionId?: string;
+        startTime?: number;
+        endTime?: number;
+        canvasName?: string;
+        exportedAt?: string;
+        source?: string;
+        framework?: string;
+        serviceName?: string;
+        scopeName?: string;
+        scopeVersion?: string;
+    };
+    spans: Array<{
+        id: string;
+        name: string;
+        traceId?: string;
+        parentSpanId?: string;
+        startTime?: number;
+        endTime?: number;
+        duration?: number;
+        status?: 'OK' | 'ERROR';
+        attributes?: Record<string, unknown>;
+        events: Array<{
+            time: number;
+            name: string;
+            attributes: Record<string, unknown>;
+        }>;
+    }>;
+}
+/**
+ * Validation error details
+ */
+export interface ValidationError {
+    path: string;
+    message: string;
+    severity: 'error' | 'warning';
+    suggestion?: string;
+}
+/**
+ * Validation result
+ */
+export interface ExecutionValidationResult {
+    valid: boolean;
+    errors: ValidationError[];
+    warnings: ValidationError[];
+}
+/**
+ * Convert OTLP format to ExecutionData format
+ */
+export declare function convertOtlpToExecutionData(otlp: OtlpData): ExecutionData;
+/**
+ * Validator for execution files
+ */
+export declare class ExecutionValidator {
+    /**
+     * Validate execution data structure
+     *
+     * Accepts both OTLP format (standard OpenTelemetry Protocol) and internal ExecutionData format.
+     * OTLP format will be automatically converted to ExecutionData format before validation.
+     */
+    validate(data: unknown, filePath?: string): ExecutionValidationResult;
+    /**
+     * Validate and throw if invalid
+     *
+     * Returns converted ExecutionData (OTLP format is automatically converted)
+     */
+    validateOrThrow(data: unknown, filePath?: string): ExecutionData;
+    /**
+     * Format validation result as human-readable report
+     */
+    formatReport(result: ExecutionValidationResult): string;
+}
+/**
+ * Create a new execution validator instance
+ */
+export declare function createExecutionValidator(): ExecutionValidator;
+//# sourceMappingURL=ExecutionValidator.d.ts.map

package/dist/execution/ExecutionValidator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ExecutionValidator.d.ts","sourceRoot":"","sources":["../../src/execution/ExecutionValidator.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EACV,0BAA0B,EAK3B,MAAM,gEAAgE,CAAC;AAOxE;;GAEG;AACH,MAAM,MAAM,QAAQ,GAAG,0BAA0B,CAAC;AAElD;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,EAAE;QACT,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,YAAY,CAAC,EAAE,MAAM,CAAC;KACvB,CAAC;IACF,KAAK,EAAE,KAAK,CAAC;QACX,EAAE,EAAE,MAAM,CAAC;QACX,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,MAAM,CAAC,EAAE,IAAI,GAAG,OAAO,CAAC;QACxB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QACrC,MAAM,EAAE,KAAK,CAAC;YACZ,IAAI,EAAE,MAAM,CAAC;YACb,IAAI,EAAE,MAAM,CAAC;YACb,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;SACrC,CAAC,CAAC;KACJ,CAAC,CAAC;CACJ;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,OAAO,GAAG,SAAS,CAAC;IAC9B,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACxC,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,eAAe,EAAE,CAAC;IAC1B,QAAQ,EAAE,eAAe,EAAE,CAAC;CAC7B;AAqFD;;GAEG;AACH,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,QAAQ,GAAG,aAAa,CAwExE;AAqBD;;GAEG;AACH,qBAAa,kBAAkB;IAC7B;;;;;OAKG;IACH,QAAQ,CAAC,IAAI,EAAE,OAAO,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,yBAAyB;IAsRrE;;;;OAIG;IACH,eAAe,CAAC,IAAI,EAAE,OAAO,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,aAAa;IAoBhE;;OAEG;IACH,YAAY,CAAC,MAAM,EAAE,yBAAyB,GAAG,MAAM;CAkCxD;AAED;;GAEG;AACH,wBAAgB,wBAAwB,IAAI,kBAAkB,CAE7D"}