@hubtalk-ai/web-sdk 0.2.0

package/dist/voice-client.d.ts

@@ -0,0 +1,84 @@
+import type { AgentState, ConnectionState, StartCallOptions, StartCallParams, VoiceClientEventHandler, VoiceClientEventName, VoiceClientOptions } from './types';
+export declare class VoiceClient {
+    private readonly emitter;
+    private readonly audio;
+    private readonly log;
+    private readonly connectTimeoutMs?;
+    private connectionState;
+    private agentState;
+    private room;
+    private callId;
+    private playAudio;
+    private stoppingLocally;
+    private reconnectSeen;
+    private destroyed;
+    private roomCleanup;
+    constructor(options?: VoiceClientOptions);
+    getState(): ConnectionState;
+    getAgentState(): AgentState;
+    getCallId(): string | null;
+    on<E extends VoiceClientEventName>(event: E, handler: VoiceClientEventHandler<E>): void;
+    off<E extends VoiceClientEventName>(event: E, handler: VoiceClientEventHandler<E>): void;
+    once<E extends VoiceClientEventName>(event: E, handler: VoiceClientEventHandler<E>): void;
+    /**
+     * `options.audio === false` — chat-only call: микрофон не публикуется,
+     * аудио агента не подписывается (см. connectRoom). Текст в обе стороны
+     * идёт как обычно — `sendText` и событие `transcript`.
+     *
+     * Аудио агента при этом ПОДПИСЫВАЕТСЯ и просто не проигрывается — это не
+     * расточительность, а единственный работающий вариант с livekit-agents
+     * 1.6.4: `_ParticipantAudioOutput.capture_frame` ждёт `_subscribed_fut`
+     * (room_io/_output.py:92), который закрывается только по
+     * `publication.wait_for_subscription()`. Без подписчика первый же кадр
+     * TTS блокируется навсегда, а вместе с ним умирает и текст: транскрипт
+     * агента идёт через TranscriptSynchronizer, привязанный к тому же
+     * аудио-выходу (room_io.py:163-166). Наблюдалось как «агент мигает
+     * thinking -> listening и молчит», при том что эхо реплик посетителя
+     * приходило — у него своя, несинхронизированная ветка вывода.
+     *
+     * ponytail: платит трафиком и TTS за то, что никто не слышит. Убирается
+     * только на стороне платформы — RoomOutputOptions(audio_enabled=False) по
+     * флагу звонка, тогда текст пойдёт сразу и синтеза не будет вовсе.
+     */
+    startCall(params: StartCallParams, options?: StartCallOptions): Promise<void>;
+    private validateStartParams;
+    private connectRoom;
+    private abandonConnectingCall;
+    private publishMicrophone;
+    /**
+     * Отправляет текстовую реплику посетителя в разговор (VPT-108 §2.1).
+     * Своё сообщение в чат SDK не кладёт — его вернёт агент событием
+     * `transcript` с role: 'user' (§2.4): один источник правды и один порядок.
+     */
+    sendText(text: string): Promise<void>;
+    stopCall(): Promise<void>;
+    destroy(): void;
+    private wireRoomEvents;
+    /**
+     * Разбор одного сегмента транскрипта (VPT-108 §1.3). Роль определена
+     * вызывающим — сравнением identity потока с локальным участником.
+     *
+     * Одна реплика приходит несколькими потоками с общим `lk.segment_id`
+     * (тот же дефект-дубль, что закрывался в №50 §9), поэтому пузырь
+     * сшивается по нему, а не по потоку. Чанки копятся ВНУТРИ потока, а текст
+     * потока ЗАМЕНЯЕТ текст сегмента: у реплик посетителя каждый поток несёт
+     * полный текст на момент отправки, а не хвост (`_ParticipantTranscription
+     * Output(is_delta_stream=False)`), и дописывание удвоило бы реплику.
+     *
+     * `final` — из атрибута `lk.transcription_final`, а не из факта закрытия
+     * потока: дельта-поток закрывается штатно, будучи нефинальным. У потока
+     * агента `true` приходит в трейлере, и livekit-client домешивает атрибуты
+     * трейлера в `reader.info` перед закрытием — поэтому читаем атрибут ПОСЛЕ
+     * цикла чтения.
+     */
+    private readTranscriptSegment;
+    private applyLkConnectionState;
+    private handleDisconnected;
+    private teardownRoom;
+    private syncAgentState;
+    private setConnectionState;
+    private setAgentState;
+    /** Переводит ось соединения (если нужно), логирует и эмитит error (§1.4);
+     * возвращает VoiceCallError — вызывающий сам решает throw или нет. */
+    private raiseError;
+}

package/package.json

@@ -0,0 +1,40 @@
+{
+  "name": "@hubtalk-ai/web-sdk",
+  "version": "0.2.0",
+  "description": "Browser SDK for WebRTC voice calls with a HubTalk Conversation Flow agent (thin wrapper over livekit-client + POST /v1/calls/web).",
+  "license": "UNLICENSED",
+  "publishConfig": {
+    "access": "public"
+  },
+  "type": "module",
+  "sideEffects": false,
+  "files": [
+    "dist"
+  ],
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "scripts": {
+    "build": "vite build && vite build --config vite.bundle.config.ts && tsc -p tsconfig.build.json",
+    "prepublishOnly": "npm run build",
+    "lint": "eslint src",
+    "format": "prettier --write src",
+    "format:check": "prettier --check src"
+  },
+  "dependencies": {
+    "livekit-client": "^2.20.0"
+  },
+  "devDependencies": {
+    "eslint": "^10.7.0",
+    "prettier": "^3.9.6",
+    "typescript": "^5.5.4",
+    "typescript-eslint": "^8.65.0",
+    "vite": "^5.4.6"
+  }
+}