@beeos-ai/bma-sdk 0.3.0 → 0.4.0

package/README.md

@@ -47,3 +47,6 @@ It also exports the extension field types `ModelConfigOverride`
 (`agent.model.api_url/api_key/api_format`), `MCPServerBMAAuth`
 (`mcp_servers[].bma_auth`), `IDEMPOTENCY_KEY_HEADER`, and `bmaSequence(event)`
 for `bma_sequence` resume cursors.
+
+The executor protocol (executor, harness and agent ends) is the separate
+package [`@beeos-ai/bma-executor-sdk`](../executor/typescript).

package/dist/facade-extensions.d.ts

@@ -4,6 +4,17 @@ export type { paths as FacadeExtensionPaths };
 export type DesktopStream = components["schemas"]["DesktopStream"];
 export type SessionFile = components["schemas"]["SessionFile"];
 export type SessionFilePage = components["schemas"]["SessionFilePage"];
+/** BMA extension: a project file mounted into a session. */
+export type FileResource = components["schemas"]["FileResource"];
+export type FileResourcePage = components["schemas"]["FileResourcePage"];
+export type DeletedSessionResource = components["schemas"]["DeletedSessionResource"];
+/** BMA extension: one downloaded session file with its response metadata. */
+export interface SessionFileContent {
+    content: Uint8Array;
+    contentType: string | null;
+    filename: string | null;
+    digest: string | null;
+}
 /** BMA extension: session `agent.model` object with a write-only credential override. */
 export type ModelConfigOverride = components["schemas"]["ModelConfigOverride"];
 /** BMA extension: `mcp_servers[].bma_auth`. */
@@ -49,4 +60,12 @@ export declare class FacadeExtensionsClient {
         limit?: number;
         page?: string;
     }): Promise<SessionFilePage>;
+    /** BMA extension: GET /v1/sessions/{session_id}/files/{file_id}/content. */
+    downloadSessionFile(sessionId: string, fileId: string): Promise<SessionFileContent>;
+    /** BMA extension: POST /v1/sessions/{session_id}/resources. */
+    addSessionResource(sessionId: string, fileId: string, mountPath?: string): Promise<FileResource>;
+    /** BMA extension: GET /v1/sessions/{session_id}/resources. */
+    listSessionResources(sessionId: string): Promise<FileResourcePage>;
+    /** BMA extension: DELETE /v1/sessions/{session_id}/resources/{resource_id}. */
+    deleteSessionResource(sessionId: string, resourceId: string): Promise<DeletedSessionResource>;
 }

package/dist/facade-extensions.js

@@ -1,12 +1,18 @@
 // BMA extensions to the Anthropic Managed Agents API.
 //
 // The standard facade routes (/v1/agents, /v1/environments, /v1/sessions,
-// events, events/stream, /v1/memory_stores) are served by the official
-// Anthropic SDKs pointed at a BMA deployment. Everything in this module is a
+// events, events/stream, /v1/files, /v1/memory_stores) are served by the
+// official Anthropic SDKs pointed at a BMA deployment. Everything in this module is a
 // BMA extension that is NOT part of the Anthropic contract. Types come from
 // src/generated/facade-extensions.ts, generated from
 // contracts/bma/facade-extensions.openapi.yaml.
 import createClient from "openapi-fetch";
+function dispositionFilename(value) {
+    if (!value)
+        return null;
+    const match = /filename\*?=(?:UTF-8'')?"?([^";]+)"?/i.exec(value);
+    return match?.[1] ? decodeURIComponent(match[1]) : null;
+}
 /** BMA extension header forwarded on session create and send-events. */
 export const IDEMPOTENCY_KEY_HEADER = "Idempotency-Key";
 /**
@@ -86,5 +92,43 @@ export class FacadeExtensionsClient {
             params: { path: { session_id: sessionId }, query: { limit: options.limit, page: options.page } },
         }));
     }
+    /** BMA extension: GET /v1/sessions/{session_id}/files/{file_id}/content. */
+    async downloadSessionFile(sessionId, fileId) {
+        const result = await this.raw.GET("/v1/sessions/{session_id}/files/{file_id}/content", {
+            params: { path: { session_id: sessionId, file_id: fileId } },
+            parseAs: "arrayBuffer",
+        });
+        if (!result.response.ok)
+            throw new FacadeApiError(result.response.status, result.error);
+        return {
+            content: new Uint8Array(result.data),
+            contentType: result.response.headers.get("content-type"),
+            filename: dispositionFilename(result.response.headers.get("content-disposition")),
+            digest: result.response.headers.get("x-bma-file-digest"),
+        };
+    }
+    /** BMA extension: POST /v1/sessions/{session_id}/resources. */
+    async addSessionResource(sessionId, fileId, mountPath) {
+        return check(await this.raw.POST("/v1/sessions/{session_id}/resources", {
+            params: { path: { session_id: sessionId } },
+            body: {
+                type: "file",
+                file_id: fileId,
+                ...(mountPath === undefined ? {} : { mount_path: mountPath }),
+            },
+        }));
+    }
+    /** BMA extension: GET /v1/sessions/{session_id}/resources. */
+    async listSessionResources(sessionId) {
+        return check(await this.raw.GET("/v1/sessions/{session_id}/resources", {
+            params: { path: { session_id: sessionId } },
+        }));
+    }
+    /** BMA extension: DELETE /v1/sessions/{session_id}/resources/{resource_id}. */
+    async deleteSessionResource(sessionId, resourceId) {
+        return check(await this.raw.DELETE("/v1/sessions/{session_id}/resources/{resource_id}", {
+            params: { path: { session_id: sessionId, resource_id: resourceId } },
+        }));
+    }
 }
 //# sourceMappingURL=facade-extensions.js.map

package/dist/facade-extensions.js.map

@@ -1 +1 @@
-{"version":3,"file":"facade-extensions.js","sourceRoot":"","sources":["../src/facade-extensions.ts"],"names":[],"mappings":"AAAA,sDAAsD;AACtD,EAAE;AACF,0EAA0E;AAC1E,uEAAuE;AACvE,6EAA6E;AAC7E,4EAA4E;AAC5E,qDAAqD;AACrD,gDAAgD;AAChD,OAAO,YAA6B,MAAM,eAAe,CAAC;AAY1D,wEAAwE;AACxE,MAAM,CAAC,MAAM,sBAAsB,GAAG,iBAAiB,CAAC;AAExD;;;;GAIG;AACH,MAAM,UAAU,WAAW,CAAC,KAAc;IACxC,MAAM,KAAK,GAAI,KAA2C,EAAE,YAAY,CAAC;IACzE,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;AACnG,CAAC;AAYD,8EAA8E;AAC9E,MAAM,OAAO,cAAe,SAAQ,KAAK;IAC9B,MAAM,CAAS;IACf,IAAI,CAAS;IACb,IAAI,CAAU;IAEvB,YAAY,MAAc,EAAE,IAAa;QACvC,MAAM,KAAK,GAAG,CAAE,IAAmC,EAAE,KAAK,IAAI,EAAE,CAA0D,CAAC;QAC3H,MAAM,IAAI,GAAG,OAAO,KAAK,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,WAAW,CAAC;QACvE,MAAM,OAAO,GAAG,OAAO,KAAK,CAAC,OAAO,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,KAAK,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ,MAAM,EAAE,CAAC;QAC7G,KAAK,CAAC,oBAAoB,MAAM,IAAI,IAAI,KAAK,OAAO,EAAE,CAAC,CAAC;QACxD,IAAI,CAAC,IAAI,GAAG,gBAAgB,CAAC;QAC7B,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,IAAI,GAAG,OAAO,KAAK,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC;IACtE,CAAC;CACF;AAED,SAAS,KAAK,CAAI,MAAyD;IACzE,IAAI,MAAM,CAAC,QAAQ,CAAC,EAAE;QAAE,OAAO,MAAM,CAAC,IAAS,CAAC;IAChD,MAAM,IAAI,cAAc,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC;AACjE,CAAC;AAED,8EAA8E;AAC9E,MAAM,OAAO,sBAAsB;IACxB,GAAG,CAAgB;IAE5B,YAAY,OAAgC;QAC1C,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC;QACtC,IAAI,CAAC,MAAM;YAAE,MAAM,IAAI,KAAK,CAAC,gCAAgC,CAAC,CAAC;QAC/D,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;QAC5D,IAAI,CAAC,OAAO;YAAE,MAAM,IAAI,KAAK,CAAC,iCAAiC,CAAC,CAAC;QACjE,IAAI,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,oDAAoD,CAAC,CAAC;QACnG,MAAM,OAAO,GAA2B,EAAE,WAAW,EAAE,MAAM,EAAE,CAAC;QAChE,IAAI,OAAO,CAAC,SAAS;YAAE,OAAO,CAAC,kBAAkB,CAAC,GAAG,OAAO,CAAC,SAAS,CAAC;QACvE,IAAI,CAAC,GAAG,GAAG,YAAY,CAAQ,EAAE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,IAAI,UAAU,CAAC,KAAK,EAAE,CAAC,CAAC;IACjG,CAAC;IAED,mEAAmE;IACnE,KAAK,CAAC,uBAAuB,CAC3B,SAAiB,EACjB,OAA2E;QAE3E,OAAO,KAAK,CACV,MAAM,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,0CAA0C,EAAE;YAC7D,MAAM,EAAE;gBACN,IAAI,EAAE,EAAE,UAAU,EAAE,SAAS,EAAE;gBAC/B,KAAK,EAAE;oBACL,kBAAkB,EAAE,OAAO,CAAC,gBAAgB;oBAC5C,WAAW,EAAE,OAAO,CAAC,UAAU;oBAC/B,MAAM,EAAE,OAAO,CAAC,MAAM;iBACvB;aACF;SACF,CAAC,CACH,CAAC;IACJ,CAAC;IAED,sFAAsF;IACtF,KAAK,CAAC,iBAAiB,CAAC,SAAiB,EAAE,IAAU,EAAE,QAAgB;QACrE,MAAM,IAAI,GAAG,IAAI,QAAQ,EAAE,CAAC;QAC5B,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,IAAI,EAAE,QAAQ,CAAC,CAAC;QACpC,OAAO,KAAK,CACV,MAAM,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,iCAAiC,EAAE;YACrD,MAAM,EAAE,EAAE,IAAI,EAAE,EAAE,UAAU,EAAE,SAAS,EAAE,EAAE;YAC3C,2EAA2E;YAC3E,IAAI,EAAE,IAAmC;YACzC,cAAc,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,IAA2B;SACtD,CAAC,CACH,CAAC;IACJ,CAAC;IAED,0DAA0D;IAC1D,KAAK,CAAC,gBAAgB,CAAC,SAAiB,EAAE,UAA6C,EAAE;QACvF,OAAO,KAAK,CACV,MAAM,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,iCAAiC,EAAE;YACpD,MAAM,EAAE,EAAE,IAAI,EAAE,EAAE,UAAU,EAAE,SAAS,EAAE,EAAE,KAAK,EAAE,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,EAAE;SACjG,CAAC,CACH,CAAC;IACJ,CAAC;CACF"}
+{"version":3,"file":"facade-extensions.js","sourceRoot":"","sources":["../src/facade-extensions.ts"],"names":[],"mappings":"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"}

package/dist/generated/facade-extensions.d.ts

@@ -51,6 +51,77 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/v1/sessions/{session_id}/files/{file_id}/content": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Download one session file (BMA extension)
+         * @description Streams one file's bytes. `file_id` is the `id` returned by the upload
+         *     or list operations. The response carries `Content-Type`,
+         *     `Content-Length` and `Content-Disposition` when known, and
+         *     `X-BMA-File-Digest` with the sha256 of the bytes. A file of another
+         *     session, or an unknown id, is a 404 `not_found_error`.
+         */
+        get: operations["downloadSessionFile"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/sessions/{session_id}/resources": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /** List the session's mounted file resources (BMA extension) */
+        get: operations["listSessionResources"];
+        put?: never;
+        /**
+         * Mount one project file into the session (BMA extension)
+         * @description Mounts an uploaded project file by reference. The Anthropic contract
+         *     mounts files through `resources` on `POST /v1/sessions`; this extension
+         *     mounts into an existing session. The file is read-only at `mount_path`
+         *     (default `/mnt/session/uploads/<file_id>`), and the response `file_id`
+         *     is the session instance created for the mount, not the project file's
+         *     own id.
+         */
+        post: operations["addSessionResource"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/sessions/{session_id}/resources/{resource_id}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        post?: never;
+        /**
+         * Unmount one file resource from the session (BMA extension)
+         * @description Removes the mount and releases the session instance. The project file
+         *     itself is kept; other sessions that mounted it keep their instances.
+         */
+        delete: operations["deleteSessionResource"];
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
 }
 export type webhooks = Record<string, never>;
 export interface components {
@@ -87,6 +158,39 @@ export interface components {
             data: components["schemas"]["SessionFile"][];
             next_page: string | null;
         };
+        FileResourceParams: {
+            /** @enum {string} */
+            type: "file";
+            /** @description The project file (`file_...`) to mount. */
+            file_id: string;
+            /**
+             * @description Absolute path below `/mnt/session/uploads` the session's tools read
+             *     the file at. A path outside it is placed under it. Defaults to
+             *     `/mnt/session/uploads/<file_id>`.
+             */
+            mount_path?: string | null;
+        };
+        FileResource: {
+            /** @description Opaque, stable resource id. */
+            id: string;
+            /** @enum {string} */
+            type: "file";
+            /** @description The session instance created for the mount. */
+            file_id: string;
+            mount_path: string;
+            /** Format: date-time */
+            created_at: string;
+            /** Format: date-time */
+            updated_at: string;
+        };
+        FileResourcePage: {
+            data: components["schemas"]["FileResource"][];
+        };
+        DeletedSessionResource: {
+            id: string;
+            /** @enum {string} */
+            type: "session_resource_deleted";
+        };
         ErrorEnvelope: {
             /** @constant */
             type: "error";
@@ -269,4 +373,135 @@ export interface operations {
             default: components["responses"]["Error"];
         };
     };
+    downloadSessionFile: {
+        parameters: {
+            query?: never;
+            header?: {
+                /**
+                 * @description Project to operate in. Required when the key can read more than one
+                 *     project and the deployment has no default project.
+                 *     `anthropic-workspace-id` is accepted as an alias.
+                 */
+                "x-bma-project-id"?: components["parameters"]["ProjectID"];
+            };
+            path: {
+                session_id: components["parameters"]["SessionID"];
+                file_id: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description The file bytes. */
+            200: {
+                headers: {
+                    /** @description sha256 of the response body. */
+                    "X-BMA-File-Digest"?: string;
+                    /** @description Suggested download filename. */
+                    "Content-Disposition"?: string;
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/octet-stream": string;
+                };
+            };
+            default: components["responses"]["Error"];
+        };
+    };
+    listSessionResources: {
+        parameters: {
+            query?: never;
+            header?: {
+                /**
+                 * @description Project to operate in. Required when the key can read more than one
+                 *     project and the deployment has no default project.
+                 *     `anthropic-workspace-id` is accepted as an alias.
+                 */
+                "x-bma-project-id"?: components["parameters"]["ProjectID"];
+            };
+            path: {
+                session_id: components["parameters"]["SessionID"];
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description The session's mounted file resources. */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["FileResourcePage"];
+                };
+            };
+            default: components["responses"]["Error"];
+        };
+    };
+    addSessionResource: {
+        parameters: {
+            query?: never;
+            header?: {
+                /**
+                 * @description Project to operate in. Required when the key can read more than one
+                 *     project and the deployment has no default project.
+                 *     `anthropic-workspace-id` is accepted as an alias.
+                 */
+                "x-bma-project-id"?: components["parameters"]["ProjectID"];
+            };
+            path: {
+                session_id: components["parameters"]["SessionID"];
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["FileResourceParams"];
+            };
+        };
+        responses: {
+            /** @description The mounted resource. */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["FileResource"];
+                };
+            };
+            default: components["responses"]["Error"];
+        };
+    };
+    deleteSessionResource: {
+        parameters: {
+            query?: never;
+            header?: {
+                /**
+                 * @description Project to operate in. Required when the key can read more than one
+                 *     project and the deployment has no default project.
+                 *     `anthropic-workspace-id` is accepted as an alias.
+                 */
+                "x-bma-project-id"?: components["parameters"]["ProjectID"];
+            };
+            path: {
+                session_id: components["parameters"]["SessionID"];
+                /** @description The `id` of the mounted resource. */
+                resource_id: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description The resource was removed. */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["DeletedSessionResource"];
+                };
+            };
+            default: components["responses"]["Error"];
+        };
+    };
 }