dsh-web-notify

English | 日本語

A community plugin for the DeepSeek Harness (DSH) Web UI that sends browser/OS notifications when a session completes, errors, becomes blocked, or waits for user interaction.

This is a community-maintained plugin, not part of the DeepSeek Harness core distribution.

What it does

The host side registers a notifyTurn session projection. The Web client observes session state and uses the browser Notification API to notify for:

• a non-visible session ending as completed, blocked, or error;
• a session waiting for approval, question, or plan-review.

Notifications are suppressed when the relevant conversation is already visible and focused.

Additional behavior:

• max-tokens, aborted, and interrupted turn endings are ignored;
• subagent sessions are ignored;
• duplicate turn and interaction notifications are suppressed;
• multiple simultaneous updates are aggregated into one notification (DSH · 3 updates / 1 Waiting, 2 Completed in English, DSH · 3件の更新 / 1件の操作待ち、2件の完了 in Japanese);
• clicking a notification opens the highest-priority affected session;
• notifications are emitted only when browser permission is granted.

Compatibility

Latest DSH version with recorded runtime verification: 0.2.1-alpha.3, runtime-verified against the live app on 2026-10-15. The package manifest also declares 0.2.1-alpha.2 as a compatibility target; that declaration has not yet been runtime-verified.

DSH version	Verification
0.1.6-alpha.2	End-to-end behavior verified
0.1.7-alpha.2	Plugin load, inventory visibility, and test notification verified
0.1.7-rc.1	Plugin load, inventory visibility, and test notification verified
0.1.7-rc.2	Plugin load, inventory visibility, and test notification verified
0.2.0-rc.1	Plugin load, inventory visibility, and test notification verified
0.2.0-rc.2	Plugin load, inventory visibility, and test notification verified
0.2.1-alpha.1	Plugin load, inventory visibility, and test notification verified
0.2.1-alpha.2	Declared in engines.dsh; source-level compatibility reviewed, but plugin load, test notification, and real session notification triggers have not been runtime-verified on this version
0.2.1-alpha.3	Plugin load, settings row visibility, granted permission status, test notification firing, and real-session firing — completion (including one resumed after an approval), waiting-for-interaction, and suppressed stop/interrupt — verified on 2026-10-15 with generic titles and fixed status copy

Real-session completion and waiting-for-interaction notification firing on 0.2.1-alpha.3 is verified as listed (stop and interrupt do not notify). In the scripted browser, the notification permission and the not-attended gate were exercised through page-side overrides; the granted-permission display itself was checked in a real browser the same day. Real-session firing from error/blocked end states has not been triggered in this pass. On 0.2.1-alpha.2, even the test-notification smoke check remains unverified. Other newer DSH versions are not assumed compatible until verified.

Install

Install dependencies and build the client bundle:

npm install
npm run build

Add the local checkout to the Web profile:

dsh plugin --profile web add <absolute-path-to-this-repository>

Restart DSH Web after installation.

Settings

Open Settings → General → Browser notifications.

• When permission is not decided, request browser notification permission.
• When permission is granted, send a test notification.
• Revoke permission from the browser's site settings.

Copy language follows the browser's preferred languages, not the DSH Language setting. The first usable preference decides: ja renders Japanese, anything else renders English.

Privacy and notification content

OS notification centers and lock screens may display notification content.

This plugin intentionally limits notification text to:

• a generic DSH title prefix plus a short state label such as Completed, Error, or Waiting for approval in English, and its Japanese counterpart in a Japanese browser session;
• generic counts for aggregated notifications.

It does not show the DSH session display title, LLM output, command text, or full filesystem paths, so a session name holding customer or project names is not exposed on the OS lock screen. The plugin declares no dedicated capability; it reads only the session id and the session finish/wait states as fixed enum values (completed, error, blocked, approval, …), and hands the OS notification nothing but a generic title, a fixed status label, and fixed status copy. Clicking a notification opens the affected session (the plugin passes only its session id there), which is how a notification is tied back to it.

The plugin does not send notification data to an external service. Notifications are created locally through the browser Notification API.

Build and test

npm run build
npm run check
npm test

npm run build regenerates lib/client.js with esbuild. Rebuild after changing client source.

Limitations

• Browser notification permission is required and is scoped to the browser origin.
• Notifications are available only while the DSH page is loaded and connected; this plugin does not implement offline push notifications.
• DSH is evolving rapidly, so extension contracts can change between prerelease versions.
• Copy language is chosen once when the client module loads; changing the browser's preferred languages takes effect on the next page reload.

Contributing

Bug reports and focused pull requests are welcome. For notification failures, include the DSH version, browser, operating system, relevant session state, and whether the page was visible/focused.

License

MIT. See LICENSE.