dsh-live-voice 0.3.2 → 0.4.0

package/lib/server.js

@@ -4,6 +4,26 @@ import { homedir as homedir2 } from "node:os";
 import { dirname as dirname2, join as join2 } from "node:path";
 import { randomUUID as randomUUID2 } from "node:crypto";
 
+// src/modules/core/speechDefaults.ts
+var notices = {
+  en: "You can see the code in our conversation history.",
+  pt: "Voc\xEA pode ver o c\xF3digo no hist\xF3rico da nossa conversa.",
+  es: "Puedes ver el c\xF3digo en el historial de nuestra conversaci\xF3n.",
+  fr: "Vous pouvez voir le code dans l\u2019historique de notre conversation.",
+  hi: "\u0906\u092A \u0939\u092E\u093E\u0930\u0940 \u092C\u093E\u0924\u091A\u0940\u0924 \u0915\u0947 \u0907\u0924\u093F\u0939\u093E\u0938 \u092E\u0947\u0902 \u0915\u094B\u0921 \u0926\u0947\u0916 \u0938\u0915\u0924\u0947 \u0939\u0948\u0902\u0964",
+  zh: "\u4F60\u53EF\u4EE5\u5728\u6211\u4EEC\u7684\u5BF9\u8BDD\u5386\u53F2\u4E2D\u67E5\u770B\u4EE3\u7801\u3002"
+};
+var defaults = /* @__PURE__ */ new Set([
+  ...Object.values(notices),
+  "Look the code on out conversation",
+  "You can see the code on our conversation history.",
+  "You can see the code on our conversation history"
+]);
+function resolveCodeNotice(value, lang = "en") {
+  const text = typeof value === "string" ? value.trim() : "";
+  return !text || defaults.has(text) ? notices[String(lang).toLowerCase().split("-")[0]] || notices.en : text;
+}
+
 // src/modules/core/settings.ts
 var voiceDetectionPresets = Object.freeze({
   short: Object.freeze({
@@ -38,6 +58,7 @@ var isQwenVoice = (value) => qwenVoices.some((voice) => voice.value === value);
 var defaultAgentVoiceContext = `Live Voice output is active. Your entire user-facing response will be spoken aloud.
 Be concise and conversational. Lead with the answer or next action. Avoid unnecessary repetition, long preambles, dense lists, raw code, paths, and verbose status narration.
 Do not narrate routine tool activity by default. If the user explicitly asks you to keep them informed while working, provide brief spoken progress updates only at meaningful milestones.`;
+var autoSendDelayOptions = Object.freeze([0.6, 0.8, 1, 2, 3, 4, 5, 6]);
 var defaultSettings = Object.freeze({
   engine: "browser",
   recognitionEngine: "browser",
@@ -47,14 +68,15 @@ var defaultSettings = Object.freeze({
   voiceDetectionCustomSilenceMs: 1e3,
   recognitionMaxUtteranceSeconds: 60,
   microphoneEnabled: true,
-  holdToTalkEnabled: true,
+  holdToTalkEnabled: false,
   announceAssistantMessages: true,
   agentVoiceContextEnabled: true,
   agentVoiceContext: defaultAgentVoiceContext,
   interruptSpeechOnUserMessage: false,
   sendingMode: "manual",
+  dshBusyEnterBehavior: "queue",
   autoSendDelaySeconds: 4,
-  assistantSpeechDelaySeconds: 3,
+  assistantSpeechDelaySeconds: 0,
   mode: "speaker",
   lang: "pt-BR",
   recognitionLang: "pt-BR",
@@ -73,7 +95,7 @@ var defaultSettings = Object.freeze({
   voiceCommandClear: "clear all, clear message",
   outputCodeFilterEnabled: true,
   outputCodeMaxLines: 5,
-  outputCodeNotice: "Look the code on out conversation",
+  outputCodeNotice: resolveCodeNotice(void 0, "pt-BR"),
   rate: 1,
   segmentGapMs: 400
 });
@@ -97,9 +119,10 @@ function normalizeSettings(value) {
     agentVoiceContextEnabled: typeof source.agentVoiceContextEnabled === "boolean" ? source.agentVoiceContextEnabled : defaultSettings.agentVoiceContextEnabled,
     agentVoiceContext: typeof source.agentVoiceContext === "string" && source.agentVoiceContext.length <= 4e3 && !source.agentVoiceContext.includes("\0") ? source.agentVoiceContext.trim() : defaultSettings.agentVoiceContext,
     interruptSpeechOnUserMessage: typeof source.interruptSpeechOnUserMessage === "boolean" ? source.interruptSpeechOnUserMessage : defaultSettings.interruptSpeechOnUserMessage,
+    dshBusyEnterBehavior: ["queue", "steer"].includes(source.dshBusyEnterBehavior) ? source.dshBusyEnterBehavior : defaultSettings.dshBusyEnterBehavior,
     sendingMode: source.sendingMode === "automatic" ? "queue" : ["manual", "queue", "steer"].includes(source.sendingMode) ? source.sendingMode : defaultSettings.sendingMode,
-    autoSendDelaySeconds: Number.isInteger(source.autoSendDelaySeconds) && source.autoSendDelaySeconds >= 2 && source.autoSendDelaySeconds <= 10 ? source.autoSendDelaySeconds : defaultSettings.autoSendDelaySeconds,
-    assistantSpeechDelaySeconds: Number.isInteger(source.assistantSpeechDelaySeconds) && source.assistantSpeechDelaySeconds >= 1 && source.assistantSpeechDelaySeconds <= 10 ? source.assistantSpeechDelaySeconds : defaultSettings.assistantSpeechDelaySeconds,
+    autoSendDelaySeconds: autoSendDelayOptions.includes(source.autoSendDelaySeconds) ? source.autoSendDelaySeconds : defaultSettings.autoSendDelaySeconds,
+    assistantSpeechDelaySeconds: Number.isInteger(source.assistantSpeechDelaySeconds) && source.assistantSpeechDelaySeconds >= 0 && source.assistantSpeechDelaySeconds <= 4 ? source.assistantSpeechDelaySeconds : defaultSettings.assistantSpeechDelaySeconds,
     mode: ["speaker", "headphones"].includes(source.mode) ? source.mode : defaultSettings.mode,
     lang: typeof source.lang === "string" && /^[a-z]{2,3}(?:-[A-Za-z0-9]{2,8})*$/.test(source.lang) ? source.lang : defaultSettings.lang,
     recognitionLang: source.recognitionLang === "auto" || typeof source.recognitionLang === "string" && /^[a-z]{2,3}(?:-[A-Za-z0-9]{2,8})*$/.test(source.recognitionLang) ? source.recognitionLang : typeof source.lang === "string" && /^[a-z]{2,3}(?:-[A-Za-z0-9]{2,8})*$/.test(source.lang) ? source.lang : defaultSettings.recognitionLang,
@@ -139,7 +162,7 @@ function normalizeSettings(value) {
     ),
     outputCodeFilterEnabled: typeof source.outputCodeFilterEnabled === "boolean" ? source.outputCodeFilterEnabled : defaultSettings.outputCodeFilterEnabled,
     outputCodeMaxLines: Number.isInteger(source.outputCodeMaxLines) && source.outputCodeMaxLines >= 0 && source.outputCodeMaxLines <= 100 ? source.outputCodeMaxLines : defaultSettings.outputCodeMaxLines,
-    outputCodeNotice: typeof source.outputCodeNotice === "string" && source.outputCodeNotice.trim() && source.outputCodeNotice.length <= 300 && !source.outputCodeNotice.includes("\0") ? source.outputCodeNotice.trim() : defaultSettings.outputCodeNotice,
+    outputCodeNotice: typeof source.outputCodeNotice === "string" && source.outputCodeNotice.trim() && source.outputCodeNotice.length <= 300 && !source.outputCodeNotice.includes("\0") ? resolveCodeNotice(source.outputCodeNotice, source.lang || defaultSettings.lang) : resolveCodeNotice(defaultSettings.outputCodeNotice, source.lang || defaultSettings.lang),
     rate: Number.isFinite(source.rate) && source.rate >= 0.1 && source.rate <= 3 ? source.rate : 1,
     segmentGapMs: Number.isFinite(source.segmentGapMs) && source.segmentGapMs >= 0 && source.segmentGapMs <= 2e3 ? Math.round(source.segmentGapMs) : 400
   };

package/package.json

@@ -1,17 +1,13 @@
 {
   "name": "dsh-live-voice",
-  "version": "0.3.2",
-  "dshTestedVersion": "0.2.0-rc.2",
+  "version": "0.4.0",
+  "dshTestedVersion": "0.2.1-alpha.1",
   "type": "module",
   "scripts": {
-    "typecheck": "tsc --noEmit",
+    "build": "node --experimental-strip-types ../../scripts/build.ts --package live-voice",
     "test": "npm run build && node --test .test-dist/*.test.js",
-    "build": "npm run typecheck && node --experimental-strip-types scripts/build.ts",
-    "check:dist": "node scripts/check-dist.mjs",
-    "dev": "node --experimental-strip-types scripts/build.ts --watch",
-    "format": "prettier --write \"src/**/*.{ts,tsx}\" \"test/**/*.{ts,tsx}\" \"scripts/**/*.ts\"",
-    "format:check": "prettier --check \"src/**/*.{ts,tsx}\" \"test/**/*.{ts,tsx}\" \"scripts/**/*.ts\"",
-    "setup:hooks": "git config core.hooksPath .githooks",
+    "typecheck": "tsc --noEmit",
+    "dev": "node --experimental-strip-types ../../scripts/build.ts --package live-voice --watch",
     "prepack": "npm run build",
     "preview": "previewjs .",
     "preview:check": "previewjs . --help"
@@ -62,12 +58,7 @@
     "lib/",
     "cordis.patch.yml",
     "README.md",
-    "CHANGELOG.md",
-    "PLAN.md",
-    "DEVELOPMENT.md",
     "HISTORY.md",
-    "docs/",
-    "scripts/",
     "LICENSE"
   ],
   "publishConfig": {
@@ -76,21 +67,8 @@
   },
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/victorwads/dsh-live-voice.git"
-  },
-  "devDependencies": {
-    "@previewjs/cli": "^1.30.1",
-    "@previewjs/plugin-react": "^17.1.0",
-    "@types/node": "26.6.2",
-    "@types/react": "19.3.0",
-    "@types/react-dom": "19.3.0",
-    "esbuild": "0.28.2",
-    "jsdom": "30.1.0",
-    "playwright-core": "1.63.0",
-    "prettier": "3.9.8",
-    "react": "19.3.0",
-    "react-dom": "19.3.0",
-    "typescript": "7.0.2"
+    "url": "git+https://github.com/victorwads/dsh-live-voice.git",
+    "directory": "packages/live-voice"
   },
   "main": "./lib/server.js",
   "exports": {
@@ -115,6 +93,7 @@
   },
   "dependencies": {
     "@wads.dev/i18n-react": "^0.0.1-alpha.0",
-    "@wads.dev/i18n-ts": "0.0.1-alpha.0"
+    "@wads.dev/i18n-ts": "0.0.1-alpha.0",
+    "marked": "^18.1.0"
   }
 }

package/src/app/AGENTS.md

@@ -1,6 +1,6 @@
 # Application boundary
 
-Read [ARCHITECTURE.md](ARCHITECTURE.md) before changing composition roots, routes, slots, or language registration. Read the repository [AGENTS.md](../../AGENTS.md) for product, validation, and authorization rules.
+Read [ARCHITECTURE.md](ARCHITECTURE.md) before changing composition roots, routes, slots, or language registration. Read the repository [AGENTS.md](../../../../AGENTS.md) for product, validation, and authorization rules.
 
 - Inspect the actual DSH extension API before changing an integration point. Preserve established slot names, IDs, ordering, injected services, authenticated same-origin routes, and browser/host separation.
 - Keep UI copy in the typed catalogs under `client/i18n/`; update every supported language in alphabetical key order. Use DSH `ctx.locale`, not an independent preference. UI locale is independent of recognition/synthesis languages and configured voice-command phrases.

package/src/app/ARCHITECTURE.md

@@ -7,4 +7,4 @@
 - `client/i18n` owns the only UI translation tree: typed, alphabetized catalogs for every supported locale, runtime selection synchronized with `ctx.locale`, DSH registration, and the boundary wrapping slot components. UI language must not change STT/TTS language or user-defined command phrases.
 - Styles are assembled from `src/styles/index.ts`; design-system primitives live under `src/shared/design-system` rather than here.
 
-Read [the repository overview](../../docs/ARCHITECTURE.md) for dependency direction and stable contracts, and the relevant module architecture before editing feature behavior. Read [application agent guidance](AGENTS.md) for operational constraints.
+Read [the repository overview](../../../../docs/ARCHITECTURE.md) for dependency direction and stable contracts, and the relevant module architecture before editing feature behavior. Read [application agent guidance](AGENTS.md) for operational constraints.

package/src/app/client/apply.tsx

@@ -1,6 +1,14 @@
 // @ts-nocheck
 import React from 'react';
+import { SpeechStatusBar } from '../../modules/conversation/components/SpeechStatusBar.js';
+import { MeetingController } from '../../modules/conversation/models/meeting.js';
+import { SharedAudioMeter, requestSharedAudio } from '../../modules/core/sharedAudio.js';
+import {
+  MeetingToggle,
+  MeetingBars,
+} from '../../modules/conversation/components/MeetingControls.js';
 import { createPortal } from 'react-dom';
+import { preserveComposerSelection } from './composerSelection.js';
 import { MicrophoneMeter, VoiceCoordinator, VoiceOwnership } from '../../modules/core/index.js';
 import {
   BrowserRecognitionEngine,
@@ -22,6 +30,10 @@ import { registerLiveVoiceLocales } from './i18n/index.js';
 import { registerConversationSlots, registerSettingsSlot } from './registerSlots.js';
 import { styles } from '../../styles/index.js';
 import { createSettingsClient } from '../../modules/settings/models/settingsStorage.js';
+import {
+  publishDiagnosticSource,
+  readCoordinatorDiagnostics,
+} from '../../modules/core/diagnostics.js';
 import {
   assistantMessages,
   addressedTurn,
@@ -42,6 +54,43 @@ export function apply(ctx) {
   // A route change may replace every conversation slot, but the next committed
   // composer should inherit the user's explicit choice to remain in voice mode.
   let voiceModeActive = false;
+  const diagnosticListeners = new Set();
+  const notifyDiagnostics = () => {
+    for (const listener of diagnosticListeners) {
+      try {
+        listener();
+      } catch {
+        /* Observers never own voice behavior. */
+      }
+    }
+  };
+  ctx.effect(() => {
+    const unpublish = publishDiagnosticSource(window, {
+      version: 1,
+      read: ({ includeContent = false } = {}) => ({
+        application: { disposed, voiceModeActive, retiring: retiring.size },
+        sessions: Object.fromEntries(
+          [...controllers].map(([id, entry]) => [
+            id,
+            readCoordinatorDiagnostics(entry.controller, includeContent),
+          ]),
+        ),
+        settingsControllers: [...settingsControllers].map((controller) =>
+          readCoordinatorDiagnostics(controller, includeContent),
+        ),
+      }),
+      subscribe: (listener) => {
+        diagnosticListeners.add(listener);
+        return () => {
+          diagnosticListeners.delete(listener);
+        };
+      },
+    });
+    return () => {
+      unpublish();
+      diagnosticListeners.clear();
+    };
+  }, 'dsh-live-voice: diagnostic bridge');
   const publishVoiceContext = (
     entry,
     active = entry?.controller?.getSnapshot().conversation === true,
@@ -146,10 +195,15 @@ export function apply(ctx) {
     entry.questionCapture = null;
     entry.controller.patch({ answeringQuestion: false });
     publishVoiceContext(entry, false);
+    entry.unsubscribeMeetingMicrophone?.();
     entry.chatListeners.clear();
     if (controllers.get(entry.key) === entry) controllers.delete(entry.key);
+    notifyDiagnostics();
     // Keep teardown in the hardware handoff barrier, not in the session registry.
-    const done = run(entry.controller, entry.controller.dispose());
+    const done = run(
+      entry.controller,
+      Promise.all([entry.controller.dispose(), entry.meeting?.dispose()]),
+    );
     const barrier = { endConversation: () => done };
     retiring.add(barrier);
     void done.finally(() => retiring.delete(barrier));
@@ -185,21 +239,29 @@ export function apply(ctx) {
     const meter = new MicrophoneMeter();
     const recognition = recognitionFor(settings, meter);
     entry.controller = new VoiceCoordinator({
+      persistSettings: (next) => savePreferences(entry.controller, next),
       recognition,
       engines: { browser: engineBrowser, say: engineSay, 'qwen-http': engineQwen },
       meter,
       composer: {
         getDraft: () => entry.draft,
+        appendFinal: (text, startedAt) => {
+          if (entry.meeting?.getSnapshot().shared.listening) {
+            entry.meeting.transcript.append('microphone', text, startedAt);
+            return entry.draft;
+          }
+          return null;
+        },
         submit: (mode = 'queue') => {
           const owner = [...entry.composers.values()].at(-1);
           if (!owner) return;
-          if (mode === 'steer') {
-            // InputActions deliberately exposes no delivery-mode argument. Dispatch the
-            // DSH accelerated composer gesture instead: Ctrl/Cmd+Enter resolves to the
-            // opposite of the normal busy-enter policy, which is direct steering when
-            // the ordinary action queues. Never fall back to inputActions.submit() here:
-            // it would silently turn an explicit steer request into a queued message.
-            owner.submitAccelerated?.();
+          const busyEnter = entry.controller.getSnapshot().settings.dshBusyEnterBehavior;
+          if (mode !== busyEnter || busyEnter === 'steer') {
+            // InputActions.submit() always queues; it does not emulate normal Enter.
+            // Use an actual Enter gesture for steering-default composers, adding Ctrl
+            // only for the opposite mode. Read the preference at delivery time.
+            // Never fall back to normal submit: that would deliver the wrong mode.
+            owner.submitAccelerated?.(mode !== busyEnter);
             return;
           }
           owner.actions.submit?.();
@@ -237,16 +299,23 @@ export function apply(ctx) {
           if (entry.pendingDraft === undefined) entry.staleDrafts.clear();
           entry.staleDrafts.add(entry.draft);
           if (entry.publishedDraft !== undefined) entry.staleDrafts.add(entry.publishedDraft);
+          const previous = entry.draft;
           entry.draft = text;
           entry.pendingDraft = text;
           entry.pendingRevision = entry.publishedRevision;
-          owner.actions.setDraft(text);
+          const append = text.length > previous.length && text.startsWith(previous);
+          if (append) preserveComposerSelection(() => owner.actions.setDraft(text));
+          else owner.actions.setDraft(text);
         },
       },
       settings,
     });
     const controller = entry.controller;
-    entry.unsubscribeVoiceContext = controller.subscribe(() => publishVoiceContext(entry));
+    entry.unsubscribeVoiceContext = controller.subscribe(() => {
+      publishVoiceContext(entry);
+      notifyDiagnostics();
+    });
+    notifyDiagnostics();
     publishVoiceContext(entry);
     entry.chat = ctx.uiConversation.binding(sessionId).target('chat');
     entry.chatListeners = new Set();
@@ -363,6 +432,34 @@ export function apply(ctx) {
         );
       };
     }
+    entry.meeting = new MeetingController({
+      composer: entry.controller.composer,
+      settings: () => entry.controller.getSnapshot().settings,
+      translate: (key) => t('dsh-live-voice.meeting.' + key),
+      createSource: (source, settings) => {
+        const meter = source === 'shared' ? new SharedAudioMeter() : new MicrophoneMeter();
+        return { meter, engine: recognitionFor(settings, meter) };
+      },
+    });
+    entry.startMeetingSource = (source) => {
+      try {
+        const request = requestSharedAudio();
+        request.catch(() => {});
+        void entry.meeting.start(source, request);
+      } catch {
+        entry.meeting.patch(source, { error: t('dsh-live-voice.meeting.failed') });
+      }
+    };
+    let microphoneActive = false;
+    const unsubscribeMeetingMicrophone = controller.subscribe(() => {
+      const state = controller.getSnapshot();
+      const next = Boolean((state.listening || state.starting) && !state.muted);
+      if (next !== microphoneActive) {
+        microphoneActive = next;
+        entry.meeting.transcript.setActive('microphone', next);
+      }
+    });
+    entry.unsubscribeMeetingMicrophone = unsubscribeMeetingMicrophone;
     controllers.set(key, entry);
     void preferences.ready.catch(() => {
       if (!entry.closed)
@@ -415,7 +512,7 @@ export function apply(ctx) {
       if (!input || typeof props.inputActions?.setDraft !== 'function') return;
       entry.composers.set(token.current, {
         actions: props.inputActions,
-        submitAccelerated: () => {
+        submitAccelerated: (accelerated = true) => {
           const active = document.activeElement;
           const editor =
             active?.nodeType === 1 && active.isContentEditable
@@ -429,7 +526,7 @@ export function apply(ctx) {
             new KeyboardEventCtor('keydown', {
               key: 'Enter',
               code: 'Enter',
-              ctrlKey: true,
+              ctrlKey: accelerated,
               bubbles: true,
               cancelable: true,
             }),
@@ -467,7 +564,19 @@ export function apply(ctx) {
   function Buttons(props) {
     const entry = useEntry(props.sessionId, 'buttons');
     useComposer(entry, props);
-    return entry ? <ConversationControls controller={entry.controller} /> : null;
+    return entry ? (
+      <>
+        <MeetingToggle
+          meeting={entry.meeting}
+          onToggle={() => {
+            const value = entry.meeting.getSnapshot().shared;
+            if (value.starting || value.listening) void entry.meeting.stop('shared');
+            else entry.startMeetingSource('shared');
+          }}
+        />
+        <ConversationControls controller={entry.controller} />
+      </>
+    ) : null;
   }
   function Settings() {
     const [controller, setController] = React.useState(null);
@@ -478,6 +587,7 @@ export function apply(ctx) {
       const meter = new MicrophoneMeter();
       const recognition = recognitionFor(settings, meter);
       const c = new VoiceCoordinator({
+        persistSettings: (next) => savePreferences(c, next),
         recognition,
         engines: {
           browser,
@@ -510,6 +620,8 @@ export function apply(ctx) {
       const update = c.updateSettings.bind(c);
       c.applySavedSettings = update;
       settingsControllers.add(c);
+      const unsubscribeDiagnostics = c.subscribe(notifyDiagnostics);
+      notifyDiagnostics();
       void preferences.ready.catch(() =>
         c.patch({ error: t('dsh-live-voice.settings.persistence.loadError') }),
       );
@@ -527,7 +639,9 @@ export function apply(ctx) {
         const [savedSettings] = await Promise.all([
           saved,
           c.endConversation(),
-          ...active.map((entry) => entry.controller.endConversation()),
+          ...active.map((entry) =>
+            Promise.all([entry.controller.endConversation(), entry.meeting.end()]),
+          ),
         ]);
         if (revision !== settingsRevision || disposed || c.disposed) return;
         for (const entry of controllers.values()) {
@@ -546,7 +660,9 @@ export function apply(ctx) {
       refresh();
       return () => {
         document.removeEventListener('dsh-live-voice:capabilitieschanged', refresh);
+        unsubscribeDiagnostics();
         settingsControllers.delete(c);
+        notifyDiagnostics();
         void c.dispose();
       };
     }, []);
@@ -556,7 +672,13 @@ export function apply(ctx) {
   function Dock(props) {
     const entry = useEntry(props.sessionId, 'dock');
     useComposer(entry, props);
-    return entry ? <ConversationStatusBar controller={entry.controller} /> : null;
+    return entry ? (
+      <div className="dlv-bar-stack">
+        <SpeechStatusBar controller={entry.controller} />
+        <MeetingBars meeting={entry.meeting} />
+        <ConversationStatusBar controller={entry.controller} includeSpeech={false} />
+      </div>
+    ) : null;
   }
   function QuestionStatusView({ entry }) {
     const snapshot = React.useSyncExternalStore(
@@ -647,8 +769,10 @@ export function apply(ctx) {
   ctx.effect(() => {
     const stop = () => {
       ownership.cancel();
-      for (const entry of controllers.values())
+      for (const entry of controllers.values()) {
         run(entry.controller, entry.controller.endConversation());
+        void entry.meeting.end();
+      }
     };
     let holdToTalk = null;
     const candidate = () => {

package/src/app/client/composerSelection.ts

@@ -0,0 +1,92 @@
+/** Preserve browser selection around DSH's synchronous, whole-draft editor write.
+ * Selection changes are published back through the editor's normal selectionchange bridge.
+ * Capture offsets, not live Ranges: setDraft replaces the underlying text nodes.
+ */
+export function preserveComposerSelection(write: () => void, doc: Document = document) {
+  const active = doc.activeElement as HTMLElement | null;
+  const selection = doc.getSelection();
+  const editable = active?.closest<HTMLElement>('[contenteditable="true"]');
+  const ownsSelection =
+    editable &&
+    selection?.anchorNode &&
+    selection.focusNode &&
+    editable.contains(selection.anchorNode) &&
+    editable.contains(selection.focusNode);
+  const offset = (node: Node, at: number) => {
+    const range = doc.createRange();
+    range.selectNodeContents(editable!);
+    range.setEnd(node, at);
+    return range.toString().length;
+  };
+  const anchor = ownsSelection ? offset(selection!.anchorNode!, selection!.anchorOffset) : null;
+  const focus = ownsSelection ? offset(selection!.focusNode!, selection!.focusOffset) : null;
+  const outside =
+    !ownsSelection && selection?.rangeCount ? selection.getRangeAt(0).cloneRange() : null;
+  const input = active as HTMLInputElement | HTMLTextAreaElement | null;
+  const inputSelection =
+    input && typeof input.selectionStart === 'number'
+      ? {
+          start: input.selectionStart,
+          end: input.selectionEnd!,
+          direction: input.selectionDirection!,
+        }
+      : null;
+  const scrollTop = active?.scrollTop,
+    scrollLeft = active?.scrollLeft;
+  const bookmark = (node: Node, at: number) => {
+    const path: number[] = [];
+    let child = node;
+    while (child !== editable && child.parentNode) {
+      path.unshift(Array.prototype.indexOf.call(child.parentNode.childNodes, child));
+      child = child.parentNode;
+    }
+    return { path, at, type: node.nodeType, text: node.textContent };
+  };
+  const anchorMark = ownsSelection
+    ? bookmark(selection!.anchorNode!, selection!.anchorOffset)
+    : null;
+  const focusMark = ownsSelection ? bookmark(selection!.focusNode!, selection!.focusOffset) : null;
+  write();
+  if (active?.isConnected && doc.activeElement !== active) active.focus({ preventScroll: true });
+  if (ownsSelection && editable!.isConnected) {
+    const point = (at: number): [Node, number] => {
+      const walker = doc.createTreeWalker(editable!, 4);
+      let node: Node | null;
+      let last: Node = editable!;
+      while ((node = walker.nextNode())) {
+        last = node;
+        const length = node.textContent?.length ?? 0;
+        if (at <= length) return [node, at];
+        at -= length;
+      }
+      return [last, last === editable ? last.childNodes.length : (last.textContent?.length ?? 0)];
+    };
+    const restorePoint = (mark: NonNullable<typeof anchorMark>, at: number): [Node, number] => {
+      let node: Node | undefined = editable!;
+      for (const index of mark.path) node = node?.childNodes[index];
+      // Preserve paragraph/empty-line boundaries when the rebuilt structure matches.
+      if (
+        node &&
+        node.nodeType === mark.type &&
+        (node.nodeType !== 3 || node.textContent?.startsWith(mark.text ?? '')) &&
+        mark.at <= (node.nodeType === 3 ? node.textContent!.length : node.childNodes.length)
+      )
+        return [node, mark.at];
+      return point(at);
+    };
+    const [a, ao] = restorePoint(anchorMark!, anchor!);
+    const [f, fo] = restorePoint(focusMark!, focus!);
+    selection!.setBaseAndExtent(a, ao, f, fo);
+    // Let Lexical adopt the restored DOM selection instead of retaining selectEnd().
+    doc.dispatchEvent(new doc.defaultView!.Event('selectionchange'));
+  } else if (inputSelection && active?.isConnected) {
+    input!.setSelectionRange(inputSelection.start, inputSelection.end, inputSelection.direction);
+  } else if (outside?.startContainer.isConnected && outside.endContainer.isConnected) {
+    selection?.removeAllRanges();
+    selection?.addRange(outside);
+  }
+  if (active?.isConnected) {
+    active.scrollTop = scrollTop!;
+    active.scrollLeft = scrollLeft!;
+  }
+}

package/src/app/client/i18n/catalogs/base.ts

@@ -23,12 +23,14 @@ export interface LiveVoiceTranslation extends Translation {
   'dsh-live-voice.commons.input.listening': string;
   'dsh-live-voice.commons.input.listeningBadge': string;
   'dsh-live-voice.commons.manual': string;
+  'dsh-live-voice.commons.milliseconds': string;
   'dsh-live-voice.commons.off': string;
   'dsh-live-voice.commons.on': string;
   'dsh-live-voice.commons.pluginName': string;
   'dsh-live-voice.commons.queue': string;
   'dsh-live-voice.commons.repository.starLabel': string;
   'dsh-live-voice.commons.repository.starLink': string;
+  'dsh-live-voice.commons.second': string;
   'dsh-live-voice.commons.seconds': string;
   'dsh-live-voice.commons.send': string;
   'dsh-live-voice.commons.status.ready': string;
@@ -43,6 +45,24 @@ export interface LiveVoiceTranslation extends Translation {
   'dsh-live-voice.commons.version.label': string;
   'dsh-live-voice.commons.version.link': string;
   'dsh-live-voice.commons.version.title': string;
+  'dsh-live-voice.meeting.failed': string;
+  'dsh-live-voice.meeting.help': string;
+  'dsh-live-voice.meeting.httpRequired': string;
+  'dsh-live-voice.meeting.inactive': string;
+  'dsh-live-voice.meeting.listening': string;
+  'dsh-live-voice.meeting.microphone': string;
+  'dsh-live-voice.meeting.noAudio': string;
+  'dsh-live-voice.meeting.processing': string;
+  'dsh-live-voice.meeting.shared': string;
+  'dsh-live-voice.meeting.start': string;
+  'dsh-live-voice.meeting.startShared': string;
+  'dsh-live-voice.meeting.starting': string;
+  'dsh-live-voice.meeting.stop': string;
+  'dsh-live-voice.meeting.stopShared': string;
+  'dsh-live-voice.meeting.timestamps': string;
+  'dsh-live-voice.meeting.timestampsBadge': string;
+  'dsh-live-voice.meeting.title': string;
+  'dsh-live-voice.meeting.unavailable': string;
   'dsh-live-voice.recognition.autoSend.countdownHelp': string;
   'dsh-live-voice.recognition.browser.autoInstallPack': string;
   'dsh-live-voice.recognition.browser.help': string;
@@ -131,6 +151,10 @@ export interface LiveVoiceTranslation extends Translation {
   'dsh-live-voice.settings.autoSend.countdown': string;
   'dsh-live-voice.settings.autoSend.delay': string;
   'dsh-live-voice.settings.close': string;
+  'dsh-live-voice.settings.delivery.dshEnterHelp': string;
+  'dsh-live-voice.settings.delivery.dshEnterQuestion': string;
+  'dsh-live-voice.settings.delivery.dshEnterQueue': string;
+  'dsh-live-voice.settings.delivery.dshEnterSteer': string;
   'dsh-live-voice.settings.delivery.label': string;
   'dsh-live-voice.settings.delivery.manualLabel': string;
   'dsh-live-voice.settings.delivery.queueLabel': string;
@@ -153,6 +177,8 @@ export interface LiveVoiceTranslation extends Translation {
   'dsh-live-voice.speak.agentContext.help': string;
   'dsh-live-voice.speak.agentContext.label': string;
   'dsh-live-voice.speak.agentContext.restore': string;
+  'dsh-live-voice.speak.autoPlayback.disable': string;
+  'dsh-live-voice.speak.autoPlayback.enable': string;
   'dsh-live-voice.speak.autoPlayback.enabled': string;
   'dsh-live-voice.speak.autoPlayback.help': string;
   'dsh-live-voice.speak.autoPlayback.label': string;
@@ -164,6 +190,11 @@ export interface LiveVoiceTranslation extends Translation {
   'dsh-live-voice.speak.browser.name': string;
   'dsh-live-voice.speak.browser.outputHelp': string;
   'dsh-live-voice.speak.browser.voice': string;
+  'dsh-live-voice.speak.captions.approximate': string;
+  'dsh-live-voice.speak.captions.loading': string;
+  'dsh-live-voice.speak.captions.position': string;
+  'dsh-live-voice.speak.captions.progress': string;
+  'dsh-live-voice.speak.captions.title': string;
   'dsh-live-voice.speak.engine.label': string;
   'dsh-live-voice.speak.engine.playbackHelp': string;
   'dsh-live-voice.speak.filters.code.enabled': string;
@@ -186,6 +217,7 @@ export interface LiveVoiceTranslation extends Translation {
   'dsh-live-voice.speak.playback.message': string;
   'dsh-live-voice.speak.playback.next': string;
   'dsh-live-voice.speak.playback.pause': string;
+  'dsh-live-voice.speak.playback.previous': string;
   'dsh-live-voice.speak.playback.resume': string;
   'dsh-live-voice.speak.playback.stop': string;
   'dsh-live-voice.speak.playback.stopAll': string;
@@ -215,6 +247,7 @@ export interface LiveVoiceTranslation extends Translation {
   'dsh-live-voice.speak.rate.label': string;
   'dsh-live-voice.speak.responseDelay.help': string;
   'dsh-live-voice.speak.responseDelay.label': string;
+  'dsh-live-voice.speak.responseDelay.none': string;
   'dsh-live-voice.speak.segmentGap.help': string;
   'dsh-live-voice.speak.segmentGap.label': string;
   'dsh-live-voice.speak.status.paused': string;