History

Tianyi Cui 25dcd7293c docs: purge chain-of-thought leakage from prose Delete design-session citations (decision/audit/plan ordinals, stack positions), change narration, review choreography, and reviewer-addressed justification from comments, JSDoc, docs, READMEs, Agent Notes, tests, and generator templates; restate every affected fact as current-state contract prose. Fix generated docs at their sources and regenerate the catalogs and cordis-surface regions; re-paste type-equiv blocks; update every bilingual counterpart and re-record the pairs. Record the citation rule in the committed-artifact-citations Agent Note.		2026-08-09 21:10:59 +08:00
..
src	docs: purge chain-of-thought leakage from prose	2026-08-09 21:10:59 +08:00
tests	Merge origin/master into worktree/sidebar-scrollbar-reveal	2026-08-04 15:46:53 +08:00
package.json	fix(packages): omit source publication payloads	2026-08-05 01:15:19 +08:00
README.i18n.yaml	docs(i18n): standardize contract terminology	2026-08-09 11:33:14 +08:00
README.md	docs: finish hierarchy rescan after rebase	2026-08-05 16:18:58 +08:00
README.zh.md	docs(i18n): standardize contract terminology	2026-08-09 11:33:14 +08:00
tsconfig.json	feat(client): typed locale standard seat in the slot framework	2026-07-30 01:04:56 +08:00
tsdown.config.ts	feat(gui): step1 skeleton — dsc web serves built web UI over booted harness host	2026-07-22 16:24:44 +08:00

README.md

@deepseek-ai/dsh-client-ui-sidebar

English | 中文

Sidebar plugin: real Host Workspaces in stable Host order, each containing its sessionIds in Workspace order with parentId nesting; Sessions outside every Workspace appear in a trailing Ungrouped section. Search, state dots, and collapse into the layout-owned 56px rail are presentation-local. Contract: the slot system standard.

New Session starts the runtime's page-local frontend Session Intent; a real Workspace's "+" starts one targeted to that Workspace. The Workspace header "+" opens ui-workspace's shared picker, whose selection also targets a frontend Session. A Workspace Intent does not appear in the sidebar.

SidebarRootComponentProps composes the layout owner share, the global useSessions and useWorkspaces hooks, the declared sidebar.workspace and sidebar.settings child slots, and injected startSession, open, and sidebar-toggle callbacks. There is no plugin store: deriveGroups consumes object-layer snapshots and component-local expansion/search state.

Scrollbars in the column are a pointer affordance: the shell rebinds ui-theme's scrollbar indirection to transparent whenever the pointer is outside it, and keeps the thumb drawn for 2s after the pointer leaves, so a list nobody is pointing at carries no bar. The reservation that keeps rows from moving belongs to the scrolling region (ui-workspace), so revealing a thumb never reflows.

The foot is the sidebar.settings seat: the sidebar renders only the bottom-pinned layout slot and shares its column state (wide); ui-settings registers the trigger row and settings panel there.

The /client export surface is the plugin body (apply/inject) plus the contract types only; SidebarRoot, the row components, and the tree derivation remain package-internal behind the slot registration.

Model Experience

None, as the sidebar renders the browser session list; nothing here reaches a model request.

KV Cache effect

None; this package neither assembles nor sends a provider request.

Known Limitations and Deferred Work

Session state-dot rendering is owned by ui-workspace — no done/error notification sources are available.
Group-by supports Workspace only — Update and Status are not available strategies.
"New task completed" unread marking is local viewing state — completion-time > last-seen never reaches the host.