description	kind
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.	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.

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, titled from the sidebarFiles namespace) 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 16px folder sheet before the type's label. The tree's own rows never draw this sheet.

Seven source files under src/client/: definition.ts (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), and expanded. The owner's signal ends a bucket: on abort the tab is forgotten and a listing that settles afterwards writes nothing.

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.

README.md