dsh-done
Task completion celebration popup with sound for DeepSeek Harness.
When an agent finishes a task (status goes running → idle), a celebratory
popup appears in the page (confetti + fanfare), then auto-dismisses.
Features
- 🎉 Popup overlay in the
shell.overlay slot when a task completes
- 🎊 Confetti animation + bounce-in
- 🔊 Web Audio fanfare (ascending C5-E5-G5-C6), no external audio file
- ⏳ Auto-closes after ~3.2 s
- 🎲 Random encouraging message on each completion
Install
dsh plugin --profile web add dsh-done
or from a local checkout:
dsh plugin --profile web add /path/to/dsh-done
Then restart the profile.
Build (for contributors)
pnpm install
pnpm run build # tsc (host) + tsdown (client bundle)
pnpm publish
- Host entry:
src/index.ts → lib/index.js
- Client bundle:
src/client/index.tsx → lib/client.js
Publish / distribute
- Publish to npm, then tag the GitHub repo with the
dsh-plugin topic so
DSH users can discover it.
- To appear in the marketplace lists, open a PR in the relevant community
curated list (e.g. awesome-dsh-plugin-series repositories).
How it works
- Host (
src/index.ts): listens to agent/status; when status is idle,
records the completion timestamp. Exposes celebration/check RPC.
- Client (
src/client/index.tsx): polls celebration/check every 500 ms;
on a fresh completion, shows the popup in shell.overlay.
Runtime adaptation (important)
This plugin installs as a static bundle (loaded by the Loader via
{id, name}), so it uses the webServer route scheme for Host↔Client
communication — the harness/host bridge only exists inside the dynamic
Cordis plugin sandbox and is not present on a static bundle's ctx:
- Host (
src/index.ts): inject: ['webServer'], registers the
GET /dsh-done/check route via
ctx.effect(() => ctx.webServer.register({ kind: 'exact', path: '/dsh-done/check', handler })).
- Client (
src/client/index.tsx): polls fetch('/dsh-done/check?since=…')
every 500 ms; on a fresh completion, shows the popup in shell.overlay, and
also registers a sidebar.footer.action entry (🎉 manual trigger button).
Restart the profile after installing so the host route registers; the client
bundle is served dynamically by dsh-client-modules, so a page refresh picks
it up.
License
MIT
