@cloudflare/sandbox 0.13.0-next.649.1 → 0.13.0-next.681.1

package/dist/codes-y-U76vnQ.d.ts

@@ -0,0 +1,79 @@
+//#region ../shared/dist/errors/codes.d.ts
+/**
+ * Centralized error code registry
+ * Each code maps to a specific error type with consistent semantics
+ */
+declare const ErrorCode: {
+  readonly FILE_NOT_FOUND: "FILE_NOT_FOUND";
+  readonly PERMISSION_DENIED: "PERMISSION_DENIED";
+  readonly FILE_EXISTS: "FILE_EXISTS";
+  readonly IS_DIRECTORY: "IS_DIRECTORY";
+  readonly NOT_DIRECTORY: "NOT_DIRECTORY";
+  readonly FILE_TOO_LARGE: "FILE_TOO_LARGE";
+  readonly NO_SPACE: "NO_SPACE";
+  readonly TOO_MANY_FILES: "TOO_MANY_FILES";
+  readonly RESOURCE_BUSY: "RESOURCE_BUSY";
+  readonly READ_ONLY: "READ_ONLY";
+  readonly NAME_TOO_LONG: "NAME_TOO_LONG";
+  readonly TOO_MANY_LINKS: "TOO_MANY_LINKS";
+  readonly FILESYSTEM_ERROR: "FILESYSTEM_ERROR";
+  readonly COMMAND_NOT_FOUND: "COMMAND_NOT_FOUND";
+  readonly COMMAND_PERMISSION_DENIED: "COMMAND_PERMISSION_DENIED";
+  readonly INVALID_COMMAND: "INVALID_COMMAND";
+  readonly COMMAND_EXECUTION_ERROR: "COMMAND_EXECUTION_ERROR";
+  readonly STREAM_START_ERROR: "STREAM_START_ERROR";
+  readonly PROCESS_NOT_FOUND: "PROCESS_NOT_FOUND";
+  readonly PROCESS_PERMISSION_DENIED: "PROCESS_PERMISSION_DENIED";
+  readonly PROCESS_ERROR: "PROCESS_ERROR";
+  readonly SESSION_ALREADY_EXISTS: "SESSION_ALREADY_EXISTS";
+  readonly SESSION_DESTROYED: "SESSION_DESTROYED";
+  readonly SESSION_TERMINATED: "SESSION_TERMINATED";
+  readonly PORT_ALREADY_EXPOSED: "PORT_ALREADY_EXPOSED";
+  readonly PORT_IN_USE: "PORT_IN_USE";
+  readonly PORT_NOT_EXPOSED: "PORT_NOT_EXPOSED";
+  readonly INVALID_PORT_NUMBER: "INVALID_PORT_NUMBER";
+  readonly INVALID_PORT: "INVALID_PORT";
+  readonly SERVICE_NOT_RESPONDING: "SERVICE_NOT_RESPONDING";
+  readonly PORT_OPERATION_ERROR: "PORT_OPERATION_ERROR";
+  readonly CUSTOM_DOMAIN_REQUIRED: "CUSTOM_DOMAIN_REQUIRED";
+  readonly GIT_REPOSITORY_NOT_FOUND: "GIT_REPOSITORY_NOT_FOUND";
+  readonly GIT_BRANCH_NOT_FOUND: "GIT_BRANCH_NOT_FOUND";
+  readonly GIT_AUTH_FAILED: "GIT_AUTH_FAILED";
+  readonly GIT_NETWORK_ERROR: "GIT_NETWORK_ERROR";
+  readonly INVALID_GIT_URL: "INVALID_GIT_URL";
+  readonly GIT_CLONE_FAILED: "GIT_CLONE_FAILED";
+  readonly GIT_CHECKOUT_FAILED: "GIT_CHECKOUT_FAILED";
+  readonly GIT_OPERATION_FAILED: "GIT_OPERATION_FAILED";
+  readonly BUCKET_MOUNT_ERROR: "BUCKET_MOUNT_ERROR";
+  readonly BUCKET_UNMOUNT_ERROR: "BUCKET_UNMOUNT_ERROR";
+  readonly S3FS_MOUNT_ERROR: "S3FS_MOUNT_ERROR";
+  readonly MISSING_CREDENTIALS: "MISSING_CREDENTIALS";
+  readonly INVALID_MOUNT_CONFIG: "INVALID_MOUNT_CONFIG";
+  readonly BACKUP_CREATE_FAILED: "BACKUP_CREATE_FAILED";
+  readonly BACKUP_RESTORE_FAILED: "BACKUP_RESTORE_FAILED";
+  readonly BACKUP_NOT_FOUND: "BACKUP_NOT_FOUND";
+  readonly BACKUP_EXPIRED: "BACKUP_EXPIRED";
+  readonly INVALID_BACKUP_CONFIG: "INVALID_BACKUP_CONFIG";
+  readonly INTERPRETER_NOT_READY: "INTERPRETER_NOT_READY";
+  readonly CONTEXT_NOT_FOUND: "CONTEXT_NOT_FOUND";
+  readonly CODE_EXECUTION_ERROR: "CODE_EXECUTION_ERROR";
+  readonly PYTHON_NOT_AVAILABLE: "PYTHON_NOT_AVAILABLE";
+  readonly JAVASCRIPT_NOT_AVAILABLE: "JAVASCRIPT_NOT_AVAILABLE";
+  readonly OPENCODE_STARTUP_FAILED: "OPENCODE_STARTUP_FAILED";
+  readonly PROCESS_READY_TIMEOUT: "PROCESS_READY_TIMEOUT";
+  readonly PROCESS_EXITED_BEFORE_READY: "PROCESS_EXITED_BEFORE_READY";
+  readonly WATCH_NOT_FOUND: "WATCH_NOT_FOUND";
+  readonly WATCH_START_ERROR: "WATCH_START_ERROR";
+  readonly WATCH_STOP_ERROR: "WATCH_STOP_ERROR";
+  readonly VALIDATION_FAILED: "VALIDATION_FAILED";
+  readonly INVALID_JSON_RESPONSE: "INVALID_JSON_RESPONSE";
+  readonly UNKNOWN_ERROR: "UNKNOWN_ERROR";
+  readonly INTERNAL_ERROR: "INTERNAL_ERROR";
+  readonly CONTAINER_UNAVAILABLE: "CONTAINER_UNAVAILABLE";
+  readonly OPERATION_INTERRUPTED: "OPERATION_INTERRUPTED";
+  readonly RPC_TRANSPORT_ERROR: "RPC_TRANSPORT_ERROR";
+};
+type ErrorCode = (typeof ErrorCode)[keyof typeof ErrorCode];
+//#endregion
+export { ErrorCode as t };
+//# sourceMappingURL=codes-y-U76vnQ.d.ts.map

package/dist/codes-y-U76vnQ.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"codes-y-U76vnQ.d.ts","names":["ErrorCode"],"sources":["../../shared/dist/errors/codes.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 PROCESS_PERMISSION_DENIED: \"PROCESS_PERMISSION_DENIED\";\n    readonly PROCESS_ERROR: \"PROCESS_ERROR\";\n    readonly SESSION_ALREADY_EXISTS: \"SESSION_ALREADY_EXISTS\";\n    readonly SESSION_DESTROYED: \"SESSION_DESTROYED\";\n    readonly SESSION_TERMINATED: \"SESSION_TERMINATED\";\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 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 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"],"mappings":";;AAIA;AAsEA;;cAtEqBA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;KAsETA,SAAAA,WAAoBA,wBAAwBA"}

package/dist/contexts-DY1LHU1v.d.ts

@@ -0,0 +1,327 @@
+import { t as ErrorCode } from "./codes-y-U76vnQ.js";
+
+//#region ../shared/dist/errors/types.d.ts
+
+/**
+ * Standard operation types
+ */
+declare const Operation: {
+  readonly FILE_READ: "file.read";
+  readonly FILE_WRITE: "file.write";
+  readonly FILE_DELETE: "file.delete";
+  readonly FILE_MOVE: "file.move";
+  readonly FILE_RENAME: "file.rename";
+  readonly FILE_STAT: "file.stat";
+  readonly DIRECTORY_CREATE: "directory.create";
+  readonly DIRECTORY_LIST: "directory.list";
+  readonly COMMAND_EXECUTE: "command.execute";
+  readonly COMMAND_STREAM: "command.stream";
+  readonly PROCESS_START: "process.start";
+  readonly PROCESS_KILL: "process.kill";
+  readonly PROCESS_LIST: "process.list";
+  readonly PROCESS_GET: "process.get";
+  readonly PROCESS_LOGS: "process.logs";
+  readonly GIT_CLONE: "git.clone";
+  readonly GIT_CHECKOUT: "git.checkout";
+  readonly GIT_OPERATION: "git.operation";
+  readonly BACKUP_CREATE: "backup.create";
+  readonly BACKUP_RESTORE: "backup.restore";
+  readonly BACKUP_UNMOUNT: "backup.unmount";
+  readonly CODE_EXECUTE: "code.execute";
+  readonly CODE_CONTEXT_CREATE: "code.context.create";
+  readonly CODE_CONTEXT_DELETE: "code.context.delete";
+};
+type OperationType = (typeof Operation)[keyof typeof Operation];
+/**
+ * Standard error response format with generic context type
+ * TContext allows type-safe access to error-specific context
+ */
+interface ErrorResponse<TContext = Record<string, unknown>> {
+  /**
+   * Error type code (machine-readable)
+   */
+  code: ErrorCode;
+  /**
+   * Human-readable error message
+   */
+  message: string;
+  /**
+   * Operation that was attempted (useful for debugging and logging)
+   */
+  operation?: OperationType;
+  /**
+   * Structured error context with relevant details
+   * Type varies based on error code
+   */
+  context: TContext;
+  /**
+   * HTTP status code (for client SDK)
+   */
+  httpStatus: number;
+  /**
+   * Timestamp when error occurred
+   */
+  timestamp: string;
+  /**
+   * Actionable suggestion for fixing the error
+   */
+  suggestion?: string;
+  /**
+   * Link to documentation
+   */
+  documentation?: string;
+}
+//#endregion
+//#region ../shared/dist/errors/contexts.d.ts
+/**
+ * File system error contexts
+ */
+interface FileNotFoundContext {
+  path: string;
+  operation: OperationType;
+}
+interface FileExistsContext {
+  path: string;
+  operation: OperationType;
+}
+interface FileTooLargeContext {
+  path: string;
+  operation: OperationType;
+  maxSize: number;
+  actualSize: number;
+}
+interface FileSystemContext {
+  path: string;
+  operation: OperationType;
+  stderr?: string;
+  exitCode?: number;
+}
+/**
+ * Command error contexts
+ */
+interface CommandNotFoundContext {
+  command: string;
+}
+interface CommandErrorContext {
+  command: string;
+  exitCode?: number;
+  stdout?: string;
+  stderr?: string;
+}
+/**
+ * Process error contexts
+ */
+interface ProcessNotFoundContext {
+  processId: string;
+}
+interface ProcessErrorContext {
+  processId: string;
+  pid?: number;
+  exitCode?: number;
+  stderr?: string;
+}
+interface SessionAlreadyExistsContext {
+  sessionId: string;
+  /**
+   * `CLOUDFLARE_PLACEMENT_ID` captured from the container at the moment the
+   * duplicate create was detected. Included so a restarted DO can learn the
+   * container's placement ID from an idempotent session-create. `null` when
+   * the env var is not set (for example, in local development).
+   */
+  containerPlacementId?: string | null;
+}
+interface SessionDestroyedContext {
+  sessionId: string;
+}
+interface SessionTerminatedContext {
+  sessionId: string;
+  exitCode: number | null;
+}
+/**
+ * Process readiness error contexts
+ */
+interface ProcessReadyTimeoutContext {
+  processId: string;
+  command: string;
+  condition: string;
+  timeout: number;
+}
+interface ProcessExitedBeforeReadyContext {
+  processId: string;
+  command: string;
+  condition: string;
+  exitCode: number;
+}
+/**
+ * Port error contexts
+ */
+interface PortAlreadyExposedContext {
+  port: number;
+  portName?: string;
+}
+interface PortNotExposedContext {
+  port: number;
+}
+interface InvalidPortContext {
+  port: number;
+  reason: string;
+}
+interface PortErrorContext {
+  port: number;
+  portName?: string;
+  stderr?: string;
+}
+/**
+ * Git error contexts
+ */
+interface GitRepositoryNotFoundContext {
+  repository: string;
+}
+interface GitAuthFailedContext {
+  repository: string;
+}
+interface GitBranchNotFoundContext {
+  branch: string;
+  repository?: string;
+}
+interface GitErrorContext {
+  repository?: string;
+  branch?: string;
+  targetDir?: string;
+  stderr?: string;
+  exitCode?: number;
+}
+/**
+ * Code interpreter error contexts
+ */
+interface InterpreterNotReadyContext {
+  retryAfter?: number;
+  progress?: number;
+}
+interface ContextNotFoundContext {
+  contextId: string;
+}
+interface CodeExecutionContext {
+  contextId?: string;
+  ename?: string;
+  evalue?: string;
+  traceback?: string[];
+}
+/**
+ * Validation error contexts
+ */
+interface ValidationFailedContext {
+  validationErrors: Array<{
+    field: string;
+    message: string;
+    code?: string;
+  }>;
+}
+/**
+ * Backup error contexts
+ */
+interface BackupCreateContext {
+  dir: string;
+  backupId?: string;
+  stderr?: string;
+  exitCode?: number;
+}
+interface BackupRestoreContext {
+  dir: string;
+  backupId: string;
+  stderr?: string;
+  exitCode?: number;
+}
+interface BackupNotFoundContext {
+  backupId: string;
+}
+interface BackupExpiredContext {
+  backupId: string;
+  expiredAt?: string;
+}
+interface InvalidBackupConfigContext {
+  reason: string;
+}
+/**
+ * OpenCode error contexts
+ */
+interface OpenCodeStartupContext {
+  port: number;
+  stderr?: string;
+  command?: string;
+}
+/**
+ * Generic error contexts
+ */
+interface InternalErrorContext {
+  originalError?: string;
+  stack?: string;
+  [key: string]: unknown;
+}
+/**
+ * Container availability error context. Surfaced when the sandbox container
+ * cannot accept the incoming RPC connection. The container may be starting
+ * up, undergoing a runtime replacement, or temporarily unhealthy. The
+ * caller should retry the same operation.
+ */
+interface ContainerUnavailableContext {
+  /**
+   * Categorical reason distinguishing startup unavailability from runtime
+   * replacement and exhausted upgrade retries.
+   */
+  reason: 'container_starting' | 'container_unhealthy' | 'container_replaced' | 'rpc_upgrade_failed';
+  /**
+   * Always true — this error represents a transient unavailability, not a
+   * permanent failure. Callers should retry the same operation.
+   */
+  retryable: true;
+  /** Suggested delay in milliseconds before the next retry attempt. */
+  retryAfterMs?: number;
+}
+type OperationInterruptedReason = 'runtime_replaced' | 'container_stopped' | 'transport_disposed' | 'sandbox_destroyed' | 'sandbox_lifetime_changed' | 'recovery_exhausted' | 'unknown';
+interface OperationInterruptedContext {
+  reason: OperationInterruptedReason;
+  operation: string;
+  phase?: string;
+  admitted: true | 'unknown';
+  retryable: boolean;
+  operationId?: string;
+  operationKey?: string;
+  idempotencyKey?: string;
+  recoveryAttempts?: number;
+  maxRecoveryAttempts?: number;
+  backupId?: string;
+  dir?: string;
+}
+/**
+ * RPC transport error contexts. Surfaced when the capnweb WebSocket session
+ * fails on the SDK side rather than the container reporting a structured
+ * error. Always retryable — the next call will open a fresh connection.
+ */
+type RPCTransportErrorKind = /** Server closed the WebSocket (container crash, DO eviction, network blip). */
+'peer_closed'
+/** Underlying socket fired the `error` event. */ | 'connection_failed'
+/** WebSocket upgrade failed before the session was established. */ | 'upgrade_failed'
+/** Peer sent a non-string frame; capnweb's wire format is JSON text only. */ | 'invalid_frame'
+/** Peer sent a frame the wire-format parser rejected (capnweb readLoop SyntaxError). */ | 'protocol_error'
+/** Session was disposed (locally or remotely) while a call was pending. */ | 'session_disposed'
+/** Anything else that bubbled up from the transport with no recognisable shape. */ | 'unknown';
+interface RPCTransportContext {
+  /** Categorical bucket so callers can branch on `peer_closed` vs `upgrade_failed` etc. */
+  kind: RPCTransportErrorKind;
+  /** Original error message, verbatim from capnweb / our DeferredTransport. */
+  originalMessage: string;
+  /**
+   * The underlying Error's `name` property. capnweb preserves this across
+   * the wire for the standard built-ins (TypeError, SyntaxError, etc.), so
+   * it's a more reliable hint than the message string for those cases.
+   */
+  errorName: string;
+  /** WebSocket close code, when available (kind === 'peer_closed'). */
+  closeCode?: number;
+  /** WebSocket close reason, when available (kind === 'peer_closed'). */
+  closeReason?: string;
+}
+//#endregion
+export { ProcessNotFoundContext as A, OperationType as B, OperationInterruptedContext as C, PortNotExposedContext as D, PortErrorContext as E, SessionDestroyedContext as F, SessionTerminatedContext as I, ValidationFailedContext as L, RPCTransportContext as M, RPCTransportErrorKind as N, ProcessErrorContext as O, SessionAlreadyExistsContext as P, ErrorResponse as R, OpenCodeStartupContext as S, PortAlreadyExposedContext as T, GitRepositoryNotFoundContext as _, CodeExecutionContext as a, InvalidBackupConfigContext as b, ContainerUnavailableContext as c, FileNotFoundContext as d, FileSystemContext as f, GitErrorContext as g, GitBranchNotFoundContext as h, BackupRestoreContext as i, ProcessReadyTimeoutContext as j, ProcessExitedBeforeReadyContext as k, ContextNotFoundContext as l, GitAuthFailedContext as m, BackupExpiredContext as n, CommandErrorContext as o, FileTooLargeContext as p, BackupNotFoundContext as r, CommandNotFoundContext as s, BackupCreateContext as t, FileExistsContext as u, InternalErrorContext as v, OperationInterruptedReason as w, InvalidPortContext as x, InterpreterNotReadyContext as y, Operation as z };
+//# sourceMappingURL=contexts-DY1LHU1v.d.ts.map

package/dist/contexts-DY1LHU1v.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contexts-DY1LHU1v.d.ts","names":["ErrorCode","Operation","OperationType","ErrorResponse","TContext","Record","ServiceError","ServiceResult","T","OperationType","FileNotFoundContext","FileExistsContext","FileTooLargeContext","FileSystemContext","CommandNotFoundContext","CommandErrorContext","ProcessNotFoundContext","ProcessErrorContext","SessionAlreadyExistsContext","SessionDestroyedContext","SessionTerminatedContext","ProcessReadyTimeoutContext","ProcessExitedBeforeReadyContext","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/types.d.ts","../../shared/dist/errors/contexts.d.ts"],"sourcesContent":["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 { 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 SessionAlreadyExistsContext {\n    sessionId: string;\n    /**\n     * `CLOUDFLARE_PLACEMENT_ID` captured from the container at the moment the\n     * duplicate create was detected. Included so a restarted DO can learn the\n     * container's placement ID from an idempotent session-create. `null` when\n     * the env var is not set (for example, in local development).\n     */\n    containerPlacementId?: string | null;\n}\nexport interface SessionDestroyedContext {\n    sessionId: string;\n}\nexport interface SessionTerminatedContext {\n    sessionId: string;\n    exitCode: number | null;\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}\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'\n/** Session was disposed (locally or remotely) while a call was pending. */\n | '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/{dist-mAH_7Ui7.js → dist-BStBkGIC.js}

@@ -152,98 +152,38 @@ function truncateForLog(value, maxLen = 120) {
 }
 
 //#endregion
-//#region ../shared/dist/interpreter-types.js
-var Execution = class {
-	code;
-	context;
-	/**
-	* All results from the execution
-	*/
-	results = [];
-	/**
-	* Accumulated stdout and stderr
-	*/
-	logs = {
-		stdout: [],
-		stderr: []
-	};
-	/**
-	* Execution error if any
-	*/
-	error;
-	/**
-	* Execution count (for interpreter)
-	*/
-	executionCount;
-	constructor(code, context) {
-		this.code = code;
-		this.context = context;
-	}
-	/**
-	* Convert to a plain object for serialization
-	*/
-	toJSON() {
-		return {
-			code: this.code,
-			logs: this.logs,
-			error: this.error,
-			executionCount: this.executionCount,
-			results: this.results.map((result) => ({
-				text: result.text,
-				html: result.html,
-				png: result.png,
-				jpeg: result.jpeg,
-				svg: result.svg,
-				latex: result.latex,
-				markdown: result.markdown,
-				javascript: result.javascript,
-				json: result.json,
-				chart: result.chart,
-				data: result.data
-			}))
-		};
-	}
-};
-var ResultImpl = class {
-	text;
-	html;
-	png;
-	jpeg;
-	svg;
-	latex;
-	markdown;
-	javascript;
-	json;
-	chart;
-	data;
-	constructor(raw) {
-		this.text = raw.text || raw.data?.["text/plain"];
-		this.html = raw.html || raw.data?.["text/html"];
-		this.png = raw.png || raw.data?.["image/png"];
-		this.jpeg = raw.jpeg || raw.data?.["image/jpeg"];
-		this.svg = raw.svg || raw.data?.["image/svg+xml"];
-		this.latex = raw.latex || raw.data?.["text/latex"];
-		this.markdown = raw.markdown || raw.data?.["text/markdown"];
-		this.javascript = raw.javascript || raw.data?.["application/javascript"];
-		this.json = raw.json || raw.data?.["application/json"];
-		this.chart = raw.chart;
-		this.data = raw.data;
-	}
-	formats() {
-		const fmts = [];
-		if (this.text) fmts.push("text");
-		if (this.html) fmts.push("html");
-		if (this.png) fmts.push("png");
-		if (this.jpeg) fmts.push("jpeg");
-		if (this.svg) fmts.push("svg");
-		if (this.latex) fmts.push("latex");
-		if (this.markdown) fmts.push("markdown");
-		if (this.javascript) fmts.push("javascript");
-		if (this.json) fmts.push("json");
-		if (this.chart) fmts.push("chart");
-		return fmts;
+//#region ../shared/dist/git.js
+/**
+* Fallback repository name used when URL parsing fails
+*/
+const FALLBACK_REPO_NAME = "repository";
+/** Default wall-clock timeout in milliseconds for git clone operations. */
+const DEFAULT_GIT_CLONE_TIMEOUT_MS = 6e5;
+/**
+* Extract repository name from a Git URL
+*
+* Supports multiple URL formats:
+* - HTTPS: https://github.com/user/repo.git → repo
+* - HTTPS without .git: https://github.com/user/repo → repo
+* - SSH: git@github.com:user/repo.git → repo
+* - GitLab/others: https://gitlab.com/org/project.git → project
+*
+* @param repoUrl - Git repository URL (HTTPS or SSH format)
+* @returns Repository name extracted from URL, or 'repository' as fallback
+*/
+function extractRepoName(repoUrl) {
+	try {
+		const pathParts = new URL(repoUrl).pathname.split("/");
+		const lastPart = pathParts[pathParts.length - 1];
+		if (lastPart) return lastPart.replace(/\.git$/, "");
+	} catch {}
+	if (repoUrl.includes(":") || repoUrl.includes("/")) {
+		const segments = repoUrl.split(/[:/]/).filter(Boolean);
+		const lastSegment = segments[segments.length - 1];
+		if (lastSegment) return lastSegment.replace(/\.git$/, "");
 	}
-};
+	return FALLBACK_REPO_NAME;
+}
 
 //#endregion
 //#region ../shared/dist/logger/canonical.js
@@ -762,6 +702,23 @@ function getEnvVar(name) {
 	}
 }
 
+//#endregion
+//#region ../shared/dist/rpc-types.js
+/**
+* Shared interface types for the container-control path.
+*
+* Defines the contract between the SDK control client and the container
+* control-plane API. The current wire implementation uses capnweb RPC.
+*/
+/**
+* Error name thrown by the host's `connect` when it has not yet provisioned
+* the requested hash and the request did not carry tarball bytes. The SDK
+* recognises this name via `Error.name` and retries the connect with the
+* bytes attached. Kept as a string constant so it survives capnweb
+* cross-realm error reconstruction.
+*/
+const EXTENSION_TARBALL_REQUIRED = "ExtensionTarballRequired";
+
 //#endregion
 //#region ../shared/dist/shell-escape.js
 /**
@@ -840,5 +797,5 @@ function isProcessStatus(value) {
 }
 
 //#endregion
-export { shellEscape as a, TraceContext as c, ResultImpl as d, filterEnvVars as f, parseSSEFrames as i, logCanonicalEvent as l, partitionEnvVars as m, isProcess as n, createLogger as o, getEnvString as p, isProcessStatus as r, createNoOpLogger as s, isExecResult as t, Execution as u };
-//# sourceMappingURL=dist-mAH_7Ui7.js.map
+export { shellEscape as a, createNoOpLogger as c, DEFAULT_GIT_CLONE_TIMEOUT_MS as d, extractRepoName as f, partitionEnvVars as g, getEnvString as h, parseSSEFrames as i, TraceContext as l, filterEnvVars as m, isProcess as n, EXTENSION_TARBALL_REQUIRED as o, redactCommand as p, isProcessStatus as r, createLogger as s, isExecResult as t, logCanonicalEvent as u };
+//# sourceMappingURL=dist-BStBkGIC.js.map