dsh-mobile-ios 0.2.16 → 0.2.18

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.
@@ -1,430 +1,498 @@
1
- // adapter/mock-host.mjs — 用契约样本驱动宿主(决策 D3:Mock 载体)
2
- // 目的:让客户端与网关在真实宿主不可用时也能跑到端到端;它不模拟"智能",
3
- // 只忠实回放契约里已有的报文形状,避免 UI 在假数据上长歪。
4
-
5
- import { fail, newId } from '../protocol.mjs';
6
- import { createMockData } from './mock-data.mjs';
7
-
8
- export function createMockHost({ log = () => {}, autoPlay = false, speed = 1, data = null } = {}) {
9
- const fixtures = data || createMockData();
10
- const hostInfo = fixtures.hostInfo;
11
- const listBody = fixtures.listBody;
12
- const detail = fixtures.detail;
13
- const createOk = fixtures.createOk;
14
- const messageOk = fixtures.messageOk;
15
- const cancelOk = fixtures.cancelOk;
16
- const artifacts = fixtures.artifacts;
17
- const todoOk = fixtures.todoOk;
18
- const scenario = fixtures.scenario;
19
-
20
- const tasks = new Map(listBody.items.map((t) => [t.taskId, { ...t }]));
21
- // 工作区分组:与 cordis alike,从夹具顶层 workspaces 下发,任务行带同源 id/name。
22
- const workspaces = Array.isArray(listBody.workspaces) ? listBody.workspaces : [];
23
- // 会话动作的 mock 状态(2026-11-18):置顶/归档集合,与桌面端 workspaceRegistry 同语义。
24
- // 列表快照据此带 pinned/archived 标记,长按菜单的「取消置顶/取消归档」才能被验证。
25
- const pinnedIds = new Set();
26
- const archivedIds = new Set();
27
- // 会话设置的 mock 状态(2026-11-17 同步面):权限当前值 + 每任务模型选择。
28
- const sessionModels = new Map();
29
- const MOCK_PERMISSION_OPTIONS = [
30
- { value: 'requireApproval', name: '需审批', description: '每一步写入与命令都需要确认' },
31
- { value: 'autoApprove', name: '自动批准', description: '跳过确认,按默认策略执行' },
32
- { value: 'readOnly', name: '只读', description: '只允许读取,不改动任何文件' },
33
- ];
34
- const MOCK_MODEL_GROUPS = [
35
- {
36
- id: 'deepseek', name: 'DeepSeek',
37
- models: [
38
- { id: 'deepseek-chat', name: 'DeepSeek Chat' },
39
- { id: 'deepseek-reasoner', name: 'DeepSeek Reasoner', defaultEffort: 'medium' },
40
- ],
41
- },
42
- {
43
- id: 'openai', name: 'OpenAI',
44
- models: [{ id: 'gpt-5.2', name: 'GPT-5.2', defaultEffort: 'high' }],
45
- },
46
- ];
47
- const modelOf = (taskId) => sessionModels.get(taskId) ?? { provider: 'deepseek', model: 'deepseek-chat' };
48
- const subscribers = new Set();
49
- const timers = new Set();
50
- let playing = null;
51
-
52
- // 宿主历史记录(2026-11-18 补齐 mock 冷启动历史缺口):
53
- // 之前 mock 没有 events 面,GET /tasks/:id/events 永远 4500,
54
- // 手机端冷启动时间线永远是空的——mock 截图验证不了气泡/时间戳。
55
- // 记录形状与宿主对齐(session-history.mjs 的翻译输入):{type, seq, time(ms), data}。
56
- const history = new Map(); // taskId -> [record]
57
- const record = (taskId, type, data, at) => {
58
- const list = history.get(taskId) ?? [];
59
- list.push({
60
- type,
61
- seq: list.length + 1,
62
- time: at ? Date.parse(at) || Date.now() : Date.now(),
63
- data,
64
- });
65
- history.set(taskId, list);
66
- };
67
-
68
- const emit = (taskId, kind, data, at) => {
69
- // 同步落一份宿主形状的历史记录(只落时间线会渲染的,噪声不搬)。
70
- host.ingestExternal(taskId, kind, data, at);
71
- for (const fn of subscribers) fn({ taskId, kind, data, at });
72
- };
73
-
74
- const clearTimers = () => {
75
- for (const t of timers) clearTimeout(t);
76
- timers.clear();
77
- playing = null;
78
- };
79
-
80
- const host = {
81
- kind: 'mock',
82
- info: () => ({ ...hostInfo, caps: [...hostInfo.caps] }),
83
-
84
- /**
85
- * 外部注入的帧(dev 端点 /__mock/emit 直发 core,绕过 host.emit)也
86
- * 落一份宿主形状的历史记录,保证 events() 与 WS 看到同一个世界。
87
- */
88
- ingestExternal(taskId, kind, data, at) {
89
- if (kind !== 'turn' || !data || typeof data !== 'object') return;
90
- if (data.type === 'user_message') {
91
- record(taskId, 'user/message', {
92
- content: [{ type: 'text', text: String(data.text ?? '') }],
93
- source: { kind: 'user' },
94
- }, at);
95
- } else if (data.type === 'thought_delta') {
96
- record(taskId, 'assistant/message', {
97
- turn: 1,
98
- message: { content: [{ type: 'reasoning', text: String(data.delta ?? '') }] },
99
- }, at);
100
- } else if (data.type === 'assistant_delta') {
101
- record(taskId, 'assistant/message', {
102
- turn: 1,
103
- message: { content: [{ type: 'text', text: String(data.delta ?? '') }] },
104
- }, at);
105
- } else if (data.type === 'tool_call') {
106
- record(taskId, 'tool/call', {
107
- turn: 1, callId: data.callId ?? newId('call'),
108
- name: data.toolName ?? 'tool', arguments: data.argSummary ?? '',
109
- }, at);
110
- } else if (data.type === 'tool_result') {
111
- record(taskId, 'tool/result', {
112
- turn: 1, toolCallId: data.callId ?? newId('call'), name: data.toolName,
113
- content: [{ type: 'text', text: String(data.summary ?? '') }],
114
- }, at);
115
- }
116
- },
117
-
118
- async listTasks({ status, limit = 50, includeArchived = false } = {}) {
119
- // 与 cordis 同口径(桌面端 tree.ts isVisible):置顶优先;
120
- // 子会话 / 空占位不进任务条;归档默认隐藏,只在 includeArchived 视图出现。
121
- const all = [...tasks.values()]
122
- .map((t) => ({ ...t, pinned: pinnedIds.has(t.taskId), archived: archivedIds.has(t.taskId) }))
123
- .filter((t) => !status || t.status === status)
124
- .filter((t) => t.origin !== 'subagent' && !t.parentSessionId)
125
- .filter((t) => !(t.blank === true && t.status !== 'running'))
126
- .filter((t) => (includeArchived ? t.archived : !t.archived));
127
- all.sort((a, b) => (Number(b.pinned) - Number(a.pinned))
128
- || (Date.parse(b.lastActivityAt ?? 0) - Date.parse(a.lastActivityAt ?? 0)));
129
- return {
130
- items: all.slice(0, limit),
131
- workspaces,
132
- nextCursor: null,
133
- serverTime: new Date().toISOString(),
134
- };
135
- },
136
-
137
- async getTask(taskId) {
138
- const t = tasks.get(taskId);
139
- if (!t) throw fail(4011);
140
- const flags = { pinned: pinnedIds.has(taskId), archived: archivedIds.has(taskId) };
141
- if (taskId === detail.task.taskId) {
142
- return { ...detail, task: { ...detail.task, ...t, ...flags }, lastSeq: 0, serverTime: new Date().toISOString() };
143
- }
144
- return {
145
- task: { ...t, ...flags, lastSeq: 0 },
146
- budget: { limitMin: t.budgetMin ?? 10, usedSec: t.elapsedSec ?? 0, remainingSec: 600, warnAt: 480 },
147
- pendingTodos: [],
148
- artifactsPreview: [],
149
- tokenUsage: null,
150
- lastSeq: 0,
151
- serverTime: new Date().toISOString(),
152
- };
153
- },
154
-
155
- async listArtifacts(taskId) {
156
- if (!tasks.has(taskId)) throw fail(4011);
157
- return artifacts;
158
- },
159
-
160
- /** mock 侧不碰磁盘:产物内容是固定文本,够客户端验证「点开→预览」这条链路。 */
161
- async readArtifact(taskId, artifactId) {
162
- if (!tasks.has(taskId)) throw fail(4011);
163
- const item = (artifacts.items ?? []).find((a) => a.artifactId === artifactId);
164
- if (!item) throw fail(4404, '产物不存在');
165
- const body = `# ${item.name}\n\nmock 产物内容(${item.kind})\n`;
166
- return {
167
- name: item.name,
168
- mime: 'text/markdown; charset=utf-8',
169
- sizeBytes: Buffer.byteLength(body),
170
- data: Buffer.from(body, 'utf8'),
171
- };
172
- },
173
-
174
- async createTask({ prompt, title, permission = 'requireApproval', budgetMin = 10, attachments } = {}) {
175
- const taskId = newId('tsk');
176
- tasks.set(taskId, {
177
- taskId,
178
- storedKey: newId('sk'),
179
- title: title || String(prompt).slice(0, 24),
180
- status: 'running',
181
- phase: { index: 1, total: 5, label: '已接收' },
182
- elapsedSec: 0,
183
- startedAt: new Date().toISOString(),
184
- lastActivityAt: new Date().toISOString(),
185
- hostId: hostInfo.hostId,
186
- hostName: hostInfo.hostName,
187
- cwd: '/mock/workspace',
188
- permission,
189
- budgetMin,
190
- needsYou: false,
191
- pendingTodoCount: 0,
192
- artifactsCount: 0,
193
- });
194
- emit(taskId, 'state', { status: 'running', phase: { index: 1, total: 5, label: '已接收' }, elapsedSec: 0, needsYou: false });
195
- log(`host createTask ${taskId}`);
196
- return { ...createOk, taskId, storedKey: tasks.get(taskId).storedKey, acceptedAt: new Date().toISOString() };
197
- },
198
-
199
- async appendMessage(taskId, { text, attachments } = {}) {
200
- if (!tasks.has(taskId)) throw fail(4011);
201
- const turnId = newId('turn');
202
- // 纯附件消息 text 可空;mock 只记元数据(不落字节),供端到端断言送达。
203
- const atts = Array.isArray(attachments) ? attachments : [];
204
- const names = atts.map((a) => a?.name || a?.kind || 'attachment').join('、');
205
- const delta = text
206
- ? `收到:${String(text).slice(0, 40)}`
207
- : `收到附件:${names || '附件'}`;
208
- emit(taskId, 'turn', { turnId, type: 'assistant_delta', delta });
209
- return { ...messageOk, taskId, turnId, acceptedAt: new Date().toISOString() };
210
- },
211
-
212
- /**
213
- * 冷启动历史(FR-CHAT-01):从 emit 落下的宿主形状记录里翻页。
214
- * 记录按 seq 升序返回;beforeSeq 取更早的一页(seq < beforeSeq)。
215
- * mock 数据量小,一页装得下,hasMore 恒 false。
216
- */
217
- async events(taskId, { beforeSeq, limit = 60 } = {}) {
218
- if (!tasks.has(taskId)) throw fail(4011);
219
- const all = history.get(taskId) ?? [];
220
- const filtered = Number.isFinite(beforeSeq) && beforeSeq > 0
221
- ? all.filter((r) => r.seq < beforeSeq)
222
- : all;
223
- const records = filtered.slice(-Math.min(Math.max(limit, 1), 200));
224
- return { taskId, records, hasMore: false };
225
- },
226
-
227
- async cancelTask(taskId) {
228
- const t = tasks.get(taskId);
229
- if (!t) throw fail(4011);
230
- t.status = 'cancelled';
231
- emit(taskId, 'state', { status: 'cancelled', phase: { index: 5, total: 5, label: '已停止' }, elapsedSec: t.elapsedSec ?? 0, needsYou: false });
232
- log(`host cancelTask ${taskId}`);
233
- return { ...cancelOk, taskId, at: new Date().toISOString() };
234
- },
235
-
236
- async answerTodo(taskId, todoId, { decision }) {
237
- if (!tasks.has(taskId)) throw fail(4011);
238
- emit(taskId, 'todo', { todoId, state: 'resolved', decision, resolvedAt: new Date().toISOString() });
239
- return { ...todoOk, taskId, todoId, decision, resolvedAt: new Date().toISOString() };
240
- },
241
-
242
- // MARK: 会话动作(与桌面端右键菜单同源;mock 用内存集合模拟 workspaceRegistry)
243
-
244
- // MARK: 提示词增强(mock 无模型,返回可预期的结构化文本供端到端断言)
245
-
246
- async enhancePrompt({ text } = {}) {
247
- const source = String(text ?? '').trim();
248
- if (!source) throw fail(4400, '待增强的提示词不能为空');
249
- return {
250
- text: `目标:\n${source}\n\n要求:\n1. 先给结论,再给依据。\n2. 保留原文给出的数值、路径与名称。\n3. 输出可直接执行的结果,不要额外解释。`,
251
- provider: 'mock',
252
- model: 'mock-enhance',
253
- finishReason: 'stop',
254
- at: new Date().toISOString(),
255
- };
256
- },
257
-
258
- async pinTask(taskId, { pinned = true } = {}) {
259
- if (!tasks.has(taskId)) throw fail(4011);
260
- if (pinned) pinnedIds.add(taskId); else pinnedIds.delete(taskId);
261
- log(`host ${pinned ? 'pin' : 'unpin'} ${taskId}`);
262
- return {
263
- applied: true, taskId, pinned,
264
- pinnedSessionIds: [...pinnedIds], at: new Date().toISOString(),
265
- };
266
- },
267
-
268
- async archiveTask(taskId, { archived = true, stopActivity = false } = {}) {
269
- const t = tasks.get(taskId);
270
- if (!t) throw fail(4011);
271
- if (archived) {
272
- // 与宿主一致:运行中会话不带 stopActivity 会拒绝(workspace/session-active → 我们用 4007 表达"忙")。
273
- if ((t.status === 'running' || t.status === 'pending') && stopActivity !== true) {
274
- throw fail(4007, '会话正在运行,归档前需先停止', { detail: 'workspace/session-active' });
275
- }
276
- if (stopActivity === true && (t.status === 'running' || t.status === 'pending')) {
277
- t.status = 'cancelled';
278
- }
279
- archivedIds.add(taskId);
280
- pinnedIds.delete(taskId); // 宿主归档时同时取消置顶(client/model.ts installArchived 实证)
281
- } else {
282
- archivedIds.delete(taskId);
283
- }
284
- log(`host ${archived ? 'archive' : 'unarchive'} ${taskId}`);
285
- return {
286
- applied: true, taskId, archived,
287
- archivedSessionIds: [...archivedIds], at: new Date().toISOString(),
288
- };
289
- },
290
-
291
- async renameTask(taskId, { title } = {}) {
292
- const t = tasks.get(taskId);
293
- if (!t) throw fail(4011);
294
- const name = String(title ?? '').trim();
295
- if (!name) throw fail(4400, '标题不能为空');
296
- t.title = name;
297
- t.lastActivityAt = new Date().toISOString();
298
- log(`host rename ${taskId} → ${name}`);
299
- return { applied: true, taskId, title: name, seq: (t.lastSeq ?? 0) + 1, at: new Date().toISOString() };
300
- },
301
-
302
- async forkTask(taskId) {
303
- const t = tasks.get(taskId);
304
- if (!t) throw fail(4011);
305
- const forkedTaskId = newId('tsk');
306
- tasks.set(forkedTaskId, {
307
- ...t, taskId: forkedTaskId, storedKey: newId('sk'),
308
- title: `${t.title}(分叉)`,
309
- status: 'idle', phase: null, startedAt: null, lastActivityAt: new Date().toISOString(),
310
- needsYou: false, pendingTodoCount: 0,
311
- });
312
- log(`host fork ${taskId} → ${forkedTaskId}`);
313
- return { accepted: true, taskId, forkedTaskId, at: new Date().toISOString() };
314
- },
315
-
316
- // MARK: 会话设置同步(与 cordis 适配器同形状;mock 恒 supported,供端到端与回归断言)
317
-
318
- async sessionSettings(taskId) {
319
- if (!tasks.has(taskId)) throw fail(4011);
320
- const selection = modelOf(taskId);
321
- return {
322
- taskId,
323
- permission: {
324
- supported: true,
325
- currentValue: tasks.get(taskId).permission ?? 'requireApproval',
326
- options: MOCK_PERMISSION_OPTIONS,
327
- },
328
- model: {
329
- supported: true,
330
- current: selection,
331
- default: { provider: 'deepseek', model: 'deepseek-chat' },
332
- groups: MOCK_MODEL_GROUPS,
333
- failures: [],
334
- },
335
- serverTime: new Date().toISOString(),
336
- };
337
- },
338
-
339
- async setPermission(taskId, { preset } = {}) {
340
- if (!tasks.has(taskId)) throw fail(4011);
341
- const value = String(preset ?? '').trim();
342
- if (!value) throw fail(4400, 'preset 不能为空');
343
- if (!MOCK_PERMISSION_OPTIONS.some((o) => o.value === value)) {
344
- throw fail(4400, `未知权限预设:${value}`);
345
- }
346
- tasks.get(taskId).permission = value;
347
- log(`host setPermission ${taskId} → ${value}`);
348
- return { applied: true, taskId, value, at: new Date().toISOString() };
349
- },
350
-
351
- async selectModel(taskId, { provider, model, reasoningEffort } = {}) {
352
- if (!tasks.has(taskId)) throw fail(4011);
353
- const providerId = String(provider ?? '').trim();
354
- const modelId = String(model ?? '').trim();
355
- if (!providerId || !modelId) throw fail(4400, 'provider 与 model 不能为空');
356
- const group = MOCK_MODEL_GROUPS.find((g) => g.id === providerId);
357
- if (!group || !group.models.some((m) => m.id === modelId)) {
358
- throw fail(4400, `目录中没有 ${providerId}/${modelId}`);
359
- }
360
- const selection = { provider: providerId, model: modelId };
361
- if (reasoningEffort) selection.reasoningEffort = String(reasoningEffort);
362
- sessionModels.set(taskId, selection);
363
- log(`host selectModel ${taskId} → ${providerId}/${modelId}`);
364
- return { applied: true, taskId, selection, at: new Date().toISOString() };
365
- },
366
-
367
- /**
368
- * 宿主重启钩子(由 GatewayCore.restartHost 调用)。
369
- *
370
- * 真实宿主重启后,在跑的任务不会复活,宿主会把它们标成中断。
371
- * mock 若不建模这一步,列表快照仍报 running,客户端「已中断 · 可续」的降级
372
- * 会被列表覆盖回「运行中」——端到端就验不出 FR-TASK-06。
373
- */
374
- onHostRestart(reason = 'host_restart') {
375
- let affected = 0;
376
- for (const t of tasks.values()) {
377
- if (t.status !== 'running' && t.status !== 'pending') continue;
378
- t.status = 'interrupted';
379
- t.needsYou = false;
380
- t.pendingTodoCount = 0;
381
- t.lastActivityAt = new Date().toISOString();
382
- affected += 1;
383
- // 刻意**不**发事件:调用方紧接着清空环缓冲并断开连接,谁也收不到;
384
- // 发了只会让「重启那一瞬间」的时序变得不可预测。
385
- // 状态由随后的列表快照体现——真实宿主也是这样。
386
- }
387
- log(`host onHostRestart(${reason}) 降级 ${affected} 个运行中任务`);
388
- return affected;
389
- },
390
-
391
- async diag() {
392
- return { adapter: 'mock', data: 'builtin', tasks: tasks.size };
393
- },
394
-
395
- subscribe(fn) {
396
- subscribers.add(fn);
397
- return () => subscribers.delete(fn);
398
- },
399
-
400
- /** 回放契约里的 10 帧事件流(间隔按 speed 缩放),用于验收"实时"而不只是"首屏" */
401
- playScenario(taskId = fixtures.RUNNING_TASK, { speed: s = speed } = {}) {
402
- clearTimers();
403
- playing = taskId;
404
- let acc = 0;
405
- for (const item of scenario.frames || []) {
406
- acc += (item.delayMs || 60) / s;
407
- const t = setTimeout(() => {
408
- timers.delete(t);
409
- emit(taskId, item.frame.kind, item.frame.data, new Date().toISOString());
410
- }, acc);
411
- timers.add(t);
412
- }
413
- const done = setTimeout(() => timers.delete(done), acc + 50);
414
- timers.add(done);
415
- log(`host playScenario ${taskId} frames=${(scenario.frames || []).length}`);
416
- return { playing, frames: (scenario.frames || []).length };
417
- },
418
-
419
- stopScenario: clearTimers,
420
- isPlaying: () => playing,
421
-
422
- async close() {
423
- clearTimers();
424
- subscribers.clear();
425
- },
426
- };
427
-
428
- if (autoPlay) setTimeout(() => host.playScenario(), 50).unref?.();
429
- return host;
430
- }
1
+ // adapter/mock-host.mjs — 用契约样本驱动宿主(决策 D3:Mock 载体)
2
+ // 目的:让客户端与网关在真实宿主不可用时也能跑到端到端;它不模拟"智能",
3
+ // 只忠实回放契约里已有的报文形状,避免 UI 在假数据上长歪。
4
+
5
+ import { fail, newId } from '../protocol.mjs';
6
+ import { createMockData } from './mock-data.mjs';
7
+
8
+ export function createMockHost({ log = () => {}, autoPlay = false, speed = 1, data = null } = {}) {
9
+ const fixtures = data || createMockData();
10
+ const hostInfo = fixtures.hostInfo;
11
+ const listBody = fixtures.listBody;
12
+ const detail = fixtures.detail;
13
+ const createOk = fixtures.createOk;
14
+ const messageOk = fixtures.messageOk;
15
+ const cancelOk = fixtures.cancelOk;
16
+ const artifacts = fixtures.artifacts;
17
+ const todoOk = fixtures.todoOk;
18
+ const scenario = fixtures.scenario;
19
+
20
+ const tasks = new Map(listBody.items.map((t) => [t.taskId, { ...t }]));
21
+ // 工作区分组:与 cordis alike,从夹具顶层 workspaces 下发,任务行带同源 id/name。
22
+ const workspaces = Array.isArray(listBody.workspaces) ? listBody.workspaces : [];
23
+ // 会话动作的 mock 状态(2026-11-18):置顶/归档集合,与桌面端 workspaceRegistry 同语义。
24
+ // 列表快照据此带 pinned/archived 标记,长按菜单的「取消置顶/取消归档」才能被验证。
25
+ const pinnedIds = new Set();
26
+ const archivedIds = new Set();
27
+ // 会话设置的 mock 状态(2026-11-17 同步面):权限当前值 + 每任务模型选择。
28
+ const sessionModels = new Map();
29
+ // 权限目录与桌面端同语义的四档(2026-11-20):只读 → 工作区 → 全权 → 自动审查。
30
+ // 真目录来自宿主 `permissionPresets.catalog()`,里面的键与文案由电脑端配置决定;
31
+ // mock 只是把它摆成桌面端那四档的样子,供设置面板与端到端断言有样本可看。
32
+ const MOCK_PERMISSION_OPTIONS = [
33
+ { value: 'readOnly', name: '仅可查看', description: '只允许读取,不改动任何文件' },
34
+ { value: 'workspaceWrite', name: '工作区内修改', description: '只能改目标工作区,越界需批准' },
35
+ { value: 'fullAccess', name: '完全权限', description: '整个文件系统可写,命令不受限' },
36
+ { value: 'autoReview', name: '自动审查', description: '工具调用自动审查后放行' },
37
+ ];
38
+ const MOCK_MODEL_GROUPS = [
39
+ {
40
+ id: 'deepseek', name: 'DeepSeek',
41
+ models: [
42
+ { id: 'deepseek-chat', name: 'DeepSeek Chat' },
43
+ { id: 'deepseek-reasoner', name: 'DeepSeek Reasoner', defaultEffort: 'medium' },
44
+ ],
45
+ },
46
+ {
47
+ id: 'openai', name: 'OpenAI',
48
+ models: [{ id: 'gpt-5.2', name: 'GPT-5.2', defaultEffort: 'high' }],
49
+ },
50
+ ];
51
+ const modelOf = (taskId) => sessionModels.get(taskId) ?? { provider: 'deepseek', model: 'deepseek-chat' };
52
+ const subscribers = new Set();
53
+ const timers = new Set();
54
+ let playing = null;
55
+
56
+ // 宿主历史记录(2026-11-18 补齐 mock 冷启动历史缺口):
57
+ // 之前 mock 没有 events 面,GET /tasks/:id/events 永远 4500,
58
+ // 手机端冷启动时间线永远是空的——mock 截图验证不了气泡/时间戳。
59
+ // 记录形状与宿主对齐(session-history.mjs 的翻译输入):{type, seq, time(ms), data}。
60
+ const history = new Map(); // taskId -> [record]
61
+ const record = (taskId, type, data, at) => {
62
+ const list = history.get(taskId) ?? [];
63
+ list.push({
64
+ type,
65
+ seq: list.length + 1,
66
+ time: at ? Date.parse(at) || Date.now() : Date.now(),
67
+ data,
68
+ });
69
+ history.set(taskId, list);
70
+ };
71
+
72
+ const emit = (taskId, kind, data, at) => {
73
+ // 同步落一份宿主形状的历史记录(只落时间线会渲染的,噪声不搬)。
74
+ host.ingestExternal(taskId, kind, data, at);
75
+ for (const fn of subscribers) fn({ taskId, kind, data, at });
76
+ };
77
+
78
+ const clearTimers = () => {
79
+ for (const t of timers) clearTimeout(t);
80
+ timers.clear();
81
+ playing = null;
82
+ };
83
+
84
+ const host = {
85
+ kind: 'mock',
86
+ info: () => ({ ...hostInfo, caps: [...hostInfo.caps] }),
87
+
88
+ /**
89
+ * 外部注入的帧(dev 端点 /__mock/emit 直发 core,绕过 host.emit)也
90
+ * 落一份宿主形状的历史记录,保证 events() 与 WS 看到同一个世界。
91
+ */
92
+ ingestExternal(taskId, kind, data, at) {
93
+ if (kind !== 'turn' || !data || typeof data !== 'object') return;
94
+ if (data.type === 'user_message') {
95
+ record(taskId, 'user/message', {
96
+ content: [{ type: 'text', text: String(data.text ?? '') }],
97
+ source: { kind: 'user' },
98
+ }, at);
99
+ } else if (data.type === 'thought_delta') {
100
+ record(taskId, 'assistant/message', {
101
+ turn: 1,
102
+ message: { content: [{ type: 'reasoning', text: String(data.delta ?? '') }] },
103
+ }, at);
104
+ } else if (data.type === 'assistant_delta') {
105
+ record(taskId, 'assistant/message', {
106
+ turn: 1,
107
+ message: { content: [{ type: 'text', text: String(data.delta ?? '') }] },
108
+ }, at);
109
+ } else if (data.type === 'tool_call') {
110
+ record(taskId, 'tool/call', {
111
+ turn: 1, callId: data.callId ?? newId('call'),
112
+ name: data.toolName ?? 'tool', arguments: data.argSummary ?? '',
113
+ }, at);
114
+ } else if (data.type === 'tool_result') {
115
+ record(taskId, 'tool/result', {
116
+ turn: 1, toolCallId: data.callId ?? newId('call'), name: data.toolName,
117
+ content: [{ type: 'text', text: String(data.summary ?? '') }],
118
+ }, at);
119
+ }
120
+ },
121
+
122
+ async listTasks({ status, limit = 50, includeArchived = false } = {}) {
123
+ // 与 cordis 同口径(桌面端 tree.ts isVisible):置顶优先;
124
+ // 子会话 / 空占位不进任务条;归档默认隐藏,只在 includeArchived 视图出现。
125
+ const all = [...tasks.values()]
126
+ .map((t) => ({ ...t, pinned: pinnedIds.has(t.taskId), archived: archivedIds.has(t.taskId) }))
127
+ .filter((t) => !status || t.status === status)
128
+ .filter((t) => t.origin !== 'subagent' && !t.parentSessionId)
129
+ .filter((t) => !(t.blank === true && t.status !== 'running'))
130
+ .filter((t) => (includeArchived ? t.archived : !t.archived));
131
+ all.sort((a, b) => (Number(b.pinned) - Number(a.pinned))
132
+ || (Date.parse(b.lastActivityAt ?? 0) - Date.parse(a.lastActivityAt ?? 0)));
133
+ return {
134
+ items: all.slice(0, limit),
135
+ workspaces,
136
+ nextCursor: null,
137
+ serverTime: new Date().toISOString(),
138
+ };
139
+ },
140
+
141
+ async getTask(taskId) {
142
+ const t = tasks.get(taskId);
143
+ if (!t) throw fail(4011);
144
+ const flags = { pinned: pinnedIds.has(taskId), archived: archivedIds.has(taskId) };
145
+ if (taskId === detail.task.taskId) {
146
+ return { ...detail, task: { ...detail.task, ...t, ...flags }, lastSeq: 0, serverTime: new Date().toISOString() };
147
+ }
148
+ return {
149
+ task: { ...t, ...flags, lastSeq: 0 },
150
+ budget: { limitMin: t.budgetMin ?? 10, usedSec: t.elapsedSec ?? 0, remainingSec: 600, warnAt: 480 },
151
+ pendingTodos: [],
152
+ artifactsPreview: [],
153
+ tokenUsage: null,
154
+ lastSeq: 0,
155
+ serverTime: new Date().toISOString(),
156
+ };
157
+ },
158
+
159
+ async listArtifacts(taskId) {
160
+ if (!tasks.has(taskId)) throw fail(4011);
161
+ return artifacts;
162
+ },
163
+
164
+ /** mock 侧不碰磁盘:产物内容是固定文本,够客户端验证「点开→预览」这条链路。 */
165
+ async readArtifact(taskId, artifactId) {
166
+ if (!tasks.has(taskId)) throw fail(4011);
167
+ const item = (artifacts.items ?? []).find((a) => a.artifactId === artifactId);
168
+ if (!item) throw fail(4404, '产物不存在');
169
+ const body = `# ${item.name}\n\nmock 产物内容(${item.kind})\n`;
170
+ return {
171
+ name: item.name,
172
+ mime: 'text/markdown; charset=utf-8',
173
+ sizeBytes: Buffer.byteLength(body),
174
+ data: Buffer.from(body, 'utf8'),
175
+ };
176
+ },
177
+
178
+ async createTask({ prompt, title, permission, budgetMin = 10, attachments, provider, model } = {}) {
179
+ const taskId = newId('tsk');
180
+ // 新建会话指定模型(2026-11-21):与真宿主同口径,请求了就记进会话并在回执里回显。
181
+ const modelApplied = provider && model ? true : undefined;
182
+ // 新建会话默认权限(2026-11-20):与真宿主同口径——未知预设不建会话,
183
+ // 已知预设就地生效并在回执里说明。缺省按工作区内修改(workspaceWrite)。
184
+ const preset = permission == null ? null : String(permission).trim();
185
+ if (preset && !MOCK_PERMISSION_OPTIONS.some((o) => o.value === preset)) {
186
+ throw fail(4400, `未知权限预设:${preset}`);
187
+ }
188
+ tasks.set(taskId, {
189
+ taskId,
190
+ storedKey: newId('sk'),
191
+ title: title || String(prompt).slice(0, 24),
192
+ status: 'running',
193
+ phase: { index: 1, total: 5, label: '已接收' },
194
+ elapsedSec: 0,
195
+ startedAt: new Date().toISOString(),
196
+ lastActivityAt: new Date().toISOString(),
197
+ hostId: hostInfo.hostId,
198
+ hostName: hostInfo.hostName,
199
+ cwd: '/mock/workspace',
200
+ permission: preset ?? 'workspaceWrite',
201
+ budgetMin,
202
+ needsYou: false,
203
+ pendingTodoCount: 0,
204
+ artifactsCount: 0,
205
+ });
206
+ emit(taskId, 'state', { status: 'running', phase: { index: 1, total: 5, label: '已接收' }, elapsedSec: 0, needsYou: false });
207
+ log(`host createTask ${taskId}`);
208
+ return { ...createOk, taskId, storedKey: tasks.get(taskId).storedKey, acceptedAt: new Date().toISOString(),
209
+ // 与真宿主同形:请求了权限 / 模型才带这些字段。
210
+ permissionApplied: preset ? true : undefined, modelApplied };
211
+ },
212
+
213
+ async appendMessage(taskId, { text, attachments } = {}) {
214
+ if (!tasks.has(taskId)) throw fail(4011);
215
+ const turnId = newId('turn');
216
+ // 纯附件消息 text 可空;mock 只记元数据(不落字节),供端到端断言送达。
217
+ const atts = Array.isArray(attachments) ? attachments : [];
218
+ const names = atts.map((a) => a?.name || a?.kind || 'attachment').join('、');
219
+ const delta = text
220
+ ? `收到:${String(text).slice(0, 40)}`
221
+ : `收到附件:${names || '附件'}`;
222
+ emit(taskId, 'turn', { turnId, type: 'assistant_delta', delta });
223
+ return { ...messageOk, taskId, turnId, acceptedAt: new Date().toISOString() };
224
+ },
225
+
226
+ /**
227
+ * 冷启动历史(FR-CHAT-01):从 emit 落下的宿主形状记录里翻页。
228
+ * 记录按 seq 升序返回;beforeSeq 取更早的一页(seq < beforeSeq)。
229
+ * mock 数据量小,一页装得下,hasMore 恒 false。
230
+ */
231
+ async events(taskId, { beforeSeq, limit = 60 } = {}) {
232
+ if (!tasks.has(taskId)) throw fail(4011);
233
+ const all = history.get(taskId) ?? [];
234
+ const filtered = Number.isFinite(beforeSeq) && beforeSeq > 0
235
+ ? all.filter((r) => r.seq < beforeSeq)
236
+ : all;
237
+ const records = filtered.slice(-Math.min(Math.max(limit, 1), 200));
238
+ return { taskId, records, hasMore: false };
239
+ },
240
+
241
+ async cancelTask(taskId) {
242
+ const t = tasks.get(taskId);
243
+ if (!t) throw fail(4011);
244
+ t.status = 'cancelled';
245
+ emit(taskId, 'state', { status: 'cancelled', phase: { index: 5, total: 5, label: '已停止' }, elapsedSec: t.elapsedSec ?? 0, needsYou: false });
246
+ log(`host cancelTask ${taskId}`);
247
+ return { ...cancelOk, taskId, at: new Date().toISOString() };
248
+ },
249
+
250
+ async answerTodo(taskId, todoId, { decision }) {
251
+ if (!tasks.has(taskId)) throw fail(4011);
252
+ emit(taskId, 'todo', { todoId, state: 'resolved', decision, resolvedAt: new Date().toISOString() });
253
+ return { ...todoOk, taskId, todoId, decision, resolvedAt: new Date().toISOString() };
254
+ },
255
+
256
+ // MARK: 会话动作(与桌面端右键菜单同源;mock 用内存集合模拟 workspaceRegistry)
257
+
258
+ // MARK: 提示词增强(mock 无模型,返回可预期的结构化文本供端到端断言)
259
+
260
+ async enhancePrompt({ text } = {}) {
261
+ const source = String(text ?? '').trim();
262
+ if (!source) throw fail(4400, '待增强的提示词不能为空');
263
+ return {
264
+ text: `目标:\n${source}\n\n要求:\n1. 先给结论,再给依据。\n2. 保留原文给出的数值、路径与名称。\n3. 输出可直接执行的结果,不要额外解释。`,
265
+ provider: 'mock',
266
+ model: 'mock-enhance',
267
+ finishReason: 'stop',
268
+ at: new Date().toISOString(),
269
+ };
270
+ },
271
+
272
+ // 工作区写动作(与桌面端分组右键菜单同源):mock 用内存 workspaces 数组模拟
273
+ // workspaceRegistry,删分组只移除注册、任务行的 workspaceId/Name 清空(落到未分组),
274
+ // 与桌面端 delete.desc「文件与会话保留,会话显示在未分组下」一致。
275
+ async renameWorkspace(workspaceId, { title } = {}) {
276
+ const id = String(workspaceId ?? '').trim();
277
+ const name = String(title ?? '').trim();
278
+ if (!id) throw fail(4400, 'workspaceId 不能为空');
279
+ if (!name) throw fail(4400, '工作区名称不能为空');
280
+ const ws = workspaces.find((w) => String(w.workspaceId ?? w.id) === id);
281
+ if (!ws) throw fail(4011, '工作区不存在', { detail: 'workspace/not-found' });
282
+ // fixture 下发的工作区字段是 {id,name};真实宿主是 {workspaceId,title}。两种都改,
283
+ // 列表快照原样下发 workspaces,改错字段会出现「回执说成功、列表名没变」。
284
+ ws.name = name;
285
+ ws.title = name;
286
+ for (const t of tasks.values()) {
287
+ if (String(t.workspaceId ?? '') === id) t.workspaceName = name;
288
+ }
289
+ log(`host rename workspace ${id} → ${name}`);
290
+ return { applied: true, workspaceId: id, title: name, at: new Date().toISOString() };
291
+ },
292
+
293
+ async deleteWorkspace(workspaceId) {
294
+ const id = String(workspaceId ?? '').trim();
295
+ if (!id) throw fail(4400, 'workspaceId 不能为空');
296
+ const idx = workspaces.findIndex((w) => String(w.workspaceId ?? w.id) === id);
297
+ if (idx < 0) throw fail(4011, '工作区不存在', { detail: 'workspace/not-found' });
298
+ workspaces.splice(idx, 1);
299
+ for (const t of tasks.values()) {
300
+ if (String(t.workspaceId ?? '') === id) {
301
+ t.workspaceId = null;
302
+ t.workspaceName = null;
303
+ }
304
+ }
305
+ log(`host delete workspace ${id}(会话落到未分组,文件保留)`);
306
+ return { applied: true, workspaceId: id, deleted: true, at: new Date().toISOString() };
307
+ },
308
+
309
+ async pinTask(taskId, { pinned = true } = {}) {
310
+ if (!tasks.has(taskId)) throw fail(4011);
311
+ if (pinned) pinnedIds.add(taskId); else pinnedIds.delete(taskId);
312
+ log(`host ${pinned ? 'pin' : 'unpin'} ${taskId}`);
313
+ return {
314
+ applied: true, taskId, pinned,
315
+ pinnedSessionIds: [...pinnedIds], at: new Date().toISOString(),
316
+ };
317
+ },
318
+
319
+ async archiveTask(taskId, { archived = true, stopActivity = false } = {}) {
320
+ const t = tasks.get(taskId);
321
+ if (!t) throw fail(4011);
322
+ if (archived) {
323
+ // 与宿主一致:运行中会话不带 stopActivity 会拒绝(workspace/session-active → 我们用 4007 表达"忙")。
324
+ if ((t.status === 'running' || t.status === 'pending') && stopActivity !== true) {
325
+ throw fail(4007, '会话正在运行,归档前需先停止', { detail: 'workspace/session-active' });
326
+ }
327
+ if (stopActivity === true && (t.status === 'running' || t.status === 'pending')) {
328
+ t.status = 'cancelled';
329
+ }
330
+ archivedIds.add(taskId);
331
+ pinnedIds.delete(taskId); // 宿主归档时同时取消置顶(client/model.ts installArchived 实证)
332
+ } else {
333
+ archivedIds.delete(taskId);
334
+ }
335
+ log(`host ${archived ? 'archive' : 'unarchive'} ${taskId}`);
336
+ return {
337
+ applied: true, taskId, archived,
338
+ archivedSessionIds: [...archivedIds], at: new Date().toISOString(),
339
+ };
340
+ },
341
+
342
+ async renameTask(taskId, { title } = {}) {
343
+ const t = tasks.get(taskId);
344
+ if (!t) throw fail(4011);
345
+ const name = String(title ?? '').trim();
346
+ if (!name) throw fail(4400, '标题不能为空');
347
+ t.title = name;
348
+ t.lastActivityAt = new Date().toISOString();
349
+ log(`host rename ${taskId} → ${name}`);
350
+ return { applied: true, taskId, title: name, seq: (t.lastSeq ?? 0) + 1, at: new Date().toISOString() };
351
+ },
352
+
353
+ async forkTask(taskId) {
354
+ const t = tasks.get(taskId);
355
+ if (!t) throw fail(4011);
356
+ const forkedTaskId = newId('tsk');
357
+ tasks.set(forkedTaskId, {
358
+ ...t, taskId: forkedTaskId, storedKey: newId('sk'),
359
+ title: `${t.title}(分叉)`,
360
+ status: 'idle', phase: null, startedAt: null, lastActivityAt: new Date().toISOString(),
361
+ needsYou: false, pendingTodoCount: 0,
362
+ });
363
+ log(`host fork ${taskId} → ${forkedTaskId}`);
364
+ return { accepted: true, taskId, forkedTaskId, at: new Date().toISOString() };
365
+ },
366
+
367
+ // MARK: 会话设置同步(与 cordis 适配器同形状;mock 恒 supported,供端到端与回归断言)
368
+
369
+ /**
370
+ * App 级设置目录(2026-11-20):进程级权限目录 + 模型目录,不含会话级当前值。
371
+ * mock 恒 supported,端到端才能验「设置面板在没会话时也有目录」。
372
+ */
373
+ async appSettings() {
374
+ return {
375
+ permission: { supported: true, options: MOCK_PERMISSION_OPTIONS },
376
+ model: {
377
+ supported: true,
378
+ default: { provider: 'deepseek', model: 'deepseek-chat' },
379
+ groups: MOCK_MODEL_GROUPS,
380
+ failures: [],
381
+ },
382
+ serverTime: new Date().toISOString(),
383
+ };
384
+ },
385
+
386
+ async sessionSettings(taskId) {
387
+ if (!tasks.has(taskId)) throw fail(4011);
388
+ const selection = modelOf(taskId);
389
+ return {
390
+ taskId,
391
+ permission: {
392
+ supported: true,
393
+ currentValue: tasks.get(taskId).permission ?? 'workspaceWrite',
394
+ options: MOCK_PERMISSION_OPTIONS,
395
+ },
396
+ model: {
397
+ supported: true,
398
+ current: selection,
399
+ default: { provider: 'deepseek', model: 'deepseek-chat' },
400
+ groups: MOCK_MODEL_GROUPS,
401
+ failures: [],
402
+ },
403
+ serverTime: new Date().toISOString(),
404
+ };
405
+ },
406
+
407
+ async setPermission(taskId, { preset } = {}) {
408
+ if (!tasks.has(taskId)) throw fail(4011);
409
+ const value = String(preset ?? '').trim();
410
+ if (!value) throw fail(4400, 'preset 不能为空');
411
+ if (!MOCK_PERMISSION_OPTIONS.some((o) => o.value === value)) {
412
+ throw fail(4400, `未知权限预设:${value}`);
413
+ }
414
+ tasks.get(taskId).permission = value;
415
+ log(`host setPermission ${taskId} → ${value}`);
416
+ return { applied: true, taskId, value, at: new Date().toISOString() };
417
+ },
418
+
419
+ async selectModel(taskId, { provider, model, reasoningEffort } = {}) {
420
+ if (!tasks.has(taskId)) throw fail(4011);
421
+ const providerId = String(provider ?? '').trim();
422
+ const modelId = String(model ?? '').trim();
423
+ if (!providerId || !modelId) throw fail(4400, 'provider 与 model 不能为空');
424
+ const group = MOCK_MODEL_GROUPS.find((g) => g.id === providerId);
425
+ if (!group || !group.models.some((m) => m.id === modelId)) {
426
+ throw fail(4400, `目录中没有 ${providerId}/${modelId}`);
427
+ }
428
+ const selection = { provider: providerId, model: modelId };
429
+ if (reasoningEffort) selection.reasoningEffort = String(reasoningEffort);
430
+ sessionModels.set(taskId, selection);
431
+ log(`host selectModel ${taskId} → ${providerId}/${modelId}`);
432
+ return { applied: true, taskId, selection, at: new Date().toISOString() };
433
+ },
434
+
435
+ /**
436
+ * 宿主重启钩子(由 GatewayCore.restartHost 调用)。
437
+ *
438
+ * 真实宿主重启后,在跑的任务不会复活,宿主会把它们标成中断。
439
+ * mock 若不建模这一步,列表快照仍报 running,客户端「已中断 · 可续」的降级
440
+ * 会被列表覆盖回「运行中」——端到端就验不出 FR-TASK-06。
441
+ */
442
+ onHostRestart(reason = 'host_restart') {
443
+ let affected = 0;
444
+ for (const t of tasks.values()) {
445
+ if (t.status !== 'running' && t.status !== 'pending') continue;
446
+ t.status = 'interrupted';
447
+ t.needsYou = false;
448
+ t.pendingTodoCount = 0;
449
+ t.lastActivityAt = new Date().toISOString();
450
+ affected += 1;
451
+ // 刻意**不**发事件:调用方紧接着清空环缓冲并断开连接,谁也收不到;
452
+ // 发了只会让「重启那一瞬间」的时序变得不可预测。
453
+ // 状态由随后的列表快照体现——真实宿主也是这样。
454
+ }
455
+ log(`host onHostRestart(${reason}) 降级 ${affected} 个运行中任务`);
456
+ return affected;
457
+ },
458
+
459
+ async diag() {
460
+ return { adapter: 'mock', data: 'builtin', tasks: tasks.size };
461
+ },
462
+
463
+ subscribe(fn) {
464
+ subscribers.add(fn);
465
+ return () => subscribers.delete(fn);
466
+ },
467
+
468
+ /** 回放契约里的 10 帧事件流(间隔按 speed 缩放),用于验收"实时"而不只是"首屏" */
469
+ playScenario(taskId = fixtures.RUNNING_TASK, { speed: s = speed } = {}) {
470
+ clearTimers();
471
+ playing = taskId;
472
+ let acc = 0;
473
+ for (const item of scenario.frames || []) {
474
+ acc += (item.delayMs || 60) / s;
475
+ const t = setTimeout(() => {
476
+ timers.delete(t);
477
+ emit(taskId, item.frame.kind, item.frame.data, new Date().toISOString());
478
+ }, acc);
479
+ timers.add(t);
480
+ }
481
+ const done = setTimeout(() => timers.delete(done), acc + 50);
482
+ timers.add(done);
483
+ log(`host playScenario ${taskId} frames=${(scenario.frames || []).length}`);
484
+ return { playing, frames: (scenario.frames || []).length };
485
+ },
486
+
487
+ stopScenario: clearTimers,
488
+ isPlaying: () => playing,
489
+
490
+ async close() {
491
+ clearTimers();
492
+ subscribers.clear();
493
+ },
494
+ };
495
+
496
+ if (autoPlay) setTimeout(() => host.playScenario(), 50).unref?.();
497
+ return host;
498
+ }