@deepseek-ai/dsh-client-ui-reference 0.1.6-alpha.1 → 0.1.7-alpha.1

package/README.i18n.yaml

@@ -2,5 +2,5 @@
 # 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-reference/README.md
-README.md: 1a79a22425fff1c7323a3bcb55afd324decbe5e8
-README.zh.md: 7cde5e46e69f008e9fcfffeb3920184d90bddb60
+README.md: 57b5ae2440cf3dd4512cf44361b334dc7f3a58c9
+README.zh.md: fa5af63c939f2bb71f371262dbbf137180c63f8e

package/README.md

@@ -51,7 +51,9 @@ The source keeps candidate encoding internal to the registration effect: the `/c
 
 ### Candidate flow
 
-For an unquoted token, the browser starts the `fileReferences/list` and `sessionReferenceResolver/candidates` Remote calls together, then deterministically orders files before sessions with locale-registered folder/file/session labels. Rows render under non-selectable file and session section headings without a redundant raw `reference` source title. A session row is dated from the Host session list's `updatedAt` through the same relative-time bucket that list uses, so one session reads the same age on both surfaces; a session the list does not carry falls back to the candidate's creation time. A drilled query publishes a breadcrumb from the workspace root to the directory being listed; each crumb carries the drill payload a folder row would, so returning to a step and descending into one are one outcome.
+For an unquoted token, the browser starts the `fileReferences/list` and `sessionReferenceResolver/candidates` Remote calls together, then deterministically orders files, direct subagents of the current Session, and other Sessions. Rows use the resolver's display title, which prefers a subagent's creation label while ordinary Sessions retain their projected title, and render under locale-owned group headings without a redundant raw `reference` source title. A session row is dated from the Host session list's `updatedAt` through the same relative-time bucket that list uses, so one session reads the same age on both surfaces; a session the list does not carry falls back to the candidate's creation time. A drilled query publishes a breadcrumb from the workspace root to the current directory; each crumb carries the drill payload a folder row would, so returning to a step and descending into one are one outcome.
+
+Candidate requests require an existing retained Client Session and share one temporary `referenceCandidates` reference. Both discovery calls wait for that Session's initial history open to succeed; an unretained Session or failed open prevents both RPCs. The candidate request's cancellation signal covers the history wait and both calls, and the temporary reference is released when the lookup settles.
 
 ### Serialization
 

package/README.zh.md

@@ -51,7 +51,9 @@ Web 用户需要从同一个 `@` 补全菜单提及文件、文件夹或会话
 
 ### 候选流程
 
-对于未加引号的 token，浏览器会同时启动 `fileReferences/list` 与 `sessionReferenceResolver/candidates` Remote 调用，再以确定性顺序把文件排在会话之前，并使用注册在 locale 字典中的文件夹、文件与会话标签。各行分别渲染在不可选择的文件与会话分组标题下，不显示重复的原始 `reference` source 标题。会话行用宿主会话列表的 `updatedAt` 经该列表相同的相对时间分档标注时间，因此同一个会话在两处读到的时长一致；列表中没有的会话回落到候选自带的创建时间。下钻后的查询会发布一条从工作区根目录到当前所列目录的面包屑；每一节携带的下钻载荷与文件夹行相同，因此「回到某一步」与「进入某一层」是同一个结果。
+对于未加引号的 token，浏览器会同时启动 `fileReferences/list` 与 `sessionReferenceResolver/candidates` Remote 调用，再按文件、当前 Session 的直接 subagent、其他 Session 的确定性顺序排列。各行使用 resolver 的显示标题；subagent 优先使用创建标签，普通 Session 保持投影标题，并渲染在 locale 管理的分组标题下，不显示重复的原始 `reference` source 标题。会话行用宿主会话列表的 `updatedAt` 经该列表相同的相对时间分档标注时间，因此同一个会话在两处读到的时长一致；列表中没有的会话回落到候选自带的创建时间。下钻后的查询会发布一条从工作区根目录到当前目录的面包屑；每一节携带的下钻载荷与文件夹行相同，因此「回到某一步」与「进入某一层」是同一个结果。
+
+候选请求要求客户端已持有该会话，并共用一个临时的 `referenceCandidates` 引用。两个发现调用都等待该会话首次历史打开成功；未持有会话或打开失败时，均不发送 RPC。候选请求的取消信号同时覆盖历史等待和两个调用，查询结束时释放临时引用。
 
 ### 序列化
 

package/lib/client.js

@@ -108,6 +108,7 @@ window.__ModuleLoader__.load({
 		*/
 		const zh = {
 			"section.files": "文件与文件夹",
+			"section.subagents": "子智能体",
 			"section.sessions": "对话",
 			"candidate.noCwd": "（无工作目录）",
 			"crumb.root": "工作区",
@@ -121,6 +122,7 @@ window.__ModuleLoader__.load({
 		/** English dictionary, checked complete against the zh key set. */
 		const en = {
 			"section.files": "Files & folders",
+			"section.subagents": "Subagents",
 			"section.sessions": "Sessions",
 			"candidate.noCwd": "(no cwd)",
 			"crumb.root": "Workspace",
@@ -159,15 +161,36 @@ window.__ModuleLoader__.load({
 				name: "reference",
 				showGroupTitle: false,
 				async candidates(session, { query, quoted, drilled, signal }) {
-					const fileLookup = ctx.remote.fileReferences.list(session.sessionId, query, signal).then((result) => result.ok ? result.value : []);
-					const sessionLookup = quoted === true ? Promise.resolve([]) : ctx.remote.sessionReferenceResolver.candidates(session.sessionId, query, signal).then((result) => result.ok ? result.value : []);
-					const [fileItems, sessionItems] = await Promise.all([fileLookup, sessionLookup]);
+					if (sessions.binding(session.sessionId) === void 0) throw new Error(`reference candidates require a retained session "${session.sessionId}"`);
+					const [fileItems, sessionItems] = await sessions.using(session.sessionId, {
+						source: "referenceCandidates",
+						signal
+					}, async (reference) => {
+						signal.throwIfAborted();
+						const state = reference.binding.session.getSnapshot();
+						if (state.openState !== "open") throw state.openError ?? /* @__PURE__ */ new Error(`session "${session.sessionId}" is not open`);
+						const fileLookup = ctx.remote.fileReferences.list(session.sessionId, query, signal).then((result) => result.ok ? result.value : []);
+						const sessionLookup = quoted === true ? Promise.resolve([]) : ctx.remote.sessionReferenceResolver.candidates(session.sessionId, query, signal).then((result) => result.ok ? result.value : []);
+						return Promise.all([fileLookup, sessionLookup]);
+					});
 					if (signal.aborted) return [];
 					const withLocation = crumbsFor(query, quoted === true, drilled, t) === void 0;
 					const now = Date.now();
 					const home = ctx.remote.$host.home;
 					const listed = sessions.list.getSnapshot().byId;
-					return [...fileItems.flatMap((candidate) => fileCandidate(candidate, quoted === true, withLocation, t)), ...sessionItems.map((candidate) => sessionCandidate(candidate, listed[candidate.sessionId]?.updatedAt ?? candidate.createdAt, now, home, t))];
+					const sessionRows = sessionItems.map((candidate) => {
+						const summary = listed[candidate.sessionId];
+						const child = summary?.origin === "subagent" && summary.parentId === session.sessionId;
+						return {
+							child,
+							row: sessionCandidate(candidate, candidate.displayTitle ?? candidate.label, summary?.updatedAt ?? candidate.createdAt, now, home, t(child ? "section.subagents" : "section.sessions"), t)
+						};
+					});
+					return [
+						...fileItems.flatMap((candidate) => fileCandidate(candidate, quoted === true, withLocation, t)),
+						...sessionRows.filter((item) => item.child).map((item) => item.row),
+						...sessionRows.filter((item) => !item.child).map((item) => item.row)
+					];
 				},
 				header(_session, req) {
 					return crumbsFor(req.query, req.quoted === true, req.drilled, t);
@@ -277,20 +300,20 @@ window.__ModuleLoader__.load({
 				...directory ? { drill: true } : {}
 			}];
 		}
-		function sessionCandidate(candidate, updatedAt, now, home, t) {
+		function sessionCandidate(candidate, label, updatedAt, now, home, section, t) {
 			const { unit, n } = (0, _deepseek_ai_dsh_client_ui_primitives.relativeTime)(updatedAt, now);
 			const age = unit === "now" ? t("time.now") : t(`time.${unit}`, { n });
 			const location = candidate.sameWorkspace ? void 0 : candidate.cwd === void 0 ? t("candidate.noCwd") : abbreviateHomePath(candidate.cwd, home);
 			const value = {
 				kind: "session",
-				label: candidate.label,
+				label,
 				mention: candidate.mention
 			};
 			return {
-				name: candidate.label,
+				name: label,
 				description: location === void 0 ? age : `${location} · ${age}`,
 				icon: "session",
-				section: t("section.sessions"),
+				section,
 				value: JSON.stringify(value)
 			};
 		}

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

@@ -1,4 +1,10 @@
 import type { Context as ClientContext } from '@deepseek-ai/cordis';
+declare module '@deepseek-ai/dsh-api-session-controller/client' {
+    interface SessionReferenceSourceMap {
+        /** File and Session candidates waiting for initial history and their RPC results. */
+        referenceCandidates: unknown;
+    }
+}
 /** Required services: the trigger registry, the Remote namespaces, and the copy. */
 export declare const inject: string[];
 /**

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

@@ -10,6 +10,7 @@ export declare const NS = "reference";
  */
 export declare const zh: {
     'section.files': string;
+    'section.subagents': string;
     'section.sessions': string;
     'candidate.noCwd': string;
     'crumb.root': string;
@@ -31,6 +32,7 @@ declare module '@deepseek-ai/dsh-client-ui-slots' {
 /** English dictionary, checked complete against the zh key set. */
 export declare const en: {
     'section.files': string;
+    'section.subagents': string;
     'section.sessions': string;
     'candidate.noCwd': string;
     'crumb.root': string;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@deepseek-ai/dsh-client-ui-reference",
   "description": "Unified Web @file and @session reference source",
-  "version": "0.1.6-alpha.1",
+  "version": "0.1.7-alpha.1",
   "publishConfig": {
     "access": "public"
   },
@@ -40,23 +40,23 @@
   },
   "license": "MIT",
   "peerDependencies": {
-    "@deepseek-ai/cordis": "^4.0.2"
+    "@deepseek-ai/cordis": "^4.0.3"
   },
   "devDependencies": {
-    "@deepseek-ai/dsh-api-remotes": "^0.1.6-alpha.1",
-    "@deepseek-ai/dsh-api-session-controller": "^0.1.6-alpha.1",
-    "@deepseek-ai/dsh-client-locale": "^0.1.6-alpha.1",
-    "@deepseek-ai/dsh-client-connection": "^0.1.6-alpha.1",
-    "@deepseek-ai/dsh-client-test-runtime": "^0.1.6-alpha.1",
-    "@deepseek-ai/dsh-client-ui-input-trigger": "^0.1.6-alpha.1",
-    "@deepseek-ai/dsh-client-ui-slots": "^0.1.6-alpha.1",
-    "@deepseek-ai/dsh-client-ui-primitives": "^0.1.6-alpha.1",
-    "@deepseek-ai/dsh-file-reference": "^0.1.6-alpha.1",
-    "@deepseek-ai/dsh-session-reference": "^0.1.6-alpha.1",
-    "@deepseek-ai/dsh-typert-protocol": "^0.1.6-alpha.1",
-    "@deepseek-ai/dsh-util-workspace-path": "^0.1.6-alpha.1",
-    "@deepseek-ai/cordis": "^4.0.2",
-    "@deepseek-ai/dsh-client-ui-sidebar-right": "^0.1.6-alpha.1"
+    "@deepseek-ai/dsh-api-remotes": "^0.1.7-alpha.1",
+    "@deepseek-ai/dsh-api-session-controller": "^0.1.7-alpha.1",
+    "@deepseek-ai/dsh-client-connection": "^0.1.7-alpha.1",
+    "@deepseek-ai/dsh-client-locale": "^0.1.7-alpha.1",
+    "@deepseek-ai/dsh-client-test-runtime": "^0.1.7-alpha.1",
+    "@deepseek-ai/dsh-client-ui-input-trigger": "^0.1.7-alpha.1",
+    "@deepseek-ai/dsh-client-ui-slots": "^0.1.7-alpha.1",
+    "@deepseek-ai/dsh-client-ui-primitives": "^0.1.7-alpha.1",
+    "@deepseek-ai/dsh-file-reference": "^0.1.7-alpha.1",
+    "@deepseek-ai/dsh-typert-protocol": "^0.1.7-alpha.1",
+    "@deepseek-ai/dsh-session-reference": "^0.1.7-alpha.1",
+    "@deepseek-ai/cordis": "^4.0.3",
+    "@deepseek-ai/dsh-util-workspace-path": "^0.1.7-alpha.1",
+    "@deepseek-ai/dsh-client-ui-sidebar-right": "^0.1.7-alpha.1"
   },
   "files": [
     "lib/index.js",