@cloudflare/sandbox 0.13.0-next.797.1 → 0.13.0-next.802.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cloudflare/sandbox",
-  "version": "0.13.0-next.797.1",
+  "version": "0.13.0-next.802.1",
   "repository": {
     "type": "git",
     "url": "https://github.com/cloudflare/sandbox-sdk"

package/dist/contexts-1EsLHByO.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"contexts-1EsLHByO.d.ts","names":["ErrorCode","ErrorCode","Operation","OperationType","ErrorResponse","TContext","Record","ServiceError","ServiceResult","T","ProcessExit","OperationType","FileNotFoundContext","FileExistsContext","FileTooLargeContext","FileSystemContext","CommandNotFoundContext","CommandErrorContext","ProcessNotFoundContext","ProcessErrorContext","InvalidProcessCwdContext","InvalidProcessEnvironmentContext","ProcessSpawnFailedContext","InvalidProcessCursorContext","StaleProcessHandleContext","ProcessWaitTimeoutContext","ProcessAbortedContext","TerminalNotFoundContext","InvalidTerminalCwdContext","InvalidTerminalCursorContext","TerminalControlErrorContext","StaleTerminalHandleContext","ProcessReadyTimeoutContext","ProcessExitedBeforeReadyContext","ProcessExitedBeforeLogContext","PortAlreadyExposedContext","PortNotExposedContext","InvalidPortContext","PortErrorContext","GitRepositoryNotFoundContext","GitAuthFailedContext","GitBranchNotFoundContext","GitErrorContext","InterpreterNotReadyContext","ContextNotFoundContext","CodeExecutionContext","ValidationFailedContext","Array","BucketMountContext","MissingCredentialsContext","InvalidMountConfigContext","BackupCreateContext","BackupRestoreContext","BackupNotFoundContext","BackupExpiredContext","InvalidBackupConfigContext","OpenCodeStartupContext","InternalErrorContext","ContainerUnavailableContext","OperationInterruptedReason","OperationInterruptedContext","RPCTransportErrorKind","RPCTransportContext"],"sources":["../../shared/dist/errors/codes.d.ts","../../shared/dist/errors/types.d.ts","../../shared/dist/errors/contexts.d.ts"],"sourcesContent":["/**\n * Centralized error code registry\n * Each code maps to a specific error type with consistent semantics\n */\nexport declare const ErrorCode: {\n    readonly FILE_NOT_FOUND: \"FILE_NOT_FOUND\";\n    readonly PERMISSION_DENIED: \"PERMISSION_DENIED\";\n    readonly FILE_EXISTS: \"FILE_EXISTS\";\n    readonly IS_DIRECTORY: \"IS_DIRECTORY\";\n    readonly NOT_DIRECTORY: \"NOT_DIRECTORY\";\n    readonly FILE_TOO_LARGE: \"FILE_TOO_LARGE\";\n    readonly NO_SPACE: \"NO_SPACE\";\n    readonly TOO_MANY_FILES: \"TOO_MANY_FILES\";\n    readonly RESOURCE_BUSY: \"RESOURCE_BUSY\";\n    readonly READ_ONLY: \"READ_ONLY\";\n    readonly NAME_TOO_LONG: \"NAME_TOO_LONG\";\n    readonly TOO_MANY_LINKS: \"TOO_MANY_LINKS\";\n    readonly FILESYSTEM_ERROR: \"FILESYSTEM_ERROR\";\n    readonly COMMAND_NOT_FOUND: \"COMMAND_NOT_FOUND\";\n    readonly COMMAND_PERMISSION_DENIED: \"COMMAND_PERMISSION_DENIED\";\n    readonly INVALID_COMMAND: \"INVALID_COMMAND\";\n    readonly COMMAND_EXECUTION_ERROR: \"COMMAND_EXECUTION_ERROR\";\n    readonly STREAM_START_ERROR: \"STREAM_START_ERROR\";\n    readonly PROCESS_NOT_FOUND: \"PROCESS_NOT_FOUND\";\n    readonly TERMINAL_NOT_FOUND: \"TERMINAL_NOT_FOUND\";\n    readonly INVALID_PROCESS_CWD: \"INVALID_PROCESS_CWD\";\n    readonly INVALID_PROCESS_ENVIRONMENT: \"INVALID_PROCESS_ENVIRONMENT\";\n    readonly INVALID_PROCESS_CURSOR: \"INVALID_PROCESS_CURSOR\";\n    readonly INVALID_TERMINAL_CWD: \"INVALID_TERMINAL_CWD\";\n    readonly INVALID_TERMINAL_CURSOR: \"INVALID_TERMINAL_CURSOR\";\n    readonly STALE_PROCESS_HANDLE: \"STALE_PROCESS_HANDLE\";\n    readonly STALE_TERMINAL_HANDLE: \"STALE_TERMINAL_HANDLE\";\n    readonly PROCESS_WAIT_TIMEOUT: \"PROCESS_WAIT_TIMEOUT\";\n    readonly PROCESS_ABORTED: \"PROCESS_ABORTED\";\n    readonly PROCESS_PERMISSION_DENIED: \"PROCESS_PERMISSION_DENIED\";\n    readonly PROCESS_ERROR: \"PROCESS_ERROR\";\n    readonly PROCESS_SPAWN_FAILED: \"PROCESS_SPAWN_FAILED\";\n    readonly TERMINAL_CONTROL_ERROR: \"TERMINAL_CONTROL_ERROR\";\n    readonly PORT_ALREADY_EXPOSED: \"PORT_ALREADY_EXPOSED\";\n    readonly PORT_IN_USE: \"PORT_IN_USE\";\n    readonly PORT_NOT_EXPOSED: \"PORT_NOT_EXPOSED\";\n    readonly INVALID_PORT_NUMBER: \"INVALID_PORT_NUMBER\";\n    readonly INVALID_PORT: \"INVALID_PORT\";\n    readonly SERVICE_NOT_RESPONDING: \"SERVICE_NOT_RESPONDING\";\n    readonly PORT_OPERATION_ERROR: \"PORT_OPERATION_ERROR\";\n    readonly CUSTOM_DOMAIN_REQUIRED: \"CUSTOM_DOMAIN_REQUIRED\";\n    readonly GIT_REPOSITORY_NOT_FOUND: \"GIT_REPOSITORY_NOT_FOUND\";\n    readonly GIT_BRANCH_NOT_FOUND: \"GIT_BRANCH_NOT_FOUND\";\n    readonly GIT_AUTH_FAILED: \"GIT_AUTH_FAILED\";\n    readonly GIT_NETWORK_ERROR: \"GIT_NETWORK_ERROR\";\n    readonly INVALID_GIT_URL: \"INVALID_GIT_URL\";\n    readonly GIT_CLONE_FAILED: \"GIT_CLONE_FAILED\";\n    readonly GIT_CHECKOUT_FAILED: \"GIT_CHECKOUT_FAILED\";\n    readonly GIT_OPERATION_FAILED: \"GIT_OPERATION_FAILED\";\n    readonly BUCKET_MOUNT_ERROR: \"BUCKET_MOUNT_ERROR\";\n    readonly BUCKET_UNMOUNT_ERROR: \"BUCKET_UNMOUNT_ERROR\";\n    readonly S3FS_MOUNT_ERROR: \"S3FS_MOUNT_ERROR\";\n    readonly MISSING_CREDENTIALS: \"MISSING_CREDENTIALS\";\n    readonly INVALID_MOUNT_CONFIG: \"INVALID_MOUNT_CONFIG\";\n    readonly BACKUP_CREATE_FAILED: \"BACKUP_CREATE_FAILED\";\n    readonly BACKUP_RESTORE_FAILED: \"BACKUP_RESTORE_FAILED\";\n    readonly BACKUP_NOT_FOUND: \"BACKUP_NOT_FOUND\";\n    readonly BACKUP_EXPIRED: \"BACKUP_EXPIRED\";\n    readonly INVALID_BACKUP_CONFIG: \"INVALID_BACKUP_CONFIG\";\n    readonly INTERPRETER_NOT_READY: \"INTERPRETER_NOT_READY\";\n    readonly CONTEXT_NOT_FOUND: \"CONTEXT_NOT_FOUND\";\n    readonly CODE_EXECUTION_ERROR: \"CODE_EXECUTION_ERROR\";\n    readonly PYTHON_NOT_AVAILABLE: \"PYTHON_NOT_AVAILABLE\";\n    readonly JAVASCRIPT_NOT_AVAILABLE: \"JAVASCRIPT_NOT_AVAILABLE\";\n    readonly OPENCODE_STARTUP_FAILED: \"OPENCODE_STARTUP_FAILED\";\n    readonly PROCESS_READY_TIMEOUT: \"PROCESS_READY_TIMEOUT\";\n    readonly PROCESS_EXITED_BEFORE_READY: \"PROCESS_EXITED_BEFORE_READY\";\n    readonly PROCESS_EXITED_BEFORE_LOG: \"PROCESS_EXITED_BEFORE_LOG\";\n    readonly WATCH_NOT_FOUND: \"WATCH_NOT_FOUND\";\n    readonly WATCH_START_ERROR: \"WATCH_START_ERROR\";\n    readonly WATCH_STOP_ERROR: \"WATCH_STOP_ERROR\";\n    readonly VALIDATION_FAILED: \"VALIDATION_FAILED\";\n    readonly INVALID_JSON_RESPONSE: \"INVALID_JSON_RESPONSE\";\n    readonly UNKNOWN_ERROR: \"UNKNOWN_ERROR\";\n    readonly INTERNAL_ERROR: \"INTERNAL_ERROR\";\n    readonly CONTAINER_UNAVAILABLE: \"CONTAINER_UNAVAILABLE\";\n    readonly CONTROL_PROTOCOL_INCOMPATIBLE: \"CONTROL_PROTOCOL_INCOMPATIBLE\";\n    readonly OPERATION_INTERRUPTED: \"OPERATION_INTERRUPTED\";\n    readonly RPC_TRANSPORT_ERROR: \"RPC_TRANSPORT_ERROR\";\n};\nexport type ErrorCode = (typeof ErrorCode)[keyof typeof ErrorCode];\n//# sourceMappingURL=codes.d.ts.map","import type { ErrorCode } from './codes';\n/**\n * Standard operation types\n */\nexport declare const Operation: {\n    readonly FILE_READ: \"file.read\";\n    readonly FILE_WRITE: \"file.write\";\n    readonly FILE_DELETE: \"file.delete\";\n    readonly FILE_MOVE: \"file.move\";\n    readonly FILE_RENAME: \"file.rename\";\n    readonly FILE_STAT: \"file.stat\";\n    readonly DIRECTORY_CREATE: \"directory.create\";\n    readonly DIRECTORY_LIST: \"directory.list\";\n    readonly COMMAND_EXECUTE: \"command.execute\";\n    readonly COMMAND_STREAM: \"command.stream\";\n    readonly PROCESS_START: \"process.start\";\n    readonly PROCESS_KILL: \"process.kill\";\n    readonly PROCESS_LIST: \"process.list\";\n    readonly PROCESS_GET: \"process.get\";\n    readonly PROCESS_LOGS: \"process.logs\";\n    readonly GIT_CLONE: \"git.clone\";\n    readonly GIT_CHECKOUT: \"git.checkout\";\n    readonly GIT_OPERATION: \"git.operation\";\n    readonly BACKUP_CREATE: \"backup.create\";\n    readonly BACKUP_RESTORE: \"backup.restore\";\n    readonly BACKUP_UNMOUNT: \"backup.unmount\";\n    readonly CODE_EXECUTE: \"code.execute\";\n    readonly CODE_CONTEXT_CREATE: \"code.context.create\";\n    readonly CODE_CONTEXT_DELETE: \"code.context.delete\";\n};\nexport type OperationType = (typeof Operation)[keyof typeof Operation];\n/**\n * Standard error response format with generic context type\n * TContext allows type-safe access to error-specific context\n */\nexport interface ErrorResponse<TContext = Record<string, unknown>> {\n    /**\n     * Error type code (machine-readable)\n     */\n    code: ErrorCode;\n    /**\n     * Human-readable error message\n     */\n    message: string;\n    /**\n     * Operation that was attempted (useful for debugging and logging)\n     */\n    operation?: OperationType;\n    /**\n     * Structured error context with relevant details\n     * Type varies based on error code\n     */\n    context: TContext;\n    /**\n     * HTTP status code (for client SDK)\n     */\n    httpStatus: number;\n    /**\n     * Timestamp when error occurred\n     */\n    timestamp: string;\n    /**\n     * Actionable suggestion for fixing the error\n     */\n    suggestion?: string;\n    /**\n     * Link to documentation\n     */\n    documentation?: string;\n}\n/**\n * Container ServiceError (lightweight, enriched by handlers)\n */\nexport interface ServiceError {\n    message: string;\n    code: ErrorCode;\n    details?: Record<string, unknown>;\n}\n/**\n * ServiceResult type for container services\n */\nexport type ServiceResult<T> = {\n    success: true;\n    data: T;\n} | {\n    success: false;\n    error: ServiceError;\n};\n//# sourceMappingURL=types.d.ts.map","import type { ProcessExit } from '../process-types';\nimport type { OperationType } from './types';\n/**\n * File system error contexts\n */\nexport interface FileNotFoundContext {\n    path: string;\n    operation: OperationType;\n}\nexport interface FileExistsContext {\n    path: string;\n    operation: OperationType;\n}\nexport interface FileTooLargeContext {\n    path: string;\n    operation: OperationType;\n    maxSize: number;\n    actualSize: number;\n}\nexport interface FileSystemContext {\n    path: string;\n    operation: OperationType;\n    stderr?: string;\n    exitCode?: number;\n}\n/**\n * Command error contexts\n */\nexport interface CommandNotFoundContext {\n    command: string;\n}\nexport interface CommandErrorContext {\n    command: string;\n    exitCode?: number;\n    stdout?: string;\n    stderr?: string;\n}\n/**\n * Process error contexts\n */\nexport interface ProcessNotFoundContext {\n    processId: string;\n}\nexport interface ProcessErrorContext {\n    processId: string;\n    pid?: number;\n    exitCode?: number;\n    stderr?: string;\n}\nexport interface InvalidProcessCwdContext {\n    processId?: string;\n    cwd: string;\n    reason: string;\n}\nexport interface InvalidProcessEnvironmentContext {\n    processId?: string;\n    name?: string;\n    reason: string;\n}\nexport interface ProcessSpawnFailedContext {\n    processId: string;\n    command: string;\n    cwd?: string;\n    stderr?: string;\n}\nexport interface InvalidProcessCursorContext {\n    processId: string;\n    cursor?: string;\n    reason: string;\n}\nexport interface StaleProcessHandleContext {\n    processId: string;\n    pid: number;\n    operation: string;\n}\nexport interface ProcessWaitTimeoutContext {\n    processId: string;\n    operation: 'output' | 'waitForExit' | 'waitForLog';\n    timeout: number;\n}\nexport interface ProcessAbortedContext {\n    processId: string;\n    operation: string;\n}\nexport interface TerminalNotFoundContext {\n    terminalId: string;\n}\nexport interface InvalidTerminalCwdContext {\n    terminalId: string;\n    cwd: string;\n    reason: string;\n}\nexport interface InvalidTerminalCursorContext {\n    terminalId: string;\n    cursor?: string;\n    reason: string;\n}\nexport interface TerminalControlErrorContext {\n    terminalId: string;\n    operation: string;\n    reason?: string;\n    failure?: {\n        code: string;\n        message: string;\n    };\n}\nexport interface StaleTerminalHandleContext {\n    terminalId: string;\n    operation: string;\n}\n/**\n * Process readiness error contexts\n */\nexport interface ProcessReadyTimeoutContext {\n    processId: string;\n    command: string;\n    condition: string;\n    timeout: number;\n}\nexport interface ProcessExitedBeforeReadyContext {\n    processId: string;\n    command: string;\n    condition: string;\n    exitCode: number;\n}\nexport interface ProcessExitedBeforeLogContext {\n    processId: string;\n    pid: number;\n    exit: ProcessExit;\n}\n/**\n * Port error contexts\n */\nexport interface PortAlreadyExposedContext {\n    port: number;\n    portName?: string;\n}\nexport interface PortNotExposedContext {\n    port: number;\n}\nexport interface InvalidPortContext {\n    port: number;\n    reason: string;\n}\nexport interface PortErrorContext {\n    port: number;\n    portName?: string;\n    stderr?: string;\n}\n/**\n * Git error contexts\n */\nexport interface GitRepositoryNotFoundContext {\n    repository: string;\n}\nexport interface GitAuthFailedContext {\n    repository: string;\n}\nexport interface GitBranchNotFoundContext {\n    branch: string;\n    repository?: string;\n}\nexport interface GitErrorContext {\n    repository?: string;\n    branch?: string;\n    targetDir?: string;\n    stderr?: string;\n    exitCode?: number;\n}\n/**\n * Code interpreter error contexts\n */\nexport interface InterpreterNotReadyContext {\n    retryAfter?: number;\n    progress?: number;\n}\nexport interface ContextNotFoundContext {\n    contextId: string;\n}\nexport interface CodeExecutionContext {\n    contextId?: string;\n    ename?: string;\n    evalue?: string;\n    traceback?: string[];\n}\n/**\n * Validation error contexts\n */\nexport interface ValidationFailedContext {\n    validationErrors: Array<{\n        field: string;\n        message: string;\n        code?: string;\n    }>;\n}\n/**\n * Bucket mounting error contexts\n */\nexport interface BucketMountContext {\n    bucket: string;\n    mountPath: string;\n    endpoint: string;\n    stderr?: string;\n    exitCode?: number;\n}\nexport interface MissingCredentialsContext {\n    bucket: string;\n    endpoint: string;\n}\nexport interface InvalidMountConfigContext {\n    bucket?: string;\n    mountPath?: string;\n    endpoint?: string;\n    reason?: string;\n}\n/**\n * Backup error contexts\n */\nexport interface BackupCreateContext {\n    dir: string;\n    backupId?: string;\n    stderr?: string;\n    exitCode?: number;\n}\nexport interface BackupRestoreContext {\n    dir: string;\n    backupId: string;\n    stderr?: string;\n    exitCode?: number;\n}\nexport interface BackupNotFoundContext {\n    backupId: string;\n}\nexport interface BackupExpiredContext {\n    backupId: string;\n    expiredAt?: string;\n}\nexport interface InvalidBackupConfigContext {\n    reason: string;\n}\n/**\n * OpenCode error contexts\n */\nexport interface OpenCodeStartupContext {\n    port: number;\n    stderr?: string;\n    command?: string;\n}\n/**\n * Generic error contexts\n */\nexport interface InternalErrorContext {\n    originalError?: string;\n    stack?: string;\n    [key: string]: unknown;\n}\n/**\n * Container availability error context. Surfaced when the sandbox container\n * cannot accept the incoming RPC connection. The container may be starting\n * up, undergoing a runtime replacement, or temporarily unhealthy. The\n * caller should retry the same operation.\n */\nexport interface ContainerUnavailableContext {\n    /**\n     * Categorical reason distinguishing startup unavailability from runtime\n     * replacement and exhausted upgrade retries.\n     */\n    reason: 'container_starting' | 'container_unhealthy' | 'container_replaced' | 'rpc_upgrade_failed';\n    /**\n     * Always true — this error represents a transient unavailability, not a\n     * permanent failure. Callers should retry the same operation.\n     */\n    retryable: true;\n    /** Suggested delay in milliseconds before the next retry attempt. */\n    retryAfterMs?: number;\n}\nexport type OperationInterruptedReason = 'runtime_replaced' | 'container_stopped' | 'transport_disposed' | 'sandbox_destroyed' | 'sandbox_lifetime_changed' | 'recovery_exhausted' | 'unknown';\nexport interface OperationInterruptedContext {\n    reason: OperationInterruptedReason;\n    operation: string;\n    phase?: string;\n    admitted: true | 'unknown';\n    retryable: boolean;\n    operationId?: string;\n    operationKey?: string;\n    idempotencyKey?: string;\n    recoveryAttempts?: number;\n    maxRecoveryAttempts?: number;\n    backupId?: string;\n    dir?: string;\n}\n/**\n * RPC transport error contexts. Surfaced when the capnweb WebSocket session\n * fails on the SDK side rather than the container reporting a structured\n * error. Always retryable — the next call will open a fresh connection.\n */\nexport type RPCTransportErrorKind = \n/** Server closed the WebSocket (container crash, DO eviction, network blip). */\n'peer_closed'\n/** Underlying socket fired the `error` event. */\n | 'connection_failed'\n/** WebSocket upgrade failed before the session was established. */\n | 'upgrade_failed'\n/** Peer sent a non-string frame; capnweb's wire format is JSON text only. */\n | 'invalid_frame'\n/** Peer sent a frame the wire-format parser rejected (capnweb readLoop SyntaxError). */\n | 'protocol_error' | 'session_disposed'\n/** Anything else that bubbled up from the transport with no recognisable shape. */\n | 'unknown';\nexport interface RPCTransportContext {\n    /** Categorical bucket so callers can branch on `peer_closed` vs `upgrade_failed` etc. */\n    kind: RPCTransportErrorKind;\n    /** Original error message, verbatim from capnweb / our DeferredTransport. */\n    originalMessage: string;\n    /**\n     * The underlying Error's `name` property. capnweb preserves this across\n     * the wire for the standard built-ins (TypeError, SyntaxError, etc.), so\n     * it's a more reliable hint than the message string for those cases.\n     */\n    errorName: string;\n    /** WebSocket close code, when available (kind === 'peer_closed'). */\n    closeCode?: number;\n    /** WebSocket close reason, when available (kind === 'peer_closed'). */\n    closeReason?: string;\n}\n//# sourceMappingURL=contexts.d.ts.map"],"mappings":"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"}

package/dist/errors-CXR0xBpw.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"errors-CXR0xBpw.js","names":[],"sources":["../../shared/dist/errors/codes.js","../../shared/dist/errors/status-map.js","../../shared/dist/errors/suggestions.js","../../shared/dist/errors/types.js"],"sourcesContent":["/**\n * Centralized error code registry\n * Each code maps to a specific error type with consistent semantics\n */\nexport const ErrorCode = {\n    // File System Errors (404)\n    FILE_NOT_FOUND: 'FILE_NOT_FOUND',\n    // Permission Errors (403)\n    PERMISSION_DENIED: 'PERMISSION_DENIED',\n    // File System Errors (409)\n    FILE_EXISTS: 'FILE_EXISTS',\n    // File System Errors (400)\n    IS_DIRECTORY: 'IS_DIRECTORY',\n    NOT_DIRECTORY: 'NOT_DIRECTORY',\n    // File Too Large Errors (413)\n    FILE_TOO_LARGE: 'FILE_TOO_LARGE',\n    // File System Errors (500)\n    NO_SPACE: 'NO_SPACE',\n    TOO_MANY_FILES: 'TOO_MANY_FILES',\n    RESOURCE_BUSY: 'RESOURCE_BUSY',\n    READ_ONLY: 'READ_ONLY',\n    NAME_TOO_LONG: 'NAME_TOO_LONG',\n    TOO_MANY_LINKS: 'TOO_MANY_LINKS',\n    FILESYSTEM_ERROR: 'FILESYSTEM_ERROR',\n    // Command Errors (404)\n    COMMAND_NOT_FOUND: 'COMMAND_NOT_FOUND',\n    // Command Errors (403/400)\n    COMMAND_PERMISSION_DENIED: 'COMMAND_PERMISSION_DENIED',\n    INVALID_COMMAND: 'INVALID_COMMAND',\n    // Command Errors (500)\n    COMMAND_EXECUTION_ERROR: 'COMMAND_EXECUTION_ERROR',\n    STREAM_START_ERROR: 'STREAM_START_ERROR',\n    // Process Errors (404)\n    PROCESS_NOT_FOUND: 'PROCESS_NOT_FOUND',\n    TERMINAL_NOT_FOUND: 'TERMINAL_NOT_FOUND',\n    // Process Errors (400)\n    INVALID_PROCESS_CWD: 'INVALID_PROCESS_CWD',\n    INVALID_PROCESS_ENVIRONMENT: 'INVALID_PROCESS_ENVIRONMENT',\n    INVALID_PROCESS_CURSOR: 'INVALID_PROCESS_CURSOR',\n    INVALID_TERMINAL_CWD: 'INVALID_TERMINAL_CWD',\n    INVALID_TERMINAL_CURSOR: 'INVALID_TERMINAL_CURSOR',\n    // Process Errors (408/409/499)\n    STALE_PROCESS_HANDLE: 'STALE_PROCESS_HANDLE',\n    STALE_TERMINAL_HANDLE: 'STALE_TERMINAL_HANDLE',\n    PROCESS_WAIT_TIMEOUT: 'PROCESS_WAIT_TIMEOUT',\n    PROCESS_ABORTED: 'PROCESS_ABORTED',\n    // Process Errors (403/500)\n    PROCESS_PERMISSION_DENIED: 'PROCESS_PERMISSION_DENIED',\n    PROCESS_ERROR: 'PROCESS_ERROR',\n    PROCESS_SPAWN_FAILED: 'PROCESS_SPAWN_FAILED',\n    TERMINAL_CONTROL_ERROR: 'TERMINAL_CONTROL_ERROR',\n    // Port Errors (409)\n    PORT_ALREADY_EXPOSED: 'PORT_ALREADY_EXPOSED',\n    PORT_IN_USE: 'PORT_IN_USE',\n    // Port Errors (404)\n    PORT_NOT_EXPOSED: 'PORT_NOT_EXPOSED',\n    // Port Errors (400)\n    INVALID_PORT_NUMBER: 'INVALID_PORT_NUMBER',\n    INVALID_PORT: 'INVALID_PORT',\n    // Port Errors (502/500)\n    SERVICE_NOT_RESPONDING: 'SERVICE_NOT_RESPONDING',\n    PORT_OPERATION_ERROR: 'PORT_OPERATION_ERROR',\n    // Port Errors (400)\n    CUSTOM_DOMAIN_REQUIRED: 'CUSTOM_DOMAIN_REQUIRED',\n    // Git Errors (404)\n    GIT_REPOSITORY_NOT_FOUND: 'GIT_REPOSITORY_NOT_FOUND',\n    GIT_BRANCH_NOT_FOUND: 'GIT_BRANCH_NOT_FOUND',\n    // Git Errors (401)\n    GIT_AUTH_FAILED: 'GIT_AUTH_FAILED',\n    // Git Errors (502)\n    GIT_NETWORK_ERROR: 'GIT_NETWORK_ERROR',\n    // Git Errors (400)\n    INVALID_GIT_URL: 'INVALID_GIT_URL',\n    // Git Errors (500)\n    GIT_CLONE_FAILED: 'GIT_CLONE_FAILED',\n    GIT_CHECKOUT_FAILED: 'GIT_CHECKOUT_FAILED',\n    GIT_OPERATION_FAILED: 'GIT_OPERATION_FAILED',\n    // Bucket mounting errors\n    BUCKET_MOUNT_ERROR: 'BUCKET_MOUNT_ERROR',\n    BUCKET_UNMOUNT_ERROR: 'BUCKET_UNMOUNT_ERROR',\n    S3FS_MOUNT_ERROR: 'S3FS_MOUNT_ERROR',\n    MISSING_CREDENTIALS: 'MISSING_CREDENTIALS',\n    INVALID_MOUNT_CONFIG: 'INVALID_MOUNT_CONFIG',\n    // Backup Errors (500)\n    BACKUP_CREATE_FAILED: 'BACKUP_CREATE_FAILED',\n    BACKUP_RESTORE_FAILED: 'BACKUP_RESTORE_FAILED',\n    // Backup Errors (404)\n    BACKUP_NOT_FOUND: 'BACKUP_NOT_FOUND',\n    // Backup Errors (400)\n    BACKUP_EXPIRED: 'BACKUP_EXPIRED',\n    INVALID_BACKUP_CONFIG: 'INVALID_BACKUP_CONFIG',\n    // Code Interpreter Errors (503)\n    INTERPRETER_NOT_READY: 'INTERPRETER_NOT_READY',\n    // Code Interpreter Errors (404)\n    CONTEXT_NOT_FOUND: 'CONTEXT_NOT_FOUND',\n    // Code Interpreter Errors (500)\n    CODE_EXECUTION_ERROR: 'CODE_EXECUTION_ERROR',\n    // Code Interpreter Errors (501) - Feature not available in image variant\n    PYTHON_NOT_AVAILABLE: 'PYTHON_NOT_AVAILABLE',\n    JAVASCRIPT_NOT_AVAILABLE: 'JAVASCRIPT_NOT_AVAILABLE',\n    // OpenCode Errors (503)\n    OPENCODE_STARTUP_FAILED: 'OPENCODE_STARTUP_FAILED',\n    // Process Readiness Errors (408/500)\n    PROCESS_READY_TIMEOUT: 'PROCESS_READY_TIMEOUT',\n    PROCESS_EXITED_BEFORE_READY: 'PROCESS_EXITED_BEFORE_READY',\n    PROCESS_EXITED_BEFORE_LOG: 'PROCESS_EXITED_BEFORE_LOG',\n    // File Watch Errors (404)\n    WATCH_NOT_FOUND: 'WATCH_NOT_FOUND',\n    // File Watch Errors (500)\n    WATCH_START_ERROR: 'WATCH_START_ERROR',\n    WATCH_STOP_ERROR: 'WATCH_STOP_ERROR',\n    // Validation Errors (400)\n    VALIDATION_FAILED: 'VALIDATION_FAILED',\n    // Generic Errors (400/500)\n    INVALID_JSON_RESPONSE: 'INVALID_JSON_RESPONSE',\n    UNKNOWN_ERROR: 'UNKNOWN_ERROR',\n    INTERNAL_ERROR: 'INTERNAL_ERROR',\n    // Container Availability Errors (503)\n    CONTAINER_UNAVAILABLE: 'CONTAINER_UNAVAILABLE',\n    CONTROL_PROTOCOL_INCOMPATIBLE: 'CONTROL_PROTOCOL_INCOMPATIBLE',\n    // Operation Lifecycle Errors (409)\n    OPERATION_INTERRUPTED: 'OPERATION_INTERRUPTED',\n    // RPC Transport Errors (503) — capnweb WebSocket session-level failures\n    // raised on the SDK side, not by the container. The container went away\n    // mid-call (peer close), the WebSocket failed before/after upgrade, the\n    // peer sent a frame the transport cannot handle, or the session was\n    // disposed while a call was in flight.\n    RPC_TRANSPORT_ERROR: 'RPC_TRANSPORT_ERROR'\n};\n","import { ErrorCode } from './codes';\n/**\n * Maps error codes to HTTP status codes\n * Centralized mapping ensures consistency across SDK\n */\nexport const ERROR_STATUS_MAP = {\n    // 404 Not Found\n    [ErrorCode.FILE_NOT_FOUND]: 404,\n    [ErrorCode.COMMAND_NOT_FOUND]: 404,\n    [ErrorCode.PROCESS_NOT_FOUND]: 404,\n    [ErrorCode.TERMINAL_NOT_FOUND]: 404,\n    [ErrorCode.PORT_NOT_EXPOSED]: 404,\n    [ErrorCode.GIT_REPOSITORY_NOT_FOUND]: 404,\n    [ErrorCode.GIT_BRANCH_NOT_FOUND]: 404,\n    [ErrorCode.CONTEXT_NOT_FOUND]: 404,\n    [ErrorCode.WATCH_NOT_FOUND]: 404,\n    // 400 Bad Request\n    [ErrorCode.IS_DIRECTORY]: 400,\n    [ErrorCode.NOT_DIRECTORY]: 400,\n    [ErrorCode.INVALID_COMMAND]: 400,\n    [ErrorCode.INVALID_PROCESS_CWD]: 400,\n    [ErrorCode.INVALID_PROCESS_ENVIRONMENT]: 400,\n    [ErrorCode.INVALID_PROCESS_CURSOR]: 400,\n    [ErrorCode.INVALID_TERMINAL_CWD]: 400,\n    [ErrorCode.INVALID_TERMINAL_CURSOR]: 400,\n    [ErrorCode.INVALID_PORT_NUMBER]: 400,\n    [ErrorCode.INVALID_PORT]: 400,\n    [ErrorCode.INVALID_GIT_URL]: 400,\n    [ErrorCode.CUSTOM_DOMAIN_REQUIRED]: 400,\n    [ErrorCode.INVALID_JSON_RESPONSE]: 400,\n    [ErrorCode.NAME_TOO_LONG]: 400,\n    [ErrorCode.VALIDATION_FAILED]: 400,\n    [ErrorCode.MISSING_CREDENTIALS]: 400,\n    [ErrorCode.INVALID_MOUNT_CONFIG]: 400,\n    // 401 Unauthorized\n    [ErrorCode.GIT_AUTH_FAILED]: 401,\n    // 403 Forbidden\n    [ErrorCode.PERMISSION_DENIED]: 403,\n    [ErrorCode.COMMAND_PERMISSION_DENIED]: 403,\n    [ErrorCode.PROCESS_PERMISSION_DENIED]: 403,\n    [ErrorCode.READ_ONLY]: 403,\n    // 409 Conflict\n    [ErrorCode.FILE_EXISTS]: 409,\n    [ErrorCode.PORT_ALREADY_EXPOSED]: 409,\n    [ErrorCode.PORT_IN_USE]: 409,\n    [ErrorCode.RESOURCE_BUSY]: 409,\n    [ErrorCode.OPERATION_INTERRUPTED]: 409,\n    [ErrorCode.STALE_PROCESS_HANDLE]: 409,\n    [ErrorCode.STALE_TERMINAL_HANDLE]: 409,\n    [ErrorCode.PROCESS_EXITED_BEFORE_LOG]: 409,\n    // 410 Gone\n    // 413 Content Too Large\n    [ErrorCode.FILE_TOO_LARGE]: 413,\n    // 502 Bad Gateway\n    [ErrorCode.SERVICE_NOT_RESPONDING]: 502,\n    [ErrorCode.GIT_NETWORK_ERROR]: 502,\n    // Backup errors\n    [ErrorCode.BACKUP_NOT_FOUND]: 404,\n    [ErrorCode.BACKUP_EXPIRED]: 400,\n    [ErrorCode.INVALID_BACKUP_CONFIG]: 400,\n    [ErrorCode.BACKUP_CREATE_FAILED]: 500,\n    [ErrorCode.BACKUP_RESTORE_FAILED]: 500,\n    // 501 Not Implemented (feature not available in image variant)\n    [ErrorCode.PYTHON_NOT_AVAILABLE]: 501,\n    [ErrorCode.JAVASCRIPT_NOT_AVAILABLE]: 501,\n    // 503 Service Unavailable\n    [ErrorCode.INTERPRETER_NOT_READY]: 503,\n    [ErrorCode.OPENCODE_STARTUP_FAILED]: 503,\n    [ErrorCode.CONTAINER_UNAVAILABLE]: 503,\n    [ErrorCode.CONTROL_PROTOCOL_INCOMPATIBLE]: 503,\n    [ErrorCode.RPC_TRANSPORT_ERROR]: 503,\n    // 408 Request Timeout\n    [ErrorCode.PROCESS_READY_TIMEOUT]: 408,\n    [ErrorCode.PROCESS_WAIT_TIMEOUT]: 408,\n    // 499 Client Closed Request\n    [ErrorCode.PROCESS_ABORTED]: 499,\n    // 500 Internal Server Error\n    [ErrorCode.PROCESS_EXITED_BEFORE_READY]: 500,\n    [ErrorCode.NO_SPACE]: 500,\n    [ErrorCode.TOO_MANY_FILES]: 500,\n    [ErrorCode.TOO_MANY_LINKS]: 500,\n    [ErrorCode.FILESYSTEM_ERROR]: 500,\n    [ErrorCode.COMMAND_EXECUTION_ERROR]: 500,\n    [ErrorCode.STREAM_START_ERROR]: 500,\n    [ErrorCode.PROCESS_ERROR]: 500,\n    [ErrorCode.PROCESS_SPAWN_FAILED]: 500,\n    [ErrorCode.TERMINAL_CONTROL_ERROR]: 500,\n    [ErrorCode.PORT_OPERATION_ERROR]: 500,\n    [ErrorCode.GIT_CLONE_FAILED]: 500,\n    [ErrorCode.GIT_CHECKOUT_FAILED]: 500,\n    [ErrorCode.GIT_OPERATION_FAILED]: 500,\n    [ErrorCode.CODE_EXECUTION_ERROR]: 500,\n    [ErrorCode.BUCKET_MOUNT_ERROR]: 500,\n    [ErrorCode.BUCKET_UNMOUNT_ERROR]: 500,\n    [ErrorCode.S3FS_MOUNT_ERROR]: 500,\n    [ErrorCode.WATCH_START_ERROR]: 500,\n    [ErrorCode.WATCH_STOP_ERROR]: 500,\n    [ErrorCode.UNKNOWN_ERROR]: 500,\n    [ErrorCode.INTERNAL_ERROR]: 500\n};\n/**\n * Get HTTP status code for an error code\n * Falls back to 500 for unknown errors\n */\nexport function getHttpStatus(code) {\n    return ERROR_STATUS_MAP[code] || 500;\n}\n","import { ErrorCode } from './codes';\n/**\n * Get actionable suggestion for an error code\n * Used by handlers when enriching ServiceError → ErrorResponse\n */\nexport function getSuggestion(code, context) {\n    switch (code) {\n        case ErrorCode.FILE_NOT_FOUND:\n            return `Ensure the file exists at ${context.path} before attempting to access it`;\n        case ErrorCode.FILE_EXISTS:\n            return `File already exists at ${context.path}. Use a different path or delete the existing file first`;\n        case ErrorCode.COMMAND_NOT_FOUND:\n            return `Check that \"${context.command}\" is installed and available in the system PATH`;\n        case ErrorCode.PROCESS_NOT_FOUND:\n            return 'Verify the process ID is correct and the process has not already exited';\n        case ErrorCode.INVALID_PROCESS_CWD:\n            return `Verify the process working directory exists and is accessible: ${context.cwd}`;\n        case ErrorCode.INVALID_PROCESS_ENVIRONMENT:\n            return 'Verify process environment variable names and values are valid strings without NUL bytes';\n        case ErrorCode.PROCESS_SPAWN_FAILED:\n            return `Check that \"${context.command}\" exists, is executable, and can be started in the requested working directory`;\n        case ErrorCode.INVALID_PROCESS_CURSOR:\n            return 'Use a log cursor previously returned by this process log stream';\n        case ErrorCode.STALE_PROCESS_HANDLE:\n            return 'The process handle refers to an older runtime process. Reacquire the process by ID before retrying the operation';\n        case ErrorCode.STALE_TERMINAL_HANDLE:\n            return 'The terminal handle refers to an older runtime terminal. Reacquire the terminal by ID before retrying the operation';\n        case ErrorCode.PROCESS_WAIT_TIMEOUT:\n            return 'The process did not complete before the timeout. Continue streaming logs or kill the process if it is no longer needed';\n        case ErrorCode.PROCESS_ABORTED:\n            return 'The process operation was aborted by the caller. Retry with a new AbortSignal if needed';\n        case ErrorCode.TERMINAL_NOT_FOUND:\n            return `Verify terminal \"${context.terminalId}\" exists and has not been evicted`;\n        case ErrorCode.INVALID_TERMINAL_CWD:\n            return `Verify the terminal working directory exists and is accessible: ${context.cwd}`;\n        case ErrorCode.INVALID_TERMINAL_CURSOR:\n            return 'Use a cursor previously returned by this terminal stream';\n        case ErrorCode.TERMINAL_CONTROL_ERROR:\n            return `Terminal control operation failed for terminal \"${context.terminalId}\"`;\n        case ErrorCode.PORT_NOT_EXPOSED:\n            return `Port ${context.port} is not currently available for this operation`;\n        case ErrorCode.PORT_ALREADY_EXPOSED:\n            return `Port ${context.port} already has preview URL authorization or activation state`;\n        case ErrorCode.PORT_IN_USE:\n            return `Port ${context.port} is already in use by another service. Choose a different port`;\n        case ErrorCode.INVALID_PORT:\n            return `Port must be between 1 and 65535. Port ${context.port} is ${context.reason}`;\n        case ErrorCode.GIT_REPOSITORY_NOT_FOUND:\n            return 'Verify the repository URL is correct and accessible';\n        case ErrorCode.GIT_AUTH_FAILED:\n            return 'Check authentication credentials or use a public repository';\n        case ErrorCode.GIT_BRANCH_NOT_FOUND:\n            return `Branch \"${context.branch}\" does not exist in the repository. Check the branch name or use the default branch`;\n        case ErrorCode.CONTROL_PROTOCOL_INCOMPATIBLE:\n            return 'Refresh the sandbox control session metadata and reconnect with a compatible control protocol';\n        case ErrorCode.INTERPRETER_NOT_READY:\n            return context.retryAfter\n                ? `Code interpreter is starting up. Retry after ${context.retryAfter} seconds`\n                : 'Code interpreter is not ready. Please wait a moment and try again';\n        case ErrorCode.CONTEXT_NOT_FOUND:\n            return `Context \"${context.contextId}\" does not exist. Create a context first using createContext()`;\n        case ErrorCode.VALIDATION_FAILED:\n            return 'Check the request parameters and ensure they match the required format';\n        case ErrorCode.NO_SPACE:\n            return 'Not enough disk space available. Consider cleaning up temporary files or increasing storage';\n        case ErrorCode.PERMISSION_DENIED:\n            return 'Operation not permitted. Check file/directory permissions';\n        case ErrorCode.IS_DIRECTORY:\n            return `Cannot perform this operation on a directory. Path ${context.path} is a directory`;\n        case ErrorCode.NOT_DIRECTORY:\n            return `Expected a directory but found a file at ${context.path}`;\n        case ErrorCode.RESOURCE_BUSY:\n            return 'Resource is currently in use. Wait for the current operation to complete';\n        case ErrorCode.READ_ONLY:\n            return 'Cannot modify a read-only resource';\n        case ErrorCode.SERVICE_NOT_RESPONDING:\n            return 'Service is not responding. Check if the service is running and accessible';\n        case ErrorCode.BACKUP_NOT_FOUND:\n            return `Backup \"${context.backupId}\" does not exist. Verify the backup ID is correct`;\n        case ErrorCode.BACKUP_EXPIRED:\n            return `Backup \"${context.backupId}\" has expired. Create a new backup`;\n        case ErrorCode.INVALID_BACKUP_CONFIG:\n            return `Invalid backup configuration: ${context.reason}`;\n        case ErrorCode.BACKUP_CREATE_FAILED:\n            return 'Backup creation failed. Check that the directory exists and you have sufficient disk space';\n        case ErrorCode.BACKUP_RESTORE_FAILED:\n            return 'Backup restoration failed. The archive may be corrupted or the target directory may be in use';\n        case ErrorCode.CONTAINER_UNAVAILABLE: {\n            const reason = context.reason;\n            switch (reason) {\n                case 'container_starting':\n                    return 'The container is still starting. Retry the operation in a moment.';\n                case 'container_unhealthy':\n                    return 'The container is temporarily unhealthy. Retry the operation in a moment.';\n                case 'container_replaced':\n                    return 'The container runtime was replaced. Retry the operation to use the new container.';\n                case 'rpc_upgrade_failed':\n                    return 'The container did not accept the RPC connection before the retry budget expired. Retry the operation in a moment.';\n                default:\n                    return 'The container is not ready yet. Retry the operation in a moment.';\n            }\n        }\n        case ErrorCode.OPERATION_INTERRUPTED:\n            return context.retryable\n                ? 'Retry the operation with the same idempotency key or operation inputs so the SDK can reconcile the previous attempt.'\n                : 'The operation may have started before it was interrupted. Inspect application state before retrying.';\n        case ErrorCode.RPC_TRANSPORT_ERROR: {\n            const kind = context.kind;\n            switch (kind) {\n                case 'peer_closed':\n                    return 'The container closed the WebSocket mid-call (likely a container restart, eviction, or crash). Retry the call — the SDK will open a fresh connection.';\n                case 'connection_failed':\n                    return 'The WebSocket connection failed. Retry the call; if the failure persists, check container health and network connectivity.';\n                case 'upgrade_failed':\n                    return 'The WebSocket upgrade was rejected by the container. Verify the container is running and reachable on the configured port.';\n                case 'invalid_frame':\n                    return 'The container sent a frame the RPC transport cannot handle. This usually indicates a version mismatch between the SDK and the container image.';\n                case 'protocol_error':\n                    return 'The peer sent a malformed RPC message (could not parse the wire format). This usually indicates a version mismatch between the SDK and the container image.';\n                case 'session_disposed':\n                    return 'The RPC session was disposed while a call was in flight. Avoid reusing stubs after disconnect(); the next method call will reconnect automatically.';\n                default:\n                    return 'The RPC transport raised an error. Retry the call — the SDK will open a fresh connection.';\n            }\n        }\n        // Generic fallback for other errors\n        default:\n            return undefined;\n    }\n}\n","/**\n * Standard operation types\n */\nexport const Operation = {\n    // File Operations\n    FILE_READ: 'file.read',\n    FILE_WRITE: 'file.write',\n    FILE_DELETE: 'file.delete',\n    FILE_MOVE: 'file.move',\n    FILE_RENAME: 'file.rename',\n    FILE_STAT: 'file.stat',\n    DIRECTORY_CREATE: 'directory.create',\n    DIRECTORY_LIST: 'directory.list',\n    // Command Operations\n    COMMAND_EXECUTE: 'command.execute',\n    COMMAND_STREAM: 'command.stream',\n    // Process Operations\n    PROCESS_START: 'process.start',\n    PROCESS_KILL: 'process.kill',\n    PROCESS_LIST: 'process.list',\n    PROCESS_GET: 'process.get',\n    PROCESS_LOGS: 'process.logs',\n    // Git Operations\n    GIT_CLONE: 'git.clone',\n    GIT_CHECKOUT: 'git.checkout',\n    GIT_OPERATION: 'git.operation',\n    // Backup Operations\n    BACKUP_CREATE: 'backup.create',\n    BACKUP_RESTORE: 'backup.restore',\n    BACKUP_UNMOUNT: 'backup.unmount',\n    // Code Interpreter\n    CODE_EXECUTE: 'code.execute',\n    CODE_CONTEXT_CREATE: 'code.context.create',\n    CODE_CONTEXT_DELETE: 'code.context.delete'\n};\n"],"mappings":"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"}