@hypercli.com/sdk 2026.6.21 → 2026.7.31

package/dist/user.d.ts

@@ -16,6 +16,10 @@ export interface User {
 export interface AuthMe {
     userId: string;
     orchestraUserId: string | null;
+    externalId: string | null;
+    privyUserId: string | null;
+    walletAddress: string | null;
+    userType: string | null;
     teamId: string;
     planId: string;
     email: string | null;
@@ -28,19 +32,25 @@ export interface AuthMe {
     keyName: string | null;
 }
 export interface RuntimeIdentity {
-    kind: string;
+    runtime: string;
     agentId: string | null;
 }
 export interface UpdateUserOptions {
     name?: string;
     email?: string;
 }
+export interface UserProfileImage {
+    id: string;
+    avatarUrl: string | null;
+    s3Key: string | null;
+}
 export declare function runtimeAgentId(auth: AuthMe): string | null;
 export declare function isRuntimeAgent(auth: AuthMe): boolean;
 export declare class UserAPI {
     private http;
     private authHttp;
-    constructor(http: HTTPClient, authHttp?: HTTPClient);
+    private profileHttp;
+    constructor(http: HTTPClient, authHttp?: HTTPClient, profileHttp?: HTTPClient);
     /**
      * Get current user info
      */
@@ -53,5 +63,8 @@ export declare class UserAPI {
      * Update the current user profile.
      */
     update(options: UpdateUserOptions): Promise<User>;
+    getProfileImage(): Promise<UserProfileImage>;
+    uploadProfileImage(content: Blob | ArrayBuffer | ArrayBufferView, contentType?: string): Promise<UserProfileImage>;
+    deleteProfileImage(): Promise<UserProfileImage>;
 }
 //# sourceMappingURL=user.d.ts.map

package/dist/user.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"user.d.ts","sourceRoot":"","sources":["../src/user.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAE5C,MAAM,WAAW,IAAI;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,QAAQ,EAAE,OAAO,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACtB;AAED,MAAM,WAAW,MAAM;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,OAAO,EAAE,eAAe,GAAG,IAAI,CAAC;IAChC,qBAAqB,EAAE,OAAO,CAAC;IAC/B,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;CACxB;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;CACxB;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAuCD,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAE1D;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEpD;AAED,qBAAa,OAAO;IACN,OAAO,CAAC,IAAI;IAAc,OAAO,CAAC,QAAQ;gBAAlC,IAAI,EAAE,UAAU,EAAU,QAAQ,GAAE,UAAiB;IAEzE;;OAEG;IACG,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;IAK1B;;OAEG;IACG,MAAM,IAAI,OAAO,CAAC,MAAM,CAAC;IAK/B;;OAEG;IACG,MAAM,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC;CAIxD"}
+{"version":3,"file":"user.d.ts","sourceRoot":"","sources":["../src/user.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAE5C,MAAM,WAAW,IAAI;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,QAAQ,EAAE,OAAO,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACtB;AAED,MAAM,WAAW,MAAM;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,OAAO,EAAE,eAAe,GAAG,IAAI,CAAC;IAChC,qBAAqB,EAAE,OAAO,CAAC;IAC/B,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;CACxB;AAED,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;CACxB;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CACtB;AA4DD,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAE1D;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEpD;AAED,qBAAa,OAAO;IAEhB,OAAO,CAAC,IAAI;IACZ,OAAO,CAAC,QAAQ;IAChB,OAAO,CAAC,WAAW;gBAFX,IAAI,EAAE,UAAU,EAChB,QAAQ,GAAE,UAAiB,EAC3B,WAAW,GAAE,UAAqB;IAG5C;;OAEG;IACG,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;IAK1B;;OAEG;IACG,MAAM,IAAI,OAAO,CAAC,MAAM,CAAC;IAK/B;;OAEG;IACG,MAAM,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC;IAKjD,eAAe,IAAI,OAAO,CAAC,gBAAgB,CAAC;IAI5C,kBAAkB,CACtB,OAAO,EAAE,IAAI,GAAG,WAAW,GAAG,eAAe,EAC7C,WAAW,CAAC,EAAE,MAAM,GACnB,OAAO,CAAC,gBAAgB,CAAC;IAgBtB,kBAAkB,IAAI,OAAO,CAAC,gBAAgB,CAAC;CAGtD"}

package/dist/user.js

@@ -1,3 +1,23 @@
+function userProfileImageFromDict(data) {
+    return {
+        id: String(data?.id || ''),
+        avatarUrl: data?.avatar_url || null,
+        s3Key: data?.s3_key || null,
+    };
+}
+function deriveExternalId(data) {
+    if (data.external_id)
+        return data.external_id;
+    if (data.privy_user_id)
+        return data.privy_user_id;
+    if (data.wallet_address)
+        return `wallet:${String(data.wallet_address).toLowerCase()}`;
+    if (data.turnkey_org_id)
+        return `turnkey:${data.turnkey_org_id}`;
+    if (data.user_id)
+        return `orchestra:${data.user_id}`;
+    return null;
+}
 function userFromDict(data) {
     return {
         userId: data.user_id || '',
@@ -14,13 +34,17 @@ function userFromDict(data) {
 function authMeFromDict(data) {
     const runtime = data?.runtime && typeof data.runtime === 'object'
         ? {
-            kind: data.runtime.kind || '',
-            agentId: data.runtime.agent_id || data.runtime.agentId || null,
+            runtime: data.runtime.runtime || '',
+            agentId: data.runtime.agent_id || null,
         }
         : null;
     return {
         userId: data.user_id || '',
         orchestraUserId: data.orchestra_user_id || null,
+        externalId: deriveExternalId(data),
+        privyUserId: data.privy_user_id || null,
+        walletAddress: data.wallet_address || null,
+        userType: data.user_type || null,
         teamId: data.team_id || '',
         planId: data.plan_id || '',
         email: data.email || null,
@@ -34,7 +58,7 @@ function authMeFromDict(data) {
     };
 }
 export function runtimeAgentId(auth) {
-    return auth.runtime?.kind === 'agent' ? auth.runtime.agentId : null;
+    return auth.runtime?.runtime === 'agent' ? auth.runtime.agentId : null;
 }
 export function isRuntimeAgent(auth) {
     return runtimeAgentId(auth) !== null;
@@ -42,9 +66,11 @@ export function isRuntimeAgent(auth) {
 export class UserAPI {
     http;
     authHttp;
-    constructor(http, authHttp = http) {
+    profileHttp;
+    constructor(http, authHttp = http, profileHttp = authHttp) {
         this.http = http;
         this.authHttp = authHttp;
+        this.profileHttp = profileHttp;
     }
     /**
      * Get current user info
@@ -67,5 +93,26 @@ export class UserAPI {
         const data = await this.http.patch('/api/user', options);
         return userFromDict(data);
     }
+    async getProfileImage() {
+        return userProfileImageFromDict(await this.profileHttp.get('/users/profile-image'));
+    }
+    async uploadProfileImage(content, contentType) {
+        let body;
+        let resolvedContentType = contentType || 'image/png';
+        if (content instanceof Blob) {
+            body = content;
+            resolvedContentType = contentType || content.type || resolvedContentType;
+        }
+        else if (ArrayBuffer.isView(content)) {
+            body = content;
+        }
+        else {
+            body = content;
+        }
+        return userProfileImageFromDict(await this.profileHttp.postRaw('/users/profile-image', body, resolvedContentType));
+    }
+    async deleteProfileImage() {
+        return userProfileImageFromDict(await this.profileHttp.delete('/users/profile-image'));
+    }
 }
 //# sourceMappingURL=user.js.map

package/dist/user.js.map

@@ -1 +1 @@
-{"version":3,"file":"user.js","sourceRoot":"","sources":["../src/user.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"user.js","sourceRoot":"","sources":["../src/user.ts"],"names":[],"mappings":"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"}

package/dist/voice-session.d.ts

@@ -0,0 +1,74 @@
+export type VoiceSessionState = 'closed' | 'idle' | 'rendering' | 'receiving';
+export interface VoiceChunkEvent {
+    requestId: string;
+    index: number;
+    total: number;
+    audio: Uint8Array;
+    final: boolean;
+}
+export interface VoiceSessionOptions {
+    /** Agents WS base, e.g. wss://api.agents.hypercli.com/ws */
+    wsUrl: string;
+    /** API key (hyper_api_...) or JWT. */
+    credential: string;
+    /** Per-request timeout in milliseconds (default 300 000). */
+    timeoutMs?: number;
+}
+export interface SpeakOptions {
+    text: string;
+    voice?: string;
+    language?: string;
+    format?: string;
+    /** true (default): receive each server-side split; false: one assembled file. */
+    chunks?: boolean;
+    requestId?: string;
+}
+export interface CloneSpeakOptions {
+    text: string;
+    refAudio: Uint8Array | ArrayBuffer;
+    language?: string;
+    xVectorOnly?: boolean;
+    format?: string;
+    chunks?: boolean;
+    requestId?: string;
+}
+export interface DesignSpeakOptions {
+    text: string;
+    description: string;
+    language?: string;
+    format?: string;
+    chunks?: boolean;
+    requestId?: string;
+}
+export declare class VoiceStreamError extends Error {
+    readonly code: string;
+    readonly detail: string;
+    constructor(code: string, detail: string);
+}
+export declare function encodeBase64(bytes: Uint8Array | ArrayBuffer): string;
+export declare class VoiceSession {
+    state: VoiceSessionState;
+    private readonly wsUrl;
+    private readonly credential;
+    private readonly timeoutMs;
+    private ws;
+    private messages;
+    private waiter;
+    private closeError;
+    constructor(options: VoiceSessionOptions);
+    open(): Promise<this>;
+    close(): void;
+    cancel(requestId: string): Promise<void>;
+    /** Speak text with a preset voice. */
+    speak(options: SpeakOptions): AsyncGenerator<VoiceChunkEvent, void, undefined>;
+    /** Speak text in a voice cloned from reference audio. */
+    speakClone(options: CloneSpeakOptions): AsyncGenerator<VoiceChunkEvent, void, undefined>;
+    /** Speak text in a voice designed from a natural-language description. */
+    speakDesign(options: DesignSpeakOptions): AsyncGenerator<VoiceChunkEvent, void, undefined>;
+    private runSpeak;
+    private send;
+    private enqueue;
+    private handleClose;
+    private nextMessage;
+}
+//# sourceMappingURL=voice-session.d.ts.map

package/dist/voice-session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"voice-session.d.ts","sourceRoot":"","sources":["../src/voice-session.ts"],"names":[],"mappings":"AAUA,MAAM,MAAM,iBAAiB,GAAG,QAAQ,GAAG,MAAM,GAAG,WAAW,GAAG,WAAW,CAAC;AAE9E,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,UAAU,CAAC;IAClB,KAAK,EAAE,OAAO,CAAC;CAChB;AAED,MAAM,WAAW,mBAAmB;IAClC,4DAA4D;IAC5D,KAAK,EAAE,MAAM,CAAC;IACd,sCAAsC;IACtC,UAAU,EAAE,MAAM,CAAC;IACnB,6DAA6D;IAC7D,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,iFAAiF;IACjF,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,UAAU,GAAG,WAAW,CAAC;IACnC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,qBAAa,gBAAiB,SAAQ,KAAK;aAEvB,IAAI,EAAE,MAAM;aACZ,MAAM,EAAE,MAAM;gBADd,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM;CAKjC;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,UAAU,GAAG,WAAW,GAAG,MAAM,CAWpE;AAuBD,qBAAa,YAAY;IACvB,KAAK,EAAE,iBAAiB,CAAY;IAEpC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAC/B,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,EAAE,CAA0C;IACpD,OAAO,CAAC,QAAQ,CAAgB;IAChC,OAAO,CAAC,MAAM,CAAuB;IACrC,OAAO,CAAC,UAAU,CAAsB;gBAE5B,OAAO,EAAE,mBAAmB;IAMlC,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAoC3B,KAAK,IAAI,IAAI;IAaP,MAAM,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI9C,sCAAsC;IAC/B,KAAK,CAAC,OAAO,EAAE,YAAY,GAAG,cAAc,CAAC,eAAe,EAAE,IAAI,EAAE,SAAS,CAAC;IAYrF,yDAAyD;IAClD,UAAU,CAAC,OAAO,EAAE,iBAAiB,GAAG,cAAc,CAAC,eAAe,EAAE,IAAI,EAAE,SAAS,CAAC;IAa/F,0EAA0E;IACnE,WAAW,CAAC,OAAO,EAAE,kBAAkB,GAAG,cAAc,CAAC,eAAe,EAAE,IAAI,EAAE,SAAS,CAAC;YAYlF,QAAQ;IA4EvB,OAAO,CAAC,IAAI;IAOZ,OAAO,CAAC,OAAO;IAUf,OAAO,CAAC,WAAW;IAWnB,OAAO,CAAC,WAAW;CAyBpB"}

package/dist/voice-session.js

@@ -0,0 +1,255 @@
+/**
+ * Voice streaming session over the /ws/voice WebSocket.
+ *
+ * The server owns text chunking; a session receives an ordered stream of
+ * audio chunks. One request at a time: idle → rendering → receiving → idle.
+ * Works in both Node (`ws` package, Authorization header) and the browser
+ * (global WebSocket, `?jwt=` query — browsers cannot set WS headers).
+ */
+import NodeWebSocket from 'ws';
+export class VoiceStreamError extends Error {
+    code;
+    detail;
+    constructor(code, detail) {
+        super(`voice stream error ${code}: ${detail}`);
+        this.code = code;
+        this.detail = detail;
+        this.name = 'VoiceStreamError';
+    }
+}
+export function encodeBase64(bytes) {
+    const data = bytes instanceof Uint8Array ? bytes : new Uint8Array(bytes);
+    if (typeof Buffer !== 'undefined') {
+        return Buffer.from(data).toString('base64');
+    }
+    let binary = '';
+    const CHUNK = 0x8000;
+    for (let i = 0; i < data.length; i += CHUNK) {
+        binary += String.fromCharCode(...data.subarray(i, i + CHUNK));
+    }
+    return btoa(binary);
+}
+function decodeBase64(value) {
+    if (typeof Buffer !== 'undefined') {
+        return new Uint8Array(Buffer.from(value, 'base64'));
+    }
+    const binary = atob(value);
+    const bytes = new Uint8Array(binary.length);
+    for (let i = 0; i < binary.length; i++) {
+        bytes[i] = binary.charCodeAt(i);
+    }
+    return bytes;
+}
+function randomRequestId() {
+    return Math.random().toString(36).slice(2, 10) + Math.random().toString(36).slice(2, 6);
+}
+export class VoiceSession {
+    state = 'closed';
+    wsUrl;
+    credential;
+    timeoutMs;
+    ws = null;
+    messages = [];
+    waiter = null;
+    closeError = null;
+    constructor(options) {
+        this.wsUrl = options.wsUrl.replace(/\/+$/, '');
+        this.credential = options.credential;
+        this.timeoutMs = options.timeoutMs ?? 300_000;
+    }
+    async open() {
+        if (this.ws)
+            return this;
+        const useBrowserSocket = 'localStorage' in globalThis && typeof WebSocket !== 'undefined';
+        if (!useBrowserSocket && typeof NodeWebSocket === 'undefined') {
+            throw new Error('WebSocket is not available in this environment');
+        }
+        await new Promise((resolve, reject) => {
+            if (useBrowserSocket) {
+                // Browsers cannot set WS headers — credential rides the jwt query param.
+                const url = `${this.wsUrl}/voice?jwt=${encodeURIComponent(this.credential)}`;
+                const ws = new WebSocket(url);
+                this.ws = ws;
+                ws.onopen = () => resolve();
+                ws.onmessage = (event) => this.enqueue(String(event.data ?? ''));
+                ws.onerror = () => reject(new Error('voice WS connection failed'));
+                ws.onclose = (event) => this.handleClose(event.code ?? 1006, String(event.reason ?? ''));
+                return;
+            }
+            const ws = new NodeWebSocket(`${this.wsUrl}/voice`, {
+                headers: { Authorization: `Bearer ${this.credential}` },
+            });
+            this.ws = ws;
+            ws.on('open', () => resolve());
+            ws.on('message', (data) => this.enqueue(typeof data === 'string' ? data : data.toString()));
+            ws.on('error', (error) => reject(error));
+            ws.on('close', (code, reason) => this.handleClose(code ?? 1006, reason?.toString() ?? ''));
+        });
+        this.state = 'idle';
+        return this;
+    }
+    close() {
+        const ws = this.ws;
+        this.ws = null;
+        this.state = 'closed';
+        if (ws) {
+            try {
+                ws.close();
+            }
+            catch {
+                // already closed
+            }
+        }
+    }
+    async cancel(requestId) {
+        this.send({ type: 'cancel', request_id: requestId });
+    }
+    /** Speak text with a preset voice. */
+    async *speak(options) {
+        yield* this.runSpeak('tts', {
+            text: options.text,
+            voice: options.voice ?? 'serena',
+            language: options.language ?? 'auto',
+        }, options);
+    }
+    /** Speak text in a voice cloned from reference audio. */
+    async *speakClone(options) {
+        yield* this.runSpeak('clone', {
+            text: options.text,
+            ref_audio_base64: encodeBase64(options.refAudio),
+            language: options.language ?? 'auto',
+            x_vector_only: options.xVectorOnly ?? true,
+        }, options);
+    }
+    /** Speak text in a voice designed from a natural-language description. */
+    async *speakDesign(options) {
+        yield* this.runSpeak('design', {
+            text: options.text,
+            instruct: options.description,
+            language: options.language ?? 'auto',
+        }, options);
+    }
+    async *runSpeak(op, body, options) {
+        if (!this.ws || this.state === 'closed') {
+            throw new Error("Session is not connected; call open() first");
+        }
+        if (this.state !== 'idle') {
+            throw new Error(`Session is ${this.state}; one request at a time`);
+        }
+        const requestId = options.requestId ?? randomRequestId();
+        const deadline = Date.now() + this.timeoutMs;
+        this.state = 'rendering';
+        let finished = false;
+        try {
+            this.send({
+                type: 'speak',
+                request_id: requestId,
+                op,
+                format: options.format ?? 'mp3',
+                chunks: options.chunks ?? true,
+                ...body,
+            });
+            while (true) {
+                const remaining = deadline - Date.now();
+                if (remaining <= 0) {
+                    throw new VoiceStreamError('timeout', `voice stream timed out after ${this.timeoutMs}ms`);
+                }
+                const raw = await this.nextMessage(remaining);
+                let message;
+                try {
+                    message = JSON.parse(raw);
+                }
+                catch {
+                    continue;
+                }
+                const rid = String(message.request_id ?? '');
+                if (rid !== '' && rid !== requestId)
+                    continue;
+                switch (message.type) {
+                    case 'chunk': {
+                        this.state = 'receiving';
+                        yield {
+                            requestId,
+                            index: Number(message.index ?? 0),
+                            total: Number(message.total ?? 1),
+                            audio: decodeBase64(String(message.audio_b64 ?? '')),
+                            final: Boolean(message.final),
+                        };
+                        break;
+                    }
+                    case 'done':
+                        finished = true;
+                        return;
+                    case 'error':
+                        finished = true;
+                        throw new VoiceStreamError(String(message.code ?? ''), String(message.detail ?? ''));
+                    default:
+                        break;
+                }
+            }
+        }
+        finally {
+            if (!finished && this.ws) {
+                // Consumer bailed early (or timed out) — cancel server-side.
+                try {
+                    await this.cancel(requestId);
+                }
+                catch {
+                    // socket may already be gone
+                }
+            }
+            this.state = this.ws ? 'idle' : 'closed';
+        }
+    }
+    send(message) {
+        if (!this.ws) {
+            throw new Error('Session is not connected');
+        }
+        this.ws.send(JSON.stringify(message));
+    }
+    enqueue(raw) {
+        if (this.waiter) {
+            const waiter = this.waiter;
+            this.waiter = null;
+            waiter.resolve(raw);
+            return;
+        }
+        this.messages.push(raw);
+    }
+    handleClose(code, reason) {
+        this.ws = null;
+        this.state = 'closed';
+        this.closeError = new Error(`voice WS closed (${code}): ${reason || 'connection closed'}`);
+        if (this.waiter) {
+            const waiter = this.waiter;
+            this.waiter = null;
+            waiter.reject(this.closeError);
+        }
+    }
+    nextMessage(timeoutMs) {
+        const queued = this.messages.shift();
+        if (queued !== undefined) {
+            return Promise.resolve(queued);
+        }
+        if (!this.ws) {
+            return Promise.reject(this.closeError ?? new Error('Session is not connected'));
+        }
+        return new Promise((resolve, reject) => {
+            const timer = setTimeout(() => {
+                this.waiter = null;
+                reject(new VoiceStreamError('timeout', `no message within ${Math.round(timeoutMs)}ms`));
+            }, timeoutMs);
+            this.waiter = {
+                resolve: (value) => {
+                    clearTimeout(timer);
+                    resolve(value);
+                },
+                reject: (error) => {
+                    clearTimeout(timer);
+                    reject(error);
+                },
+            };
+        });
+    }
+}
+//# sourceMappingURL=voice-session.js.map

package/dist/voice-session.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"voice-session.js","sourceRoot":"","sources":["../src/voice-session.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,aAAa,MAAM,IAAI,CAAC;AAkD/B,MAAM,OAAO,gBAAiB,SAAQ,KAAK;IAEvB;IACA;IAFlB,YACkB,IAAY,EACZ,MAAc;QAE9B,KAAK,CAAC,sBAAsB,IAAI,KAAK,MAAM,EAAE,CAAC,CAAC;QAH/B,SAAI,GAAJ,IAAI,CAAQ;QACZ,WAAM,GAAN,MAAM,CAAQ;QAG9B,IAAI,CAAC,IAAI,GAAG,kBAAkB,CAAC;IACjC,CAAC;CACF;AAED,MAAM,UAAU,YAAY,CAAC,KAA+B;IAC1D,MAAM,IAAI,GAAG,KAAK,YAAY,UAAU,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,UAAU,CAAC,KAAK,CAAC,CAAC;IACzE,IAAI,OAAO,MAAM,KAAK,WAAW,EAAE,CAAC;QAClC,OAAO,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;IAC9C,CAAC;IACD,IAAI,MAAM,GAAG,EAAE,CAAC;IAChB,MAAM,KAAK,GAAG,MAAM,CAAC;IACrB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,IAAI,KAAK,EAAE,CAAC;QAC5C,MAAM,IAAI,MAAM,CAAC,YAAY,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC;IAChE,CAAC;IACD,OAAO,IAAI,CAAC,MAAM,CAAC,CAAC;AACtB,CAAC;AAED,SAAS,YAAY,CAAC,KAAa;IACjC,IAAI,OAAO,MAAM,KAAK,WAAW,EAAE,CAAC;QAClC,OAAO,IAAI,UAAU,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC,CAAC;IACtD,CAAC;IACD,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC;IAC3B,MAAM,KAAK,GAAG,IAAI,UAAU,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAC5C,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACvC,KAAK,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;IAClC,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,eAAe;IACtB,OAAO,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;AAC1F,CAAC;AAOD,MAAM,OAAO,YAAY;IACvB,KAAK,GAAsB,QAAQ,CAAC;IAEnB,KAAK,CAAS;IACd,UAAU,CAAS;IACnB,SAAS,CAAS;IAC3B,EAAE,GAAqC,IAAI,CAAC;IAC5C,QAAQ,GAAa,EAAE,CAAC;IACxB,MAAM,GAAkB,IAAI,CAAC;IAC7B,UAAU,GAAiB,IAAI,CAAC;IAExC,YAAY,OAA4B;QACtC,IAAI,CAAC,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;QAC/C,IAAI,CAAC,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC;QACrC,IAAI,CAAC,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,OAAO,CAAC;IAChD,CAAC;IAED,KAAK,CAAC,IAAI;QACR,IAAI,IAAI,CAAC,EAAE;YAAE,OAAO,IAAI,CAAC;QACzB,MAAM,gBAAgB,GAAG,cAAc,IAAI,UAAU,IAAI,OAAO,SAAS,KAAK,WAAW,CAAC;QAC1F,IAAI,CAAC,gBAAgB,IAAI,OAAO,aAAa,KAAK,WAAW,EAAE,CAAC;YAC9D,MAAM,IAAI,KAAK,CAAC,gDAAgD,CAAC,CAAC;QACpE,CAAC;QAED,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YAC1C,IAAI,gBAAgB,EAAE,CAAC;gBACrB,yEAAyE;gBACzE,MAAM,GAAG,GAAG,GAAG,IAAI,CAAC,KAAK,cAAc,kBAAkB,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC;gBAC7E,MAAM,EAAE,GAAG,IAAI,SAAS,CAAC,GAAG,CAAC,CAAC;gBAC9B,IAAI,CAAC,EAAE,GAAG,EAAE,CAAC;gBACb,EAAE,CAAC,MAAM,GAAG,GAAG,EAAE,CAAC,OAAO,EAAE,CAAC;gBAC5B,EAAE,CAAC,SAAS,GAAG,CAAC,KAAyB,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,CAAC;gBACrF,EAAE,CAAC,OAAO,GAAG,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,4BAA4B,CAAC,CAAC,CAAC;gBACnE,EAAE,CAAC,OAAO,GAAG,CAAC,KAAyC,EAAE,EAAE,CACzD,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,IAAI,IAAI,IAAI,EAAE,MAAM,CAAC,KAAK,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,CAAC;gBACnE,OAAO;YACT,CAAC;YACD,MAAM,EAAE,GAAG,IAAI,aAAa,CAAC,GAAG,IAAI,CAAC,KAAK,QAAQ,EAAE;gBAClD,OAAO,EAAE,EAAE,aAAa,EAAE,UAAU,IAAI,CAAC,UAAU,EAAE,EAAE;aACxD,CAAC,CAAC;YACH,IAAI,CAAC,EAAE,GAAG,EAAE,CAAC;YACb,EAAE,CAAC,EAAE,CAAC,MAAM,EAAE,GAAG,EAAE,CAAC,OAAO,EAAE,CAAC,CAAC;YAC/B,EAAE,CAAC,EAAE,CAAC,SAAS,EAAE,CAAC,IAA2B,EAAE,EAAE,CAC/C,IAAI,CAAC,OAAO,CAAC,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC;YACnE,EAAE,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,KAAY,EAAE,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;YAChD,EAAE,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,IAAY,EAAE,MAAc,EAAE,EAAE,CAC9C,IAAI,CAAC,WAAW,CAAC,IAAI,IAAI,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;QAC9D,CAAC,CAAC,CAAC;QAEH,IAAI,CAAC,KAAK,GAAG,MAAM,CAAC;QACpB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,KAAK;QACH,MAAM,EAAE,GAAG,IAAI,CAAC,EAAE,CAAC;QACnB,IAAI,CAAC,EAAE,GAAG,IAAI,CAAC;QACf,IAAI,CAAC,KAAK,GAAG,QAAQ,CAAC;QACtB,IAAI,EAAE,EAAE,CAAC;YACP,IAAI,CAAC;gBACH,EAAE,CAAC,KAAK,EAAE,CAAC;YACb,CAAC;YAAC,MAAM,CAAC;gBACP,iBAAiB;YACnB,CAAC;QACH,CAAC;IACH,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,SAAiB;QAC5B,IAAI,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,UAAU,EAAE,SAAS,EAAE,CAAC,CAAC;IACvD,CAAC;IAED,sCAAsC;IACtC,KAAK,CAAC,CAAC,KAAK,CAAC,OAAqB;QAChC,KAAK,CAAC,CAAC,IAAI,CAAC,QAAQ,CAClB,KAAK,EACL;YACE,IAAI,EAAE,OAAO,CAAC,IAAI;YAClB,KAAK,EAAE,OAAO,CAAC,KAAK,IAAI,QAAQ;YAChC,QAAQ,EAAE,OAAO,CAAC,QAAQ,IAAI,MAAM;SACrC,EACD,OAAO,CACR,CAAC;IACJ,CAAC;IAED,yDAAyD;IACzD,KAAK,CAAC,CAAC,UAAU,CAAC,OAA0B;QAC1C,KAAK,CAAC,CAAC,IAAI,CAAC,QAAQ,CAClB,OAAO,EACP;YACE,IAAI,EAAE,OAAO,CAAC,IAAI;YAClB,gBAAgB,EAAE,YAAY,CAAC,OAAO,CAAC,QAAQ,CAAC;YAChD,QAAQ,EAAE,OAAO,CAAC,QAAQ,IAAI,MAAM;YACpC,aAAa,EAAE,OAAO,CAAC,WAAW,IAAI,IAAI;SAC3C,EACD,OAAO,CACR,CAAC;IACJ,CAAC;IAED,0EAA0E;IAC1E,KAAK,CAAC,CAAC,WAAW,CAAC,OAA2B;QAC5C,KAAK,CAAC,CAAC,IAAI,CAAC,QAAQ,CAClB,QAAQ,EACR;YACE,IAAI,EAAE,OAAO,CAAC,IAAI;YAClB,QAAQ,EAAE,OAAO,CAAC,WAAW;YAC7B,QAAQ,EAAE,OAAO,CAAC,QAAQ,IAAI,MAAM;SACrC,EACD,OAAO,CACR,CAAC;IACJ,CAAC;IAEO,KAAK,CAAC,CAAC,QAAQ,CACrB,EAAU,EACV,IAA6B,EAC7B,OAAkE;QAElE,IAAI,CAAC,IAAI,CAAC,EAAE,IAAI,IAAI,CAAC,KAAK,KAAK,QAAQ,EAAE,CAAC;YACxC,MAAM,IAAI,KAAK,CAAC,6CAA6C,CAAC,CAAC;QACjE,CAAC;QACD,IAAI,IAAI,CAAC,KAAK,KAAK,MAAM,EAAE,CAAC;YAC1B,MAAM,IAAI,KAAK,CAAC,cAAc,IAAI,CAAC,KAAK,yBAAyB,CAAC,CAAC;QACrE,CAAC;QAED,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,eAAe,EAAE,CAAC;QACzD,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC;QAC7C,IAAI,CAAC,KAAK,GAAG,WAAW,CAAC;QACzB,IAAI,QAAQ,GAAG,KAAK,CAAC;QACrB,IAAI,CAAC;YACH,IAAI,CAAC,IAAI,CAAC;gBACR,IAAI,EAAE,OAAO;gBACb,UAAU,EAAE,SAAS;gBACrB,EAAE;gBACF,MAAM,EAAE,OAAO,CAAC,MAAM,IAAI,KAAK;gBAC/B,MAAM,EAAE,OAAO,CAAC,MAAM,IAAI,IAAI;gBAC9B,GAAG,IAAI;aACR,CAAC,CAAC;YAEH,OAAO,IAAI,EAAE,CAAC;gBACZ,MAAM,SAAS,GAAG,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;gBACxC,IAAI,SAAS,IAAI,CAAC,EAAE,CAAC;oBACnB,MAAM,IAAI,gBAAgB,CAAC,SAAS,EAAE,gCAAgC,IAAI,CAAC,SAAS,IAAI,CAAC,CAAC;gBAC5F,CAAC;gBACD,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,SAAS,CAAC,CAAC;gBAC9C,IAAI,OAAgC,CAAC;gBACrC,IAAI,CAAC;oBACH,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAA4B,CAAC;gBACvD,CAAC;gBAAC,MAAM,CAAC;oBACP,SAAS;gBACX,CAAC;gBACD,MAAM,GAAG,GAAG,MAAM,CAAC,OAAO,CAAC,UAAU,IAAI,EAAE,CAAC,CAAC;gBAC7C,IAAI,GAAG,KAAK,EAAE,IAAI,GAAG,KAAK,SAAS;oBAAE,SAAS;gBAE9C,QAAQ,OAAO,CAAC,IAAI,EAAE,CAAC;oBACrB,KAAK,OAAO,CAAC,CAAC,CAAC;wBACb,IAAI,CAAC,KAAK,GAAG,WAAW,CAAC;wBACzB,MAAM;4BACJ,SAAS;4BACT,KAAK,EAAE,MAAM,CAAC,OAAO,CAAC,KAAK,IAAI,CAAC,CAAC;4BACjC,KAAK,EAAE,MAAM,CAAC,OAAO,CAAC,KAAK,IAAI,CAAC,CAAC;4BACjC,KAAK,EAAE,YAAY,CAAC,MAAM,CAAC,OAAO,CAAC,SAAS,IAAI,EAAE,CAAC,CAAC;4BACpD,KAAK,EAAE,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC;yBAC9B,CAAC;wBACF,MAAM;oBACR,CAAC;oBACD,KAAK,MAAM;wBACT,QAAQ,GAAG,IAAI,CAAC;wBAChB,OAAO;oBACT,KAAK,OAAO;wBACV,QAAQ,GAAG,IAAI,CAAC;wBAChB,MAAM,IAAI,gBAAgB,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,IAAI,EAAE,CAAC,EAAE,MAAM,CAAC,OAAO,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,CAAC;oBACvF;wBACE,MAAM;gBACV,CAAC;YACH,CAAC;QACH,CAAC;gBAAS,CAAC;YACT,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,EAAE,EAAE,CAAC;gBACzB,6DAA6D;gBAC7D,IAAI,CAAC;oBACH,MAAM,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;gBAC/B,CAAC;gBAAC,MAAM,CAAC;oBACP,6BAA6B;gBAC/B,CAAC;YACH,CAAC;YACD,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC;QAC3C,CAAC;IACH,CAAC;IAEO,IAAI,CAAC,OAAgC;QAC3C,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC;YACb,MAAM,IAAI,KAAK,CAAC,0BAA0B,CAAC,CAAC;QAC9C,CAAC;QACD,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC;IACxC,CAAC;IAEO,OAAO,CAAC,GAAW;QACzB,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAChB,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;YAC3B,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;YACnB,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;YACpB,OAAO;QACT,CAAC;QACD,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC1B,CAAC;IAEO,WAAW,CAAC,IAAY,EAAE,MAAc;QAC9C,IAAI,CAAC,EAAE,GAAG,IAAI,CAAC;QACf,IAAI,CAAC,KAAK,GAAG,QAAQ,CAAC;QACtB,IAAI,CAAC,UAAU,GAAG,IAAI,KAAK,CAAC,oBAAoB,IAAI,MAAM,MAAM,IAAI,mBAAmB,EAAE,CAAC,CAAC;QAC3F,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAChB,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;YAC3B,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;YACnB,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QACjC,CAAC;IACH,CAAC;IAEO,WAAW,CAAC,SAAiB;QACnC,MAAM,MAAM,GAAG,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC;QACrC,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;YACzB,OAAO,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QACjC,CAAC;QACD,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC;YACb,OAAO,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,UAAU,IAAI,IAAI,KAAK,CAAC,0BAA0B,CAAC,CAAC,CAAC;QAClF,CAAC;QACD,OAAO,IAAI,OAAO,CAAS,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YAC7C,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE;gBAC5B,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;gBACnB,MAAM,CAAC,IAAI,gBAAgB,CAAC,SAAS,EAAE,qBAAqB,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC;YAC1F,CAAC,EAAE,SAAS,CAAC,CAAC;YACd,IAAI,CAAC,MAAM,GAAG;gBACZ,OAAO,EAAE,CAAC,KAAK,EAAE,EAAE;oBACjB,YAAY,CAAC,KAAK,CAAC,CAAC;oBACpB,OAAO,CAAC,KAAK,CAAC,CAAC;gBACjB,CAAC;gBACD,MAAM,EAAE,CAAC,KAAK,EAAE,EAAE;oBAChB,YAAY,CAAC,KAAK,CAAC,CAAC;oBACpB,MAAM,CAAC,KAAK,CAAC,CAAC;gBAChB,CAAC;aACF,CAAC;QACJ,CAAC,CAAC,CAAC;IACL,CAAC;CACF"}

package/dist/voice.d.ts

@@ -1,12 +1,12 @@
-/**
- * Voice capability API
- */
 import type { HTTPClient } from './http.js';
+import { VoiceSession, type VoiceChunkEvent } from './voice-session.js';
+export { VoiceSession, VoiceStreamError, type CloneSpeakOptions, type DesignSpeakOptions, type SpeakOptions, type VoiceChunkEvent, type VoiceSessionOptions, type VoiceSessionState, } from './voice-session.js';
 export interface TTSOptions {
     text: string;
     voice?: string;
     language?: string;
     responseFormat?: string;
+    signal?: AbortSignal;
 }
 export interface CloneOptions {
     text: string;
@@ -27,5 +27,29 @@ export declare class VoiceAPI {
     tts(options: TTSOptions): Promise<Uint8Array>;
     clone(options: CloneOptions): Promise<Uint8Array>;
     design(options: DesignOptions): Promise<Uint8Array>;
+    /**
+     * Create a streaming VoiceSession over /ws/voice (call open() or use ttsStream()).
+     */
+    connect(options?: {
+        timeoutMs?: number;
+    }): VoiceSession;
+    /**
+     * One-shot streaming TTS: opens a session, speaks, closes.
+     */
+    ttsStream(options: TTSOptions & {
+        timeoutMs?: number;
+    }): AsyncGenerator<VoiceChunkEvent, void, undefined>;
+    /**
+     * One-shot streaming voice clone: opens a session, speaks, closes.
+     */
+    cloneStream(options: CloneOptions & {
+        timeoutMs?: number;
+    }): AsyncGenerator<VoiceChunkEvent, void, undefined>;
+    /**
+     * One-shot streaming voice design: opens a session, speaks, closes.
+     */
+    designStream(options: DesignOptions & {
+        timeoutMs?: number;
+    }): AsyncGenerator<VoiceChunkEvent, void, undefined>;
 }
 //# sourceMappingURL=voice.d.ts.map

package/dist/voice.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"voice.d.ts","sourceRoot":"","sources":["../src/voice.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAE5C,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,UAAU,GAAG,WAAW,CAAC;IACnC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAOD,qBAAa,QAAQ;IACP,OAAO,CAAC,IAAI;gBAAJ,IAAI,EAAE,UAAU;IAE9B,GAAG,CAAC,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC;IAS7C,KAAK,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,UAAU,CAAC;IAUjD,MAAM,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,UAAU,CAAC;CAQ1D"}
+{"version":3,"file":"voice.d.ts","sourceRoot":"","sources":["../src/voice.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAC5C,OAAO,EAAE,YAAY,EAAE,KAAK,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAExE,OAAO,EACL,YAAY,EACZ,gBAAgB,EAChB,KAAK,iBAAiB,EACtB,KAAK,kBAAkB,EACvB,KAAK,YAAY,EACjB,KAAK,eAAe,EACpB,KAAK,mBAAmB,EACxB,KAAK,iBAAiB,GACvB,MAAM,oBAAoB,CAAC;AAE5B,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,UAAU,GAAG,WAAW,CAAC;IACnC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAgBD,qBAAa,QAAQ;IACP,OAAO,CAAC,IAAI;gBAAJ,IAAI,EAAE,UAAU;IAE9B,GAAG,CAAC,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC;IAS7C,KAAK,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,UAAU,CAAC;IAUjD,MAAM,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,UAAU,CAAC;IASzD;;OAEG;IACH,OAAO,CAAC,OAAO,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,YAAY;IAQvD;;OAEG;IACI,SAAS,CAAC,OAAO,EAAE,UAAU,GAAG;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,cAAc,CAAC,eAAe,EAAE,IAAI,EAAE,SAAS,CAAC;IAgBhH;;OAEG;IACI,WAAW,CAAC,OAAO,EAAE,YAAY,GAAG;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,cAAc,CAAC,eAAe,EAAE,IAAI,EAAE,SAAS,CAAC;IAiBpH;;OAEG;IACI,YAAY,CAAC,OAAO,EAAE,aAAa,GAAG;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,cAAc,CAAC,eAAe,EAAE,IAAI,EAAE,SAAS,CAAC;CAevH"}