dsh-worktree-groups 0.0.0-stage → 0.1.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/LICENSE +21 -0
- package/README.md +168 -2
- package/cordis.patch.yml +17 -0
- package/icon.svg +20 -0
- package/lib/activity.d.ts +78 -0
- package/lib/activity.d.ts.map +1 -0
- package/lib/activity.js +241 -0
- package/lib/activity.js.map +1 -0
- package/lib/client.d.ts +78 -0
- package/lib/client.d.ts.map +1 -0
- package/lib/client.js +4280 -0
- package/lib/git.d.ts +109 -0
- package/lib/git.d.ts.map +1 -0
- package/lib/git.js +317 -0
- package/lib/git.js.map +1 -0
- package/lib/icons.d.ts +148 -0
- package/lib/icons.d.ts.map +1 -0
- package/lib/icons.js +144 -0
- package/lib/icons.js.map +1 -0
- package/lib/index.d.ts +32 -0
- package/lib/index.d.ts.map +1 -0
- package/lib/index.js +47 -0
- package/lib/index.js.map +1 -0
- package/lib/ledger.d.ts +97 -0
- package/lib/ledger.d.ts.map +1 -0
- package/lib/ledger.js +276 -0
- package/lib/ledger.js.map +1 -0
- package/lib/live-merge.d.ts +44 -0
- package/lib/live-merge.d.ts.map +1 -0
- package/lib/live-merge.js +227 -0
- package/lib/live-merge.js.map +1 -0
- package/lib/live-state.d.ts +158 -0
- package/lib/live-state.d.ts.map +1 -0
- package/lib/live-state.js +281 -0
- package/lib/live-state.js.map +1 -0
- package/lib/locales.d.ts +71 -0
- package/lib/locales.d.ts.map +1 -0
- package/lib/locales.js +199 -0
- package/lib/locales.js.map +1 -0
- package/lib/projects.d.ts +88 -0
- package/lib/projects.d.ts.map +1 -0
- package/lib/projects.js +418 -0
- package/lib/projects.js.map +1 -0
- package/lib/routes.d.ts +376 -0
- package/lib/routes.d.ts.map +1 -0
- package/lib/routes.js +1875 -0
- package/lib/routes.js.map +1 -0
- package/lib/row-memo.d.ts +34 -0
- package/lib/row-memo.d.ts.map +1 -0
- package/lib/row-memo.js +46 -0
- package/lib/row-memo.js.map +1 -0
- package/lib/sidebar.d.ts +126 -0
- package/lib/sidebar.d.ts.map +1 -0
- package/lib/tree-model.d.ts +1226 -0
- package/lib/tree-model.d.ts.map +1 -0
- package/lib/tree-model.js +2143 -0
- package/lib/tree-model.js.map +1 -0
- package/lib/types.d.ts +98 -0
- package/lib/types.d.ts.map +1 -0
- package/lib/types.js +8 -0
- package/lib/types.js.map +1 -0
- package/locale/en.json +6 -0
- package/locale/zh.json +6 -0
- package/package.json +88 -4
|
@@ -0,0 +1,44 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* 客户端实时会话叠加层(2026-11-14 PERF6,纯逻辑,零宿主依赖)。
|
|
3
|
+
*
|
|
4
|
+
* ## 为什么需要
|
|
5
|
+
*
|
|
6
|
+
* 侧栏树来自 `POST /dsh-worktree-groups/tree`,服务端要列举全部会话、扫 git、组装整棵树;
|
|
7
|
+
* 即使有缓存也至少是一次网络往返 + 防抖。而宿主客户端早已持有**实时**会话列表
|
|
8
|
+
* (`useSessions(identity)` 快照,`byId[id] = { id, cwd, updatedAt, running, blank, title,
|
|
9
|
+
* parentId, origin }`,由宿主 `ClientSessions.projectList()` 产出)。
|
|
10
|
+
*
|
|
11
|
+
* 本模块把这份实时快照叠加到最近一次服务端树上:
|
|
12
|
+
*
|
|
13
|
+
* 1. **已有会话**:标题 / 运行态 / blank 以实时快照为准;`updatedAt`(与 `lastActivityAt`)只增不减。
|
|
14
|
+
* 2. **新顶层会话**(树里没有、非子代理、未归档、有 `cwd`):按 `cwd` 最长前缀匹配到某个
|
|
15
|
+
* **存在的** worktree 节点或非 git 工作区,**立即**插入;匹配不到的不插(等服务端裁决,
|
|
16
|
+
* 避免与服务端的 history / 台账归属规则冲突)。
|
|
17
|
+
* 3. 返回 `pendingIds`:实时快照里有、服务端树里还没有的顶层会话 id —— 调用方据此触发
|
|
18
|
+
* 一次(防抖的)服务端重取;服务端返回后它们自然消失,不会形成重取循环。
|
|
19
|
+
*
|
|
20
|
+
* 无任何变化时返回**同一个** `tree` 引用,便于 `useMemo` 下游零成本短路。
|
|
21
|
+
*/
|
|
22
|
+
import type { ProjectNodeLike, SessionRowLike } from './tree-model.js';
|
|
23
|
+
/** 叠加层输入树(`/tree` 载荷子集)。 */
|
|
24
|
+
export interface LiveMergeTree {
|
|
25
|
+
projects: ProjectNodeLike[];
|
|
26
|
+
ungrouped: SessionRowLike[];
|
|
27
|
+
archivedSessionIds: string[];
|
|
28
|
+
/** 归一化工作区路径 → workspaceId(用于非 git 工作区的路径匹配)。 */
|
|
29
|
+
workspaceByPath?: Record<string, string>;
|
|
30
|
+
}
|
|
31
|
+
/** 叠加结果。 */
|
|
32
|
+
export interface LiveMergeResult<T extends LiveMergeTree> {
|
|
33
|
+
tree: T;
|
|
34
|
+
/** 实时快照里有、服务端树里还没有的顶层可见会话 id(已排序)。 */
|
|
35
|
+
pendingIds: string[];
|
|
36
|
+
}
|
|
37
|
+
/**
|
|
38
|
+
* 把实时会话快照叠加到服务端树上(纯函数,不修改入参)。
|
|
39
|
+
*
|
|
40
|
+
* @param tree 最近一次服务端树;
|
|
41
|
+
* @param snapshot `useSessions(identity)` 快照(缺席 / 形状不符 ⇒ 原样返回)。
|
|
42
|
+
*/
|
|
43
|
+
export declare function mergeLiveSessions<T extends LiveMergeTree>(tree: T, snapshot: unknown): LiveMergeResult<T>;
|
|
44
|
+
//# sourceMappingURL=live-merge.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"live-merge.d.ts","sourceRoot":"","sources":["../src/live-merge.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAA;AAItE,4BAA4B;AAC5B,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,eAAe,EAAE,CAAA;IAC3B,SAAS,EAAE,cAAc,EAAE,CAAA;IAC3B,kBAAkB,EAAE,MAAM,EAAE,CAAA;IAC5B,gDAAgD;IAChD,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CACzC;AAcD,YAAY;AACZ,MAAM,WAAW,eAAe,CAAC,CAAC,SAAS,aAAa;IACtD,IAAI,EAAE,CAAC,CAAA;IACP,sCAAsC;IACtC,UAAU,EAAE,MAAM,EAAE,CAAA;CACrB;AA4FD;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,SAAS,aAAa,EAAE,IAAI,EAAE,CAAC,EAAE,QAAQ,EAAE,OAAO,GAAG,eAAe,CAAC,CAAC,CAAC,CAoGzG"}
|
|
@@ -0,0 +1,227 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* 客户端实时会话叠加层(2026-11-14 PERF6,纯逻辑,零宿主依赖)。
|
|
3
|
+
*
|
|
4
|
+
* ## 为什么需要
|
|
5
|
+
*
|
|
6
|
+
* 侧栏树来自 `POST /dsh-worktree-groups/tree`,服务端要列举全部会话、扫 git、组装整棵树;
|
|
7
|
+
* 即使有缓存也至少是一次网络往返 + 防抖。而宿主客户端早已持有**实时**会话列表
|
|
8
|
+
* (`useSessions(identity)` 快照,`byId[id] = { id, cwd, updatedAt, running, blank, title,
|
|
9
|
+
* parentId, origin }`,由宿主 `ClientSessions.projectList()` 产出)。
|
|
10
|
+
*
|
|
11
|
+
* 本模块把这份实时快照叠加到最近一次服务端树上:
|
|
12
|
+
*
|
|
13
|
+
* 1. **已有会话**:标题 / 运行态 / blank 以实时快照为准;`updatedAt`(与 `lastActivityAt`)只增不减。
|
|
14
|
+
* 2. **新顶层会话**(树里没有、非子代理、未归档、有 `cwd`):按 `cwd` 最长前缀匹配到某个
|
|
15
|
+
* **存在的** worktree 节点或非 git 工作区,**立即**插入;匹配不到的不插(等服务端裁决,
|
|
16
|
+
* 避免与服务端的 history / 台账归属规则冲突)。
|
|
17
|
+
* 3. 返回 `pendingIds`:实时快照里有、服务端树里还没有的顶层会话 id —— 调用方据此触发
|
|
18
|
+
* 一次(防抖的)服务端重取;服务端返回后它们自然消失,不会形成重取循环。
|
|
19
|
+
*
|
|
20
|
+
* 无任何变化时返回**同一个** `tree` 引用,便于 `useMemo` 下游零成本短路。
|
|
21
|
+
*/
|
|
22
|
+
const SESSION_ID_PREFIX = 'session-';
|
|
23
|
+
/** 去掉宿主 `session-` 前缀(树与快照里两种拼法都可能出现)。 */
|
|
24
|
+
function bareId(id) {
|
|
25
|
+
return id.startsWith(SESSION_ID_PREFIX) && id.length > SESSION_ID_PREFIX.length ? id.slice(SESSION_ID_PREFIX.length) : id;
|
|
26
|
+
}
|
|
27
|
+
/** 路径归一:反斜杠转正斜杠、去尾斜杠(根保留)。 */
|
|
28
|
+
function normalize(path) {
|
|
29
|
+
let out = path.replace(/\\/g, '/');
|
|
30
|
+
while (out.length > 1 && out.endsWith('/'))
|
|
31
|
+
out = out.slice(0, -1);
|
|
32
|
+
return out;
|
|
33
|
+
}
|
|
34
|
+
function isUnder(cwd, base) {
|
|
35
|
+
if (cwd === base)
|
|
36
|
+
return true;
|
|
37
|
+
return cwd.startsWith(base.endsWith('/') ? base : `${base}/`);
|
|
38
|
+
}
|
|
39
|
+
function finite(value) {
|
|
40
|
+
return typeof value === 'number' && Number.isFinite(value) ? value : undefined;
|
|
41
|
+
}
|
|
42
|
+
function nonEmpty(value) {
|
|
43
|
+
return typeof value === 'string' && value !== '' ? value : undefined;
|
|
44
|
+
}
|
|
45
|
+
/** 把一条实时条目覆盖到既有行上;无变化返回原行。 */
|
|
46
|
+
function patchRow(row, entry) {
|
|
47
|
+
const title = nonEmpty(entry.title);
|
|
48
|
+
const running = typeof entry.running === 'boolean' ? entry.running : row.running;
|
|
49
|
+
const blank = typeof entry.blank === 'boolean' ? entry.blank : row.blank;
|
|
50
|
+
const liveUpdated = finite(entry.updatedAt);
|
|
51
|
+
const updatedAt = liveUpdated !== undefined && liveUpdated > row.updatedAt ? liveUpdated : row.updatedAt;
|
|
52
|
+
const priorActivity = row.lastActivityAt ?? row.updatedAt;
|
|
53
|
+
const lastActivityAt = updatedAt > priorActivity ? updatedAt : priorActivity;
|
|
54
|
+
if ((title === undefined || title === row.title) &&
|
|
55
|
+
running === row.running &&
|
|
56
|
+
blank === row.blank &&
|
|
57
|
+
updatedAt === row.updatedAt &&
|
|
58
|
+
lastActivityAt === (row.lastActivityAt ?? row.updatedAt)) {
|
|
59
|
+
return row;
|
|
60
|
+
}
|
|
61
|
+
return {
|
|
62
|
+
...row,
|
|
63
|
+
...(title === undefined ? {} : { title }),
|
|
64
|
+
running,
|
|
65
|
+
blank,
|
|
66
|
+
updatedAt,
|
|
67
|
+
lastActivityAt,
|
|
68
|
+
};
|
|
69
|
+
}
|
|
70
|
+
/** 逐行覆盖一个列表;无变化返回原数组。 */
|
|
71
|
+
function patchList(list, live) {
|
|
72
|
+
let out;
|
|
73
|
+
for (let index = 0; index < list.length; index += 1) {
|
|
74
|
+
const row = list[index];
|
|
75
|
+
const entry = live.get(bareId(row.sessionId));
|
|
76
|
+
if (entry === undefined)
|
|
77
|
+
continue;
|
|
78
|
+
const next = patchRow(row, entry);
|
|
79
|
+
if (next === row)
|
|
80
|
+
continue;
|
|
81
|
+
out ??= list.slice();
|
|
82
|
+
out[index] = next;
|
|
83
|
+
}
|
|
84
|
+
return out ?? list;
|
|
85
|
+
}
|
|
86
|
+
/** 快照 → `裸 id → 条目`。兼容 `byId` 对象与 `Map`。 */
|
|
87
|
+
function liveEntriesOf(snapshot) {
|
|
88
|
+
const out = new Map();
|
|
89
|
+
if (typeof snapshot !== 'object' || snapshot === null)
|
|
90
|
+
return out;
|
|
91
|
+
const byId = snapshot.byId;
|
|
92
|
+
const add = (key, value) => {
|
|
93
|
+
if (typeof value !== 'object' || value === null)
|
|
94
|
+
return;
|
|
95
|
+
const entry = value;
|
|
96
|
+
const id = nonEmpty(entry.id) ?? key;
|
|
97
|
+
if (id === '')
|
|
98
|
+
return;
|
|
99
|
+
out.set(bareId(id), { ...entry, id });
|
|
100
|
+
};
|
|
101
|
+
if (byId instanceof Map) {
|
|
102
|
+
for (const [key, value] of byId)
|
|
103
|
+
add(String(key), value);
|
|
104
|
+
}
|
|
105
|
+
else if (typeof byId === 'object' && byId !== null) {
|
|
106
|
+
for (const [key, value] of Object.entries(byId))
|
|
107
|
+
add(key, value);
|
|
108
|
+
}
|
|
109
|
+
return out;
|
|
110
|
+
}
|
|
111
|
+
/**
|
|
112
|
+
* 把实时会话快照叠加到服务端树上(纯函数,不修改入参)。
|
|
113
|
+
*
|
|
114
|
+
* @param tree 最近一次服务端树;
|
|
115
|
+
* @param snapshot `useSessions(identity)` 快照(缺席 / 形状不符 ⇒ 原样返回)。
|
|
116
|
+
*/
|
|
117
|
+
export function mergeLiveSessions(tree, snapshot) {
|
|
118
|
+
const live = liveEntriesOf(snapshot);
|
|
119
|
+
if (live.size === 0)
|
|
120
|
+
return { tree, pendingIds: [] };
|
|
121
|
+
// 1) 树里已有的 id(裸 id)。
|
|
122
|
+
const known = new Set();
|
|
123
|
+
const remember = (list) => {
|
|
124
|
+
for (const row of list)
|
|
125
|
+
known.add(bareId(row.sessionId));
|
|
126
|
+
};
|
|
127
|
+
for (const project of tree.projects) {
|
|
128
|
+
for (const node of project.worktrees)
|
|
129
|
+
remember(node.sessions);
|
|
130
|
+
remember(project.history);
|
|
131
|
+
remember(project.flatSessions);
|
|
132
|
+
}
|
|
133
|
+
remember(tree.ungrouped);
|
|
134
|
+
const archived = new Set(tree.archivedSessionIds.map(bareId));
|
|
135
|
+
// 2) 新的顶层可见会话。
|
|
136
|
+
const pendingIds = [];
|
|
137
|
+
const additions = [];
|
|
138
|
+
for (const [key, entry] of live) {
|
|
139
|
+
if (known.has(key) || archived.has(key))
|
|
140
|
+
continue;
|
|
141
|
+
if (entry.origin === 'subagent' || nonEmpty(entry.parentId) !== undefined)
|
|
142
|
+
continue;
|
|
143
|
+
const cwd = nonEmpty(entry.cwd);
|
|
144
|
+
if (cwd === undefined)
|
|
145
|
+
continue;
|
|
146
|
+
const id = nonEmpty(entry.id) ?? key;
|
|
147
|
+
pendingIds.push(id);
|
|
148
|
+
additions.push({ entry, cwd: normalize(cwd), id });
|
|
149
|
+
}
|
|
150
|
+
pendingIds.sort();
|
|
151
|
+
// 3) 覆盖既有行。
|
|
152
|
+
let changed = false;
|
|
153
|
+
const projects = tree.projects.map((project) => {
|
|
154
|
+
const worktrees = project.worktrees.map((node) => {
|
|
155
|
+
const sessions = patchList(node.sessions, live);
|
|
156
|
+
return sessions === node.sessions ? node : { ...node, sessions };
|
|
157
|
+
});
|
|
158
|
+
const history = patchList(project.history, live);
|
|
159
|
+
const flatSessions = patchList(project.flatSessions, live);
|
|
160
|
+
const worktreesChanged = worktrees.some((node, index) => node !== project.worktrees[index]);
|
|
161
|
+
if (!worktreesChanged && history === project.history && flatSessions === project.flatSessions)
|
|
162
|
+
return project;
|
|
163
|
+
changed = true;
|
|
164
|
+
return { ...project, worktrees, history, flatSessions };
|
|
165
|
+
});
|
|
166
|
+
const ungrouped = patchList(tree.ungrouped, live);
|
|
167
|
+
if (ungrouped !== tree.ungrouped)
|
|
168
|
+
changed = true;
|
|
169
|
+
// 4) 新会话按 cwd 最长前缀落位。
|
|
170
|
+
if (additions.length > 0) {
|
|
171
|
+
const targets = [];
|
|
172
|
+
const projectIndexByKey = new Map();
|
|
173
|
+
projects.forEach((project, projectIndex) => {
|
|
174
|
+
projectIndexByKey.set(project.key, projectIndex);
|
|
175
|
+
if (!project.isGit)
|
|
176
|
+
return;
|
|
177
|
+
project.worktrees.forEach((node, worktreeIndex) => {
|
|
178
|
+
if (node.exists === false)
|
|
179
|
+
return;
|
|
180
|
+
targets.push({ path: normalize(node.path), projectIndex, worktreeIndex });
|
|
181
|
+
});
|
|
182
|
+
});
|
|
183
|
+
for (const [path, workspaceId] of Object.entries(tree.workspaceByPath ?? {})) {
|
|
184
|
+
const projectIndex = projectIndexByKey.get(`ws:${workspaceId}`);
|
|
185
|
+
if (projectIndex === undefined || projects[projectIndex].isGit)
|
|
186
|
+
continue;
|
|
187
|
+
targets.push({ path: normalize(path), projectIndex, worktreeIndex: -1 });
|
|
188
|
+
}
|
|
189
|
+
for (const { entry, cwd, id } of additions) {
|
|
190
|
+
let best;
|
|
191
|
+
for (const target of targets) {
|
|
192
|
+
if (!isUnder(cwd, target.path))
|
|
193
|
+
continue;
|
|
194
|
+
if (best === undefined || target.path.length > best.path.length)
|
|
195
|
+
best = target;
|
|
196
|
+
}
|
|
197
|
+
if (best === undefined)
|
|
198
|
+
continue;
|
|
199
|
+
const updatedAt = finite(entry.updatedAt) ?? 0;
|
|
200
|
+
const title = nonEmpty(entry.title);
|
|
201
|
+
const added = {
|
|
202
|
+
sessionId: id,
|
|
203
|
+
updatedAt,
|
|
204
|
+
lastActivityAt: updatedAt,
|
|
205
|
+
running: entry.running === true,
|
|
206
|
+
blank: entry.blank === true,
|
|
207
|
+
cwd,
|
|
208
|
+
...(title === undefined ? {} : { title }),
|
|
209
|
+
};
|
|
210
|
+
const project = projects[best.projectIndex];
|
|
211
|
+
if (best.worktreeIndex < 0) {
|
|
212
|
+
projects[best.projectIndex] = { ...project, flatSessions: [added, ...project.flatSessions] };
|
|
213
|
+
}
|
|
214
|
+
else {
|
|
215
|
+
const worktrees = project.worktrees.slice();
|
|
216
|
+
const node = worktrees[best.worktreeIndex];
|
|
217
|
+
worktrees[best.worktreeIndex] = { ...node, sessions: [added, ...node.sessions] };
|
|
218
|
+
projects[best.projectIndex] = { ...project, worktrees };
|
|
219
|
+
}
|
|
220
|
+
changed = true;
|
|
221
|
+
}
|
|
222
|
+
}
|
|
223
|
+
if (!changed)
|
|
224
|
+
return { tree, pendingIds };
|
|
225
|
+
return { tree: { ...tree, projects, ungrouped }, pendingIds };
|
|
226
|
+
}
|
|
227
|
+
//# sourceMappingURL=live-merge.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"live-merge.js","sourceRoot":"","sources":["../src/live-merge.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,158 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* 会话行的**客户端 live fact**:等待确认(琥珀)与后台完成未读(绿点)。
|
|
3
|
+
*
|
|
4
|
+
* ## 为什么单独成一个纯逻辑模块
|
|
5
|
+
*
|
|
6
|
+
* 这两个态**只能**从客户端快照取 —— 宿主 HTTP 面(`SessionSummary` 的
|
|
7
|
+
* `summarizeCold` / `summaryFor` / `listFields`)根本没有这两个字段。而客户端的取法
|
|
8
|
+
* 随宿主版本变化过两次,把它从 `sidebar.tsx` 抽出来,才能用 `node --test` 直接覆盖
|
|
9
|
+
* (`.tsx` 不进 `lib/`,无法单测)。
|
|
10
|
+
*
|
|
11
|
+
* ## 宿主事实(2026-10-19 核实,Desktop 2.0.18 / `@deepseek-ai/*@0.2.1-rc.2`)
|
|
12
|
+
*
|
|
13
|
+
* | 状态 | `0.1.5-rc.2` 的取法 | `0.2.1-rc.2` 的取法 |
|
|
14
|
+
* |---|---|---|
|
|
15
|
+
* | 等待确认 | root hook `useSessionPendingInteraction` → `Map<id, interaction>` | **该 source 已删除**;改由 `useSessionStatus` 提供 |
|
|
16
|
+
* | 后台完成未读 | `useSessions().byId[id].completed` | **该字段已删除**;改由 `useSessionStatus` 的 `completionUnread` |
|
|
17
|
+
*
|
|
18
|
+
* `useSessionStatus` 的快照形状(`dsh-client-ui-session/lib/client.js` 的
|
|
19
|
+
* `publishStatus()`):
|
|
20
|
+
*
|
|
21
|
+
* ```js
|
|
22
|
+
* new Map<SessionId, {
|
|
23
|
+
* running: boolean,
|
|
24
|
+
* pendingInteraction: { kind: 'approval' | 'plan-review' | 'question' | <其它> } | undefined,
|
|
25
|
+
* completionUnread: boolean,
|
|
26
|
+
* }>()
|
|
27
|
+
* ```
|
|
28
|
+
*
|
|
29
|
+
* ## 契约
|
|
30
|
+
*
|
|
31
|
+
* 1. **新源优先**:`status` 有该会话的数据就用它,旧取法不再覆盖;
|
|
32
|
+
* 2. **旧取法保留兜底**:宿主回退或其它组合下不至于两个态全灭;
|
|
33
|
+
* 3. **kind 白名单**:只有 `approval` / `plan-review` / `question` 算「等待确认」
|
|
34
|
+
* (对齐原生 `visiblePendingKind`,`dsh-client-ui-workspace/lib/client.js`);
|
|
35
|
+
* 4. **id 拼法兼容**:宿主有 `session-<uuid>` 与裸 `<uuid>` 两种拼法,查表归一化;
|
|
36
|
+
* 5. **绝不抛错**:任何不认识的形状都降级为「没有该态」。
|
|
37
|
+
*
|
|
38
|
+
* 纯逻辑:不 import react、不 import 任何 `@deepseek-ai/*`、无 IO。
|
|
39
|
+
*/
|
|
40
|
+
/**
|
|
41
|
+
* 复刻原生 `visiblePendingKind()`。
|
|
42
|
+
*
|
|
43
|
+
* 语义:只有 `approval` / `plan-review` / `question` 三种 kind 算「等待用户确认」,
|
|
44
|
+
* 其它(或非字符串)一律 `undefined` —— 客户端不能因为快照里有值就点琥珀。
|
|
45
|
+
*
|
|
46
|
+
* @param kind 快照里 interaction 的 `kind`(未知类型)。
|
|
47
|
+
* @returns 合法 kind,或 `undefined`。
|
|
48
|
+
*/
|
|
49
|
+
export declare function visiblePendingKind(kind: unknown): string | undefined;
|
|
50
|
+
/**
|
|
51
|
+
* 会话 id 归一化键(宿主有 `session-<uuid>` 与裸 `<uuid>` 两种拼法)。
|
|
52
|
+
*
|
|
53
|
+
* **只用于查表比较**,渲染与写回仍用原 id。
|
|
54
|
+
*
|
|
55
|
+
* @param id 会话 id。
|
|
56
|
+
* @returns 去掉 `session-` 前缀后的比较键。
|
|
57
|
+
*/
|
|
58
|
+
export declare function normalizeSessionKey(id: string): string;
|
|
59
|
+
/** `useSessions` 快照里我们需要的部分(旧取法兜底用)。 */
|
|
60
|
+
interface SessionsSnapshot {
|
|
61
|
+
/** `sessionId → 条目`(宿主 client 的 `projectList()` 产出)。 */
|
|
62
|
+
byId?: Record<string, {
|
|
63
|
+
completed?: unknown;
|
|
64
|
+
} | undefined>;
|
|
65
|
+
}
|
|
66
|
+
/** {@link liveStateOf} 的输入:三个可选的宿主快照。 */
|
|
67
|
+
export interface LiveStateInput {
|
|
68
|
+
/** `useSessionStatus(identity)` 的结果(新源,优先)。 */
|
|
69
|
+
status?: unknown;
|
|
70
|
+
/** `useSessionPendingInteraction(identity)` 的结果(旧源,兜底)。 */
|
|
71
|
+
pending?: unknown;
|
|
72
|
+
/** `useSessions(identity)` 的结果(旧源,兜底)。 */
|
|
73
|
+
sessions?: SessionsSnapshot | undefined;
|
|
74
|
+
}
|
|
75
|
+
/** 一个会话行的 live fact。 */
|
|
76
|
+
export interface SessionLiveState {
|
|
77
|
+
/** 等待确认的合法 kind;`undefined` = 没有待确认。 */
|
|
78
|
+
pendingKind: string | undefined;
|
|
79
|
+
/** 后台完成未读(绿点)。 */
|
|
80
|
+
completionUnread: boolean;
|
|
81
|
+
}
|
|
82
|
+
/**
|
|
83
|
+
* 从 `useSessionStatus` 的快照里取某会话的状态条目。
|
|
84
|
+
*
|
|
85
|
+
* 先按原 id 精确命中(宿主绝大多数情况一致),再退归一化键遍历 —— 遍历是 O(n),
|
|
86
|
+
* 只在未命中时发生。
|
|
87
|
+
*
|
|
88
|
+
* @param status `useSessionStatus(identity)` 的结果。
|
|
89
|
+
* @param sessionId 渲染行的 `row.sessionId`。
|
|
90
|
+
* @returns 状态条目,或 `undefined`。
|
|
91
|
+
*/
|
|
92
|
+
export declare function sessionStatusOf(status: unknown, sessionId: string): unknown;
|
|
93
|
+
/**
|
|
94
|
+
* 运行中会话集合签名:只取 `running === true` 的会话 id,归一化去重、排序、逗号拼接。
|
|
95
|
+
*
|
|
96
|
+
* ## 用途(2026-10-20,运行中任务高亮)
|
|
97
|
+
*
|
|
98
|
+
* `sidebar.tsx` 把它放进**既有 220 ms 防抖**重取 effect 的依赖。签名只在「运行集合」
|
|
99
|
+
* 变化时变(宿主 `sameSessionStatus` 已先做内容去重)⇒ 不会因 `Map` 引用变化每帧重取,
|
|
100
|
+
* 也不会因审批弹窗 / 完成未读触发重取。
|
|
101
|
+
*
|
|
102
|
+
* ## 精确语义(`test/live-state.test.mjs` 的 B1–B8 逐条锁定)
|
|
103
|
+
*
|
|
104
|
+
* 1. 非对象 / 无 `entries()` ⇒ `''`;
|
|
105
|
+
* 2. 遍历 `entries()`:`id` 非字符串或空串 ⇒ 跳过;条目为 `null` / 非对象 ⇒ 跳过;
|
|
106
|
+
* `running !== true` ⇒ 跳过(**只认 `=== true`**,`undefined` / 真值对象都不算);
|
|
107
|
+
* 3. `normalizeSessionKey(id)` 归一化(`session-x` 与 `x` 只算一次),键为空 ⇒ 跳过;
|
|
108
|
+
* 4. `[...Set].sort()` 后 `join(',')`(默认 UTF-16 码元升序,结果确定);
|
|
109
|
+
* 5. 遍历过程中任何异常 ⇒ `''`(整体 try/catch,绝不抛)。
|
|
110
|
+
*
|
|
111
|
+
* **忽略** `pendingInteraction` 与 `completionUnread`:审批弹窗、完成未读都不是「运行中」。
|
|
112
|
+
*
|
|
113
|
+
* 纯函数:不 import react / 宿主包、无 IO、不读时间与随机数。
|
|
114
|
+
*
|
|
115
|
+
* @param status `useSessionStatus(identity)` 的快照(未知形状,防御式读取)。
|
|
116
|
+
* @returns 归一化运行中 id 的排序逗号串;空状态 / 异常形状 ⇒ `''`。
|
|
117
|
+
*/
|
|
118
|
+
export declare function runningSignature(status: unknown): string;
|
|
119
|
+
/**
|
|
120
|
+
* 取一个会话行的 live fact(新源优先,旧源兜底)。
|
|
121
|
+
*
|
|
122
|
+
* @param input 三个可选快照。
|
|
123
|
+
* @param sessionId 渲染行的 `row.sessionId`。
|
|
124
|
+
* @returns `pendingKind` 与 `completionUnread`;永不抛错。
|
|
125
|
+
*/
|
|
126
|
+
export declare function liveStateOf(input: LiveStateInput, sessionId: string): SessionLiveState;
|
|
127
|
+
/** {@link currentSessionIdOf} 的输入。 */
|
|
128
|
+
export interface CurrentSessionInput {
|
|
129
|
+
/** `useSessions(identity)` 的快照。 */
|
|
130
|
+
sessions?: unknown;
|
|
131
|
+
/** `usePanelInfo(identity)` 的快照(可选)。 */
|
|
132
|
+
panelInfo?: unknown;
|
|
133
|
+
/** 用户刚点击打开会话时的乐观选中 sessionId(可选)。 */
|
|
134
|
+
optimisticSessionId?: string;
|
|
135
|
+
}
|
|
136
|
+
/**
|
|
137
|
+
* 解析当前在主视图打开的会话 id(2026-10-21 WSR3 / AC2)。
|
|
138
|
+
*
|
|
139
|
+
* ## 为什么需要它
|
|
140
|
+
*
|
|
141
|
+
* 宿主 `@deepseek-ai/dsh-api-session-controller@0.2.1-rc.2` 删除了 `sessions.list`
|
|
142
|
+
* 快照顶层的 `current` 字段(`lib/client.js:3814`),改为在 `byId[id].retainedBy.mainView`
|
|
143
|
+
* 计数上标记当前主视图持有的会话(`dsh-client-ui-workspace/lib/client.js:866, 3025-3027`)。
|
|
144
|
+
* 旧代码只读 `sessionsSnapshot?.current`,导致升级后 `currentSessionId` 恒为 `undefined`,
|
|
145
|
+
* 打开任何对话都没有选中效果。
|
|
146
|
+
*
|
|
147
|
+
* ## 优先级
|
|
148
|
+
*
|
|
149
|
+
* 1. 若 `panelInfo` 为对象且 `activePanelId !== null && activePanelId !== undefined`
|
|
150
|
+
* (其它面板占据主视图)⇒ 返回 `undefined`;
|
|
151
|
+
* 2. 新源(`0.2.1-rc.2`):`sessions.byId` 中 `retainedBy.mainView > 0` 的条目;
|
|
152
|
+
* 3. 旧源(`0.1.5-rc.2` 兜底):`sessions.current` 非空字符串;
|
|
153
|
+
* 4. 乐观选中兜底:`optimisticSessionId` 非空字符串(覆盖刚点击历史孤儿会话尚未完成
|
|
154
|
+
* `retainScope` 投影的窗口,或无 `byId` 的测试桩)。
|
|
155
|
+
*/
|
|
156
|
+
export declare function currentSessionIdOf(input: CurrentSessionInput): string | undefined;
|
|
157
|
+
export {};
|
|
158
|
+
//# sourceMappingURL=live-state.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"live-state.d.ts","sourceRoot":"","sources":["../src/live-state.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AAKH;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAEpE;AAED;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAEtD;AAED,wCAAwC;AACxC,UAAU,gBAAgB;IACxB,wDAAwD;IACxD,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE;QAAE,SAAS,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,SAAS,CAAC,CAAA;CAC3D;AAED,yCAAyC;AACzC,MAAM,WAAW,cAAc;IAC7B,+CAA+C;IAC/C,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,2DAA2D;IAC3D,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,0CAA0C;IAC1C,QAAQ,CAAC,EAAE,gBAAgB,GAAG,SAAS,CAAA;CACxC;AAED,wBAAwB;AACxB,MAAM,WAAW,gBAAgB;IAC/B,wCAAwC;IACxC,WAAW,EAAE,MAAM,GAAG,SAAS,CAAA;IAC/B,kBAAkB;IAClB,gBAAgB,EAAE,OAAO,CAAA;CAC1B;AAcD;;;;;;;;;GASG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAgB3E;AAmCD;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,CAiBxD;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,GAAG,gBAAgB,CActF;AAED,sCAAsC;AACtC,MAAM,WAAW,mBAAmB;IAClC,mCAAmC;IACnC,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,wCAAwC;IACxC,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB,qCAAqC;IACrC,mBAAmB,CAAC,EAAE,MAAM,CAAA;CAC7B;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,mBAAmB,GAAG,MAAM,GAAG,SAAS,CAwCjF"}
|