dsh-notify-desktop 0.0.0-stage → 0.1.0

package/CHANGELOG.md

@@ -0,0 +1,46 @@
+# Changelog
+
+All notable changes to this plugin are recorded here.
+The format follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
+and the project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [Unreleased]
+
+### Added
+
+- npm distribution: `dsh-notify-desktop` is published on npm and can be installed without cloning —
+  `dsh.cmd plugin --profile desktop add dsh-notify-desktop`. Local `link:` installs remain supported
+  for development.
+
+### Verified
+
+- Compatibility with DSH desktop **0.2.1-rc.1** verified end to end on 2026-10-17: version gate, plugin
+  loading, session-projection delivery, host toast / sound / silence channels, and an unfocused
+  end-to-end notification all passed. See `docs/acceptance/2026-10-17-dsh-0.2.1-rc.1-compat.md`.
+
+## [0.1.0] - 2026-10-10
+
+First release, verified end to end on DSH desktop 0.2.0-rc.2 (see
+`docs/acceptance/2026-10-10-desktop-e2e.md`).
+
+### Added
+
+- Windows toast notifications for five turn-end reasons (completed, error,
+  aborted, blocked, max-tokens), for approval requests, for questions
+  (including `run_code` PTC questions) and for plan reviews.
+- Edge-triggered notifications with a 3-second de-duplication key, suppressed
+  while the DSH window is focused.
+- Click raises the DSH window through the app's own `dsh://open` protocol
+  handler; it deliberately does not jump to the session.
+- One reminder for a blocking interaction that stays unanswered (10 minutes by
+  default, configurable).
+- Per-situation sounds in four groups (finished / error / waiting-on-you /
+  reminder), picked from a library with three sections: the twenty Windows
+  sounds, the four author sounds shipped in `sounds/`, and the user's own
+  imports (`.wav` / `.mp3` / `.m4a` / `.aac` / `.wma` / `.flac` /
+  `.ogg` / `.opus`, copied into a folder and transcoded once with ffmpeg).
+- File sounds are capped at eight seconds, and stop immediately when the sound
+  switch is turned off or the DSH window regains focus.
+- A settings section (settings → 通知 / Notifications) with every switch, the
+  sound pickers with preview, the custom file entry and a transcode-cache
+  readout with a clear button.

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 paleech0
+
+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,168 @@
-# Temporary Holding Version
+# dsh-notify-desktop
 
-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.
+[![npm](https://img.shields.io/npm/v/dsh-notify-desktop.svg)](https://www.npmjs.com/package/dsh-notify-desktop) · [中文文档](README.zh.md) · English
+
+Windows toast notifications for the DSH desktop app. A session finishes, fails, or stops to ask you
+something — you get a native notification with a sound chosen for that situation, and clicking it brings
+the DSH window back to the front.
+
+<img src="https://raw.githubusercontent.com/paleech0/dsh-notify-desktop/main/docs/images/settings.png" width="460" alt="Notification settings">
+
+## What you get
+
+- **Told when it matters** — turn ends (completed, error, aborted, blocked, max-tokens), approval
+  requests, questions, plan reviews, and one nudge for a wait that drags on.
+- **Quiet when you are there** — nothing pops while the DSH window has focus, and each event notifies
+  once (three-second de-duplication).
+- **A sound per situation** — four groups (finished, error, waiting on you, still waiting), each picked
+  from the Windows sounds, the author sounds shipped in [`sounds/`](sounds/), or your own files.
+- **Your own sounds** — *Add sound…* copies the file you pick into the plugin's folder, so several can
+  coexist and each can be removed later.
+- **Never a long ring** — a file sound stops after eight seconds, and stops at once when you mute
+  notifications or come back to the window.
+- **Click to come back** — the toast raises the DSH window; it deliberately does not jump to the session.
+
+Requirements: Windows and the DSH desktop app (profile `desktop`), runtime 0.2.x. `ffmpeg` on `PATH` is
+optional and only used to transcode custom sounds that are not `.wav`.
+
+## Install
+
+### From npm
+
+```powershell
+& "<DSH desktop install>\resources\runtime\cli\bin\dsh.cmd" plugin --profile desktop add dsh-notify-desktop
+```
+
+Then restart the DSH desktop app and open **Settings → Notifications** (`Ctrl+,` while focused).
+
+### From a local checkout
+
+1. Clone this repository somewhere permanent — the profile links to that folder.
+2. Register it with the desktop app's own CLI:
+
+   ```powershell
+   & "<DSH desktop install>\resources\runtime\cli\bin\dsh.cmd" plugin --profile desktop add "link:<path-to-this-repo>"
+   ```
+
+3. Restart the DSH desktop app, then open **Settings → Notifications** (`Ctrl+,` while focused).
+
+## Settings
+
+Every switch lives in one section of the settings page. Preferences are stored in the renderer's
+`localStorage` and apply immediately.
+
+| Control | What it does |
+|---|---|
+| Enable notifications | Master switch; nothing else fires while it is off |
+| Sound | Mutes every situation group at once |
+| Sounds | One picker per group, each with a preview button |
+| Custom sounds | Add, list and remove your own files |
+| Transcode cache | Shows what transcoded wavs occupy, and clears them |
+| When to notify | One switch per turn-end reason |
+| Waiting on you | One switch per interaction kind |
+| Reminder | Minutes before the single nudge, plus a test button |
+
+## Sounds
+
+**Three sections.** Every picker opens a two-level list: the source first, that source's sounds second.
+
+- *Windows sounds* — twenty built-in choices: the five toast events plus the media library
+  (`chimes`, `ding`, `tada`, `Windows Error`, `Critical Stop`, `Alarm0x`, `Ring0x`, …).
+- *Author sounds* — the four `.wav` files in [`sounds/`](sounds/). Drop another file in that folder and
+  it appears; no code change is involved.
+- *Custom sounds* — your own imports.
+
+**Your own files.** *Add sound…* copies the file into `%LOCALAPPDATA%\dsh-notify\custom`, so the
+original can move or be deleted afterwards. Accepted formats are `.wav`, `.mp3`, `.m4a`, `.aac`,
+`.wma`, `.flac`, `.ogg` and `.opus`.
+
+**When a sound stops.** A `.wav` plays directly. Anything else is transcoded once with the `ffmpeg` on
+your `PATH` and lands in the transcode cache below the list, which reports its size and can clear it. File
+sounds are capped at eight seconds, and a sound already playing stops immediately when you switch sound
+off or when the DSH window regains focus. Without ffmpeg, wav files and the two shipped libraries still
+work; the diagnostics route reports `media.ffmpeg: null`.
+
+**Why custom sounds exist.** A toast can only reference five `ms-winsoundevent` values, and on Windows 11
+those resolve to four very similar chimes — `Notification.IM` and `Notification.SMS` are literally the
+same file. Playing the audio from the host is the only way to get sounds that are actually distinguishable.
+
+## Compatibility
+
+| | |
+|---|---|
+| Verified on | DSH desktop **0.2.1-rc.1** (2026-10-17): version gate, plugin loading, projection delivery, host toast / sound / silence channels and an unfocused end-to-end notification all pass ([evidence](docs/acceptance/2026-10-17-dsh-0.2.1-rc.1-compat.md)); 0.2.0-rc.2 remains the original end-to-end run ([evidence](docs/acceptance/2026-10-10-desktop-e2e.md)) |
+| Declared range | `>=0.2.0-rc.2 <0.3.0-0` — the whole 0.2 line, prereleases included; the loader checks it with `includePrerelease`, so 0.2.1-rc.1 passes |
+| Platform | Windows desktop profile only; the web profile has no toast channel and is untested |
+| 0.2.1 seam check | The 0.2.1-rc.1 runtime image ships no `.d.ts`; every seam used here was checked against its compiled JS and still matches |
+
+The profile loader reads the `peerDependencies` entries named `@deepseek-ai/dsh` or `@deepseek-ai/dsh-*`
+and checks them with `semver.satisfies(runtime, range, { includePrerelease: true })`. A mismatch makes it
+skip the plugin rather than load it. On another runtime, grant an exemption:
+
+```powershell
+dsh.cmd plugin --profile desktop allow-version dsh-notify-desktop@0.1.0 --dsh-version <your-version> --accept-risk
+```
+
+## How it works
+
+Two halves, and no harness code is modified.
+
+- The **host half** registers one session projection (`notify`) and a few same-origin routes.
+- The **client half** reads that projection from the session list, decides whether a notification is
+  warranted, and sends it: a host PowerShell toast while the window is unfocused, the renderer's own
+  notification as the fallback.
+
+Questions arrive from two places on purpose, and neither can be dropped. Questions asked as tool calls
+reach the projection; service-level asks such as the plan review never enter the session log, so the host
+observes the `user-questions/request` waterfall with `{ global: true }` and hands them to the client over
+a bounded queue. A cross-source key keeps the two copies from double-toasting.
+
+| Route | Purpose |
+|---|---|
+| `GET /dsh-notify/debug` | Projection state, recent client reports, ffmpeg and player status |
+| `POST /dsh-notify/toast` | Raise one toast (title, body, sound id) |
+| `POST /dsh-notify/focus` | Raise the window through `dsh://open` |
+| `POST /dsh-notify/silence` | Stop the sound that is playing |
+| `GET/POST /dsh-notify/sound-library` | List the two library folders |
+| `POST /dsh-notify/import-sound`, `/delete-sound` | Add or remove a custom sound |
+| `GET/POST /dsh-notify/sound-cache` | Report or clear the transcode cache |
+| `POST /dsh-notify/pick-file`, `GET /dsh-notify/foreground` | Windows file picker; OS-level focus answer |
+| `GET /dsh-notify/questions` | Poll the host-side question queue |
+
+## Troubleshooting
+
+Windows toasts never reach the Action Center, so the diagnostics route is the only evidence channel:
+
+```powershell
+Invoke-WebRequest http://127.0.0.1:19387/dsh-notify/debug
+```
+
+It returns the projection registration state, the last 40 client reports (every decision, channel choice
+and platform result), and the sound plumbing (`media.ffmpeg`, `media.soundPlayers`).
+
+## Development
+
+```powershell
+pnpm install
+pnpm run check      # typecheck + vitest + build
+```
+
+`lib/` is committed on purpose: the profile links to this folder, so the built bundles ship with the
+source. [AGENTS.md](AGENTS.md) holds the repository rules and the measured constraints that must not be
+"optimised" away — the host bundle stays self-contained, the toast spawn keeps piped stdio, and audio goes
+through `System.Media.SoundPlayer` only.
+
+## Known limits
+
+- No tray badge, taskbar badge or window flashing; those need main-process APIs a plugin cannot reach.
+- Clicking a toast raises the window, it does not navigate to the session.
+- The `error` and `max-tokens` turn ends are covered by unit tests only; they were never reproduced live.
+- A toast cannot be observed being dismissed, so file sounds are capped rather than tied to the toast.
+- Windows desktop profile only.
+
+## License
+
+[MIT](LICENSE) · third-party notices in [THIRD-PARTY-NOTICES.md](THIRD-PARTY-NOTICES.md).
+
+Unofficial plugin: not affiliated with, endorsed by, or sponsored by DeepSeek. "DeepSeek", "DSH" and
+"DeepSeek Harness" are used descriptively, to say what this plugin plugs into.

package/README.zh.md

@@ -0,0 +1,153 @@
+# dsh-notify-desktop
+
+[![npm](https://img.shields.io/npm/v/dsh-notify-desktop.svg)](https://www.npmjs.com/package/dsh-notify-desktop) · [English](README.md) · 中文
+
+给 **DSH 桌面端** 加 Windows 原生通知：会话跑完、出错、或停下来等你确认时弹一条系统通知，并播放**为这种情况挑好的音效**；
+点通知把 DSH 窗口拉回前台。
+
+<img src="https://raw.githubusercontent.com/paleech0/dsh-notify-desktop/main/docs/images/settings.png" width="460" alt="通知设置">
+
+## 它能给你什么
+
+- **该提醒时提醒** —— 回合结束（正常完成 / 出错 / 被中止 / 被阻塞 / Token 上限）、等待审批、等待回答、计划评审，
+  以及等待过久时的一条催办。
+- **你在看就不吵** —— DSH 窗口有焦点时一律不弹；同一件事只弹一次（3 秒去重）。
+- **每种情况一个声音** —— 四组（正常结束 / 出错 / 需要你处理 / 超时催办），可选的来源有三类：Windows 音效、
+  随插件发布的作者音效（[`sounds/`](sounds/)）、以及你自己导入的文件。
+- **可以用自己的音效** —— 点「添加音效…」会把选中的文件**复制**进插件目录，可以同时放多个，之后也能逐个删除。
+- **不会一直响** —— 文件类音效最长 8 秒；关掉提示音、或切回 DSH 窗口，正在响的会**立刻停**。
+- **点击回前台** —— 通知只把窗口拉回前台，**刻意不跳转会话**（更可预测）。
+
+**环境要求**：Windows + DSH 桌面端（profile `desktop`），运行时 0.2.x。`ffmpeg` 可选（仅用于把非 `.wav` 的自定义音效转码），
+放在 `PATH` 里即可。
+
+## 安装
+
+### 从 npm 安装
+
+```powershell
+& "<DSH 桌面端安装目录>\resources\runtime\cli\bin\dsh.cmd" plugin --profile desktop add dsh-notify-desktop
+```
+
+然后重启 DSH 桌面端，打开 **设置 → 通知**（窗口有焦点时按 `Ctrl+,`）。
+
+### 从本地仓库安装
+
+1. 把本仓库 clone 到一个**固定目录**（profile 以链接方式指向它，之后别挪动）。
+2. 用桌面端自带 CLI 注册：
+
+   ```powershell
+   & "<DSH 桌面端安装目录>\resources\runtime\cli\bin\dsh.cmd" plugin --profile desktop add "link:<本仓库路径>"
+   ```
+
+3. 重启 DSH 桌面端，然后打开 **设置 → 通知**（窗口有焦点时按 `Ctrl+,`）。
+
+## 设置项
+
+所有开关都在设置页的同一个「通知」段里。偏好存在渲染层 `localStorage`，改完立即生效。
+
+| 控件 | 作用 |
+|---|---|
+| 启用通知 | 总开关；关掉后一律不弹 |
+| 提示音 | 一次性静音所有音效组 |
+| 音效 | 四类情况各一个选择器，带「试听」 |
+| 自定义音效 | 添加 / 列出 / 删除你自己的文件 |
+| 转换缓存 | 显示转码 wav 的占用，并可一键清理 |
+| 结束提醒 | 每种回合结束原因一个开关 |
+| 等待确认 | 每种阻塞交互一个开关 |
+| 催办 | 多少分钟后补一条；另有测试按钮 |
+
+## 音效
+
+**三个分区。** 每个选择器都是两级：先选**来源**，再选该来源下的具体音效。
+
+- *Windows 音效* —— 内置 20 个：5 个通知事件 + 系统媒体库（`chimes`、`ding`、`tada`、`Windows Error`、
+  `Critical Stop`、`Alarm0x`、`Ring0x` 等）。
+- *作者音效* —— 本仓库 [`sounds/`](sounds/) 里的 4 个 `.wav`。**往那个文件夹再丢文件就等于加音效**，不用改代码。
+- *自定义音效* —— 你自己导入的。
+
+**用自己的文件。** 点「添加音效…」会把文件**复制**到 `%LOCALAPPDATA%\dsh-notify\custom`，所以原文件之后移动或删除都不影响。
+支持 `.wav`、`.mp3`、`.m4a`、`.aac`、`.wma`、`.flac`、`.ogg`、`.opus`。
+
+**声音什么时候停。** `.wav` 直接播放；其他格式首次播放时用 `PATH` 上的 `ffmpeg` 转码一次，占用计入列表下面的
+**「转换缓存」**（在那里查看与清理）。文件类音效最长 8 秒；关掉提示音或窗口重获焦点时，正在响的**立刻停**。
+没有 ffmpeg 时，wav 与随插件发布的音效照常可用，诊断接口会显示 `media.ffmpeg: null`。
+
+**为什么需要自定义音效。** Toast 只能引用 5 个 `ms-winsoundevent` 值，而在 Windows 11 上它们只对应 4 个**彼此很像**的
+「叮」—— `Notification.IM` 与 `Notification.SMS` 甚至是同一个文件。想让四类情况真的听得出差别，只能由宿主自己播放音频。
+
+## 兼容性
+
+| | |
+|---|---|
+| 实测版本 | DSH 桌面端 **0.2.1-rc.1**（2026-10-17）：版本闸门、插件加载、投影送达、宿主 Toast/音效/静音通道以及一次失焦端到端通知全部通过（[证据](docs/acceptance/2026-10-17-dsh-0.2.1-rc.1-compat.md)）；0.2.0-rc.2 仍是最早的端到端验收（[证据](docs/acceptance/2026-10-10-desktop-e2e.md)）|
+| 声明范围 | `>=0.2.0-rc.2 <0.3.0-0` —— 即整条 0.2 线，含预发布版；加载器按 `includePrerelease` 判定，0.2.1-rc.1 在范围内 |
+| 平台 | 仅 Windows 桌面端 profile；web profile 没有 Toast 通道，未验证 |
+| 0.2.1 seam 核对 | 0.2.1-rc.1 运行时镜像不带 `.d.ts`；本插件用到的全部 seam 均按其编译 JS 复核通过 |
+
+profile 加载器只看 `peerDependencies` 里名为 `@deepseek-ai/dsh` 或 `@deepseek-ai/dsh-*` 的条目，
+用 `semver.satisfies(runtime, range, { includePrerelease: true })` 判定；**不匹配会直接跳过该插件**（不加载）。
+运行时不在范围内时，可以显式豁免：
+
+```powershell
+dsh.cmd plugin --profile desktop allow-version dsh-notify-desktop@0.1.0 --dsh-version <你的版本> --accept-risk
+```
+
+## 工作原理
+
+两半组成，**不改任何 harness 代码**。
+
+- **宿主半侧**：注册一个会话投影（`notify`）和若干同源路由。
+- **客户端半侧**：从会话列表读那个投影，判断该不该通知，然后发出去 —— 窗口失焦时走宿主 PowerShell Toast，
+  路由不可达时退回渲染层通知。
+
+提问**故意有两个来源，都不能删**：工具调用式提问能进投影；而服务级提问（计划评审）根本不进会话日志，
+所以宿主用 `{ global: true }` 监听 `user-questions/request` 瀑布，经有界队列交给客户端。跨源去重键保证不会重复弹两条。
+
+| 路由 | 用途 |
+|---|---|
+| `GET /dsh-notify/debug` | 投影状态 + 客户端最近上报 + ffmpeg/播放器状态 |
+| `POST /dsh-notify/toast` | 弹一条通知（标题、正文、音效 id）|
+| `POST /dsh-notify/focus` | 通过 `dsh://open` 把窗口拉回前台 |
+| `POST /dsh-notify/silence` | 停掉正在播放的声音 |
+| `GET/POST /dsh-notify/sound-library` | 列出两个音效目录 |
+| `POST /dsh-notify/import-sound`、`/delete-sound` | 添加 / 删除自定义音效 |
+| `GET/POST /dsh-notify/sound-cache` | 查询 / 清理转码缓存 |
+| `POST /dsh-notify/pick-file`、`GET /dsh-notify/foreground` | Windows 选文件框；OS 级焦点判定 |
+| `GET /dsh-notify/questions` | 轮询宿主侧提问队列 |
+
+## 排查
+
+Windows 通知**不进操作中心**，所以诊断接口是唯一的证据通道：
+
+```powershell
+Invoke-WebRequest http://127.0.0.1:19387/dsh-notify/debug
+```
+
+返回投影注册状态、客户端最近 40 条上报（每条决定、通道选择、平台结果），以及音效链路状态
+（`media.ffmpeg`、`media.soundPlayers`）。
+
+## 开发
+
+```powershell
+pnpm install
+pnpm run check      # typecheck + vitest + build
+```
+
+`lib/` 是**故意提交**的：profile 链接的就是这个目录，构建产物随源码一起走。[AGENTS.md](AGENTS.md) 里是仓库规则，
+以及那些**不许"优化"掉**的实测约束 —— 宿主 bundle 必须自包含、Toast 子进程必须保留管道 stdio、音频只能走
+`System.Media.SoundPlayer`。
+
+## 已知限制
+
+- 没有托盘角标 / 任务栏角标 / 窗口闪烁；那些需要主进程 API，插件够不到。
+- 部分场景下点通知只把窗口拉回前台，不跳转会话。
+- `error` 与 `max-tokens` 两个结束态只有单测覆盖，没有真机构造过。
+- 插件无法感知通知被关闭，所以文件类音效用「封顶 8 秒」代替跟随通知生命周期。
+- 仅支持 Windows 桌面端 profile。
+
+## 许可证
+
+[MIT](LICENSE) · 第三方许可见 [THIRD-PARTY-NOTICES.md](THIRD-PARTY-NOTICES.md)。
+
+非官方插件：与 DeepSeek 官方无关，未获其背书或赞助。「DeepSeek」「DSH」「DeepSeek Harness」仅用于说明本插件接入的对象。

package/THIRD-PARTY-NOTICES.md

@@ -0,0 +1,55 @@
+# Third-party notices
+
+This plugin is MIT licensed (see [LICENSE](LICENSE)). It ships no runtime
+dependencies: the host bundle is self-contained apart from Node's own built-in
+modules, and the client bundle is a single file that uses the host's React.
+
+The one piece of third-party code compiled into `lib/index.js` is listed below,
+with the notice its licence requires.
+
+## zod 4.6.5 — MIT
+
+Compiled into `lib/index.js` (used for the projection payload schema).
+
+```text
+MIT License
+
+Copyright (c) 2025 Colin McDonnell
+
+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.
+```
+
+## Things that are referenced but not distributed
+
+- **Windows sounds.** The built-in "Windows sounds" are played by asking Windows
+  to play the files in `%SystemRoot%\Media`; no sound file from Windows is
+  copied into this repository.
+- **Author sounds.** The four `.wav` files in [`sounds/`](sounds/) are original
+  works by the repository owner, released under the same MIT licence as the rest
+  of this project.
+- **Dev dependencies.** TypeScript, Vitest, Rolldown, jsdom and the
+  `@deepseek-ai/*` packages are used to build and test only; none of them is
+  redistributed here.
+
+## Trademarks
+
+This is an **unofficial** plugin. It is not affiliated with, endorsed by, or
+sponsored by DeepSeek. "DeepSeek", "DSH" and "DeepSeek Harness" are used
+descriptively, to say what this plugin plugs into. "Windows" is a trademark of
+Microsoft Corporation.

package/cordis.patch.yml

@@ -0,0 +1,5 @@
+# dsh-notify-desktop bundle patch: mount the host plugin under its package name,
+# resolved through the profile's node_modules.
+- insert:
+    - id: dsh-notify-desktop
+      name: dsh-notify-desktop

package/dsh.plugin.json

@@ -0,0 +1,7 @@
+{
+  "name": "dsh-notify-desktop",
+  "description": "Windows native notifications and click-to-focus for DSH desktop sessions",
+  "version": "0.1.0",
+  "entry": { "name": "dsh-notify-desktop", "inject": [] },
+  "client": { "platform": "web" }
+}