@craftedxp/voice-js 0.3.1 → 0.4.0

package/dist/node.d.mts

@@ -64,7 +64,8 @@ interface ProtocolCallbacks {
     onTranscript: (entries: TranscriptEntry[]) => void;
     onError: (err: CallError) => void;
     onInterrupt: () => void;
-    onAgentTurnStart: () => void;
+    onAgentTurnStart: (seq?: number) => void;
+    onAgentTurnEnd: (seq?: number) => void;
     onCallEnd: (reason: CallEndReason) => void;
     onConnected: () => void;
     onClientToolCall: (frame: ClientToolCallFrame) => void;
@@ -98,10 +99,25 @@ interface FetchTokenArgs {
      */
     metadata?: Record<string, string>;
 }
-type FetchToken = (args: FetchTokenArgs) => Promise<string>;
+/**
+ * What `fetchToken` may return. The rich object form lets the server
+ * choose the transport per call. Returning a bare string is backwards-
+ * compatible — the SDK treats it as `{ token, transport: 'ws' }`.
+ */
+interface FetchTokenResult {
+    /** Raw `ct_` to feed into the WS open / WebRTC offer. */
+    token: string;
+    /** Server-selected transport. Default `'ws'` if absent. */
+    transport?: 'ws' | 'webrtc';
+    /** Required when `transport === 'webrtc'` AND the server uses a
+     *  separate signaling gateway. When omitted on a webrtc result, the
+     *  SDK falls back to the API base's Phase-1 routes (local dev). */
+    webrtcGatewayBase?: string;
+}
+type FetchToken = (args: FetchTokenArgs) => Promise<string | FetchTokenResult>;
 interface VoiceClientConfig {
     /**
-     * Full HTTPS URL of the Voxline server. The WebSocket scheme is
+     * Full HTTPS URL of the Voissia server. The WebSocket scheme is
      * derived: `https` → `wss`, `http` → `ws`. No trailing slash needed.
      */
     apiBase: string;
@@ -322,4 +338,4 @@ interface NodeVoiceClientFactory {
  */
 declare function configureVoiceClient(config: VoiceClientConfig): NodeVoiceClientFactory;
 
-export { type Call, type CallEndEvent, type CallEndReason, type CallError, type CallErrorCode, type CallState, type ClientTool, type ClientToolMap, type FetchToken, type FetchTokenArgs, type NodeCall, type NodeStartCallOptions, type NodeVoiceClientFactory, type ProtocolCallbacks, type ProtocolState, type RWSEvent, type RWSOptions, type ReconnectingWebSocket, type ServerMessage, type StartCallOptions, type TranscriptEntry, type VoiceClientConfig, type VoiceClientFactory, type VolumeEvent, type WebSocketFactory, type WebSocketLike, buildWsUrl, configureVoiceClient, createProtocolState, createReconnectingWebSocket, handleServerMessage };
+export { type Call, type CallEndEvent, type CallEndReason, type CallError, type CallErrorCode, type CallState, type ClientTool, type ClientToolMap, type FetchToken, type FetchTokenArgs, type FetchTokenResult, type NodeCall, type NodeStartCallOptions, type NodeVoiceClientFactory, type ProtocolCallbacks, type ProtocolState, type RWSEvent, type RWSOptions, type ReconnectingWebSocket, type ServerMessage, type StartCallOptions, type TranscriptEntry, type VoiceClientConfig, type VoiceClientFactory, type VolumeEvent, type WebSocketFactory, type WebSocketLike, buildWsUrl, configureVoiceClient, createProtocolState, createReconnectingWebSocket, handleServerMessage };