dsh-done-sound 0.1.2 → 0.1.3

package/lib/client.js

@@ -60,6 +60,8 @@ window.__ModuleLoader__.load({
         interruptHint: '手动停止生成时也播放（默认关闭）',
         error: '出错时也响',
         errorHint: '对话以错误结束时也播放（默认开启）',
+        pending: '等待确认时提醒',
+        pendingHint: 'Agent 需要你确认操作（如审批）而停住等待时播放提醒（默认开启）',
         saved: '已保存：',
         readFailed: '读取文件失败',
         apiFailed: '无法连接插件服务（Host 未加载？），请重启 dsh web',
@@ -69,6 +71,7 @@ window.__ModuleLoader__.load({
         evNormal: '正常完成',
         evInterrupt: '中断',
         evError: '出错',
+        evPending: '等待确认',
         evPlayed: '已播放',
         evNotPlayed: '未播放',
       },
@@ -86,6 +89,8 @@ window.__ModuleLoader__.load({
         interruptHint: 'Also play when generation is stopped (default off)',
         error: 'Play on error',
         errorHint: 'Also play when a turn ends in error (default on)',
+        pending: 'Alert on approval wait',
+        pendingHint: 'Play a reminder when the agent is waiting for your confirmation (default on)',
         saved: 'Saved:',
         readFailed: 'Failed to read file',
         apiFailed: 'Cannot reach the plugin host service (host not loaded?), restart dsh web',
@@ -95,6 +100,7 @@ window.__ModuleLoader__.load({
         evNormal: 'completed',
         evInterrupt: 'interrupted',
         evError: 'error',
+        evPending: 'approval wait',
         evPlayed: 'played',
         evNotPlayed: 'not played',
       },
@@ -130,7 +136,9 @@ window.__ModuleLoader__.load({
         volume: 0.8,
         playOnInterrupt: false,
         playOnError: true,
+        playOnPending: true,
         url: null,
+        defaultUrl: null,
         fileName: '',
         mime: '',
         size: 0,
@@ -159,9 +167,10 @@ window.__ModuleLoader__.load({
       return cfg;
     }
     function playChime(cfg) {
-      if (!cfg.enabled || !cfg.url) return;
+      const url = cfg.url || cfg.defaultUrl;
+      if (!cfg.enabled || !url) return;
       try {
-        const audio = new Audio(cfg.url);
+        const audio = new Audio(url);
         audio.volume = cfg.volume;
         audio.play().catch(() => {});
       } catch {
@@ -203,7 +212,9 @@ window.__ModuleLoader__.load({
           volume: typeof payload.volume === 'number' ? payload.volume : 0.8,
           playOnInterrupt: payload.playOnInterrupt === true,
           playOnError: payload.playOnError !== false,
+          playOnPending: payload.playOnPending !== false,
           url: typeof payload.url === 'string' && payload.url ? payload.url : null,
+          defaultUrl: typeof payload.defaultUrl === 'string' && payload.defaultUrl ? payload.defaultUrl : null,
           fileName: payload.audio && typeof payload.audio.fileName === 'string' ? payload.audio.fileName : '',
           mime: payload.audio && typeof payload.audio.mime === 'string' ? payload.audio.mime : '',
           size: payload.audio && typeof payload.audio.size === 'number' ? payload.audio.size : 0,
@@ -395,6 +406,24 @@ window.__ModuleLoader__.load({
             ),
             react.createElement('span', { className: 'dtc-muted' }, L('errorHint')),
           ),
+          react.createElement(
+            'div',
+            { className: 'dtc-row' },
+            react.createElement(
+              'label',
+              { className: 'dtc-toggle' },
+              react.createElement('input', {
+                type: 'checkbox',
+                checked: cfg.playOnPending,
+                disabled: busy,
+                onChange: (e) => {
+                  run('/dsh-done-sound/api/config', { playOnPending: e.target.checked });
+                },
+              }),
+              react.createElement('span', null, L('pending')),
+            ),
+            react.createElement('span', { className: 'dtc-muted' }, L('pendingHint')),
+          ),
 
           error !== null && react.createElement('div', { className: 'dtc-err' }, error),
           !cfg.loaded && react.createElement('div', { className: 'dtc-muted' }, L('loading')),
@@ -406,7 +435,13 @@ window.__ModuleLoader__.load({
                 '：' +
                 formatEventTime(cfg.lastEvent.at) +
                 ' ' +
-                (cfg.lastEvent.kind === 'interrupt' ? L('evInterrupt') : cfg.lastEvent.kind === 'error' ? L('evError') : L('evNormal')) +
+                (cfg.lastEvent.kind === 'interrupt'
+                  ? L('evInterrupt')
+                  : cfg.lastEvent.kind === 'error'
+                    ? L('evError')
+                    : cfg.lastEvent.kind === 'pending'
+                      ? L('evPending')
+                      : L('evNormal')) +
                 ' → ' +
                 (cfg.lastEvent.play ? L('evPlayed') : L('evNotPlayed')),
             ),
@@ -426,6 +461,7 @@ window.__ModuleLoader__.load({
         const pendingReasonRef = react.useRef(null);
         const lastEndTurnRef = react.useRef(0);
         const lastSessionRef = react.useRef(null);
+        const prevPendingRef = react.useRef(false);
 
         const snap =
           typeof useSession === 'function'
@@ -447,6 +483,8 @@ window.__ModuleLoader__.load({
                   streaming: s.partial !== null || s.running === true,
                   endReason,
                   endTurn,
+                  // agent is waiting for human intervention (approval etc.)
+                  pendingCount: s && Array.isArray(s.pending) ? s.pending.length : 0,
                 };
               })
             : null;
@@ -460,8 +498,22 @@ window.__ModuleLoader__.load({
             lastSessionRef.current = snap.sessionId;
             pendingReasonRef.current = null;
             lastEndTurnRef.current = snap.endTurn;
+            prevPendingRef.current = snap.pendingCount > 0;
+            return;
+          }
+
+          // Agent entered a waiting-for-human state (rising edge only).
+          if (snap.pendingCount > 0 && !prevPendingRef.current) {
+            prevPendingRef.current = true;
+            let played = false;
+            if (cfg.enabled && cfg.playOnPending && (cfg.url || cfg.defaultUrl)) {
+              playChime(cfg);
+              played = true;
+            }
+            setConfig({ lastEvent: { at: Date.now(), kind: 'pending', reason: 'pending', play: played } });
             return;
           }
+          prevPendingRef.current = snap.pendingCount > 0;
 
           // A newly-closed turn is the authoritative "a turn ended" signal.
           if (snap.endTurn > lastEndTurnRef.current) {
@@ -480,24 +532,60 @@ window.__ModuleLoader__.load({
           else if (reason === 'error' || reason === 'max-tokens') kind = 'error';
           else kind = 'normal'; // 'completed' (and unknown future reasons default to playing)
 
-          let played = false;
-          if (kind === 'interrupt') {
-            if (cfg.playOnInterrupt && cfg.url) {
-              playChime(cfg);
-              played = true;
+          // Fire the chime for a given config view; returns whether it played.
+          const effectiveUrlOf = (view) => view.url || view.defaultUrl;
+          const firePlay = (view) => {
+            if (kind === 'interrupt') {
+              if (view.playOnInterrupt && effectiveUrlOf(view)) {
+                playChime(view);
+                return true;
+              }
+              return false;
             }
-          } else if (kind === 'error') {
-            if (cfg.playOnError && cfg.url) {
-              playChime(cfg);
-              played = true;
+            if (kind === 'error') {
+              if (view.playOnError && effectiveUrlOf(view)) {
+                playChime(view);
+                return true;
+              }
+              return false;
             }
-          } else if (cfg.url) {
-            playChime(cfg);
-            played = true;
-          }
+            if (effectiveUrlOf(view)) {
+              playChime(view);
+              return true;
+            }
+            return false;
+          };
 
-          // Visible diagnostic for the settings card (and future debugging).
-          setConfig({ lastEvent: { at: Date.now(), kind, reason, play: played } });
+          let played = firePlay(cfg);
+          const record = (value) =>
+            setConfig({ lastEvent: { at: Date.now(), kind, reason, play: value } });
+          if (!played && !cfg.url && !cfg.defaultUrl) {
+            // Self-heal: the in-memory config may be stale (e.g. the audio was
+            // uploaded after this page mounted, or in another tab). Re-fetch
+            // status once and retry before giving up.
+            api('/dsh-done-sound/api/status')
+              .then((payload) => {
+                if (payload && typeof payload === 'object') {
+                  syncConfig(payload);
+                  const fresh = {
+                    ...cfg,
+                    enabled: payload.enabled === true,
+                    volume: typeof payload.volume === 'number' ? payload.volume : 0.8,
+                    playOnInterrupt: payload.playOnInterrupt === true,
+                    playOnError: payload.playOnError !== false,
+                    playOnPending: payload.playOnPending !== false,
+                    url: typeof payload.url === 'string' && payload.url ? payload.url : null,
+                    defaultUrl: typeof payload.defaultUrl === 'string' && payload.defaultUrl ? payload.defaultUrl : null,
+                  };
+                  record(firePlay(fresh));
+                } else {
+                  record(false);
+                }
+              })
+              .catch(() => record(false));
+          } else {
+            record(played);
+          }
         }, [snap, cfg]);
 
         return null;

package/lib/index.js

@@ -1,7 +1,7 @@
 // dsh-done-sound/src/index.js
 import { fileURLToPath } from "node:url";
 import { mkdir, readFile, writeFile, unlink } from "node:fs/promises";
-import { join } from "node:path";
+import { join, dirname } from "node:path";
 import { randomUUID } from "node:crypto";
 
 // C:/Users/Administrator/.dsh/profiles/web/node_modules/@deepseek-ai/cosmokit/lib/index.js
@@ -796,6 +796,9 @@ defineMethod("transform", [
 var name = "dsh-done-sound";
 var inject = ["settings", "commands", "webServer"];
 var MAX_BYTES = 2 * 1024 * 1024;
+var DEFAULT_AUDIO_PATH = join(dirname(fileURLToPath(import.meta.url)), "..", "assets", "turn-done.wav");
+var DEFAULT_AUDIO_URL = "/dsh-done-sound/audio/default";
+var DEFAULT_AUDIO_MIME = "audio/wav";
 var AUDIO_MIMES = {
   "audio/mpeg": "mp3",
   "audio/mp3": "mp3",
@@ -816,6 +819,7 @@ var TurnChimeSchema = Schema.object({
   volume: Schema.number().min(0).max(1).step(0.01).default(0.8),
   playOnInterrupt: Schema.boolean().default(false),
   playOnError: Schema.boolean().default(true),
+  playOnPending: Schema.boolean().default(true),
   audio: Schema.object({
     fileId: Schema.string().default(""),
     fileName: Schema.string().default(""),
@@ -840,13 +844,15 @@ function apply(ctx) {
       volume: value.volume,
       playOnInterrupt: value.playOnInterrupt,
       playOnError: value.playOnError,
+      playOnPending: value.playOnPending,
       audio: {
         fileId,
         fileName: value.audio?.fileName ?? "",
         mime: value.audio?.mime ?? "",
         size: value.audio?.size ?? 0
       },
-      url: fileId ? `${ROUTE_PREFIX}/audio/${fileId}` : null
+      url: fileId ? `${ROUTE_PREFIX}/audio/${fileId}` : null,
+      defaultUrl: DEFAULT_AUDIO_URL
     };
   };
   const clearAudio = async () => {
@@ -972,6 +978,22 @@ function apply(ctx) {
       pathname = "/";
     }
     const method = (req.method ?? "GET").toUpperCase();
+    if (pathname === DEFAULT_AUDIO_URL) {
+      try {
+        const buffer = await readFile(DEFAULT_AUDIO_PATH);
+        res.writeHead(200, {
+          "Content-Type": DEFAULT_AUDIO_MIME,
+          "Content-Length": buffer.length,
+          "Cache-Control": "no-cache",
+          "X-Content-Type-Options": "nosniff"
+        });
+        res.end(buffer);
+      } catch {
+        res.writeHead(404);
+        res.end("not found");
+      }
+      return;
+    }
     const audioMatch = /^\/dsh-done-sound\/audio\/([A-Za-z0-9-]+)$/.exec(pathname);
     if (audioMatch) {
       const fileId = audioMatch[1];
@@ -1008,6 +1030,7 @@ function apply(ctx) {
         if (typeof body.volume === "number" && body.volume >= 0 && body.volume <= 1) patch.volume = body.volume;
         if (typeof body.playOnInterrupt === "boolean") patch.playOnInterrupt = body.playOnInterrupt;
         if (typeof body.playOnError === "boolean") patch.playOnError = body.playOnError;
+        if (typeof body.playOnPending === "boolean") patch.playOnPending = body.playOnPending;
         if (Object.keys(patch).length > 0) await scope.update(patch);
         sendJson(res, 200, statusPayload());
         return;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-done-sound",
-  "version": "0.1.2",
+  "version": "0.1.3",
   "description": "Play a user-chosen sound whenever a conversation finishes in the DeepSeek Harness web GUI",
   "license": "MIT",
   "type": "module",
@@ -30,6 +30,7 @@
   },
   "files": [
     "lib",
+    "assets",
     "cordis.patch.yml",
     "README.md",
     "LICENSE"
@@ -81,8 +82,12 @@
   "devDependencies": {
     "esbuild": "^0.25.0"
   },
+  "engines": {
+    "node": ">=18"
+  },
   "scripts": {
     "build": "esbuild src/index.js --bundle --format=esm --platform=node --target=node22 --outfile=lib/index.js",
-    "check": "node --check lib/index.js && node --check lib/client.js"
+    "check": "node --check lib/index.js && node --check lib/client.js",
+    "test": "node test/host.test.mjs && node test/classify.test.mjs"
   }
 }