@enactprotocol/shared 1.2.13 → 2.0.1

package/dist/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,qDAAqD;AACrD,OAAO,EACL,cAAc,EACd,eAAe,EACf,gBAAgB,EAChB,gBAAgB,EAChB,qBAAqB,EACrB,oBAAoB,GACrB,MAAM,sBAAsB,CAAC;AAE9B,+EAA+E;AAC/E,kDAAkD;AAClD,+EAA+E;AAE/E;;;GAGG;AACH,OAAO,EAAE,cAAc,IAAI,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAClE,MAAM,CAAC,MAAM,aAAa,GAAG,OAAO,CAAC,GAAG,CAAC,aAAa,IAAI,GAAG,QAAQ,MAAM,CAAC;AAE5E;;;GAGG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,OAAO,CAAC,GAAG,CAAC,aAAa,IAAI,QAAQ,CAAC"}

package/dist/execution/command.d.ts

@@ -0,0 +1,102 @@
+/**
+ * Command interpolation and parsing
+ *
+ * Handles ${parameter} substitution in command templates with proper escaping.
+ */
+import type { InterpolationOptions, ParsedCommand } from "./types";
+/**
+ * Parse a command template into tokens
+ *
+ * @param command - Command template with ${parameter} placeholders
+ * @returns Parsed command with tokens and parameter list
+ */
+export declare function parseCommand(command: string): ParsedCommand;
+/**
+ * Shell-escape a value for safe inclusion in a command
+ *
+ * Uses single quotes and handles embedded single quotes.
+ * Example: "it's a test" becomes "'it'\"'\"'s a test'"
+ *
+ * @param value - Value to escape
+ * @returns Shell-safe escaped string
+ */
+export declare function shellEscape(value: string): string;
+/**
+ * Convert a value to string for command interpolation
+ *
+ * Handles different types:
+ * - string: as-is
+ * - number: toString()
+ * - boolean: "true" or "false"
+ * - object/array: JSON.stringify
+ * - null/undefined: empty string
+ *
+ * @param value - Value to convert
+ * @param jsonifyObjects - Whether to JSON-stringify objects
+ * @returns String representation
+ */
+export declare function valueToString(value: unknown, jsonifyObjects?: boolean): string;
+/**
+ * Interpolate a command template with parameter values
+ *
+ * @param command - Command template or parsed command
+ * @param params - Parameter values
+ * @param options - Interpolation options
+ * @returns Interpolated command string
+ * @throws Error if required parameter is missing and onMissing is "error"
+ */
+export declare function interpolateCommand(command: string | ParsedCommand, params: Record<string, unknown>, options?: InterpolationOptions): string;
+/**
+ * Parse a command string respecting quotes
+ *
+ * Splits a command into arguments, respecting single and double quotes.
+ *
+ * @param command - Command string to parse
+ * @returns Array of command arguments
+ */
+export declare function parseCommandArgs(command: string): string[];
+/**
+ * Wrap a command with sh -c for execution
+ *
+ * Useful when the command contains shell features like pipes, redirects, etc.
+ *
+ * @param command - Command to wrap
+ * @returns Arguments for sh -c execution
+ */
+export declare function wrapWithShell(command: string): string[];
+/**
+ * Check if a command needs shell wrapping
+ *
+ * Returns true if the command contains shell special characters.
+ *
+ * @param command - Command to check
+ * @returns Whether the command needs sh -c wrapping
+ */
+export declare function needsShellWrap(command: string): boolean;
+/**
+ * Prepare a command for execution
+ *
+ * Parses the command and determines if it needs shell wrapping.
+ *
+ * @param command - Command template
+ * @param params - Parameter values for interpolation
+ * @param options - Interpolation options
+ * @returns Command ready for execution [program, ...args]
+ */
+export declare function prepareCommand(command: string, params: Record<string, unknown>, options?: InterpolationOptions): string[];
+/**
+ * Validate that all required parameters are provided
+ *
+ * @param command - Parsed command
+ * @param params - Provided parameters
+ * @returns Array of missing parameter names
+ */
+export declare function getMissingParams(command: string | ParsedCommand, params: Record<string, unknown>): string[];
+/**
+ * Get all parameters in a command template
+ *
+ * @param command - Command template
+ * @returns Array of parameter names
+ */
+export declare function getCommandParams(command: string): string[];
+//# sourceMappingURL=command.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"command.d.ts","sourceRoot":"","sources":["../../src/execution/command.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAgB,oBAAoB,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAOjF;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,aAAa,CAkD3D;AAED;;;;;;;;GAQG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAejD;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,EAAE,cAAc,UAAO,GAAG,MAAM,CAkB3E;AAED;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,MAAM,GAAG,aAAa,EAC/B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,OAAO,GAAE,oBAAyB,GACjC,MAAM,CAiCR;AAED;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,CAgD1D;AAED;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,CAEvD;AAED;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAGvD;AAED;;;;;;;;;GASG;AACH,wBAAgB,cAAc,CAC5B,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,OAAO,GAAE,oBAAyB,GACjC,MAAM,EAAE,CAWV;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,MAAM,GAAG,aAAa,EAC/B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC9B,MAAM,EAAE,CAIV;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,CAE1D"}

package/dist/execution/command.js

@@ -0,0 +1,262 @@
+/**
+ * Command interpolation and parsing
+ *
+ * Handles ${parameter} substitution in command templates with proper escaping.
+ */
+/**
+ * Pattern to match ${parameter} in command strings
+ */
+const PARAM_PATTERN = /\$\{([^}]+)\}/g;
+/**
+ * Parse a command template into tokens
+ *
+ * @param command - Command template with ${parameter} placeholders
+ * @returns Parsed command with tokens and parameter list
+ */
+export function parseCommand(command) {
+    const tokens = [];
+    const parameters = [];
+    let lastIndex = 0;
+    let match = null;
+    // Reset regex state
+    PARAM_PATTERN.lastIndex = 0;
+    match = PARAM_PATTERN.exec(command);
+    while (match !== null) {
+        // Add literal text before this match
+        if (match.index > lastIndex) {
+            tokens.push({
+                type: "literal",
+                value: command.slice(lastIndex, match.index),
+            });
+        }
+        // Add the parameter token
+        const paramName = match[1];
+        if (paramName) {
+            tokens.push({
+                type: "parameter",
+                name: paramName,
+            });
+            if (!parameters.includes(paramName)) {
+                parameters.push(paramName);
+            }
+        }
+        lastIndex = match.index + match[0].length;
+        match = PARAM_PATTERN.exec(command);
+    }
+    // Add any remaining literal text
+    if (lastIndex < command.length) {
+        tokens.push({
+            type: "literal",
+            value: command.slice(lastIndex),
+        });
+    }
+    return {
+        original: command,
+        tokens,
+        parameters,
+    };
+}
+/**
+ * Shell-escape a value for safe inclusion in a command
+ *
+ * Uses single quotes and handles embedded single quotes.
+ * Example: "it's a test" becomes "'it'\"'\"'s a test'"
+ *
+ * @param value - Value to escape
+ * @returns Shell-safe escaped string
+ */
+export function shellEscape(value) {
+    // If the value is empty, return empty quoted string
+    if (value === "") {
+        return "''";
+    }
+    // If value contains no special characters, return as-is
+    if (/^[a-zA-Z0-9._\-/]+$/.test(value)) {
+        return value;
+    }
+    // Use single quotes, escaping any embedded single quotes
+    // The technique: end quote, add escaped quote, start new quote
+    // 'it'"'"'s' means: 'it' + "'" + 's'
+    return `'${value.replace(/'/g, "'\"'\"'")}'`;
+}
+/**
+ * Convert a value to string for command interpolation
+ *
+ * Handles different types:
+ * - string: as-is
+ * - number: toString()
+ * - boolean: "true" or "false"
+ * - object/array: JSON.stringify
+ * - null/undefined: empty string
+ *
+ * @param value - Value to convert
+ * @param jsonifyObjects - Whether to JSON-stringify objects
+ * @returns String representation
+ */
+export function valueToString(value, jsonifyObjects = true) {
+    if (value === null || value === undefined) {
+        return "";
+    }
+    if (typeof value === "string") {
+        return value;
+    }
+    if (typeof value === "number" || typeof value === "boolean") {
+        return String(value);
+    }
+    if (jsonifyObjects && (typeof value === "object" || Array.isArray(value))) {
+        return JSON.stringify(value);
+    }
+    return String(value);
+}
+/**
+ * Interpolate a command template with parameter values
+ *
+ * @param command - Command template or parsed command
+ * @param params - Parameter values
+ * @param options - Interpolation options
+ * @returns Interpolated command string
+ * @throws Error if required parameter is missing and onMissing is "error"
+ */
+export function interpolateCommand(command, params, options = {}) {
+    const { escape: shouldEscape = true, jsonifyObjects = true, onMissing = "error" } = options;
+    const parsed = typeof command === "string" ? parseCommand(command) : command;
+    const parts = [];
+    for (const token of parsed.tokens) {
+        if (token.type === "literal") {
+            parts.push(token.value);
+        }
+        else {
+            const paramName = token.name;
+            const value = params[paramName];
+            if (value === undefined) {
+                switch (onMissing) {
+                    case "error":
+                        throw new Error(`Missing required parameter: ${paramName}`);
+                    case "empty":
+                        parts.push("");
+                        break;
+                    case "keep":
+                        parts.push(`\${${paramName}}`);
+                        break;
+                }
+            }
+            else {
+                const stringValue = valueToString(value, jsonifyObjects);
+                parts.push(shouldEscape ? shellEscape(stringValue) : stringValue);
+            }
+        }
+    }
+    return parts.join("");
+}
+/**
+ * Parse a command string respecting quotes
+ *
+ * Splits a command into arguments, respecting single and double quotes.
+ *
+ * @param command - Command string to parse
+ * @returns Array of command arguments
+ */
+export function parseCommandArgs(command) {
+    const args = [];
+    let current = "";
+    let inSingleQuote = false;
+    let inDoubleQuote = false;
+    let escapeNext = false;
+    for (let i = 0; i < command.length; i++) {
+        const char = command[i];
+        if (escapeNext) {
+            current += char;
+            escapeNext = false;
+            continue;
+        }
+        if (char === "\\") {
+            escapeNext = true;
+            continue;
+        }
+        if (char === "'" && !inDoubleQuote) {
+            inSingleQuote = !inSingleQuote;
+            continue;
+        }
+        if (char === '"' && !inSingleQuote) {
+            inDoubleQuote = !inDoubleQuote;
+            continue;
+        }
+        if (char === " " && !inSingleQuote && !inDoubleQuote) {
+            if (current.length > 0) {
+                args.push(current);
+                current = "";
+            }
+            continue;
+        }
+        current += char;
+    }
+    // Add the last argument
+    if (current.length > 0) {
+        args.push(current);
+    }
+    return args;
+}
+/**
+ * Wrap a command with sh -c for execution
+ *
+ * Useful when the command contains shell features like pipes, redirects, etc.
+ *
+ * @param command - Command to wrap
+ * @returns Arguments for sh -c execution
+ */
+export function wrapWithShell(command) {
+    return ["sh", "-c", command];
+}
+/**
+ * Check if a command needs shell wrapping
+ *
+ * Returns true if the command contains shell special characters.
+ *
+ * @param command - Command to check
+ * @returns Whether the command needs sh -c wrapping
+ */
+export function needsShellWrap(command) {
+    // Check for shell operators and features
+    return /[|&;<>()$`\\"\n*?[\]#~=%]/.test(command);
+}
+/**
+ * Prepare a command for execution
+ *
+ * Parses the command and determines if it needs shell wrapping.
+ *
+ * @param command - Command template
+ * @param params - Parameter values for interpolation
+ * @param options - Interpolation options
+ * @returns Command ready for execution [program, ...args]
+ */
+export function prepareCommand(command, params, options = {}) {
+    // Interpolate parameters
+    const interpolated = interpolateCommand(command, params, options);
+    // Check if we need shell wrapping
+    if (needsShellWrap(interpolated)) {
+        return wrapWithShell(interpolated);
+    }
+    // Parse into arguments
+    return parseCommandArgs(interpolated);
+}
+/**
+ * Validate that all required parameters are provided
+ *
+ * @param command - Parsed command
+ * @param params - Provided parameters
+ * @returns Array of missing parameter names
+ */
+export function getMissingParams(command, params) {
+    const parsed = typeof command === "string" ? parseCommand(command) : command;
+    return parsed.parameters.filter((param) => params[param] === undefined);
+}
+/**
+ * Get all parameters in a command template
+ *
+ * @param command - Command template
+ * @returns Array of parameter names
+ */
+export function getCommandParams(command) {
+    return parseCommand(command).parameters;
+}
+//# sourceMappingURL=command.js.map

package/dist/execution/command.js.map

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

package/dist/execution/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Execution Engine Module
+ *
+ * Provides containerized tool execution using the Dagger SDK.
+ * This is the main entry point for Phase 3 of Enact CLI 2.0.
+ */
+export type { ExecutionInput, FileInput, ExecutionOutput, ExecutionResult, ExecutionMetadata, ExecutionError, ExecutionErrorCode, ExecutionOptions, RetryConfig, ContainerRuntime, RuntimeDetection, RuntimeStatus, EngineHealth, EngineState, ExecutionProvider, ParsedCommand, CommandToken, InterpolationOptions, InputValidationResult, InputValidationError, DryRunResult, } from "./types.js";
+export { DEFAULT_RETRY_CONFIG } from "./types.js";
+export { detectRuntime, clearRuntimeCache, isRuntimeAvailable, getAvailableRuntimes, RuntimeStatusTracker, createRuntimeTracker, } from "./runtime.js";
+export { parseCommand, interpolateCommand, shellEscape, parseCommandArgs, prepareCommand, getMissingParams, } from "./command.js";
+export { validateInputs, applyDefaults, getRequiredParams, getParamInfo, } from "./validation.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/execution/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,YAAY,EAEV,cAAc,EACd,SAAS,EACT,eAAe,EACf,eAAe,EACf,iBAAiB,EACjB,cAAc,EACd,kBAAkB,EAElB,gBAAgB,EAChB,WAAW,EAEX,gBAAgB,EAChB,gBAAgB,EAChB,aAAa,EAEb,YAAY,EACZ,WAAW,EAEX,iBAAiB,EAEjB,aAAa,EACb,YAAY,EACZ,oBAAoB,EAEpB,qBAAqB,EACrB,oBAAoB,EAEpB,YAAY,GACb,MAAM,YAAY,CAAC;AAGpB,OAAO,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAGlD,OAAO,EACL,aAAa,EACb,iBAAiB,EACjB,kBAAkB,EAClB,oBAAoB,EACpB,oBAAoB,EACpB,oBAAoB,GACrB,MAAM,cAAc,CAAC;AAGtB,OAAO,EACL,YAAY,EACZ,kBAAkB,EAClB,WAAW,EACX,gBAAgB,EAChB,cAAc,EACd,gBAAgB,GACjB,MAAM,cAAc,CAAC;AAGtB,OAAO,EACL,cAAc,EACd,aAAa,EACb,iBAAiB,EACjB,YAAY,GACb,MAAM,iBAAiB,CAAC"}

package/dist/execution/index.js

@@ -0,0 +1,17 @@
+/**
+ * Execution Engine Module
+ *
+ * Provides containerized tool execution using the Dagger SDK.
+ * This is the main entry point for Phase 3 of Enact CLI 2.0.
+ */
+// Constants
+export { DEFAULT_RETRY_CONFIG } from "./types.js";
+// Runtime detection
+export { detectRuntime, clearRuntimeCache, isRuntimeAvailable, getAvailableRuntimes, RuntimeStatusTracker, createRuntimeTracker, } from "./runtime.js";
+// Command interpolation
+export { parseCommand, interpolateCommand, shellEscape, parseCommandArgs, prepareCommand, getMissingParams, } from "./command.js";
+// Input validation
+export { validateInputs, applyDefaults, getRequiredParams, getParamInfo, } from "./validation.js";
+// NOTE: Dagger provider moved to @enactprotocol/execution package
+// This keeps @enactprotocol/shared browser-safe (no Dagger SDK dependency)
+//# sourceMappingURL=index.js.map

package/dist/execution/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/execution/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAmCH,YAAY;AACZ,OAAO,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAElD,oBAAoB;AACpB,OAAO,EACL,aAAa,EACb,iBAAiB,EACjB,kBAAkB,EAClB,oBAAoB,EACpB,oBAAoB,EACpB,oBAAoB,GACrB,MAAM,cAAc,CAAC;AAEtB,wBAAwB;AACxB,OAAO,EACL,YAAY,EACZ,kBAAkB,EAClB,WAAW,EACX,gBAAgB,EAChB,cAAc,EACd,gBAAgB,GACjB,MAAM,cAAc,CAAC;AAEtB,mBAAmB;AACnB,OAAO,EACL,cAAc,EACd,aAAa,EACb,iBAAiB,EACjB,YAAY,GACb,MAAM,iBAAiB,CAAC;AAEzB,kEAAkE;AAClE,2EAA2E"}

package/dist/execution/runtime.d.ts

@@ -0,0 +1,82 @@
+/**
+ * Container runtime detection
+ *
+ * Auto-detects available container runtimes (docker, podman, nerdctl)
+ * and provides runtime status monitoring.
+ */
+import type { ContainerRuntime, RuntimeDetection, RuntimeStatus } from "./types";
+/**
+ * Detect available container runtime
+ *
+ * Checks for docker, podman, and nerdctl in order of preference.
+ * Results are cached for 1 minute.
+ *
+ * @returns Detection result with runtime info or error
+ */
+export declare function detectRuntime(): RuntimeDetection;
+/**
+ * Clear the cached detection result
+ * Useful after installing a runtime
+ */
+export declare function clearRuntimeCache(): void;
+/**
+ * Force detection of a specific runtime
+ *
+ * @param runtime - The runtime to check
+ * @returns Whether the runtime is available
+ */
+export declare function isRuntimeAvailable(runtime: ContainerRuntime): boolean;
+/**
+ * Get all available runtimes
+ *
+ * @returns Array of available runtimes
+ */
+export declare function getAvailableRuntimes(): ContainerRuntime[];
+/**
+ * Runtime status tracker for health monitoring
+ */
+export declare class RuntimeStatusTracker {
+    private status;
+    private healthCheckInterval;
+    constructor(runtime: ContainerRuntime);
+    /**
+     * Record a successful operation
+     */
+    recordSuccess(): void;
+    /**
+     * Record a failed operation
+     *
+     * @returns Whether the engine should be reset (3+ consecutive failures)
+     */
+    recordFailure(): boolean;
+    /**
+     * Get current status
+     */
+    getStatus(): RuntimeStatus;
+    /**
+     * Check if engine needs reset
+     */
+    needsReset(): boolean;
+    /**
+     * Reset failure count after engine restart
+     */
+    resetFailureCount(): void;
+    /**
+     * Start periodic health checks
+     *
+     * @param intervalMs - Check interval in milliseconds (default: 60000)
+     * @param onUnhealthy - Callback when engine becomes unhealthy
+     */
+    startHealthChecks(intervalMs?: number, onUnhealthy?: (status: RuntimeStatus) => void): void;
+    /**
+     * Stop periodic health checks
+     */
+    stopHealthChecks(): void;
+}
+/**
+ * Create a runtime status tracker for the detected runtime
+ *
+ * @returns Status tracker or null if no runtime found
+ */
+export declare function createRuntimeTracker(): RuntimeStatusTracker | null;
+//# sourceMappingURL=runtime.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../../src/execution/runtime.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAoFjF;;;;;;;GAOG;AACH,wBAAgB,aAAa,IAAI,gBAAgB,CAgChD;AAsCD;;;GAGG;AACH,wBAAgB,iBAAiB,IAAI,IAAI,CAGxC;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAErE;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,IAAI,gBAAgB,EAAE,CAEzD;AAED;;GAEG;AACH,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,MAAM,CAAgB;IAC9B,OAAO,CAAC,mBAAmB,CAA+C;gBAE9D,OAAO,EAAE,gBAAgB;IAUrC;;OAEG;IACH,aAAa,IAAI,IAAI;IAMrB;;;;OAIG;IACH,aAAa,IAAI,OAAO;IAYxB;;OAEG;IACH,SAAS,IAAI,aAAa;IAI1B;;OAEG;IACH,UAAU,IAAI,OAAO;IAIrB;;OAEG;IACH,iBAAiB,IAAI,IAAI;IAKzB;;;;;OAKG;IACH,iBAAiB,CAAC,UAAU,SAAQ,EAAE,WAAW,CAAC,EAAE,CAAC,MAAM,EAAE,aAAa,KAAK,IAAI,GAAG,IAAI;IAgB1F;;OAEG;IACH,gBAAgB,IAAI,IAAI;CAMzB;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,IAAI,oBAAoB,GAAG,IAAI,CAMlE"}