deepseek-harness/packages/client/ui-sidebar-files/README.md

---

description: "The right Sidebar's file-tree tab type for the dsh web client: the session workspace root listed one level at a time over the wire, opening files into the Sidebar by resource address."

kind: "package-reference"

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

English | 中文

Summary

The right Sidebar's navigator tab type: the session's workspace root as a tree, listed one level at a time over the wire, opening files into the Sidebar. It is a page type reached from the guide and claims no address; it opens files by address for the dsh-resource://file viewers to claim — nothing in ui-sidebar-right knows this package.

Table of Contents

• What it registers
• The tree
• Model Experience
• Known Limitations and Deferred Work
• Dev Note

---

What it registers

• The type — ctx.sidebarRightTabs.register(...) with kind files, id @deepseek-ai/dsh-client-ui-sidebar-files, band builtin, no patterns, and one guide entry (order 10, its title and description from the sidebarFiles namespace, its glyph the shared folder icon) that opens the type.
• The body — the keyed sidebar.right.pane.tab seat under that id: a header row under the strip, then the tree. The header row is the document preview's (ui-sidebar-documentpreview): the root path, its directories greyed and its last segment in full ink, never ellipsized (a path wider than the row keeps its end and fades its start), with the one control, reload, at its right. The row is copied rather than shared because a plugin bundle shares runtime code only through the platform modules; once the artifact and slot surfaces settle, one copy in ui-primitives could serve every pane header.
• The chip title — the keyed sidebar.right.pane.tab.title seat under that id: a shared FileTypeIcon folder glyph at 16px before the type's label. The tree's own rows never draw this sheet.

Seven source files under src/client/: definition.tsx (the type), store.ts (what it keeps), face.ts (how it lists, Remote binding included), FilesBody.tsx (what it draws, with its ordering and failure-line helpers), FilesTitle.tsx (the chip title), locales.ts (what it says), and index.ts (the wiring).

The tree

The root is the session's working directory, read from useSessions().byId[sessionId].cwd, and split for the header row by pathPartsOf from @deepseek-ai/dsh-util-workspace-path. Every level is keyed by absolute path; a child's path is its parent's joined with the entry name by /. A level is listed when it is first expanded, through remote.workspaceFiles.list(sessionId, absolutePath) on the @deepseek-ai/dsh-api-workspace-files namespace; the adapter keeps the listing's entries and truncation flag and drops its workspace-relative path. Rows are ordered directories first, then by natural, case-insensitive name; dotfiles are shown like any other entry.

Entry type	Row
directory	Toggles; the level is fetched the first time it opens and kept while collapsed.
file	Opens dsh-resource://file/session/<sessionId>/<encoded path relative to the root>, built by fileAddressFor from @deepseek-ai/dsh-util-workspace-path from the entry's absolute path and the tree's root, through useTabInfo().tab.actions.openResource, landing in the tab's own pane.
other	Shown greyed and not clickable, so the directory is reported whole.

A level cut by the endpoint's entry cap ends with a marker; an empty level says so; a level that failed shows one line per code — workspace-file/not-found, outside-workspace, not-directory — and the transport's own message otherwise. Reload drops every listed level and asks again for the expanded ones; collapsed levels are fetched again when they next open. A session without a working directory shows a single line instead of a tree.

State lives in the type's own store, bucketed by tab id: root, levels (loading / ready / failed per absolute path), expanded, and scrollTop, which the body tracks locally while scrolling and commits once when it unmounts. Because the store outlives the body, switching to another sidebar tab and back remounts the tree with its levels intact and its scroll offset restored. The owner's signal ends a bucket: on abort the tab is forgotten, and neither a listing that settles afterwards nor the unmount's offset commit writes anything.

Model Experience

None, as this package draws a workspace file tree in the browser and registers nothing model-facing.

KV Cache effect

None; directory listings travel over the Remote and assemble no model request.

Known Limitations and Deferred Work

• Listing only. No search, artifact filter, drag-and-drop, rename, context menu, current-file highlight, or filesystem watching; a level changes only through reload.
• One root. The tree is rooted at the session's working directory; there is no way to browse above it, and the Host refuses paths outside the workspace root anyway.

Dev Note

Working context for maintainers — click to expand

None.

Runtime invariant: No companion is published. The tree's only runtime state is one Slot store per tab, written by the body that owns it and forgotten on the tab's abort signal; there is no second observation of it to compare against.