@band-ai/sdk 0.2.0 → 0.3.0

package/dist/runtime.d.cts

@@ -1,13 +1,13 @@
-import { c as ContactEventConfig, g as MessageEvent, C as ContactEvent, f as PlatformEvent, P as PlatformMessage } from './types-D958TC71.cjs';
-export { A as AgentConfig, b as ContactEventCallback, d as ContactEventStrategy, e as ConversationContext, H as HistoryProvider, M as MessageHandler, h as SYNTHETIC_CONTACT_EVENTS_SENDER_ID, i as SYNTHETIC_CONTACT_EVENTS_SENDER_NAME, j as SYNTHETIC_SENDER_TYPE, S as SessionConfig, k as ensureHandlePrefix } from './types-D958TC71.cjs';
+import { c as ContactEventConfig, g as MessageEvent, C as ContactEvent, f as PlatformEvent, P as PlatformMessage } from './types-BNNtOXu3.cjs';
+export { A as AgentConfig, b as ContactEventCallback, d as ContactEventStrategy, e as ConversationContext, H as HistoryProvider, M as MessageHandler, j as SYNTHETIC_CONTACT_EVENTS_SENDER_ID, k as SYNTHETIC_CONTACT_EVENTS_SENDER_NAME, l as SYNTHETIC_SENDER_TYPE, S as SessionConfig, m as ensureHandlePrefix } from './types-BNNtOXu3.cjs';
 import { L as Logger } from './logger-CABQOnlR.cjs';
 import { A as AdapterToolsProtocol, a as AgentToolsProtocol, h as AgentToolsCapabilities, C as ContactTools } from './protocols-Bz1rxcUg.cjs';
 import { e as AgentToolsRestApi, f as ChatMessagingRestApi, g as ChatRoomRestApi, h as ContactRestApi } from './types-BgYFd_Yw.cjs';
-import { B as BandLink, c as ExecutionContext } from './schemas-BotL3ZLH.cjs';
-export { e as ALL_TOOL_NAMES, A as AgentRuntime, f as BASE_TOOL_NAMES, C as CHAT_TOOL_NAMES, g as CONTACT_TOOL_NAMES, D as DefaultPreprocessor, E as ExecutionContextOptions, h as ExecutionState, M as MCP_SERVER_NAME, b as MCP_TOOL_PREFIX, i as MEMORY_TOOL_NAMES, P as PlatformRuntime, T as TOOL_MODELS, j as getToolDescription, m as mcpToolNames } from './schemas-BotL3ZLH.cjs';
-import { M as MetadataMap, a as MentionInput, T as ToolOperationResult, c as PaginatedList, d as PeerRecord, P as ParticipantRecord, b as ToolSchemaRecord, 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, m as ToolModelMessage } from './dtos-B8KU_q4d.cjs';
+import { B as BandLink, c as ExecutionContext } from './schemas-BgJhlqqO.cjs';
+export { e as ALL_TOOL_NAMES, A as AgentRuntime, f as BASE_TOOL_NAMES, C as CHAT_TOOL_NAMES, g as CONTACT_TOOL_NAMES, D as DefaultPreprocessor, E as ExecutionContextOptions, h as ExecutionState, M as MCP_SERVER_NAME, b as MCP_TOOL_PREFIX, i as MEMORY_TOOL_NAMES, P as PlatformRuntime, R as RoomPresence, T as TOOL_MODELS, j as getToolDescription, m as mcpToolNames } from './schemas-BgJhlqqO.cjs';
 import { ParticipantRoster } from '@band-ai/band-sdk-core';
-export { ParticipantRoster, RetryTracker } from '@band-ai/band-sdk-core';
+export { ParticipantRoster, RetryTracker, RoomMembership, RoomRoster } from '@band-ai/band-sdk-core';
+import { a as MentionInput, T as ToolOperationResult, M as MetadataMap, c as PaginatedList, d as PeerRecord, P as ParticipantRecord, b as ToolSchemaRecord, 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, m as ToolModelMessage } from './dtos-B8KU_q4d.cjs';
 import 'zod';
 import './pagination-DqdkQArT.cjs';
 import './disconnectReason-IuADl6TH.cjs';
@@ -99,43 +99,12 @@ declare class Execution {
     private markMessageFailed;
 }
 
-interface RoomPresenceOptions {
-    link: BandLink;
-    roomFilter?: (room: MetadataMap) => boolean;
-    autoSubscribeExistingRooms?: boolean;
-    logger?: Logger;
-}
-type RoomPresenceJoinHandler = (roomId: string, payload: MetadataMap) => Promise<void>;
-type RoomPresenceLeaveHandler = (roomId: string) => Promise<void>;
-type RoomPresenceEventHandler = (roomId: string, event: PlatformEvent) => Promise<void>;
-type RoomPresenceContactHandler = (event: ContactEvent) => Promise<void>;
-declare class RoomPresence {
-    readonly rooms: Set<string>;
-    onRoomJoined: RoomPresenceJoinHandler | null;
-    onRoomLeft: RoomPresenceLeaveHandler | null;
-    onRoomEvent: RoomPresenceEventHandler | null;
-    onContactEvent: RoomPresenceContactHandler | null;
-    private readonly link;
-    private readonly roomFilter?;
-    private readonly autoSubscribeExistingRooms;
-    private readonly logger;
-    private eventController;
-    private eventTask;
-    private contactsSubscribed;
-    constructor(options: RoomPresenceOptions);
-    start(): Promise<void>;
-    stop(): Promise<void>;
-    private consumeEvents;
-    private handleRoomAdded;
-    private handleRoomRemoved;
-    private subscribeExistingRooms;
-}
-
 interface AgentToolsOptions {
     roomId: string;
     rest: AgentToolsRestApi;
     roster?: ParticipantRoster;
     capabilities?: Partial<AgentToolsCapabilities>;
+    logger?: Logger;
 }
 declare class AgentTools implements AgentToolsProtocol {
     readonly roomId: string;
@@ -144,6 +113,7 @@ declare class AgentTools implements AgentToolsProtocol {
     private readonly roster;
     private readonly adapterTools;
     private readonly toolHandlers;
+    private readonly logger;
     constructor(options: AgentToolsOptions);
     getAdapterTools(): AdapterToolsProtocol;
     sendMessage(content: string, mentions?: MentionInput): Promise<ToolOperationResult>;
@@ -218,6 +188,7 @@ type ChatMessageType = (typeof CHAT_MESSAGE_TYPES)[number];
 declare function isChatEventType(value: string): value is ChatEventType;
 declare function assertChatEventType(value: string): asserts value is ChatEventType;
 
+declare function mentionSubjectsFromMetadata(metadata: MetadataMap | undefined): Array<Record<string, unknown>>;
 declare function replaceUuidMentions(content: string, participants: Array<Record<string, unknown>>): string;
 declare function formatMessageForLlm(message: Record<string, unknown>, participants?: Array<Record<string, unknown>>): ToolModelMessage;
 declare function formatHistoryForLlm(messages: Array<Record<string, unknown>>, options?: {
@@ -266,4 +237,4 @@ declare class GracefulShutdown {
 }
 declare function runWithGracefulShutdown(agent: StoppableAgent, options?: GracefulShutdownOptions): Promise<void>;
 
-export { AgentTools, BASE_INSTRUCTIONS, CHAT_EVENT_TYPES, CHAT_MESSAGE_TYPES, type ChatEventType, type ChatMessageType, ContactEventConfig, ContactEventHandler, ContactToolsImpl, Execution, ExecutionContext, type ExecutionHandler, GracefulShutdown, HUB_ROOM_SYSTEM_PROMPT, MEMORY_SECTION, PlatformMessage, type RenderSystemPromptOptions, RoomPresence, TEMPLATES, assertChatEventType, buildParticipantsMessage, formatHistoryForLlm, formatMessageForLlm, isChatEventType, renderSystemPrompt, replaceUuidMentions, runWithGracefulShutdown };
+export { AgentTools, BASE_INSTRUCTIONS, CHAT_EVENT_TYPES, CHAT_MESSAGE_TYPES, type ChatEventType, type ChatMessageType, ContactEventConfig, ContactEventHandler, ContactToolsImpl, Execution, ExecutionContext, type ExecutionHandler, GracefulShutdown, HUB_ROOM_SYSTEM_PROMPT, MEMORY_SECTION, PlatformMessage, type RenderSystemPromptOptions, TEMPLATES, assertChatEventType, buildParticipantsMessage, formatHistoryForLlm, formatMessageForLlm, isChatEventType, mentionSubjectsFromMetadata, renderSystemPrompt, replaceUuidMentions, runWithGracefulShutdown };

package/dist/runtime.d.ts

@@ -1,13 +1,13 @@
-import { c as ContactEventConfig, g as MessageEvent, C as ContactEvent, f as PlatformEvent, P as PlatformMessage } from './types-BTN_ZETM.js';
-export { A as AgentConfig, b as ContactEventCallback, d as ContactEventStrategy, e as ConversationContext, H as HistoryProvider, M as MessageHandler, h as SYNTHETIC_CONTACT_EVENTS_SENDER_ID, i as SYNTHETIC_CONTACT_EVENTS_SENDER_NAME, j as SYNTHETIC_SENDER_TYPE, S as SessionConfig, k as ensureHandlePrefix } from './types-BTN_ZETM.js';
+import { c as ContactEventConfig, g as MessageEvent, C as ContactEvent, f as PlatformEvent, P as PlatformMessage } from './types-DFUtpxah.js';
+export { A as AgentConfig, b as ContactEventCallback, d as ContactEventStrategy, e as ConversationContext, H as HistoryProvider, M as MessageHandler, j as SYNTHETIC_CONTACT_EVENTS_SENDER_ID, k as SYNTHETIC_CONTACT_EVENTS_SENDER_NAME, l as SYNTHETIC_SENDER_TYPE, S as SessionConfig, m as ensureHandlePrefix } from './types-DFUtpxah.js';
 import { L as Logger } from './logger-CABQOnlR.js';
 import { A as AdapterToolsProtocol, a as AgentToolsProtocol, h as AgentToolsCapabilities, C as ContactTools } from './protocols-Bwwcql0h.js';
 import { e as AgentToolsRestApi, f as ChatMessagingRestApi, g as ChatRoomRestApi, h as ContactRestApi } from './types-BivGO7I9.js';
-import { B as BandLink, c as ExecutionContext } from './schemas-DBsC4J1g.js';
-export { e as ALL_TOOL_NAMES, A as AgentRuntime, f as BASE_TOOL_NAMES, C as CHAT_TOOL_NAMES, g as CONTACT_TOOL_NAMES, D as DefaultPreprocessor, E as ExecutionContextOptions, h as ExecutionState, M as MCP_SERVER_NAME, b as MCP_TOOL_PREFIX, i as MEMORY_TOOL_NAMES, P as PlatformRuntime, T as TOOL_MODELS, j as getToolDescription, m as mcpToolNames } from './schemas-DBsC4J1g.js';
-import { M as MetadataMap, a as MentionInput, T as ToolOperationResult, c as PaginatedList, d as PeerRecord, P as ParticipantRecord, b as ToolSchemaRecord, 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, m as ToolModelMessage } from './dtos-B8KU_q4d.js';
+import { B as BandLink, c as ExecutionContext } from './schemas-C4mK1WSs.js';
+export { e as ALL_TOOL_NAMES, A as AgentRuntime, f as BASE_TOOL_NAMES, C as CHAT_TOOL_NAMES, g as CONTACT_TOOL_NAMES, D as DefaultPreprocessor, E as ExecutionContextOptions, h as ExecutionState, M as MCP_SERVER_NAME, b as MCP_TOOL_PREFIX, i as MEMORY_TOOL_NAMES, P as PlatformRuntime, R as RoomPresence, T as TOOL_MODELS, j as getToolDescription, m as mcpToolNames } from './schemas-C4mK1WSs.js';
 import { ParticipantRoster } from '@band-ai/band-sdk-core';
-export { ParticipantRoster, RetryTracker } from '@band-ai/band-sdk-core';
+export { ParticipantRoster, RetryTracker, RoomMembership, RoomRoster } from '@band-ai/band-sdk-core';
+import { a as MentionInput, T as ToolOperationResult, M as MetadataMap, c as PaginatedList, d as PeerRecord, P as ParticipantRecord, b as ToolSchemaRecord, 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, m as ToolModelMessage } from './dtos-B8KU_q4d.js';
 import 'zod';
 import './pagination-BgEx-HeL.js';
 import './disconnectReason-IuADl6TH.js';
@@ -99,43 +99,12 @@ declare class Execution {
     private markMessageFailed;
 }
 
-interface RoomPresenceOptions {
-    link: BandLink;
-    roomFilter?: (room: MetadataMap) => boolean;
-    autoSubscribeExistingRooms?: boolean;
-    logger?: Logger;
-}
-type RoomPresenceJoinHandler = (roomId: string, payload: MetadataMap) => Promise<void>;
-type RoomPresenceLeaveHandler = (roomId: string) => Promise<void>;
-type RoomPresenceEventHandler = (roomId: string, event: PlatformEvent) => Promise<void>;
-type RoomPresenceContactHandler = (event: ContactEvent) => Promise<void>;
-declare class RoomPresence {
-    readonly rooms: Set<string>;
-    onRoomJoined: RoomPresenceJoinHandler | null;
-    onRoomLeft: RoomPresenceLeaveHandler | null;
-    onRoomEvent: RoomPresenceEventHandler | null;
-    onContactEvent: RoomPresenceContactHandler | null;
-    private readonly link;
-    private readonly roomFilter?;
-    private readonly autoSubscribeExistingRooms;
-    private readonly logger;
-    private eventController;
-    private eventTask;
-    private contactsSubscribed;
-    constructor(options: RoomPresenceOptions);
-    start(): Promise<void>;
-    stop(): Promise<void>;
-    private consumeEvents;
-    private handleRoomAdded;
-    private handleRoomRemoved;
-    private subscribeExistingRooms;
-}
-
 interface AgentToolsOptions {
     roomId: string;
     rest: AgentToolsRestApi;
     roster?: ParticipantRoster;
     capabilities?: Partial<AgentToolsCapabilities>;
+    logger?: Logger;
 }
 declare class AgentTools implements AgentToolsProtocol {
     readonly roomId: string;
@@ -144,6 +113,7 @@ declare class AgentTools implements AgentToolsProtocol {
     private readonly roster;
     private readonly adapterTools;
     private readonly toolHandlers;
+    private readonly logger;
     constructor(options: AgentToolsOptions);
     getAdapterTools(): AdapterToolsProtocol;
     sendMessage(content: string, mentions?: MentionInput): Promise<ToolOperationResult>;
@@ -218,6 +188,7 @@ type ChatMessageType = (typeof CHAT_MESSAGE_TYPES)[number];
 declare function isChatEventType(value: string): value is ChatEventType;
 declare function assertChatEventType(value: string): asserts value is ChatEventType;
 
+declare function mentionSubjectsFromMetadata(metadata: MetadataMap | undefined): Array<Record<string, unknown>>;
 declare function replaceUuidMentions(content: string, participants: Array<Record<string, unknown>>): string;
 declare function formatMessageForLlm(message: Record<string, unknown>, participants?: Array<Record<string, unknown>>): ToolModelMessage;
 declare function formatHistoryForLlm(messages: Array<Record<string, unknown>>, options?: {
@@ -266,4 +237,4 @@ declare class GracefulShutdown {
 }
 declare function runWithGracefulShutdown(agent: StoppableAgent, options?: GracefulShutdownOptions): Promise<void>;
 
-export { AgentTools, BASE_INSTRUCTIONS, CHAT_EVENT_TYPES, CHAT_MESSAGE_TYPES, type ChatEventType, type ChatMessageType, ContactEventConfig, ContactEventHandler, ContactToolsImpl, Execution, ExecutionContext, type ExecutionHandler, GracefulShutdown, HUB_ROOM_SYSTEM_PROMPT, MEMORY_SECTION, PlatformMessage, type RenderSystemPromptOptions, RoomPresence, TEMPLATES, assertChatEventType, buildParticipantsMessage, formatHistoryForLlm, formatMessageForLlm, isChatEventType, renderSystemPrompt, replaceUuidMentions, runWithGracefulShutdown };
+export { AgentTools, BASE_INSTRUCTIONS, CHAT_EVENT_TYPES, CHAT_MESSAGE_TYPES, type ChatEventType, type ChatMessageType, ContactEventConfig, ContactEventHandler, ContactToolsImpl, Execution, ExecutionContext, type ExecutionHandler, GracefulShutdown, HUB_ROOM_SYSTEM_PROMPT, MEMORY_SECTION, PlatformMessage, type RenderSystemPromptOptions, TEMPLATES, assertChatEventType, buildParticipantsMessage, formatHistoryForLlm, formatMessageForLlm, isChatEventType, mentionSubjectsFromMetadata, renderSystemPrompt, replaceUuidMentions, runWithGracefulShutdown };

package/dist/runtime.js

@@ -9,11 +9,9 @@ import {
   GracefulShutdown,
   HUB_ROOM_SYSTEM_PROMPT,
   PlatformRuntime,
-  hydrateTrackedRooms,
-  runWithGracefulShutdown,
-  trackRoomJoin,
-  trackRoomLeave
-} from "./chunk-N2QTUMGO.js";
+  RoomPresence,
+  runWithGracefulShutdown
+} from "./chunk-JJF44XWA.js";
 import {
   HistoryProvider,
   SYNTHETIC_CONTACT_EVENTS_SENDER_ID,
@@ -23,164 +21,42 @@ import {
   ensureHandlePrefix,
   formatHistoryForLlm,
   formatMessageForLlm,
+  mentionSubjectsFromMetadata,
   replaceUuidMentions
-} from "./chunk-LBWKISBS.js";
+} from "./chunk-OH6VVVKT.js";
 import {
   BASE_INSTRUCTIONS,
   MEMORY_SECTION,
   TEMPLATES,
   renderSystemPrompt
-} from "./chunk-WLCM2OXG.js";
+} from "./chunk-YJ42AZO4.js";
 import {
   ALL_TOOL_NAMES,
   BASE_TOOL_NAMES,
-  CHAT_EVENT_TYPES,
-  CHAT_MESSAGE_TYPES,
   CHAT_TOOL_NAMES,
   CONTACT_TOOL_NAMES,
   MCP_SERVER_NAME,
   MCP_TOOL_PREFIX,
   MEMORY_TOOL_NAMES,
   TOOL_MODELS,
-  assertChatEventType,
   getToolDescription,
-  isChatEventType,
   mcpToolNames
-} from "./chunk-RV76SKFT.js";
-import "./chunk-US226AS4.js";
+} from "./chunk-MQY74R7D.js";
 import {
-  DEFAULT_REQUEST_OPTIONS
-} from "./chunk-EAI2M3WM.js";
-import "./chunk-ZZJRRBPQ.js";
-import "./chunk-3BKAC4OZ.js";
-import {
-  NoopLogger
-} from "./chunk-OD2G5LFQ.js";
+  CHAT_EVENT_TYPES,
+  CHAT_MESSAGE_TYPES,
+  assertChatEventType,
+  isChatEventType
+} from "./chunk-F63TPOI3.js";
+import "./chunk-US226AS4.js";
+import "./chunk-W5IAI6Z4.js";
+import "./chunk-KXJ74J73.js";
+import "./chunk-JADCAMZY.js";
+import "./chunk-OD2G5LFQ.js";
 import "./chunk-JY75VSQK.js";
 
-// src/runtime/rooms/RoomPresence.ts
-var RoomPresence = class {
-  rooms = /* @__PURE__ */ new Set();
-  onRoomJoined = null;
-  onRoomLeft = null;
-  onRoomEvent = null;
-  onContactEvent = null;
-  link;
-  roomFilter;
-  autoSubscribeExistingRooms;
-  logger;
-  eventController = null;
-  eventTask = null;
-  contactsSubscribed = false;
-  constructor(options) {
-    this.link = options.link;
-    this.roomFilter = options.roomFilter;
-    this.autoSubscribeExistingRooms = options.autoSubscribeExistingRooms ?? true;
-    this.logger = options.logger ?? new NoopLogger();
-  }
-  async start() {
-    if (this.eventTask) {
-      return;
-    }
-    if (!this.link.isConnected()) {
-      await this.link.connect();
-    }
-    try {
-      await this.link.subscribeAgentRooms();
-    } catch {
-    }
-    if (this.autoSubscribeExistingRooms) {
-      await this.subscribeExistingRooms();
-    }
-    if (this.link.capabilities.contacts) {
-      await this.link.subscribeAgentContacts();
-      this.contactsSubscribed = true;
-    }
-    this.eventController = new AbortController();
-    this.eventTask = this.consumeEvents(this.eventController.signal);
-  }
-  async stop() {
-    this.eventController?.abort();
-    await this.eventTask;
-    this.eventTask = null;
-    this.eventController = null;
-    if (this.contactsSubscribed) {
-      await this.link.unsubscribeAgentContacts();
-      this.contactsSubscribed = false;
-    }
-    for (const roomId of [...this.rooms]) {
-      await trackRoomLeave({
-        link: this.link,
-        roomId,
-        trackedRooms: this.rooms,
-        onLeft: this.onRoomLeft ?? void 0
-      });
-    }
-  }
-  async consumeEvents(signal) {
-    while (!signal.aborted) {
-      const event = await this.link.nextEvent(signal);
-      if (!event) {
-        return;
-      }
-      switch (event.type) {
-        case "room_added":
-          await this.handleRoomAdded(event.roomId, event.payload);
-          break;
-        case "room_removed":
-        case "room_deleted":
-          await this.handleRoomRemoved(event.roomId);
-          break;
-        case "contact_request_received":
-        case "contact_request_updated":
-        case "contact_added":
-        case "contact_removed":
-          await this.onContactEvent?.(event);
-          break;
-        default:
-          if (event.roomId && this.rooms.has(event.roomId)) {
-            await this.onRoomEvent?.(event.roomId, event);
-          }
-          break;
-      }
-    }
-  }
-  async handleRoomAdded(roomId, payload) {
-    await trackRoomJoin({
-      link: this.link,
-      roomId,
-      payload,
-      trackedRooms: this.rooms,
-      roomFilter: this.roomFilter,
-      onJoined: this.onRoomJoined ?? void 0
-    });
-  }
-  async handleRoomRemoved(roomId) {
-    await trackRoomLeave({
-      link: this.link,
-      roomId,
-      trackedRooms: this.rooms,
-      onLeft: this.onRoomLeft ?? void 0
-    });
-  }
-  async subscribeExistingRooms() {
-    await hydrateTrackedRooms({
-      link: this.link,
-      trackedRooms: this.rooms,
-      requestOptions: DEFAULT_REQUEST_OPTIONS,
-      roomFilter: this.roomFilter,
-      onJoined: this.onRoomJoined ?? void 0,
-      onError: async (error) => {
-        this.logger.warn("RoomPresence failed to subscribe existing rooms", {
-          error
-        });
-      }
-    });
-  }
-};
-
 // src/runtime/index.ts
-import { ParticipantRoster, RetryTracker } from "@band-ai/band-sdk-core";
+import { ParticipantRoster, RetryTracker, RoomRoster } from "@band-ai/band-sdk-core";
 export {
   ALL_TOOL_NAMES,
   AgentRuntime,
@@ -207,6 +83,7 @@ export {
   PlatformRuntime,
   RetryTracker,
   RoomPresence,
+  RoomRoster,
   SYNTHETIC_CONTACT_EVENTS_SENDER_ID,
   SYNTHETIC_CONTACT_EVENTS_SENDER_NAME,
   SYNTHETIC_SENDER_TYPE,
@@ -220,6 +97,7 @@ export {
   getToolDescription,
   isChatEventType,
   mcpToolNames,
+  mentionSubjectsFromMetadata,
   renderSystemPrompt,
   replaceUuidMentions,
   runWithGracefulShutdown

package/dist/{schemas-BotL3ZLH.d.cts → schemas-BgJhlqqO.d.cts}

@@ -1,11 +1,11 @@
 import { h as AgentToolsCapabilities, g as PlatformMessageLike, A as AdapterToolsProtocol, e as Preprocessor, F as FrameworkAdapter, i as PreprocessorContext } from './protocols-Bz1rxcUg.cjs';
-import { f as PlatformEvent, P as PlatformMessage, e as ConversationContext, S as SessionConfig, c as ContactEventConfig, A as AgentConfig, C as ContactEvent, a as AgentInput } from './types-D958TC71.cjs';
+import { f as PlatformEvent, P as PlatformMessage, e as ConversationContext, S as SessionConfig, c as ContactEventConfig, A as AgentConfig, g as MessageEvent, h as ParticipantAddedEvent, i as ParticipantRemovedEvent, C as ContactEvent, a as AgentInput } from './types-BNNtOXu3.cjs';
 import { M as MetadataMap, P as ParticipantRecord } from './dtos-B8KU_q4d.cjs';
 import { L as Logger } from './logger-CABQOnlR.cjs';
 import { B as BandLinkRestApi, b as RestRequestOptions, P as PaginatedResponse, e as AgentToolsRestApi } from './types-BgYFd_Yw.cjs';
 import { P as PaginationOptions } from './pagination-DqdkQArT.cjs';
 import { W as WebSocketConflictPolicy, b as WebSocketDisconnectReason } from './disconnectReason-IuADl6TH.cjs';
-import { RetryTracker } from '@band-ai/band-sdk-core';
+import { RetryTracker, RoomRoster } from '@band-ai/band-sdk-core';
 
 interface TopicHandlers {
     [event: string]: (payload: Record<string, unknown>) => Promise<void> | void;
@@ -93,6 +93,7 @@ interface ExecutionContextOptions {
     enableContextCache?: boolean;
     contextCacheTtlSeconds?: number;
     enableContextHydration?: boolean;
+    logger?: Logger;
 }
 declare class ExecutionContext {
     readonly roomId: string;
@@ -167,7 +168,7 @@ interface PlatformRuntimeOptions {
         description?: string | null;
     };
 }
-declare class PlatformRuntime {
+declare class PlatformRuntime implements AsyncDisposable {
     private readonly _agentId;
     private readonly _apiKey;
     private readonly _wsUrl?;
@@ -203,6 +204,7 @@ declare class PlatformRuntime {
     private doInitialize;
     start(adapter: FrameworkAdapter): Promise<void>;
     stop(timeoutMs?: number): Promise<boolean>;
+    [Symbol.asyncDispose](): Promise<void>;
     runForever(): Promise<void>;
     bootstrapRoomMessage(roomId: string, message: PlatformMessage): Promise<void>;
     resetRoomSession(roomId: string, timeoutMs?: number): Promise<boolean>;
@@ -210,6 +212,55 @@ declare class PlatformRuntime {
     private handleContactEvent;
 }
 
+interface RoomPresenceOptions {
+    link: BandLink;
+    roomFilter?: (room: MetadataMap) => boolean;
+    autoSubscribeExistingRooms?: boolean;
+    logger?: Logger;
+}
+type RoomPresenceJoinHandler = (roomId: string, payload: MetadataMap) => Promise<void>;
+type RoomPresenceLeaveHandler = (roomId: string) => Promise<void>;
+type RoomPresenceEventHandler = (roomId: string, event: MessageEvent | ParticipantAddedEvent | ParticipantRemovedEvent) => Promise<void>;
+type RoomPresenceContactHandler = (event: ContactEvent) => Promise<void>;
+declare class RoomPresence implements AsyncDisposable {
+    readonly roster: RoomRoster;
+    onRoomJoined: RoomPresenceJoinHandler | null;
+    onRoomLeft: RoomPresenceLeaveHandler | null;
+    onRoomEvent: RoomPresenceEventHandler | null;
+    onContactEvent: RoomPresenceContactHandler | null;
+    private readonly link;
+    private readonly roomFilter?;
+    private readonly autoSubscribeExistingRooms;
+    private readonly logger;
+    private eventController;
+    private eventTask;
+    private contactsSubscribed;
+    private lifecycle;
+    private readonly admissionInFlight;
+    private readonly lastSubscribeError;
+    constructor(options: RoomPresenceOptions);
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    [Symbol.asyncDispose](): Promise<void>;
+    abortEventLoop(): void;
+    waitUntilStopped(): Promise<void>;
+    admitRoom(roomId: string, payload: MetadataMap, notify?: boolean): Promise<boolean>;
+    /** Admit a room for a caller that needs to know *why* a failed subscribe happened, not just that it did. */
+    admitRoomOrThrow(roomId: string): Promise<void>;
+    private awaitInFlightAdmission;
+    private performAdmission;
+    private completeAdmission;
+    private serialize;
+    private startBody;
+    private subscribeContacts;
+    private stopBody;
+    private consumeEvents;
+    private handleRoomAdded;
+    private handleRoomRemoved;
+    private unsubscribeRoom;
+    private subscribeExistingRooms;
+}
+
 interface AgentRuntimeOptions {
     link: BandLink;
     agentId: string;
@@ -228,6 +279,7 @@ interface AgentRuntimeOptions {
     logger?: Logger;
 }
 declare class AgentRuntime {
+    readonly presence: RoomPresence;
     private readonly link;
     private readonly agentId;
     private readonly onExecute;
@@ -238,19 +290,14 @@ declare class AgentRuntime {
     private readonly onParticipantAdded?;
     private readonly onParticipantRemoved?;
     private readonly onError?;
-    private readonly roomFilter?;
     private readonly contextFactory?;
     private readonly sessionConfig;
-    private readonly autoSubscribeExistingRooms;
-    private readonly subscribedRooms;
     private readonly contexts;
     private readonly executions;
     private readonly executionWatchers;
     private readonly logger;
     private running;
     private stopping;
-    private stopController;
-    private consumeTask;
     private fatalError;
     constructor(options: AgentRuntimeOptions);
     start(): Promise<void>;
@@ -259,15 +306,12 @@ declare class AgentRuntime {
     getContext(roomId: string): ExecutionContext | undefined;
     waitUntilStopped(): Promise<void>;
     getContexts(): ExecutionContext[];
-    private consumeLoop;
-    private handleEvent;
     enqueueEvent(roomId: string, event: PlatformEvent): Promise<void>;
     bootstrapRoomMessage(roomId: string, message: PlatformMessage): Promise<void>;
     resetRoomSession(roomId: string, timeoutMs?: number): Promise<boolean>;
+    private teardownExecution;
     private getOrCreateExecution;
     getOrCreateContext(roomId: string): ExecutionContext;
-    private subscribeExistingRooms;
-    private leaveTrackedRoom;
     private failRuntime;
     private notifyOnError;
 }
@@ -584,4 +628,4 @@ declare const MCP_SERVER_NAME = "band";
 declare function mcpToolNames(names: Set<string>): string[];
 declare function getToolDescription(name: string): string;
 
-export { AgentRuntime as A, BandLink as B, CHAT_TOOL_NAMES as C, DefaultPreprocessor as D, type ExecutionContextOptions as E, MCP_SERVER_NAME as M, PlatformRuntime as P, TOOL_MODELS as T, type PlatformRuntimeOptions as a, MCP_TOOL_PREFIX as b, ExecutionContext as c, deriveDefaultRestUrl as d, ALL_TOOL_NAMES as e, BASE_TOOL_NAMES as f, CONTACT_TOOL_NAMES as g, type ExecutionState as h, MEMORY_TOOL_NAMES as i, getToolDescription as j, mcpToolNames as m };
+export { AgentRuntime as A, BandLink as B, CHAT_TOOL_NAMES as C, DefaultPreprocessor as D, type ExecutionContextOptions as E, MCP_SERVER_NAME as M, PlatformRuntime as P, RoomPresence as R, TOOL_MODELS as T, type PlatformRuntimeOptions as a, MCP_TOOL_PREFIX as b, ExecutionContext as c, deriveDefaultRestUrl as d, ALL_TOOL_NAMES as e, BASE_TOOL_NAMES as f, CONTACT_TOOL_NAMES as g, type ExecutionState as h, MEMORY_TOOL_NAMES as i, getToolDescription as j, mcpToolNames as m };

package/dist/{schemas-DBsC4J1g.d.ts → schemas-C4mK1WSs.d.ts}

@@ -1,11 +1,11 @@
 import { h as AgentToolsCapabilities, g as PlatformMessageLike, A as AdapterToolsProtocol, e as Preprocessor, F as FrameworkAdapter, i as PreprocessorContext } from './protocols-Bwwcql0h.js';
-import { f as PlatformEvent, P as PlatformMessage, e as ConversationContext, S as SessionConfig, c as ContactEventConfig, A as AgentConfig, C as ContactEvent, a as AgentInput } from './types-BTN_ZETM.js';
+import { f as PlatformEvent, P as PlatformMessage, e as ConversationContext, S as SessionConfig, c as ContactEventConfig, A as AgentConfig, g as MessageEvent, h as ParticipantAddedEvent, i as ParticipantRemovedEvent, C as ContactEvent, a as AgentInput } from './types-DFUtpxah.js';
 import { M as MetadataMap, P as ParticipantRecord } from './dtos-B8KU_q4d.js';
 import { L as Logger } from './logger-CABQOnlR.js';
 import { B as BandLinkRestApi, b as RestRequestOptions, P as PaginatedResponse, e as AgentToolsRestApi } from './types-BivGO7I9.js';
 import { P as PaginationOptions } from './pagination-BgEx-HeL.js';
 import { W as WebSocketConflictPolicy, b as WebSocketDisconnectReason } from './disconnectReason-IuADl6TH.js';
-import { RetryTracker } from '@band-ai/band-sdk-core';
+import { RetryTracker, RoomRoster } from '@band-ai/band-sdk-core';
 
 interface TopicHandlers {
     [event: string]: (payload: Record<string, unknown>) => Promise<void> | void;
@@ -93,6 +93,7 @@ interface ExecutionContextOptions {
     enableContextCache?: boolean;
     contextCacheTtlSeconds?: number;
     enableContextHydration?: boolean;
+    logger?: Logger;
 }
 declare class ExecutionContext {
     readonly roomId: string;
@@ -167,7 +168,7 @@ interface PlatformRuntimeOptions {
         description?: string | null;
     };
 }
-declare class PlatformRuntime {
+declare class PlatformRuntime implements AsyncDisposable {
     private readonly _agentId;
     private readonly _apiKey;
     private readonly _wsUrl?;
@@ -203,6 +204,7 @@ declare class PlatformRuntime {
     private doInitialize;
     start(adapter: FrameworkAdapter): Promise<void>;
     stop(timeoutMs?: number): Promise<boolean>;
+    [Symbol.asyncDispose](): Promise<void>;
     runForever(): Promise<void>;
     bootstrapRoomMessage(roomId: string, message: PlatformMessage): Promise<void>;
     resetRoomSession(roomId: string, timeoutMs?: number): Promise<boolean>;
@@ -210,6 +212,55 @@ declare class PlatformRuntime {
     private handleContactEvent;
 }
 
+interface RoomPresenceOptions {
+    link: BandLink;
+    roomFilter?: (room: MetadataMap) => boolean;
+    autoSubscribeExistingRooms?: boolean;
+    logger?: Logger;
+}
+type RoomPresenceJoinHandler = (roomId: string, payload: MetadataMap) => Promise<void>;
+type RoomPresenceLeaveHandler = (roomId: string) => Promise<void>;
+type RoomPresenceEventHandler = (roomId: string, event: MessageEvent | ParticipantAddedEvent | ParticipantRemovedEvent) => Promise<void>;
+type RoomPresenceContactHandler = (event: ContactEvent) => Promise<void>;
+declare class RoomPresence implements AsyncDisposable {
+    readonly roster: RoomRoster;
+    onRoomJoined: RoomPresenceJoinHandler | null;
+    onRoomLeft: RoomPresenceLeaveHandler | null;
+    onRoomEvent: RoomPresenceEventHandler | null;
+    onContactEvent: RoomPresenceContactHandler | null;
+    private readonly link;
+    private readonly roomFilter?;
+    private readonly autoSubscribeExistingRooms;
+    private readonly logger;
+    private eventController;
+    private eventTask;
+    private contactsSubscribed;
+    private lifecycle;
+    private readonly admissionInFlight;
+    private readonly lastSubscribeError;
+    constructor(options: RoomPresenceOptions);
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    [Symbol.asyncDispose](): Promise<void>;
+    abortEventLoop(): void;
+    waitUntilStopped(): Promise<void>;
+    admitRoom(roomId: string, payload: MetadataMap, notify?: boolean): Promise<boolean>;
+    /** Admit a room for a caller that needs to know *why* a failed subscribe happened, not just that it did. */
+    admitRoomOrThrow(roomId: string): Promise<void>;
+    private awaitInFlightAdmission;
+    private performAdmission;
+    private completeAdmission;
+    private serialize;
+    private startBody;
+    private subscribeContacts;
+    private stopBody;
+    private consumeEvents;
+    private handleRoomAdded;
+    private handleRoomRemoved;
+    private unsubscribeRoom;
+    private subscribeExistingRooms;
+}
+
 interface AgentRuntimeOptions {
     link: BandLink;
     agentId: string;
@@ -228,6 +279,7 @@ interface AgentRuntimeOptions {
     logger?: Logger;
 }
 declare class AgentRuntime {
+    readonly presence: RoomPresence;
     private readonly link;
     private readonly agentId;
     private readonly onExecute;
@@ -238,19 +290,14 @@ declare class AgentRuntime {
     private readonly onParticipantAdded?;
     private readonly onParticipantRemoved?;
     private readonly onError?;
-    private readonly roomFilter?;
     private readonly contextFactory?;
     private readonly sessionConfig;
-    private readonly autoSubscribeExistingRooms;
-    private readonly subscribedRooms;
     private readonly contexts;
     private readonly executions;
     private readonly executionWatchers;
     private readonly logger;
     private running;
     private stopping;
-    private stopController;
-    private consumeTask;
     private fatalError;
     constructor(options: AgentRuntimeOptions);
     start(): Promise<void>;
@@ -259,15 +306,12 @@ declare class AgentRuntime {
     getContext(roomId: string): ExecutionContext | undefined;
     waitUntilStopped(): Promise<void>;
     getContexts(): ExecutionContext[];
-    private consumeLoop;
-    private handleEvent;
     enqueueEvent(roomId: string, event: PlatformEvent): Promise<void>;
     bootstrapRoomMessage(roomId: string, message: PlatformMessage): Promise<void>;
     resetRoomSession(roomId: string, timeoutMs?: number): Promise<boolean>;
+    private teardownExecution;
     private getOrCreateExecution;
     getOrCreateContext(roomId: string): ExecutionContext;
-    private subscribeExistingRooms;
-    private leaveTrackedRoom;
     private failRuntime;
     private notifyOnError;
 }
@@ -584,4 +628,4 @@ declare const MCP_SERVER_NAME = "band";
 declare function mcpToolNames(names: Set<string>): string[];
 declare function getToolDescription(name: string): string;
 
-export { AgentRuntime as A, BandLink as B, CHAT_TOOL_NAMES as C, DefaultPreprocessor as D, type ExecutionContextOptions as E, MCP_SERVER_NAME as M, PlatformRuntime as P, TOOL_MODELS as T, type PlatformRuntimeOptions as a, MCP_TOOL_PREFIX as b, ExecutionContext as c, deriveDefaultRestUrl as d, ALL_TOOL_NAMES as e, BASE_TOOL_NAMES as f, CONTACT_TOOL_NAMES as g, type ExecutionState as h, MEMORY_TOOL_NAMES as i, getToolDescription as j, mcpToolNames as m };
+export { AgentRuntime as A, BandLink as B, CHAT_TOOL_NAMES as C, DefaultPreprocessor as D, type ExecutionContextOptions as E, MCP_SERVER_NAME as M, PlatformRuntime as P, RoomPresence as R, TOOL_MODELS as T, type PlatformRuntimeOptions as a, MCP_TOOL_PREFIX as b, ExecutionContext as c, deriveDefaultRestUrl as d, ALL_TOOL_NAMES as e, BASE_TOOL_NAMES as f, CONTACT_TOOL_NAMES as g, type ExecutionState as h, MEMORY_TOOL_NAMES as i, getToolDescription as j, mcpToolNames as m };