@cloudflare/sandbox 0.2.1 → 0.2.2

package/dist/{chunk-SYMWNYWA.js → chunk-VTKZL632.js}

@@ -1,55 +1,63 @@
 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 = {}) {
-    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
-      })
+    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)
+      };
     });
-    if (!response.ok) {
-      const errorData = await response.json().catch(() => ({ error: "Unknown error" }));
-      throw new Error(errorData.error || `Failed to create context: ${response.status}`);
-    }
-    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) {
-    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
-      })
+    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);
+      }
     });
-    if (!response.ok) {
-      const errorData = await response.json().catch(() => ({ error: "Unknown error" }));
-      throw new Error(errorData.error || `Failed to execute code: ${response.status}`);
-    }
-    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();
@@ -146,40 +154,84 @@ var JupyterClient = class extends HttpClient {
     }
   }
   async listCodeContexts() {
-    const response = await this.doFetch("/api/contexts", {
-      method: "GET",
-      headers: { "Content-Type": "application/json" }
+    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)
+      }));
     });
-    if (!response.ok) {
-      const errorData = await response.json().catch(() => ({ error: "Unknown error" }));
-      throw new Error(errorData.error || `Failed to list contexts: ${response.status}`);
-    }
-    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) {
-    const response = await this.doFetch(`/api/contexts/${contextId}`, {
-      method: "DELETE",
-      headers: { "Content-Type": "application/json" }
+    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);
+      }
     });
-    if (!response.ok) {
-      const errorData = await response.json().catch(() => ({ error: "Unknown error" }));
-      throw new Error(errorData.error || `Failed to delete context: ${response.status}`);
-    }
   }
   // 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-SYMWNYWA.js.map
+//# 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":[]}

package/dist/{chunk-IATLC32Y.js → chunk-ZMPO44U4.js}

@@ -1,3 +1,9 @@
+import {
+  SecurityError,
+  logSecurityEvent,
+  sanitizeSandboxId,
+  validatePort
+} from "./chunk-6UAWTJ5S.js";
 import {
   parseSSEStream
 } from "./chunk-NNGBXDMY.js";
@@ -10,13 +16,7 @@ import {
 } from "./chunk-FKBV7CZS.js";
 import {
   JupyterClient
-} from "./chunk-SYMWNYWA.js";
-import {
-  SecurityError,
-  logSecurityEvent,
-  sanitizeSandboxId,
-  validatePort
-} from "./chunk-6UAWTJ5S.js";
+} from "./chunk-VTKZL632.js";
 
 // src/sandbox.ts
 import { Container, getContainer } from "@cloudflare/containers";
@@ -687,4 +687,4 @@ export {
   proxyToSandbox,
   isLocalhostPattern
 };
-//# sourceMappingURL=chunk-IATLC32Y.js.map
+//# sourceMappingURL=chunk-ZMPO44U4.js.map

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

@@ -9,6 +9,8 @@ interface ExecutionCallbacks {
     onError?: (error: ExecutionError) => void | Promise<void>;
 }
 declare class JupyterClient extends HttpClient {
+    private readonly maxRetries;
+    private readonly retryDelayMs;
     createCodeContext(options?: CreateContextOptions): Promise<CodeContext>;
     runCodeStream(contextId: string | undefined, code: string, language: string | undefined, callbacks: ExecutionCallbacks): Promise<void>;
     private readLines;
@@ -16,6 +18,14 @@ declare class JupyterClient extends HttpClient {
     listCodeContexts(): Promise<CodeContext[]>;
     deleteCodeContext(contextId: string): Promise<void>;
     doFetch(path: string, options?: RequestInit): Promise<Response>;
+    /**
+     * Execute an operation with automatic retry for transient errors
+     */
+    private executeWithRetry;
+    /**
+     * Check if an error is retryable
+     */
+    private isRetryableError;
 }
 
 declare function getSandbox(ns: DurableObjectNamespace<Sandbox>, id: string): DurableObjectStub<Sandbox<unknown>>;

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-C7rKCYBD.js';
+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';
 import './types.js';
 import '@cloudflare/containers';
 import './interpreter-types.js';

package/dist/errors.d.ts

@@ -0,0 +1,95 @@
+/**
+ * Standard error response from the sandbox API
+ */
+interface SandboxErrorResponse {
+    error?: string;
+    status?: string;
+    progress?: number;
+}
+/**
+ * Base error class for all Sandbox-related errors
+ */
+declare class SandboxError extends Error {
+    constructor(message: string);
+}
+/**
+ * Error thrown when Jupyter functionality is requested but the service is still initializing.
+ *
+ * Note: With the current implementation, requests wait for Jupyter to be ready.
+ * This error is only thrown when:
+ * 1. The request times out waiting for Jupyter (default: 30 seconds)
+ * 2. Jupyter initialization actually fails
+ *
+ * Most requests will succeed after a delay, not throw this error.
+ */
+declare class JupyterNotReadyError extends SandboxError {
+    readonly code = "JUPYTER_NOT_READY";
+    readonly retryAfter: number;
+    readonly progress?: number;
+    constructor(message?: string, options?: {
+        retryAfter?: number;
+        progress?: number;
+    });
+}
+/**
+ * Error thrown when a context is not found
+ */
+declare class ContextNotFoundError extends SandboxError {
+    readonly code = "CONTEXT_NOT_FOUND";
+    readonly contextId: string;
+    constructor(contextId: string);
+}
+/**
+ * Error thrown when code execution fails
+ */
+declare class CodeExecutionError extends SandboxError {
+    readonly code = "CODE_EXECUTION_ERROR";
+    readonly executionError?: {
+        ename?: string;
+        evalue?: string;
+        traceback?: string[];
+    };
+    constructor(message: string, executionError?: any);
+}
+/**
+ * Error thrown when the sandbox container is not ready
+ */
+declare class ContainerNotReadyError extends SandboxError {
+    readonly code = "CONTAINER_NOT_READY";
+    constructor(message?: string);
+}
+/**
+ * Error thrown when a network request to the sandbox fails
+ */
+declare class SandboxNetworkError extends SandboxError {
+    readonly code = "NETWORK_ERROR";
+    readonly statusCode?: number;
+    readonly statusText?: string;
+    constructor(message: string, statusCode?: number, statusText?: string);
+}
+/**
+ * Error thrown when service is temporarily unavailable (e.g., circuit breaker open)
+ */
+declare class ServiceUnavailableError extends SandboxError {
+    readonly code = "SERVICE_UNAVAILABLE";
+    readonly retryAfter?: number;
+    constructor(message?: string, retryAfter?: number);
+}
+/**
+ * Type guard to check if an error is a JupyterNotReadyError
+ */
+declare function isJupyterNotReadyError(error: unknown): error is JupyterNotReadyError;
+/**
+ * Type guard to check if an error is any SandboxError
+ */
+declare function isSandboxError(error: unknown): error is SandboxError;
+/**
+ * Helper to determine if an error is retryable
+ */
+declare function isRetryableError(error: unknown): boolean;
+/**
+ * Parse error response from the sandbox API and return appropriate error instance
+ */
+declare function parseErrorResponse(response: Response): Promise<SandboxError>;
+
+export { CodeExecutionError, ContainerNotReadyError, ContextNotFoundError, JupyterNotReadyError, SandboxError, type SandboxErrorResponse, SandboxNetworkError, ServiceUnavailableError, isJupyterNotReadyError, isRetryableError, isSandboxError, parseErrorResponse };

package/dist/errors.js

@@ -0,0 +1,27 @@
+import {
+  CodeExecutionError,
+  ContainerNotReadyError,
+  ContextNotFoundError,
+  JupyterNotReadyError,
+  SandboxError,
+  SandboxNetworkError,
+  ServiceUnavailableError,
+  isJupyterNotReadyError,
+  isRetryableError,
+  isSandboxError,
+  parseErrorResponse
+} from "./chunk-LALY4SFU.js";
+export {
+  CodeExecutionError,
+  ContainerNotReadyError,
+  ContextNotFoundError,
+  JupyterNotReadyError,
+  SandboxError,
+  SandboxNetworkError,
+  ServiceUnavailableError,
+  isJupyterNotReadyError,
+  isRetryableError,
+  isSandboxError,
+  parseErrorResponse
+};
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/index.d.ts

@@ -1,4 +1,5 @@
-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-C7rKCYBD.js';
+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 { asyncIterableToSSEStream, parseSSEStream, responseToAsyncIterable } from './sse-parser.js';

package/dist/index.js

@@ -2,7 +2,8 @@ import {
   Sandbox,
   getSandbox,
   proxyToSandbox
-} from "./chunk-IATLC32Y.js";
+} from "./chunk-ZMPO44U4.js";
+import "./chunk-6UAWTJ5S.js";
 import {
   asyncIterableToSSEStream,
   parseSSEStream,
@@ -13,14 +14,37 @@ import "./chunk-FKBV7CZS.js";
 import {
   ResultImpl
 } from "./chunk-EGC5IYXA.js";
-import "./chunk-SYMWNYWA.js";
+import "./chunk-VTKZL632.js";
 import "./chunk-CUHYLCMT.js";
-import "./chunk-6UAWTJ5S.js";
+import {
+  CodeExecutionError,
+  ContainerNotReadyError,
+  ContextNotFoundError,
+  JupyterNotReadyError,
+  SandboxError,
+  SandboxNetworkError,
+  ServiceUnavailableError,
+  isJupyterNotReadyError,
+  isRetryableError,
+  isSandboxError,
+  parseErrorResponse
+} from "./chunk-LALY4SFU.js";
 export {
+  CodeExecutionError,
+  ContainerNotReadyError,
+  ContextNotFoundError,
+  JupyterNotReadyError,
   ResultImpl,
   Sandbox,
+  SandboxError,
+  SandboxNetworkError,
+  ServiceUnavailableError,
   asyncIterableToSSEStream,
   getSandbox,
+  isJupyterNotReadyError,
+  isRetryableError,
+  isSandboxError,
+  parseErrorResponse,
   parseSSEStream,
   proxyToSandbox,
   responseToAsyncIterable

package/dist/interpreter.d.ts

@@ -1,5 +1,5 @@
 import { CreateContextOptions, CodeContext, RunCodeOptions, Execution } from './interpreter-types.js';
-import { S as Sandbox } from './client-C7rKCYBD.js';
+import { S as Sandbox } from './client-bzEV222a.js';
 import '@cloudflare/containers';
 import './types.js';
 

package/dist/jupyter-client.d.ts

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

package/dist/jupyter-client.js

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

package/dist/request-handler.d.ts

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

package/dist/request-handler.js

@@ -1,14 +1,15 @@
 import {
   isLocalhostPattern,
   proxyToSandbox
-} from "./chunk-IATLC32Y.js";
+} from "./chunk-ZMPO44U4.js";
+import "./chunk-6UAWTJ5S.js";
 import "./chunk-NNGBXDMY.js";
 import "./chunk-S5FFBU4Y.js";
 import "./chunk-FKBV7CZS.js";
 import "./chunk-EGC5IYXA.js";
-import "./chunk-SYMWNYWA.js";
+import "./chunk-VTKZL632.js";
 import "./chunk-CUHYLCMT.js";
-import "./chunk-6UAWTJ5S.js";
+import "./chunk-LALY4SFU.js";
 export {
   isLocalhostPattern,
   proxyToSandbox

package/dist/sandbox.d.ts

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

package/dist/sandbox.js

@@ -1,14 +1,15 @@
 import {
   Sandbox,
   getSandbox
-} from "./chunk-IATLC32Y.js";
+} from "./chunk-ZMPO44U4.js";
+import "./chunk-6UAWTJ5S.js";
 import "./chunk-NNGBXDMY.js";
 import "./chunk-S5FFBU4Y.js";
 import "./chunk-FKBV7CZS.js";
 import "./chunk-EGC5IYXA.js";
-import "./chunk-SYMWNYWA.js";
+import "./chunk-VTKZL632.js";
 import "./chunk-CUHYLCMT.js";
-import "./chunk-6UAWTJ5S.js";
+import "./chunk-LALY4SFU.js";
 export {
   Sandbox,
   getSandbox

package/package.json

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