@hypercli.com/sdk 0.9.1

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

@@ -0,0 +1,64 @@
+export type VoiceTranscriptionSessionState = 'closed' | 'ready' | 'streaming' | 'committed';
+export interface VoiceTranscriptionSessionOptions {
+    /** Agents WS base, e.g. wss://api.agents.hypercli.com/ws */
+    wsUrl: string;
+    /** API key (hyper_api_...) or opaque access token. */
+    credential: string;
+    /** Per-request timeout in milliseconds (default 300 000). */
+    timeoutMs?: number;
+    language?: string;
+    model?: string;
+    responseFormat?: string;
+    prompt?: string;
+}
+export interface TranscriptionStartOptions {
+    language?: string;
+    model?: string;
+    responseFormat?: string;
+    prompt?: string;
+}
+export interface VoiceTranscriptionAckEvent {
+    type: 'ack';
+    [key: string]: unknown;
+}
+export interface VoiceTranscriptDeltaEvent {
+    type: 'transcript.delta';
+    text: string;
+    delta?: string;
+    [key: string]: unknown;
+}
+export interface VoiceTranscriptFinalEvent {
+    type: 'transcript.final';
+    text: string;
+    [key: string]: unknown;
+}
+export type VoiceTranscriptionEvent = VoiceTranscriptionAckEvent | VoiceTranscriptDeltaEvent | VoiceTranscriptFinalEvent;
+export declare class VoiceTranscriptionSession {
+    state: VoiceTranscriptionSessionState;
+    private readonly wsUrl;
+    private readonly credential;
+    private readonly timeoutMs;
+    private readonly transcriptionOptions;
+    private ws;
+    private messages;
+    private waiter;
+    private closeError;
+    constructor(options: VoiceTranscriptionSessionOptions);
+    open(): Promise<this>;
+    close(): void;
+    sendAudio(audio: Uint8Array | ArrayBuffer): void;
+    sendBase64Audio(audio: string | Uint8Array | ArrayBuffer): void;
+    commit(): void;
+    events(): AsyncGenerator<VoiceTranscriptionEvent, void, undefined>;
+    transcribe(audio: Uint8Array | ArrayBuffer | string, options?: {
+        base64?: boolean;
+    }): AsyncGenerator<VoiceTranscriptionEvent, void, undefined>;
+    private sendJson;
+    private connectionUrl;
+    private waitForReady;
+    private parseMessage;
+    private enqueue;
+    private handleClose;
+    private nextMessage;
+}
+//# sourceMappingURL=voice-transcription-session.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"voice-transcription-session.d.ts","sourceRoot":"","sources":["../src/voice-transcription-session.ts"],"names":[],"mappings":"AASA,MAAM,MAAM,8BAA8B,GAAG,QAAQ,GAAG,OAAO,GAAG,WAAW,GAAG,WAAW,CAAC;AAE5F,MAAM,WAAW,gCAAgC;IAC/C,4DAA4D;IAC5D,KAAK,EAAE,MAAM,CAAC;IACd,sDAAsD;IACtD,UAAU,EAAE,MAAM,CAAC;IACnB,6DAA6D;IAC7D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,0BAA0B;IACzC,IAAI,EAAE,KAAK,CAAC;IACZ,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,yBAAyB;IACxC,IAAI,EAAE,kBAAkB,CAAC;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,yBAAyB;IACxC,IAAI,EAAE,kBAAkB,CAAC;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,MAAM,MAAM,uBAAuB,GAC/B,0BAA0B,GAC1B,yBAAyB,GACzB,yBAAyB,CAAC;AAmB9B,qBAAa,yBAAyB;IACpC,KAAK,EAAE,8BAA8B,CAAY;IAEjD,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAC/B,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAA4B;IACjE,OAAO,CAAC,EAAE,CAA0C;IACpD,OAAO,CAAC,QAAQ,CAAgB;IAChC,OAAO,CAAC,MAAM,CAAuB;IACrC,OAAO,CAAC,UAAU,CAAsB;gBAE5B,OAAO,EAAE,gCAAgC;IAY/C,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAqC3B,KAAK,IAAI,IAAI;IAab,SAAS,CAAC,KAAK,EAAE,UAAU,GAAG,WAAW,GAAG,IAAI;IAMhD,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,UAAU,GAAG,WAAW,GAAG,IAAI;IAQ/D,MAAM,IAAI,IAAI;IAKP,MAAM,IAAI,cAAc,CAAC,uBAAuB,EAAE,IAAI,EAAE,SAAS,CAAC;IA+BlE,UAAU,CACf,KAAK,EAAE,UAAU,GAAG,WAAW,GAAG,MAAM,EACxC,OAAO,GAAE;QAAE,MAAM,CAAC,EAAE,OAAO,CAAA;KAAO,GACjC,cAAc,CAAC,uBAAuB,EAAE,IAAI,EAAE,SAAS,CAAC;IAU3D,OAAO,CAAC,QAAQ;IAMhB,OAAO,CAAC,aAAa;YASP,YAAY;IAiB1B,OAAO,CAAC,YAAY;IAepB,OAAO,CAAC,OAAO;IAUf,OAAO,CAAC,WAAW;IAWnB,OAAO,CAAC,WAAW;CAqBpB"}

package/dist/voice-transcription-session.js

@@ -0,0 +1,228 @@
+import { encodeBase64, VoiceStreamError } from './voice-session.js';
+async function loadNodeWebSocket() {
+    const moduleName = 'ws';
+    const mod = await import(moduleName);
+    return (mod.default ?? mod);
+}
+function bytesFromAudio(audio) {
+    return new Uint8Array(audio);
+}
+export class VoiceTranscriptionSession {
+    state = 'closed';
+    wsUrl;
+    credential;
+    timeoutMs;
+    transcriptionOptions;
+    ws = null;
+    messages = [];
+    waiter = null;
+    closeError = null;
+    constructor(options) {
+        this.wsUrl = options.wsUrl.replace(/\/+$/, '');
+        this.credential = options.credential;
+        this.timeoutMs = options.timeoutMs ?? 300_000;
+        this.transcriptionOptions = {
+            language: options.language,
+            model: options.model,
+            responseFormat: options.responseFormat,
+            prompt: options.prompt,
+        };
+    }
+    async open() {
+        if (this.ws)
+            return this;
+        const useBrowserSocket = 'localStorage' in globalThis && typeof WebSocket !== 'undefined';
+        await new Promise((resolve, reject) => {
+            if (useBrowserSocket) {
+                const url = this.connectionUrl();
+                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 transcription WS connection failed'));
+                ws.onclose = (event) => this.handleClose(event.code ?? 1006, String(event.reason ?? ''));
+                return;
+            }
+            loadNodeWebSocket()
+                .then((NodeSocket) => {
+                const ws = new NodeSocket(this.connectionUrl(), {
+                    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() ?? ''));
+            })
+                .catch(() => reject(new Error('WebSocket is not available in this environment')));
+        });
+        await this.waitForReady();
+        this.state = 'ready';
+        return this;
+    }
+    close() {
+        const ws = this.ws;
+        this.ws = null;
+        this.state = 'closed';
+        if (ws) {
+            try {
+                ws.close();
+            }
+            catch {
+                // already closed
+            }
+        }
+    }
+    sendAudio(audio) {
+        if (!this.ws)
+            throw new Error('Session is not connected');
+        this.ws.send(bytesFromAudio(audio));
+        this.state = 'streaming';
+    }
+    sendBase64Audio(audio) {
+        this.sendJson({
+            event: 'audio',
+            audio: typeof audio === 'string' ? audio : encodeBase64(audio),
+        });
+        this.state = 'streaming';
+    }
+    commit() {
+        this.sendJson({ event: 'commit' });
+        this.state = 'committed';
+    }
+    async *events() {
+        if (!this.ws || this.state === 'closed') {
+            throw new Error("Session is not connected; call open() first");
+        }
+        const deadline = Date.now() + this.timeoutMs;
+        while (true) {
+            const remaining = deadline - Date.now();
+            if (remaining <= 0) {
+                throw new VoiceStreamError('timeout', `voice transcription stream timed out after ${this.timeoutMs}ms`);
+            }
+            const message = this.parseMessage(await this.nextMessage(remaining));
+            if (!message)
+                continue;
+            if (message.type === 'error') {
+                throw new VoiceStreamError(String(message.code ?? ''), String(message.detail ?? message.message ?? ''));
+            }
+            if (message.type === 'ack') {
+                yield message;
+                continue;
+            }
+            if (message.type === 'transcript.delta') {
+                yield { ...message, type: 'transcript.delta', text: String(message.text ?? ''), delta: String(message.delta ?? '') };
+                continue;
+            }
+            if (message.type === 'transcript.final') {
+                yield { ...message, type: 'transcript.final', text: String(message.text ?? '') };
+                this.state = this.ws ? 'ready' : 'closed';
+                return;
+            }
+        }
+    }
+    async *transcribe(audio, options = {}) {
+        if (typeof audio === 'string' || options.base64) {
+            this.sendBase64Audio(audio);
+        }
+        else {
+            this.sendAudio(audio);
+        }
+        this.commit();
+        yield* this.events();
+    }
+    sendJson(message) {
+        if (!this.ws)
+            throw new Error('Session is not connected');
+        const body = Object.fromEntries(Object.entries(message).filter(([, value]) => value !== undefined));
+        this.ws.send(JSON.stringify(body));
+    }
+    connectionUrl() {
+        const params = new URLSearchParams({ token: this.credential });
+        if (this.transcriptionOptions.language)
+            params.set('language', this.transcriptionOptions.language);
+        if (this.transcriptionOptions.model)
+            params.set('model', this.transcriptionOptions.model);
+        if (this.transcriptionOptions.responseFormat)
+            params.set('response_format', this.transcriptionOptions.responseFormat);
+        if (this.transcriptionOptions.prompt)
+            params.set('prompt', this.transcriptionOptions.prompt);
+        return `${this.wsUrl}/voice/transcribe?${params.toString()}`;
+    }
+    async waitForReady() {
+        const deadline = Date.now() + this.timeoutMs;
+        while (true) {
+            const remaining = deadline - Date.now();
+            if (remaining <= 0) {
+                throw new VoiceStreamError('timeout', `voice transcription stream timed out after ${this.timeoutMs}ms`);
+            }
+            const message = this.parseMessage(await this.nextMessage(remaining));
+            if (!message)
+                continue;
+            if (message.type === 'ready')
+                return;
+            if (message.type === 'error') {
+                throw new VoiceStreamError(String(message.code ?? ''), String(message.detail ?? message.message ?? ''));
+            }
+            this.messages.push(JSON.stringify(message));
+        }
+    }
+    parseMessage(raw) {
+        try {
+            const message = JSON.parse(raw);
+            if (message.type === undefined && typeof message.event === 'string') {
+                message.type = message.event;
+            }
+            if (message.detail === undefined && typeof message.error === 'string') {
+                message.detail = message.error;
+            }
+            return message;
+        }
+        catch {
+            return null;
+        }
+    }
+    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 transcription 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-transcription-session.js.map

package/dist/voice-transcription-session.js.map

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

package/dist/voice.d.ts

@@ -0,0 +1,62 @@
+import { type HTTPClient } from './http.js';
+import { VoiceSession, type VoiceChunkEvent } from './voice-session.js';
+import { VoiceTranscriptionSession, type TranscriptionStartOptions, type VoiceTranscriptionEvent } from './voice-transcription-session.js';
+export { VoiceSession, VoiceStreamError, type CloneSpeakOptions, type VoiceAudioMetadata, type VoiceChunkEvent, type VoiceSessionOptions, type VoiceSessionState, } from './voice-session.js';
+export { VoiceTranscriptionSession, type TranscriptionStartOptions, type VoiceTranscriptDeltaEvent, type VoiceTranscriptFinalEvent, type VoiceTranscriptionAckEvent, type VoiceTranscriptionEvent, type VoiceTranscriptionSessionOptions, type VoiceTranscriptionSessionState, } from './voice-transcription-session.js';
+export interface CloneOptions {
+    text: string;
+    refAudio: Uint8Array | ArrayBuffer;
+    language?: string;
+    xVectorOnly?: boolean;
+    responseFormat?: string;
+    signal?: AbortSignal;
+}
+export interface TranscribeOptions {
+    audio: Uint8Array | ArrayBuffer | Blob;
+    filename?: string;
+    contentType?: string;
+    language?: string;
+    model?: string;
+    responseFormat?: string;
+    prompt?: string;
+    signal?: AbortSignal;
+}
+export interface TranscriptionResult {
+    text: string;
+    [key: string]: unknown;
+}
+export interface TranscribeStreamOptions {
+    audio: Uint8Array | ArrayBuffer | string;
+    language?: string;
+    model?: string;
+    responseFormat?: string;
+    prompt?: string;
+    base64?: boolean;
+    timeoutMs?: number;
+}
+export declare class VoiceAPI {
+    private http;
+    constructor(http: HTTPClient);
+    clone(options: CloneOptions): Promise<Uint8Array>;
+    transcribe(options: TranscribeOptions): Promise<TranscriptionResult>;
+    /**
+     * Create a streaming VoiceSession over /ws/voice (call open() or use cloneStream()).
+     */
+    connect(options?: {
+        timeoutMs?: number;
+    }): VoiceSession;
+    connectTranscription(options?: TranscriptionStartOptions & {
+        timeoutMs?: number;
+    }): VoiceTranscriptionSession;
+    transcribeStream(options: TranscribeStreamOptions): AsyncGenerator<VoiceTranscriptionEvent, void, undefined>;
+    /**
+     * One-shot streaming voice clone: opens a session, speaks, closes.
+     * Defaults to PCM with automatic incremental negotiation. Older servers may
+     * return known-total chunks. Request an encoded responseFormat for file output;
+     * unlike REST clone(), omitting it no longer requests MP3.
+     */
+    cloneStream(options: CloneOptions & {
+        timeoutMs?: number;
+    }): AsyncGenerator<VoiceChunkEvent, void, undefined>;
+}
+//# sourceMappingURL=voice.d.ts.map

package/dist/voice.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"voice.d.ts","sourceRoot":"","sources":["../src/voice.ts"],"names":[],"mappings":"AAIA,OAAO,EAAsC,KAAK,UAAU,EAAE,MAAM,WAAW,CAAC;AAChF,OAAO,EAAE,YAAY,EAAE,KAAK,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACxE,OAAO,EACL,yBAAyB,EACzB,KAAK,yBAAyB,EAC9B,KAAK,uBAAuB,EAC7B,MAAM,kCAAkC,CAAC;AAE1C,OAAO,EACL,YAAY,EACZ,gBAAgB,EAChB,KAAK,iBAAiB,EACtB,KAAK,kBAAkB,EACvB,KAAK,eAAe,EACpB,KAAK,mBAAmB,EACxB,KAAK,iBAAiB,GACvB,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EACL,yBAAyB,EACzB,KAAK,yBAAyB,EAC9B,KAAK,yBAAyB,EAC9B,KAAK,yBAAyB,EAC9B,KAAK,0BAA0B,EAC/B,KAAK,uBAAuB,EAC5B,KAAK,gCAAgC,EACrC,KAAK,8BAA8B,GACpC,MAAM,kCAAkC,CAAC;AAE1C,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;IACxB,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,UAAU,GAAG,WAAW,GAAG,IAAI,CAAC;IACvC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,uBAAuB;IACtC,KAAK,EAAE,UAAU,GAAG,WAAW,GAAG,MAAM,CAAC;IACzC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAgBD,qBAAa,QAAQ;IACP,OAAO,CAAC,IAAI;gBAAJ,IAAI,EAAE,UAAU;IAE9B,KAAK,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,UAAU,CAAC;IAUjD,UAAU,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,mBAAmB,CAAC;IA+B1E;;OAEG;IACH,OAAO,CAAC,OAAO,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,YAAY;IAQvD,oBAAoB,CAAC,OAAO,CAAC,EAAE,yBAAyB,GAAG;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,yBAAyB;IAYtG,gBAAgB,CACrB,OAAO,EAAE,uBAAuB,GAC/B,cAAc,CAAC,uBAAuB,EAAE,IAAI,EAAE,SAAS,CAAC;IAkB3D;;;;;OAKG;IACI,WAAW,CAAC,OAAO,EAAE,YAAY,GAAG;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,cAAc,CAAC,eAAe,EAAE,IAAI,EAAE,SAAS,CAAC;CAiBrH"}

package/dist/voice.js

@@ -0,0 +1,134 @@
+/**
+ * Voice capability API
+ */
+import { getAgentsWsUrlFromProductBase } from './config.js';
+import { requestWithRetry, responseAPIError } from './http.js';
+import { VoiceSession } from './voice-session.js';
+import { VoiceTranscriptionSession, } from './voice-transcription-session.js';
+export { VoiceSession, VoiceStreamError, } from './voice-session.js';
+export { VoiceTranscriptionSession, } from './voice-transcription-session.js';
+function encodeBase64(bytes) {
+    const data = bytes instanceof Uint8Array ? bytes : new Uint8Array(bytes);
+    if (typeof Buffer !== 'undefined') {
+        return Buffer.from(data).toString('base64');
+    }
+    // Browser fallback: btoa over chunked binary string (avoids arg-limit blowups)
+    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);
+}
+export class VoiceAPI {
+    http;
+    constructor(http) {
+        this.http = http;
+    }
+    async clone(options) {
+        return this.http.postBytes('/voice/clone', {
+            text: options.text,
+            ref_audio_base64: encodeBase64(options.refAudio),
+            language: options.language ?? 'auto',
+            x_vector_only: options.xVectorOnly ?? true,
+            response_format: options.responseFormat ?? 'mp3',
+        }, options.signal ? { signal: options.signal } : {});
+    }
+    async transcribe(options) {
+        const formData = new FormData();
+        const filename = options.filename ?? 'audio';
+        const audio = options.audio instanceof Blob
+            ? options.audio
+            : new Blob([options.audio], {
+                type: options.contentType ?? 'application/octet-stream',
+            });
+        formData.append('file', audio, filename);
+        if (options.language)
+            formData.append('language', options.language);
+        if (options.model)
+            formData.append('model', options.model);
+        if (options.responseFormat)
+            formData.append('response_format', options.responseFormat);
+        if (options.prompt)
+            formData.append('prompt', options.prompt);
+        const response = await requestWithRetry({
+            method: 'POST',
+            url: `${this.http.base}/voice/transcribe`,
+            headers: { Authorization: `Bearer ${this.http.credential}` },
+            body: formData,
+            rawBody: true,
+            signal: options.signal,
+        });
+        if (response.status >= 400)
+            throw await responseAPIError(response, 'POST');
+        const contentType = response.headers.get('content-type') ?? '';
+        if (contentType.includes('application/json')) {
+            const data = await response.json();
+            return { ...data, text: String(data.text ?? data.transcript ?? '') };
+        }
+        return { text: await response.text() };
+    }
+    /**
+     * Create a streaming VoiceSession over /ws/voice (call open() or use cloneStream()).
+     */
+    connect(options) {
+        return new VoiceSession({
+            wsUrl: getAgentsWsUrlFromProductBase(this.http.base),
+            credential: this.http.credential,
+            timeoutMs: options?.timeoutMs,
+        });
+    }
+    connectTranscription(options) {
+        return new VoiceTranscriptionSession({
+            wsUrl: getAgentsWsUrlFromProductBase(this.http.base),
+            credential: this.http.credential,
+            timeoutMs: options?.timeoutMs,
+            language: options?.language,
+            model: options?.model,
+            responseFormat: options?.responseFormat,
+            prompt: options?.prompt,
+        });
+    }
+    async *transcribeStream(options) {
+        const session = this.connectTranscription({
+            timeoutMs: options.timeoutMs,
+            language: options.language,
+            model: options.model,
+            responseFormat: options.responseFormat,
+            prompt: options.prompt,
+        });
+        await session.open();
+        try {
+            yield* session.transcribe(options.audio, {
+                base64: options.base64,
+            });
+        }
+        finally {
+            session.close();
+        }
+    }
+    /**
+     * One-shot streaming voice clone: opens a session, speaks, closes.
+     * Defaults to PCM with automatic incremental negotiation. Older servers may
+     * return known-total chunks. Request an encoded responseFormat for file output;
+     * unlike REST clone(), omitting it no longer requests MP3.
+     */
+    async *cloneStream(options) {
+        const session = this.connect({ timeoutMs: options.timeoutMs });
+        await session.open();
+        try {
+            yield* session.speakClone({
+                text: options.text,
+                refAudio: options.refAudio,
+                language: options.language,
+                xVectorOnly: options.xVectorOnly,
+                format: options.responseFormat,
+                chunks: true,
+            });
+        }
+        finally {
+            session.close();
+        }
+    }
+}
+//# sourceMappingURL=voice.js.map

package/dist/voice.js.map

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

package/dist/workspace-tomd.d.ts

@@ -0,0 +1,61 @@
+/**
+ * Parser for the workspaces `/tomd` Markdown document shape: a YAML
+ * frontmatter block between `---` fences carrying typed file metadata, then
+ * a Markdown body. The frontmatter writer is the tomd pipeline's own emitter
+ * (agents/workspaces `_frontmatter_scalar`): scalars are double-quoted
+ * strings, booleans, numbers, or `null`; lists/objects are inline JSON. This
+ * parser is dependency-free and scoped to that emitted shape (plus block
+ * `- item` lists for robustness) so the SDK stays yaml-free.
+ */
+export interface WorkspaceTomdFrontmatter {
+    fileId?: string;
+    path?: string;
+    version?: number;
+    index?: number;
+    partCount?: number;
+    state?: string;
+    keywords?: string[];
+    summary?: string;
+    sizeBytes?: number;
+    contentType?: string;
+    etag?: string;
+    lastModified?: string;
+    createdAt?: string;
+    updatedAt?: string;
+    downloadCommand?: string;
+    detectedType?: string;
+    docType?: string;
+    enriched?: boolean;
+    language?: string;
+    longSummary?: string;
+    pageCount?: number;
+    title?: string;
+    /** Keys not mapped above, kept verbatim (snake_case) so new backend keys never break parsing. */
+    extra: Record<string, unknown>;
+}
+export interface WorkspaceTomdDocument {
+    frontmatter: WorkspaceTomdFrontmatter;
+    /** The Markdown body after the closing frontmatter fence. */
+    body: string;
+    /**
+     * The body minus the sections the tomd pipeline generates from the same
+     * frontmatter (`## Keywords`, `## Summary`, `## Long Summary`,
+     * `## Section Summaries`) — they duplicate a metadata header, so rich
+     * previews render this instead. Everything else, including `## Full Text`,
+     * is kept.
+     */
+    contentBody: string;
+}
+/**
+ * Split a `/tomd` Markdown document into typed frontmatter and body.
+ * Missing or unterminated frontmatter is not an error: the whole input is
+ * treated as the body with an empty frontmatter.
+ */
+export declare function parseWorkspaceTomd(markdown: string): WorkspaceTomdDocument;
+/**
+ * Remove the tomd-generated `## Keywords` / `## Summary` / `## Long Summary`
+ * / `## Section Summaries` sections (each runs until the next level-1/2
+ * heading). Headings inside fenced code blocks are left alone.
+ */
+export declare function stripWorkspaceTomdGeneratedSections(body: string): string;
+//# sourceMappingURL=workspace-tomd.d.ts.map

package/dist/workspace-tomd.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace-tomd.d.ts","sourceRoot":"","sources":["../src/workspace-tomd.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,MAAM,WAAW,wBAAwB;IACvC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,iGAAiG;IACjG,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAChC;AAED,MAAM,WAAW,qBAAqB;IACpC,WAAW,EAAE,wBAAwB,CAAC;IACtC,6DAA6D;IAC7D,IAAI,EAAE,MAAM,CAAC;IACb;;;;;;OAMG;IACH,WAAW,EAAE,MAAM,CAAC;CACrB;AA6BD;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,qBAAqB,CAO1E;AAED;;;;GAIG;AACH,wBAAgB,mCAAmC,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAmBxE"}