@bittersmilezzz/dsh-asr-voice 0.3.1

package/lib/presets.js.map

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

package/lib/realtime-dashscope.js

@@ -0,0 +1,211 @@
+/** 建连/关闭兜底超时（毫秒）：本机回环远低于此，云端握手一般也在内。 */
+const CONNECT_TIMEOUT_MS = 15_000;
+/** close() 后等 `session.finished` 的最长期限：服务端要先吐完在途 final。 */
+const CLOSE_GRACE_MS = 3_000;
+/** 默认 VAD：官方推荐值（低阈值灵敏度高，400ms 断句响应快）。 */
+const DEFAULT_VAD = { threshold: 0.0, silenceDurationMs: 400 };
+/** 一条与 qwen3-asr-flash-realtime 的实时连接。 */
+class DashscopeRealtimeConnection {
+    opts;
+    /** CONNECTING 期上行缓冲上限：40ms 帧 ≈ 1.3s 语音；满了丢最旧（保新不保旧）。 */
+    static PENDING_AUDIO_CAP = 32;
+    ws;
+    closed = false;
+    sessionUpdateSent = false;
+    /** 建连超时：close() 也要清（否则连接在 CONNECTING 中被关，15s 后 fail() 空转一次）。 */
+    connectTimer;
+    /** CONNECTING 期暂存的待发音频帧（有界；open 后按序冲刷，会话开头的帧不丢）。 */
+    pendingAudio = [];
+    onEvent = null;
+    constructor(url, opts) {
+        this.opts = opts;
+        this.ws = new WebSocket(url, { headers: { Authorization: `Bearer ${opts.apiKey}` } });
+        const fail = (code) => {
+            if (this.closed)
+                return;
+            this.closed = true;
+            clearTimeout(this.connectTimer);
+            this.pendingAudio.length = 0; // 未送出的缓冲帧随连接作废
+            try {
+                this.ws.close();
+            }
+            catch { /* already closed */ }
+            // 本地能确定的终态：超时/不可达后连接已废，此后不会再有 final。
+            this.onEvent?.({ type: 'error', code, fatal: true });
+        };
+        this.connectTimer = setTimeout(() => fail('provider-timeout'), opts.connectTimeoutMs ?? CONNECT_TIMEOUT_MS);
+        this.ws.onopen = () => {
+            clearTimeout(this.connectTimer);
+            if (this.closed)
+                return;
+            this.sendSessionUpdate();
+            // 协议要求 session.update 先行：冲刷必须在 sendSessionUpdate 之后。
+            try {
+                this.flushPendingAudio();
+            }
+            catch { /* socket died during flush */ }
+        };
+        this.ws.onerror = () => {
+            clearTimeout(this.connectTimer);
+            fail('provider-unreachable');
+        };
+        this.ws.onclose = (ev) => {
+            clearTimeout(this.connectTimer);
+            // closed 已置位 = 由 close()/fail() 主动收尾（graceful 或已报过错），不重复报。
+            // 走到这里 = 对端主动关闭且未报过错，用**规范定义的 wasClean**（关闭握手是否
+            // 走完）分辨两种收尾：
+            //   wasClean=false（code 1006）= 握手没走完 = RST/销毁式断连 → provider-unreachable
+            //   wasClean=true（code 1000 等）= 对端正常挥手关闭 → provider-closed
+            // 不能靠「onerror 有没有先到」来区分：undici 对销毁式断连是否补发 error 随 Node
+            // 版本而变（22 只发 close、26 先发 error），同一个异常断连会因此在 22 上报
+            // provider-closed、在 26 上报 provider-unreachable——实测两版 wasClean 一致，
+            // 才是可依赖的判据。
+            if (this.closed)
+                return;
+            this.closed = true;
+            // 对端已关连接 = 终态（fatal）：此后不可能再有 final，host 据它收尾会话。
+            this.onEvent?.({ type: 'error', code: ev.wasClean === false ? 'provider-unreachable' : 'provider-closed', fatal: true });
+        };
+        this.ws.onmessage = (msg) => {
+            if (this.closed)
+                return;
+            const ev = this.mapServerEvent(String(msg.data));
+            if (ev !== null)
+                this.onEvent?.(ev);
+        };
+    }
+    /** 连接建立后第一时间发 session.update（pcm/16000/server_vad）。 */
+    sendSessionUpdate() {
+        if (this.sessionUpdateSent || this.closed)
+            return;
+        this.sessionUpdateSent = true;
+        const { vad } = this.opts;
+        const v = vad === undefined ? DEFAULT_VAD : { ...DEFAULT_VAD, ...vad };
+        const session = {
+            input_audio_format: 'pcm',
+            sample_rate: 16000,
+            turn_detection: { type: 'server_vad', threshold: v.threshold, silence_duration_ms: v.silenceDurationMs },
+        };
+        if (this.opts.language !== undefined && this.opts.language !== '') {
+            session.input_audio_transcription = { language: this.opts.language };
+        }
+        this.sendRaw({ type: 'session.update', session });
+    }
+    /** 上行一段 int16 LE PCM：base64 后走 input_audio_buffer.append。 */
+    send(pcm) {
+        if (this.closed || pcm.byteLength === 0)
+            return;
+        if (this.ws.readyState !== WebSocket.OPEN) {
+            // CONNECTING（会话开头 ~100-500ms 握手窗口）：帧进有界缓冲，open 后按序冲刷，
+            // 不再静默丢弃——否则开麦头几百毫秒的语音直接蒸发。缓冲满丢最旧（实时音频
+            // 没有重放价值，保新不保旧）；CLOSING/CLOSED 无意义，维持丢弃。
+            if (this.ws.readyState !== WebSocket.CONNECTING)
+                return;
+            if (this.pendingAudio.length >= DashscopeRealtimeConnection.PENDING_AUDIO_CAP)
+                this.pendingAudio.shift();
+            this.pendingAudio.push(pcm);
+            return;
+        }
+        this.flushPendingAudio();
+        const base64 = Buffer.from(pcm.buffer, pcm.byteOffset, pcm.byteLength).toString('base64');
+        this.sendRaw({ type: 'input_audio_buffer.append', audio: base64 });
+    }
+    /** 把 CONNECTING 期缓冲的音频帧按序送出（open 后调用；随帧转 base64，不提前编码）。 */
+    flushPendingAudio() {
+        if (this.pendingAudio.length === 0)
+            return;
+        const frames = this.pendingAudio.splice(0);
+        for (const frame of frames) {
+            const base64 = Buffer.from(frame.buffer, frame.byteOffset, frame.byteLength).toString('base64');
+            this.sendRaw({ type: 'input_audio_buffer.append', audio: base64 });
+        }
+    }
+    /** 结束会话（幂等）：先发 session.finish，等 session.finished 或超时再关 WS。 */
+    close() {
+        if (this.closed)
+            return;
+        this.closed = true;
+        clearTimeout(this.connectTimer);
+        // VAD 模式下必须先发 session.finish 再关连接，否则服务端丢弃在途 final。
+        try {
+            this.sendRaw({ type: 'session.finish' });
+        }
+        catch { /* socket gone */ }
+        const dispose = () => {
+            // 兜底关闭也要摘掉监听：收尾期间加的 onFinished 挂在 ws 上，不摘会随连接
+            // 一起滞留到 GC，且 session.finished 迟到时会 clear 一个已触发的 timer（无害
+            // 但仍是无效操作）。幂等：ws.close() 对已关连接无副作用。
+            this.ws.removeEventListener('message', onFinished);
+            try {
+                this.ws.close();
+            }
+            catch { /* already closed */ }
+        };
+        // 收到 session.finished 提前关；到点兜底强制关。
+        const timer = setTimeout(dispose, CLOSE_GRACE_MS);
+        const onFinished = (msg) => {
+            try {
+                const parsed = JSON.parse(String(msg.data));
+                if (parsed.type === 'session.finished') {
+                    clearTimeout(timer);
+                    this.ws.removeEventListener('message', onFinished);
+                    dispose();
+                }
+            }
+            catch { /* non-JSON (ping etc.) ignore */ }
+        };
+        this.ws.addEventListener('message', onFinished);
+    }
+    /** 发一条客户端事件（JSON 文本帧）。 */
+    sendRaw(payload) {
+        this.ws.send(JSON.stringify(payload));
+    }
+    /** 服务端事件 → 接缝事件；无关事件（session.created/updated 等）返回 null。 */
+    mapServerEvent(raw) {
+        let parsed;
+        try {
+            parsed = JSON.parse(raw);
+        }
+        catch {
+            return null; // 非 JSON（心跳注释等）忽略
+        }
+        switch (parsed.type) {
+            case 'input_audio_buffer.speech_started':
+                return { type: 'speech-started' };
+            case 'input_audio_buffer.speech_stopped':
+                return { type: 'speech-stopped' };
+            case 'conversation.item.input_audio_transcription.text':
+                // text=已确认前缀 + stash=仍在处理的草稿后缀：拼接才是当前完整预览。
+                return { type: 'partial', text: `${parsed.text ?? ''}${parsed.stash ?? ''}` };
+            case 'conversation.item.input_audio_transcription.completed':
+                return { type: 'final', text: parsed.transcript ?? '' };
+            case 'conversation.item.input_audio_transcription.failed':
+                // 单条音频转写失败：连接与后续回合不受影响，标 fatal=false 让 host 别拆会话。
+                return { type: 'error', code: 'transcription-failed', fatal: false };
+            case 'error':
+                // 通用 error（官方文档：含 invalid_request_error 等客户端参数错，示例为 model 名非法）——
+                // 文档未声明会话终止，连接可能仍可用，故**不判终态**：拆会话会因一次可恢复错误掐掉
+                // 整场对话。是否结束交给客户端既有的连败阈值（CLOUD_FAIL_LIMIT）。
+                return { type: 'error', code: parsed.error?.code ?? 'provider-error', fatal: false };
+            case 'session.finished':
+                // 服务端收尾完成：连接使命结束，本地不必再报错（close() 兜底会关）。
+                return null;
+            default:
+                return null; // session.created/updated/committed/item.created 等不需要
+        }
+    }
+}
+/** 真云端实时 provider 工厂（I5：host 侧 createProvider 用它）。 */
+export function createDashscopeRealtimeProvider(opts) {
+    const wssUrl = (opts.wssUrl ?? 'wss://dashscope.aliyuncs.com/api-ws/v1/realtime').replace(/\/+$/, '');
+    const model = opts.model ?? 'qwen3-asr-flash-realtime';
+    const url = `${wssUrl}?model=${encodeURIComponent(model)}`;
+    return {
+        connect: async () => {
+            if (!opts.apiKey)
+                throw new Error('dashscope realtime: no API key');
+            return new DashscopeRealtimeConnection(url, opts);
+        },
+    };
+}
+//# sourceMappingURL=realtime-dashscope.js.map

package/lib/realtime-dashscope.js.map

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

package/lib/realtime-host.js

@@ -0,0 +1,413 @@
+/** dsh-asr-voice — host 半区：实时转写会话注册表 + SSE 下行（I3 交付）。
+ * 纯管道：浏览器 PCM 上行（POST audio）→ RealtimeProvider 接缝 → SSE 下行
+ * （GET events）。`sid` 由 **host 铸造**（crypto.randomUUID），客户端只拿到
+ * 不透明 token，无法伪造会话；4 条 exact 路由全部过 `isTrusted` 信任围栏。
+ * 会话生命周期：
+ * - POST   /api/asr-voice/realtime/session   → { ok, sid }（建会话）
+ * - POST   /api/asr-voice/realtime/audio     → { ok }（PCM 上行，?sid=…）
+ * - GET    /api/asr-voice/realtime/events    → SSE 下行（?sid=…）
+ * - POST   /api/asr-voice/realtime/close     → { ok }（关会话，?sid=…）
+ * 4 条路由路径互不相同：webserver 的 register 对重复 (kind, path) 直接抛错，
+ * 同一路径挂两个 method 会撞——所以关闭走独立的 /close 路径而不是 /session 的 DELETE。
+ * SSE 背压：Node `res.write()` 返回 false 表示内核缓冲已满（下行慢于上行）。
+ * 这里不无限缓冲——partial（可丢的中间结果）coalesce 成最新一条，final /
+ * speech-stopped（不可丢的回合边界）**必须**最终送达。drain 后按序冲刷。
+ * 每会话一条 SSE（浏览器是单一消费者）；SSE 断开 / 会话超时都会拆掉整个会话，
+ * 防止麦克风数据在 host 侧无人认领地堆积。
+ */
+import { randomUUID } from 'node:crypto';
+import { guardRoute, readRawBody, sendJson, statusOfBodyError } from "./http.js";
+/** 单次 PCM 上行体上限（16k int16 ≈ 每 100ms 3200B；40ms 帧 1280B）。 */
+const MAX_PCM_BYTES = 4 * 1024 * 1024;
+/** 会话空闲上限（毫秒）：没有数据进来也没有消费者，自动拆会话防泄漏。 */
+const DEFAULT_SESSION_IDLE_MS = 10 * 60 * 1000;
+/** 上游终态报错后的收尾宽限期（毫秒）：错误帧入队后给它这段时间送达客户端（SSE 若正
+ *  背压则等 drain 冲刷），到点无条件拆会话。设短值即可——客户端收到错误帧后自己会走
+ *  failNow → /close；这个宽限只是「客户端没反应」时的兜底，不是正常路径。 */
+const ERROR_LINGER_MS = 5_000;
+/** SSE 下行通道：带背压（partial 原位合并 / final 必达）与心跳。 */
+export class SseChannel {
+    res;
+    backedUp = false;
+    /** 背压期间排队待发的事件（有界）。partial 会被更新的 partial 原位替换（coalesce），
+     *  final/speech-stopped 追加保序——drain 后按序冲刷，**任何 final 都不丢**。
+     *  此前单一 coalesce 槽会被后续 final/partial 直接覆盖：背压中连续两句收口时，
+     *  第一句的 final 被第二句顶掉，客户端永远只看到 partial（缺句）。 */
+    pending = [];
+    /** pending 上限：与会话侧 pending 缓冲同量级；极端积压（客户端几乎不读）时丢最旧
+     *  事件降级，会话最终由 disconnect / 空闲守卫拆除。 */
+    static PENDING_CAP = 64;
+    closed = false;
+    /** 空闲心跳：防止中间代理把长连接掐掉（部分代理 30s 无数据即断）。 */
+    heartbeat = null;
+    onDisconnect;
+    /** 当前挂着的 drain 监听（close/disconnect 时移除，避免监听随响应滞留到 GC）。 */
+    drainHandler = null;
+    constructor(res, opts = {}) {
+        this.res = res;
+        this.onDisconnect = opts.onDisconnect ?? null;
+        const hb = opts.heartbeatMs ?? 15_000;
+        if (hb > 0) {
+            this.heartbeat = setInterval(() => {
+                if (!this.closed && !this.backedUp) {
+                    try {
+                        this.res.write(': ping\n\n');
+                    }
+                    catch { /* socket gone */ }
+                }
+            }, hb);
+        }
+        res.on('close', this.disconnect);
+    }
+    /** 排入一条事件：空闲直写；背压时 partial 原位合并、final/stopped 排队保序。
+     *  命中背压的那一条**已经写出**（`write` 返回 false 只是「别再写了」，不是「没写」），
+     *  所以队列只兜住背压期间新到的事件，等 drain 恢复后按序送出。 */
+    enqueue(ev) {
+        if (this.closed)
+            return;
+        if (ev.type === 'partial') {
+            // partial 可丢：只保留同句最新一条。队尾是 partial 就原位替换（不后移，
+            // 保持与后续 final 的相对顺序——否则迟到的 partial 会排到 final 之后，
+            // 客户端先收 final 再收旧 partial，字幕倒退）。
+            const tail = this.pending[this.pending.length - 1];
+            if (tail?.type === 'partial') {
+                this.pending[this.pending.length - 1] = ev;
+                return;
+            }
+            this.pending.push(ev);
+        }
+        else {
+            // final / speech-stopped 不可丢：先丢队尾的 partial——它们是刚收口这句的
+            // 预览，final 到达后冗余（且晚到的 final 若排在 partial 之后会让客户端
+            // 字幕倒退）；再入队保序，任何 final 都最终送达。
+            while (this.pending.length > 0) {
+                const tail = this.pending[this.pending.length - 1];
+                if (tail === undefined || tail.type !== 'partial')
+                    break;
+                this.pending.pop();
+            }
+            this.pending.push(ev);
+        }
+        // 有界：极端积压（客户端几乎不读）时降级防无界增长（会话最终由 disconnect /
+        // 空闲守卫拆除）。降级顺序不能破坏「final 必达」契约：先丢队尾 partial（可丢的
+        // 中间结果，final 到达后冗余），只有整队都是 final（不可丢的回合边界）才丢最旧
+        // 一条——新来的事件绝不顶掉已入队的 final。
+        if (this.pending.length > SseChannel.PENDING_CAP) {
+            while (this.pending.length > SseChannel.PENDING_CAP) {
+                const tail = this.pending[this.pending.length - 1];
+                if (tail === undefined || tail.type !== 'partial')
+                    break;
+                this.pending.pop();
+            }
+            if (this.pending.length > SseChannel.PENDING_CAP)
+                this.pending.shift();
+        }
+        // 空闲（无背压）才立即冲刷：背压中只入队等 drain 恢复后按序送出。
+        if (!this.backedUp)
+            this.flush();
+    }
+    /** 按序冲刷排队的事件（final 不丢、partial 保最新）；缓冲满则挂 drain 等恢复。
+     *  **`write()` 返回 false 只表示内核缓冲已超高水位，事件本身已被接受并会送出**——
+     *  因此出队与返回值无关：先出队再据返回值置背压标志。早先「返回 false 就不出队」的
+     *  写法会让同一条事件在 drain 后被再写一遍（partial 重放无害，final 重放会让客户端
+     *  把同一个回合提交两次）。 */
+    flush() {
+        if (this.closed || this.backedUp)
+            return;
+        while (this.pending.length > 0) {
+            const ev = this.pending[0];
+            const payload = `data: ${JSON.stringify(ev)}\n\n`;
+            let ok = false;
+            try {
+                ok = this.res.write(payload);
+            }
+            catch {
+                this.disconnect();
+                return;
+            }
+            this.pending.shift();
+            if (!ok) {
+                this.backedUp = true;
+                this.armDrain();
+                return;
+            }
+        }
+        this.backedUp = false;
+    }
+    /** 挂一次 drain 监听（同一时间只挂一个；close/disconnect 时摘掉）。 */
+    armDrain() {
+        if (this.drainHandler !== null)
+            return;
+        this.drainHandler = () => {
+            this.drainHandler = null;
+            // drain = 内核缓冲已回落到水位之下：先解除背压态，flush 才会真的往下写
+            //（flush 自身对背压态早退，避免在背压中反复重试）。
+            this.backedUp = false;
+            this.flush();
+        };
+        this.res.once('drain', this.drainHandler);
+    }
+    /** 结束下行（幂等）：清心跳、断 close/drain 监听。 */
+    close() {
+        if (this.closed)
+            return;
+        this.closed = true;
+        if (this.heartbeat !== null)
+            clearInterval(this.heartbeat);
+        this.heartbeat = null;
+        this.res.removeListener('close', this.disconnect);
+        if (this.drainHandler !== null)
+            this.res.removeListener('drain', this.drainHandler);
+        this.drainHandler = null;
+        try {
+            this.res.end();
+        }
+        catch { /* already ended */ }
+    }
+    disconnect = () => {
+        if (this.closed)
+            return;
+        this.closed = true;
+        if (this.heartbeat !== null)
+            clearInterval(this.heartbeat);
+        this.heartbeat = null;
+        this.res.removeListener('close', this.disconnect);
+        if (this.drainHandler !== null)
+            this.res.removeListener('drain', this.drainHandler);
+        this.drainHandler = null;
+        this.onDisconnect?.();
+    };
+}
+/** 实时转写会话注册表 + 路由。 */
+export class RealtimeHost {
+    sessions = new Map();
+    opts;
+    createProvider;
+    constructor(options) {
+        this.createProvider = options.createProvider;
+        this.opts = {
+            idleMs: options.idleMs ?? DEFAULT_SESSION_IDLE_MS,
+            heartbeatMs: options.heartbeatMs ?? 15_000,
+            errorLingerMs: options.errorLingerMs ?? ERROR_LINGER_MS,
+            now: options.now ?? Date.now,
+        };
+    }
+    /** 铸造新会话：host 生成 sid，建 provider 连接。 */
+    async createSession() {
+        const sid = randomUUID();
+        const conn = await this.createProvider();
+        const session = { sid, conn, sse: null, pending: [], lastActive: this.opts.now(), idleTimer: null, errored: false };
+        // provider 事件统一走同一个收口：无 SSE 时缓冲（有界），挂上后冲刷。
+        conn.onEvent = (ev) => {
+            const s = this.sessions.get(sid);
+            if (s === undefined)
+                return;
+            if (s.sse !== null) {
+                s.sse.enqueue(ev);
+            }
+            else {
+                s.pending.push(ev);
+                if (s.pending.length > 64)
+                    s.pending.shift();
+            }
+            // 终态报错（连接已死）才收尾：错误帧先入队（无 SSE 时留缓冲，等 SSE 挂上补送），
+            // 再进入宽限拆除。非终态错误（如单条转写失败）不动会话——连接还活着，后续回合
+            // 照常，拆掉等于用户说错一句就掐掉整场对话。注意这个判定必须在「SSE 已挂」分支
+            // 之外：SSE 挂着才是常态，放在分支里等于永不收尾。
+            if (ev.type === 'error' && ev.fatal !== false)
+                this.armErrorTeardown(sid);
+        };
+        this.sessions.set(sid, session);
+        this.armIdle(sid);
+        return { sid };
+    }
+    /** 上游终态报错后的收尾：标记会话已终结 + 把空闲窗口收紧到 ERROR_LINGER_MS。
+     *  修的是「僵尸会话」：此前 provider 报错后 host 不拆会话，客户端仍在按 40ms 一帧
+     *  上行 PCM，每帧 `feedAudio` → `refreshIdle` 都把 lastActive 顶到现在——死连接的
+     *  会话因此永远等不到空闲过期，SSE 一直挂着、麦克风一直开。 */
+    armErrorTeardown(sid) {
+        const s = this.sessions.get(sid);
+        if (s === undefined || s.errored)
+            return;
+        s.errored = true;
+        s.lastActive = this.opts.now();
+        this.armIdle(sid, this.opts.errorLingerMs);
+    }
+    /** 空闲守卫：到点复查——期间有任何上行/下行活动会走 refreshIdle 重挂， 真正空闲满 windowMs 才拆会话防泄漏（默认 idleMs；上游终态报错后用更短的收尾宽限）。 */
+    armIdle(sid, windowMs = this.opts.idleMs) {
+        const s = this.sessions.get(sid);
+        if (s === undefined)
+            return;
+        if (s.idleTimer !== null)
+            clearTimeout(s.idleTimer);
+        s.idleTimer = setTimeout(() => {
+            const cur = this.sessions.get(sid);
+            if (cur === undefined)
+                return;
+            const idle = this.opts.now() - cur.lastActive;
+            if (idle >= windowMs)
+                this.closeSession(sid);
+            else
+                this.armIdle(sid, windowMs);
+        }, windowMs);
+    }
+    /** 刷新空闲计时（每次上行/下行活动调用）。已终结的会话不续命——否则死连接被
+     *  客户端的持续上行"续命"，永远到不了过期点。 */
+    refreshIdle(sid) {
+        const s = this.sessions.get(sid);
+        if (s === undefined || s.errored)
+            return;
+        s.lastActive = this.opts.now();
+        this.armIdle(sid);
+    }
+    /** 上行 PCM（16k int16 LE）到指定会话。会话不存在**或上游已终态报错**返回 false
+     *  （路由据此回 404，客户端停止上行）。 */
+    feedAudio(sid, pcm) {
+        const s = this.sessions.get(sid);
+        if (s === undefined || s.errored)
+            return false;
+        this.refreshIdle(sid);
+        s.conn.send(pcm);
+        return true;
+    }
+    /** 挂起 SSE 下行（单消费者）。会话不存在 / 已有下行返回 false。 */
+    attachSse(sid, res) {
+        const s = this.sessions.get(sid);
+        if (s === undefined || s.sse !== null)
+            return false;
+        this.refreshIdle(sid);
+        const channel = new SseChannel(res, {
+            heartbeatMs: this.opts.heartbeatMs,
+            onDisconnect: () => this.closeSession(sid),
+        });
+        s.sse = channel;
+        // 冲刷挂 SSE 前缓冲的上游事件（上行先于下行的部分不丢）。
+        if (s.pending.length > 0) {
+            for (const ev of s.pending)
+                channel.enqueue(ev);
+            s.pending = [];
+        }
+        return true;
+    }
+    /** 关闭会话：拆 provider、拆 SSE、清定时器（幂等）。 */
+    closeSession(sid) {
+        const s = this.sessions.get(sid);
+        if (s === undefined)
+            return;
+        this.sessions.delete(sid);
+        if (s.idleTimer !== null)
+            clearTimeout(s.idleTimer);
+        s.idleTimer = null;
+        s.sse?.close();
+        s.sse = null;
+        s.conn.onEvent = null;
+        try {
+            s.conn.close();
+        }
+        catch { /* noop */ }
+    }
+    /** 会话是否存活（供测试/诊断）。 */
+    hasSession(sid) {
+        return this.sessions.has(sid);
+    }
+    /** 释放全部会话（插件卸载/热重载时由 fiber disposer 调用）：逐个 closeSession
+     *  （幂等），SSE 心跳、idle timer、provider 连接全部随之释放。 */
+    dispose() {
+        for (const sid of [...this.sessions.keys()])
+            this.closeSession(sid);
+    }
+    /** 注册 4 条 exact 路由（全部过 isTrusted）。 @returns 全部路由的 disposer（由 ctx.effect 挂载/回收）。 */
+    registerRoutes(register) {
+        const disposers = [
+            register({
+                kind: 'exact',
+                path: '/api/asr-voice/realtime/session',
+                handler: async (req, res) => {
+                    const denied = guardRoute(req);
+                    if (denied !== null)
+                        return sendJson(res, denied.status, denied.payload);
+                    try {
+                        const { sid } = await this.createSession();
+                        return sendJson(res, 200, { ok: true, sid });
+                    }
+                    catch (error) {
+                        return sendJson(res, 502, { ok: false, reason: error instanceof Error ? error.message : String(error) });
+                    }
+                },
+            }),
+            register({
+                kind: 'exact',
+                path: '/api/asr-voice/realtime/audio',
+                handler: async (req, res) => {
+                    const denied = guardRoute(req);
+                    if (denied !== null)
+                        return sendJson(res, denied.status, denied.payload);
+                    const sid = sidOf(req);
+                    if (sid === '')
+                        return sendJson(res, 400, { ok: false, reason: 'missing sid' });
+                    try {
+                        const pcm = await readRawBody(req, MAX_PCM_BYTES);
+                        if (pcm.length === 0)
+                            return sendJson(res, 400, { ok: false, reason: 'empty audio body' });
+                        if (!this.feedAudio(sid, pcm))
+                            return sendJson(res, 404, { ok: false, reason: 'no such session' });
+                        return sendJson(res, 200, { ok: true });
+                    }
+                    catch (error) {
+                        // 超限/超时是请求侧问题（413/408），其余（含 sid 不存在）仍按 400 口径。
+                        return sendJson(res, statusOfBodyError(error, 400), { ok: false, reason: error instanceof Error ? error.message : String(error) });
+                    }
+                },
+            }),
+            register({
+                kind: 'exact',
+                path: '/api/asr-voice/realtime/events',
+                handler: async (req, res) => {
+                    const denied = guardRoute(req, ['GET']);
+                    if (denied !== null)
+                        return sendJson(res, denied.status, denied.payload);
+                    const sid = sidOf(req);
+                    if (sid === '')
+                        return sendJson(res, 400, { ok: false, reason: 'missing sid' });
+                    if (!this.hasSession(sid))
+                        return sendJson(res, 404, { ok: false, reason: 'no such session' });
+                    // SSE：先把头写出去（背压/断连交给 SseChannel），再挂会话。
+                    res.writeHead(200, {
+                        'content-type': 'text/event-stream; charset=utf-8',
+                        'cache-control': 'no-cache, no-store',
+                        'connection': 'keep-alive',
+                        'x-accel-buffering': 'no',
+                    });
+                    res.flushHeaders();
+                    if (!this.attachSse(sid, res)) {
+                        // 已有下行消费者（或会话刚被拆）：本连接直接收掉。
+                        res.end();
+                    }
+                },
+            }),
+            register({
+                kind: 'exact',
+                path: '/api/asr-voice/realtime/close',
+                handler: async (req, res) => {
+                    const denied = guardRoute(req);
+                    if (denied !== null)
+                        return sendJson(res, denied.status, denied.payload);
+                    const sid = sidOf(req);
+                    if (sid === '')
+                        return sendJson(res, 400, { ok: false, reason: 'missing sid' });
+                    this.closeSession(sid);
+                    return sendJson(res, 200, { ok: true });
+                },
+            }),
+        ];
+        return () => { for (const dispose of disposers)
+            dispose(); };
+    }
+}
+/** 从查询串取 sid（缺省返回空串）。 */
+function sidOf(req) {
+    const url = new URL(req.url ?? '/', 'http://localhost');
+    const sid = url.searchParams.get('sid') ?? '';
+    return sid.trim();
+}
+//# sourceMappingURL=realtime-host.js.map