@beeos-ai/bma-sdk 0.0.0-stage → 0.4.0

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

@@ -0,0 +1,507 @@
+/**
+ * This file was auto-generated by openapi-typescript.
+ * Do not make direct changes to the file.
+ */
+export interface paths {
+    "/v1/sessions/{session_id}/desktop/stream": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Mint a desktop watch ticket for a session (BMA extension)
+         * @description Returns a short-lived, single-use, origin-bound watch ticket and the
+         *     WebSocket endpoint of the desktop session attached to the session's
+         *     machine. The browser connects to `url` with `subprotocol` and the
+         *     ticket; the tenant API key never reaches the browser.
+         */
+        get: operations["getSessionDesktopStream"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/sessions/{session_id}/files": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /** List files uploaded into the session (BMA extension) */
+        get: operations["listSessionFiles"];
+        put?: never;
+        /**
+         * Upload one file into the session (BMA extension)
+         * @description Stores one multipart file (at most 8 MiB, non-empty, bare filename) in
+         *     the session's read_write memory store under the session's own
+         *     directory. Create-only: an existing filename is a 409
+         *     `file_already_exists`. A session without a read_write memory store is a
+         *     409 `session_files_unavailable`.
+         */
+        post: operations["uploadSessionFile"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        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 {
+    schemas: {
+        DesktopStream: {
+            /** @constant */
+            type: "bma.desktop_stream";
+            session_id: string;
+            desktop_session_id: string;
+            machine_id: string;
+            /** @description WebSocket endpoint the ticket belongs to. */
+            url: string;
+            /** @description Single-use credential. Treat as a secret. */
+            ticket: string;
+            subprotocol: string;
+            /** Format: date-time */
+            expires_at: string;
+            permissions: string[];
+        };
+        SessionFile: {
+            /** @description Opaque, stable file id. */
+            id: string;
+            /** @constant */
+            type: "file";
+            filename: string;
+            /** @description Derived from the filename extension; advisory. */
+            mime_type: string;
+            /** Format: int64 */
+            size_bytes: number;
+            /** Format: date-time */
+            created_at: string;
+        };
+        SessionFilePage: {
+            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";
+            error: {
+                type: string;
+                message: string;
+                code?: string;
+            };
+        };
+        /**
+         * @description Session `agent.model` object with the BMA credential override. The
+         *     `api_*` fields are write-only and never echoed. `api_url` and
+         *     `api_format` are required when `api_key` is set.
+         */
+        ModelConfigOverride: {
+            id: string;
+            effort?: string | null;
+            inference_geo?: string | null;
+            speed?: string | null;
+            api_url?: string;
+            api_key?: string;
+            api_format?: string;
+        };
+        /**
+         * @description `mcp_servers[].bma_auth` binds an MCP server to a BMA project secret.
+         *     `service` and `region` are required for, and only allowed with,
+         *     `type: sigv4`.
+         */
+        MCPServerBMAAuth: {
+            /** @enum {string} */
+            type: "bearer" | "oauth" | "sigv4";
+            secret_id: string;
+            service?: string;
+            region?: string;
+        };
+        /**
+         * Format: int64
+         * @description `bma_sequence` on session events: the durable BMA agent-event sequence
+         *     the event was projected from. Absent on preview and synthetic events.
+         *     Resume a stream by sending it as `Last-Event-ID`.
+         */
+        BMASequence: number;
+    };
+    responses: {
+        /** @description Anthropic error envelope. */
+        Error: {
+            headers: {
+                [name: string]: unknown;
+            };
+            content: {
+                "application/json": components["schemas"]["ErrorEnvelope"];
+            };
+        };
+    };
+    parameters: {
+        SessionID: string;
+        /**
+         * @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.
+         */
+        ProjectID: string;
+        /**
+         * @description Replay key forwarded to BMA on `POST /v1/sessions` and
+         *     `POST /v1/sessions/{id}/events`. 1-255 characters, no surrounding
+         *     whitespace.
+         */
+        IdempotencyKey: string;
+    };
+    requestBodies: never;
+    headers: never;
+    pathItems: never;
+}
+export type $defs = Record<string, never>;
+export interface operations {
+    getSessionDesktopStream: {
+        parameters: {
+            query: {
+                desktop_session_id: string;
+                /** @description Ticket lifetime. Omit for the native default. */
+                ttl_seconds?: number;
+                /** @description Browser origin the ticket is bound to. Defaults to the request `Origin` header. */
+                origin?: string;
+            };
+            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 Desktop watch ticket. */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["DesktopStream"];
+                };
+            };
+            default: components["responses"]["Error"];
+        };
+    };
+    listSessionFiles: {
+        parameters: {
+            query?: {
+                limit?: number;
+                /** @description Opaque cursor from `next_page`. */
+                page?: string;
+            };
+            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 One page of session files ordered by filename. */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["SessionFilePage"];
+                };
+            };
+            default: components["responses"]["Error"];
+        };
+    };
+    uploadSessionFile: {
+        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: {
+                "multipart/form-data": {
+                    /** Format: binary */
+                    file: string;
+                };
+            };
+        };
+        responses: {
+            /** @description The stored file. */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["SessionFile"];
+                };
+            };
+            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"];
+        };
+    };
+}

package/dist/generated/facade-extensions.js

@@ -0,0 +1,6 @@
+/**
+ * This file was auto-generated by openapi-typescript.
+ * Do not make direct changes to the file.
+ */
+export {};
+//# sourceMappingURL=facade-extensions.js.map

package/dist/generated/facade-extensions.js.map

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