@sudocode-ai/local-server 0.1.6 → 0.1.7

package/dist/execution/process/simple-manager.js

@@ -1,336 +0,0 @@
-/**
- * Simple Process Manager Implementation
- *
- * A straightforward implementation of IProcessManager that spawns a fresh
- * process for each task. This is the "simple first" approach that will later
- * be upgraded to support process pooling.
- *
- * Supports any CLI tool/agent (Claude Code, Codex, Gemini CLI, etc.)
- *
- * Key features:
- * - One process per task (no pooling)
- * - Event-based I/O streaming
- * - Graceful termination (SIGTERM → SIGKILL)
- * - Automatic cleanup
- * - Metrics tracking
- * - Agent-agnostic design
- *
- * @module execution/process/simple-manager
- */
-import { spawn } from "child_process";
-import { generateId } from "./utils.js";
-/**
- * Simple process manager that spawns one process per task
- *
- * This implementation follows the "simple first" principle - it provides
- * a production-ready process manager without the complexity of pooling.
- *
- * Works with any CLI tool/agent by accepting executable path and args.
- *
- * @example
- * ```typescript
- * // Claude Code example
- * const manager = new SimpleProcessManager({
- *   executablePath: 'claude',
- *   args: ['--print', '--output-format', 'stream-json'],
- * });
- *
- * const process = await manager.acquireProcess({
- *   executablePath: 'claude',
- *   args: ['--print', '--output-format', 'stream-json'],
- *   workDir: '/path/to/project',
- *   timeout: 300000,
- * });
- *
- * // Codex example
- * const codexProcess = await manager.acquireProcess({
- *   executablePath: 'codex',
- *   args: ['--mode', 'agent', '--json'],
- *   workDir: '/path/to/project',
- * });
- * ```
- */
-export class SimpleProcessManager {
-    _defaultConfig;
-    _activeProcesses = new Map();
-    _cleanupTimers = new Map();
-    _metrics = {
-        totalSpawned: 0,
-        currentlyActive: 0,
-        totalCompleted: 0,
-        totalFailed: 0,
-        averageDuration: 0,
-    };
-    /**
-     * Create a new SimpleProcessManager
-     *
-     * @param defaultConfig - Default configuration to merge with per-process config
-     */
-    constructor(_defaultConfig = {}) {
-        this._defaultConfig = _defaultConfig;
-    }
-    async acquireProcess(config) {
-        // Merge with default config
-        const mergedConfig = { ...this._defaultConfig, ...config };
-        // Spawn the process
-        const childProcess = this.spawnProcess(mergedConfig);
-        // Validate process spawned successfully
-        if (!childProcess.pid) {
-            // Suppress error event to prevent uncaughtException
-            childProcess.once("error", () => {
-                // Error is expected when process fails to spawn
-            });
-            throw new Error("Failed to spawn process: no PID assigned");
-        }
-        // Generate unique ID for this process
-        const id = generateId("process");
-        // Create managed process object
-        const managedProcess = {
-            id,
-            pid: childProcess.pid,
-            status: "busy",
-            spawnedAt: new Date(),
-            lastActivity: new Date(),
-            exitCode: null,
-            signal: null,
-            process: childProcess,
-            streams: {
-                stdout: childProcess.stdout,
-                stderr: childProcess.stderr,
-                stdin: childProcess.stdin,
-            },
-            metrics: {
-                totalDuration: 0,
-                tasksCompleted: 0,
-                successRate: 1.0,
-            },
-        };
-        // Track the process
-        this._activeProcesses.set(id, managedProcess);
-        // Update metrics
-        this._metrics.totalSpawned++;
-        this._metrics.currentlyActive++;
-        // Set up event handlers for lifecycle management
-        this.setupProcessHandlers(managedProcess, mergedConfig);
-        return managedProcess;
-    }
-    /**
-     * Spawn a process with the given configuration
-     *
-     * @param config - Process configuration
-     * @returns ChildProcess instance
-     */
-    spawnProcess(config) {
-        const childProcess = spawn(config.executablePath, config.args, {
-            cwd: config.workDir,
-            stdio: ["pipe", "pipe", "pipe"],
-            env: {
-                ...process.env,
-                ...config.env,
-            },
-        });
-        return childProcess;
-    }
-    /**
-     * Set up event handlers for a managed process
-     *
-     * Handles lifecycle events:
-     * - exit: Process terminated normally or abnormally
-     * - error: Process encountered an error
-     * - stdout/stderr data: Track activity for idle detection
-     *
-     * @param managedProcess - The managed process to set up handlers for
-     * @param config - Process configuration (for timeout)
-     */
-    setupProcessHandlers(managedProcess, config) {
-        const { process: childProcess, id } = managedProcess;
-        let timeoutHandle = null;
-        // Set up timeout if configured
-        if (config.timeout) {
-            timeoutHandle = setTimeout(() => {
-                // Terminate process on timeout using graceful termination
-                if (managedProcess.status === "busy") {
-                    this.terminateProcess(id).catch(() => {
-                        // Ignore errors during timeout termination
-                    });
-                }
-            }, config.timeout);
-        }
-        // Exit event handler
-        childProcess.once("exit", (code, signal) => {
-            // Clear timeout
-            if (timeoutHandle) {
-                clearTimeout(timeoutHandle);
-            }
-            // Update process state
-            managedProcess.exitCode = code;
-            managedProcess.signal = signal;
-            managedProcess.status = code === 0 ? "completed" : "crashed";
-            // Calculate duration
-            const duration = Date.now() - managedProcess.spawnedAt.getTime();
-            managedProcess.metrics.totalDuration = duration;
-            // Update global metrics
-            this._metrics.currentlyActive--;
-            if (code === 0) {
-                this._metrics.totalCompleted++;
-            }
-            else {
-                this._metrics.totalFailed++;
-            }
-            // Calculate average duration
-            const totalProcesses = this._metrics.totalCompleted + this._metrics.totalFailed;
-            if (totalProcesses > 0) {
-                const currentTotal = this._metrics.averageDuration * (totalProcesses - 1);
-                this._metrics.averageDuration =
-                    (currentTotal + duration) / totalProcesses;
-            }
-            // Clean up stdio streams to prevent event loop hang
-            managedProcess.streams.stdin.destroy();
-            managedProcess.streams.stdout.destroy();
-            managedProcess.streams.stderr.destroy();
-            // Schedule cleanup (delete from activeProcesses after 5s delay)
-            const cleanupTimer = setTimeout(() => {
-                this._activeProcesses.delete(id);
-                this._cleanupTimers.delete(id);
-            }, 5000);
-            this._cleanupTimers.set(id, cleanupTimer);
-        });
-        // Error event handler
-        childProcess.once("error", (error) => {
-            void error; // Error is logged but not used here
-            // Clear timeout
-            if (timeoutHandle) {
-                clearTimeout(timeoutHandle);
-            }
-            // Update process state
-            managedProcess.status = "crashed";
-            // Update global metrics
-            this._metrics.currentlyActive--;
-            this._metrics.totalFailed++;
-        });
-        // stdout data handler - track activity
-        childProcess.stdout?.on("data", () => {
-            managedProcess.lastActivity = new Date();
-        });
-        // stderr data handler - track activity
-        childProcess.stderr?.on("data", () => {
-            managedProcess.lastActivity = new Date();
-        });
-    }
-    async releaseProcess(processId) {
-        await this.terminateProcess(processId);
-    }
-    async terminateProcess(processId, signal = "SIGTERM") {
-        const managed = this._activeProcesses.get(processId);
-        if (!managed) {
-            return; // Process not found, nothing to terminate
-        }
-        // If already terminated, do nothing (idempotent)
-        if (managed.exitCode !== null) {
-            return;
-        }
-        // Update status to terminating
-        managed.status = "terminating";
-        // Try graceful shutdown first
-        managed.process.kill(signal);
-        // Wait for process to exit (with 2 second timeout)
-        const exitPromise = new Promise((resolve) => {
-            if (managed.exitCode !== null) {
-                resolve();
-            }
-            else {
-                managed.process.once("exit", () => resolve());
-            }
-        });
-        const timeoutPromise = new Promise((resolve) => {
-            setTimeout(resolve, 2000);
-        });
-        await Promise.race([exitPromise, timeoutPromise]);
-        // Force kill if still running
-        if (managed.exitCode === null) {
-            managed.process.kill("SIGKILL");
-            // Wait for SIGKILL to take effect (with timeout)
-            await Promise.race([
-                new Promise((resolve) => {
-                    if (managed.exitCode !== null) {
-                        resolve();
-                    }
-                    else {
-                        managed.process.once("exit", () => resolve());
-                    }
-                }),
-                new Promise((resolve) => setTimeout(resolve, 1000)),
-            ]);
-        }
-    }
-    async sendInput(processId, input) {
-        const managed = this._activeProcesses.get(processId);
-        if (!managed) {
-            throw new Error(`Process ${processId} not found`);
-        }
-        return new Promise((resolve, reject) => {
-            managed.streams.stdin.write(input, (error) => {
-                if (error)
-                    reject(error);
-                else
-                    resolve();
-            });
-        });
-    }
-    /**
-     * Close stdin stream for a process
-     *
-     * Signals EOF to the process, useful for programs that wait for stdin to close.
-     *
-     * @param processId - ID of the process
-     */
-    closeInput(processId) {
-        const managed = this._activeProcesses.get(processId);
-        if (!managed) {
-            throw new Error(`Process ${processId} not found`);
-        }
-        managed.streams.stdin.end();
-    }
-    onOutput(processId, handler) {
-        const managed = this._activeProcesses.get(processId);
-        if (!managed) {
-            throw new Error(`Process ${processId} not found`);
-        }
-        managed.streams.stdout.on("data", (data) => {
-            handler(data, "stdout");
-        });
-        managed.streams.stderr.on("data", (data) => {
-            handler(data, "stderr");
-        });
-    }
-    onError(processId, handler) {
-        const managed = this._activeProcesses.get(processId);
-        if (!managed) {
-            throw new Error(`Process ${processId} not found`);
-        }
-        managed.process.on("error", (error) => {
-            handler(error);
-        });
-    }
-    getProcess(processId) {
-        return this._activeProcesses.get(processId) || null;
-    }
-    getActiveProcesses() {
-        return Array.from(this._activeProcesses.values());
-    }
-    getMetrics() {
-        // Return a copy to prevent external mutation
-        return { ...this._metrics };
-    }
-    async shutdown() {
-        // Terminate all active processes first
-        const processIds = Array.from(this._activeProcesses.keys());
-        await Promise.all(processIds.map((id) => this.terminateProcess(id, "SIGTERM")));
-        // Clear all pending cleanup timers (including ones scheduled by exit handlers)
-        for (const [id, timer] of this._cleanupTimers.entries()) {
-            clearTimeout(timer);
-            this._cleanupTimers.delete(id);
-        }
-    }
-}
-//# sourceMappingURL=simple-manager.js.map

package/dist/execution/process/simple-manager.js.map

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

package/dist/execution/process/types.d.ts

@@ -1,105 +0,0 @@
-/**
- * Process Layer Types
- *
- * Core types and interfaces for the Process Layer (Layer 1) of the execution system.
- * Defines generic types for managing any CLI tool/agent process lifecycle.
- *
- * @module execution/process/types
- */
-import type { ChildProcess } from 'child_process';
-import type { Readable, Writable } from 'stream';
-/**
- * Status of a managed process throughout its lifecycle
- */
-export type ProcessStatus = 'spawning' | 'idle' | 'busy' | 'terminating' | 'crashed' | 'completed';
-/**
- * Configuration for spawning a new process
- * Generic interface that works with any CLI tool/agent
- */
-export interface ProcessConfig {
-    /** Path to the executable (e.g., 'claude', 'codex', 'node') */
-    executablePath: string;
-    /** Command-line arguments to pass to the executable */
-    args: string[];
-    /** Working directory for the process */
-    workDir: string;
-    /** Environment variables to pass to the process */
-    env?: Record<string, string>;
-    /** Maximum execution time in milliseconds */
-    timeout?: number;
-    /** Maximum idle time before cleanup (pool only) */
-    idleTimeout?: number;
-    /** Retry configuration for failed spawns */
-    retry?: {
-        /** Maximum number of retry attempts */
-        maxAttempts: number;
-        /** Initial backoff delay in milliseconds */
-        backoffMs: number;
-    };
-}
-/**
- * Represents a single managed process instance with its lifecycle state
- * Can be any CLI tool/agent (Claude Code, Codex, Gemini CLI, etc.)
- */
-export interface ManagedProcess {
-    /** Unique process identifier */
-    id: string;
-    /** Operating system process ID */
-    pid: number;
-    /** Current status of the process */
-    status: ProcessStatus;
-    /** When the process was spawned */
-    spawnedAt: Date;
-    /** Last I/O activity timestamp */
-    lastActivity: Date;
-    /** Exit code if process has exited */
-    exitCode: number | null;
-    /** Signal that terminated the process if applicable */
-    signal: string | null;
-    /** Node.js ChildProcess handle */
-    process: ChildProcess;
-    /** Process I/O streams */
-    streams: {
-        stdout: Readable;
-        stderr: Readable;
-        stdin: Writable;
-    };
-    /** Process execution metrics */
-    metrics: {
-        /** Total duration in milliseconds */
-        totalDuration: number;
-        /** Number of tasks completed */
-        tasksCompleted: number;
-        /** Success rate (0-1) */
-        successRate: number;
-    };
-}
-/**
- * Handler for process output (stdout/stderr)
- *
- * @param data - Output data buffer
- * @param type - Stream type
- */
-export type OutputHandler = (data: Buffer, type: 'stdout' | 'stderr') => void;
-/**
- * Handler for process errors
- *
- * @param error - Error that occurred
- */
-export type ErrorHandler = (error: Error) => void;
-/**
- * Aggregate metrics for all processes managed by a ProcessManager
- */
-export interface ProcessMetrics {
-    /** Total number of processes spawned */
-    totalSpawned: number;
-    /** Number of currently active processes */
-    currentlyActive: number;
-    /** Total number of successfully completed processes */
-    totalCompleted: number;
-    /** Total number of failed processes */
-    totalFailed: number;
-    /** Average process duration in milliseconds */
-    averageDuration: number;
-}
-//# sourceMappingURL=types.d.ts.map

package/dist/execution/process/types.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/execution/process/types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAClD,OAAO,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,QAAQ,CAAC;AAEjD;;GAEG;AACH,MAAM,MAAM,aAAa,GACrB,UAAU,GACV,MAAM,GACN,MAAM,GACN,aAAa,GACb,SAAS,GACT,WAAW,CAAC;AAEhB;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B,+DAA+D;IAC/D,cAAc,EAAE,MAAM,CAAC;IAEvB,uDAAuD;IACvD,IAAI,EAAE,MAAM,EAAE,CAAC;IAEf,wCAAwC;IACxC,OAAO,EAAE,MAAM,CAAC;IAEhB,mDAAmD;IACnD,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAE7B,6CAA6C;IAC7C,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB,mDAAmD;IACnD,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,4CAA4C;IAC5C,KAAK,CAAC,EAAE;QACN,uCAAuC;QACvC,WAAW,EAAE,MAAM,CAAC;QACpB,4CAA4C;QAC5C,SAAS,EAAE,MAAM,CAAC;KACnB,CAAC;CACH;AAED;;;GAGG;AACH,MAAM,WAAW,cAAc;IAE7B,gCAAgC;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,kCAAkC;IAClC,GAAG,EAAE,MAAM,CAAC;IAGZ,oCAAoC;IACpC,MAAM,EAAE,aAAa,CAAC;IACtB,mCAAmC;IACnC,SAAS,EAAE,IAAI,CAAC;IAChB,kCAAkC;IAClC,YAAY,EAAE,IAAI,CAAC;IACnB,sCAAsC;IACtC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,uDAAuD;IACvD,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IAGtB,kCAAkC;IAClC,OAAO,EAAE,YAAY,CAAC;IACtB,0BAA0B;IAC1B,OAAO,EAAE;QACP,MAAM,EAAE,QAAQ,CAAC;QACjB,MAAM,EAAE,QAAQ,CAAC;QACjB,KAAK,EAAE,QAAQ,CAAC;KACjB,CAAC;IAGF,gCAAgC;IAChC,OAAO,EAAE;QACP,qCAAqC;QACrC,aAAa,EAAE,MAAM,CAAC;QACtB,gCAAgC;QAChC,cAAc,EAAE,MAAM,CAAC;QACvB,yBAAyB;QACzB,WAAW,EAAE,MAAM,CAAC;KACrB,CAAC;CACH;AAED;;;;;GAKG;AACH,MAAM,MAAM,aAAa,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,GAAG,QAAQ,KAAK,IAAI,CAAC;AAE9E;;;;GAIG;AACH,MAAM,MAAM,YAAY,GAAG,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;AAElD;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,wCAAwC;IACxC,YAAY,EAAE,MAAM,CAAC;IACrB,2CAA2C;IAC3C,eAAe,EAAE,MAAM,CAAC;IACxB,uDAAuD;IACvD,cAAc,EAAE,MAAM,CAAC;IACvB,uCAAuC;IACvC,WAAW,EAAE,MAAM,CAAC;IACpB,+CAA+C;IAC/C,eAAe,EAAE,MAAM,CAAC;CACzB"}

package/dist/execution/process/types.js

@@ -1,10 +0,0 @@
-/**
- * Process Layer Types
- *
- * Core types and interfaces for the Process Layer (Layer 1) of the execution system.
- * Defines generic types for managing any CLI tool/agent process lifecycle.
- *
- * @module execution/process/types
- */
-export {};
-//# sourceMappingURL=types.js.map

package/dist/execution/process/types.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/execution/process/types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG"}

package/dist/execution/process/utils.d.ts

@@ -1,53 +0,0 @@
-/**
- * Process Layer Utilities
- *
- * Helper functions for the Process Layer including ID generation,
- * formatting, and validation utilities.
- *
- * @module execution/process/utils
- */
-/**
- * Generate a unique process ID with a prefix
- *
- * Creates URL-safe, unique identifiers for processes. Uses nanoid for
- * cryptographically strong random IDs.
- *
- * @param prefix - Prefix for the ID (e.g., 'process', 'task')
- * @returns Unique ID string in format: `{prefix}-{randomId}`
- *
- * @example
- * ```typescript
- * const id = generateId('process');
- * // Returns: 'process-a1b2c3d4'
- * ```
- */
-export declare function generateId(prefix: string): string;
-/**
- * Format duration in milliseconds to human-readable string
- *
- * @param ms - Duration in milliseconds
- * @returns Formatted duration string
- *
- * @example
- * ```typescript
- * formatDuration(1500); // "1.5s"
- * formatDuration(65000); // "1m 5s"
- * ```
- */
-export declare function formatDuration(ms: number): string;
-/**
- * Validate that a signal name is valid for Node.js
- *
- * @param signal - Signal name to validate
- * @returns True if signal is valid
- */
-export declare function isValidSignal(signal: string): boolean;
-/**
- * Format error message from process exit
- *
- * @param exitCode - Process exit code
- * @param signal - Signal that terminated the process
- * @returns Formatted error message
- */
-export declare function formatProcessError(exitCode: number | null, signal: string | null): string;
-//# sourceMappingURL=utils.d.ts.map

package/dist/execution/process/utils.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../src/execution/process/utils.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAKjD;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAuBjD;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAUrD;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,MAAM,GAAG,IAAI,EACvB,MAAM,EAAE,MAAM,GAAG,IAAI,GACpB,MAAM,CAQR"}

package/dist/execution/process/utils.js

@@ -1,97 +0,0 @@
-/**
- * Process Layer Utilities
- *
- * Helper functions for the Process Layer including ID generation,
- * formatting, and validation utilities.
- *
- * @module execution/process/utils
- */
-import { customAlphabet } from 'nanoid';
-/**
- * Generate a unique process ID with a prefix
- *
- * Creates URL-safe, unique identifiers for processes. Uses nanoid for
- * cryptographically strong random IDs.
- *
- * @param prefix - Prefix for the ID (e.g., 'process', 'task')
- * @returns Unique ID string in format: `{prefix}-{randomId}`
- *
- * @example
- * ```typescript
- * const id = generateId('process');
- * // Returns: 'process-a1b2c3d4'
- * ```
- */
-export function generateId(prefix) {
-    // Use nanoid with custom alphabet (alphanumeric, lowercase)
-    // 10 characters gives us ~1.5 million years to collision at 1000 IDs/hour
-    const nanoid = customAlphabet('0123456789abcdefghijklmnopqrstuvwxyz', 10);
-    return `${prefix}-${nanoid()}`;
-}
-/**
- * Format duration in milliseconds to human-readable string
- *
- * @param ms - Duration in milliseconds
- * @returns Formatted duration string
- *
- * @example
- * ```typescript
- * formatDuration(1500); // "1.5s"
- * formatDuration(65000); // "1m 5s"
- * ```
- */
-export function formatDuration(ms) {
-    if (ms < 1000) {
-        return `${ms}ms`;
-    }
-    const seconds = Math.floor(ms / 1000);
-    if (seconds < 60) {
-        return `${seconds}s`;
-    }
-    const minutes = Math.floor(seconds / 60);
-    const remainingSeconds = seconds % 60;
-    if (minutes < 60) {
-        return remainingSeconds > 0
-            ? `${minutes}m ${remainingSeconds}s`
-            : `${minutes}m`;
-    }
-    const hours = Math.floor(minutes / 60);
-    const remainingMinutes = minutes % 60;
-    return remainingMinutes > 0
-        ? `${hours}h ${remainingMinutes}m`
-        : `${hours}h`;
-}
-/**
- * Validate that a signal name is valid for Node.js
- *
- * @param signal - Signal name to validate
- * @returns True if signal is valid
- */
-export function isValidSignal(signal) {
-    const validSignals = [
-        'SIGTERM',
-        'SIGKILL',
-        'SIGINT',
-        'SIGHUP',
-        'SIGQUIT',
-        'SIGABRT',
-    ];
-    return validSignals.includes(signal);
-}
-/**
- * Format error message from process exit
- *
- * @param exitCode - Process exit code
- * @param signal - Signal that terminated the process
- * @returns Formatted error message
- */
-export function formatProcessError(exitCode, signal) {
-    if (signal) {
-        return `Process terminated by signal: ${signal}`;
-    }
-    if (exitCode !== null && exitCode !== 0) {
-        return `Process exited with code: ${exitCode}`;
-    }
-    return 'Process exited unexpectedly';
-}
-//# sourceMappingURL=utils.js.map

package/dist/execution/process/utils.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../../src/execution/process/utils.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,QAAQ,CAAC;AAExC;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,UAAU,CAAC,MAAc;IACvC,4DAA4D;IAC5D,0EAA0E;IAC1E,MAAM,MAAM,GAAG,cAAc,CAAC,sCAAsC,EAAE,EAAE,CAAC,CAAC;IAC1E,OAAO,GAAG,MAAM,IAAI,MAAM,EAAE,EAAE,CAAC;AACjC,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,cAAc,CAAC,EAAU;IACvC,IAAI,EAAE,GAAG,IAAI,EAAE,CAAC;QACd,OAAO,GAAG,EAAE,IAAI,CAAC;IACnB,CAAC;IAED,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,GAAG,IAAI,CAAC,CAAC;IACtC,IAAI,OAAO,GAAG,EAAE,EAAE,CAAC;QACjB,OAAO,GAAG,OAAO,GAAG,CAAC;IACvB,CAAC;IAED,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,GAAG,EAAE,CAAC,CAAC;IACzC,MAAM,gBAAgB,GAAG,OAAO,GAAG,EAAE,CAAC;IACtC,IAAI,OAAO,GAAG,EAAE,EAAE,CAAC;QACjB,OAAO,gBAAgB,GAAG,CAAC;YACzB,CAAC,CAAC,GAAG,OAAO,KAAK,gBAAgB,GAAG;YACpC,CAAC,CAAC,GAAG,OAAO,GAAG,CAAC;IACpB,CAAC;IAED,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,GAAG,EAAE,CAAC,CAAC;IACvC,MAAM,gBAAgB,GAAG,OAAO,GAAG,EAAE,CAAC;IACtC,OAAO,gBAAgB,GAAG,CAAC;QACzB,CAAC,CAAC,GAAG,KAAK,KAAK,gBAAgB,GAAG;QAClC,CAAC,CAAC,GAAG,KAAK,GAAG,CAAC;AAClB,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,aAAa,CAAC,MAAc;IAC1C,MAAM,YAAY,GAAG;QACnB,SAAS;QACT,SAAS;QACT,QAAQ;QACR,QAAQ;QACR,SAAS;QACT,SAAS;KACV,CAAC;IACF,OAAO,YAAY,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;AACvC,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,kBAAkB,CAChC,QAAuB,EACvB,MAAqB;IAErB,IAAI,MAAM,EAAE,CAAC;QACX,OAAO,iCAAiC,MAAM,EAAE,CAAC;IACnD,CAAC;IACD,IAAI,QAAQ,KAAK,IAAI,IAAI,QAAQ,KAAK,CAAC,EAAE,CAAC;QACxC,OAAO,6BAA6B,QAAQ,EAAE,CAAC;IACjD,CAAC;IACD,OAAO,6BAA6B,CAAC;AACvC,CAAC"}