agentkernel 0.8.0 → 0.9.0

package/README.md

@@ -37,6 +37,105 @@ console.log(result.output);
 // sandbox auto-removed when scope exits
 ```
 
+## Exec Options
+
+Run commands with a working directory, environment variables, or as root:
+
+```typescript
+const result = await client.execInSandbox("my-sandbox", ["npm", "start"], {
+  workdir: "/app",
+  env: ["NODE_ENV=production"],
+  sudo: true,
+});
+```
+
+Works on sandbox sessions too:
+
+```typescript
+await using sb = await client.sandbox("dev");
+await sb.run(["pip", "install", "-r", "requirements.txt"], {
+  workdir: "/app",
+  sudo: true,
+});
+```
+
+## Git Source Cloning
+
+Clone a git repo into the sandbox at creation time:
+
+```typescript
+const sb = await client.createSandbox("my-project", {
+  image: "node:20-alpine",
+  source_url: "https://github.com/user/repo.git",
+  source_ref: "main",
+});
+```
+
+## Persistent Volumes
+
+Mount volumes that persist across sandbox restarts:
+
+```typescript
+// First create volumes via CLI: agentkernel volume create mydata
+
+const sb = await client.createSandbox("my-project", {
+  image: "node:20-alpine",
+  volumes: ["mydata:/data", "cache:/tmp/cache:ro"],
+});
+
+// Data in /data persists across sandbox restarts
+await sb.run(["sh", "-c", "echo hello > /data/test.txt"]);
+```
+
+## File Operations
+
+Read, write, and delete files in a sandbox:
+
+```typescript
+// Write a file
+await client.writeFile("my-sandbox", "app/main.py", "print('hello')");
+
+// Read a file
+const file = await client.readFile("my-sandbox", "app/main.py");
+console.log(file.content);
+
+// Delete a file
+await client.deleteFile("my-sandbox", "app/main.py");
+
+// Batch write multiple files at once
+await client.writeFiles("my-sandbox", {
+  "/app/index.js": "console.log('hi')",
+  "/app/package.json": '{"name":"app"}',
+});
+```
+
+## Detached Commands
+
+Run long-lived processes in the background and retrieve their output later:
+
+```typescript
+// Start a background process
+const cmd = await client.execDetached("my-sandbox", ["python3", "train.py"]);
+console.log(`Started: ${cmd.id} (pid ${cmd.pid})`);
+
+// Check status
+const status = await client.detachedStatus("my-sandbox", cmd.id);
+console.log(status.status); // "running" | "completed" | "failed"
+
+// Get logs
+const logs = await client.detachedLogs("my-sandbox", cmd.id);
+console.log(logs.stdout);
+
+// Get stderr only
+const stderr = await client.detachedLogs("my-sandbox", cmd.id, "stderr");
+
+// List all detached commands
+const all = await client.detachedList("my-sandbox");
+
+// Kill a running command
+await client.detachedKill("my-sandbox", cmd.id);
+```
+
 ## Streaming
 
 ```typescript
@@ -91,7 +190,7 @@ List all sandboxes.
 
 ### `client.createSandbox(name, options?)`
 
-Create a new sandbox.
+Create a new sandbox. Options: `image`, `vcpus`, `memory_mb`, `profile`, `source_url`, `source_ref`, `volumes`.
 
 ### `client.getSandbox(name)`
 
@@ -101,9 +200,45 @@ Get sandbox info.
 
 Remove a sandbox.
 
-### `client.execInSandbox(name, command)`
+### `client.execInSandbox(name, command, options?)`
+
+Run a command in an existing sandbox. Options: `env`, `workdir`, `sudo`.
+
+### `client.readFile(name, path)`
+
+Read a file from a sandbox.
+
+### `client.writeFile(name, path, content, options?)`
+
+Write a file to a sandbox.
+
+### `client.deleteFile(name, path)`
+
+Delete a file from a sandbox.
+
+### `client.writeFiles(name, files)`
+
+Write multiple files to a sandbox in one request. `files` is a `Record<string, string>` of path to content.
+
+### `client.execDetached(name, command, options?)`
+
+Start a detached (background) command. Returns a `DetachedCommand`.
+
+### `client.detachedStatus(name, cmdId)`
+
+Get the status of a detached command.
+
+### `client.detachedLogs(name, cmdId, stream?)`
+
+Get stdout/stderr from a detached command. Pass `"stderr"` to get only stderr.
+
+### `client.detachedKill(name, cmdId)`
+
+Kill a detached command.
+
+### `client.detachedList(name)`
 
-Run a command in an existing sandbox.
+List all detached commands in a sandbox.
 
 ### `client.sandbox(name, options?)`
 

package/dist/index.cjs

@@ -120,21 +120,27 @@ var SandboxSession = class {
   _execInSandbox;
   _removeSandbox;
   _getSandbox;
+  _writeFiles;
   /** @internal */
-  constructor(name, execInSandbox, removeSandbox, getSandbox) {
+  constructor(name, execInSandbox, removeSandbox, getSandbox, writeFiles) {
     this.name = name;
     this._execInSandbox = execInSandbox;
     this._removeSandbox = removeSandbox;
     this._getSandbox = getSandbox;
+    this._writeFiles = writeFiles;
   }
   /** Run a command in this sandbox. */
-  async run(command) {
-    return this._execInSandbox(this.name, command);
+  async run(command, opts) {
+    return this._execInSandbox(this.name, command, opts);
   }
   /** Get sandbox info. */
   async info() {
     return this._getSandbox(this.name);
   }
+  /** Write multiple files in one request. */
+  async writeFiles(files) {
+    return this._writeFiles(this.name, files);
+  }
   /** Remove the sandbox. Idempotent. */
   async remove() {
     if (this._removed) return;
@@ -285,7 +291,9 @@ var AgentKernel = class {
       image: opts?.image,
       vcpus: opts?.vcpus,
       memory_mb: opts?.memory_mb,
-      profile: opts?.profile
+      profile: opts?.profile,
+      source_url: opts?.source_url,
+      source_ref: opts?.source_ref
     });
   }
   /** Get info about a sandbox. */
@@ -297,11 +305,16 @@ var AgentKernel = class {
     await this.request("DELETE", `/sandboxes/${encodeURIComponent(name)}`);
   }
   /** Run a command in an existing sandbox. */
-  async execInSandbox(name, command) {
+  async execInSandbox(name, command, opts) {
     return this.request(
       "POST",
       `/sandboxes/${encodeURIComponent(name)}/exec`,
-      { command }
+      {
+        command,
+        env: opts?.env,
+        workdir: opts?.workdir,
+        sudo: opts?.sudo
+      }
     );
   }
   /** Read a file from a sandbox. */
@@ -333,10 +346,60 @@ var AgentKernel = class {
       `/sandboxes/${encodeURIComponent(name)}/logs`
     );
   }
+  /** Write multiple files to a sandbox in one request. */
+  async writeFiles(name, files) {
+    return this.request(
+      "POST",
+      `/sandboxes/${encodeURIComponent(name)}/files`,
+      { files }
+    );
+  }
   /** Run multiple commands in parallel. */
   async batchRun(commands) {
     return this.request("POST", "/batch/run", { commands });
   }
+  /** Start a detached (background) command in a sandbox. */
+  async execDetached(name, command, opts) {
+    return this.request(
+      "POST",
+      `/sandboxes/${encodeURIComponent(name)}/exec/detach`,
+      {
+        command,
+        env: opts?.env,
+        workdir: opts?.workdir,
+        sudo: opts?.sudo
+      }
+    );
+  }
+  /** Get the status of a detached command. */
+  async detachedStatus(name, cmdId) {
+    return this.request(
+      "GET",
+      `/sandboxes/${encodeURIComponent(name)}/exec/detached/${encodeURIComponent(cmdId)}`
+    );
+  }
+  /** Get logs from a detached command. */
+  async detachedLogs(name, cmdId, stream) {
+    const query = stream === "stderr" ? "?stream=stderr" : "";
+    return this.request(
+      "GET",
+      `/sandboxes/${encodeURIComponent(name)}/exec/detached/${encodeURIComponent(cmdId)}/logs${query}`
+    );
+  }
+  /** Kill a detached command. */
+  async detachedKill(name, cmdId) {
+    return this.request(
+      "DELETE",
+      `/sandboxes/${encodeURIComponent(name)}/exec/detached/${encodeURIComponent(cmdId)}`
+    );
+  }
+  /** List detached commands in a sandbox. */
+  async detachedList(name) {
+    return this.request(
+      "GET",
+      `/sandboxes/${encodeURIComponent(name)}/exec/detached`
+    );
+  }
   /**
    * Create a sandbox session with automatic cleanup.
    *
@@ -354,9 +417,10 @@ var AgentKernel = class {
     await this.createSandbox(name, opts);
     return new SandboxSession(
       name,
-      (n, cmd) => this.execInSandbox(n, cmd),
+      (n, cmd, o) => this.execInSandbox(n, cmd, o),
       (n) => this.removeSandbox(n),
-      (n) => this.getSandbox(n)
+      (n) => this.getSandbox(n),
+      (n, f) => this.writeFiles(n, f)
     );
   }
   // -- Internal helpers --

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts","../src/config.ts","../src/errors.ts","../src/sandbox.ts","../src/sse.ts","../src/client.ts"],"sourcesContent":["export { AgentKernel } from \"./client.js\";\nexport { SandboxSession } from \"./sandbox.js\";\nexport {\n  AgentKernelError,\n  AuthError,\n  NotFoundError,\n  ValidationError,\n  ServerError,\n  NetworkError,\n  StreamError,\n} from \"./errors.js\";\nexport type {\n  AgentKernelOptions,\n  RunOptions,\n  CreateSandboxOptions,\n  RunOutput,\n  SandboxInfo,\n  StreamEvent,\n  StreamEventType,\n  SecurityProfile,\n  SandboxStatus,\n  ApiResponse,\n} from \"./types.js\";\n","import type { AgentKernelOptions } from \"./types.js\";\n\nconst DEFAULT_BASE_URL = \"http://localhost:18888\";\nconst DEFAULT_TIMEOUT = 30_000;\n\n/** Resolve configuration from constructor args, env vars, and defaults. */\nexport function resolveConfig(opts?: AgentKernelOptions) {\n  const baseUrl =\n    opts?.baseUrl ??\n    process.env.AGENTKERNEL_BASE_URL ??\n    DEFAULT_BASE_URL;\n\n  const apiKey =\n    opts?.apiKey ??\n    process.env.AGENTKERNEL_API_KEY ??\n    undefined;\n\n  const timeout = opts?.timeout ?? DEFAULT_TIMEOUT;\n\n  return {\n    baseUrl: baseUrl.replace(/\\/+$/, \"\"),\n    apiKey,\n    timeout,\n  };\n}\n","/** Base error for all agentkernel SDK errors. */\nexport class AgentKernelError extends Error {\n  constructor(message: string) {\n    super(message);\n    this.name = \"AgentKernelError\";\n  }\n}\n\n/** 401 Unauthorized. */\nexport class AuthError extends AgentKernelError {\n  readonly status = 401;\n  constructor(message = \"Unauthorized\") {\n    super(message);\n    this.name = \"AuthError\";\n  }\n}\n\n/** 404 Not Found. */\nexport class NotFoundError extends AgentKernelError {\n  readonly status = 404;\n  constructor(message = \"Not found\") {\n    super(message);\n    this.name = \"NotFoundError\";\n  }\n}\n\n/** 400 Bad Request. */\nexport class ValidationError extends AgentKernelError {\n  readonly status = 400;\n  constructor(message = \"Bad request\") {\n    super(message);\n    this.name = \"ValidationError\";\n  }\n}\n\n/** 500 Internal Server Error. */\nexport class ServerError extends AgentKernelError {\n  readonly status = 500;\n  constructor(message = \"Internal server error\") {\n    super(message);\n    this.name = \"ServerError\";\n  }\n}\n\n/** Network / connection error. */\nexport class NetworkError extends AgentKernelError {\n  constructor(message = \"Network error\") {\n    super(message);\n    this.name = \"NetworkError\";\n  }\n}\n\n/** SSE streaming error. */\nexport class StreamError extends AgentKernelError {\n  constructor(message = \"Stream error\") {\n    super(message);\n    this.name = \"StreamError\";\n  }\n}\n\n/** Map an HTTP status code + body to the appropriate error. */\nexport function errorFromStatus(status: number, body: string): AgentKernelError {\n  let message: string;\n  try {\n    const parsed = JSON.parse(body);\n    message = parsed.error ?? body;\n  } catch {\n    message = body;\n  }\n\n  switch (status) {\n    case 400:\n      return new ValidationError(message);\n    case 401:\n      return new AuthError(message);\n    case 404:\n      return new NotFoundError(message);\n    default:\n      return new ServerError(message);\n  }\n}\n","import type { RunOutput, SandboxInfo } from \"./types.js\";\n\ntype ExecFn = (name: string, command: string[]) => Promise<RunOutput>;\ntype RemoveFn = (name: string) => Promise<void>;\ntype GetFn = (name: string) => Promise<SandboxInfo>;\n\n/**\n * A sandbox session that auto-removes the sandbox on dispose.\n *\n * Supports both explicit cleanup via remove() and automatic cleanup via\n * Symbol.asyncDispose (TS 5.2+ `await using`).\n *\n * @example\n * ```ts\n * await using sb = await client.sandbox(\"test\");\n * await sb.exec([\"echo\", \"hello\"]);\n * // sandbox auto-removed when scope exits\n * ```\n */\nexport class SandboxSession implements AsyncDisposable {\n  readonly name: string;\n  private _removed = false;\n  private readonly _execInSandbox: ExecFn;\n  private readonly _removeSandbox: RemoveFn;\n  private readonly _getSandbox: GetFn;\n\n  /** @internal */\n  constructor(\n    name: string,\n    execInSandbox: ExecFn,\n    removeSandbox: RemoveFn,\n    getSandbox: GetFn,\n  ) {\n    this.name = name;\n    this._execInSandbox = execInSandbox;\n    this._removeSandbox = removeSandbox;\n    this._getSandbox = getSandbox;\n  }\n\n  /** Run a command in this sandbox. */\n  async run(command: string[]): Promise<RunOutput> {\n    return this._execInSandbox(this.name, command);\n  }\n\n  /** Get sandbox info. */\n  async info(): Promise<SandboxInfo> {\n    return this._getSandbox(this.name);\n  }\n\n  /** Remove the sandbox. Idempotent. */\n  async remove(): Promise<void> {\n    if (this._removed) return;\n    this._removed = true;\n    await this._removeSandbox(this.name);\n  }\n\n  /** Auto-cleanup for `await using`. */\n  async [Symbol.asyncDispose](): Promise<void> {\n    await this.remove();\n  }\n}\n","import { createParser, type EventSourceMessage } from \"eventsource-parser\";\nimport type { StreamEvent, StreamEventType } from \"./types.js\";\n\nconst KNOWN_EVENTS = new Set<string>([\"started\", \"progress\", \"output\", \"done\", \"error\"]);\n\n/** Shared mutable state between the pump and the generator. */\ninterface PumpState {\n  events: StreamEvent[];\n  resolve: (() => void) | null;\n  done: boolean;\n}\n\nfunction pushEvent(state: PumpState, event: StreamEvent): void {\n  state.events.push(event);\n  if (state.resolve) {\n    const cb = state.resolve;\n    state.resolve = null;\n    cb();\n  }\n}\n\n/**\n * Parse an SSE response body into an async generator of StreamEvents.\n *\n * Consumes a ReadableStream<Uint8Array> from fetch() and yields typed events\n * until the stream closes or a \"done\"/\"error\" event is received.\n */\nexport async function* parseSSE(\n  body: ReadableStream<Uint8Array>,\n): AsyncGenerator<StreamEvent> {\n  const reader = body.getReader();\n  const decoder = new TextDecoder();\n  const state: PumpState = { events: [], resolve: null, done: false };\n\n  const parser = createParser({\n    onEvent(event: EventSourceMessage) {\n      const type = event.event ?? \"message\";\n      if (!KNOWN_EVENTS.has(type)) return;\n\n      let data: Record<string, unknown>;\n      try {\n        data = JSON.parse(event.data);\n      } catch {\n        data = { raw: event.data };\n      }\n\n      pushEvent(state, { type: type as StreamEventType, data });\n    },\n  });\n\n  // Read the stream in the background\n  const pump = (async () => {\n    try {\n      for (;;) {\n        const result = await reader.read();\n        if (result.done) break;\n        parser.feed(decoder.decode(result.value, { stream: true }));\n      }\n    } catch (err) {\n      pushEvent(state, {\n        type: \"error\",\n        data: { message: err instanceof Error ? err.message : String(err) },\n      });\n    } finally {\n      state.done = true;\n      if (state.resolve) {\n        const cb = state.resolve;\n        state.resolve = null;\n        cb();\n      }\n    }\n  })();\n\n  try {\n    for (;;) {\n      // Yield all buffered events\n      while (state.events.length > 0) {\n        const event = state.events.shift()!;\n        yield event;\n        if (event.type === \"done\" || event.type === \"error\") return;\n      }\n\n      // If the stream is done and no more events, exit\n      if (state.done) return;\n\n      // Wait for the next event\n      await new Promise<void>((r) => {\n        state.resolve = r;\n      });\n    }\n  } finally {\n    reader.cancel().catch(() => {});\n    await pump.catch(() => {});\n  }\n}\n","import { resolveConfig } from \"./config.js\";\nimport {\n  AgentKernelError,\n  NetworkError,\n  errorFromStatus,\n} from \"./errors.js\";\nimport { SandboxSession } from \"./sandbox.js\";\nimport { parseSSE } from \"./sse.js\";\nimport type {\n  AgentKernelOptions,\n  ApiResponse,\n  BatchCommand,\n  BatchRunResponse,\n  CreateSandboxOptions,\n  FileReadResponse,\n  FileWriteOptions,\n  RunOptions,\n  RunOutput,\n  SandboxInfo,\n  StreamEvent,\n} from \"./types.js\";\n\nconst SDK_VERSION = \"0.4.0\";\n\n/**\n * Client for the agentkernel HTTP API.\n *\n * @example\n * ```ts\n * const client = new AgentKernel();\n * const result = await client.run([\"echo\", \"hello\"]);\n * console.log(result.output); // \"hello\\n\"\n * ```\n */\nexport class AgentKernel {\n  private readonly baseUrl: string;\n  private readonly apiKey: string | undefined;\n  private readonly timeout: number;\n\n  constructor(opts?: AgentKernelOptions) {\n    const config = resolveConfig(opts);\n    this.baseUrl = config.baseUrl;\n    this.apiKey = config.apiKey;\n    this.timeout = config.timeout;\n  }\n\n  // -- Core API methods --\n\n  /** Health check. Returns \"ok\" if the server is running. */\n  async health(): Promise<string> {\n    const res = await this.request<string>(\"GET\", \"/health\");\n    return res;\n  }\n\n  /** Run a command in a temporary sandbox. */\n  async run(command: string[], opts?: RunOptions): Promise<RunOutput> {\n    return this.request<RunOutput>(\"POST\", \"/run\", {\n      command,\n      image: opts?.image,\n      profile: opts?.profile,\n      fast: opts?.fast ?? true,\n    });\n  }\n\n  /**\n   * Run a command with SSE streaming output.\n   *\n   * @example\n   * ```ts\n   * for await (const event of client.runStream([\"python3\", \"script.py\"])) {\n   *   if (event.type === \"output\") process.stdout.write(String(event.data.data));\n   * }\n   * ```\n   */\n  async *runStream(\n    command: string[],\n    opts?: RunOptions,\n  ): AsyncGenerator<StreamEvent> {\n    const body = JSON.stringify({\n      command,\n      image: opts?.image,\n      profile: opts?.profile,\n      fast: opts?.fast ?? true,\n    });\n\n    const response = await this.fetch(\"/run/stream\", {\n      method: \"POST\",\n      headers: this.headers(\"application/json\"),\n      body,\n    });\n\n    if (!response.ok) {\n      const text = await response.text();\n      throw errorFromStatus(response.status, text);\n    }\n\n    if (!response.body) {\n      throw new AgentKernelError(\"No response body for SSE stream\");\n    }\n\n    yield* parseSSE(response.body);\n  }\n\n  /** List all sandboxes. */\n  async listSandboxes(): Promise<SandboxInfo[]> {\n    return this.request<SandboxInfo[]>(\"GET\", \"/sandboxes\");\n  }\n\n  /** Create a new sandbox. */\n  async createSandbox(\n    name: string,\n    opts?: CreateSandboxOptions,\n  ): Promise<SandboxInfo> {\n    return this.request<SandboxInfo>(\"POST\", \"/sandboxes\", {\n      name,\n      image: opts?.image,\n      vcpus: opts?.vcpus,\n      memory_mb: opts?.memory_mb,\n      profile: opts?.profile,\n    });\n  }\n\n  /** Get info about a sandbox. */\n  async getSandbox(name: string): Promise<SandboxInfo> {\n    return this.request<SandboxInfo>(\"GET\", `/sandboxes/${encodeURIComponent(name)}`);\n  }\n\n  /** Remove a sandbox. */\n  async removeSandbox(name: string): Promise<void> {\n    await this.request<string>(\"DELETE\", `/sandboxes/${encodeURIComponent(name)}`);\n  }\n\n  /** Run a command in an existing sandbox. */\n  async execInSandbox(name: string, command: string[]): Promise<RunOutput> {\n    return this.request<RunOutput>(\n      \"POST\",\n      `/sandboxes/${encodeURIComponent(name)}/exec`,\n      { command },\n    );\n  }\n\n  /** Read a file from a sandbox. */\n  async readFile(name: string, path: string): Promise<FileReadResponse> {\n    return this.request<FileReadResponse>(\n      \"GET\",\n      `/sandboxes/${encodeURIComponent(name)}/files/${path}`,\n    );\n  }\n\n  /** Write a file to a sandbox. */\n  async writeFile(\n    name: string,\n    path: string,\n    content: string,\n    opts?: FileWriteOptions,\n  ): Promise<string> {\n    return this.request<string>(\n      \"PUT\",\n      `/sandboxes/${encodeURIComponent(name)}/files/${path}`,\n      { content, encoding: opts?.encoding ?? \"utf8\" },\n    );\n  }\n\n  /** Delete a file from a sandbox. */\n  async deleteFile(name: string, path: string): Promise<string> {\n    return this.request<string>(\n      \"DELETE\",\n      `/sandboxes/${encodeURIComponent(name)}/files/${path}`,\n    );\n  }\n\n  /** Get audit log entries for a sandbox. */\n  async getSandboxLogs(name: string): Promise<Record<string, unknown>[]> {\n    return this.request<Record<string, unknown>[]>(\n      \"GET\",\n      `/sandboxes/${encodeURIComponent(name)}/logs`,\n    );\n  }\n\n  /** Run multiple commands in parallel. */\n  async batchRun(commands: BatchCommand[]): Promise<BatchRunResponse> {\n    return this.request<BatchRunResponse>(\"POST\", \"/batch/run\", { commands });\n  }\n\n  /**\n   * Create a sandbox session with automatic cleanup.\n   *\n   * The returned SandboxSession implements AsyncDisposable,\n   * so it works with `await using` (TS 5.2+):\n   *\n   * @example\n   * ```ts\n   * await using sb = await client.sandbox(\"test\", { image: \"python:3.12-alpine\" });\n   * await sb.run([\"pip\", \"install\", \"numpy\"]);\n   * // sandbox auto-removed when scope exits\n   * ```\n   */\n  async sandbox(\n    name: string,\n    opts?: CreateSandboxOptions,\n  ): Promise<SandboxSession> {\n    await this.createSandbox(name, opts);\n    return new SandboxSession(\n      name,\n      (n, cmd) => this.execInSandbox(n, cmd),\n      (n) => this.removeSandbox(n),\n      (n) => this.getSandbox(n),\n    );\n  }\n\n  // -- Internal helpers --\n\n  private headers(contentType?: string): Record<string, string> {\n    const h: Record<string, string> = {\n      \"User-Agent\": `agentkernel-nodejs-sdk/${SDK_VERSION}`,\n    };\n    if (contentType) h[\"Content-Type\"] = contentType;\n    if (this.apiKey) h[\"Authorization\"] = `Bearer ${this.apiKey}`;\n    return h;\n  }\n\n  private async fetch(path: string, init: RequestInit): Promise<Response> {\n    const url = `${this.baseUrl}${path}`;\n    try {\n      return await fetch(url, {\n        ...init,\n        signal: AbortSignal.timeout(this.timeout),\n      });\n    } catch (err) {\n      if (err instanceof DOMException && err.name === \"TimeoutError\") {\n        throw new NetworkError(`Request timed out after ${this.timeout}ms`);\n      }\n      if (err instanceof TypeError) {\n        throw new NetworkError(`Failed to connect to ${this.baseUrl}: ${err.message}`);\n      }\n      throw new NetworkError(\n        err instanceof Error ? err.message : String(err),\n      );\n    }\n  }\n\n  private async request<T>(\n    method: string,\n    path: string,\n    body?: unknown,\n  ): Promise<T> {\n    const init: RequestInit = {\n      method,\n      headers: this.headers(body ? \"application/json\" : undefined),\n    };\n    if (body) init.body = JSON.stringify(body);\n\n    const response = await this.fetch(path, init);\n\n    const text = await response.text();\n    if (!response.ok) {\n      throw errorFromStatus(response.status, text);\n    }\n\n    const parsed: ApiResponse<T> = JSON.parse(text);\n    if (!parsed.success) {\n      throw new AgentKernelError(parsed.error ?? \"Unknown error\");\n    }\n    return parsed.data as T;\n  }\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../src/index.ts","../src/config.ts","../src/errors.ts","../src/sandbox.ts","../src/sse.ts","../src/client.ts"],"sourcesContent":["export { AgentKernel } from \"./client.js\";\nexport { SandboxSession } from \"./sandbox.js\";\nexport {\n  AgentKernelError,\n  AuthError,\n  NotFoundError,\n  ValidationError,\n  ServerError,\n  NetworkError,\n  StreamError,\n} from \"./errors.js\";\nexport type {\n  AgentKernelOptions,\n  BatchFileWriteResponse,\n  CreateSandboxOptions,\n  DetachedCommand,\n  DetachedLogsResponse,\n  DetachedStatus,\n  ExecOptions,\n  RunOptions,\n  RunOutput,\n  SandboxInfo,\n  StreamEvent,\n  StreamEventType,\n  SecurityProfile,\n  SandboxStatus,\n  ApiResponse,\n} from \"./types.js\";\n","import type { AgentKernelOptions } from \"./types.js\";\n\nconst DEFAULT_BASE_URL = \"http://localhost:18888\";\nconst DEFAULT_TIMEOUT = 30_000;\n\n/** Resolve configuration from constructor args, env vars, and defaults. */\nexport function resolveConfig(opts?: AgentKernelOptions) {\n  const baseUrl =\n    opts?.baseUrl ??\n    process.env.AGENTKERNEL_BASE_URL ??\n    DEFAULT_BASE_URL;\n\n  const apiKey =\n    opts?.apiKey ??\n    process.env.AGENTKERNEL_API_KEY ??\n    undefined;\n\n  const timeout = opts?.timeout ?? DEFAULT_TIMEOUT;\n\n  return {\n    baseUrl: baseUrl.replace(/\\/+$/, \"\"),\n    apiKey,\n    timeout,\n  };\n}\n","/** Base error for all agentkernel SDK errors. */\nexport class AgentKernelError extends Error {\n  constructor(message: string) {\n    super(message);\n    this.name = \"AgentKernelError\";\n  }\n}\n\n/** 401 Unauthorized. */\nexport class AuthError extends AgentKernelError {\n  readonly status = 401;\n  constructor(message = \"Unauthorized\") {\n    super(message);\n    this.name = \"AuthError\";\n  }\n}\n\n/** 404 Not Found. */\nexport class NotFoundError extends AgentKernelError {\n  readonly status = 404;\n  constructor(message = \"Not found\") {\n    super(message);\n    this.name = \"NotFoundError\";\n  }\n}\n\n/** 400 Bad Request. */\nexport class ValidationError extends AgentKernelError {\n  readonly status = 400;\n  constructor(message = \"Bad request\") {\n    super(message);\n    this.name = \"ValidationError\";\n  }\n}\n\n/** 500 Internal Server Error. */\nexport class ServerError extends AgentKernelError {\n  readonly status = 500;\n  constructor(message = \"Internal server error\") {\n    super(message);\n    this.name = \"ServerError\";\n  }\n}\n\n/** Network / connection error. */\nexport class NetworkError extends AgentKernelError {\n  constructor(message = \"Network error\") {\n    super(message);\n    this.name = \"NetworkError\";\n  }\n}\n\n/** SSE streaming error. */\nexport class StreamError extends AgentKernelError {\n  constructor(message = \"Stream error\") {\n    super(message);\n    this.name = \"StreamError\";\n  }\n}\n\n/** Map an HTTP status code + body to the appropriate error. */\nexport function errorFromStatus(status: number, body: string): AgentKernelError {\n  let message: string;\n  try {\n    const parsed = JSON.parse(body);\n    message = parsed.error ?? body;\n  } catch {\n    message = body;\n  }\n\n  switch (status) {\n    case 400:\n      return new ValidationError(message);\n    case 401:\n      return new AuthError(message);\n    case 404:\n      return new NotFoundError(message);\n    default:\n      return new ServerError(message);\n  }\n}\n","import type {\n  BatchFileWriteResponse,\n  ExecOptions,\n  RunOutput,\n  SandboxInfo,\n} from \"./types.js\";\n\ntype ExecFn = (\n  name: string,\n  command: string[],\n  opts?: ExecOptions,\n) => Promise<RunOutput>;\ntype RemoveFn = (name: string) => Promise<void>;\ntype GetFn = (name: string) => Promise<SandboxInfo>;\ntype WriteFilesFn = (\n  name: string,\n  files: Record<string, string>,\n) => Promise<BatchFileWriteResponse>;\n\n/**\n * A sandbox session that auto-removes the sandbox on dispose.\n *\n * Supports both explicit cleanup via remove() and automatic cleanup via\n * Symbol.asyncDispose (TS 5.2+ `await using`).\n *\n * @example\n * ```ts\n * await using sb = await client.sandbox(\"test\");\n * await sb.exec([\"echo\", \"hello\"]);\n * // sandbox auto-removed when scope exits\n * ```\n */\nexport class SandboxSession implements AsyncDisposable {\n  readonly name: string;\n  private _removed = false;\n  private readonly _execInSandbox: ExecFn;\n  private readonly _removeSandbox: RemoveFn;\n  private readonly _getSandbox: GetFn;\n  private readonly _writeFiles: WriteFilesFn;\n\n  /** @internal */\n  constructor(\n    name: string,\n    execInSandbox: ExecFn,\n    removeSandbox: RemoveFn,\n    getSandbox: GetFn,\n    writeFiles: WriteFilesFn,\n  ) {\n    this.name = name;\n    this._execInSandbox = execInSandbox;\n    this._removeSandbox = removeSandbox;\n    this._getSandbox = getSandbox;\n    this._writeFiles = writeFiles;\n  }\n\n  /** Run a command in this sandbox. */\n  async run(command: string[], opts?: ExecOptions): Promise<RunOutput> {\n    return this._execInSandbox(this.name, command, opts);\n  }\n\n  /** Get sandbox info. */\n  async info(): Promise<SandboxInfo> {\n    return this._getSandbox(this.name);\n  }\n\n  /** Write multiple files in one request. */\n  async writeFiles(\n    files: Record<string, string>,\n  ): Promise<BatchFileWriteResponse> {\n    return this._writeFiles(this.name, files);\n  }\n\n  /** Remove the sandbox. Idempotent. */\n  async remove(): Promise<void> {\n    if (this._removed) return;\n    this._removed = true;\n    await this._removeSandbox(this.name);\n  }\n\n  /** Auto-cleanup for `await using`. */\n  async [Symbol.asyncDispose](): Promise<void> {\n    await this.remove();\n  }\n}\n","import { createParser, type EventSourceMessage } from \"eventsource-parser\";\nimport type { StreamEvent, StreamEventType } from \"./types.js\";\n\nconst KNOWN_EVENTS = new Set<string>([\"started\", \"progress\", \"output\", \"done\", \"error\"]);\n\n/** Shared mutable state between the pump and the generator. */\ninterface PumpState {\n  events: StreamEvent[];\n  resolve: (() => void) | null;\n  done: boolean;\n}\n\nfunction pushEvent(state: PumpState, event: StreamEvent): void {\n  state.events.push(event);\n  if (state.resolve) {\n    const cb = state.resolve;\n    state.resolve = null;\n    cb();\n  }\n}\n\n/**\n * Parse an SSE response body into an async generator of StreamEvents.\n *\n * Consumes a ReadableStream<Uint8Array> from fetch() and yields typed events\n * until the stream closes or a \"done\"/\"error\" event is received.\n */\nexport async function* parseSSE(\n  body: ReadableStream<Uint8Array>,\n): AsyncGenerator<StreamEvent> {\n  const reader = body.getReader();\n  const decoder = new TextDecoder();\n  const state: PumpState = { events: [], resolve: null, done: false };\n\n  const parser = createParser({\n    onEvent(event: EventSourceMessage) {\n      const type = event.event ?? \"message\";\n      if (!KNOWN_EVENTS.has(type)) return;\n\n      let data: Record<string, unknown>;\n      try {\n        data = JSON.parse(event.data);\n      } catch {\n        data = { raw: event.data };\n      }\n\n      pushEvent(state, { type: type as StreamEventType, data });\n    },\n  });\n\n  // Read the stream in the background\n  const pump = (async () => {\n    try {\n      for (;;) {\n        const result = await reader.read();\n        if (result.done) break;\n        parser.feed(decoder.decode(result.value, { stream: true }));\n      }\n    } catch (err) {\n      pushEvent(state, {\n        type: \"error\",\n        data: { message: err instanceof Error ? err.message : String(err) },\n      });\n    } finally {\n      state.done = true;\n      if (state.resolve) {\n        const cb = state.resolve;\n        state.resolve = null;\n        cb();\n      }\n    }\n  })();\n\n  try {\n    for (;;) {\n      // Yield all buffered events\n      while (state.events.length > 0) {\n        const event = state.events.shift()!;\n        yield event;\n        if (event.type === \"done\" || event.type === \"error\") return;\n      }\n\n      // If the stream is done and no more events, exit\n      if (state.done) return;\n\n      // Wait for the next event\n      await new Promise<void>((r) => {\n        state.resolve = r;\n      });\n    }\n  } finally {\n    reader.cancel().catch(() => {});\n    await pump.catch(() => {});\n  }\n}\n","import { resolveConfig } from \"./config.js\";\nimport {\n  AgentKernelError,\n  NetworkError,\n  errorFromStatus,\n} from \"./errors.js\";\nimport { SandboxSession } from \"./sandbox.js\";\nimport { parseSSE } from \"./sse.js\";\nimport type {\n  AgentKernelOptions,\n  ApiResponse,\n  BatchCommand,\n  BatchFileWriteResponse,\n  BatchRunResponse,\n  CreateSandboxOptions,\n  DetachedCommand,\n  DetachedLogsResponse,\n  ExecOptions,\n  FileReadResponse,\n  FileWriteOptions,\n  RunOptions,\n  RunOutput,\n  SandboxInfo,\n  StreamEvent,\n} from \"./types.js\";\n\nconst SDK_VERSION = \"0.4.0\";\n\n/**\n * Client for the agentkernel HTTP API.\n *\n * @example\n * ```ts\n * const client = new AgentKernel();\n * const result = await client.run([\"echo\", \"hello\"]);\n * console.log(result.output); // \"hello\\n\"\n * ```\n */\nexport class AgentKernel {\n  private readonly baseUrl: string;\n  private readonly apiKey: string | undefined;\n  private readonly timeout: number;\n\n  constructor(opts?: AgentKernelOptions) {\n    const config = resolveConfig(opts);\n    this.baseUrl = config.baseUrl;\n    this.apiKey = config.apiKey;\n    this.timeout = config.timeout;\n  }\n\n  // -- Core API methods --\n\n  /** Health check. Returns \"ok\" if the server is running. */\n  async health(): Promise<string> {\n    const res = await this.request<string>(\"GET\", \"/health\");\n    return res;\n  }\n\n  /** Run a command in a temporary sandbox. */\n  async run(command: string[], opts?: RunOptions): Promise<RunOutput> {\n    return this.request<RunOutput>(\"POST\", \"/run\", {\n      command,\n      image: opts?.image,\n      profile: opts?.profile,\n      fast: opts?.fast ?? true,\n    });\n  }\n\n  /**\n   * Run a command with SSE streaming output.\n   *\n   * @example\n   * ```ts\n   * for await (const event of client.runStream([\"python3\", \"script.py\"])) {\n   *   if (event.type === \"output\") process.stdout.write(String(event.data.data));\n   * }\n   * ```\n   */\n  async *runStream(\n    command: string[],\n    opts?: RunOptions,\n  ): AsyncGenerator<StreamEvent> {\n    const body = JSON.stringify({\n      command,\n      image: opts?.image,\n      profile: opts?.profile,\n      fast: opts?.fast ?? true,\n    });\n\n    const response = await this.fetch(\"/run/stream\", {\n      method: \"POST\",\n      headers: this.headers(\"application/json\"),\n      body,\n    });\n\n    if (!response.ok) {\n      const text = await response.text();\n      throw errorFromStatus(response.status, text);\n    }\n\n    if (!response.body) {\n      throw new AgentKernelError(\"No response body for SSE stream\");\n    }\n\n    yield* parseSSE(response.body);\n  }\n\n  /** List all sandboxes. */\n  async listSandboxes(): Promise<SandboxInfo[]> {\n    return this.request<SandboxInfo[]>(\"GET\", \"/sandboxes\");\n  }\n\n  /** Create a new sandbox. */\n  async createSandbox(\n    name: string,\n    opts?: CreateSandboxOptions,\n  ): Promise<SandboxInfo> {\n    return this.request<SandboxInfo>(\"POST\", \"/sandboxes\", {\n      name,\n      image: opts?.image,\n      vcpus: opts?.vcpus,\n      memory_mb: opts?.memory_mb,\n      profile: opts?.profile,\n      source_url: opts?.source_url,\n      source_ref: opts?.source_ref,\n    });\n  }\n\n  /** Get info about a sandbox. */\n  async getSandbox(name: string): Promise<SandboxInfo> {\n    return this.request<SandboxInfo>(\"GET\", `/sandboxes/${encodeURIComponent(name)}`);\n  }\n\n  /** Remove a sandbox. */\n  async removeSandbox(name: string): Promise<void> {\n    await this.request<string>(\"DELETE\", `/sandboxes/${encodeURIComponent(name)}`);\n  }\n\n  /** Run a command in an existing sandbox. */\n  async execInSandbox(\n    name: string,\n    command: string[],\n    opts?: ExecOptions,\n  ): Promise<RunOutput> {\n    return this.request<RunOutput>(\n      \"POST\",\n      `/sandboxes/${encodeURIComponent(name)}/exec`,\n      {\n        command,\n        env: opts?.env,\n        workdir: opts?.workdir,\n        sudo: opts?.sudo,\n      },\n    );\n  }\n\n  /** Read a file from a sandbox. */\n  async readFile(name: string, path: string): Promise<FileReadResponse> {\n    return this.request<FileReadResponse>(\n      \"GET\",\n      `/sandboxes/${encodeURIComponent(name)}/files/${path}`,\n    );\n  }\n\n  /** Write a file to a sandbox. */\n  async writeFile(\n    name: string,\n    path: string,\n    content: string,\n    opts?: FileWriteOptions,\n  ): Promise<string> {\n    return this.request<string>(\n      \"PUT\",\n      `/sandboxes/${encodeURIComponent(name)}/files/${path}`,\n      { content, encoding: opts?.encoding ?? \"utf8\" },\n    );\n  }\n\n  /** Delete a file from a sandbox. */\n  async deleteFile(name: string, path: string): Promise<string> {\n    return this.request<string>(\n      \"DELETE\",\n      `/sandboxes/${encodeURIComponent(name)}/files/${path}`,\n    );\n  }\n\n  /** Get audit log entries for a sandbox. */\n  async getSandboxLogs(name: string): Promise<Record<string, unknown>[]> {\n    return this.request<Record<string, unknown>[]>(\n      \"GET\",\n      `/sandboxes/${encodeURIComponent(name)}/logs`,\n    );\n  }\n\n  /** Write multiple files to a sandbox in one request. */\n  async writeFiles(\n    name: string,\n    files: Record<string, string>,\n  ): Promise<BatchFileWriteResponse> {\n    return this.request<BatchFileWriteResponse>(\n      \"POST\",\n      `/sandboxes/${encodeURIComponent(name)}/files`,\n      { files },\n    );\n  }\n\n  /** Run multiple commands in parallel. */\n  async batchRun(commands: BatchCommand[]): Promise<BatchRunResponse> {\n    return this.request<BatchRunResponse>(\"POST\", \"/batch/run\", { commands });\n  }\n\n  /** Start a detached (background) command in a sandbox. */\n  async execDetached(\n    name: string,\n    command: string[],\n    opts?: ExecOptions,\n  ): Promise<DetachedCommand> {\n    return this.request<DetachedCommand>(\n      \"POST\",\n      `/sandboxes/${encodeURIComponent(name)}/exec/detach`,\n      {\n        command,\n        env: opts?.env,\n        workdir: opts?.workdir,\n        sudo: opts?.sudo,\n      },\n    );\n  }\n\n  /** Get the status of a detached command. */\n  async detachedStatus(\n    name: string,\n    cmdId: string,\n  ): Promise<DetachedCommand> {\n    return this.request<DetachedCommand>(\n      \"GET\",\n      `/sandboxes/${encodeURIComponent(name)}/exec/detached/${encodeURIComponent(cmdId)}`,\n    );\n  }\n\n  /** Get logs from a detached command. */\n  async detachedLogs(\n    name: string,\n    cmdId: string,\n    stream?: \"stdout\" | \"stderr\",\n  ): Promise<DetachedLogsResponse> {\n    const query = stream === \"stderr\" ? \"?stream=stderr\" : \"\";\n    return this.request<DetachedLogsResponse>(\n      \"GET\",\n      `/sandboxes/${encodeURIComponent(name)}/exec/detached/${encodeURIComponent(cmdId)}/logs${query}`,\n    );\n  }\n\n  /** Kill a detached command. */\n  async detachedKill(name: string, cmdId: string): Promise<string> {\n    return this.request<string>(\n      \"DELETE\",\n      `/sandboxes/${encodeURIComponent(name)}/exec/detached/${encodeURIComponent(cmdId)}`,\n    );\n  }\n\n  /** List detached commands in a sandbox. */\n  async detachedList(name: string): Promise<DetachedCommand[]> {\n    return this.request<DetachedCommand[]>(\n      \"GET\",\n      `/sandboxes/${encodeURIComponent(name)}/exec/detached`,\n    );\n  }\n\n  /**\n   * Create a sandbox session with automatic cleanup.\n   *\n   * The returned SandboxSession implements AsyncDisposable,\n   * so it works with `await using` (TS 5.2+):\n   *\n   * @example\n   * ```ts\n   * await using sb = await client.sandbox(\"test\", { image: \"python:3.12-alpine\" });\n   * await sb.run([\"pip\", \"install\", \"numpy\"]);\n   * // sandbox auto-removed when scope exits\n   * ```\n   */\n  async sandbox(\n    name: string,\n    opts?: CreateSandboxOptions,\n  ): Promise<SandboxSession> {\n    await this.createSandbox(name, opts);\n    return new SandboxSession(\n      name,\n      (n, cmd, o) => this.execInSandbox(n, cmd, o),\n      (n) => this.removeSandbox(n),\n      (n) => this.getSandbox(n),\n      (n, f) => this.writeFiles(n, f),\n    );\n  }\n\n  // -- Internal helpers --\n\n  private headers(contentType?: string): Record<string, string> {\n    const h: Record<string, string> = {\n      \"User-Agent\": `agentkernel-nodejs-sdk/${SDK_VERSION}`,\n    };\n    if (contentType) h[\"Content-Type\"] = contentType;\n    if (this.apiKey) h[\"Authorization\"] = `Bearer ${this.apiKey}`;\n    return h;\n  }\n\n  private async fetch(path: string, init: RequestInit): Promise<Response> {\n    const url = `${this.baseUrl}${path}`;\n    try {\n      return await fetch(url, {\n        ...init,\n        signal: AbortSignal.timeout(this.timeout),\n      });\n    } catch (err) {\n      if (err instanceof DOMException && err.name === \"TimeoutError\") {\n        throw new NetworkError(`Request timed out after ${this.timeout}ms`);\n      }\n      if (err instanceof TypeError) {\n        throw new NetworkError(`Failed to connect to ${this.baseUrl}: ${err.message}`);\n      }\n      throw new NetworkError(\n        err instanceof Error ? err.message : String(err),\n      );\n    }\n  }\n\n  private async request<T>(\n    method: string,\n    path: string,\n    body?: unknown,\n  ): Promise<T> {\n    const init: RequestInit = {\n      method,\n      headers: this.headers(body ? \"application/json\" : undefined),\n    };\n    if (body) init.body = JSON.stringify(body);\n\n    const response = await this.fetch(path, init);\n\n    const text = await response.text();\n    if (!response.ok) {\n      throw errorFromStatus(response.status, text);\n    }\n\n    const parsed: ApiResponse<T> = JSON.parse(text);\n    if (!parsed.success) {\n      throw new AgentKernelError(parsed.error ?? \"Unknown error\");\n    }\n    return parsed.data as T;\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/index.d.cts

@@ -29,6 +29,21 @@ interface CreateSandboxOptions {
     vcpus?: number;
     memory_mb?: number;
     profile?: SecurityProfile;
+    /** Git repository URL to clone into the sandbox. */
+    source_url?: string;
+    /** Git ref to checkout after cloning. */
+    source_ref?: string;
+    /** Volume mounts (slug:/path or slug:/path:ro). Create volumes via CLI first. */
+    volumes?: string[];
+}
+/** Options for executing a command in a sandbox. */
+interface ExecOptions {
+    /** Environment variables (KEY=VALUE). */
+    env?: string[];
+    /** Working directory inside the container. */
+    workdir?: string;
+    /** Run as root. */
+    sudo?: boolean;
 }
 /** Output from a command execution. */
 interface RunOutput {
@@ -73,6 +88,27 @@ interface BatchResult {
 interface BatchRunResponse {
     results: BatchResult[];
 }
+/** Result of a batch file write. */
+interface BatchFileWriteResponse {
+    written: number;
+}
+/** Status of a detached command. */
+type DetachedStatus = "running" | "completed" | "failed";
+/** A detached (background) command running in a sandbox. */
+interface DetachedCommand {
+    id: string;
+    sandbox: string;
+    command: string[];
+    pid: number;
+    status: DetachedStatus;
+    exit_code: number | null;
+    started_at: string;
+}
+/** Response from detached command logs. */
+interface DetachedLogsResponse {
+    stdout?: string;
+    stderr?: string;
+}
 /** API response wrapper. */
 interface ApiResponse<T> {
     success: boolean;
@@ -80,9 +116,10 @@ interface ApiResponse<T> {
     error?: string;
 }
 
-type ExecFn = (name: string, command: string[]) => Promise<RunOutput>;
+type ExecFn = (name: string, command: string[], opts?: ExecOptions) => Promise<RunOutput>;
 type RemoveFn = (name: string) => Promise<void>;
 type GetFn = (name: string) => Promise<SandboxInfo>;
+type WriteFilesFn = (name: string, files: Record<string, string>) => Promise<BatchFileWriteResponse>;
 /**
  * A sandbox session that auto-removes the sandbox on dispose.
  *
@@ -102,12 +139,15 @@ declare class SandboxSession implements AsyncDisposable {
     private readonly _execInSandbox;
     private readonly _removeSandbox;
     private readonly _getSandbox;
+    private readonly _writeFiles;
     /** @internal */
-    constructor(name: string, execInSandbox: ExecFn, removeSandbox: RemoveFn, getSandbox: GetFn);
+    constructor(name: string, execInSandbox: ExecFn, removeSandbox: RemoveFn, getSandbox: GetFn, writeFiles: WriteFilesFn);
     /** Run a command in this sandbox. */
-    run(command: string[]): Promise<RunOutput>;
+    run(command: string[], opts?: ExecOptions): Promise<RunOutput>;
     /** Get sandbox info. */
     info(): Promise<SandboxInfo>;
+    /** Write multiple files in one request. */
+    writeFiles(files: Record<string, string>): Promise<BatchFileWriteResponse>;
     /** Remove the sandbox. Idempotent. */
     remove(): Promise<void>;
     /** Auto-cleanup for `await using`. */
@@ -153,7 +193,7 @@ declare class AgentKernel {
     /** Remove a sandbox. */
     removeSandbox(name: string): Promise<void>;
     /** Run a command in an existing sandbox. */
-    execInSandbox(name: string, command: string[]): Promise<RunOutput>;
+    execInSandbox(name: string, command: string[], opts?: ExecOptions): Promise<RunOutput>;
     /** Read a file from a sandbox. */
     readFile(name: string, path: string): Promise<FileReadResponse>;
     /** Write a file to a sandbox. */
@@ -162,8 +202,20 @@ declare class AgentKernel {
     deleteFile(name: string, path: string): Promise<string>;
     /** Get audit log entries for a sandbox. */
     getSandboxLogs(name: string): Promise<Record<string, unknown>[]>;
+    /** Write multiple files to a sandbox in one request. */
+    writeFiles(name: string, files: Record<string, string>): Promise<BatchFileWriteResponse>;
     /** Run multiple commands in parallel. */
     batchRun(commands: BatchCommand[]): Promise<BatchRunResponse>;
+    /** Start a detached (background) command in a sandbox. */
+    execDetached(name: string, command: string[], opts?: ExecOptions): Promise<DetachedCommand>;
+    /** Get the status of a detached command. */
+    detachedStatus(name: string, cmdId: string): Promise<DetachedCommand>;
+    /** Get logs from a detached command. */
+    detachedLogs(name: string, cmdId: string, stream?: "stdout" | "stderr"): Promise<DetachedLogsResponse>;
+    /** Kill a detached command. */
+    detachedKill(name: string, cmdId: string): Promise<string>;
+    /** List detached commands in a sandbox. */
+    detachedList(name: string): Promise<DetachedCommand[]>;
     /**
      * Create a sandbox session with automatic cleanup.
      *
@@ -216,4 +268,4 @@ declare class StreamError extends AgentKernelError {
     constructor(message?: string);
 }
 
-export { AgentKernel, AgentKernelError, type AgentKernelOptions, type ApiResponse, AuthError, type CreateSandboxOptions, NetworkError, NotFoundError, type RunOptions, type RunOutput, type SandboxInfo, SandboxSession, type SandboxStatus, type SecurityProfile, ServerError, StreamError, type StreamEvent, type StreamEventType, ValidationError };
+export { AgentKernel, AgentKernelError, type AgentKernelOptions, type ApiResponse, AuthError, type BatchFileWriteResponse, type CreateSandboxOptions, type DetachedCommand, type DetachedLogsResponse, type DetachedStatus, type ExecOptions, NetworkError, NotFoundError, type RunOptions, type RunOutput, type SandboxInfo, SandboxSession, type SandboxStatus, type SecurityProfile, ServerError, StreamError, type StreamEvent, type StreamEventType, ValidationError };

package/dist/index.d.ts

@@ -29,6 +29,21 @@ interface CreateSandboxOptions {
     vcpus?: number;
     memory_mb?: number;
     profile?: SecurityProfile;
+    /** Git repository URL to clone into the sandbox. */
+    source_url?: string;
+    /** Git ref to checkout after cloning. */
+    source_ref?: string;
+    /** Volume mounts (slug:/path or slug:/path:ro). Create volumes via CLI first. */
+    volumes?: string[];
+}
+/** Options for executing a command in a sandbox. */
+interface ExecOptions {
+    /** Environment variables (KEY=VALUE). */
+    env?: string[];
+    /** Working directory inside the container. */
+    workdir?: string;
+    /** Run as root. */
+    sudo?: boolean;
 }
 /** Output from a command execution. */
 interface RunOutput {
@@ -73,6 +88,27 @@ interface BatchResult {
 interface BatchRunResponse {
     results: BatchResult[];
 }
+/** Result of a batch file write. */
+interface BatchFileWriteResponse {
+    written: number;
+}
+/** Status of a detached command. */
+type DetachedStatus = "running" | "completed" | "failed";
+/** A detached (background) command running in a sandbox. */
+interface DetachedCommand {
+    id: string;
+    sandbox: string;
+    command: string[];
+    pid: number;
+    status: DetachedStatus;
+    exit_code: number | null;
+    started_at: string;
+}
+/** Response from detached command logs. */
+interface DetachedLogsResponse {
+    stdout?: string;
+    stderr?: string;
+}
 /** API response wrapper. */
 interface ApiResponse<T> {
     success: boolean;
@@ -80,9 +116,10 @@ interface ApiResponse<T> {
     error?: string;
 }
 
-type ExecFn = (name: string, command: string[]) => Promise<RunOutput>;
+type ExecFn = (name: string, command: string[], opts?: ExecOptions) => Promise<RunOutput>;
 type RemoveFn = (name: string) => Promise<void>;
 type GetFn = (name: string) => Promise<SandboxInfo>;
+type WriteFilesFn = (name: string, files: Record<string, string>) => Promise<BatchFileWriteResponse>;
 /**
  * A sandbox session that auto-removes the sandbox on dispose.
  *
@@ -102,12 +139,15 @@ declare class SandboxSession implements AsyncDisposable {
     private readonly _execInSandbox;
     private readonly _removeSandbox;
     private readonly _getSandbox;
+    private readonly _writeFiles;
     /** @internal */
-    constructor(name: string, execInSandbox: ExecFn, removeSandbox: RemoveFn, getSandbox: GetFn);
+    constructor(name: string, execInSandbox: ExecFn, removeSandbox: RemoveFn, getSandbox: GetFn, writeFiles: WriteFilesFn);
     /** Run a command in this sandbox. */
-    run(command: string[]): Promise<RunOutput>;
+    run(command: string[], opts?: ExecOptions): Promise<RunOutput>;
     /** Get sandbox info. */
     info(): Promise<SandboxInfo>;
+    /** Write multiple files in one request. */
+    writeFiles(files: Record<string, string>): Promise<BatchFileWriteResponse>;
     /** Remove the sandbox. Idempotent. */
     remove(): Promise<void>;
     /** Auto-cleanup for `await using`. */
@@ -153,7 +193,7 @@ declare class AgentKernel {
     /** Remove a sandbox. */
     removeSandbox(name: string): Promise<void>;
     /** Run a command in an existing sandbox. */
-    execInSandbox(name: string, command: string[]): Promise<RunOutput>;
+    execInSandbox(name: string, command: string[], opts?: ExecOptions): Promise<RunOutput>;
     /** Read a file from a sandbox. */
     readFile(name: string, path: string): Promise<FileReadResponse>;
     /** Write a file to a sandbox. */
@@ -162,8 +202,20 @@ declare class AgentKernel {
     deleteFile(name: string, path: string): Promise<string>;
     /** Get audit log entries for a sandbox. */
     getSandboxLogs(name: string): Promise<Record<string, unknown>[]>;
+    /** Write multiple files to a sandbox in one request. */
+    writeFiles(name: string, files: Record<string, string>): Promise<BatchFileWriteResponse>;
     /** Run multiple commands in parallel. */
     batchRun(commands: BatchCommand[]): Promise<BatchRunResponse>;
+    /** Start a detached (background) command in a sandbox. */
+    execDetached(name: string, command: string[], opts?: ExecOptions): Promise<DetachedCommand>;
+    /** Get the status of a detached command. */
+    detachedStatus(name: string, cmdId: string): Promise<DetachedCommand>;
+    /** Get logs from a detached command. */
+    detachedLogs(name: string, cmdId: string, stream?: "stdout" | "stderr"): Promise<DetachedLogsResponse>;
+    /** Kill a detached command. */
+    detachedKill(name: string, cmdId: string): Promise<string>;
+    /** List detached commands in a sandbox. */
+    detachedList(name: string): Promise<DetachedCommand[]>;
     /**
      * Create a sandbox session with automatic cleanup.
      *
@@ -216,4 +268,4 @@ declare class StreamError extends AgentKernelError {
     constructor(message?: string);
 }
 
-export { AgentKernel, AgentKernelError, type AgentKernelOptions, type ApiResponse, AuthError, type CreateSandboxOptions, NetworkError, NotFoundError, type RunOptions, type RunOutput, type SandboxInfo, SandboxSession, type SandboxStatus, type SecurityProfile, ServerError, StreamError, type StreamEvent, type StreamEventType, ValidationError };
+export { AgentKernel, AgentKernelError, type AgentKernelOptions, type ApiResponse, AuthError, type BatchFileWriteResponse, type CreateSandboxOptions, type DetachedCommand, type DetachedLogsResponse, type DetachedStatus, type ExecOptions, NetworkError, NotFoundError, type RunOptions, type RunOutput, type SandboxInfo, SandboxSession, type SandboxStatus, type SecurityProfile, ServerError, StreamError, type StreamEvent, type StreamEventType, ValidationError };

package/dist/index.js

@@ -86,21 +86,27 @@ var SandboxSession = class {
   _execInSandbox;
   _removeSandbox;
   _getSandbox;
+  _writeFiles;
   /** @internal */
-  constructor(name, execInSandbox, removeSandbox, getSandbox) {
+  constructor(name, execInSandbox, removeSandbox, getSandbox, writeFiles) {
     this.name = name;
     this._execInSandbox = execInSandbox;
     this._removeSandbox = removeSandbox;
     this._getSandbox = getSandbox;
+    this._writeFiles = writeFiles;
   }
   /** Run a command in this sandbox. */
-  async run(command) {
-    return this._execInSandbox(this.name, command);
+  async run(command, opts) {
+    return this._execInSandbox(this.name, command, opts);
   }
   /** Get sandbox info. */
   async info() {
     return this._getSandbox(this.name);
   }
+  /** Write multiple files in one request. */
+  async writeFiles(files) {
+    return this._writeFiles(this.name, files);
+  }
   /** Remove the sandbox. Idempotent. */
   async remove() {
     if (this._removed) return;
@@ -251,7 +257,9 @@ var AgentKernel = class {
       image: opts?.image,
       vcpus: opts?.vcpus,
       memory_mb: opts?.memory_mb,
-      profile: opts?.profile
+      profile: opts?.profile,
+      source_url: opts?.source_url,
+      source_ref: opts?.source_ref
     });
   }
   /** Get info about a sandbox. */
@@ -263,11 +271,16 @@ var AgentKernel = class {
     await this.request("DELETE", `/sandboxes/${encodeURIComponent(name)}`);
   }
   /** Run a command in an existing sandbox. */
-  async execInSandbox(name, command) {
+  async execInSandbox(name, command, opts) {
     return this.request(
       "POST",
       `/sandboxes/${encodeURIComponent(name)}/exec`,
-      { command }
+      {
+        command,
+        env: opts?.env,
+        workdir: opts?.workdir,
+        sudo: opts?.sudo
+      }
     );
   }
   /** Read a file from a sandbox. */
@@ -299,10 +312,60 @@ var AgentKernel = class {
       `/sandboxes/${encodeURIComponent(name)}/logs`
     );
   }
+  /** Write multiple files to a sandbox in one request. */
+  async writeFiles(name, files) {
+    return this.request(
+      "POST",
+      `/sandboxes/${encodeURIComponent(name)}/files`,
+      { files }
+    );
+  }
   /** Run multiple commands in parallel. */
   async batchRun(commands) {
     return this.request("POST", "/batch/run", { commands });
   }
+  /** Start a detached (background) command in a sandbox. */
+  async execDetached(name, command, opts) {
+    return this.request(
+      "POST",
+      `/sandboxes/${encodeURIComponent(name)}/exec/detach`,
+      {
+        command,
+        env: opts?.env,
+        workdir: opts?.workdir,
+        sudo: opts?.sudo
+      }
+    );
+  }
+  /** Get the status of a detached command. */
+  async detachedStatus(name, cmdId) {
+    return this.request(
+      "GET",
+      `/sandboxes/${encodeURIComponent(name)}/exec/detached/${encodeURIComponent(cmdId)}`
+    );
+  }
+  /** Get logs from a detached command. */
+  async detachedLogs(name, cmdId, stream) {
+    const query = stream === "stderr" ? "?stream=stderr" : "";
+    return this.request(
+      "GET",
+      `/sandboxes/${encodeURIComponent(name)}/exec/detached/${encodeURIComponent(cmdId)}/logs${query}`
+    );
+  }
+  /** Kill a detached command. */
+  async detachedKill(name, cmdId) {
+    return this.request(
+      "DELETE",
+      `/sandboxes/${encodeURIComponent(name)}/exec/detached/${encodeURIComponent(cmdId)}`
+    );
+  }
+  /** List detached commands in a sandbox. */
+  async detachedList(name) {
+    return this.request(
+      "GET",
+      `/sandboxes/${encodeURIComponent(name)}/exec/detached`
+    );
+  }
   /**
    * Create a sandbox session with automatic cleanup.
    *
@@ -320,9 +383,10 @@ var AgentKernel = class {
     await this.createSandbox(name, opts);
     return new SandboxSession(
       name,
-      (n, cmd) => this.execInSandbox(n, cmd),
+      (n, cmd, o) => this.execInSandbox(n, cmd, o),
       (n) => this.removeSandbox(n),
-      (n) => this.getSandbox(n)
+      (n) => this.getSandbox(n),
+      (n, f) => this.writeFiles(n, f)
     );
   }
   // -- Internal helpers --

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/config.ts","../src/errors.ts","../src/sandbox.ts","../src/sse.ts","../src/client.ts"],"sourcesContent":["import type { AgentKernelOptions } from \"./types.js\";\n\nconst DEFAULT_BASE_URL = \"http://localhost:18888\";\nconst DEFAULT_TIMEOUT = 30_000;\n\n/** Resolve configuration from constructor args, env vars, and defaults. */\nexport function resolveConfig(opts?: AgentKernelOptions) {\n  const baseUrl =\n    opts?.baseUrl ??\n    process.env.AGENTKERNEL_BASE_URL ??\n    DEFAULT_BASE_URL;\n\n  const apiKey =\n    opts?.apiKey ??\n    process.env.AGENTKERNEL_API_KEY ??\n    undefined;\n\n  const timeout = opts?.timeout ?? DEFAULT_TIMEOUT;\n\n  return {\n    baseUrl: baseUrl.replace(/\\/+$/, \"\"),\n    apiKey,\n    timeout,\n  };\n}\n","/** Base error for all agentkernel SDK errors. */\nexport class AgentKernelError extends Error {\n  constructor(message: string) {\n    super(message);\n    this.name = \"AgentKernelError\";\n  }\n}\n\n/** 401 Unauthorized. */\nexport class AuthError extends AgentKernelError {\n  readonly status = 401;\n  constructor(message = \"Unauthorized\") {\n    super(message);\n    this.name = \"AuthError\";\n  }\n}\n\n/** 404 Not Found. */\nexport class NotFoundError extends AgentKernelError {\n  readonly status = 404;\n  constructor(message = \"Not found\") {\n    super(message);\n    this.name = \"NotFoundError\";\n  }\n}\n\n/** 400 Bad Request. */\nexport class ValidationError extends AgentKernelError {\n  readonly status = 400;\n  constructor(message = \"Bad request\") {\n    super(message);\n    this.name = \"ValidationError\";\n  }\n}\n\n/** 500 Internal Server Error. */\nexport class ServerError extends AgentKernelError {\n  readonly status = 500;\n  constructor(message = \"Internal server error\") {\n    super(message);\n    this.name = \"ServerError\";\n  }\n}\n\n/** Network / connection error. */\nexport class NetworkError extends AgentKernelError {\n  constructor(message = \"Network error\") {\n    super(message);\n    this.name = \"NetworkError\";\n  }\n}\n\n/** SSE streaming error. */\nexport class StreamError extends AgentKernelError {\n  constructor(message = \"Stream error\") {\n    super(message);\n    this.name = \"StreamError\";\n  }\n}\n\n/** Map an HTTP status code + body to the appropriate error. */\nexport function errorFromStatus(status: number, body: string): AgentKernelError {\n  let message: string;\n  try {\n    const parsed = JSON.parse(body);\n    message = parsed.error ?? body;\n  } catch {\n    message = body;\n  }\n\n  switch (status) {\n    case 400:\n      return new ValidationError(message);\n    case 401:\n      return new AuthError(message);\n    case 404:\n      return new NotFoundError(message);\n    default:\n      return new ServerError(message);\n  }\n}\n","import type { RunOutput, SandboxInfo } from \"./types.js\";\n\ntype ExecFn = (name: string, command: string[]) => Promise<RunOutput>;\ntype RemoveFn = (name: string) => Promise<void>;\ntype GetFn = (name: string) => Promise<SandboxInfo>;\n\n/**\n * A sandbox session that auto-removes the sandbox on dispose.\n *\n * Supports both explicit cleanup via remove() and automatic cleanup via\n * Symbol.asyncDispose (TS 5.2+ `await using`).\n *\n * @example\n * ```ts\n * await using sb = await client.sandbox(\"test\");\n * await sb.exec([\"echo\", \"hello\"]);\n * // sandbox auto-removed when scope exits\n * ```\n */\nexport class SandboxSession implements AsyncDisposable {\n  readonly name: string;\n  private _removed = false;\n  private readonly _execInSandbox: ExecFn;\n  private readonly _removeSandbox: RemoveFn;\n  private readonly _getSandbox: GetFn;\n\n  /** @internal */\n  constructor(\n    name: string,\n    execInSandbox: ExecFn,\n    removeSandbox: RemoveFn,\n    getSandbox: GetFn,\n  ) {\n    this.name = name;\n    this._execInSandbox = execInSandbox;\n    this._removeSandbox = removeSandbox;\n    this._getSandbox = getSandbox;\n  }\n\n  /** Run a command in this sandbox. */\n  async run(command: string[]): Promise<RunOutput> {\n    return this._execInSandbox(this.name, command);\n  }\n\n  /** Get sandbox info. */\n  async info(): Promise<SandboxInfo> {\n    return this._getSandbox(this.name);\n  }\n\n  /** Remove the sandbox. Idempotent. */\n  async remove(): Promise<void> {\n    if (this._removed) return;\n    this._removed = true;\n    await this._removeSandbox(this.name);\n  }\n\n  /** Auto-cleanup for `await using`. */\n  async [Symbol.asyncDispose](): Promise<void> {\n    await this.remove();\n  }\n}\n","import { createParser, type EventSourceMessage } from \"eventsource-parser\";\nimport type { StreamEvent, StreamEventType } from \"./types.js\";\n\nconst KNOWN_EVENTS = new Set<string>([\"started\", \"progress\", \"output\", \"done\", \"error\"]);\n\n/** Shared mutable state between the pump and the generator. */\ninterface PumpState {\n  events: StreamEvent[];\n  resolve: (() => void) | null;\n  done: boolean;\n}\n\nfunction pushEvent(state: PumpState, event: StreamEvent): void {\n  state.events.push(event);\n  if (state.resolve) {\n    const cb = state.resolve;\n    state.resolve = null;\n    cb();\n  }\n}\n\n/**\n * Parse an SSE response body into an async generator of StreamEvents.\n *\n * Consumes a ReadableStream<Uint8Array> from fetch() and yields typed events\n * until the stream closes or a \"done\"/\"error\" event is received.\n */\nexport async function* parseSSE(\n  body: ReadableStream<Uint8Array>,\n): AsyncGenerator<StreamEvent> {\n  const reader = body.getReader();\n  const decoder = new TextDecoder();\n  const state: PumpState = { events: [], resolve: null, done: false };\n\n  const parser = createParser({\n    onEvent(event: EventSourceMessage) {\n      const type = event.event ?? \"message\";\n      if (!KNOWN_EVENTS.has(type)) return;\n\n      let data: Record<string, unknown>;\n      try {\n        data = JSON.parse(event.data);\n      } catch {\n        data = { raw: event.data };\n      }\n\n      pushEvent(state, { type: type as StreamEventType, data });\n    },\n  });\n\n  // Read the stream in the background\n  const pump = (async () => {\n    try {\n      for (;;) {\n        const result = await reader.read();\n        if (result.done) break;\n        parser.feed(decoder.decode(result.value, { stream: true }));\n      }\n    } catch (err) {\n      pushEvent(state, {\n        type: \"error\",\n        data: { message: err instanceof Error ? err.message : String(err) },\n      });\n    } finally {\n      state.done = true;\n      if (state.resolve) {\n        const cb = state.resolve;\n        state.resolve = null;\n        cb();\n      }\n    }\n  })();\n\n  try {\n    for (;;) {\n      // Yield all buffered events\n      while (state.events.length > 0) {\n        const event = state.events.shift()!;\n        yield event;\n        if (event.type === \"done\" || event.type === \"error\") return;\n      }\n\n      // If the stream is done and no more events, exit\n      if (state.done) return;\n\n      // Wait for the next event\n      await new Promise<void>((r) => {\n        state.resolve = r;\n      });\n    }\n  } finally {\n    reader.cancel().catch(() => {});\n    await pump.catch(() => {});\n  }\n}\n","import { resolveConfig } from \"./config.js\";\nimport {\n  AgentKernelError,\n  NetworkError,\n  errorFromStatus,\n} from \"./errors.js\";\nimport { SandboxSession } from \"./sandbox.js\";\nimport { parseSSE } from \"./sse.js\";\nimport type {\n  AgentKernelOptions,\n  ApiResponse,\n  BatchCommand,\n  BatchRunResponse,\n  CreateSandboxOptions,\n  FileReadResponse,\n  FileWriteOptions,\n  RunOptions,\n  RunOutput,\n  SandboxInfo,\n  StreamEvent,\n} from \"./types.js\";\n\nconst SDK_VERSION = \"0.4.0\";\n\n/**\n * Client for the agentkernel HTTP API.\n *\n * @example\n * ```ts\n * const client = new AgentKernel();\n * const result = await client.run([\"echo\", \"hello\"]);\n * console.log(result.output); // \"hello\\n\"\n * ```\n */\nexport class AgentKernel {\n  private readonly baseUrl: string;\n  private readonly apiKey: string | undefined;\n  private readonly timeout: number;\n\n  constructor(opts?: AgentKernelOptions) {\n    const config = resolveConfig(opts);\n    this.baseUrl = config.baseUrl;\n    this.apiKey = config.apiKey;\n    this.timeout = config.timeout;\n  }\n\n  // -- Core API methods --\n\n  /** Health check. Returns \"ok\" if the server is running. */\n  async health(): Promise<string> {\n    const res = await this.request<string>(\"GET\", \"/health\");\n    return res;\n  }\n\n  /** Run a command in a temporary sandbox. */\n  async run(command: string[], opts?: RunOptions): Promise<RunOutput> {\n    return this.request<RunOutput>(\"POST\", \"/run\", {\n      command,\n      image: opts?.image,\n      profile: opts?.profile,\n      fast: opts?.fast ?? true,\n    });\n  }\n\n  /**\n   * Run a command with SSE streaming output.\n   *\n   * @example\n   * ```ts\n   * for await (const event of client.runStream([\"python3\", \"script.py\"])) {\n   *   if (event.type === \"output\") process.stdout.write(String(event.data.data));\n   * }\n   * ```\n   */\n  async *runStream(\n    command: string[],\n    opts?: RunOptions,\n  ): AsyncGenerator<StreamEvent> {\n    const body = JSON.stringify({\n      command,\n      image: opts?.image,\n      profile: opts?.profile,\n      fast: opts?.fast ?? true,\n    });\n\n    const response = await this.fetch(\"/run/stream\", {\n      method: \"POST\",\n      headers: this.headers(\"application/json\"),\n      body,\n    });\n\n    if (!response.ok) {\n      const text = await response.text();\n      throw errorFromStatus(response.status, text);\n    }\n\n    if (!response.body) {\n      throw new AgentKernelError(\"No response body for SSE stream\");\n    }\n\n    yield* parseSSE(response.body);\n  }\n\n  /** List all sandboxes. */\n  async listSandboxes(): Promise<SandboxInfo[]> {\n    return this.request<SandboxInfo[]>(\"GET\", \"/sandboxes\");\n  }\n\n  /** Create a new sandbox. */\n  async createSandbox(\n    name: string,\n    opts?: CreateSandboxOptions,\n  ): Promise<SandboxInfo> {\n    return this.request<SandboxInfo>(\"POST\", \"/sandboxes\", {\n      name,\n      image: opts?.image,\n      vcpus: opts?.vcpus,\n      memory_mb: opts?.memory_mb,\n      profile: opts?.profile,\n    });\n  }\n\n  /** Get info about a sandbox. */\n  async getSandbox(name: string): Promise<SandboxInfo> {\n    return this.request<SandboxInfo>(\"GET\", `/sandboxes/${encodeURIComponent(name)}`);\n  }\n\n  /** Remove a sandbox. */\n  async removeSandbox(name: string): Promise<void> {\n    await this.request<string>(\"DELETE\", `/sandboxes/${encodeURIComponent(name)}`);\n  }\n\n  /** Run a command in an existing sandbox. */\n  async execInSandbox(name: string, command: string[]): Promise<RunOutput> {\n    return this.request<RunOutput>(\n      \"POST\",\n      `/sandboxes/${encodeURIComponent(name)}/exec`,\n      { command },\n    );\n  }\n\n  /** Read a file from a sandbox. */\n  async readFile(name: string, path: string): Promise<FileReadResponse> {\n    return this.request<FileReadResponse>(\n      \"GET\",\n      `/sandboxes/${encodeURIComponent(name)}/files/${path}`,\n    );\n  }\n\n  /** Write a file to a sandbox. */\n  async writeFile(\n    name: string,\n    path: string,\n    content: string,\n    opts?: FileWriteOptions,\n  ): Promise<string> {\n    return this.request<string>(\n      \"PUT\",\n      `/sandboxes/${encodeURIComponent(name)}/files/${path}`,\n      { content, encoding: opts?.encoding ?? \"utf8\" },\n    );\n  }\n\n  /** Delete a file from a sandbox. */\n  async deleteFile(name: string, path: string): Promise<string> {\n    return this.request<string>(\n      \"DELETE\",\n      `/sandboxes/${encodeURIComponent(name)}/files/${path}`,\n    );\n  }\n\n  /** Get audit log entries for a sandbox. */\n  async getSandboxLogs(name: string): Promise<Record<string, unknown>[]> {\n    return this.request<Record<string, unknown>[]>(\n      \"GET\",\n      `/sandboxes/${encodeURIComponent(name)}/logs`,\n    );\n  }\n\n  /** Run multiple commands in parallel. */\n  async batchRun(commands: BatchCommand[]): Promise<BatchRunResponse> {\n    return this.request<BatchRunResponse>(\"POST\", \"/batch/run\", { commands });\n  }\n\n  /**\n   * Create a sandbox session with automatic cleanup.\n   *\n   * The returned SandboxSession implements AsyncDisposable,\n   * so it works with `await using` (TS 5.2+):\n   *\n   * @example\n   * ```ts\n   * await using sb = await client.sandbox(\"test\", { image: \"python:3.12-alpine\" });\n   * await sb.run([\"pip\", \"install\", \"numpy\"]);\n   * // sandbox auto-removed when scope exits\n   * ```\n   */\n  async sandbox(\n    name: string,\n    opts?: CreateSandboxOptions,\n  ): Promise<SandboxSession> {\n    await this.createSandbox(name, opts);\n    return new SandboxSession(\n      name,\n      (n, cmd) => this.execInSandbox(n, cmd),\n      (n) => this.removeSandbox(n),\n      (n) => this.getSandbox(n),\n    );\n  }\n\n  // -- Internal helpers --\n\n  private headers(contentType?: string): Record<string, string> {\n    const h: Record<string, string> = {\n      \"User-Agent\": `agentkernel-nodejs-sdk/${SDK_VERSION}`,\n    };\n    if (contentType) h[\"Content-Type\"] = contentType;\n    if (this.apiKey) h[\"Authorization\"] = `Bearer ${this.apiKey}`;\n    return h;\n  }\n\n  private async fetch(path: string, init: RequestInit): Promise<Response> {\n    const url = `${this.baseUrl}${path}`;\n    try {\n      return await fetch(url, {\n        ...init,\n        signal: AbortSignal.timeout(this.timeout),\n      });\n    } catch (err) {\n      if (err instanceof DOMException && err.name === \"TimeoutError\") {\n        throw new NetworkError(`Request timed out after ${this.timeout}ms`);\n      }\n      if (err instanceof TypeError) {\n        throw new NetworkError(`Failed to connect to ${this.baseUrl}: ${err.message}`);\n      }\n      throw new NetworkError(\n        err instanceof Error ? err.message : String(err),\n      );\n    }\n  }\n\n  private async request<T>(\n    method: string,\n    path: string,\n    body?: unknown,\n  ): Promise<T> {\n    const init: RequestInit = {\n      method,\n      headers: this.headers(body ? \"application/json\" : undefined),\n    };\n    if (body) init.body = JSON.stringify(body);\n\n    const response = await this.fetch(path, init);\n\n    const text = await response.text();\n    if (!response.ok) {\n      throw errorFromStatus(response.status, text);\n    }\n\n    const parsed: ApiResponse<T> = JSON.parse(text);\n    if (!parsed.success) {\n      throw new AgentKernelError(parsed.error ?? \"Unknown error\");\n    }\n    return parsed.data as T;\n  }\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../src/config.ts","../src/errors.ts","../src/sandbox.ts","../src/sse.ts","../src/client.ts"],"sourcesContent":["import type { AgentKernelOptions } from \"./types.js\";\n\nconst DEFAULT_BASE_URL = \"http://localhost:18888\";\nconst DEFAULT_TIMEOUT = 30_000;\n\n/** Resolve configuration from constructor args, env vars, and defaults. */\nexport function resolveConfig(opts?: AgentKernelOptions) {\n  const baseUrl =\n    opts?.baseUrl ??\n    process.env.AGENTKERNEL_BASE_URL ??\n    DEFAULT_BASE_URL;\n\n  const apiKey =\n    opts?.apiKey ??\n    process.env.AGENTKERNEL_API_KEY ??\n    undefined;\n\n  const timeout = opts?.timeout ?? DEFAULT_TIMEOUT;\n\n  return {\n    baseUrl: baseUrl.replace(/\\/+$/, \"\"),\n    apiKey,\n    timeout,\n  };\n}\n","/** Base error for all agentkernel SDK errors. */\nexport class AgentKernelError extends Error {\n  constructor(message: string) {\n    super(message);\n    this.name = \"AgentKernelError\";\n  }\n}\n\n/** 401 Unauthorized. */\nexport class AuthError extends AgentKernelError {\n  readonly status = 401;\n  constructor(message = \"Unauthorized\") {\n    super(message);\n    this.name = \"AuthError\";\n  }\n}\n\n/** 404 Not Found. */\nexport class NotFoundError extends AgentKernelError {\n  readonly status = 404;\n  constructor(message = \"Not found\") {\n    super(message);\n    this.name = \"NotFoundError\";\n  }\n}\n\n/** 400 Bad Request. */\nexport class ValidationError extends AgentKernelError {\n  readonly status = 400;\n  constructor(message = \"Bad request\") {\n    super(message);\n    this.name = \"ValidationError\";\n  }\n}\n\n/** 500 Internal Server Error. */\nexport class ServerError extends AgentKernelError {\n  readonly status = 500;\n  constructor(message = \"Internal server error\") {\n    super(message);\n    this.name = \"ServerError\";\n  }\n}\n\n/** Network / connection error. */\nexport class NetworkError extends AgentKernelError {\n  constructor(message = \"Network error\") {\n    super(message);\n    this.name = \"NetworkError\";\n  }\n}\n\n/** SSE streaming error. */\nexport class StreamError extends AgentKernelError {\n  constructor(message = \"Stream error\") {\n    super(message);\n    this.name = \"StreamError\";\n  }\n}\n\n/** Map an HTTP status code + body to the appropriate error. */\nexport function errorFromStatus(status: number, body: string): AgentKernelError {\n  let message: string;\n  try {\n    const parsed = JSON.parse(body);\n    message = parsed.error ?? body;\n  } catch {\n    message = body;\n  }\n\n  switch (status) {\n    case 400:\n      return new ValidationError(message);\n    case 401:\n      return new AuthError(message);\n    case 404:\n      return new NotFoundError(message);\n    default:\n      return new ServerError(message);\n  }\n}\n","import type {\n  BatchFileWriteResponse,\n  ExecOptions,\n  RunOutput,\n  SandboxInfo,\n} from \"./types.js\";\n\ntype ExecFn = (\n  name: string,\n  command: string[],\n  opts?: ExecOptions,\n) => Promise<RunOutput>;\ntype RemoveFn = (name: string) => Promise<void>;\ntype GetFn = (name: string) => Promise<SandboxInfo>;\ntype WriteFilesFn = (\n  name: string,\n  files: Record<string, string>,\n) => Promise<BatchFileWriteResponse>;\n\n/**\n * A sandbox session that auto-removes the sandbox on dispose.\n *\n * Supports both explicit cleanup via remove() and automatic cleanup via\n * Symbol.asyncDispose (TS 5.2+ `await using`).\n *\n * @example\n * ```ts\n * await using sb = await client.sandbox(\"test\");\n * await sb.exec([\"echo\", \"hello\"]);\n * // sandbox auto-removed when scope exits\n * ```\n */\nexport class SandboxSession implements AsyncDisposable {\n  readonly name: string;\n  private _removed = false;\n  private readonly _execInSandbox: ExecFn;\n  private readonly _removeSandbox: RemoveFn;\n  private readonly _getSandbox: GetFn;\n  private readonly _writeFiles: WriteFilesFn;\n\n  /** @internal */\n  constructor(\n    name: string,\n    execInSandbox: ExecFn,\n    removeSandbox: RemoveFn,\n    getSandbox: GetFn,\n    writeFiles: WriteFilesFn,\n  ) {\n    this.name = name;\n    this._execInSandbox = execInSandbox;\n    this._removeSandbox = removeSandbox;\n    this._getSandbox = getSandbox;\n    this._writeFiles = writeFiles;\n  }\n\n  /** Run a command in this sandbox. */\n  async run(command: string[], opts?: ExecOptions): Promise<RunOutput> {\n    return this._execInSandbox(this.name, command, opts);\n  }\n\n  /** Get sandbox info. */\n  async info(): Promise<SandboxInfo> {\n    return this._getSandbox(this.name);\n  }\n\n  /** Write multiple files in one request. */\n  async writeFiles(\n    files: Record<string, string>,\n  ): Promise<BatchFileWriteResponse> {\n    return this._writeFiles(this.name, files);\n  }\n\n  /** Remove the sandbox. Idempotent. */\n  async remove(): Promise<void> {\n    if (this._removed) return;\n    this._removed = true;\n    await this._removeSandbox(this.name);\n  }\n\n  /** Auto-cleanup for `await using`. */\n  async [Symbol.asyncDispose](): Promise<void> {\n    await this.remove();\n  }\n}\n","import { createParser, type EventSourceMessage } from \"eventsource-parser\";\nimport type { StreamEvent, StreamEventType } from \"./types.js\";\n\nconst KNOWN_EVENTS = new Set<string>([\"started\", \"progress\", \"output\", \"done\", \"error\"]);\n\n/** Shared mutable state between the pump and the generator. */\ninterface PumpState {\n  events: StreamEvent[];\n  resolve: (() => void) | null;\n  done: boolean;\n}\n\nfunction pushEvent(state: PumpState, event: StreamEvent): void {\n  state.events.push(event);\n  if (state.resolve) {\n    const cb = state.resolve;\n    state.resolve = null;\n    cb();\n  }\n}\n\n/**\n * Parse an SSE response body into an async generator of StreamEvents.\n *\n * Consumes a ReadableStream<Uint8Array> from fetch() and yields typed events\n * until the stream closes or a \"done\"/\"error\" event is received.\n */\nexport async function* parseSSE(\n  body: ReadableStream<Uint8Array>,\n): AsyncGenerator<StreamEvent> {\n  const reader = body.getReader();\n  const decoder = new TextDecoder();\n  const state: PumpState = { events: [], resolve: null, done: false };\n\n  const parser = createParser({\n    onEvent(event: EventSourceMessage) {\n      const type = event.event ?? \"message\";\n      if (!KNOWN_EVENTS.has(type)) return;\n\n      let data: Record<string, unknown>;\n      try {\n        data = JSON.parse(event.data);\n      } catch {\n        data = { raw: event.data };\n      }\n\n      pushEvent(state, { type: type as StreamEventType, data });\n    },\n  });\n\n  // Read the stream in the background\n  const pump = (async () => {\n    try {\n      for (;;) {\n        const result = await reader.read();\n        if (result.done) break;\n        parser.feed(decoder.decode(result.value, { stream: true }));\n      }\n    } catch (err) {\n      pushEvent(state, {\n        type: \"error\",\n        data: { message: err instanceof Error ? err.message : String(err) },\n      });\n    } finally {\n      state.done = true;\n      if (state.resolve) {\n        const cb = state.resolve;\n        state.resolve = null;\n        cb();\n      }\n    }\n  })();\n\n  try {\n    for (;;) {\n      // Yield all buffered events\n      while (state.events.length > 0) {\n        const event = state.events.shift()!;\n        yield event;\n        if (event.type === \"done\" || event.type === \"error\") return;\n      }\n\n      // If the stream is done and no more events, exit\n      if (state.done) return;\n\n      // Wait for the next event\n      await new Promise<void>((r) => {\n        state.resolve = r;\n      });\n    }\n  } finally {\n    reader.cancel().catch(() => {});\n    await pump.catch(() => {});\n  }\n}\n","import { resolveConfig } from \"./config.js\";\nimport {\n  AgentKernelError,\n  NetworkError,\n  errorFromStatus,\n} from \"./errors.js\";\nimport { SandboxSession } from \"./sandbox.js\";\nimport { parseSSE } from \"./sse.js\";\nimport type {\n  AgentKernelOptions,\n  ApiResponse,\n  BatchCommand,\n  BatchFileWriteResponse,\n  BatchRunResponse,\n  CreateSandboxOptions,\n  DetachedCommand,\n  DetachedLogsResponse,\n  ExecOptions,\n  FileReadResponse,\n  FileWriteOptions,\n  RunOptions,\n  RunOutput,\n  SandboxInfo,\n  StreamEvent,\n} from \"./types.js\";\n\nconst SDK_VERSION = \"0.4.0\";\n\n/**\n * Client for the agentkernel HTTP API.\n *\n * @example\n * ```ts\n * const client = new AgentKernel();\n * const result = await client.run([\"echo\", \"hello\"]);\n * console.log(result.output); // \"hello\\n\"\n * ```\n */\nexport class AgentKernel {\n  private readonly baseUrl: string;\n  private readonly apiKey: string | undefined;\n  private readonly timeout: number;\n\n  constructor(opts?: AgentKernelOptions) {\n    const config = resolveConfig(opts);\n    this.baseUrl = config.baseUrl;\n    this.apiKey = config.apiKey;\n    this.timeout = config.timeout;\n  }\n\n  // -- Core API methods --\n\n  /** Health check. Returns \"ok\" if the server is running. */\n  async health(): Promise<string> {\n    const res = await this.request<string>(\"GET\", \"/health\");\n    return res;\n  }\n\n  /** Run a command in a temporary sandbox. */\n  async run(command: string[], opts?: RunOptions): Promise<RunOutput> {\n    return this.request<RunOutput>(\"POST\", \"/run\", {\n      command,\n      image: opts?.image,\n      profile: opts?.profile,\n      fast: opts?.fast ?? true,\n    });\n  }\n\n  /**\n   * Run a command with SSE streaming output.\n   *\n   * @example\n   * ```ts\n   * for await (const event of client.runStream([\"python3\", \"script.py\"])) {\n   *   if (event.type === \"output\") process.stdout.write(String(event.data.data));\n   * }\n   * ```\n   */\n  async *runStream(\n    command: string[],\n    opts?: RunOptions,\n  ): AsyncGenerator<StreamEvent> {\n    const body = JSON.stringify({\n      command,\n      image: opts?.image,\n      profile: opts?.profile,\n      fast: opts?.fast ?? true,\n    });\n\n    const response = await this.fetch(\"/run/stream\", {\n      method: \"POST\",\n      headers: this.headers(\"application/json\"),\n      body,\n    });\n\n    if (!response.ok) {\n      const text = await response.text();\n      throw errorFromStatus(response.status, text);\n    }\n\n    if (!response.body) {\n      throw new AgentKernelError(\"No response body for SSE stream\");\n    }\n\n    yield* parseSSE(response.body);\n  }\n\n  /** List all sandboxes. */\n  async listSandboxes(): Promise<SandboxInfo[]> {\n    return this.request<SandboxInfo[]>(\"GET\", \"/sandboxes\");\n  }\n\n  /** Create a new sandbox. */\n  async createSandbox(\n    name: string,\n    opts?: CreateSandboxOptions,\n  ): Promise<SandboxInfo> {\n    return this.request<SandboxInfo>(\"POST\", \"/sandboxes\", {\n      name,\n      image: opts?.image,\n      vcpus: opts?.vcpus,\n      memory_mb: opts?.memory_mb,\n      profile: opts?.profile,\n      source_url: opts?.source_url,\n      source_ref: opts?.source_ref,\n    });\n  }\n\n  /** Get info about a sandbox. */\n  async getSandbox(name: string): Promise<SandboxInfo> {\n    return this.request<SandboxInfo>(\"GET\", `/sandboxes/${encodeURIComponent(name)}`);\n  }\n\n  /** Remove a sandbox. */\n  async removeSandbox(name: string): Promise<void> {\n    await this.request<string>(\"DELETE\", `/sandboxes/${encodeURIComponent(name)}`);\n  }\n\n  /** Run a command in an existing sandbox. */\n  async execInSandbox(\n    name: string,\n    command: string[],\n    opts?: ExecOptions,\n  ): Promise<RunOutput> {\n    return this.request<RunOutput>(\n      \"POST\",\n      `/sandboxes/${encodeURIComponent(name)}/exec`,\n      {\n        command,\n        env: opts?.env,\n        workdir: opts?.workdir,\n        sudo: opts?.sudo,\n      },\n    );\n  }\n\n  /** Read a file from a sandbox. */\n  async readFile(name: string, path: string): Promise<FileReadResponse> {\n    return this.request<FileReadResponse>(\n      \"GET\",\n      `/sandboxes/${encodeURIComponent(name)}/files/${path}`,\n    );\n  }\n\n  /** Write a file to a sandbox. */\n  async writeFile(\n    name: string,\n    path: string,\n    content: string,\n    opts?: FileWriteOptions,\n  ): Promise<string> {\n    return this.request<string>(\n      \"PUT\",\n      `/sandboxes/${encodeURIComponent(name)}/files/${path}`,\n      { content, encoding: opts?.encoding ?? \"utf8\" },\n    );\n  }\n\n  /** Delete a file from a sandbox. */\n  async deleteFile(name: string, path: string): Promise<string> {\n    return this.request<string>(\n      \"DELETE\",\n      `/sandboxes/${encodeURIComponent(name)}/files/${path}`,\n    );\n  }\n\n  /** Get audit log entries for a sandbox. */\n  async getSandboxLogs(name: string): Promise<Record<string, unknown>[]> {\n    return this.request<Record<string, unknown>[]>(\n      \"GET\",\n      `/sandboxes/${encodeURIComponent(name)}/logs`,\n    );\n  }\n\n  /** Write multiple files to a sandbox in one request. */\n  async writeFiles(\n    name: string,\n    files: Record<string, string>,\n  ): Promise<BatchFileWriteResponse> {\n    return this.request<BatchFileWriteResponse>(\n      \"POST\",\n      `/sandboxes/${encodeURIComponent(name)}/files`,\n      { files },\n    );\n  }\n\n  /** Run multiple commands in parallel. */\n  async batchRun(commands: BatchCommand[]): Promise<BatchRunResponse> {\n    return this.request<BatchRunResponse>(\"POST\", \"/batch/run\", { commands });\n  }\n\n  /** Start a detached (background) command in a sandbox. */\n  async execDetached(\n    name: string,\n    command: string[],\n    opts?: ExecOptions,\n  ): Promise<DetachedCommand> {\n    return this.request<DetachedCommand>(\n      \"POST\",\n      `/sandboxes/${encodeURIComponent(name)}/exec/detach`,\n      {\n        command,\n        env: opts?.env,\n        workdir: opts?.workdir,\n        sudo: opts?.sudo,\n      },\n    );\n  }\n\n  /** Get the status of a detached command. */\n  async detachedStatus(\n    name: string,\n    cmdId: string,\n  ): Promise<DetachedCommand> {\n    return this.request<DetachedCommand>(\n      \"GET\",\n      `/sandboxes/${encodeURIComponent(name)}/exec/detached/${encodeURIComponent(cmdId)}`,\n    );\n  }\n\n  /** Get logs from a detached command. */\n  async detachedLogs(\n    name: string,\n    cmdId: string,\n    stream?: \"stdout\" | \"stderr\",\n  ): Promise<DetachedLogsResponse> {\n    const query = stream === \"stderr\" ? \"?stream=stderr\" : \"\";\n    return this.request<DetachedLogsResponse>(\n      \"GET\",\n      `/sandboxes/${encodeURIComponent(name)}/exec/detached/${encodeURIComponent(cmdId)}/logs${query}`,\n    );\n  }\n\n  /** Kill a detached command. */\n  async detachedKill(name: string, cmdId: string): Promise<string> {\n    return this.request<string>(\n      \"DELETE\",\n      `/sandboxes/${encodeURIComponent(name)}/exec/detached/${encodeURIComponent(cmdId)}`,\n    );\n  }\n\n  /** List detached commands in a sandbox. */\n  async detachedList(name: string): Promise<DetachedCommand[]> {\n    return this.request<DetachedCommand[]>(\n      \"GET\",\n      `/sandboxes/${encodeURIComponent(name)}/exec/detached`,\n    );\n  }\n\n  /**\n   * Create a sandbox session with automatic cleanup.\n   *\n   * The returned SandboxSession implements AsyncDisposable,\n   * so it works with `await using` (TS 5.2+):\n   *\n   * @example\n   * ```ts\n   * await using sb = await client.sandbox(\"test\", { image: \"python:3.12-alpine\" });\n   * await sb.run([\"pip\", \"install\", \"numpy\"]);\n   * // sandbox auto-removed when scope exits\n   * ```\n   */\n  async sandbox(\n    name: string,\n    opts?: CreateSandboxOptions,\n  ): Promise<SandboxSession> {\n    await this.createSandbox(name, opts);\n    return new SandboxSession(\n      name,\n      (n, cmd, o) => this.execInSandbox(n, cmd, o),\n      (n) => this.removeSandbox(n),\n      (n) => this.getSandbox(n),\n      (n, f) => this.writeFiles(n, f),\n    );\n  }\n\n  // -- Internal helpers --\n\n  private headers(contentType?: string): Record<string, string> {\n    const h: Record<string, string> = {\n      \"User-Agent\": `agentkernel-nodejs-sdk/${SDK_VERSION}`,\n    };\n    if (contentType) h[\"Content-Type\"] = contentType;\n    if (this.apiKey) h[\"Authorization\"] = `Bearer ${this.apiKey}`;\n    return h;\n  }\n\n  private async fetch(path: string, init: RequestInit): Promise<Response> {\n    const url = `${this.baseUrl}${path}`;\n    try {\n      return await fetch(url, {\n        ...init,\n        signal: AbortSignal.timeout(this.timeout),\n      });\n    } catch (err) {\n      if (err instanceof DOMException && err.name === \"TimeoutError\") {\n        throw new NetworkError(`Request timed out after ${this.timeout}ms`);\n      }\n      if (err instanceof TypeError) {\n        throw new NetworkError(`Failed to connect to ${this.baseUrl}: ${err.message}`);\n      }\n      throw new NetworkError(\n        err instanceof Error ? err.message : String(err),\n      );\n    }\n  }\n\n  private async request<T>(\n    method: string,\n    path: string,\n    body?: unknown,\n  ): Promise<T> {\n    const init: RequestInit = {\n      method,\n      headers: this.headers(body ? \"application/json\" : undefined),\n    };\n    if (body) init.body = JSON.stringify(body);\n\n    const response = await this.fetch(path, init);\n\n    const text = await response.text();\n    if (!response.ok) {\n      throw errorFromStatus(response.status, text);\n    }\n\n    const parsed: ApiResponse<T> = JSON.parse(text);\n    if (!parsed.success) {\n      throw new AgentKernelError(parsed.error ?? \"Unknown error\");\n    }\n    return parsed.data as T;\n  }\n}\n"],"mappings":"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","names":[]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agentkernel",
-  "version": "0.8.0",
+  "version": "0.9.0",
   "description": "Node.js SDK for agentkernel — run AI coding agents in secure, isolated microVMs",
   "type": "module",
   "main": "./dist/index.cjs",