@1outres/dsh-plugin-notify 0.0.0-stage → 0.3.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 1outres
+
+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,59 @@
-# Temporary Holding Version
+# @1outres/dsh-plugin-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.
+Show a desktop notification when the DeepSeek Harness Web UI is in the
+background and the Session needs you: a tool call is waiting for approval, the
+agent asked a question (or proposed a plan to review), or a turn finished.
+
+Install just this plugin:
+
+```sh
+dsh plugin add @1outres/dsh-plugin-notify
+```
+
+Or install it with every plugin in the repository through the
+[`@1outres/dsh-plugins`](../dsh-plugins) bundle. Enable one or the other: both
+insert the same `notify` row.
+
+## Settings
+
+Open **Settings → Notifications**.
+
+| Field                                     | Default | Meaning                                                                   |
+| ----------------------------------------- | ------- | ------------------------------------------------------------------------- |
+| Enable notifications                      | on      | Master switch.                                                            |
+| Only while this page is in the background | on      | While the window is focused and visible, the prompt is on screen already. |
+| Approval prompts                          | on      | A tool call waits for allow or reject.                                    |
+| Questions and plan reviews                | on      | The agent asked you something, or proposed a plan.                        |
+| Finished turns                            | on      | A turn stopped running while you were looking elsewhere.                  |
+| Include request details                   | on      | Adds the tool name, the approval reason, or the question text.            |
+
+The page also shows the browser permission state, an **Allow notifications**
+button, and **Send test notification**.
+
+## How it works
+
+1. The browser half subscribes to `uiSession.sessionStatus`, the per-Session map
+   the shipped UI already maintains (`running`, `pendingInteraction`,
+   `completionUnread`).
+2. A new pending interaction, or a Session that stops running, becomes a Web
+   Notification: `Approval needed`, `Question waiting`, `Plan review waiting`,
+   or `Turn finished`.
+3. Notifications are tagged per Session and concern, so a repeated request
+   replaces the previous one, and answering the prompt closes it.
+4. Clicking a notification focuses the window and opens that Session through
+   `uiWorkspace.openSession()`.
+
+The plugin never registers into the approval waterfall: it only reads state the
+approval UI already publishes, so it cannot drop, delay, or answer a request.
+Notifications are raised by the browser, which means they appear on the machine
+showing the page, not on the Host.
+
+## Limits
+
+- No notification while the page is closed: the browser cannot raise one.
+- Notification permission is per browser and per origin; each browser asks once.
+- The Host does not forward tool arguments to the browser, so the body can show
+  the tool name and the approval reason but not the full command.
+- Only the highest-precedence pending interaction per Session is visible in the
+  status map, so an approval waiting behind a visible question is notified once
+  the question is answered.

package/cordis.patch.yml

@@ -0,0 +1,6 @@
+# Installs this plugin on its own (dsh plugin add @1outres/dsh-plugin-notify).
+# The @1outres/dsh-plugins bundle inserts the same "notify" row, so select one
+# bundle or the other, never both.
+- insert:
+    - id: notify
+      name: "@1outres/dsh-plugin-notify"

package/lib/client.js

@@ -0,0 +1,635 @@
+/* Generated by scripts/build.mjs — do not edit. */
+window.__ModuleLoader__.load({
+	id: "@1outres/dsh-plugin-notify",
+	factory: (require) => {
+		var module = { exports: {} };
+		var exports = module.exports;
+		"use strict";
+		var __defProp = Object.defineProperty;
+		var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+		var __getOwnPropNames = Object.getOwnPropertyNames;
+		var __hasOwnProp = Object.prototype.hasOwnProperty;
+		var __export = (target, all) => {
+		  for (var name in all)
+		    __defProp(target, name, { get: all[name], enumerable: true });
+		};
+		var __copyProps = (to, from, except, desc) => {
+		  if (from && typeof from === "object" || typeof from === "function") {
+		    for (let key of __getOwnPropNames(from))
+		      if (!__hasOwnProp.call(to, key) && key !== except)
+		        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+		  }
+		  return to;
+		};
+		var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+		// ../dsh-plugin-notify/src/client/index.tsx
+		var index_exports = {};
+		__export(index_exports, {
+		  apply: () => apply,
+		  inject: () => inject
+		});
+		module.exports = __toCommonJS(index_exports);
+
+		// ../dsh-plugin-notify/src/client/config.ts
+		var CONFIG_NAMESPACE = "notify";
+		var DEFAULT_CONFIG = {
+		  enabled: true,
+		  onlyWhenUnfocused: true,
+		  approval: true,
+		  question: true,
+		  completion: true,
+		  showDetail: true
+		};
+		function normalizeConfig(value) {
+		  const read = (field) => {
+		    const current = value?.[field];
+		    return typeof current === "boolean" ? current : DEFAULT_CONFIG[field];
+		  };
+		  return {
+		    enabled: read("enabled"),
+		    onlyWhenUnfocused: read("onlyWhenUnfocused"),
+		    approval: read("approval"),
+		    question: read("question"),
+		    completion: read("completion"),
+		    showDetail: read("showDetail")
+		  };
+		}
+
+		// ../dsh-plugin-notify/src/client/i18n.ts
+		var en = {
+		  nav: "Notifications",
+		  title: "Notifications",
+		  description: "Raise a desktop notification when this page is in the background: a tool call needs approval, the agent asks a question, or a turn finishes. The notification comes from this browser, on the machine that is showing the page.",
+		  enabled: "Enable notifications",
+		  enabledHint: "Turn every notification off without uninstalling the plugin.",
+		  onlyWhenUnfocused: "Only while this page is in the background",
+		  onlyWhenUnfocusedHint: "While the window is focused and visible, the prompt is already on screen.",
+		  approval: "Approval prompts",
+		  approvalHint: "A tool call is waiting for allow or reject.",
+		  question: "Questions and plan reviews",
+		  questionHint: "The agent asked you something, or proposed a plan to review.",
+		  completion: "Finished turns",
+		  completionHint: "A turn stopped running while you were looking elsewhere.",
+		  showDetail: "Include request details",
+		  showDetailHint: "Adds the tool name, the approval reason, or the question text.",
+		  permission: "Browser permission",
+		  permissionGranted: "Allowed",
+		  permissionDenied: "Blocked. Allow notifications for this site in the browser settings.",
+		  permissionDefault: "Not requested yet",
+		  permissionUnsupported: "This browser does not support notifications.",
+		  allow: "Allow notifications",
+		  test: "Send test notification",
+		  testSent: "Test notification sent.",
+		  testBlocked: "The browser has not allowed notifications.",
+		  testTitle: "DeepSeek Harness notifications",
+		  testBody: "Approval and completion alerts will appear like this.",
+		  loading: "Loading configuration\u2026",
+		  unavailable: "This configuration is not available.",
+		  readOnly: "Configuration is read-only.",
+		  writeError: "The Host refused the change."
+		};
+
+		// ../dsh-plugin-notify/src/client/notify.ts
+		var FALLBACK_SESSION = "DeepSeek Harness";
+		var MAX_BODY = 180;
+		var MAX_DETAIL = 140;
+		var TITLES = {
+		  approval: "Approval needed",
+		  question: "Question waiting",
+		  "plan-review": "Plan review waiting",
+		  completion: "Turn finished"
+		};
+		function kindOf(pending) {
+		  switch (pending.kind) {
+		    case "approval":
+		      return "approval";
+		    case "question":
+		      return "question";
+		    case "plan-review":
+		      return "plan-review";
+		    default:
+		      return void 0;
+		  }
+		}
+		function noticeTag(sessionId, kind) {
+		  return `dsh-notify:${kind}:${sessionId}`;
+		}
+		function diffStatus(previous, next, options) {
+		  const opened = [];
+		  const closed = [];
+		  const allowed = (sessionId) => options.notifySession?.(sessionId) ?? true;
+		  const enabled = (kind) => kind === "approval" ? options.approval : kind === "completion" ? options.completion : options.question;
+		  for (const [sessionId, status] of next) {
+		    const before = previous?.get(sessionId);
+		    const pending = status.pendingInteraction;
+		    const previousPending = before?.pendingInteraction;
+		    if (pending !== void 0) {
+		      const kind = kindOf(pending);
+		      const replaced = previousPending !== void 0 && pending.key !== previousPending.key;
+		      if (replaced && previousPending !== void 0) {
+		        const previousKind = kindOf(previousPending);
+		        if (previousKind !== void 0 && previousKind !== kind) {
+		          closed.push(noticeTag(sessionId, previousKind));
+		        }
+		      }
+		      if (kind !== void 0 && pending.key !== previousPending?.key && enabled(kind) && allowed(sessionId)) {
+		        opened.push({ sessionId, kind, key: pending.key, ...detailOf(pending) });
+		      }
+		    } else if (previousPending !== void 0) {
+		      const kind = kindOf(previousPending);
+		      if (kind !== void 0) closed.push(noticeTag(sessionId, kind));
+		    }
+		    if (before === void 0) continue;
+		    const finished = before.running === true && status.running === false;
+		    const becameUnread = before.completionUnread !== true && status.completionUnread === true;
+		    if ((finished || becameUnread) && options.completion && allowed(sessionId)) {
+		      opened.push({ sessionId, kind: "completion", key: `completion:${sessionId}` });
+		    }
+		  }
+		  for (const [sessionId, before] of previous ?? []) {
+		    if (next.has(sessionId)) continue;
+		    const kind = before.pendingInteraction === void 0 ? void 0 : kindOf(before.pendingInteraction);
+		    if (kind !== void 0) closed.push(noticeTag(sessionId, kind));
+		  }
+		  return { opened, closed };
+		}
+		function shouldNotify(config, page) {
+		  if (!config.enabled) return false;
+		  if (config.onlyWhenUnfocused && page.visible && page.focused) return false;
+		  return true;
+		}
+		function formatNotice(event, sessionTitle, options) {
+		  const session = truncate(sessionTitle, MAX_DETAIL) || FALLBACK_SESSION;
+		  const detail = options.showDetail ? describe(event) : void 0;
+		  const body = detail === void 0 ? session : truncate(`${session} \xB7 ${detail}`, MAX_BODY);
+		  return {
+		    tag: noticeTag(event.sessionId, event.kind),
+		    title: TITLES[event.kind],
+		    body,
+		    sessionId: event.sessionId
+		  };
+		}
+		function truncate(value, max) {
+		  const text = value.replace(/\s+/g, " ").trim();
+		  if (text.length <= max) return text;
+		  return `${text.slice(0, Math.max(0, max - 1)).trimEnd()}\u2026`;
+		}
+		function describe(event) {
+		  const reason = event.displayReason?.en ?? event.reason;
+		  switch (event.kind) {
+		    case "approval": {
+		      const parts = [event.toolName, reason].filter(
+		        (part) => typeof part === "string" && part.trim().length > 0
+		      );
+		      return parts.length === 0 ? void 0 : truncate(parts.join(": "), MAX_DETAIL);
+		    }
+		    case "question":
+		      return event.question === void 0 ? void 0 : truncate(event.question, MAX_DETAIL);
+		    case "plan-review":
+		      return reason === void 0 ? void 0 : truncate(reason, MAX_DETAIL);
+		    case "completion":
+		      return void 0;
+		  }
+		}
+		function detailOf(pending) {
+		  return {
+		    toolName: pending.toolName,
+		    reason: pending.reason,
+		    displayReason: pending.displayReason,
+		    question: pending.questions?.[0]?.question
+		  };
+		}
+
+		// ../dsh-plugin-notify/src/client/SettingsPage.tsx
+		var import_react = require("react");
+		var import_jsx_runtime = require("react/jsx-runtime");
+		var PERMISSION_KEYS = {
+		  granted: "permissionGranted",
+		  denied: "permissionDenied",
+		  default: "permissionDefault",
+		  unsupported: "permissionUnsupported"
+		};
+		var sectionStyle = {
+		  maxWidth: 680,
+		  padding: "4px 0 32px",
+		  color: "var(--dsw-alias-label-primary)"
+		};
+		var headingStyle = {
+		  margin: 0,
+		  fontSize: 18,
+		  fontWeight: 600,
+		  lineHeight: 1.4
+		};
+		var introStyle = {
+		  margin: "8px 0 0",
+		  color: "var(--dsw-alias-label-secondary)",
+		  fontSize: 13,
+		  lineHeight: 1.6
+		};
+		var toggleStyle = {
+		  display: "flex",
+		  alignItems: "center",
+		  justifyContent: "space-between",
+		  gap: 16,
+		  marginTop: 20,
+		  fontSize: 13,
+		  fontWeight: 600
+		};
+		var hintStyle = {
+		  margin: 0,
+		  color: "var(--dsw-alias-label-tertiary)",
+		  fontSize: 12,
+		  lineHeight: 1.5,
+		  fontWeight: 400
+		};
+		var errorStyle = {
+		  margin: "8px 0 0",
+		  color: "var(--dsw-alias-state-error-primary)",
+		  fontSize: 12,
+		  lineHeight: 1.5
+		};
+		var groupStyle = {
+		  margin: "26px 0 0",
+		  paddingTop: 18,
+		  borderTop: "1px solid var(--dsw-alias-border-l2)"
+		};
+		var buttonStyle = {
+		  marginTop: 12,
+		  marginRight: 8,
+		  padding: "8px 12px",
+		  borderRadius: 8,
+		  border: "1px solid var(--dsw-alias-border-l2)",
+		  background: "var(--dsw-alias-bg-layer-1)",
+		  color: "inherit",
+		  font: "inherit",
+		  cursor: "pointer"
+		};
+		var mutedStyle = {
+		  color: "var(--dsw-alias-label-tertiary)",
+		  fontSize: 13,
+		  lineHeight: 1.6
+		};
+		function SettingsPage({ form, t, notifier }) {
+		  const subscribe = (0, import_react.useCallback)((listener) => form.subscribe(listener), [form]);
+		  const getSnapshot = (0, import_react.useCallback)(() => form.getSnapshot(), [form]);
+		  const snapshot = (0, import_react.useSyncExternalStore)(subscribe, getSnapshot, getSnapshot);
+		  const config = normalizeConfig(snapshot.value);
+		  const [permission, setPermission] = (0, import_react.useState)(() => notifier.permission());
+		  const [busy, setBusy] = (0, import_react.useState)(false);
+		  const [message, setMessage] = (0, import_react.useState)(void 0);
+		  const [writeError, setWriteError] = (0, import_react.useState)(false);
+		  const write = (field, value) => {
+		    void form.set(field, value).then((accepted) => setWriteError(!accepted)).catch(() => setWriteError(true));
+		  };
+		  const allow = async () => {
+		    setBusy(true);
+		    setMessage(void 0);
+		    try {
+		      setPermission(await notifier.request());
+		    } finally {
+		      setBusy(false);
+		    }
+		  };
+		  const test = async () => {
+		    setBusy(true);
+		    setMessage(void 0);
+		    try {
+		      const shown = await notifier.test();
+		      setPermission(notifier.permission());
+		      setMessage(shown ? t("testSent") : t("testBlocked"));
+		    } finally {
+		      setBusy(false);
+		    }
+		  };
+		  if (snapshot.status === "unavailable") {
+		    return /* @__PURE__ */ (0, import_jsx_runtime.jsx)("p", { style: mutedStyle, children: t("unavailable") });
+		  }
+		  const disabled = snapshot.writable === false || busy;
+		  const unsupported = permission === "unsupported";
+		  const permissionLabel = t(PERMISSION_KEYS[permission] ?? "permissionDefault");
+		  return /* @__PURE__ */ (0, import_jsx_runtime.jsxs)("div", { style: sectionStyle, children: [
+		    /* @__PURE__ */ (0, import_jsx_runtime.jsx)("h2", { style: headingStyle, children: t("title") }),
+		    /* @__PURE__ */ (0, import_jsx_runtime.jsx)("p", { style: introStyle, children: t("description") }),
+		    /* @__PURE__ */ (0, import_jsx_runtime.jsx)(
+		      Toggle,
+		      {
+		        label: t("enabled"),
+		        hint: t("enabledHint"),
+		        checked: config.enabled,
+		        disabled,
+		        onChange: (next) => write("enabled", next)
+		      }
+		    ),
+		    /* @__PURE__ */ (0, import_jsx_runtime.jsx)(
+		      Toggle,
+		      {
+		        label: t("onlyWhenUnfocused"),
+		        hint: t("onlyWhenUnfocusedHint"),
+		        checked: config.onlyWhenUnfocused,
+		        disabled,
+		        onChange: (next) => write("onlyWhenUnfocused", next)
+		      }
+		    ),
+		    /* @__PURE__ */ (0, import_jsx_runtime.jsxs)("div", { style: groupStyle, children: [
+		      /* @__PURE__ */ (0, import_jsx_runtime.jsx)(
+		        Toggle,
+		        {
+		          label: t("approval"),
+		          hint: t("approvalHint"),
+		          checked: config.approval,
+		          disabled,
+		          onChange: (next) => write("approval", next)
+		        }
+		      ),
+		      /* @__PURE__ */ (0, import_jsx_runtime.jsx)(
+		        Toggle,
+		        {
+		          label: t("question"),
+		          hint: t("questionHint"),
+		          checked: config.question,
+		          disabled,
+		          onChange: (next) => write("question", next)
+		        }
+		      ),
+		      /* @__PURE__ */ (0, import_jsx_runtime.jsx)(
+		        Toggle,
+		        {
+		          label: t("completion"),
+		          hint: t("completionHint"),
+		          checked: config.completion,
+		          disabled,
+		          onChange: (next) => write("completion", next)
+		        }
+		      ),
+		      /* @__PURE__ */ (0, import_jsx_runtime.jsx)(
+		        Toggle,
+		        {
+		          label: t("showDetail"),
+		          hint: t("showDetailHint"),
+		          checked: config.showDetail,
+		          disabled,
+		          onChange: (next) => write("showDetail", next)
+		        }
+		      )
+		    ] }),
+		    /* @__PURE__ */ (0, import_jsx_runtime.jsxs)("div", { style: groupStyle, children: [
+		      /* @__PURE__ */ (0, import_jsx_runtime.jsxs)("div", { style: toggleStyle, children: [
+		        /* @__PURE__ */ (0, import_jsx_runtime.jsx)("span", { children: t("permission") }),
+		        /* @__PURE__ */ (0, import_jsx_runtime.jsx)("span", { style: { fontWeight: 400, color: "var(--dsw-alias-label-secondary)" }, children: permissionLabel })
+		      ] }),
+		      permission === "default" ? /* @__PURE__ */ (0, import_jsx_runtime.jsx)(
+		        "button",
+		        {
+		          type: "button",
+		          style: buttonStyle,
+		          disabled,
+		          onClick: () => void allow(),
+		          children: t("allow")
+		        }
+		      ) : null,
+		      /* @__PURE__ */ (0, import_jsx_runtime.jsx)(
+		        "button",
+		        {
+		          type: "button",
+		          style: buttonStyle,
+		          disabled: disabled || unsupported,
+		          onClick: () => void test(),
+		          children: t("test")
+		        }
+		      ),
+		      message === void 0 ? null : /* @__PURE__ */ (0, import_jsx_runtime.jsx)("p", { style: hintStyle, children: message }),
+		      writeError ? /* @__PURE__ */ (0, import_jsx_runtime.jsx)("p", { style: errorStyle, children: t("writeError") }) : null
+		    ] })
+		  ] });
+		}
+		function Toggle({ label, hint, checked, disabled, onChange }) {
+		  return /* @__PURE__ */ (0, import_jsx_runtime.jsxs)("div", { style: toggleStyle, children: [
+		    /* @__PURE__ */ (0, import_jsx_runtime.jsxs)("span", { style: { display: "flex", flexDirection: "column", gap: 4 }, children: [
+		      /* @__PURE__ */ (0, import_jsx_runtime.jsx)("span", { children: label }),
+		      /* @__PURE__ */ (0, import_jsx_runtime.jsx)("span", { style: hintStyle, children: hint })
+		    ] }),
+		    /* @__PURE__ */ (0, import_jsx_runtime.jsx)(
+		      "button",
+		      {
+		        type: "button",
+		        role: "switch",
+		        "aria-checked": checked,
+		        "aria-label": label,
+		        className: "dsh-notify-switch",
+		        disabled,
+		        onClick: (event) => {
+		          event.stopPropagation();
+		          onChange(!checked);
+		        },
+		        children: /* @__PURE__ */ (0, import_jsx_runtime.jsx)("span", { className: "dsh-notify-thumb" })
+		      }
+		    )
+		  ] });
+		}
+
+		// ../dsh-plugin-notify/src/client/styles.ts
+		var NOTIFY_CSS = `
+		.dsh-notify-switch {
+		  box-sizing: border-box;
+		  position: relative;
+		  flex: 0 0 auto;
+		  width: 36px;
+		  height: 20px;
+		  padding: 2px;
+		  border: 0;
+		  border-radius: 999px;
+		  background: var(--dsw-alias-border-l3);
+		  cursor: pointer;
+		}
+
+		.dsh-notify-switch[aria-checked="true"] {
+		  background: var(--dsw-alias-brand-primary);
+		}
+
+		.dsh-notify-switch:disabled {
+		  cursor: default;
+		  opacity: 0.5;
+		}
+
+		.dsh-notify-switch:focus-visible {
+		  outline: var(--dsw-focus-ring-width) solid
+		    var(--dsw-focus-ring-color, var(--dsw-alias-state-business-primary));
+		  outline-offset: 2px;
+		}
+
+		.dsh-notify-thumb {
+		  display: block;
+		  width: 16px;
+		  height: 16px;
+		  border-radius: 50%;
+		  background: var(--dsw-alias-label-primary-foreground);
+		  transition: transform 0.12s ease;
+		}
+
+		.dsh-notify-switch[aria-checked="false"] .dsh-notify-thumb {
+		  background: var(--dsw-alias-switch-thumb);
+		}
+
+		.dsh-notify-switch[aria-checked="true"] .dsh-notify-thumb {
+		  transform: translate(16px);
+		}
+		`;
+
+		// ../dsh-plugin-notify/src/client/index.tsx
+		var import_jsx_runtime2 = require("react/jsx-runtime");
+		var inject = ["sessions", "uiSession", "uiWorkspace", "locale", "configForms", "slots"];
+		var PLUGIN_ID = "@1outres/dsh-plugin-notify";
+		var TEST_TAG = `${PLUGIN_ID}:test`;
+		function apply(ctx) {
+		  const t = ctx.locale.bind(CONFIG_NAMESPACE);
+		  ctx.effect(() => ctx.locale.register(CONFIG_NAMESPACE, { en }), "notify: dictionaries");
+		  ctx.effect(() => {
+		    const tag = document.createElement("style");
+		    tag.dataset.plugin = PLUGIN_ID;
+		    tag.dataset.pluginCss = `${PLUGIN_ID}/notify.css`;
+		    tag.textContent = NOTIFY_CSS;
+		    document.head.append(tag);
+		    return () => {
+		      tag.remove();
+		    };
+		  }, "notify: stylesheet");
+		  const form = ctx.configForms.get(CONFIG_NAMESPACE);
+		  let config = normalizeConfig(form.getSnapshot().value);
+		  ctx.effect(() => {
+		    const read = () => {
+		      config = normalizeConfig(form.getSnapshot().value);
+		    };
+		    const off = form.subscribe(read);
+		    read();
+		    return off;
+		  }, "notify: configuration");
+		  const live = /* @__PURE__ */ new Map();
+		  let autoRequested = false;
+		  const supported = () => typeof Notification !== "undefined";
+		  const permission = () => supported() ? Notification.permission : "unsupported";
+		  const close = (tag) => {
+		    const notification = live.get(tag);
+		    if (notification === void 0) return;
+		    live.delete(tag);
+		    try {
+		      notification.close();
+		    } catch {
+		    }
+		  };
+		  const closeAll = () => {
+		    for (const tag of [...live.keys()]) close(tag);
+		  };
+		  const request = async () => {
+		    if (!supported()) return "unsupported";
+		    if (Notification.permission !== "default") return Notification.permission;
+		    try {
+		      return await Notification.requestPermission();
+		    } catch {
+		      return Notification.permission;
+		    }
+		  };
+		  const show = (spec) => {
+		    if (!supported()) return;
+		    close(spec.tag);
+		    const notification = new Notification(spec.title, { body: spec.body, tag: spec.tag });
+		    live.set(spec.tag, notification);
+		    notification.onclick = () => {
+		      try {
+		        if (spec.sessionId.length > 0) ctx.uiWorkspace.openSession(spec.sessionId);
+		      } catch {
+		      }
+		      try {
+		        window.focus();
+		      } catch {
+		      }
+		      close(spec.tag);
+		    };
+		    notification.onclose = () => {
+		      if (live.get(spec.tag) === notification) live.delete(spec.tag);
+		    };
+		  };
+		  const push = async (spec) => {
+		    if (!supported()) return;
+		    let state = permission();
+		    if (state === "default" && !autoRequested) {
+		      autoRequested = true;
+		      state = await request();
+		    }
+		    if (state !== "granted") return;
+		    show(spec);
+		  };
+		  const pageState = () => ({
+		    visible: typeof document === "undefined" ? true : document.visibilityState !== "hidden",
+		    focused: typeof document === "undefined" ? true : document.hasFocus()
+		  });
+		  const rowOf = (sessionId) => ctx.sessions.list.getSnapshot().byId[sessionId];
+		  const isListed = (sessionId) => {
+		    const row = rowOf(sessionId);
+		    return row !== void 0 && row.origin !== "subagent";
+		  };
+		  const titleOf = (sessionId) => {
+		    const row = rowOf(sessionId);
+		    return row?.title ?? row?.displayTitle ?? "";
+		  };
+		  const status = ctx.uiSession.sessionStatus;
+		  let previous;
+		  const sync = () => {
+		    const next = status.getSnapshot();
+		    const diff = diffStatus(previous, next, {
+		      approval: config.approval,
+		      question: config.question,
+		      completion: config.completion,
+		      notifySession: isListed
+		    });
+		    previous = next;
+		    for (const tag of diff.closed) close(tag);
+		    if (!shouldNotify(config, pageState())) return;
+		    for (const event of diff.opened) {
+		      void push(formatNotice(event, titleOf(event.sessionId), { showDetail: config.showDetail }));
+		    }
+		  };
+		  ctx.effect(() => {
+		    const off = status.subscribe(sync);
+		    sync();
+		    return () => {
+		      off();
+		      closeAll();
+		    };
+		  }, "notify: session status");
+		  const notifier = {
+		    permission,
+		    request,
+		    test: async () => {
+		      const state = await request();
+		      if (state !== "granted") return false;
+		      show({ tag: TEST_TAG, title: t("testTitle"), body: t("testBody"), sessionId: "" });
+		      return true;
+		    }
+		  };
+		  const translate = t;
+		  const Page = () => /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(SettingsPage, { form, t: translate, notifier });
+		  ctx.effect(
+		    () => ctx.configForms.whileServed(
+		      [CONFIG_NAMESPACE],
+		      () => ctx.slots.inject(
+		        "settings.section",
+		        () => ctx.slots.register(
+		          {
+		            name: "settings.section",
+		            id: "notify",
+		            order: 61,
+		            label: () => t("nav"),
+		            locale: CONFIG_NAMESPACE
+		          },
+		          Page
+		        )
+		      )
+		    ),
+		    "notify: settings section"
+		  );
+		}
+
+		return module.exports;
+	}
+});

package/lib/index.js

@@ -0,0 +1,23 @@
+// ../dsh-plugin-notify/src/index.ts
+import z from "@deepseek-ai/schemastery";
+var Config = z.object({
+  enabled: z.boolean().default(true).volatile(),
+  onlyWhenUnfocused: z.boolean().default(true).volatile(),
+  approval: z.boolean().default(true).volatile(),
+  question: z.boolean().default(true).volatile(),
+  completion: z.boolean().default(true).volatile(),
+  showDetail: z.boolean().default(true).volatile()
+});
+function apply(ctx) {
+  ctx.inject(["settings"], (child) => {
+    const settings = child.settings;
+    child.effect(
+      () => settings.configure({ auto: false }, ctx.fiber),
+      "notify: settings page policy"
+    );
+  });
+}
+export {
+  Config,
+  apply
+};

package/package.json

@@ -1,6 +1,60 @@
 {
   "name": "@1outres/dsh-plugin-notify",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.3.0",
+  "description": "Desktop notifications for approval prompts, agent questions, and finished turns in the DeepSeek Harness Web UI.",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/1outres/my-dsh-plugins.git",
+    "directory": "packages/dsh-plugin-notify"
+  },
+  "type": "module",
+  "main": "lib/index.js",
+  "exports": {
+    ".": "./lib/index.js",
+    "./client": "./lib/client.js",
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "lib",
+    "cordis.patch.yml"
+  ],
+  "keywords": [
+    "dsh",
+    "dsh-plugin",
+    "notifications",
+    "desktop-notifications",
+    "deepseek-harness"
+  ],
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "dsh": ">=0.2.1-rc.5 <0.3.0",
+    "node": ">=22"
+  },
+  "dependencies": {
+    "@deepseek-ai/schemastery": "~3.18.5"
+  },
+  "peerDependencies": {
+    "@deepseek-ai/cordis": "~4.0.5",
+    "react": "^18.2.0"
+  },
+  "dsh": {
+    "bundle": {
+      "patch": [
+        "./cordis.patch.yml"
+      ]
+    },
+    "client": {
+      "platform": "web",
+      "inject": [
+        "@deepseek-ai/dsh-client-ui-renderer",
+        "@deepseek-ai/dsh-client-ui-settings",
+        "@deepseek-ai/dsh-client-ui-session",
+        "@deepseek-ai/dsh-client-ui-workspace",
+        "@deepseek-ai/dsh-api-session-controller"
+      ]
+    }
+  }
 }