@band-ai/sdk 0.1.2

package/dist/mcp.d.cts

@@ -0,0 +1,97 @@
+export { C as CreateThenvoiMcpBackendOptions, T as ThenvoiMcpBackend, a as ThenvoiMcpBackendKind, c as createThenvoiMcpBackend, g as getThenvoiSdkMcpServerConfig } from './backends-BnOLsG7w.cjs';
+import { M as McpToolRegistration } from './claude-CwTAxhwI.cjs';
+export { B as BuildRegistrationsOptions, a as McpToolInputSchema, b as McpToolResult, c as buildRoomScopedRegistrations, d as buildSingleContextRegistrations, e as errorResult, s as successResult } from './claude-CwTAxhwI.cjs';
+import { A as AdapterToolsProtocol } from './protocols-CInhtFpA.cjs';
+import { Readable, Writable } from 'node:stream';
+import '@anthropic-ai/claude-agent-sdk';
+import './dtos-DUpbIu8k.cjs';
+
+interface ThenvoiMcpServerOptions {
+    /** Single tools instance (no room scoping) or a resolver function for room-scoped tools. */
+    tools: AdapterToolsProtocol | ((roomId: string) => AdapterToolsProtocol | undefined);
+    /** Server name advertised to MCP clients. */
+    name?: string;
+    /** Port to listen on. Defaults to auto-selecting from 50000-60000. */
+    port?: number;
+    /** Enable memory tools. */
+    enableMemoryTools?: boolean;
+    /** Enable contact tools. */
+    enableContactTools?: boolean;
+    /** Additional MCP tool registrations to expose alongside the built-in tools. */
+    additionalTools?: McpToolRegistration[];
+}
+/**
+ * Standalone MCP server that exposes Thenvoi agent tools over Streamable HTTP.
+ *
+ * Uses `@modelcontextprotocol/server` (optional peer dependency) and `express`.
+ * Install with: `npm install @modelcontextprotocol/server express`
+ */
+declare class ThenvoiMcpServer {
+    private readonly options;
+    private readonly registrations;
+    private httpServer;
+    private actualPort;
+    private readonly sessions;
+    private sessionSweepTimer;
+    constructor(options: ThenvoiMcpServerOptions);
+    /** Port the server is listening on. Null if not started. */
+    get port(): number | null;
+    /** MCP endpoint URL. Null if not started. */
+    get url(): string | null;
+    /** Tool names registered on this server. */
+    get toolNames(): string[];
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    private createSession;
+    private startSessionSweep;
+    private stopSessionSweep;
+    private closeIdleSessions;
+}
+
+interface ThenvoiMcpSseServerOptions {
+    tools: AdapterToolsProtocol | ((roomId: string) => AdapterToolsProtocol | undefined);
+    name?: string;
+    port?: number;
+    enableMemoryTools?: boolean;
+    enableContactTools?: boolean;
+    additionalTools?: McpToolRegistration[];
+}
+declare class ThenvoiMcpSseServer {
+    private readonly options;
+    private readonly registrations;
+    private httpServer;
+    private actualPort;
+    private readonly sessions;
+    private sweepTimer;
+    constructor(options: ThenvoiMcpSseServerOptions);
+    get port(): number | null;
+    get sseUrl(): string | null;
+    get toolNames(): string[];
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    private startSessionSweep;
+    private stopSessionSweep;
+    private closeIdleSessions;
+}
+
+interface ThenvoiMcpStdioServerOptions {
+    tools: AdapterToolsProtocol | ((roomId: string) => AdapterToolsProtocol | undefined);
+    name?: string;
+    enableMemoryTools?: boolean;
+    enableContactTools?: boolean;
+    additionalTools?: McpToolRegistration[];
+    stdin?: Readable;
+    stdout?: Writable;
+}
+declare class ThenvoiMcpStdioServer {
+    private readonly options;
+    private readonly registrations;
+    private mcpServer;
+    private transport;
+    constructor(options: ThenvoiMcpStdioServerOptions);
+    get toolNames(): string[];
+    start(): Promise<void>;
+    stop(): Promise<void>;
+}
+
+export { McpToolRegistration, ThenvoiMcpServer, type ThenvoiMcpServerOptions, ThenvoiMcpSseServer, type ThenvoiMcpSseServerOptions, ThenvoiMcpStdioServer, type ThenvoiMcpStdioServerOptions };

package/dist/mcp.d.ts

@@ -0,0 +1,97 @@
+export { C as CreateThenvoiMcpBackendOptions, T as ThenvoiMcpBackend, a as ThenvoiMcpBackendKind, c as createThenvoiMcpBackend, g as getThenvoiSdkMcpServerConfig } from './backends-C4n6cKOf.js';
+import { M as McpToolRegistration } from './claude-CcnQ5OUC.js';
+export { B as BuildRegistrationsOptions, a as McpToolInputSchema, b as McpToolResult, c as buildRoomScopedRegistrations, d as buildSingleContextRegistrations, e as errorResult, s as successResult } from './claude-CcnQ5OUC.js';
+import { A as AdapterToolsProtocol } from './protocols-DrhzOH6K.js';
+import { Readable, Writable } from 'node:stream';
+import '@anthropic-ai/claude-agent-sdk';
+import './dtos-DUpbIu8k.js';
+
+interface ThenvoiMcpServerOptions {
+    /** Single tools instance (no room scoping) or a resolver function for room-scoped tools. */
+    tools: AdapterToolsProtocol | ((roomId: string) => AdapterToolsProtocol | undefined);
+    /** Server name advertised to MCP clients. */
+    name?: string;
+    /** Port to listen on. Defaults to auto-selecting from 50000-60000. */
+    port?: number;
+    /** Enable memory tools. */
+    enableMemoryTools?: boolean;
+    /** Enable contact tools. */
+    enableContactTools?: boolean;
+    /** Additional MCP tool registrations to expose alongside the built-in tools. */
+    additionalTools?: McpToolRegistration[];
+}
+/**
+ * Standalone MCP server that exposes Thenvoi agent tools over Streamable HTTP.
+ *
+ * Uses `@modelcontextprotocol/server` (optional peer dependency) and `express`.
+ * Install with: `npm install @modelcontextprotocol/server express`
+ */
+declare class ThenvoiMcpServer {
+    private readonly options;
+    private readonly registrations;
+    private httpServer;
+    private actualPort;
+    private readonly sessions;
+    private sessionSweepTimer;
+    constructor(options: ThenvoiMcpServerOptions);
+    /** Port the server is listening on. Null if not started. */
+    get port(): number | null;
+    /** MCP endpoint URL. Null if not started. */
+    get url(): string | null;
+    /** Tool names registered on this server. */
+    get toolNames(): string[];
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    private createSession;
+    private startSessionSweep;
+    private stopSessionSweep;
+    private closeIdleSessions;
+}
+
+interface ThenvoiMcpSseServerOptions {
+    tools: AdapterToolsProtocol | ((roomId: string) => AdapterToolsProtocol | undefined);
+    name?: string;
+    port?: number;
+    enableMemoryTools?: boolean;
+    enableContactTools?: boolean;
+    additionalTools?: McpToolRegistration[];
+}
+declare class ThenvoiMcpSseServer {
+    private readonly options;
+    private readonly registrations;
+    private httpServer;
+    private actualPort;
+    private readonly sessions;
+    private sweepTimer;
+    constructor(options: ThenvoiMcpSseServerOptions);
+    get port(): number | null;
+    get sseUrl(): string | null;
+    get toolNames(): string[];
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    private startSessionSweep;
+    private stopSessionSweep;
+    private closeIdleSessions;
+}
+
+interface ThenvoiMcpStdioServerOptions {
+    tools: AdapterToolsProtocol | ((roomId: string) => AdapterToolsProtocol | undefined);
+    name?: string;
+    enableMemoryTools?: boolean;
+    enableContactTools?: boolean;
+    additionalTools?: McpToolRegistration[];
+    stdin?: Readable;
+    stdout?: Writable;
+}
+declare class ThenvoiMcpStdioServer {
+    private readonly options;
+    private readonly registrations;
+    private mcpServer;
+    private transport;
+    constructor(options: ThenvoiMcpStdioServerOptions);
+    get toolNames(): string[];
+    start(): Promise<void>;
+    stop(): Promise<void>;
+}
+
+export { McpToolRegistration, ThenvoiMcpServer, type ThenvoiMcpServerOptions, ThenvoiMcpSseServer, type ThenvoiMcpSseServerOptions, ThenvoiMcpStdioServer, type ThenvoiMcpStdioServerOptions };

package/dist/mcp.js

@@ -0,0 +1,27 @@
+import {
+  ThenvoiMcpServer,
+  ThenvoiMcpSseServer,
+  ThenvoiMcpStdioServer,
+  createThenvoiMcpBackend,
+  getThenvoiSdkMcpServerConfig
+} from "./chunk-NIAQBANR.js";
+import {
+  buildRoomScopedRegistrations,
+  buildSingleContextRegistrations,
+  errorResult,
+  successResult
+} from "./chunk-EDPKUUJL.js";
+import "./chunk-GVEQ3RAH.js";
+import "./chunk-3BKAC4OZ.js";
+import "./chunk-YR3BOQNW.js";
+export {
+  ThenvoiMcpServer,
+  ThenvoiMcpSseServer,
+  ThenvoiMcpStdioServer,
+  buildRoomScopedRegistrations,
+  buildSingleContextRegistrations,
+  createThenvoiMcpBackend,
+  errorResult,
+  getThenvoiSdkMcpServerConfig,
+  successResult
+};

package/dist/opencode-BBcDchcN.d.cts

@@ -0,0 +1,159 @@
+import { H as HistoryConverter } from './protocols-CInhtFpA.cjs';
+import { R as RestApi } from './types-CSHFipIc.cjs';
+
+interface GoogleADKMessage {
+    role: "user" | "model";
+    content: string | Array<Record<string, unknown>>;
+}
+type GoogleADKMessages = GoogleADKMessage[];
+declare class GoogleADKHistoryConverter {
+    private agentName;
+    constructor(agentName?: string);
+    setAgentName(name: string): void;
+    convert(raw: Array<Record<string, unknown>>): GoogleADKMessages;
+}
+declare function extractGoogleAdkSessionId(raw: Array<Record<string, unknown>>): string | null;
+
+interface A2AAuth {
+    apiKey?: string;
+    bearerToken?: string;
+    headers?: Record<string, string>;
+}
+interface A2ASessionState {
+    contextId: string | null;
+    taskId: string | null;
+    taskState: string | null;
+}
+declare function buildA2AAuthHeaders(auth?: A2AAuth): Record<string, string>;
+declare class A2AHistoryConverter implements HistoryConverter<A2ASessionState> {
+    convert(raw: Array<Record<string, unknown>>): A2ASessionState;
+}
+
+type GatewayTaskState = "submitted" | "working" | "input-required" | "completed" | "canceled" | "failed" | "rejected" | "auth-required" | "unknown";
+interface GatewayMessagePart {
+    kind?: string;
+    text?: string;
+    root?: {
+        text?: string;
+    };
+}
+interface GatewayA2AMessage {
+    kind: "message";
+    messageId: string;
+    role: "user" | "agent";
+    parts: GatewayMessagePart[];
+    contextId?: string;
+    taskId?: string;
+}
+interface GatewayA2ATaskStatus {
+    state: GatewayTaskState;
+    timestamp?: string;
+    message?: GatewayA2AMessage;
+}
+interface GatewayA2AStatusUpdateEvent {
+    kind: "status-update";
+    taskId: string;
+    contextId: string;
+    final: boolean;
+    status: GatewayA2ATaskStatus;
+    metadata?: Record<string, unknown>;
+}
+interface GatewayRequest {
+    /**
+     * Canonical Thenvoi peer id.
+     * Legacy clients may still send a slug in this field; adapter-side normalization handles that alias.
+     */
+    peerId: string;
+    /**
+     * Optional gateway route slug for compatibility/diagnostics.
+     */
+    peerSlug?: string;
+    taskId: string;
+    contextId: string;
+    message: GatewayA2AMessage;
+}
+interface GatewayCancelRequest {
+    /**
+     * Canonical Thenvoi peer id.
+     * Legacy clients may still send a slug in this field; adapter-side normalization handles that alias.
+     */
+    peerId: string;
+    /**
+     * Optional gateway route slug for compatibility/diagnostics.
+     */
+    peerSlug?: string;
+    taskId: string;
+}
+interface GatewayPeer {
+    id: string;
+    name: string;
+    description: string;
+    handle?: string | null;
+    slug: string;
+}
+interface GatewaySessionState {
+    contextToRoom: Record<string, string>;
+    roomParticipants: Record<string, string[]>;
+}
+interface PendingA2ATask {
+    taskId: string;
+    contextId: string;
+    peerId: string;
+    peerSlug?: string;
+    roomId: string;
+    enqueue(event: GatewayA2AStatusUpdateEvent): void;
+}
+interface GatewayServerLike {
+    start(): Promise<void>;
+    stop(): Promise<void>;
+}
+interface GatewayServerOptions {
+    peersBySlug: Map<string, GatewayPeer>;
+    peersById: Map<string, GatewayPeer>;
+    gatewayUrl: string;
+    host: string;
+    port: number;
+    authToken?: string;
+    allowUnauthenticatedLoopback?: boolean;
+    onRequest: (request: GatewayRequest) => AsyncIterable<GatewayA2AStatusUpdateEvent>;
+    onCancel?: (request: GatewayCancelRequest) => Promise<void>;
+    loadModules?: () => Promise<unknown>;
+}
+type GatewayServerFactory = (options: GatewayServerOptions) => GatewayServerLike;
+interface A2AGatewayAdapterOptions {
+    thenvoiRest: RestApi;
+    gatewayUrl?: string;
+    host?: string;
+    port?: number;
+    authToken?: string;
+    allowUnauthenticatedLoopback?: boolean;
+    responseTimeoutMs?: number;
+    peerPageSize?: number;
+    maxPeerPages?: number;
+    serverFactory?: GatewayServerFactory;
+}
+
+interface ParlantMessage {
+    role: "user" | "assistant";
+    content: string;
+    sender: string;
+    senderType: string;
+}
+type ParlantMessages = ParlantMessage[];
+declare class ParlantHistoryConverter implements HistoryConverter<ParlantMessages> {
+    convert(raw: Array<Record<string, unknown>>): ParlantMessages;
+}
+
+interface OpencodeSessionState {
+    sessionId: string | null;
+    roomId: string | null;
+    createdAt: Date | null;
+    replayMessages: string[];
+}
+declare class OpencodeHistoryConverter {
+    setAgentName(_name: string): void;
+    convert(raw: Array<Record<string, unknown>>): OpencodeSessionState;
+}
+declare function extractOpencodeSessionId(raw: Array<Record<string, unknown>>): string | null;
+
+export { type A2AAuth as A, type GatewaySessionState as G, OpencodeHistoryConverter as O, ParlantHistoryConverter as P, type A2AGatewayAdapterOptions as a, type GatewayServerLike as b, type GatewayServerOptions as c, A2AHistoryConverter as d, type A2ASessionState as e, type GatewayA2AMessage as f, type GatewayA2AStatusUpdateEvent as g, type GatewayCancelRequest as h, type GatewayPeer as i, type GatewayRequest as j, type GatewayServerFactory as k, type GatewayTaskState as l, type ParlantMessage as m, type ParlantMessages as n, type PendingA2ATask as o, buildA2AAuthHeaders as p, GoogleADKHistoryConverter as q, type GoogleADKMessage as r, type GoogleADKMessages as s, type OpencodeSessionState as t, extractGoogleAdkSessionId as u, extractOpencodeSessionId as v };

package/dist/opencode-DthQQUsZ.d.ts

@@ -0,0 +1,159 @@
+import { H as HistoryConverter } from './protocols-DrhzOH6K.js';
+import { R as RestApi } from './types-CxII3XkA.js';
+
+interface GoogleADKMessage {
+    role: "user" | "model";
+    content: string | Array<Record<string, unknown>>;
+}
+type GoogleADKMessages = GoogleADKMessage[];
+declare class GoogleADKHistoryConverter {
+    private agentName;
+    constructor(agentName?: string);
+    setAgentName(name: string): void;
+    convert(raw: Array<Record<string, unknown>>): GoogleADKMessages;
+}
+declare function extractGoogleAdkSessionId(raw: Array<Record<string, unknown>>): string | null;
+
+interface A2AAuth {
+    apiKey?: string;
+    bearerToken?: string;
+    headers?: Record<string, string>;
+}
+interface A2ASessionState {
+    contextId: string | null;
+    taskId: string | null;
+    taskState: string | null;
+}
+declare function buildA2AAuthHeaders(auth?: A2AAuth): Record<string, string>;
+declare class A2AHistoryConverter implements HistoryConverter<A2ASessionState> {
+    convert(raw: Array<Record<string, unknown>>): A2ASessionState;
+}
+
+type GatewayTaskState = "submitted" | "working" | "input-required" | "completed" | "canceled" | "failed" | "rejected" | "auth-required" | "unknown";
+interface GatewayMessagePart {
+    kind?: string;
+    text?: string;
+    root?: {
+        text?: string;
+    };
+}
+interface GatewayA2AMessage {
+    kind: "message";
+    messageId: string;
+    role: "user" | "agent";
+    parts: GatewayMessagePart[];
+    contextId?: string;
+    taskId?: string;
+}
+interface GatewayA2ATaskStatus {
+    state: GatewayTaskState;
+    timestamp?: string;
+    message?: GatewayA2AMessage;
+}
+interface GatewayA2AStatusUpdateEvent {
+    kind: "status-update";
+    taskId: string;
+    contextId: string;
+    final: boolean;
+    status: GatewayA2ATaskStatus;
+    metadata?: Record<string, unknown>;
+}
+interface GatewayRequest {
+    /**
+     * Canonical Thenvoi peer id.
+     * Legacy clients may still send a slug in this field; adapter-side normalization handles that alias.
+     */
+    peerId: string;
+    /**
+     * Optional gateway route slug for compatibility/diagnostics.
+     */
+    peerSlug?: string;
+    taskId: string;
+    contextId: string;
+    message: GatewayA2AMessage;
+}
+interface GatewayCancelRequest {
+    /**
+     * Canonical Thenvoi peer id.
+     * Legacy clients may still send a slug in this field; adapter-side normalization handles that alias.
+     */
+    peerId: string;
+    /**
+     * Optional gateway route slug for compatibility/diagnostics.
+     */
+    peerSlug?: string;
+    taskId: string;
+}
+interface GatewayPeer {
+    id: string;
+    name: string;
+    description: string;
+    handle?: string | null;
+    slug: string;
+}
+interface GatewaySessionState {
+    contextToRoom: Record<string, string>;
+    roomParticipants: Record<string, string[]>;
+}
+interface PendingA2ATask {
+    taskId: string;
+    contextId: string;
+    peerId: string;
+    peerSlug?: string;
+    roomId: string;
+    enqueue(event: GatewayA2AStatusUpdateEvent): void;
+}
+interface GatewayServerLike {
+    start(): Promise<void>;
+    stop(): Promise<void>;
+}
+interface GatewayServerOptions {
+    peersBySlug: Map<string, GatewayPeer>;
+    peersById: Map<string, GatewayPeer>;
+    gatewayUrl: string;
+    host: string;
+    port: number;
+    authToken?: string;
+    allowUnauthenticatedLoopback?: boolean;
+    onRequest: (request: GatewayRequest) => AsyncIterable<GatewayA2AStatusUpdateEvent>;
+    onCancel?: (request: GatewayCancelRequest) => Promise<void>;
+    loadModules?: () => Promise<unknown>;
+}
+type GatewayServerFactory = (options: GatewayServerOptions) => GatewayServerLike;
+interface A2AGatewayAdapterOptions {
+    thenvoiRest: RestApi;
+    gatewayUrl?: string;
+    host?: string;
+    port?: number;
+    authToken?: string;
+    allowUnauthenticatedLoopback?: boolean;
+    responseTimeoutMs?: number;
+    peerPageSize?: number;
+    maxPeerPages?: number;
+    serverFactory?: GatewayServerFactory;
+}
+
+interface ParlantMessage {
+    role: "user" | "assistant";
+    content: string;
+    sender: string;
+    senderType: string;
+}
+type ParlantMessages = ParlantMessage[];
+declare class ParlantHistoryConverter implements HistoryConverter<ParlantMessages> {
+    convert(raw: Array<Record<string, unknown>>): ParlantMessages;
+}
+
+interface OpencodeSessionState {
+    sessionId: string | null;
+    roomId: string | null;
+    createdAt: Date | null;
+    replayMessages: string[];
+}
+declare class OpencodeHistoryConverter {
+    setAgentName(_name: string): void;
+    convert(raw: Array<Record<string, unknown>>): OpencodeSessionState;
+}
+declare function extractOpencodeSessionId(raw: Array<Record<string, unknown>>): string | null;
+
+export { type A2AAuth as A, type GatewaySessionState as G, OpencodeHistoryConverter as O, ParlantHistoryConverter as P, type A2AGatewayAdapterOptions as a, type GatewayServerLike as b, type GatewayServerOptions as c, A2AHistoryConverter as d, type A2ASessionState as e, type GatewayA2AMessage as f, type GatewayA2AStatusUpdateEvent as g, type GatewayCancelRequest as h, type GatewayPeer as i, type GatewayRequest as j, type GatewayServerFactory as k, type GatewayTaskState as l, type ParlantMessage as m, type ParlantMessages as n, type PendingA2ATask as o, buildA2AAuthHeaders as p, GoogleADKHistoryConverter as q, type GoogleADKMessage as r, type GoogleADKMessages as s, type OpencodeSessionState as t, extractGoogleAdkSessionId as u, extractOpencodeSessionId as v };

package/dist/pagination-BPiys10t.d.cts

@@ -0,0 +1,25 @@
+import { P as PaginatedResponse, a as PaginationMetadata } from './types-CSHFipIc.cjs';
+import { M as MetadataMap } from './dtos-DUpbIu8k.cjs';
+
+interface FetchPageRequest {
+    page: number;
+    pageSize: number;
+}
+type PaginationStrategy = "auto" | "total_pages" | "until_empty";
+type PaginationMetadataValidation = "strategy_aware" | "strict" | "lossy";
+interface PaginationOptions {
+    pageSize?: number;
+    maxPages?: number;
+    strategy?: PaginationStrategy;
+    metadataValidation?: PaginationMetadataValidation;
+}
+interface FetchPaginatedOptions<T extends MetadataMap> extends PaginationOptions {
+    fetchPage: (request: FetchPageRequest) => Promise<PaginatedResponse<T>>;
+}
+type PaginationMetadataMode = "strict" | "lossy";
+declare function normalizePaginationMetadata(metadata?: Record<string, unknown> | PaginationMetadata, options?: {
+    mode?: PaginationMetadataMode;
+}): PaginationMetadata;
+declare function fetchPaginated<T extends MetadataMap>(options: FetchPaginatedOptions<T>): Promise<T[]>;
+
+export { type PaginationOptions as P, fetchPaginated as f, normalizePaginationMetadata as n };

package/dist/pagination-CcDkVFxK.d.ts

@@ -0,0 +1,25 @@
+import { P as PaginatedResponse, a as PaginationMetadata } from './types-CxII3XkA.js';
+import { M as MetadataMap } from './dtos-DUpbIu8k.js';
+
+interface FetchPageRequest {
+    page: number;
+    pageSize: number;
+}
+type PaginationStrategy = "auto" | "total_pages" | "until_empty";
+type PaginationMetadataValidation = "strategy_aware" | "strict" | "lossy";
+interface PaginationOptions {
+    pageSize?: number;
+    maxPages?: number;
+    strategy?: PaginationStrategy;
+    metadataValidation?: PaginationMetadataValidation;
+}
+interface FetchPaginatedOptions<T extends MetadataMap> extends PaginationOptions {
+    fetchPage: (request: FetchPageRequest) => Promise<PaginatedResponse<T>>;
+}
+type PaginationMetadataMode = "strict" | "lossy";
+declare function normalizePaginationMetadata(metadata?: Record<string, unknown> | PaginationMetadata, options?: {
+    mode?: PaginationMetadataMode;
+}): PaginationMetadata;
+declare function fetchPaginated<T extends MetadataMap>(options: FetchPaginatedOptions<T>): Promise<T[]>;
+
+export { type PaginationOptions as P, fetchPaginated as f, normalizePaginationMetadata as n };