Overview
@local/activity-heat
README / EN
Package documentation
Registry summary
dsh.pub verifies the pinned bundle contract, runtime facts, and distribution semantics. The complete README remains in the source repository.
Read the full README on GitHubLIMITATIONS
Known limitations
- Turns, tokens, cache hit rate and context usage read `sessionStats`, `tokenUsage` and `contextPressure` — the same projections as the composer status bar, so the numbers match it exactly. Profiles that only expose `contextTimeline` fall back to its values; in that case the figures can differ from the status bar. - No Linux default shortcut is declared; Linux users bind one in Settings. - The right-click menu does **not** delete sessions: the host only supports archiving, and archived sessions can be restored from the sidebar's archived view. - Running sessions' archive item becomes “Stop and archive…”: the dialog lists the running turn / subagents / jobs / schedules and stops them (irreversible) before archiving; the panel re-sorts by heat afterwards. - "Download session log" requires the host to mount `dsh-session-log-export`; without it the item reports unavailability instead of opening a 404 page. - The host's native sidebar rows expose no right-click event, but they do expose `sidebar.workspaces.session.menu.item` / `.row.action` seats; the plugin's terminal / copy / download actions live there, while pin / rename / fork / archive use the host's own items and the central panel keeps the full menu. - `updatedAt` is the host's last-activity snapshot and does not refresh with tool steps or streaming output; the panel treats running sessions as maximum heat, which does not mean they just received a message. - "Open in…" requires the host to mount `dsh-host-open-in-app` (`/open-in-app/apps` and `/open-in-app/open`); without it, over SSH, or when the directory is gone, the item is disabled or reports a failure. The host probes installed apps once at startup, so newly installed apps appear after a DSH restart. - Terminals list terminal emulators only (Windows Terminal / Terminal / iTerm2 / Warp…); Git Bash is a shell, not a terminal emulator, so it is not shown. - "Open in terminal" is implemented by the plugin's own Host route `POST /activity-heat/open-terminal`, independent of the host open-in-app catalog; Windows tries Windows Terminal → PowerShell 7 → Windows PowerShell, and reports a failure when none is available. - Waiting-for-approval / plan-review rely on the host `pendingInteraction`; older hosts expose only `userQuestions`, so both fall back to “Waiting”. - The right-sidebar dock and `/heat` require the host to mount `sidebarRightTabs` / `commandUi`; otherwise the entry is simply absent. - Batch-archiving a running session uses `stopActivity`; stopping is not reversible.
