@deepseek-ai/dsh-client-ui-workspace 0.1.7-rc.2 → 0.2.0-rc.1

package/README.i18n.yaml

@@ -6,8 +6,8 @@
   en: 7c0f613105d4008a
   zh: c36c0cdff7e77576
 /deepseek-ai-dsh-client-ui-workspace:
-  en: c611184cd49f130f
-  zh: caddcda48dc30f11
+  en: b286adf3aca51710
+  zh: 6122f6e7c8015197
 /deepseek-ai-dsh-client-ui-workspace/summary:
   en: 1a76ace6a18e3ab5
   zh: b274d1e98e133851
@@ -15,8 +15,8 @@
   en: d152484eb41ac6b4
   zh: 09388d293f9be9cb
 /deepseek-ai-dsh-client-ui-workspace/use-this-package:
-  en: c8d579e1e65bc8c5
-  zh: 56f8e45351445ec7
+  en: b164014ee565be16
+  zh: 6a741647932b93e6
 /deepseek-ai-dsh-client-ui-workspace/use-this-package/reordering-and-view-options:
   en: 1fe0693758e0536b
   zh: ef30198bc767fc04

package/README.md

@@ -7,6 +7,8 @@ kind: "package-reference"
 
 English | [中文](README.zh.md)
 
+Desktop product events use the optional [product analytics service](../product-analytics/README.md); ordinary Web interactions are excluded.
+
 ## Summary
 
 This package lets users browse grouped or flat Session lists, choose a Workspace for a new Session, and manage Workspaces and Sessions through add, rename, reorder, search, fork, archive, and Workspace deletion; the Session row menu and its hover buttons are slot lists that client plugins extend. Pending interactions appear as warning dots, and subagent-origin Sessions remain hidden. An idle, unarchived Session row with active scheduled tasks shows a clock mark, and its hover card lists those tasks. Canonically distinct folder paths remain separate Workspaces. Adding a Workspace requires a composed directory picker; without one, adding is unavailable.
@@ -27,6 +29,8 @@ This package lets users browse grouped or flat Session lists, choose a Workspace
 
 Use the sidebar to browse Workspaces and their Sessions, reorder them, and start new ones; use the picker in the Session Intent hero to choose a Workspace for a new session. An open Workspace shows five idle, non-blank Sessions by default. Running Sessions, including parents with running children, remain visible in their ordered positions without using that quota; the selected blank **New Session** is also an extra row until its first prompt. Each **Show more** click reveals up to five more idle Sessions; after the final batch, **Show less** restores the initial rows while keeping running Sessions visible. Closing and reopening the Workspace also restores this folded projection.
 
+History rows without a stored title use the localized unnamed label (未命名 / Untitled), rather than a directory name. The current blank row remains New Session; other blank rows remain hidden. Rename drafts use the stored title, or start empty when unnamed; unnamed rows do not offer title copying.
+
 ### Reordering and view options
 
 Pinned Sessions lead ordinary Sessions in both grouped and flat views. **Last updated** sorts each partition strictly by the latest user prompt or steer time, newest first; pin time does not affect it. **Manual** uses the relative positions in one complete Session sequence, including hidden archives. Returning to Last updated discards the manual layout, and entering Manual again freezes the then-current chronological order. The browser defaults to Last updated and remembers the selected mode across reloads.

package/README.zh.md

@@ -7,6 +7,8 @@ kind: "package-reference"
 
 [English](README.md) | 中文
 
+桌面端产品事件使用可选的[产品埋点服务](../product-analytics/README.zh.md)，不包含普通 Web 交互。
+
 ## 概述
 
 本包让用户浏览分组或扁平的 Session 列表、为新 Session 选择 Workspace，并通过添加、重命名、重排序、搜索、fork、归档和删除 Workspace 来管理 Workspace 与 Session；Session 行菜单及其悬停按钮是可由客户端插件扩展的 slot 列表。待处理交互显示为警告点，subagent 来源的 Session 则保持隐藏。处于空闲状态且未归档、其 Session 有活动定时任务的 Session 行会显示时钟标记，其悬浮卡片会列出这些任务。规范化后仍有差异的文件夹路径会保留为独立 Workspace。添加 Workspace 需要组合目录选择器；没有目录选择器时，添加操作不可用。
@@ -27,6 +29,8 @@ kind: "package-reference"
 
 用侧边栏浏览 Workspace 及其 Session、重排它们并新建会话；在 Session Intent 主视觉区用选择器为新会话选择 Workspace。打开的 Workspace 默认显示五条空闲的非空白 Session。正在运行的 Session（包括有子会话正在运行的父会话）始终按原顺序显示，不占用这五条配额；当前选中的空白**新会话**在首条提示词落地前也作为额外行。每次点击**展开其余**最多再显示五条空闲 Session；全部显示后，**收起**恢复初始行数，但仍显示正在运行的 Session。关闭再打开 Workspace 也会恢复该折叠投影。
 
+未保存标题的历史会话显示本地化名称「未命名 / Untitled」，不使用目录名兜底。当前空会话仍显示「新会话」，其他空会话仍隐藏。重命名草稿使用已保存标题，无标题时留空；无标题行不提供标题复制。
+
 ### 重排序与视图选项
 
 分组和平铺视图都先显示置顶 Session，再显示普通 Session。**最近更新**在各分区内严格按最近一次用户提示词或 steering（中途引导）时间降序排列，置顶时间不影响它。**手动排序**使用同一条完整 Session 序列中的相对位置，包括隐藏的归档项。返回最近更新会丢弃手动布局，再次进入手动排序时冻结当时的时间顺序。浏览器默认采用最近更新，并在重新加载后记住所选模式。

package/lib/client.js

@@ -164,7 +164,7 @@ window.__ModuleLoader__.load({
 				} : {
 					status: "handled",
 					run: () => {
-						controls.rename(target.id, target.displayTitle);
+						controls.rename(target.id, target.title?.trim() ?? "");
 					}
 				};
 			});
@@ -384,10 +384,11 @@ window.__ModuleLoader__.load({
 		/**
 		* A blank session is the selected Workspace's provisional New Session row;
 		* its canonical title never enters search (blank rows are query-excluded)
-		* and the renderer localizes its display label.
+		* and the renderer localizes its display label. Unnamed history also yields an
+		* empty title for localization and does not match a directory-name title search.
 		*/
 		function sessionTitle(session) {
-			return session.blank ? "" : session.displayTitle;
+			return session.blank ? "" : session.title?.trim() ?? "";
 		}
 		/** Build one group without projecting session lineage into presentation. */
 		function buildGroup(key, workspaceId, cwd, createdAt, label, members) {
@@ -834,10 +835,11 @@ window.__ModuleLoader__.load({
 				if (navigation.aborted) return;
 				this.replaceMain(sessionId, navigation, "reveal", beforeOpen);
 			}
-			async forkSession(sessionId) {
-				await this.sessions.fork({
+			async forkSession(sessionId, onCreated) {
+				return this.sessions.fork({
 					sessionId,
-					increaseTitle: true
+					increaseTitle: true,
+					...onCreated === void 0 ? {} : { onCreated }
 				});
 			}
 			startSession(workspaceId) {
@@ -1117,7 +1119,7 @@ window.__ModuleLoader__.load({
 		*/
 		/** Row display title: blank rows show the localized New Session label. */
 		function displayTitle(node, t) {
-			return node.blank ? t("session.new") : node.title;
+			return node.blank ? t("session.new") : node.title || t("session.untitled");
 		}
 		const MIN_TITLE_REVEAL_PX = 8;
 		const TITLE_MARQUEE_PX_PER_MS = .03;
@@ -1511,7 +1513,7 @@ window.__ModuleLoader__.load({
 						}),
 						(0, react_jsx_runtime.jsx)("span", {
 							className: Rows_module_css_default.searchResultTitle,
-							children: result.title
+							children: result.title || t("session.untitled")
 						}),
 						result.archived && (0, react_jsx_runtime.jsx)("span", {
 							className: Rows_module_css_default.rowActions,
@@ -1674,7 +1676,7 @@ window.__ModuleLoader__.load({
 				}),
 				openDelayMs: 800,
 				disabled: menuOpen || drag?.active === true,
-				copyText: row.blank ? void 0 : row.title,
+				copyText: row.blank || row.title === "" ? void 0 : row.title,
 				copyLabel: t("copy"),
 				copiedLabel: t("hover.copied")
 			});
@@ -3696,7 +3698,7 @@ window.__ModuleLoader__.load({
 		* one dialog per request (keyed by the Session, so a new request starts a
 		* fresh draft). Sessions have no client-side name-conflict rule (the host
 		* normalizes), and unlike Workspace rename an unchanged title is NOT
-		* blocked: confirming the current automatic title is the gesture that pins it.
+		* blocked. An unnamed Session starts with an empty draft and requires a name.
 		* @param props - the request hook, its settlement, the rename hop, and the locale seat.
 		* @returns the open dialog, or null.
 		*/
@@ -3865,6 +3867,7 @@ window.__ModuleLoader__.load({
 			"defaultWorkspace.failed": "无法创建默认工作区，请通过“选择工作区”选择文件夹",
 			"group.ungrouped": "未分组",
 			"session.new": "新会话",
+			"session.untitled": "未命名",
 			"shortcut.noSession": "请先选择一个会话",
 			"shortcut.noPicker": "目录选择器不可用",
 			"shortcut.directoryBusy": "正在选择或添加工作区",
@@ -3979,6 +3982,7 @@ window.__ModuleLoader__.load({
 			"defaultWorkspace.failed": "Unable to create default workspace. Use Choose workspace to select a folder.",
 			"group.ungrouped": "Ungrouped",
 			"session.new": "New Session",
+			"session.untitled": "Untitled",
 			"shortcut.noSession": "Select a session first",
 			"shortcut.noPicker": "Directory picker unavailable",
 			"shortcut.directoryBusy": "Selecting or adding a workspace",
@@ -4227,7 +4231,13 @@ window.__ModuleLoader__.load({
 				}
 			});
 			const forkInjected = () => ({ forkSession: (sessionId) => {
-				uiWorkspace.forkSession(sessionId).catch(() => {});
+				uiWorkspace.forkSession(sessionId, (childId) => {
+					ctx.get("productAnalytics")?.track("branch_session_click", {
+						session_id: childId,
+						parent_session_id: sessionId,
+						click_position: "sidebar"
+					});
+				}).catch(() => {});
 			} });
 			const renameInjected = () => ({ requestSessionRename });
 			const renameDialogInjected = () => ({

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

@@ -67,7 +67,7 @@ export interface DirectoryFlowOwnerProps {
 export interface SessionRowOwnerProps {
     /** Session the row shows. */
     sessionId: SessionId;
-    /** Row display title: persisted title, project basename, or Session id. */
+    /** Row display title: persisted title, or empty when the Session has none. */
     displayTitle: string;
 }
 /** The row menu's open state as its owner holds it: the `useState` pair. */

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

@@ -1,20 +1,3 @@
-/**
- * Workspace plugin, browser half. Two registrations: WorkspaceBrowser fills
- * the sidebar shell's `sidebar.workspaces` hole (the whole browsing region),
- * and WorkspacePicker fills the conversation hero's picker hole
- * (`conversation.hero.workspace` — both hero forms). Both read real Host
- * Workspaces through the global useWorkspaces hook, and each declares its
- * own `single` directory-flow child hole for the composed picker package's
- * client half. WorkspaceBrowser additionally declares the two Session row
- * action lists, and this apply registers the shipped actions — pin, rename,
- * fork, archive — into them the way any client plugin would, each with its
- * own behavior, plus the rename dialog and the row-action notice into
- * `shell.overlay` (see the contract module doc). It also declares two
- * Session-row seats: the leading decoration a row renders only while its own
- * primary state is idle, and the section the row's hover card renders between
- * its relative time and its trailing status line. Export discipline:
- * packages/client/AGENTS.md.
- */
 import type { Context } from '@deepseek-ai/cordis';
 import type { WorkspaceSnapshot } from '@deepseek-ai/dsh-api-workspace-controller/client';
 import type { SnapshotSelectorHook } from '@deepseek-ai/dsh-client-ui-slots';

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

@@ -8,6 +8,7 @@ export declare const zh: {
     'defaultWorkspace.failed': string;
     'group.ungrouped': string;
     'session.new': string;
+    'session.untitled': string;
     'shortcut.noSession': string;
     'shortcut.noPicker': string;
     'shortcut.directoryBusy': string;
@@ -124,6 +125,7 @@ export declare const en: {
     'defaultWorkspace.failed': string;
     'group.ungrouped': string;
     'session.new': string;
+    'session.untitled': string;
     'shortcut.noSession': string;
     'shortcut.noPicker': string;
     'shortcut.directoryBusy': string;

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

@@ -26,9 +26,10 @@ export interface UiWorkspace {
     /**
      * Fork a Session without changing the current selection.
      * @param sessionId - source Session.
-     * @returns completion after child creation and inherited-title increment.
+     * @param onCreated - observer before the optional child-title update.
+     * @returns the child SessionId after creation and inherited-title increment.
      */
-    forkSession(sessionId: SessionId): Promise<void>;
+    forkSession(sessionId: SessionId, onCreated?: (childId: SessionId) => void): Promise<SessionId>;
     /**
      * Resolve the reusable or newly created blank Session for a Workspace.
      * @param workspaceId - target Workspace.
@@ -125,7 +126,7 @@ declare class UiWorkspaceService extends Service implements UiWorkspace {
     private reuseBlank;
     openSession(target: SessionTarget): void;
     openWorkspace(workspaceId: WorkspaceId, beforeOpen?: (sessionId: SessionId) => void): Promise<void>;
-    forkSession(sessionId: SessionId): Promise<void>;
+    forkSession(sessionId: SessionId, onCreated?: (childId: SessionId) => void): Promise<SessionId>;
     startSession(workspaceId?: WorkspaceId): void;
     archiveSession(sessionId: SessionId, options?: {
         readonly stopActivity?: boolean;

package/lib/types/client/session-actions/RenameSession.d.ts

@@ -10,7 +10,7 @@ export declare function RenameSessionMenuItem({ sessionId, displayTitle, useMenu
  * one dialog per request (keyed by the Session, so a new request starts a
  * fresh draft). Sessions have no client-side name-conflict rule (the host
  * normalizes), and unlike Workspace rename an unchanged title is NOT
- * blocked: confirming the current automatic title is the gesture that pins it.
+ * blocked. An unnamed Session starts with an empty draft and requires a name.
  * @param props - the request hook, its settlement, the rename hop, and the locale seat.
  * @returns the open dialog, or null.
  */

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

@@ -22,7 +22,7 @@ type SessionStatuses = SessionStatusSnapshot;
 /** One top-level session row in a group or the flat list. */
 export interface SessionNode {
     id: SessionId;
-    /** Stored display title; the renderer substitutes the localized New Session label for blank rows. */
+    /** Stored title, or empty; the renderer localizes blank and unnamed row labels. */
     title: string;
     /** The provisional blank session (renderer shows the localized New Session title). */
     blank: boolean;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@deepseek-ai/dsh-client-ui-workspace",
   "description": "Workspace picker plugin: one WorkspacePicker registered into the sidebar and empty-state workspace slots",
-  "version": "0.1.7-rc.2",
+  "version": "0.2.0-rc.1",
   "publishConfig": {
     "access": "public"
   },
@@ -51,30 +51,31 @@
     "@types/react": "~18.3.1",
     "clsx": "^2.0.0",
     "react": "^18.2.0",
+    "@deepseek-ai/dsh-api-remotes": "0.2.0-rc.1",
+    "@deepseek-ai/dsh-agent": "0.2.0-rc.1",
+    "@deepseek-ai/dsh-api-session-controller": "0.2.0-rc.1",
+    "@deepseek-ai/dsh-api-workspace-controller": "0.2.0-rc.1",
     "@deepseek-ai/cordis": "~4.0.4",
-    "@deepseek-ai/dsh-api-remotes": "0.1.7-rc.2",
-    "@deepseek-ai/dsh-agent": "0.1.7-rc.2",
-    "@deepseek-ai/dsh-api-session-controller": "0.1.7-rc.2",
-    "@deepseek-ai/dsh-api-workspace-controller": "0.1.7-rc.2",
-    "@deepseek-ai/dsh-client-connection": "0.1.7-rc.2",
-    "@deepseek-ai/dsh-client-store": "0.1.7-rc.2",
-    "@deepseek-ai/dsh-client-locale": "0.1.7-rc.2",
-    "@deepseek-ai/dsh-client-test-runtime": "0.1.7-rc.2",
-    "@deepseek-ai/dsh-client-ui-conversation": "0.1.7-rc.2",
-    "@deepseek-ai/dsh-client-ui-layout": "0.1.7-rc.2",
-    "@deepseek-ai/dsh-client-ui-primitives": "0.1.7-rc.2",
-    "@deepseek-ai/dsh-client-ui-session": "0.1.7-rc.2",
-    "@deepseek-ai/dsh-client-ui-renderer": "0.1.7-rc.2",
-    "@deepseek-ai/dsh-client-ui-sidebar": "0.1.7-rc.2",
-    "@deepseek-ai/dsh-jobs": "0.1.7-rc.2",
-    "@deepseek-ai/dsh-client-ui-slots": "0.1.7-rc.2",
-    "@deepseek-ai/dsh-session": "0.1.7-rc.2",
-    "@deepseek-ai/dsh-schedule": "0.1.7-rc.2",
-    "@deepseek-ai/dsh-subagent": "0.1.7-rc.2",
-    "@deepseek-ai/dsh-typert-protocol": "0.1.7-rc.2",
-    "@deepseek-ai/dsh-util-workspace-path": "0.1.7-rc.2",
-    "@deepseek-ai/dsh-client-shortcuts": "0.1.7-rc.2",
-    "@deepseek-ai/dsh-util-values": "0.1.7-rc.2"
+    "@deepseek-ai/dsh-client-connection": "0.2.0-rc.1",
+    "@deepseek-ai/dsh-client-locale": "0.2.0-rc.1",
+    "@deepseek-ai/dsh-client-test-runtime": "0.2.0-rc.1",
+    "@deepseek-ai/dsh-client-ui-conversation": "0.2.0-rc.1",
+    "@deepseek-ai/dsh-client-store": "0.2.0-rc.1",
+    "@deepseek-ai/dsh-client-ui-layout": "0.2.0-rc.1",
+    "@deepseek-ai/dsh-client-ui-primitives": "0.2.0-rc.1",
+    "@deepseek-ai/dsh-client-ui-renderer": "0.2.0-rc.1",
+    "@deepseek-ai/dsh-client-ui-session": "0.2.0-rc.1",
+    "@deepseek-ai/dsh-client-ui-sidebar": "0.2.0-rc.1",
+    "@deepseek-ai/dsh-client-ui-slots": "0.2.0-rc.1",
+    "@deepseek-ai/dsh-jobs": "0.2.0-rc.1",
+    "@deepseek-ai/dsh-schedule": "0.2.0-rc.1",
+    "@deepseek-ai/dsh-session": "0.2.0-rc.1",
+    "@deepseek-ai/dsh-subagent": "0.2.0-rc.1",
+    "@deepseek-ai/dsh-typert-protocol": "0.2.0-rc.1",
+    "@deepseek-ai/dsh-util-values": "0.2.0-rc.1",
+    "@deepseek-ai/dsh-util-workspace-path": "0.2.0-rc.1",
+    "@deepseek-ai/dsh-client-shortcuts": "0.2.0-rc.1",
+    "@deepseek-ai/dsh-client-product-analytics": "0.2.0-rc.1"
   },
   "files": [
     "lib/index.js",