@olares/lares-core 0.15.29 → 0.15.30

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@olares/lares-core",
-  "version": "0.15.29",
+  "version": "0.15.30",
   "description": "Lares 共享业务核心：Router、workspace、文件/媒体、Olares 身份（无 UI、无平台壳）",
   "type": "module",
   "repository": {

package/voice/lares-realtime-gateway.js

@@ -20,6 +20,9 @@ const BARGE_IN_LIMIT_MS = 10_000;
 // AudioWorklet keeps a bounded queue; sending a whole answer at network speed
 // overflowed it and dropped audio.
 const PLAY_AHEAD_MS = 2_000;
+// A temporarily interrupted AudioContext (device switch, lock screen) must not
+// end a reply; only a client that stays silent this long is treated as stuck.
+const PLAYOUT_STALL_MS = 30_000;
 const TICKET_MS = 30_000;
 // Usage lives in the child ASR/LLM/TTS requests; the OpenAI shape stays parseable (Router ADR-83).
 const ZERO_USAGE = Object.freeze({ total_tokens: 0, input_tokens: 0, output_tokens: 0, input_token_details: { text_tokens: 0, audio_tokens: 0, cached_tokens: 0 }, output_token_details: { text_tokens: 0, audio_tokens: 0 } });
@@ -179,7 +182,7 @@ export function createLaresRealtimeGateway({ service, config, transcribe, synthe
           if (current.abort.signal.aborted || current.done || closed || client.readyState !== 1) return;
           const heard = played.get(current.itemId) ?? 0;
           if (heard > lastPlayed) { lastPlayed = heard; playedAt = Date.now(); }
-          if (Date.now() - playedAt > 10_000) throw new Error("voice_audio_backpressure");
+          if (Date.now() - playedAt > PLAYOUT_STALL_MS) throw new Error("voice_audio_backpressure");
           await new Promise((resolve) => setTimeout(resolve, 20));
         }
         if (current.abort.signal.aborted || current.done || closed || client.readyState !== 1) return;

package/voice/pcm-player.js

@@ -3,6 +3,21 @@ import { pcmSamples } from "./realtime-audio.js";
 
 let primed = null;
 const worklets = new WeakMap();
+let watchingVisibility = false;
+
+/** iOS/macOS suspend the page's context on a call, the lock screen or a device switch. */
+function resumeIfInterrupted(context) {
+  if (!context || context.state === "closed" || context.state === "running") return;
+  void context.resume?.().catch(() => {});
+}
+
+function watchVisibility() {
+  if (watchingVisibility || typeof document === "undefined" || !document.addEventListener) return;
+  watchingVisibility = true;
+  document.addEventListener("visibilitychange", () => {
+    if (document.visibilityState === "visible") resumeIfInterrupted(primed);
+  });
+}
 
 function ensureWorklet(ctx) {
   const pending = worklets.get(ctx);
@@ -35,7 +50,9 @@ export function createPcmStreamPlayer({ onProgress = () => {}, onMetric = () =>
    * gets a fresh context instead of a silent failure.
    */
   const openContext = async (shared) => {
+    watchVisibility();
     if (shared) {
+      shared.addEventListener?.("statechange", () => resumeIfInterrupted(shared));
       try {
         await ensureWorklet(shared);
         await shared.resume?.();
@@ -49,6 +66,7 @@ export function createPcmStreamPlayer({ onProgress = () => {}, onMetric = () =>
     }
     const fresh = new Context();
     owned = true;
+    fresh.addEventListener?.("statechange", () => resumeIfInterrupted(fresh));
     try {
       await ensureWorklet(fresh);
       await fresh.resume?.();

package/voice/presentation.js

@@ -39,17 +39,14 @@ export function voiceCallFailure(view) {
 }
 
 /**
- * Playback stays visible at the composer until it ends.
- * A hidden readout call and a chat reader both use this one strip:
- * status plus the control that stops it. The hold button is not that strip.
+ * A voice call that is still playing keeps one strip at the composer until it
+ * ends: status plus the control that stops it. The hold button is not that
+ * strip. A chat readout stays on the assistant row that is being read.
  */
-export function voicePlaybackChrome(view, readout) {
+export function voicePlaybackChrome(view) {
   const playback = view?.snapshot?.playback;
-  if (playback && playback !== "idle") {
-    return { status: voicePanelPresentation(view).status, stop: "call", stopLabel: "panel.close" };
-  }
-  if (!readout) return null;
-  return { status: `readout.${readout.status}`, stop: "readout", stopLabel: readout.status === "error" ? "readout.dismiss" : "panel.close" };
+  if (!playback || playback === "idle") return null;
+  return { status: voicePanelPresentation(view).status, stop: "call", stopLabel: "panel.close" };
 }
 
 /** Shared inline labels; clients own focus, positioning and the timer tick. */

package/voice/stream-gateway.js

@@ -10,7 +10,7 @@ import { routerGatewayUrl, routerAuthHeaders } from "../router/gateway.js";
 const fault = (code, status = 409) => new VoiceError(code, status, code);
 
 /** Single-use HTTP grants bind raw audio sockets to the authenticated Host scope. */
-export function createAudioStreamGateway({ config, models, replies, synthesize = synthesizeStream, env = process.env, metric = () => {} }) {
+export function createAudioStreamGateway({ config, models, replies, synthesize = synthesizeStream, env = process.env, metric = () => {}, playbackStallMs = 45_000 }) {
   const tickets = new Map(), clients = new Set();
   const synthesis = createSynthesisRuns({ synthesize, metric });
   const server = new WebSocketServer({ noServer: true, maxPayload: 96 * 1024, perMessageDeflate: false,
@@ -145,7 +145,14 @@ export function createAudioStreamGateway({ config, models, replies, synthesize =
                 for (let offset = 0; offset < event.chunk.length; offset += 16384) {
                   while (pausedAt || sentFrames - playedFrames > rate * 2 || client.bufferedAmount > 128 * 1024) {
                     if (!reportedWait) { reportedWait = true; metric({ stage: "playback_wait", voiceId: grant.scope.id, sentFrames, playedFrames, paused: Boolean(pausedAt) }); }
-                    await new Promise((resolve, reject) => { const timer = setTimeout(() => { waiter = null; reject(fault(pausedAt ? "voice_interruption_timeout" : "voice_audio_backpressure")); }, pausedAt ? Math.max(1, 10000 - (Date.now() - pausedAt)) : 10000); waiter = () => { clearTimeout(timer); resolve(); }; });
+                    // A device switch or a locked screen can stop playout for a
+                    // while without the client being gone. Wait for it to come
+                    // back instead of ending the answer after ten seconds.
+                    await new Promise((resolve, reject) => {
+                      const limit = pausedAt ? Math.max(1, 10_000 - (Date.now() - pausedAt)) : playbackStallMs;
+                      const timer = setTimeout(() => { waiter = null; reject(fault(pausedAt ? "voice_interruption_timeout" : "voice_audio_backpressure")); }, limit);
+                      waiter = () => { clearTimeout(timer); resolve(); };
+                    });
                     if (abort.signal.aborted || client.readyState !== 1) throw fault("voice_cancelled");
                   }
                   if (client.readyState !== 1) throw fault("voice_cancelled");