agentkernel 0.9.0 → 0.10.0

package/dist/index.cjs

@@ -23,6 +23,8 @@ __export(index_exports, {
   AgentKernel: () => AgentKernel,
   AgentKernelError: () => AgentKernelError,
   AuthError: () => AuthError,
+  BROWSER_SETUP_CMD: () => BROWSER_SETUP_CMD,
+  BrowserSession: () => BrowserSession,
   NetworkError: () => NetworkError,
   NotFoundError: () => NotFoundError,
   SandboxSession: () => SandboxSession,
@@ -113,6 +115,127 @@ function errorFromStatus(status, body) {
   }
 }
 
+// src/browser.ts
+var GOTO_SCRIPT = `
+import asyncio, json, sys
+from playwright.async_api import async_playwright
+async def main():
+    url = sys.argv[1]
+    async with async_playwright() as p:
+        b = await p.chromium.launch()
+        page = await b.new_page()
+        await page.goto(url, timeout=30000)
+        title = await page.title()
+        url_final = page.url
+        text = await page.evaluate("() => document.body.innerText.slice(0, 8000)")
+        links = await page.evaluate('''() =>
+            Array.from(document.querySelectorAll('a[href]'))
+                .slice(0, 50)
+                .map(a => ({text: a.textContent.trim(), href: a.href}))
+                .filter(l => l.href.startsWith("http"))
+        ''')
+        print(json.dumps({"title": title, "url": url_final, "text": text, "links": links}))
+        await b.close()
+asyncio.run(main())
+`;
+var SCREENSHOT_SCRIPT = `
+import asyncio, base64, sys
+from playwright.async_api import async_playwright
+async def main():
+    url = sys.argv[1]
+    async with async_playwright() as p:
+        b = await p.chromium.launch()
+        page = await b.new_page()
+        await page.goto(url, timeout=30000)
+        data = await page.screenshot()
+        print(base64.b64encode(data).decode())
+        await b.close()
+asyncio.run(main())
+`;
+var EVALUATE_SCRIPT = `
+import asyncio, json, sys
+from playwright.async_api import async_playwright
+async def main():
+    url = sys.argv[1]
+    expr = sys.argv[2]
+    async with async_playwright() as p:
+        b = await p.chromium.launch()
+        page = await b.new_page()
+        await page.goto(url, timeout=30000)
+        result = await page.evaluate(expr)
+        print(json.dumps(result))
+        await b.close()
+asyncio.run(main())
+`;
+var BROWSER_SETUP_CMD = [
+  "sh",
+  "-c",
+  "pip install -q playwright && playwright install --with-deps chromium"
+];
+var BrowserSession = class {
+  name;
+  _removed = false;
+  _lastUrl = null;
+  _run;
+  _remove;
+  /** @internal */
+  constructor(name, runFn, removeFn) {
+    this.name = name;
+    this._run = runFn;
+    this._remove = removeFn;
+  }
+  /** Navigate to a URL and return page data (title, text, links). */
+  async goto(url) {
+    const result = await this._run(this.name, [
+      "python3",
+      "-c",
+      GOTO_SCRIPT,
+      url
+    ]);
+    this._lastUrl = url;
+    return JSON.parse(result.output);
+  }
+  /** Take a PNG screenshot. Returns a base64-encoded string. */
+  async screenshot(url) {
+    const target = url ?? this._lastUrl;
+    if (!target) {
+      throw new Error("No URL specified and no previous goto() call");
+    }
+    const result = await this._run(this.name, [
+      "python3",
+      "-c",
+      SCREENSHOT_SCRIPT,
+      target
+    ]);
+    return result.output.trim();
+  }
+  /** Run a JavaScript expression on a page and return the result. */
+  async evaluate(expression, url) {
+    const target = url ?? this._lastUrl;
+    if (!target) {
+      throw new Error("No URL specified and no previous goto() call");
+    }
+    const result = await this._run(this.name, [
+      "python3",
+      "-c",
+      EVALUATE_SCRIPT,
+      target,
+      expression
+    ]);
+    return JSON.parse(result.output);
+  }
+  /** Remove the sandbox. Idempotent. */
+  async remove() {
+    if (this._removed) return;
+    this._removed = true;
+    await this._remove(this.name);
+  }
+  /** Auto-cleanup for `await using`. */
+  async [Symbol.asyncDispose]() {
+    await this.remove();
+  }
+};
+
 // src/sandbox.ts
 var SandboxSession = class {
   name;
@@ -223,7 +346,7 @@ async function* parseSSE(body) {
 }
 
 // src/client.ts
-var SDK_VERSION = "0.4.0";
+var SDK_VERSION = "0.3.0";
 var AgentKernel = class {
   baseUrl;
   apiKey;
@@ -293,7 +416,8 @@ var AgentKernel = class {
       memory_mb: opts?.memory_mb,
       profile: opts?.profile,
       source_url: opts?.source_url,
-      source_ref: opts?.source_ref
+      source_ref: opts?.source_ref,
+      volumes: opts?.volumes
     });
   }
   /** Get info about a sandbox. */
@@ -423,6 +547,71 @@ var AgentKernel = class {
       (n, f) => this.writeFiles(n, f)
     );
   }
+  /**
+   * Create a sandboxed browser session with automatic cleanup.
+   *
+   * Creates a sandbox with Chromium pre-installed via Playwright.
+   * Use `goto()`, `screenshot()`, and `evaluate()` to interact with web pages.
+   *
+   * @example
+   * ```ts
+   * await using browser = await client.browser("my-browser");
+   * const page = await browser.goto("https://example.com");
+   * console.log(page.title, page.links);
+   * // sandbox auto-removed when scope exits
+   * ```
+   */
+  async browser(name, opts) {
+    await this.createSandbox(name, {
+      image: "python:3.12-slim",
+      memory_mb: opts?.memory_mb ?? 2048,
+      profile: "moderate"
+    });
+    await this.execInSandbox(name, BROWSER_SETUP_CMD);
+    return new BrowserSession(
+      name,
+      (n, cmd) => this.execInSandbox(n, cmd),
+      (n) => this.removeSandbox(n)
+    );
+  }
+  // -- TTL & Snapshot methods --
+  /** Extend a sandbox's TTL. Returns the new expiry time. */
+  async extendTtl(name, opts) {
+    return this.request(
+      "POST",
+      `/sandboxes/${encodeURIComponent(name)}/extend`,
+      { by: opts.by }
+    );
+  }
+  /** List all snapshots. */
+  async listSnapshots() {
+    return this.request("GET", "/snapshots");
+  }
+  /** Take a snapshot of a sandbox. */
+  async takeSnapshot(opts) {
+    return this.request("POST", "/snapshots", opts);
+  }
+  /** Get info about a snapshot. */
+  async getSnapshot(name) {
+    return this.request(
+      "GET",
+      `/snapshots/${encodeURIComponent(name)}`
+    );
+  }
+  /** Delete a snapshot. */
+  async deleteSnapshot(name) {
+    await this.request(
+      "DELETE",
+      `/snapshots/${encodeURIComponent(name)}`
+    );
+  }
+  /** Restore a sandbox from a snapshot. */
+  async restoreSnapshot(name) {
+    return this.request(
+      "POST",
+      `/snapshots/${encodeURIComponent(name)}/restore`
+    );
+  }
   // -- Internal helpers --
   headers(contentType) {
     const h = {
@@ -474,6 +663,8 @@ var AgentKernel = class {
   AgentKernel,
   AgentKernelError,
   AuthError,
+  BROWSER_SETUP_CMD,
+  BrowserSession,
   NetworkError,
   NotFoundError,
   SandboxSession,

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  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":[]}
+{"version":3,"sources":["../src/index.ts","../src/config.ts","../src/errors.ts","../src/browser.ts","../src/sandbox.ts","../src/sse.ts","../src/client.ts"],"sourcesContent":["export { AgentKernel } from \"./client.js\";\nexport { BrowserSession, BROWSER_SETUP_CMD } from \"./browser.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  ExtendTtlOptions,\n  ExtendTtlResponse,\n  PageLink,\n  PageResult,\n  RunOptions,\n  RunOutput,\n  SandboxInfo,\n  SnapshotMeta,\n  StreamEvent,\n  StreamEventType,\n  SecurityProfile,\n  SandboxStatus,\n  TakeSnapshotOptions,\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","/**\n * Browser session for orchestrating headless browsers in sandboxes.\n *\n * Each method generates a self-contained Python/Playwright script,\n * runs it inside the sandbox, and parses the JSON result.\n */\n\nimport type { PageResult, RunOutput } from \"./types.js\";\n\ntype RunInSandboxFn = (\n  name: string,\n  command: string[],\n) => Promise<RunOutput>;\ntype RemoveSandboxFn = (name: string) => Promise<void>;\n\nconst GOTO_SCRIPT = `\nimport asyncio, json, sys\nfrom playwright.async_api import async_playwright\nasync def main():\n    url = sys.argv[1]\n    async with async_playwright() as p:\n        b = await p.chromium.launch()\n        page = await b.new_page()\n        await page.goto(url, timeout=30000)\n        title = await page.title()\n        url_final = page.url\n        text = await page.evaluate(\"() => document.body.innerText.slice(0, 8000)\")\n        links = await page.evaluate('''() =>\n            Array.from(document.querySelectorAll('a[href]'))\n                .slice(0, 50)\n                .map(a => ({text: a.textContent.trim(), href: a.href}))\n                .filter(l => l.href.startsWith(\"http\"))\n        ''')\n        print(json.dumps({\"title\": title, \"url\": url_final, \"text\": text, \"links\": links}))\n        await b.close()\nasyncio.run(main())\n`;\n\nconst SCREENSHOT_SCRIPT = `\nimport asyncio, base64, sys\nfrom playwright.async_api import async_playwright\nasync def main():\n    url = sys.argv[1]\n    async with async_playwright() as p:\n        b = await p.chromium.launch()\n        page = await b.new_page()\n        await page.goto(url, timeout=30000)\n        data = await page.screenshot()\n        print(base64.b64encode(data).decode())\n        await b.close()\nasyncio.run(main())\n`;\n\nconst EVALUATE_SCRIPT = `\nimport asyncio, json, sys\nfrom playwright.async_api import async_playwright\nasync def main():\n    url = sys.argv[1]\n    expr = sys.argv[2]\n    async with async_playwright() as p:\n        b = await p.chromium.launch()\n        page = await b.new_page()\n        await page.goto(url, timeout=30000)\n        result = await page.evaluate(expr)\n        print(json.dumps(result))\n        await b.close()\nasyncio.run(main())\n`;\n\n/** Command to install Playwright + Chromium inside the sandbox. */\nexport const BROWSER_SETUP_CMD = [\n  \"sh\",\n  \"-c\",\n  \"pip install -q playwright && playwright install --with-deps chromium\",\n];\n\n/**\n * A sandboxed headless browser controlled from outside.\n *\n * The browser (Chromium via Playwright) runs inside an agentkernel sandbox.\n * You call high-level methods; the SDK generates and runs scripts internally.\n *\n * @example\n * ```ts\n * await using browser = await client.browser(\"my-browser\");\n * const page = await browser.goto(\"https://example.com\");\n * console.log(page.title, page.links);\n * ```\n */\nexport class BrowserSession implements AsyncDisposable {\n  readonly name: string;\n  private _removed = false;\n  private _lastUrl: string | null = null;\n  private readonly _run: RunInSandboxFn;\n  private readonly _remove: RemoveSandboxFn;\n\n  /** @internal */\n  constructor(name: string, runFn: RunInSandboxFn, removeFn: RemoveSandboxFn) {\n    this.name = name;\n    this._run = runFn;\n    this._remove = removeFn;\n  }\n\n  /** Navigate to a URL and return page data (title, text, links). */\n  async goto(url: string): Promise<PageResult> {\n    const result = await this._run(this.name, [\n      \"python3\",\n      \"-c\",\n      GOTO_SCRIPT,\n      url,\n    ]);\n    this._lastUrl = url;\n    return JSON.parse(result.output) as PageResult;\n  }\n\n  /** Take a PNG screenshot. Returns a base64-encoded string. */\n  async screenshot(url?: string): Promise<string> {\n    const target = url ?? this._lastUrl;\n    if (!target) {\n      throw new Error(\"No URL specified and no previous goto() call\");\n    }\n    const result = await this._run(this.name, [\n      \"python3\",\n      \"-c\",\n      SCREENSHOT_SCRIPT,\n      target,\n    ]);\n    return result.output.trim();\n  }\n\n  /** Run a JavaScript expression on a page and return the result. */\n  async evaluate(expression: string, url?: string): Promise<unknown> {\n    const target = url ?? this._lastUrl;\n    if (!target) {\n      throw new Error(\"No URL specified and no previous goto() call\");\n    }\n    const result = await this._run(this.name, [\n      \"python3\",\n      \"-c\",\n      EVALUATE_SCRIPT,\n      target,\n      expression,\n    ]);\n    return JSON.parse(result.output);\n  }\n\n  /** Remove the sandbox. Idempotent. */\n  async remove(): Promise<void> {\n    if (this._removed) return;\n    this._removed = true;\n    await this._remove(this.name);\n  }\n\n  /** Auto-cleanup for `await using`. */\n  async [Symbol.asyncDispose](): Promise<void> {\n    await this.remove();\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 { BrowserSession, BROWSER_SETUP_CMD } from \"./browser.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  ExtendTtlOptions,\n  ExtendTtlResponse,\n  FileReadResponse,\n  FileWriteOptions,\n  RunOptions,\n  RunOutput,\n  SandboxInfo,\n  SnapshotMeta,\n  StreamEvent,\n  TakeSnapshotOptions,\n} from \"./types.js\";\n\nconst SDK_VERSION = \"0.3.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      volumes: opts?.volumes,\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  /**\n   * Create a sandboxed browser session with automatic cleanup.\n   *\n   * Creates a sandbox with Chromium pre-installed via Playwright.\n   * Use `goto()`, `screenshot()`, and `evaluate()` to interact with web pages.\n   *\n   * @example\n   * ```ts\n   * await using browser = await client.browser(\"my-browser\");\n   * const page = await browser.goto(\"https://example.com\");\n   * console.log(page.title, page.links);\n   * // sandbox auto-removed when scope exits\n   * ```\n   */\n  async browser(\n    name: string,\n    opts?: { memory_mb?: number },\n  ): Promise<BrowserSession> {\n    await this.createSandbox(name, {\n      image: \"python:3.12-slim\",\n      memory_mb: opts?.memory_mb ?? 2048,\n      profile: \"moderate\",\n    });\n    await this.execInSandbox(name, BROWSER_SETUP_CMD);\n    return new BrowserSession(\n      name,\n      (n, cmd) => this.execInSandbox(n, cmd),\n      (n) => this.removeSandbox(n),\n    );\n  }\n\n  // -- TTL & Snapshot methods --\n\n  /** Extend a sandbox's TTL. Returns the new expiry time. */\n  async extendTtl(name: string, opts: ExtendTtlOptions): Promise<ExtendTtlResponse> {\n    return this.request<ExtendTtlResponse>(\n      \"POST\",\n      `/sandboxes/${encodeURIComponent(name)}/extend`,\n      { by: opts.by },\n    );\n  }\n\n  /** List all snapshots. */\n  async listSnapshots(): Promise<SnapshotMeta[]> {\n    return this.request<SnapshotMeta[]>(\"GET\", \"/snapshots\");\n  }\n\n  /** Take a snapshot of a sandbox. */\n  async takeSnapshot(opts: TakeSnapshotOptions): Promise<SnapshotMeta> {\n    return this.request<SnapshotMeta>(\"POST\", \"/snapshots\", opts);\n  }\n\n  /** Get info about a snapshot. */\n  async getSnapshot(name: string): Promise<SnapshotMeta> {\n    return this.request<SnapshotMeta>(\n      \"GET\",\n      `/snapshots/${encodeURIComponent(name)}`,\n    );\n  }\n\n  /** Delete a snapshot. */\n  async deleteSnapshot(name: string): Promise<void> {\n    await this.request<string>(\n      \"DELETE\",\n      `/snapshots/${encodeURIComponent(name)}`,\n    );\n  }\n\n  /** Restore a sandbox from a snapshot. */\n  async restoreSnapshot(name: string): Promise<SandboxInfo> {\n    return this.request<SandboxInfo>(\n      \"POST\",\n      `/snapshots/${encodeURIComponent(name)}/restore`,\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

@@ -115,6 +115,93 @@ interface ApiResponse<T> {
     data?: T;
     error?: string;
 }
+/** Response from extending a sandbox's TTL. */
+interface ExtendTtlResponse {
+    expires_at?: string;
+}
+/** Options for extending TTL. */
+interface ExtendTtlOptions {
+    /** Duration string like "1h", "30m", "2d". */
+    by: string;
+}
+/** Metadata for a sandbox snapshot. */
+interface SnapshotMeta {
+    name: string;
+    sandbox: string;
+    image_tag: string;
+    backend: string;
+    base_image?: string;
+    vcpus?: number;
+    memory_mb?: number;
+    created_at: string;
+}
+/** Options for taking a snapshot. */
+interface TakeSnapshotOptions {
+    /** Name of the sandbox to snapshot. */
+    sandbox: string;
+    /** Optional snapshot name (auto-generated if not provided). */
+    name?: string;
+}
+/** A link extracted from a web page. */
+interface PageLink {
+    text: string;
+    href: string;
+}
+/** Result of navigating to a web page. */
+interface PageResult {
+    /** Page title. */
+    title: string;
+    /** Final URL after redirects. */
+    url: string;
+    /** Page body text (truncated to ~8KB). */
+    text: string;
+    /** First 50 links on the page. */
+    links: PageLink[];
+}
+
+/**
+ * Browser session for orchestrating headless browsers in sandboxes.
+ *
+ * Each method generates a self-contained Python/Playwright script,
+ * runs it inside the sandbox, and parses the JSON result.
+ */
+
+type RunInSandboxFn = (name: string, command: string[]) => Promise<RunOutput>;
+type RemoveSandboxFn = (name: string) => Promise<void>;
+/** Command to install Playwright + Chromium inside the sandbox. */
+declare const BROWSER_SETUP_CMD: string[];
+/**
+ * A sandboxed headless browser controlled from outside.
+ *
+ * The browser (Chromium via Playwright) runs inside an agentkernel sandbox.
+ * You call high-level methods; the SDK generates and runs scripts internally.
+ *
+ * @example
+ * ```ts
+ * await using browser = await client.browser("my-browser");
+ * const page = await browser.goto("https://example.com");
+ * console.log(page.title, page.links);
+ * ```
+ */
+declare class BrowserSession implements AsyncDisposable {
+    readonly name: string;
+    private _removed;
+    private _lastUrl;
+    private readonly _run;
+    private readonly _remove;
+    /** @internal */
+    constructor(name: string, runFn: RunInSandboxFn, removeFn: RemoveSandboxFn);
+    /** Navigate to a URL and return page data (title, text, links). */
+    goto(url: string): Promise<PageResult>;
+    /** Take a PNG screenshot. Returns a base64-encoded string. */
+    screenshot(url?: string): Promise<string>;
+    /** Run a JavaScript expression on a page and return the result. */
+    evaluate(expression: string, url?: string): Promise<unknown>;
+    /** Remove the sandbox. Idempotent. */
+    remove(): Promise<void>;
+    /** Auto-cleanup for `await using`. */
+    [Symbol.asyncDispose](): Promise<void>;
+}
 
 type ExecFn = (name: string, command: string[], opts?: ExecOptions) => Promise<RunOutput>;
 type RemoveFn = (name: string) => Promise<void>;
@@ -230,6 +317,35 @@ declare class AgentKernel {
      * ```
      */
     sandbox(name: string, opts?: CreateSandboxOptions): Promise<SandboxSession>;
+    /**
+     * Create a sandboxed browser session with automatic cleanup.
+     *
+     * Creates a sandbox with Chromium pre-installed via Playwright.
+     * Use `goto()`, `screenshot()`, and `evaluate()` to interact with web pages.
+     *
+     * @example
+     * ```ts
+     * await using browser = await client.browser("my-browser");
+     * const page = await browser.goto("https://example.com");
+     * console.log(page.title, page.links);
+     * // sandbox auto-removed when scope exits
+     * ```
+     */
+    browser(name: string, opts?: {
+        memory_mb?: number;
+    }): Promise<BrowserSession>;
+    /** Extend a sandbox's TTL. Returns the new expiry time. */
+    extendTtl(name: string, opts: ExtendTtlOptions): Promise<ExtendTtlResponse>;
+    /** List all snapshots. */
+    listSnapshots(): Promise<SnapshotMeta[]>;
+    /** Take a snapshot of a sandbox. */
+    takeSnapshot(opts: TakeSnapshotOptions): Promise<SnapshotMeta>;
+    /** Get info about a snapshot. */
+    getSnapshot(name: string): Promise<SnapshotMeta>;
+    /** Delete a snapshot. */
+    deleteSnapshot(name: string): Promise<void>;
+    /** Restore a sandbox from a snapshot. */
+    restoreSnapshot(name: string): Promise<SandboxInfo>;
     private headers;
     private fetch;
     private request;
@@ -268,4 +384,4 @@ declare class StreamError extends AgentKernelError {
     constructor(message?: string);
 }
 
-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 };
+export { AgentKernel, AgentKernelError, type AgentKernelOptions, type ApiResponse, AuthError, BROWSER_SETUP_CMD, type BatchFileWriteResponse, BrowserSession, type CreateSandboxOptions, type DetachedCommand, type DetachedLogsResponse, type DetachedStatus, type ExecOptions, type ExtendTtlOptions, type ExtendTtlResponse, NetworkError, NotFoundError, type PageLink, type PageResult, type RunOptions, type RunOutput, type SandboxInfo, SandboxSession, type SandboxStatus, type SecurityProfile, ServerError, type SnapshotMeta, StreamError, type StreamEvent, type StreamEventType, type TakeSnapshotOptions, ValidationError };

package/dist/index.d.ts

@@ -115,6 +115,93 @@ interface ApiResponse<T> {
     data?: T;
     error?: string;
 }
+/** Response from extending a sandbox's TTL. */
+interface ExtendTtlResponse {
+    expires_at?: string;
+}
+/** Options for extending TTL. */
+interface ExtendTtlOptions {
+    /** Duration string like "1h", "30m", "2d". */
+    by: string;
+}
+/** Metadata for a sandbox snapshot. */
+interface SnapshotMeta {
+    name: string;
+    sandbox: string;
+    image_tag: string;
+    backend: string;
+    base_image?: string;
+    vcpus?: number;
+    memory_mb?: number;
+    created_at: string;
+}
+/** Options for taking a snapshot. */
+interface TakeSnapshotOptions {
+    /** Name of the sandbox to snapshot. */
+    sandbox: string;
+    /** Optional snapshot name (auto-generated if not provided). */
+    name?: string;
+}
+/** A link extracted from a web page. */
+interface PageLink {
+    text: string;
+    href: string;
+}
+/** Result of navigating to a web page. */
+interface PageResult {
+    /** Page title. */
+    title: string;
+    /** Final URL after redirects. */
+    url: string;
+    /** Page body text (truncated to ~8KB). */
+    text: string;
+    /** First 50 links on the page. */
+    links: PageLink[];
+}
+
+/**
+ * Browser session for orchestrating headless browsers in sandboxes.
+ *
+ * Each method generates a self-contained Python/Playwright script,
+ * runs it inside the sandbox, and parses the JSON result.
+ */
+
+type RunInSandboxFn = (name: string, command: string[]) => Promise<RunOutput>;
+type RemoveSandboxFn = (name: string) => Promise<void>;
+/** Command to install Playwright + Chromium inside the sandbox. */
+declare const BROWSER_SETUP_CMD: string[];
+/**
+ * A sandboxed headless browser controlled from outside.
+ *
+ * The browser (Chromium via Playwright) runs inside an agentkernel sandbox.
+ * You call high-level methods; the SDK generates and runs scripts internally.
+ *
+ * @example
+ * ```ts
+ * await using browser = await client.browser("my-browser");
+ * const page = await browser.goto("https://example.com");
+ * console.log(page.title, page.links);
+ * ```
+ */
+declare class BrowserSession implements AsyncDisposable {
+    readonly name: string;
+    private _removed;
+    private _lastUrl;
+    private readonly _run;
+    private readonly _remove;
+    /** @internal */
+    constructor(name: string, runFn: RunInSandboxFn, removeFn: RemoveSandboxFn);
+    /** Navigate to a URL and return page data (title, text, links). */
+    goto(url: string): Promise<PageResult>;
+    /** Take a PNG screenshot. Returns a base64-encoded string. */
+    screenshot(url?: string): Promise<string>;
+    /** Run a JavaScript expression on a page and return the result. */
+    evaluate(expression: string, url?: string): Promise<unknown>;
+    /** Remove the sandbox. Idempotent. */
+    remove(): Promise<void>;
+    /** Auto-cleanup for `await using`. */
+    [Symbol.asyncDispose](): Promise<void>;
+}
 
 type ExecFn = (name: string, command: string[], opts?: ExecOptions) => Promise<RunOutput>;
 type RemoveFn = (name: string) => Promise<void>;
@@ -230,6 +317,35 @@ declare class AgentKernel {
      * ```
      */
     sandbox(name: string, opts?: CreateSandboxOptions): Promise<SandboxSession>;
+    /**
+     * Create a sandboxed browser session with automatic cleanup.
+     *
+     * Creates a sandbox with Chromium pre-installed via Playwright.
+     * Use `goto()`, `screenshot()`, and `evaluate()` to interact with web pages.
+     *
+     * @example
+     * ```ts
+     * await using browser = await client.browser("my-browser");
+     * const page = await browser.goto("https://example.com");
+     * console.log(page.title, page.links);
+     * // sandbox auto-removed when scope exits
+     * ```
+     */
+    browser(name: string, opts?: {
+        memory_mb?: number;
+    }): Promise<BrowserSession>;
+    /** Extend a sandbox's TTL. Returns the new expiry time. */
+    extendTtl(name: string, opts: ExtendTtlOptions): Promise<ExtendTtlResponse>;
+    /** List all snapshots. */
+    listSnapshots(): Promise<SnapshotMeta[]>;
+    /** Take a snapshot of a sandbox. */
+    takeSnapshot(opts: TakeSnapshotOptions): Promise<SnapshotMeta>;
+    /** Get info about a snapshot. */
+    getSnapshot(name: string): Promise<SnapshotMeta>;
+    /** Delete a snapshot. */
+    deleteSnapshot(name: string): Promise<void>;
+    /** Restore a sandbox from a snapshot. */
+    restoreSnapshot(name: string): Promise<SandboxInfo>;
     private headers;
     private fetch;
     private request;
@@ -268,4 +384,4 @@ declare class StreamError extends AgentKernelError {
     constructor(message?: string);
 }
 
-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 };
+export { AgentKernel, AgentKernelError, type AgentKernelOptions, type ApiResponse, AuthError, BROWSER_SETUP_CMD, type BatchFileWriteResponse, BrowserSession, type CreateSandboxOptions, type DetachedCommand, type DetachedLogsResponse, type DetachedStatus, type ExecOptions, type ExtendTtlOptions, type ExtendTtlResponse, NetworkError, NotFoundError, type PageLink, type PageResult, type RunOptions, type RunOutput, type SandboxInfo, SandboxSession, type SandboxStatus, type SecurityProfile, ServerError, type SnapshotMeta, StreamError, type StreamEvent, type StreamEventType, type TakeSnapshotOptions, ValidationError };

package/dist/index.js

@@ -79,6 +79,127 @@ function errorFromStatus(status, body) {
   }
 }
 
+// src/browser.ts
+var GOTO_SCRIPT = `
+import asyncio, json, sys
+from playwright.async_api import async_playwright
+async def main():
+    url = sys.argv[1]
+    async with async_playwright() as p:
+        b = await p.chromium.launch()
+        page = await b.new_page()
+        await page.goto(url, timeout=30000)
+        title = await page.title()
+        url_final = page.url
+        text = await page.evaluate("() => document.body.innerText.slice(0, 8000)")
+        links = await page.evaluate('''() =>
+            Array.from(document.querySelectorAll('a[href]'))
+                .slice(0, 50)
+                .map(a => ({text: a.textContent.trim(), href: a.href}))
+                .filter(l => l.href.startsWith("http"))
+        ''')
+        print(json.dumps({"title": title, "url": url_final, "text": text, "links": links}))
+        await b.close()
+asyncio.run(main())
+`;
+var SCREENSHOT_SCRIPT = `
+import asyncio, base64, sys
+from playwright.async_api import async_playwright
+async def main():
+    url = sys.argv[1]
+    async with async_playwright() as p:
+        b = await p.chromium.launch()
+        page = await b.new_page()
+        await page.goto(url, timeout=30000)
+        data = await page.screenshot()
+        print(base64.b64encode(data).decode())
+        await b.close()
+asyncio.run(main())
+`;
+var EVALUATE_SCRIPT = `
+import asyncio, json, sys
+from playwright.async_api import async_playwright
+async def main():
+    url = sys.argv[1]
+    expr = sys.argv[2]
+    async with async_playwright() as p:
+        b = await p.chromium.launch()
+        page = await b.new_page()
+        await page.goto(url, timeout=30000)
+        result = await page.evaluate(expr)
+        print(json.dumps(result))
+        await b.close()
+asyncio.run(main())
+`;
+var BROWSER_SETUP_CMD = [
+  "sh",
+  "-c",
+  "pip install -q playwright && playwright install --with-deps chromium"
+];
+var BrowserSession = class {
+  name;
+  _removed = false;
+  _lastUrl = null;
+  _run;
+  _remove;
+  /** @internal */
+  constructor(name, runFn, removeFn) {
+    this.name = name;
+    this._run = runFn;
+    this._remove = removeFn;
+  }
+  /** Navigate to a URL and return page data (title, text, links). */
+  async goto(url) {
+    const result = await this._run(this.name, [
+      "python3",
+      "-c",
+      GOTO_SCRIPT,
+      url
+    ]);
+    this._lastUrl = url;
+    return JSON.parse(result.output);
+  }
+  /** Take a PNG screenshot. Returns a base64-encoded string. */
+  async screenshot(url) {
+    const target = url ?? this._lastUrl;
+    if (!target) {
+      throw new Error("No URL specified and no previous goto() call");
+    }
+    const result = await this._run(this.name, [
+      "python3",
+      "-c",
+      SCREENSHOT_SCRIPT,
+      target
+    ]);
+    return result.output.trim();
+  }
+  /** Run a JavaScript expression on a page and return the result. */
+  async evaluate(expression, url) {
+    const target = url ?? this._lastUrl;
+    if (!target) {
+      throw new Error("No URL specified and no previous goto() call");
+    }
+    const result = await this._run(this.name, [
+      "python3",
+      "-c",
+      EVALUATE_SCRIPT,
+      target,
+      expression
+    ]);
+    return JSON.parse(result.output);
+  }
+  /** Remove the sandbox. Idempotent. */
+  async remove() {
+    if (this._removed) return;
+    this._removed = true;
+    await this._remove(this.name);
+  }
+  /** Auto-cleanup for `await using`. */
+  async [Symbol.asyncDispose]() {
+    await this.remove();
+  }
+};
+
 // src/sandbox.ts
 var SandboxSession = class {
   name;
@@ -189,7 +310,7 @@ async function* parseSSE(body) {
 }
 
 // src/client.ts
-var SDK_VERSION = "0.4.0";
+var SDK_VERSION = "0.3.0";
 var AgentKernel = class {
   baseUrl;
   apiKey;
@@ -259,7 +380,8 @@ var AgentKernel = class {
       memory_mb: opts?.memory_mb,
       profile: opts?.profile,
       source_url: opts?.source_url,
-      source_ref: opts?.source_ref
+      source_ref: opts?.source_ref,
+      volumes: opts?.volumes
     });
   }
   /** Get info about a sandbox. */
@@ -389,6 +511,71 @@ var AgentKernel = class {
       (n, f) => this.writeFiles(n, f)
     );
   }
+  /**
+   * Create a sandboxed browser session with automatic cleanup.
+   *
+   * Creates a sandbox with Chromium pre-installed via Playwright.
+   * Use `goto()`, `screenshot()`, and `evaluate()` to interact with web pages.
+   *
+   * @example
+   * ```ts
+   * await using browser = await client.browser("my-browser");
+   * const page = await browser.goto("https://example.com");
+   * console.log(page.title, page.links);
+   * // sandbox auto-removed when scope exits
+   * ```
+   */
+  async browser(name, opts) {
+    await this.createSandbox(name, {
+      image: "python:3.12-slim",
+      memory_mb: opts?.memory_mb ?? 2048,
+      profile: "moderate"
+    });
+    await this.execInSandbox(name, BROWSER_SETUP_CMD);
+    return new BrowserSession(
+      name,
+      (n, cmd) => this.execInSandbox(n, cmd),
+      (n) => this.removeSandbox(n)
+    );
+  }
+  // -- TTL & Snapshot methods --
+  /** Extend a sandbox's TTL. Returns the new expiry time. */
+  async extendTtl(name, opts) {
+    return this.request(
+      "POST",
+      `/sandboxes/${encodeURIComponent(name)}/extend`,
+      { by: opts.by }
+    );
+  }
+  /** List all snapshots. */
+  async listSnapshots() {
+    return this.request("GET", "/snapshots");
+  }
+  /** Take a snapshot of a sandbox. */
+  async takeSnapshot(opts) {
+    return this.request("POST", "/snapshots", opts);
+  }
+  /** Get info about a snapshot. */
+  async getSnapshot(name) {
+    return this.request(
+      "GET",
+      `/snapshots/${encodeURIComponent(name)}`
+    );
+  }
+  /** Delete a snapshot. */
+  async deleteSnapshot(name) {
+    await this.request(
+      "DELETE",
+      `/snapshots/${encodeURIComponent(name)}`
+    );
+  }
+  /** Restore a sandbox from a snapshot. */
+  async restoreSnapshot(name) {
+    return this.request(
+      "POST",
+      `/snapshots/${encodeURIComponent(name)}/restore`
+    );
+  }
   // -- Internal helpers --
   headers(contentType) {
     const h = {
@@ -439,6 +626,8 @@ export {
   AgentKernel,
   AgentKernelError,
   AuthError,
+  BROWSER_SETUP_CMD,
+  BrowserSession,
   NetworkError,
   NotFoundError,
   SandboxSession,

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 {\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":[]}
+{"version":3,"sources":["../src/config.ts","../src/errors.ts","../src/browser.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","/**\n * Browser session for orchestrating headless browsers in sandboxes.\n *\n * Each method generates a self-contained Python/Playwright script,\n * runs it inside the sandbox, and parses the JSON result.\n */\n\nimport type { PageResult, RunOutput } from \"./types.js\";\n\ntype RunInSandboxFn = (\n  name: string,\n  command: string[],\n) => Promise<RunOutput>;\ntype RemoveSandboxFn = (name: string) => Promise<void>;\n\nconst GOTO_SCRIPT = `\nimport asyncio, json, sys\nfrom playwright.async_api import async_playwright\nasync def main():\n    url = sys.argv[1]\n    async with async_playwright() as p:\n        b = await p.chromium.launch()\n        page = await b.new_page()\n        await page.goto(url, timeout=30000)\n        title = await page.title()\n        url_final = page.url\n        text = await page.evaluate(\"() => document.body.innerText.slice(0, 8000)\")\n        links = await page.evaluate('''() =>\n            Array.from(document.querySelectorAll('a[href]'))\n                .slice(0, 50)\n                .map(a => ({text: a.textContent.trim(), href: a.href}))\n                .filter(l => l.href.startsWith(\"http\"))\n        ''')\n        print(json.dumps({\"title\": title, \"url\": url_final, \"text\": text, \"links\": links}))\n        await b.close()\nasyncio.run(main())\n`;\n\nconst SCREENSHOT_SCRIPT = `\nimport asyncio, base64, sys\nfrom playwright.async_api import async_playwright\nasync def main():\n    url = sys.argv[1]\n    async with async_playwright() as p:\n        b = await p.chromium.launch()\n        page = await b.new_page()\n        await page.goto(url, timeout=30000)\n        data = await page.screenshot()\n        print(base64.b64encode(data).decode())\n        await b.close()\nasyncio.run(main())\n`;\n\nconst EVALUATE_SCRIPT = `\nimport asyncio, json, sys\nfrom playwright.async_api import async_playwright\nasync def main():\n    url = sys.argv[1]\n    expr = sys.argv[2]\n    async with async_playwright() as p:\n        b = await p.chromium.launch()\n        page = await b.new_page()\n        await page.goto(url, timeout=30000)\n        result = await page.evaluate(expr)\n        print(json.dumps(result))\n        await b.close()\nasyncio.run(main())\n`;\n\n/** Command to install Playwright + Chromium inside the sandbox. */\nexport const BROWSER_SETUP_CMD = [\n  \"sh\",\n  \"-c\",\n  \"pip install -q playwright && playwright install --with-deps chromium\",\n];\n\n/**\n * A sandboxed headless browser controlled from outside.\n *\n * The browser (Chromium via Playwright) runs inside an agentkernel sandbox.\n * You call high-level methods; the SDK generates and runs scripts internally.\n *\n * @example\n * ```ts\n * await using browser = await client.browser(\"my-browser\");\n * const page = await browser.goto(\"https://example.com\");\n * console.log(page.title, page.links);\n * ```\n */\nexport class BrowserSession implements AsyncDisposable {\n  readonly name: string;\n  private _removed = false;\n  private _lastUrl: string | null = null;\n  private readonly _run: RunInSandboxFn;\n  private readonly _remove: RemoveSandboxFn;\n\n  /** @internal */\n  constructor(name: string, runFn: RunInSandboxFn, removeFn: RemoveSandboxFn) {\n    this.name = name;\n    this._run = runFn;\n    this._remove = removeFn;\n  }\n\n  /** Navigate to a URL and return page data (title, text, links). */\n  async goto(url: string): Promise<PageResult> {\n    const result = await this._run(this.name, [\n      \"python3\",\n      \"-c\",\n      GOTO_SCRIPT,\n      url,\n    ]);\n    this._lastUrl = url;\n    return JSON.parse(result.output) as PageResult;\n  }\n\n  /** Take a PNG screenshot. Returns a base64-encoded string. */\n  async screenshot(url?: string): Promise<string> {\n    const target = url ?? this._lastUrl;\n    if (!target) {\n      throw new Error(\"No URL specified and no previous goto() call\");\n    }\n    const result = await this._run(this.name, [\n      \"python3\",\n      \"-c\",\n      SCREENSHOT_SCRIPT,\n      target,\n    ]);\n    return result.output.trim();\n  }\n\n  /** Run a JavaScript expression on a page and return the result. */\n  async evaluate(expression: string, url?: string): Promise<unknown> {\n    const target = url ?? this._lastUrl;\n    if (!target) {\n      throw new Error(\"No URL specified and no previous goto() call\");\n    }\n    const result = await this._run(this.name, [\n      \"python3\",\n      \"-c\",\n      EVALUATE_SCRIPT,\n      target,\n      expression,\n    ]);\n    return JSON.parse(result.output);\n  }\n\n  /** Remove the sandbox. Idempotent. */\n  async remove(): Promise<void> {\n    if (this._removed) return;\n    this._removed = true;\n    await this._remove(this.name);\n  }\n\n  /** Auto-cleanup for `await using`. */\n  async [Symbol.asyncDispose](): Promise<void> {\n    await this.remove();\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 { BrowserSession, BROWSER_SETUP_CMD } from \"./browser.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  ExtendTtlOptions,\n  ExtendTtlResponse,\n  FileReadResponse,\n  FileWriteOptions,\n  RunOptions,\n  RunOutput,\n  SandboxInfo,\n  SnapshotMeta,\n  StreamEvent,\n  TakeSnapshotOptions,\n} from \"./types.js\";\n\nconst SDK_VERSION = \"0.3.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      volumes: opts?.volumes,\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  /**\n   * Create a sandboxed browser session with automatic cleanup.\n   *\n   * Creates a sandbox with Chromium pre-installed via Playwright.\n   * Use `goto()`, `screenshot()`, and `evaluate()` to interact with web pages.\n   *\n   * @example\n   * ```ts\n   * await using browser = await client.browser(\"my-browser\");\n   * const page = await browser.goto(\"https://example.com\");\n   * console.log(page.title, page.links);\n   * // sandbox auto-removed when scope exits\n   * ```\n   */\n  async browser(\n    name: string,\n    opts?: { memory_mb?: number },\n  ): Promise<BrowserSession> {\n    await this.createSandbox(name, {\n      image: \"python:3.12-slim\",\n      memory_mb: opts?.memory_mb ?? 2048,\n      profile: \"moderate\",\n    });\n    await this.execInSandbox(name, BROWSER_SETUP_CMD);\n    return new BrowserSession(\n      name,\n      (n, cmd) => this.execInSandbox(n, cmd),\n      (n) => this.removeSandbox(n),\n    );\n  }\n\n  // -- TTL & Snapshot methods --\n\n  /** Extend a sandbox's TTL. Returns the new expiry time. */\n  async extendTtl(name: string, opts: ExtendTtlOptions): Promise<ExtendTtlResponse> {\n    return this.request<ExtendTtlResponse>(\n      \"POST\",\n      `/sandboxes/${encodeURIComponent(name)}/extend`,\n      { by: opts.by },\n    );\n  }\n\n  /** List all snapshots. */\n  async listSnapshots(): Promise<SnapshotMeta[]> {\n    return this.request<SnapshotMeta[]>(\"GET\", \"/snapshots\");\n  }\n\n  /** Take a snapshot of a sandbox. */\n  async takeSnapshot(opts: TakeSnapshotOptions): Promise<SnapshotMeta> {\n    return this.request<SnapshotMeta>(\"POST\", \"/snapshots\", opts);\n  }\n\n  /** Get info about a snapshot. */\n  async getSnapshot(name: string): Promise<SnapshotMeta> {\n    return this.request<SnapshotMeta>(\n      \"GET\",\n      `/snapshots/${encodeURIComponent(name)}`,\n    );\n  }\n\n  /** Delete a snapshot. */\n  async deleteSnapshot(name: string): Promise<void> {\n    await this.request<string>(\n      \"DELETE\",\n      `/snapshots/${encodeURIComponent(name)}`,\n    );\n  }\n\n  /** Restore a sandbox from a snapshot. */\n  async restoreSnapshot(name: string): Promise<SandboxInfo> {\n    return this.request<SandboxInfo>(\n      \"POST\",\n      `/snapshots/${encodeURIComponent(name)}/restore`,\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.9.0",
+  "version": "0.10.0",
   "description": "Node.js SDK for agentkernel — run AI coding agents in secure, isolated microVMs",
   "type": "module",
   "main": "./dist/index.cjs",