dsh-response-meta

English | 中文

A DSH Web plugin that adds one always-visible runtime summary to every model
reply: model, reasoning extent, tokens per second, timestamp, total runtime,
and time to first token (TTFT).

The plugin hides the duplicate native timing group that normally appears on
hover in the same assistant action row, while preserving timestamps on user
messages. Manually interrupted replies, including replies stopped during
reasoning, receive an inline summary as well.

Example in a Chinese UI (11 px muted text):

# Completed reply, below the message actions
deepseek-v4-pro · 思考 15 tok · 46 tok/s · 14:16 · 用时 2分24秒 · 首 token 2.1秒
# Interrupted during reasoning, inline in the message stream
deepseek-v4-pro · 思考 1.5k 字

• Model comes from the turn's request/header session event. Later turns
  without a new header inherit the most recent known model.
• Reasoning extent prefers provider-reported reasoning tokens and falls
  back to the reasoning text length.
• Tokens/s is output tokens divided by decode time, from first token to
  message completion, matching DSH's native timing semantics.
• Timestamp shows HH:mm for today's replies and includes the date for
  older replies.
• Total runtime spans the whole turn; TTFT spans the current step from
  start to its first token.
• Interrupted replies usually have no usage record, so the plugin shows the
  model and streamed reasoning extent. Real usage is retained when a
  finalization race provides it.
• Missing fields are omitted individually; nothing is rendered when all fields
  are unavailable.

Install

dsh plugin --profile web add github:Unintendedz/dsh-response-meta#v0.1.0

Restart the running DSH Web service after installation. Plugins are loaded
when the service starts.

Local development

./scripts/install.sh   # remove + add to refresh the local file: snapshot
# Restart the DSH Web service afterward.

The script reuses the profile's configured pnpm storeDir, preventing
ERR_PNPM_UNEXPECTED_STORE when run from a different shell. If the store was
changed manually, relink it once:

cd ~/.dsh/profiles/web && pnpm install --config.confirm-modules-purge=false

Uninstall

dsh plugin --profile web remove dsh-response-meta

How it works

• Host (lib/index.js): registers a dependency-free projection unit on
  ctx.sessionProjections. It folds session events, tracks the active
  turn/step, records the last in-turn request/header model in byTurn, and
  inherits the previous model for header-less turns. Headers outside turns,
  such as title or compaction requests, are ignored. Projection updates reach
  the browser through DSH's existing session-projection channel. The plugin
  implements the rc2 projection contract (stateSchema + wire.viewSchema).
• Browser (lib/client.js):
  • Completed replies register in conversation.chat.assistant-actions. The
    component reads usage, step timing, turn timing, reasoning content, and the
    per-turn model projection for the exact messageId. A scoped structural
    selector hides only the native assistant timing group.
  • Interrupted, failed, or aborted steps register through a
    dsh-response-meta-aborted conversation event and a keyed
    conversation.chat.node entry. This also covers reasoning-only steps that
    never produced turn/end.
  • Actions remain on the first row; the complete summary owns a responsive
    second row. Narrow screens wrap without truncation or horizontal overflow.

Verify

npm test
node tests/live-e2e.mjs http://127.0.0.1:33880

The live test requires a DSH Web test server running this plugin. The browser
scripts in tests/ cover interruption behavior and completed-row layout.