dsh-agent-pill

DSH (DeepSeek Harness) web plugin: a ZCode-style agent activity pill (top-right status capsule) plus a right-side summary drawer, toggled with Ctrl+Alt+P.

host half: aggregates the current conversation's Goal / Subagents / Agent status / background jobs and exposes a fenced JSON API (/pill/api) with full control verbs.
client half: top-right floating status capsule + right drawer (goal card, subagent list, agent status, job list with output/kill).

UI behavior

Draggable capsule: drag the pill to any screen edge; the seat persists in localStorage across reloads and stays clamped to the viewport on window resize.
Auto light/dark theme: the palette is driven by CSS variables that follow the DSH theme signal (<body data-ds-dark-theme>), so the capsule and drawer switch between the white and the dark ("moon night") scheme instantly — including system mode following the OS.
Shortcut: Ctrl+Alt+P toggles the drawer (click also works).
Goal card shows the objective, phase, rounds, and elapsed time (ZCode-style), with a rounds progress bar (roundsStarted / maxGoalRounds) and the activation state.
Capsule summary (v0.3.0): the pill shows the goal's elapsed time plus live badges — running subagents, running jobs, an active workflow run (wf, with the current phase in the tooltip), and failed jobs (red).
Subagent tree (v0.3.0): descendants are indented by depth, and each row shows its run duration and terminal stop reason (failed settles render red) — timestamps come from the host's subagent/start / subagent/end observation, since the durable listing carries none.
Jobs timing (v0.3.0): each job row shows relative start time, and finished jobs show total duration and when they settled.
Usage section (v0.3.0): when the host mounts tokenMeter, the drawer shows the session's current token pressure, surface, and signed surface delta (measured at most every 10s).
Workflow status (v0.3.0): the most recent workflow run (id, meta name, current phase() title, settled state) is reported under Agent and drives the capsule's busy dot and wf badge.

Install

dsh plugin --profile web add dsh-agent-pill
# restart the profile (the web composition disables host-side HMR)

Features

Section	Data source	Control verbs
Goal	`goal/change` session-event projection replay + live append feed (last-wins fold)	`goal.pause` / `goal.resume` / `goal.complete` / `goal.clear` (CAS `{id, revision}`, requires a live agent)
Subagents	`ctx.subagents.listDescendants` (durable tree, live-preferred) + process-local `subagent/start` / `subagent/end` timestamps	`subagent.interrupt` (human-parent authority; cancels a continuable child's current turn)
Agent	`ctx.agents.get(id)?.status` + `agent/status` events (`idle` / `running`)	read-only
Workflow	`workflow/start` / `workflow/phase` / `workflow/end` events (most recent run, global)	read-only
Jobs	`ctx.jobs.list(caller)` + `onJobsChanged` invalidation	`jobs.kill` (registry stock API); `jobs.output` (event replay, never consumes the model's cursor)
Usage	`ctx.tokenMeter.measure(session)` (throttled to 10s)	read-only

API routes

All routes pass the browser-trust fence (loopback Host or trustedHosts; cross-site requests refused) and answer {ok, value} / {ok:false, error:{code,message}}.

POST /pill/api/state — {sessionId} → aggregated snapshot (goal / agent / subagents / jobs / services)
POST /pill/api/goal.pause|resume|complete|clear — {sessionId, id, revision}
POST /pill/api/subagent.interrupt — {sessionId, childId}
POST /pill/api/jobs.output — {sessionId, id}
POST /pill/api/jobs.kill — {sessionId, id, reason?}

Build from source

pnpm install
pnpm build        # tsc host → tsc client → tsdown (lib/index.js + lib/client.js)

host half: plain ESM (lib/index.js); runtime @deepseek-ai/* peers resolve from the deployment's module fallback.
client half: window.__ModuleLoader__.load({id:'dsh-agent-pill', factory}) protocol artifact (lib/client.js); platform modules external, everything else inlined.

Mount manually (without npm)

Create a junction from your profile's plugins/ directory to this package, then append to the profile's cordis.patch.yml:

- insert:
    - id: agent-pill
      name: 'dsh-agent-pill'   # or a relative path like './plugins/dsh-agent-pill'

A patch entry must be an id-targeted override or an insert list — a bare - name: <package> row is skipped by applyEntryPatches.

Restart the DSH profile after any cordis.patch.yml / bundles change (the web composition disables host-side HMR); client bundle changes only need a hard browser refresh.

License

MIT

dsh-agent-pill

DSH (DeepSeek Harness) web plugin: a ZCode-style agent activity pill (top-right status capsule) plus a right-side summary drawer, toggled with Ctrl+Alt+P.

host half: aggregates the current conversation's Goal / Subagents / Agent status / background jobs and exposes a fenced JSON API (/pill/api) with full control verbs.

client half: top-right floating status capsule + right drawer (goal card, subagent list, agent status, job list with output/kill).

UI behavior

Draggable capsule: drag the pill to any screen edge; the seat persists in localStorage across reloads and stays clamped to the viewport on window resize.

Auto light/dark theme: the palette is driven by CSS variables that follow the DSH theme signal (<body data-ds-dark-theme>), so the capsule and drawer switch between the white and the dark ("moon night") scheme instantly — including system mode following the OS.

Shortcut: Ctrl+Alt+P toggles the drawer (click also works).

Goal card shows the objective, phase, rounds, and elapsed time (ZCode-style), with a rounds progress bar (roundsStarted / maxGoalRounds) and the activation state.

Capsule summary (v0.3.0): the pill shows the goal's elapsed time plus live badges — running subagents, running jobs, an active workflow run (wf, with the current phase in the tooltip), and failed jobs (red).

Subagent tree (v0.3.0): descendants are indented by depth, and each row shows its run duration and terminal stop reason (failed settles render red) — timestamps come from the host's subagent/start / subagent/end observation, since the durable listing carries none.

Jobs timing (v0.3.0): each job row shows relative start time, and finished jobs show total duration and when they settled.

Usage section (v0.3.0): when the host mounts tokenMeter, the drawer shows the session's current token pressure, surface, and signed surface delta (measured at most every 10s).

Workflow status (v0.3.0): the most recent workflow run (id, meta name, current phase() title, settled state) is reported under Agent and drives the capsule's busy dot and wf badge.

Features

Section

Data source

Control verbs

Goal

goal/change session-event projection replay + live append feed (last-wins fold)

goal.pause / goal.resume / goal.complete / goal.clear (CAS {id, revision}, requires a live agent)

Subagents

ctx.subagents.listDescendants (durable tree, live-preferred) + process-local subagent/start / subagent/end timestamps

subagent.interrupt (human-parent authority; cancels a continuable child's current turn)

Agent

ctx.agents.get(id)?.status + agent/status events (idle / running)

read-only

Workflow

workflow/start / workflow/phase / workflow/end events (most recent run, global)

read-only

Jobs

ctx.jobs.list(caller) + onJobsChanged invalidation

jobs.kill (registry stock API); jobs.output (event replay, never consumes the model's cursor)

Usage

ctx.tokenMeter.measure(session) (throttled to 10s)

read-only

API routes

All routes pass the browser-trust fence (loopback Host or trustedHosts; cross-site requests refused) and answer {ok, value} / {ok:false, error:{code,message}}.

POST /pill/api/state — {sessionId} → aggregated snapshot (goal / agent / subagents / jobs / services)

POST /pill/api/goal.pause|resume|complete|clear — {sessionId, id, revision}

POST /pill/api/subagent.interrupt — {sessionId, childId}

POST /pill/api/jobs.output — {sessionId, id}

POST /pill/api/jobs.kill — {sessionId, id, reason?}

Build from source

pnpm install pnpm build # tsc host → tsc client → tsdown (lib/index.js + lib/client.js)

host half: plain ESM (lib/index.js); runtime @deepseek-ai/* peers resolve from the deployment's module fallback.

client half: window.__ModuleLoader__.load({id:'dsh-agent-pill', factory}) protocol artifact (lib/client.js); platform modules external, everything else inlined.

Mount manually (without npm)

Create a junction from your profile's plugins/ directory to this package, then append to the profile's cordis.patch.yml:

- insert: - id: agent-pill name: 'dsh-agent-pill' # or a relative path like './plugins/dsh-agent-pill'

A patch entry must be an id-targeted override or an insert list — a bare - name: <package> row is skipped by applyEntryPatches.

Restart the DSH profile after any cordis.patch.yml / bundles change (the web composition disables host-side HMR); client bundle changes only need a hard browser refresh.

mozhuanzuojing/dsh-agent-pill

dsh-agent-pill

UI behavior

Install

Features

API routes

Build from source

Mount manually (without npm)

License

社区评论

mozhuanzuojing/dsh-agent-pill

dsh-agent-pill

UI behavior

Install

Features

API routes

Build from source

Mount manually (without npm)

License

社区评论