@band-ai/sdk 0.1.6 → 0.2.0

package/dist/core.cjs

@@ -20,14 +20,15 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/core/index.ts
 var core_exports = {};
 __export(core_exports, {
+  BandSdkError: () => BandSdkError,
   ConsoleLogger: () => ConsoleLogger,
   NoopLogger: () => NoopLogger,
   RuntimeStateError: () => RuntimeStateError,
   SimpleAdapter: () => SimpleAdapter,
-  ThenvoiSdkError: () => ThenvoiSdkError,
   TransportError: () => TransportError,
   UnsupportedFeatureError: () => UnsupportedFeatureError,
-  ValidationError: () => ValidationError
+  ValidationError: () => ValidationError,
+  WebSocketDisconnectError: () => WebSocketDisconnectError
 });
 module.exports = __toCommonJS(core_exports);
 
@@ -68,37 +69,78 @@ var SimpleAdapter = class {
 };
 
 // src/core/errors.ts
-var ThenvoiSdkError = class extends Error {
+var BandSdkError = class extends Error {
   constructor(message, cause) {
     super(message, cause !== void 0 ? { cause } : void 0);
-    this.name = "ThenvoiSdkError";
+    this.name = "BandSdkError";
   }
 };
-var UnsupportedFeatureError = class extends ThenvoiSdkError {
+var UnsupportedFeatureError = class extends BandSdkError {
   constructor(message) {
     super(message);
     this.name = "UnsupportedFeatureError";
   }
 };
-var ValidationError = class extends ThenvoiSdkError {
+var ValidationError = class extends BandSdkError {
   constructor(message, cause) {
     super(message, cause);
     this.name = "ValidationError";
   }
 };
-var TransportError = class extends ThenvoiSdkError {
+var TransportError = class extends BandSdkError {
   constructor(message, cause) {
     super(message, cause);
     this.name = "TransportError";
   }
 };
-var RuntimeStateError = class extends ThenvoiSdkError {
+var RuntimeStateError = class extends BandSdkError {
   constructor(message) {
     super(message);
     this.name = "RuntimeStateError";
   }
 };
 
+// src/platform/streaming/disconnectReason.ts
+var import_zod = require("zod");
+var UPGRADE_CODES = [
+  "invalid_on_conflict",
+  "connection_conflict",
+  "too_many_requests",
+  "tracking_failed"
+];
+var upgradeErrorSchema = import_zod.z.object({
+  status: import_zod.z.number(),
+  body: import_zod.z.preprocess(
+    (body) => {
+      if (typeof body !== "string") {
+        return body;
+      }
+      try {
+        return JSON.parse(body);
+      } catch {
+        return null;
+      }
+    },
+    import_zod.z.object({
+      error: import_zod.z.object({
+        code: import_zod.z.enum(UPGRADE_CODES),
+        message: import_zod.z.string().optional(),
+        retry_after: import_zod.z.number().nullable().optional(),
+        request_id: import_zod.z.string().nullable().optional()
+      })
+    })
+  ),
+  headers: import_zod.z.record(import_zod.z.unknown()).optional()
+});
+var WebSocketDisconnectError = class extends Error {
+  reason;
+  constructor(reason) {
+    super(reason.message);
+    this.name = "WebSocketDisconnectError";
+    this.reason = reason;
+  }
+};
+
 // src/core/logger.ts
 var noop = () => void 0;
 var REDACTED_VALUE = "[REDACTED]";
@@ -174,12 +216,13 @@ function sanitizeValue(value, seen = /* @__PURE__ */ new WeakSet()) {
 }
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  BandSdkError,
   ConsoleLogger,
   NoopLogger,
   RuntimeStateError,
   SimpleAdapter,
-  ThenvoiSdkError,
   TransportError,
   UnsupportedFeatureError,
-  ValidationError
+  ValidationError,
+  WebSocketDisconnectError
 });

package/dist/core.d.cts

@@ -1,22 +1,23 @@
-export { S as SimpleAdapter } from './simpleAdapter-DqhvjsGr.cjs';
-export { A as AdapterToolsProtocol, a as AgentToolsProtocol, C as ContactTools, F as FrameworkAdapter, b as FrameworkAdapterInput, H as HistoryConverter, M as MemoryTools, c as MessagingTools, P as ParticipantTools, d as PeerLookupTools, e as Preprocessor, R as RoomParticipantTools, T as ToolExecutor, f as ToolSchemaProvider } from './protocols-CInhtFpA.cjs';
+export { S as SimpleAdapter } from './simpleAdapter-BpT4XbZC.cjs';
+export { A as AdapterToolsProtocol, a as AgentToolsProtocol, C as ContactTools, F as FrameworkAdapter, b as FrameworkAdapterInput, H as HistoryConverter, M as MemoryTools, c as MessagingTools, P as ParticipantTools, d as PeerLookupTools, e as Preprocessor, R as RoomParticipantTools, T as ToolExecutor, f as ToolSchemaProvider } from './protocols-Bz1rxcUg.cjs';
+export { W as WebSocketConflictPolicy, a as WebSocketDisconnectError, b as WebSocketDisconnectReason } from './disconnectReason-IuADl6TH.cjs';
 export { C as ConsoleLogger, L as Logger, N as NoopLogger } from './logger-CABQOnlR.cjs';
-import './dtos-DUpbIu8k.cjs';
+import './dtos-B8KU_q4d.cjs';
 
-declare class ThenvoiSdkError extends Error {
+declare class BandSdkError extends Error {
     constructor(message: string, cause?: unknown);
 }
-declare class UnsupportedFeatureError extends ThenvoiSdkError {
+declare class UnsupportedFeatureError extends BandSdkError {
     constructor(message: string);
 }
-declare class ValidationError extends ThenvoiSdkError {
+declare class ValidationError extends BandSdkError {
     constructor(message: string, cause?: unknown);
 }
-declare class TransportError extends ThenvoiSdkError {
+declare class TransportError extends BandSdkError {
     constructor(message: string, cause?: unknown);
 }
-declare class RuntimeStateError extends ThenvoiSdkError {
+declare class RuntimeStateError extends BandSdkError {
     constructor(message: string);
 }
 
-export { RuntimeStateError, ThenvoiSdkError, TransportError, UnsupportedFeatureError, ValidationError };
+export { BandSdkError, RuntimeStateError, TransportError, UnsupportedFeatureError, ValidationError };

package/dist/core.d.ts

@@ -1,22 +1,23 @@
-export { S as SimpleAdapter } from './simpleAdapter-9OE_p6QW.js';
-export { A as AdapterToolsProtocol, a as AgentToolsProtocol, C as ContactTools, F as FrameworkAdapter, b as FrameworkAdapterInput, H as HistoryConverter, M as MemoryTools, c as MessagingTools, P as ParticipantTools, d as PeerLookupTools, e as Preprocessor, R as RoomParticipantTools, T as ToolExecutor, f as ToolSchemaProvider } from './protocols-DrhzOH6K.js';
+export { S as SimpleAdapter } from './simpleAdapter--wznuoOw.js';
+export { A as AdapterToolsProtocol, a as AgentToolsProtocol, C as ContactTools, F as FrameworkAdapter, b as FrameworkAdapterInput, H as HistoryConverter, M as MemoryTools, c as MessagingTools, P as ParticipantTools, d as PeerLookupTools, e as Preprocessor, R as RoomParticipantTools, T as ToolExecutor, f as ToolSchemaProvider } from './protocols-Bwwcql0h.js';
+export { W as WebSocketConflictPolicy, a as WebSocketDisconnectError, b as WebSocketDisconnectReason } from './disconnectReason-IuADl6TH.js';
 export { C as ConsoleLogger, L as Logger, N as NoopLogger } from './logger-CABQOnlR.js';
-import './dtos-DUpbIu8k.js';
+import './dtos-B8KU_q4d.js';
 
-declare class ThenvoiSdkError extends Error {
+declare class BandSdkError extends Error {
     constructor(message: string, cause?: unknown);
 }
-declare class UnsupportedFeatureError extends ThenvoiSdkError {
+declare class UnsupportedFeatureError extends BandSdkError {
     constructor(message: string);
 }
-declare class ValidationError extends ThenvoiSdkError {
+declare class ValidationError extends BandSdkError {
     constructor(message: string, cause?: unknown);
 }
-declare class TransportError extends ThenvoiSdkError {
+declare class TransportError extends BandSdkError {
     constructor(message: string, cause?: unknown);
 }
-declare class RuntimeStateError extends ThenvoiSdkError {
+declare class RuntimeStateError extends BandSdkError {
     constructor(message: string);
 }
 
-export { RuntimeStateError, ThenvoiSdkError, TransportError, UnsupportedFeatureError, ValidationError };
+export { BandSdkError, RuntimeStateError, TransportError, UnsupportedFeatureError, ValidationError };

package/dist/core.js

@@ -1,24 +1,28 @@
 import {
   SimpleAdapter
 } from "./chunk-AVVDPXP4.js";
+import {
+  WebSocketDisconnectError
+} from "./chunk-US226AS4.js";
 import {
   ConsoleLogger,
   NoopLogger
 } from "./chunk-OD2G5LFQ.js";
 import {
+  BandSdkError,
   RuntimeStateError,
-  ThenvoiSdkError,
   TransportError,
   UnsupportedFeatureError,
   ValidationError
-} from "./chunk-YR3BOQNW.js";
+} from "./chunk-JY75VSQK.js";
 export {
+  BandSdkError,
   ConsoleLogger,
   NoopLogger,
   RuntimeStateError,
   SimpleAdapter,
-  ThenvoiSdkError,
   TransportError,
   UnsupportedFeatureError,
-  ValidationError
+  ValidationError,
+  WebSocketDisconnectError
 };

package/dist/disconnectReason-IuADl6TH.d.cts

@@ -0,0 +1,34 @@
+type WebSocketConflictPolicy = "supersede" | "reject";
+interface AgentControlSupersedeDisconnectReason {
+    source: "agent_control";
+    code: string;
+    message: string;
+    retryable: false;
+    retryAfter: number | null;
+    targetSocketId: string | null;
+    correlationId: string | null;
+}
+interface WebSocketUpgradeDisconnectReason {
+    source: "upgrade";
+    status: 400 | 409 | 429 | 503;
+    code: "invalid_on_conflict" | "connection_conflict" | "too_many_requests" | "tracking_failed";
+    message: string;
+    retryable: boolean;
+    retryAfter: number | null;
+    requestId: string | null;
+}
+interface GenericWebSocketCloseReason {
+    source: "websocket_close";
+    code: "websocket.closed";
+    message: string;
+    retryable: boolean;
+    closeCode: number | null;
+    closeReason: string | null;
+}
+type WebSocketDisconnectReason = AgentControlSupersedeDisconnectReason | WebSocketUpgradeDisconnectReason | GenericWebSocketCloseReason;
+declare class WebSocketDisconnectError extends Error {
+    readonly reason: WebSocketDisconnectReason;
+    constructor(reason: WebSocketDisconnectReason);
+}
+
+export { type WebSocketConflictPolicy as W, WebSocketDisconnectError as a, type WebSocketDisconnectReason as b };

package/dist/disconnectReason-IuADl6TH.d.ts

@@ -0,0 +1,34 @@
+type WebSocketConflictPolicy = "supersede" | "reject";
+interface AgentControlSupersedeDisconnectReason {
+    source: "agent_control";
+    code: string;
+    message: string;
+    retryable: false;
+    retryAfter: number | null;
+    targetSocketId: string | null;
+    correlationId: string | null;
+}
+interface WebSocketUpgradeDisconnectReason {
+    source: "upgrade";
+    status: 400 | 409 | 429 | 503;
+    code: "invalid_on_conflict" | "connection_conflict" | "too_many_requests" | "tracking_failed";
+    message: string;
+    retryable: boolean;
+    retryAfter: number | null;
+    requestId: string | null;
+}
+interface GenericWebSocketCloseReason {
+    source: "websocket_close";
+    code: "websocket.closed";
+    message: string;
+    retryable: boolean;
+    closeCode: number | null;
+    closeReason: string | null;
+}
+type WebSocketDisconnectReason = AgentControlSupersedeDisconnectReason | WebSocketUpgradeDisconnectReason | GenericWebSocketCloseReason;
+declare class WebSocketDisconnectError extends Error {
+    readonly reason: WebSocketDisconnectReason;
+    constructor(reason: WebSocketDisconnectReason);
+}
+
+export { type WebSocketConflictPolicy as W, WebSocketDisconnectError as a, type WebSocketDisconnectReason as b };

package/dist/{dtos-DUpbIu8k.d.ts → dtos-B8KU_q4d.d.cts}

@@ -1,3 +1,28 @@
+/** Canonical memory enums; DTOs, tool schemas, and validation derive from these constants. */
+/** Which memory types are valid for each memory tier. */
+declare const MEMORY_SYSTEM_TYPES: {
+    readonly sensory: readonly ["iconic", "echoic", "haptic"];
+    readonly working: readonly ["episodic", "semantic", "procedural"];
+    readonly long_term: readonly ["episodic", "semantic", "procedural"];
+};
+type MemorySystem = keyof typeof MEMORY_SYSTEM_TYPES;
+type MemoryType = (typeof MEMORY_SYSTEM_TYPES)[MemorySystem][number];
+/** Logical subject category (user/agent/tool/guideline); not scope `subject` or `subject_id`. */
+declare const MEMORY_SEGMENTS: readonly ["user", "agent", "tool", "guideline"];
+/** Visibility scope for `band_store_memory`. */
+declare const MEMORY_STORE_SCOPES: readonly ["subject", "organization"];
+/** Scope filter for `band_list_memories`. */
+declare const MEMORY_LIST_SCOPES: readonly ["subject", "organization", "all"];
+/** Lifecycle state; list filter and set by supersede/archive tools. */
+declare const MEMORY_STATUSES: readonly ["active", "superseded", "archived", "all"];
+/** Logical subject category (user/agent/tool/guideline); not scope `subject` or `subject_id`. */
+type MemorySegment = (typeof MEMORY_SEGMENTS)[number];
+type MemoryStoreScope = (typeof MEMORY_STORE_SCOPES)[number];
+type MemoryScope = (typeof MEMORY_LIST_SCOPES)[number];
+type MemoryStatus = (typeof MEMORY_STATUSES)[number];
+/** Alias for {@link MemoryStoreScope} on store/write DTOs. */
+type MemoryVisibility = MemoryStoreScope;
+
 interface MetadataMap {
     [key: string]: unknown;
 }
@@ -98,12 +123,7 @@ type RespondContactRequestArgs = {
     target: "requestId";
     requestId: string;
 };
-type MemoryScope = "subject" | "organization" | "all";
-type MemoryVisibility = Exclude<MemoryScope, "all">;
-type MemorySystem = "sensory" | "working" | "long_term";
-type MemoryType = "iconic" | "echoic" | "haptic" | "episodic" | "semantic" | "procedural";
-type MemorySegment = "user" | "agent" | "tool" | "guideline";
-type MemoryStatus = "active" | "superseded" | "archived" | "all";
+
 interface WireListMemoriesArgs {
     subject_id?: string;
     scope?: MemoryScope;

package/dist/{dtos-DUpbIu8k.d.cts → dtos-B8KU_q4d.d.ts}

@@ -1,3 +1,28 @@
+/** Canonical memory enums; DTOs, tool schemas, and validation derive from these constants. */
+/** Which memory types are valid for each memory tier. */
+declare const MEMORY_SYSTEM_TYPES: {
+    readonly sensory: readonly ["iconic", "echoic", "haptic"];
+    readonly working: readonly ["episodic", "semantic", "procedural"];
+    readonly long_term: readonly ["episodic", "semantic", "procedural"];
+};
+type MemorySystem = keyof typeof MEMORY_SYSTEM_TYPES;
+type MemoryType = (typeof MEMORY_SYSTEM_TYPES)[MemorySystem][number];
+/** Logical subject category (user/agent/tool/guideline); not scope `subject` or `subject_id`. */
+declare const MEMORY_SEGMENTS: readonly ["user", "agent", "tool", "guideline"];
+/** Visibility scope for `band_store_memory`. */
+declare const MEMORY_STORE_SCOPES: readonly ["subject", "organization"];
+/** Scope filter for `band_list_memories`. */
+declare const MEMORY_LIST_SCOPES: readonly ["subject", "organization", "all"];
+/** Lifecycle state; list filter and set by supersede/archive tools. */
+declare const MEMORY_STATUSES: readonly ["active", "superseded", "archived", "all"];
+/** Logical subject category (user/agent/tool/guideline); not scope `subject` or `subject_id`. */
+type MemorySegment = (typeof MEMORY_SEGMENTS)[number];
+type MemoryStoreScope = (typeof MEMORY_STORE_SCOPES)[number];
+type MemoryScope = (typeof MEMORY_LIST_SCOPES)[number];
+type MemoryStatus = (typeof MEMORY_STATUSES)[number];
+/** Alias for {@link MemoryStoreScope} on store/write DTOs. */
+type MemoryVisibility = MemoryStoreScope;
+
 interface MetadataMap {
     [key: string]: unknown;
 }
@@ -98,12 +123,7 @@ type RespondContactRequestArgs = {
     target: "requestId";
     requestId: string;
 };
-type MemoryScope = "subject" | "organization" | "all";
-type MemoryVisibility = Exclude<MemoryScope, "all">;
-type MemorySystem = "sensory" | "working" | "long_term";
-type MemoryType = "iconic" | "echoic" | "haptic" | "episodic" | "semantic" | "procedural";
-type MemorySegment = "user" | "agent" | "tool" | "guideline";
-type MemoryStatus = "active" | "superseded" | "archived" | "all";
+
 interface WireListMemoriesArgs {
     subject_id?: string;
     scope?: MemoryScope;