@band-ai/rest-client 0.0.113 → 0.0.117

package/dist/esm/api/resources/agentApiEvents/exports.d.mts

@@ -0,0 +1,2 @@
+export { AgentApiEventsClient } from "./client/Client.mjs";
+export * from "./client/index.mjs";

package/dist/esm/api/resources/agentApiEvents/exports.mjs

@@ -0,0 +1,3 @@
+// This file was auto-generated by Fern from our API Definition.
+export { AgentApiEventsClient } from "./client/Client.mjs";
+export * from "./client/index.mjs";

package/dist/esm/api/resources/agentApiEvents/index.d.mts

@@ -0,0 +1,2 @@
+export * from "./client/index.mjs";
+export * from "./types/index.mjs";

package/dist/esm/api/resources/agentApiEvents/index.mjs

@@ -0,0 +1,2 @@
+export * from "./client/index.mjs";
+export * from "./types/index.mjs";

package/dist/esm/api/resources/agentApiEvents/types/CreateAgentChatEventResponse.d.mts

@@ -0,0 +1,4 @@
+import type * as Band from "../../../index.mjs";
+export interface CreateAgentChatEventResponse {
+    data: Band.EventCreatedResponse;
+}

package/dist/esm/api/resources/agentApiEvents/types/CreateAgentChatEventResponse.mjs

@@ -0,0 +1,2 @@
+// This file was auto-generated by Fern from our API Definition.
+export {};

package/dist/esm/api/resources/agentApiEvents/types/index.d.mts

@@ -0,0 +1 @@
+export * from "./CreateAgentChatEventResponse.mjs";

package/dist/esm/api/resources/agentApiEvents/types/index.mjs

@@ -0,0 +1 @@
+export * from "./CreateAgentChatEventResponse.mjs";

package/dist/esm/api/resources/agentApiIdentity/client/Client.d.mts

@@ -0,0 +1,30 @@
+import type { BaseClientOptions, BaseRequestOptions } from "../../../../BaseClient.mjs";
+import { type NormalizedClientOptionsWithAuth } from "../../../../BaseClient.mjs";
+import * as core from "../../../../core/index.mjs";
+import * as Band from "../../../index.mjs";
+export declare namespace AgentApiIdentityClient {
+    type Options = BaseClientOptions;
+    interface RequestOptions extends BaseRequestOptions {
+    }
+}
+/**
+ * Agent identity and profile endpoints. Validate API key and get agent details.
+ */
+export declare class AgentApiIdentityClient {
+    protected readonly _options: NormalizedClientOptionsWithAuth<AgentApiIdentityClient.Options>;
+    constructor(options: AgentApiIdentityClient.Options);
+    /**
+     * Returns the profile of the currently authenticated agent.
+     * Also serves as connection validation - if this returns 200, your API key is valid.
+     *
+     * @param {AgentApiIdentityClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link Band.UnauthorizedError}
+     * @throws {@link Band.ForbiddenError}
+     *
+     * @example
+     *     await client.agentApiIdentity.getAgentMe()
+     */
+    getAgentMe(requestOptions?: AgentApiIdentityClient.RequestOptions): core.HttpResponsePromise<Band.GetAgentMeResponse>;
+    private __getAgentMe;
+}

package/dist/esm/api/resources/agentApiIdentity/client/Client.mjs

@@ -0,0 +1,76 @@
+// This file was auto-generated by Fern from our API Definition.
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+import { normalizeClientOptionsWithAuth } from "../../../../BaseClient.mjs";
+import { mergeHeaders } from "../../../../core/headers.mjs";
+import * as core from "../../../../core/index.mjs";
+import * as environments from "../../../../environments.mjs";
+import { handleNonStatusCodeError } from "../../../../errors/handleNonStatusCodeError.mjs";
+import * as errors from "../../../../errors/index.mjs";
+import * as Band from "../../../index.mjs";
+/**
+ * Agent identity and profile endpoints. Validate API key and get agent details.
+ */
+export class AgentApiIdentityClient {
+    constructor(options) {
+        this._options = normalizeClientOptionsWithAuth(options);
+    }
+    /**
+     * Returns the profile of the currently authenticated agent.
+     * Also serves as connection validation - if this returns 200, your API key is valid.
+     *
+     * @param {AgentApiIdentityClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link Band.UnauthorizedError}
+     * @throws {@link Band.ForbiddenError}
+     *
+     * @example
+     *     await client.agentApiIdentity.getAgentMe()
+     */
+    getAgentMe(requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__getAgentMe(requestOptions));
+    }
+    __getAgentMe(requestOptions) {
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a, _b, _c, _d, _e, _f, _g, _h, _j;
+            const _authRequest = yield this._options.authProvider.getAuthRequest();
+            const _headers = mergeHeaders(_authRequest.headers, (_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers);
+            const _response = yield core.fetcher({
+                url: core.url.join((_c = (_b = (yield core.Supplier.get(this._options.baseUrl))) !== null && _b !== void 0 ? _b : (yield core.Supplier.get(this._options.environment))) !== null && _c !== void 0 ? _c : environments.BandEnvironment.Default, "api/v1/agent/me"),
+                method: "GET",
+                headers: _headers,
+                queryString: core.url.queryBuilder().mergeAdditional(requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams).build(),
+                timeoutMs: ((_f = (_d = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.timeoutInSeconds) !== null && _d !== void 0 ? _d : (_e = this._options) === null || _e === void 0 ? void 0 : _e.timeoutInSeconds) !== null && _f !== void 0 ? _f : 60) * 1000,
+                maxRetries: (_g = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.maxRetries) !== null && _g !== void 0 ? _g : (_h = this._options) === null || _h === void 0 ? void 0 : _h.maxRetries,
+                abortSignal: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.abortSignal,
+                fetchFn: (_j = this._options) === null || _j === void 0 ? void 0 : _j.fetch,
+                logging: this._options.logging,
+            });
+            if (_response.ok) {
+                return { data: _response.body, rawResponse: _response.rawResponse };
+            }
+            if (_response.error.reason === "status-code") {
+                switch (_response.error.statusCode) {
+                    case 401:
+                        throw new Band.UnauthorizedError(_response.error.body, _response.rawResponse);
+                    case 403:
+                        throw new Band.ForbiddenError(_response.error.body, _response.rawResponse);
+                    default:
+                        throw new errors.BandError({
+                            statusCode: _response.error.statusCode,
+                            body: _response.error.body,
+                            rawResponse: _response.rawResponse,
+                        });
+                }
+            }
+            return handleNonStatusCodeError(_response.error, _response.rawResponse, "GET", "/api/v1/agent/me");
+        });
+    }
+}

package/dist/esm/api/resources/agentApiIdentity/client/index.d.mts

@@ -0,0 +1 @@
+export {};

package/dist/esm/api/resources/agentApiIdentity/client/index.mjs

@@ -0,0 +1 @@
+export {};

package/dist/esm/api/resources/agentApiIdentity/exports.d.mts

@@ -0,0 +1,2 @@
+export { AgentApiIdentityClient } from "./client/Client.mjs";
+export * from "./client/index.mjs";

package/dist/esm/api/resources/agentApiIdentity/exports.mjs

@@ -0,0 +1,3 @@
+// This file was auto-generated by Fern from our API Definition.
+export { AgentApiIdentityClient } from "./client/Client.mjs";
+export * from "./client/index.mjs";

package/dist/esm/api/resources/agentApiIdentity/index.d.mts

@@ -0,0 +1,2 @@
+export * from "./client/index.mjs";
+export * from "./types/index.mjs";

package/dist/esm/api/resources/agentApiIdentity/index.mjs

@@ -0,0 +1,2 @@
+export * from "./client/index.mjs";
+export * from "./types/index.mjs";

package/dist/esm/api/resources/agentApiIdentity/types/GetAgentMeResponse.d.mts

@@ -0,0 +1,4 @@
+import type * as Band from "../../../index.mjs";
+export interface GetAgentMeResponse {
+    data: Band.AgentMe;
+}

package/dist/esm/api/resources/agentApiIdentity/types/GetAgentMeResponse.mjs

@@ -0,0 +1,2 @@
+// This file was auto-generated by Fern from our API Definition.
+export {};

package/dist/esm/api/resources/agentApiIdentity/types/index.d.mts

@@ -0,0 +1 @@
+export * from "./GetAgentMeResponse.mjs";

package/dist/esm/api/resources/agentApiIdentity/types/index.mjs

@@ -0,0 +1 @@
+export * from "./GetAgentMeResponse.mjs";

package/dist/esm/api/resources/agentApiMemories/client/Client.d.mts

@@ -0,0 +1,120 @@
+import type { BaseClientOptions, BaseRequestOptions } from "../../../../BaseClient.mjs";
+import { type NormalizedClientOptionsWithAuth } from "../../../../BaseClient.mjs";
+import * as core from "../../../../core/index.mjs";
+import * as Band from "../../../index.mjs";
+export declare namespace AgentApiMemoriesClient {
+    type Options = BaseClientOptions;
+    interface RequestOptions extends BaseRequestOptions {
+    }
+}
+/**
+ * Store and retrieve agent memories for persistent knowledge across sessions.
+ */
+export declare class AgentApiMemoriesClient {
+    protected readonly _options: NormalizedClientOptionsWithAuth<AgentApiMemoriesClient.Options>;
+    constructor(options: AgentApiMemoriesClient.Options);
+    /**
+     * Lists memories accessible to the agent. By default returns:
+     * - Memories about the specified subject (cross-agent sharing)
+     * - Organization-wide shared memories
+     *
+     * Use `scope` parameter to filter by visibility.
+     * Use `content_query` for full-text search across memory content.
+     *
+     * @param {Band.ListAgentMemoriesRequest} request
+     * @param {AgentApiMemoriesClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link Band.UnauthorizedError}
+     *
+     * @example
+     *     await client.agentApiMemories.listAgentMemories({
+     *         subject_id: "daca00d0-eb6b-4db1-8201-c46015c93d04",
+     *         scope: "subject",
+     *         system: "long_term",
+     *         type: "semantic",
+     *         segment: "user",
+     *         content_query: "prefers SUV",
+     *         page_size: 1,
+     *         status: "active"
+     *     })
+     */
+    listAgentMemories(request?: Band.ListAgentMemoriesRequest, requestOptions?: AgentApiMemoriesClient.RequestOptions): core.HttpResponsePromise<Band.ListAgentMemoriesResponse>;
+    private __listAgentMemories;
+    /**
+     * Stores a new memory entry. The memory will be:
+     * - Associated with the authenticated agent as the source
+     * - Scoped to the subject (for cross-agent sharing) or organization (for shared knowledge)
+     *
+     * For subject-scoped memories, provide a `subject_id` to associate the memory with a specific user or agent.
+     * For organization-scoped memories, omit `subject_id` - the memory will be visible to all agents in the org.
+     *
+     * @param {Band.CreateAgentMemoryRequest} request
+     * @param {AgentApiMemoriesClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link Band.UnauthorizedError}
+     * @throws {@link Band.UnprocessableEntityError}
+     *
+     * @example
+     *     await client.agentApiMemories.createAgentMemory({
+     *         memory: {
+     *             content: "content",
+     *             segment: "user",
+     *             system: "sensory",
+     *             thought: "thought",
+     *             type: "iconic"
+     *         }
+     *     })
+     */
+    createAgentMemory(request: Band.CreateAgentMemoryRequest, requestOptions?: AgentApiMemoriesClient.RequestOptions): core.HttpResponsePromise<Band.CreateAgentMemoryResponse>;
+    private __createAgentMemory;
+    /**
+     * Retrieves a specific memory by ID if accessible to the agent.
+     *
+     * @param {string} id - Memory ID
+     * @param {AgentApiMemoriesClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link Band.UnauthorizedError}
+     * @throws {@link Band.NotFoundError}
+     *
+     * @example
+     *     await client.agentApiMemories.getAgentMemory("daca00d0-eb6b-4db1-8201-c46015c93d04")
+     */
+    getAgentMemory(id: string, requestOptions?: AgentApiMemoriesClient.RequestOptions): core.HttpResponsePromise<Band.GetAgentMemoryResponse>;
+    private __getAgentMemory;
+    /**
+     * Archives a memory (hides but preserves). Use when memory is valid but not currently needed.
+     * Archived memories can be restored later by humans.
+     *
+     * Only the source agent can archive.
+     *
+     * @param {string} id - Memory ID
+     * @param {AgentApiMemoriesClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link Band.UnauthorizedError}
+     * @throws {@link Band.ForbiddenError}
+     * @throws {@link Band.NotFoundError}
+     *
+     * @example
+     *     await client.agentApiMemories.archiveAgentMemory("daca00d0-eb6b-4db1-8201-c46015c93d04")
+     */
+    archiveAgentMemory(id: string, requestOptions?: AgentApiMemoriesClient.RequestOptions): core.HttpResponsePromise<Band.ArchiveAgentMemoryResponse>;
+    private __archiveAgentMemory;
+    /**
+     * Marks a memory as superseded (soft delete). Use when information is outdated or incorrect.
+     * The memory remains for audit trail but won't appear in normal queries.
+     *
+     * Only the source agent can supersede.
+     *
+     * @param {string} id - Memory ID
+     * @param {AgentApiMemoriesClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link Band.UnauthorizedError}
+     * @throws {@link Band.ForbiddenError}
+     * @throws {@link Band.NotFoundError}
+     *
+     * @example
+     *     await client.agentApiMemories.supersedeAgentMemory("daca00d0-eb6b-4db1-8201-c46015c93d04")
+     */
+    supersedeAgentMemory(id: string, requestOptions?: AgentApiMemoriesClient.RequestOptions): core.HttpResponsePromise<Band.SupersedeAgentMemoryResponse>;
+    private __supersedeAgentMemory;
+}

package/dist/esm/api/resources/agentApiMemories/client/Client.mjs

@@ -0,0 +1,334 @@
+// This file was auto-generated by Fern from our API Definition.
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+import { normalizeClientOptionsWithAuth } from "../../../../BaseClient.mjs";
+import { mergeHeaders } from "../../../../core/headers.mjs";
+import * as core from "../../../../core/index.mjs";
+import * as environments from "../../../../environments.mjs";
+import { handleNonStatusCodeError } from "../../../../errors/handleNonStatusCodeError.mjs";
+import * as errors from "../../../../errors/index.mjs";
+import * as Band from "../../../index.mjs";
+/**
+ * Store and retrieve agent memories for persistent knowledge across sessions.
+ */
+export class AgentApiMemoriesClient {
+    constructor(options) {
+        this._options = normalizeClientOptionsWithAuth(options);
+    }
+    /**
+     * Lists memories accessible to the agent. By default returns:
+     * - Memories about the specified subject (cross-agent sharing)
+     * - Organization-wide shared memories
+     *
+     * Use `scope` parameter to filter by visibility.
+     * Use `content_query` for full-text search across memory content.
+     *
+     * @param {Band.ListAgentMemoriesRequest} request
+     * @param {AgentApiMemoriesClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link Band.UnauthorizedError}
+     *
+     * @example
+     *     await client.agentApiMemories.listAgentMemories({
+     *         subject_id: "daca00d0-eb6b-4db1-8201-c46015c93d04",
+     *         scope: "subject",
+     *         system: "long_term",
+     *         type: "semantic",
+     *         segment: "user",
+     *         content_query: "prefers SUV",
+     *         page_size: 1,
+     *         status: "active"
+     *     })
+     */
+    listAgentMemories(request = {}, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__listAgentMemories(request, requestOptions));
+    }
+    __listAgentMemories() {
+        return __awaiter(this, arguments, void 0, function* (request = {}, requestOptions) {
+            var _a, _b, _c, _d, _e, _f, _g, _h, _j;
+            const { subject_id: subjectId, scope, system, type: type_, segment, content_query: contentQuery, page_size: pageSize, status, } = request;
+            const _queryParams = {
+                subject_id: subjectId,
+                scope,
+                system,
+                type: type_,
+                segment,
+                content_query: contentQuery,
+                page_size: pageSize,
+                status,
+            };
+            const _authRequest = yield this._options.authProvider.getAuthRequest();
+            const _headers = mergeHeaders(_authRequest.headers, (_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers);
+            const _response = yield core.fetcher({
+                url: core.url.join((_c = (_b = (yield core.Supplier.get(this._options.baseUrl))) !== null && _b !== void 0 ? _b : (yield core.Supplier.get(this._options.environment))) !== null && _c !== void 0 ? _c : environments.BandEnvironment.Default, "api/v1/agent/memories"),
+                method: "GET",
+                headers: _headers,
+                queryString: core.url
+                    .queryBuilder()
+                    .addMany(_queryParams)
+                    .mergeAdditional(requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams)
+                    .build(),
+                timeoutMs: ((_f = (_d = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.timeoutInSeconds) !== null && _d !== void 0 ? _d : (_e = this._options) === null || _e === void 0 ? void 0 : _e.timeoutInSeconds) !== null && _f !== void 0 ? _f : 60) * 1000,
+                maxRetries: (_g = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.maxRetries) !== null && _g !== void 0 ? _g : (_h = this._options) === null || _h === void 0 ? void 0 : _h.maxRetries,
+                abortSignal: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.abortSignal,
+                fetchFn: (_j = this._options) === null || _j === void 0 ? void 0 : _j.fetch,
+                logging: this._options.logging,
+            });
+            if (_response.ok) {
+                return { data: _response.body, rawResponse: _response.rawResponse };
+            }
+            if (_response.error.reason === "status-code") {
+                switch (_response.error.statusCode) {
+                    case 401:
+                        throw new Band.UnauthorizedError(_response.error.body, _response.rawResponse);
+                    default:
+                        throw new errors.BandError({
+                            statusCode: _response.error.statusCode,
+                            body: _response.error.body,
+                            rawResponse: _response.rawResponse,
+                        });
+                }
+            }
+            return handleNonStatusCodeError(_response.error, _response.rawResponse, "GET", "/api/v1/agent/memories");
+        });
+    }
+    /**
+     * Stores a new memory entry. The memory will be:
+     * - Associated with the authenticated agent as the source
+     * - Scoped to the subject (for cross-agent sharing) or organization (for shared knowledge)
+     *
+     * For subject-scoped memories, provide a `subject_id` to associate the memory with a specific user or agent.
+     * For organization-scoped memories, omit `subject_id` - the memory will be visible to all agents in the org.
+     *
+     * @param {Band.CreateAgentMemoryRequest} request
+     * @param {AgentApiMemoriesClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link Band.UnauthorizedError}
+     * @throws {@link Band.UnprocessableEntityError}
+     *
+     * @example
+     *     await client.agentApiMemories.createAgentMemory({
+     *         memory: {
+     *             content: "content",
+     *             segment: "user",
+     *             system: "sensory",
+     *             thought: "thought",
+     *             type: "iconic"
+     *         }
+     *     })
+     */
+    createAgentMemory(request, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__createAgentMemory(request, requestOptions));
+    }
+    __createAgentMemory(request, requestOptions) {
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a, _b, _c, _d, _e, _f, _g, _h, _j;
+            const _authRequest = yield this._options.authProvider.getAuthRequest();
+            const _headers = mergeHeaders(_authRequest.headers, (_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers);
+            const _response = yield core.fetcher({
+                url: core.url.join((_c = (_b = (yield core.Supplier.get(this._options.baseUrl))) !== null && _b !== void 0 ? _b : (yield core.Supplier.get(this._options.environment))) !== null && _c !== void 0 ? _c : environments.BandEnvironment.Default, "api/v1/agent/memories"),
+                method: "POST",
+                headers: _headers,
+                contentType: "application/json",
+                queryString: core.url.queryBuilder().mergeAdditional(requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams).build(),
+                requestType: "json",
+                body: request,
+                timeoutMs: ((_f = (_d = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.timeoutInSeconds) !== null && _d !== void 0 ? _d : (_e = this._options) === null || _e === void 0 ? void 0 : _e.timeoutInSeconds) !== null && _f !== void 0 ? _f : 60) * 1000,
+                maxRetries: (_g = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.maxRetries) !== null && _g !== void 0 ? _g : (_h = this._options) === null || _h === void 0 ? void 0 : _h.maxRetries,
+                abortSignal: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.abortSignal,
+                fetchFn: (_j = this._options) === null || _j === void 0 ? void 0 : _j.fetch,
+                logging: this._options.logging,
+            });
+            if (_response.ok) {
+                return { data: _response.body, rawResponse: _response.rawResponse };
+            }
+            if (_response.error.reason === "status-code") {
+                switch (_response.error.statusCode) {
+                    case 401:
+                        throw new Band.UnauthorizedError(_response.error.body, _response.rawResponse);
+                    case 422:
+                        throw new Band.UnprocessableEntityError(_response.error.body, _response.rawResponse);
+                    default:
+                        throw new errors.BandError({
+                            statusCode: _response.error.statusCode,
+                            body: _response.error.body,
+                            rawResponse: _response.rawResponse,
+                        });
+                }
+            }
+            return handleNonStatusCodeError(_response.error, _response.rawResponse, "POST", "/api/v1/agent/memories");
+        });
+    }
+    /**
+     * Retrieves a specific memory by ID if accessible to the agent.
+     *
+     * @param {string} id - Memory ID
+     * @param {AgentApiMemoriesClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link Band.UnauthorizedError}
+     * @throws {@link Band.NotFoundError}
+     *
+     * @example
+     *     await client.agentApiMemories.getAgentMemory("daca00d0-eb6b-4db1-8201-c46015c93d04")
+     */
+    getAgentMemory(id, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__getAgentMemory(id, requestOptions));
+    }
+    __getAgentMemory(id, requestOptions) {
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a, _b, _c, _d, _e, _f, _g, _h, _j;
+            const _authRequest = yield this._options.authProvider.getAuthRequest();
+            const _headers = mergeHeaders(_authRequest.headers, (_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers);
+            const _response = yield core.fetcher({
+                url: core.url.join((_c = (_b = (yield core.Supplier.get(this._options.baseUrl))) !== null && _b !== void 0 ? _b : (yield core.Supplier.get(this._options.environment))) !== null && _c !== void 0 ? _c : environments.BandEnvironment.Default, `api/v1/agent/memories/${core.url.encodePathParam(id)}`),
+                method: "GET",
+                headers: _headers,
+                queryString: core.url.queryBuilder().mergeAdditional(requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams).build(),
+                timeoutMs: ((_f = (_d = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.timeoutInSeconds) !== null && _d !== void 0 ? _d : (_e = this._options) === null || _e === void 0 ? void 0 : _e.timeoutInSeconds) !== null && _f !== void 0 ? _f : 60) * 1000,
+                maxRetries: (_g = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.maxRetries) !== null && _g !== void 0 ? _g : (_h = this._options) === null || _h === void 0 ? void 0 : _h.maxRetries,
+                abortSignal: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.abortSignal,
+                fetchFn: (_j = this._options) === null || _j === void 0 ? void 0 : _j.fetch,
+                logging: this._options.logging,
+            });
+            if (_response.ok) {
+                return { data: _response.body, rawResponse: _response.rawResponse };
+            }
+            if (_response.error.reason === "status-code") {
+                switch (_response.error.statusCode) {
+                    case 401:
+                        throw new Band.UnauthorizedError(_response.error.body, _response.rawResponse);
+                    case 404:
+                        throw new Band.NotFoundError(_response.error.body, _response.rawResponse);
+                    default:
+                        throw new errors.BandError({
+                            statusCode: _response.error.statusCode,
+                            body: _response.error.body,
+                            rawResponse: _response.rawResponse,
+                        });
+                }
+            }
+            return handleNonStatusCodeError(_response.error, _response.rawResponse, "GET", "/api/v1/agent/memories/{id}");
+        });
+    }
+    /**
+     * Archives a memory (hides but preserves). Use when memory is valid but not currently needed.
+     * Archived memories can be restored later by humans.
+     *
+     * Only the source agent can archive.
+     *
+     * @param {string} id - Memory ID
+     * @param {AgentApiMemoriesClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link Band.UnauthorizedError}
+     * @throws {@link Band.ForbiddenError}
+     * @throws {@link Band.NotFoundError}
+     *
+     * @example
+     *     await client.agentApiMemories.archiveAgentMemory("daca00d0-eb6b-4db1-8201-c46015c93d04")
+     */
+    archiveAgentMemory(id, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__archiveAgentMemory(id, requestOptions));
+    }
+    __archiveAgentMemory(id, requestOptions) {
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a, _b, _c, _d, _e, _f, _g, _h, _j;
+            const _authRequest = yield this._options.authProvider.getAuthRequest();
+            const _headers = mergeHeaders(_authRequest.headers, (_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers);
+            const _response = yield core.fetcher({
+                url: core.url.join((_c = (_b = (yield core.Supplier.get(this._options.baseUrl))) !== null && _b !== void 0 ? _b : (yield core.Supplier.get(this._options.environment))) !== null && _c !== void 0 ? _c : environments.BandEnvironment.Default, `api/v1/agent/memories/${core.url.encodePathParam(id)}/archive`),
+                method: "POST",
+                headers: _headers,
+                queryString: core.url.queryBuilder().mergeAdditional(requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams).build(),
+                timeoutMs: ((_f = (_d = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.timeoutInSeconds) !== null && _d !== void 0 ? _d : (_e = this._options) === null || _e === void 0 ? void 0 : _e.timeoutInSeconds) !== null && _f !== void 0 ? _f : 60) * 1000,
+                maxRetries: (_g = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.maxRetries) !== null && _g !== void 0 ? _g : (_h = this._options) === null || _h === void 0 ? void 0 : _h.maxRetries,
+                abortSignal: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.abortSignal,
+                fetchFn: (_j = this._options) === null || _j === void 0 ? void 0 : _j.fetch,
+                logging: this._options.logging,
+            });
+            if (_response.ok) {
+                return { data: _response.body, rawResponse: _response.rawResponse };
+            }
+            if (_response.error.reason === "status-code") {
+                switch (_response.error.statusCode) {
+                    case 401:
+                        throw new Band.UnauthorizedError(_response.error.body, _response.rawResponse);
+                    case 403:
+                        throw new Band.ForbiddenError(_response.error.body, _response.rawResponse);
+                    case 404:
+                        throw new Band.NotFoundError(_response.error.body, _response.rawResponse);
+                    default:
+                        throw new errors.BandError({
+                            statusCode: _response.error.statusCode,
+                            body: _response.error.body,
+                            rawResponse: _response.rawResponse,
+                        });
+                }
+            }
+            return handleNonStatusCodeError(_response.error, _response.rawResponse, "POST", "/api/v1/agent/memories/{id}/archive");
+        });
+    }
+    /**
+     * Marks a memory as superseded (soft delete). Use when information is outdated or incorrect.
+     * The memory remains for audit trail but won't appear in normal queries.
+     *
+     * Only the source agent can supersede.
+     *
+     * @param {string} id - Memory ID
+     * @param {AgentApiMemoriesClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link Band.UnauthorizedError}
+     * @throws {@link Band.ForbiddenError}
+     * @throws {@link Band.NotFoundError}
+     *
+     * @example
+     *     await client.agentApiMemories.supersedeAgentMemory("daca00d0-eb6b-4db1-8201-c46015c93d04")
+     */
+    supersedeAgentMemory(id, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__supersedeAgentMemory(id, requestOptions));
+    }
+    __supersedeAgentMemory(id, requestOptions) {
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a, _b, _c, _d, _e, _f, _g, _h, _j;
+            const _authRequest = yield this._options.authProvider.getAuthRequest();
+            const _headers = mergeHeaders(_authRequest.headers, (_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers);
+            const _response = yield core.fetcher({
+                url: core.url.join((_c = (_b = (yield core.Supplier.get(this._options.baseUrl))) !== null && _b !== void 0 ? _b : (yield core.Supplier.get(this._options.environment))) !== null && _c !== void 0 ? _c : environments.BandEnvironment.Default, `api/v1/agent/memories/${core.url.encodePathParam(id)}/supersede`),
+                method: "POST",
+                headers: _headers,
+                queryString: core.url.queryBuilder().mergeAdditional(requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams).build(),
+                timeoutMs: ((_f = (_d = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.timeoutInSeconds) !== null && _d !== void 0 ? _d : (_e = this._options) === null || _e === void 0 ? void 0 : _e.timeoutInSeconds) !== null && _f !== void 0 ? _f : 60) * 1000,
+                maxRetries: (_g = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.maxRetries) !== null && _g !== void 0 ? _g : (_h = this._options) === null || _h === void 0 ? void 0 : _h.maxRetries,
+                abortSignal: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.abortSignal,
+                fetchFn: (_j = this._options) === null || _j === void 0 ? void 0 : _j.fetch,
+                logging: this._options.logging,
+            });
+            if (_response.ok) {
+                return { data: _response.body, rawResponse: _response.rawResponse };
+            }
+            if (_response.error.reason === "status-code") {
+                switch (_response.error.statusCode) {
+                    case 401:
+                        throw new Band.UnauthorizedError(_response.error.body, _response.rawResponse);
+                    case 403:
+                        throw new Band.ForbiddenError(_response.error.body, _response.rawResponse);
+                    case 404:
+                        throw new Band.NotFoundError(_response.error.body, _response.rawResponse);
+                    default:
+                        throw new errors.BandError({
+                            statusCode: _response.error.statusCode,
+                            body: _response.error.body,
+                            rawResponse: _response.rawResponse,
+                        });
+                }
+            }
+            return handleNonStatusCodeError(_response.error, _response.rawResponse, "POST", "/api/v1/agent/memories/{id}/supersede");
+        });
+    }
+}

package/dist/esm/api/resources/agentApiMemories/client/index.d.mts

@@ -0,0 +1 @@
+export * from "./requests/index.mjs";

package/dist/esm/api/resources/agentApiMemories/client/index.mjs

@@ -0,0 +1 @@
+export * from "./requests/index.mjs";