dsh-pgragh

<h1 align="center">dsh-pgragh</h1>

<p align="center"><strong>A live parallel execution line for DeepSeek Harness Web.</strong></p>

<p align="center"> <a href="README.zh-CN.md">简体中文</a> · <a href="https://github.com/dangoZhang/dsh-pgragh/actions/workflows/ci.yml"><img alt="CI" src="https://img.shields.io/github/actions/workflow/status/dangoZhang/dsh-pgragh/ci.yml?style=flat-square&label=tests"></a> <a href="https://www.npmjs.com/package/dsh-pgragh"><img alt="npm" src="https://img.shields.io/npm/v/dsh-pgragh?style=flat-square"></a> <a href="https://github.com/deepseek-ai/deepseek-harness"><img alt="DeepSeek Harness" src="https://img.shields.io/badge/DeepSeek_Harness-plugin-475569?style=flat-square"></a> <a href="LICENSE"><img alt="MIT" src="https://img.shields.io/github/license/dangoZhang/dsh-pgragh?style=flat-square"></a> </p>

dsh-pgragh adds one compact white line above the DeepSeek Harness composer. Every point comes from a real tool dispatch, physical completion, and ordered session commit, so you can see whether parallel work happened, where it waited, and how much wall time it saved.

model emits:    A  B  C  D
completion:     B  A  C  D
ordered commit: A  B  C  D


Install

Requires DeepSeek Harness and Node.js 22.19+ or 24+.

npx --yes @deepseek-ai/dsh plugin --profile web add dsh-pgragh@0.1.0
npx --yes @deepseek-ai/dsh web

Open a conversation and run more than one tool in a step. The line appears automatically and stays hidden when there are no calls. A source install is also supported:

npx --yes @deepseek-ai/dsh plugin --profile web add github:dangoZhang/dsh-pgragh

Read the line

• Position and state: point position is physical completion time; a hollow pulse is running, a double outline is completed but waiting for ordered commit, and a solid point is committed. Hover for the tool label, duration, and commit wait.
• Call type: an outer ring marks a subagent, a small point marks a code-mode internal call, and a diamond marks an exclusive barrier. T17 · S4 identifies the active turn and step.
• Savings: Parallelism = serial leaf-work estimate / wall time; Saved = serial estimate - wall time. Parent run_code calls are excluded when their internal calls are visible, preventing double counting.

Ground truth and limits

The host observes the official tools/execute around-dispatch path for start and completion timestamps. Persisted tool/result and tool/code-dispatch session events determine when results become model-visible. The observer is read-only: it does not change arguments, results, scheduler behavior, or commit order.

The SSE feed contains only session id, tool name, optional description, status, and timestamps. The UI shows the latest observed step; its in-memory timeline starts again when the DSH host restarts.

Verification

pnpm check runs strict type checking, both host and browser builds, state-machine and metrics tests, plus a real DSH integration test using the official ToolRuntime, SessionStore, and WebServer.

pnpm install
pnpm check

Focused issues and pull requests are welcome. Keep the observer read-only and include behavioral tests for timeline changes.

License

[MIT](LICENSE) © dsh-pgragh contributors