@beeos-ai/bma-sdk 1.0.0 → 2.0.0

package/dist/generated/{rest.js → extensions.js}

@@ -3,4 +3,4 @@
  * Do not make direct changes to the file.
  */
 export {};
-//# sourceMappingURL=rest.js.map
+//# sourceMappingURL=extensions.js.map

package/dist/generated/extensions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"extensions.js","sourceRoot":"","sources":["../../src/generated/extensions.ts"],"names":[],"mappings":"AAAA;;;GAGG"}

package/dist/idempotency.d.ts

@@ -0,0 +1,4 @@
+/** A random Idempotency-Key for one extension create. It is computed once per
+ * call, so the official client's automatic retries resend the same key and the
+ * server replays the first result. */
+export declare function newIdempotencyKey(): string;

package/dist/idempotency.js

@@ -0,0 +1,7 @@
+/** A random Idempotency-Key for one extension create. It is computed once per
+ * call, so the official client's automatic retries resend the same key and the
+ * server replays the first result. */
+export function newIdempotencyKey() {
+    return globalThis.crypto.randomUUID();
+}
+//# sourceMappingURL=idempotency.js.map

package/dist/idempotency.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"idempotency.js","sourceRoot":"","sources":["../src/idempotency.ts"],"names":[],"mappings":"AAAA;;sCAEsC;AACtC,MAAM,UAAU,iBAAiB;IAC/B,OAAO,UAAU,CAAC,MAAM,CAAC,UAAU,EAAE,CAAC;AACxC,CAAC"}

package/dist/index.d.ts

@@ -1,55 +1,9 @@
-import { type Client } from "openapi-fetch";
-import type { components, operations, paths } from "./generated/rest.js";
-import { RestClientBase } from "./generated/rest-resources.js";
-import { SDK_VERSION } from "./version.js";
-export { SDK_VERSION };
-export type { components, operations, paths };
-export type * from "./generated/rest-types.js";
-export type * from "./generated/rest-operations.js";
-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, type ErrorCode, } from "./errors.js";
-export { DEFAULT_MAX_RETRIES, DEFAULT_TIMEOUT_MS, type RequestOptions, type Uploadable } from "./core.js";
-export { PagePromise, type CursorPageBody, type Page, type PageItem } from "./pagination.js";
-export { Stream } from "./streaming.js";
-export { defineTool, ToolError, type RunnableTool, type ToolOutput, type ToolRunContext, type ToolRunner, type ToolRunnerParams } from "./lib/tool-runner.js";
-export type { DownloadArtifactOptions } from "./lib/artifacts.js";
-export type { StreamEventsEvent as AgentStreamEvent } from "./generated/rest-operations.js";
-/** Hosted BMA origin; the client adds the /api/v1 prefix. */
-export declare const DEFAULT_BASE_URL = "https://api.bma.beeos.ai";
-export interface BmaClientOptions {
-    /** BMA personal or organization bearer token; env BMA_TOKEN. */
-    token?: string;
-    /**
-     * Deployment origin, for example https://api.bma.beeos.ai; env BMA_BASE_URL.
-     * The client adds /api/v1; a value that already ends with /api/v1 is accepted.
-     */
-    baseUrl?: string;
-    /** Default organization (org_...) for org- and project-scoped methods; env BMA_ORG_ID. */
-    orgId?: string;
-    /** Default project (prj_...) for project-scoped methods; env BMA_PROJECT_ID. */
-    projectId?: string;
-    /**
-     * Per-attempt timeout in milliseconds until the response headers arrive
-     * (default 60 000; 0 disables it). Uploads have no default timeout.
-     */
-    timeout?: number;
-    /** Retries after the first attempt (default 2). */
-    maxRetries?: number;
-    /** Optional fetch implementation; defaults to globalThis.fetch. */
-    fetch?: typeof globalThis.fetch;
-}
-/** Authenticated BMA REST client. */
-export declare class BmaClient extends RestClientBase {
-    /**
-     * Escape hatch: the openapi-fetch client typed by contract path, for
-     * operations without a resource method (Machine Daemon). Pair with unwrap().
-     */
-    readonly rest: Client<paths>;
-    constructor(options?: BmaClientOptions);
-}
-/** Escape hatch companion of `bma.rest`: returns `data` or throws the typed error. */
-export declare function unwrap<T>(result: {
-    data?: T;
-    error?: unknown;
-    response: Response;
-}): T;
+export { BmaClient, DEFAULT_BASE_URL, type BmaClientOptions } from './client.js';
+export { BmaClient as default } from './client.js';
+export { SDK_VERSION } from './version.js';
+export { errorCode } from './errors.js';
+export { agentExtensions, environmentExtensions, eventExtensions, sessionExtensions, type AgentExt, type AgentExtParams, type AgentModelOverride, type AgentModelOverrideInput, type AgentModelOverridePatch, type EnvironmentDesktop, type EnvironmentExt, type EnvironmentExtParams, type EnvironmentMachine, type EventExt, type Harness, type SessionCreateExt, type SessionExt, type SessionUpdateExt, } from './extensions.js';
+export * from './generated/extensions-resources.js';
+export type { components } from './generated/extensions.js';
+export { BmaBeta, BmaEvents, BmaSessions } from './beta.js';
+export { AnthropicError, APIError, APIConnectionError, APIConnectionTimeoutError, APIUserAbortError, AuthenticationError, BadRequestError, ConflictError, ContentTooLargeError, GatewayTimeoutError, InternalServerError, NotFoundError, OverloadedError, PermissionDeniedError, PreconditionFailedError, RateLimitError, RequestTimeoutError, ServiceUnavailableError, UnprocessableEntityError, } from '@anthropic-ai/sdk';

package/dist/index.js

@@ -1,58 +1,10 @@
-// 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";
-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 extends RestClientBase {
-    /**
-     * Escape hatch: the openapi-fetch client typed by contract path, for
-     * operations without a resource method (Machine Daemon). Pair with unwrap().
-     */
-    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 });
-    }
-}
-/** 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);
-}
+export { BmaClient, DEFAULT_BASE_URL } from './client.js';
+export { BmaClient as default } from './client.js';
+export { SDK_VERSION } from './version.js';
+export { errorCode } from './errors.js';
+export { agentExtensions, environmentExtensions, eventExtensions, sessionExtensions, } from './extensions.js';
+export * from './generated/extensions-resources.js';
+export { BmaBeta, BmaEvents, BmaSessions } from './beta.js';
+// The official error classes, so one import serves error handling.
+export { AnthropicError, APIError, APIConnectionError, APIConnectionTimeoutError, APIUserAbortError, AuthenticationError, BadRequestError, ConflictError, ContentTooLargeError, GatewayTimeoutError, InternalServerError, NotFoundError, OverloadedError, PermissionDeniedError, PreconditionFailedError, RateLimitError, RequestTimeoutError, ServiceUnavailableError, UnprocessableEntityError, } from '@anthropic-ai/sdk';
 //# 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":"AAAA,OAAO,EAAE,SAAS,EAAE,gBAAgB,EAAyB,MAAM,aAAa,CAAC;AACjF,OAAO,EAAE,SAAS,IAAI,OAAO,EAAE,MAAM,aAAa,CAAC;AACnD,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EACL,eAAe,EACf,qBAAqB,EACrB,eAAe,EACf,iBAAiB,GAelB,MAAM,iBAAiB,CAAC;AACzB,cAAc,qCAAqC,CAAC;AAEpD,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAC5D,mEAAmE;AACnE,OAAO,EACL,cAAc,EACd,QAAQ,EACR,kBAAkB,EAClB,yBAAyB,EACzB,iBAAiB,EACjB,mBAAmB,EACnB,eAAe,EACf,aAAa,EACb,oBAAoB,EACpB,mBAAmB,EACnB,mBAAmB,EACnB,aAAa,EACb,eAAe,EACf,qBAAqB,EACrB,uBAAuB,EACvB,cAAc,EACd,mBAAmB,EACnB,uBAAuB,EACvB,wBAAwB,GACzB,MAAM,mBAAmB,CAAC"}

package/dist/internal.d.ts

@@ -0,0 +1,9 @@
+import type { Anthropic } from '@anthropic-ai/sdk';
+/** The per-request options of the official client (its type is not exported). */
+export type RequestOptions = NonNullable<Parameters<Anthropic['beta']['sessions']['events']['stream']>[2]>;
+type HeadersLike = RequestOptions['headers'];
+/** Merges header sets; a later one wins. Explicit nulls (unset a default) are kept. */
+export declare function mergeHeaders(sets: HeadersLike[]): Headers;
+/** Tagged template for a URL path: every interpolated segment is checked and percent-encoded. */
+export declare function path(strings: TemplateStringsArray, ...segments: string[]): string;
+export {};

package/dist/internal.js

@@ -0,0 +1,32 @@
+/** Merges header sets; a later one wins. Explicit nulls (unset a default) are kept. */
+export function mergeHeaders(sets) {
+    const out = new Headers();
+    for (const set of sets) {
+        if (!set)
+            continue;
+        const entries = set instanceof Headers ? set.entries()
+            : Array.isArray(set) ? set
+                : 'values' in set && set.values instanceof Headers ? set.values.entries()
+                    : Object.entries(set);
+        for (const [name, value] of entries) {
+            if (value === undefined || value === null)
+                out.delete(name);
+            else
+                out.set(name, value);
+        }
+    }
+    return out;
+}
+/** Tagged template for a URL path: every interpolated segment is checked and percent-encoded. */
+export function path(strings, ...segments) {
+    return strings.reduce((url, text, i) => {
+        if (i === 0)
+            return text;
+        const segment = segments[i - 1];
+        if (segment === '' || segment === '.' || segment === '..') {
+            throw new TypeError(`Expected a valid path segment but received ${JSON.stringify(segment)}`);
+        }
+        return url + encodeURIComponent(segment) + text;
+    }, '');
+}
+//# sourceMappingURL=internal.js.map

package/dist/internal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"internal.js","sourceRoot":"","sources":["../src/internal.ts"],"names":[],"mappings":"AAOA,uFAAuF;AACvF,MAAM,UAAU,YAAY,CAAC,IAAmB;IAC9C,MAAM,GAAG,GAAG,IAAI,OAAO,EAAE,CAAC;IAC1B,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,IAAI,CAAC,GAAG;YAAE,SAAS;QACnB,MAAM,OAAO,GACX,GAAG,YAAY,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,EAAE;YACtC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAE,GAA0B;gBAClD,CAAC,CAAC,QAAQ,IAAI,GAAG,IAAK,GAA2B,CAAC,MAAM,YAAY,OAAO,CAAC,CAAC,CAAE,GAA2B,CAAC,MAAM,CAAC,OAAO,EAAE;oBAC3H,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,GAAgD,CAAC,CAAC;QACrE,KAAK,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,OAAO,EAAE,CAAC;YACpC,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI;gBAAE,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;;gBACvD,GAAG,CAAC,GAAG,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;QAC5B,CAAC;IACH,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,iGAAiG;AACjG,MAAM,UAAU,IAAI,CAAC,OAA6B,EAAE,GAAG,QAAkB;IACvE,OAAO,OAAO,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC,EAAE,EAAE;QACrC,IAAI,CAAC,KAAK,CAAC;YAAE,OAAO,IAAI,CAAC;QACzB,MAAM,OAAO,GAAG,QAAQ,CAAC,CAAC,GAAG,CAAC,CAAE,CAAC;QACjC,IAAI,OAAO,KAAK,EAAE,IAAI,OAAO,KAAK,GAAG,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;YAC1D,MAAM,IAAI,SAAS,CAAC,8CAA8C,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;QAC/F,CAAC;QACD,OAAO,GAAG,GAAG,kBAAkB,CAAC,OAAO,CAAC,GAAG,IAAI,CAAC;IAClD,CAAC,EAAE,EAAE,CAAC,CAAC;AACT,CAAC"}

package/dist/resume.d.ts

@@ -0,0 +1,22 @@
+import { Stream } from '@anthropic-ai/sdk/core/streaming';
+import type { BaseAnthropic } from '@anthropic-ai/sdk/client';
+/** Stream resumption: a dropped stream reconnects with Last-Event-ID, up to
+ * `maxReconnects` attempts in a row with exponential backoff from `backoffMs`
+ * to `maxBackoffMs`. Exported for the tests; not part of the public API. */
+export declare const streamResume: {
+    maxReconnects: number;
+    backoffMs: number;
+    maxBackoffMs: number;
+};
+/**
+ * resumable wraps the official, non-resuming event stream `first`. When the
+ * connection drops or the server ends the stream, it calls `connect` with the
+ * Last-Event-ID to send and carries on with the new stream, so no event is lost
+ * or repeated. One durable BMA event (a `bma_sequence`) projects into several
+ * frames that share its sequence and the server resumes after a whole
+ * sequence: it resumes after the previous sequence and skips the frames it
+ * already returned. It stops when the stream is aborted, after `maxReconnects`
+ * failed attempts in a row, or on an API error other than 408, 409, 429 and
+ * 5xx (which the official client retries first).
+ */
+export declare function resumable<Item extends object>(first: Stream<Item>, connect: (lastEventID: string | undefined) => Promise<Stream<Item>>, client: BaseAnthropic, signal?: AbortSignal | null): Stream<Item>;

package/dist/resume.js

@@ -0,0 +1,122 @@
+import { APIConnectionError, APIError } from '@anthropic-ai/sdk/core/error';
+import { Stream } from '@anthropic-ai/sdk/core/streaming';
+/** Stream resumption: a dropped stream reconnects with Last-Event-ID, up to
+ * `maxReconnects` attempts in a row with exponential backoff from `backoffMs`
+ * to `maxBackoffMs`. Exported for the tests; not part of the public API. */
+export const streamResume = { maxReconnects: 5, backoffMs: 500, maxBackoffMs: 8000 };
+function retryableStatus(status) {
+    return status === 408 || status === 409 || status === 429 || (status !== undefined && status >= 500);
+}
+function isAbort(error) {
+    return error instanceof Error && (error.name === 'AbortError' || error.name === 'APIUserAbortError');
+}
+function sleep(ms, signal) {
+    return new Promise((resolve) => {
+        const timer = setTimeout(done, ms);
+        signal.addEventListener('abort', done, { once: true });
+        function done() {
+            clearTimeout(timer);
+            signal.removeEventListener('abort', done);
+            resolve();
+        }
+    });
+}
+/**
+ * resumable wraps the official, non-resuming event stream `first`. When the
+ * connection drops or the server ends the stream, it calls `connect` with the
+ * Last-Event-ID to send and carries on with the new stream, so no event is lost
+ * or repeated. One durable BMA event (a `bma_sequence`) projects into several
+ * frames that share its sequence and the server resumes after a whole
+ * sequence: it resumes after the previous sequence and skips the frames it
+ * already returned. It stops when the stream is aborted, after `maxReconnects`
+ * failed attempts in a row, or on an API error other than 408, 409, 429 and
+ * 5xx (which the official client retries first).
+ */
+export function resumable(first, connect, client, signal) {
+    const master = new AbortController();
+    let current = first;
+    master.signal.addEventListener('abort', () => current?.controller.abort());
+    signal?.addEventListener('abort', () => master.abort(), { once: true });
+    let consumed = false;
+    async function* iterate() {
+        if (consumed) {
+            throw new Error('Cannot iterate over a consumed stream, use `.tee()` to split the stream.');
+        }
+        consumed = true;
+        let sequence = 0; // bma_sequence of the last durable frame
+        const seen = new Set(); // frame ids returned at `sequence`
+        let failures = 0;
+        try {
+            for (;;) {
+                let cause = new Error('stream ended');
+                try {
+                    for await (const frame of current) {
+                        const { id = '', bma_sequence: seq = 0 } = frame;
+                        if (seq > 0) {
+                            if (seq < sequence)
+                                continue; // replayed after a reconnect
+                            if (seq === sequence) {
+                                if (seen.has(id))
+                                    continue;
+                            }
+                            else {
+                                sequence = seq;
+                                seen.clear();
+                            }
+                            seen.add(id);
+                        }
+                        else if (id !== '') {
+                            // An announcement ahead of its durable copy (such as the
+                            // session.status_idle of requires_action): a replay of the
+                            // current sequence must not return it twice.
+                            if (seen.has(id))
+                                continue;
+                            seen.add(id);
+                        }
+                        failures = 0;
+                        yield frame;
+                    }
+                }
+                catch (error) {
+                    if (master.signal.aborted || isAbort(error))
+                        return;
+                    if (error instanceof APIError && !(error instanceof APIConnectionError))
+                        throw error;
+                    cause = error;
+                }
+                current?.controller.abort();
+                for (;;) {
+                    if (master.signal.aborted)
+                        return;
+                    if (failures >= streamResume.maxReconnects) {
+                        throw new Error(`bma-sdk: event stream not resumed after ${failures} attempts`, { cause });
+                    }
+                    const delay = Math.min(streamResume.backoffMs * 2 ** failures, streamResume.maxBackoffMs);
+                    failures++;
+                    await sleep(delay, master.signal);
+                    if (master.signal.aborted)
+                        return;
+                    try {
+                        // Resume after the previous sequence; none yet means the server's
+                        // default position (new events only).
+                        current = await connect(sequence >= 1 ? String(sequence - 1) : undefined);
+                        break;
+                    }
+                    catch (error) {
+                        if (master.signal.aborted || isAbort(error))
+                            return;
+                        if (error instanceof APIError && !(error instanceof APIConnectionError) && !retryableStatus(error.status)) {
+                            throw error;
+                        }
+                        cause = error;
+                    }
+                }
+            }
+        }
+        finally {
+            master.abort();
+        }
+    }
+    return new Stream(iterate, master, client);
+}
+//# sourceMappingURL=resume.js.map

package/dist/resume.js.map

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

package/dist/version.d.ts

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

package/dist/version.js

@@ -1,4 +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";
+// The version of this package, sent as X-BMA-SDK; tools/check_versions.sh keeps
+// it equal to package.json.
+export const SDK_VERSION = "2.0.0";
 //# sourceMappingURL=version.js.map

package/dist/version.js.map

@@ -1 +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"}
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAChF,4BAA4B;AAC5B,MAAM,CAAC,MAAM,WAAW,GAAG,OAAO,CAAC"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@beeos-ai/bma-sdk",
-  "version": "1.0.0",
-  "description": "TypeScript client for the BMA REST API and the BMA extensions to the Anthropic Managed Agents API.",
+  "version": "2.0.0",
+  "description": "TypeScript client for BMA: the official Anthropic SDK with the BMA extensions (machines, machine pools, desktop and terminal sessions) under client.beta.",
   "license": "Apache-2.0",
   "repository": {
     "type": "git",
@@ -13,10 +13,6 @@
     ".": {
       "types": "./dist/index.d.ts",
       "import": "./dist/index.js"
-    },
-    "./facade-extensions": {
-      "types": "./dist/facade-extensions.d.ts",
-      "import": "./dist/facade-extensions.js"
     }
   },
   "files": [
@@ -27,18 +23,16 @@
     "node": ">=20"
   },
   "scripts": {
-    "generate": "openapi-typescript ../contracts/bma/rest.openapi.yaml -o src/generated/rest.ts && openapi-typescript ../contracts/bma/facade-extensions.openapi.yaml -o src/generated/facade-extensions.ts",
+    "generate": "openapi-typescript ../.build/extensions.openapi.ts.yaml --default-non-nullable=false -o src/generated/extensions.ts",
     "build": "tsc -p tsconfig.json",
     "test": "tsc -p tsconfig.test.json && node --test build-test/test/*.test.js"
   },
   "dependencies": {
-    "openapi-fetch": "0.17.0"
+    "@anthropic-ai/sdk": "1.6.0"
   },
   "devDependencies": {
-    "@types/node": "^22.0.0",
-    "expect-type": "1.4.0",
+    "@types/node": "^26.6.6",
     "openapi-typescript": "7.13.0",
-    "typescript": "5.9.3",
-    "zod": "4.6.7"
+    "typescript": "5.9.3"
   }
 }

package/dist/core.d.ts

@@ -1,105 +0,0 @@
-import { PagePromise, type CursorPageBody } from "./pagination.js";
-import { Stream } from "./streaming.js";
-/**
- * Default per-attempt timeout (D3), measured until the response headers
- * arrive. Uploads (binary and multipart bodies) have no default timeout;
- * event streams and downloads are bounded only until the headers arrive.
- */
-export declare const DEFAULT_TIMEOUT_MS = 60000;
-/** Default retries after the first attempt (D3; @anthropic-ai/sdk uses 2). */
-export declare const DEFAULT_MAX_RETRIES = 2;
-/** Generated description of one contract operation. */
-export interface OperationDescriptor {
-    readonly id: string;
-    readonly method: "GET" | "POST" | "PUT" | "PATCH" | "DELETE";
-    readonly path: string;
-    /** Path template name -> params key (scope params) or positional name. */
-    readonly pathParams?: Readonly<Record<string, string>>;
-    /** Query name -> serialization style. */
-    readonly query?: Readonly<Record<string, string>>;
-    /** Header name -> params key. */
-    readonly headers?: Readonly<Record<string, string>>;
-    readonly body?: "json" | "binary" | "multipart";
-    readonly bodyRequired?: boolean;
-    readonly multipartJSON?: readonly string[];
-    readonly response: "json" | "void" | "binary" | "sse";
-    /** The operation accepts an Idempotency-Key header. */
-    readonly idempotency?: boolean;
-    /**
-     * Paginated list: [query parameter, response field] pairs, the default
-     * direction first, e.g. [["cursor", "next_cursor"]].
-     */
-    readonly page?: readonly (readonly [string, string])[];
-}
-/** Per-request options; every resource method takes them last. */
-export interface RequestOptions {
-    /**
-     * Per-attempt timeout in milliseconds, until the response headers arrive;
-     * 0 means none. Uploads use only this per-call value (no client default).
-     */
-    timeout?: number;
-    /** Retries after the first attempt; for event streams, reconnects in a row without receiving data. */
-    maxRetries?: number;
-    signal?: AbortSignal;
-    /**
-     * Idempotency-Key for operations that declare it. When omitted the SDK
-     * generates one and reuses it across the retries of this call.
-     */
-    idempotencyKey?: string;
-    headers?: Record<string, string>;
-}
-/** A raw request body: file contents or bytes. */
-export type Uploadable = Blob | ArrayBuffer | ArrayBufferView | string;
-/** @internal A body that may be omitted entirely. */
-export type OptionalBody<B> = B | {
-    [K in keyof B]?: never;
-};
-/** @internal A multipart body whose binary fields take a Blob or File. */
-export type MultipartBody<B, Files extends PropertyKey> = B extends unknown ? {
-    [K in keyof B]: K extends Files ? Blob : B[K];
-} : never;
-/** @internal */
-export interface ClientCoreOptions {
-    baseUrl: string;
-    fetch?: typeof globalThis.fetch;
-    timeout?: number;
-    maxRetries?: number;
-    /** Authentication and other headers sent on every request. */
-    headers: Record<string, string>;
-    /** Scope defaults keyed by params name (org_id, project_id). */
-    scope: Record<string, string | undefined>;
-    /** Client option that sets each scope default, for error messages. */
-    scopeOption: Record<string, string>;
-}
-/**
- * The deployment origin of a BMA base URL (BMA_BASE_URL): trailing slashes and
- * a trailing /api/v1 (the pre-1.0 API-root form) are removed, so the SDK adds
- * each API prefix exactly once.
- */
-export declare function bmaOrigin(baseUrl: string): string;
-/** @internal The transport every resource calls. */
-export declare class ClientCore {
-    #private;
-    readonly baseUrl: string;
-    constructor(options: ClientCoreOptions);
-    /** @internal */
-    _request<T>(op: OperationDescriptor, path: Record<string, string>, params: object, options?: RequestOptions): Promise<T>;
-    /**
-     * @internal A paginated list. The cursor parameter is the one of
-     * `op.page` the caller passed (e.g. before_sequence), else the default.
-     */
-    _page<R extends CursorPageBody>(op: OperationDescriptor, path: Record<string, string>, params: object, options?: RequestOptions): PagePromise<R>;
-    /**
-     * @internal Event stream with EventSource reconnection: when the
-     * connection drops or the server ends the response (a rolling restart), or
-     * sends an `error` frame with code `service_unavailable`, the stream
-     * reconnects with Last-Event-ID set to the last durable frame. A frame not
-     * terminated before the end is discarded. Reconnects are bounded by
-     * `maxReconnects` (default `maxRetries`) attempts in a row that receive no
-     * data; any other error frame ends the stream with EventStreamError.
-     */
-    _stream<T>(op: OperationDescriptor, path: Record<string, string>, params: object, options?: RequestOptions, hooks?: {
-        onOpen?: () => void;
-        maxReconnects?: number;
-    }): Stream<T>;
-}