@estuary-ai/sdk 0.5.0 → 0.7.0

package/LICENSE

@@ -1,21 +1,21 @@
-MIT License
-
-Copyright (c) 2026 estuary.ai
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+MIT License
+
+Copyright (c) 2026 estuary.ai
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/index.d.mts

@@ -91,6 +91,34 @@ interface QuotaExceededData {
     remaining: number;
     tier: string;
 }
+/**
+ * Emitted when the server ends the session due to inactivity (no conversation
+ * activity for the server's idle timeout). The server disconnects the socket
+ * right after; the SDK does not auto-reconnect from this — call connect()
+ * again on explicit user intent to resume.
+ */
+interface SessionTimeoutData {
+    reason: string;
+    idleSeconds: number;
+    timeoutSeconds: number;
+}
+/**
+ * Emitted when the server releases the CALL's voice resources after voice
+ * inactivity (no user speech for the server's voice-idle timeout) while the
+ * session itself stays connected — e.g. the user kept texting with a silent
+ * call open. The LiveKit room is already deleted server-side; the SDK has
+ * released the microphone and disposed the voice transport (voiceStopped is
+ * also emitted). The socket remains connected and text chat continues.
+ *
+ * Recommended UX: present this as an auto-muted microphone rather than a
+ * dropped call — keep the call UI open, show the mic as muted, and call
+ * startVoice() again when the user unmutes.
+ */
+interface VoiceTimeoutData {
+    reason: string;
+    idleSeconds: number;
+    timeoutSeconds: number;
+}
 interface LiveKitTokenResponse {
     token: string;
     url: string;
@@ -208,6 +236,8 @@ type EstuaryEventMap = {
     error: (error: Error) => void;
     authError: (error: string) => void;
     quotaExceeded: (data: QuotaExceededData) => void;
+    sessionTimeout: (data: SessionTimeoutData) => void;
+    voiceTimeout: (data: VoiceTimeoutData) => void;
     cameraCaptureRequest: (request: CameraCaptureRequest) => void;
     characterAction: (action: CharacterAction) => void;
     voiceStarted: () => void;
@@ -454,6 +484,13 @@ declare class EstuaryClient extends TypedEventEmitter<EstuaryEventMap> {
     startVoice(): Promise<void>;
     /** Stop voice input */
     stopVoice(): Promise<void>;
+    /**
+     * Tear down voice state without requiring an active manager — used when the
+     * server ends the session out from under us. Unlike stopVoice(), this also
+     * disposes a manager whose transport already died (LiveKit room deleted →
+     * isActive is false but the local mic track was never released).
+     */
+    private releaseVoice;
     /** Toggle microphone mute */
     toggleMute(): void;
     /** Whether the microphone is muted */
@@ -525,4 +562,4 @@ declare class CharacterClient {
     dispose(): void;
 }
 
-export { type BotResponse, type BotVoice, type CameraCaptureRequest, type CharacterAction, CharacterClient, type CharacterInfo, 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 ScriptController, type ScriptEndReason, type ScriptLine, type ScriptLineStartedInfo, type ScriptOptions, type ScriptState, type SessionCapabilities, type SessionInfo, type ShareOpenResponse, type SttResponse, type VoiceManager, type VoiceTransport, parseActions };
+export { type BotResponse, type BotVoice, type CameraCaptureRequest, type CharacterAction, CharacterClient, type CharacterInfo, 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 ScriptController, type ScriptEndReason, type ScriptLine, type ScriptLineStartedInfo, type ScriptOptions, type ScriptState, type SessionCapabilities, type SessionInfo, type SessionTimeoutData, type ShareOpenResponse, type SttResponse, type VoiceManager, type VoiceTimeoutData, type VoiceTransport, parseActions };

package/dist/index.d.ts

@@ -91,6 +91,34 @@ interface QuotaExceededData {
     remaining: number;
     tier: string;
 }
+/**
+ * Emitted when the server ends the session due to inactivity (no conversation
+ * activity for the server's idle timeout). The server disconnects the socket
+ * right after; the SDK does not auto-reconnect from this — call connect()
+ * again on explicit user intent to resume.
+ */
+interface SessionTimeoutData {
+    reason: string;
+    idleSeconds: number;
+    timeoutSeconds: number;
+}
+/**
+ * Emitted when the server releases the CALL's voice resources after voice
+ * inactivity (no user speech for the server's voice-idle timeout) while the
+ * session itself stays connected — e.g. the user kept texting with a silent
+ * call open. The LiveKit room is already deleted server-side; the SDK has
+ * released the microphone and disposed the voice transport (voiceStopped is
+ * also emitted). The socket remains connected and text chat continues.
+ *
+ * Recommended UX: present this as an auto-muted microphone rather than a
+ * dropped call — keep the call UI open, show the mic as muted, and call
+ * startVoice() again when the user unmutes.
+ */
+interface VoiceTimeoutData {
+    reason: string;
+    idleSeconds: number;
+    timeoutSeconds: number;
+}
 interface LiveKitTokenResponse {
     token: string;
     url: string;
@@ -208,6 +236,8 @@ type EstuaryEventMap = {
     error: (error: Error) => void;
     authError: (error: string) => void;
     quotaExceeded: (data: QuotaExceededData) => void;
+    sessionTimeout: (data: SessionTimeoutData) => void;
+    voiceTimeout: (data: VoiceTimeoutData) => void;
     cameraCaptureRequest: (request: CameraCaptureRequest) => void;
     characterAction: (action: CharacterAction) => void;
     voiceStarted: () => void;
@@ -454,6 +484,13 @@ declare class EstuaryClient extends TypedEventEmitter<EstuaryEventMap> {
     startVoice(): Promise<void>;
     /** Stop voice input */
     stopVoice(): Promise<void>;
+    /**
+     * Tear down voice state without requiring an active manager — used when the
+     * server ends the session out from under us. Unlike stopVoice(), this also
+     * disposes a manager whose transport already died (LiveKit room deleted →
+     * isActive is false but the local mic track was never released).
+     */
+    private releaseVoice;
     /** Toggle microphone mute */
     toggleMute(): void;
     /** Whether the microphone is muted */
@@ -525,4 +562,4 @@ declare class CharacterClient {
     dispose(): void;
 }
 
-export { type BotResponse, type BotVoice, type CameraCaptureRequest, type CharacterAction, CharacterClient, type CharacterInfo, 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 ScriptController, type ScriptEndReason, type ScriptLine, type ScriptLineStartedInfo, type ScriptOptions, type ScriptState, type SessionCapabilities, type SessionInfo, type ShareOpenResponse, type SttResponse, type VoiceManager, type VoiceTransport, parseActions };
+export { type BotResponse, type BotVoice, type CameraCaptureRequest, type CharacterAction, CharacterClient, type CharacterInfo, 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 ScriptController, type ScriptEndReason, type ScriptLine, type ScriptLineStartedInfo, type ScriptOptions, type ScriptState, type SessionCapabilities, type SessionInfo, type SessionTimeoutData, type ShareOpenResponse, type SttResponse, type VoiceManager, type VoiceTimeoutData, type VoiceTransport, parseActions };