description, kind
| 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.
Table of Contents
What it registers
- The type —
ctx.sidebarRightTabs.register(...)with kindfiles, id@deepseek-ai/dsh-client-ui-sidebar-files, bandbuiltin, no patterns, and one guide entry (order 10, titled from thesidebarFilesnamespace) that opens the type. - The body — the keyed
sidebar.right.pane.tabseat under that id: the tree, with its one control, reload, at the right of its header row.
Six 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), 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 labelled by workspaceTitleOf 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.