agentkernel 0.19.0 → 0.20.0

package/README.md

@@ -8,7 +8,7 @@ Node.js SDK for [agentkernel](https://github.com/thrashr888/agentkernel) — run
 npm install agentkernel
 ```
 
-Requires Node.js 20+. Zero HTTP dependencies (uses native `fetch`).
+Requires Node.js 22.13+. Zero HTTP dependencies (uses native `fetch`).
 
 ## Quick Start
 

package/dist/browser.d.cts

@@ -0,0 +1,67 @@
+/**
+ * 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.
+ */
+import type { AriaSnapshot, PageResult, RunOutput } from "./types.cjs";
+type RunInSandboxFn = (name: string, command: string[]) => Promise<RunOutput>;
+type RemoveSandboxFn = (name: string) => Promise<void>;
+/** Command to install Playwright + Chromium inside the sandbox. */
+export 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);
+ * ```
+ */
+export 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>;
+    /** Navigate to a URL and return an ARIA snapshot. */
+    open(url: string, page?: string): Promise<AriaSnapshot>;
+    /** Get the current ARIA snapshot without navigating. */
+    snapshot(page?: string): Promise<AriaSnapshot>;
+    /** Click an element by ref ID or CSS selector. Returns new snapshot. */
+    click(opts: {
+        ref?: string;
+        selector?: string;
+        page?: string;
+    }): Promise<AriaSnapshot>;
+    /** Fill an input by ref ID or CSS selector. Returns new snapshot. */
+    fill(value: string, opts: {
+        ref?: string;
+        selector?: string;
+        page?: string;
+    }): Promise<AriaSnapshot>;
+    /** Close a named page. */
+    closePage(page?: string): Promise<void>;
+    /** List active page names. */
+    listPages(): Promise<string[]>;
+    private _serverStarted;
+    private _ensureServer;
+    private _browserRequest;
+    /** Remove the sandbox. Idempotent. */
+    remove(): Promise<void>;
+    /** Auto-cleanup for `await using`. */
+    [Symbol.asyncDispose](): Promise<void>;
+}
+export {};

package/dist/browser.d.ts

@@ -0,0 +1,67 @@
+/**
+ * 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.
+ */
+import type { AriaSnapshot, PageResult, RunOutput } from "./types.js";
+type RunInSandboxFn = (name: string, command: string[]) => Promise<RunOutput>;
+type RemoveSandboxFn = (name: string) => Promise<void>;
+/** Command to install Playwright + Chromium inside the sandbox. */
+export 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);
+ * ```
+ */
+export 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>;
+    /** Navigate to a URL and return an ARIA snapshot. */
+    open(url: string, page?: string): Promise<AriaSnapshot>;
+    /** Get the current ARIA snapshot without navigating. */
+    snapshot(page?: string): Promise<AriaSnapshot>;
+    /** Click an element by ref ID or CSS selector. Returns new snapshot. */
+    click(opts: {
+        ref?: string;
+        selector?: string;
+        page?: string;
+    }): Promise<AriaSnapshot>;
+    /** Fill an input by ref ID or CSS selector. Returns new snapshot. */
+    fill(value: string, opts: {
+        ref?: string;
+        selector?: string;
+        page?: string;
+    }): Promise<AriaSnapshot>;
+    /** Close a named page. */
+    closePage(page?: string): Promise<void>;
+    /** List active page names. */
+    listPages(): Promise<string[]>;
+    private _serverStarted;
+    private _ensureServer;
+    private _browserRequest;
+    /** Remove the sandbox. Idempotent. */
+    remove(): Promise<void>;
+    /** Auto-cleanup for `await using`. */
+    [Symbol.asyncDispose](): Promise<void>;
+}
+export {};

package/dist/client.d.cts

@@ -0,0 +1,169 @@
+import { BrowserSession } from "./browser.cjs";
+import { SandboxSession } from "./sandbox.cjs";
+import type { AgentKernelOptions, BatchCommand, BatchFileWriteResponse, BatchRunResponse, CreateStoreRequest, CreateObjectRequest, CreateOrchestrationRequest, CreateScheduleRequest, CreateSandboxOptions, DetachedCommand, DetachedLogsResponse, ExecOptions, ExtendTtlOptions, ExtendTtlResponse, DurableObject, DurableStore, DurableStoreCommandResponse, DurableStoreExecuteResponse, DurableStoreQueryResponse, FileReadResponse, FileWriteOptions, OrchestrationDefinition, RunOptions, RunOutput, Orchestration, SandboxInfo, Schedule, SnapshotMeta, StreamEvent, TakeSnapshotOptions } from "./types.cjs";
+/**
+ * Client for the agentkernel HTTP API.
+ *
+ * @example
+ * ```ts
+ * const client = new AgentKernel();
+ * const result = await client.run(["echo", "hello"]);
+ * console.log(result.output); // "hello\n"
+ * ```
+ */
+export declare class AgentKernel {
+    private readonly baseUrl;
+    private readonly apiKey;
+    private readonly timeout;
+    constructor(opts?: AgentKernelOptions);
+    /** Health check. Returns "ok" if the server is running. */
+    health(): Promise<string>;
+    /** Run a command in a temporary sandbox. */
+    run(command: string[], opts?: RunOptions): Promise<RunOutput>;
+    /**
+     * Run a command with SSE streaming output.
+     *
+     * @example
+     * ```ts
+     * for await (const event of client.runStream(["python3", "script.py"])) {
+     *   if (event.type === "output") process.stdout.write(String(event.data.data));
+     * }
+     * ```
+     */
+    runStream(command: string[], opts?: RunOptions): AsyncGenerator<StreamEvent>;
+    /** List all sandboxes. */
+    listSandboxes(): Promise<SandboxInfo[]>;
+    /** Create a new sandbox. */
+    createSandbox(name: string, opts?: CreateSandboxOptions): Promise<SandboxInfo>;
+    /** Get info about a sandbox. */
+    getSandbox(name: string): Promise<SandboxInfo>;
+    /** Get info about a sandbox by UUID. */
+    getSandboxByUuid(uuid: string): Promise<SandboxInfo>;
+    /** Remove a sandbox. */
+    removeSandbox(name: string): Promise<void>;
+    /** Run a command in an existing sandbox. */
+    execInSandbox(name: string, command: string[], opts?: ExecOptions): Promise<RunOutput>;
+    /** Read a file from a sandbox. */
+    readFile(name: string, path: string): Promise<FileReadResponse>;
+    /** Write a file to a sandbox. */
+    writeFile(name: string, path: string, content: string, opts?: FileWriteOptions): Promise<string>;
+    /** Delete a file from a sandbox. */
+    deleteFile(name: string, path: string): Promise<string>;
+    /** Get audit log entries for a sandbox. */
+    getSandboxLogs(name: string): Promise<Record<string, unknown>[]>;
+    /** Write multiple files to a sandbox in one request. */
+    writeFiles(name: string, files: Record<string, string>): Promise<BatchFileWriteResponse>;
+    /** Run multiple commands in parallel. */
+    batchRun(commands: BatchCommand[]): Promise<BatchRunResponse>;
+    /** Start a detached (background) command in a sandbox. */
+    execDetached(name: string, command: string[], opts?: ExecOptions): Promise<DetachedCommand>;
+    /** Get the status of a detached command. */
+    detachedStatus(name: string, cmdId: string): Promise<DetachedCommand>;
+    /** Get logs from a detached command. */
+    detachedLogs(name: string, cmdId: string, stream?: "stdout" | "stderr"): Promise<DetachedLogsResponse>;
+    /** Kill a detached command. */
+    detachedKill(name: string, cmdId: string): Promise<string>;
+    /** List detached commands in a sandbox. */
+    detachedList(name: string): Promise<DetachedCommand[]>;
+    /** List all orchestrations. */
+    listOrchestrations(): Promise<Orchestration[]>;
+    /** Create a new orchestration. */
+    createOrchestration(payload: CreateOrchestrationRequest): Promise<Orchestration>;
+    /** Get info about an orchestration by identifier. */
+    getOrchestration(id: string): Promise<Orchestration>;
+    /** Raise an external event for an orchestration. */
+    signalOrchestration(id: string, payload: Record<string, unknown>): Promise<Orchestration>;
+    /** Terminate an orchestration. */
+    terminateOrchestration(id: string, payload?: Record<string, unknown>): Promise<Orchestration>;
+    /** List orchestration definitions. */
+    listOrchestrationDefinitions(): Promise<OrchestrationDefinition[]>;
+    /** Register or update an orchestration definition. */
+    upsertOrchestrationDefinition(payload: OrchestrationDefinition): Promise<OrchestrationDefinition>;
+    /** Get an orchestration definition by name. */
+    getOrchestrationDefinition(name: string): Promise<OrchestrationDefinition>;
+    /** Delete an orchestration definition by name. */
+    deleteOrchestrationDefinition(name: string): Promise<string>;
+    /** List all objects. */
+    listObjects(): Promise<DurableObject[]>;
+    /** Create a new object. */
+    createObject(payload: CreateObjectRequest): Promise<DurableObject>;
+    /** Get an object by identifier. */
+    getObject(id: string): Promise<DurableObject>;
+    /** Call a method on a durable object (auto-creates/wakes if needed). */
+    callObject(className: string, objectId: string, method: string, args?: Record<string, unknown>): Promise<unknown>;
+    /** Delete a durable object by identifier. */
+    deleteObject(id: string): Promise<string>;
+    /** Partially update a durable object (storage and/or status). */
+    patchObject(id: string, payload: {
+        storage?: unknown;
+        status?: string;
+    }): Promise<DurableObject>;
+    /** List all schedules. */
+    listSchedules(): Promise<Schedule[]>;
+    /** Create a new schedule. */
+    createSchedule(payload: CreateScheduleRequest): Promise<Schedule>;
+    /** Get a schedule by identifier. */
+    getSchedule(id: string): Promise<Schedule>;
+    /** Delete a schedule by identifier. */
+    deleteSchedule(id: string): Promise<string>;
+    /** List all durable stores. */
+    listStores(): Promise<DurableStore[]>;
+    /** Create a durable store. */
+    createStore(payload: CreateStoreRequest): Promise<DurableStore>;
+    /** Get a durable store by identifier. */
+    getStore(id: string): Promise<DurableStore>;
+    /** Delete a durable store by identifier. */
+    deleteStore(id: string): Promise<string>;
+    /** Execute a read query against a durable store. */
+    queryStore(id: string, payload: Record<string, unknown>): Promise<DurableStoreQueryResponse>;
+    /** Execute a write statement against a durable store. */
+    executeStore(id: string, payload: Record<string, unknown>): Promise<DurableStoreExecuteResponse>;
+    /** Execute a command against a durable store (Redis-style engines). */
+    commandStore(id: string, payload: Record<string, unknown>): Promise<DurableStoreCommandResponse>;
+    /**
+     * Create a sandbox session with automatic cleanup.
+     *
+     * The returned SandboxSession implements AsyncDisposable,
+     * so it works with `await using` (TS 5.2+):
+     *
+     * @example
+     * ```ts
+     * await using sb = await client.sandbox("test", { image: "python:3.12-alpine" });
+     * await sb.run(["pip", "install", "numpy"]);
+     * // sandbox auto-removed when scope exits
+     * ```
+     */
+    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;
+}

package/dist/client.d.ts

@@ -0,0 +1,169 @@
+import { BrowserSession } from "./browser.js";
+import { SandboxSession } from "./sandbox.js";
+import type { AgentKernelOptions, BatchCommand, BatchFileWriteResponse, BatchRunResponse, CreateStoreRequest, CreateObjectRequest, CreateOrchestrationRequest, CreateScheduleRequest, CreateSandboxOptions, DetachedCommand, DetachedLogsResponse, ExecOptions, ExtendTtlOptions, ExtendTtlResponse, DurableObject, DurableStore, DurableStoreCommandResponse, DurableStoreExecuteResponse, DurableStoreQueryResponse, FileReadResponse, FileWriteOptions, OrchestrationDefinition, RunOptions, RunOutput, Orchestration, SandboxInfo, Schedule, SnapshotMeta, StreamEvent, TakeSnapshotOptions } from "./types.js";
+/**
+ * Client for the agentkernel HTTP API.
+ *
+ * @example
+ * ```ts
+ * const client = new AgentKernel();
+ * const result = await client.run(["echo", "hello"]);
+ * console.log(result.output); // "hello\n"
+ * ```
+ */
+export declare class AgentKernel {
+    private readonly baseUrl;
+    private readonly apiKey;
+    private readonly timeout;
+    constructor(opts?: AgentKernelOptions);
+    /** Health check. Returns "ok" if the server is running. */
+    health(): Promise<string>;
+    /** Run a command in a temporary sandbox. */
+    run(command: string[], opts?: RunOptions): Promise<RunOutput>;
+    /**
+     * Run a command with SSE streaming output.
+     *
+     * @example
+     * ```ts
+     * for await (const event of client.runStream(["python3", "script.py"])) {
+     *   if (event.type === "output") process.stdout.write(String(event.data.data));
+     * }
+     * ```
+     */
+    runStream(command: string[], opts?: RunOptions): AsyncGenerator<StreamEvent>;
+    /** List all sandboxes. */
+    listSandboxes(): Promise<SandboxInfo[]>;
+    /** Create a new sandbox. */
+    createSandbox(name: string, opts?: CreateSandboxOptions): Promise<SandboxInfo>;
+    /** Get info about a sandbox. */
+    getSandbox(name: string): Promise<SandboxInfo>;
+    /** Get info about a sandbox by UUID. */
+    getSandboxByUuid(uuid: string): Promise<SandboxInfo>;
+    /** Remove a sandbox. */
+    removeSandbox(name: string): Promise<void>;
+    /** Run a command in an existing sandbox. */
+    execInSandbox(name: string, command: string[], opts?: ExecOptions): Promise<RunOutput>;
+    /** Read a file from a sandbox. */
+    readFile(name: string, path: string): Promise<FileReadResponse>;
+    /** Write a file to a sandbox. */
+    writeFile(name: string, path: string, content: string, opts?: FileWriteOptions): Promise<string>;
+    /** Delete a file from a sandbox. */
+    deleteFile(name: string, path: string): Promise<string>;
+    /** Get audit log entries for a sandbox. */
+    getSandboxLogs(name: string): Promise<Record<string, unknown>[]>;
+    /** Write multiple files to a sandbox in one request. */
+    writeFiles(name: string, files: Record<string, string>): Promise<BatchFileWriteResponse>;
+    /** Run multiple commands in parallel. */
+    batchRun(commands: BatchCommand[]): Promise<BatchRunResponse>;
+    /** Start a detached (background) command in a sandbox. */
+    execDetached(name: string, command: string[], opts?: ExecOptions): Promise<DetachedCommand>;
+    /** Get the status of a detached command. */
+    detachedStatus(name: string, cmdId: string): Promise<DetachedCommand>;
+    /** Get logs from a detached command. */
+    detachedLogs(name: string, cmdId: string, stream?: "stdout" | "stderr"): Promise<DetachedLogsResponse>;
+    /** Kill a detached command. */
+    detachedKill(name: string, cmdId: string): Promise<string>;
+    /** List detached commands in a sandbox. */
+    detachedList(name: string): Promise<DetachedCommand[]>;
+    /** List all orchestrations. */
+    listOrchestrations(): Promise<Orchestration[]>;
+    /** Create a new orchestration. */
+    createOrchestration(payload: CreateOrchestrationRequest): Promise<Orchestration>;
+    /** Get info about an orchestration by identifier. */
+    getOrchestration(id: string): Promise<Orchestration>;
+    /** Raise an external event for an orchestration. */
+    signalOrchestration(id: string, payload: Record<string, unknown>): Promise<Orchestration>;
+    /** Terminate an orchestration. */
+    terminateOrchestration(id: string, payload?: Record<string, unknown>): Promise<Orchestration>;
+    /** List orchestration definitions. */
+    listOrchestrationDefinitions(): Promise<OrchestrationDefinition[]>;
+    /** Register or update an orchestration definition. */
+    upsertOrchestrationDefinition(payload: OrchestrationDefinition): Promise<OrchestrationDefinition>;
+    /** Get an orchestration definition by name. */
+    getOrchestrationDefinition(name: string): Promise<OrchestrationDefinition>;
+    /** Delete an orchestration definition by name. */
+    deleteOrchestrationDefinition(name: string): Promise<string>;
+    /** List all objects. */
+    listObjects(): Promise<DurableObject[]>;
+    /** Create a new object. */
+    createObject(payload: CreateObjectRequest): Promise<DurableObject>;
+    /** Get an object by identifier. */
+    getObject(id: string): Promise<DurableObject>;
+    /** Call a method on a durable object (auto-creates/wakes if needed). */
+    callObject(className: string, objectId: string, method: string, args?: Record<string, unknown>): Promise<unknown>;
+    /** Delete a durable object by identifier. */
+    deleteObject(id: string): Promise<string>;
+    /** Partially update a durable object (storage and/or status). */
+    patchObject(id: string, payload: {
+        storage?: unknown;
+        status?: string;
+    }): Promise<DurableObject>;
+    /** List all schedules. */
+    listSchedules(): Promise<Schedule[]>;
+    /** Create a new schedule. */
+    createSchedule(payload: CreateScheduleRequest): Promise<Schedule>;
+    /** Get a schedule by identifier. */
+    getSchedule(id: string): Promise<Schedule>;
+    /** Delete a schedule by identifier. */
+    deleteSchedule(id: string): Promise<string>;
+    /** List all durable stores. */
+    listStores(): Promise<DurableStore[]>;
+    /** Create a durable store. */
+    createStore(payload: CreateStoreRequest): Promise<DurableStore>;
+    /** Get a durable store by identifier. */
+    getStore(id: string): Promise<DurableStore>;
+    /** Delete a durable store by identifier. */
+    deleteStore(id: string): Promise<string>;
+    /** Execute a read query against a durable store. */
+    queryStore(id: string, payload: Record<string, unknown>): Promise<DurableStoreQueryResponse>;
+    /** Execute a write statement against a durable store. */
+    executeStore(id: string, payload: Record<string, unknown>): Promise<DurableStoreExecuteResponse>;
+    /** Execute a command against a durable store (Redis-style engines). */
+    commandStore(id: string, payload: Record<string, unknown>): Promise<DurableStoreCommandResponse>;
+    /**
+     * Create a sandbox session with automatic cleanup.
+     *
+     * The returned SandboxSession implements AsyncDisposable,
+     * so it works with `await using` (TS 5.2+):
+     *
+     * @example
+     * ```ts
+     * await using sb = await client.sandbox("test", { image: "python:3.12-alpine" });
+     * await sb.run(["pip", "install", "numpy"]);
+     * // sandbox auto-removed when scope exits
+     * ```
+     */
+    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;
+}

package/dist/config.d.cts

@@ -0,0 +1,7 @@
+import type { AgentKernelOptions } from "./types.cjs";
+/** Resolve configuration from constructor args, env vars, and defaults. */
+export declare function resolveConfig(opts?: AgentKernelOptions): {
+    baseUrl: string;
+    apiKey: string | undefined;
+    timeout: number;
+};

package/dist/config.d.ts

@@ -0,0 +1,7 @@
+import type { AgentKernelOptions } from "./types.js";
+/** Resolve configuration from constructor args, env vars, and defaults. */
+export declare function resolveConfig(opts?: AgentKernelOptions): {
+    baseUrl: string;
+    apiKey: string | undefined;
+    timeout: number;
+};

package/dist/errors.d.cts

@@ -0,0 +1,34 @@
+/** Base error for all agentkernel SDK errors. */
+export declare class AgentKernelError extends Error {
+    constructor(message: string);
+}
+/** 401 Unauthorized. */
+export declare class AuthError extends AgentKernelError {
+    readonly status = 401;
+    constructor(message?: string);
+}
+/** 404 Not Found. */
+export declare class NotFoundError extends AgentKernelError {
+    readonly status = 404;
+    constructor(message?: string);
+}
+/** 400 Bad Request. */
+export declare class ValidationError extends AgentKernelError {
+    readonly status = 400;
+    constructor(message?: string);
+}
+/** 500 Internal Server Error. */
+export declare class ServerError extends AgentKernelError {
+    readonly status = 500;
+    constructor(message?: string);
+}
+/** Network / connection error. */
+export declare class NetworkError extends AgentKernelError {
+    constructor(message?: string);
+}
+/** SSE streaming error. */
+export declare class StreamError extends AgentKernelError {
+    constructor(message?: string);
+}
+/** Map an HTTP status code + body to the appropriate error. */
+export declare function errorFromStatus(status: number, body: string): AgentKernelError;

package/dist/errors.d.ts

@@ -0,0 +1,34 @@
+/** Base error for all agentkernel SDK errors. */
+export declare class AgentKernelError extends Error {
+    constructor(message: string);
+}
+/** 401 Unauthorized. */
+export declare class AuthError extends AgentKernelError {
+    readonly status = 401;
+    constructor(message?: string);
+}
+/** 404 Not Found. */
+export declare class NotFoundError extends AgentKernelError {
+    readonly status = 404;
+    constructor(message?: string);
+}
+/** 400 Bad Request. */
+export declare class ValidationError extends AgentKernelError {
+    readonly status = 400;
+    constructor(message?: string);
+}
+/** 500 Internal Server Error. */
+export declare class ServerError extends AgentKernelError {
+    readonly status = 500;
+    constructor(message?: string);
+}
+/** Network / connection error. */
+export declare class NetworkError extends AgentKernelError {
+    constructor(message?: string);
+}
+/** SSE streaming error. */
+export declare class StreamError extends AgentKernelError {
+    constructor(message?: string);
+}
+/** Map an HTTP status code + body to the appropriate error. */
+export declare function errorFromStatus(status: number, body: string): AgentKernelError;