dsh-summary-panel

English | 简体中文

An extensible Codex-style conversation summary panel for DeepSeek Harness Web.

The list icon in the session header toggles a compact 320px popover. Its height grows with its content until it reaches the available viewport height, then the content scrolls. It stays aligned to the conversation edge and to the left of open Harness tool details. On mobile it becomes a dismissible right drawer. Open state is persisted per session.

Built-in outputs

The Outputs section reads successful file mutations published by ui-deliverables. It aggregates all loaded Turns, keeps each exact path once at its latest successful sequence, and lists the most recent files first. Five files are shown initially, with explicit expand and collapse controls. Clicking a row resolves it against the session workspace and opens it through Harness.

An empty conversation shows No outputs yet. The built-in section has no creation action because the panel does not own a file creation workflow.

Install

Install a reviewed commit into a DSH profile:

dsh plugin --profile <profile> add github:hzthzt/dsh-summary-panel#<commit-sha>
dsh --profile <profile> --dump-config
dsh --profile <profile> web

The repository commits lib/, so Git installation does not need to build the package. A local tarball can be installed instead:

pnpm pack
dsh plugin --profile <profile> add ./dsh-summary-panel-0.1.0.tgz

Extension API

Client plugins can register session-scoped sections through the typed conversation.summary.section list slot. Add dsh-summary-panel to the contributing bundle's Client inject list and peer dependencies, then import its public Client contract:

import type { ClientContext } from '@deepseek-ai/dsh-client-runtime/client'
import {
  SummaryEmpty,
  SummarySection,
  type SummarySectionComponentProps,
} from 'dsh-summary-panel/client'

function ReviewSection({ presentation, closePanel }: SummarySectionComponentProps) {
  return (
    <SummarySection title="Review" actionLabel="Add review" onAction={() => {}}>
      <SummaryEmpty>Nothing to review</SummaryEmpty>
      <small>{presentation}</small>
      <button type="button" onClick={closePanel}>Close</button>
    </SummarySection>
  )
}

export function apply(ctx: ClientContext): void {
  ctx.slots.inject('conversation.summary.section', () => ctx.slots.register({
    name: 'conversation.summary.section',
    id: 'review',
    order: 30,
  }, ReviewSection))
}

Every section receives the standard session props, including sessionId, useSession, and useSessions, plus presentation: 'pinned' | 'overlay' and closePanel().

The Client module also augments ctx.summaryPanel:

ctx.summaryPanel.open(sessionId)
ctx.summaryPanel.close(sessionId)
ctx.summaryPanel.toggle(sessionId)

Public presentation primitives are SummarySection, SummaryItem, and SummaryEmpty. SummarySection shows its plus action only when both actionLabel and onAction are provided.

Layout compatibility

Version 0.1.0 targets DeepSeek Harness dsh-v0.1.1-rc.2 at commit b150a551b8d465e31e418e1b2eaf5e79bbb7d28e.

Popover placement assumes the baseline AppFrame order: [data-shell-overlay] follows the details column. The plugin uses its width to keep the popover to the left of open tool details, but never replaces conversation, details, or another single slot and never mutates the center column. If the DOM cannot be discovered or measured, it falls back to a right-aligned popover.

When another shell plugin exposes a visible [data-dsh-toggle-cluster], the summary button aligns immediately before that cluster; otherwise it stays in the native session-header utilities slot. Shell buttons and resize handles do not dismiss an open summary, while Escape, the summary toggle, mobile backdrop, and an ordinary click in non-interactive content retain their close behavior.

Development

Use Node.js 24 and pnpm@11.7.0:

pnpm install --frozen-lockfile
pnpm typecheck
pnpm test
pnpm build
git diff --exit-code -- lib
pnpm pack

License

MIT