@estuary-ai/sdk 0.1.21 → 0.1.22

package/dist/index.d.mts

@@ -13,7 +13,7 @@ interface EstuaryConfig {
     autoReconnect?: boolean;
     /** Max reconnect attempts (default: 5) */
     maxReconnectAttempts?: number;
-    /** Delay between reconnect attempts in ms (default: 2000) */
+    /** Base delay between reconnect attempts in ms (default: 2000). Actual delay is baseDelay × attemptNumber (linear backoff). */
     reconnectDelayMs?: number;
     /** Enable debug logging (default: false) */
     debug?: boolean;
@@ -82,14 +82,23 @@ interface CameraCaptureRequest {
 }
 interface MemoryData {
     id: string;
+    userId: string;
+    agentId: string;
+    playerId: string;
     content: string;
     memoryType: string;
     confidence: number;
     status: string;
     sourceConversationId: string;
     sourceQuote?: string;
+    source?: string;
     topic?: string;
-    createdAt: string;
+    secondaryTopics?: string[];
+    lastAccessedAt?: string | null;
+    accessCount?: number;
+    extractedAt?: string | null;
+    createdAt?: string | null;
+    updatedAt?: string | null;
 }
 interface MemoryUpdatedEvent {
     agentId: string;
@@ -162,7 +171,7 @@ interface MemorySearchOptions {
     limit?: number;
 }
 interface MemoryListResponse {
-    memories: Record<string, unknown>[];
+    memories: MemoryData[];
     total: number;
     limit: number;
     offset: number;
@@ -170,36 +179,93 @@ interface MemoryListResponse {
 interface MemoryTimelineResponse {
     timeline: {
         date: string;
-        memories: Record<string, unknown>[];
+        memories: MemoryData[];
     }[];
     totalMemories: number;
     groupBy: string;
 }
 interface MemoryStatsResponse {
-    [key: string]: unknown;
+    totalActive: number;
+    totalSuperseded: number;
+    totalDecayed: number;
+    byType: Record<string, number>;
+    coreFacts: number;
+}
+interface MemoryGraphNode {
+    id: string;
+    type: 'user' | 'cluster' | 'memory' | 'entity';
+    label?: string;
+    /** Cluster fields */
+    level?: number;
+    memoryCount?: number;
+    typeDistribution?: Record<string, number>;
+    expanded?: boolean;
+    parentClusterId?: string | null;
+    childClusterIds?: string[];
+    labelPending?: boolean;
+    /** Memory fields */
+    memoryType?: string;
+    content?: string;
+    confidence?: number;
+    clusterId?: string;
+    sourceQuote?: string | null;
+    sourceConversationId?: string | null;
+    createdAt?: string | null;
+    accessCount?: number;
+    /** Entity fields */
+    entityType?: string | null;
+    name?: string;
+    mentionCount?: number;
+    extraData?: Record<string, string>;
+}
+interface MemoryGraphEdge {
+    source: string;
+    target: string;
+    type: 'has_cluster' | 'contains' | 'mentions' | 'relationship';
+    relationshipType?: string;
+    label?: string | null;
+    confidence?: number;
 }
 interface MemoryGraphResponse {
-    nodes: Record<string, unknown>[];
-    edges: Record<string, unknown>[];
-    stats: Record<string, unknown>;
+    nodes: MemoryGraphNode[];
+    edges: MemoryGraphEdge[];
+    stats: {
+        totalMemories: number;
+        totalEntities: number;
+        clusterCount: number;
+        clusters: Record<string, number>;
+    };
+    stale?: boolean;
 }
 interface MemorySearchResponse {
     results: {
-        memory: Record<string, unknown>;
+        memory: MemoryData;
         score: number;
         similarityScore: number;
     }[];
     query: string;
     total: number;
 }
+interface CoreFact {
+    id: string;
+    userId: string;
+    agentId: string;
+    playerId: string;
+    factKey: string;
+    factValue: string;
+    sourceMemoryId?: string | null;
+    createdAt?: string | null;
+    updatedAt?: string | null;
+}
 interface CoreFactsResponse {
-    coreFacts: Record<string, unknown>[];
+    coreFacts: CoreFact[];
 }
 
 declare class RestClient {
     private baseUrl;
     private apiKey;
-    constructor(baseUrl: string, apiKey: string);
+    private timeoutMs;
+    constructor(baseUrl: string, apiKey: string, timeoutMs?: number);
     get<T>(path: string, params?: Record<string, string | number | boolean | undefined>): Promise<T>;
     post<T>(path: string, body?: unknown): Promise<T>;
     delete<T>(path: string, params?: Record<string, string | number | boolean | undefined>): Promise<T>;
@@ -259,8 +325,8 @@ declare class EstuaryClient extends TypedEventEmitter<EstuaryEventMap> {
     /** Connect to the Estuary server and authenticate */
     connect(): Promise<SessionInfo>;
     /** Disconnect from the server */
-    disconnect(): void;
-    /** Send a text message to the character */
+    disconnect(): Promise<void>;
+    /** Send a text message to the character. Defaults to textOnly=true (no TTS audio response). Pass textOnly=false to receive voice audio. */
     sendText(text: string, textOnly?: boolean): void;
     /** Interrupt the current bot response */
     interrupt(messageId?: string): void;
@@ -275,7 +341,7 @@ declare class EstuaryClient extends TypedEventEmitter<EstuaryEventMap> {
     /** Start voice input (requests microphone permission) */
     startVoice(): Promise<void>;
     /** Stop voice input */
-    stopVoice(): void;
+    stopVoice(): Promise<void>;
     /** Toggle microphone mute */
     toggleMute(): void;
     /** Whether the microphone is muted */
@@ -328,4 +394,4 @@ declare function parseActions(text: string): {
     cleanText: string;
 };
 
-export { type BotResponse, type BotVoice, type CameraCaptureRequest, type CharacterAction, ConnectionState, type CoreFactsResponse, ErrorCode, EstuaryClient, type EstuaryConfig, EstuaryError, type EstuaryEventMap, type InterruptData, type LiveKitTokenResponse, MemoryClient, type MemoryData, type MemoryGraphOptions, type MemoryGraphResponse, type MemoryListOptions, type MemoryListResponse, type MemorySearchOptions, type MemorySearchResponse, type MemoryStatsResponse, type MemoryTimelineOptions, type MemoryTimelineResponse, type MemoryUpdatedEvent, type ParsedAction, type QuotaExceededData, type SessionInfo, type SttResponse, type VoiceManager, type VoiceTransport, parseActions };
+export { type BotResponse, type BotVoice, type CameraCaptureRequest, type CharacterAction, ConnectionState, type CoreFact, type CoreFactsResponse, ErrorCode, EstuaryClient, type EstuaryConfig, EstuaryError, type EstuaryEventMap, type InterruptData, type LiveKitTokenResponse, MemoryClient, type MemoryData, type MemoryGraphEdge, type MemoryGraphNode, type MemoryGraphOptions, type MemoryGraphResponse, type MemoryListOptions, type MemoryListResponse, type MemorySearchOptions, type MemorySearchResponse, type MemoryStatsResponse, type MemoryTimelineOptions, type MemoryTimelineResponse, type MemoryUpdatedEvent, type ParsedAction, type QuotaExceededData, type SessionInfo, type SttResponse, type VoiceManager, type VoiceTransport, parseActions };

package/dist/index.d.ts

@@ -13,7 +13,7 @@ interface EstuaryConfig {
     autoReconnect?: boolean;
     /** Max reconnect attempts (default: 5) */
     maxReconnectAttempts?: number;
-    /** Delay between reconnect attempts in ms (default: 2000) */
+    /** Base delay between reconnect attempts in ms (default: 2000). Actual delay is baseDelay × attemptNumber (linear backoff). */
     reconnectDelayMs?: number;
     /** Enable debug logging (default: false) */
     debug?: boolean;
@@ -82,14 +82,23 @@ interface CameraCaptureRequest {
 }
 interface MemoryData {
     id: string;
+    userId: string;
+    agentId: string;
+    playerId: string;
     content: string;
     memoryType: string;
     confidence: number;
     status: string;
     sourceConversationId: string;
     sourceQuote?: string;
+    source?: string;
     topic?: string;
-    createdAt: string;
+    secondaryTopics?: string[];
+    lastAccessedAt?: string | null;
+    accessCount?: number;
+    extractedAt?: string | null;
+    createdAt?: string | null;
+    updatedAt?: string | null;
 }
 interface MemoryUpdatedEvent {
     agentId: string;
@@ -162,7 +171,7 @@ interface MemorySearchOptions {
     limit?: number;
 }
 interface MemoryListResponse {
-    memories: Record<string, unknown>[];
+    memories: MemoryData[];
     total: number;
     limit: number;
     offset: number;
@@ -170,36 +179,93 @@ interface MemoryListResponse {
 interface MemoryTimelineResponse {
     timeline: {
         date: string;
-        memories: Record<string, unknown>[];
+        memories: MemoryData[];
     }[];
     totalMemories: number;
     groupBy: string;
 }
 interface MemoryStatsResponse {
-    [key: string]: unknown;
+    totalActive: number;
+    totalSuperseded: number;
+    totalDecayed: number;
+    byType: Record<string, number>;
+    coreFacts: number;
+}
+interface MemoryGraphNode {
+    id: string;
+    type: 'user' | 'cluster' | 'memory' | 'entity';
+    label?: string;
+    /** Cluster fields */
+    level?: number;
+    memoryCount?: number;
+    typeDistribution?: Record<string, number>;
+    expanded?: boolean;
+    parentClusterId?: string | null;
+    childClusterIds?: string[];
+    labelPending?: boolean;
+    /** Memory fields */
+    memoryType?: string;
+    content?: string;
+    confidence?: number;
+    clusterId?: string;
+    sourceQuote?: string | null;
+    sourceConversationId?: string | null;
+    createdAt?: string | null;
+    accessCount?: number;
+    /** Entity fields */
+    entityType?: string | null;
+    name?: string;
+    mentionCount?: number;
+    extraData?: Record<string, string>;
+}
+interface MemoryGraphEdge {
+    source: string;
+    target: string;
+    type: 'has_cluster' | 'contains' | 'mentions' | 'relationship';
+    relationshipType?: string;
+    label?: string | null;
+    confidence?: number;
 }
 interface MemoryGraphResponse {
-    nodes: Record<string, unknown>[];
-    edges: Record<string, unknown>[];
-    stats: Record<string, unknown>;
+    nodes: MemoryGraphNode[];
+    edges: MemoryGraphEdge[];
+    stats: {
+        totalMemories: number;
+        totalEntities: number;
+        clusterCount: number;
+        clusters: Record<string, number>;
+    };
+    stale?: boolean;
 }
 interface MemorySearchResponse {
     results: {
-        memory: Record<string, unknown>;
+        memory: MemoryData;
         score: number;
         similarityScore: number;
     }[];
     query: string;
     total: number;
 }
+interface CoreFact {
+    id: string;
+    userId: string;
+    agentId: string;
+    playerId: string;
+    factKey: string;
+    factValue: string;
+    sourceMemoryId?: string | null;
+    createdAt?: string | null;
+    updatedAt?: string | null;
+}
 interface CoreFactsResponse {
-    coreFacts: Record<string, unknown>[];
+    coreFacts: CoreFact[];
 }
 
 declare class RestClient {
     private baseUrl;
     private apiKey;
-    constructor(baseUrl: string, apiKey: string);
+    private timeoutMs;
+    constructor(baseUrl: string, apiKey: string, timeoutMs?: number);
     get<T>(path: string, params?: Record<string, string | number | boolean | undefined>): Promise<T>;
     post<T>(path: string, body?: unknown): Promise<T>;
     delete<T>(path: string, params?: Record<string, string | number | boolean | undefined>): Promise<T>;
@@ -259,8 +325,8 @@ declare class EstuaryClient extends TypedEventEmitter<EstuaryEventMap> {
     /** Connect to the Estuary server and authenticate */
     connect(): Promise<SessionInfo>;
     /** Disconnect from the server */
-    disconnect(): void;
-    /** Send a text message to the character */
+    disconnect(): Promise<void>;
+    /** Send a text message to the character. Defaults to textOnly=true (no TTS audio response). Pass textOnly=false to receive voice audio. */
     sendText(text: string, textOnly?: boolean): void;
     /** Interrupt the current bot response */
     interrupt(messageId?: string): void;
@@ -275,7 +341,7 @@ declare class EstuaryClient extends TypedEventEmitter<EstuaryEventMap> {
     /** Start voice input (requests microphone permission) */
     startVoice(): Promise<void>;
     /** Stop voice input */
-    stopVoice(): void;
+    stopVoice(): Promise<void>;
     /** Toggle microphone mute */
     toggleMute(): void;
     /** Whether the microphone is muted */
@@ -328,4 +394,4 @@ declare function parseActions(text: string): {
     cleanText: string;
 };
 
-export { type BotResponse, type BotVoice, type CameraCaptureRequest, type CharacterAction, ConnectionState, type CoreFactsResponse, ErrorCode, EstuaryClient, type EstuaryConfig, EstuaryError, type EstuaryEventMap, type InterruptData, type LiveKitTokenResponse, MemoryClient, type MemoryData, type MemoryGraphOptions, type MemoryGraphResponse, type MemoryListOptions, type MemoryListResponse, type MemorySearchOptions, type MemorySearchResponse, type MemoryStatsResponse, type MemoryTimelineOptions, type MemoryTimelineResponse, type MemoryUpdatedEvent, type ParsedAction, type QuotaExceededData, type SessionInfo, type SttResponse, type VoiceManager, type VoiceTransport, parseActions };
+export { type BotResponse, type BotVoice, type CameraCaptureRequest, type CharacterAction, ConnectionState, type CoreFact, type CoreFactsResponse, ErrorCode, EstuaryClient, type EstuaryConfig, EstuaryError, type EstuaryEventMap, type InterruptData, type LiveKitTokenResponse, MemoryClient, type MemoryData, type MemoryGraphEdge, type MemoryGraphNode, type MemoryGraphOptions, type MemoryGraphResponse, type MemoryListOptions, type MemoryListResponse, type MemorySearchOptions, type MemorySearchResponse, type MemoryStatsResponse, type MemoryTimelineOptions, type MemoryTimelineResponse, type MemoryUpdatedEvent, type ParsedAction, type QuotaExceededData, type SessionInfo, type SttResponse, type VoiceManager, type VoiceTransport, parseActions };

package/dist/index.js

@@ -44,11 +44,7 @@ var init_errors = __esm({
   }
 });
 
-// src/voice/websocket-voice.ts
-var websocket_voice_exports = {};
-__export(websocket_voice_exports, {
-  WebSocketVoiceManager: () => WebSocketVoiceManager
-});
+// src/audio/audio-utils.ts
 function resample(input, fromRate, toRate) {
   const ratio = fromRate / toRate;
   const outputLength = Math.round(input.length / ratio);
@@ -80,10 +76,21 @@ function uint8ArrayToBase64(bytes) {
   }
   return Buffer.from(bytes).toString("base64");
 }
+var init_audio_utils = __esm({
+  "src/audio/audio-utils.ts"() {
+  }
+});
+
+// src/voice/websocket-voice.ts
+var websocket_voice_exports = {};
+__export(websocket_voice_exports, {
+  WebSocketVoiceManager: () => WebSocketVoiceManager
+});
 var WebSocketVoiceManager;
 var init_websocket_voice = __esm({
   "src/voice/websocket-voice.ts"() {
     init_errors();
+    init_audio_utils();
     WebSocketVoiceManager = class {
       socketManager;
       sampleRate;
@@ -770,12 +777,15 @@ async function createVoiceManager(transport, socketManager, sampleRate, logger)
 
 // src/rest/rest-client.ts
 init_errors();
+var DEFAULT_TIMEOUT_MS = 1e4;
 var RestClient = class {
   baseUrl;
   apiKey;
-  constructor(baseUrl, apiKey) {
+  timeoutMs;
+  constructor(baseUrl, apiKey, timeoutMs = DEFAULT_TIMEOUT_MS) {
     this.baseUrl = baseUrl.replace(/\/+$/, "");
     this.apiKey = apiKey;
+    this.timeoutMs = timeoutMs;
   }
   async get(path, params) {
     const url = this.buildUrl(path, params);
@@ -810,7 +820,11 @@ var RestClient = class {
   async request(url, init) {
     const headers = new Headers(init.headers);
     headers.set("X-API-Key", this.apiKey);
-    const response = await fetch(url, { ...init, headers });
+    const response = await fetch(url, {
+      ...init,
+      headers,
+      signal: AbortSignal.timeout(this.timeoutMs)
+    });
     if (!response.ok) {
       let detail;
       try {
@@ -1153,20 +1167,20 @@ var EstuaryClient = class extends TypedEventEmitter {
     return session;
   }
   /** Disconnect from the server */
-  disconnect() {
+  async disconnect() {
     this.logger.info("Disconnecting...");
     if (this._autoInterruptGraceTimer) {
       clearTimeout(this._autoInterruptGraceTimer);
       this._autoInterruptGraceTimer = null;
     }
-    this.stopVoice();
+    await this.stopVoice();
     this.audioPlayer?.dispose();
     this.audioPlayer = null;
     this.socketManager.disconnect();
     this._sessionInfo = null;
   }
-  /** Send a text message to the character */
-  sendText(text, textOnly = false) {
+  /** Send a text message to the character. Defaults to textOnly=true (no TTS audio response). Pass textOnly=false to receive voice audio. */
+  sendText(text, textOnly = true) {
     this.ensureConnected();
     this.socketManager.emitEvent("text", { text, textOnly });
   }
@@ -1244,9 +1258,9 @@ var EstuaryClient = class extends TypedEventEmitter {
     this.emit("voiceStarted");
   }
   /** Stop voice input */
-  stopVoice() {
+  async stopVoice() {
     if (this.voiceManager?.isActive) {
-      this.voiceManager.stop();
+      await this.voiceManager.stop();
       this.voiceManager.dispose();
       this.voiceManager = null;
       this.emit("voiceStopped");