@cloudflare/sandbox 0.2.0 → 0.2.1

package/dist/chunk-SYMWNYWA.js

@@ -0,0 +1,185 @@
+import {
+  HttpClient
+} from "./chunk-CUHYLCMT.js";
+
+// src/jupyter-client.ts
+var JupyterClient = class extends HttpClient {
+  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
+      })
+    });
+    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
+      })
+    });
+    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();
+    let buffer = "";
+    try {
+      while (true) {
+        const { done, value } = await reader.read();
+        if (value) {
+          buffer += new TextDecoder().decode(value);
+        }
+        if (done) break;
+        let newlineIdx = buffer.indexOf("\n");
+        while (newlineIdx !== -1) {
+          yield buffer.slice(0, newlineIdx);
+          buffer = buffer.slice(newlineIdx + 1);
+          newlineIdx = buffer.indexOf("\n");
+        }
+      }
+      if (buffer.length > 0) {
+        yield buffer;
+      }
+    } finally {
+      reader.releaseLock();
+    }
+  }
+  async parseExecutionResult(line, callbacks) {
+    if (!line.trim()) return;
+    try {
+      const data = JSON.parse(line);
+      switch (data.type) {
+        case "stdout":
+          if (callbacks.onStdout && data.text) {
+            await callbacks.onStdout({
+              text: data.text,
+              timestamp: data.timestamp || Date.now()
+            });
+          }
+          break;
+        case "stderr":
+          if (callbacks.onStderr && data.text) {
+            await callbacks.onStderr({
+              text: data.text,
+              timestamp: data.timestamp || Date.now()
+            });
+          }
+          break;
+        case "result":
+          if (callbacks.onResult) {
+            const result = {
+              text: data.text,
+              html: data.html,
+              png: data.png,
+              jpeg: data.jpeg,
+              svg: data.svg,
+              latex: data.latex,
+              markdown: data.markdown,
+              javascript: data.javascript,
+              json: data.json,
+              chart: data.chart,
+              data: data.data,
+              formats: () => {
+                const formats = [];
+                if (data.text) formats.push("text");
+                if (data.html) formats.push("html");
+                if (data.png) formats.push("png");
+                if (data.jpeg) formats.push("jpeg");
+                if (data.svg) formats.push("svg");
+                if (data.latex) formats.push("latex");
+                if (data.markdown) formats.push("markdown");
+                if (data.javascript) formats.push("javascript");
+                if (data.json) formats.push("json");
+                if (data.chart) formats.push("chart");
+                return formats;
+              }
+            };
+            await callbacks.onResult(result);
+          }
+          break;
+        case "error":
+          if (callbacks.onError) {
+            await callbacks.onError({
+              name: data.ename || "Error",
+              value: data.evalue || data.text || "Unknown error",
+              traceback: data.traceback || [],
+              lineNumber: data.lineNumber
+            });
+          }
+          break;
+        case "execution_complete":
+          break;
+      }
+    } catch (error) {
+      console.error("[JupyterClient] Error parsing execution result:", error);
+    }
+  }
+  async listCodeContexts() {
+    const response = await this.doFetch("/api/contexts", {
+      method: "GET",
+      headers: { "Content-Type": "application/json" }
+    });
+    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" }
+    });
+    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);
+  }
+};
+
+export {
+  JupyterClient
+};
+//# sourceMappingURL=chunk-SYMWNYWA.js.map

package/dist/chunk-SYMWNYWA.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/jupyter-client.ts"],"sourcesContent":["import { HttpClient } from './client.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\ninterface ErrorResponse {\n  error: string;\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?: any;\n  chart?: any;\n  data?: any;\n  metadata?: any;\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  async createCodeContext(options: CreateContextOptions = {}): Promise<CodeContext> {\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      const errorData = await response.json().catch(() => ({ error: 'Unknown error' })) as ErrorResponse;\n      throw new Error(errorData.error || `Failed to create context: ${response.status}`);\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  async runCodeStream(\n    contextId: string | undefined, \n    code: string, \n    language: string | undefined,\n    callbacks: ExecutionCallbacks\n  ): Promise<void> {\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      const errorData = await response.json().catch(() => ({ error: 'Unknown error' })) as ErrorResponse;\n      throw new Error(errorData.error || `Failed to execute code: ${response.status}`);\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  private async *readLines(stream: ReadableStream<Uint8Array>): 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(line: string, callbacks: ExecutionCallbacks) {\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    const response = await this.doFetch('/api/contexts', {\n      method: 'GET',\n      headers: { 'Content-Type': 'application/json' }\n    });\n    \n    if (!response.ok) {\n      const errorData = await response.json().catch(() => ({ error: 'Unknown error' })) as ErrorResponse;\n      throw new Error(errorData.error || `Failed to list contexts: ${response.status}`);\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  async deleteCodeContext(contextId: string): Promise<void> {\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      const errorData = await response.json().catch(() => ({ error: 'Unknown error' })) as ErrorResponse;\n      throw new Error(errorData.error || `Failed to delete context: ${response.status}`);\n    }\n  }\n  \n  // Override parent doFetch to be public for this class\n  public async doFetch(\n    path: string,\n    options?: RequestInit\n  ): Promise<Response> {\n    return super.doFetch(path, options);\n  }\n}"],"mappings":"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","names":[]}

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

@@ -1,12 +1,30 @@
 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>;
+    onStderr?: (output: OutputMessage) => void | Promise<void>;
+    onResult?: (result: Result) => void | Promise<void>;
+    onError?: (error: ExecutionError) => void | Promise<void>;
+}
+declare class JupyterClient extends HttpClient {
+    createCodeContext(options?: CreateContextOptions): Promise<CodeContext>;
+    runCodeStream(contextId: string | undefined, code: string, language: string | undefined, callbacks: ExecutionCallbacks): Promise<void>;
+    private readLines;
+    private parseExecutionResult;
+    listCodeContexts(): Promise<CodeContext[]>;
+    deleteCodeContext(contextId: string): Promise<void>;
+    doFetch(path: string, options?: RequestInit): Promise<Response>;
+}
+
 declare function getSandbox(ns: DurableObjectNamespace<Sandbox>, id: string): DurableObjectStub<Sandbox<unknown>>;
 declare class Sandbox<Env = unknown> extends Container<Env> implements ISandbox {
     defaultPort: number;
     sleepAfter: string;
-    client: HttpClient;
+    client: JupyterClient;
     private sandboxName;
+    private codeInterpreter;
     constructor(ctx: DurableObjectState, env: Env);
     setSandboxName(name: string): Promise<void>;
     setEnvVars(envVars: Record<string, string>): Promise<void>;
@@ -64,6 +82,26 @@ declare class Sandbox<Env = unknown> extends Container<Env> implements ISandbox
         exposedAt: string;
     }[]>;
     private constructPreviewUrl;
+    /**
+     * Create a new code execution context
+     */
+    createCodeContext(options?: CreateContextOptions): Promise<CodeContext>;
+    /**
+     * Run code with streaming callbacks
+     */
+    runCode(code: string, options?: RunCodeOptions): Promise<ExecutionResult>;
+    /**
+     * Run code and return a streaming response
+     */
+    runCodeStream(code: string, options?: RunCodeOptions): Promise<ReadableStream>;
+    /**
+     * List all code contexts
+     */
+    listCodeContexts(): Promise<CodeContext[]>;
+    /**
+     * Delete a code context
+     */
+    deleteCodeContext(contextId: string): Promise<void>;
 }
 
 interface ExecuteResponse {
@@ -166,8 +204,8 @@ declare class HttpClient {
     private options;
     private sessionId;
     constructor(options?: HttpClientOptions);
-    private doFetch;
-    execute(command: string, options: Pick<BaseExecOptions, 'sessionId' | 'cwd' | 'env'>): Promise<ExecuteResponse>;
+    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>;
@@ -208,4 +246,4 @@ declare class HttpClient {
     streamProcessLogs(processId: string): Promise<ReadableStream<Uint8Array>>;
 }
 
-export { type DeleteFileResponse as D, type ExecuteResponse as E, type GitCheckoutResponse as G, HttpClient as H, type MkdirResponse as M, type ReadFileResponse as R, Sandbox as S, type WriteFileResponse as W, type MoveFileResponse as a, type RenameFileResponse as b, getSandbox as g };
+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 };

package/dist/client.d.ts

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

package/dist/client.js

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

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-BXYlxy-j.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-C7rKCYBD.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';
 export { ExecEvent, LogEvent } from './types.js';

package/dist/index.js

@@ -2,16 +2,22 @@ import {
   Sandbox,
   getSandbox,
   proxyToSandbox
-} from "./chunk-ZJN2PQOS.js";
-import "./chunk-YVZ3K26G.js";
-import "./chunk-6UAWTJ5S.js";
+} from "./chunk-IATLC32Y.js";
 import {
   asyncIterableToSSEStream,
   parseSSEStream,
   responseToAsyncIterable
 } from "./chunk-NNGBXDMY.js";
-import "./chunk-6THNBO4S.js";
+import "./chunk-S5FFBU4Y.js";
+import "./chunk-FKBV7CZS.js";
+import {
+  ResultImpl
+} from "./chunk-EGC5IYXA.js";
+import "./chunk-SYMWNYWA.js";
+import "./chunk-CUHYLCMT.js";
+import "./chunk-6UAWTJ5S.js";
 export {
+  ResultImpl,
   Sandbox,
   asyncIterableToSSEStream,
   getSandbox,

package/dist/interpreter-types.d.ts

@@ -0,0 +1,259 @@
+interface CreateContextOptions {
+    /**
+     * Programming language for the context
+     * @default 'python'
+     */
+    language?: 'python' | 'javascript' | 'typescript';
+    /**
+     * Working directory for the context
+     * @default '/workspace'
+     */
+    cwd?: string;
+    /**
+     * Environment variables for the context
+     */
+    envVars?: Record<string, string>;
+    /**
+     * Request timeout in milliseconds
+     * @default 30000
+     */
+    timeout?: number;
+}
+interface CodeContext {
+    /**
+     * Unique identifier for the context
+     */
+    readonly id: string;
+    /**
+     * Programming language of the context
+     */
+    readonly language: string;
+    /**
+     * Current working directory
+     */
+    readonly cwd: string;
+    /**
+     * When the context was created
+     */
+    readonly createdAt: Date;
+    /**
+     * When the context was last used
+     */
+    readonly lastUsed: Date;
+}
+interface RunCodeOptions {
+    /**
+     * Context to run the code in. If not provided, uses default context for the language
+     */
+    context?: CodeContext;
+    /**
+     * Language to use if context is not provided
+     * @default 'python'
+     */
+    language?: 'python' | 'javascript' | 'typescript';
+    /**
+     * Environment variables for this execution
+     */
+    envVars?: Record<string, string>;
+    /**
+     * Execution timeout in milliseconds
+     * @default 60000
+     */
+    timeout?: number;
+    /**
+     * AbortSignal for cancelling execution
+     */
+    signal?: AbortSignal;
+    /**
+     * Callback for stdout output
+     */
+    onStdout?: (output: OutputMessage) => void | Promise<void>;
+    /**
+     * Callback for stderr output
+     */
+    onStderr?: (output: OutputMessage) => void | Promise<void>;
+    /**
+     * Callback for execution results (charts, tables, etc)
+     */
+    onResult?: (result: Result) => void | Promise<void>;
+    /**
+     * Callback for execution errors
+     */
+    onError?: (error: ExecutionError) => void | Promise<void>;
+}
+interface OutputMessage {
+    /**
+     * The output text
+     */
+    text: string;
+    /**
+     * Timestamp of the output
+     */
+    timestamp: number;
+}
+interface Result {
+    /**
+     * Plain text representation
+     */
+    text?: string;
+    /**
+     * HTML representation (tables, formatted output)
+     */
+    html?: string;
+    /**
+     * PNG image data (base64 encoded)
+     */
+    png?: string;
+    /**
+     * JPEG image data (base64 encoded)
+     */
+    jpeg?: string;
+    /**
+     * SVG image data
+     */
+    svg?: string;
+    /**
+     * LaTeX representation
+     */
+    latex?: string;
+    /**
+     * Markdown representation
+     */
+    markdown?: string;
+    /**
+     * JavaScript code to execute
+     */
+    javascript?: string;
+    /**
+     * JSON data
+     */
+    json?: any;
+    /**
+     * Chart data if the result is a visualization
+     */
+    chart?: ChartData;
+    /**
+     * Raw data object
+     */
+    data?: any;
+    /**
+     * Available output formats
+     */
+    formats(): string[];
+}
+interface ChartData {
+    /**
+     * Type of chart
+     */
+    type: 'line' | 'bar' | 'scatter' | 'pie' | 'histogram' | 'heatmap' | 'unknown';
+    /**
+     * Chart title
+     */
+    title?: string;
+    /**
+     * Chart data (format depends on library)
+     */
+    data: any;
+    /**
+     * Chart layout/configuration
+     */
+    layout?: any;
+    /**
+     * Additional configuration
+     */
+    config?: any;
+    /**
+     * Library that generated the chart
+     */
+    library?: 'matplotlib' | 'plotly' | 'altair' | 'seaborn' | 'unknown';
+    /**
+     * Base64 encoded image if available
+     */
+    image?: string;
+}
+interface ExecutionError {
+    /**
+     * Error name/type (e.g., 'NameError', 'SyntaxError')
+     */
+    name: string;
+    /**
+     * Error message
+     */
+    value: string;
+    /**
+     * Stack trace
+     */
+    traceback: string[];
+    /**
+     * Line number where error occurred
+     */
+    lineNumber?: number;
+}
+interface ExecutionResult {
+    code: string;
+    logs: {
+        stdout: string[];
+        stderr: string[];
+    };
+    error?: ExecutionError;
+    executionCount?: number;
+    results: Array<{
+        text?: string;
+        html?: string;
+        png?: string;
+        jpeg?: string;
+        svg?: string;
+        latex?: string;
+        markdown?: string;
+        javascript?: string;
+        json?: any;
+        chart?: ChartData;
+        data?: any;
+    }>;
+}
+declare class Execution {
+    readonly code: string;
+    readonly context: CodeContext;
+    /**
+     * All results from the execution
+     */
+    results: Result[];
+    /**
+     * Accumulated stdout and stderr
+     */
+    logs: {
+        stdout: string[];
+        stderr: string[];
+    };
+    /**
+     * Execution error if any
+     */
+    error?: ExecutionError;
+    /**
+     * Execution count (for Jupyter)
+     */
+    executionCount?: number;
+    constructor(code: string, context: CodeContext);
+    /**
+     * Convert to a plain object for serialization
+     */
+    toJSON(): ExecutionResult;
+}
+declare class ResultImpl implements Result {
+    private raw;
+    constructor(raw: any);
+    get text(): string | undefined;
+    get html(): string | undefined;
+    get png(): string | undefined;
+    get jpeg(): string | undefined;
+    get svg(): string | undefined;
+    get latex(): string | undefined;
+    get markdown(): string | undefined;
+    get javascript(): string | undefined;
+    get json(): any;
+    get chart(): ChartData | undefined;
+    get data(): any;
+    formats(): string[];
+}
+
+export { type ChartData, type CodeContext, type CreateContextOptions, Execution, type ExecutionError, type ExecutionResult, type OutputMessage, type Result, ResultImpl, type RunCodeOptions };

package/dist/interpreter-types.js

@@ -0,0 +1,9 @@
+import {
+  Execution,
+  ResultImpl
+} from "./chunk-EGC5IYXA.js";
+export {
+  Execution,
+  ResultImpl
+};
+//# sourceMappingURL=interpreter-types.js.map

package/dist/interpreter-types.js.map

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

package/dist/interpreter.d.ts

@@ -0,0 +1,33 @@
+import { CreateContextOptions, CodeContext, RunCodeOptions, Execution } from './interpreter-types.js';
+import { S as Sandbox } from './client-C7rKCYBD.js';
+import '@cloudflare/containers';
+import './types.js';
+
+declare class CodeInterpreter {
+    private jupyterClient;
+    private contexts;
+    constructor(sandbox: Sandbox);
+    /**
+     * Create a new code execution context
+     */
+    createCodeContext(options?: CreateContextOptions): Promise<CodeContext>;
+    /**
+     * Run code with optional context
+     */
+    runCode(code: string, options?: RunCodeOptions): Promise<Execution>;
+    /**
+     * Run code and return a streaming response
+     */
+    runCodeStream(code: string, options?: RunCodeOptions): Promise<ReadableStream>;
+    /**
+     * List all code contexts
+     */
+    listCodeContexts(): Promise<CodeContext[]>;
+    /**
+     * Delete a code context
+     */
+    deleteCodeContext(contextId: string): Promise<void>;
+    private getOrCreateDefaultContext;
+}
+
+export { CodeInterpreter };

package/dist/interpreter.js

@@ -0,0 +1,8 @@
+import {
+  CodeInterpreter
+} from "./chunk-FKBV7CZS.js";
+import "./chunk-EGC5IYXA.js";
+export {
+  CodeInterpreter
+};
+//# sourceMappingURL=interpreter.js.map

package/dist/interpreter.js.map

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

package/dist/jupyter-client.d.ts

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

package/dist/jupyter-client.js

@@ -0,0 +1,8 @@
+import {
+  JupyterClient
+} from "./chunk-SYMWNYWA.js";
+import "./chunk-CUHYLCMT.js";
+export {
+  JupyterClient
+};
+//# sourceMappingURL=jupyter-client.js.map

package/dist/jupyter-client.js.map

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