@cloudflare/sandbox 0.2.3 → 0.3.0

package/dist/{client-bzEV222a.d.ts → client-Dny_ro_v.d.ts}

@@ -1,6 +1,6 @@
+import { ISandbox, ExecOptions, ExecResult, ProcessOptions, Process, StreamOptions, GitCheckoutResponse, MkdirResponse, WriteFileResponse, DeleteFileResponse, RenameFileResponse, MoveFileResponse, ReadFileResponse, ListFilesResponse, ExecutionSession, BaseExecOptions, ExecuteResponse, StartProcessResponse, ListProcessesResponse, GetProcessResponse, GetProcessLogsResponse } from './types.js';
 import { Container } from '@cloudflare/containers';
 import { CreateContextOptions, CodeContext, OutputMessage, Result, ExecutionError, RunCodeOptions, ExecutionResult } from './interpreter-types.js';
-import { ISandbox, ExecOptions, ExecResult, ProcessOptions, Process, StreamOptions, BaseExecOptions, StartProcessResponse, ListProcessesResponse, GetProcessResponse, GetProcessLogsResponse } from './types.js';
 
 interface ExecutionCallbacks {
     onStdout?: (output: OutputMessage) => void | Promise<void>;
@@ -35,6 +35,7 @@ declare class Sandbox<Env = unknown> extends Container<Env> implements ISandbox
     client: JupyterClient;
     private sandboxName;
     private codeInterpreter;
+    private defaultSession;
     constructor(ctx: DurableObjectState, env: Env);
     setSandboxName(name: string): Promise<void>;
     setEnvVars(envVars: Record<string, string>): Promise<void>;
@@ -43,13 +44,12 @@ declare class Sandbox<Env = unknown> extends Container<Env> implements ISandbox
     onError(error: unknown): void;
     fetch(request: Request): Promise<Response>;
     private determinePort;
+    private ensureDefaultSession;
     exec(command: string, options?: ExecOptions): Promise<ExecResult>;
-    private executeWithStreaming;
-    private mapExecuteResponseToExecResult;
     startProcess(command: string, options?: ProcessOptions): Promise<Process>;
     listProcesses(): Promise<Process[]>;
     getProcess(id: string): Promise<Process | null>;
-    killProcess(id: string, _signal?: string): Promise<void>;
+    killProcess(id: string, signal?: string): Promise<void>;
     killAllProcesses(): Promise<number>;
     cleanupCompletedProcesses(): Promise<number>;
     getProcessLogs(id: string): Promise<{
@@ -76,6 +76,10 @@ declare class Sandbox<Env = unknown> extends Container<Env> implements ISandbox
     readFile(path: string, options?: {
         encoding?: string;
     }): Promise<ReadFileResponse>;
+    listFiles(path: string, options?: {
+        recursive?: boolean;
+        includeHidden?: boolean;
+    }): Promise<ListFilesResponse>;
     exposePort(port: number, options: {
         name?: string;
         hostname: string;
@@ -112,68 +116,18 @@ declare class Sandbox<Env = unknown> extends Container<Env> implements ISandbox
      * Delete a code context
      */
     deleteCodeContext(contextId: string): Promise<void>;
+    /**
+     * Create a new execution session with isolation
+     * Returns a session object with exec() method
+     */
+    createSession(options: {
+        id?: string;
+        env?: Record<string, string>;
+        cwd?: string;
+        isolation?: boolean;
+    }): Promise<ExecutionSession>;
 }
 
-interface ExecuteResponse {
-    success: boolean;
-    stdout: string;
-    stderr: string;
-    exitCode: number;
-    command: string;
-    timestamp: string;
-}
-interface GitCheckoutResponse {
-    success: boolean;
-    stdout: string;
-    stderr: string;
-    exitCode: number;
-    repoUrl: string;
-    branch: string;
-    targetDir: string;
-    timestamp: string;
-}
-interface MkdirResponse {
-    success: boolean;
-    stdout: string;
-    stderr: string;
-    exitCode: number;
-    path: string;
-    recursive: boolean;
-    timestamp: string;
-}
-interface WriteFileResponse {
-    success: boolean;
-    exitCode: number;
-    path: string;
-    timestamp: string;
-}
-interface ReadFileResponse {
-    success: boolean;
-    exitCode: number;
-    path: string;
-    content: string;
-    timestamp: string;
-}
-interface DeleteFileResponse {
-    success: boolean;
-    exitCode: number;
-    path: string;
-    timestamp: string;
-}
-interface RenameFileResponse {
-    success: boolean;
-    exitCode: number;
-    oldPath: string;
-    newPath: string;
-    timestamp: string;
-}
-interface MoveFileResponse {
-    success: boolean;
-    exitCode: number;
-    sourcePath: string;
-    destinationPath: string;
-    timestamp: string;
-}
 interface PreviewInfo {
     url: string;
     port: number;
@@ -212,48 +166,58 @@ interface HttpClientOptions {
 declare class HttpClient {
     private baseUrl;
     private options;
-    private sessionId;
     constructor(options?: HttpClientOptions);
     protected doFetch(path: string, options?: RequestInit): Promise<Response>;
-    execute(command: string, options: Pick<BaseExecOptions, "sessionId" | "cwd" | "env">): Promise<ExecuteResponse>;
-    executeCommandStream(command: string, sessionId?: string): Promise<ReadableStream<Uint8Array>>;
-    gitCheckout(repoUrl: string, branch?: string, targetDir?: string, sessionId?: string): Promise<GitCheckoutResponse>;
-    mkdir(path: string, recursive?: boolean, sessionId?: string): Promise<MkdirResponse>;
-    writeFile(path: string, content: string, encoding?: string, sessionId?: string): Promise<WriteFileResponse>;
-    readFile(path: string, encoding?: string, sessionId?: string): Promise<ReadFileResponse>;
-    deleteFile(path: string, sessionId?: string): Promise<DeleteFileResponse>;
-    renameFile(oldPath: string, newPath: string, sessionId?: string): Promise<RenameFileResponse>;
-    moveFile(sourcePath: string, destinationPath: string, sessionId?: string): Promise<MoveFileResponse>;
+    createSession(options: {
+        id: string;
+        env?: Record<string, string>;
+        cwd?: string;
+        isolation?: boolean;
+    }): Promise<{
+        success: boolean;
+        id: string;
+        message: string;
+    }>;
+    exec(sessionId: string, command: string, options?: Pick<BaseExecOptions, "cwd" | "env">): Promise<ExecuteResponse>;
+    execStream(sessionId: string, command: string): Promise<ReadableStream<Uint8Array>>;
+    gitCheckout(repoUrl: string, sessionId: string, branch?: string, targetDir?: string): Promise<GitCheckoutResponse>;
+    mkdir(path: string, recursive: boolean | undefined, sessionId: string): Promise<MkdirResponse>;
+    writeFile(path: string, content: string, encoding: string | undefined, sessionId: string): Promise<WriteFileResponse>;
+    readFile(path: string, encoding: string | undefined, sessionId: string): Promise<ReadFileResponse>;
+    deleteFile(path: string, sessionId: string): Promise<DeleteFileResponse>;
+    renameFile(oldPath: string, newPath: string, sessionId: string): Promise<RenameFileResponse>;
+    moveFile(sourcePath: string, destinationPath: string, sessionId: string): Promise<MoveFileResponse>;
+    listFiles(path: string, sessionId: string, options?: {
+        recursive?: boolean;
+        includeHidden?: boolean;
+    }): Promise<ListFilesResponse>;
     exposePort(port: number, name?: string): Promise<ExposePortResponse>;
     unexposePort(port: number): Promise<UnexposePortResponse>;
     getExposedPorts(): Promise<GetExposedPortsResponse>;
     ping(): Promise<string>;
-    getCommands(): Promise<string[]>;
-    getSessionId(): string | null;
-    setSessionId(sessionId: string): void;
-    clearSession(): void;
-    startProcess(command: string, options?: {
+    startProcess(command: string, sessionId: string, options?: {
         processId?: string;
-        sessionId?: string;
         timeout?: number;
         env?: Record<string, string>;
         cwd?: string;
         encoding?: string;
         autoCleanup?: boolean;
     }): Promise<StartProcessResponse>;
-    listProcesses(): Promise<ListProcessesResponse>;
+    listProcesses(sessionId?: string): Promise<ListProcessesResponse>;
     getProcess(processId: string): Promise<GetProcessResponse>;
     killProcess(processId: string): Promise<{
         success: boolean;
         message: string;
     }>;
-    killAllProcesses(): Promise<{
+    killAllProcesses(sessionId?: string): Promise<{
         success: boolean;
         killedCount: number;
         message: string;
     }>;
     getProcessLogs(processId: string): Promise<GetProcessLogsResponse>;
-    streamProcessLogs(processId: string): Promise<ReadableStream<Uint8Array>>;
+    streamProcessLogs(processId: string, options?: {
+        signal?: AbortSignal;
+    }): Promise<ReadableStream<Uint8Array>>;
 }
 
-export { type DeleteFileResponse as D, type ExecuteResponse as E, type GitCheckoutResponse as G, HttpClient as H, JupyterClient as J, type MkdirResponse as M, type ReadFileResponse as R, Sandbox as S, type WriteFileResponse as W, type MoveFileResponse as a, type RenameFileResponse as b, type ExecutionCallbacks as c, getSandbox as g };
+export { type ExecutionCallbacks as E, HttpClient as H, JupyterClient as J, Sandbox as S, getSandbox as g };

package/dist/client.d.ts

@@ -1,4 +1,4 @@
-export { D as DeleteFileResponse, E as ExecuteResponse, G as GitCheckoutResponse, H as HttpClient, M as MkdirResponse, a as MoveFileResponse, R as ReadFileResponse, b as RenameFileResponse, W as WriteFileResponse } from './client-bzEV222a.js';
+export { H as HttpClient } from './client-Dny_ro_v.js';
 import './types.js';
 import '@cloudflare/containers';
 import './interpreter-types.js';

package/dist/client.js

@@ -1,6 +1,6 @@
 import {
   HttpClient
-} from "./chunk-CUHYLCMT.js";
+} from "./chunk-SMUEY5JR.js";
 export {
   HttpClient
 };

package/dist/index.d.ts

@@ -1,7 +1,7 @@
-export { D as DeleteFileResponse, E as ExecuteResponse, G as GitCheckoutResponse, M as MkdirResponse, a as MoveFileResponse, R as ReadFileResponse, b as RenameFileResponse, S as Sandbox, W as WriteFileResponse, g as getSandbox } from './client-bzEV222a.js';
 export { CodeExecutionError, ContainerNotReadyError, ContextNotFoundError, JupyterNotReadyError, SandboxError, SandboxErrorResponse, SandboxNetworkError, ServiceUnavailableError, isJupyterNotReadyError, isRetryableError, isSandboxError, parseErrorResponse } from './errors.js';
 export { ChartData, CodeContext, CreateContextOptions, Execution, ExecutionError, OutputMessage, Result, ResultImpl, RunCodeOptions } from './interpreter-types.js';
 export { RouteInfo, SandboxEnv, proxyToSandbox } from './request-handler.js';
+export { S as Sandbox, g as getSandbox } from './client-Dny_ro_v.js';
 export { asyncIterableToSSEStream, parseSSEStream, responseToAsyncIterable } from './sse-parser.js';
-export { ExecEvent, LogEvent } from './types.js';
+export { DeleteFileResponse, ExecEvent, ExecOptions, ExecResult, ExecuteResponse, ExecutionSession, GitCheckoutResponse, ISandbox, ListFilesResponse, LogEvent, MkdirResponse, MoveFileResponse, Process, ProcessOptions, ProcessStatus, ReadFileResponse, RenameFileResponse, StreamOptions, WriteFileResponse } from './types.js';
 import '@cloudflare/containers';

package/dist/index.js

@@ -1,21 +1,20 @@
-import {
-  Sandbox,
-  getSandbox,
-  proxyToSandbox
-} from "./chunk-4KELYYKS.js";
-import "./chunk-6UAWTJ5S.js";
 import {
   asyncIterableToSSEStream,
   parseSSEStream,
   responseToAsyncIterable
 } from "./chunk-NNGBXDMY.js";
-import "./chunk-S5FFBU4Y.js";
+import {
+  Sandbox,
+  getSandbox,
+  proxyToSandbox
+} from "./chunk-GTGWAEED.js";
+import "./chunk-6UAWTJ5S.js";
 import "./chunk-FKBV7CZS.js";
 import {
   ResultImpl
 } from "./chunk-EGC5IYXA.js";
-import "./chunk-VTKZL632.js";
-import "./chunk-CUHYLCMT.js";
+import "./chunk-BEQUGUY4.js";
+import "./chunk-SMUEY5JR.js";
 import {
   CodeExecutionError,
   ContainerNotReadyError,

package/dist/interpreter.d.ts

@@ -1,7 +1,7 @@
 import { CreateContextOptions, CodeContext, RunCodeOptions, Execution } from './interpreter-types.js';
-import { S as Sandbox } from './client-bzEV222a.js';
-import '@cloudflare/containers';
+import { S as Sandbox } from './client-Dny_ro_v.js';
 import './types.js';
+import '@cloudflare/containers';
 
 declare class CodeInterpreter {
     private jupyterClient;

package/dist/jupyter-client.d.ts

@@ -1,4 +1,4 @@
-export { c as ExecutionCallbacks, J as JupyterClient } from './client-bzEV222a.js';
+export { E as ExecutionCallbacks, J as JupyterClient } from './client-Dny_ro_v.js';
 import './interpreter-types.js';
-import '@cloudflare/containers';
 import './types.js';
+import '@cloudflare/containers';

package/dist/jupyter-client.js

@@ -1,7 +1,7 @@
 import {
   JupyterClient
-} from "./chunk-VTKZL632.js";
-import "./chunk-CUHYLCMT.js";
+} from "./chunk-BEQUGUY4.js";
+import "./chunk-SMUEY5JR.js";
 import "./chunk-LALY4SFU.js";
 export {
   JupyterClient

package/dist/request-handler.d.ts

@@ -1,7 +1,7 @@
-import { S as Sandbox } from './client-bzEV222a.js';
-import '@cloudflare/containers';
-import './interpreter-types.js';
+import { S as Sandbox } from './client-Dny_ro_v.js';
 import './types.js';
+import './interpreter-types.js';
+import '@cloudflare/containers';
 
 interface SandboxEnv {
     Sandbox: DurableObjectNamespace<Sandbox>;

package/dist/request-handler.js

@@ -1,14 +1,12 @@
 import {
   isLocalhostPattern,
   proxyToSandbox
-} from "./chunk-4KELYYKS.js";
+} from "./chunk-GTGWAEED.js";
 import "./chunk-6UAWTJ5S.js";
-import "./chunk-NNGBXDMY.js";
-import "./chunk-S5FFBU4Y.js";
 import "./chunk-FKBV7CZS.js";
 import "./chunk-EGC5IYXA.js";
-import "./chunk-VTKZL632.js";
-import "./chunk-CUHYLCMT.js";
+import "./chunk-BEQUGUY4.js";
+import "./chunk-SMUEY5JR.js";
 import "./chunk-LALY4SFU.js";
 export {
   isLocalhostPattern,

package/dist/sandbox.d.ts

@@ -1,4 +1,4 @@
-export { S as Sandbox, g as getSandbox } from './client-bzEV222a.js';
+import './types.js';
 import '@cloudflare/containers';
 import './interpreter-types.js';
-import './types.js';
+export { S as Sandbox, g as getSandbox } from './client-Dny_ro_v.js';

package/dist/sandbox.js

@@ -1,14 +1,12 @@
 import {
   Sandbox,
   getSandbox
-} from "./chunk-4KELYYKS.js";
+} from "./chunk-GTGWAEED.js";
 import "./chunk-6UAWTJ5S.js";
-import "./chunk-NNGBXDMY.js";
-import "./chunk-S5FFBU4Y.js";
 import "./chunk-FKBV7CZS.js";
 import "./chunk-EGC5IYXA.js";
-import "./chunk-VTKZL632.js";
-import "./chunk-CUHYLCMT.js";
+import "./chunk-BEQUGUY4.js";
+import "./chunk-SMUEY5JR.js";
 import "./chunk-LALY4SFU.js";
 export {
   Sandbox,

package/dist/types.d.ts

@@ -1,10 +1,6 @@
 import { CreateContextOptions, CodeContext, RunCodeOptions, ExecutionResult } from './interpreter-types.js';
 
 interface BaseExecOptions {
-    /**
-     * Session ID for grouping related commands
-     */
-    sessionId?: string;
     /**
      * Maximum execution time in milliseconds
      */
@@ -73,10 +69,6 @@ interface ExecResult {
      * ISO timestamp when command started
      */
     timestamp: string;
-    /**
-     * Session ID if provided
-     */
-    sessionId?: string;
 }
 interface ProcessOptions extends BaseExecOptions {
     /**
@@ -135,10 +127,6 @@ interface Process {
      * Process exit code (if completed)
      */
     readonly exitCode?: number;
-    /**
-     * Session ID if provided
-     */
-    readonly sessionId?: string;
     /**
      * Kill the process
      */
@@ -163,14 +151,12 @@ interface ExecEvent {
     exitCode?: number;
     result?: ExecResult;
     error?: string;
-    sessionId?: string;
 }
 interface LogEvent {
     type: 'stdout' | 'stderr' | 'exit' | 'error';
     timestamp: string;
     data: string;
     processId: string;
-    sessionId?: string;
     exitCode?: number;
 }
 interface StreamOptions extends BaseExecOptions {
@@ -204,8 +190,6 @@ interface ProcessRecord {
     startTime: Date;
     endTime?: Date;
     exitCode?: number;
-    sessionId?: string;
-    childProcess?: any;
     stdout: string;
     stderr: string;
     outputListeners: Set<(stream: 'stdout' | 'stderr', data: string) => void>;
@@ -215,7 +199,6 @@ interface StartProcessRequest {
     command: string;
     options?: {
         processId?: string;
-        sessionId?: string;
         timeout?: number;
         env?: Record<string, string>;
         cwd?: string;
@@ -230,7 +213,9 @@ interface StartProcessResponse {
         command: string;
         status: ProcessStatus;
         startTime: string;
-        sessionId?: string;
+        endTime?: string | null;
+        exitCode?: number | null;
+        sessionId: string;
     };
 }
 interface ListProcessesResponse {
@@ -242,7 +227,6 @@ interface ListProcessesResponse {
         startTime: string;
         endTime?: string;
         exitCode?: number;
-        sessionId?: string;
     }>;
 }
 interface GetProcessResponse {
@@ -254,7 +238,6 @@ interface GetProcessResponse {
         startTime: string;
         endTime?: string;
         exitCode?: number;
-        sessionId?: string;
     } | null;
 }
 interface GetProcessLogsResponse {
@@ -279,14 +262,137 @@ interface ISandbox {
         stdout: string;
         stderr: string;
     }>;
+    gitCheckout(repoUrl: string, options: {
+        branch?: string;
+        targetDir?: string;
+    }): Promise<GitCheckoutResponse>;
+    mkdir(path: string, options?: {
+        recursive?: boolean;
+    }): Promise<MkdirResponse>;
+    writeFile(path: string, content: string, options?: {
+        encoding?: string;
+    }): Promise<WriteFileResponse>;
+    deleteFile(path: string): Promise<DeleteFileResponse>;
+    renameFile(oldPath: string, newPath: string): Promise<RenameFileResponse>;
+    moveFile(sourcePath: string, destinationPath: string): Promise<MoveFileResponse>;
+    readFile(path: string, options?: {
+        encoding?: string;
+    }): Promise<ReadFileResponse>;
+    listFiles(path: string, options?: {
+        recursive?: boolean;
+        includeHidden?: boolean;
+    }): Promise<ListFilesResponse>;
+    exposePort(port: number, options: {
+        name?: string;
+        hostname: string;
+    }): Promise<{
+        url: string;
+        port: number;
+        name?: string;
+    }>;
+    unexposePort(port: number): Promise<void>;
+    getExposedPorts(hostname: string): Promise<Array<{
+        url: string;
+        port: number;
+        name?: string;
+        exposedAt: string;
+    }>>;
+    setEnvVars(envVars: Record<string, string>): Promise<void>;
+    setSandboxName(name: string): Promise<void>;
     createCodeContext(options?: CreateContextOptions): Promise<CodeContext>;
     runCode(code: string, options?: RunCodeOptions): Promise<ExecutionResult>;
     runCodeStream(code: string, options?: RunCodeOptions): Promise<ReadableStream>;
     listCodeContexts(): Promise<CodeContext[]>;
     deleteCodeContext(contextId: string): Promise<void>;
 }
+interface ExecutionSession extends Omit<ISandbox, 'createSession' | 'setSandboxName'> {
+    /**
+     * Session ID
+     */
+    id: string;
+}
+interface ExecuteResponse {
+    success: boolean;
+    stdout: string;
+    stderr: string;
+    exitCode: number;
+    command: string;
+    timestamp: string;
+}
+interface GitCheckoutResponse {
+    success: boolean;
+    stdout: string;
+    stderr: string;
+    exitCode: number;
+    repoUrl: string;
+    branch: string;
+    targetDir: string;
+    timestamp: string;
+}
+interface MkdirResponse {
+    success: boolean;
+    stdout: string;
+    stderr: string;
+    exitCode: number;
+    path: string;
+    recursive: boolean;
+    timestamp: string;
+}
+interface WriteFileResponse {
+    success: boolean;
+    exitCode: number;
+    path: string;
+    timestamp: string;
+}
+interface ReadFileResponse {
+    success: boolean;
+    exitCode: number;
+    path: string;
+    content: string;
+    timestamp: string;
+}
+interface DeleteFileResponse {
+    success: boolean;
+    exitCode: number;
+    path: string;
+    timestamp: string;
+}
+interface RenameFileResponse {
+    success: boolean;
+    exitCode: number;
+    oldPath: string;
+    newPath: string;
+    timestamp: string;
+}
+interface MoveFileResponse {
+    success: boolean;
+    exitCode: number;
+    sourcePath: string;
+    destinationPath: string;
+    timestamp: string;
+}
+interface ListFilesResponse {
+    success: boolean;
+    exitCode: number;
+    path: string;
+    files: Array<{
+        name: string;
+        absolutePath: string;
+        relativePath: string;
+        type: 'file' | 'directory' | 'symlink' | 'other';
+        size: number;
+        modifiedAt: string;
+        mode: string;
+        permissions: {
+            readable: boolean;
+            writable: boolean;
+            executable: boolean;
+        };
+    }>;
+    timestamp: string;
+}
 declare function isExecResult(value: any): value is ExecResult;
 declare function isProcess(value: any): value is Process;
 declare function isProcessStatus(value: string): value is ProcessStatus;
 
-export { type BaseExecOptions, type ExecEvent, type ExecOptions, type ExecResult, ExecutionTimeoutError, type GetProcessLogsResponse, type GetProcessResponse, type ISandbox, type ListProcessesResponse, type LogEvent, type Process, ProcessAlreadyExistsError, ProcessNotFoundError, type ProcessOptions, type ProcessRecord, type ProcessStatus, SandboxError, type StartProcessRequest, type StartProcessResponse, type StreamOptions, isExecResult, isProcess, isProcessStatus };
+export { type BaseExecOptions, type DeleteFileResponse, type ExecEvent, type ExecOptions, type ExecResult, type ExecuteResponse, type ExecutionSession, ExecutionTimeoutError, type GetProcessLogsResponse, type GetProcessResponse, type GitCheckoutResponse, type ISandbox, type ListFilesResponse, type ListProcessesResponse, type LogEvent, type MkdirResponse, type MoveFileResponse, type Process, ProcessAlreadyExistsError, ProcessNotFoundError, type ProcessOptions, type ProcessRecord, type ProcessStatus, type ReadFileResponse, type RenameFileResponse, SandboxError, type StartProcessRequest, type StartProcessResponse, type StreamOptions, type WriteFileResponse, isExecResult, isProcess, isProcessStatus };

package/dist/types.js

@@ -1,12 +1,38 @@
-import {
-  ExecutionTimeoutError,
-  ProcessAlreadyExistsError,
-  ProcessNotFoundError,
-  SandboxError,
-  isExecResult,
-  isProcess,
-  isProcessStatus
-} from "./chunk-S5FFBU4Y.js";
+// src/types.ts
+var SandboxError = class extends Error {
+  constructor(message, code) {
+    super(message);
+    this.code = code;
+    this.name = "SandboxError";
+  }
+};
+var ProcessNotFoundError = class extends SandboxError {
+  constructor(processId) {
+    super(`Process not found: ${processId}`, "PROCESS_NOT_FOUND");
+    this.name = "ProcessNotFoundError";
+  }
+};
+var ProcessAlreadyExistsError = class extends SandboxError {
+  constructor(processId) {
+    super(`Process already exists: ${processId}`, "PROCESS_EXISTS");
+    this.name = "ProcessAlreadyExistsError";
+  }
+};
+var ExecutionTimeoutError = class extends SandboxError {
+  constructor(timeout) {
+    super(`Execution timed out after ${timeout}ms`, "EXECUTION_TIMEOUT");
+    this.name = "ExecutionTimeoutError";
+  }
+};
+function isExecResult(value) {
+  return value && typeof value.success === "boolean" && typeof value.exitCode === "number" && typeof value.stdout === "string" && typeof value.stderr === "string";
+}
+function isProcess(value) {
+  return value && typeof value.id === "string" && typeof value.command === "string" && typeof value.status === "string";
+}
+function isProcessStatus(value) {
+  return ["starting", "running", "completed", "failed", "killed", "error"].includes(value);
+}
 export {
   ExecutionTimeoutError,
   ProcessAlreadyExistsError,

package/dist/types.js.map

@@ -1 +1 @@
-{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}
+{"version":3,"sources":["../src/types.ts"],"sourcesContent":["// Core Types\n\nexport interface BaseExecOptions {\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// 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   * 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}\n\nexport interface LogEvent {\n  type: 'stdout' | 'stderr' | 'exit' | 'error';\n  timestamp: string;\n  data: string;\n  processId: 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\n  // Internal fields\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    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    endTime?: string | null;\n    exitCode?: number | null;\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  }>;\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  } | 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  // File operations\n  gitCheckout(repoUrl: string, options: { branch?: string; targetDir?: string }): Promise<GitCheckoutResponse>;\n  mkdir(path: string, options?: { recursive?: boolean }): Promise<MkdirResponse>;\n  writeFile(path: string, content: string, options?: { encoding?: string }): Promise<WriteFileResponse>;\n  deleteFile(path: string): Promise<DeleteFileResponse>;\n  renameFile(oldPath: string, newPath: string): Promise<RenameFileResponse>;\n  moveFile(sourcePath: string, destinationPath: string): Promise<MoveFileResponse>;\n  readFile(path: string, options?: { encoding?: string }): Promise<ReadFileResponse>;\n  listFiles(path: string, options?: { recursive?: boolean; includeHidden?: boolean }): Promise<ListFilesResponse>;\n\n  // Port management\n  exposePort(port: number, options: { name?: string; hostname: string }): Promise<{ url: string; port: number; name?: string }>;\n  unexposePort(port: number): Promise<void>;\n  getExposedPorts(hostname: string): Promise<Array<{ url: string; port: number; name?: string; exposedAt: string }>>;\n\n  // Environment management\n  setEnvVars(envVars: Record<string, string>): Promise<void>;\n  setSandboxName(name: string): Promise<void>;\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// Execution session returned by createSession()\n// Sessions are full-featured sandbox objects with scoped execution context\n// Inherits all ISandbox methods except createSession (sessions can't create sub-sessions),\n// and setSandboxName (sessions inherit sandbox name).\nexport interface ExecutionSession extends Omit<ISandbox, 'createSession' | 'setSandboxName'> {\n  /**\n   * Session ID\n   */\n  id: string;\n}\n\n// API Response Types\n\nexport interface ExecuteResponse {\n  success: boolean;\n  stdout: string;\n  stderr: string;\n  exitCode: number;\n  command: string;\n  timestamp: string;\n}\n\nexport interface GitCheckoutResponse {\n  success: boolean;\n  stdout: string;\n  stderr: string;\n  exitCode: number;\n  repoUrl: string;\n  branch: string;\n  targetDir: string;\n  timestamp: string;\n}\n\nexport interface MkdirResponse {\n  success: boolean;\n  stdout: string;\n  stderr: string;\n  exitCode: number;\n  path: string;\n  recursive: boolean;\n  timestamp: string;\n}\n\nexport interface WriteFileResponse {\n  success: boolean;\n  exitCode: number;\n  path: string;\n  timestamp: string;\n}\n\nexport interface ReadFileResponse {\n  success: boolean;\n  exitCode: number;\n  path: string;\n  content: string;\n  timestamp: string;\n}\n\nexport interface DeleteFileResponse {\n  success: boolean;\n  exitCode: number;\n  path: string;\n  timestamp: string;\n}\n\nexport interface RenameFileResponse {\n  success: boolean;\n  exitCode: number;\n  oldPath: string;\n  newPath: string;\n  timestamp: string;\n}\n\nexport interface MoveFileResponse {\n  success: boolean;\n  exitCode: number;\n  sourcePath: string;\n  destinationPath: string;\n  timestamp: string;\n}\n\nexport interface ListFilesResponse {\n  success: boolean;\n  exitCode: number;\n  path: string;\n  files: Array<{\n    name: string;\n    absolutePath: string;\n    relativePath: string;\n    type: 'file' | 'directory' | 'symlink' | 'other';\n    size: number;\n    modifiedAt: string;\n    mode: string;\n    permissions: {\n      readable: boolean;\n      writable: boolean;\n      executable: boolean;\n    };\n  }>;\n  timestamp: 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":";AA2NO,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;AA+OO,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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cloudflare/sandbox",
-  "version": "0.2.3",
+  "version": "0.3.0",
   "repository": {
     "type": "git",
     "url": "https://github.com/cloudflare/sandbox-sdk"