dsh-live-voice 0.3.0 → 0.3.1

package/CHANGELOG.md

@@ -2,6 +2,22 @@
 
 All notable changes to DSH Live Voice are documented in this file.
 
+## [0.3.1] - Unreleased
+
+### Changes
+
+- Group the primary speech, recognition, and conversation settings into collapsed General sections, with icons on tabs and subsection headings.
+- Start silence-detection settings collapsed and keep recognition capability status visible outside the General section.
+- Add the General section label to every supported interface language and update accessibility and mounted-component regression coverage.
+
+### Documentation
+
+- Split agent guidance and architecture documentation by application, domain module, and shared design-system boundaries.
+
+### Compatibility
+
+- Confirm tested compatibility with DeepSeek Harness **0.2.0-rc.2**.
+
 ## [0.3.0] - Unreleased
 
 ### Features

package/PLAN.md

@@ -2,6 +2,12 @@
 
 This document describes the product plan and local implementation progress. The published npm version is a documentation placeholder; the working tree now contains an initial plugin undergoing integration validation. Features below describe intended behavior unless verified in the progress section.
 
+## 0.3.1 release preparation
+
+The Settings interface now groups primary fields under collapsed General sections, adds icons to tabs and subsection headings, and keeps recognition capability status outside the General section. All six interface catalogs include the new section label. Release metadata and the lockfile use 0.3.1; the version-badge regression derives the current and next release versions from build-injected package metadata.
+
+Validation on an isolated release snapshot: `npm test` passed all 182 automated tests, including the build and TypeScript check; `npm run format:check` passed; an isolated Chrome preview with a synthetic controller verified the three tabs, initially collapsed General sections, and disclosure interactions without browser errors; `npm publish --dry-run --access public --tag latest` passed package validation. These checks do not constitute physical-microphone, native speech-engine, or authenticated DSH runtime acceptance. No npm publication or version tag was created.
+
 ## Qwen3 local engine
 
 Qwen3 is available as independent recognition and speaking selections backed by a separately managed HTTP process on the DSH host. Runtime installation, weights, and service lifecycle stay outside the repository. The authenticated host bridge accepts only a loopback base URL, validates bounded mono PCM16 WAV before ASR forwarding, maps `pt-BR` to Portuguese, forwards TTS text without logging it, and returns WAV audio for browser playback. Browser cancellation aborts pending host/model requests and stale synthesized audio cannot begin playback after cancellation. Automated plugin coverage includes configuration normalization, loopback validation, HTTP payloads, WAV transport, browser playback, and route cleanup. Native model and endpoint acceptance must be reported separately from these tests.

package/README.md

@@ -1,9 +1,11 @@
 # DSH Live Voice
 
 [![npm version](https://img.shields.io/npm/v/dsh-live-voice?logo=npm&label=npm&color=brightgreen)](https://www.npmjs.com/package/dsh-live-voice)
-[![DSH](https://img.shields.io/badge/DSH-v0.1.6--alpha.2-5c5cff?logo=deepseek&logoColor=white)](https://github.com/deepseek-ai/deepseek-harness/releases/tag/v0.1.6-alpha.2)
+[![Tested DSH](https://img.shields.io/badge/Tested_DSH-v0.2.0--rc.2-5c5cff?logo=deepseek&logoColor=white)](https://github.com/deepseek-ai/deepseek-harness/releases/tag/dsh-v0.2.0-rc.2)
 [![License: Apache-2.0](https://img.shields.io/badge/License-Apache--2.0-blue.svg)](LICENSE)
 
+**Tested and working with DeepSeek Harness v0.2.0-rc.2.** This is the current tested DSH version, recorded in the `dshTestedVersion` field in [package.json](package.json).
+
 **A local-first, hands-free voice assistant plugin for DeepSeek Harness (DSH).**
 *Built in Brazil 🇧🇷 and tested daily with Brazilian Portuguese on macOS.*
 

package/docs/ARCHITECTURE.md

@@ -11,24 +11,17 @@ DSH Live Voice uses application composition roots, domain modules, and a domain-
 5. Feature modules use the intentionally centralized client i18n API, but never register DSH slots or host routes.
 6. Browser and host dependency graphs remain separate. Host-only Node imports must never enter the client bundle.
 
-## Composition roots
+## Ownership map
 
-- Client: `src/app/client/apply.tsx`.
-- Server: `src/app/server/apply.ts`.
-- Slot definitions and registration: `src/app/client/slotDefinitions.ts` and `registerSlots.tsx`.
-- Styles: `src/styles/index.ts`.
+- [Application composition, slots, routes, i18n](../src/app/ARCHITECTURE.md)
+- [Core voice policy, ownership, settings normalization](../src/modules/core/ARCHITECTURE.md)
+- [Conversation and composer behavior](../src/modules/conversation/ARCHITECTURE.md)
+- [Settings presentation and storage](../src/modules/settings/ARCHITECTURE.md)
+- [Recognition engines and capability](../src/modules/recognition/ARCHITECTURE.md)
+- [Speaking engines and playback](../src/modules/speak/ARCHITECTURE.md)
+- [Shared design system](../src/shared/ARCHITECTURE.md)
 
-## Internationalization
-
-The only client language tree is `src/app/client/i18n`. It owns typed catalogs, the React runtime, DSH catalog registration, and synchronization with `ctx.locale`. Every DSH slot component is wrapped by the application language boundary. UI locale, recognition language, synthesis language, and user-defined command phrases are independent values.
-
-## Modules
-
-- `modules/core`: shared voice-domain coordination, settings normalization, ownership, transcript handling, microphone policy, filters, and shared Qwen configuration.
-- `modules/conversation`: composer/chat UI, conversation components, chat models, and session-facing behavior.
-- `modules/settings`: modular Settings shell, hooks, services, and Conversation/Recognition/Speech sections.
-- `modules/recognition/engines/{browser,qwen,whisper}`: recognition adapters and provider-specific host/UI code.
-- `modules/speak/engines/{browser,qwen,say,audio}`: speech adapters, host audio, transcoding, and provider clients.
+Read the relevant local architecture file before editing a boundary. The source of truth for plugin and tested-DSH versions is `package.json`.
 
 ## Stable contracts
 

package/lib/client.js

@@ -1372,6 +1372,7 @@ var en = {
   "dsh-live-voice.settings.delivery.toggle": "Automatic delivery mode",
   "dsh-live-voice.settings.engine.refresh": "Refresh available engines",
   "dsh-live-voice.settings.filters.title": "Filtering",
+  "dsh-live-voice.settings.general.title": "General",
   "dsh-live-voice.settings.tabs.conversation": "Conversation",
   "dsh-live-voice.settings.tabs.recognition": "Speech recognition",
   "dsh-live-voice.settings.tabs.speak": "Speech",
@@ -1588,6 +1589,7 @@ var es = {
   "dsh-live-voice.settings.delivery.toggle": "Modo de env\xEDo autom\xE1tico",
   "dsh-live-voice.settings.engine.refresh": "Actualizar los motores disponibles",
   "dsh-live-voice.settings.filters.title": "Filtrado",
+  "dsh-live-voice.settings.general.title": "General",
   "dsh-live-voice.settings.tabs.conversation": "Conversaci\xF3n",
   "dsh-live-voice.settings.tabs.recognition": "Reconocimiento de voz",
   "dsh-live-voice.settings.tabs.speak": "S\xEDntesis de voz",
@@ -1804,6 +1806,7 @@ var fr = {
   "dsh-live-voice.settings.delivery.toggle": "Mode d\u2019envoi automatique",
   "dsh-live-voice.settings.engine.refresh": "Actualiser les moteurs disponibles",
   "dsh-live-voice.settings.filters.title": "Filtrage",
+  "dsh-live-voice.settings.general.title": "G\xE9n\xE9ral",
   "dsh-live-voice.settings.tabs.conversation": "Conversation",
   "dsh-live-voice.settings.tabs.recognition": "Reconnaissance vocale",
   "dsh-live-voice.settings.tabs.speak": "Synth\xE8se vocale",
@@ -2020,6 +2023,7 @@ var hi = {
   "dsh-live-voice.settings.delivery.toggle": "\u0938\u094D\u0935\u091A\u093E\u0932\u093F\u0924 \u092D\u0947\u091C\u0928\u0947 \u0915\u093E \u092E\u094B\u0921",
   "dsh-live-voice.settings.engine.refresh": "\u0909\u092A\u0932\u092C\u094D\u0927 \u0907\u0902\u091C\u0928 \u0930\u0940\u092B\u093C\u094D\u0930\u0947\u0936 \u0915\u0930\u0947\u0902",
   "dsh-live-voice.settings.filters.title": "\u092B\u093C\u093F\u0932\u094D\u091F\u0930\u093F\u0902\u0917",
+  "dsh-live-voice.settings.general.title": "\u0938\u093E\u092E\u093E\u0928\u094D\u092F",
   "dsh-live-voice.settings.tabs.conversation": "\u092C\u093E\u0924\u091A\u0940\u0924",
   "dsh-live-voice.settings.tabs.recognition": "\u0935\u093E\u0915\u094D \u092A\u0939\u091A\u093E\u0928",
   "dsh-live-voice.settings.tabs.speak": "\u0935\u093E\u091A\u0928",
@@ -2236,6 +2240,7 @@ var ptBR = {
   "dsh-live-voice.settings.delivery.toggle": "Modo de entrega autom\xE1tica",
   "dsh-live-voice.settings.engine.refresh": "Atualizar mecanismos dispon\xEDveis",
   "dsh-live-voice.settings.filters.title": "Filtragem",
+  "dsh-live-voice.settings.general.title": "Gerais",
   "dsh-live-voice.settings.tabs.conversation": "Conversa",
   "dsh-live-voice.settings.tabs.recognition": "Reconhecimento de voz",
   "dsh-live-voice.settings.tabs.speak": "Fala",
@@ -2452,6 +2457,7 @@ var zh = {
   "dsh-live-voice.settings.delivery.toggle": "\u81EA\u52A8\u53D1\u9001\u6A21\u5F0F",
   "dsh-live-voice.settings.engine.refresh": "\u5237\u65B0\u53EF\u7528\u5F15\u64CE",
   "dsh-live-voice.settings.filters.title": "\u8FC7\u6EE4",
+  "dsh-live-voice.settings.general.title": "\u5E38\u89C4",
   "dsh-live-voice.settings.tabs.conversation": "\u5BF9\u8BDD",
   "dsh-live-voice.settings.tabs.recognition": "\u8BED\u97F3\u8BC6\u522B",
   "dsh-live-voice.settings.tabs.speak": "\u8BED\u97F3\u5408\u6210",
@@ -2741,6 +2747,10 @@ var iconPaths = {
   skipNext: "M5 5l10 7-10 7V5M19 5v14",
   send: "M3 11.5L21 3l-8.5 18-2-7.5L3 11.5zm7.5 2L21 3",
   queue: "M5 6h14M5 12h10M5 18h6M18 15v6M15 18h6",
+  settings: "M4 7h16M4 17h16M8 4v6M16 14v6",
+  filter: "M3 5h18l-7 8v6l-4 2v-8L3 5z",
+  link: "M10 13a5 5 0 0 0 7.07 0l3-3a5 5 0 0 0-7.07-7.07l-1.7 1.7M14 11a5 5 0 0 0-7.07 0l-3 3a5 5 0 0 0 7.07 7.07l1.7-1.7",
+  chevron: "M6 9l6 6 6-6",
   close: "M6 6l12 12M18 6 6 18"
 };
 
@@ -2862,9 +2872,10 @@ function SettingsSubcard({
   title,
   children,
   open = false,
-  ariaLabel
+  ariaLabel,
+  icon = "settings"
 }) {
-  return /* @__PURE__ */ import_react17.default.createElement("details", { className: "dlv-settings-subcard", open, "aria-label": ariaLabel }, /* @__PURE__ */ import_react17.default.createElement("summary", null, title), /* @__PURE__ */ import_react17.default.createElement("div", { className: "dlv-settings-subcard-body" }, children));
+  return /* @__PURE__ */ import_react17.default.createElement("details", { className: "dlv-settings-subcard", open }, /* @__PURE__ */ import_react17.default.createElement("summary", { "aria-label": ariaLabel }, /* @__PURE__ */ import_react17.default.createElement(Icon, { name: icon, className: "dlv-settings-subcard-icon" }), /* @__PURE__ */ import_react17.default.createElement("span", null, title), /* @__PURE__ */ import_react17.default.createElement(Icon, { name: "chevron", className: "dlv-settings-subcard-chevron" })), /* @__PURE__ */ import_react17.default.createElement("div", { className: "dlv-settings-subcard-body" }, children));
 }
 
 // src/shared/design-system/layout/SettingsTabs.tsx
@@ -2905,7 +2916,8 @@ function SettingsTabs({ label, tabs, active, idPrefix, onChange }) {
       onClick: () => onChange(tab.id),
       onKeyDown: (event) => onKeyDown(event, index)
     },
-    tab.label
+    tab.icon ? /* @__PURE__ */ import_react18.default.createElement(Icon, { name: tab.icon, className: "dlv-settings-tab-icon" }) : null,
+    /* @__PURE__ */ import_react18.default.createElement("span", null, tab.label)
   )));
 }
 
@@ -3856,8 +3868,8 @@ function useConversationController(controller) {
 var import_react23 = __toESM(require("react"), 1);
 
 // src/modules/settings/services/releases.ts
-var CURRENT_VERSION = "0.3.0";
-var TESTED_DSH_VERSION = "0.1.6-alpha.2";
+var CURRENT_VERSION = "0.3.1";
+var TESTED_DSH_VERSION = "0.2.0-rc.2";
 var REPOSITORY_URL = "https://github.com/victorwads/dsh-live-voice";
 var RELEASES_URL = `${REPOSITORY_URL}/releases`;
 var LATEST_RELEASE_API_URL = "https://api.github.com/repos/victorwads/dsh-live-voice/releases/latest";
@@ -3865,7 +3877,7 @@ var RELEASE_CHECK_STORAGE_KEY = "dsh-live-voice.latest-release-check";
 var RELEASE_CHECK_INTERVAL_MS = 24 * 60 * 60 * 1e3;
 var LIVE_VOICE_BADGE_URL = "https://cdn.simpleicons.org/npm/white";
 var DSH_BADGE_URL = "https://cdn.simpleicons.org/deepseek/white";
-var TESTED_DSH_RELEASE_URL = `https://github.com/deepseek-ai/deepseek-harness/releases/tag/v${TESTED_DSH_VERSION}`;
+var TESTED_DSH_RELEASE_URL = `https://github.com/deepseek-ai/deepseek-harness/releases/tag/dsh-v${TESTED_DSH_VERSION}`;
 function versionParts(version) {
   const normalized = String(version || "").trim().replace(/^v/i, "").split("+", 1)[0];
   const [core = "", prerelease = ""] = normalized.split("-", 2);
@@ -4084,7 +4096,8 @@ function PlaybackPolicySettings({ settings, updateSettings }) {
 
 // src/modules/settings/sections/conversation/ConversationSettingsSection.tsx
 function ConversationSettingsSection(props) {
-  return /* @__PURE__ */ import_react29.default.createElement(SettingsCard, null, /* @__PURE__ */ import_react29.default.createElement("div", { className: "dlv-settings-card-body" }, /* @__PURE__ */ import_react29.default.createElement(DeliverySettings, { ...props }), /* @__PURE__ */ import_react29.default.createElement(HoldToTalkSettings, { ...props }), /* @__PURE__ */ import_react29.default.createElement(VoiceModeSettings, { ...props }), /* @__PURE__ */ import_react29.default.createElement(PlaybackPolicySettings, { ...props }), /* @__PURE__ */ import_react29.default.createElement(ConversationDelaySettings, { ...props })));
+  const { scoped: settingsLanguage } = useLanguage((ctx) => ctx.settings);
+  return /* @__PURE__ */ import_react29.default.createElement(SettingsCard, null, /* @__PURE__ */ import_react29.default.createElement("div", { className: "dlv-settings-card-body" }, /* @__PURE__ */ import_react29.default.createElement(SettingsSubcard, { title: settingsLanguage.general.title(), icon: "send" }, /* @__PURE__ */ import_react29.default.createElement("div", { className: "dlv-conversation-fields" }, /* @__PURE__ */ import_react29.default.createElement(DeliverySettings, { ...props }), /* @__PURE__ */ import_react29.default.createElement(HoldToTalkSettings, { ...props }), /* @__PURE__ */ import_react29.default.createElement(VoiceModeSettings, { ...props }), /* @__PURE__ */ import_react29.default.createElement(PlaybackPolicySettings, { ...props }), /* @__PURE__ */ import_react29.default.createElement(ConversationDelaySettings, { ...props })))));
 }
 
 // src/modules/settings/sections/recognition/RecognitionEngineSettings.tsx
@@ -4398,7 +4411,7 @@ function RecognitionEngineSettings({
       checked: settings.recognitionAutoInstall !== false,
       onChange: (event) => updateSettings({ recognitionAutoInstall: event.target.checked })
     }
-  ) : /* @__PURE__ */ import_react32.default.createElement("p", { role: "status" }, recognition.browser.remoteServiceWarning())), engine === "whisper-http" && /* @__PURE__ */ import_react32.default.createElement(SettingsSubcard, { title: commons.connection.title() }, /* @__PURE__ */ import_react32.default.createElement("p", null, recognition.whisper.captureHelp()), /* @__PURE__ */ import_react32.default.createElement(WhisperSettings, { controller })), engine === "qwen-http" && /* @__PURE__ */ import_react32.default.createElement(SettingsSubcard, { title: commons.connection.title() }, /* @__PURE__ */ import_react32.default.createElement("p", null, recognition.qwen.captureHelp()), settings.engine !== "qwen-http" && /* @__PURE__ */ import_react32.default.createElement(QwenSettings, { controller })));
+  ) : /* @__PURE__ */ import_react32.default.createElement("p", { role: "status" }, recognition.browser.remoteServiceWarning())), engine === "whisper-http" && /* @__PURE__ */ import_react32.default.createElement(SettingsSubcard, { title: commons.connection.title(), icon: "link" }, /* @__PURE__ */ import_react32.default.createElement("p", null, recognition.whisper.captureHelp()), /* @__PURE__ */ import_react32.default.createElement(WhisperSettings, { controller })), engine === "qwen-http" && /* @__PURE__ */ import_react32.default.createElement(SettingsSubcard, { title: commons.connection.title(), icon: "link" }, /* @__PURE__ */ import_react32.default.createElement("p", null, recognition.qwen.captureHelp()), settings.engine !== "qwen-http" && /* @__PURE__ */ import_react32.default.createElement(QwenSettings, { controller })));
 }
 
 // src/modules/settings/sections/recognition/RecognitionFilterSettings.tsx
@@ -4406,7 +4419,7 @@ var import_react33 = __toESM(require("react"), 1);
 function RecognitionFilterSettings({ settings, updateSettings }) {
   const { scoped: recognition } = useLanguage((ctx) => ctx.recognition);
   const enabled = settings.recognitionFilterEnabled !== false;
-  return /* @__PURE__ */ import_react33.default.createElement(SettingsSubcard, { title: recognition.minimumWords.label() }, /* @__PURE__ */ import_react33.default.createElement(
+  return /* @__PURE__ */ import_react33.default.createElement(SettingsSubcard, { title: recognition.minimumWords.label(), icon: "filter" }, /* @__PURE__ */ import_react33.default.createElement(
     CheckboxField,
     {
       label: recognition.minimumWords.enabled(),
@@ -4445,7 +4458,7 @@ function SilenceDetectionSettings({ settings, updateSettings }) {
     {
       title: recognition.silenceDetection.label(),
       ariaLabel: recognition.silenceDetection.title(),
-      open: true
+      icon: "pause"
     },
     /* @__PURE__ */ import_react34.default.createElement("p", null, recognition.silenceDetection.help()),
     /* @__PURE__ */ import_react34.default.createElement(
@@ -4502,7 +4515,7 @@ var COMMANDS = [
 function VoiceCommandSettings({ settings, updateSettings }) {
   const { scoped: recognition } = useLanguage((ctx) => ctx.recognition);
   const enabled = settings.voiceCommandsEnabled !== false;
-  return /* @__PURE__ */ import_react35.default.createElement(SettingsSubcard, { title: recognition.commands.title() }, /* @__PURE__ */ import_react35.default.createElement(
+  return /* @__PURE__ */ import_react35.default.createElement(SettingsSubcard, { title: recognition.commands.title(), icon: "send" }, /* @__PURE__ */ import_react35.default.createElement(
     CheckboxField,
     {
       label: recognition.commands.enabled(),
@@ -4532,7 +4545,8 @@ function RecognitionStatus({ capabilities = {} }) {
 
 // src/modules/settings/sections/recognition/RecognitionSettingsSection.tsx
 function RecognitionSettingsSection(props) {
-  return /* @__PURE__ */ import_react37.default.createElement(SettingsCard, null, /* @__PURE__ */ import_react37.default.createElement("div", { className: "dlv-settings-card-body" }, /* @__PURE__ */ import_react37.default.createElement(RecognitionEngineSettings, { ...props }), /* @__PURE__ */ import_react37.default.createElement(VoiceCommandSettings, { ...props }), /* @__PURE__ */ import_react37.default.createElement(RecognitionFilterSettings, { ...props }), /* @__PURE__ */ import_react37.default.createElement(SilenceDetectionSettings, { ...props }), /* @__PURE__ */ import_react37.default.createElement(RecognitionStatus, { ...props })));
+  const { scoped: settingsLanguage } = useLanguage((ctx) => ctx.settings);
+  return /* @__PURE__ */ import_react37.default.createElement(SettingsCard, null, /* @__PURE__ */ import_react37.default.createElement("div", { className: "dlv-settings-card-body" }, /* @__PURE__ */ import_react37.default.createElement(RecognitionStatus, { ...props }), /* @__PURE__ */ import_react37.default.createElement(SettingsSubcard, { title: settingsLanguage.general.title(), icon: "mic" }, /* @__PURE__ */ import_react37.default.createElement(RecognitionEngineSettings, { ...props })), /* @__PURE__ */ import_react37.default.createElement(VoiceCommandSettings, { ...props }), /* @__PURE__ */ import_react37.default.createElement(RecognitionFilterSettings, { ...props }), /* @__PURE__ */ import_react37.default.createElement(SilenceDetectionSettings, { ...props })));
 }
 
 // src/modules/settings/sections/speak/OutputFilterSettings.tsx
@@ -4540,7 +4554,7 @@ var import_react38 = __toESM(require("react"), 1);
 function OutputFilterSettings({ settings, updateSettings }) {
   const { scoped: speak } = useLanguage((ctx) => ctx.speak);
   const enabled = settings.outputCodeFilterEnabled !== false;
-  return /* @__PURE__ */ import_react38.default.createElement(SettingsSubcard, { title: speak.filters.code.enabled() }, /* @__PURE__ */ import_react38.default.createElement(
+  return /* @__PURE__ */ import_react38.default.createElement(SettingsSubcard, { title: speak.filters.code.enabled(), icon: "filter" }, /* @__PURE__ */ import_react38.default.createElement(
     CheckboxField,
     {
       label: speak.filters.code.enabled(),
@@ -4678,7 +4692,7 @@ function SpeechAdvancedSettings({
       options: outputOptions,
       onChange: (event) => updateSettings({ outputDeviceId: event.target.value })
     }
-  ) : /* @__PURE__ */ import_react40.default.createElement("p", { className: "dlv-setting-description" }, speak.macos.outputHelp()), settings.engine === "qwen-http" && /* @__PURE__ */ import_react40.default.createElement(SettingsSubcard, { title: speak.qwen.connection() }, /* @__PURE__ */ import_react40.default.createElement(QwenSettings, { controller })), /* @__PURE__ */ import_react40.default.createElement(SettingsSubcard, { title: speak.agentContext.label() }, /* @__PURE__ */ import_react40.default.createElement(
+  ) : /* @__PURE__ */ import_react40.default.createElement("p", { className: "dlv-setting-description" }, speak.macos.outputHelp()), settings.engine === "qwen-http" && /* @__PURE__ */ import_react40.default.createElement(SettingsSubcard, { title: speak.qwen.connection(), icon: "link" }, /* @__PURE__ */ import_react40.default.createElement(QwenSettings, { controller })), /* @__PURE__ */ import_react40.default.createElement(SettingsSubcard, { title: speak.agentContext.label(), icon: "settings" }, /* @__PURE__ */ import_react40.default.createElement(
     CheckboxField,
     {
       label: speak.agentContext.enabled(),
@@ -4705,7 +4719,8 @@ function SpeechAdvancedSettings({
 
 // src/modules/settings/sections/speak/SpeakSettingsSection.tsx
 function SpeakSettingsSection(props) {
-  return /* @__PURE__ */ import_react41.default.createElement(SettingsCard, null, /* @__PURE__ */ import_react41.default.createElement("div", { className: "dlv-settings-card-body" }, /* @__PURE__ */ import_react41.default.createElement(SpeechEngineSettings, { ...props }), /* @__PURE__ */ import_react41.default.createElement(SpeechAdvancedSettings, { ...props }), /* @__PURE__ */ import_react41.default.createElement(OutputFilterSettings, { ...props })));
+  const { scoped: settingsLanguage } = useLanguage((ctx) => ctx.settings);
+  return /* @__PURE__ */ import_react41.default.createElement(SettingsCard, null, /* @__PURE__ */ import_react41.default.createElement("div", { className: "dlv-settings-card-body" }, /* @__PURE__ */ import_react41.default.createElement(SettingsSubcard, { title: settingsLanguage.general.title(), icon: "speaker" }, /* @__PURE__ */ import_react41.default.createElement(SpeechEngineSettings, { ...props }), /* @__PURE__ */ import_react41.default.createElement(SpeechAdvancedSettings, { ...props })), /* @__PURE__ */ import_react41.default.createElement(OutputFilterSettings, { ...props })));
 }
 
 // src/modules/settings/components/SettingsHeader.tsx
@@ -4783,9 +4798,17 @@ function LiveVoiceSettings({ controller, onClose }) {
   const [activeTab, setActiveTab] = import_react44.default.useState("conversation");
   const tabsId = import_react44.default.useId();
   const tabs = [
-    { id: "speech", label: settingsLanguage.tabs.speak() },
-    { id: "recognition", label: settingsLanguage.tabs.recognition() },
-    { id: "conversation", label: settingsLanguage.tabs.conversation() }
+    { id: "speech", label: settingsLanguage.tabs.speak(), icon: "speaker" },
+    {
+      id: "recognition",
+      label: settingsLanguage.tabs.recognition(),
+      icon: "mic"
+    },
+    {
+      id: "conversation",
+      label: settingsLanguage.tabs.conversation(),
+      icon: "send"
+    }
   ];
   const sectionProps = {
     controller,
@@ -5285,10 +5308,10 @@ var styles = `
 .dlv-settings h3,.dlv-settings p{margin:0}
 .dlv-settings-heading{display:flex;align-items:center;gap:8px;min-width:0}.dlv-settings-heading h3{white-space:nowrap}.dlv-heading-divider{height:1px;min-width:12px;flex:1;background:var(--dsw-alias-border-l1)}.dlv-settings-heading .dlv-star-badge{flex:none}
 .dlv-version-badges{display:flex;flex:none;gap:5px;align-items:center}.dlv-shields-badge{display:inline-flex;align-items:center;justify-content:center;box-sizing:border-box;height:20px;gap:4px;padding:3px 5px;border:1px solid var(--dsw-alias-border-l1);border-radius:5px;background:var(--dsw-alias-bg-layer-1);color:var(--dsw-alias-label-secondary);font-size:10px;font-weight:650;line-height:12px;text-decoration:none}.dlv-shields-badge img{display:block;width:12px;height:12px;max-width:100%}.dlv-shields-badge:focus-visible{border-radius:4px;outline:2px solid var(--dsw-alias-label-primary);outline-offset:3px}.dlv-version-badge{display:inline-flex;align-items:center;min-height:24px;box-sizing:border-box;padding:3px 8px;border:1px solid var(--dsw-alias-border-l1);border-radius:999px;background:var(--dsw-alias-bg-layer-1);color:var(--dsw-alias-label-secondary);font-size:11px;font-weight:650;line-height:16px;text-decoration:none}.dlv-version-badges a.dlv-version-badge:hover{border-color:var(--dsw-alias-border-l2);color:var(--dsw-alias-label-primary)}.dlv-star-badge{padding:4px 10px;color:var(--dsw-alias-label-primary)}.dlv-update-icon{margin-right:4px;font-size:14px;line-height:1}.dlv-star-icon{margin-right:4px;color:#f59e0b;font-size:14px;line-height:1;text-shadow:0 0 8px rgba(245,158,11,.28)}.dlv-version-badges a.dlv-star-badge:hover{border-color:#f59e0b;background:rgba(245,158,11,.08)}.dlv-update-badge{border-color:var(--dsw-alias-state-business-primary);color:var(--dsw-alias-state-business-primary)}
-.dlv-settings-tabs{border-bottom:.5px solid var(--dsw-alias-border-l2);display:flex;align-items:flex-end;gap:22px;overflow-x:auto}.dlv-settings-tab{position:relative;flex:none;padding:7px 1px 9px;border:0;background:transparent;color:var(--dsw-alias-label-tertiary);font:inherit;font-size:13px;line-height:20px;cursor:pointer}.dlv-settings-tab:hover,.dlv-settings-tab[data-active=true]{color:var(--dsw-alias-label-primary)}.dlv-settings-tab[data-active=true]:after,.dlv-settings-tab:focus-visible:after{content:"";position:absolute;right:0;bottom:-1px;left:0;height:2px;border-radius:2px 2px 0 0;background:var(--dsw-alias-label-primary)}.dlv-settings-tab:focus-visible{border-radius:2px;outline:2px solid var(--dsw-alias-state-business-primary);outline-offset:2px;color:var(--dsw-alias-label-primary)}.dlv-settings-panel{min-width:0;padding-top:2px}.dlv-settings-panel[hidden]{display:none}.dlv-settings-group{margin:0;border:1px solid var(--dsw-alias-border-l1);border-radius:10px;min-width:0;display:grid;gap:14px;padding:16px}.dlv-settings-group legend{padding:0 6px;font-weight:600;color:var(--dsw-alias-label-primary)}.dlv-settings-card-body{display:grid;gap:12px;padding:12px 0}.dlv-settings-subcard{border:1px solid var(--dsw-alias-border-l2);border-radius:8px;min-width:0}.dlv-settings-subcard>summary{cursor:pointer;font-weight:650;list-style:none;display:flex;align-items:center;justify-content:space-between;padding:10px}.dlv-settings-subcard>summary::-webkit-details-marker{display:none}.dlv-settings-subcard>summary:after{content:"\u203A";transform:rotate(90deg);transition:transform .15s}.dlv-settings-subcard:not([open])>summary:after{transform:rotate(0)}.dlv-settings-subcard-body{display:grid;gap:10px;padding:0 10px 10px}
+.dlv-settings-tabs{border-bottom:.5px solid var(--dsw-alias-border-l2);display:flex;align-items:flex-end;gap:22px;overflow-x:auto}.dlv-settings-tab{position:relative;display:inline-flex;align-items:center;gap:6px;flex:none;padding:7px 1px 9px;border:0;background:transparent;color:var(--dsw-alias-label-tertiary);font:inherit;font-size:16px;font-weight:600;line-height:22px;cursor:pointer}.dlv-settings-tab-icon{width:17px;height:17px;flex:none}.dlv-settings-tab:hover,.dlv-settings-tab[data-active=true]{color:var(--dsw-alias-label-primary)}.dlv-settings-tab[data-active=true]:after,.dlv-settings-tab:focus-visible:after{content:"";position:absolute;right:0;bottom:-1px;left:0;height:2px;border-radius:2px 2px 0 0;background:var(--dsw-alias-label-primary)}.dlv-settings-tab:focus-visible{border-radius:2px;outline:2px solid var(--dsw-alias-state-business-primary);outline-offset:2px;color:var(--dsw-alias-label-primary)}.dlv-settings-panel{min-width:0;padding-top:2px}.dlv-settings-panel[hidden]{display:none}.dlv-settings-group{margin:0;border:1px solid var(--dsw-alias-border-l1);border-radius:10px;min-width:0;display:grid;gap:14px;padding:16px}.dlv-settings-group legend{padding:0 6px;font-weight:600;color:var(--dsw-alias-label-primary)}.dlv-settings-card-body{display:grid;gap:18px;padding:8px 0 12px}.dlv-settings-subcard{min-width:0;margin:8px 0 0}.dlv-settings-subcard>summary{cursor:pointer;list-style:none;display:flex;align-items:center;gap:9px;padding:10px 12px;border-bottom:1px solid var(--dsw-alias-border-l1);border-radius:6px 6px 0 0;background:color-mix(in srgb,var(--dsw-alias-bg-layer-2) 38%,transparent);color:var(--dsw-alias-label-secondary);font-size:14px;font-weight:500;line-height:20px}.dlv-settings-subcard>summary::-webkit-details-marker{display:none}.dlv-settings-subcard>summary:focus-visible{outline:2px solid var(--dsw-alias-label-primary);outline-offset:3px}.dlv-settings-subcard-icon{width:16px;height:16px;flex:none}.dlv-settings-subcard-chevron{width:16px;height:16px;margin-left:auto;flex:none;transition:transform .15s}.dlv-settings-subcard[open]>summary .dlv-settings-subcard-chevron{transform:rotate(180deg)}.dlv-settings-subcard-body{display:grid;gap:16px;padding:18px 0 6px}
 .dlv-settings label{display:grid;gap:6px;font-size:14px}.dlv-settings label.dlv-check{display:flex;align-items:center;gap:8px}.dlv-settings label.dlv-check input{width:auto}
 .dlv-settings :is(input,select,textarea){box-sizing:border-box;width:100%;padding:8px;border:1px solid var(--dsw-alias-border-l2);border-radius:8px;background:var(--dsw-alias-bg-layer-1);color:inherit;font:inherit}
-.dlv-settings small,.dlv-settings p{font-size:13px;color:var(--dsw-alias-label-secondary);line-height:1.5}
+.dlv-settings small,.dlv-settings p{font-size:13px;color:var(--dsw-alias-label-secondary);line-height:1.5}.dlv-settings .dlv-setting-description{line-height:1.65;margin:3px 0 5px}.dlv-settings .dlv-conversation-fields{display:grid;gap:20px;padding:4px 0}
 .dlv-preset-group{display:grid;grid-template-columns:repeat(3,minmax(0,1fr));gap:8px}.dlv-settings label.dlv-preset{display:flex;align-items:flex-start;gap:8px;padding:10px;border:1px solid var(--dsw-alias-border-l1);border-radius:8px;cursor:pointer}.dlv-settings label.dlv-preset:has(input:checked){border-color:var(--dsw-alias-label-primary);background:var(--dsw-alias-bg-layer-1)}.dlv-settings label.dlv-preset input{width:auto;margin-top:3px}.dlv-preset span{display:grid;gap:3px}.dlv-vad-summary{font-weight:500}
 .dlv-settings-actions{display:flex;flex-wrap:wrap;gap:8px}.dlv-settings-actions button{padding:8px 12px;border:1px solid var(--dsw-alias-border-l2);border-radius:8px;background:var(--dsw-alias-bg-layer-1);color:inherit;cursor:pointer}.dlv-settings-actions button:disabled{opacity:.45;cursor:default}
 @media(max-width:480px){.dlv-settings-heading{gap:6px}.dlv-heading-divider{min-width:4px}.dlv-settings-heading .dlv-star-badge{padding:3px 6px;font-size:10px}.dlv-preset-group{grid-template-columns:1fr}.dlv-pill{flex-wrap:wrap}.dlv-wave{flex-basis:90px}.dlv-status{flex-basis:100px}}

package/lib/server.js

@@ -304,7 +304,7 @@ var QwenHttpHost = class {
     baseUrl,
     timeoutMs = 3e5,
     fetchImpl = globalThis.fetch,
-    maxBytes = 2e6,
+    maxBytes = 5e7,
     maxSpeechBytes = 5e7,
     store
   } = {}) {

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "dsh-live-voice",
-  "version": "0.3.0",
-  "dshTestedVersion": "0.1.6-alpha.2",
+  "version": "0.3.1",
+  "dshTestedVersion": "0.2.0-rc.2",
   "type": "module",
   "scripts": {
     "typecheck": "tsc --noEmit",

package/src/app/AGENTS.md

@@ -0,0 +1,7 @@
+# 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.
+
+- 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.
+- Treat `package.json` as the source of truth for plugin and tested-DSH versions. Never hard-code these in the client.

package/src/app/ARCHITECTURE.md

@@ -0,0 +1,10 @@
+# Application architecture
+
+`src/app` is the composition boundary between DSH and the voice-domain modules. Client and server entry points remain separate; host-only Node dependencies must never enter the browser bundle.
+
+- `client/apply.tsx` injects DSH client services, creates session controllers and voice ownership, wires engines and settings, and disposes resources. `client/slotDefinitions.ts` and `client/registerSlots.tsx` own the established slot IDs, order, and registration. Preserve those contracts when changing placement.
+- `server/apply.ts` composes host engines and providers. `server/registerRoutes.ts` registers authenticated same-origin routes; do not bypass their validation or expose host access directly to browser code.
+- `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.

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

@@ -136,6 +136,7 @@ export interface LiveVoiceTranslation extends Translation {
   'dsh-live-voice.settings.delivery.toggle': string;
   'dsh-live-voice.settings.engine.refresh': string;
   'dsh-live-voice.settings.filters.title': string;
+  'dsh-live-voice.settings.general.title': string;
   'dsh-live-voice.settings.tabs.conversation': string;
   'dsh-live-voice.settings.tabs.recognition': string;
   'dsh-live-voice.settings.tabs.speak': string;

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

@@ -162,6 +162,7 @@ const en: LiveVoiceTranslation = {
   'dsh-live-voice.settings.delivery.toggle': 'Automatic delivery mode',
   'dsh-live-voice.settings.engine.refresh': 'Refresh available engines',
   'dsh-live-voice.settings.filters.title': 'Filtering',
+  'dsh-live-voice.settings.general.title': 'General',
   'dsh-live-voice.settings.tabs.conversation': 'Conversation',
   'dsh-live-voice.settings.tabs.recognition': 'Speech recognition',
   'dsh-live-voice.settings.tabs.speak': 'Speech',

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

@@ -175,6 +175,7 @@ const es: LiveVoiceTranslation = {
   'dsh-live-voice.settings.delivery.toggle': 'Modo de envío automático',
   'dsh-live-voice.settings.engine.refresh': 'Actualizar los motores disponibles',
   'dsh-live-voice.settings.filters.title': 'Filtrado',
+  'dsh-live-voice.settings.general.title': 'General',
   'dsh-live-voice.settings.tabs.conversation': 'Conversación',
   'dsh-live-voice.settings.tabs.recognition': 'Reconocimiento de voz',
   'dsh-live-voice.settings.tabs.speak': 'Síntesis de voz',

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

@@ -178,6 +178,7 @@ const fr: LiveVoiceTranslation = {
   'dsh-live-voice.settings.delivery.toggle': 'Mode d’envoi automatique',
   'dsh-live-voice.settings.engine.refresh': 'Actualiser les moteurs disponibles',
   'dsh-live-voice.settings.filters.title': 'Filtrage',
+  'dsh-live-voice.settings.general.title': 'Général',
   'dsh-live-voice.settings.tabs.conversation': 'Conversation',
   'dsh-live-voice.settings.tabs.recognition': 'Reconnaissance vocale',
   'dsh-live-voice.settings.tabs.speak': 'Synthèse vocale',

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

@@ -165,6 +165,7 @@ const hi: LiveVoiceTranslation = {
   'dsh-live-voice.settings.delivery.toggle': 'स्वचालित भेजने का मोड',
   'dsh-live-voice.settings.engine.refresh': 'उपलब्ध इंजन रीफ़्रेश करें',
   'dsh-live-voice.settings.filters.title': 'फ़िल्टरिंग',
+  'dsh-live-voice.settings.general.title': 'सामान्य',
   'dsh-live-voice.settings.tabs.conversation': 'बातचीत',
   'dsh-live-voice.settings.tabs.recognition': 'वाक् पहचान',
   'dsh-live-voice.settings.tabs.speak': 'वाचन',

package/src/app/client/i18n/catalogs/pt-BR.ts

@@ -169,6 +169,7 @@ const ptBR: LiveVoiceTranslation = {
   'dsh-live-voice.settings.delivery.toggle': 'Modo de entrega automática',
   'dsh-live-voice.settings.engine.refresh': 'Atualizar mecanismos disponíveis',
   'dsh-live-voice.settings.filters.title': 'Filtragem',
+  'dsh-live-voice.settings.general.title': 'Gerais',
   'dsh-live-voice.settings.tabs.conversation': 'Conversa',
   'dsh-live-voice.settings.tabs.recognition': 'Reconhecimento de voz',
   'dsh-live-voice.settings.tabs.speak': 'Fala',

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

@@ -156,6 +156,7 @@ const zh: LiveVoiceTranslation = {
   'dsh-live-voice.settings.delivery.toggle': '自动发送模式',
   'dsh-live-voice.settings.engine.refresh': '刷新可用引擎',
   'dsh-live-voice.settings.filters.title': '过滤',
+  'dsh-live-voice.settings.general.title': '常规',
   'dsh-live-voice.settings.tabs.conversation': '对话',
   'dsh-live-voice.settings.tabs.recognition': '语音识别',
   'dsh-live-voice.settings.tabs.speak': '语音合成',

package/src/modules/AGENTS.md

@@ -0,0 +1,5 @@
+# Module guidance
+
+Read the nearest module's `ARCHITECTURE.md` before changing its behavior. `src/modules` owns product policy, feature UI, models, providers, and services. Modules may use `src/shared` and the centralized `src/app/client/i18n` API, but must not register DSH slots or host routes; composition belongs to `src/app`.
+
+Preserve local-first STT and TTS options without claiming DSH itself is offline. Track capture/recognition, synthesis/playback, and agent generation separately. Preserve pause, resume, cancel, ownership, interruption, and stale asynchronous result semantics. Avoid logging raw audio or transcripts by default. Consult [VOICE-LIFECYCLE.md](../../docs/VOICE-LIFECYCLE.md) for the behavioral contract and [root guidance](../../AGENTS.md) for testing and authorization.

package/src/modules/conversation/ARCHITECTURE.md

@@ -0,0 +1,5 @@
+# Conversation module
+
+`models/chat.ts` interprets DSH chat turns and pending questions. `hooks/useConversationController.ts` subscribes to session state; `hooks/useConversationActions.ts` maps user actions onto the controller. `components/` renders composer controls, microphone state, playback controls, status, and waveform; `createConversationComponents.tsx` composes them for the application slot boundary.
+
+Keep UI components session-facing rather than importing host engines or registering slots. Preserve the DSH composer contract: `useInput` provides subscribed input and `inputActions.setDraft()` updates the composer; a recognition result must not be lost to stale interim updates. History pagination must not count as a new user turn. Do not treat sending, recognition, playback, or agent generation as one state. See [voice lifecycle](../../../docs/VOICE-LIFECYCLE.md) before changing interruption or turn-taking.

package/src/modules/core/ARCHITECTURE.md

@@ -0,0 +1,5 @@
+# Core voice domain
+
+`core` owns policy and reusable voice-domain state, not DSH slot/route registration or provider-specific presentation. `coordinator.ts` serializes input transitions, owns conversation state and speech queues, and invalidates stale async work with generations. `ownership.ts` arbitrates microphone and speaker use between sessions and Settings self-tests. `transcript.ts` manages draft/final recognition text, `microphone.ts` manages capture and activity, `filters.ts` handles voice commands and speech text filtering, and `settings.ts` normalizes persisted values and defaults.
+
+The `qwen/` subtree contains shared Qwen host configuration and its settings UI; recognition and speaking adapters live in their respective modules. Keep the client/host dependency graphs separate. Preserve the persisted `dsh-live-voice.settings` key and normalization compatibility. Distinguish capture, recognition, playback, and generation; do not conflate pausing with cancellation or resume obsolete speech after a new turn. Consult [voice lifecycle](../../../docs/VOICE-LIFECYCLE.md) for expected transitions.

package/src/modules/core/qwen/QwenHttpHost.ts

@@ -64,7 +64,7 @@ export class QwenHttpHost {
     baseUrl,
     timeoutMs = 300000,
     fetchImpl = globalThis.fetch,
-    maxBytes = 2_000_000,
+    maxBytes = 50_000_000,
     maxSpeechBytes = 50_000_000,
     store,
   } = {}) {

package/src/modules/recognition/ARCHITECTURE.md

@@ -0,0 +1,5 @@
+# Recognition module
+
+`engines/browser/BrowserRecognitionEngine.ts` adapts browser speech recognition and reports local-pack/browser capabilities. `engines/qwen/QwenRecognitionEngine.ts` and `engines/whisper/WhisperRecognitionEngine.ts` adapt local-first HTTP recognition; host bridges live beside the relevant adapters (Whisper here, shared Qwen configuration in `../core/qwen`). `components/RecognitionCapabilityStatus.tsx` and engine settings UI present capability and configuration states.
+
+Distinguish microphone capture and permission from recognition engine availability. Do not infer feature support merely from operating system. Bound audio and host requests, keep host-only code out of the browser bundle, and abort/ignore stale results after cancellation. Recognition language and voice-command phrases are independent of the interface locale. Browser simulations are not a physical microphone or model acceptance test.

package/src/modules/settings/ARCHITECTURE.md

@@ -0,0 +1,5 @@
+# Settings module
+
+`components/LiveVoiceSettings.tsx` owns the tabbed Settings shell; `sections/{conversation,recognition,speak}` own feature controls. `hooks/useLiveVoiceSettings.ts` subscribes to controller state and dispatches updates, while `hooks/useAudioDevices.ts` and `hooks/useReleaseStatus.ts` handle capability-adjacent data. `models/settingsStorage.ts` owns storage integration; `services/releases.ts` supports version metadata. Shared fields, layout, icons, and feedback live in `src/shared/design-system`.
+
+Preserve existing setting names, default values, handlers, and normalization in `../core/settings.ts`; reorganizing presentation must not silently change policy. Keep transient capability/permission messages visible even when an options section is collapsed. User-facing copy and accessible names belong in all typed catalogs under `src/app/client/i18n`; UI locale does not select recognition or speech language. The preview in `__previewjs__/LiveVoicePreviews.tsx` exercises presentation with a fake controller, not a physical microphone or authenticated DSH runtime. Run `npm test` after changes and check the preview for layout and interaction.

package/src/modules/settings/components/LiveVoiceSettings.tsx

@@ -17,9 +17,17 @@ export function LiveVoiceSettings({ controller, onClose }: { controller: any; on
   const [activeTab, setActiveTab] = React.useState('conversation');
   const tabsId = React.useId();
   const tabs = [
-    { id: 'speech', label: (settingsLanguage as any).tabs.speak() },
-    { id: 'recognition', label: (settingsLanguage as any).tabs.recognition() },
-    { id: 'conversation', label: (settingsLanguage as any).tabs.conversation() },
+    { id: 'speech', label: (settingsLanguage as any).tabs.speak(), icon: 'speaker' as const },
+    {
+      id: 'recognition',
+      label: (settingsLanguage as any).tabs.recognition(),
+      icon: 'mic' as const,
+    },
+    {
+      id: 'conversation',
+      label: (settingsLanguage as any).tabs.conversation(),
+      icon: 'send' as const,
+    },
   ];
   const sectionProps = {
     controller,

package/src/modules/settings/sections/conversation/ConversationSettingsSection.tsx

@@ -1,5 +1,6 @@
 import React from 'react';
-import { SettingsCard } from '../../../../shared/design-system/index.js';
+import { useLanguage } from '../../../../app/client/i18n/index.js';
+import { SettingsCard, SettingsSubcard } from '../../../../shared/design-system/index.js';
 import { DeliverySettings } from './DeliverySettings.js';
 import { HoldToTalkSettings } from './HoldToTalkSettings.js';
 import { VoiceModeSettings } from './VoiceModeSettings.js';
@@ -9,14 +10,19 @@ export function ConversationSettingsSection(props: {
   settings: any;
   updateSettings(value: any): void;
 }) {
+  const { scoped: settingsLanguage } = useLanguage((ctx) => ctx.settings);
   return (
     <SettingsCard>
       <div className="dlv-settings-card-body">
-        <DeliverySettings {...props} />
-        <HoldToTalkSettings {...props} />
-        <VoiceModeSettings {...props} />
-        <PlaybackPolicySettings {...props} />
-        <ConversationDelaySettings {...props} />
+        <SettingsSubcard title={(settingsLanguage as any).general.title()} icon="send">
+          <div className="dlv-conversation-fields">
+            <DeliverySettings {...props} />
+            <HoldToTalkSettings {...props} />
+            <VoiceModeSettings {...props} />
+            <PlaybackPolicySettings {...props} />
+            <ConversationDelaySettings {...props} />
+          </div>
+        </SettingsSubcard>
       </div>
     </SettingsCard>
   );

package/src/modules/settings/sections/recognition/RecognitionEngineSettings.tsx

@@ -93,13 +93,13 @@ export function RecognitionEngineSettings({
         </>
       )}
       {engine === 'whisper-http' && (
-        <SettingsSubcard title={(commons as any).connection.title()}>
+        <SettingsSubcard title={(commons as any).connection.title()} icon="link">
           <p>{(recognition as any).whisper.captureHelp()}</p>
           <WhisperSettings controller={controller} />
         </SettingsSubcard>
       )}
       {engine === 'qwen-http' && (
-        <SettingsSubcard title={(commons as any).connection.title()}>
+        <SettingsSubcard title={(commons as any).connection.title()} icon="link">
           <p>{(recognition as any).qwen.captureHelp()}</p>
           {settings.engine !== 'qwen-http' && <QwenSettings controller={controller} />}
         </SettingsSubcard>

package/src/modules/settings/sections/recognition/RecognitionFilterSettings.tsx

@@ -9,7 +9,7 @@ export function RecognitionFilterSettings({ settings, updateSettings }: any) {
   const { scoped: recognition } = useLanguage((ctx) => ctx.recognition);
   const enabled = settings.recognitionFilterEnabled !== false;
   return (
-    <SettingsSubcard title={(recognition as any).minimumWords.label()}>
+    <SettingsSubcard title={(recognition as any).minimumWords.label()} icon="filter">
       <CheckboxField
         label={(recognition as any).minimumWords.enabled()}
         description={(recognition as any).minimumWords.help()}

package/src/modules/settings/sections/recognition/RecognitionSettingsSection.tsx

@@ -1,19 +1,23 @@
 import React from 'react';
-import { SettingsCard } from '../../../../shared/design-system/index.js';
+import { useLanguage } from '../../../../app/client/i18n/index.js';
+import { SettingsCard, SettingsSubcard } from '../../../../shared/design-system/index.js';
 import { RecognitionEngineSettings } from './RecognitionEngineSettings.js';
 import { RecognitionFilterSettings } from './RecognitionFilterSettings.js';
 import { SilenceDetectionSettings } from './SilenceDetectionSettings.js';
 import { VoiceCommandSettings } from './VoiceCommandSettings.js';
 import { RecognitionStatus } from './RecognitionStatus.js';
 export function RecognitionSettingsSection(props: any) {
+  const { scoped: settingsLanguage } = useLanguage((ctx) => ctx.settings);
   return (
     <SettingsCard>
       <div className="dlv-settings-card-body">
-        <RecognitionEngineSettings {...props} />
+        <RecognitionStatus {...props} />
+        <SettingsSubcard title={(settingsLanguage as any).general.title()} icon="mic">
+          <RecognitionEngineSettings {...props} />
+        </SettingsSubcard>
         <VoiceCommandSettings {...props} />
         <RecognitionFilterSettings {...props} />
         <SilenceDetectionSettings {...props} />
-        <RecognitionStatus {...props} />
       </div>
     </SettingsCard>
   );

package/src/modules/settings/sections/recognition/SilenceDetectionSettings.tsx

@@ -10,7 +10,7 @@ export function SilenceDetectionSettings({ settings, updateSettings }: any) {
     <SettingsSubcard
       title={(recognition as any).silenceDetection.label()}
       ariaLabel={(recognition as any).silenceDetection.title()}
-      open
+      icon="pause"
     >
       <p>{(recognition as any).silenceDetection.help()}</p>
       <NumberField

package/src/modules/settings/sections/recognition/VoiceCommandSettings.tsx

@@ -18,7 +18,7 @@ export function VoiceCommandSettings({ settings, updateSettings }: any) {
   const { scoped: recognition } = useLanguage((ctx) => ctx.recognition);
   const enabled = settings.voiceCommandsEnabled !== false;
   return (
-    <SettingsSubcard title={(recognition as any).commands.title()}>
+    <SettingsSubcard title={(recognition as any).commands.title()} icon="send">
       <CheckboxField
         label={(recognition as any).commands.enabled()}
         checked={enabled}

package/src/modules/settings/sections/speak/OutputFilterSettings.tsx

@@ -10,7 +10,7 @@ export function OutputFilterSettings({ settings, updateSettings }: any) {
   const { scoped: speak } = useLanguage((ctx) => ctx.speak);
   const enabled = settings.outputCodeFilterEnabled !== false;
   return (
-    <SettingsSubcard title={(speak as any).filters.code.enabled()}>
+    <SettingsSubcard title={(speak as any).filters.code.enabled()} icon="filter">
       <CheckboxField
         label={(speak as any).filters.code.enabled()}
         checked={enabled}

package/src/modules/settings/sections/speak/SpeakSettingsSection.tsx

@@ -1,14 +1,18 @@
 import React from 'react';
-import { SettingsCard } from '../../../../shared/design-system/index.js';
+import { useLanguage } from '../../../../app/client/i18n/index.js';
+import { SettingsCard, SettingsSubcard } from '../../../../shared/design-system/index.js';
 import { OutputFilterSettings } from './OutputFilterSettings.js';
 import { SpeechEngineSettings } from './SpeechEngineSettings.js';
 import { SpeechAdvancedSettings } from './SpeechAdvancedSettings.js';
 export function SpeakSettingsSection(props: any) {
+  const { scoped: settingsLanguage } = useLanguage((ctx) => ctx.settings);
   return (
     <SettingsCard>
       <div className="dlv-settings-card-body">
-        <SpeechEngineSettings {...props} />
-        <SpeechAdvancedSettings {...props} />
+        <SettingsSubcard title={(settingsLanguage as any).general.title()} icon="speaker">
+          <SpeechEngineSettings {...props} />
+          <SpeechAdvancedSettings {...props} />
+        </SettingsSubcard>
         <OutputFilterSettings {...props} />
       </div>
     </SettingsCard>

package/src/modules/settings/sections/speak/SpeechAdvancedSettings.tsx

@@ -39,11 +39,11 @@ export function SpeechAdvancedSettings({
         <p className="dlv-setting-description">{(speak as any).macos.outputHelp()}</p>
       )}
       {settings.engine === 'qwen-http' && (
-        <SettingsSubcard title={(speak as any).qwen.connection()}>
+        <SettingsSubcard title={(speak as any).qwen.connection()} icon="link">
           <QwenSettings controller={controller} />
         </SettingsSubcard>
       )}
-      <SettingsSubcard title={(speak as any).agentContext.label()}>
+      <SettingsSubcard title={(speak as any).agentContext.label()} icon="settings">
         <CheckboxField
           label={(speak as any).agentContext.enabled()}
           checked={settings.agentVoiceContextEnabled !== false}

package/src/modules/settings/services/releases.ts

@@ -13,7 +13,7 @@ export const RELEASE_CHECK_INTERVAL_MS = 24 * 60 * 60 * 1000;
 
 export const LIVE_VOICE_BADGE_URL = 'https://cdn.simpleicons.org/npm/white';
 export const DSH_BADGE_URL = 'https://cdn.simpleicons.org/deepseek/white';
-export const TESTED_DSH_RELEASE_URL = `https://github.com/deepseek-ai/deepseek-harness/releases/tag/v${TESTED_DSH_VERSION}`;
+export const TESTED_DSH_RELEASE_URL = `https://github.com/deepseek-ai/deepseek-harness/releases/tag/dsh-v${TESTED_DSH_VERSION}`;
 
 function versionParts(version) {
   const normalized = String(version || '')

package/src/modules/speak/ARCHITECTURE.md

@@ -0,0 +1,5 @@
+# Speaking module
+
+`services/speechQueue.ts` schedules speech independently of capture and agent generation. `engines/browser/BrowserSpeakingEngine.ts` uses browser voices, `engines/qwen/QwenSpeakingEngine.ts` uses the Qwen HTTP bridge, and `engines/say/` uses the macOS host speaker. `engines/audio/` manages host audio playback and transcoding. `qwen/QwenSpeakingSettings.tsx` presents engine-specific settings.
+
+Keep provider adapters separate from conversation policy and DSH composition. Maintain truthful pause/resume capability and distinguish pause from stop/cancel. Abort old operations and prevent stale synthesized audio from beginning after a newer turn or cancellation. Do not let a Settings speech test bypass page-level ownership. Local TTS is an option; it does not imply the DSH model runs offline.

package/src/shared/ARCHITECTURE.md

@@ -0,0 +1,5 @@
+# Shared design system
+
+`design-system/` contains domain-independent React primitives: buttons, form fields, feedback, layout, and SVG icons. It must never import feature modules or DSH integration. Modules supply translated strings and handlers; shared components only render and dispatch them. Icons use `currentColor` so they follow surrounding text across themes.
+
+Settings layouts include accessible cards, tab navigation, and native disclosure sections. Keep `<details>/<summary>` keyboard behavior and ARIA semantics when changing a subsection; headings and icons should not become separate unlabeled controls. Shared primitives should not own persisted settings, product policy, or translation catalogs.

package/src/shared/design-system/icons/icons.ts

@@ -10,6 +10,10 @@ export const iconPaths = {
   skipNext: 'M5 5l10 7-10 7V5M19 5v14',
   send: 'M3 11.5L21 3l-8.5 18-2-7.5L3 11.5zm7.5 2L21 3',
   queue: 'M5 6h14M5 12h10M5 18h6M18 15v6M15 18h6',
+  settings: 'M4 7h16M4 17h16M8 4v6M16 14v6',
+  filter: 'M3 5h18l-7 8v6l-4 2v-8L3 5z',
+  link: 'M10 13a5 5 0 0 0 7.07 0l3-3a5 5 0 0 0-7.07-7.07l-1.7 1.7M14 11a5 5 0 0 0-7.07 0l-3 3a5 5 0 0 0 7.07 7.07l1.7-1.7',
+  chevron: 'M6 9l6 6 6-6',
   close: 'M6 6l12 12M18 6 6 18',
 } as const;
 

package/src/shared/design-system/layout/SettingsSubcard.tsx

@@ -1,13 +1,25 @@
 import React from 'react';
+import { Icon, type IconName } from '../icons/index.js';
+
 export function SettingsSubcard({
   title,
   children,
   open = false,
   ariaLabel,
-}: React.PropsWithChildren<{ title: string; open?: boolean; ariaLabel?: string }>) {
+  icon = 'settings',
+}: React.PropsWithChildren<{
+  title: string;
+  open?: boolean;
+  ariaLabel?: string;
+  icon?: IconName;
+}>) {
   return (
-    <details className="dlv-settings-subcard" open={open} aria-label={ariaLabel}>
-      <summary>{title}</summary>
+    <details className="dlv-settings-subcard" open={open}>
+      <summary aria-label={ariaLabel}>
+        <Icon name={icon} className="dlv-settings-subcard-icon" />
+        <span>{title}</span>
+        <Icon name="chevron" className="dlv-settings-subcard-chevron" />
+      </summary>
       <div className="dlv-settings-subcard-body">{children}</div>
     </details>
   );

package/src/shared/design-system/layout/SettingsTabs.tsx

@@ -1,6 +1,7 @@
 import React from 'react';
+import { Icon, type IconName } from '../icons/index.js';
 
-export type SettingsTab = { id: string; label: string };
+export type SettingsTab = { id: string; label: string; icon?: IconName };
 export type SettingsTabsProps = {
   label: string;
   tabs: readonly SettingsTab[];
@@ -46,7 +47,8 @@ export function SettingsTabs({ label, tabs, active, idPrefix, onChange }: Settin
           onClick={() => onChange(tab.id)}
           onKeyDown={(event) => onKeyDown(event, index)}
         >
-          {tab.label}
+          {tab.icon ? <Icon name={tab.icon} className="dlv-settings-tab-icon" /> : null}
+          <span>{tab.label}</span>
         </button>
       ))}
     </div>

package/src/styles/index.ts

@@ -31,10 +31,10 @@ export const styles = `
 .dlv-settings h3,.dlv-settings p{margin:0}
 .dlv-settings-heading{display:flex;align-items:center;gap:8px;min-width:0}.dlv-settings-heading h3{white-space:nowrap}.dlv-heading-divider{height:1px;min-width:12px;flex:1;background:var(--dsw-alias-border-l1)}.dlv-settings-heading .dlv-star-badge{flex:none}
 .dlv-version-badges{display:flex;flex:none;gap:5px;align-items:center}.dlv-shields-badge{display:inline-flex;align-items:center;justify-content:center;box-sizing:border-box;height:20px;gap:4px;padding:3px 5px;border:1px solid var(--dsw-alias-border-l1);border-radius:5px;background:var(--dsw-alias-bg-layer-1);color:var(--dsw-alias-label-secondary);font-size:10px;font-weight:650;line-height:12px;text-decoration:none}.dlv-shields-badge img{display:block;width:12px;height:12px;max-width:100%}.dlv-shields-badge:focus-visible{border-radius:4px;outline:2px solid var(--dsw-alias-label-primary);outline-offset:3px}.dlv-version-badge{display:inline-flex;align-items:center;min-height:24px;box-sizing:border-box;padding:3px 8px;border:1px solid var(--dsw-alias-border-l1);border-radius:999px;background:var(--dsw-alias-bg-layer-1);color:var(--dsw-alias-label-secondary);font-size:11px;font-weight:650;line-height:16px;text-decoration:none}.dlv-version-badges a.dlv-version-badge:hover{border-color:var(--dsw-alias-border-l2);color:var(--dsw-alias-label-primary)}.dlv-star-badge{padding:4px 10px;color:var(--dsw-alias-label-primary)}.dlv-update-icon{margin-right:4px;font-size:14px;line-height:1}.dlv-star-icon{margin-right:4px;color:#f59e0b;font-size:14px;line-height:1;text-shadow:0 0 8px rgba(245,158,11,.28)}.dlv-version-badges a.dlv-star-badge:hover{border-color:#f59e0b;background:rgba(245,158,11,.08)}.dlv-update-badge{border-color:var(--dsw-alias-state-business-primary);color:var(--dsw-alias-state-business-primary)}
-.dlv-settings-tabs{border-bottom:.5px solid var(--dsw-alias-border-l2);display:flex;align-items:flex-end;gap:22px;overflow-x:auto}.dlv-settings-tab{position:relative;flex:none;padding:7px 1px 9px;border:0;background:transparent;color:var(--dsw-alias-label-tertiary);font:inherit;font-size:13px;line-height:20px;cursor:pointer}.dlv-settings-tab:hover,.dlv-settings-tab[data-active=true]{color:var(--dsw-alias-label-primary)}.dlv-settings-tab[data-active=true]:after,.dlv-settings-tab:focus-visible:after{content:"";position:absolute;right:0;bottom:-1px;left:0;height:2px;border-radius:2px 2px 0 0;background:var(--dsw-alias-label-primary)}.dlv-settings-tab:focus-visible{border-radius:2px;outline:2px solid var(--dsw-alias-state-business-primary);outline-offset:2px;color:var(--dsw-alias-label-primary)}.dlv-settings-panel{min-width:0;padding-top:2px}.dlv-settings-panel[hidden]{display:none}.dlv-settings-group{margin:0;border:1px solid var(--dsw-alias-border-l1);border-radius:10px;min-width:0;display:grid;gap:14px;padding:16px}.dlv-settings-group legend{padding:0 6px;font-weight:600;color:var(--dsw-alias-label-primary)}.dlv-settings-card-body{display:grid;gap:12px;padding:12px 0}.dlv-settings-subcard{border:1px solid var(--dsw-alias-border-l2);border-radius:8px;min-width:0}.dlv-settings-subcard>summary{cursor:pointer;font-weight:650;list-style:none;display:flex;align-items:center;justify-content:space-between;padding:10px}.dlv-settings-subcard>summary::-webkit-details-marker{display:none}.dlv-settings-subcard>summary:after{content:"›";transform:rotate(90deg);transition:transform .15s}.dlv-settings-subcard:not([open])>summary:after{transform:rotate(0)}.dlv-settings-subcard-body{display:grid;gap:10px;padding:0 10px 10px}
+.dlv-settings-tabs{border-bottom:.5px solid var(--dsw-alias-border-l2);display:flex;align-items:flex-end;gap:22px;overflow-x:auto}.dlv-settings-tab{position:relative;display:inline-flex;align-items:center;gap:6px;flex:none;padding:7px 1px 9px;border:0;background:transparent;color:var(--dsw-alias-label-tertiary);font:inherit;font-size:16px;font-weight:600;line-height:22px;cursor:pointer}.dlv-settings-tab-icon{width:17px;height:17px;flex:none}.dlv-settings-tab:hover,.dlv-settings-tab[data-active=true]{color:var(--dsw-alias-label-primary)}.dlv-settings-tab[data-active=true]:after,.dlv-settings-tab:focus-visible:after{content:"";position:absolute;right:0;bottom:-1px;left:0;height:2px;border-radius:2px 2px 0 0;background:var(--dsw-alias-label-primary)}.dlv-settings-tab:focus-visible{border-radius:2px;outline:2px solid var(--dsw-alias-state-business-primary);outline-offset:2px;color:var(--dsw-alias-label-primary)}.dlv-settings-panel{min-width:0;padding-top:2px}.dlv-settings-panel[hidden]{display:none}.dlv-settings-group{margin:0;border:1px solid var(--dsw-alias-border-l1);border-radius:10px;min-width:0;display:grid;gap:14px;padding:16px}.dlv-settings-group legend{padding:0 6px;font-weight:600;color:var(--dsw-alias-label-primary)}.dlv-settings-card-body{display:grid;gap:18px;padding:8px 0 12px}.dlv-settings-subcard{min-width:0;margin:8px 0 0}.dlv-settings-subcard>summary{cursor:pointer;list-style:none;display:flex;align-items:center;gap:9px;padding:10px 12px;border-bottom:1px solid var(--dsw-alias-border-l1);border-radius:6px 6px 0 0;background:color-mix(in srgb,var(--dsw-alias-bg-layer-2) 38%,transparent);color:var(--dsw-alias-label-secondary);font-size:14px;font-weight:500;line-height:20px}.dlv-settings-subcard>summary::-webkit-details-marker{display:none}.dlv-settings-subcard>summary:focus-visible{outline:2px solid var(--dsw-alias-label-primary);outline-offset:3px}.dlv-settings-subcard-icon{width:16px;height:16px;flex:none}.dlv-settings-subcard-chevron{width:16px;height:16px;margin-left:auto;flex:none;transition:transform .15s}.dlv-settings-subcard[open]>summary .dlv-settings-subcard-chevron{transform:rotate(180deg)}.dlv-settings-subcard-body{display:grid;gap:16px;padding:18px 0 6px}
 .dlv-settings label{display:grid;gap:6px;font-size:14px}.dlv-settings label.dlv-check{display:flex;align-items:center;gap:8px}.dlv-settings label.dlv-check input{width:auto}
 .dlv-settings :is(input,select,textarea){box-sizing:border-box;width:100%;padding:8px;border:1px solid var(--dsw-alias-border-l2);border-radius:8px;background:var(--dsw-alias-bg-layer-1);color:inherit;font:inherit}
-.dlv-settings small,.dlv-settings p{font-size:13px;color:var(--dsw-alias-label-secondary);line-height:1.5}
+.dlv-settings small,.dlv-settings p{font-size:13px;color:var(--dsw-alias-label-secondary);line-height:1.5}.dlv-settings .dlv-setting-description{line-height:1.65;margin:3px 0 5px}.dlv-settings .dlv-conversation-fields{display:grid;gap:20px;padding:4px 0}
 .dlv-preset-group{display:grid;grid-template-columns:repeat(3,minmax(0,1fr));gap:8px}.dlv-settings label.dlv-preset{display:flex;align-items:flex-start;gap:8px;padding:10px;border:1px solid var(--dsw-alias-border-l1);border-radius:8px;cursor:pointer}.dlv-settings label.dlv-preset:has(input:checked){border-color:var(--dsw-alias-label-primary);background:var(--dsw-alias-bg-layer-1)}.dlv-settings label.dlv-preset input{width:auto;margin-top:3px}.dlv-preset span{display:grid;gap:3px}.dlv-vad-summary{font-weight:500}
 .dlv-settings-actions{display:flex;flex-wrap:wrap;gap:8px}.dlv-settings-actions button{padding:8px 12px;border:1px solid var(--dsw-alias-border-l2);border-radius:8px;background:var(--dsw-alias-bg-layer-1);color:inherit;cursor:pointer}.dlv-settings-actions button:disabled{opacity:.45;cursor:default}
 @media(max-width:480px){.dlv-settings-heading{gap:6px}.dlv-heading-divider{min-width:4px}.dlv-settings-heading .dlv-star-badge{padding:3px 6px;font-size:10px}.dlv-preset-group{grid-template-columns:1fr}.dlv-pill{flex-wrap:wrap}.dlv-wave{flex-basis:90px}.dlv-status{flex-basis:100px}}