@wjm200509/dsh-client-ui-task-notify 0.0.0-stage → 1.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 JiaMingWang-CN
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,45 @@
-# Temporary Holding Version
+# @wjm200509/dsh-client-ui-task-notify
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+**中文** · 任务完成通知插件：主会话从运行中变为完成、且当前页面不在前台时，发送一条系统通知。不修改 DSH 源码，卸载即恢复。
+
+## 功能
+
+- 只在主会话完成时通知，子 Agent 完成不通知；
+- 五种提示音：系统默认、叮、叮咚、上升、静音；
+- 提示音由 Web Audio 生成，音量跟随系统；
+- 开关与提示音写入 DSH 的持久化设置，重启后保留。
+
+## 安装
+
+```powershell
+dsh plugin --profile web add -w "@wjm200509/dsh-client-ui-task-notify"
+```
+
+安装后重启 DSH。用本地目录时把 `-w` 换成目录的绝对路径。
+
+## 使用
+
+1. 打开 DSH 设置，进入 **任务通知**；
+2. 开启通知并选择提示音；
+3. 浏览器首次请求系统通知权限时选择允许。
+
+页面聚焦时不会通知；只有主会话由运行中转为完成、且页面未聚焦才发送。
+
+## 兼容
+
+适配 DSH **0.2.2-rc.1**；`engines.dsh` 同时保留 `0.1.7-rc.2`、`0.2.0-rc.2`、`0.2.1-alpha.x` 的范围。
+
+## 开发
+
+```powershell
+cd dsh-client-ui-task-notify
+npm test
+```
+
+目录：
+
+```text
+lib/index.js    Host 半边：持久化设置命名空间
+lib/client.js   浏览器半边：设置页、菜单项、通知与提示音
+patch.yml       loader 组合补丁（插入本插件行）
+```

package/lib/client.js

@@ -0,0 +1,217 @@
+window.__ModuleLoader__.load({
+	id: "@wjm200509/dsh-client-ui-task-notify",
+	factory: (require) => {
+		var module = { exports: {} };
+		var exports = module.exports;
+		Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+		let react = require("react");
+		const React = react;
+		//#region lib/client.js
+		/** Toggle-row stylesheet, themed through the shell's alias tokens. */
+		const CSS = '.dsh-notify-page{max-width:720px;display:flex;flex-direction:column;gap:16px;color:var(--dsw-alias-label-primary)}' +
+			'.dsh-notify-row{display:flex;align-items:center;justify-content:space-between;gap:24px}' +
+			'.dsh-notify-title{font-weight:600;font-size:14px}' +
+			'.dsh-notify-desc{margin-top:4px;font-size:12px;color:var(--dsw-alias-label-secondary)}' +
+			'.dsh-notify-switch{position:relative;box-sizing:border-box;width:40px;height:22px;border-radius:11px;padding:0;cursor:pointer;flex:none;background:var(--dsw-alias-bg-layer-2);border:1px solid var(--dsw-alias-border-l2);transition:background .15s,border-color .15s}' +
+			'.dsh-notify-switch.on{background:var(--dsw-alias-brand-primary);border-color:var(--dsw-alias-brand-primary)}' +
+			'.dsh-notify-knob{position:absolute;top:2px;left:2px;width:16px;height:16px;border-radius:50%;background:var(--dsw-alias-bg-overlay,#fff);box-shadow:0 1px 2px rgba(0,0,0,.2);transition:transform .15s}' +
+			'.dsh-notify-switch.on .dsh-notify-knob{transform:translateX(18px)}' +
+			'.dsh-notify-warn{font-size:12px;color:var(--dsw-alias-state-warn-primary)}' +
+			'.dsh-notify-seg{display:flex;gap:8px;flex-wrap:wrap}' +
+			'.dsh-notify-segbtn{box-sizing:border-box;padding:4px 12px;border-radius:14px;font-size:12px;cursor:pointer;background:var(--dsw-alias-bg-layer-2);border:1px solid var(--dsw-alias-border-l2);color:var(--dsw-alias-label-secondary);transition:background .15s,border-color .15s,color .15s}' +
+			'.dsh-notify-segbtn.on{background:var(--dsw-alias-brand-primary);border-color:var(--dsw-alias-brand-primary);color:var(--dsw-alias-bg-overlay,#fff)}';
+		/** Stable Cordis plugin name. */
+		const name = "ui-task-notify";
+		/** The session list store carries running state; slots carry the settings
+		 *  seat, configForms the durable toggle storage, uiWorkspace the
+		 *  notification click-through. */
+		const inject = ["slots", "sessions", "configForms", "uiWorkspace"];
+		/** Main sessions only: subagent children carry origin/parentId on their summary. */
+		function isMainSession(entry) {
+			return entry !== void 0 && entry.origin === void 0 && entry.parentId === void 0;
+		}
+		/** The session the main view currently shows: the list marks it by
+		 *  main-view retention, not by a `current` field. */
+		function shownInView(list) {
+			return Object.values(list.byId).find((row) => (row?.retainedBy?.mainView ?? 0) > 0)?.id;
+		}
+		/** Off the DSH interface: tab hidden, minimized, or another window focused. */
+		function offScreen() {
+			return document.visibilityState !== "visible" || !document.hasFocus();
+		}
+		/**
+		 * Completion-sound presets synthesized with Web Audio: each entry is a
+		 * note table ({ freq Hz, at, dur } in seconds) played at fixed unity
+		 * gain, so the perceived loudness tracks the OS volume with no private
+		 * scaling stage (a volume control here would break that alignment).
+		 */
+		const SOUNDS = {
+			ding: [{ freq: 880, at: 0, dur: 0.35 }],
+			chime: [{ freq: 660, at: 0, dur: 0.25 }, { freq: 880, at: 0.18, dur: 0.35 }],
+			rise: [{ freq: 523.25, at: 0, dur: 0.18 }, { freq: 659.25, at: 0.12, dur: 0.18 }, { freq: 783.99, at: 0.24, dur: 0.4 }],
+		};
+		/** Segmented-control options for the settings row. */
+		const SOUND_OPTIONS = [
+			{ id: "system", label: "\u7CFB\u7EDF\u9ED8\u8BA4" },
+			{ id: "ding", label: "\u53EE" },
+			{ id: "chime", label: "\u53EE\u54DA" },
+			{ id: "rise", label: "\u4E0A\u5347" },
+			{ id: "silent", label: "\u9759\u97F3" },
+		];
+		/** Shared AudioContext; created/resumed on user gestures (selector clicks). */
+		let audioCtx;
+		/** Ensure the context exists and runs; without a gesture it stays suspended. */
+		function ensureAudio() {
+			audioCtx ??= new AudioContext();
+			if (audioCtx.state === "suspended") audioCtx.resume().catch(() => {});
+			return audioCtx;
+		}
+		/** Play one synthesized preset; `system`/`silent` never reach here. */
+		function playSound(id) {
+			const notes = SOUNDS[id];
+			if (notes === void 0) return;
+			const ctx = ensureAudio();
+			const base = ctx.currentTime + 0.02;
+			for (const note of notes) {
+				const osc = ctx.createOscillator();
+				const gain = ctx.createGain();
+				osc.type = "sine";
+				osc.frequency.value = note.freq;
+				gain.gain.setValueAtTime(1, base + note.at);
+				gain.gain.exponentialRampToValueAtTime(0.001, base + note.at + note.dur);
+				osc.connect(gain).connect(ctx.destination);
+				osc.start(base + note.at);
+				osc.stop(base + note.at + note.dur + 0.05);
+			}
+		}
+		/**
+		 * Settings page: the toggle row, the sound-selection row (clicking a
+		 * segment also previews it — the click doubles as the user gesture that
+		 * unlocks Web Audio for later background playback), and a hint when the
+		 * browser denied notification permission. Displayed values follow the
+		 * durable settings form through the bound configuration scope, never the click echo.
+		 */
+		function SettingsPage(props) {
+			const host = props.host;
+			const readEnabled = () => host.getSnapshot().value?.enabled === true;
+			const readSound = () => host.getSnapshot().value?.sound ?? "system";
+			const [on, setOn] = React.useState(readEnabled);
+			const [sound, setSound] = React.useState(readSound);
+			const [denied, setDenied] = React.useState(typeof Notification !== "undefined" && Notification.permission === "denied");
+			React.useEffect(() => host.subscribe(() => {
+				setOn(readEnabled());
+				setSound(readSound());
+			}), [host]);
+			const toggle = () => {
+				const next = !on;
+				if (next && typeof Notification !== "undefined" && Notification.permission === "default") {
+					Notification.requestPermission().then((p) => setDenied(p === "denied")).catch(() => setDenied(true));
+				}
+				host.set("enabled", next);
+				setOn(next);
+			};
+			const selectSound = (id) => {
+				ensureAudio();
+				host.set("sound", id);
+				setSound(id);
+				if (id !== "system" && id !== "silent") playSound(id);
+			};
+			return React.createElement("div", { className: "dsh-notify-page" },
+				React.createElement("div", { className: "dsh-notify-row" },
+					React.createElement("div", null,
+						React.createElement("div", { className: "dsh-notify-title" }, "\u4F1A\u8BDD\u5B8C\u6210\u901A\u77E5"),
+						React.createElement("div", { className: "dsh-notify-desc" }, "\u4E3B\u4F1A\u8BDD\u5B8C\u6210\u4EFB\u52A1\u4E14\u672A\u9009\u4E2D\u8BE5\u4F1A\u8BDD\u6216\u4E0D\u5728\u672C\u754C\u9762\u65F6\uFF0C\u53D1\u9001\u7CFB\u7EDF\u901A\u77E5\uFF1B\u5B50 Agent \u5B8C\u6210\u4E0D\u901A\u77E5\u3002"),
+					),
+					React.createElement("button", {
+						type: "button",
+						className: "dsh-notify-switch" + (on ? " on" : ""),
+						role: "switch",
+						"aria-checked": on ? "true" : "false",
+						"aria-label": "\u4F1A\u8BDD\u5B8C\u6210\u901A\u77E5",
+						onClick: toggle,
+					}, React.createElement("span", { className: "dsh-notify-knob" })),
+				),
+				React.createElement("div", { className: "dsh-notify-row" },
+					React.createElement("div", null,
+						React.createElement("div", { className: "dsh-notify-title" }, "\u63D0\u793A\u97F3"),
+						React.createElement("div", { className: "dsh-notify-desc" }, "\u5B8C\u6210\u901A\u77E5\u7684\u63D0\u793A\u97F3\uFF1B\u70B9\u9009\u5373\u8BD5\u542C\uFF0C\u54CD\u5EA6\u8DDF\u968F\u7CFB\u7EDF\u97F3\u91CF\u3002"),
+					),
+					React.createElement("div", { className: "dsh-notify-seg" },
+						SOUND_OPTIONS.map((option) => React.createElement("button", {
+							key: option.id,
+							type: "button",
+							className: "dsh-notify-segbtn" + (sound === option.id ? " on" : ""),
+							"aria-pressed": sound === option.id ? "true" : "false",
+							onClick: () => selectSound(option.id),
+						}, option.label)),
+					),
+				),
+				on && denied ? React.createElement("div", { className: "dsh-notify-warn" }, "\u7CFB\u7EDF\u901A\u77E5\u6743\u9650\u5DF2\u88AB\u62D2\u7EDD\uFF0C\u8BF7\u5728\u6D4F\u89C8\u5668\u7AD9\u70B9\u8BBE\u7F6E\u4E2D\u5141\u8BB8\u901A\u77E5\u540E\u91CD\u8BD5\u3002") : null,
+			);
+		}
+		/**
+		 * Client plugin body: the completion watcher over the session list store and
+		 * the settings.section toggle page.
+		 * @param ctx - client root context.
+		 */
+		function apply(ctx) {
+			const host = ctx.configForms.get(name);
+			/** Seed from the durable section (undefined while the read is in flight → off). */
+			const enabled = { value: host.getSnapshot().value?.enabled === true };
+			/** Last-observed running bit per session; the true→false edge arms a notification. */
+			const prevRunning = new Map();
+			ctx.effect(() => {
+				const tag = document.createElement("style");
+				tag.textContent = CSS;
+				document.head.append(tag);
+				return () => tag.remove();
+			}, "ui-task-notify: styles");
+			ctx.effect(() => host.subscribe(() => {
+				const section = host.getSnapshot().value;
+				if (section !== void 0) enabled.value = section.enabled === true;
+			}), "ui-task-notify: settings adoption");
+			ctx.effect(() => {
+				const sessions = ctx.sessions;
+				const snap = sessions.list.getSnapshot();
+				for (const id of snap.ids) prevRunning.set(id, snap.byId[id]?.running === true);
+				return sessions.list.subscribe(() => {
+					const list = sessions.list.getSnapshot();
+					for (const id of list.ids) {
+						const entry = list.byId[id];
+						const now = entry?.running === true;
+						const was = prevRunning.get(id);
+						prevRunning.set(id, now);
+						if (was !== true || now !== false) continue;
+						if (!isMainSession(entry)) continue;
+						if (!enabled.value) continue;
+						if (typeof Notification === "undefined" || Notification.permission !== "granted") continue;
+						if (shownInView(list) === id && !offScreen()) continue;
+						const sound = host.getSnapshot().value?.sound ?? "system";
+						const notification = new Notification("\u4EFB\u52A1\u5B8C\u6210", {
+							body: (entry.displayTitle || id) + " \u5DF2\u5B8C\u6210\u5F53\u524D\u4EFB\u52A1",
+							tag: "dsh-task-notify-" + id,
+							/* Custom or muted: drop the OS sound so it never doubles the synth (or noise). */
+							silent: sound !== "system",
+						});
+						if (sound !== "system" && sound !== "silent") playSound(sound);
+						notification.onclick = () => {
+							try { ctx.uiWorkspace.openSession(id); } catch (error) { console.error("ui-task-notify: open session failed", error); }
+							window.focus();
+						};
+					}
+					const live = new Set(list.ids);
+					for (const id of prevRunning.keys()) if (!live.has(id)) prevRunning.delete(id);
+				});
+			}, "ui-task-notify: completion watcher");
+			ctx.slots.inject("settings.section", () => ctx.slots.register(
+				{ name: "settings.section", id: "session-notify", order: 25, label: "\u4EFB\u52A1\u901A\u77E5" },
+				() => React.createElement(SettingsPage, { host }),
+			));
+		}
+		//#endregion
+		exports.apply = apply;
+		exports.inject = inject;
+		exports.name = name;
+		return module.exports;
+	}
+});

package/lib/index.js

@@ -0,0 +1,43 @@
+/**
+ * dsh-client-ui-task-notify — host half.
+ *
+ * The notification feature lives in the browser half (`lib/client.js`);
+ * this half owns the durable settings schema: the `Config` export is the
+ * `ui-task-notify` profile entry's form, which dsh projects into the shared
+ * settings document. The client toggle reads and writes it through
+ * `ctx.configForms.get(...)`, so the switch state persists with the DSH
+ * configuration instead of browser-local storage.
+ */
+import z from "@deepseek-ai/schemastery";
+
+const name = "ui-task-notify";
+
+/** Field carrying the persisted toggle state. */
+const NOTIFY_ENABLED_FIELD = "enabled";
+/** Field carrying the persisted completion-sound selection. */
+const NOTIFY_SOUND_FIELD = "sound";
+/** Accepted completion-sound ids; `system` defers to the OS notification sound. */
+const NOTIFY_SOUNDS = ["system", "ding", "chime", "rise", "silent"];
+/**
+ * Durable toggle schema; the default keeps the feature off until the user opts
+ * in. Every field is volatile: the settings form only edits volatile fields,
+ * and a volatile-only write lands in the running plugin without a remount.
+ */
+const Config = z.object({
+	[NOTIFY_ENABLED_FIELD]: z.boolean().default(false).volatile(),
+	[NOTIFY_SOUND_FIELD]: z.union([...NOTIFY_SOUNDS]).default("system").volatile()
+});
+
+/**
+ * The host half owns no behavior beyond its settings schema: the automatic
+ * config page is suppressed because the feature renders its own
+ * `settings.section` page from the browser half.
+ * @param ctx - Host plugin context.
+ */
+function apply(ctx) {
+	ctx.inject(["settings"], (child) => {
+		child.effect(() => child.settings.configure({ auto: false }, ctx.fiber));
+	});
+}
+
+export { apply, name, Config };

package/package.json

@@ -1,6 +1,50 @@
 {
   "name": "@wjm200509/dsh-client-ui-task-notify",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "1.0.1",
+  "description": "Session completion system notifications with selectable completion sound; toggle and sound persist in DSH settings",
+  "type": "module",
+  "author": "JiaMingWang-CN",
+  "license": "MIT",
+  "homepage": "https://github.com/JiaMingWang-CN/dsh-bundles#readme",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/JiaMingWang-CN/dsh-bundles",
+    "directory": "dsh-client-ui-task-notify"
+  },
+  "keywords": [
+    "dsh",
+    "dsh-plugin",
+    "deepseek-harness",
+    "notification",
+    "web"
+  ],
+  "files": [
+    "lib",
+    "patch.yml",
+    "README.md"
+  ],
+  "scripts": {
+    "test": "node --test"
+  },
+  "engines": {
+    "dsh": "^0.1.7-rc.2 || ^0.2.0-rc.2 || ^0.2.1-alpha.2 || ^0.2.2-rc.1"
+  },
+  "dependencies": {
+    "@deepseek-ai/schemastery": "^3.18.4"
+  },
+  "exports": {
+    ".": "./lib/index.js",
+    "./client": "./lib/client.js"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dsh": {
+    "client": {
+      "platform": "web"
+    },
+    "bundle": {
+      "patch": "./patch.yml"
+    }
+  }
+}

package/patch.yml

@@ -0,0 +1,4 @@
+# Session completion system notification plugin (client half + durable settings namespace).
+- insert:
+    - id: ui-task-notify
+      name: "@wjm200509/dsh-client-ui-task-notify"