dsh-summary-panel

Readme

# dsh-summary-panel

English | [简体中文](README.zh.md)

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:

```sh
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:

```sh
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:

```tsx
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`:

```ts
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`:

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

## License

MIT