@cloudflare/sandbox 0.2.0 → 0.2.2

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

package/dist/index.js

@@ -2,19 +2,49 @@ import {
   Sandbox,
   getSandbox,
   proxyToSandbox
-} from "./chunk-ZJN2PQOS.js";
-import "./chunk-YVZ3K26G.js";
+} from "./chunk-ZMPO44U4.js";
 import "./chunk-6UAWTJ5S.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-VTKZL632.js";
+import "./chunk-CUHYLCMT.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-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-bzEV222a.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-bzEV222a.js';
+import './interpreter-types.js';
+import '@cloudflare/containers';
+import './types.js';

package/dist/jupyter-client.js

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

package/dist/jupyter-client.js.map

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

package/dist/request-handler.d.ts

@@ -1,5 +1,6 @@
-import { S as Sandbox } from './client-BXYlxy-j.js';
+import { S as Sandbox } from './client-bzEV222a.js';
 import '@cloudflare/containers';
+import './interpreter-types.js';
 import './types.js';
 
 interface SandboxEnv {

package/dist/request-handler.js

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

package/dist/sandbox.d.ts

@@ -1,3 +1,4 @@
-export { S as Sandbox, g as getSandbox } from './client-BXYlxy-j.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,10 +1,15 @@
 import {
   Sandbox,
   getSandbox
-} from "./chunk-ZJN2PQOS.js";
-import "./chunk-YVZ3K26G.js";
+} from "./chunk-ZMPO44U4.js";
 import "./chunk-6UAWTJ5S.js";
-import "./chunk-6THNBO4S.js";
+import "./chunk-NNGBXDMY.js";
+import "./chunk-S5FFBU4Y.js";
+import "./chunk-FKBV7CZS.js";
+import "./chunk-EGC5IYXA.js";
+import "./chunk-VTKZL632.js";
+import "./chunk-CUHYLCMT.js";
+import "./chunk-LALY4SFU.js";
 export {
   Sandbox,
   getSandbox

package/dist/types.d.ts

@@ -1,3 +1,5 @@
+import { CreateContextOptions, CodeContext, RunCodeOptions, ExecutionResult } from './interpreter-types.js';
+
 interface BaseExecOptions {
     /**
      * Session ID for grouping related commands
@@ -260,6 +262,7 @@ interface GetProcessLogsResponse {
     stderr: string;
     processId: string;
 }
+
 interface ISandbox {
     exec(command: string, options?: ExecOptions): Promise<ExecResult>;
     startProcess(command: string, options?: ProcessOptions): Promise<Process>;
@@ -276,6 +279,11 @@ interface ISandbox {
         stdout: string;
         stderr: string;
     }>;
+    createCodeContext(options?: CreateContextOptions): Promise<CodeContext>;
+    runCode(code: string, options?: RunCodeOptions): Promise<ExecutionResult>;
+    runCodeStream(code: string, options?: RunCodeOptions): Promise<ReadableStream>;
+    listCodeContexts(): Promise<CodeContext[]>;
+    deleteCodeContext(contextId: string): Promise<void>;
 }
 declare function isExecResult(value: any): value is ExecResult;
 declare function isProcess(value: any): value is Process;

package/dist/types.js

@@ -6,7 +6,7 @@ import {
   isExecResult,
   isProcess,
   isProcessStatus
-} from "./chunk-6THNBO4S.js";
+} from "./chunk-S5FFBU4Y.js";
 export {
   ExecutionTimeoutError,
   ProcessAlreadyExistsError,

package/package.json

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