@cloudflare/sandbox 0.3.1 → 0.3.2

package/container_src/jupyter-service.ts

@@ -1,461 +0,0 @@
-import { existsSync } from "node:fs";
-import { CircuitBreaker } from "./circuit-breaker";
-import { type CreateContextRequest, JupyterServer } from "./jupyter-server";
-
-interface PoolStats {
-  available: number;
-  inUse: number;
-  total: number;
-  minSize: number;
-  maxSize: number;
-  warming: boolean;
-}
-
-interface CircuitBreakerState {
-  state: string;
-  failures: number;
-  lastFailure: number;
-  isOpen: boolean;
-}
-
-export interface JupyterHealthStatus {
-  ready: boolean;
-  initializing: boolean;
-  error?: string;
-  checks?: {
-    httpApi: boolean;
-    kernelManager: boolean;
-    markerFile: boolean;
-    kernelSpawn?: boolean;
-    websocket?: boolean;
-  };
-  timestamp: number;
-  performance?: {
-    poolStats?: Record<string, PoolStats>;
-    activeContexts?: number;
-    uptime?: number;
-    circuitBreakers?: {
-      contextCreation: CircuitBreakerState;
-      codeExecution: CircuitBreakerState;
-      kernelCommunication: CircuitBreakerState;
-    };
-  };
-}
-
-/**
- * Wrapper service that provides graceful degradation for Jupyter functionality
- */
-export class JupyterService {
-  private jupyterServer: JupyterServer;
-  private initPromise: Promise<void> | null = null;
-  private initialized = false;
-  private initError: Error | null = null;
-  private startTime = Date.now();
-  private circuitBreakers: {
-    contextCreation: CircuitBreaker;
-    codeExecution: CircuitBreaker;
-    kernelCommunication: CircuitBreaker;
-  };
-
-  constructor() {
-    this.jupyterServer = new JupyterServer();
-
-    // Initialize circuit breakers for different operations
-    this.circuitBreakers = {
-      contextCreation: new CircuitBreaker({
-        name: "context-creation",
-        threshold: 3,
-        timeout: 60000, // 1 minute
-      }),
-      codeExecution: new CircuitBreaker({
-        name: "code-execution",
-        threshold: 5,
-        timeout: 30000, // 30 seconds
-      }),
-      kernelCommunication: new CircuitBreaker({
-        name: "kernel-communication",
-        threshold: 10,
-        timeout: 20000, // 20 seconds
-      }),
-    };
-  }
-
-  /**
-   * Initialize Jupyter server with retry logic
-   */
-  async initialize(): Promise<void> {
-    if (this.initialized) return;
-
-    if (!this.initPromise) {
-      this.initPromise = this.doInitialize()
-        .then(() => {
-          this.initialized = true;
-          console.log("[JupyterService] Initialization complete");
-        })
-        .catch((err) => {
-          this.initError = err;
-          // Don't null out initPromise on error - keep it so we can return the same error
-          console.error("[JupyterService] Initialization failed:", err);
-          throw err;
-        });
-    }
-
-    return this.initPromise;
-  }
-
-  private async doInitialize(): Promise<void> {
-    // Wait for Jupyter marker file or timeout
-    const markerCheckPromise = this.waitForMarkerFile();
-    const timeoutPromise = new Promise<void>((_, reject) => {
-      setTimeout(
-        () => reject(new Error("Jupyter initialization timeout")),
-        60000
-      );
-    });
-
-    try {
-      await Promise.race([markerCheckPromise, timeoutPromise]);
-      console.log("[JupyterService] Jupyter process detected via marker file");
-    } catch (error) {
-      console.log(
-        "[JupyterService] Marker file not found yet - proceeding with initialization"
-      );
-    }
-
-    // Initialize Jupyter server
-    await this.jupyterServer.initialize();
-
-    // Pre-warm context pools in background after Jupyter is ready
-    this.warmContextPools();
-  }
-
-  /**
-   * Pre-warm context pools for better performance
-   */
-  private async warmContextPools() {
-    // Delay pre-warming to avoid startup rush that triggers Bun WebSocket bug
-    await new Promise((resolve) => setTimeout(resolve, 2000));
-
-    try {
-      console.log(
-        "[JupyterService] Pre-warming context pools for better performance"
-      );
-
-      // Only pre-warm Python contexts to avoid Bun WebSocket validation errors
-      // JavaScript contexts will be created on-demand
-      await this.jupyterServer.enablePoolWarming("python", 1);
-
-      // Commenting out JavaScript pre-warming due to kernel message validation errors
-      // The errors appear to be related to Bun's handling of WebSocket messages
-      // JavaScript contexts still work fine when created on-demand
-      // 
-      // await new Promise((resolve) => setTimeout(resolve, 1000));
-      // await this.jupyterServer.enablePoolWarming("javascript", 1);
-    } catch (error) {
-      console.error("[JupyterService] Error pre-warming context pools:", error);
-      console.error(
-        "[JupyterService] Pre-warming failed but service continues"
-      );
-    }
-  }
-
-  private async waitForMarkerFile(): Promise<void> {
-    const markerPath = "/tmp/jupyter-ready";
-    let attempts = 0;
-    const maxAttempts = 120; // 2 minutes with 1s intervals
-
-    while (attempts < maxAttempts) {
-      if (existsSync(markerPath)) {
-        return;
-      }
-      attempts++;
-      await new Promise((resolve) => setTimeout(resolve, 1000));
-    }
-
-    throw new Error("Marker file not found within timeout");
-  }
-
-  /**
-   * Get current health status
-   */
-  async getHealthStatus(): Promise<JupyterHealthStatus> {
-    const status: JupyterHealthStatus = {
-      ready: this.initialized,
-      initializing: this.initPromise !== null && !this.initialized,
-      timestamp: Date.now(),
-    };
-
-    if (this.initError) {
-      status.error = this.initError.message;
-    }
-
-    // Detailed health checks
-    if (this.initialized || this.initPromise) {
-      status.checks = {
-        httpApi: await this.checkHttpApi(),
-        kernelManager: this.initialized,
-        markerFile: existsSync("/tmp/jupyter-ready"),
-      };
-
-      // Advanced health checks only if fully initialized
-      if (this.initialized) {
-        const advancedChecks = await this.performAdvancedHealthChecks();
-        status.checks.kernelSpawn = advancedChecks.kernelSpawn;
-        status.checks.websocket = advancedChecks.websocket;
-
-        // Performance metrics
-        status.performance = {
-          poolStats: await this.jupyterServer.getPoolStats(),
-          activeContexts: (await this.jupyterServer.listContexts()).length,
-          uptime: Date.now() - this.startTime,
-        };
-      }
-    }
-
-    // Add circuit breaker status
-    if (status.performance) {
-      status.performance.circuitBreakers = {
-        contextCreation: this.circuitBreakers.contextCreation.getState(),
-        codeExecution: this.circuitBreakers.codeExecution.getState(),
-        kernelCommunication:
-          this.circuitBreakers.kernelCommunication.getState(),
-      };
-    }
-
-    return status;
-  }
-
-  private async checkHttpApi(): Promise<boolean> {
-    try {
-      const response = await fetch("http://localhost:8888/api", {
-        signal: AbortSignal.timeout(2000),
-      });
-      return response.ok;
-    } catch {
-      return false;
-    }
-  }
-
-  /**
-   * Perform advanced health checks including kernel spawn and WebSocket
-   */
-  private async performAdvancedHealthChecks(): Promise<{
-    kernelSpawn: boolean;
-    websocket: boolean;
-  }> {
-    const checks = {
-      kernelSpawn: false,
-      websocket: false,
-    };
-
-    try {
-      // Test kernel spawn with timeout
-      const testContext = await Promise.race([
-        this.jupyterServer.createContext({ language: "python" }),
-        new Promise<null>((_, reject) =>
-          setTimeout(() => reject(new Error("Kernel spawn timeout")), 5000)
-        ),
-      ]);
-
-      if (testContext) {
-        checks.kernelSpawn = true;
-
-        // Test WebSocket by executing simple code
-        try {
-          const result = await Promise.race([
-            this.jupyterServer.executeCode(
-              testContext.id,
-              "print('health_check')"
-            ),
-            new Promise<null>((_, reject) =>
-              setTimeout(() => reject(new Error("WebSocket timeout")), 3000)
-            ),
-          ]);
-
-          checks.websocket = result !== null;
-        } catch {
-          // WebSocket test failed
-        }
-
-        // Clean up test context
-        try {
-          await this.jupyterServer.deleteContext(testContext.id);
-        } catch {
-          // Ignore cleanup errors
-        }
-      }
-    } catch (error) {
-      console.log("[JupyterService] Advanced health check failed:", error);
-    }
-
-    return checks;
-  }
-
-  /**
-   * Ensure Jupyter is initialized before proceeding
-   * This will wait for initialization to complete or fail
-   */
-  private async ensureInitialized(timeoutMs: number = 30000): Promise<void> {
-    if (this.initialized) return;
-
-    // Start initialization if not already started
-    if (!this.initPromise) {
-      this.initPromise = this.initialize();
-    }
-
-    // Wait for initialization with timeout
-    try {
-      await Promise.race([
-        this.initPromise,
-        new Promise<never>((_, reject) =>
-          setTimeout(
-            () =>
-              reject(new Error("Timeout waiting for Jupyter initialization")),
-            timeoutMs
-          )
-        ),
-      ]);
-    } catch (error) {
-      // If it's a timeout and Jupyter is still initializing, throw a retryable error
-      if (
-        error instanceof Error &&
-        error.message.includes("Timeout") &&
-        !this.initError
-      ) {
-        throw new JupyterNotReadyError(
-          "Jupyter is taking longer than expected to initialize. Please try again.",
-          {
-            retryAfter: 10,
-            progress: this.getInitializationProgress(),
-          }
-        );
-      }
-      // If initialization actually failed, throw the real error
-      throw new Error(
-        `Jupyter initialization failed: ${
-          error instanceof Error ? error.message : "Unknown error"
-        }`
-      );
-    }
-  }
-
-  /**
-   * Create context - will wait for Jupyter if still initializing
-   */
-  async createContext(req: CreateContextRequest): Promise<any> {
-    if (!this.initialized) {
-      console.log(
-        "[JupyterService] Context creation requested while Jupyter is initializing - waiting..."
-      );
-      const startWait = Date.now();
-      await this.ensureInitialized();
-      const waitTime = Date.now() - startWait;
-      console.log(
-        `[JupyterService] Jupyter ready after ${waitTime}ms wait - proceeding with context creation`
-      );
-    }
-
-    // Use circuit breaker for context creation
-    return await this.circuitBreakers.contextCreation.execute(async () => {
-      return await this.jupyterServer.createContext(req);
-    });
-  }
-
-  /**
-   * Execute code - will wait for Jupyter if still initializing
-   */
-  async executeCode(
-    contextId: string | undefined,
-    code: string,
-    language?: string
-  ): Promise<Response> {
-    if (!this.initialized) {
-      console.log(
-        "[JupyterService] Code execution requested while Jupyter is initializing - waiting..."
-      );
-      const startWait = Date.now();
-      await this.ensureInitialized();
-      const waitTime = Date.now() - startWait;
-      console.log(
-        `[JupyterService] Jupyter ready after ${waitTime}ms wait - proceeding with code execution`
-      );
-    }
-
-    // Use circuit breaker for code execution
-    return await this.circuitBreakers.codeExecution.execute(async () => {
-      return await this.jupyterServer.executeCode(contextId, code, language);
-    });
-  }
-
-  /**
-   * List contexts with graceful degradation
-   */
-  async listContexts(): Promise<any[]> {
-    if (!this.initialized) {
-      return [];
-    }
-    return await this.jupyterServer.listContexts();
-  }
-
-  /**
-   * Delete context - will wait for Jupyter if still initializing
-   */
-  async deleteContext(contextId: string): Promise<void> {
-    if (!this.initialized) {
-      console.log(
-        "[JupyterService] Context deletion requested while Jupyter is initializing - waiting..."
-      );
-      const startWait = Date.now();
-      await this.ensureInitialized();
-      const waitTime = Date.now() - startWait;
-      console.log(
-        `[JupyterService] Jupyter ready after ${waitTime}ms wait - proceeding with context deletion`
-      );
-    }
-
-    // Use circuit breaker for kernel communication
-    return await this.circuitBreakers.kernelCommunication.execute(async () => {
-      return await this.jupyterServer.deleteContext(contextId);
-    });
-  }
-
-  /**
-   * Shutdown the service
-   */
-  async shutdown(): Promise<void> {
-    if (this.initialized) {
-      await this.jupyterServer.shutdown();
-    }
-  }
-
-  /**
-   * Get initialization progress
-   */
-  private getInitializationProgress(): number {
-    if (this.initialized) return 100;
-    if (!this.initPromise) return 0;
-
-    const elapsed = Date.now() - this.startTime;
-    const estimatedTotal = 20000; // 20 seconds estimated
-    return Math.min(95, Math.round((elapsed / estimatedTotal) * 100));
-  }
-}
-
-/**
- * Error thrown when Jupyter is not ready yet
- * This matches the interface of the SDK's JupyterNotReadyError
- */
-export class JupyterNotReadyError extends Error {
-  public readonly retryAfter: number;
-  public readonly progress?: number;
-
-  constructor(
-    message: string,
-    options?: { retryAfter?: number; progress?: number }
-  ) {
-    super(message);
-    this.name = "JupyterNotReadyError";
-    this.retryAfter = options?.retryAfter || 5;
-    this.progress = options?.progress;
-  }
-}

package/container_src/jupyter_config.py

@@ -1,48 +0,0 @@
-"""
-Minimal Jupyter configuration focused on kernel-only usage
-"""
-
-c = get_config()  # noqa
-
-# Disable all authentication - we handle security at container level
-c.ServerApp.token = ''
-c.ServerApp.password = ''
-c.IdentityProvider.token = ''
-c.ServerApp.allow_origin = '*'
-c.ServerApp.allow_remote_access = True
-c.ServerApp.disable_check_xsrf = True
-c.ServerApp.allow_root = True
-c.ServerApp.allow_credentials = True
-
-# Also set NotebookApp settings for compatibility
-c.NotebookApp.token = ''
-c.NotebookApp.password = ''
-c.NotebookApp.allow_origin = '*'
-c.NotebookApp.allow_remote_access = True
-c.NotebookApp.disable_check_xsrf = True
-c.NotebookApp.allow_credentials = True
-
-# Performance settings
-c.ServerApp.iopub_data_rate_limit = 1000000000  # E2B uses 1GB/s
-
-# Minimal logging
-c.Application.log_level = 'ERROR'
-
-# Disable browser
-c.ServerApp.open_browser = False
-
-# Optimize for container environment
-c.ServerApp.ip = '0.0.0.0'
-c.ServerApp.port = 8888
-
-# Kernel optimizations
-c.KernelManager.shutdown_wait_time = 0.0
-c.MappingKernelManager.cull_idle_timeout = 0
-c.MappingKernelManager.cull_interval = 0
-
-# Disable terminals
-c.ServerApp.terminals_enabled = False
-
-# Disable all extensions to speed up startup
-c.ServerApp.jpserver_extensions = {}
-c.ServerApp.nbserver_extensions = {}

package/dist/chunk-BEQUGUY4.js.map

@@ -1 +0,0 @@
-{"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-EGC5IYXA.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/interpreter-types.ts"],"sourcesContent":["// Context Management\nexport interface CreateContextOptions {\n  /**\n   * Programming language for the context\n   * @default 'python'\n   */\n  language?: 'python' | 'javascript' | 'typescript';\n  \n  /**\n   * Working directory for the context\n   * @default '/workspace'\n   */\n  cwd?: string;\n  \n  /**\n   * Environment variables for the context\n   */\n  envVars?: Record<string, string>;\n  \n  /**\n   * Request timeout in milliseconds\n   * @default 30000\n   */\n  timeout?: number;\n}\n\nexport interface CodeContext {\n  /**\n   * Unique identifier for the context\n   */\n  readonly id: string;\n  \n  /**\n   * Programming language of the context\n   */\n  readonly language: string;\n  \n  /**\n   * Current working directory\n   */\n  readonly cwd: string;\n  \n  /**\n   * When the context was created\n   */\n  readonly createdAt: Date;\n  \n  /**\n   * When the context was last used\n   */\n  readonly lastUsed: Date;\n}\n\n// Execution Options\nexport interface RunCodeOptions {\n  /**\n   * Context to run the code in. If not provided, uses default context for the language\n   */\n  context?: CodeContext;\n  \n  /**\n   * Language to use if context is not provided\n   * @default 'python'\n   */\n  language?: 'python' | 'javascript' | 'typescript';\n  \n  /**\n   * Environment variables for this execution\n   */\n  envVars?: Record<string, string>;\n  \n  /**\n   * Execution timeout in milliseconds\n   * @default 60000\n   */\n  timeout?: number;\n  \n  /**\n   * AbortSignal for cancelling execution\n   */\n  signal?: AbortSignal;\n  \n  /**\n   * Callback for stdout output\n   */\n  onStdout?: (output: OutputMessage) => void | Promise<void>;\n  \n  /**\n   * Callback for stderr output\n   */\n  onStderr?: (output: OutputMessage) => void | Promise<void>;\n  \n  /**\n   * Callback for execution results (charts, tables, etc)\n   */\n  onResult?: (result: Result) => void | Promise<void>;\n  \n  /**\n   * Callback for execution errors\n   */\n  onError?: (error: ExecutionError) => void | Promise<void>;\n}\n\n// Output Messages\nexport interface OutputMessage {\n  /**\n   * The output text\n   */\n  text: string;\n  \n  /**\n   * Timestamp of the output\n   */\n  timestamp: number;\n}\n\n// Execution Results\nexport interface Result {\n  /**\n   * Plain text representation\n   */\n  text?: string;\n  \n  /**\n   * HTML representation (tables, formatted output)\n   */\n  html?: string;\n  \n  /**\n   * PNG image data (base64 encoded)\n   */\n  png?: string;\n  \n  /**\n   * JPEG image data (base64 encoded)\n   */\n  jpeg?: string;\n  \n  /**\n   * SVG image data\n   */\n  svg?: string;\n  \n  /**\n   * LaTeX representation\n   */\n  latex?: string;\n  \n  /**\n   * Markdown representation\n   */\n  markdown?: string;\n  \n  /**\n   * JavaScript code to execute\n   */\n  javascript?: string;\n  \n  /**\n   * JSON data\n   */\n  json?: any;\n  \n  /**\n   * Chart data if the result is a visualization\n   */\n  chart?: ChartData;\n  \n  /**\n   * Raw data object\n   */\n  data?: any;\n  \n  /**\n   * Available output formats\n   */\n  formats(): string[];\n}\n\n// Chart Data\nexport interface ChartData {\n  /**\n   * Type of chart\n   */\n  type: 'line' | 'bar' | 'scatter' | 'pie' | 'histogram' | 'heatmap' | 'unknown';\n  \n  /**\n   * Chart title\n   */\n  title?: string;\n  \n  /**\n   * Chart data (format depends on library)\n   */\n  data: any;\n  \n  /**\n   * Chart layout/configuration\n   */\n  layout?: any;\n  \n  /**\n   * Additional configuration\n   */\n  config?: any;\n  \n  /**\n   * Library that generated the chart\n   */\n  library?: 'matplotlib' | 'plotly' | 'altair' | 'seaborn' | 'unknown';\n  \n  /**\n   * Base64 encoded image if available\n   */\n  image?: string;\n}\n\n// Execution Error\nexport interface ExecutionError {\n  /**\n   * Error name/type (e.g., 'NameError', 'SyntaxError')\n   */\n  name: string;\n  \n  /**\n   * Error message\n   */\n  value: string;\n  \n  /**\n   * Stack trace\n   */\n  traceback: string[];\n  \n  /**\n   * Line number where error occurred\n   */\n  lineNumber?: number;\n}\n\n// Serializable execution result\nexport interface ExecutionResult {\n  code: string;\n  logs: {\n    stdout: string[];\n    stderr: string[];\n  };\n  error?: ExecutionError;\n  executionCount?: number;\n  results: Array<{\n    text?: string;\n    html?: string;\n    png?: string;\n    jpeg?: string;\n    svg?: string;\n    latex?: string;\n    markdown?: string;\n    javascript?: string;\n    json?: any;\n    chart?: ChartData;\n    data?: any;\n  }>;\n}\n\n// Execution Result Container\nexport class Execution {\n  /**\n   * All results from the execution\n   */\n  public results: Result[] = [];\n  \n  /**\n   * Accumulated stdout and stderr\n   */\n  public logs = {\n    stdout: [] as string[],\n    stderr: [] as string[]\n  };\n  \n  /**\n   * Execution error if any\n   */\n  public error?: ExecutionError;\n  \n  /**\n   * Execution count (for Jupyter)\n   */\n  public executionCount?: number;\n  \n  constructor(\n    public readonly code: string,\n    public readonly context: CodeContext\n  ) {}\n  \n  /**\n   * Convert to a plain object for serialization\n   */\n  toJSON(): ExecutionResult {\n    return {\n      code: this.code,\n      logs: this.logs,\n      error: this.error,\n      executionCount: this.executionCount,\n      results: this.results.map(result => ({\n        text: result.text,\n        html: result.html,\n        png: result.png,\n        jpeg: result.jpeg,\n        svg: result.svg,\n        latex: result.latex,\n        markdown: result.markdown,\n        javascript: result.javascript,\n        json: result.json,\n        chart: result.chart,\n        data: result.data\n      }))\n    };\n  }\n}\n\n// Implementation of Result\nexport class ResultImpl implements Result {\n  constructor(private raw: any) {}\n  \n  get text(): string | undefined { \n    return this.raw.text || this.raw.data?.['text/plain']; \n  }\n  \n  get html(): string | undefined { \n    return this.raw.html || this.raw.data?.['text/html']; \n  }\n  \n  get png(): string | undefined { \n    return this.raw.png || this.raw.data?.['image/png']; \n  }\n  \n  get jpeg(): string | undefined { \n    return this.raw.jpeg || this.raw.data?.['image/jpeg']; \n  }\n  \n  get svg(): string | undefined { \n    return this.raw.svg || this.raw.data?.['image/svg+xml']; \n  }\n  \n  get latex(): string | undefined { \n    return this.raw.latex || this.raw.data?.['text/latex']; \n  }\n  \n  get markdown(): string | undefined { \n    return this.raw.markdown || this.raw.data?.['text/markdown']; \n  }\n  \n  get javascript(): string | undefined { \n    return this.raw.javascript || this.raw.data?.['application/javascript']; \n  }\n  \n  get json(): any { \n    return this.raw.json || this.raw.data?.['application/json']; \n  }\n  \n  get chart(): ChartData | undefined { \n    return this.raw.chart; \n  }\n  \n  get data(): any { \n    return this.raw.data; \n  }\n  \n  formats(): string[] {\n    const formats: string[] = [];\n    if (this.text) formats.push('text');\n    if (this.html) formats.push('html');\n    if (this.png) formats.push('png');\n    if (this.jpeg) formats.push('jpeg');\n    if (this.svg) formats.push('svg');\n    if (this.latex) formats.push('latex');\n    if (this.markdown) formats.push('markdown');\n    if (this.javascript) formats.push('javascript');\n    if (this.json) formats.push('json');\n    if (this.chart) formats.push('chart');\n    return formats;\n  }\n}"],"mappings":";AAyQO,IAAM,YAAN,MAAgB;AAAA,EAwBrB,YACkB,MACA,SAChB;AAFgB;AACA;AAAA,EACf;AAAA;AAAA;AAAA;AAAA,EAvBI,UAAoB,CAAC;AAAA;AAAA;AAAA;AAAA,EAKrB,OAAO;AAAA,IACZ,QAAQ,CAAC;AAAA,IACT,QAAQ,CAAC;AAAA,EACX;AAAA;AAAA;AAAA;AAAA,EAKO;AAAA;AAAA;AAAA;AAAA,EAKA;AAAA;AAAA;AAAA;AAAA,EAUP,SAA0B;AACxB,WAAO;AAAA,MACL,MAAM,KAAK;AAAA,MACX,MAAM,KAAK;AAAA,MACX,OAAO,KAAK;AAAA,MACZ,gBAAgB,KAAK;AAAA,MACrB,SAAS,KAAK,QAAQ,IAAI,aAAW;AAAA,QACnC,MAAM,OAAO;AAAA,QACb,MAAM,OAAO;AAAA,QACb,KAAK,OAAO;AAAA,QACZ,MAAM,OAAO;AAAA,QACb,KAAK,OAAO;AAAA,QACZ,OAAO,OAAO;AAAA,QACd,UAAU,OAAO;AAAA,QACjB,YAAY,OAAO;AAAA,QACnB,MAAM,OAAO;AAAA,QACb,OAAO,OAAO;AAAA,QACd,MAAM,OAAO;AAAA,MACf,EAAE;AAAA,IACJ;AAAA,EACF;AACF;AAGO,IAAM,aAAN,MAAmC;AAAA,EACxC,YAAoB,KAAU;AAAV;AAAA,EAAW;AAAA,EAE/B,IAAI,OAA2B;AAC7B,WAAO,KAAK,IAAI,QAAQ,KAAK,IAAI,OAAO,YAAY;AAAA,EACtD;AAAA,EAEA,IAAI,OAA2B;AAC7B,WAAO,KAAK,IAAI,QAAQ,KAAK,IAAI,OAAO,WAAW;AAAA,EACrD;AAAA,EAEA,IAAI,MAA0B;AAC5B,WAAO,KAAK,IAAI,OAAO,KAAK,IAAI,OAAO,WAAW;AAAA,EACpD;AAAA,EAEA,IAAI,OAA2B;AAC7B,WAAO,KAAK,IAAI,QAAQ,KAAK,IAAI,OAAO,YAAY;AAAA,EACtD;AAAA,EAEA,IAAI,MAA0B;AAC5B,WAAO,KAAK,IAAI,OAAO,KAAK,IAAI,OAAO,eAAe;AAAA,EACxD;AAAA,EAEA,IAAI,QAA4B;AAC9B,WAAO,KAAK,IAAI,SAAS,KAAK,IAAI,OAAO,YAAY;AAAA,EACvD;AAAA,EAEA,IAAI,WAA+B;AACjC,WAAO,KAAK,IAAI,YAAY,KAAK,IAAI,OAAO,eAAe;AAAA,EAC7D;AAAA,EAEA,IAAI,aAAiC;AACnC,WAAO,KAAK,IAAI,cAAc,KAAK,IAAI,OAAO,wBAAwB;AAAA,EACxE;AAAA,EAEA,IAAI,OAAY;AACd,WAAO,KAAK,IAAI,QAAQ,KAAK,IAAI,OAAO,kBAAkB;AAAA,EAC5D;AAAA,EAEA,IAAI,QAA+B;AACjC,WAAO,KAAK,IAAI;AAAA,EAClB;AAAA,EAEA,IAAI,OAAY;AACd,WAAO,KAAK,IAAI;AAAA,EAClB;AAAA,EAEA,UAAoB;AAClB,UAAM,UAAoB,CAAC;AAC3B,QAAI,KAAK,KAAM,SAAQ,KAAK,MAAM;AAClC,QAAI,KAAK,KAAM,SAAQ,KAAK,MAAM;AAClC,QAAI,KAAK,IAAK,SAAQ,KAAK,KAAK;AAChC,QAAI,KAAK,KAAM,SAAQ,KAAK,MAAM;AAClC,QAAI,KAAK,IAAK,SAAQ,KAAK,KAAK;AAChC,QAAI,KAAK,MAAO,SAAQ,KAAK,OAAO;AACpC,QAAI,KAAK,SAAU,SAAQ,KAAK,UAAU;AAC1C,QAAI,KAAK,WAAY,SAAQ,KAAK,YAAY;AAC9C,QAAI,KAAK,KAAM,SAAQ,KAAK,MAAM;AAClC,QAAI,KAAK,MAAO,SAAQ,KAAK,OAAO;AACpC,WAAO;AAAA,EACT;AACF;","names":[]}

package/dist/chunk-FKBV7CZS.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/interpreter.ts"],"sourcesContent":["import {\n  type CodeContext,\n  type CreateContextOptions,\n  Execution,\n  ResultImpl,\n  type RunCodeOptions,\n} from \"./interpreter-types.js\";\nimport type { JupyterClient } from \"./jupyter-client.js\";\nimport type { Sandbox } from \"./sandbox.js\";\n\nexport class CodeInterpreter {\n  private jupyterClient: JupyterClient;\n  private contexts = new Map<string, CodeContext>();\n\n  constructor(sandbox: Sandbox) {\n    this.jupyterClient = sandbox.client as JupyterClient;\n  }\n\n  /**\n   * Create a new code execution context\n   */\n  async createCodeContext(\n    options: CreateContextOptions = {}\n  ): Promise<CodeContext> {\n    const context = await this.jupyterClient.createCodeContext(options);\n    this.contexts.set(context.id, context);\n    return context;\n  }\n\n  /**\n   * Run code with optional context\n   */\n  async runCode(\n    code: string,\n    options: RunCodeOptions = {}\n  ): Promise<Execution> {\n    // Get or create context\n    let context = options.context;\n    if (!context) {\n      // Try to find or create a default context for the language\n      const language = options.language || \"python\";\n      context = await this.getOrCreateDefaultContext(language);\n    }\n\n    // Create execution object to collect results\n    const execution = new Execution(code, context);\n\n    // Stream execution\n    await this.jupyterClient.runCodeStream(context.id, code, options.language, {\n      onStdout: (output) => {\n        execution.logs.stdout.push(output.text);\n        if (options.onStdout) return options.onStdout(output);\n      },\n      onStderr: (output) => {\n        execution.logs.stderr.push(output.text);\n        if (options.onStderr) return options.onStderr(output);\n      },\n      onResult: async (result) => {\n        execution.results.push(new ResultImpl(result) as any);\n        if (options.onResult) return options.onResult(result);\n      },\n      onError: (error) => {\n        execution.error = error;\n        if (options.onError) return options.onError(error);\n      },\n    });\n\n    return execution;\n  }\n\n  /**\n   * Run code and return a streaming response\n   */\n  async runCodeStream(\n    code: string,\n    options: RunCodeOptions = {}\n  ): Promise<ReadableStream> {\n    // Get or create context\n    let context = options.context;\n    if (!context) {\n      const language = options.language || \"python\";\n      context = await this.getOrCreateDefaultContext(language);\n    }\n\n    // Create streaming response\n    const response = await this.jupyterClient.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: context.id,\n        code,\n        language: options.language,\n      }),\n    });\n\n    if (!response.ok) {\n      const errorData = (await response\n        .json()\n        .catch(() => ({ error: \"Unknown error\" }))) as { error?: string };\n      throw new Error(\n        errorData.error || `Failed to execute code: ${response.status}`\n      );\n    }\n\n    if (!response.body) {\n      throw new Error(\"No response body for streaming execution\");\n    }\n\n    return response.body;\n  }\n\n  /**\n   * List all code contexts\n   */\n  async listCodeContexts(): Promise<CodeContext[]> {\n    const contexts = await this.jupyterClient.listCodeContexts();\n\n    // Update local cache\n    for (const context of contexts) {\n      this.contexts.set(context.id, context);\n    }\n\n    return contexts;\n  }\n\n  /**\n   * Delete a code context\n   */\n  async deleteCodeContext(contextId: string): Promise<void> {\n    await this.jupyterClient.deleteCodeContext(contextId);\n    this.contexts.delete(contextId);\n  }\n\n  private async getOrCreateDefaultContext(\n    language: \"python\" | \"javascript\" | \"typescript\"\n  ): Promise<CodeContext> {\n    // Check if we have a cached context for this language\n    for (const context of this.contexts.values()) {\n      if (context.language === language) {\n        return context;\n      }\n    }\n\n    // Create new default context\n    return this.createCodeContext({ language });\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/chunk-LALY4SFU.js.map

@@ -1 +0,0 @@
-{"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":[]}