@cloudflare/sandbox 0.2.0 → 0.2.2

package/dist/chunk-LALY4SFU.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/errors.ts"],"sourcesContent":["/**\n * Standard error response from the sandbox API\n */\nexport interface SandboxErrorResponse {\n  error?: string;\n  status?: string;\n  progress?: number;\n}\n\n/**\n * Base error class for all Sandbox-related errors\n */\nexport class SandboxError extends Error {\n  constructor(message: string) {\n    super(message);\n    this.name = this.constructor.name;\n\n    // Maintains proper stack trace for where our error was thrown (only available on V8)\n    if (Error.captureStackTrace) {\n      Error.captureStackTrace(this, this.constructor);\n    }\n  }\n}\n\n/**\n * Error thrown when Jupyter functionality is requested but the service is still initializing.\n *\n * Note: With the current implementation, requests wait for Jupyter to be ready.\n * This error is only thrown when:\n * 1. The request times out waiting for Jupyter (default: 30 seconds)\n * 2. Jupyter initialization actually fails\n *\n * Most requests will succeed after a delay, not throw this error.\n */\nexport class JupyterNotReadyError extends SandboxError {\n  public readonly code = \"JUPYTER_NOT_READY\";\n  public readonly retryAfter: number;\n  public readonly progress?: number;\n\n  constructor(\n    message?: string,\n    options?: { retryAfter?: number; progress?: number }\n  ) {\n    super(\n      message || \"Jupyter is still initializing. Please retry in a few seconds.\"\n    );\n    this.retryAfter = options?.retryAfter || 5;\n    this.progress = options?.progress;\n  }\n}\n\n/**\n * Error thrown when a context is not found\n */\nexport class ContextNotFoundError extends SandboxError {\n  public readonly code = \"CONTEXT_NOT_FOUND\";\n  public readonly contextId: string;\n\n  constructor(contextId: string) {\n    super(`Context ${contextId} not found`);\n    this.contextId = contextId;\n  }\n}\n\n/**\n * Error thrown when code execution fails\n */\nexport class CodeExecutionError extends SandboxError {\n  public readonly code = \"CODE_EXECUTION_ERROR\";\n  public readonly executionError?: {\n    ename?: string;\n    evalue?: string;\n    traceback?: string[];\n  };\n\n  constructor(message: string, executionError?: any) {\n    super(message);\n    this.executionError = executionError;\n  }\n}\n\n/**\n * Error thrown when the sandbox container is not ready\n */\nexport class ContainerNotReadyError extends SandboxError {\n  public readonly code = \"CONTAINER_NOT_READY\";\n\n  constructor(message?: string) {\n    super(\n      message ||\n        \"Container is not ready. Please wait for initialization to complete.\"\n    );\n  }\n}\n\n/**\n * Error thrown when a network request to the sandbox fails\n */\nexport class SandboxNetworkError extends SandboxError {\n  public readonly code = \"NETWORK_ERROR\";\n  public readonly statusCode?: number;\n  public readonly statusText?: string;\n\n  constructor(message: string, statusCode?: number, statusText?: string) {\n    super(message);\n    this.statusCode = statusCode;\n    this.statusText = statusText;\n  }\n}\n\n/**\n * Error thrown when service is temporarily unavailable (e.g., circuit breaker open)\n */\nexport class ServiceUnavailableError extends SandboxError {\n  public readonly code = \"SERVICE_UNAVAILABLE\";\n  public readonly retryAfter?: number;\n\n  constructor(message?: string, retryAfter?: number) {\n    // Simple, user-friendly message without implementation details\n    super(message || \"Service temporarily unavailable\");\n    this.retryAfter = retryAfter;\n  }\n}\n\n/**\n * Type guard to check if an error is a JupyterNotReadyError\n */\nexport function isJupyterNotReadyError(\n  error: unknown\n): error is JupyterNotReadyError {\n  return error instanceof JupyterNotReadyError;\n}\n\n/**\n * Type guard to check if an error is any SandboxError\n */\nexport function isSandboxError(error: unknown): error is SandboxError {\n  return error instanceof SandboxError;\n}\n\n/**\n * Helper to determine if an error is retryable\n */\nexport function isRetryableError(error: unknown): boolean {\n  if (\n    error instanceof JupyterNotReadyError ||\n    error instanceof ContainerNotReadyError ||\n    error instanceof ServiceUnavailableError\n  ) {\n    return true;\n  }\n\n  if (error instanceof SandboxNetworkError) {\n    // Retry on 502, 503, 504 (gateway/service unavailable errors)\n    return error.statusCode\n      ? [502, 503, 504].includes(error.statusCode)\n      : false;\n  }\n\n  return false;\n}\n\n/**\n * Parse error response from the sandbox API and return appropriate error instance\n */\nexport async function parseErrorResponse(\n  response: Response\n): Promise<SandboxError> {\n  let data: SandboxErrorResponse;\n\n  try {\n    data = (await response.json()) as SandboxErrorResponse;\n  } catch {\n    // If JSON parsing fails, return a generic network error\n    return new SandboxNetworkError(\n      `Request failed with status ${response.status}`,\n      response.status,\n      response.statusText\n    );\n  }\n\n  // Check for specific error types based on response\n  if (response.status === 503) {\n    // Circuit breaker error\n    if (data.status === \"circuit_open\") {\n      return new ServiceUnavailableError(\n        \"Service temporarily unavailable\",\n        parseInt(response.headers.get(\"Retry-After\") || \"30\")\n      );\n    }\n\n    // Jupyter initialization error\n    if (data.status === \"initializing\") {\n      return new JupyterNotReadyError(data.error, {\n        retryAfter: parseInt(response.headers.get(\"Retry-After\") || \"5\"),\n        progress: data.progress,\n      });\n    }\n  }\n\n  // Check for context not found\n  if (\n    response.status === 404 &&\n    data.error?.includes(\"Context\") &&\n    data.error?.includes(\"not found\")\n  ) {\n    const contextId =\n      data.error.match(/Context (\\S+) not found/)?.[1] || \"unknown\";\n    return new ContextNotFoundError(contextId);\n  }\n\n  // Default network error\n  return new SandboxNetworkError(\n    data.error || `Request failed with status ${response.status}`,\n    response.status,\n    response.statusText\n  );\n}\n"],"mappings":"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","names":[]}

package/dist/{chunk-6THNBO4S.js → chunk-S5FFBU4Y.js}

@@ -43,4 +43,4 @@ export {
   isProcess,
   isProcessStatus
 };
-//# sourceMappingURL=chunk-6THNBO4S.js.map
+//# sourceMappingURL=chunk-S5FFBU4Y.js.map

package/dist/{chunk-6THNBO4S.js.map → chunk-S5FFBU4Y.js.map}

@@ -1 +1 @@
-{"version":3,"sources":["../src/types.ts"],"sourcesContent":["// Core Types\n\nexport interface BaseExecOptions {\n  /**\n   * Session ID for grouping related commands\n   */\n  sessionId?: string;\n\n  /**\n   * Maximum execution time in milliseconds\n   */\n  timeout?: number;\n\n  /**\n   * Environment variables for the command\n   */\n  env?: Record<string, string>;\n\n  /**\n   * Working directory for command execution\n   */\n  cwd?: string;\n\n  /**\n   * Text encoding for output (default: 'utf8')\n   */\n  encoding?: string;\n}\n\nexport interface ExecOptions extends BaseExecOptions {\n  /**\n   * Enable real-time output streaming via callbacks\n   */\n  stream?: boolean;\n\n  /**\n   * Callback for real-time output data\n   */\n  onOutput?: (stream: 'stdout' | 'stderr', data: string) => void;\n\n  /**\n   * Callback when command completes (only when stream: true)\n   */\n  onComplete?: (result: ExecResult) => void;\n\n  /**\n   * Callback for execution errors\n   */\n  onError?: (error: Error) => void;\n\n  /**\n   * AbortSignal for cancelling execution\n   */\n  signal?: AbortSignal;\n}\n\nexport interface ExecResult {\n  /**\n   * Whether the command succeeded (exitCode === 0)\n   */\n  success: boolean;\n\n  /**\n   * Process exit code\n   */\n  exitCode: number;\n\n  /**\n   * Standard output content\n   */\n  stdout: string;\n\n  /**\n   * Standard error content\n   */\n  stderr: string;\n\n  /**\n   * Command that was executed\n   */\n  command: string;\n\n\n  /**\n   * Execution duration in milliseconds\n   */\n  duration: number;\n\n  /**\n   * ISO timestamp when command started\n   */\n  timestamp: string;\n\n  /**\n   * Session ID if provided\n   */\n  sessionId?: string;\n}\n\n// Background Process Types\n\nexport interface ProcessOptions extends BaseExecOptions {\n  /**\n   * Custom process ID for later reference\n   * If not provided, a UUID will be generated\n   */\n  processId?: string;\n\n  /**\n   * Automatically cleanup process record after exit (default: true)\n   */\n  autoCleanup?: boolean;\n\n  /**\n   * Callback when process exits\n   */\n  onExit?: (code: number | null) => void;\n\n  /**\n   * Callback for real-time output (background processes)\n   */\n  onOutput?: (stream: 'stdout' | 'stderr', data: string) => void;\n\n  /**\n   * Callback when process starts successfully\n   */\n  onStart?: (process: Process) => void;\n\n  /**\n   * Callback for process errors\n   */\n  onError?: (error: Error) => void;\n}\n\nexport type ProcessStatus =\n  | 'starting'    // Process is being initialized\n  | 'running'     // Process is actively running\n  | 'completed'   // Process exited successfully (code 0)\n  | 'failed'      // Process exited with non-zero code\n  | 'killed'      // Process was terminated by signal\n  | 'error';      // Process failed to start or encountered error\n\nexport interface Process {\n  /**\n   * Unique process identifier\n   */\n  readonly id: string;\n\n  /**\n   * System process ID (if available and running)\n   */\n  readonly pid?: number;\n\n  /**\n   * Command that was executed\n   */\n  readonly command: string;\n\n\n  /**\n   * Current process status\n   */\n  readonly status: ProcessStatus;\n\n  /**\n   * When the process was started\n   */\n  readonly startTime: Date;\n\n  /**\n   * When the process ended (if completed)\n   */\n  readonly endTime?: Date;\n\n  /**\n   * Process exit code (if completed)\n   */\n  readonly exitCode?: number;\n\n  /**\n   * Session ID if provided\n   */\n  readonly sessionId?: string;\n\n  /**\n   * Kill the process\n   */\n  kill(signal?: string): Promise<void>;\n\n  /**\n   * Get current process status (refreshed)\n   */\n  getStatus(): Promise<ProcessStatus>;\n\n  /**\n   * Get accumulated logs\n   */\n  getLogs(): Promise<{ stdout: string; stderr: string }>;\n}\n\n// Streaming Types\n\nexport interface ExecEvent {\n  type: 'start' | 'stdout' | 'stderr' | 'complete' | 'error';\n  timestamp: string;\n  data?: string;\n  command?: string;\n  exitCode?: number;\n  result?: ExecResult;\n  error?: string; // Changed to string for serialization\n  sessionId?: string;\n}\n\nexport interface LogEvent {\n  type: 'stdout' | 'stderr' | 'exit' | 'error';\n  timestamp: string;\n  data: string;\n  processId: string;\n  sessionId?: string;\n  exitCode?: number; // For 'exit' events\n}\n\nexport interface StreamOptions extends BaseExecOptions {\n  /**\n   * Buffer size for streaming output\n   */\n  bufferSize?: number;\n\n  /**\n   * AbortSignal for cancelling stream\n   */\n  signal?: AbortSignal;\n}\n\n// Error Types\n\nexport class SandboxError extends Error {\n  constructor(message: string, public code?: string) {\n    super(message);\n    this.name = 'SandboxError';\n  }\n}\n\nexport class ProcessNotFoundError extends SandboxError {\n  constructor(processId: string) {\n    super(`Process not found: ${processId}`, 'PROCESS_NOT_FOUND');\n    this.name = 'ProcessNotFoundError';\n  }\n}\n\nexport class ProcessAlreadyExistsError extends SandboxError {\n  constructor(processId: string) {\n    super(`Process already exists: ${processId}`, 'PROCESS_EXISTS');\n    this.name = 'ProcessAlreadyExistsError';\n  }\n}\n\nexport class ExecutionTimeoutError extends SandboxError {\n  constructor(timeout: number) {\n    super(`Execution timed out after ${timeout}ms`, 'EXECUTION_TIMEOUT');\n    this.name = 'ExecutionTimeoutError';\n  }\n}\n\n// Internal Container Types\n\nexport interface ProcessRecord {\n  id: string;\n  pid?: number;\n  command: string;\n  status: ProcessStatus;\n  startTime: Date;\n  endTime?: Date;\n  exitCode?: number;\n  sessionId?: string;\n\n  // Internal fields\n  childProcess?: any;  // Node.js ChildProcess\n  stdout: string;      // Accumulated output (ephemeral)\n  stderr: string;      // Accumulated output (ephemeral)\n\n  // Streaming\n  outputListeners: Set<(stream: 'stdout' | 'stderr', data: string) => void>;\n  statusListeners: Set<(status: ProcessStatus) => void>;\n}\n\n// Container Request/Response Types\n\nexport interface StartProcessRequest {\n  command: string;\n  options?: {\n    processId?: string;\n    sessionId?: string;\n    timeout?: number;\n    env?: Record<string, string>;\n    cwd?: string;\n    encoding?: string;\n    autoCleanup?: boolean;\n  };\n}\n\nexport interface StartProcessResponse {\n  process: {\n    id: string;\n    pid?: number;\n    command: string;\n      status: ProcessStatus;\n    startTime: string;\n    sessionId?: string;\n  };\n}\n\nexport interface ListProcessesResponse {\n  processes: Array<{\n    id: string;\n    pid?: number;\n    command: string;\n      status: ProcessStatus;\n    startTime: string;\n    endTime?: string;\n    exitCode?: number;\n    sessionId?: string;\n  }>;\n}\n\nexport interface GetProcessResponse {\n  process: {\n    id: string;\n    pid?: number;\n    command: string;\n      status: ProcessStatus;\n    startTime: string;\n    endTime?: string;\n    exitCode?: number;\n    sessionId?: string;\n  } | null;\n}\n\nexport interface GetProcessLogsResponse {\n  stdout: string;\n  stderr: string;\n  processId: string;\n}\n\n// Main Sandbox Interface\n\nexport interface ISandbox {\n  // Enhanced execution API\n  exec(command: string, options?: ExecOptions): Promise<ExecResult>;\n\n  // Background process management\n  startProcess(command: string, options?: ProcessOptions): Promise<Process>;\n  listProcesses(): Promise<Process[]>;\n  getProcess(id: string): Promise<Process | null>;\n  killProcess(id: string, signal?: string): Promise<void>;\n  killAllProcesses(): Promise<number>;\n\n  // Advanced streaming - returns ReadableStream that can be converted to AsyncIterable\n  execStream(command: string, options?: StreamOptions): Promise<ReadableStream<Uint8Array>>;\n  streamProcessLogs(processId: string, options?: { signal?: AbortSignal }): Promise<ReadableStream<Uint8Array>>;\n\n  // Utility methods\n  cleanupCompletedProcesses(): Promise<number>;\n  getProcessLogs(id: string): Promise<{ stdout: string; stderr: string }>;\n}\n\n// Type Guards\n\nexport function isExecResult(value: any): value is ExecResult {\n  return value &&\n    typeof value.success === 'boolean' &&\n    typeof value.exitCode === 'number' &&\n    typeof value.stdout === 'string' &&\n    typeof value.stderr === 'string';\n}\n\nexport function isProcess(value: any): value is Process {\n  return value &&\n    typeof value.id === 'string' &&\n    typeof value.command === 'string' &&\n    typeof value.status === 'string';\n}\n\nexport function isProcessStatus(value: string): value is ProcessStatus {\n  return ['starting', 'running', 'completed', 'failed', 'killed', 'error'].includes(value);\n}"],"mappings":";AA4OO,IAAM,eAAN,cAA2B,MAAM;AAAA,EACtC,YAAY,SAAwB,MAAe;AACjD,UAAM,OAAO;AADqB;AAElC,SAAK,OAAO;AAAA,EACd;AACF;AAEO,IAAM,uBAAN,cAAmC,aAAa;AAAA,EACrD,YAAY,WAAmB;AAC7B,UAAM,sBAAsB,SAAS,IAAI,mBAAmB;AAC5D,SAAK,OAAO;AAAA,EACd;AACF;AAEO,IAAM,4BAAN,cAAwC,aAAa;AAAA,EAC1D,YAAY,WAAmB;AAC7B,UAAM,2BAA2B,SAAS,IAAI,gBAAgB;AAC9D,SAAK,OAAO;AAAA,EACd;AACF;AAEO,IAAM,wBAAN,cAAoC,aAAa;AAAA,EACtD,YAAY,SAAiB;AAC3B,UAAM,6BAA6B,OAAO,MAAM,mBAAmB;AACnE,SAAK,OAAO;AAAA,EACd;AACF;AA0GO,SAAS,aAAa,OAAiC;AAC5D,SAAO,SACL,OAAO,MAAM,YAAY,aACzB,OAAO,MAAM,aAAa,YAC1B,OAAO,MAAM,WAAW,YACxB,OAAO,MAAM,WAAW;AAC5B;AAEO,SAAS,UAAU,OAA8B;AACtD,SAAO,SACL,OAAO,MAAM,OAAO,YACpB,OAAO,MAAM,YAAY,YACzB,OAAO,MAAM,WAAW;AAC5B;AAEO,SAAS,gBAAgB,OAAuC;AACrE,SAAO,CAAC,YAAY,WAAW,aAAa,UAAU,UAAU,OAAO,EAAE,SAAS,KAAK;AACzF;","names":[]}
+{"version":3,"sources":["../src/types.ts"],"sourcesContent":["// Core Types\n\nexport interface BaseExecOptions {\n  /**\n   * Session ID for grouping related commands\n   */\n  sessionId?: string;\n\n  /**\n   * Maximum execution time in milliseconds\n   */\n  timeout?: number;\n\n  /**\n   * Environment variables for the command\n   */\n  env?: Record<string, string>;\n\n  /**\n   * Working directory for command execution\n   */\n  cwd?: string;\n\n  /**\n   * Text encoding for output (default: 'utf8')\n   */\n  encoding?: string;\n}\n\nexport interface ExecOptions extends BaseExecOptions {\n  /**\n   * Enable real-time output streaming via callbacks\n   */\n  stream?: boolean;\n\n  /**\n   * Callback for real-time output data\n   */\n  onOutput?: (stream: 'stdout' | 'stderr', data: string) => void;\n\n  /**\n   * Callback when command completes (only when stream: true)\n   */\n  onComplete?: (result: ExecResult) => void;\n\n  /**\n   * Callback for execution errors\n   */\n  onError?: (error: Error) => void;\n\n  /**\n   * AbortSignal for cancelling execution\n   */\n  signal?: AbortSignal;\n}\n\nexport interface ExecResult {\n  /**\n   * Whether the command succeeded (exitCode === 0)\n   */\n  success: boolean;\n\n  /**\n   * Process exit code\n   */\n  exitCode: number;\n\n  /**\n   * Standard output content\n   */\n  stdout: string;\n\n  /**\n   * Standard error content\n   */\n  stderr: string;\n\n  /**\n   * Command that was executed\n   */\n  command: string;\n\n\n  /**\n   * Execution duration in milliseconds\n   */\n  duration: number;\n\n  /**\n   * ISO timestamp when command started\n   */\n  timestamp: string;\n\n  /**\n   * Session ID if provided\n   */\n  sessionId?: string;\n}\n\n// Background Process Types\n\nexport interface ProcessOptions extends BaseExecOptions {\n  /**\n   * Custom process ID for later reference\n   * If not provided, a UUID will be generated\n   */\n  processId?: string;\n\n  /**\n   * Automatically cleanup process record after exit (default: true)\n   */\n  autoCleanup?: boolean;\n\n  /**\n   * Callback when process exits\n   */\n  onExit?: (code: number | null) => void;\n\n  /**\n   * Callback for real-time output (background processes)\n   */\n  onOutput?: (stream: 'stdout' | 'stderr', data: string) => void;\n\n  /**\n   * Callback when process starts successfully\n   */\n  onStart?: (process: Process) => void;\n\n  /**\n   * Callback for process errors\n   */\n  onError?: (error: Error) => void;\n}\n\nexport type ProcessStatus =\n  | 'starting'    // Process is being initialized\n  | 'running'     // Process is actively running\n  | 'completed'   // Process exited successfully (code 0)\n  | 'failed'      // Process exited with non-zero code\n  | 'killed'      // Process was terminated by signal\n  | 'error';      // Process failed to start or encountered error\n\nexport interface Process {\n  /**\n   * Unique process identifier\n   */\n  readonly id: string;\n\n  /**\n   * System process ID (if available and running)\n   */\n  readonly pid?: number;\n\n  /**\n   * Command that was executed\n   */\n  readonly command: string;\n\n\n  /**\n   * Current process status\n   */\n  readonly status: ProcessStatus;\n\n  /**\n   * When the process was started\n   */\n  readonly startTime: Date;\n\n  /**\n   * When the process ended (if completed)\n   */\n  readonly endTime?: Date;\n\n  /**\n   * Process exit code (if completed)\n   */\n  readonly exitCode?: number;\n\n  /**\n   * Session ID if provided\n   */\n  readonly sessionId?: string;\n\n  /**\n   * Kill the process\n   */\n  kill(signal?: string): Promise<void>;\n\n  /**\n   * Get current process status (refreshed)\n   */\n  getStatus(): Promise<ProcessStatus>;\n\n  /**\n   * Get accumulated logs\n   */\n  getLogs(): Promise<{ stdout: string; stderr: string }>;\n}\n\n// Streaming Types\n\nexport interface ExecEvent {\n  type: 'start' | 'stdout' | 'stderr' | 'complete' | 'error';\n  timestamp: string;\n  data?: string;\n  command?: string;\n  exitCode?: number;\n  result?: ExecResult;\n  error?: string; // Changed to string for serialization\n  sessionId?: string;\n}\n\nexport interface LogEvent {\n  type: 'stdout' | 'stderr' | 'exit' | 'error';\n  timestamp: string;\n  data: string;\n  processId: string;\n  sessionId?: string;\n  exitCode?: number; // For 'exit' events\n}\n\nexport interface StreamOptions extends BaseExecOptions {\n  /**\n   * Buffer size for streaming output\n   */\n  bufferSize?: number;\n\n  /**\n   * AbortSignal for cancelling stream\n   */\n  signal?: AbortSignal;\n}\n\n// Error Types\n\nexport class SandboxError extends Error {\n  constructor(message: string, public code?: string) {\n    super(message);\n    this.name = 'SandboxError';\n  }\n}\n\nexport class ProcessNotFoundError extends SandboxError {\n  constructor(processId: string) {\n    super(`Process not found: ${processId}`, 'PROCESS_NOT_FOUND');\n    this.name = 'ProcessNotFoundError';\n  }\n}\n\nexport class ProcessAlreadyExistsError extends SandboxError {\n  constructor(processId: string) {\n    super(`Process already exists: ${processId}`, 'PROCESS_EXISTS');\n    this.name = 'ProcessAlreadyExistsError';\n  }\n}\n\nexport class ExecutionTimeoutError extends SandboxError {\n  constructor(timeout: number) {\n    super(`Execution timed out after ${timeout}ms`, 'EXECUTION_TIMEOUT');\n    this.name = 'ExecutionTimeoutError';\n  }\n}\n\n// Internal Container Types\n\nexport interface ProcessRecord {\n  id: string;\n  pid?: number;\n  command: string;\n  status: ProcessStatus;\n  startTime: Date;\n  endTime?: Date;\n  exitCode?: number;\n  sessionId?: string;\n\n  // Internal fields\n  childProcess?: any;  // Node.js ChildProcess\n  stdout: string;      // Accumulated output (ephemeral)\n  stderr: string;      // Accumulated output (ephemeral)\n\n  // Streaming\n  outputListeners: Set<(stream: 'stdout' | 'stderr', data: string) => void>;\n  statusListeners: Set<(status: ProcessStatus) => void>;\n}\n\n// Container Request/Response Types\n\nexport interface StartProcessRequest {\n  command: string;\n  options?: {\n    processId?: string;\n    sessionId?: string;\n    timeout?: number;\n    env?: Record<string, string>;\n    cwd?: string;\n    encoding?: string;\n    autoCleanup?: boolean;\n  };\n}\n\nexport interface StartProcessResponse {\n  process: {\n    id: string;\n    pid?: number;\n    command: string;\n      status: ProcessStatus;\n    startTime: string;\n    sessionId?: string;\n  };\n}\n\nexport interface ListProcessesResponse {\n  processes: Array<{\n    id: string;\n    pid?: number;\n    command: string;\n      status: ProcessStatus;\n    startTime: string;\n    endTime?: string;\n    exitCode?: number;\n    sessionId?: string;\n  }>;\n}\n\nexport interface GetProcessResponse {\n  process: {\n    id: string;\n    pid?: number;\n    command: string;\n      status: ProcessStatus;\n    startTime: string;\n    endTime?: string;\n    exitCode?: number;\n    sessionId?: string;\n  } | null;\n}\n\nexport interface GetProcessLogsResponse {\n  stdout: string;\n  stderr: string;\n  processId: string;\n}\n\n// Import code interpreter types\nimport type {\n  CodeContext,\n  CreateContextOptions,\n  ExecutionResult, \n  RunCodeOptions\n} from './interpreter-types';\n\n// Main Sandbox Interface\n\nexport interface ISandbox {\n  // Enhanced execution API\n  exec(command: string, options?: ExecOptions): Promise<ExecResult>;\n\n  // Background process management\n  startProcess(command: string, options?: ProcessOptions): Promise<Process>;\n  listProcesses(): Promise<Process[]>;\n  getProcess(id: string): Promise<Process | null>;\n  killProcess(id: string, signal?: string): Promise<void>;\n  killAllProcesses(): Promise<number>;\n\n  // Advanced streaming - returns ReadableStream that can be converted to AsyncIterable\n  execStream(command: string, options?: StreamOptions): Promise<ReadableStream<Uint8Array>>;\n  streamProcessLogs(processId: string, options?: { signal?: AbortSignal }): Promise<ReadableStream<Uint8Array>>;\n\n  // Utility methods\n  cleanupCompletedProcesses(): Promise<number>;\n  getProcessLogs(id: string): Promise<{ stdout: string; stderr: string }>;\n\n  // Code Interpreter API\n  createCodeContext(options?: CreateContextOptions): Promise<CodeContext>;\n  runCode(code: string, options?: RunCodeOptions): Promise<ExecutionResult>;\n  runCodeStream(code: string, options?: RunCodeOptions): Promise<ReadableStream>;\n  listCodeContexts(): Promise<CodeContext[]>;\n  deleteCodeContext(contextId: string): Promise<void>;\n}\n\n// Type Guards\n\nexport function isExecResult(value: any): value is ExecResult {\n  return value &&\n    typeof value.success === 'boolean' &&\n    typeof value.exitCode === 'number' &&\n    typeof value.stdout === 'string' &&\n    typeof value.stderr === 'string';\n}\n\nexport function isProcess(value: any): value is Process {\n  return value &&\n    typeof value.id === 'string' &&\n    typeof value.command === 'string' &&\n    typeof value.status === 'string';\n}\n\nexport function isProcessStatus(value: string): value is ProcessStatus {\n  return ['starting', 'running', 'completed', 'failed', 'killed', 'error'].includes(value);\n}"],"mappings":";AA4OO,IAAM,eAAN,cAA2B,MAAM;AAAA,EACtC,YAAY,SAAwB,MAAe;AACjD,UAAM,OAAO;AADqB;AAElC,SAAK,OAAO;AAAA,EACd;AACF;AAEO,IAAM,uBAAN,cAAmC,aAAa;AAAA,EACrD,YAAY,WAAmB;AAC7B,UAAM,sBAAsB,SAAS,IAAI,mBAAmB;AAC5D,SAAK,OAAO;AAAA,EACd;AACF;AAEO,IAAM,4BAAN,cAAwC,aAAa;AAAA,EAC1D,YAAY,WAAmB;AAC7B,UAAM,2BAA2B,SAAS,IAAI,gBAAgB;AAC9D,SAAK,OAAO;AAAA,EACd;AACF;AAEO,IAAM,wBAAN,cAAoC,aAAa;AAAA,EACtD,YAAY,SAAiB;AAC3B,UAAM,6BAA6B,OAAO,MAAM,mBAAmB;AACnE,SAAK,OAAO;AAAA,EACd;AACF;AAyHO,SAAS,aAAa,OAAiC;AAC5D,SAAO,SACL,OAAO,MAAM,YAAY,aACzB,OAAO,MAAM,aAAa,YAC1B,OAAO,MAAM,WAAW,YACxB,OAAO,MAAM,WAAW;AAC5B;AAEO,SAAS,UAAU,OAA8B;AACtD,SAAO,SACL,OAAO,MAAM,OAAO,YACpB,OAAO,MAAM,YAAY,YACzB,OAAO,MAAM,WAAW;AAC5B;AAEO,SAAS,gBAAgB,OAAuC;AACrE,SAAO,CAAC,YAAY,WAAW,aAAa,UAAU,UAAU,OAAO,EAAE,SAAS,KAAK;AACzF;","names":[]}

package/dist/chunk-VTKZL632.js

@@ -0,0 +1,237 @@
+import {
+  HttpClient
+} from "./chunk-CUHYLCMT.js";
+import {
+  isRetryableError,
+  parseErrorResponse
+} from "./chunk-LALY4SFU.js";
+
+// src/jupyter-client.ts
+var JupyterClient = class extends HttpClient {
+  maxRetries = 3;
+  retryDelayMs = 1e3;
+  async createCodeContext(options = {}) {
+    return this.executeWithRetry(async () => {
+      const response = await this.doFetch("/api/contexts", {
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify({
+          language: options.language || "python",
+          cwd: options.cwd || "/workspace",
+          env_vars: options.envVars
+        })
+      });
+      if (!response.ok) {
+        throw await parseErrorResponse(response);
+      }
+      const data = await response.json();
+      return {
+        id: data.id,
+        language: data.language,
+        cwd: data.cwd,
+        createdAt: new Date(data.createdAt),
+        lastUsed: new Date(data.lastUsed)
+      };
+    });
+  }
+  async runCodeStream(contextId, code, language, callbacks) {
+    return this.executeWithRetry(async () => {
+      const response = await this.doFetch("/api/execute/code", {
+        method: "POST",
+        headers: {
+          "Content-Type": "application/json",
+          Accept: "text/event-stream"
+        },
+        body: JSON.stringify({
+          context_id: contextId,
+          code,
+          language
+        })
+      });
+      if (!response.ok) {
+        throw await parseErrorResponse(response);
+      }
+      if (!response.body) {
+        throw new Error("No response body for streaming execution");
+      }
+      for await (const chunk of this.readLines(response.body)) {
+        await this.parseExecutionResult(chunk, callbacks);
+      }
+    });
+  }
+  async *readLines(stream) {
+    const reader = stream.getReader();
+    let buffer = "";
+    try {
+      while (true) {
+        const { done, value } = await reader.read();
+        if (value) {
+          buffer += new TextDecoder().decode(value);
+        }
+        if (done) break;
+        let newlineIdx = buffer.indexOf("\n");
+        while (newlineIdx !== -1) {
+          yield buffer.slice(0, newlineIdx);
+          buffer = buffer.slice(newlineIdx + 1);
+          newlineIdx = buffer.indexOf("\n");
+        }
+      }
+      if (buffer.length > 0) {
+        yield buffer;
+      }
+    } finally {
+      reader.releaseLock();
+    }
+  }
+  async parseExecutionResult(line, callbacks) {
+    if (!line.trim()) return;
+    try {
+      const data = JSON.parse(line);
+      switch (data.type) {
+        case "stdout":
+          if (callbacks.onStdout && data.text) {
+            await callbacks.onStdout({
+              text: data.text,
+              timestamp: data.timestamp || Date.now()
+            });
+          }
+          break;
+        case "stderr":
+          if (callbacks.onStderr && data.text) {
+            await callbacks.onStderr({
+              text: data.text,
+              timestamp: data.timestamp || Date.now()
+            });
+          }
+          break;
+        case "result":
+          if (callbacks.onResult) {
+            const result = {
+              text: data.text,
+              html: data.html,
+              png: data.png,
+              jpeg: data.jpeg,
+              svg: data.svg,
+              latex: data.latex,
+              markdown: data.markdown,
+              javascript: data.javascript,
+              json: data.json,
+              chart: data.chart,
+              data: data.data,
+              formats: () => {
+                const formats = [];
+                if (data.text) formats.push("text");
+                if (data.html) formats.push("html");
+                if (data.png) formats.push("png");
+                if (data.jpeg) formats.push("jpeg");
+                if (data.svg) formats.push("svg");
+                if (data.latex) formats.push("latex");
+                if (data.markdown) formats.push("markdown");
+                if (data.javascript) formats.push("javascript");
+                if (data.json) formats.push("json");
+                if (data.chart) formats.push("chart");
+                return formats;
+              }
+            };
+            await callbacks.onResult(result);
+          }
+          break;
+        case "error":
+          if (callbacks.onError) {
+            await callbacks.onError({
+              name: data.ename || "Error",
+              value: data.evalue || data.text || "Unknown error",
+              traceback: data.traceback || [],
+              lineNumber: data.lineNumber
+            });
+          }
+          break;
+        case "execution_complete":
+          break;
+      }
+    } catch (error) {
+      console.error("[JupyterClient] Error parsing execution result:", error);
+    }
+  }
+  async listCodeContexts() {
+    return this.executeWithRetry(async () => {
+      const response = await this.doFetch("/api/contexts", {
+        method: "GET",
+        headers: { "Content-Type": "application/json" }
+      });
+      if (!response.ok) {
+        throw await parseErrorResponse(response);
+      }
+      const data = await response.json();
+      return data.contexts.map((ctx) => ({
+        id: ctx.id,
+        language: ctx.language,
+        cwd: ctx.cwd,
+        createdAt: new Date(ctx.createdAt),
+        lastUsed: new Date(ctx.lastUsed)
+      }));
+    });
+  }
+  async deleteCodeContext(contextId) {
+    return this.executeWithRetry(async () => {
+      const response = await this.doFetch(`/api/contexts/${contextId}`, {
+        method: "DELETE",
+        headers: { "Content-Type": "application/json" }
+      });
+      if (!response.ok) {
+        throw await parseErrorResponse(response);
+      }
+    });
+  }
+  // Override parent doFetch to be public for this class
+  async doFetch(path, options) {
+    return super.doFetch(path, options);
+  }
+  /**
+   * Execute an operation with automatic retry for transient errors
+   */
+  async executeWithRetry(operation) {
+    let lastError;
+    for (let attempt = 0; attempt < this.maxRetries; attempt++) {
+      try {
+        return await operation();
+      } catch (error) {
+        lastError = error;
+        if (this.isRetryableError(error)) {
+          if (attempt < this.maxRetries - 1) {
+            const delay = this.retryDelayMs * 2 ** attempt + Math.random() * 1e3;
+            await new Promise((resolve) => setTimeout(resolve, delay));
+            continue;
+          }
+        }
+        throw error;
+      }
+    }
+    if (lastError?.message.includes("Code execution")) {
+      throw lastError;
+    }
+    throw new Error("Unable to execute code at this time");
+  }
+  /**
+   * Check if an error is retryable
+   */
+  isRetryableError(error) {
+    if (isRetryableError(error)) {
+      return true;
+    }
+    if (error instanceof Error) {
+      if (error.message.includes("Circuit breaker is open")) {
+        return true;
+      }
+      if ("status" in error && error.status === "circuit_open") {
+        return true;
+      }
+    }
+    return false;
+  }
+};
+
+export {
+  JupyterClient
+};
+//# sourceMappingURL=chunk-VTKZL632.js.map

package/dist/chunk-VTKZL632.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/jupyter-client.ts"],"sourcesContent":["import { HttpClient } from \"./client.js\";\nimport { isRetryableError, parseErrorResponse } from \"./errors.js\";\nimport type {\n  CodeContext,\n  CreateContextOptions,\n  ExecutionError,\n  OutputMessage,\n  Result,\n} from \"./interpreter-types.js\";\n\n// API Response types\ninterface ContextResponse {\n  id: string;\n  language: string;\n  cwd: string;\n  createdAt: string; // ISO date string from JSON\n  lastUsed: string; // ISO date string from JSON\n}\n\ninterface ContextListResponse {\n  contexts: ContextResponse[];\n}\n\n// Streaming execution data from the server\ninterface StreamingExecutionData {\n  type: \"result\" | \"stdout\" | \"stderr\" | \"error\" | \"execution_complete\";\n  text?: string;\n  html?: string;\n  png?: string; // base64\n  jpeg?: string; // base64\n  svg?: string;\n  latex?: string;\n  markdown?: string;\n  javascript?: string;\n  json?: unknown;\n  chart?: {\n    type:\n      | \"line\"\n      | \"bar\"\n      | \"scatter\"\n      | \"pie\"\n      | \"histogram\"\n      | \"heatmap\"\n      | \"unknown\";\n    data: unknown;\n    options?: unknown;\n  };\n  data?: unknown;\n  metadata?: Record<string, unknown>;\n  execution_count?: number;\n  ename?: string;\n  evalue?: string;\n  traceback?: string[];\n  lineNumber?: number;\n  timestamp?: number;\n}\n\nexport interface ExecutionCallbacks {\n  onStdout?: (output: OutputMessage) => void | Promise<void>;\n  onStderr?: (output: OutputMessage) => void | Promise<void>;\n  onResult?: (result: Result) => void | Promise<void>;\n  onError?: (error: ExecutionError) => void | Promise<void>;\n}\n\nexport class JupyterClient extends HttpClient {\n  private readonly maxRetries = 3;\n  private readonly retryDelayMs = 1000;\n\n  async createCodeContext(\n    options: CreateContextOptions = {}\n  ): Promise<CodeContext> {\n    return this.executeWithRetry(async () => {\n      const response = await this.doFetch(\"/api/contexts\", {\n        method: \"POST\",\n        headers: { \"Content-Type\": \"application/json\" },\n        body: JSON.stringify({\n          language: options.language || \"python\",\n          cwd: options.cwd || \"/workspace\",\n          env_vars: options.envVars,\n        }),\n      });\n\n      if (!response.ok) {\n        throw await parseErrorResponse(response);\n      }\n\n      const data = (await response.json()) as ContextResponse;\n      return {\n        id: data.id,\n        language: data.language,\n        cwd: data.cwd,\n        createdAt: new Date(data.createdAt),\n        lastUsed: new Date(data.lastUsed),\n      };\n    });\n  }\n\n  async runCodeStream(\n    contextId: string | undefined,\n    code: string,\n    language: string | undefined,\n    callbacks: ExecutionCallbacks\n  ): Promise<void> {\n    return this.executeWithRetry(async () => {\n      const response = await this.doFetch(\"/api/execute/code\", {\n        method: \"POST\",\n        headers: {\n          \"Content-Type\": \"application/json\",\n          Accept: \"text/event-stream\",\n        },\n        body: JSON.stringify({\n          context_id: contextId,\n          code,\n          language,\n        }),\n      });\n\n      if (!response.ok) {\n        throw await parseErrorResponse(response);\n      }\n\n      if (!response.body) {\n        throw new Error(\"No response body for streaming execution\");\n      }\n\n      // Process streaming response\n      for await (const chunk of this.readLines(response.body)) {\n        await this.parseExecutionResult(chunk, callbacks);\n      }\n    });\n  }\n\n  private async *readLines(\n    stream: ReadableStream<Uint8Array>\n  ): AsyncGenerator<string> {\n    const reader = stream.getReader();\n    let buffer = \"\";\n\n    try {\n      while (true) {\n        const { done, value } = await reader.read();\n        if (value) {\n          buffer += new TextDecoder().decode(value);\n        }\n        if (done) break;\n\n        let newlineIdx = buffer.indexOf(\"\\n\");\n        while (newlineIdx !== -1) {\n          yield buffer.slice(0, newlineIdx);\n          buffer = buffer.slice(newlineIdx + 1);\n          newlineIdx = buffer.indexOf(\"\\n\");\n        }\n      }\n\n      // Yield any remaining data\n      if (buffer.length > 0) {\n        yield buffer;\n      }\n    } finally {\n      reader.releaseLock();\n    }\n  }\n\n  private async parseExecutionResult(\n    line: string,\n    callbacks: ExecutionCallbacks\n  ) {\n    if (!line.trim()) return;\n\n    try {\n      const data = JSON.parse(line) as StreamingExecutionData;\n\n      switch (data.type) {\n        case \"stdout\":\n          if (callbacks.onStdout && data.text) {\n            await callbacks.onStdout({\n              text: data.text,\n              timestamp: data.timestamp || Date.now(),\n            });\n          }\n          break;\n\n        case \"stderr\":\n          if (callbacks.onStderr && data.text) {\n            await callbacks.onStderr({\n              text: data.text,\n              timestamp: data.timestamp || Date.now(),\n            });\n          }\n          break;\n\n        case \"result\":\n          if (callbacks.onResult) {\n            // Convert raw result to Result interface\n            const result: Result = {\n              text: data.text,\n              html: data.html,\n              png: data.png,\n              jpeg: data.jpeg,\n              svg: data.svg,\n              latex: data.latex,\n              markdown: data.markdown,\n              javascript: data.javascript,\n              json: data.json,\n              chart: data.chart,\n              data: data.data,\n              formats: () => {\n                const formats: string[] = [];\n                if (data.text) formats.push(\"text\");\n                if (data.html) formats.push(\"html\");\n                if (data.png) formats.push(\"png\");\n                if (data.jpeg) formats.push(\"jpeg\");\n                if (data.svg) formats.push(\"svg\");\n                if (data.latex) formats.push(\"latex\");\n                if (data.markdown) formats.push(\"markdown\");\n                if (data.javascript) formats.push(\"javascript\");\n                if (data.json) formats.push(\"json\");\n                if (data.chart) formats.push(\"chart\");\n                return formats;\n              },\n            };\n            await callbacks.onResult(result);\n          }\n          break;\n\n        case \"error\":\n          if (callbacks.onError) {\n            await callbacks.onError({\n              name: data.ename || \"Error\",\n              value: data.evalue || data.text || \"Unknown error\",\n              traceback: data.traceback || [],\n              lineNumber: data.lineNumber,\n            });\n          }\n          break;\n\n        case \"execution_complete\":\n          // Execution completed successfully\n          break;\n      }\n    } catch (error) {\n      console.error(\"[JupyterClient] Error parsing execution result:\", error);\n    }\n  }\n\n  async listCodeContexts(): Promise<CodeContext[]> {\n    return this.executeWithRetry(async () => {\n      const response = await this.doFetch(\"/api/contexts\", {\n        method: \"GET\",\n        headers: { \"Content-Type\": \"application/json\" },\n      });\n\n      if (!response.ok) {\n        throw await parseErrorResponse(response);\n      }\n\n      const data = (await response.json()) as ContextListResponse;\n      return data.contexts.map((ctx) => ({\n        id: ctx.id,\n        language: ctx.language,\n        cwd: ctx.cwd,\n        createdAt: new Date(ctx.createdAt),\n        lastUsed: new Date(ctx.lastUsed),\n      }));\n    });\n  }\n\n  async deleteCodeContext(contextId: string): Promise<void> {\n    return this.executeWithRetry(async () => {\n      const response = await this.doFetch(`/api/contexts/${contextId}`, {\n        method: \"DELETE\",\n        headers: { \"Content-Type\": \"application/json\" },\n      });\n\n      if (!response.ok) {\n        throw await parseErrorResponse(response);\n      }\n    });\n  }\n\n  // Override parent doFetch to be public for this class\n  public async doFetch(path: string, options?: RequestInit): Promise<Response> {\n    return super.doFetch(path, options);\n  }\n\n  /**\n   * Execute an operation with automatic retry for transient errors\n   */\n  private async executeWithRetry<T>(operation: () => Promise<T>): Promise<T> {\n    let lastError: Error | undefined;\n\n    for (let attempt = 0; attempt < this.maxRetries; attempt++) {\n      try {\n        return await operation();\n      } catch (error) {\n        lastError = error as Error;\n\n        // Check if it's a retryable error (circuit breaker or Jupyter not ready)\n        if (this.isRetryableError(error)) {\n          // Don't retry on the last attempt\n          if (attempt < this.maxRetries - 1) {\n            // Exponential backoff with jitter\n            const delay =\n              this.retryDelayMs * 2 ** attempt + Math.random() * 1000;\n            await new Promise((resolve) => setTimeout(resolve, delay));\n            continue;\n          }\n        }\n\n        // Non-retryable error or last attempt - throw immediately\n        throw error;\n      }\n    }\n\n    // All retries exhausted - throw a clean error without implementation details\n    if (lastError?.message.includes(\"Code execution\")) {\n      // If the error already has a clean message about code execution, use it\n      throw lastError;\n    }\n\n    // Otherwise, throw a generic but user-friendly error\n    throw new Error(\"Unable to execute code at this time\");\n  }\n\n  /**\n   * Check if an error is retryable\n   */\n  private isRetryableError(error: unknown): boolean {\n    // Use the SDK's built-in retryable check\n    if (isRetryableError(error)) {\n      return true;\n    }\n\n    // Also check for circuit breaker specific errors\n    if (error instanceof Error) {\n      // Circuit breaker errors (from the container's response)\n      if (error.message.includes(\"Circuit breaker is open\")) {\n        return true;\n      }\n\n      // Check if error has a status property\n      if (\"status\" in error && error.status === \"circuit_open\") {\n        return true;\n      }\n    }\n\n    return false;\n  }\n}\n"],"mappings":"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","names":[]}