@beeos-ai/bma-sdk 0.4.1 → 1.0.0

package/dist/lib/tool-runner.js

@@ -0,0 +1,140 @@
+import { BmaError, ConflictError } from "../errors.js";
+import { OP } from "../generated/rest-operations.js";
+import { APIResource } from "../resource.js";
+/** Throw from `run` to report a failed call with this content to the model. */
+export class ToolError extends Error {
+    content;
+    constructor(content) {
+        super(typeof content === "string" ? content : "tool error");
+        this.name = "ToolError";
+        this.content = content;
+    }
+}
+/**
+ * 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 function defineTool(options) {
+    const std = options.inputSchema["~standard"];
+    const schema = options.jsonSchema ?? std.jsonSchema?.input({ target: "draft-2020-12" });
+    if (!schema) {
+        throw new BmaError(`bma: cannot derive a JSON Schema from this ${std.vendor} schema; pass jsonSchema or use a library implementing Standard JSON Schema (zod >= 4.2)`);
+    }
+    if (schema.type !== "object")
+        throw new BmaError(`bma: input schema of tool ${options.name} must be an object`);
+    return {
+        name: options.name,
+        definition: {
+            type: "custom",
+            description: options.description,
+            input_schema: schema,
+        },
+        async parse(input) {
+            const result = await std.validate(input);
+            if (result.issues) {
+                const detail = result.issues
+                    .slice(0, 5)
+                    .map((i) => {
+                    const path = (i.path ?? []).map((p) => String(typeof p === "object" ? p.key : p)).join(".");
+                    return path ? `${path}: ${i.message}` : i.message;
+                })
+                    .join("; ");
+                throw new ToolError(`invalid input for ${options.name}: ${detail}`);
+            }
+            return result.value;
+        },
+        run: options.run,
+    };
+}
+export 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, params, options) {
+        const tools = new Map(params.tools.map((t) => [t.name, t]));
+        if (tools.size !== params.tools.length)
+            throw new BmaError("bma: tool names must be unique");
+        const scope = { org_id: params.org_id, project_id: params.project_id };
+        const controller = new AbortController();
+        options?.signal?.addEventListener("abort", () => controller.abort(), { once: true });
+        // Calls being run or submitted; a call leaves the set once its result is
+        // stored, after which the server no longer reports it as ready.
+        const inFlight = new Set();
+        const running = new Set();
+        let failure;
+        const fail = (error) => {
+            failure ??= error;
+            controller.abort();
+        };
+        const handle = (call) => {
+            const tool = tools.get(call.name);
+            if (call.type !== "custom" || call.state !== "ready" || !tool || inFlight.has(call.id))
+                return;
+            if (params.session_id && call.agent_id === agentId && call.session_id !== params.session_id)
+                return;
+            inFlight.add(call.id);
+            const task = (async () => {
+                let outcome = "succeeded";
+                let output;
+                try {
+                    output = await tool.run(await tool.parse(call.input), { toolCall: call, signal: controller.signal });
+                }
+                catch (error) {
+                    outcome = "failed";
+                    output = error instanceof ToolError ? error.content : error instanceof Error ? error.message : String(error);
+                }
+                const content_blocks = typeof output === "string" ? [{ type: "text", text: output }] : output;
+                try {
+                    await this._client._request(OP.submitToolCallResult, { agentID: call.agent_id, toolCallID: call.id }, { ...scope, outcome, content_blocks }, { ...options, signal: undefined });
+                }
+                catch (error) {
+                    if (!(error instanceof ConflictError))
+                        throw error;
+                }
+                finally {
+                    inFlight.delete(call.id);
+                }
+            })().catch(fail);
+            running.add(task);
+            void task.finally(() => running.delete(task));
+        };
+        const sweep = async () => {
+            const pages = this._client._page(OP.listToolCalls, { agentID: agentId }, { ...scope, state: "ready", type: "custom", include_subagents: true }, { ...options, signal: controller.signal });
+            for await (const call of pages)
+                handle(call);
+        };
+        const stream = this._client._stream(OP.streamEvents, { agentID: agentId }, { ...scope, ...(params.session_id ? { session_id: params.session_id } : {}) }, { ...options, signal: controller.signal }, { onOpen: () => void sweep().catch(fail), maxReconnects: params.max_reconnects ?? Number.POSITIVE_INFINITY });
+        const finished = (async () => {
+            try {
+                for await (const event of stream) {
+                    if (event.event !== "tool_call_update" || event.data.state !== "ready")
+                        continue;
+                    const { tool_call } = await this._client._request(OP.getToolCall, { agentID: event.data.agent_id ?? agentId, toolCallID: event.data.tool_call_id }, scope, { ...options, signal: controller.signal });
+                    handle(tool_call);
+                }
+            }
+            catch (error) {
+                if (!controller.signal.aborted)
+                    fail(error);
+            }
+            while (running.size > 0)
+                await Promise.allSettled([...running]);
+            if (failure !== undefined)
+                throw failure;
+        })();
+        return {
+            done: () => finished,
+            stop: async () => {
+                controller.abort();
+                await finished;
+            },
+        };
+    }
+}
+//# sourceMappingURL=tool-runner.js.map

package/dist/lib/tool-runner.js.map

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

package/dist/pagination.d.ts

@@ -0,0 +1,31 @@
+/** Response body of a paginated operation. */
+export interface CursorPageBody {
+    data: unknown[];
+}
+export type PageItem<R extends CursorPageBody> = R["data"][number];
+export interface PageMethods<R extends CursorPageBody> {
+    hasNextPage(): boolean;
+    /** Fetches the next page; throws when there is none. */
+    getNextPage(): Promise<Page<R>>;
+    /** This page and every following page. */
+    iterPages(): AsyncGenerator<Page<R>>;
+    /** Every item of this page and every following page. */
+    [Symbol.asyncIterator](): AsyncGenerator<PageItem<R>>;
+}
+/** One page: the response body plus navigation helpers. */
+export type Page<R extends CursorPageBody> = R & PageMethods<R>;
+type Cursor = string | number;
+type FetchPage<R> = (cursor: Cursor | undefined) => Promise<R>;
+type NextCursor = (body: CursorPageBody) => Cursor | undefined;
+/** `await` for the first page, `for await` for every item. */
+export declare class PagePromise<R extends CursorPageBody> implements Promise<Page<R>>, AsyncIterable<PageItem<R>> {
+    #private;
+    readonly [Symbol.toStringTag] = "PagePromise";
+    /** @internal */
+    constructor(fetchPage: FetchPage<R>, nextCursor: NextCursor);
+    then<A = Page<R>, B = never>(onfulfilled?: ((value: Page<R>) => A | PromiseLike<A>) | null, onrejected?: ((reason: unknown) => B | PromiseLike<B>) | null): Promise<A | B>;
+    catch<B = never>(onrejected?: ((reason: unknown) => B | PromiseLike<B>) | null): Promise<Page<R> | B>;
+    finally(onfinally?: (() => void) | null): Promise<Page<R>>;
+    [Symbol.asyncIterator](): AsyncGenerator<PageItem<R>>;
+}
+export {};

package/dist/pagination.js

@@ -0,0 +1,66 @@
+// Pagination. Mirrors the Stainless PagePromise of @anthropic-ai/sdk and
+// openai: `await` resolves to the first page, `for await` walks every item
+// across pages. Applies to every list whose response is
+// `{ data: [...], next_<param> }` for a query parameter <param>: `cursor`,
+// `page`, `before_id`/`after_id`, `before_sequence`/`after_sequence` (as the
+// Anthropic Page supports before_id/after_id).
+import { BmaError } from "./errors.js";
+function makePage(body, fetchPage, nextCursor) {
+    const methods = {
+        hasNextPage: () => nextCursor(body) !== undefined,
+        getNextPage: async () => {
+            const next = nextCursor(body);
+            if (next === undefined)
+                throw new BmaError("bma: no next page; check hasNextPage() first");
+            return makePage(await fetchPage(next), fetchPage, nextCursor);
+        },
+        iterPages: async function* () {
+            let page = makePage(body, fetchPage, nextCursor);
+            yield page;
+            while (page.hasNextPage()) {
+                page = await page.getNextPage();
+                yield page;
+            }
+        },
+        [Symbol.asyncIterator]: async function* () {
+            for await (const page of methods.iterPages())
+                yield* page.data;
+        },
+    };
+    // Methods are non-enumerable so JSON.stringify(page) is the wire body.
+    const page = Object.create(null);
+    Object.assign(page, body);
+    for (const [key, value] of [...Object.entries(methods), [Symbol.asyncIterator, methods[Symbol.asyncIterator]]]) {
+        Object.defineProperty(page, key, { value, enumerable: false });
+    }
+    return page;
+}
+/** `await` for the first page, `for await` for every item. */
+export class PagePromise {
+    [Symbol.toStringTag] = "PagePromise";
+    #first;
+    #fetchPage;
+    #nextCursor;
+    /** @internal */
+    constructor(fetchPage, nextCursor) {
+        this.#fetchPage = fetchPage;
+        this.#nextCursor = nextCursor;
+    }
+    #page() {
+        this.#first ??= this.#fetchPage(undefined).then((body) => makePage(body, this.#fetchPage, this.#nextCursor));
+        return this.#first;
+    }
+    then(onfulfilled, onrejected) {
+        return this.#page().then(onfulfilled, onrejected);
+    }
+    catch(onrejected) {
+        return this.#page().catch(onrejected);
+    }
+    finally(onfinally) {
+        return this.#page().finally(onfinally);
+    }
+    async *[Symbol.asyncIterator]() {
+        yield* await this.#page();
+    }
+}
+//# sourceMappingURL=pagination.js.map

package/dist/pagination.js.map

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

package/dist/resource.d.ts

@@ -0,0 +1,8 @@
+import type { ClientCore } from "./core.js";
+export type { ClientCore };
+/** Base class of every generated resource. */
+export declare class APIResource {
+    /** @internal */
+    protected readonly _client: ClientCore;
+    constructor(client: ClientCore);
+}

package/dist/resource.js

@@ -0,0 +1,9 @@
+/** Base class of every generated resource. */
+export class APIResource {
+    /** @internal */
+    _client;
+    constructor(client) {
+        this._client = client;
+    }
+}
+//# sourceMappingURL=resource.js.map

package/dist/resource.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resource.js","sourceRoot":"","sources":["../src/resource.ts"],"names":[],"mappings":"AAIA,8CAA8C;AAC9C,MAAM,OAAO,WAAW;IACtB,gBAAgB;IACG,OAAO,CAAa;IAEvC,YAAY,MAAkB;QAC5B,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC;IACxB,CAAC;CACF"}

package/dist/streaming.d.ts

@@ -0,0 +1,27 @@
+/**
+ * A typed event stream. Iterate it once with `for await`; `abort()` closes it.
+ * Like EventSource, the stream does not end when the server closes the
+ * connection: it reconnects from the last durable frame until the reconnect
+ * budget is spent, then throws.
+ */
+export declare class Stream<T> implements AsyncIterable<T> {
+    #private;
+    readonly controller: AbortController;
+    /** @internal */
+    constructor(iterate: (signal: AbortSignal) => AsyncGenerator<T>, controller: AbortController);
+    [Symbol.asyncIterator](): AsyncGenerator<T>;
+    /** Closes the connection; a pending iteration ends with APIUserAbortError. */
+    abort(): void;
+}
+/** @internal One raw SSE frame. */
+export interface RawSSEFrame {
+    event: string;
+    id?: string;
+    data: string;
+}
+/**
+ * @internal Minimal text/event-stream parser (WHATWG HTML §9.2.6 field rules).
+ * A frame not terminated by a blank line when the body ends is discarded, as
+ * the spec requires. `onLine` runs for every line, comments included.
+ */
+export declare function parseSSE(body: ReadableStream<Uint8Array>, onLine?: () => void): AsyncGenerator<RawSSEFrame>;

package/dist/streaming.js

@@ -0,0 +1,89 @@
+// Server-sent event streams.
+import { BmaError } from "./errors.js";
+/**
+ * A typed event stream. Iterate it once with `for await`; `abort()` closes it.
+ * Like EventSource, the stream does not end when the server closes the
+ * connection: it reconnects from the last durable frame until the reconnect
+ * budget is spent, then throws.
+ */
+export class Stream {
+    controller;
+    #iterate;
+    #used = false;
+    /** @internal */
+    constructor(iterate, controller) {
+        this.#iterate = iterate;
+        this.controller = controller;
+    }
+    [Symbol.asyncIterator]() {
+        if (this.#used)
+            throw new BmaError("bma: a Stream can be iterated only once");
+        this.#used = true;
+        return this.#iterate(this.controller.signal);
+    }
+    /** Closes the connection; a pending iteration ends with APIUserAbortError. */
+    abort() {
+        this.controller.abort();
+    }
+}
+/**
+ * @internal Minimal text/event-stream parser (WHATWG HTML §9.2.6 field rules).
+ * A frame not terminated by a blank line when the body ends is discarded, as
+ * the spec requires. `onLine` runs for every line, comments included.
+ */
+export async function* parseSSE(body, onLine) {
+    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) {
+                // A trailing \r may be the first half of a \r\n split across chunks.
+                if (!done && newline === buffer.length - 1 && buffer.endsWith("\r"))
+                    break;
+                const line = buffer.slice(0, newline);
+                buffer = buffer.slice(newline + (buffer.startsWith("\r\n", newline) ? 2 : 1));
+                onLine?.();
+                if (line === "") {
+                    const frame = dispatch();
+                    if (frame)
+                        yield frame;
+                    continue;
+                }
+                if (line.startsWith(":"))
+                    continue;
+                const colon = line.indexOf(":");
+                const name = colon < 0 ? line : line.slice(0, colon);
+                let value = colon < 0 ? "" : line.slice(colon + 1);
+                if (value.startsWith(" "))
+                    value = value.slice(1);
+                if (name === "event")
+                    event = value;
+                else if (name === "id")
+                    id = value;
+                else if (name === "data")
+                    data.push(value);
+            }
+            if (done)
+                return; // an unterminated frame is discarded
+        }
+    }
+    finally {
+        await reader.cancel().catch(() => undefined);
+        reader.releaseLock();
+    }
+}
+//# sourceMappingURL=streaming.js.map

package/dist/streaming.js.map

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

package/dist/version.d.ts

@@ -0,0 +1 @@
+export declare const SDK_VERSION = "1.0.0";

package/dist/version.js

@@ -0,0 +1,4 @@
+// The package version, sent in User-Agent. tools/check_versions.sh keeps it
+// equal to package.json (CI) and to the release tag (release.yaml).
+export const SDK_VERSION = "1.0.0";
+//# sourceMappingURL=version.js.map

package/dist/version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA,4EAA4E;AAC5E,oEAAoE;AACpE,MAAM,CAAC,MAAM,WAAW,GAAG,OAAO,CAAC"}

package/package.json

@@ -1,11 +1,11 @@
 {
   "name": "@beeos-ai/bma-sdk",
-  "version": "0.4.1",
+  "version": "1.0.0",
   "description": "TypeScript client for the BMA REST API and the BMA extensions to the Anthropic Managed Agents API.",
   "license": "Apache-2.0",
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/beeos-ai/bma-sdks.git",
+    "url": "git+https://github.com/beeos-ai/bma-sdk.git",
     "directory": "typescript"
   },
   "type": "module",
@@ -36,7 +36,9 @@
   },
   "devDependencies": {
     "@types/node": "^22.0.0",
+    "expect-type": "1.4.0",
     "openapi-typescript": "7.13.0",
-    "typescript": "5.9.3"
+    "typescript": "5.9.3",
+    "zod": "4.6.7"
   }
 }