dsh-live-voice 0.2.2 → 0.2.3

package/CHANGELOG.md

@@ -2,6 +2,25 @@
 
 All notable changes to DSH Live Voice are documented in this file.
 
+## [0.2.3] - 2026-09-21
+
+### Features
+
+- Add an update notification in Live Voice settings when a newer GitHub release is available. The check runs at most once every 24 hours and the action opens the matching release.
+- Show the installed Live Voice version and the tested DSH version in the settings header.
+- Show Browser WebGPU Inference, sherpa-onnx Streaming, NVIDIA Parakeet, and Voxtral Realtime as disabled upcoming recognition engines.
+
+### Changes
+
+- Rename recognition-engine options to describe the API they use: Browser SpeechRecognition, Qwen3 ASR HTTP API, and Whisper HTTP API.
+- Show the expected HTTP URL or transcription route for the selected recognition engine.
+
+### Bug Fixes
+
+- Avoid repeated GitHub requests when the release API is unavailable by caching failed checks for the same 24-hour interval.
+- Handle release tags with a leading `v` and prerelease identifiers correctly when deciding whether an update is newer.
+- Ignore unexpected release URLs and fall back to the repository releases page.
+
 ## [0.2.2] - 2026-09-19
 
 ### Features
@@ -106,7 +125,8 @@ This release expands conversation control, audio routing, speech filtering, and
 - Support browser speech synthesis and native macOS `say` output.
 - Add Live Voice controls, Whisper settings, build and browser-preview scripts, and an initial test suite.
 
-[0.2.2]: https://github.com/victorwads/dsh-live-voice/compare/v0.2.1...HEAD
+[0.2.3]: https://github.com/victorwads/dsh-live-voice/compare/v0.2.2...HEAD
+[0.2.2]: https://github.com/victorwads/dsh-live-voice/compare/v0.2.1...v0.2.2
 [0.2.1]: https://github.com/victorwads/dsh-live-voice/compare/v0.2.0...v0.2.1
 [0.2.0]: https://github.com/victorwads/dsh-live-voice/compare/v0.1.0...v0.2.0
 [0.1.0]: https://github.com/victorwads/dsh-live-voice/compare/v0.0.2...v0.1.0

package/README.md

@@ -1,8 +1,7 @@
 # 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.pub registry status](https://dsh.pub/api/badges/victorwads/dsh-live-voice.svg)](https://dsh.pub/en/plugins/dsh-live-voice/)
-[![license](https://img.shields.io/badge/license-GPL--3.0--only-blue)](LICENSE)
+[![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)
 
 **A local-first, hands-free voice assistant plugin for DeepSeek Harness (DSH). Speak, listen, answer prompts, and keep working without touching the computer.**
 
@@ -10,8 +9,6 @@ Looking for a DeepSeek Harness voice plugin, DSH microphone plugin, speech-to-te
 
 It coordinates the microphone, composer, assistant messages, structured questions, and speech output without letting listening and speaking compete. Once voice conversation mode is running, DSH can narrate responses and questions, capture your spoken answers, and continue the conversation while your hands stay free.
 
-[![DSH tested](https://img.shields.io/badge/DSH%20tested-0.1.6--alpha.2-5c5cff?logo=deepseek&logoColor=white)](https://github.com/deepseek-ai/deepseek-harness/releases/tag/v0.1.6-alpha.2)
-
 ## Built for daily use, maintained with you
 
 I use DSH Live Voice for at least eight hours a day. For me, it is the best voice plugin for DSH — and I am committed to making it better through real, everyday use.

package/lib/client.js

@@ -2283,6 +2283,100 @@ function createQwenSettings(React2) {
   };
 }
 
+// src/client/releases.ts
+var CURRENT_VERSION = "0.2.3";
+var TESTED_DSH_VERSION = "0.1.6-alpha.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";
+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}`;
+function versionParts(version) {
+  const normalized = String(version || "").trim().replace(/^v/i, "").split("+", 1)[0];
+  const [core = "", prerelease = ""] = normalized.split("-", 2);
+  const numbers = core.split(".").map((part) => {
+    const match = part.match(/^\d+/);
+    return match ? Number(match[0]) : 0;
+  });
+  while (numbers.length < 3) numbers.push(0);
+  return { numbers, prerelease: prerelease ? prerelease.split(".") : [] };
+}
+function compareIdentifier(left, right) {
+  const leftNumber = /^\d+$/.test(left) ? Number(left) : null;
+  const rightNumber = /^\d+$/.test(right) ? Number(right) : null;
+  if (leftNumber !== null && rightNumber !== null) return Math.sign(leftNumber - rightNumber);
+  if (leftNumber !== null) return -1;
+  if (rightNumber !== null) return 1;
+  return left.localeCompare(right);
+}
+function compareVersions(left, right) {
+  const a = versionParts(left);
+  const b = versionParts(right);
+  for (let index = 0; index < Math.max(a.numbers.length, b.numbers.length); index++) {
+    const difference = (a.numbers[index] || 0) - (b.numbers[index] || 0);
+    if (difference) return Math.sign(difference);
+  }
+  if (!a.prerelease.length && !b.prerelease.length) return 0;
+  if (!a.prerelease.length) return 1;
+  if (!b.prerelease.length) return -1;
+  for (let index = 0; index < Math.max(a.prerelease.length, b.prerelease.length); index++) {
+    if (a.prerelease[index] === void 0) return -1;
+    if (b.prerelease[index] === void 0) return 1;
+    const difference = compareIdentifier(a.prerelease[index], b.prerelease[index]);
+    if (difference) return difference;
+  }
+  return 0;
+}
+function readCached(storage, now) {
+  try {
+    const cached = JSON.parse(storage?.getItem(RELEASE_CHECK_STORAGE_KEY) || "null");
+    if (cached && Number.isFinite(cached.checkedAt) && now - cached.checkedAt >= 0 && now - cached.checkedAt < RELEASE_CHECK_INTERVAL_MS)
+      return cached;
+  } catch {
+  }
+  return null;
+}
+function writeCached(storage, value) {
+  try {
+    storage?.setItem(RELEASE_CHECK_STORAGE_KEY, JSON.stringify(value));
+  } catch {
+  }
+}
+async function checkLatestRelease({
+  fetchImpl = globalThis.window?.fetch?.bind(globalThis.window),
+  storage = globalThis.window?.localStorage,
+  now = Date.now()
+} = {}) {
+  const cached = readCached(storage, now);
+  if (cached) return cached;
+  const attempted = { checkedAt: now, release: null };
+  writeCached(storage, attempted);
+  if (typeof fetchImpl !== "function") return attempted;
+  try {
+    const response = await fetchImpl(LATEST_RELEASE_API_URL, {
+      headers: { Accept: "application/vnd.github+json" }
+    });
+    if (!response.ok) return attempted;
+    const body = await response.json();
+    if (typeof body?.tag_name !== "string" || !body.tag_name.trim()) return attempted;
+    const release = {
+      tag: body.tag_name.trim(),
+      url: typeof body.html_url === "string" && body.html_url.startsWith("https://github.com/") ? body.html_url : RELEASES_URL
+    };
+    const result = { checkedAt: now, release };
+    writeCached(storage, result);
+    return result;
+  } catch {
+    return attempted;
+  }
+}
+function hasNewerRelease(release, currentVersion = CURRENT_VERSION) {
+  return Boolean(release?.tag && compareVersions(release.tag, currentVersion) > 0);
+}
+
 // src/client/components.ts
 function createComponents(React2) {
   const h = React2.createElement;
@@ -2576,6 +2670,17 @@ function createComponents(React2) {
     const settings = state.settings || {};
     const capabilities = state.capabilities || {};
     const tabsId = React2.useId();
+    const [latestRelease, setLatestRelease] = React2.useState(null);
+    React2.useEffect(() => {
+      let active = true;
+      void checkLatestRelease().then((result) => {
+        if (active) setLatestRelease(result.release);
+      });
+      return () => {
+        active = false;
+      };
+    }, []);
+    const updateAvailable = hasNewerRelease(latestRelease);
     const tabs = [
       { id: "conversation", label: "Conversation" },
       { id: "speech", label: "Speech" },
@@ -2668,7 +2773,69 @@ function createComponents(React2) {
     return h(
       "section",
       { className: "dlv-settings", "aria-label": "Live Voice settings" },
-      h("h3", null, "Live Voice"),
+      h(
+        "div",
+        { className: "dlv-settings-heading" },
+        h("h3", null, "Live Voice"),
+        h(
+          "div",
+          { className: "dlv-version-badges", "aria-label": "Version information" },
+          h(
+            "a",
+            {
+              className: "dlv-shields-badge",
+              href: RELEASES_URL,
+              target: "_blank",
+              rel: "noreferrer",
+              "aria-label": `DSH Live Voice v${CURRENT_VERSION}. Open releases`,
+              title: `DSH Live Voice v${CURRENT_VERSION}`
+            },
+            h("img", { src: LIVE_VOICE_BADGE_URL, alt: "" }),
+            h("span", null, `v${CURRENT_VERSION}`)
+          ),
+          h(
+            "a",
+            {
+              className: "dlv-shields-badge",
+              href: TESTED_DSH_RELEASE_URL,
+              target: "_blank",
+              rel: "noreferrer",
+              "aria-label": `Compatible with DSH v${TESTED_DSH_VERSION}. Open release`,
+              title: `Compatible with DSH v${TESTED_DSH_VERSION}`
+            },
+            h("img", { src: DSH_BADGE_URL, alt: "" }),
+            h("span", null, `v${TESTED_DSH_VERSION}`)
+          )
+        ),
+        h("span", { className: "dlv-heading-divider", "aria-hidden": true }),
+        updateAvailable ? h(
+          "a",
+          {
+            className: "dlv-version-badge dlv-update-badge",
+            href: latestRelease.url,
+            target: "_blank",
+            rel: "noreferrer",
+            "aria-label": `Update available: ${latestRelease.tag}. Open release`,
+            title: `Update available: ${latestRelease.tag}`
+          },
+          h("span", { className: "dlv-update-icon", "aria-hidden": true }, "\u2191"),
+          "Update available"
+        ) : null,
+        updateAvailable ? h("span", { className: "dlv-heading-divider", "aria-hidden": true }) : null,
+        h(
+          "a",
+          {
+            className: "dlv-version-badge dlv-star-badge",
+            href: REPOSITORY_URL,
+            target: "_blank",
+            rel: "noreferrer",
+            "aria-label": "Star DSH Live Voice on GitHub",
+            title: "Star DSH Live Voice on GitHub"
+          },
+          h("span", { className: "dlv-star-icon", "aria-hidden": true }, "\u2605"),
+          "Star Us on GitHub"
+        )
+      ),
       onClose ? h(Button, { label: "Close voice settings", icon: "close", onClick: onClose }) : null,
       h(
         "div",
@@ -2877,11 +3044,28 @@ function createComponents(React2) {
                   event.target.value === "browser" && settings.recognitionLang === "auto" ? { recognitionEngine: "browser", recognitionLang: "pt-BR" } : { recognitionEngine: event.target.value }
                 )
               },
-              h("option", { value: "qwen-http" }, "Qwen3 ASR \u2014 local MLX server"),
-              h("option", { value: "browser" }, "Browser SpeechRecognition"),
-              h("option", { value: "whisper-http" }, "Whisper HTTP \u2014 DSH host")
+              h("option", { value: "browser" }, "Browser SpeechRecognition \u2014 Default option"),
+              h("option", { value: "qwen-http" }, "Qwen3 ASR \u2014 HTTP API"),
+              h("option", { value: "whisper-http" }, "Whisper \u2014 HTTP API"),
+              h(
+                "optgroup",
+                { label: "Coming Soon \u2014 vote on repo issues" },
+                h("option", { value: "webgpu", disabled: true }, "Browser WebGPU Inference \u2014 Soon"),
+                h(
+                  "option",
+                  { value: "sherpa-onnx", disabled: true },
+                  "sherpa-onnx Streaming \u2014 Soon"
+                ),
+                h("option", { value: "parakeet", disabled: true }, "NVIDIA Parakeet \u2014 Soon"),
+                h("option", { value: "voxtral", disabled: true }, "Voxtral Realtime \u2014 Soon")
+              )
             )
           ),
+          h(
+            "small",
+            { className: "dlv-recognition-engine-description" },
+            settings.recognitionEngine === "qwen-http" ? "HTTP API at the configured base URL (default: http://127.0.0.1:8080/). Compatible with POST /v1/audio/transcriptions." : settings.recognitionEngine === "whisper-http" ? "HTTP API at the configured DSH host URL (default: http://127.0.0.1:8080/inference). Audio uses the authenticated DSH host transcription route." : "Uses the browser SpeechRecognition API. This is the default option."
+          ),
           field("Input device", "inputDeviceId", deviceOptions("audioinput", "Microphone")),
           settings.recognitionEngine === "browser" ? h(
             "small",
@@ -3236,13 +3420,15 @@ var styles = `
 .dlv-error{color:var(--dsw-alias-state-error-primary);overflow-wrap:anywhere;font-size:13px;max-width:720px;margin:8px auto}
 .dlv-settings{box-sizing:border-box;padding:18px;width:100%;display:grid;gap:16px;max-width:640px;color:var(--dsw-alias-label-primary)}
 .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 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-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-preset-group{grid-template-columns:1fr}.dlv-pill{flex-wrap:wrap}.dlv-wave{flex-basis:90px}.dlv-status{flex-basis:100px}}
+@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}}
 `;
 
 // src/client/chat.ts

package/package.json

@@ -1,6 +1,7 @@
 {
   "name": "dsh-live-voice",
-  "version": "0.2.2",
+  "version": "0.2.3",
+  "dshTestedVersion": "0.1.6-alpha.2",
   "type": "module",
   "scripts": {
     "typecheck": "tsc --noEmit",

package/scripts/build.ts

@@ -1,6 +1,12 @@
 // @ts-nocheck
 import { build, context, type BuildOptions } from 'esbuild';
-import { rm, mkdir } from 'node:fs/promises';
+import { rm, mkdir, readFile } from 'node:fs/promises';
+
+const packageMetadata = JSON.parse(await readFile('package.json', 'utf8'));
+const versionDefine = {
+  __DLV_VERSION__: JSON.stringify(packageMetadata.version),
+  __DLV_TESTED_DSH_VERSION__: JSON.stringify(packageMetadata.dshTestedVersion),
+};
 
 const client: BuildOptions = {
   entryPoints: ['src/client/index.ts'],
@@ -10,6 +16,7 @@ const client: BuildOptions = {
   platform: 'browser',
   target: ['es2022'],
   external: ['react', 'react-dom'],
+  define: versionDefine,
   banner: {
     js: 'window.__ModuleLoader__.load({id:"dsh-live-voice",factory:(require)=>{var module={exports:{}};var exports=module.exports;',
   },
@@ -35,6 +42,7 @@ const tests: BuildOptions = {
   platform: 'node',
   target: ['node22'],
   packages: 'external',
+  define: versionDefine,
   logLevel: 'silent',
 };
 const watch = process.argv.includes('--watch');

package/src/client/components.ts

@@ -2,6 +2,17 @@
 import { createWhisperSettings } from './whisper-settings.ts';
 import { createQwenSettings } from './qwen-settings.ts';
 import { qwenVoices, usesPluginVoiceDetection, voiceDetectionPresets } from '../core/settings.ts';
+import {
+  checkLatestRelease,
+  CURRENT_VERSION,
+  DSH_BADGE_URL,
+  hasNewerRelease,
+  LIVE_VOICE_BADGE_URL,
+  RELEASES_URL,
+  REPOSITORY_URL,
+  TESTED_DSH_RELEASE_URL,
+  TESTED_DSH_VERSION,
+} from './releases.ts';
 
 // UI only: the controller owns capture, recognition, playback and policy.
 export function createComponents(React) {
@@ -383,6 +394,17 @@ export function createComponents(React) {
     const settings = state.settings || {};
     const capabilities = state.capabilities || {};
     const tabsId = React.useId();
+    const [latestRelease, setLatestRelease] = React.useState(null);
+    React.useEffect(() => {
+      let active = true;
+      void checkLatestRelease().then((result) => {
+        if (active) setLatestRelease(result.release);
+      });
+      return () => {
+        active = false;
+      };
+    }, []);
+    const updateAvailable = hasNewerRelease(latestRelease);
     const tabs = [
       { id: 'conversation', label: 'Conversation' },
       { id: 'speech', label: 'Speech' },
@@ -483,7 +505,73 @@ export function createComponents(React) {
     return h(
       'section',
       { className: 'dlv-settings', 'aria-label': 'Live Voice settings' },
-      h('h3', null, 'Live Voice'),
+      h(
+        'div',
+        { className: 'dlv-settings-heading' },
+        h('h3', null, 'Live Voice'),
+        h(
+          'div',
+          { className: 'dlv-version-badges', 'aria-label': 'Version information' },
+          h(
+            'a',
+            {
+              className: 'dlv-shields-badge',
+              href: RELEASES_URL,
+              target: '_blank',
+              rel: 'noreferrer',
+              'aria-label': `DSH Live Voice v${CURRENT_VERSION}. Open releases`,
+              title: `DSH Live Voice v${CURRENT_VERSION}`,
+            },
+            h('img', { src: LIVE_VOICE_BADGE_URL, alt: '' }),
+            h('span', null, `v${CURRENT_VERSION}`),
+          ),
+          h(
+            'a',
+            {
+              className: 'dlv-shields-badge',
+              href: TESTED_DSH_RELEASE_URL,
+              target: '_blank',
+              rel: 'noreferrer',
+              'aria-label': `Compatible with DSH v${TESTED_DSH_VERSION}. Open release`,
+              title: `Compatible with DSH v${TESTED_DSH_VERSION}`,
+            },
+            h('img', { src: DSH_BADGE_URL, alt: '' }),
+            h('span', null, `v${TESTED_DSH_VERSION}`),
+          ),
+        ),
+        h('span', { className: 'dlv-heading-divider', 'aria-hidden': true }),
+        updateAvailable
+          ? h(
+              'a',
+              {
+                className: 'dlv-version-badge dlv-update-badge',
+                href: latestRelease.url,
+                target: '_blank',
+                rel: 'noreferrer',
+                'aria-label': `Update available: ${latestRelease.tag}. Open release`,
+                title: `Update available: ${latestRelease.tag}`,
+              },
+              h('span', { className: 'dlv-update-icon', 'aria-hidden': true }, '↑'),
+              'Update available',
+            )
+          : null,
+        updateAvailable
+          ? h('span', { className: 'dlv-heading-divider', 'aria-hidden': true })
+          : null,
+        h(
+          'a',
+          {
+            className: 'dlv-version-badge dlv-star-badge',
+            href: REPOSITORY_URL,
+            target: '_blank',
+            rel: 'noreferrer',
+            'aria-label': 'Star DSH Live Voice on GitHub',
+            title: 'Star DSH Live Voice on GitHub',
+          },
+          h('span', { className: 'dlv-star-icon', 'aria-hidden': true }, '★'),
+          'Star Us on GitHub',
+        ),
+      ),
       onClose
         ? h(Button, { label: 'Close voice settings', icon: 'close', onClick: onClose })
         : null,
@@ -710,11 +798,32 @@ export function createComponents(React) {
                       : { recognitionEngine: event.target.value },
                   ),
               },
-              h('option', { value: 'qwen-http' }, 'Qwen3 ASR — local MLX server'),
-              h('option', { value: 'browser' }, 'Browser SpeechRecognition'),
-              h('option', { value: 'whisper-http' }, 'Whisper HTTP — DSH host'),
+              h('option', { value: 'browser' }, 'Browser SpeechRecognition — Default option'),
+              h('option', { value: 'qwen-http' }, 'Qwen3 ASR — HTTP API'),
+              h('option', { value: 'whisper-http' }, 'Whisper — HTTP API'),
+              h(
+                'optgroup',
+                { label: 'Coming Soon — vote on repo issues' },
+                h('option', { value: 'webgpu', disabled: true }, 'Browser WebGPU Inference — Soon'),
+                h(
+                  'option',
+                  { value: 'sherpa-onnx', disabled: true },
+                  'sherpa-onnx Streaming — Soon',
+                ),
+                h('option', { value: 'parakeet', disabled: true }, 'NVIDIA Parakeet — Soon'),
+                h('option', { value: 'voxtral', disabled: true }, 'Voxtral Realtime — Soon'),
+              ),
             ),
           ),
+          h(
+            'small',
+            { className: 'dlv-recognition-engine-description' },
+            settings.recognitionEngine === 'qwen-http'
+              ? 'HTTP API at the configured base URL (default: http://127.0.0.1:8080/). Compatible with POST /v1/audio/transcriptions.'
+              : settings.recognitionEngine === 'whisper-http'
+                ? 'HTTP API at the configured DSH host URL (default: http://127.0.0.1:8080/inference). Audio uses the authenticated DSH host transcription route.'
+                : 'Uses the browser SpeechRecognition API. This is the default option.',
+          ),
           field('Input device', 'inputDeviceId', deviceOptions('audioinput', 'Microphone')),
           settings.recognitionEngine === 'browser'
             ? h(

package/src/client/releases.ts

@@ -0,0 +1,117 @@
+declare const __DLV_VERSION__: string;
+declare const __DLV_TESTED_DSH_VERSION__: string;
+
+// Both values are injected from package.json by scripts/build.ts.
+export const CURRENT_VERSION = __DLV_VERSION__;
+export const TESTED_DSH_VERSION = __DLV_TESTED_DSH_VERSION__;
+export const REPOSITORY_URL = 'https://github.com/victorwads/dsh-live-voice';
+export const RELEASES_URL = `${REPOSITORY_URL}/releases`;
+export const LATEST_RELEASE_API_URL =
+  'https://api.github.com/repos/victorwads/dsh-live-voice/releases/latest';
+export const RELEASE_CHECK_STORAGE_KEY = 'dsh-live-voice.latest-release-check';
+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}`;
+
+function versionParts(version) {
+  const normalized = String(version || '')
+    .trim()
+    .replace(/^v/i, '')
+    .split('+', 1)[0];
+  const [core = '', prerelease = ''] = normalized.split('-', 2);
+  const numbers = core.split('.').map((part) => {
+    const match = part.match(/^\d+/);
+    return match ? Number(match[0]) : 0;
+  });
+  while (numbers.length < 3) numbers.push(0);
+  return { numbers, prerelease: prerelease ? prerelease.split('.') : [] };
+}
+
+function compareIdentifier(left, right) {
+  const leftNumber = /^\d+$/.test(left) ? Number(left) : null;
+  const rightNumber = /^\d+$/.test(right) ? Number(right) : null;
+  if (leftNumber !== null && rightNumber !== null) return Math.sign(leftNumber - rightNumber);
+  if (leftNumber !== null) return -1;
+  if (rightNumber !== null) return 1;
+  return left.localeCompare(right);
+}
+
+export function compareVersions(left, right) {
+  const a = versionParts(left);
+  const b = versionParts(right);
+  for (let index = 0; index < Math.max(a.numbers.length, b.numbers.length); index++) {
+    const difference = (a.numbers[index] || 0) - (b.numbers[index] || 0);
+    if (difference) return Math.sign(difference);
+  }
+  if (!a.prerelease.length && !b.prerelease.length) return 0;
+  if (!a.prerelease.length) return 1;
+  if (!b.prerelease.length) return -1;
+  for (let index = 0; index < Math.max(a.prerelease.length, b.prerelease.length); index++) {
+    if (a.prerelease[index] === undefined) return -1;
+    if (b.prerelease[index] === undefined) return 1;
+    const difference = compareIdentifier(a.prerelease[index], b.prerelease[index]);
+    if (difference) return difference;
+  }
+  return 0;
+}
+
+function readCached(storage, now) {
+  try {
+    const cached = JSON.parse(storage?.getItem(RELEASE_CHECK_STORAGE_KEY) || 'null');
+    if (
+      cached &&
+      Number.isFinite(cached.checkedAt) &&
+      now - cached.checkedAt >= 0 &&
+      now - cached.checkedAt < RELEASE_CHECK_INTERVAL_MS
+    )
+      return cached;
+  } catch {}
+  return null;
+}
+
+function writeCached(storage, value) {
+  try {
+    storage?.setItem(RELEASE_CHECK_STORAGE_KEY, JSON.stringify(value));
+  } catch {}
+}
+
+export async function checkLatestRelease({
+  fetchImpl = globalThis.window?.fetch?.bind(globalThis.window),
+  storage = globalThis.window?.localStorage,
+  now = Date.now(),
+} = {}) {
+  const cached = readCached(storage, now);
+  if (cached) return cached;
+
+  // Record the attempt before requesting so a failing public endpoint is not retried on every mount.
+  const attempted = { checkedAt: now, release: null };
+  writeCached(storage, attempted);
+  if (typeof fetchImpl !== 'function') return attempted;
+
+  try {
+    const response = await fetchImpl(LATEST_RELEASE_API_URL, {
+      headers: { Accept: 'application/vnd.github+json' },
+    });
+    if (!response.ok) return attempted;
+    const body = await response.json();
+    if (typeof body?.tag_name !== 'string' || !body.tag_name.trim()) return attempted;
+    const release = {
+      tag: body.tag_name.trim(),
+      url:
+        typeof body.html_url === 'string' && body.html_url.startsWith('https://github.com/')
+          ? body.html_url
+          : RELEASES_URL,
+    };
+    const result = { checkedAt: now, release };
+    writeCached(storage, result);
+    return result;
+  } catch {
+    return attempted;
+  }
+}
+
+export function hasNewerRelease(release, currentVersion = CURRENT_VERSION) {
+  return Boolean(release?.tag && compareVersions(release.tag, currentVersion) > 0);
+}

package/src/client/styles.ts

@@ -29,12 +29,14 @@ export const styles = `
 .dlv-error{color:var(--dsw-alias-state-error-primary);overflow-wrap:anywhere;font-size:13px;max-width:720px;margin:8px auto}
 .dlv-settings{box-sizing:border-box;padding:18px;width:100%;display:grid;gap:16px;max-width:640px;color:var(--dsw-alias-label-primary)}
 .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 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-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-preset-group{grid-template-columns:1fr}.dlv-pill{flex-wrap:wrap}.dlv-wave{flex-basis:90px}.dlv-status{flex-basis:100px}}
+@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}}
 `;
 export default styles;