Files
deepseek-harness/packages/client
Tianyi Cui 044cd4fb49 merge: integrate pinned master into session-log-v4 base
Merge master 01d96c168a84227374e3aa741e94ddfbb498e27e, observed when
this integration started, after the published 6de3db41 checkpoint. Keep
master's author history and preserve the release writer, adjacent
migrations, historical Session generations, and parent-owned catalogs.

Combine blank Session writer acquisition and superseded-startup
cancellation with the release branch's projection refresh and panel
preservation. A startup acquisition may finish after a later navigation,
but must not retain a stale main Session or reveal its Conversation.
Update the existing regression's retention expectation while preserving
its panel and active-navigation assertions.

Keep the release catalog loading, known-leaf, and parent availability
behavior alongside master's completed-turn status and aligned sidebar
icons. Regenerate the config locations and pair the combined README
contracts. Preserve upstream's Linux process-state assertion repair.
2026-09-18 18:21:47 +08:00
..
2026-09-17 21:11:19 +08:00
2026-09-17 21:11:19 +08:00
2026-09-17 21:11:19 +08:00
2026-09-17 21:11:19 +08:00
2026-09-17 21:11:19 +08:00
2026-09-17 21:11:19 +08:00
2026-09-17 21:11:19 +08:00
2026-09-17 21:11:19 +08:00
2026-09-17 21:11:19 +08:00

description, kind
description kind
Package map for the web GUI browser half: shell boot, browser-host communication, shared client services, localization, development reload, and the UI feature plugins. package-group

client/ — web-GUI browser half

English | 中文

Summary

The client/ group provides the browser experience for the dsh web GUI, including conversation, navigation, settings, approvals, file access, and other interactive features. Choose packages from this family when adding browser-visible behavior; use host/ for server-side page delivery and host integration. Packages cover both the shared browser foundation and focused UI features, while each child README owns its configuration and behavior. Authoring rules live in AGENTS.md, and the related documentation below explains cross-package composition.

Table of Contents


Packages

The kernel packages boot and serve the page; the UI feature packages present it. Each package README owns its contract and configuration.

Package Role ctx key
web/ Boots the browser shell —
modules/ Loads browser-side client modules ctx.clientModules / ctx.modules
connection/ Maintains browser-host RPC communication and event delivery ctx.connection
file-upload/ Sends raw Blob and byte-stream request bodies outside the page thread ctx.fileUpload
store/ Provides React-free observable and snapshot-store primitives —
hmr/ Refreshes client plugins during development —
locale/ Provides localization preferences and message dictionaries ctx.locale
test-runtime/ Shared repository test support for client feature packages —
ui-renderer/ Binds slot data to React and mounts the assembled application ctx.uiRenderer
ui-slots/ Defines typed extension Slots and reusable Component Factories —
ui-session/ Adapts Session Controller state into standard Slot sources and hooks —
ui-theme/ Applies the selected color theme —
ui-primitives/ Provides shared React controls, icons, and content renderers —
ui-attachment/ Registers composer and message-image attachment presentation —
ui-layout/ Arranges the main application regions —
ui-dockkit/ Provides docking layout operations and React components —
ui-sidebar/ Presents workspace and session navigation —
ui-sidebar-right/ Owns the right Sidebar and its tab types ctx.sidebarRight, ctx.sidebarRightTabs
ui-sidebar-documentpreview/ Displays documents in right Sidebar tabs ctx.documentPreviews
ui-sidebar-browser/ Browses sandboxed HTTP(S) pages, including loopback services, in right-Sidebar tabs —
resources/ Unified resource model: protocol providers behind the useResource session standard hook ctx.resources
ui-sidebar-files/ Right-Sidebar workspace file tree tab type —
ui-brand-official/ Fills the generic browser-brand slots with the official name and marks —
ui-workspace/ Provides workspace selection and creation surfaces —
ui-conversation/ Presents the active conversation and its input surface —
ui-chat/ Projects and renders the Chat conversation target —
ui-approval/ Presents approval requests and returns user decisions —
ui-tool/ Composes Tool call trees and keyed per-Tool views —
ui-workflow-run/ Replays durable workflow runs as nested chat disclosures —
ui-goal/ Presents and manages the current goal —
ui-trajectory/ Presents alternate views of agent activity —
ui-commands/ Provides session-aware command discovery and dispatch —
ui-input-trigger/ Coordinates inline command and reference suggestions —
ui-skill/ Adds skill references to inline suggestions —
ui-reference/ Unified Web @file / @session reference source —
ui-subagent/ Provides subagent navigation, child transcript states, and inline references —
ui-schedule/ Lists the current Session's active reminders in a read-only header catalog —
ui-jobs/ Lists this session's background jobs in the conversation header —
ui-model-selection/ Provides model selection in conversation surfaces —
ui-permission-presets/ Configures default permissions and switches the current session's access —
ui-plan/ Presents active plan-mode status and its exit control —
ui-settings-plugins/ Owns the Plugins settings section, its tab extension point, and configurable host-plane plugin cards —
ui-user-questions/ Presents interactive questions requested by the agent —
ui-agent-preset/ Selects a session's agent preset and authors preset compositions —
ui-settings/ Hosts the settings interface and its extension areas —
ui-settings-general/ Provides the general settings section —
ui-settings-models/ Provides model-provider configuration and DeepSeek onboarding —
ui-plugin-manager/ Contributes the sidebar Plugins panel: install, enable, disable, retry, and compose installed packages —
ui-settings-plugin-inventory/ Contributes the read-only Host Loader inventory tab to Plugins settings —
ui-deliverables/ Produces the changed-files card with its comparison tabs, delivery cards, and clickable final-response file references —
ui-message-feedback/ Provides message ratings and feedback dialogs opened from ratings, /feedback, or the Session Header menu ctx.feedbackUi
ui-directory-picker-browse/ In-app directory browsing surface for the workspace directory flow —
ui-directory-picker-native/ Native directory-picker surface driving the local Desktop or Host OS chooser —
ui-open-in-app/ Session-header split button opening the workspace directory in an installed application, and the document preview's default-application controls for one file —

Start with the subsystem reference and the two notes that own the cross-package composition decisions, then the host half that serves this page.

Dev Note

Working context for maintainers — click to expand

None.