dsh-plugin-pin-session

A DeepSeek Harness web plugin that pins sessions: a collapsible Pinned Sessions group above the sidebar session list, plus Pin / Unpin entries in every session row's ... menu. Pure client+host bundle — zero changes to DSH core, pin order stored host-side so it follows you across browsers and origins.

✨ Features

• 📌 Pin / Unpin in the row ... menu — one entry per row, label reflects current state.
• 🗂️ Collapsible Pinned Sessions group directly above the session list:
  • click a pinned row to open that session (sessions.open);
  • hover reveals an × quick-unpin;
  • header toggles collapse (persisted per browser via localStorage);
  • sessions no longer present in the list render dimmed and are not clickable.
• 💾 Host-side storage at $DSH_HOME/storages/pin-session.json — pin order is oldest-first and consistent across browsers and origins.
• 🧩 Zero core surgery — pinned sessions stay in the chronological list; the shipped WorkspaceBrowser is left untouched.

🚀 Install

dsh plugin --profile web add github:NattoCB/dsh-plugin-pin-session

Then add "dsh-plugin-pin-session" to dsh.profile.bundles in the profile's package.json. A DSH restart is required — new client bundles join the boot graph only at process start.

Local checkout instead? dsh plugin --profile web add file:/absolute/path/to/dsh-plugin-pin-session

⚙️ How it works

Half	Mechanism
Host	webServer.register({ kind: 'prefix', path: '/pin-session' }) JSON API over an atomic JSON file store
Row menu	The shipped session-row menu portals a role="menu" element to document.body; a MutationObserver matches each menu to its row via React fibers (props.node.id) and appends one Pin/Unpin item styled with the menu's own classes, closed by an outside pointerdown
Section	A React root planted before the [role="tree"] session list renders each pinned row's own real primitives.Menu, anchored at that row's ... button and wired to the same live callbacks (onRename(id, title) / onFork(id) / onArchive(id)) resolved from the row's fiber

The shell freezes every vendor module it serves (Object.isFrozen(primitives) === true), so shared components cannot be monkey-patched — but they can be called. The section menu therefore opens at the pinned row (not wherever the original row is scrolled) while rename/fork/archive stay single-sourced in the shipped browser; the ... affordance hides while the real row is not rendered (collapsed group / filtered list).

No pin icon ships in the primitives set, so the menu item embeds its own pushpin SVG.

✅ Verify after refresh

1. Sidebar shows Pinned Sessions above the list once at least one session is pinned.
2. Hover a session row → ... → Rename / Fork / Archive + a pushpin-iconed Pin.
3. Click Pin → row appears under Pinned Sessions; menu flips to Unpin.
4. The pinned row's own ... opens right at that row with the same actions.
5. Click a pinned row → that session opens; Unpin removes it.
6. Collapse the group → reload page → collapsed state survives (localStorage).
7. cat ~/.dsh/storages/pin-session.json shows the id list.

🔌 API

GET  /pin-session/pins                 -> { pins: [{ id, title?, pinnedAt }] }
POST /pin-session/pin    {id, title?}  -> { pins }
POST /pin-session/unpin  {id}          -> { pins }

🧪 Test

npm test   # node --test — 11 cases across store + HTTP router

---

License

MIT — see LICENSE.