@band-ai/sdk 0.1.2

package/dist/protocols-CInhtFpA.d.cts

@@ -0,0 +1,116 @@
+import { a as MentionInput, T as ToolOperationResult, M as MetadataMap, P as ParticipantRecord, b as ToolSchemaRecord, c as PaginatedList, d as PeerRecord, L as ListContactsArgs, C as ContactRecord, A as AddContactArgs, R as RemoveContactArgs, e as ListContactRequestsArgs, f as ContactRequestsResult, g as RespondContactRequestArgs, h as ListMemoriesArgs, i as MemoryRecord, S as StoreMemoryArgs } from './dtos-DUpbIu8k.cjs';
+
+interface HistoryConverter<T> {
+    convert(raw: MetadataMap[]): T;
+}
+interface PlatformMessageLike {
+    id: string;
+    roomId: string;
+    content: string;
+    senderId: string;
+    senderType: string;
+    senderName: string | null;
+    messageType: string;
+    metadata: MetadataMap;
+    createdAt: Date;
+}
+interface HistoryLike {
+    readonly raw: MetadataMap[];
+    convert<T>(converter: HistoryConverter<T>): T;
+    readonly length: number;
+}
+interface MessagingTools {
+    sendMessage(content: string, mentions?: MentionInput): Promise<ToolOperationResult>;
+    sendEvent(content: string, messageType: string, metadata?: MetadataMap): Promise<ToolOperationResult>;
+}
+interface RoomParticipantTools {
+    addParticipant(name: string, role?: string): Promise<ToolOperationResult>;
+    removeParticipant(name: string): Promise<ToolOperationResult>;
+    getParticipants(): Promise<ParticipantRecord[]>;
+    createChatroom(taskId?: string): Promise<string>;
+}
+interface PeerLookupTools {
+    lookupPeers(page?: number, pageSize?: number): Promise<PaginatedList<PeerRecord>>;
+}
+interface ToolSchemaProvider {
+    getToolSchemas(format: "openai" | "anthropic", options?: {
+        includeMemory?: boolean;
+    }): ToolSchemaRecord[];
+    getAnthropicToolSchemas(options?: {
+        includeMemory?: boolean;
+    }): ToolSchemaRecord[];
+    getOpenAIToolSchemas(options?: {
+        includeMemory?: boolean;
+    }): ToolSchemaRecord[];
+}
+interface ContactTools {
+    listContacts(request?: ListContactsArgs): Promise<PaginatedList<ContactRecord>>;
+    addContact(request: AddContactArgs): Promise<ToolOperationResult>;
+    removeContact(request: RemoveContactArgs): Promise<ToolOperationResult>;
+    listContactRequests(request?: ListContactRequestsArgs): Promise<ContactRequestsResult>;
+    respondContactRequest(request: RespondContactRequestArgs): Promise<ToolOperationResult>;
+}
+interface MemoryTools {
+    listMemories(args?: ListMemoriesArgs): Promise<PaginatedList<MemoryRecord>>;
+    storeMemory(args: StoreMemoryArgs): Promise<MemoryRecord>;
+    getMemory(memoryId: string): Promise<MemoryRecord>;
+    supersedeMemory(memoryId: string): Promise<ToolOperationResult>;
+    archiveMemory(memoryId: string): Promise<ToolOperationResult>;
+}
+interface ToolExecutor {
+    executeToolCall(toolName: string, toolArgs: MetadataMap): Promise<unknown>;
+}
+interface ParticipantTools extends RoomParticipantTools, PeerLookupTools {
+}
+/** Full tool surface available to framework adapters during message handling. */
+interface AdapterToolsProtocol extends MessagingTools, RoomParticipantTools, ToolSchemaProvider, ToolExecutor, Partial<PeerLookupTools>, Partial<ContactTools>, Partial<MemoryTools> {
+    /** Check capability flags to determine which optional tools are available. */
+    readonly capabilities: Readonly<AgentToolsCapabilities>;
+}
+type AgentToolsProtocol = AdapterToolsProtocol;
+interface AgentToolsCapabilities {
+    peers: boolean;
+    contacts: boolean;
+    memory: boolean;
+}
+interface FrameworkAdapterInput {
+    message: PlatformMessageLike;
+    tools: AdapterToolsProtocol;
+    history: HistoryLike;
+    participantsMessage: string | null;
+    contactsMessage: string | null;
+    isSessionBootstrap: boolean;
+    roomId: string;
+}
+interface PreprocessorContext {
+    roomId: string;
+    hasMessage(messageId: string): boolean;
+    recordMessage(message: PlatformMessageLike): void;
+    getTools(): AdapterToolsProtocol;
+    getRawHistory(): MetadataMap[];
+    getHydratedHistory(excludeMessageId?: string): Promise<MetadataMap[]>;
+    consumeParticipantsMessage(): string | null;
+    consumeContactsMessage(): string | null;
+    readonly isLlmInitialized: boolean;
+    markLlmInitialized(): void;
+    injectSystemMessage(message: string): void;
+    consumeSystemMessages(): string[];
+}
+/** Contract that every adapter must satisfy. Implement via {@link SimpleAdapter} for convenience. */
+interface FrameworkAdapter {
+    onEvent(input: FrameworkAdapterInput): Promise<void>;
+    onCleanup(roomId: string): Promise<void>;
+    onStarted(agentName: string, agentDescription: string): Promise<void>;
+    onRuntimeStop?(): Promise<void>;
+}
+interface EventEnvelope {
+    type: string;
+    roomId: string | null;
+    payload: MetadataMap;
+    raw?: MetadataMap;
+}
+interface Preprocessor<TEvent extends EventEnvelope = EventEnvelope> {
+    process(context: PreprocessorContext, event: TEvent, agentId: string): Promise<FrameworkAdapterInput | null>;
+}
+
+export type { AdapterToolsProtocol as A, ContactTools as C, FrameworkAdapter as F, HistoryConverter as H, MemoryTools as M, ParticipantTools as P, RoomParticipantTools as R, ToolExecutor as T, AgentToolsProtocol as a, FrameworkAdapterInput as b, MessagingTools as c, PeerLookupTools as d, Preprocessor as e, ToolSchemaProvider as f, PlatformMessageLike as g, AgentToolsCapabilities as h, PreprocessorContext as i };

package/dist/protocols-DrhzOH6K.d.ts

@@ -0,0 +1,116 @@
+import { a as MentionInput, T as ToolOperationResult, M as MetadataMap, P as ParticipantRecord, b as ToolSchemaRecord, c as PaginatedList, d as PeerRecord, L as ListContactsArgs, C as ContactRecord, A as AddContactArgs, R as RemoveContactArgs, e as ListContactRequestsArgs, f as ContactRequestsResult, g as RespondContactRequestArgs, h as ListMemoriesArgs, i as MemoryRecord, S as StoreMemoryArgs } from './dtos-DUpbIu8k.js';
+
+interface HistoryConverter<T> {
+    convert(raw: MetadataMap[]): T;
+}
+interface PlatformMessageLike {
+    id: string;
+    roomId: string;
+    content: string;
+    senderId: string;
+    senderType: string;
+    senderName: string | null;
+    messageType: string;
+    metadata: MetadataMap;
+    createdAt: Date;
+}
+interface HistoryLike {
+    readonly raw: MetadataMap[];
+    convert<T>(converter: HistoryConverter<T>): T;
+    readonly length: number;
+}
+interface MessagingTools {
+    sendMessage(content: string, mentions?: MentionInput): Promise<ToolOperationResult>;
+    sendEvent(content: string, messageType: string, metadata?: MetadataMap): Promise<ToolOperationResult>;
+}
+interface RoomParticipantTools {
+    addParticipant(name: string, role?: string): Promise<ToolOperationResult>;
+    removeParticipant(name: string): Promise<ToolOperationResult>;
+    getParticipants(): Promise<ParticipantRecord[]>;
+    createChatroom(taskId?: string): Promise<string>;
+}
+interface PeerLookupTools {
+    lookupPeers(page?: number, pageSize?: number): Promise<PaginatedList<PeerRecord>>;
+}
+interface ToolSchemaProvider {
+    getToolSchemas(format: "openai" | "anthropic", options?: {
+        includeMemory?: boolean;
+    }): ToolSchemaRecord[];
+    getAnthropicToolSchemas(options?: {
+        includeMemory?: boolean;
+    }): ToolSchemaRecord[];
+    getOpenAIToolSchemas(options?: {
+        includeMemory?: boolean;
+    }): ToolSchemaRecord[];
+}
+interface ContactTools {
+    listContacts(request?: ListContactsArgs): Promise<PaginatedList<ContactRecord>>;
+    addContact(request: AddContactArgs): Promise<ToolOperationResult>;
+    removeContact(request: RemoveContactArgs): Promise<ToolOperationResult>;
+    listContactRequests(request?: ListContactRequestsArgs): Promise<ContactRequestsResult>;
+    respondContactRequest(request: RespondContactRequestArgs): Promise<ToolOperationResult>;
+}
+interface MemoryTools {
+    listMemories(args?: ListMemoriesArgs): Promise<PaginatedList<MemoryRecord>>;
+    storeMemory(args: StoreMemoryArgs): Promise<MemoryRecord>;
+    getMemory(memoryId: string): Promise<MemoryRecord>;
+    supersedeMemory(memoryId: string): Promise<ToolOperationResult>;
+    archiveMemory(memoryId: string): Promise<ToolOperationResult>;
+}
+interface ToolExecutor {
+    executeToolCall(toolName: string, toolArgs: MetadataMap): Promise<unknown>;
+}
+interface ParticipantTools extends RoomParticipantTools, PeerLookupTools {
+}
+/** Full tool surface available to framework adapters during message handling. */
+interface AdapterToolsProtocol extends MessagingTools, RoomParticipantTools, ToolSchemaProvider, ToolExecutor, Partial<PeerLookupTools>, Partial<ContactTools>, Partial<MemoryTools> {
+    /** Check capability flags to determine which optional tools are available. */
+    readonly capabilities: Readonly<AgentToolsCapabilities>;
+}
+type AgentToolsProtocol = AdapterToolsProtocol;
+interface AgentToolsCapabilities {
+    peers: boolean;
+    contacts: boolean;
+    memory: boolean;
+}
+interface FrameworkAdapterInput {
+    message: PlatformMessageLike;
+    tools: AdapterToolsProtocol;
+    history: HistoryLike;
+    participantsMessage: string | null;
+    contactsMessage: string | null;
+    isSessionBootstrap: boolean;
+    roomId: string;
+}
+interface PreprocessorContext {
+    roomId: string;
+    hasMessage(messageId: string): boolean;
+    recordMessage(message: PlatformMessageLike): void;
+    getTools(): AdapterToolsProtocol;
+    getRawHistory(): MetadataMap[];
+    getHydratedHistory(excludeMessageId?: string): Promise<MetadataMap[]>;
+    consumeParticipantsMessage(): string | null;
+    consumeContactsMessage(): string | null;
+    readonly isLlmInitialized: boolean;
+    markLlmInitialized(): void;
+    injectSystemMessage(message: string): void;
+    consumeSystemMessages(): string[];
+}
+/** Contract that every adapter must satisfy. Implement via {@link SimpleAdapter} for convenience. */
+interface FrameworkAdapter {
+    onEvent(input: FrameworkAdapterInput): Promise<void>;
+    onCleanup(roomId: string): Promise<void>;
+    onStarted(agentName: string, agentDescription: string): Promise<void>;
+    onRuntimeStop?(): Promise<void>;
+}
+interface EventEnvelope {
+    type: string;
+    roomId: string | null;
+    payload: MetadataMap;
+    raw?: MetadataMap;
+}
+interface Preprocessor<TEvent extends EventEnvelope = EventEnvelope> {
+    process(context: PreprocessorContext, event: TEvent, agentId: string): Promise<FrameworkAdapterInput | null>;
+}
+
+export type { AdapterToolsProtocol as A, ContactTools as C, FrameworkAdapter as F, HistoryConverter as H, MemoryTools as M, ParticipantTools as P, RoomParticipantTools as R, ToolExecutor as T, AgentToolsProtocol as a, FrameworkAdapterInput as b, MessagingTools as c, PeerLookupTools as d, Preprocessor as e, ToolSchemaProvider as f, PlatformMessageLike as g, AgentToolsCapabilities as h, PreprocessorContext as i };