CodeInterpreterClient

Source: src/services/code-interpreter.ts

Signature

CodeInterpreterClient(transport: Leap0Transport)

Overview

Talks to the sandbox-hosted code interpreter service.

Throws

• Leap0Error: If API calls, stream decoding, or response validation fail.

Methods

health

async health(sandbox: SandboxRef, options: RequestOptions = {}): Promise<boolean>

Returns whether the code interpreter service is healthy.

Parameters

• sandbox: Sandbox ID or sandbox-like object.
• options: Optional request settings such as timeout and query params.

Returns

• Whether the code interpreter reports a healthy status.

createContext

async createContext(sandbox: SandboxRef, language: CodeLanguage = "python" as CodeLanguage, cwd?: string, options: RequestOptions = {}): Promise<CodeContext>

Creates a reusable interpreter context.

Parameters

• sandbox: Sandbox ID or sandbox-like object.
• language: Interpreter language for the context.
• cwd: Optional working directory.
• options: Optional request settings such as timeout and query params.

Returns

• The created interpreter context.

listContexts

async listContexts(sandbox: SandboxRef, options: RequestOptions = {}): Promise<CodeContext[]>

Lists active interpreter contexts.

Parameters

• sandbox: Sandbox ID or sandbox-like object.
• options: Optional request settings such as timeout and query params.

Returns

• The active interpreter contexts.

getContext

async getContext(sandbox: SandboxRef, contextId: string, options: RequestOptions = {}): Promise<CodeContext>

Fetches a single interpreter context by ID.

Parameters

• sandbox: Sandbox ID or sandbox-like object.
• contextId: Interpreter context ID.
• options: Optional request settings such as timeout and query params.

Returns

• The requested interpreter context.

deleteContext

async deleteContext(sandbox: SandboxRef, contextId: string, options: RequestOptions = {}): Promise<void>

Deletes an interpreter context by ID.

Parameters

• sandbox: Sandbox ID or sandbox-like object.
• contextId: Interpreter context ID.
• options: Optional request settings such as timeout and query params.

execute

async execute(sandbox: SandboxRef, params: { code: string; language?: CodeLanguage; contextId?: string; envVars?: Record<string, string>; timeoutMs?: number; }, options: RequestOptions = {}): Promise<CodeExecutionResult>

Executes code and waits for the final result.

Parameters

• sandbox: Sandbox ID or sandbox-like object.
• params: Execution parameters.
• params.code: Source code to execute.
• params.language: Optional interpreter language.
• params.contextId: Optional existing context ID to reuse.
• params.envVars: Optional environment variables for execution.
• params.timeoutMs: Optional execution timeout in milliseconds.
• options: Optional request settings such as timeout and query params.

Returns

• The completed execution result.

Examples

const result = await sandbox.codeInterpreter.execute({
  language: "python",
  code: "print('hello')",
});

executeStream

async executeStream(sandbox: SandboxRef, params: { code: string; language?: CodeLanguage; contextId?: string; timeoutMs?: number; }, options: RequestOptions = {}): AsyncIterable<StreamEvent>

Streams code execution events until the interpreter exits.

Parameters

• sandbox: Sandbox ID or sandbox-like object.
• params: Stream execution parameters.
• params.code: Source code to execute.
• params.language: Optional interpreter language.
• params.contextId: Optional existing context ID to reuse.
• params.timeoutMs: Optional execution timeout in milliseconds.
• options: Optional request settings such as timeout and query params.

Throws

• Leap0Error: If the stream returns malformed events or reports an execution error.

Examples

for await (const event of sandbox.codeInterpreter.executeStream({
  language: "python",
  code: "print('hello')",
})) {
  console.log(event);
}