@band-ai/rest-client 0.0.113 → 0.0.117

package/dist/esm/api/types/ChatParticipant.mjs

@@ -0,0 +1,9 @@
+// This file was auto-generated by Fern from our API Definition.
+export var ChatParticipant;
+(function (ChatParticipant) {
+    /** Participant type */
+    ChatParticipant.Type = {
+        User: "User",
+        Agent: "Agent",
+    };
+})(ChatParticipant || (ChatParticipant = {}));

package/dist/esm/api/types/ChatRoom.d.mts

@@ -0,0 +1,15 @@
+/**
+ * A chat room
+ */
+export interface ChatRoom {
+    /** Chat Room ID */
+    id: string;
+    /** Created At */
+    inserted_at: string;
+    /** Associated Task ID */
+    task_id?: string | undefined;
+    /** Chat room title */
+    title?: string | undefined;
+    /** Updated At */
+    updated_at: string;
+}

package/dist/esm/api/types/ChatRoom.mjs

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

package/dist/esm/api/types/ChatRoomRequest.d.mts

@@ -0,0 +1,9 @@
+/**
+ * Request to create a chat room. Status defaults to 'active'. Type defaults to 'direct'. The owner is automatically set to the authenticated user or agent.
+ */
+export interface ChatRoomRequest {
+    /** Associated task ID (optional) */
+    task_id?: string | undefined;
+    /** Optional title for the chat room. If provided and non-blank after trimming, the room is marked title_locked: true and LLM auto-titling is skipped. Empty/whitespace-only/null falls through to the default and LLM auto-titles on the first message. Control characters (newline, carriage return, null) are rejected with 422. Max 120 chars. Note: agent callers can set this at creation but cannot rename later — the rename endpoint is /me-scoped and human-owner-only. */
+    title?: string | undefined;
+}

package/dist/esm/api/types/ChatRoomRequest.mjs

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

package/dist/esm/api/types/Error_.d.mts

@@ -0,0 +1,18 @@
+/**
+ * Standard error response with request ID for tracing
+ */
+export interface Error_ {
+    error: Error_.Error_;
+}
+export declare namespace Error_ {
+    interface Error_ {
+        /** Machine-readable error code */
+        code: string;
+        /** Additional error details (optional) */
+        details?: Record<string, unknown> | undefined;
+        /** Human-readable error message */
+        message: string;
+        /** Unique request identifier for tracing and debugging */
+        request_id: string;
+    }
+}

package/dist/esm/api/types/Error_.mjs

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

package/dist/esm/api/types/EventCreatedResponse.d.mts

@@ -0,0 +1,11 @@
+/**
+ * Response after creating an event.
+ */
+export interface EventCreatedResponse {
+    /** ID of the created event */
+    id: string;
+    /** Type of event recorded */
+    message_type: string;
+    /** Whether the event was created successfully */
+    success: boolean;
+}

package/dist/esm/api/types/EventCreatedResponse.mjs

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

package/dist/esm/api/types/MessageSentResponse.d.mts

@@ -0,0 +1,24 @@
+/**
+ * Minimal response after sending a message. Contains only essential fields to confirm delivery.
+ */
+export interface MessageSentResponse {
+    /** ID of the created message */
+    id: string;
+    /** List of participants who will receive the message */
+    recipients: MessageSentResponse.Recipients.Item[];
+    /** Whether the message was sent successfully */
+    success: boolean;
+}
+export declare namespace MessageSentResponse {
+    type Recipients = Recipients.Item[];
+    namespace Recipients {
+        interface Item {
+            /** Recipient handle */
+            handle: string;
+            /** Recipient ID */
+            id: string;
+            /** Recipient display name (optional) */
+            name?: string | undefined;
+        }
+    }
+}

package/dist/esm/api/types/MessageSentResponse.mjs

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

package/dist/esm/api/types/MessageStatusResponse.d.mts

@@ -0,0 +1,22 @@
+/**
+ * Minimal response after updating message processing status.
+ */
+export interface MessageStatusResponse {
+    /** Current attempt number */
+    attempt_number: number;
+    /** ID of the message */
+    id: string;
+    /** New processing status */
+    status: MessageStatusResponse.Status;
+    /** Whether the status was updated successfully */
+    success: boolean;
+}
+export declare namespace MessageStatusResponse {
+    /** New processing status */
+    const Status: {
+        readonly Processing: "processing";
+        readonly Processed: "processed";
+        readonly Failed: "failed";
+    };
+    type Status = (typeof Status)[keyof typeof Status];
+}

package/dist/esm/api/types/MessageStatusResponse.mjs

@@ -0,0 +1,10 @@
+// This file was auto-generated by Fern from our API Definition.
+export var MessageStatusResponse;
+(function (MessageStatusResponse) {
+    /** New processing status */
+    MessageStatusResponse.Status = {
+        Processing: "processing",
+        Processed: "processed",
+        Failed: "failed",
+    };
+})(MessageStatusResponse || (MessageStatusResponse = {}));

package/dist/esm/api/types/ParticipantRequest.d.mts

@@ -0,0 +1,18 @@
+/**
+ * Request to add a participant to a chat room
+ */
+export interface ParticipantRequest {
+    /** Participant ID (User UUID or Agent ID) */
+    participant_id: string;
+    /** Participant role */
+    role?: ParticipantRequest.Role | undefined;
+}
+export declare namespace ParticipantRequest {
+    /** Participant role */
+    const Role: {
+        readonly Owner: "owner";
+        readonly Admin: "admin";
+        readonly Member: "member";
+    };
+    type Role = (typeof Role)[keyof typeof Role];
+}

package/dist/esm/api/types/ParticipantRequest.mjs

@@ -0,0 +1,10 @@
+// This file was auto-generated by Fern from our API Definition.
+export var ParticipantRequest;
+(function (ParticipantRequest) {
+    /** Participant role */
+    ParticipantRequest.Role = {
+        Owner: "owner",
+        Admin: "admin",
+        Member: "member",
+    };
+})(ParticipantRequest || (ParticipantRequest = {}));

package/dist/esm/api/types/ParticipantRole.d.mts

@@ -0,0 +1,13 @@
+/** Role of a participant in a chat room. Determines permissions and capabilities. */
+export declare const ParticipantRole: {
+    /**
+     * Full control over the chat room. Can manage participants and settings. */
+    readonly Owner: "owner";
+    /**
+     * Can manage participants but not room settings. */
+    readonly Admin: "admin";
+    /**
+     * Can send messages and view chat history. */
+    readonly Member: "member";
+};
+export type ParticipantRole = (typeof ParticipantRole)[keyof typeof ParticipantRole];

package/dist/esm/api/types/ParticipantRole.mjs

@@ -0,0 +1,13 @@
+// This file was auto-generated by Fern from our API Definition.
+/** Role of a participant in a chat room. Determines permissions and capabilities. */
+export const ParticipantRole = {
+    /**
+     * Full control over the chat room. Can manage participants and settings. */
+    Owner: "owner",
+    /**
+     * Can manage participants but not room settings. */
+    Admin: "admin",
+    /**
+     * Can send messages and view chat history. */
+    Member: "member",
+};

package/dist/esm/api/types/Peer.d.mts

@@ -0,0 +1,39 @@
+/**
+ * An entity available for interaction in chat rooms (user or agent)
+ */
+export interface Peer {
+    /** Description (for agents) */
+    description?: string | undefined;
+    /** Handle without @ prefix (user handle or owner/slug for agents) */
+    handle: string;
+    /** Entity ID (User UUID or Agent ID) */
+    id: string;
+    /** Whether this peer is also in the agent's contacts */
+    is_contact: boolean;
+    /** Whether this is an external agent */
+    is_external?: boolean | undefined;
+    /** Whether listed in directory */
+    listed_in_directory?: boolean | undefined;
+    /** Display name */
+    name: string;
+    /** How the peer was discovered (registry = owner/sibling/global, contact = from contacts) */
+    source: Peer.Source;
+    /** Tags (agents only) */
+    tags?: string[] | undefined;
+    /** Entity type */
+    type: Peer.Type;
+}
+export declare namespace Peer {
+    /** How the peer was discovered (registry = owner/sibling/global, contact = from contacts) */
+    const Source: {
+        readonly Registry: "registry";
+        readonly Contact: "contact";
+    };
+    type Source = (typeof Source)[keyof typeof Source];
+    /** Entity type */
+    const Type: {
+        readonly User: "User";
+        readonly Agent: "Agent";
+    };
+    type Type = (typeof Type)[keyof typeof Type];
+}

package/dist/esm/api/types/Peer.mjs

@@ -0,0 +1,14 @@
+// This file was auto-generated by Fern from our API Definition.
+export var Peer;
+(function (Peer) {
+    /** How the peer was discovered (registry = owner/sibling/global, contact = from contacts) */
+    Peer.Source = {
+        Registry: "registry",
+        Contact: "contact",
+    };
+    /** Entity type */
+    Peer.Type = {
+        User: "User",
+        Agent: "Agent",
+    };
+})(Peer || (Peer = {}));

package/dist/esm/api/types/ReceivedContactRequest.d.mts

@@ -0,0 +1,22 @@
+/**
+ * A received contact request
+ */
+export interface ReceivedContactRequest {
+    /** Requester's handle (no @ prefix) */
+    from_handle?: string | undefined;
+    from_name?: string | undefined;
+    /** Request ID */
+    id: string;
+    inserted_at: string;
+    message?: string | undefined;
+    status: ReceivedContactRequest.Status;
+}
+export declare namespace ReceivedContactRequest {
+    const Status: {
+        readonly Pending: "pending";
+        readonly Approved: "approved";
+        readonly Rejected: "rejected";
+        readonly Cancelled: "cancelled";
+    };
+    type Status = (typeof Status)[keyof typeof Status];
+}

package/dist/esm/api/types/ReceivedContactRequest.mjs

@@ -0,0 +1,10 @@
+// This file was auto-generated by Fern from our API Definition.
+export var ReceivedContactRequest;
+(function (ReceivedContactRequest) {
+    ReceivedContactRequest.Status = {
+        Pending: "pending",
+        Approved: "approved",
+        Rejected: "rejected",
+        Cancelled: "cancelled",
+    };
+})(ReceivedContactRequest || (ReceivedContactRequest = {}));

package/dist/esm/api/types/SentContactRequest.d.mts

@@ -0,0 +1,22 @@
+/**
+ * A sent contact request
+ */
+export interface SentContactRequest {
+    /** Request ID */
+    id: string;
+    inserted_at: string;
+    message?: string | undefined;
+    status: SentContactRequest.Status;
+    /** Recipient's handle (no @ prefix) */
+    to_handle?: string | undefined;
+    to_name?: string | undefined;
+}
+export declare namespace SentContactRequest {
+    const Status: {
+        readonly Pending: "pending";
+        readonly Approved: "approved";
+        readonly Rejected: "rejected";
+        readonly Cancelled: "cancelled";
+    };
+    type Status = (typeof Status)[keyof typeof Status];
+}

package/dist/esm/api/types/SentContactRequest.mjs

@@ -0,0 +1,10 @@
+// This file was auto-generated by Fern from our API Definition.
+export var SentContactRequest;
+(function (SentContactRequest) {
+    SentContactRequest.Status = {
+        Pending: "pending",
+        Approved: "approved",
+        Rejected: "rejected",
+        Cancelled: "cancelled",
+    };
+})(SentContactRequest || (SentContactRequest = {}));

package/dist/esm/api/types/ValidationError.d.mts

@@ -0,0 +1,18 @@
+/**
+ * Validation error response with field-specific errors and request ID for tracing
+ */
+export interface ValidationError {
+    error: ValidationError.Error_;
+}
+export declare namespace ValidationError {
+    interface Error_ {
+        /** Machine-readable error code */
+        code: string;
+        /** Field-specific validation errors with JSON Pointer paths (RFC 6901) as keys */
+        details: Record<string, string[]>;
+        /** Human-readable error message */
+        message: string;
+        /** Unique request identifier for tracing and debugging */
+        request_id: string;
+    }
+}

package/dist/esm/api/types/ValidationError.mjs

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

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

@@ -0,0 +1,21 @@
+export * from "./AgentContact.mjs";
+export * from "./AgentMe.mjs";
+export * from "./AgentMemory.mjs";
+export * from "./AgentMemoryCreateRequest.mjs";
+export * from "./ChatEventMessageType.mjs";
+export * from "./ChatEventRequest.mjs";
+export * from "./ChatMessage.mjs";
+export * from "./ChatMessageRequest.mjs";
+export * from "./ChatParticipant.mjs";
+export * from "./ChatRoom.mjs";
+export * from "./ChatRoomRequest.mjs";
+export * from "./Error_.mjs";
+export * from "./EventCreatedResponse.mjs";
+export * from "./MessageSentResponse.mjs";
+export * from "./MessageStatusResponse.mjs";
+export * from "./ParticipantRequest.mjs";
+export * from "./ParticipantRole.mjs";
+export * from "./Peer.mjs";
+export * from "./ReceivedContactRequest.mjs";
+export * from "./SentContactRequest.mjs";
+export * from "./ValidationError.mjs";

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

@@ -0,0 +1,21 @@
+export * from "./AgentContact.mjs";
+export * from "./AgentMe.mjs";
+export * from "./AgentMemory.mjs";
+export * from "./AgentMemoryCreateRequest.mjs";
+export * from "./ChatEventMessageType.mjs";
+export * from "./ChatEventRequest.mjs";
+export * from "./ChatMessage.mjs";
+export * from "./ChatMessageRequest.mjs";
+export * from "./ChatParticipant.mjs";
+export * from "./ChatRoom.mjs";
+export * from "./ChatRoomRequest.mjs";
+export * from "./Error_.mjs";
+export * from "./EventCreatedResponse.mjs";
+export * from "./MessageSentResponse.mjs";
+export * from "./MessageStatusResponse.mjs";
+export * from "./ParticipantRequest.mjs";
+export * from "./ParticipantRole.mjs";
+export * from "./Peer.mjs";
+export * from "./ReceivedContactRequest.mjs";
+export * from "./SentContactRequest.mjs";
+export * from "./ValidationError.mjs";

package/dist/esm/auth/HeaderAuthProvider.d.mts

@@ -0,0 +1,20 @@
+import * as core from "../core/index.mjs";
+declare const PARAM_KEY: "apiKey";
+export declare class HeaderAuthProvider implements core.AuthProvider {
+    private readonly options;
+    constructor(options: HeaderAuthProvider.Options);
+    static canCreate(options: Partial<HeaderAuthProvider.Options>): boolean;
+    getAuthRequest({ endpointMetadata, }?: {
+        endpointMetadata?: core.EndpointMetadata;
+    }): Promise<core.AuthRequest>;
+}
+export declare namespace HeaderAuthProvider {
+    const AUTH_SCHEME: "ApiKeyAuth";
+    const AUTH_CONFIG_ERROR_MESSAGE: string;
+    type Options = AuthOptions;
+    type AuthOptions = {
+        [PARAM_KEY]: core.Supplier<string>;
+    };
+    function createInstance(options: Options): core.AuthProvider;
+}
+export {};

package/dist/esm/auth/HeaderAuthProvider.mjs

@@ -0,0 +1,43 @@
+// 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 * as core from "../core/index.mjs";
+import * as errors from "../errors/index.mjs";
+const PARAM_KEY = "apiKey";
+const HEADER_NAME = "X-API-Key";
+export class HeaderAuthProvider {
+    constructor(options) {
+        this.options = options;
+    }
+    static canCreate(options) {
+        return (options === null || options === void 0 ? void 0 : options[PARAM_KEY]) != null;
+    }
+    getAuthRequest() {
+        return __awaiter(this, arguments, void 0, function* ({ endpointMetadata, } = {}) {
+            const headerValue = yield core.Supplier.get(this.options[PARAM_KEY]);
+            if (headerValue == null) {
+                throw new errors.BandError({
+                    message: HeaderAuthProvider.AUTH_CONFIG_ERROR_MESSAGE,
+                });
+            }
+            return {
+                headers: { [HEADER_NAME]: headerValue },
+            };
+        });
+    }
+}
+(function (HeaderAuthProvider) {
+    HeaderAuthProvider.AUTH_SCHEME = "ApiKeyAuth";
+    HeaderAuthProvider.AUTH_CONFIG_ERROR_MESSAGE = `Please provide '${PARAM_KEY}' when initializing the client`;
+    function createInstance(options) {
+        return new HeaderAuthProvider(options);
+    }
+    HeaderAuthProvider.createInstance = createInstance;
+})(HeaderAuthProvider || (HeaderAuthProvider = {}));

package/dist/esm/auth/index.d.mts

@@ -0,0 +1 @@
+export { HeaderAuthProvider } from "./HeaderAuthProvider.mjs";

package/dist/esm/auth/index.mjs

@@ -0,0 +1 @@
+export { HeaderAuthProvider } from "./HeaderAuthProvider.mjs";

package/dist/esm/core/auth/AuthProvider.d.mts

@@ -0,0 +1,8 @@
+import type { EndpointMetadata } from "../fetcher/EndpointMetadata.mjs";
+import type { AuthRequest } from "./AuthRequest.mjs";
+export interface AuthProvider {
+    getAuthRequest(arg?: {
+        endpointMetadata?: EndpointMetadata;
+    }): Promise<AuthRequest>;
+}
+export declare function isAuthProvider(value: unknown): value is AuthProvider;

package/dist/esm/core/auth/AuthProvider.mjs

@@ -0,0 +1,6 @@
+export function isAuthProvider(value) {
+    return (typeof value === "object" &&
+        value !== null &&
+        "getAuthRequest" in value &&
+        typeof value.getAuthRequest === "function");
+}

package/dist/esm/core/auth/AuthRequest.d.mts

@@ -0,0 +1,9 @@
+/**
+ * Request parameters for authentication requests.
+ */
+export interface AuthRequest {
+    /**
+     * The headers to be included in the request.
+     */
+    headers: Record<string, string>;
+}

package/dist/esm/core/auth/AuthRequest.mjs

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

package/dist/esm/core/auth/BasicAuth.d.mts

@@ -0,0 +1,8 @@
+export interface BasicAuth {
+    username?: string;
+    password?: string;
+}
+export declare const BasicAuth: {
+    toAuthorizationHeader: (basicAuth: BasicAuth | undefined) => string | undefined;
+    fromAuthorizationHeader: (header: string) => BasicAuth;
+};

package/dist/esm/core/auth/BasicAuth.mjs

@@ -0,0 +1,30 @@
+import { base64Decode, base64Encode } from "../base64.mjs";
+const BASIC_AUTH_HEADER_PREFIX = /^Basic /i;
+export const BasicAuth = {
+    toAuthorizationHeader: (basicAuth) => {
+        var _a, _b;
+        if (basicAuth == null) {
+            return undefined;
+        }
+        const username = (_a = basicAuth.username) !== null && _a !== void 0 ? _a : "";
+        const password = (_b = basicAuth.password) !== null && _b !== void 0 ? _b : "";
+        if (username === "" && password === "") {
+            return undefined;
+        }
+        const token = base64Encode(`${username}:${password}`);
+        return `Basic ${token}`;
+    },
+    fromAuthorizationHeader: (header) => {
+        const credentials = header.replace(BASIC_AUTH_HEADER_PREFIX, "");
+        const decoded = base64Decode(credentials);
+        const [username, ...passwordParts] = decoded.split(":");
+        const password = passwordParts.length > 0 ? passwordParts.join(":") : undefined;
+        if (username == null || password == null) {
+            throw new Error("Invalid basic auth");
+        }
+        return {
+            username,
+            password,
+        };
+    },
+};

package/dist/esm/core/auth/BearerToken.d.mts

@@ -0,0 +1,7 @@
+export type BearerToken = string;
+declare function toAuthorizationHeader(token: string | undefined): string | undefined;
+export declare const BearerToken: {
+    toAuthorizationHeader: typeof toAuthorizationHeader;
+    fromAuthorizationHeader: (header: string) => BearerToken;
+};
+export {};

package/dist/esm/core/auth/BearerToken.mjs

@@ -0,0 +1,13 @@
+const BEARER_AUTH_HEADER_PREFIX = /^Bearer /i;
+function toAuthorizationHeader(token) {
+    if (token == null) {
+        return undefined;
+    }
+    return `Bearer ${token}`;
+}
+export const BearerToken = {
+    toAuthorizationHeader: toAuthorizationHeader,
+    fromAuthorizationHeader: (header) => {
+        return header.replace(BEARER_AUTH_HEADER_PREFIX, "").trim();
+    },
+};

package/dist/esm/core/auth/NoOpAuthProvider.d.mts

@@ -0,0 +1,5 @@
+import type { AuthProvider } from "./AuthProvider.mjs";
+import type { AuthRequest } from "./AuthRequest.mjs";
+export declare class NoOpAuthProvider implements AuthProvider {
+    getAuthRequest(): Promise<AuthRequest>;
+}

package/dist/esm/core/auth/NoOpAuthProvider.mjs

@@ -0,0 +1,5 @@
+export class NoOpAuthProvider {
+    getAuthRequest() {
+        return Promise.resolve({ headers: {} });
+    }
+}

package/dist/esm/core/auth/index.d.mts

@@ -0,0 +1,5 @@
+export { type AuthProvider, isAuthProvider } from "./AuthProvider.mjs";
+export type { AuthRequest } from "./AuthRequest.mjs";
+export { BasicAuth } from "./BasicAuth.mjs";
+export { BearerToken } from "./BearerToken.mjs";
+export { NoOpAuthProvider } from "./NoOpAuthProvider.mjs";

package/dist/esm/core/auth/index.mjs

@@ -0,0 +1,4 @@
+export { isAuthProvider } from "./AuthProvider.mjs";
+export { BasicAuth } from "./BasicAuth.mjs";
+export { BearerToken } from "./BearerToken.mjs";
+export { NoOpAuthProvider } from "./NoOpAuthProvider.mjs";

package/dist/esm/core/base64.d.mts

@@ -0,0 +1,2 @@
+export declare function base64Encode(input: string): string;
+export declare function base64Decode(input: string): string;

package/dist/esm/core/base64.mjs

@@ -0,0 +1,22 @@
+function base64ToBytes(base64) {
+    const binString = atob(base64);
+    return Uint8Array.from(binString, (m) => m.codePointAt(0));
+}
+function bytesToBase64(bytes) {
+    const binString = String.fromCodePoint(...bytes);
+    return btoa(binString);
+}
+export function base64Encode(input) {
+    if (typeof Buffer !== "undefined") {
+        return Buffer.from(input, "utf8").toString("base64");
+    }
+    const bytes = new TextEncoder().encode(input);
+    return bytesToBase64(bytes);
+}
+export function base64Decode(input) {
+    if (typeof Buffer !== "undefined") {
+        return Buffer.from(input, "base64").toString("utf8");
+    }
+    const bytes = base64ToBytes(input);
+    return new TextDecoder().decode(bytes);
+}

package/dist/esm/core/exports.d.mts

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

package/dist/esm/core/exports.mjs

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