@deepseek-ai/dsh-client-ui-sidebar 0.0.1-rc.1

package/LICENSE

@@ -0,0 +1,28 @@
+BSD 3-Clause License
+
+Copyright (c) 2026, DeepSeek
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are met:
+
+1. Redistributions of source code must retain the above copyright notice, this
+   list of conditions and the following disclaimer.
+
+2. Redistributions in binary form must reproduce the above copyright notice,
+   this list of conditions and the following disclaimer in the documentation
+   and/or other materials provided with the distribution.
+
+3. Neither the name of the copyright holder nor the names of its
+   contributors may be used to endorse or promote products derived from
+   this software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
+FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
+SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
+CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
+OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

package/README.i18n.yaml

@@ -0,0 +1,6 @@
+# Bilingual-pair consistency record (docs/i18n/README.md): the git blob hash of each
+# side as of the last confirmed-consistent state. Both languages carry equal authority;
+# after editing either side, bring the other along and re-record with:
+#   pnpm run verify-translation-pairing --write packages/client/ui-sidebar/README.md
+README.md: 45ae267d98b17bbc612cf932f5b95b42ba6ff4bf
+README.zh.md: a9fb927305d0bab5fb4d27adbfdbec90dfa1dd6d

package/README.md

@@ -0,0 +1,29 @@
+# @deepseek-ai/dsh-client-ui-sidebar
+
+English | [中文](README.zh.md)
+
+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](../../../.agents/notes/implemented/architecture/2026-07-22-slot-type-chain-implementation.md).
+
+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](../ui-theme/README.md) 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](../ui-workspace/README.md)), 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](../ui-workspace/README.md)** — 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.

package/README.zh.md

@@ -0,0 +1,29 @@
+# @deepseek-ai/dsh-client-ui-sidebar
+
+[English](README.md) | 中文
+
+侧边栏插件：真实 Host Workspace 按稳定的 Host 顺序排列；每个 Workspace 按自身顺序包含其 `sessionIds`，并以 `parentId` 嵌套；不属于任何 Workspace 的会话显示在末尾的 `Ungrouped` 分区。搜索、状态点以及折叠到布局拥有的 56px 轨道，都只属于呈现层。约定：[slot 系统标准](../../../.agents/notes/implemented/architecture/2026-07-22-slot-type-chain-implementation.md)。
+
+New Session 会启动运行时的页面局部前端 Session Intent；真实 Workspace 的「+」会启动一项以该 Workspace 为目标的 Intent。Workspace 标题栏的「+」打开 ui-workspace 的共享选择器，选择结果同样以一个前端会话为目标。Workspace Intent 不会出现在侧边栏中。
+
+`SidebarRootComponentProps` 组合布局 owner share、全局 `useSessions` 和 `useWorkspaces` 钩子、已声明的 `sidebar.workspace` 与 `sidebar.settings` 子 slot，以及注入的 `startSession`、`open` 和侧边栏切换回调。这里没有插件 store：`deriveGroups` 消费对象层快照与组件局部的展开／搜索状态。
+
+栏内的滚动条是一种指针可供性：只要指针不在栏内，外壳就把 ui-theme 的[滚动条间接层](../ui-theme/README.md)重新绑定为 `transparent`；指针离开后滑块再保留 2 秒，因此没人指向的列表不会带着滚动条。避免行位移的空间预留属于滚动区域本身（[ui-workspace](../ui-workspace/README.md)），所以显示滑块不会引起重排。
+
+页脚承载 `sidebar.settings`：侧边栏只渲染固定在底部的布局 slot，并共享其栏状态（`wide`）；ui-settings 在此注册触发行和设置面板。
+
+`/client` 导出表层只包含插件主体（`apply`／`inject`）及约定类型；SidebarRoot、行组件和树派生仍由 slot 注册封装在包内。
+
+## 模型体验
+
+无。侧边栏渲染浏览器会话列表；这里没有任何内容进入模型请求。
+
+#### KV Cache 影响
+
+无；该包（package）既不组装也不发送提供方请求。
+
+## 已知限制与暂缓事项
+
+- **Session 状态点渲染由 [ui-workspace](../ui-workspace/README.md) 持有**：没有可用的 done/error 通知数据源。
+- **分组只支持 Workspace**：Update 和 Status 不是可用策略。
+- **「New task completed」未读标记是本地查看状态**：完成时间 > 上次查看时间这一事实永远不会到达宿主。

package/lib/client.js

@@ -0,0 +1,278 @@
+window.__ModuleLoader__.load({
+	id: "@deepseek-ai/dsh-client-ui-sidebar",
+	factory: (require) => {
+		var module = { exports: {} };
+		var exports = module.exports;
+		Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+		let react_jsx_runtime = require("react/jsx-runtime");
+		let react = require("react");
+		let _deepseek_ai_dsh_client_ui_primitives = require("@deepseek-ai/dsh-client-ui-primitives");
+		//#region ../../../node_modules/.pnpm/clsx@2.1.1/node_modules/clsx/dist/clsx.mjs
+		function r(e) {
+			var t, f, n = "";
+			if ("string" == typeof e || "number" == typeof e) n += e;
+			else if ("object" == typeof e) if (Array.isArray(e)) {
+				var o = e.length;
+				for (t = 0; t < o; t++) e[t] && (f = r(e[t])) && (n && (n += " "), n += f);
+			} else for (f in e) e[f] && (n && (n += " "), n += f);
+			return n;
+		}
+		function clsx() {
+			for (var e, t, f = 0, n = "", o = arguments.length; f < o; f++) (e = arguments[f]) && (t = r(e)) && (n && (n += " "), n += t);
+			return n;
+		}
+		//#endregion
+		//#region \0dsh-css:/home/runner/work/deepseek-harness/deepseek-harness/packages/client/ui-sidebar/src/client/SidebarRoot.module.css.mjs
+		const css = ".hHd-Xa_root{--dsh-sidebar-inline-padding:12px;height:100%;padding:6px var(--dsh-sidebar-inline-padding);box-sizing:border-box;background:var(--dsw-specific-sidebar-fill);color:var(--dsw-alias-label-primary);--dsh-scrollbar-thumb:var(--dsw-alias-scrollbar-bg-l2);--dsh-scrollbar-thumb-hover:var(--dsw-alias-scrollbar-hover-l2);flex-direction:column;font-size:14px;display:flex}.hHd-Xa_root.hHd-Xa_collapsed{padding:18px 10px 6px}.hHd-Xa_root.hHd-Xa_quietBars{--dsh-scrollbar-thumb:transparent;--dsh-scrollbar-thumb-hover:transparent}.hHd-Xa_fading>*{opacity:0;transition:opacity .15s var(--ds-ease-in-out)}.hHd-Xa_wide{animation:hHd-Xa_wide-in .2s var(--ds-ease-in-out)}@keyframes hHd-Xa_wide-in{0%{opacity:0}}.hHd-Xa_railIn .hHd-Xa_iconButton,.hHd-Xa_railIn .hHd-Xa_newSession,.hHd-Xa_railIn .hHd-Xa_footArea{animation:hHd-Xa_rail-in .15s var(--ds-ease-in-out) .1s backwards}@keyframes hHd-Xa_rail-in{0%{opacity:0}}.hHd-Xa_logoRow{box-sizing:border-box;flex:none;justify-content:flex-end;align-items:center;gap:8px;height:60px;margin-bottom:16px;padding:8px 0 8px 4px;display:flex;overflow:hidden}.hHd-Xa_collapsed .hHd-Xa_logoRow{height:36px;margin-bottom:12px;padding:0}.hHd-Xa_brand{min-width:0;color:inherit;cursor:pointer;background:0 0;border:none;flex:1;align-items:center;padding:0;display:inline-flex;overflow:hidden}.hHd-Xa_iconButton{cursor:pointer;width:28px;height:28px;color:var(--dsw-alias-label-secondary);background:0 0;border:none;border-radius:50%;flex:none;justify-content:center;align-items:center;padding:0;display:inline-flex}.hHd-Xa_iconButton:hover{background:var(--dsw-alias-interactive-bg-hover)}.hHd-Xa_collapsed .hHd-Xa_iconButton{width:36px;height:36px}.hHd-Xa_collapsed .hHd-Xa_toggle .hHd-Xa_panelIcon{display:none}.hHd-Xa_collapsed .hHd-Xa_toggle:hover .hHd-Xa_panelIcon{display:inline}.hHd-Xa_collapsed .hHd-Xa_toggle:hover .hHd-Xa_railFish{display:none}.hHd-Xa_collapsed .hHd-Xa_iconButton{color:var(--dsw-alias-label-primary)}.hHd-Xa_newSession{box-sizing:border-box;border:1px solid var(--dsw-alias-border-l2);background:var(--dsw-alias-button-elevated-fill);height:38px;color:var(--dsw-alias-label-primary);cursor:pointer;border-radius:24px;flex:none;justify-content:center;align-items:center;gap:6px;margin:0 2px 20px;padding:8px 16px;font-size:14px;font-weight:500;line-height:22px;display:flex;overflow:hidden}.hHd-Xa_newSession:hover{background:var(--dsw-alias-button-floating-hover)}.hHd-Xa_collapsed .hHd-Xa_newSession{background:0 0;border-color:#0000;gap:0;height:36px;margin:0 0 12px;padding:0}.hHd-Xa_collapsed .hHd-Xa_newSession:hover{background:var(--dsw-alias-interactive-bg-hover)}.hHd-Xa_newSessionLabel{white-space:nowrap;max-width:200px;overflow:hidden}.hHd-Xa_collapsed .hHd-Xa_newSessionLabel{max-width:0}.hHd-Xa_regionArea{min-height:0;margin-right:calc(-1 * var(--dsh-sidebar-inline-padding));flex-direction:column;flex:1;display:flex;overflow:hidden}.hHd-Xa_collapsed .hHd-Xa_regionArea{margin-right:0}.hHd-Xa_footArea{flex:none}@media (prefers-reduced-motion:reduce){.hHd-Xa_wide,.hHd-Xa_fading>*,.hHd-Xa_railIn .hHd-Xa_iconButton,.hHd-Xa_railIn .hHd-Xa_newSession,.hHd-Xa_railIn .hHd-Xa_footArea{transition:none;animation:none}}";
+		const tagId = "@deepseek-ai/dsh-client-ui-sidebar/SidebarRoot.module.css";
+		if (typeof document !== "undefined" && document.querySelector("style[data-plugin-css=" + JSON.stringify(tagId) + "]") === null) {
+			const tag = document.createElement("style");
+			tag.dataset.plugin = "@deepseek-ai/dsh-client-ui-sidebar";
+			tag.dataset.pluginCss = tagId;
+			tag.textContent = css;
+			document.head.appendChild(tag);
+		}
+		var SidebarRoot_module_css_default = {
+			"collapsed": "hHd-Xa_collapsed",
+			"newSession": "hHd-Xa_newSession",
+			"toggle": "hHd-Xa_toggle",
+			"quietBars": "hHd-Xa_quietBars",
+			"iconButton": "hHd-Xa_iconButton",
+			"footArea": "hHd-Xa_footArea",
+			"brand": "hHd-Xa_brand",
+			"root": "hHd-Xa_root",
+			"wide-in": "hHd-Xa_wide-in",
+			"rail-in": "hHd-Xa_rail-in",
+			"railFish": "hHd-Xa_railFish",
+			"newSessionLabel": "hHd-Xa_newSessionLabel",
+			"railIn": "hHd-Xa_railIn",
+			"regionArea": "hHd-Xa_regionArea",
+			"panelIcon": "hHd-Xa_panelIcon",
+			"fading": "hHd-Xa_fading",
+			"logoRow": "hHd-Xa_logoRow",
+			"wide": "hHd-Xa_wide"
+		};
+		//#endregion
+		//#region lib/types/client/SidebarRoot.js
+		/**
+		* Sidebar shell: column geometry only. Collapse is a slide plus crossfade:
+		* content freezes at its expanded width (inline style) and fades out in place
+		* while the sliding column (AppFrame grid tracks) clips it — nothing reflows
+		* mid-slide. At settle the wide-only content unmounts and the control rows
+		* snap to the 56px rail (one icon each, same top-down order) fading in as the
+		* slide ends. The workspace/session browsing region between the New Session
+		* button and the foot is the `sidebar.workspaces` registrant's, and the foot
+		* is the `sidebar.settings` registrant's; the shell hands them the wide flag
+		* (plus an expand request callback for the browser).
+		*
+		* The column also owns whether the scroll regions nested in it draw a
+		* scrollbar at all: the shell tracks the pointer and rebinds ui-theme's
+		* scrollbar indirection away while it is elsewhere, so a list the user is not
+		* pointing at carries no bar.
+		*/
+		/** Wide-content unmount delay; matches the 150ms wide-content fade-out. */
+		const COLLAPSE_SETTLE_MS = 150;
+		/**
+		* How long the column's scrollbars stay drawn after the pointer leaves it.
+		* The bar is a pointer affordance here, and hiding it on the leave event
+		* itself makes it blink out while the pointer is only crossing the column's
+		* edge — on the way to the conversation, or around a portalled menu.
+		*/
+		const SCROLLBAR_LINGER_MS = 2e3;
+		/**
+		* Render the sidebar column shell.
+		* @param props - composed slot props (runtime share + injected callbacks, contract/slots.ts).
+		* @returns the sidebar element tree.
+		*/
+		function SidebarRoot({ collapsed, width, startSession, toggleSidebar, t, renderSlot }) {
+			const [settled, setSettled] = (0, react.useState)(collapsed);
+			(0, react.useEffect)(() => {
+				if (!collapsed) {
+					setSettled(false);
+					return;
+				}
+				const timer = window.setTimeout(() => {
+					setSettled(true);
+				}, COLLAPSE_SETTLE_MS);
+				return () => {
+					window.clearTimeout(timer);
+				};
+			}, [collapsed]);
+			const wide = !collapsed || !settled;
+			const lastWideWidth = (0, react.useRef)(width);
+			if (!collapsed) lastWideWidth.current = width;
+			const everWide = (0, react.useRef)(!collapsed);
+			if (!collapsed) everWide.current = true;
+			const column = (0, react.useRef)(null);
+			const [pointerInside, setPointerInside] = (0, react.useState)(false);
+			const lingerTimer = (0, react.useRef)(void 0);
+			const armLinger = () => {
+				if (lingerTimer.current !== void 0) return;
+				lingerTimer.current = window.setTimeout(() => {
+					lingerTimer.current = void 0;
+					setPointerInside(false);
+				}, SCROLLBAR_LINGER_MS);
+			};
+			const cancelLinger = () => {
+				window.clearTimeout(lingerTimer.current);
+				lingerTimer.current = void 0;
+			};
+			(0, react.useEffect)(() => {
+				if (!pointerInside) return;
+				const onMove = (event) => {
+					const rect = column.current?.getBoundingClientRect();
+					/* v8 ignore next -- the listener only exists while the column is mounted and revealed. */
+					if (rect === void 0) return;
+					if (event.clientX >= rect.left && event.clientX < rect.right && event.clientY >= rect.top && event.clientY < rect.bottom) cancelLinger();
+					else armLinger();
+				};
+				document.addEventListener("pointermove", onMove);
+				return () => {
+					document.removeEventListener("pointermove", onMove);
+					cancelLinger();
+				};
+			}, [pointerInside]);
+			return (0, react_jsx_runtime.jsxs)("div", {
+				ref: column,
+				className: clsx(SidebarRoot_module_css_default.root, !wide && SidebarRoot_module_css_default.collapsed, !wide && everWide.current && SidebarRoot_module_css_default.railIn, collapsed && wide && SidebarRoot_module_css_default.fading, !pointerInside && SidebarRoot_module_css_default.quietBars),
+				style: wide ? { width: collapsed ? lastWideWidth.current : width } : void 0,
+				onPointerEnter: () => {
+					cancelLinger();
+					setPointerInside(true);
+				},
+				onPointerLeave: () => {
+					armLinger();
+				},
+				children: [
+					(0, react_jsx_runtime.jsxs)("div", {
+						className: SidebarRoot_module_css_default.logoRow,
+						children: [wide && (0, react_jsx_runtime.jsx)("button", {
+							type: "button",
+							className: clsx(SidebarRoot_module_css_default.brand, SidebarRoot_module_css_default.wide),
+							"aria-label": t("session.new.label"),
+							onClick: () => {
+								startSession();
+							},
+							children: (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.BrandWordmark, {})
+						}), (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.Tooltip, {
+							label: collapsed ? t("toggle.open") : t("toggle.collapse"),
+							delayMs: 500,
+							children: (0, react_jsx_runtime.jsxs)("button", {
+								type: "button",
+								className: clsx(SidebarRoot_module_css_default.iconButton, SidebarRoot_module_css_default.toggle),
+								"aria-label": collapsed ? t("toggle.open") : t("toggle.collapse"),
+								onClick: () => {
+									toggleSidebar();
+								},
+								children: [!wide && (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.FishLogo, {
+									className: SidebarRoot_module_css_default.railFish,
+									size: 24
+								}), (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.IconPanelLeftOutline16, {
+									className: SidebarRoot_module_css_default.panelIcon,
+									size: wide ? 16 : 18
+								})]
+							})
+						})]
+					}),
+					(0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.Tooltip, {
+						label: t("session.new.label"),
+						delayMs: 500,
+						disabled: wide,
+						children: (0, react_jsx_runtime.jsxs)("button", {
+							type: "button",
+							className: SidebarRoot_module_css_default.newSession,
+							"aria-label": t("session.new.label"),
+							onClick: () => {
+								startSession();
+							},
+							children: [(0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.IconNewChatOutline16, { size: wide ? 14 : 18 }), wide && (0, react_jsx_runtime.jsx)("span", {
+								className: clsx(SidebarRoot_module_css_default.newSessionLabel, SidebarRoot_module_css_default.wide),
+								children: t("session.new")
+							})]
+						})
+					}),
+					(0, react_jsx_runtime.jsx)("div", {
+						className: SidebarRoot_module_css_default.regionArea,
+						children: renderSlot("sidebar.workspaces", {
+							wide,
+							expandSidebar: () => {
+								if (collapsed) toggleSidebar();
+							}
+						})
+					}),
+					(0, react_jsx_runtime.jsx)("div", {
+						className: SidebarRoot_module_css_default.footArea,
+						children: renderSlot("sidebar.settings", { wide })
+					})
+				]
+			});
+		}
+		//#endregion
+		//#region lib/types/client/locales.js
+		/** `sidebar` namespace dictionaries: shell controls (brand row, New Session, fold toggle). */
+		/** Simplified Chinese dictionary (the key-set source of truth). */
+		const zh = {
+			"session.new": "新会话",
+			"session.new.label": "新建会话",
+			"toggle.open": "打开侧边栏",
+			"toggle.collapse": "收起侧边栏"
+		};
+		/** English dictionary, checked complete against the zh key set. */
+		const en = {
+			"session.new": "New Session",
+			"session.new.label": "New session",
+			"toggle.open": "Open sidebar",
+			"toggle.collapse": "Collapse sidebar"
+		};
+		//#endregion
+		//#region lib/types/client/index.js
+		/** Dictionary namespace owned by this plugin (shell controls copy). */
+		const NS = "sidebar";
+		/** Services required by the sidebar plugin. */
+		const inject = [
+			"slots",
+			"layout",
+			"sessions",
+			"workspaces",
+			"locale"
+		];
+		/** Registers the sidebar shell and its service callbacks.
+		* @param ctx - Client root context.
+		*/
+		function apply(ctx) {
+			ctx.effect(() => ctx.locale.register(NS, {
+				zh,
+				en
+			}), "ui-sidebar: dictionaries");
+			const injectProps = () => ({
+				startSession: (workspaceId) => {
+					ctx.workspaces.startSession(workspaceId);
+				},
+				toggleSidebar: () => {
+					ctx.layout.toggleSidebar();
+				}
+			});
+			ctx.effect(() => ctx.slots.register({
+				name: "sidebar",
+				locale: NS,
+				children: {
+					"sidebar.workspaces": {
+						kind: "single",
+						scope: "root"
+					},
+					"sidebar.settings": {
+						kind: "single",
+						scope: "root"
+					}
+				},
+				inject: injectProps
+			}, SidebarRoot), "ui-sidebar: slot registration");
+		}
+		//#endregion
+		exports.apply = apply;
+		exports.inject = inject;
+		return module.exports;
+	}
+});
+
+//# sourceMappingURL=client.js.map

package/lib/index.js

@@ -0,0 +1,6 @@
+//#region lib/types/index.js
+/** Host loader entry for the browser-only sidebar plugin. */
+/** Provides no host-side behavior. */
+function apply() {}
+//#endregion
+export { apply };

package/lib/invariant.js

@@ -0,0 +1,25 @@
+//#region lib/types/invariant.js
+/**
+* Package-owned invariant companion for `@deepseek-ai/dsh-client-ui-sidebar`.
+* @module @deepseek-ai/dsh-client-ui-sidebar/invariant
+*/
+const PACKAGE_NAME = "@deepseek-ai/dsh-client-ui-sidebar";
+/** Cordis companion plugin name. */
+const name = "client-ui-sidebar-invariant";
+/** Service required before the companion can reserve package ownership. */
+const inject = ["invariants"];
+/**
+* No runtime invariant: a pure-consumer plugin deriving its rows in-component
+* from the standard useSessions delivery — it emits no cordis events and owns
+* no cross-plugin mutable state; derivation and interaction behavior are
+* asserted directly by this package's tree/component specs.
+*/
+const install = () => {};
+/**
+* Register this package's invariant companion.
+* @param ctx - Cordis context carrying the invariant service.
+* @returns the installed registration's disposer after setup succeeds.
+*/
+const apply = (ctx) => Promise.resolve(ctx.invariants.register(PACKAGE_NAME, install));
+//#endregion
+export { apply, inject, name };

package/lib/types/client/SidebarRoot.d.ts

@@ -0,0 +1,8 @@
+import type { SidebarRootComponentProps } from './contract/slots.ts';
+/**
+ * Render the sidebar column shell.
+ * @param props - composed slot props (runtime share + injected callbacks, contract/slots.ts).
+ * @returns the sidebar element tree.
+ */
+export declare function SidebarRoot({ collapsed, width, startSession, toggleSidebar, t, renderSlot, }: SidebarRootComponentProps): import("react").JSX.Element;
+//# sourceMappingURL=SidebarRoot.d.ts.map

package/lib/types/client/contract/slots.d.ts

@@ -0,0 +1,75 @@
+/**
+ * Sidebar slot contract: the registrant-side props composition for the
+ * layout-owned `sidebar` slot, plus the holes this shell declares. The shell
+ * owns column geometry (fold state machine, brand row, New Session);
+ * everything between the section header and the list bottom is the
+ * `sidebar.workspaces` registrant's (ui-workspace), and the foot is the
+ * `sidebar.settings` registrant's (ui-settings).
+ */
+import type { PropsLocale, PropsRenderSlots, PropsRuntime } from '@deepseek-ai/dsh-client-ui-slots';
+import type { WorkspaceId } from '@deepseek-ai/dsh-client-runtime/client';
+declare module '@deepseek-ai/dsh-client-ui-slots' {
+    interface SlotMap {
+        /**
+         * The workspace/session browsing region: section header, search, the
+         * grouped/flat session list, and every workspace dialog. Declared by this
+         * package's 'sidebar' entry (declaring is claiming); ui-workspace
+         * registers the browser.
+         */
+        'sidebar.workspaces': {
+            kind: 'single';
+            scope: 'root';
+            owner: SidebarSectionOwnerProps;
+        };
+        /**
+         * The settings seat at the sidebar foot. Declared by this package's
+         * 'sidebar' entry; ui-settings registers its trigger row + modal panel.
+         * The sidebar passes only its column state — it holds no settings state.
+         */
+        'sidebar.settings': {
+            kind: 'single';
+            scope: 'root';
+            owner: SidebarSettingsOwnerProps;
+        };
+    }
+}
+/**
+ * Owner share of the browser hole — the only facts crossing the shell/region
+ * boundary. Business data and actions arrive through the region's own inject.
+ */
+export interface SidebarSectionOwnerProps {
+    /** Shell fold-state output: wide renders the full browser, rail the icon column. */
+    wide: boolean;
+    /** Rail icons request expansion; the browser rides the wide flip for focus. */
+    expandSidebar: () => void;
+}
+/**
+ * Owner share of the sidebar settings seat: the column display state the
+ * occupant's trigger row must render against (wide row vs rail icon).
+ */
+export interface SidebarSettingsOwnerProps {
+    /** Whether the sidebar renders wide content (false = 56px rail). */
+    wide: boolean;
+}
+/**
+ * Registrant-private injected share (arrives via the register inject
+ * factory). The shell keeps only its own controls: starting a Session from
+ * the New Session button and toggling the column.
+ */
+export type SidebarRootInjected = {
+    /**
+     * Start a New Session: with a workspace, reuse-or-create its blank session
+     * and open it; without one, clear the selection into the New Session pure
+     * view state (the conversation.empty seat).
+     */
+    startSession: (workspaceId?: WorkspaceId) => void;
+    /** Toggle the sidebar column through the layout service. */
+    toggleSidebar: () => void;
+};
+/**
+ * Full component props: layout owner state/actions plus the declared holes'
+ * render shares, this package's injected callbacks, and the standard locale
+ * seat. No store is registered.
+ */
+export type SidebarRootComponentProps = PropsRuntime<'sidebar'> & PropsRenderSlots<'sidebar.workspaces' | 'sidebar.settings'> & SidebarRootInjected & PropsLocale<'sidebar'>;
+//# sourceMappingURL=slots.d.ts.map

package/lib/types/client/index.d.ts

@@ -0,0 +1,18 @@
+/** Registers the sidebar shell into the layout-owned slot. */
+import type { ClientContext } from '@deepseek-ai/dsh-client-runtime/client';
+import { type SidebarKey } from './locales.ts';
+export type { SidebarRootComponentProps, SidebarRootInjected, SidebarSectionOwnerProps, SidebarSettingsOwnerProps } from './contract/slots.ts';
+export type { SidebarKey } from './locales.ts';
+declare module '@deepseek-ai/dsh-client-ui-slots' {
+    interface LocaleNamespaceMap {
+        /** Sidebar shell controls copy. */
+        sidebar: SidebarKey;
+    }
+}
+/** Services required by the sidebar plugin. */
+export declare const inject: string[];
+/** Registers the sidebar shell and its service callbacks.
+ * @param ctx - Client root context.
+ */
+export declare function apply(ctx: ClientContext): void;
+//# sourceMappingURL=index.d.ts.map

package/lib/types/client/locales.d.ts

@@ -0,0 +1,18 @@
+/** `sidebar` namespace dictionaries: shell controls (brand row, New Session, fold toggle). */
+/** Simplified Chinese dictionary (the key-set source of truth). */
+export declare const zh: {
+    'session.new': string;
+    'session.new.label': string;
+    'toggle.open': string;
+    'toggle.collapse': string;
+};
+/** The sidebar namespace key union. */
+export type SidebarKey = keyof typeof zh;
+/** English dictionary, checked complete against the zh key set. */
+export declare const en: {
+    'session.new': string;
+    'session.new.label': string;
+    'toggle.open': string;
+    'toggle.collapse': string;
+};
+//# sourceMappingURL=locales.d.ts.map

package/lib/types/index.d.ts

@@ -0,0 +1,4 @@
+/** Host loader entry for the browser-only sidebar plugin. */
+/** Provides no host-side behavior. */
+export declare function apply(): void;
+//# sourceMappingURL=index.d.ts.map

package/lib/types/invariant.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Package-owned invariant companion for `@deepseek-ai/dsh-client-ui-sidebar`.
+ * @module @deepseek-ai/dsh-client-ui-sidebar/invariant
+ */
+import type { Context } from '@deepseek-ai/cordis';
+/** Cordis companion plugin name. */
+export declare const name = "client-ui-sidebar-invariant";
+/** Service required before the companion can reserve package ownership. */
+export declare const inject: string[];
+/**
+ * Register this package's invariant companion.
+ * @param ctx - Cordis context carrying the invariant service.
+ * @returns the installed registration's disposer after setup succeeds.
+ */
+export declare const apply: (ctx: Context) => Promise<() => void>;
+//# sourceMappingURL=invariant.d.ts.map

package/package.json

@@ -0,0 +1,77 @@
+{
+  "name": "@deepseek-ai/dsh-client-ui-sidebar",
+  "description": "Sidebar plugin: session multi-level tree, search, grouping, state dots",
+  "version": "0.0.1-rc.1",
+  "publishConfig": {
+    "access": "restricted"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/deepseek-ai/deepseek-harness.git",
+    "directory": "packages/client/ui-sidebar"
+  },
+  "type": "module",
+  "main": "lib/index.js",
+  "types": "lib/types/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./lib/types/index.d.ts",
+      "default": "./lib/index.js"
+    },
+    "./invariant": {
+      "types": "./lib/types/invariant.d.ts",
+      "default": "./lib/invariant.js"
+    },
+    "./client": {
+      "types": "./lib/types/client/index.d.ts",
+      "default": "./lib/client.js"
+    },
+    "./src/*": "./src/*",
+    "./package.json": "./package.json"
+  },
+  "dsh": {
+    "client": {
+      "inject": [
+        "@deepseek-ai/dsh-client-runtime",
+        "@deepseek-ai/dsh-client-ui-layout",
+        "@deepseek-ai/dsh-client-locale"
+      ],
+      "platform": "web"
+    }
+  },
+  "license": "BSD-3-Clause",
+  "dependencies": {
+    "clsx": "^2.0.0"
+  },
+  "peerDependencies": {
+    "react": "^18.2.0",
+    "@deepseek-ai/dsh-client-locale": "^0.0.1-rc.1",
+    "@deepseek-ai/dsh-client-runtime": "^0.0.1-rc.1",
+    "@deepseek-ai/dsh-client-ui-primitives": "^0.0.1-rc.1",
+    "@deepseek-ai/dsh-invariants": "^0.0.1-rc.1",
+    "@deepseek-ai/cordis": "^4.0.1-rc.1",
+    "@deepseek-ai/dsh-client-ui-slots": "^0.0.1-rc.1"
+  },
+  "devDependencies": {
+    "@types/react": "~18.3.1",
+    "react": "^18.2.0",
+    "@deepseek-ai/dsh-client-locale": "^0.0.1-rc.1",
+    "@deepseek-ai/dsh-client-runtime": "^0.0.1-rc.1",
+    "@deepseek-ai/dsh-client-test-runtime": "^0.0.1-rc.1",
+    "@deepseek-ai/dsh-client-ui-primitives": "^0.0.1-rc.1",
+    "@deepseek-ai/dsh-client-ui-layout": "^0.0.1-rc.1",
+    "@deepseek-ai/dsh-client-ui-slots": "^0.0.1-rc.1",
+    "@deepseek-ai/cordis": "^4.0.1-rc.1",
+    "@deepseek-ai/dsh-invariants": "^0.0.1-rc.1"
+  },
+  "files": [
+    "lib/index.js",
+    "lib/invariant.js",
+    "lib/client.js",
+    "lib/types/**/*.d.ts"
+  ],
+  "scripts": {
+    "bundle": "tsdown",
+    "watch": "tsdown --watch"
+  }
+}