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.
- package/LICENSE +21 -21
- package/README.md +311 -284
- package/cordis.patch.yml +20 -20
- package/entries/plugin.mjs +197 -223
- package/entries/sidecar.mjs +92 -111
- package/lib/client.js +1754 -1621
- package/lib/vendor/qrcode-generator.cjs +2297 -2297
- package/lib/vendor/qrcode-utf8.cjs +26 -26
- package/package.json +3 -2
- package/src/adapter/artifacts.mjs +235 -235
- package/src/adapter/cordis-host.mjs +1444 -1225
- package/src/adapter/mock-host.mjs +498 -430
- package/src/adapter/mux-host.mjs +99 -99
- package/src/adapter/session-history.mjs +241 -241
- package/src/cloudflare.mjs +735 -698
- package/src/dns-label.mjs +32 -32
- package/src/dns-probe.mjs +110 -110
- package/src/file-log.mjs +68 -68
- package/src/gateway.mjs +285 -285
- package/src/host-name.mjs +42 -0
- package/src/pairing.mjs +300 -300
- package/src/protocol.mjs +59 -59
- package/src/provision-local.mjs +883 -560
- package/src/provision-select.mjs +105 -0
- package/src/rest.mjs +958 -894
- package/src/ring.mjs +148 -148
- package/src/server.mjs +246 -246
- package/src/tunnel-error.mjs +91 -0
- package/src/tunnel-state.mjs +122 -0
- package/src/tunnel.mjs +544 -544
- package/src/version.mjs +24 -24
- package/src/ws.mjs +332 -332
- package/src/zone-health.mjs +430 -251
|
@@ -1,1225 +1,1444 @@
|
|
|
1
|
-
// adapter/cordis-host.mjs — 真实宿主适配器(X2 方法表,2026-11-16 考古闭环)
|
|
2
|
-
//
|
|
3
|
-
// 证据链(全部来自 app.asar 反编译核对,见 RUNBOOK §10):
|
|
4
|
-
// · 宿主业务通过 Typert RPC 动作暴露:session/list | state | create | prompt |
|
|
5
|
-
// cancel | follow | events …(@deepseek-ai/dsh-api-session-controller,服务名
|
|
6
|
-
// `sessionController`,namespace "session");
|
|
7
|
-
// · 对外传输 = 宿主 Gateway(服务名 `typertGateway`)把 RPC 挂在 webServer 的
|
|
8
|
-
// WebSocket `/api` 上(RemoteStreamMuxServer——「mux」的真身);历史上推测的
|
|
9
|
-
// `/api/remote.mux` HTTP 端点**不存在**(asar 内 16 处 mux 命中全是 tmux-context);
|
|
10
|
-
// · 我们的插件与控制器同处宿主进程、同一个 cordis 上下文树——loader 给插件的是
|
|
11
|
-
// 根上下文的子上下文,服务向上解析,因此**进程内直取服务**是最短且受信任
|
|
12
|
-
// (principalOf:非 Remote 调用视同 owner)的路径。本适配器即此路径。
|
|
13
|
-
//
|
|
14
|
-
// 纪律(ADR-12 不变):这一层是唯一允许出现宿主服务的地方;
|
|
15
|
-
// 映射不到的方法显式抛 4021,绝不假装成功。
|
|
16
|
-
|
|
17
|
-
import
|
|
18
|
-
import
|
|
19
|
-
import {
|
|
20
|
-
import {
|
|
21
|
-
import { translateLiveEvent } from './session-history.mjs';
|
|
22
|
-
import { deriveArtifacts, decodeArtifactId, mimeOf } from './artifacts.mjs';
|
|
23
|
-
|
|
24
|
-
// 宿主 RemoteError.code → 我们的协议错误码。
|
|
25
|
-
// 宿主码来自 dsh-typert-protocol / 各控制器源码(gateway/bad-request、
|
|
26
|
-
// session/not-found、session/agent-busy、workspace/not-found 等)。
|
|
27
|
-
const HOST_CODE_MAP = {
|
|
28
|
-
'session/not-found': 4011,
|
|
29
|
-
'workspace/not-found': 4011,
|
|
30
|
-
'session/agent-busy': 4007,
|
|
31
|
-
'session/wait-timeout': 4007,
|
|
32
|
-
'gateway/bad-request': 4400,
|
|
33
|
-
'gateway/internal': 4500,
|
|
34
|
-
'gateway/signature-invalid': 4400,
|
|
35
|
-
'gateway/context-unavailable': 4021,
|
|
36
|
-
};
|
|
37
|
-
|
|
38
|
-
/** 宿主服务名清单(诊断与 services 证据用;来源:各控制器 `static inject` 与 super(ctx, 名))。 */
|
|
39
|
-
const WATCHED_SERVICES = [
|
|
40
|
-
'sessionController', 'jobController', 'workspaceController',
|
|
41
|
-
'terminalController', 'settingsController', 'remoteAccess',
|
|
42
|
-
'agents', 'sessions', 'sessionQuery', 'sessionProjections', 'llm', 'typert',
|
|
43
|
-
// 2026-11-17 会话设置同步:权限目录(permissionPresets)与斜杠命令面(commands,
|
|
44
|
-
// 权限切换实证 = 会话命令 `/permission <preset>`,与桌面端 PermissionSelect 同一条写路径)。
|
|
45
|
-
'permissionPresets', 'commands',
|
|
46
|
-
// 2026-11-18 附件上送:图片内联 prompt,通用文件经 fileUploads.uploadStream 换 receiptId。
|
|
47
|
-
'fileUploads',
|
|
48
|
-
// 2026-11-18 会话动作(置顶/归档):权威集合来自 workspaceRegistry(feed.ts 同源),
|
|
49
|
-
// workspaceController 提供 pinSession/archiveSession 等写动作。
|
|
50
|
-
'workspaceRegistry', 'workspaceController',
|
|
51
|
-
];
|
|
52
|
-
|
|
53
|
-
/**
|
|
54
|
-
* cordis 适配器**实际提供**的协议能力(caps 语义与 mock 对齐:客户端据此判 UI)。
|
|
55
|
-
* 如实边界:todos.answer / events.resume 未映射(4021),绝不虚报;
|
|
56
|
-
* ws.ticket 由网关统一并入(server.mjs GATEWAY_CAPS)。
|
|
57
|
-
*
|
|
58
|
-
* artifacts.read 是 2026-11-17 新加的:宿主没有「会话产物」端点,但会话事件里
|
|
59
|
-
* 的写类工具调用带完整路径,配上 session/list 给的 cwd 就能核对出真文件
|
|
60
|
-
* (见 artifacts.mjs)。能列、能下载,才敢写进 caps。
|
|
61
|
-
*
|
|
62
|
-
* tasks.settings 是同日新增:权限当前值/目录 + 模型目录/切换(见 sessionSettings)。
|
|
63
|
-
*/
|
|
64
|
-
const SERVED_CAPS = [
|
|
65
|
-
'tasks.read', 'tasks.write', 'tasks.cancel', 'artifacts.read', 'tasks.settings',
|
|
66
|
-
// 2026-11-18:与桌面端右键菜单同源的会话动作(置顶/归档/重命名/分叉/复制 ID)。
|
|
67
|
-
// 复制 ID 纯客户端,不需要宿主能力;这里声明的四个都需要宿主动作可达。
|
|
68
|
-
'tasks.sessionActions',
|
|
69
|
-
// 2026-11-18:提示词增强(真调宿主 llm,一次性补全)。客户端据此点亮增强按钮。
|
|
70
|
-
'prompt.enhance',
|
|
71
|
-
];
|
|
72
|
-
|
|
73
|
-
function isHostRemoteError(err) {
|
|
74
|
-
return err && typeof err === 'object' && err.isDSHRemoteError === true;
|
|
75
|
-
}
|
|
76
|
-
|
|
77
|
-
function toGatewayError(err, method) {
|
|
78
|
-
if (isHostRemoteError(err)) {
|
|
79
|
-
const code = HOST_CODE_MAP[err.code] ?? 4500;
|
|
80
|
-
return fail(code, code === 4500 ? `宿主错误:${err.code}` : undefined, {
|
|
81
|
-
detail: `host=${err.code} method=${method}`,
|
|
82
|
-
hostCode: err.code,
|
|
83
|
-
});
|
|
84
|
-
}
|
|
85
|
-
return fail(4500, `宿主调用异常`, { detail: `method=${method} ${err?.message || String(err)}` });
|
|
86
|
-
}
|
|
87
|
-
|
|
88
|
-
/** 从 cwd 取展示标题(宿主 summary 不带标题;标题投影在 projections 里,命中即用)。 */
|
|
89
|
-
function deriveTitle(summary) {
|
|
90
|
-
const projTitle = summary?.projections?.values?.title ?? summary?.projections?.title;
|
|
91
|
-
if (typeof projTitle === 'string' && projTitle.trim()) return projTitle.trim();
|
|
92
|
-
const cwd = typeof summary?.cwd === 'string' ? summary.cwd : '';
|
|
93
|
-
if (cwd) {
|
|
94
|
-
const base = cwd.split('/').filter(Boolean).pop();
|
|
95
|
-
if (base) return base;
|
|
96
|
-
}
|
|
97
|
-
const id = String(summary?.sessionId ?? '');
|
|
98
|
-
return `会话 ${id.slice(-6)}`;
|
|
99
|
-
}
|
|
100
|
-
|
|
101
|
-
/**
|
|
102
|
-
* 宿主会话 summary → 我们的 TaskSummary。
|
|
103
|
-
* status 映射(v1 如实边界):
|
|
104
|
-
* · running === true → running
|
|
105
|
-
* · agentAvailable 但没在跑 → idle(「空闲 · 可续」)
|
|
106
|
-
* · 冷会话同样进 listTasks(映射为 idle)——手机侧栏与桌面端同口径,
|
|
107
|
-
*
|
|
108
|
-
* 为什么不能把「没在跑」写成 interrupted:宿主 summary 只有
|
|
109
|
-
* `{sessionId, updatedAt, agentAvailable, running, blank, cwd, projections}`,
|
|
110
|
-
* **没有「上一回合是被打断的、还是正常说完的」这个事实**。把两者合并成 interrupted,
|
|
111
|
-
* 结果是每个空闲会话都顶着「已中断 · 可续」的告警徽标——用户看到的是「怎么老是中断」
|
|
112
|
-
* (2026-11-17 真机反馈,起因就是这里)。真正被打断只在我们能观测到证据时才说:
|
|
113
|
-
* 客户端侧监听 WS gen 变化,把「原本 running 的任务」降级为 interrupted(FR-TASK-06)。
|
|
114
|
-
*
|
|
115
|
-
* needsYou/pendingTodoCount v1 恒 false/0:宿主 summary 不暴露审批态,不编造。
|
|
116
|
-
*/
|
|
117
|
-
/**
|
|
118
|
-
* 从会话事件推导「最近一轮」的 token 用量。
|
|
119
|
-
*
|
|
120
|
-
* 宿主的权威字段取自 app.asar 实证:`assistant/message` 的 `data.usage`
|
|
121
|
-
* (或 stream 里最后一段 usage),形状是
|
|
122
|
-
* `{ inputTokens, outputTokens, totalTokens, cacheReadTokens, cacheWriteTokens }`。
|
|
123
|
-
* 同一轮可能有多次尝试(step),每个 step 取最后一次采样,跨 step 求和——
|
|
124
|
-
* 与宿主 `dsh-token-meter/turn-usage.ts` 的 deriveTurnTokenUsage 同口径。
|
|
125
|
-
* 拿不到就返回 null:面板只能如实省略,不能编一个数字。
|
|
126
|
-
*/
|
|
127
|
-
function latestTurnUsage(records) {
|
|
128
|
-
const events = (Array.isArray(records) ? records : [])
|
|
129
|
-
.map((r) => r?.event ?? r)
|
|
130
|
-
.filter((e) => e && typeof e === 'object');
|
|
131
|
-
let endIdx = -1;
|
|
132
|
-
for (let i = events.length - 1; i >= 0; i -= 1) {
|
|
133
|
-
if (events[i].type === 'turn/end') { endIdx = i; break; }
|
|
134
|
-
}
|
|
135
|
-
if (endIdx < 0) return null;
|
|
136
|
-
const turn = events[endIdx].data?.turn;
|
|
137
|
-
let startIdx = 0;
|
|
138
|
-
if (turn !== undefined) {
|
|
139
|
-
for (let i = endIdx - 1; i >= 0; i -= 1) {
|
|
140
|
-
if (events[i].type === 'turn/start' && events[i].data?.turn === turn) { startIdx = i; break; }
|
|
141
|
-
}
|
|
142
|
-
}
|
|
143
|
-
const isCount = (v) => typeof v === 'number' && Number.isFinite(v) && v >= 0;
|
|
144
|
-
const streamUsage = (stream) => {
|
|
145
|
-
if (!Array.isArray(stream)) return null;
|
|
146
|
-
for (let i = stream.length - 1; i >= 0; i -= 1) {
|
|
147
|
-
if (stream[i]?.usage && isCount(stream[i].usage.inputTokens)) return stream[i].usage;
|
|
148
|
-
}
|
|
149
|
-
return null;
|
|
150
|
-
};
|
|
151
|
-
const samples = new Map();
|
|
152
|
-
for (let i = startIdx; i <= endIdx; i += 1) {
|
|
153
|
-
const e = events[i];
|
|
154
|
-
if (e.type !== 'assistant/message') continue;
|
|
155
|
-
const d = e.data ?? {};
|
|
156
|
-
const u = d.usage ?? streamUsage(d.stream);
|
|
157
|
-
if (!isCount(u?.inputTokens) || !isCount(u?.outputTokens)) continue;
|
|
158
|
-
samples.set(String(d.step ?? '0'), u);
|
|
159
|
-
}
|
|
160
|
-
if (!samples.size) return null;
|
|
161
|
-
let totalTokens = 0;
|
|
162
|
-
let inputTokens = 0;
|
|
163
|
-
let outputTokens = 0;
|
|
164
|
-
let cacheReadTokens = 0;
|
|
165
|
-
let cacheWriteTokens = 0;
|
|
166
|
-
for (const u of samples.values()) {
|
|
167
|
-
inputTokens += u.inputTokens;
|
|
168
|
-
outputTokens += u.outputTokens;
|
|
169
|
-
totalTokens += isCount(u.totalTokens) ? u.totalTokens : u.inputTokens + u.outputTokens;
|
|
170
|
-
if (isCount(u.cacheReadTokens)) cacheReadTokens += u.cacheReadTokens;
|
|
171
|
-
if (isCount(u.cacheWriteTokens)) cacheWriteTokens += u.cacheWriteTokens;
|
|
172
|
-
}
|
|
173
|
-
return { totalTokens, inputTokens, outputTokens, cacheReadTokens, cacheWriteTokens };
|
|
174
|
-
}
|
|
175
|
-
|
|
176
|
-
function summaryToTask(summary, hostName, workspaceIndex = null) {
|
|
177
|
-
const running = summary.running === true;
|
|
178
|
-
const workspace = workspaceIndex?.bySession.get(String(summary.sessionId));
|
|
179
|
-
return {
|
|
180
|
-
taskId: summary.sessionId,
|
|
181
|
-
title: deriveTitle(summary),
|
|
182
|
-
status: running ? 'running' : 'idle',
|
|
183
|
-
// 宿主 list 只给 running / agentAvailable,没有阶段进度——**不编**。
|
|
184
|
-
// 之前拼的「第 5/5 步 · 已中断·可续」既不是宿主事实,又和状态标签重复,
|
|
185
|
-
// 手机端会读成「连不上」,实际只是会话被宿主重启打断(2026-11-16 修复)。
|
|
186
|
-
phase: null,
|
|
187
|
-
startedAt: null,
|
|
188
|
-
lastActivityAt: typeof summary.updatedAt === 'number' ? new Date(summary.updatedAt).toISOString() : null,
|
|
189
|
-
hostId: 'host_cordis',
|
|
190
|
-
hostName,
|
|
191
|
-
cwd: summary.cwd ?? null,
|
|
192
|
-
// 桌面侧栏的工作区分组(workspaceRegistry.list() 的 title/sessionIds)。
|
|
193
|
-
// 没有归属的会话留 null,手机端归到「未分组」——与 tree.ts 的 UNGROUPED_KEY 同口径。
|
|
194
|
-
workspaceId: workspace?.id ?? null,
|
|
195
|
-
workspaceName: workspace?.title ?? null,
|
|
196
|
-
needsYou: false,
|
|
197
|
-
pendingTodoCount: 0,
|
|
198
|
-
artifactsCount: 0,
|
|
199
|
-
// 宿主侧痕迹字段,诊断与测试用(协议允许额外字段;iOS 解码忽略未知键)
|
|
200
|
-
hostAgentAvailable: summary.agentAvailable === true,
|
|
201
|
-
};
|
|
202
|
-
}
|
|
203
|
-
|
|
204
|
-
/**
|
|
205
|
-
* 清洗模型输出:模型偶尔会把整段包成代码块,或加一句「以下是增强后的提示词:」。
|
|
206
|
-
* 只做这两类**确定性**剥离,不去猜测正文边界。
|
|
207
|
-
*/
|
|
208
|
-
function unwrapEnhancedText(raw) {
|
|
209
|
-
let text = String(raw ?? '').trim();
|
|
210
|
-
if (!text) return '';
|
|
211
|
-
const fenced = text.match(/^```[a-zA-Z0-9_-]*\n([\s\S]*?)\n?```$/);
|
|
212
|
-
if (fenced) text = fenced[1].trim();
|
|
213
|
-
const lines = text.split('\n');
|
|
214
|
-
if (lines.length > 1) {
|
|
215
|
-
const first = lines[0].trim();
|
|
216
|
-
if (first.length <= 24 && /[::]\s*$/.test(first)
|
|
217
|
-
&& /^(以下是|下面是|这是|增强后|改写后|优化后|好的)/.test(first)) {
|
|
218
|
-
text = lines.slice(1).join('\n').trim();
|
|
219
|
-
}
|
|
220
|
-
}
|
|
221
|
-
return text;
|
|
222
|
-
}
|
|
223
|
-
|
|
224
|
-
export function createCordisHost({ ctx, log = () => {}, hostname =
|
|
225
|
-
if (!ctx || (typeof ctx.get !== 'function' && typeof ctx !== 'object')) {
|
|
226
|
-
throw new Error('createCordisHost 需要 cordis 上下文(ctx)');
|
|
227
|
-
}
|
|
228
|
-
|
|
229
|
-
/** 解析宿主服务:cordis 服务在子上下文上向上解析;取不到显式 4021。 */
|
|
230
|
-
function service(name, method) {
|
|
231
|
-
let svc;
|
|
232
|
-
try {
|
|
233
|
-
svc = typeof ctx.get === 'function' ? ctx.get(name) : undefined;
|
|
234
|
-
if (svc === undefined || svc === null) svc = ctx[name];
|
|
235
|
-
} catch {
|
|
236
|
-
/* get 抛错视为不可用,走下方统一 4021 */
|
|
237
|
-
}
|
|
238
|
-
if (svc === undefined || svc === null) {
|
|
239
|
-
throw fail(4021, `宿主服务 ${name} 不可用(方法 ${method} 无法执行)`, {
|
|
240
|
-
detail: `service=${name}`,
|
|
241
|
-
});
|
|
242
|
-
}
|
|
243
|
-
return svc;
|
|
244
|
-
}
|
|
245
|
-
|
|
246
|
-
/** 统一执行宿主调用:错误翻译 + 永不外抛。协议自身的 GatewayError 原样透传。 */
|
|
247
|
-
async function call(method, fn) {
|
|
248
|
-
try {
|
|
249
|
-
return await fn();
|
|
250
|
-
} catch (err) {
|
|
251
|
-
if (err instanceof GatewayError) throw err;
|
|
252
|
-
const translated = toGatewayError(err, method);
|
|
253
|
-
log(`cordis ${method} 失败:${translated.code ?? 'unknown'}`);
|
|
254
|
-
throw translated;
|
|
255
|
-
}
|
|
256
|
-
}
|
|
257
|
-
|
|
258
|
-
let requestIdOf = null;
|
|
259
|
-
|
|
260
|
-
// MARK: 实时事件流(v2)
|
|
261
|
-
//
|
|
262
|
-
// 为什么是轮询而不是订阅:宿主确实有推送面(sessionController.observeEvent/2、
|
|
263
|
-
// observeState/2),但它们的请求形状没有取证过——猜错就是「静默不推送」,
|
|
264
|
-
// 比不做更糟。而 events(request) 的契约已经在 X2 里跑通(冷启动历史用的就是它),
|
|
265
|
-
// 所以实时这条先按 1.2s 轮询落地:手机的观感是「一两秒内出现」,不是「一片死寂」。
|
|
266
|
-
//
|
|
267
|
-
// 关键取舍:**首轮只记水位,不补历史**。任务的历史由 REST /tasks/:id/events 提供,
|
|
268
|
-
// 实时通道只负责「从现在起新发生的」。否则每次重连都会把 40 条旧事件重推一遍,
|
|
269
|
-
// 手机端时间线会整段重复。
|
|
270
|
-
const LIVE_POLL_MS = 1200;
|
|
271
|
-
const LIVE_KEEP_MS = 10 * 60_000; // 停下来的任务再观察 10 分钟,收尾帧不至于丢
|
|
272
|
-
const LIVE_PAGE = 40;
|
|
273
|
-
|
|
274
|
-
const watched = new Map(); // sessionId → { hostSeq|null, running, lastActiveAt }
|
|
275
|
-
let liveListener = null;
|
|
276
|
-
let liveTimer = null;
|
|
277
|
-
let liveBusy = false;
|
|
278
|
-
let liveFirstOk = false;
|
|
279
|
-
|
|
280
|
-
/**
|
|
281
|
-
* 把一个会话放进观察集。
|
|
282
|
-
*
|
|
283
|
-
* `baseline` = 「这次写操作**之前**宿主已经到哪了」。手机刚发出的那条指令,
|
|
284
|
-
* 宿主通常在我们 markWatched 之前就写进了事件日志;如果此时把水位设成「当前最大值」,
|
|
285
|
-
* 这条指令自己会被当成历史跳过——用户看到的是「我问了,它答了,但我的问题不见了」。
|
|
286
|
-
* 所以写操作路径必须带上写前水位。
|
|
287
|
-
*/
|
|
288
|
-
function markWatched(taskId, baseline) {
|
|
289
|
-
if (!taskId) return;
|
|
290
|
-
const existing = watched.get(taskId);
|
|
291
|
-
if (existing) {
|
|
292
|
-
if (typeof baseline === 'number' && existing.hostSeq !== null) {
|
|
293
|
-
existing.hostSeq = Math.min(existing.hostSeq, baseline);
|
|
294
|
-
}
|
|
295
|
-
existing.lastActiveAt = Date.now();
|
|
296
|
-
return;
|
|
297
|
-
}
|
|
298
|
-
// 轮询发现的新会话没有 baseline:水位留空,首轮设成当前最大值(历史由 REST 给)。
|
|
299
|
-
watched.set(taskId, {
|
|
300
|
-
hostSeq: typeof baseline === 'number' ? baseline : null,
|
|
301
|
-
running: null,
|
|
302
|
-
lastActiveAt: Date.now(),
|
|
303
|
-
});
|
|
304
|
-
}
|
|
305
|
-
|
|
306
|
-
/** 写前水位:读最新一条事件的 seq(读不到就返回 0,等于「从头观察」)。 */
|
|
307
|
-
async function preWriteSeq(taskId) {
|
|
308
|
-
try {
|
|
309
|
-
const page = await eventPage(taskId, { maxMessages: 1 });
|
|
310
|
-
const latest = page.records
|
|
311
|
-
.map((r) => (r && r.event ? r.event : r))
|
|
312
|
-
.filter((e) => e && typeof e.seq === 'number')
|
|
313
|
-
.reduce((max, e) => Math.max(max, e.seq), 0);
|
|
314
|
-
return latest;
|
|
315
|
-
} catch {
|
|
316
|
-
return 0;
|
|
317
|
-
}
|
|
318
|
-
}
|
|
319
|
-
|
|
320
|
-
async function pollTaskEvents(taskId) {
|
|
321
|
-
const page = await eventPage(taskId, { maxMessages: LIVE_PAGE });
|
|
322
|
-
const records = page.records.map((r) => (r && r.event ? r.event : r)).filter(Boolean);
|
|
323
|
-
let maxSeq = 0;
|
|
324
|
-
for (const e of records) if (typeof e.seq === 'number') maxSeq = Math.max(maxSeq, e.seq);
|
|
325
|
-
|
|
326
|
-
const state = watched.get(taskId) ?? { hostSeq: null, running: null, lastActiveAt: Date.now() };
|
|
327
|
-
if (state.hostSeq === null) {
|
|
328
|
-
state.hostSeq = maxSeq;
|
|
329
|
-
watched.set(taskId, state);
|
|
330
|
-
return;
|
|
331
|
-
}
|
|
332
|
-
|
|
333
|
-
const fresh = records.filter((e) => (typeof e.seq === 'number' ? e.seq : 0) > state.hostSeq);
|
|
334
|
-
// 宿主日志按 seq 升序;万一不是,也保证手机端按发生顺序追加。
|
|
335
|
-
fresh.sort((a, b) => (a.seq ?? 0) - (b.seq ?? 0));
|
|
336
|
-
let pushed = 0;
|
|
337
|
-
for (const event of fresh) {
|
|
338
|
-
for (const frame of translateLiveEvent(event)) {
|
|
339
|
-
liveListener?.({ taskId, ...frame });
|
|
340
|
-
pushed += 1;
|
|
341
|
-
}
|
|
342
|
-
}
|
|
343
|
-
if (pushed > 0) log(`live push ${taskId} +${pushed} 帧(宿主 seq ${state.hostSeq}→${maxSeq})`);
|
|
344
|
-
if (fresh.length) state.lastActiveAt = Date.now();
|
|
345
|
-
state.hostSeq = Math.max(state.hostSeq, maxSeq);
|
|
346
|
-
watched.set(taskId, state);
|
|
347
|
-
}
|
|
348
|
-
|
|
349
|
-
async function pollLive() {
|
|
350
|
-
if (liveBusy || !liveListener) return;
|
|
351
|
-
liveBusy = true;
|
|
352
|
-
try {
|
|
353
|
-
const summaries = await summaryList();
|
|
354
|
-
const now = Date.now();
|
|
355
|
-
|
|
356
|
-
for (const s of summaries) {
|
|
357
|
-
if (s.running === true) markWatched(s.sessionId);
|
|
358
|
-
const state = watched.get(s.sessionId);
|
|
359
|
-
if (!state) continue;
|
|
360
|
-
const running = s.running === true;
|
|
361
|
-
// 状态翻转立刻推一帧:手机端的「运行中 / 空闲」不该等列表刷新。
|
|
362
|
-
if (state.running !== running) {
|
|
363
|
-
state.running = running;
|
|
364
|
-
state.lastActiveAt = now;
|
|
365
|
-
liveListener?.({ taskId: s.sessionId, kind: 'state', data: { status: running ? 'running' : 'idle' } });
|
|
366
|
-
}
|
|
367
|
-
}
|
|
368
|
-
|
|
369
|
-
for (const [taskId, state] of [...watched]) {
|
|
370
|
-
if (now - state.lastActiveAt > LIVE_KEEP_MS) {
|
|
371
|
-
watched.delete(taskId);
|
|
372
|
-
continue;
|
|
373
|
-
}
|
|
374
|
-
try {
|
|
375
|
-
await pollTaskEvents(taskId);
|
|
376
|
-
} catch (err) {
|
|
377
|
-
// 单个会话读失败(正在被压缩 / 刚建还没落盘)不该拖垮整轮;
|
|
378
|
-
// 退避一件事:把它挪出观察集,下轮重新按 running 进入。
|
|
379
|
-
if (err instanceof GatewayError && err.code === 4011) watched.delete(taskId);
|
|
380
|
-
log(`live poll ${taskId} 失败:${err?.code ?? err?.message ?? 'unknown'}`);
|
|
381
|
-
}
|
|
382
|
-
}
|
|
383
|
-
if (!liveFirstOk) {
|
|
384
|
-
liveFirstOk = true;
|
|
385
|
-
log(`live poll ok(首轮成功,观察 ${watched.size} 个会话)`);
|
|
386
|
-
}
|
|
387
|
-
} catch (err) {
|
|
388
|
-
// 启动瞬间服务还没挂上(sessionController 尚未 provide)是常态,
|
|
389
|
-
// 每 1.2s 会再试,不必惊动用户;但要在日志里看得见。
|
|
390
|
-
log(`live poll 失败:${err?.message ?? String(err)}`);
|
|
391
|
-
} finally {
|
|
392
|
-
liveBusy = false;
|
|
393
|
-
}
|
|
394
|
-
}
|
|
395
|
-
|
|
396
|
-
/** RPC 双参方法(payload, signal)的 signal:宿主内部会 throwIfAborted,缺省直接炸。 */
|
|
397
|
-
const RPC_TIMEOUT_MS = 30_000;
|
|
398
|
-
const rpcSignal = () => AbortSignal.timeout(RPC_TIMEOUT_MS);
|
|
399
|
-
|
|
400
|
-
/**
|
|
401
|
-
* 提示词增强(2026-11-18,真调模型)。
|
|
402
|
-
*
|
|
403
|
-
* 宿主 `ctx.llm` 就挂在本进程的 cordis 上下文上——网关是宿主内插件,可以直接
|
|
404
|
-
* `llm.stream()` 做一次性补全,**不需要**走 Remote RPC。这也是为什么之前只能
|
|
405
|
-
* 做本地规则:宿主没有把补全能力暴露成 @Remote 动作,但服务对象本身是可用的。
|
|
406
|
-
*
|
|
407
|
-
* 模型取 `modelCatalog.default`(宿主「未配置会话用的默认模型」);客户端可以
|
|
408
|
-
* 显式传 provider/model 覆盖(例如用当前会话已选的模型)。
|
|
409
|
-
*
|
|
410
|
-
* system prompt 的做法借鉴 WorkBuddy 的 `llm:enhancePrompt`(同一台机器上的
|
|
411
|
-
* 产品实证):语言一致性最高优先、只补全不改写意图、控制篇幅、只输出正文。
|
|
412
|
-
*/
|
|
413
|
-
const ENHANCE_INPUT_LIMIT = 4000;
|
|
414
|
-
const ENHANCE_TIMEOUT_MS = 60_000;
|
|
415
|
-
const ENHANCE_SYSTEM_PROMPT = [
|
|
416
|
-
'你是资深提示词工程师。把用户给的粗略想法改写成一条清晰、可执行、可直接交给 AI 执行的提示词。',
|
|
417
|
-
'',
|
|
418
|
-
'规则(按优先级):',
|
|
419
|
-
'1. 语言一致:输入中文就输出中文,输入英文就输出英文;代码、命令、路径、专有名词保持原样,不要翻译。',
|
|
420
|
-
'2. 保留原意:只做澄清与补全,不新增用户没有表达的需求;原文没有的细节不要编造,宁可留空也不要编一个具体值。',
|
|
421
|
-
'3. 结构化:按需组织为「目标 → 关键约束与上下文 → 期望输出(格式/范围/验收标准)」。原文很短时不要套空模板,两三句讲清即可。',
|
|
422
|
-
'4. 具体可执行:把模糊措辞换成可验证的要求(例如「快一点」→「首屏渲染 < 1 秒」)。用户已给出的数值、路径、名称必须原样保留。',
|
|
423
|
-
'5. 控制篇幅:一般不超过原文的 3 倍,且不超过 600 字。原文已经足够清晰时只做最小润色,不要为了显得「增强」而灌水。',
|
|
424
|
-
'6. 只输出改写后的提示词正文:不要解释、不要前言、不要「以下是」之类的话、不要用代码块包整段、不要回答提示词里提出的问题。',
|
|
425
|
-
].join('\n');
|
|
426
|
-
|
|
427
|
-
/**
|
|
428
|
-
* 把移动端附件翻译成宿主 prompt 的 content block(2026-11-18)。
|
|
429
|
-
*
|
|
430
|
-
* 两份证据都来自 app.asar 反编译(见 spike0/RUNBOOK §10):
|
|
431
|
-
* · `sessionController.prompt` 的 content 是 text/image/file 三种 block 的联合,
|
|
432
|
-
* image = `{type:'image', mediaType:'image/png|jpeg|webp|gif', data:base64, name?}`,
|
|
433
|
-
* file = `{type:'file', receiptId}`;
|
|
434
|
-
* · 图片走 `admitPromptContent` 直接规范化持久化,可内联 base64;
|
|
435
|
-
* 通用文件必须先拿 receiptId——`fileUploads.uploadStream({sessionId, data, name})`
|
|
436
|
-
* 是非 Remote 方法、从 request.sessionId 自己解析 agent,进程内直调最稳。
|
|
437
|
-
*
|
|
438
|
-
* 不认识的 mediaType 一律按通用文件处理,不猜、不丢。
|
|
439
|
-
*/
|
|
440
|
-
const INLINE_IMAGE_TYPES = new Set(['image/png', 'image/jpeg', 'image/webp', 'image/gif']);
|
|
441
|
-
|
|
442
|
-
async function attachmentBlocks(sessionId, attachments) {
|
|
443
|
-
if (!Array.isArray(attachments) || attachments.length === 0) return [];
|
|
444
|
-
const blocks = [];
|
|
445
|
-
for (const att of attachments) {
|
|
446
|
-
const name = typeof att?.name === 'string' && att.name ? att.name : 'attachment';
|
|
447
|
-
const data = typeof att?.dataBase64 === 'string' ? att.dataBase64 : '';
|
|
448
|
-
if (!data) throw fail(4400, `附件 ${name} 缺少数据`);
|
|
449
|
-
if (att.kind === 'image' && INLINE_IMAGE_TYPES.has(att.mediaType)) {
|
|
450
|
-
blocks.push({ type: 'image', mediaType: att.mediaType, data, name });
|
|
451
|
-
continue;
|
|
452
|
-
}
|
|
453
|
-
// 通用文件:字节 → async iterable → uploadStream → receiptId。
|
|
454
|
-
let bytes;
|
|
455
|
-
try {
|
|
456
|
-
bytes = Buffer.from(data, 'base64');
|
|
457
|
-
} catch {
|
|
458
|
-
throw fail(4400, `附件 ${name} 的 base64 不合法`);
|
|
459
|
-
}
|
|
460
|
-
if (bytes.length === 0) throw fail(4400, `附件 ${name} 解码后为空`);
|
|
461
|
-
const fileUploads = service('fileUploads', 'attachments.upload');
|
|
462
|
-
async function* chunks() {
|
|
463
|
-
const CHUNK = 64 * 1024;
|
|
464
|
-
for (let i = 0; i < bytes.length; i += CHUNK) {
|
|
465
|
-
yield new Uint8Array(bytes.subarray(i, i + CHUNK));
|
|
466
|
-
}
|
|
467
|
-
}
|
|
468
|
-
const staged = await call('fileUploads.uploadStream', () =>
|
|
469
|
-
fileUploads.uploadStream({ sessionId, data: chunks(), name }));
|
|
470
|
-
const receiptId = staged?.receiptId;
|
|
471
|
-
if (!receiptId) throw fail(4500, '宿主上传附件未返回 receiptId');
|
|
472
|
-
blocks.push({ type: 'file', receiptId });
|
|
473
|
-
}
|
|
474
|
-
return blocks;
|
|
475
|
-
}
|
|
476
|
-
|
|
477
|
-
/**
|
|
478
|
-
* 提交用户指令。mode 合法值考古实证只有 `steer` / `append`
|
|
479
|
-
* (client.js:input.mode==='steer'?'steering':'queued')——
|
|
480
|
-
* 此前的 'queue' 是无效值,宿主直接拒绝:手机发消息卡「发送中」、
|
|
481
|
-
* 新建任务桌面无反应的根因。steer 先试(运行中注入当前回合),
|
|
482
|
-
* 非会话不存在类失败退 append(排队/续话)。
|
|
483
|
-
*
|
|
484
|
-
* @param {string|undefined} text 可为空(纯附件消息),但 content 不能空。
|
|
485
|
-
* @param {Array} attachments 已翻译成 block;调用方先经 attachmentBlocks。
|
|
486
|
-
*/
|
|
487
|
-
async function submitPrompt(ctrl, sessionId, text, extraBlocks = []) {
|
|
488
|
-
requestIdOf = crypto.randomUUID();
|
|
489
|
-
const content = [
|
|
490
|
-
...(text ? [{ type: 'text', text }] : []),
|
|
491
|
-
...extraBlocks,
|
|
492
|
-
];
|
|
493
|
-
if (content.length === 0) throw fail(4400, 'prompt content 不能为空');
|
|
494
|
-
const payload = (mode) => ({
|
|
495
|
-
requestId: requestIdOf,
|
|
496
|
-
sessionId,
|
|
497
|
-
mode,
|
|
498
|
-
content,
|
|
499
|
-
clientTimeZone: Intl.DateTimeFormat().resolvedOptions().timeZone,
|
|
500
|
-
});
|
|
501
|
-
try {
|
|
502
|
-
await ctrl.prompt(payload('steer'), rpcSignal());
|
|
503
|
-
} catch (err) {
|
|
504
|
-
const hostCode = isHostRemoteError(err) ? err.code : '';
|
|
505
|
-
if (hostCode === 'session/not-found' || hostCode === 'workspace/not-found') throw err;
|
|
506
|
-
await ctrl.prompt(payload('append'), rpcSignal());
|
|
507
|
-
}
|
|
508
|
-
}
|
|
509
|
-
|
|
510
|
-
async function summaryList() {
|
|
511
|
-
const ctrl = service('sessionController', 'session/list');
|
|
512
|
-
const raw = await ctrl.list({}, rpcSignal());
|
|
513
|
-
// 宿主 session.list({}) 走信封 {ok, value:{items}}(考古 client.js 实证);
|
|
514
|
-
// 兼容裸数组与其他常见信封键,命中路径记到 host.listEnvelope 供 diag 取证。
|
|
515
|
-
const candidates = [
|
|
516
|
-
['array', Array.isArray(raw) ? raw : null],
|
|
517
|
-
['value.items', Array.isArray(raw?.value?.items) ? raw.value.items : null],
|
|
518
|
-
['items', Array.isArray(raw?.items) ? raw.items : null],
|
|
519
|
-
['sessions', Array.isArray(raw?.sessions) ? raw.sessions : null],
|
|
520
|
-
['values', Array.isArray(raw?.values) ? raw.values : null],
|
|
521
|
-
['list', Array.isArray(raw?.list) ? raw.list : null],
|
|
522
|
-
];
|
|
523
|
-
const hit = candidates.find(([, v]) => v !== null);
|
|
524
|
-
if (!hit) {
|
|
525
|
-
const shape = raw === null || raw === undefined
|
|
526
|
-
? String(raw)
|
|
527
|
-
: typeof raw !== 'object'
|
|
528
|
-
? `${typeof raw}`
|
|
529
|
-
: `keys=[${Object.keys(raw).join(',')}]; `
|
|
530
|
-
+ Object.entries(raw).map(([k, v]) => `${k}:${Array.isArray(v) ? 'array' : typeof v}`).join(', ');
|
|
531
|
-
throw fail(4500, '宿主 session/list 返回了非数组', { detail: shape });
|
|
532
|
-
}
|
|
533
|
-
host.listEnvelope = hit[0];
|
|
534
|
-
return hit[1];
|
|
535
|
-
}
|
|
536
|
-
|
|
537
|
-
/**
|
|
538
|
-
* 会话历史页(FR-CHAT-01 冷启动数据源)。
|
|
539
|
-
* 宿主契约(app.asar typert 实证):sessionController.events(request, signal),
|
|
540
|
-
* request = { address:{kind:'session',sessionId}, beforeSeq?, throughSeq?, maxMessages?, turnWindow? }
|
|
541
|
-
* → { records:[{event}], hasMore, projections, assistantStream? }
|
|
542
|
-
*/
|
|
543
|
-
async function eventPage(taskId, { beforeSeq, maxMessages = 60 } = {}) {
|
|
544
|
-
const ctrl = service('sessionController', 'session/events');
|
|
545
|
-
const request = { address: { kind: 'session', sessionId: taskId }, maxMessages };
|
|
546
|
-
if (Number.isFinite(beforeSeq) && beforeSeq > 0) request.beforeSeq = beforeSeq;
|
|
547
|
-
const raw = await ctrl.events(request, rpcSignal());
|
|
548
|
-
const page = raw && typeof raw === 'object' && raw.value && typeof raw.value === 'object'
|
|
549
|
-
? raw.value
|
|
550
|
-
: raw;
|
|
551
|
-
const records = Array.isArray(page?.records) ? page.records : [];
|
|
552
|
-
// 形状取证:首条记录的键名/type/seq 记进 diag,供翻译层对齐(不落内容)。
|
|
553
|
-
if (records.length && !host.eventShape) {
|
|
554
|
-
const ev = records[0]?.event ?? records[0];
|
|
555
|
-
host.eventShape = `keys=${Object.keys(ev || {}).join(',')} type=${ev?.type} seq=${ev?.seq}`;
|
|
556
|
-
log(`cordis events 形状: ${host.eventShape}`);
|
|
557
|
-
}
|
|
558
|
-
return { records, hasMore: Boolean(page?.hasMore) };
|
|
559
|
-
}
|
|
560
|
-
|
|
561
|
-
/**
|
|
562
|
-
* X2 取证:宿主服务方法面(方法名/形参个数)。只暴露元信息,
|
|
563
|
-
* 不含任何会话内容——用于核对 prompt/create 等动作的真实签名。
|
|
564
|
-
*/
|
|
565
|
-
function methodSurface(svc) {
|
|
566
|
-
if (!svc || (typeof svc !== 'object' && typeof svc !== 'function')) return null;
|
|
567
|
-
const names = new Set();
|
|
568
|
-
let proto = svc;
|
|
569
|
-
for (let depth = 0; depth < 3 && proto && proto !== Object.prototype; depth += 1) {
|
|
570
|
-
for (const n of Object.getOwnPropertyNames(proto)) names.add(n);
|
|
571
|
-
proto = Object.getPrototypeOf(proto);
|
|
572
|
-
}
|
|
573
|
-
return [...names].filter((n) => {
|
|
574
|
-
try { return typeof svc[n] === 'function'; } catch { return false; }
|
|
575
|
-
}).map((n) => {
|
|
576
|
-
try { return `${n}/${svc[n].length}`; } catch { return n; }
|
|
577
|
-
}).sort();
|
|
578
|
-
}
|
|
579
|
-
|
|
580
|
-
/** 会话的工作目录。产物定位、路径收边都靠它;宿主没给就如实返回 null。 */
|
|
581
|
-
async function taskCwd(taskId) {
|
|
582
|
-
const summaries = await summaryList();
|
|
583
|
-
const summary = summaries.find((s) => s.sessionId === taskId);
|
|
584
|
-
if (!summary) throw fail(4011);
|
|
585
|
-
return summary.cwd ?? null;
|
|
586
|
-
}
|
|
587
|
-
|
|
588
|
-
/**
|
|
589
|
-
* 会话产物清单(推导)。`getTask` 与 `listArtifacts` 共用同一条口径,
|
|
590
|
-
* 免得「详情页说没有产物、产物面板里却有五个」这种两处各说各话。
|
|
591
|
-
*/
|
|
592
|
-
async function taskArtifacts(taskId) {
|
|
593
|
-
const cwd = await taskCwd(taskId);
|
|
594
|
-
if (!cwd) return { items: [], hasMore: false, reason: 'host 未提供工作目录(cwd 为空)' };
|
|
595
|
-
const page = await eventPage(taskId, { maxMessages: 200 });
|
|
596
|
-
const { items, skipped } = deriveArtifacts(page.records, { cwd });
|
|
597
|
-
return { items, hasMore: false, skipped };
|
|
598
|
-
}
|
|
599
|
-
|
|
600
|
-
// MARK: 会话设置同步辅助(权限 / 模型,方法体在 host 对象内)
|
|
601
|
-
|
|
602
|
-
/** 宿主返回值统一解信封:{ok:true,value} 直接取 value,其余原样(list 已实证这个形状)。 */
|
|
603
|
-
function unwrapHost(raw) {
|
|
604
|
-
return raw && typeof raw === 'object' && raw.ok === true && 'value' in raw ? raw.value : raw;
|
|
605
|
-
}
|
|
606
|
-
|
|
607
|
-
/** 会话投影(权限当前值 / 模型选择)。拿不到返回 null,不影响其他面。 */
|
|
608
|
-
async function readProjections(taskId) {
|
|
609
|
-
const ctrl = service('sessionController', 'session/projections');
|
|
610
|
-
const raw = await ctrl.projections({ sessionId: taskId }, rpcSignal());
|
|
611
|
-
return unwrapHost(raw);
|
|
612
|
-
}
|
|
613
|
-
|
|
614
|
-
/**
|
|
615
|
-
|
|
616
|
-
|
|
617
|
-
|
|
618
|
-
|
|
619
|
-
|
|
620
|
-
|
|
621
|
-
|
|
622
|
-
|
|
623
|
-
|
|
624
|
-
|
|
625
|
-
|
|
626
|
-
|
|
627
|
-
|
|
628
|
-
|
|
629
|
-
|
|
630
|
-
|
|
631
|
-
|
|
632
|
-
|
|
633
|
-
|
|
634
|
-
|
|
635
|
-
|
|
636
|
-
|
|
637
|
-
|
|
638
|
-
|
|
639
|
-
|
|
640
|
-
|
|
641
|
-
|
|
642
|
-
|
|
643
|
-
|
|
644
|
-
|
|
645
|
-
|
|
646
|
-
|
|
647
|
-
|
|
648
|
-
}
|
|
649
|
-
|
|
650
|
-
|
|
651
|
-
|
|
652
|
-
|
|
653
|
-
|
|
654
|
-
|
|
655
|
-
|
|
656
|
-
|
|
657
|
-
|
|
658
|
-
|
|
659
|
-
|
|
660
|
-
|
|
661
|
-
|
|
662
|
-
|
|
663
|
-
|
|
664
|
-
|
|
665
|
-
|
|
666
|
-
|
|
667
|
-
|
|
668
|
-
|
|
669
|
-
|
|
670
|
-
|
|
671
|
-
|
|
672
|
-
|
|
673
|
-
|
|
674
|
-
|
|
675
|
-
|
|
676
|
-
|
|
677
|
-
|
|
678
|
-
|
|
679
|
-
|
|
680
|
-
|
|
681
|
-
|
|
682
|
-
|
|
683
|
-
|
|
684
|
-
|
|
685
|
-
|
|
686
|
-
|
|
687
|
-
|
|
688
|
-
|
|
689
|
-
|
|
690
|
-
|
|
691
|
-
|
|
692
|
-
|
|
693
|
-
|
|
694
|
-
|
|
695
|
-
|
|
696
|
-
|
|
697
|
-
|
|
698
|
-
|
|
699
|
-
|
|
700
|
-
});
|
|
701
|
-
return {
|
|
702
|
-
|
|
703
|
-
|
|
704
|
-
|
|
705
|
-
|
|
706
|
-
|
|
707
|
-
|
|
708
|
-
|
|
709
|
-
|
|
710
|
-
|
|
711
|
-
|
|
712
|
-
|
|
713
|
-
|
|
714
|
-
|
|
715
|
-
|
|
716
|
-
|
|
717
|
-
|
|
718
|
-
|
|
719
|
-
|
|
720
|
-
|
|
721
|
-
|
|
722
|
-
|
|
723
|
-
|
|
724
|
-
|
|
725
|
-
|
|
726
|
-
|
|
727
|
-
|
|
728
|
-
|
|
729
|
-
|
|
730
|
-
|
|
731
|
-
|
|
732
|
-
|
|
733
|
-
|
|
734
|
-
|
|
735
|
-
|
|
736
|
-
|
|
737
|
-
|
|
738
|
-
|
|
739
|
-
|
|
740
|
-
|
|
741
|
-
|
|
742
|
-
|
|
743
|
-
|
|
744
|
-
|
|
745
|
-
|
|
746
|
-
|
|
747
|
-
|
|
748
|
-
|
|
749
|
-
|
|
750
|
-
|
|
751
|
-
|
|
752
|
-
|
|
753
|
-
|
|
754
|
-
|
|
755
|
-
|
|
756
|
-
|
|
757
|
-
|
|
758
|
-
|
|
759
|
-
|
|
760
|
-
|
|
761
|
-
|
|
762
|
-
|
|
763
|
-
|
|
764
|
-
|
|
765
|
-
|
|
766
|
-
|
|
767
|
-
|
|
768
|
-
|
|
769
|
-
|
|
770
|
-
|
|
771
|
-
|
|
772
|
-
|
|
773
|
-
|
|
774
|
-
|
|
775
|
-
|
|
776
|
-
|
|
777
|
-
|
|
778
|
-
|
|
779
|
-
|
|
780
|
-
|
|
781
|
-
|
|
782
|
-
|
|
783
|
-
|
|
784
|
-
|
|
785
|
-
|
|
786
|
-
|
|
787
|
-
|
|
788
|
-
|
|
789
|
-
|
|
790
|
-
|
|
791
|
-
|
|
792
|
-
|
|
793
|
-
|
|
794
|
-
|
|
795
|
-
|
|
796
|
-
|
|
797
|
-
|
|
798
|
-
|
|
799
|
-
|
|
800
|
-
|
|
801
|
-
|
|
802
|
-
|
|
803
|
-
|
|
804
|
-
|
|
805
|
-
|
|
806
|
-
//
|
|
807
|
-
//
|
|
808
|
-
|
|
809
|
-
|
|
810
|
-
|
|
811
|
-
|
|
812
|
-
|
|
813
|
-
|
|
814
|
-
|
|
815
|
-
|
|
816
|
-
|
|
817
|
-
|
|
818
|
-
|
|
819
|
-
|
|
820
|
-
|
|
821
|
-
|
|
822
|
-
|
|
823
|
-
|
|
824
|
-
|
|
825
|
-
|
|
826
|
-
|
|
827
|
-
|
|
828
|
-
|
|
829
|
-
|
|
830
|
-
const
|
|
831
|
-
//
|
|
832
|
-
|
|
833
|
-
|
|
834
|
-
//
|
|
835
|
-
|
|
836
|
-
|
|
837
|
-
|
|
838
|
-
//
|
|
839
|
-
|
|
840
|
-
|
|
841
|
-
//
|
|
842
|
-
//
|
|
843
|
-
//
|
|
844
|
-
|
|
845
|
-
|
|
846
|
-
|
|
847
|
-
|
|
848
|
-
|
|
849
|
-
|
|
850
|
-
|
|
851
|
-
|
|
852
|
-
|
|
853
|
-
|
|
854
|
-
|
|
855
|
-
|
|
856
|
-
|
|
857
|
-
|
|
858
|
-
|
|
859
|
-
|
|
860
|
-
|
|
861
|
-
|
|
862
|
-
|
|
863
|
-
|
|
864
|
-
|
|
865
|
-
|
|
866
|
-
|
|
867
|
-
|
|
868
|
-
|
|
869
|
-
|
|
870
|
-
|
|
871
|
-
|
|
872
|
-
|
|
873
|
-
|
|
874
|
-
|
|
875
|
-
|
|
876
|
-
|
|
877
|
-
|
|
878
|
-
|
|
879
|
-
|
|
880
|
-
|
|
881
|
-
|
|
882
|
-
|
|
883
|
-
|
|
884
|
-
|
|
885
|
-
|
|
886
|
-
|
|
887
|
-
|
|
888
|
-
|
|
889
|
-
|
|
890
|
-
|
|
891
|
-
|
|
892
|
-
|
|
893
|
-
|
|
894
|
-
|
|
895
|
-
|
|
896
|
-
|
|
897
|
-
|
|
898
|
-
|
|
899
|
-
|
|
900
|
-
|
|
901
|
-
|
|
902
|
-
|
|
903
|
-
}
|
|
904
|
-
|
|
905
|
-
|
|
906
|
-
|
|
907
|
-
|
|
908
|
-
|
|
909
|
-
|
|
910
|
-
|
|
911
|
-
|
|
912
|
-
|
|
913
|
-
|
|
914
|
-
|
|
915
|
-
|
|
916
|
-
|
|
917
|
-
|
|
918
|
-
|
|
919
|
-
|
|
920
|
-
|
|
921
|
-
|
|
922
|
-
|
|
923
|
-
|
|
924
|
-
|
|
925
|
-
|
|
926
|
-
|
|
927
|
-
|
|
928
|
-
|
|
929
|
-
|
|
930
|
-
|
|
931
|
-
|
|
932
|
-
|
|
933
|
-
|
|
934
|
-
|
|
935
|
-
|
|
936
|
-
|
|
937
|
-
|
|
938
|
-
|
|
939
|
-
|
|
940
|
-
|
|
941
|
-
|
|
942
|
-
|
|
943
|
-
|
|
944
|
-
|
|
945
|
-
|
|
946
|
-
|
|
947
|
-
|
|
948
|
-
|
|
949
|
-
|
|
950
|
-
|
|
951
|
-
|
|
952
|
-
|
|
953
|
-
|
|
954
|
-
|
|
955
|
-
|
|
956
|
-
|
|
957
|
-
|
|
958
|
-
|
|
959
|
-
|
|
960
|
-
|
|
961
|
-
|
|
962
|
-
|
|
963
|
-
|
|
964
|
-
|
|
965
|
-
|
|
966
|
-
|
|
967
|
-
|
|
968
|
-
|
|
969
|
-
|
|
970
|
-
|
|
971
|
-
|
|
972
|
-
|
|
973
|
-
|
|
974
|
-
|
|
975
|
-
|
|
976
|
-
|
|
977
|
-
|
|
978
|
-
|
|
979
|
-
const ctrl = service('
|
|
980
|
-
|
|
981
|
-
|
|
982
|
-
const
|
|
983
|
-
|
|
984
|
-
|
|
985
|
-
|
|
986
|
-
|
|
987
|
-
|
|
988
|
-
|
|
989
|
-
|
|
990
|
-
|
|
991
|
-
|
|
992
|
-
|
|
993
|
-
|
|
994
|
-
|
|
995
|
-
|
|
996
|
-
|
|
997
|
-
|
|
998
|
-
|
|
999
|
-
|
|
1000
|
-
|
|
1001
|
-
|
|
1002
|
-
|
|
1003
|
-
|
|
1004
|
-
|
|
1005
|
-
|
|
1006
|
-
|
|
1007
|
-
|
|
1008
|
-
|
|
1009
|
-
|
|
1010
|
-
|
|
1011
|
-
|
|
1012
|
-
|
|
1013
|
-
|
|
1014
|
-
|
|
1015
|
-
|
|
1016
|
-
|
|
1017
|
-
|
|
1018
|
-
|
|
1019
|
-
|
|
1020
|
-
|
|
1021
|
-
|
|
1022
|
-
|
|
1023
|
-
|
|
1024
|
-
|
|
1025
|
-
|
|
1026
|
-
const
|
|
1027
|
-
|
|
1028
|
-
|
|
1029
|
-
|
|
1030
|
-
|
|
1031
|
-
|
|
1032
|
-
|
|
1033
|
-
|
|
1034
|
-
|
|
1035
|
-
|
|
1036
|
-
|
|
1037
|
-
|
|
1038
|
-
|
|
1039
|
-
|
|
1040
|
-
|
|
1041
|
-
|
|
1042
|
-
|
|
1043
|
-
|
|
1044
|
-
|
|
1045
|
-
|
|
1046
|
-
|
|
1047
|
-
|
|
1048
|
-
|
|
1049
|
-
|
|
1050
|
-
|
|
1051
|
-
|
|
1052
|
-
|
|
1053
|
-
|
|
1054
|
-
|
|
1055
|
-
|
|
1056
|
-
|
|
1057
|
-
|
|
1058
|
-
|
|
1059
|
-
|
|
1060
|
-
|
|
1061
|
-
|
|
1062
|
-
|
|
1063
|
-
|
|
1064
|
-
|
|
1065
|
-
|
|
1066
|
-
|
|
1067
|
-
|
|
1068
|
-
|
|
1069
|
-
|
|
1070
|
-
|
|
1071
|
-
|
|
1072
|
-
|
|
1073
|
-
|
|
1074
|
-
|
|
1075
|
-
|
|
1076
|
-
|
|
1077
|
-
|
|
1078
|
-
|
|
1079
|
-
|
|
1080
|
-
|
|
1081
|
-
|
|
1082
|
-
|
|
1083
|
-
|
|
1084
|
-
|
|
1085
|
-
|
|
1086
|
-
|
|
1087
|
-
|
|
1088
|
-
|
|
1089
|
-
|
|
1090
|
-
|
|
1091
|
-
|
|
1092
|
-
|
|
1093
|
-
|
|
1094
|
-
|
|
1095
|
-
|
|
1096
|
-
|
|
1097
|
-
|
|
1098
|
-
|
|
1099
|
-
|
|
1100
|
-
|
|
1101
|
-
|
|
1102
|
-
|
|
1103
|
-
|
|
1104
|
-
|
|
1105
|
-
|
|
1106
|
-
|
|
1107
|
-
|
|
1108
|
-
|
|
1109
|
-
|
|
1110
|
-
|
|
1111
|
-
|
|
1112
|
-
|
|
1113
|
-
|
|
1114
|
-
|
|
1115
|
-
|
|
1116
|
-
|
|
1117
|
-
|
|
1118
|
-
|
|
1119
|
-
|
|
1120
|
-
|
|
1121
|
-
|
|
1122
|
-
|
|
1123
|
-
|
|
1124
|
-
|
|
1125
|
-
|
|
1126
|
-
|
|
1127
|
-
|
|
1128
|
-
|
|
1129
|
-
|
|
1130
|
-
|
|
1131
|
-
|
|
1132
|
-
|
|
1133
|
-
|
|
1134
|
-
|
|
1135
|
-
|
|
1136
|
-
|
|
1137
|
-
|
|
1138
|
-
|
|
1139
|
-
|
|
1140
|
-
|
|
1141
|
-
|
|
1142
|
-
|
|
1143
|
-
|
|
1144
|
-
|
|
1145
|
-
|
|
1146
|
-
|
|
1147
|
-
|
|
1148
|
-
|
|
1149
|
-
|
|
1150
|
-
at: new Date().toISOString()
|
|
1151
|
-
};
|
|
1152
|
-
}
|
|
1153
|
-
|
|
1154
|
-
|
|
1155
|
-
|
|
1156
|
-
|
|
1157
|
-
|
|
1158
|
-
|
|
1159
|
-
|
|
1160
|
-
|
|
1161
|
-
|
|
1162
|
-
|
|
1163
|
-
|
|
1164
|
-
|
|
1165
|
-
|
|
1166
|
-
|
|
1167
|
-
|
|
1168
|
-
|
|
1169
|
-
|
|
1170
|
-
|
|
1171
|
-
|
|
1172
|
-
|
|
1173
|
-
|
|
1174
|
-
|
|
1175
|
-
|
|
1176
|
-
|
|
1177
|
-
|
|
1178
|
-
|
|
1179
|
-
|
|
1180
|
-
|
|
1181
|
-
|
|
1182
|
-
|
|
1183
|
-
|
|
1184
|
-
|
|
1185
|
-
|
|
1186
|
-
|
|
1187
|
-
|
|
1188
|
-
|
|
1189
|
-
|
|
1190
|
-
|
|
1191
|
-
|
|
1192
|
-
|
|
1193
|
-
|
|
1194
|
-
|
|
1195
|
-
|
|
1196
|
-
|
|
1197
|
-
|
|
1198
|
-
|
|
1199
|
-
|
|
1200
|
-
|
|
1201
|
-
|
|
1202
|
-
|
|
1203
|
-
|
|
1204
|
-
|
|
1205
|
-
|
|
1206
|
-
|
|
1207
|
-
|
|
1208
|
-
|
|
1209
|
-
|
|
1210
|
-
|
|
1211
|
-
|
|
1212
|
-
|
|
1213
|
-
|
|
1214
|
-
|
|
1215
|
-
|
|
1216
|
-
|
|
1217
|
-
|
|
1218
|
-
|
|
1219
|
-
|
|
1220
|
-
|
|
1221
|
-
|
|
1222
|
-
|
|
1223
|
-
|
|
1224
|
-
|
|
1225
|
-
|
|
1
|
+
// adapter/cordis-host.mjs — 真实宿主适配器(X2 方法表,2026-11-16 考古闭环)
|
|
2
|
+
//
|
|
3
|
+
// 证据链(全部来自 app.asar 反编译核对,见 RUNBOOK §10):
|
|
4
|
+
// · 宿主业务通过 Typert RPC 动作暴露:session/list | state | create | prompt |
|
|
5
|
+
// cancel | follow | events …(@deepseek-ai/dsh-api-session-controller,服务名
|
|
6
|
+
// `sessionController`,namespace "session");
|
|
7
|
+
// · 对外传输 = 宿主 Gateway(服务名 `typertGateway`)把 RPC 挂在 webServer 的
|
|
8
|
+
// WebSocket `/api` 上(RemoteStreamMuxServer——「mux」的真身);历史上推测的
|
|
9
|
+
// `/api/remote.mux` HTTP 端点**不存在**(asar 内 16 处 mux 命中全是 tmux-context);
|
|
10
|
+
// · 我们的插件与控制器同处宿主进程、同一个 cordis 上下文树——loader 给插件的是
|
|
11
|
+
// 根上下文的子上下文,服务向上解析,因此**进程内直取服务**是最短且受信任
|
|
12
|
+
// (principalOf:非 Remote 调用视同 owner)的路径。本适配器即此路径。
|
|
13
|
+
//
|
|
14
|
+
// 纪律(ADR-12 不变):这一层是唯一允许出现宿主服务的地方;
|
|
15
|
+
// 映射不到的方法显式抛 4021,绝不假装成功。
|
|
16
|
+
|
|
17
|
+
import crypto from 'node:crypto';
|
|
18
|
+
import { readFileSync, statSync } from 'node:fs';
|
|
19
|
+
import { fail, GatewayError } from '../protocol.mjs';
|
|
20
|
+
import { displayHostName } from '../host-name.mjs';
|
|
21
|
+
import { translateLiveEvent } from './session-history.mjs';
|
|
22
|
+
import { deriveArtifacts, decodeArtifactId, mimeOf } from './artifacts.mjs';
|
|
23
|
+
|
|
24
|
+
// 宿主 RemoteError.code → 我们的协议错误码。
|
|
25
|
+
// 宿主码来自 dsh-typert-protocol / 各控制器源码(gateway/bad-request、
|
|
26
|
+
// session/not-found、session/agent-busy、workspace/not-found 等)。
|
|
27
|
+
const HOST_CODE_MAP = {
|
|
28
|
+
'session/not-found': 4011,
|
|
29
|
+
'workspace/not-found': 4011,
|
|
30
|
+
'session/agent-busy': 4007,
|
|
31
|
+
'session/wait-timeout': 4007,
|
|
32
|
+
'gateway/bad-request': 4400,
|
|
33
|
+
'gateway/internal': 4500,
|
|
34
|
+
'gateway/signature-invalid': 4400,
|
|
35
|
+
'gateway/context-unavailable': 4021,
|
|
36
|
+
};
|
|
37
|
+
|
|
38
|
+
/** 宿主服务名清单(诊断与 services 证据用;来源:各控制器 `static inject` 与 super(ctx, 名))。 */
|
|
39
|
+
const WATCHED_SERVICES = [
|
|
40
|
+
'sessionController', 'jobController', 'workspaceController',
|
|
41
|
+
'terminalController', 'settingsController', 'remoteAccess',
|
|
42
|
+
'agents', 'sessions', 'sessionQuery', 'sessionProjections', 'llm', 'typert',
|
|
43
|
+
// 2026-11-17 会话设置同步:权限目录(permissionPresets)与斜杠命令面(commands,
|
|
44
|
+
// 权限切换实证 = 会话命令 `/permission <preset>`,与桌面端 PermissionSelect 同一条写路径)。
|
|
45
|
+
'permissionPresets', 'commands',
|
|
46
|
+
// 2026-11-18 附件上送:图片内联 prompt,通用文件经 fileUploads.uploadStream 换 receiptId。
|
|
47
|
+
'fileUploads',
|
|
48
|
+
// 2026-11-18 会话动作(置顶/归档):权威集合来自 workspaceRegistry(feed.ts 同源),
|
|
49
|
+
// workspaceController 提供 pinSession/archiveSession 等写动作。
|
|
50
|
+
'workspaceRegistry', 'workspaceController',
|
|
51
|
+
];
|
|
52
|
+
|
|
53
|
+
/**
|
|
54
|
+
* cordis 适配器**实际提供**的协议能力(caps 语义与 mock 对齐:客户端据此判 UI)。
|
|
55
|
+
* 如实边界:todos.answer / events.resume 未映射(4021),绝不虚报;
|
|
56
|
+
* ws.ticket 由网关统一并入(server.mjs GATEWAY_CAPS)。
|
|
57
|
+
*
|
|
58
|
+
* artifacts.read 是 2026-11-17 新加的:宿主没有「会话产物」端点,但会话事件里
|
|
59
|
+
* 的写类工具调用带完整路径,配上 session/list 给的 cwd 就能核对出真文件
|
|
60
|
+
* (见 artifacts.mjs)。能列、能下载,才敢写进 caps。
|
|
61
|
+
*
|
|
62
|
+
* tasks.settings 是同日新增:权限当前值/目录 + 模型目录/切换(见 sessionSettings)。
|
|
63
|
+
*/
|
|
64
|
+
const SERVED_CAPS = [
|
|
65
|
+
'tasks.read', 'tasks.write', 'tasks.cancel', 'artifacts.read', 'tasks.settings',
|
|
66
|
+
// 2026-11-18:与桌面端右键菜单同源的会话动作(置顶/归档/重命名/分叉/复制 ID)。
|
|
67
|
+
// 复制 ID 纯客户端,不需要宿主能力;这里声明的四个都需要宿主动作可达。
|
|
68
|
+
'tasks.sessionActions',
|
|
69
|
+
// 2026-11-18:提示词增强(真调宿主 llm,一次性补全)。客户端据此点亮增强按钮。
|
|
70
|
+
'prompt.enhance',
|
|
71
|
+
];
|
|
72
|
+
|
|
73
|
+
function isHostRemoteError(err) {
|
|
74
|
+
return err && typeof err === 'object' && err.isDSHRemoteError === true;
|
|
75
|
+
}
|
|
76
|
+
|
|
77
|
+
function toGatewayError(err, method) {
|
|
78
|
+
if (isHostRemoteError(err)) {
|
|
79
|
+
const code = HOST_CODE_MAP[err.code] ?? 4500;
|
|
80
|
+
return fail(code, code === 4500 ? `宿主错误:${err.code}` : undefined, {
|
|
81
|
+
detail: `host=${err.code} method=${method}`,
|
|
82
|
+
hostCode: err.code,
|
|
83
|
+
});
|
|
84
|
+
}
|
|
85
|
+
return fail(4500, `宿主调用异常`, { detail: `method=${method} ${err?.message || String(err)}` });
|
|
86
|
+
}
|
|
87
|
+
|
|
88
|
+
/** 从 cwd 取展示标题(宿主 summary 不带标题;标题投影在 projections 里,命中即用)。 */
|
|
89
|
+
function deriveTitle(summary) {
|
|
90
|
+
const projTitle = summary?.projections?.values?.title ?? summary?.projections?.title;
|
|
91
|
+
if (typeof projTitle === 'string' && projTitle.trim()) return projTitle.trim();
|
|
92
|
+
const cwd = typeof summary?.cwd === 'string' ? summary.cwd : '';
|
|
93
|
+
if (cwd) {
|
|
94
|
+
const base = cwd.split('/').filter(Boolean).pop();
|
|
95
|
+
if (base) return base;
|
|
96
|
+
}
|
|
97
|
+
const id = String(summary?.sessionId ?? '');
|
|
98
|
+
return `会话 ${id.slice(-6)}`;
|
|
99
|
+
}
|
|
100
|
+
|
|
101
|
+
/**
|
|
102
|
+
* 宿主会话 summary → 我们的 TaskSummary。
|
|
103
|
+
* status 映射(v1 如实边界):
|
|
104
|
+
* · running === true → running
|
|
105
|
+
* · agentAvailable 但没在跑 → idle(「空闲 · 可续」)
|
|
106
|
+
* · 冷会话同样进 listTasks(映射为 idle)——手机侧栏与桌面端同口径,
|
|
107
|
+
*
|
|
108
|
+
* 为什么不能把「没在跑」写成 interrupted:宿主 summary 只有
|
|
109
|
+
* `{sessionId, updatedAt, agentAvailable, running, blank, cwd, projections}`,
|
|
110
|
+
* **没有「上一回合是被打断的、还是正常说完的」这个事实**。把两者合并成 interrupted,
|
|
111
|
+
* 结果是每个空闲会话都顶着「已中断 · 可续」的告警徽标——用户看到的是「怎么老是中断」
|
|
112
|
+
* (2026-11-17 真机反馈,起因就是这里)。真正被打断只在我们能观测到证据时才说:
|
|
113
|
+
* 客户端侧监听 WS gen 变化,把「原本 running 的任务」降级为 interrupted(FR-TASK-06)。
|
|
114
|
+
*
|
|
115
|
+
* needsYou/pendingTodoCount v1 恒 false/0:宿主 summary 不暴露审批态,不编造。
|
|
116
|
+
*/
|
|
117
|
+
/**
|
|
118
|
+
* 从会话事件推导「最近一轮」的 token 用量。
|
|
119
|
+
*
|
|
120
|
+
* 宿主的权威字段取自 app.asar 实证:`assistant/message` 的 `data.usage`
|
|
121
|
+
* (或 stream 里最后一段 usage),形状是
|
|
122
|
+
* `{ inputTokens, outputTokens, totalTokens, cacheReadTokens, cacheWriteTokens }`。
|
|
123
|
+
* 同一轮可能有多次尝试(step),每个 step 取最后一次采样,跨 step 求和——
|
|
124
|
+
* 与宿主 `dsh-token-meter/turn-usage.ts` 的 deriveTurnTokenUsage 同口径。
|
|
125
|
+
* 拿不到就返回 null:面板只能如实省略,不能编一个数字。
|
|
126
|
+
*/
|
|
127
|
+
function latestTurnUsage(records) {
|
|
128
|
+
const events = (Array.isArray(records) ? records : [])
|
|
129
|
+
.map((r) => r?.event ?? r)
|
|
130
|
+
.filter((e) => e && typeof e === 'object');
|
|
131
|
+
let endIdx = -1;
|
|
132
|
+
for (let i = events.length - 1; i >= 0; i -= 1) {
|
|
133
|
+
if (events[i].type === 'turn/end') { endIdx = i; break; }
|
|
134
|
+
}
|
|
135
|
+
if (endIdx < 0) return null;
|
|
136
|
+
const turn = events[endIdx].data?.turn;
|
|
137
|
+
let startIdx = 0;
|
|
138
|
+
if (turn !== undefined) {
|
|
139
|
+
for (let i = endIdx - 1; i >= 0; i -= 1) {
|
|
140
|
+
if (events[i].type === 'turn/start' && events[i].data?.turn === turn) { startIdx = i; break; }
|
|
141
|
+
}
|
|
142
|
+
}
|
|
143
|
+
const isCount = (v) => typeof v === 'number' && Number.isFinite(v) && v >= 0;
|
|
144
|
+
const streamUsage = (stream) => {
|
|
145
|
+
if (!Array.isArray(stream)) return null;
|
|
146
|
+
for (let i = stream.length - 1; i >= 0; i -= 1) {
|
|
147
|
+
if (stream[i]?.usage && isCount(stream[i].usage.inputTokens)) return stream[i].usage;
|
|
148
|
+
}
|
|
149
|
+
return null;
|
|
150
|
+
};
|
|
151
|
+
const samples = new Map();
|
|
152
|
+
for (let i = startIdx; i <= endIdx; i += 1) {
|
|
153
|
+
const e = events[i];
|
|
154
|
+
if (e.type !== 'assistant/message') continue;
|
|
155
|
+
const d = e.data ?? {};
|
|
156
|
+
const u = d.usage ?? streamUsage(d.stream);
|
|
157
|
+
if (!isCount(u?.inputTokens) || !isCount(u?.outputTokens)) continue;
|
|
158
|
+
samples.set(String(d.step ?? '0'), u);
|
|
159
|
+
}
|
|
160
|
+
if (!samples.size) return null;
|
|
161
|
+
let totalTokens = 0;
|
|
162
|
+
let inputTokens = 0;
|
|
163
|
+
let outputTokens = 0;
|
|
164
|
+
let cacheReadTokens = 0;
|
|
165
|
+
let cacheWriteTokens = 0;
|
|
166
|
+
for (const u of samples.values()) {
|
|
167
|
+
inputTokens += u.inputTokens;
|
|
168
|
+
outputTokens += u.outputTokens;
|
|
169
|
+
totalTokens += isCount(u.totalTokens) ? u.totalTokens : u.inputTokens + u.outputTokens;
|
|
170
|
+
if (isCount(u.cacheReadTokens)) cacheReadTokens += u.cacheReadTokens;
|
|
171
|
+
if (isCount(u.cacheWriteTokens)) cacheWriteTokens += u.cacheWriteTokens;
|
|
172
|
+
}
|
|
173
|
+
return { totalTokens, inputTokens, outputTokens, cacheReadTokens, cacheWriteTokens };
|
|
174
|
+
}
|
|
175
|
+
|
|
176
|
+
function summaryToTask(summary, hostName, workspaceIndex = null) {
|
|
177
|
+
const running = summary.running === true;
|
|
178
|
+
const workspace = workspaceIndex?.bySession.get(String(summary.sessionId));
|
|
179
|
+
return {
|
|
180
|
+
taskId: summary.sessionId,
|
|
181
|
+
title: deriveTitle(summary),
|
|
182
|
+
status: running ? 'running' : 'idle',
|
|
183
|
+
// 宿主 list 只给 running / agentAvailable,没有阶段进度——**不编**。
|
|
184
|
+
// 之前拼的「第 5/5 步 · 已中断·可续」既不是宿主事实,又和状态标签重复,
|
|
185
|
+
// 手机端会读成「连不上」,实际只是会话被宿主重启打断(2026-11-16 修复)。
|
|
186
|
+
phase: null,
|
|
187
|
+
startedAt: null,
|
|
188
|
+
lastActivityAt: typeof summary.updatedAt === 'number' ? new Date(summary.updatedAt).toISOString() : null,
|
|
189
|
+
hostId: 'host_cordis',
|
|
190
|
+
hostName,
|
|
191
|
+
cwd: summary.cwd ?? null,
|
|
192
|
+
// 桌面侧栏的工作区分组(workspaceRegistry.list() 的 title/sessionIds)。
|
|
193
|
+
// 没有归属的会话留 null,手机端归到「未分组」——与 tree.ts 的 UNGROUPED_KEY 同口径。
|
|
194
|
+
workspaceId: workspace?.id ?? null,
|
|
195
|
+
workspaceName: workspace?.title ?? null,
|
|
196
|
+
needsYou: false,
|
|
197
|
+
pendingTodoCount: 0,
|
|
198
|
+
artifactsCount: 0,
|
|
199
|
+
// 宿主侧痕迹字段,诊断与测试用(协议允许额外字段;iOS 解码忽略未知键)
|
|
200
|
+
hostAgentAvailable: summary.agentAvailable === true,
|
|
201
|
+
};
|
|
202
|
+
}
|
|
203
|
+
|
|
204
|
+
/**
|
|
205
|
+
* 清洗模型输出:模型偶尔会把整段包成代码块,或加一句「以下是增强后的提示词:」。
|
|
206
|
+
* 只做这两类**确定性**剥离,不去猜测正文边界。
|
|
207
|
+
*/
|
|
208
|
+
function unwrapEnhancedText(raw) {
|
|
209
|
+
let text = String(raw ?? '').trim();
|
|
210
|
+
if (!text) return '';
|
|
211
|
+
const fenced = text.match(/^```[a-zA-Z0-9_-]*\n([\s\S]*?)\n?```$/);
|
|
212
|
+
if (fenced) text = fenced[1].trim();
|
|
213
|
+
const lines = text.split('\n');
|
|
214
|
+
if (lines.length > 1) {
|
|
215
|
+
const first = lines[0].trim();
|
|
216
|
+
if (first.length <= 24 && /[::]\s*$/.test(first)
|
|
217
|
+
&& /^(以下是|下面是|这是|增强后|改写后|优化后|好的)/.test(first)) {
|
|
218
|
+
text = lines.slice(1).join('\n').trim();
|
|
219
|
+
}
|
|
220
|
+
}
|
|
221
|
+
return text;
|
|
222
|
+
}
|
|
223
|
+
|
|
224
|
+
export function createCordisHost({ ctx, log = () => {}, hostname = displayHostName() } = {}) {
|
|
225
|
+
if (!ctx || (typeof ctx.get !== 'function' && typeof ctx !== 'object')) {
|
|
226
|
+
throw new Error('createCordisHost 需要 cordis 上下文(ctx)');
|
|
227
|
+
}
|
|
228
|
+
|
|
229
|
+
/** 解析宿主服务:cordis 服务在子上下文上向上解析;取不到显式 4021。 */
|
|
230
|
+
function service(name, method) {
|
|
231
|
+
let svc;
|
|
232
|
+
try {
|
|
233
|
+
svc = typeof ctx.get === 'function' ? ctx.get(name) : undefined;
|
|
234
|
+
if (svc === undefined || svc === null) svc = ctx[name];
|
|
235
|
+
} catch {
|
|
236
|
+
/* get 抛错视为不可用,走下方统一 4021 */
|
|
237
|
+
}
|
|
238
|
+
if (svc === undefined || svc === null) {
|
|
239
|
+
throw fail(4021, `宿主服务 ${name} 不可用(方法 ${method} 无法执行)`, {
|
|
240
|
+
detail: `service=${name}`,
|
|
241
|
+
});
|
|
242
|
+
}
|
|
243
|
+
return svc;
|
|
244
|
+
}
|
|
245
|
+
|
|
246
|
+
/** 统一执行宿主调用:错误翻译 + 永不外抛。协议自身的 GatewayError 原样透传。 */
|
|
247
|
+
async function call(method, fn) {
|
|
248
|
+
try {
|
|
249
|
+
return await fn();
|
|
250
|
+
} catch (err) {
|
|
251
|
+
if (err instanceof GatewayError) throw err;
|
|
252
|
+
const translated = toGatewayError(err, method);
|
|
253
|
+
log(`cordis ${method} 失败:${translated.code ?? 'unknown'}`);
|
|
254
|
+
throw translated;
|
|
255
|
+
}
|
|
256
|
+
}
|
|
257
|
+
|
|
258
|
+
let requestIdOf = null;
|
|
259
|
+
|
|
260
|
+
// MARK: 实时事件流(v2)
|
|
261
|
+
//
|
|
262
|
+
// 为什么是轮询而不是订阅:宿主确实有推送面(sessionController.observeEvent/2、
|
|
263
|
+
// observeState/2),但它们的请求形状没有取证过——猜错就是「静默不推送」,
|
|
264
|
+
// 比不做更糟。而 events(request) 的契约已经在 X2 里跑通(冷启动历史用的就是它),
|
|
265
|
+
// 所以实时这条先按 1.2s 轮询落地:手机的观感是「一两秒内出现」,不是「一片死寂」。
|
|
266
|
+
//
|
|
267
|
+
// 关键取舍:**首轮只记水位,不补历史**。任务的历史由 REST /tasks/:id/events 提供,
|
|
268
|
+
// 实时通道只负责「从现在起新发生的」。否则每次重连都会把 40 条旧事件重推一遍,
|
|
269
|
+
// 手机端时间线会整段重复。
|
|
270
|
+
const LIVE_POLL_MS = 1200;
|
|
271
|
+
const LIVE_KEEP_MS = 10 * 60_000; // 停下来的任务再观察 10 分钟,收尾帧不至于丢
|
|
272
|
+
const LIVE_PAGE = 40;
|
|
273
|
+
|
|
274
|
+
const watched = new Map(); // sessionId → { hostSeq|null, running, lastActiveAt }
|
|
275
|
+
let liveListener = null;
|
|
276
|
+
let liveTimer = null;
|
|
277
|
+
let liveBusy = false;
|
|
278
|
+
let liveFirstOk = false;
|
|
279
|
+
|
|
280
|
+
/**
|
|
281
|
+
* 把一个会话放进观察集。
|
|
282
|
+
*
|
|
283
|
+
* `baseline` = 「这次写操作**之前**宿主已经到哪了」。手机刚发出的那条指令,
|
|
284
|
+
* 宿主通常在我们 markWatched 之前就写进了事件日志;如果此时把水位设成「当前最大值」,
|
|
285
|
+
* 这条指令自己会被当成历史跳过——用户看到的是「我问了,它答了,但我的问题不见了」。
|
|
286
|
+
* 所以写操作路径必须带上写前水位。
|
|
287
|
+
*/
|
|
288
|
+
function markWatched(taskId, baseline) {
|
|
289
|
+
if (!taskId) return;
|
|
290
|
+
const existing = watched.get(taskId);
|
|
291
|
+
if (existing) {
|
|
292
|
+
if (typeof baseline === 'number' && existing.hostSeq !== null) {
|
|
293
|
+
existing.hostSeq = Math.min(existing.hostSeq, baseline);
|
|
294
|
+
}
|
|
295
|
+
existing.lastActiveAt = Date.now();
|
|
296
|
+
return;
|
|
297
|
+
}
|
|
298
|
+
// 轮询发现的新会话没有 baseline:水位留空,首轮设成当前最大值(历史由 REST 给)。
|
|
299
|
+
watched.set(taskId, {
|
|
300
|
+
hostSeq: typeof baseline === 'number' ? baseline : null,
|
|
301
|
+
running: null,
|
|
302
|
+
lastActiveAt: Date.now(),
|
|
303
|
+
});
|
|
304
|
+
}
|
|
305
|
+
|
|
306
|
+
/** 写前水位:读最新一条事件的 seq(读不到就返回 0,等于「从头观察」)。 */
|
|
307
|
+
async function preWriteSeq(taskId) {
|
|
308
|
+
try {
|
|
309
|
+
const page = await eventPage(taskId, { maxMessages: 1 });
|
|
310
|
+
const latest = page.records
|
|
311
|
+
.map((r) => (r && r.event ? r.event : r))
|
|
312
|
+
.filter((e) => e && typeof e.seq === 'number')
|
|
313
|
+
.reduce((max, e) => Math.max(max, e.seq), 0);
|
|
314
|
+
return latest;
|
|
315
|
+
} catch {
|
|
316
|
+
return 0;
|
|
317
|
+
}
|
|
318
|
+
}
|
|
319
|
+
|
|
320
|
+
async function pollTaskEvents(taskId) {
|
|
321
|
+
const page = await eventPage(taskId, { maxMessages: LIVE_PAGE });
|
|
322
|
+
const records = page.records.map((r) => (r && r.event ? r.event : r)).filter(Boolean);
|
|
323
|
+
let maxSeq = 0;
|
|
324
|
+
for (const e of records) if (typeof e.seq === 'number') maxSeq = Math.max(maxSeq, e.seq);
|
|
325
|
+
|
|
326
|
+
const state = watched.get(taskId) ?? { hostSeq: null, running: null, lastActiveAt: Date.now() };
|
|
327
|
+
if (state.hostSeq === null) {
|
|
328
|
+
state.hostSeq = maxSeq;
|
|
329
|
+
watched.set(taskId, state);
|
|
330
|
+
return;
|
|
331
|
+
}
|
|
332
|
+
|
|
333
|
+
const fresh = records.filter((e) => (typeof e.seq === 'number' ? e.seq : 0) > state.hostSeq);
|
|
334
|
+
// 宿主日志按 seq 升序;万一不是,也保证手机端按发生顺序追加。
|
|
335
|
+
fresh.sort((a, b) => (a.seq ?? 0) - (b.seq ?? 0));
|
|
336
|
+
let pushed = 0;
|
|
337
|
+
for (const event of fresh) {
|
|
338
|
+
for (const frame of translateLiveEvent(event)) {
|
|
339
|
+
liveListener?.({ taskId, ...frame });
|
|
340
|
+
pushed += 1;
|
|
341
|
+
}
|
|
342
|
+
}
|
|
343
|
+
if (pushed > 0) log(`live push ${taskId} +${pushed} 帧(宿主 seq ${state.hostSeq}→${maxSeq})`);
|
|
344
|
+
if (fresh.length) state.lastActiveAt = Date.now();
|
|
345
|
+
state.hostSeq = Math.max(state.hostSeq, maxSeq);
|
|
346
|
+
watched.set(taskId, state);
|
|
347
|
+
}
|
|
348
|
+
|
|
349
|
+
async function pollLive() {
|
|
350
|
+
if (liveBusy || !liveListener) return;
|
|
351
|
+
liveBusy = true;
|
|
352
|
+
try {
|
|
353
|
+
const summaries = await summaryList();
|
|
354
|
+
const now = Date.now();
|
|
355
|
+
|
|
356
|
+
for (const s of summaries) {
|
|
357
|
+
if (s.running === true) markWatched(s.sessionId);
|
|
358
|
+
const state = watched.get(s.sessionId);
|
|
359
|
+
if (!state) continue;
|
|
360
|
+
const running = s.running === true;
|
|
361
|
+
// 状态翻转立刻推一帧:手机端的「运行中 / 空闲」不该等列表刷新。
|
|
362
|
+
if (state.running !== running) {
|
|
363
|
+
state.running = running;
|
|
364
|
+
state.lastActiveAt = now;
|
|
365
|
+
liveListener?.({ taskId: s.sessionId, kind: 'state', data: { status: running ? 'running' : 'idle' } });
|
|
366
|
+
}
|
|
367
|
+
}
|
|
368
|
+
|
|
369
|
+
for (const [taskId, state] of [...watched]) {
|
|
370
|
+
if (now - state.lastActiveAt > LIVE_KEEP_MS) {
|
|
371
|
+
watched.delete(taskId);
|
|
372
|
+
continue;
|
|
373
|
+
}
|
|
374
|
+
try {
|
|
375
|
+
await pollTaskEvents(taskId);
|
|
376
|
+
} catch (err) {
|
|
377
|
+
// 单个会话读失败(正在被压缩 / 刚建还没落盘)不该拖垮整轮;
|
|
378
|
+
// 退避一件事:把它挪出观察集,下轮重新按 running 进入。
|
|
379
|
+
if (err instanceof GatewayError && err.code === 4011) watched.delete(taskId);
|
|
380
|
+
log(`live poll ${taskId} 失败:${err?.code ?? err?.message ?? 'unknown'}`);
|
|
381
|
+
}
|
|
382
|
+
}
|
|
383
|
+
if (!liveFirstOk) {
|
|
384
|
+
liveFirstOk = true;
|
|
385
|
+
log(`live poll ok(首轮成功,观察 ${watched.size} 个会话)`);
|
|
386
|
+
}
|
|
387
|
+
} catch (err) {
|
|
388
|
+
// 启动瞬间服务还没挂上(sessionController 尚未 provide)是常态,
|
|
389
|
+
// 每 1.2s 会再试,不必惊动用户;但要在日志里看得见。
|
|
390
|
+
log(`live poll 失败:${err?.message ?? String(err)}`);
|
|
391
|
+
} finally {
|
|
392
|
+
liveBusy = false;
|
|
393
|
+
}
|
|
394
|
+
}
|
|
395
|
+
|
|
396
|
+
/** RPC 双参方法(payload, signal)的 signal:宿主内部会 throwIfAborted,缺省直接炸。 */
|
|
397
|
+
const RPC_TIMEOUT_MS = 30_000;
|
|
398
|
+
const rpcSignal = () => AbortSignal.timeout(RPC_TIMEOUT_MS);
|
|
399
|
+
|
|
400
|
+
/**
|
|
401
|
+
* 提示词增强(2026-11-18,真调模型)。
|
|
402
|
+
*
|
|
403
|
+
* 宿主 `ctx.llm` 就挂在本进程的 cordis 上下文上——网关是宿主内插件,可以直接
|
|
404
|
+
* `llm.stream()` 做一次性补全,**不需要**走 Remote RPC。这也是为什么之前只能
|
|
405
|
+
* 做本地规则:宿主没有把补全能力暴露成 @Remote 动作,但服务对象本身是可用的。
|
|
406
|
+
*
|
|
407
|
+
* 模型取 `modelCatalog.default`(宿主「未配置会话用的默认模型」);客户端可以
|
|
408
|
+
* 显式传 provider/model 覆盖(例如用当前会话已选的模型)。
|
|
409
|
+
*
|
|
410
|
+
* system prompt 的做法借鉴 WorkBuddy 的 `llm:enhancePrompt`(同一台机器上的
|
|
411
|
+
* 产品实证):语言一致性最高优先、只补全不改写意图、控制篇幅、只输出正文。
|
|
412
|
+
*/
|
|
413
|
+
const ENHANCE_INPUT_LIMIT = 4000;
|
|
414
|
+
const ENHANCE_TIMEOUT_MS = 60_000;
|
|
415
|
+
const ENHANCE_SYSTEM_PROMPT = [
|
|
416
|
+
'你是资深提示词工程师。把用户给的粗略想法改写成一条清晰、可执行、可直接交给 AI 执行的提示词。',
|
|
417
|
+
'',
|
|
418
|
+
'规则(按优先级):',
|
|
419
|
+
'1. 语言一致:输入中文就输出中文,输入英文就输出英文;代码、命令、路径、专有名词保持原样,不要翻译。',
|
|
420
|
+
'2. 保留原意:只做澄清与补全,不新增用户没有表达的需求;原文没有的细节不要编造,宁可留空也不要编一个具体值。',
|
|
421
|
+
'3. 结构化:按需组织为「目标 → 关键约束与上下文 → 期望输出(格式/范围/验收标准)」。原文很短时不要套空模板,两三句讲清即可。',
|
|
422
|
+
'4. 具体可执行:把模糊措辞换成可验证的要求(例如「快一点」→「首屏渲染 < 1 秒」)。用户已给出的数值、路径、名称必须原样保留。',
|
|
423
|
+
'5. 控制篇幅:一般不超过原文的 3 倍,且不超过 600 字。原文已经足够清晰时只做最小润色,不要为了显得「增强」而灌水。',
|
|
424
|
+
'6. 只输出改写后的提示词正文:不要解释、不要前言、不要「以下是」之类的话、不要用代码块包整段、不要回答提示词里提出的问题。',
|
|
425
|
+
].join('\n');
|
|
426
|
+
|
|
427
|
+
/**
|
|
428
|
+
* 把移动端附件翻译成宿主 prompt 的 content block(2026-11-18)。
|
|
429
|
+
*
|
|
430
|
+
* 两份证据都来自 app.asar 反编译(见 spike0/RUNBOOK §10):
|
|
431
|
+
* · `sessionController.prompt` 的 content 是 text/image/file 三种 block 的联合,
|
|
432
|
+
* image = `{type:'image', mediaType:'image/png|jpeg|webp|gif', data:base64, name?}`,
|
|
433
|
+
* file = `{type:'file', receiptId}`;
|
|
434
|
+
* · 图片走 `admitPromptContent` 直接规范化持久化,可内联 base64;
|
|
435
|
+
* 通用文件必须先拿 receiptId——`fileUploads.uploadStream({sessionId, data, name})`
|
|
436
|
+
* 是非 Remote 方法、从 request.sessionId 自己解析 agent,进程内直调最稳。
|
|
437
|
+
*
|
|
438
|
+
* 不认识的 mediaType 一律按通用文件处理,不猜、不丢。
|
|
439
|
+
*/
|
|
440
|
+
const INLINE_IMAGE_TYPES = new Set(['image/png', 'image/jpeg', 'image/webp', 'image/gif']);
|
|
441
|
+
|
|
442
|
+
async function attachmentBlocks(sessionId, attachments) {
|
|
443
|
+
if (!Array.isArray(attachments) || attachments.length === 0) return [];
|
|
444
|
+
const blocks = [];
|
|
445
|
+
for (const att of attachments) {
|
|
446
|
+
const name = typeof att?.name === 'string' && att.name ? att.name : 'attachment';
|
|
447
|
+
const data = typeof att?.dataBase64 === 'string' ? att.dataBase64 : '';
|
|
448
|
+
if (!data) throw fail(4400, `附件 ${name} 缺少数据`);
|
|
449
|
+
if (att.kind === 'image' && INLINE_IMAGE_TYPES.has(att.mediaType)) {
|
|
450
|
+
blocks.push({ type: 'image', mediaType: att.mediaType, data, name });
|
|
451
|
+
continue;
|
|
452
|
+
}
|
|
453
|
+
// 通用文件:字节 → async iterable → uploadStream → receiptId。
|
|
454
|
+
let bytes;
|
|
455
|
+
try {
|
|
456
|
+
bytes = Buffer.from(data, 'base64');
|
|
457
|
+
} catch {
|
|
458
|
+
throw fail(4400, `附件 ${name} 的 base64 不合法`);
|
|
459
|
+
}
|
|
460
|
+
if (bytes.length === 0) throw fail(4400, `附件 ${name} 解码后为空`);
|
|
461
|
+
const fileUploads = service('fileUploads', 'attachments.upload');
|
|
462
|
+
async function* chunks() {
|
|
463
|
+
const CHUNK = 64 * 1024;
|
|
464
|
+
for (let i = 0; i < bytes.length; i += CHUNK) {
|
|
465
|
+
yield new Uint8Array(bytes.subarray(i, i + CHUNK));
|
|
466
|
+
}
|
|
467
|
+
}
|
|
468
|
+
const staged = await call('fileUploads.uploadStream', () =>
|
|
469
|
+
fileUploads.uploadStream({ sessionId, data: chunks(), name }));
|
|
470
|
+
const receiptId = staged?.receiptId;
|
|
471
|
+
if (!receiptId) throw fail(4500, '宿主上传附件未返回 receiptId');
|
|
472
|
+
blocks.push({ type: 'file', receiptId });
|
|
473
|
+
}
|
|
474
|
+
return blocks;
|
|
475
|
+
}
|
|
476
|
+
|
|
477
|
+
/**
|
|
478
|
+
* 提交用户指令。mode 合法值考古实证只有 `steer` / `append`
|
|
479
|
+
* (client.js:input.mode==='steer'?'steering':'queued')——
|
|
480
|
+
* 此前的 'queue' 是无效值,宿主直接拒绝:手机发消息卡「发送中」、
|
|
481
|
+
* 新建任务桌面无反应的根因。steer 先试(运行中注入当前回合),
|
|
482
|
+
* 非会话不存在类失败退 append(排队/续话)。
|
|
483
|
+
*
|
|
484
|
+
* @param {string|undefined} text 可为空(纯附件消息),但 content 不能空。
|
|
485
|
+
* @param {Array} attachments 已翻译成 block;调用方先经 attachmentBlocks。
|
|
486
|
+
*/
|
|
487
|
+
async function submitPrompt(ctrl, sessionId, text, extraBlocks = []) {
|
|
488
|
+
requestIdOf = crypto.randomUUID();
|
|
489
|
+
const content = [
|
|
490
|
+
...(text ? [{ type: 'text', text }] : []),
|
|
491
|
+
...extraBlocks,
|
|
492
|
+
];
|
|
493
|
+
if (content.length === 0) throw fail(4400, 'prompt content 不能为空');
|
|
494
|
+
const payload = (mode) => ({
|
|
495
|
+
requestId: requestIdOf,
|
|
496
|
+
sessionId,
|
|
497
|
+
mode,
|
|
498
|
+
content,
|
|
499
|
+
clientTimeZone: Intl.DateTimeFormat().resolvedOptions().timeZone,
|
|
500
|
+
});
|
|
501
|
+
try {
|
|
502
|
+
await ctrl.prompt(payload('steer'), rpcSignal());
|
|
503
|
+
} catch (err) {
|
|
504
|
+
const hostCode = isHostRemoteError(err) ? err.code : '';
|
|
505
|
+
if (hostCode === 'session/not-found' || hostCode === 'workspace/not-found') throw err;
|
|
506
|
+
await ctrl.prompt(payload('append'), rpcSignal());
|
|
507
|
+
}
|
|
508
|
+
}
|
|
509
|
+
|
|
510
|
+
async function summaryList() {
|
|
511
|
+
const ctrl = service('sessionController', 'session/list');
|
|
512
|
+
const raw = await ctrl.list({}, rpcSignal());
|
|
513
|
+
// 宿主 session.list({}) 走信封 {ok, value:{items}}(考古 client.js 实证);
|
|
514
|
+
// 兼容裸数组与其他常见信封键,命中路径记到 host.listEnvelope 供 diag 取证。
|
|
515
|
+
const candidates = [
|
|
516
|
+
['array', Array.isArray(raw) ? raw : null],
|
|
517
|
+
['value.items', Array.isArray(raw?.value?.items) ? raw.value.items : null],
|
|
518
|
+
['items', Array.isArray(raw?.items) ? raw.items : null],
|
|
519
|
+
['sessions', Array.isArray(raw?.sessions) ? raw.sessions : null],
|
|
520
|
+
['values', Array.isArray(raw?.values) ? raw.values : null],
|
|
521
|
+
['list', Array.isArray(raw?.list) ? raw.list : null],
|
|
522
|
+
];
|
|
523
|
+
const hit = candidates.find(([, v]) => v !== null);
|
|
524
|
+
if (!hit) {
|
|
525
|
+
const shape = raw === null || raw === undefined
|
|
526
|
+
? String(raw)
|
|
527
|
+
: typeof raw !== 'object'
|
|
528
|
+
? `${typeof raw}`
|
|
529
|
+
: `keys=[${Object.keys(raw).join(',')}]; `
|
|
530
|
+
+ Object.entries(raw).map(([k, v]) => `${k}:${Array.isArray(v) ? 'array' : typeof v}`).join(', ');
|
|
531
|
+
throw fail(4500, '宿主 session/list 返回了非数组', { detail: shape });
|
|
532
|
+
}
|
|
533
|
+
host.listEnvelope = hit[0];
|
|
534
|
+
return hit[1];
|
|
535
|
+
}
|
|
536
|
+
|
|
537
|
+
/**
|
|
538
|
+
* 会话历史页(FR-CHAT-01 冷启动数据源)。
|
|
539
|
+
* 宿主契约(app.asar typert 实证):sessionController.events(request, signal),
|
|
540
|
+
* request = { address:{kind:'session',sessionId}, beforeSeq?, throughSeq?, maxMessages?, turnWindow? }
|
|
541
|
+
* → { records:[{event}], hasMore, projections, assistantStream? }
|
|
542
|
+
*/
|
|
543
|
+
async function eventPage(taskId, { beforeSeq, maxMessages = 60 } = {}) {
|
|
544
|
+
const ctrl = service('sessionController', 'session/events');
|
|
545
|
+
const request = { address: { kind: 'session', sessionId: taskId }, maxMessages };
|
|
546
|
+
if (Number.isFinite(beforeSeq) && beforeSeq > 0) request.beforeSeq = beforeSeq;
|
|
547
|
+
const raw = await ctrl.events(request, rpcSignal());
|
|
548
|
+
const page = raw && typeof raw === 'object' && raw.value && typeof raw.value === 'object'
|
|
549
|
+
? raw.value
|
|
550
|
+
: raw;
|
|
551
|
+
const records = Array.isArray(page?.records) ? page.records : [];
|
|
552
|
+
// 形状取证:首条记录的键名/type/seq 记进 diag,供翻译层对齐(不落内容)。
|
|
553
|
+
if (records.length && !host.eventShape) {
|
|
554
|
+
const ev = records[0]?.event ?? records[0];
|
|
555
|
+
host.eventShape = `keys=${Object.keys(ev || {}).join(',')} type=${ev?.type} seq=${ev?.seq}`;
|
|
556
|
+
log(`cordis events 形状: ${host.eventShape}`);
|
|
557
|
+
}
|
|
558
|
+
return { records, hasMore: Boolean(page?.hasMore) };
|
|
559
|
+
}
|
|
560
|
+
|
|
561
|
+
/**
|
|
562
|
+
* X2 取证:宿主服务方法面(方法名/形参个数)。只暴露元信息,
|
|
563
|
+
* 不含任何会话内容——用于核对 prompt/create 等动作的真实签名。
|
|
564
|
+
*/
|
|
565
|
+
function methodSurface(svc) {
|
|
566
|
+
if (!svc || (typeof svc !== 'object' && typeof svc !== 'function')) return null;
|
|
567
|
+
const names = new Set();
|
|
568
|
+
let proto = svc;
|
|
569
|
+
for (let depth = 0; depth < 3 && proto && proto !== Object.prototype; depth += 1) {
|
|
570
|
+
for (const n of Object.getOwnPropertyNames(proto)) names.add(n);
|
|
571
|
+
proto = Object.getPrototypeOf(proto);
|
|
572
|
+
}
|
|
573
|
+
return [...names].filter((n) => {
|
|
574
|
+
try { return typeof svc[n] === 'function'; } catch { return false; }
|
|
575
|
+
}).map((n) => {
|
|
576
|
+
try { return `${n}/${svc[n].length}`; } catch { return n; }
|
|
577
|
+
}).sort();
|
|
578
|
+
}
|
|
579
|
+
|
|
580
|
+
/** 会话的工作目录。产物定位、路径收边都靠它;宿主没给就如实返回 null。 */
|
|
581
|
+
async function taskCwd(taskId) {
|
|
582
|
+
const summaries = await summaryList();
|
|
583
|
+
const summary = summaries.find((s) => s.sessionId === taskId);
|
|
584
|
+
if (!summary) throw fail(4011);
|
|
585
|
+
return summary.cwd ?? null;
|
|
586
|
+
}
|
|
587
|
+
|
|
588
|
+
/**
|
|
589
|
+
* 会话产物清单(推导)。`getTask` 与 `listArtifacts` 共用同一条口径,
|
|
590
|
+
* 免得「详情页说没有产物、产物面板里却有五个」这种两处各说各话。
|
|
591
|
+
*/
|
|
592
|
+
async function taskArtifacts(taskId) {
|
|
593
|
+
const cwd = await taskCwd(taskId);
|
|
594
|
+
if (!cwd) return { items: [], hasMore: false, reason: 'host 未提供工作目录(cwd 为空)' };
|
|
595
|
+
const page = await eventPage(taskId, { maxMessages: 200 });
|
|
596
|
+
const { items, skipped } = deriveArtifacts(page.records, { cwd });
|
|
597
|
+
return { items, hasMore: false, skipped };
|
|
598
|
+
}
|
|
599
|
+
|
|
600
|
+
// MARK: 会话设置同步辅助(权限 / 模型,方法体在 host 对象内)
|
|
601
|
+
|
|
602
|
+
/** 宿主返回值统一解信封:{ok:true,value} 直接取 value,其余原样(list 已实证这个形状)。 */
|
|
603
|
+
function unwrapHost(raw) {
|
|
604
|
+
return raw && typeof raw === 'object' && raw.ok === true && 'value' in raw ? raw.value : raw;
|
|
605
|
+
}
|
|
606
|
+
|
|
607
|
+
/** 会话投影(权限当前值 / 模型选择)。拿不到返回 null,不影响其他面。 */
|
|
608
|
+
async function readProjections(taskId) {
|
|
609
|
+
const ctrl = service('sessionController', 'session/projections');
|
|
610
|
+
const raw = await ctrl.projections({ sessionId: taskId }, rpcSignal());
|
|
611
|
+
return unwrapHost(raw);
|
|
612
|
+
}
|
|
613
|
+
|
|
614
|
+
/**
|
|
615
|
+
* 把权限预设套到某条会话上(新建会话默认权限,2026-11-21 修)。
|
|
616
|
+
*
|
|
617
|
+
* 失败**不抛出**:会话已经建好了,为了权限去中断创建只会留下一条没有提示的
|
|
618
|
+
* 空会话,比权限没套上更难收场。返回 true/false 让回执如实说明,
|
|
619
|
+
* 手机端据此提示「权限未套用」,不假装成功。
|
|
620
|
+
*/
|
|
621
|
+
async function applyPermissionPreset(sessionId, preset) {
|
|
622
|
+
const body = String(preset ?? '').trim();
|
|
623
|
+
if (!body) return undefined;
|
|
624
|
+
try {
|
|
625
|
+
const switched = await switchPermission(sessionId, body);
|
|
626
|
+
if (switched.kind === 'error') {
|
|
627
|
+
log(`cordis 新建会话权限被拒:${sessionId} ${body} — ${switched.text}`);
|
|
628
|
+
return false;
|
|
629
|
+
}
|
|
630
|
+
log(`cordis 新建会话权限 ${sessionId} → ${body}(${switched.via})`);
|
|
631
|
+
return true;
|
|
632
|
+
} catch (err) {
|
|
633
|
+
log(`cordis 新建会话权限失败:${sessionId} ${body} — ${err?.code ?? err?.message ?? 'unknown'}`);
|
|
634
|
+
return false;
|
|
635
|
+
}
|
|
636
|
+
}
|
|
637
|
+
|
|
638
|
+
/**
|
|
639
|
+
* 新建会话时应用用户在新建页选的模型(2026-11-21)。
|
|
640
|
+
*
|
|
641
|
+
* 走宿主 `session/selectModel({sessionId, provider, model, reasoningEffort?})`,
|
|
642
|
+
* 与详情页模型胶囊同一动作,不另造协议。必须在 submitPrompt 之前调用——
|
|
643
|
+
* 否则首条提示已经用电脑端默认模型跑完了,用户选的模型形同虚设。
|
|
644
|
+
* provider / model 缺一不可(与 selectModel 的校验一致);没选就返回 undefined,
|
|
645
|
+
* 由 JSON.stringify 丢掉,客户端据此区分「没要求」。
|
|
646
|
+
* 失败如实记日志并返回 false,不阻断建会话(模型没切成不该让会话建不起来)。
|
|
647
|
+
*/
|
|
648
|
+
async function applyInitialModel(sessionId, { provider, model, reasoningEffort } = {}) {
|
|
649
|
+
const providerId = String(provider ?? '').trim();
|
|
650
|
+
const modelId = String(model ?? '').trim();
|
|
651
|
+
if (!providerId || !modelId) return undefined;
|
|
652
|
+
try {
|
|
653
|
+
const ctrl = service('sessionController', 'session/selectModel');
|
|
654
|
+
const request = { sessionId, provider: providerId, model: modelId };
|
|
655
|
+
if (reasoningEffort) request.reasoningEffort = String(reasoningEffort);
|
|
656
|
+
await ctrl.selectModel(request, rpcSignal());
|
|
657
|
+
log(`cordis 新建会话模型 ${sessionId} → ${providerId}/${modelId}`);
|
|
658
|
+
return true;
|
|
659
|
+
} catch (err) {
|
|
660
|
+
log(`cordis 新建会话模型失败:${sessionId} ${providerId}/${modelId} — ${err?.code ?? err?.message ?? 'unknown'}`);
|
|
661
|
+
return false;
|
|
662
|
+
}
|
|
663
|
+
}
|
|
664
|
+
|
|
665
|
+
/**
|
|
666
|
+
* 切换会话权限预设(2026-11-21 二次修正:以宿主真写路径 permissionPresets.set 为主)。
|
|
667
|
+
*
|
|
668
|
+
* app.asar 铁证(本轮逐条核对,推翻上一轮的 Agent 对象推断):
|
|
669
|
+
* · 桌面端自己的 `SessionController.command(line)` =
|
|
670
|
+
* `ctx.remote.commands.execute(this.sessionId, line, [])` —— 第一个参数是
|
|
671
|
+
* **sessionId 字符串**,不是 Agent;上一轮改成传 Agent 是误判。
|
|
672
|
+
* · `commands/execute` 的 zod schema:parameter_0 = z.string()(sessionId)。
|
|
673
|
+
* · 权限**真写**在 `@deepseek-ai/dsh-permission-presets`:
|
|
674
|
+
* `permissionPresets.set(session, presetName)`(session 来自 sessions.list(),
|
|
675
|
+
* "written through to their own session events")—— 桌面端 auto-review
|
|
676
|
+
* 卸载时就是 `permissionPresets.set(session, "danger-full-access")`。
|
|
677
|
+
*
|
|
678
|
+
* 因此直接用宿主的真写 setter,session 从宿主内存里按 id 取:
|
|
679
|
+
* `sessions.get(taskId)` 或退回 `sessions.list().find(...)`(两种宿主版本都兼容)。
|
|
680
|
+
* 不再经过 `/permission` 命令注册表(那是给 UI 用的 human command registry,
|
|
681
|
+
* 远程调用实测 4500,具体宿主异常已随 detail 记进日志)。
|
|
682
|
+
* 会话不在宿主内存 → 4007 人话提示,不假装成功。
|
|
683
|
+
*/
|
|
684
|
+
async function switchPermission(taskId, preset) {
|
|
685
|
+
const sessions = service('sessions', 'sessions/get');
|
|
686
|
+
let session = typeof sessions.get === 'function' ? sessions.get(taskId) : undefined;
|
|
687
|
+
if (!session && typeof sessions.list === 'function') {
|
|
688
|
+
const all = sessions.list();
|
|
689
|
+
session = (Array.isArray(all) ? all : []).find(
|
|
690
|
+
(s) => s?.id === taskId || s?.sessionId === taskId);
|
|
691
|
+
}
|
|
692
|
+
if (!session) {
|
|
693
|
+
throw fail(4007, '会话当前不在电脑端内存里:先在电脑端打开它,再切换权限');
|
|
694
|
+
}
|
|
695
|
+
const presets = service('permissionPresets', 'permissionPresets/set');
|
|
696
|
+
try {
|
|
697
|
+
presets.set(session, preset);
|
|
698
|
+
} catch (err) {
|
|
699
|
+
// 记下真实宿主异常:真机再失败时可从日志确诊,不靠猜。
|
|
700
|
+
log(`cordis permission set 失败 ${taskId} ${preset}: ${err?.message ?? String(err)}`);
|
|
701
|
+
return { kind: 'error', text: err?.message ?? String(err), via: 'preset' };
|
|
702
|
+
}
|
|
703
|
+
log(`cordis permission ${taskId} → ${preset}(permissionPresets.set)`);
|
|
704
|
+
return { kind: 'ok', via: 'preset' };
|
|
705
|
+
}
|
|
706
|
+
|
|
707
|
+
/** 进程级权限目录。 */
|
|
708
|
+
async function permissionCatalog() {
|
|
709
|
+
const svc = service('permissionPresets', 'permissionPresets/catalog');
|
|
710
|
+
const raw = await svc.catalog();
|
|
711
|
+
return unwrapHost(raw);
|
|
712
|
+
}
|
|
713
|
+
|
|
714
|
+
/** 模型目录(provider 分组 + 部署默认)。 */
|
|
715
|
+
async function readModelCatalog() {
|
|
716
|
+
const ctrl = service('sessionController', 'session/modelCatalog');
|
|
717
|
+
const raw = await ctrl.modelCatalog();
|
|
718
|
+
return unwrapHost(raw);
|
|
719
|
+
}
|
|
720
|
+
|
|
721
|
+
async function assertTaskExists(taskId) {
|
|
722
|
+
const summaries = await summaryList();
|
|
723
|
+
if (!summaries.some((s) => s.sessionId === taskId)) throw fail(4011);
|
|
724
|
+
}
|
|
725
|
+
|
|
726
|
+
/**
|
|
727
|
+
* 会话置顶/归档集合(2026-11-18,与桌面端右键菜单同源)。
|
|
728
|
+
* 权威源 = workspaceRegistry(feed.ts 用它构建 baseline 的同一处):
|
|
729
|
+
* pinnedSessionIds / archivedSessionIds。尽力而为的附加字段——拿不到回空集合,
|
|
730
|
+
* 绝不让 listTasks 因它失败(否则整个侧栏空白)。
|
|
731
|
+
*/
|
|
732
|
+
function workspaceFlags() {
|
|
733
|
+
const empty = { pinned: new Set(), archived: new Set() };
|
|
734
|
+
try {
|
|
735
|
+
const reg = service('workspaceRegistry', 'workspace/flags');
|
|
736
|
+
const toSet = (v) => new Set(Array.isArray(v) ? v.map(String) : []);
|
|
737
|
+
return { pinned: toSet(reg.pinnedSessionIds), archived: toSet(reg.archivedSessionIds) };
|
|
738
|
+
} catch {
|
|
739
|
+
return empty;
|
|
740
|
+
}
|
|
741
|
+
}
|
|
742
|
+
|
|
743
|
+
/**
|
|
744
|
+
* 桌面侧栏的工作区分组(与桌面 tree.ts / WorkspaceFeed 对齐)。
|
|
745
|
+
*
|
|
746
|
+
* 权威源 = workspaceRegistry.list()(`WorkspaceFeed.baseline()` 与
|
|
747
|
+
* `workspaces()` 用的是同一处)。**返回形状以宿主源码为准**:
|
|
748
|
+
* `list()` 是同步方法,元素是 Workspace 对象
|
|
749
|
+
* `{ id, title, path, sessionIds: Set<string> }`。
|
|
750
|
+
*
|
|
751
|
+
* 2026-11-21 真机返工(分组条三点菜单整条消失)根因就在这两处形状误判:
|
|
752
|
+
* 1) 之前按 `ws.workspaceId` 取 id —— 字段其实叫 `id`,于是每个工作区都被
|
|
753
|
+
* `continue` 跳过,`workspaces` 恒为 `[]`;
|
|
754
|
+
* 2) 之前用 `Array.isArray(ws.sessionIds)` 判会话归属 —— 它是个 **Set**,
|
|
755
|
+
* 判空后 bySession 永远为空。
|
|
756
|
+
* 两处叠加的结果:所有任务 workspaceId 都是 null → 手机端全部退化成
|
|
757
|
+
* `cwd:` 兜底分组 → 分组头菜单被"非真实工作区"过滤条件全部挡掉。
|
|
758
|
+
* 实测证据:修复前 `/mobile/v1/tasks` 返回 `items:15, workspaces:[]`。
|
|
759
|
+
*
|
|
760
|
+
* 现在两种形状都收(`id ?? workspaceId`、Set 与数组都支持),
|
|
761
|
+
* 拿不到就回空索引——移动端退化为「未分组」,绝不猜 cwd 冒充工作区名。
|
|
762
|
+
*/
|
|
763
|
+
function workspaceIndex() {
|
|
764
|
+
const empty = { bySession: new Map(), groups: [] };
|
|
765
|
+
try {
|
|
766
|
+
const reg = service('workspaceRegistry', 'workspace/list');
|
|
767
|
+
const list = typeof reg.list === 'function' ? reg.list() : [];
|
|
768
|
+
if (!Array.isArray(list)) return empty;
|
|
769
|
+
const bySession = new Map();
|
|
770
|
+
const groups = [];
|
|
771
|
+
for (const ws of list) {
|
|
772
|
+
if (!ws) continue;
|
|
773
|
+
const id = String(ws.id ?? ws.workspaceId ?? '').trim();
|
|
774
|
+
if (!id) continue;
|
|
775
|
+
// 真实宿主是 title;旧快照里出现过 name(mock fixture 同形),两者都认。
|
|
776
|
+
const title = String(ws.title || ws.name || '').trim();
|
|
777
|
+
if (!title) continue;
|
|
778
|
+
groups.push({ id, name: title });
|
|
779
|
+
// sessionIds 在宿主里是 Set,别用 Array.isArray 判——那会把归属全丢掉。
|
|
780
|
+
const ids = ws.sessionIds instanceof Set
|
|
781
|
+
? [...ws.sessionIds]
|
|
782
|
+
: (Array.isArray(ws.sessionIds) ? ws.sessionIds : []);
|
|
783
|
+
for (const sid of ids) {
|
|
784
|
+
if (!sid) continue;
|
|
785
|
+
bySession.set(String(sid), { id, title });
|
|
786
|
+
}
|
|
787
|
+
}
|
|
788
|
+
return { bySession, groups };
|
|
789
|
+
} catch {
|
|
790
|
+
return empty;
|
|
791
|
+
}
|
|
792
|
+
}
|
|
793
|
+
|
|
794
|
+
function withFlags(task, flags) {
|
|
795
|
+
return {
|
|
796
|
+
...task,
|
|
797
|
+
pinned: flags.pinned.has(task.taskId),
|
|
798
|
+
archived: flags.archived.has(task.taskId),
|
|
799
|
+
};
|
|
800
|
+
}
|
|
801
|
+
|
|
802
|
+
const host = {
|
|
803
|
+
kind: 'cordis',
|
|
804
|
+
|
|
805
|
+
info() {
|
|
806
|
+
// caps = 协议能力(与 mock 同语义,客户端判 UI 用);
|
|
807
|
+
// services = 宿主服务可见性证据(X2 运行时快照,诊断用)。
|
|
808
|
+
const services = WATCHED_SERVICES.filter((n) => {
|
|
809
|
+
try {
|
|
810
|
+
const svc = typeof ctx.get === 'function' ? ctx.get(n) : undefined;
|
|
811
|
+
return svc !== undefined && svc !== null;
|
|
812
|
+
} catch {
|
|
813
|
+
return false;
|
|
814
|
+
}
|
|
815
|
+
});
|
|
816
|
+
return {
|
|
817
|
+
hostId: 'host_cordis',
|
|
818
|
+
hostName: hostname,
|
|
819
|
+
hostVersion: 'unknown',
|
|
820
|
+
platform: process.platform,
|
|
821
|
+
protocolVersion: '1.0',
|
|
822
|
+
caps: [...SERVED_CAPS],
|
|
823
|
+
services,
|
|
824
|
+
maxConcurrentTasks: 3,
|
|
825
|
+
};
|
|
826
|
+
},
|
|
827
|
+
|
|
828
|
+
async listTasks({ limit = 50, includeArchived = false } = {}) {
|
|
829
|
+
return call('session/list', async () => {
|
|
830
|
+
const summaries = await summaryList();
|
|
831
|
+
// 与桌面端侧栏同口径:冷会话(agentAvailable=false)也进列表,
|
|
832
|
+
// 由 summaryToTask 映射为 idle(可续)——之前只放行 running,
|
|
833
|
+
// 手机侧栏只剩 1 条(2026-11-17 真机反馈)。
|
|
834
|
+
//
|
|
835
|
+
// 可见性严格对齐桌面端 tree.ts 的 isVisible(2026-11-18 真机对账):
|
|
836
|
+
// · origin==='subagent' / 有 parentSessionId 的子会话只挂在父行的
|
|
837
|
+
// 子代理目录里,**不单独占任务条**;
|
|
838
|
+
// · blank 是「新会话」占位,桌面端只显示当前选中的那一条;
|
|
839
|
+
// · archived 默认隐藏,只在「已归档」视图(includeArchived)里出现。
|
|
840
|
+
// 真机实测:宿主 list 返回 48 条,其中 25 条已归档 + 一批子会话/空占位,
|
|
841
|
+
// 桌面端侧栏只有十几条——差异全部来自这三条规则。之前把归档项留在
|
|
842
|
+
// 列表里(怕没有恢复入口),结果用户点「删除/归档」后任务条纹丝不动,
|
|
843
|
+
// 读起来就是「点了没反应」。现在改为默认隐藏 + 独立归档视图恢复。
|
|
844
|
+
const flags = workspaceFlags();
|
|
845
|
+
const workspaces = workspaceIndex();
|
|
846
|
+
const visible = summaries.filter((s) => {
|
|
847
|
+
const id = String(s.sessionId);
|
|
848
|
+
if (s.origin === 'subagent') return false;
|
|
849
|
+
if (s.parentSessionId) return false;
|
|
850
|
+
// 正在跑的 blank 说明已经在产出内容(新建即发消息),保留,避免刚建的会话闪没。
|
|
851
|
+
if (s.blank === true && s.running !== true) return false;
|
|
852
|
+
return includeArchived ? flags.archived.has(id) : !flags.archived.has(id);
|
|
853
|
+
});
|
|
854
|
+
const items = visible
|
|
855
|
+
.sort((a, b) => {
|
|
856
|
+
const pa = flags.pinned.has(String(a.sessionId)) ? 1 : 0;
|
|
857
|
+
const pb = flags.pinned.has(String(b.sessionId)) ? 1 : 0;
|
|
858
|
+
if (pa !== pb) return pb - pa;
|
|
859
|
+
return (b.updatedAt ?? 0) - (a.updatedAt ?? 0);
|
|
860
|
+
})
|
|
861
|
+
.slice(0, limit)
|
|
862
|
+
.map((s) => withFlags(summaryToTask(s, hostname, workspaces), flags));
|
|
863
|
+
// 分组配置随列表下发:手机端据此给出与桌面一致的工作区标题与顺序。
|
|
864
|
+
return {
|
|
865
|
+
items,
|
|
866
|
+
workspaces: workspaces.groups,
|
|
867
|
+
nextCursor: null,
|
|
868
|
+
serverTime: new Date().toISOString(),
|
|
869
|
+
};
|
|
870
|
+
});
|
|
871
|
+
},
|
|
872
|
+
|
|
873
|
+
async getTask(taskId) {
|
|
874
|
+
return call('session/state', async () => {
|
|
875
|
+
const summaries = await summaryList();
|
|
876
|
+
const summary = summaries.find((s) => s.sessionId === taskId);
|
|
877
|
+
if (!summary) throw fail(4011);
|
|
878
|
+
const task = withFlags(summaryToTask(summary, hostname, workspaceIndex()), workspaceFlags());
|
|
879
|
+
// 产物清单要跟着详情一起回来。
|
|
880
|
+
//
|
|
881
|
+
// 为什么:手机端「对话里那句话提到的文件」要靠 `task.artifacts` 才认得出,
|
|
882
|
+
// 只给 `artifactsPreview: []` 的后果是——产物面板里有五个文件,对话里却
|
|
883
|
+
// 一个入口都没有(2026-11-17 实测)。推导成本与产物面板同一次事件读取,
|
|
884
|
+
// 所以直接复用同一条口径。
|
|
885
|
+
const artifacts = await taskArtifacts(taskId).catch(() => ({ items: [] }));
|
|
886
|
+
const items = artifacts.items ?? [];
|
|
887
|
+
task.artifactsCount = items.length;
|
|
888
|
+
// token 用量与产物同源(会话事件);宿主没给就 null,手机端省略而不是编造。
|
|
889
|
+
const tokenUsage = await eventPage(taskId, { maxMessages: 80 })
|
|
890
|
+
.then((page) => latestTurnUsage(page.records))
|
|
891
|
+
.catch(() => null);
|
|
892
|
+
return {
|
|
893
|
+
task,
|
|
894
|
+
// budget/pendingTodos 如实缺省(iOS 端全部可选解码);
|
|
895
|
+
// budget 走宿主 job/workingDirectory 语义后 v2 再接。
|
|
896
|
+
pendingTodos: [],
|
|
897
|
+
// 预览带前 12 条即可:手机上「对话里提到的」通常就是最近这几个,
|
|
898
|
+
// 完整清单仍由产物面板按需拉。
|
|
899
|
+
artifactsPreview: items.slice(0, 12),
|
|
900
|
+
tokenUsage,
|
|
901
|
+
lastSeq: 0,
|
|
902
|
+
serverTime: new Date().toISOString(),
|
|
903
|
+
};
|
|
904
|
+
});
|
|
905
|
+
},
|
|
906
|
+
|
|
907
|
+
async events(taskId, { beforeSeq, limit } = {}) {
|
|
908
|
+
return call('session/events', async () => {
|
|
909
|
+
const page = await eventPage(taskId, { beforeSeq, maxMessages: limit });
|
|
910
|
+
return {
|
|
911
|
+
taskId,
|
|
912
|
+
records: page.records,
|
|
913
|
+
hasMore: page.hasMore,
|
|
914
|
+
eventShape: host.eventShape ?? null,
|
|
915
|
+
};
|
|
916
|
+
});
|
|
917
|
+
},
|
|
918
|
+
|
|
919
|
+
async listArtifacts(taskId) {
|
|
920
|
+
// 宿主无「会话产物」端点。产物从**会话事件**里还原:写类工具调用带路径,
|
|
921
|
+
// 再拿 cwd 收边、去磁盘核对存在性与大小。这样点开的一定是真文件;
|
|
922
|
+
// 任务被回滚或文件被删掉,清单会自己变短,不会给用户一个 404。
|
|
923
|
+
return call('artifacts/derive', () => taskArtifacts(taskId));
|
|
924
|
+
},
|
|
925
|
+
|
|
926
|
+
async readArtifact(taskId, artifactId) {
|
|
927
|
+
return call('artifacts/read', async () => {
|
|
928
|
+
const cwd = await taskCwd(taskId);
|
|
929
|
+
if (!cwd) throw fail(4021, '主机未提供工作目录,产物无法定位');
|
|
930
|
+
const file = decodeArtifactId(cwd, artifactId);
|
|
931
|
+
if (!file) throw fail(4404, '产物不存在,或不在该任务的工作目录内');
|
|
932
|
+
const info = statSync(file);
|
|
933
|
+
if (info.size > 25 * 1024 * 1024) throw fail(4021, '产物过大,请在电脑端打开');
|
|
934
|
+
const name = file.split(/[\\/]/).pop();
|
|
935
|
+
return { name, mime: mimeOf(name), sizeBytes: info.size, data: readFileSync(file) };
|
|
936
|
+
});
|
|
937
|
+
},
|
|
938
|
+
|
|
939
|
+
async createTask({ prompt, cwd, attachments, permission, provider, model, reasoningEffort } = {}) {
|
|
940
|
+
return call('session/create+prompt', async () => {
|
|
941
|
+
if ((!prompt || !String(prompt).trim()) && !(Array.isArray(attachments) && attachments.length)) {
|
|
942
|
+
throw fail(4400, 'prompt 不能为空');
|
|
943
|
+
}
|
|
944
|
+
const ctrl = service('sessionController', 'session/create');
|
|
945
|
+
const created = await ctrl.create(cwd ? { cwd } : {});
|
|
946
|
+
// create 也走 {ok, value} 信封(考古 client.js:result.value.sessionId)
|
|
947
|
+
const sessionId = created?.ok === true ? created?.value?.sessionId : created?.sessionId;
|
|
948
|
+
if (!sessionId) throw fail(4500, '宿主 create 未返回 sessionId');
|
|
949
|
+
// 新会话还没有任何事件:基线就是 0,从第一条开始都在观察范围内。
|
|
950
|
+
const baseline = await preWriteSeq(sessionId);
|
|
951
|
+
// 新建会话默认权限(2026-11-20):必须排在**提交首条提示之前**。
|
|
952
|
+
// 顺序反了就等于「第一回合仍按电脑端默认策略跑」——用户以为选了只读,
|
|
953
|
+
// 模型却已经在首回合写过文件了。契约里这个字段一直存在,此前被网关丢掉,
|
|
954
|
+
// 手机端的权限选择器因此一直是空转的。
|
|
955
|
+
const permissionApplied = await applyPermissionPreset(sessionId, permission);
|
|
956
|
+
// 新建会话指定模型(2026-11-21):与权限同理,必须排在**提交首条提示之前**,
|
|
957
|
+
// 否则第一句话仍走电脑端默认模型,用户在新建页选的模型等于没选。
|
|
958
|
+
// 复用宿主 session/selectModel(与详情页模型胶囊同一动作),不另造协议。
|
|
959
|
+
const modelApplied = await applyInitialModel(sessionId, { provider, model, reasoningEffort });
|
|
960
|
+
const blocks = await attachmentBlocks(sessionId, attachments);
|
|
961
|
+
await submitPrompt(ctrl, sessionId, prompt ? String(prompt) : '', blocks);
|
|
962
|
+
// 新会话立刻进入观察集:宿主 running 标志可能晚一拍,等它就漏掉首条回复。
|
|
963
|
+
markWatched(sessionId, baseline);
|
|
964
|
+
log(`cordis create+prompt session=${sessionId}`);
|
|
965
|
+
// 响应字段按契约补齐。少了 `accepted` 的后果是灾难性的:客户端把它当
|
|
966
|
+
// 必填布尔,解码失败 → 判成可重试 → 队列无限重放同一 submissionId,
|
|
967
|
+
// 界面上就是「新建任务永远发不出去、气泡一直发送中」。
|
|
968
|
+
return { accepted: true, taskId: sessionId, queued: false, acceptedAt: new Date().toISOString(),
|
|
969
|
+
// 只有请求了权限才带这个字段(undefined 会被 JSON.stringify 丢掉)——
|
|
970
|
+
// 客户端据此区分「没要求」与「要求了但电脑端拒绝」。
|
|
971
|
+
permissionApplied, modelApplied };
|
|
972
|
+
});
|
|
973
|
+
},
|
|
974
|
+
|
|
975
|
+
async appendMessage(taskId, { text, attachments } = {}) {
|
|
976
|
+
return call('session/prompt', async () => {
|
|
977
|
+
const body = String(text ?? '').trim();
|
|
978
|
+
if (!body && !(Array.isArray(attachments) && attachments.length)) throw fail(4400, '消息不能为空');
|
|
979
|
+
const ctrl = service('sessionController', 'session/prompt');
|
|
980
|
+
// 先记写前水位,再提交:宿主会把这条指令写成 user/message,
|
|
981
|
+
// 水位若在提交后才取,刚好把它自己排除掉(实测「我的问题不见了,只看到回答」)。
|
|
982
|
+
const baseline = await preWriteSeq(taskId);
|
|
983
|
+
// 附件先翻译(文件要先上传宿主换 receiptId),再和文本一起提交。
|
|
984
|
+
const blocks = await attachmentBlocks(taskId, attachments);
|
|
985
|
+
await submitPrompt(ctrl, taskId, body, blocks);
|
|
986
|
+
// 提交成功即进入观察集:手机随后发的那条消息要能被推回来。
|
|
987
|
+
markWatched(taskId, baseline);
|
|
988
|
+
return {
|
|
989
|
+
accepted: true,
|
|
990
|
+
taskId,
|
|
991
|
+
turnId: requestIdOf,
|
|
992
|
+
mode: 'append',
|
|
993
|
+
acceptedAt: new Date().toISOString(),
|
|
994
|
+
};
|
|
995
|
+
});
|
|
996
|
+
},
|
|
997
|
+
|
|
998
|
+
async cancelTask(taskId) {
|
|
999
|
+
return call('session/cancel', async () => {
|
|
1000
|
+
const ctrl = service('sessionController', 'session/cancel');
|
|
1001
|
+
await ctrl.cancel({ sessionId: taskId });
|
|
1002
|
+
log(`cordis cancel session=${taskId}`);
|
|
1003
|
+
// cancelRequested / irreversible 同为契约字段:缺一个客户端就解码失败,
|
|
1004
|
+
// 用户点「停止」看到的是转圈,而不是「已请求停止」。
|
|
1005
|
+
return {
|
|
1006
|
+
accepted: true,
|
|
1007
|
+
cancelRequested: true,
|
|
1008
|
+
irreversible: false,
|
|
1009
|
+
taskId,
|
|
1010
|
+
at: new Date().toISOString(),
|
|
1011
|
+
};
|
|
1012
|
+
});
|
|
1013
|
+
},
|
|
1014
|
+
|
|
1015
|
+
// MARK: 提示词增强(真调模型,2026-11-18)
|
|
1016
|
+
|
|
1017
|
+
/**
|
|
1018
|
+
* 一次性补全:把草稿改写成结构化提示词。
|
|
1019
|
+
*
|
|
1020
|
+
* 走宿主 `llm.stream()`(GenerateOptions: provider/model/system/messages/
|
|
1021
|
+
* temperature/maxTokens/signal)。流式块里只累加 `text-delta`;`finish`
|
|
1022
|
+
* 的 reason 原样回传,便于客户端区分「被截断」与「正常结束」。
|
|
1023
|
+
*/
|
|
1024
|
+
async enhancePrompt({ text, provider, model } = {}) {
|
|
1025
|
+
return call('prompt/enhance', async () => {
|
|
1026
|
+
const source = String(text ?? '').trim();
|
|
1027
|
+
if (!source) throw fail(4400, '待增强的提示词不能为空');
|
|
1028
|
+
if (source.length > ENHANCE_INPUT_LIMIT) {
|
|
1029
|
+
throw fail(4400, `提示词过长(上限 ${ENHANCE_INPUT_LIMIT} 字)`);
|
|
1030
|
+
}
|
|
1031
|
+
|
|
1032
|
+
const llm = service('llm', 'prompt/enhance');
|
|
1033
|
+
if (typeof llm.stream !== 'function') {
|
|
1034
|
+
throw fail(4021, '宿主 llm 服务不支持一次性补全(缺 stream 方法)');
|
|
1035
|
+
}
|
|
1036
|
+
|
|
1037
|
+
// 路由:显式指定 > 宿主默认模型。默认模型来自 modelCatalog.default。
|
|
1038
|
+
let routeProvider = provider ? String(provider) : '';
|
|
1039
|
+
let routeModel = model ? String(model) : '';
|
|
1040
|
+
if (!routeProvider || !routeModel) {
|
|
1041
|
+
const catalog = await readModelCatalog();
|
|
1042
|
+
routeProvider = routeProvider || String(catalog?.default?.provider ?? '');
|
|
1043
|
+
routeModel = routeModel || String(catalog?.default?.model ?? '');
|
|
1044
|
+
}
|
|
1045
|
+
if (!routeProvider || !routeModel) {
|
|
1046
|
+
throw fail(4021, '宿主没有可用的默认模型,无法增强提示词');
|
|
1047
|
+
}
|
|
1048
|
+
|
|
1049
|
+
let output = '';
|
|
1050
|
+
let finishReason = null;
|
|
1051
|
+
try {
|
|
1052
|
+
const stream = llm.stream({
|
|
1053
|
+
provider: routeProvider,
|
|
1054
|
+
model: routeModel,
|
|
1055
|
+
system: ENHANCE_SYSTEM_PROMPT,
|
|
1056
|
+
messages: [{ role: 'user', content: [{ type: 'text', text: source }] }],
|
|
1057
|
+
temperature: 0.2,
|
|
1058
|
+
maxTokens: 1200,
|
|
1059
|
+
// 生成可能比普通 RPC 慢,用独立超时而不是 30s 的 rpcSignal。
|
|
1060
|
+
signal: AbortSignal.timeout(ENHANCE_TIMEOUT_MS),
|
|
1061
|
+
purpose: 'prompt-enhance',
|
|
1062
|
+
});
|
|
1063
|
+
for await (const chunk of stream) {
|
|
1064
|
+
if (chunk?.type === 'text-delta' && typeof chunk.text === 'string') {
|
|
1065
|
+
output += chunk.text;
|
|
1066
|
+
} else if (chunk?.type === 'finish') {
|
|
1067
|
+
// 宿主 FinishReason 实测是对象 `{kind:'stop'}`(deepseek-official 路由),
|
|
1068
|
+
// 早期契约写的是字符串。这里统一压成字符串再回给客户端——
|
|
1069
|
+
// iOS 的 finishReason 是 String?,对象会直接解码失败(实测踩到)。
|
|
1070
|
+
const reason = chunk.reason;
|
|
1071
|
+
finishReason = typeof reason === 'string' ? reason : (reason?.kind ?? null);
|
|
1072
|
+
}
|
|
1073
|
+
}
|
|
1074
|
+
} catch (err) {
|
|
1075
|
+
// 模型侧失败要给用户一句能读懂的话,而不是裸错误。
|
|
1076
|
+
throw fail(4500, `模型调用失败:${err?.message ?? String(err)}`);
|
|
1077
|
+
}
|
|
1078
|
+
|
|
1079
|
+
const enhanced = unwrapEnhancedText(output);
|
|
1080
|
+
if (!enhanced) throw fail(4500, '模型返回了空结果,请重试或换一个模型');
|
|
1081
|
+
|
|
1082
|
+
log(`cordis enhance provider=${routeProvider} model=${routeModel}`
|
|
1083
|
+
+ ` in=${source.length} out=${enhanced.length} finish=${finishReason ?? '?'}`);
|
|
1084
|
+
return {
|
|
1085
|
+
text: enhanced,
|
|
1086
|
+
provider: routeProvider,
|
|
1087
|
+
model: routeModel,
|
|
1088
|
+
finishReason,
|
|
1089
|
+
at: new Date().toISOString(),
|
|
1090
|
+
};
|
|
1091
|
+
});
|
|
1092
|
+
},
|
|
1093
|
+
|
|
1094
|
+
// MARK: 会话动作(2026-11-18,与桌面端 Session 右键菜单同源)
|
|
1095
|
+
//
|
|
1096
|
+
// 全部来自 app.asar 反编译的 @Remote 实证(见 spike0/RUNBOOK §10):
|
|
1097
|
+
// · 置顶/归档 → workspaceController,单参数请求,无 signal 形参;
|
|
1098
|
+
// 返回完整集合 pinnedSessionIds / archivedSessionIds({ok,value} 信封)。
|
|
1099
|
+
// · 重命名/分叉 → sessionController,rename({sessionId,title}) 与
|
|
1100
|
+
// fork({sessionId,atSeq?,allowMigration?}),同样单参数。
|
|
1101
|
+
// 宿主码 workspace/session-active(归档运行中会话未带 stopActivity)走
|
|
1102
|
+
// HOST_CODE_MAP 默认 4500;归档前由 REST 层显式带 stopActivity=true 规避。
|
|
1103
|
+
|
|
1104
|
+
// MARK: 工作区写动作(2026-11-21,与桌面端分组右键菜单同源)
|
|
1105
|
+
//
|
|
1106
|
+
// app.asar 铁证:桌面端分组三点菜单「重命名 / 删除工作区」走宿主
|
|
1107
|
+
// workspaceController 的 @Remote('rename') / @Remote('delete'),与 pin/archive
|
|
1108
|
+
// 同一个 service、同样单参数无 signal(RPC 元数据 invocation.kind='direct')。
|
|
1109
|
+
// · rename({ workspaceId, title }) → WorkspaceValue
|
|
1110
|
+
// · delete({ workspaceId }) → { deleted: true }
|
|
1111
|
+
// 删除只移除分组注册:文件夹与会话保留,会话落到「未分组」(桌面端 delete.desc
|
|
1112
|
+
// 原文),不是删文件——这点必须在 UI 文案里如实说明。
|
|
1113
|
+
// owner-only 不是障碍:适配器与控制器同处宿主进程,直调视同 owner。
|
|
1114
|
+
async renameWorkspace(workspaceId, { title } = {}) {
|
|
1115
|
+
return call('workspace/rename', async () => {
|
|
1116
|
+
const id = String(workspaceId ?? '').trim();
|
|
1117
|
+
const name = String(title ?? '').trim();
|
|
1118
|
+
if (!id) throw fail(4400, 'workspaceId 不能为空');
|
|
1119
|
+
if (!name) throw fail(4400, '工作区名称不能为空');
|
|
1120
|
+
const ctrl = service('workspaceController', 'workspace/rename');
|
|
1121
|
+
const raw = await ctrl.rename({ workspaceId: id, title: name });
|
|
1122
|
+
const value = unwrapHost(raw);
|
|
1123
|
+
const finalTitle = String(
|
|
1124
|
+
value?.workspace?.title ?? value?.title ?? name);
|
|
1125
|
+
log(`cordis rename workspace=${id} → ${finalTitle}`);
|
|
1126
|
+
return { applied: true, workspaceId: id, title: finalTitle, at: new Date().toISOString() };
|
|
1127
|
+
});
|
|
1128
|
+
},
|
|
1129
|
+
|
|
1130
|
+
async deleteWorkspace(workspaceId) {
|
|
1131
|
+
return call('workspace/delete', async () => {
|
|
1132
|
+
const id = String(workspaceId ?? '').trim();
|
|
1133
|
+
if (!id) throw fail(4400, 'workspaceId 不能为空');
|
|
1134
|
+
const ctrl = service('workspaceController', 'workspace/delete');
|
|
1135
|
+
const raw = await ctrl.delete({ workspaceId: id });
|
|
1136
|
+
unwrapHost(raw);
|
|
1137
|
+
log(`cordis delete workspace=${id}(会话落到未分组,文件保留)`);
|
|
1138
|
+
return { applied: true, workspaceId: id, deleted: true, at: new Date().toISOString() };
|
|
1139
|
+
});
|
|
1140
|
+
},
|
|
1141
|
+
|
|
1142
|
+
async pinTask(taskId, { pinned = true } = {}) {
|
|
1143
|
+
return call('workspace/pinSession', async () => {
|
|
1144
|
+
const ctrl = service('workspaceController', 'workspace/pinSession');
|
|
1145
|
+
const action = pinned ? 'pinSession' : 'unpinSession';
|
|
1146
|
+
const raw = await ctrl[action]({ sessionId: taskId });
|
|
1147
|
+
const value = unwrapHost(raw);
|
|
1148
|
+
const ids = Array.isArray(value?.pinnedSessionIds) ? value.pinnedSessionIds.map(String) : [];
|
|
1149
|
+
log(`cordis ${action} session=${taskId} total=${ids.length}`);
|
|
1150
|
+
return { applied: true, taskId, pinned, pinnedSessionIds: ids, at: new Date().toISOString() };
|
|
1151
|
+
});
|
|
1152
|
+
},
|
|
1153
|
+
|
|
1154
|
+
async archiveTask(taskId, { archived = true, stopActivity = false } = {}) {
|
|
1155
|
+
return call('workspace/archiveSession', async () => {
|
|
1156
|
+
const ctrl = service('workspaceController', 'workspace/archiveSession');
|
|
1157
|
+
const action = archived ? 'archiveSession' : 'unarchiveSession';
|
|
1158
|
+
const request = { sessionId: taskId };
|
|
1159
|
+
// 只有归档(非恢复)且显式要求时才带 stopActivity;恢复动作的请求类型无此字段。
|
|
1160
|
+
if (archived && stopActivity === true) request.stopActivity = true;
|
|
1161
|
+
const raw = await ctrl[action](request);
|
|
1162
|
+
const value = unwrapHost(raw);
|
|
1163
|
+
const ids = Array.isArray(value?.archivedSessionIds) ? value.archivedSessionIds.map(String) : [];
|
|
1164
|
+
log(`cordis ${action} session=${taskId} total=${ids.length}`);
|
|
1165
|
+
return { applied: true, taskId, archived, archivedSessionIds: ids, at: new Date().toISOString() };
|
|
1166
|
+
});
|
|
1167
|
+
},
|
|
1168
|
+
|
|
1169
|
+
async renameTask(taskId, { title } = {}) {
|
|
1170
|
+
return call('session/rename', async () => {
|
|
1171
|
+
const name = String(title ?? '').trim();
|
|
1172
|
+
if (!name) throw fail(4400, '标题不能为空');
|
|
1173
|
+
await assertTaskExists(taskId);
|
|
1174
|
+
const ctrl = service('sessionController', 'session/rename');
|
|
1175
|
+
const raw = await ctrl.rename({ sessionId: taskId, title: name });
|
|
1176
|
+
const value = unwrapHost(raw);
|
|
1177
|
+
log(`cordis rename session=${taskId} seq=${value?.seq ?? '?'}`);
|
|
1178
|
+
return {
|
|
1179
|
+
applied: true,
|
|
1180
|
+
taskId,
|
|
1181
|
+
title: String(value?.title ?? name),
|
|
1182
|
+
seq: Number.isFinite(value?.seq) ? value.seq : 0,
|
|
1183
|
+
at: new Date().toISOString(),
|
|
1184
|
+
};
|
|
1185
|
+
});
|
|
1186
|
+
},
|
|
1187
|
+
|
|
1188
|
+
async forkTask(taskId) {
|
|
1189
|
+
return call('session/fork', async () => {
|
|
1190
|
+
await assertTaskExists(taskId);
|
|
1191
|
+
const ctrl = service('sessionController', 'session/fork');
|
|
1192
|
+
const raw = await ctrl.fork({ sessionId: taskId });
|
|
1193
|
+
const value = unwrapHost(raw);
|
|
1194
|
+
const newId = value?.sessionId;
|
|
1195
|
+
if (!newId) throw fail(4500, '宿主 fork 未返回新会话 ID');
|
|
1196
|
+
// 新会话立刻进入观察集(与 create 同理由:首轮回复不能漏)。
|
|
1197
|
+
markWatched(String(newId), 0);
|
|
1198
|
+
log(`cordis fork session=${taskId} → ${newId}`);
|
|
1199
|
+
return { accepted: true, taskId, forkedTaskId: String(newId), at: new Date().toISOString() };
|
|
1200
|
+
});
|
|
1201
|
+
},
|
|
1202
|
+
|
|
1203
|
+
async answerTodo() {
|
|
1204
|
+
// 宿主审批面走 session/control(namespace 下存在该动作),请求形状 v2 考古后接入。
|
|
1205
|
+
throw fail(4021, '待办答复尚未与宿主 session/control 对齐', { detail: 'method=todos.answer' });
|
|
1206
|
+
},
|
|
1207
|
+
|
|
1208
|
+
// MARK: 会话设置同步(2026-11-17,工作区权限 + 模型选择与桌面端同源)
|
|
1209
|
+
//
|
|
1210
|
+
// 考古证据(app.asar 实证,全部为 sessionController / permissionPresets / commands
|
|
1211
|
+
// 的进程内动作):
|
|
1212
|
+
// · 权限当前值:session/projections → values.permissions.currentValue
|
|
1213
|
+
// ("a configured preset key, `auto`, or `custom`");
|
|
1214
|
+
// · 权限可选项:permissionPresets.catalog() → { options: [{value, name, description?}] };
|
|
1215
|
+
// · 权限切换:桌面端 PermissionSelect 走 `session.command("/permission <preset>")`,
|
|
1216
|
+
// 进程内 = commands/execute(**Agent**, "/permission x", [], signal);
|
|
1217
|
+
// 会话还没起回合(无活体 Agent)时退回 permissionPresets.set(Session, name)
|
|
1218
|
+
// ——第一个形参是 Agent / Session 对象,不是 id 字符串(见 switchPermission);
|
|
1219
|
+
// · 模型当前值:session/projections → values.modelSelection.next ?? lastUsed;
|
|
1220
|
+
// · 模型目录:session/modelCatalog() → { default, groups: [{id,name,models}] };
|
|
1221
|
+
// · 模型切换:session/selectModel({sessionId, provider, model, reasoningEffort?})。
|
|
1222
|
+
// 任何一个面取不到都降级为 supported:false——手机端如实显示,不编造目录。
|
|
1223
|
+
async sessionSettings(taskId) {
|
|
1224
|
+
return call('session/settings', async () => {
|
|
1225
|
+
await assertTaskExists(taskId);
|
|
1226
|
+
// 三个面彼此独立:缺哪个就把哪一节标成 supported:false,绝不让整个接口 500。
|
|
1227
|
+
const [projection, presets, catalog] = await Promise.all([
|
|
1228
|
+
readProjections(taskId).catch((err) => {
|
|
1229
|
+
log(`cordis projections 失败:${err?.code ?? err?.message ?? 'unknown'}`);
|
|
1230
|
+
return null;
|
|
1231
|
+
}),
|
|
1232
|
+
permissionCatalog().catch((err) => {
|
|
1233
|
+
log(`cordis permissionPresets 失败:${err?.code ?? err?.message ?? 'unknown'}`);
|
|
1234
|
+
return null;
|
|
1235
|
+
}),
|
|
1236
|
+
readModelCatalog().catch((err) => {
|
|
1237
|
+
log(`cordis modelCatalog 失败:${err?.code ?? err?.message ?? 'unknown'}`);
|
|
1238
|
+
return null;
|
|
1239
|
+
}),
|
|
1240
|
+
]);
|
|
1241
|
+
|
|
1242
|
+
const values = projection?.values ?? null;
|
|
1243
|
+
const permissionValue = values?.permissions?.currentValue ?? null;
|
|
1244
|
+
const selection = values?.modelSelection ?? null;
|
|
1245
|
+
const currentModel = selection?.next ?? selection?.lastUsed ?? null;
|
|
1246
|
+
|
|
1247
|
+
const presetOptions = Array.isArray(presets?.options) ? presets.options : [];
|
|
1248
|
+
const groups = Array.isArray(catalog?.groups) ? catalog.groups : [];
|
|
1249
|
+
|
|
1250
|
+
return {
|
|
1251
|
+
taskId,
|
|
1252
|
+
permission: {
|
|
1253
|
+
supported: presetOptions.length > 0 && permissionValue !== null,
|
|
1254
|
+
currentValue: permissionValue,
|
|
1255
|
+
options: presetOptions.map((o) => ({
|
|
1256
|
+
value: o.value,
|
|
1257
|
+
name: o.name,
|
|
1258
|
+
...(typeof o.description === 'string' ? { description: o.description } : {}),
|
|
1259
|
+
})),
|
|
1260
|
+
},
|
|
1261
|
+
model: {
|
|
1262
|
+
supported: groups.length > 0,
|
|
1263
|
+
current: currentModel,
|
|
1264
|
+
default: catalog?.default ?? null,
|
|
1265
|
+
groups: groups.map((g) => ({
|
|
1266
|
+
id: g.id,
|
|
1267
|
+
name: g.name,
|
|
1268
|
+
models: (Array.isArray(g.models) ? g.models : []).map((m) => ({
|
|
1269
|
+
id: m.id,
|
|
1270
|
+
name: m.name,
|
|
1271
|
+
...(typeof m.description === 'string' ? { description: m.description } : {}),
|
|
1272
|
+
...(m.reasoning?.defaultEffort ? { defaultEffort: m.reasoning.defaultEffort } : {}),
|
|
1273
|
+
})),
|
|
1274
|
+
})),
|
|
1275
|
+
failures: Array.isArray(catalog?.failures) ? catalog.failures : [],
|
|
1276
|
+
},
|
|
1277
|
+
serverTime: new Date().toISOString(),
|
|
1278
|
+
};
|
|
1279
|
+
});
|
|
1280
|
+
},
|
|
1281
|
+
|
|
1282
|
+
/**
|
|
1283
|
+
* App 级设置目录(2026-11-20):与「某条会话」无关的进程级两面。
|
|
1284
|
+
*
|
|
1285
|
+
* 手机端设置面板要能先选「新建会话默认权限」和查看「跟随电脑端的模型」,
|
|
1286
|
+
* 而 `GET /tasks/:id/settings` 必须先有会话——第一次打开 App 时一条都没有,
|
|
1287
|
+
* 面板就会空着。permissionPresets / modelCatalog 本来就是**进程级服务**,
|
|
1288
|
+
* 这里直接把两面取出来,不编任何目录。
|
|
1289
|
+
*
|
|
1290
|
+
* 与 sessionSettings 的差别只有一处:没有 currentValue(那是会话级事实)。
|
|
1291
|
+
* 某个面取不到 → supported:false,手机端如实显示「跟随电脑端」。
|
|
1292
|
+
*/
|
|
1293
|
+
async appSettings() {
|
|
1294
|
+
return call('app/settings', async () => {
|
|
1295
|
+
const [presets, catalog] = await Promise.all([
|
|
1296
|
+
permissionCatalog().catch((err) => {
|
|
1297
|
+
log(`cordis permissionPresets 失败:${err?.code ?? err?.message ?? 'unknown'}`);
|
|
1298
|
+
return null;
|
|
1299
|
+
}),
|
|
1300
|
+
readModelCatalog().catch((err) => {
|
|
1301
|
+
log(`cordis modelCatalog 失败:${err?.code ?? err?.message ?? 'unknown'}`);
|
|
1302
|
+
return null;
|
|
1303
|
+
}),
|
|
1304
|
+
]);
|
|
1305
|
+
|
|
1306
|
+
const presetOptions = Array.isArray(presets?.options) ? presets.options : [];
|
|
1307
|
+
const groups = Array.isArray(catalog?.groups) ? catalog.groups : [];
|
|
1308
|
+
|
|
1309
|
+
return {
|
|
1310
|
+
permission: {
|
|
1311
|
+
supported: presetOptions.length > 0,
|
|
1312
|
+
options: presetOptions.map((o) => ({
|
|
1313
|
+
value: o.value,
|
|
1314
|
+
name: o.name,
|
|
1315
|
+
...(typeof o.description === 'string' ? { description: o.description } : {}),
|
|
1316
|
+
})),
|
|
1317
|
+
},
|
|
1318
|
+
model: {
|
|
1319
|
+
supported: groups.length > 0,
|
|
1320
|
+
default: catalog?.default ?? null,
|
|
1321
|
+
groups: groups.map((g) => ({
|
|
1322
|
+
id: g.id,
|
|
1323
|
+
name: g.name,
|
|
1324
|
+
models: (Array.isArray(g.models) ? g.models : []).map((m) => ({
|
|
1325
|
+
id: m.id,
|
|
1326
|
+
name: m.name,
|
|
1327
|
+
...(typeof m.description === 'string' ? { description: m.description } : {}),
|
|
1328
|
+
...(m.reasoning?.defaultEffort ? { defaultEffort: m.reasoning.defaultEffort } : {}),
|
|
1329
|
+
})),
|
|
1330
|
+
})),
|
|
1331
|
+
failures: Array.isArray(catalog?.failures) ? catalog.failures : [],
|
|
1332
|
+
},
|
|
1333
|
+
serverTime: new Date().toISOString(),
|
|
1334
|
+
};
|
|
1335
|
+
});
|
|
1336
|
+
},
|
|
1337
|
+
|
|
1338
|
+
async setPermission(taskId, { preset } = {}) {
|
|
1339
|
+
return call('permission/switch', async () => {
|
|
1340
|
+
const body = String(preset ?? '').trim();
|
|
1341
|
+
if (!body) throw fail(4400, 'preset 不能为空');
|
|
1342
|
+
await assertTaskExists(taskId);
|
|
1343
|
+
// 与桌面端同一条写路径;活体与直写两条分支的取舍见 switchPermission。
|
|
1344
|
+
const switched = await switchPermission(taskId, body);
|
|
1345
|
+
if (switched.kind === 'error') {
|
|
1346
|
+
throw fail(4500, `权限切换被宿主拒绝:${switched.text ?? '未知原因'}`);
|
|
1347
|
+
}
|
|
1348
|
+
log(`cordis permission ${taskId} → ${body}(${switched.via})`);
|
|
1349
|
+
return { applied: true, taskId, value: body, via: switched.via, at: new Date().toISOString() };
|
|
1350
|
+
});
|
|
1351
|
+
},
|
|
1352
|
+
|
|
1353
|
+
async selectModel(taskId, { provider, model, reasoningEffort } = {}) {
|
|
1354
|
+
return call('model/select', async () => {
|
|
1355
|
+
const providerId = String(provider ?? '').trim();
|
|
1356
|
+
const modelId = String(model ?? '').trim();
|
|
1357
|
+
if (!providerId || !modelId) throw fail(4400, 'provider 与 model 不能为空');
|
|
1358
|
+
await assertTaskExists(taskId);
|
|
1359
|
+
const ctrl = service('sessionController', 'session/selectModel');
|
|
1360
|
+
const request = { sessionId: taskId, provider: providerId, model: modelId };
|
|
1361
|
+
if (reasoningEffort) request.reasoningEffort = String(reasoningEffort);
|
|
1362
|
+
const raw = await ctrl.selectModel(request, rpcSignal());
|
|
1363
|
+
unwrapHost(raw);
|
|
1364
|
+
log(`cordis selectModel ${taskId} → ${providerId}/${modelId}`);
|
|
1365
|
+
return {
|
|
1366
|
+
applied: true,
|
|
1367
|
+
taskId,
|
|
1368
|
+
selection: { provider: providerId, model: modelId, ...(reasoningEffort ? { reasoningEffort } : {}) },
|
|
1369
|
+
at: new Date().toISOString(),
|
|
1370
|
+
};
|
|
1371
|
+
});
|
|
1372
|
+
},
|
|
1373
|
+
|
|
1374
|
+
/**
|
|
1375
|
+
* X2 取证:宿主服务方法面(方法名/形参个数)。只暴露元信息,
|
|
1376
|
+
* 不含任何会话内容——用于核对 prompt/create 等动作的真实签名。
|
|
1377
|
+
*/
|
|
1378
|
+
async diag() {
|
|
1379
|
+
const present = [];
|
|
1380
|
+
const missing = [];
|
|
1381
|
+
for (const n of WATCHED_SERVICES) {
|
|
1382
|
+
try {
|
|
1383
|
+
const svc = typeof ctx.get === 'function' ? ctx.get(n) : undefined;
|
|
1384
|
+
(svc !== undefined && svc !== null ? present : missing).push(n);
|
|
1385
|
+
} catch {
|
|
1386
|
+
missing.push(n);
|
|
1387
|
+
}
|
|
1388
|
+
}
|
|
1389
|
+
const methods = {};
|
|
1390
|
+
const sources = {};
|
|
1391
|
+
for (const n of present) {
|
|
1392
|
+
try { methods[n] = methodSurface(ctx.get(n)); } catch { /* 内省失败不挡诊断 */ }
|
|
1393
|
+
}
|
|
1394
|
+
// 关键动作源码取证(RPC 包装器会暴露动作名与参数映射;只取我们映射用到的方法)
|
|
1395
|
+
try {
|
|
1396
|
+
const sc = ctx.get('sessionController');
|
|
1397
|
+
if (sc) {
|
|
1398
|
+
for (const m of ['prompt', 'list', 'create', 'cancel', 'state', 'rename', 'fork']) {
|
|
1399
|
+
if (typeof sc[m] === 'function') sources[m] = String(sc[m]).slice(0, 1600);
|
|
1400
|
+
}
|
|
1401
|
+
}
|
|
1402
|
+
const wc = ctx.get('workspaceController');
|
|
1403
|
+
if (wc) {
|
|
1404
|
+
for (const m of ['pinSession', 'unpinSession', 'archiveSession', 'unarchiveSession']) {
|
|
1405
|
+
if (typeof wc[m] === 'function') sources[`workspace.${m}`] = String(wc[m]).slice(0, 1600);
|
|
1406
|
+
}
|
|
1407
|
+
}
|
|
1408
|
+
} catch { /* 忽略 */ }
|
|
1409
|
+
return {
|
|
1410
|
+
adapter: 'cordis',
|
|
1411
|
+
services: { present, missing },
|
|
1412
|
+
methods,
|
|
1413
|
+
...(Object.keys(sources).length ? { sources } : {}),
|
|
1414
|
+
hostName: hostname,
|
|
1415
|
+
};
|
|
1416
|
+
},
|
|
1417
|
+
/**
|
|
1418
|
+
* 实时事件流 v2:轮询宿主 events(),把新事件翻译成网关 `turn` 帧推出去。
|
|
1419
|
+
*
|
|
1420
|
+
* 上一版这里是空实现(只打一行日志),后果是所有写操作都「看起来没反应」:
|
|
1421
|
+
* 手机发了消息,网关收下了、宿主也跑了,但没有任何帧能到达手机,
|
|
1422
|
+
* 时间线永远停在原地(2026-11-17 真机反馈「发出信息都无反应」的真因)。
|
|
1423
|
+
*/
|
|
1424
|
+
subscribe(fn) {
|
|
1425
|
+
liveListener = fn;
|
|
1426
|
+
if (!liveTimer) {
|
|
1427
|
+
// 立刻来一轮:手机连上就能拿到当前状态,不用等一个轮询周期。
|
|
1428
|
+
void pollLive();
|
|
1429
|
+
liveTimer = setInterval(() => void pollLive(), LIVE_POLL_MS);
|
|
1430
|
+
if (typeof liveTimer.unref === 'function') liveTimer.unref();
|
|
1431
|
+
}
|
|
1432
|
+
return () => {
|
|
1433
|
+
liveListener = null;
|
|
1434
|
+
if (liveTimer) clearInterval(liveTimer);
|
|
1435
|
+
liveTimer = null;
|
|
1436
|
+
watched.clear();
|
|
1437
|
+
};
|
|
1438
|
+
},
|
|
1439
|
+
|
|
1440
|
+
async close() {},
|
|
1441
|
+
};
|
|
1442
|
+
|
|
1443
|
+
return host;
|
|
1444
|
+
}
|