@beeos-ai/bma-sdk 0.4.2 → 1.0.0

package/dist/index.js

@@ -1,248 +1,58 @@
-// TypeScript client for the BMA REST API. Every path, operation and schema
-// type comes from src/generated/rest.ts, which is generated from
-// contracts/bma/rest.openapi.yaml; this file adds only what the contract does
-// not describe: bearer authentication, error decoding, the server-sent event
-// stream, and verified artifact downloads.
+// TypeScript client for the BMA REST API.
+//
+//   const bma = new BmaClient({ token, baseUrl, orgId, projectId });
+//   const { session } = await bma.agents.sessions.create(agentId);
+//
+// Resource classes, request descriptors and params types are generated by
+// tools/sdkgen/sdkgen.py from contracts/bma/rest.openapi.yaml and
+// contracts/bma/sdk.resources.yaml; schema types by openapi-typescript.
 import createClient from "openapi-fetch";
-/** Hosted BMA API root, including the /v1 prefix. */
-export const DEFAULT_BASE_URL = "https://api.bma.beeos.ai/v1";
-export const SDK_VERSION = "0.4.2";
-/** A non-2xx response from the BMA API. */
-export class BmaApiError extends Error {
-    status;
-    code;
-    currentDigest;
-    issues;
-    constructor(status, body) {
-        const wire = (typeof body === "object" && body !== null ? body : {});
-        const code = typeof wire.code === "string" ? wire.code : "";
-        const message = typeof wire.error === "string" && wire.error !== "" ? wire.error : `HTTP ${status}`;
-        super(`bma: HTTP ${status} ${code || "unknown"}: ${message}`);
-        this.name = "BmaApiError";
-        this.status = status;
-        this.code = code;
-        this.currentDigest = wire.current_digest;
-        this.issues = wire.issues;
-    }
-    /** Whether a retry may succeed without changing the request. */
-    get retryable() {
-        return (this.status === 408 ||
-            this.status === 429 ||
-            this.status >= 500 ||
-            this.code === "service_unavailable" ||
-            this.code === "rate_limited");
-    }
-}
-/**
- * Returns `data` from an openapi-fetch result or throws BmaApiError.
- *
- * ```ts
- * const agent = unwrap(await bma.rest.GET("/orgs/{orgID}/projects/{projectID}/agents/{agentID}", { params }));
- * ```
- */
-export function unwrap(result) {
-    if (result.response.ok) {
-        return result.data;
-    }
-    throw new BmaApiError(result.response.status, result.error);
+import { BmaApiError, BmaError } from "./errors.js";
+import { bmaOrigin } from "./core.js";
+import { RestClientBase } from "./generated/rest-resources.js";
+import { SDK_VERSION } from "./version.js";
+export { SDK_VERSION };
+export * as Resources from "./generated/rest-resources.js";
+export { APIConnectionError, APIConnectionTimeoutError, APIUserAbortError, AuthenticationError, BadRequestError, BmaApiError, BmaError, ConflictError, ContentTooLargeError, EventStreamError, InternalServerError, NotFoundError, PermissionDeniedError, RateLimitError, RequestTimeoutError, ServiceUnavailableError, UnprocessableEntityError, } from "./errors.js";
+export { DEFAULT_MAX_RETRIES, DEFAULT_TIMEOUT_MS } from "./core.js";
+export { PagePromise } from "./pagination.js";
+export { Stream } from "./streaming.js";
+export { defineTool, ToolError } from "./lib/tool-runner.js";
+/** Hosted BMA origin; the client adds the /api/v1 prefix. */
+export const DEFAULT_BASE_URL = "https://api.bma.beeos.ai";
+function env(name) {
+    const value = typeof process === "undefined" ? undefined : process.env?.[name]?.trim();
+    return value || undefined;
 }
 /** Authenticated BMA REST client. */
-export class BmaClient {
-    /** Generated, fully typed openapi-fetch client for every contract operation. */
-    rest;
-    baseUrl;
-    token;
-    fetchImpl;
-    constructor(options) {
-        const token = options.token?.trim();
-        if (!token) {
-            throw new Error("bma: token is required");
-        }
-        const baseUrl = (options.baseUrl?.trim() || DEFAULT_BASE_URL).replace(/\/+$/, "");
-        const scheme = new URL(baseUrl).protocol;
-        if (scheme !== "http:" && scheme !== "https:") {
-            throw new Error("bma: baseUrl must use http or https");
-        }
-        this.baseUrl = baseUrl;
-        this.token = token;
-        this.fetchImpl = options.fetch ?? globalThis.fetch;
-        this.rest = createClient({ baseUrl, fetch: this.fetchImpl, headers: this.headers() });
-    }
-    headers(extra = {}) {
-        return { Authorization: `Bearer ${this.token}`, ...extra };
-    }
-    async send(path, accept, headers, signal) {
-        const response = await this.fetchImpl(this.baseUrl + path, {
-            method: "GET",
-            headers: this.headers({ Accept: accept, ...headers }),
-            signal,
-        });
-        if (!response.ok) {
-            const text = await response.text();
-            let body;
-            try {
-                body = JSON.parse(text);
-            }
-            catch {
-                body = undefined;
-            }
-            throw new BmaApiError(response.status, body);
-        }
-        return response;
-    }
+export class BmaClient extends RestClientBase {
     /**
-     * Streams `GET .../agents/{agentID}/events/stream`. Heartbeat comments are
-     * skipped; the iterator ends when the server closes the stream.
+     * Escape hatch: the openapi-fetch client typed by contract path, for
+     * operations without a resource method (Machine Daemon). Pair with unwrap().
      */
-    async *streamEvents(options) {
-        const query = {};
-        if (options.sessionId !== undefined)
-            query.session_id = options.sessionId;
-        if (options.afterSequence !== undefined)
-            query.after_sequence = options.afterSequence;
-        if (options.streamDeltas !== undefined)
-            query.stream_deltas = options.streamDeltas;
-        const search = new URLSearchParams(Object.entries(query).map(([k, v]) => [k, String(v)])).toString();
-        const path = `/orgs/${encodeURIComponent(options.orgID)}/projects/${encodeURIComponent(options.projectID)}` +
-            `/agents/${encodeURIComponent(options.agentID)}/events/stream` +
-            (search ? `?${search}` : "");
-        const headers = {};
-        if (options.lastEventId !== undefined)
-            headers["Last-Event-ID"] = String(options.lastEventId);
-        const response = await this.send(path, "text/event-stream", headers, options.signal);
-        const media = (response.headers.get("Content-Type") ?? "").split(";")[0].trim();
-        if (media !== "text/event-stream" || !response.body) {
-            await response.body?.cancel();
-            throw new Error(`bma: event stream content type = ${JSON.stringify(media)}`);
-        }
-        for await (const raw of parseSSE(response.body)) {
-            const frame = { event: raw.event, data: JSON.parse(raw.data) };
-            if (raw.id !== undefined) {
-                const sequence = Number(raw.id);
-                if (!Number.isSafeInteger(sequence)) {
-                    throw new Error(`bma: invalid event id ${JSON.stringify(raw.id)}`);
-                }
-                frame.id = raw.id;
-                frame.sequence = sequence;
-            }
-            yield frame;
-        }
-    }
-    /**
-     * Downloads artifact content and verifies the size and sha256 digest
-     * recorded on the artifact. The whole body is buffered, bounded by maxBytes.
-     */
-    async downloadArtifact(artifact, options) {
-        const size = artifact.size_bytes;
-        if (!(options.maxBytes > 0))
-            throw new Error("bma: maxBytes is required");
-        if (size === undefined || size < 0 || size > options.maxBytes) {
-            throw new Error("bma: artifact size is missing or exceeds maxBytes");
-        }
-        const digest = artifact.digest ?? "";
-        if (!/^sha256:[0-9a-f]{64}$/.test(digest)) {
-            throw new Error("bma: artifact digest must be sha256:<hex>");
-        }
-        const path = `/orgs/${encodeURIComponent(artifact.org_id)}/projects/${encodeURIComponent(artifact.project_id)}` +
-            `/agents/${encodeURIComponent(artifact.agent_id)}/artifacts/${encodeURIComponent(artifact.id)}/content`;
-        const response = await this.send(path, "application/octet-stream", {}, options.signal);
-        const bytes = await readAtMost(response, size + 1);
-        if (bytes.byteLength !== size) {
-            throw new Error(`bma: artifact size = ${bytes.byteLength}, want ${size}`);
-        }
-        const hash = new Uint8Array(await crypto.subtle.digest("SHA-256", bytes));
-        const actual = Array.from(hash, (b) => b.toString(16).padStart(2, "0")).join("");
-        if (`sha256:${actual}` !== digest) {
-            throw new Error("bma: artifact digest mismatch");
-        }
-        return bytes;
-    }
-}
-async function readAtMost(response, limit) {
-    const reader = response.body?.getReader();
-    if (!reader)
-        return new Uint8Array();
-    const chunks = [];
-    let total = 0;
-    for (;;) {
-        const { done, value } = await reader.read();
-        if (done)
-            break;
-        chunks.push(value);
-        total += value.byteLength;
-        if (total >= limit) {
-            await reader.cancel();
-            break;
-        }
-    }
-    const out = new Uint8Array(total);
-    let offset = 0;
-    for (const chunk of chunks) {
-        out.set(chunk, offset);
-        offset += chunk.byteLength;
+    rest;
+    constructor(options = {}) {
+        const token = options.token?.trim() || env("BMA_TOKEN");
+        if (!token)
+            throw new BmaError("bma: token is required; pass token or set BMA_TOKEN");
+        const baseUrl = `${bmaOrigin(options.baseUrl?.trim() || env("BMA_BASE_URL") || DEFAULT_BASE_URL)}/api/v1`;
+        const headers = { Authorization: `Bearer ${token}`, "User-Agent": `bma-sdk-typescript/${SDK_VERSION}` };
+        super({
+            baseUrl,
+            fetch: options.fetch,
+            timeout: options.timeout,
+            maxRetries: options.maxRetries,
+            headers,
+            scope: { org_id: options.orgId ?? env("BMA_ORG_ID"), project_id: options.projectId ?? env("BMA_PROJECT_ID") },
+            scopeOption: { org_id: "orgId", project_id: "projectId" },
+        });
+        this.rest = createClient({ baseUrl: this.baseUrl, fetch: options.fetch ?? globalThis.fetch, headers });
     }
-    return out;
 }
-/** Minimal text/event-stream parser (WHATWG SSE field rules). */
-export async function* parseSSE(body) {
-    const decoder = new TextDecoder();
-    let buffer = "";
-    let event = "";
-    let id;
-    let data = [];
-    const dispatch = () => {
-        const frame = data.length > 0 ? { event: event || "message", id, data: data.join("\n") } : undefined;
-        event = "";
-        id = undefined;
-        data = [];
-        return frame;
-    };
-    const reader = body.getReader();
-    try {
-        for (;;) {
-            const { done, value } = await reader.read();
-            buffer += done ? decoder.decode() : decoder.decode(value, { stream: true });
-            let newline;
-            while ((newline = buffer.search(/\r\n|\r|\n/)) >= 0) {
-                const line = buffer.slice(0, newline);
-                buffer = buffer.slice(newline + (buffer.startsWith("\r\n", newline) ? 2 : 1));
-                if (line === "") {
-                    const frame = dispatch();
-                    if (frame)
-                        yield frame;
-                    continue;
-                }
-                if (line.startsWith(":"))
-                    continue;
-                const colon = line.indexOf(":");
-                const field = colon < 0 ? line : line.slice(0, colon);
-                let value = colon < 0 ? "" : line.slice(colon + 1);
-                if (value.startsWith(" "))
-                    value = value.slice(1);
-                if (field === "event")
-                    event = value;
-                else if (field === "id")
-                    id = value;
-                else if (field === "data")
-                    data.push(value);
-            }
-            if (done) {
-                if (buffer !== "") {
-                    // A final line without a terminator still belongs to the frame.
-                    const colon = buffer.indexOf(":");
-                    if (colon > 0 && buffer.slice(0, colon) === "data") {
-                        data.push(buffer.slice(colon + 1).replace(/^ /, ""));
-                    }
-                }
-                const frame = dispatch();
-                if (frame)
-                    yield frame;
-                return;
-            }
-        }
-    }
-    finally {
-        reader.releaseLock();
-    }
+/** Escape hatch companion of `bma.rest`: returns `data` or throws the typed error. */
+export function unwrap(result) {
+    if (result.response.ok)
+        return result.data;
+    throw BmaApiError.generate(result.response.status, result.error, result.response.headers);
 }
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/lib/artifacts.d.ts

@@ -0,0 +1,14 @@
+import type { RequestOptions } from "../core.js";
+import type { Artifact } from "../generated/rest-types.js";
+import { APIResource } from "../resource.js";
+export interface DownloadArtifactOptions extends RequestOptions {
+    /** Explicit product limit; artifacts larger than this are refused. */
+    maxBytes: number;
+}
+export declare class ArtifactsBase extends APIResource {
+    /**
+     * Downloads artifact content and verifies its size and sha256 digest. The
+     * whole body is buffered, bounded by maxBytes.
+     */
+    downloadVerified(artifact: Artifact, options: DownloadArtifactOptions): Promise<Uint8Array<ArrayBuffer>>;
+}

package/dist/lib/artifacts.js

@@ -0,0 +1,56 @@
+import { BmaError } from "../errors.js";
+import { OP } from "../generated/rest-operations.js";
+import { APIResource } from "../resource.js";
+export class ArtifactsBase extends APIResource {
+    /**
+     * Downloads artifact content and verifies its size and sha256 digest. The
+     * whole body is buffered, bounded by maxBytes.
+     */
+    async downloadVerified(artifact, options) {
+        const { maxBytes, ...request } = options;
+        const size = artifact.size_bytes;
+        if (!(maxBytes > 0))
+            throw new BmaError("bma: maxBytes is required");
+        if (size === undefined || size < 0 || size > maxBytes) {
+            throw new BmaError("bma: artifact size is missing or exceeds maxBytes");
+        }
+        const digest = artifact.digest ?? "";
+        if (!/^sha256:[0-9a-f]{64}$/.test(digest))
+            throw new BmaError("bma: artifact digest must be sha256:<hex>");
+        const response = await this._client._request(OP.getArtifactContent, { agentID: artifact.agent_id, artifactID: artifact.id }, { org_id: artifact.org_id, project_id: artifact.project_id }, request);
+        const bytes = await readAtMost(response, size + 1);
+        if (bytes.byteLength !== size)
+            throw new BmaError(`bma: artifact size = ${bytes.byteLength}, want ${size}`);
+        const hash = new Uint8Array(await crypto.subtle.digest("SHA-256", bytes));
+        const actual = Array.from(hash, (b) => b.toString(16).padStart(2, "0")).join("");
+        if (`sha256:${actual}` !== digest)
+            throw new BmaError("bma: artifact digest mismatch");
+        return bytes;
+    }
+}
+async function readAtMost(response, limit) {
+    const reader = response.body?.getReader();
+    if (!reader)
+        return new Uint8Array();
+    const chunks = [];
+    let total = 0;
+    for (;;) {
+        const { done, value } = await reader.read();
+        if (done)
+            break;
+        chunks.push(value);
+        total += value.byteLength;
+        if (total >= limit) {
+            await reader.cancel();
+            break;
+        }
+    }
+    const out = new Uint8Array(total);
+    let offset = 0;
+    for (const chunk of chunks) {
+        out.set(chunk, offset);
+        offset += chunk.byteLength;
+    }
+    return out;
+}
+//# sourceMappingURL=artifacts.js.map

package/dist/lib/artifacts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"artifacts.js","sourceRoot":"","sources":["../../src/lib/artifacts.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAExC,OAAO,EAAE,EAAE,EAAE,MAAM,iCAAiC,CAAC;AACrD,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAO7C,MAAM,OAAO,aAAc,SAAQ,WAAW;IAC5C;;;OAGG;IACH,KAAK,CAAC,gBAAgB,CAAC,QAAkB,EAAE,OAAgC;QACzE,MAAM,EAAE,QAAQ,EAAE,GAAG,OAAO,EAAE,GAAG,OAAO,CAAC;QACzC,MAAM,IAAI,GAAG,QAAQ,CAAC,UAAU,CAAC;QACjC,IAAI,CAAC,CAAC,QAAQ,GAAG,CAAC,CAAC;YAAE,MAAM,IAAI,QAAQ,CAAC,2BAA2B,CAAC,CAAC;QACrE,IAAI,IAAI,KAAK,SAAS,IAAI,IAAI,GAAG,CAAC,IAAI,IAAI,GAAG,QAAQ,EAAE,CAAC;YACtD,MAAM,IAAI,QAAQ,CAAC,mDAAmD,CAAC,CAAC;QAC1E,CAAC;QACD,MAAM,MAAM,GAAG,QAAQ,CAAC,MAAM,IAAI,EAAE,CAAC;QACrC,IAAI,CAAC,uBAAuB,CAAC,IAAI,CAAC,MAAM,CAAC;YAAE,MAAM,IAAI,QAAQ,CAAC,2CAA2C,CAAC,CAAC;QAC3G,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,QAAQ,CAC1C,EAAE,CAAC,kBAAkB,EACrB,EAAE,OAAO,EAAE,QAAQ,CAAC,QAAQ,EAAE,UAAU,EAAE,QAAQ,CAAC,EAAE,EAAE,EACvD,EAAE,MAAM,EAAE,QAAQ,CAAC,MAAM,EAAE,UAAU,EAAE,QAAQ,CAAC,UAAU,EAAE,EAC5D,OAAO,CACR,CAAC;QACF,MAAM,KAAK,GAAG,MAAM,UAAU,CAAC,QAAQ,EAAE,IAAI,GAAG,CAAC,CAAC,CAAC;QACnD,IAAI,KAAK,CAAC,UAAU,KAAK,IAAI;YAAE,MAAM,IAAI,QAAQ,CAAC,wBAAwB,KAAK,CAAC,UAAU,UAAU,IAAI,EAAE,CAAC,CAAC;QAC5G,MAAM,IAAI,GAAG,IAAI,UAAU,CAAC,MAAM,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC,CAAC;QAC1E,MAAM,MAAM,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACjF,IAAI,UAAU,MAAM,EAAE,KAAK,MAAM;YAAE,MAAM,IAAI,QAAQ,CAAC,+BAA+B,CAAC,CAAC;QACvF,OAAO,KAAK,CAAC;IACf,CAAC;CACF;AAED,KAAK,UAAU,UAAU,CAAC,QAAkB,EAAE,KAAa;IACzD,MAAM,MAAM,GAAG,QAAQ,CAAC,IAAI,EAAE,SAAS,EAAE,CAAC;IAC1C,IAAI,CAAC,MAAM;QAAE,OAAO,IAAI,UAAU,EAAE,CAAC;IACrC,MAAM,MAAM,GAAiB,EAAE,CAAC;IAChC,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,SAAS,CAAC;QACR,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,MAAM,MAAM,CAAC,IAAI,EAAE,CAAC;QAC5C,IAAI,IAAI;YAAE,MAAM;QAChB,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACnB,KAAK,IAAI,KAAK,CAAC,UAAU,CAAC;QAC1B,IAAI,KAAK,IAAI,KAAK,EAAE,CAAC;YACnB,MAAM,MAAM,CAAC,MAAM,EAAE,CAAC;YACtB,MAAM;QACR,CAAC;IACH,CAAC;IACD,MAAM,GAAG,GAAG,IAAI,UAAU,CAAC,KAAK,CAAC,CAAC;IAClC,IAAI,MAAM,GAAG,CAAC,CAAC;IACf,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,GAAG,CAAC,GAAG,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;QACvB,MAAM,IAAI,KAAK,CAAC,UAAU,CAAC;IAC7B,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/lib/tool-runner.d.ts

@@ -0,0 +1,99 @@
+import type { RequestOptions } from "../core.js";
+import type { AgentConfigDefinitionTool, SubmitToolResultContentBlock, ToolCall } from "../generated/rest-types.js";
+import { APIResource } from "../resource.js";
+/** The Standard Schema v1 interface (https://standardschema.dev), as published. */
+export interface StandardSchemaV1<Input = unknown, Output = Input> {
+    readonly "~standard": {
+        readonly version: 1;
+        readonly vendor: string;
+        readonly validate: (value: unknown) => StandardResult<Output> | Promise<StandardResult<Output>>;
+        readonly types?: {
+            readonly input: Input;
+            readonly output: Output;
+        } | undefined;
+        /** Standard JSON Schema (zod >= 4.2, valibot via toStandardJsonSchema). */
+        readonly jsonSchema?: {
+            readonly input: (options: {
+                target: string;
+            }) => Record<string, unknown>;
+        };
+    };
+}
+type StandardResult<Output> = {
+    readonly value: Output;
+    readonly issues?: undefined;
+} | {
+    readonly issues: ReadonlyArray<{
+        readonly message: string;
+        readonly path?: ReadonlyArray<PropertyKey | {
+            key: PropertyKey;
+        }>;
+    }>;
+};
+type InferOutput<S extends StandardSchemaV1> = NonNullable<S["~standard"]["types"]>["output"];
+/** What a tool returns: text, or result content blocks. */
+export type ToolOutput = string | SubmitToolResultContentBlock[];
+/** Throw from `run` to report a failed call with this content to the model. */
+export declare class ToolError extends Error {
+    readonly content: ToolOutput;
+    constructor(content: ToolOutput);
+}
+export interface ToolRunContext {
+    toolCall: ToolCall;
+    signal: AbortSignal;
+}
+export interface RunnableTool<Input = unknown> {
+    readonly name: string;
+    /** Agent config entry for `tools.<name>`. */
+    readonly definition: AgentConfigDefinitionTool & {
+        type: "custom";
+        description: string;
+    };
+    parse(input: unknown): Promise<Input>;
+    run(input: Input, context: ToolRunContext): ToolOutput | Promise<ToolOutput>;
+}
+/**
+ * Defines a custom tool from a Standard Schema (zod, valibot, arktype). The
+ * input is validated before `run` sees it; the JSON Schema for the agent
+ * config comes from the schema's Standard JSON Schema or `jsonSchema`.
+ */
+export declare function defineTool<S extends StandardSchemaV1>(options: {
+    name: string;
+    description: string;
+    inputSchema: S;
+    /** JSON Schema of the input; derived from `inputSchema` when omitted. */
+    jsonSchema?: Record<string, unknown>;
+    run: (input: InferOutput<S>, context: ToolRunContext) => ToolOutput | Promise<ToolOutput>;
+}): RunnableTool<InferOutput<S>>;
+export interface ToolRunnerParams {
+    /** Only calls made in this session (calls of subagents are always handled). */
+    session_id?: string;
+    tools: RunnableTool<any>[];
+    org_id?: string;
+    project_id?: string;
+    /**
+     * Event stream reconnects in a row that receive no data before the runner
+     * fails; unlimited by default (with backoff up to 8 s), so a runner rides
+     * out deployments. Independent of `maxRetries`, which bounds each request.
+     */
+    max_reconnects?: number;
+}
+/** A running tool consumer. */
+export interface ToolRunner {
+    /** Resolves when the runner stops; rejects with the error that stopped it. */
+    done(): Promise<void>;
+    /** Stops listening and waits for running tools to finish. */
+    stop(): Promise<void>;
+}
+export declare class ToolCallsBase extends APIResource {
+    /**
+     * Runs custom tools for an agent: every `ready` custom call (of the agent
+     * and its subagents) whose name matches a tool is parsed, run, and its
+     * result submitted. Ready calls are listed on every (re)connection of the
+     * event stream, so calls that became ready while disconnected are not lost.
+     * A 409 on submit (another consumer answered the call first) counts as
+     * handled. `done()` rejects only with the error that stopped the runner.
+     */
+    runner(agentId: string, params: ToolRunnerParams, options?: RequestOptions): ToolRunner;
+}
+export {};