agentkernel 0.8.0 → 0.10.0

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