@enactprotocol/shared 1.2.13 → 2.0.1

package/dist/execution/runtime.js

@@ -0,0 +1,273 @@
+/**
+ * Container runtime detection
+ *
+ * Auto-detects available container runtimes (docker, podman, nerdctl)
+ * and provides runtime status monitoring.
+ */
+import { spawnSync } from "node:child_process";
+/**
+ * Order of preference for container runtime detection
+ */
+const RUNTIME_PREFERENCE = ["docker", "podman", "nerdctl"];
+/**
+ * Runtime-specific version commands
+ */
+const VERSION_COMMANDS = {
+    docker: ["docker", "--version"],
+    podman: ["podman", "--version"],
+    nerdctl: ["nerdctl", "--version"],
+};
+/**
+ * Cached detection result
+ */
+let cachedDetection = null;
+let cachedDetectionTime = 0;
+const CACHE_TTL_MS = 60000; // 1 minute
+/**
+ * Check if a command is available in PATH
+ */
+function commandExists(command) {
+    try {
+        const result = spawnSync("which", [command], {
+            encoding: "utf-8",
+            timeout: 5000,
+        });
+        return result.status === 0 && result.stdout.trim().length > 0;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Get the version of a container runtime
+ */
+function getRuntimeVersion(runtime) {
+    try {
+        const versionCmd = VERSION_COMMANDS[runtime];
+        const cmd = versionCmd[0];
+        if (!cmd)
+            return undefined;
+        const args = versionCmd.slice(1);
+        const result = spawnSync(cmd, args, {
+            encoding: "utf-8",
+            timeout: 5000,
+        });
+        if (result.status === 0) {
+            // Parse version from output
+            // Docker: "Docker version 24.0.6, build ed223bc"
+            // Podman: "podman version 4.5.1"
+            // nerdctl: "nerdctl version 1.5.0"
+            const match = result.stdout.match(/(\d+\.\d+\.\d+)/);
+            return match?.[1];
+        }
+    }
+    catch {
+        // Ignore errors
+    }
+    return undefined;
+}
+/**
+ * Get the path to a runtime binary
+ */
+function getRuntimePath(runtime) {
+    try {
+        const result = spawnSync("which", [runtime], {
+            encoding: "utf-8",
+            timeout: 5000,
+        });
+        if (result.status === 0) {
+            return result.stdout.trim();
+        }
+    }
+    catch {
+        // Ignore errors
+    }
+    return undefined;
+}
+/**
+ * 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 function detectRuntime() {
+    // Return cached result if still valid
+    const now = Date.now();
+    if (cachedDetection && now - cachedDetectionTime < CACHE_TTL_MS) {
+        return cachedDetection;
+    }
+    for (const runtime of RUNTIME_PREFERENCE) {
+        if (commandExists(runtime)) {
+            const version = getRuntimeVersion(runtime);
+            const path = getRuntimePath(runtime);
+            const result = {
+                found: true,
+                runtime,
+            };
+            if (path)
+                result.path = path;
+            if (version)
+                result.version = version;
+            cachedDetection = result;
+            cachedDetectionTime = now;
+            return result;
+        }
+    }
+    const notFoundResult = {
+        found: false,
+        error: getInstallInstructions(),
+    };
+    cachedDetection = notFoundResult;
+    cachedDetectionTime = now;
+    return notFoundResult;
+}
+/**
+ * Get helpful installation instructions when no runtime is found
+ */
+function getInstallInstructions() {
+    const platform = process.platform;
+    if (platform === "darwin") {
+        return ("No container runtime found. Install Docker Desktop:\n" +
+            "  brew install --cask docker\n" +
+            "Or install Podman:\n" +
+            "  brew install podman");
+    }
+    if (platform === "linux") {
+        return ("No container runtime found. Install Docker:\n" +
+            "  curl -fsSL https://get.docker.com | sh\n" +
+            "Or install Podman:\n" +
+            "  sudo apt install podman  # Debian/Ubuntu\n" +
+            "  sudo dnf install podman  # Fedora/RHEL");
+    }
+    if (platform === "win32") {
+        return ("No container runtime found. Install Docker Desktop:\n" +
+            "  winget install Docker.DockerDesktop\n" +
+            "Or download from: https://www.docker.com/products/docker-desktop");
+    }
+    return "No container runtime found. Please install Docker, Podman, or nerdctl.";
+}
+/**
+ * Clear the cached detection result
+ * Useful after installing a runtime
+ */
+export function clearRuntimeCache() {
+    cachedDetection = null;
+    cachedDetectionTime = 0;
+}
+/**
+ * Force detection of a specific runtime
+ *
+ * @param runtime - The runtime to check
+ * @returns Whether the runtime is available
+ */
+export function isRuntimeAvailable(runtime) {
+    return commandExists(runtime);
+}
+/**
+ * Get all available runtimes
+ *
+ * @returns Array of available runtimes
+ */
+export function getAvailableRuntimes() {
+    return RUNTIME_PREFERENCE.filter((runtime) => commandExists(runtime));
+}
+/**
+ * Runtime status tracker for health monitoring
+ */
+export class RuntimeStatusTracker {
+    status;
+    healthCheckInterval = null;
+    constructor(runtime) {
+        this.status = {
+            available: true,
+            runtime,
+            engineHealthy: true,
+            lastHealthCheck: new Date(),
+            failureCount: 0,
+        };
+    }
+    /**
+     * Record a successful operation
+     */
+    recordSuccess() {
+        this.status.failureCount = 0;
+        this.status.engineHealthy = true;
+        this.status.lastHealthCheck = new Date();
+    }
+    /**
+     * Record a failed operation
+     *
+     * @returns Whether the engine should be reset (3+ consecutive failures)
+     */
+    recordFailure() {
+        this.status.failureCount++;
+        this.status.lastHealthCheck = new Date();
+        if (this.status.failureCount >= 3) {
+            this.status.engineHealthy = false;
+            return true; // Engine needs reset
+        }
+        return false;
+    }
+    /**
+     * Get current status
+     */
+    getStatus() {
+        return { ...this.status };
+    }
+    /**
+     * Check if engine needs reset
+     */
+    needsReset() {
+        return this.status.failureCount >= 3;
+    }
+    /**
+     * Reset failure count after engine restart
+     */
+    resetFailureCount() {
+        this.status.failureCount = 0;
+        this.status.engineHealthy = true;
+    }
+    /**
+     * Start periodic health checks
+     *
+     * @param intervalMs - Check interval in milliseconds (default: 60000)
+     * @param onUnhealthy - Callback when engine becomes unhealthy
+     */
+    startHealthChecks(intervalMs = 60000, onUnhealthy) {
+        if (this.healthCheckInterval) {
+            clearInterval(this.healthCheckInterval);
+        }
+        this.healthCheckInterval = setInterval(() => {
+            const detection = detectRuntime();
+            this.status.available = detection.found;
+            this.status.lastHealthCheck = new Date();
+            if (!detection.found || !this.status.engineHealthy) {
+                onUnhealthy?.(this.status);
+            }
+        }, intervalMs);
+    }
+    /**
+     * Stop periodic health checks
+     */
+    stopHealthChecks() {
+        if (this.healthCheckInterval) {
+            clearInterval(this.healthCheckInterval);
+            this.healthCheckInterval = null;
+        }
+    }
+}
+/**
+ * Create a runtime status tracker for the detected runtime
+ *
+ * @returns Status tracker or null if no runtime found
+ */
+export function createRuntimeTracker() {
+    const detection = detectRuntime();
+    if (!detection.found || !detection.runtime) {
+        return null;
+    }
+    return new RuntimeStatusTracker(detection.runtime);
+}
+//# sourceMappingURL=runtime.js.map

package/dist/execution/runtime.js.map

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

package/dist/execution/types.d.ts

@@ -0,0 +1,306 @@
+/**
+ * Type definitions for the Enact execution engine
+ * Provides interfaces for tool execution, container management, and results
+ */
+import type { ToolManifest } from "../types/manifest";
+/**
+ * Input to a tool execution
+ */
+export interface ExecutionInput {
+    /** Input parameters (key-value pairs) */
+    params: Record<string, unknown>;
+    /** Files to mount into the container (path -> content/source) */
+    files?: Record<string, FileInput>;
+    /** Secret overrides (secret name -> Dagger URI) */
+    secretOverrides?: Record<string, string>;
+    /** Environment variable overrides */
+    envOverrides?: Record<string, string>;
+}
+/**
+ * File input for execution
+ */
+export interface FileInput {
+    /** File content (string or Buffer) */
+    content?: string | Buffer;
+    /** Path to source file on host */
+    sourcePath?: string;
+    /** Target path in container */
+    targetPath: string;
+}
+/**
+ * Output from a tool execution
+ */
+export interface ExecutionOutput {
+    /** Standard output from the container */
+    stdout: string;
+    /** Standard error from the container */
+    stderr: string;
+    /** Exit code from the container */
+    exitCode: number;
+    /** Parsed output (if outputSchema is defined and output is JSON) */
+    parsed?: unknown;
+    /** Files extracted from the container */
+    files?: Record<string, Buffer>;
+}
+/**
+ * Result of a tool execution
+ */
+export interface ExecutionResult {
+    /** Whether the execution was successful */
+    success: boolean;
+    /** Output from the execution */
+    output: ExecutionOutput;
+    /** Execution metadata */
+    metadata: ExecutionMetadata;
+    /** Error information (if failed) */
+    error?: ExecutionError;
+}
+/**
+ * Metadata about the execution
+ */
+export interface ExecutionMetadata {
+    /** Tool name */
+    toolName: string;
+    /** Tool version (if available) */
+    toolVersion?: string;
+    /** Container image used */
+    containerImage: string;
+    /** Start time */
+    startTime: Date;
+    /** End time */
+    endTime: Date;
+    /** Duration in milliseconds */
+    durationMs: number;
+    /** Whether the result came from cache */
+    cached: boolean;
+    /** Execution ID for tracking */
+    executionId: string;
+}
+/**
+ * Error codes for execution failures
+ */
+export type ExecutionErrorCode = "TIMEOUT" | "CONTAINER_ERROR" | "VALIDATION_ERROR" | "SECRET_ERROR" | "NETWORK_ERROR" | "RUNTIME_NOT_FOUND" | "ENGINE_ERROR" | "COMMAND_ERROR" | "UNKNOWN";
+/**
+ * Execution error with details
+ */
+export interface ExecutionError {
+    /** Error code for programmatic handling */
+    code: ExecutionErrorCode;
+    /** Human-readable error message */
+    message: string;
+    /** Stack trace (if available) */
+    stack?: string;
+    /** Additional error details */
+    details?: Record<string, unknown>;
+    /** Suggested action to resolve */
+    suggestion?: string;
+}
+/**
+ * Options for tool execution
+ */
+export interface ExecutionOptions {
+    /** Timeout override (default from manifest or 30s) */
+    timeout?: string;
+    /** Working directory in container */
+    workdir?: string;
+    /** Whether to stream output in real-time */
+    stream?: boolean;
+    /** Callback for streaming output */
+    onOutput?: (type: "stdout" | "stderr", data: string) => void;
+    /** Whether to disable network access */
+    networkDisabled?: boolean;
+    /** Additional environment variables */
+    additionalEnv?: Record<string, string>;
+    /** Mount host directories (host path -> container path) */
+    mountDirs?: Record<string, string>;
+    /** Output files to extract (container path) */
+    outputFiles?: string[];
+    /** Retry configuration */
+    retry?: RetryConfig;
+    /** Dry run mode (don't actually execute) */
+    dryRun?: boolean;
+}
+/**
+ * Retry configuration for transient failures
+ */
+export interface RetryConfig {
+    /** Maximum number of retries */
+    maxRetries: number;
+    /** Initial delay in ms (for exponential backoff) */
+    initialDelayMs: number;
+    /** Maximum delay in ms */
+    maxDelayMs: number;
+    /** Error codes that should trigger a retry */
+    retryableCodes: ExecutionErrorCode[];
+}
+/**
+ * Default retry configuration
+ */
+export declare const DEFAULT_RETRY_CONFIG: RetryConfig;
+/**
+ * Supported container runtimes
+ */
+export type ContainerRuntime = "docker" | "podman" | "nerdctl";
+/**
+ * Container runtime detection result
+ */
+export interface RuntimeDetection {
+    /** Whether a runtime was found */
+    found: boolean;
+    /** The detected runtime */
+    runtime?: ContainerRuntime;
+    /** Path to the runtime binary */
+    path?: string;
+    /** Runtime version */
+    version?: string;
+    /** Error if detection failed */
+    error?: string;
+}
+/**
+ * Container runtime status
+ */
+export interface RuntimeStatus {
+    /** Whether the runtime is available */
+    available: boolean;
+    /** The runtime in use */
+    runtime: ContainerRuntime;
+    /** Whether the engine is healthy */
+    engineHealthy: boolean;
+    /** Last health check time */
+    lastHealthCheck: Date;
+    /** Consecutive failure count */
+    failureCount: number;
+}
+/**
+ * Engine health check result
+ */
+export interface EngineHealth {
+    /** Whether the engine is healthy */
+    healthy: boolean;
+    /** Container runtime being used */
+    runtime: ContainerRuntime;
+    /** Engine version */
+    version?: string;
+    /** Last successful operation time */
+    lastSuccess?: Date;
+    /** Consecutive failure count */
+    consecutiveFailures: number;
+    /** Error message if unhealthy */
+    error?: string;
+}
+/**
+ * Engine state for tracking health
+ */
+export interface EngineState {
+    /** Current health status */
+    health: EngineHealth;
+    /** Whether engine needs reset */
+    needsReset: boolean;
+    /** Time of last reset */
+    lastReset?: Date;
+    /** Total executions */
+    totalExecutions: number;
+    /** Successful executions */
+    successfulExecutions: number;
+}
+/**
+ * Interface for execution providers
+ * Allows for different implementations (Dagger, mock, etc.)
+ */
+export interface ExecutionProvider {
+    /** Provider name */
+    readonly name: string;
+    /** Initialize the provider */
+    initialize(): Promise<void>;
+    /** Check if the provider is available */
+    isAvailable(): Promise<boolean>;
+    /** Get provider health status */
+    getHealth(): Promise<EngineHealth>;
+    /** Execute a tool */
+    execute(manifest: ToolManifest, input: ExecutionInput, options?: ExecutionOptions): Promise<ExecutionResult>;
+    /** Execute a raw command in a tool's container */
+    exec(manifest: ToolManifest, command: string, options?: ExecutionOptions): Promise<ExecutionResult>;
+    /** Shutdown the provider */
+    shutdown(): Promise<void>;
+}
+/**
+ * Parsed command with tokens
+ */
+export interface ParsedCommand {
+    /** Original command string */
+    original: string;
+    /** Parsed tokens (strings and parameters) */
+    tokens: CommandToken[];
+    /** Parameters found in the command */
+    parameters: string[];
+}
+/**
+ * A token in a parsed command
+ */
+export type CommandToken = {
+    type: "literal";
+    value: string;
+} | {
+    type: "parameter";
+    name: string;
+};
+/**
+ * Command interpolation options
+ */
+export interface InterpolationOptions {
+    /** Whether to shell-escape values */
+    escape?: boolean;
+    /** Whether to JSON-stringify objects */
+    jsonifyObjects?: boolean;
+    /** Missing parameter handling */
+    onMissing?: "error" | "empty" | "keep";
+}
+/**
+ * Result of input validation
+ */
+export interface InputValidationResult {
+    /** Whether inputs are valid */
+    valid: boolean;
+    /** Validation errors */
+    errors: InputValidationError[];
+    /** Coerced/normalized values */
+    coercedValues?: Record<string, unknown>;
+}
+/**
+ * Input validation error
+ */
+export interface InputValidationError {
+    /** Parameter path (e.g., "params.name" or "params.config.timeout") */
+    path: string;
+    /** Error message */
+    message: string;
+    /** Expected type or format */
+    expected?: string;
+    /** Actual value received */
+    actual?: unknown;
+}
+/**
+ * Dry run result showing what would be executed
+ */
+export interface DryRunResult {
+    /** Tool name */
+    toolName: string;
+    /** Container image that would be used */
+    containerImage: string;
+    /** Interpolated command that would run */
+    command: string;
+    /** Environment variables that would be set (secrets masked) */
+    environment: Record<string, string>;
+    /** Secrets that would be injected (names only) */
+    secrets: string[];
+    /** Files that would be mounted */
+    mounts: Array<{
+        source: string;
+        target: string;
+    }>;
+    /** Timeout that would be applied */
+    timeout: string;
+    /** Input validation result */
+    validation: InputValidationResult;
+}
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/execution/types.js

@@ -0,0 +1,14 @@
+/**
+ * Type definitions for the Enact execution engine
+ * Provides interfaces for tool execution, container management, and results
+ */
+/**
+ * Default retry configuration
+ */
+export const DEFAULT_RETRY_CONFIG = {
+    maxRetries: 3,
+    initialDelayMs: 1000,
+    maxDelayMs: 8000,
+    retryableCodes: ["NETWORK_ERROR", "ENGINE_ERROR", "TIMEOUT"],
+};
+//# sourceMappingURL=types.js.map

package/dist/execution/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/execution/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAgKH;;GAEG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAgB;IAC/C,UAAU,EAAE,CAAC;IACb,cAAc,EAAE,IAAI;IACpB,UAAU,EAAE,IAAI;IAChB,cAAc,EAAE,CAAC,eAAe,EAAE,cAAc,EAAE,SAAS,CAAC;CAC7D,CAAC"}

package/dist/execution/validation.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Input validation using JSON Schema
+ *
+ * Validates tool inputs against the manifest's inputSchema.
+ */
+import type { JSONSchema7 } from "json-schema";
+import type { InputValidationResult } from "./types";
+/**
+ * Validate inputs against a JSON Schema
+ *
+ * @param inputs - The inputs to validate
+ * @param schema - The JSON Schema to validate against
+ * @returns Validation result with errors and coerced values
+ */
+export declare function validateInputs(inputs: Record<string, unknown>, schema: JSONSchema7 | undefined): InputValidationResult;
+/**
+ * Apply default values from schema to inputs
+ *
+ * @param inputs - Current inputs
+ * @param schema - Input schema with defaults
+ * @returns Inputs with defaults applied
+ */
+export declare function applyDefaults(inputs: Record<string, unknown>, schema: JSONSchema7 | undefined): Record<string, unknown>;
+/**
+ * Get the list of required parameters from a schema
+ *
+ * @param schema - Input schema
+ * @returns Array of required parameter names
+ */
+export declare function getRequiredParams(schema: JSONSchema7 | undefined): string[];
+/**
+ * Get parameter info from schema for help/documentation
+ *
+ * @param schema - Input schema
+ * @returns Map of parameter name to info
+ */
+export declare function getParamInfo(schema: JSONSchema7 | undefined): Map<string, {
+    type: string;
+    description?: string | undefined;
+    required: boolean;
+    default?: unknown;
+}>;
+//# sourceMappingURL=validation.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../src/execution/validation.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,KAAK,EAAwB,qBAAqB,EAAE,MAAM,SAAS,CAAC;AAE3E;;;;;;GAMG;AACH,wBAAgB,cAAc,CAC5B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,MAAM,EAAE,WAAW,GAAG,SAAS,GAC9B,qBAAqB,CA6DvB;AAqVD;;;;;;GAMG;AACH,wBAAgB,aAAa,CAC3B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,MAAM,EAAE,WAAW,GAAG,SAAS,GAC9B,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAiBzB;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,WAAW,GAAG,SAAS,GAAG,MAAM,EAAE,CAK3E;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAC1B,MAAM,EAAE,WAAW,GAAG,SAAS,GAC9B,GAAG,CACJ,MAAM,EACN;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAAC,QAAQ,EAAE,OAAO,CAAC;IAAC,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,CACzF,CAiCA"}