@band-ai/sdk 0.1.4 → 0.1.10

package/dist/{chunk-RHVH2GZR.js → chunk-J3M3PFFY.js}

@@ -1,32 +1,32 @@
 import {
   createThenvoiMcpBackend
-} from "./chunk-MSL6CWHY.js";
+} from "./chunk-2BHHR6YW.js";
 import {
   buildRoomScopedRegistrations,
   buildZodShape,
   errorResult,
   successResult
-} from "./chunk-EDPKUUJL.js";
+} from "./chunk-6RXWL6TC.js";
 import {
   GoogleADKHistoryConverter,
   LazyAsyncValue,
   OpencodeHistoryConverter,
   extractClaudeSessionId,
   findLatestTaskMetadata
-} from "./chunk-W5NDZSYE.js";
+} from "./chunk-XA4N2JPH.js";
 import {
   SimpleAdapter
 } from "./chunk-AVVDPXP4.js";
 import {
   formatHistoryForLlm,
   formatMessageForLlm
-} from "./chunk-INA6YZTZ.js";
-import {
-  mcpToolNames
-} from "./chunk-GVEQ3RAH.js";
+} from "./chunk-RDM4TE4B.js";
 import {
   renderSystemPrompt
-} from "./chunk-SFVKOEQH.js";
+} from "./chunk-DNPVCR3S.js";
+import {
+  mcpToolNames
+} from "./chunk-MLROFDKR.js";
 import {
   asErrorMessage,
   asNonEmptyString,
@@ -750,7 +750,8 @@ var CodexAdapter = class extends SimpleAdapter {
       agentName: this.agentName,
       agentDescription: this.agentDescription,
       customSection,
-      includeBaseInstructions: this.baseConfig.includeBaseInstructions ?? true
+      includeBaseInstructions: this.baseConfig.includeBaseInstructions ?? true,
+      capabilities: { memory: this.includeMemoryTools }
     }).trim();
     this.systemPrompt = prompt.length > 0 ? prompt : null;
   }
@@ -2630,7 +2631,8 @@ var GoogleADKAdapter = class extends SimpleAdapter {
     this.systemPrompt = this.systemPromptOverride ?? renderSystemPrompt({
       agentName,
       agentDescription,
-      customSection: this.customSection
+      customSection: this.customSection,
+      capabilities: { memory: this.enableMemoryTools }
     });
   }
   async onMessage(message, tools, history, participantsMessage, contactsMessage, context) {
@@ -2869,7 +2871,8 @@ var LangGraphAdapter = class extends SimpleAdapter {
     this.renderedSystemPrompt = this.systemPromptOverride ?? renderSystemPrompt({
       agentName,
       agentDescription,
-      customSection: this.customSection
+      customSection: this.customSection,
+      capabilities: { memory: this.includeMemoryTools }
     });
   }
   async onMessage(message, tools, history, participantsMessage, contactsMessage, context) {
@@ -2888,14 +2891,17 @@ var LangGraphAdapter = class extends SimpleAdapter {
       ];
     }
     const graph = await this.resolveGraph(sdk, langGraphTools);
-    const messages = this.buildMessages(
-      history,
-      message,
-      participantsMessage,
-      contactsMessage,
-      context.isSessionBootstrap,
-      context.roomId
-    );
+    const usesCheckpointer = Boolean(this.checkpointer);
+    const isFirstBootstrap = context.isSessionBootstrap && !this.bootstrappedRooms.has(context.roomId);
+    const replayHistory = !usesCheckpointer || isFirstBootstrap;
+    const includeSystemPrompt = this.usesCustomGraph && (!usesCheckpointer || isFirstBootstrap);
+    if (context.isSessionBootstrap) {
+      this.bootstrappedRooms.add(context.roomId);
+    }
+    const messages = this.buildMessages(history, message, participantsMessage, contactsMessage, {
+      replayHistory,
+      includeSystemPrompt
+    });
     const input = { messages };
     const graphConfig = {
       configurable: {
@@ -2922,6 +2928,10 @@ var LangGraphAdapter = class extends SimpleAdapter {
   async onCleanup(roomId) {
     this.bootstrappedRooms.delete(roomId);
   }
+  /** A caller-supplied graph rather than the built-in createReactAgent. */
+  get usesCustomGraph() {
+    return Boolean(this.graph || this.graphFactory);
+  }
   resolveGraph(sdk, langGraphTools) {
     if (this.graphFactory) {
       return Promise.resolve(this.graphFactory(langGraphTools));
@@ -2942,14 +2952,13 @@ var LangGraphAdapter = class extends SimpleAdapter {
       prompt: this.renderedSystemPrompt
     }));
   }
-  buildMessages(history, message, participantsMessage, contactsMessage, isSessionBootstrap, roomId) {
+  buildMessages(history, message, participantsMessage, contactsMessage, options) {
     const messages = [];
-    if (isSessionBootstrap && !this.bootstrappedRooms.has(roomId)) {
+    if (options.includeSystemPrompt) {
       messages.push(["system", this.renderedSystemPrompt]);
-      this.bootstrappedRooms.add(roomId);
     }
-    if (isSessionBootstrap && history.length > 0) {
-      const historical = history.raw.slice(-this.maxHistoryMessages);
+    if (options.replayHistory && history.length > 0) {
+      const historical = history.raw.filter((item) => item.id !== message.id).slice(-this.maxHistoryMessages);
       for (const item of historical) {
         const role = String(item.sender_type ?? "") === "Agent" ? "assistant" : "user";
         const content = String(item.content ?? "");
@@ -2968,7 +2977,7 @@ var LangGraphAdapter = class extends SimpleAdapter {
     return messages;
   }
   async forwardStreamEvents(graph, input, config, tools) {
-    const stream = graph.streamEvents?.(input, config, { version: "v2" });
+    const stream = graph.streamEvents?.(input, { ...config, version: "v2" });
     if (!stream) {
       return null;
     }
@@ -2995,6 +3004,10 @@ var LangGraphAdapter = class extends SimpleAdapter {
         );
       }
       if (eventType === "on_chain_end") {
+        const chainName = String(data.name ?? "");
+        if (!this.usesCustomGraph && chainName !== "LangGraph" && chainName !== "agent") {
+          continue;
+        }
         const output = asOptionalRecord(data.data) ?? {};
         const text = extractAssistantText(output.output);
         if (text) {
@@ -3056,18 +3069,25 @@ function stringifyToolResult2(value, logger, toolName) {
   });
 }
 function extractAssistantText(result) {
-  if (typeof result === "string" && result.trim().length > 0) {
-    return result.trim();
+  if (typeof result === "string") {
+    const trimmed = result.trim();
+    return trimmed.length > 0 && !isInternalLangGraphMarker(trimmed) ? trimmed : null;
   }
   const record = asOptionalRecord(result) ?? {};
+  if (isLangChainAssistantMessage(record)) {
+    const text = asLangChainMessageContent(record);
+    if (text && !isInternalLangGraphMarker(text)) {
+      return text;
+    }
+  }
   const directContent = asMessageContent(record.content);
-  if (directContent) {
+  if (directContent && !isInternalLangGraphMarker(directContent)) {
     return directContent;
   }
   const messages = Array.isArray(record.messages) ? record.messages : [];
   for (let index = messages.length - 1; index >= 0; index -= 1) {
     const text = asMessageText(messages[index]);
-    if (text) {
+    if (text && !isInternalLangGraphMarker(text)) {
       return text;
     }
   }
@@ -3084,12 +3104,40 @@ function asMessageText(value) {
   if (!record) {
     return null;
   }
+  if (isLangChainAssistantMessage(record)) {
+    return asLangChainMessageContent(record);
+  }
   const role = String(record.role ?? "");
   if (role !== "assistant") {
     return null;
   }
   return asMessageContent(record.content);
 }
+function isLangChainAssistantMessage(record) {
+  const id = record.id;
+  if (Array.isArray(id)) {
+    const typeName = String(id[id.length - 1] ?? "");
+    if (typeName === "AIMessage" || typeName === "AIMessageChunk") {
+      return true;
+    }
+  }
+  const getType = record.getType;
+  if (typeof getType === "function") {
+    try {
+      return getType.call(record) === "ai";
+    } catch {
+      return false;
+    }
+  }
+  return false;
+}
+function asLangChainMessageContent(record) {
+  const kwargs = asOptionalRecord(record.kwargs);
+  return asMessageContent(kwargs?.content ?? record.content);
+}
+function isInternalLangGraphMarker(text) {
+  return text === "__end__" || text === "__start__";
+}
 function asMessageContent(value) {
   if (typeof value === "string" && value.trim().length > 0) {
     return value.trim();
@@ -4244,7 +4292,8 @@ var OpencodeAdapter = class extends SimpleAdapter {
       agentName,
       agentDescription,
       customSection: this.config.customSection,
-      includeBaseInstructions: this.config.includeBaseInstructions
+      includeBaseInstructions: this.config.includeBaseInstructions,
+      capabilities: { memory: this.config.enableMemoryTools }
     }).trim();
     this.systemPrompt = `${systemPrompt}
 
@@ -5095,7 +5144,8 @@ var ClaudeSDKAdapter = class extends SimpleAdapter {
       agentName,
       agentDescription,
       customSection: this.customSection,
-      includeBaseInstructions: this.includeBaseInstructions
+      includeBaseInstructions: this.includeBaseInstructions,
+      capabilities: { memory: this.enableMemoryTools }
     });
     if (this.enableMcpTools) {
       const createThenvoiMcpBridge = await thenvoiMcpBridgeFactory.get();

package/dist/{chunk-GVEQ3RAH.js → chunk-MLROFDKR.js}

@@ -16,6 +16,108 @@ function assertChatEventType(value) {
   }
 }
 
+// src/contracts/memory.ts
+var SENSORY_MEMORY_TYPES = [
+  "iconic",
+  // Visual input
+  "echoic",
+  // Auditory input
+  "haptic"
+  // Tactile input
+];
+var COGNITIVE_MEMORY_TYPES = [
+  "episodic",
+  // Events that occurred
+  "semantic",
+  // Facts, preferences, learned knowledge
+  "procedural"
+  // How to perform tasks
+];
+function namedValues(values) {
+  return Object.fromEntries(values.map((value) => [value, value]));
+}
+var MEMORY_SYSTEM_TYPES = {
+  sensory: SENSORY_MEMORY_TYPES,
+  // Brief sensory inputs
+  working: COGNITIVE_MEMORY_TYPES,
+  // Short-term session context
+  long_term: COGNITIVE_MEMORY_TYPES
+  // Persistent cross-conversation memory
+};
+var MEMORY_SYSTEMS = Object.keys(MEMORY_SYSTEM_TYPES);
+var MEMORY_TYPES = [
+  ...SENSORY_MEMORY_TYPES,
+  ...COGNITIVE_MEMORY_TYPES
+];
+var MEMORY_SEGMENTS = [
+  "user",
+  // User preferences or profile info
+  "agent",
+  // Facts or events about agents/entities
+  "tool",
+  // Tool usage or task procedures
+  "guideline"
+  // Behavioral rules or policies
+];
+var MEMORY_STORE_SCOPES = [
+  "subject",
+  // About one person/agent; requires subject_id
+  "organization"
+  // Shared org-wide
+];
+var MEMORY_LIST_SCOPES = [
+  "subject",
+  // Subject-scoped memories only
+  "organization",
+  // Organization-scoped memories only
+  "all"
+  // Both scopes (no scope filter)
+];
+var MEMORY_STATUSES = [
+  "active",
+  // Normal, visible memories
+  "superseded",
+  // Outdated; soft-deleted via thenvoi_supersede_memory
+  "archived",
+  // Hidden but preserved via thenvoi_archive_memory
+  "all"
+  // Any status (no filter)
+];
+var MEMORY_SYSTEM = namedValues(MEMORY_SYSTEMS);
+var MEMORY_TYPE = namedValues(MEMORY_TYPES);
+var MEMORY_SEGMENT = namedValues(MEMORY_SEGMENTS);
+var MEMORY_STORE_SCOPE = namedValues(MEMORY_STORE_SCOPES);
+function isMemorySystem(value) {
+  return MEMORY_SYSTEMS.includes(value);
+}
+function isMemoryType(value) {
+  return MEMORY_TYPES.includes(value);
+}
+function isMemoryTypeForSystem(system, type) {
+  return MEMORY_SYSTEM_TYPES[system].includes(type);
+}
+function isMemorySegment(value) {
+  return MEMORY_SEGMENTS.includes(value);
+}
+function isMemoryStoreScope(value) {
+  return MEMORY_STORE_SCOPES.includes(value);
+}
+function isMemoryListScope(value) {
+  return MEMORY_LIST_SCOPES.includes(value);
+}
+function isMemoryStatus(value) {
+  return MEMORY_STATUSES.includes(value);
+}
+function expectedList(values) {
+  return values.join(", ");
+}
+function expectedMemoryTypesForSystem(system) {
+  return expectedList(MEMORY_SYSTEM_TYPES[system]);
+}
+function memoryTypeForSystemError(system) {
+  return `type must be one of: ${expectedMemoryTypesForSystem(system)} for system "${system}"`;
+}
+
 // src/runtime/tools/schemas.ts
 var TOOL_MODELS = {
   thenvoi_send_message: {
@@ -203,29 +305,22 @@ var TOOL_MODELS = {
       },
       scope: {
         type: "string",
-        enum: ["subject", "organization", "all"],
+        enum: [...MEMORY_LIST_SCOPES],
         description: "Filter by scope."
       },
       system: {
         type: "string",
-        enum: ["sensory", "working", "long_term"],
+        enum: [...MEMORY_SYSTEMS],
         description: "Filter by memory system."
       },
       type: {
         type: "string",
-        enum: [
-          "iconic",
-          "echoic",
-          "haptic",
-          "episodic",
-          "semantic",
-          "procedural"
-        ],
+        enum: [...MEMORY_TYPES],
         description: "Filter by memory type."
       },
       segment: {
         type: "string",
-        enum: ["user", "agent", "tool", "guideline"],
+        enum: [...MEMORY_SEGMENTS],
         description: "Filter by segment."
       },
       content_query: {
@@ -240,7 +335,7 @@ var TOOL_MODELS = {
       },
       status: {
         type: "string",
-        enum: ["active", "superseded", "archived", "all"],
+        enum: [...MEMORY_STATUSES],
         description: "Filter by status."
       }
     },
@@ -255,24 +350,17 @@ var TOOL_MODELS = {
       },
       system: {
         type: "string",
-        enum: ["sensory", "working", "long_term"],
+        enum: [...MEMORY_SYSTEMS],
         description: "Memory system tier."
       },
       type: {
         type: "string",
-        enum: [
-          "iconic",
-          "echoic",
-          "haptic",
-          "episodic",
-          "semantic",
-          "procedural"
-        ],
+        enum: [...MEMORY_TYPES],
         description: "Memory type (must be valid for selected system)."
       },
       segment: {
         type: "string",
-        enum: ["user", "agent", "tool", "guideline"],
+        enum: [...MEMORY_SEGMENTS],
         description: "Logical segment."
       },
       thought: {
@@ -281,7 +369,7 @@ var TOOL_MODELS = {
       },
       scope: {
         type: "string",
-        enum: ["subject", "organization"],
+        enum: [...MEMORY_STORE_SCOPES],
         description: "Visibility scope."
       },
       subject_id: {
@@ -361,6 +449,27 @@ export {
   CHAT_MESSAGE_TYPES,
   isChatEventType,
   assertChatEventType,
+  MEMORY_SYSTEM_TYPES,
+  MEMORY_SYSTEMS,
+  MEMORY_TYPES,
+  MEMORY_SEGMENTS,
+  MEMORY_STORE_SCOPES,
+  MEMORY_LIST_SCOPES,
+  MEMORY_STATUSES,
+  MEMORY_SYSTEM,
+  MEMORY_TYPE,
+  MEMORY_SEGMENT,
+  MEMORY_STORE_SCOPE,
+  isMemorySystem,
+  isMemoryType,
+  isMemoryTypeForSystem,
+  isMemorySegment,
+  isMemoryStoreScope,
+  isMemoryListScope,
+  isMemoryStatus,
+  expectedList,
+  expectedMemoryTypesForSystem,
+  memoryTypeForSystemError,
   TOOL_MODELS,
   ALL_TOOL_NAMES,
   MEMORY_TOOL_NAMES,

package/dist/{chunk-INA6YZTZ.js → chunk-RDM4TE4B.js}

@@ -1,3 +1,26 @@
+// src/runtime/types.ts
+var HistoryProvider = class {
+  raw;
+  constructor(raw) {
+    this.raw = raw;
+  }
+  convert(converter) {
+    return converter.convert(this.raw);
+  }
+  get length() {
+    return this.raw.length;
+  }
+};
+var SYNTHETIC_SENDER_TYPE = "System";
+var SYNTHETIC_CONTACT_EVENTS_SENDER_ID = "contact-events";
+var SYNTHETIC_CONTACT_EVENTS_SENDER_NAME = "Contact Events";
+function ensureHandlePrefix(handle) {
+  if (!handle) {
+    return null;
+  }
+  return handle.startsWith("@") ? handle : `@${handle}`;
+}
+
 // src/runtime/formatters.ts
 function isMetadataMap(value) {
   return value !== null && typeof value === "object" && !Array.isArray(value);
@@ -11,7 +34,7 @@ function replaceUuidMentions(content, participants) {
     const participantId = participant.id;
     const handle = participant.handle;
     if (typeof participantId === "string" && typeof handle === "string") {
-      next = next.replaceAll(`@[[${participantId}]]`, `@${handle}`);
+      next = next.replaceAll(`@[[${participantId}]]`, ensureHandlePrefix(handle) ?? "");
     }
   }
   return next;
@@ -43,7 +66,9 @@ function buildParticipantsMessage(participants) {
     const participantType = String(participant.type ?? "Unknown");
     const participantName = String(participant.name ?? "Unknown");
     const participantHandle = String(participant.handle ?? "Unknown");
-    lines.push(`- @${participantHandle} \u2014 ${participantName} (${participantType})`);
+    lines.push(
+      `- ${ensureHandlePrefix(participantHandle) ?? ""} \u2014 ${participantName} (${participantType})`
+    );
   }
   lines.push("");
   lines.push(
@@ -52,37 +77,14 @@ function buildParticipantsMessage(participants) {
   return lines.join("\n");
 }
 
-// src/runtime/types.ts
-var HistoryProvider = class {
-  raw;
-  constructor(raw) {
-    this.raw = raw;
-  }
-  convert(converter) {
-    return converter.convert(this.raw);
-  }
-  get length() {
-    return this.raw.length;
-  }
-};
-var SYNTHETIC_SENDER_TYPE = "System";
-var SYNTHETIC_CONTACT_EVENTS_SENDER_ID = "contact-events";
-var SYNTHETIC_CONTACT_EVENTS_SENDER_NAME = "Contact Events";
-function ensureHandlePrefix(handle) {
-  if (!handle) {
-    return null;
-  }
-  return handle.startsWith("@") ? handle : `@${handle}`;
-}
-
 export {
-  replaceUuidMentions,
-  formatMessageForLlm,
-  formatHistoryForLlm,
-  buildParticipantsMessage,
   HistoryProvider,
   SYNTHETIC_SENDER_TYPE,
   SYNTHETIC_CONTACT_EVENTS_SENDER_ID,
   SYNTHETIC_CONTACT_EVENTS_SENDER_NAME,
-  ensureHandlePrefix
+  ensureHandlePrefix,
+  replaceUuidMentions,
+  formatMessageForLlm,
+  formatHistoryForLlm,
+  buildParticipantsMessage
 };

package/dist/chunk-US226AS4.js

@@ -0,0 +1,130 @@
+// src/platform/streaming/disconnectReason.ts
+import { z } from "zod";
+var UPGRADE_CODES = [
+  "invalid_on_conflict",
+  "connection_conflict",
+  "too_many_requests",
+  "tracking_failed"
+];
+var UPGRADE_REASONS = {
+  invalid_on_conflict: {
+    status: 400,
+    message: "Invalid websocket conflict policy.",
+    retryable: false
+  },
+  connection_conflict: {
+    status: 409,
+    message: "Websocket connection conflict.",
+    retryable: false
+  },
+  too_many_requests: {
+    status: 429,
+    message: "Too many websocket connection attempts.",
+    retryable: true
+  },
+  tracking_failed: {
+    status: 503,
+    message: "Websocket connection tracking failed.",
+    retryable: true
+  }
+};
+var upgradeErrorSchema = z.object({
+  status: z.number(),
+  body: z.preprocess(
+    (body) => {
+      if (typeof body !== "string") {
+        return body;
+      }
+      try {
+        return JSON.parse(body);
+      } catch {
+        return null;
+      }
+    },
+    z.object({
+      error: z.object({
+        code: z.enum(UPGRADE_CODES),
+        message: z.string().optional(),
+        retry_after: z.number().nullable().optional(),
+        request_id: z.string().nullable().optional()
+      })
+    })
+  ),
+  headers: z.record(z.unknown()).optional()
+});
+var WebSocketDisconnectError = class extends Error {
+  reason;
+  constructor(reason) {
+    super(reason.message);
+    this.name = "WebSocketDisconnectError";
+    this.reason = reason;
+  }
+};
+function parseSupersedeDisconnectReason(payload) {
+  if (typeof payload.reason !== "string" || typeof payload.message !== "string") {
+    return null;
+  }
+  return {
+    source: "agent_control",
+    code: payload.reason,
+    message: payload.message,
+    retryable: false,
+    retryAfter: typeof payload.retry_after === "number" ? payload.retry_after : null,
+    targetSocketId: typeof payload.target_socket_id === "string" ? payload.target_socket_id : null,
+    correlationId: typeof payload.correlation_id === "string" ? payload.correlation_id : null
+  };
+}
+function parseUpgradeDisconnectReason(event) {
+  const parsed = upgradeErrorSchema.safeParse(event);
+  if (!parsed.success) {
+    return null;
+  }
+  const { status, body, headers } = parsed.data;
+  const {
+    code,
+    message,
+    retry_after: retryAfter,
+    request_id: requestId
+  } = body.error;
+  const reason = UPGRADE_REASONS[code];
+  if (status !== reason.status) {
+    return null;
+  }
+  return {
+    source: "upgrade",
+    status: reason.status,
+    code,
+    message: message ?? reason.message,
+    retryable: reason.retryable,
+    retryAfter: retryAfter ?? retryAfterFromHeaders(headers),
+    requestId: requestId ?? null
+  };
+}
+function genericCloseReason(event) {
+  return {
+    source: "websocket_close",
+    code: "websocket.closed",
+    message: "Phoenix socket closed without a platform disconnect reason.",
+    retryable: true,
+    closeCode: typeof event?.code === "number" ? event.code : null,
+    closeReason: typeof event?.reason === "string" && event.reason.length > 0 ? event.reason : null
+  };
+}
+function retryAfterFromHeaders(headers) {
+  const value = headers?.["retry-after"] ?? headers?.["Retry-After"];
+  if (typeof value === "number") {
+    return value;
+  }
+  if (typeof value === "string" && value.trim() !== "") {
+    const seconds = Number(value);
+    return Number.isFinite(seconds) ? seconds : null;
+  }
+  return null;
+}
+
+export {
+  WebSocketDisconnectError,
+  parseSupersedeDisconnectReason,
+  parseUpgradeDisconnectReason,
+  genericCloseReason
+};

package/dist/{chunk-W5NDZSYE.js → chunk-XA4N2JPH.js}

@@ -3,7 +3,7 @@ import {
 } from "./chunk-AVVDPXP4.js";
 import {
   renderSystemPrompt
-} from "./chunk-SFVKOEQH.js";
+} from "./chunk-DNPVCR3S.js";
 import {
   asErrorMessage,
   asNonEmptyString,