DeepSeek Harness

This repository is a feature fork: dsh-report-card adds a card: 'report'
render intent to DeepSeek Harness so tools can render interactive HTML
reports directly inside the conversation.

What this fork adds

• packages/client/ui-report-panel - a standalone client plugin
  (dsh-client-ui-report-panel) that contributes the report
  artifact surface through public ui-conversation slots: the turn-tail card
  and the right-hand panel (tabs, search, scroll memory, minimize,
  multi-document tabs, ask-in-chat). The fork's ui-conversation stays at the
  upstream baseline; the panel is an opt-in composition entry.

• packages/core/tools/src/presentation.ts — new ReportCallView /
  ReportResultView (card: 'report', carrying a self-contained HTML
  document), wired into the ToolCallView / ToolResultView unions. The wire
  types flow to clients automatically, so any tool can emit the card.

• packages/client/ui-primitives/src/ReportBlock.tsx — sandboxed inline
  renderer: the report HTML is displayed in an <iframe sandbox="allow-scripts">
  (no same-origin), so report scripts can run but cannot touch the host page.
  The frame auto-resizes via a postMessage height contract
  (dsh-report-height), can open the report in a new tab, copy the HTML, or
  download it as a title-named file. The details panel renders the report as a
  full-height reading surface (up to 4096px).

• packages/client/ui-tool — reportCardModel derivation plus render wiring
  in the chat tool row and the details panel; malformed wire payloads (bad
  title, empty or >5MB html) fall back to the generic card instead of
  crashing. Report cards show up in the conversation immediately as standalone
  ChatGPT-style cards: a compact preview with an Expand action to view the
  full HTML and Collapse to shrink it back. The standalone card renders in the
  core conversation renderer at the turn tail (the bottom of the message),
  fully outside the tool-call tree. Clicking the card opens a right-side
  application panel showing the full report; the panel shares the same layout
  plane (the conversation is pushed left), includes a Refresh action, and
  auto-replaces its content when a newer report arrives. Controls follow the
  UI language (zh/en). The panel is fixed to the right side of the viewport
  (full height, independent scroll) and the conversation reserves its width,
  so the two are independent parallel spaces. The report fills the panel
  height, so the whole pane is used. Multiple reports open as tabs in the
  panel, and the panel width is draggable (320-800px). Reports load through
  blob URLs with an injected in-frame navigation shim, so in-report anchor
  links (table of contents) smooth-scroll to their target without blanking
  the frame, and the collapsed preview stays scrollable. The panel searches
  inside the report (the sandboxed frame is opaque to host Ctrl+F), remembers
  each tab's scroll offset across switches, and minimizes to a narrow bar
  without losing the tab set. Batch deliveries open as multi-document tabs
  with an index page whose links switch reports, and the panel can compose an
  ask-about-report question into the main conversation.

• demo/report-card-demo — a demo tool that emits the card.

• demo/report-html-integration — mounts the
  dsh-report-html plugin so
  its report tools emit the card; verified end to end with a real headless run.

Demo

Real server, real model round: ask for a report, click the card, and the full
report opens in an independent right-hand panel.

Install the panel plugin

The report panel ships as an npm plugin and can be added to any dsh host:

dsh plugin --profile web add dsh-client-ui-report-panel

Pair it with a report generator such as
dsh-report-html
(dsh plugin --profile web add dsh-report-html). The fork's demo overlay
demo/report-html-integration/cordis.yml mounts both for local development.

Try the demo

pnpm install
pnpm dsh --profile web --patch ./demo/report-card-demo/cordis.yml

Open http://127.0.0.1:3080 and ask: Use the demo_report tool. The returned
HTML report renders inline in the conversation.

Any tool can use the intent by declaring a presentResult that returns
{ card: 'report', title, html }; dsh-report-html is the full report
generator companion that produces the HTML payload.

English | 中文

DeepSeek Harness (dsh) is an open-source agent harness developed by DeepSeek AI.

It uses an architecture where everything is a plugin, and is powered by Cordis, whose design is described in A Programming Paradigm for Spatiotemporal Composability.

Developer preview

DeepSeek Harness is currently in developer preview and is iterating rapidly. THERE WILL BE COMPATIBILITY-BREAKING CHANGES.

Run

Run from npm

Install Node.js, then run:

npx @deepseek-ai/dsh web

The command starts the Web UI, served at http://127.0.0.1:3080 by default. See Web UI guide.

Run from source

To run from a repository checkout:

git clone https://github.com/deepseek-ai/deepseek-harness.git
cd deepseek-harness
pnpm install
pnpm run build
pnpm dsh web

Community and support

• Feel free to submit feedback or bug reports through GitHub Discussions.
• Add the dsh-plugin topic to your plugin repository for discoverability.
• Join DeepSeek Harness Discord community.

Contributing

See CONTRIBUTING.md.

Development

Start with the development guide and architecture documentation.

For agents, follow AGENTS.md.

License

MIT

Third-party dependencies and their licenses are disclosed in THIRD_PARTY_NOTICES.md.