dsh-calendar

Session-interaction calendar plugin for DeepSeek Harness: a root-scope calendar surface that aggregates every session's interaction events across the whole harness. A sidebar-foot action opens a full-viewport month grid; each day cell carries a badge with that day's interaction count, and selecting a day lists one row per active session — the session's title, its day-scoped duration, and its event count — expandable to the raw event list. Live appends stream into the open calendar in real time.

English | 中文

Features

• Whole-harness view — one calendar for every session (user messages, assistant replies, tool calls, turn boundaries), not just the current one.
• Real-time — host-side SSE channel pushes new events into the open calendar the moment they are appended.
• Historical backfill — seeds already-live sessions at startup and best-effort reads the persisted log through sessionPersistence.
• Merge-extensible — unknown (plugin-merged) event types fall back to their type name; no per-type registry to maintain.
• Bounded memory — rolling 90-day window, capped at 2000 events per day.

Installation

The plugin targets the DeepSeek Harness web surface (dsh web).

npm install @necokeine/dsh-calendar
# or: pnpm add @necokeine/dsh-calendar

Then mount it in your Harness profile by inserting the plugin row (e.g. in $DSH_HOME/profiles/web/cordis.patch.yml):

- insert:
    - id: ui-calendar
      name: '@necokeine/dsh-calendar'

Restart dsh web and refresh the page — a Calendar entry appears at the bottom of the sidebar.

Development

pnpm install
pnpm test        # vitest: node half + browser-half data layer + component specs
pnpm build       # tsc -b && tsdown → lib/ (node half + browser client bundle)
pnpm lint        # oxlint (src + tests)

The footer-action integration specs (slot registration over the real SlotRegistry and locale plugins) need a DeepSeek Harness checkout: the published @deepseek-ai/dsh-client-runtime/dsh-client-locale npm artifacts are browser-format bundles that cannot load under plain node/vitest. The standalone specs here cover the same code through a local createSnapshotStore stub (tests/stubs/runtime-client.ts); run the integration specs inside the harness monorepo, where workspace tsconfig paths resolve those packages to source.

The package is a split plugin like the harness's own dsh-client-hmr:

• Node half (src/index.ts) — a host plugin injecting sessions + webServer. It subscribes to the session/event firehose, summarizes every event into a short wire record { sessionId, seq, time, type, summary } (Chinese product copy, host-authored), folds each session's title from its session/title events (foldSessionTitle), and aggregates everything per-session-per-day — each day bucket lists one CalendarSessionWire per active session with its title, day-scoped time span, event count, and (for the expanded view) its raw event list. It registers two routes:
  • GET /calendar/events?from=YYYY-MM-DD&to=YYYY-MM-DD — JSON per-session day buckets for a local-day range.
  • GET /calendar/stream — SSE channel: a backlog frame on connect, then one event frame per live append (the browser folds them into the matching session rows).
• Browser half (src/client/index.ts) — registers the sidebar.footer.action entry plus the calendar locale namespace. CalendarController owns the view store (bound to useCalendar), the per-month /calendar/events fetch, and the /calendar/stream EventSource lifecycle (open with the panel, close with it). The month grid shows per-day interaction counts; the day-detail area lists session rows (title + duration + event count) that expand to the raw event list — expanded state is component-local.

Repository layout

src/
  index.ts              # node half: aggregator, index, routes, SSE
  events.ts             # shared wire protocol (both halves)
  invariant.ts          # package invariant companion
  client/
    index.ts            # browser half entry (footer action registration)
    calendar-controller.ts  # store + wire calls + SSE lifecycle
    CalendarAction.tsx  # footer trigger + month grid + day detail
    calendar-action.module.css
    locales.ts          # zh/en dictionaries
tests/                  # vitest specs (node half, controller, component)
tsdown.config.ts        # independent build (CSS modules inline + loader banner)

License

MIT