@aiti-ai/ext-shared 0.0.0-stage → 0.1.11
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/LICENSE +21 -0
- package/README.md +36 -2
- package/agent-accounts.test.mjs +227 -0
- package/agent-accounts.ts +324 -0
- package/agent-capability-contract.test.mjs +129 -0
- package/agent-interaction.test.mjs +194 -0
- package/agent-interaction.ts +340 -0
- package/agent-launch.test.mjs +262 -0
- package/agent-spawn-env.test.mjs +169 -0
- package/agent-spawn-env.ts +548 -0
- package/aiti-editor-inject.mjs +49 -0
- package/backend-queue.test.mjs +336 -0
- package/backend-queue.ts +469 -0
- package/blob-save-route.ts +128 -0
- package/cbc-model-catalog.ts +86 -0
- package/check-client.mjs +273 -0
- package/check-ext-globals.mjs +144 -0
- package/controlled-login-dialog.mjs +270 -0
- package/controlled-login.mjs +398 -0
- package/controlled-login.test.mjs +466 -0
- package/convert-saveas.test.mjs +39 -0
- package/convert-saveas.ts +170 -0
- package/copy-client-bundle.mjs +39 -0
- package/cursor-cli-store.ts +377 -0
- package/dedupe-fetch.test.mjs +71 -0
- package/dedupe-fetch.ts +58 -0
- package/deploy-commit.mjs +52 -0
- package/dev-pack.mjs +246 -0
- package/dock-icons.ts +127 -0
- package/esbuild-bin.test.mjs +53 -0
- package/esbuild-bin.ts +66 -0
- package/exec-async.test.mjs +86 -0
- package/exec-async.ts +179 -0
- package/ext-display-names.ts +91 -0
- package/ext-entry-contracts.test.mjs +131 -0
- package/ext-float-dock-core.test.mjs +348 -0
- package/ext-float-dock-core.ts +783 -0
- package/ext-float-dock-lite.ts +52 -0
- package/ext-float-dock.test.mjs +286 -0
- package/ext-float-dock.ts +740 -0
- package/ext-icons-deploy.mjs +24 -0
- package/ext-lazy.test.mjs +186 -0
- package/ext-lazy.tsx +183 -0
- package/ext-model-state.test.mjs +272 -0
- package/ext-model-state.ts +324 -0
- package/ext-protocol.mjs +113 -0
- package/ext-protocol.test.mjs +88 -0
- package/ext-session-usage.test.mjs +219 -0
- package/ext-session-usage.ts +507 -0
- package/external-cli-governance.ts +153 -0
- package/git-ops-client/api.mjs +56 -0
- package/git-ops-client/branch-panel.tsx +987 -0
- package/git-ops-client/i18n.mjs +328 -0
- package/host-tools-allow.test.mjs +46 -0
- package/host-tools-allow.ts +84 -0
- package/icons/alert.svg +1 -0
- package/icons/bookmark.svg +1 -0
- package/icons/bot.svg +1 -0
- package/icons/chart-column.svg +1 -0
- package/icons/check-circle.svg +1 -0
- package/icons/clipboard-list.svg +1 -0
- package/icons/clock.svg +1 -0
- package/icons/coffee.svg +1 -0
- package/icons/edit.svg +1 -0
- package/icons/eye.svg +1 -0
- package/icons/git-branch.svg +1 -0
- package/icons/git-commit-horizontal.svg +1 -0
- package/icons/globe.svg +1 -0
- package/icons/history.svg +1 -0
- package/icons/import.svg +1 -0
- package/icons/inbox.svg +1 -0
- package/icons/key-round.svg +1 -0
- package/icons/layout-grid.svg +1 -0
- package/icons/mail.svg +1 -0
- package/icons/message-circle.svg +1 -0
- package/icons/message-square.svg +1 -0
- package/icons/meter-vertical.svg +1 -0
- package/icons/mic.svg +1 -0
- package/icons/monitor.svg +1 -0
- package/icons/pen-line.svg +1 -0
- package/icons/plug.svg +1 -0
- package/icons/radio-dot.svg +1 -0
- package/icons/radio.svg +1 -0
- package/icons/refresh.svg +1 -0
- package/icons/rocket.svg +1 -0
- package/icons/search.svg +1 -0
- package/icons/shield.svg +1 -0
- package/icons/sparkles.svg +1 -0
- package/icons/square-kanban.svg +1 -0
- package/icons/terminal.svg +1 -0
- package/icons/users.svg +1 -0
- package/icons/volume-2.svg +1 -0
- package/icons/wand.svg +1 -0
- package/icons/wrench.svg +1 -0
- package/icons/x-circle.svg +1 -0
- package/icons/x.svg +1 -0
- package/ignore-semantics.ts +76 -0
- package/lazy-loading-metrics.mjs +61 -0
- package/new-session-cwd.test.mjs +389 -0
- package/new-session-cwd.ts +253 -0
- package/open-viewer-window.ts +65 -0
- package/overlay-back-client.test.mjs +123 -0
- package/overlay-back-client.ts +87 -0
- package/package.json +65 -4
- package/pi-fork-rpc/README.md +12 -0
- package/pi-fork-rpc/cli-resolve.test.mjs +42 -0
- package/pi-fork-rpc/cli-resolve.ts +79 -0
- package/pi-fork-rpc/remote-queue.test.mjs +100 -0
- package/pi-fork-rpc/remote-queue.ts +140 -0
- package/pi-fork-rpc/spec.ts +106 -0
- package/pi-fork-rpc/wire.test.mjs +260 -0
- package/pi-fork-rpc/wire.ts +367 -0
- package/popup-anchor.ts +45 -0
- package/provider-priority-contract.test.mjs +55 -0
- package/reconcile-deps.mjs +41 -0
- package/reload-instances.mjs +60 -0
- package/seed-tool.test.mjs +95 -0
- package/seed-tool.ts +88 -0
- package/session-recycle.ts +109 -0
- package/shared-copy-sync.test.mjs +115 -0
- package/soffice-locate.ts +171 -0
- package/soffice-panel.ts +239 -0
- package/sync-dir.mjs +91 -0
- package/sync-dir.test.mjs +101 -0
- package/sync-gate.test.mjs +93 -0
- package/sync-mirror.test.mjs +85 -0
- package/task-list.test.mjs +91 -0
- package/task-list.ts +118 -0
- package/test-rm-rf.mjs +33 -0
- package/ui-dialogs.test.mjs +198 -0
- package/ui-dialogs.ts +310 -0
package/backend-queue.ts
ADDED
|
@@ -0,0 +1,469 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* backend-queue — 后端会话队列共享实现层(docs/backend-queue-manager-plan.md §3)。
|
|
3
|
+
*
|
|
4
|
+
* 把 aiti-zcode-agent handle 里验证过的「本地 followUp 队列 + steer 镜像 + queueManage
|
|
5
|
+
* 全 action + settle 自动续轮 + user 气泡 + steer 失败降级」抽成组合式 helper:
|
|
6
|
+
* 各后端 handle 以 ≤15 行接入(组合,不改 pi-web core)。
|
|
7
|
+
*
|
|
8
|
+
* ⚠ 权威源:本文件(pi-web-ext/_shared/backend-queue.ts)。部署时复制进各扩展目录
|
|
9
|
+
* (同 external-cli-governance 先例)——改动须同步全部副本,头部保留本注释。
|
|
10
|
+
*
|
|
11
|
+
* 语义要点:
|
|
12
|
+
* - 分流(routePrompt):running + streamingBehavior==="followUp" → 本地队列(可撤回);
|
|
13
|
+
* running + steer 注入可用 → steer()(协议相关,可缺省);steer 失败 → 降级入本地队列
|
|
14
|
+
* (R9 泛化:消息不丢、不打断原轮、不产生双 settled);空闲 → dispatch(由 handle 提供,
|
|
15
|
+
* support 只管队列,发送永远由 handle 执行)。
|
|
16
|
+
* - 队列条目带图片({text, images},闭环 zcode R4);queue_update wire 仍只传文本
|
|
17
|
+
* (前端面板无需感知图片);recall/remove 的 entry/removed 带 hasImages/images 供取回还原。
|
|
18
|
+
* - settled 轮账本无关:scheduleDrain 由 handle 在 settle/finally 后调用,幂等
|
|
19
|
+
* (running 中 no-op)——与各后端 settle 时序差异解耦(plan G2)。
|
|
20
|
+
* - rev 单调版本号(2026-09-18):queue_update 事件与 queueManage 全结果携带同一
|
|
21
|
+
* 数轴,前端据此丢弃迟到的旧 get_state 快照(竞态覆盖根修,见 BackendQueueManageResult.rev)。
|
|
22
|
+
*/
|
|
23
|
+
|
|
24
|
+
import { mkdirSync, readFileSync, readdirSync, renameSync, rmSync, statSync, writeFileSync, existsSync } from "node:fs";
|
|
25
|
+
import { dirname, join } from "node:path";
|
|
26
|
+
|
|
27
|
+
/** 最小图片结构(plan G5:共享层只定义最小形状,handle 侧适配自有 TurnImage)。 */
|
|
28
|
+
export interface QueueTurnImageLike {
|
|
29
|
+
data: string;
|
|
30
|
+
mimeType: string;
|
|
31
|
+
filename?: string;
|
|
32
|
+
}
|
|
33
|
+
|
|
34
|
+
/** 本地 followUp 队列条目(R4 闭环:带图片)。 */
|
|
35
|
+
export interface BackendQueueEntry {
|
|
36
|
+
text: string;
|
|
37
|
+
images?: QueueTurnImageLike[];
|
|
38
|
+
queuedAt: number;
|
|
39
|
+
}
|
|
40
|
+
|
|
41
|
+
export interface BackendQueueOpts {
|
|
42
|
+
/** 运行中判定(handle 的 running + alive 组合;drain 幂等与分流都依赖它)。 */
|
|
43
|
+
isRunning(): boolean;
|
|
44
|
+
/** 存活判定(可选,缺省恒 true):dispose 后 drain/dispatch 不再启动。 */
|
|
45
|
+
alive?(): boolean;
|
|
46
|
+
/** 真正的发送(handle.runTurn / prompt 全簿记)——空闲分流与续轮都走这里。 */
|
|
47
|
+
dispatch(text: string, images?: QueueTurnImageLike[]): Promise<void> | void;
|
|
48
|
+
/** wire 事件出口(queue_update 广播 / user 气泡 message_end)。 */
|
|
49
|
+
onEvent(ev: Record<string, unknown>): void;
|
|
50
|
+
/**
|
|
51
|
+
* 运行中注入(协议相关,可选)。缺省 = 不支持 steer:运行中发送一律本地排队
|
|
52
|
+
* (降级语义收敛到面板,而不是静默丢消息——plan §1.3)。
|
|
53
|
+
* 服务端 steer 镜像由 handle 在协议事件回调里调 registerSteer/drainSteer 喂入。
|
|
54
|
+
*/
|
|
55
|
+
steer?(text: string, images?: QueueTurnImageLike[]): Promise<void> | void;
|
|
56
|
+
/** 降级/异常提示(可缺省)。 */
|
|
57
|
+
log?(msg: string): void;
|
|
58
|
+
/**
|
|
59
|
+
* 崩溃恢复 sidecar(可选,docs/aiti-remote-queue-and-sidecar-plan.md §3):挂上后
|
|
60
|
+
* pending 队列跨进程重启可恢复(恢复项 settle 后照常自动续轮发出——排队=要发的意图);
|
|
61
|
+
* dispose = 会话正常关闭 → remove() 丢弃。用 createQueueFilePersistence() 构建文件实现。
|
|
62
|
+
*/
|
|
63
|
+
persistence?: BackendQueuePersistence;
|
|
64
|
+
}
|
|
65
|
+
|
|
66
|
+
/** 队列持久化口(save/load/remove 全同步小文件写;实现须原子写——tmp+rename,Windows 兼容 §0)。 */
|
|
67
|
+
export interface BackendQueuePersistence {
|
|
68
|
+
save(entries: BackendQueueEntry[]): void;
|
|
69
|
+
load(): BackendQueueEntry[];
|
|
70
|
+
remove(): void;
|
|
71
|
+
}
|
|
72
|
+
|
|
73
|
+
const QUEUE_SIDECAR_VERSION = 1;
|
|
74
|
+
/** sidecar 残留清理阈值:崩溃恢复窗口 7 天(同 pi-web agent sessions 清理 TTL)。 */
|
|
75
|
+
const QUEUE_SIDECAR_TTL_MS = 7 * 24 * 60 * 60 * 1000;
|
|
76
|
+
|
|
77
|
+
/**
|
|
78
|
+
* sidecar 文件名:Windows 上冒号是 NTFS ADS 流分隔符——`claude:new-1.json` 会写成
|
|
79
|
+
* 基名 `claude` + 匿名流(rename/existsSync 语义全乱,教训见 backend-queue.test)。
|
|
80
|
+
* win32 把 id 中的冒号替换为 `_`;调用方(createQueueFilePersistence 的 getFile)
|
|
81
|
+
* 必须用同一函数,否则迁移/恢复互不认识。
|
|
82
|
+
*/
|
|
83
|
+
export function sidecarFileName(id: string): string {
|
|
84
|
+
const safe = process.platform === "win32" ? id.replace(/:/g, "_") : id;
|
|
85
|
+
return `${safe}.json`;
|
|
86
|
+
}
|
|
87
|
+
|
|
88
|
+
/**
|
|
89
|
+
* 文件版队列持久化(<stateDir>/queues/<sessionId>.json)。getFile 惰性求值——
|
|
90
|
+
* 扩展 handle 以 field 初始化器构建 support、文件路径在 ctor body 才能确定,
|
|
91
|
+
* 惰性闭包同时规避 init 顺序问题与「未传路径 = 不持久化」的缺省语义。
|
|
92
|
+
*/
|
|
93
|
+
export function createQueueFilePersistence(
|
|
94
|
+
getFile: () => string | undefined,
|
|
95
|
+
log?: (msg: string) => void,
|
|
96
|
+
): BackendQueuePersistence {
|
|
97
|
+
const read = (): BackendQueueEntry[] => {
|
|
98
|
+
const file = getFile();
|
|
99
|
+
if (!file || !existsSync(file)) return [];
|
|
100
|
+
try {
|
|
101
|
+
const raw = JSON.parse(readFileSync(file, "utf8")) as { version?: number; entries?: BackendQueueEntry[] };
|
|
102
|
+
if (raw.version !== QUEUE_SIDECAR_VERSION || !Array.isArray(raw.entries)) return [];
|
|
103
|
+
return raw.entries.filter((e) => e && typeof e.text === "string" && typeof e.queuedAt === "number");
|
|
104
|
+
} catch (e) {
|
|
105
|
+
log?.(`[backend-queue] sidecar 读取失败(忽略恢复): ${e instanceof Error ? e.message : String(e)}`);
|
|
106
|
+
return [];
|
|
107
|
+
}
|
|
108
|
+
};
|
|
109
|
+
/** 事件驱动的残留清理(非轮询):只在 save 时顺手扫一次同目录,删 >7 天的旧 sidecar。 */
|
|
110
|
+
const prune = (dir: string): void => {
|
|
111
|
+
try {
|
|
112
|
+
for (const name of readdirSync(dir)) {
|
|
113
|
+
if (!name.endsWith(".json")) continue;
|
|
114
|
+
const p = join(dir, name);
|
|
115
|
+
try {
|
|
116
|
+
if (Date.now() - statSync(p).mtimeMs > QUEUE_SIDECAR_TTL_MS) rmSync(p, { force: true });
|
|
117
|
+
} catch { /* 单文件失败不影响其余 */ }
|
|
118
|
+
}
|
|
119
|
+
} catch { /* 目录不存在等 */ }
|
|
120
|
+
};
|
|
121
|
+
return {
|
|
122
|
+
save(entries) {
|
|
123
|
+
const file = getFile();
|
|
124
|
+
if (!file) return;
|
|
125
|
+
try {
|
|
126
|
+
mkdirSync(dirname(file), { recursive: true });
|
|
127
|
+
const tmp = `${file}.tmp`;
|
|
128
|
+
writeFileSync(tmp, JSON.stringify({ version: QUEUE_SIDECAR_VERSION, entries }) + "\n");
|
|
129
|
+
renameSync(tmp, file);
|
|
130
|
+
prune(dirname(file));
|
|
131
|
+
} catch (e) {
|
|
132
|
+
log?.(`[backend-queue] sidecar 写入失败(队列照常,仅崩溃恢复受损): ${e instanceof Error ? e.message : String(e)}`);
|
|
133
|
+
}
|
|
134
|
+
},
|
|
135
|
+
load: read,
|
|
136
|
+
remove() {
|
|
137
|
+
const file = getFile();
|
|
138
|
+
if (!file) return;
|
|
139
|
+
try { rmSync(file, { force: true }); } catch { /* best effort */ }
|
|
140
|
+
},
|
|
141
|
+
};
|
|
142
|
+
}
|
|
143
|
+
|
|
144
|
+
/**
|
|
145
|
+
* id 换绑时迁移队列 sidecar(占位 id → 真实 id):各 handle 走「懒持久化」模式——真实
|
|
146
|
+
* 会话 id 在首个后端帧才出现(claude system/init、zcode/codebuddy rebindSessionId、
|
|
147
|
+
* codex thread.started、cursor extractChatId),此前排队的条目落在随机占位 id 文件里,
|
|
148
|
+
* 不迁移则崩溃恢复永远找不到(只能等 7 天 prune)。与 renameExtModelState 状态文件
|
|
149
|
+
* 换绑同构,在各 handle 真实 id 捕获点调用。acp 无此窗口(id 在宿主拿到 handle 前
|
|
150
|
+
* 同步赋真实值)。
|
|
151
|
+
*/
|
|
152
|
+
export function migrateQueueSidecar(
|
|
153
|
+
dir: string | undefined,
|
|
154
|
+
fromId: string,
|
|
155
|
+
toId: string,
|
|
156
|
+
log?: (msg: string) => void,
|
|
157
|
+
): void {
|
|
158
|
+
if (!dir || !fromId || !toId || fromId === toId) return;
|
|
159
|
+
try {
|
|
160
|
+
const from = join(dir, "queues", sidecarFileName(fromId));
|
|
161
|
+
if (!existsSync(from)) return;
|
|
162
|
+
const to = join(dir, "queues", sidecarFileName(toId));
|
|
163
|
+
// Windows renameSync 不覆盖已有目标:先删(迁移内容 ⊆ 内存 pending,最终以内存 save 为准)
|
|
164
|
+
if (existsSync(to)) rmSync(to, { force: true });
|
|
165
|
+
renameSync(from, to);
|
|
166
|
+
log?.(`[backend-queue] sidecar 随 id 换绑迁移: ${fromId} → ${toId}`);
|
|
167
|
+
} catch (e) {
|
|
168
|
+
log?.(`[backend-queue] sidecar 迁移失败(忽略,崩溃恢复降级): ${e instanceof Error ? e.message : String(e)}`);
|
|
169
|
+
}
|
|
170
|
+
}
|
|
171
|
+
|
|
172
|
+
export interface BackendQueueRouteOpts {
|
|
173
|
+
images?: QueueTurnImageLike[];
|
|
174
|
+
streamingBehavior?: "steer" | "followUp";
|
|
175
|
+
}
|
|
176
|
+
|
|
177
|
+
export interface BackendQueueManageReq {
|
|
178
|
+
action: "list" | "clear" | "move" | "convert" | "remove" | "recall" | "requeue";
|
|
179
|
+
kind?: "steer" | "followUp";
|
|
180
|
+
from?: number;
|
|
181
|
+
to?: number;
|
|
182
|
+
index?: number;
|
|
183
|
+
targetKind?: "steer" | "followUp";
|
|
184
|
+
text?: string;
|
|
185
|
+
}
|
|
186
|
+
|
|
187
|
+
export interface BackendQueueManageResult {
|
|
188
|
+
steering: string[];
|
|
189
|
+
followUp: string[];
|
|
190
|
+
/**
|
|
191
|
+
* 队列内容单调版本号(跨仓契约,pi-web useAgentSession 消费):任意一次内容变化后
|
|
192
|
+
* 递增,queue_update 事件与 queueManage/get_state 快照同源携带同一数轴。前端据此
|
|
193
|
+
* 丢弃乱序/迟到的旧快照(异步 get_state 响应与实时 queue_update 竞态覆盖——
|
|
194
|
+
* 2026-09-18 「队列条目不显示直到手动刷新」根因修复)。
|
|
195
|
+
*/
|
|
196
|
+
rev: number;
|
|
197
|
+
entry?: { text: string; images?: QueueTurnImageLike[] };
|
|
198
|
+
/** remove 的 QueueTrashItem 形状(pi-web core SessionHandle.queueManage 契约)。 */
|
|
199
|
+
removed?: { id: string; kind: string; text: string; hasImages: boolean; queuedAt: number };
|
|
200
|
+
}
|
|
201
|
+
|
|
202
|
+
export interface BackendQueue {
|
|
203
|
+
/** prompt 入口分流(handle 仅在 running 时调用;空闲分支供 steer/followUp 能力方法直达 dispatch)。 */
|
|
204
|
+
routePrompt(text: string, opts?: BackendQueueRouteOpts): Promise<"dispatched" | "queued" | "steered">;
|
|
205
|
+
/** 运行中入本地队列(settle 后自动续轮,可撤回);空闲等同 dispatch。 */
|
|
206
|
+
enqueueFollowUp(text: string, images?: QueueTurnImageLike[]): void;
|
|
207
|
+
/** @capability queueManage(SessionHandle.queueManage 直接转发至此)。 */
|
|
208
|
+
queueManage(req: BackendQueueManageReq): Promise<BackendQueueManageResult>;
|
|
209
|
+
/** 服务端 steer 镜像喂入(zcode:steerQueued/steerDrained/steerDiscarded 事件;其他后端可缺省不喂)。 */
|
|
210
|
+
registerSteer(pendingInputId: string, input: string): void;
|
|
211
|
+
drainSteer(pendingInputIds: string[]): void;
|
|
212
|
+
clearSteerMirror(): void;
|
|
213
|
+
/** settle 后由 handle 调(finally / agent_settled)——幂等,running 中 no-op。 */
|
|
214
|
+
scheduleDrain(): void;
|
|
215
|
+
/** 向前端同步排队区(queue_update 契约:steering/followUp 两组文本)。 */
|
|
216
|
+
emitUpdate(): void;
|
|
217
|
+
/** user 气泡(message_end role=user,blocks content——adapter string 防御已兼容)。 */
|
|
218
|
+
userBubble(text: string): void;
|
|
219
|
+
snapshot(): { steering: string[]; followUp: string[] };
|
|
220
|
+
/** 清 pending + 镜像 + 停止未决续轮。 */
|
|
221
|
+
dispose(): void;
|
|
222
|
+
}
|
|
223
|
+
|
|
224
|
+
export function createBackendQueueSupport(opts: BackendQueueOpts): BackendQueue {
|
|
225
|
+
const alive = () => (opts.alive ? opts.alive() : true);
|
|
226
|
+
/** 本地 followUp 队列(带图片,R4 闭环)。 */
|
|
227
|
+
let pending: BackendQueueEntry[] = [];
|
|
228
|
+
/** 服务端 steer 队列镜像(已交给后端、尚未 drain 的输入;全量快照,只读展示)。 */
|
|
229
|
+
let steerMirror: Array<{ pendingInputId: string; input: string }> = [];
|
|
230
|
+
/** 队列内容版本号(emitUpdate 即变化出口,每次递增;快照读取不递增)。 */
|
|
231
|
+
let rev = 0;
|
|
232
|
+
let disposed = false;
|
|
233
|
+
/** sidecar 恢复懒加载标记(ensureRestored 幂等;规避 field 初始化早于 ctor 的顺序问题)。 */
|
|
234
|
+
let restored = false;
|
|
235
|
+
const persist = (): void => { try { opts.persistence?.save(pending); } catch { /* 持久化不阻塞队列 */ } };
|
|
236
|
+
/** 恢复:崩溃前排队的条目回到队首(当前进程内尚未入队任何条目,实际即整队还原)。 */
|
|
237
|
+
const ensureRestored = (): void => {
|
|
238
|
+
if (restored || disposed) return;
|
|
239
|
+
restored = true;
|
|
240
|
+
try {
|
|
241
|
+
const saved = opts.persistence?.load() ?? [];
|
|
242
|
+
if (saved.length > 0) {
|
|
243
|
+
pending = [...saved.filter((e) => !pending.some((p) => p.queuedAt === e.queuedAt && p.text === e.text)), ...pending];
|
|
244
|
+
opts.log?.(`[backend-queue] sidecar 恢复 ${saved.length} 条排队消息`);
|
|
245
|
+
emitUpdate();
|
|
246
|
+
}
|
|
247
|
+
} catch { /* 恢复失败不阻塞队列 */ }
|
|
248
|
+
};
|
|
249
|
+
|
|
250
|
+
const snapshot = () => ({
|
|
251
|
+
steering: steerMirror.map((s) => s.input),
|
|
252
|
+
followUp: pending.map((e) => e.text),
|
|
253
|
+
});
|
|
254
|
+
|
|
255
|
+
const emitUpdate = (): void => {
|
|
256
|
+
rev += 1;
|
|
257
|
+
opts.onEvent({ type: "queue_update", rev, ...snapshot() });
|
|
258
|
+
};
|
|
259
|
+
|
|
260
|
+
const enqueueFollowUp = (text: string, images?: QueueTurnImageLike[]): void => {
|
|
261
|
+
ensureRestored();
|
|
262
|
+
pending.push({ text, ...(images && images.length ? { images } : {}), queuedAt: Date.now() });
|
|
263
|
+
persist();
|
|
264
|
+
emitUpdate();
|
|
265
|
+
};
|
|
266
|
+
|
|
267
|
+
/** steer 失败降级(R9 泛化):转回本地 followUp 队列——消息不丢、不打断原轮。 */
|
|
268
|
+
const degradeToQueue = (text: string, images?: QueueTurnImageLike[], reason?: unknown): void => {
|
|
269
|
+
opts.log?.(`[backend-queue] steer 发送失败,转本地队列待续轮: ${reason instanceof Error ? reason.message : String(reason ?? "")}`);
|
|
270
|
+
enqueueFollowUp(text, images);
|
|
271
|
+
};
|
|
272
|
+
|
|
273
|
+
const routePrompt = async (
|
|
274
|
+
text: string,
|
|
275
|
+
routeOpts?: BackendQueueRouteOpts,
|
|
276
|
+
): Promise<"dispatched" | "queued" | "steered"> => {
|
|
277
|
+
if (opts.isRunning()) {
|
|
278
|
+
// followUp:本地持有(queue keeper 可撤回/排序),settle 后自动续轮
|
|
279
|
+
if (routeOpts?.streamingBehavior === "followUp") {
|
|
280
|
+
enqueueFollowUp(text, routeOpts?.images);
|
|
281
|
+
return "queued";
|
|
282
|
+
}
|
|
283
|
+
// steer / 缺省:运行中注入可用则注入(镜像由 handle 经协议事件喂入);失败降级本地队列
|
|
284
|
+
if (opts.steer) {
|
|
285
|
+
try {
|
|
286
|
+
await opts.steer(text, routeOpts?.images);
|
|
287
|
+
return "steered";
|
|
288
|
+
} catch (e) {
|
|
289
|
+
degradeToQueue(text, routeOpts?.images, e);
|
|
290
|
+
return "queued";
|
|
291
|
+
}
|
|
292
|
+
}
|
|
293
|
+
enqueueFollowUp(text, routeOpts?.images);
|
|
294
|
+
return "queued";
|
|
295
|
+
}
|
|
296
|
+
// 空闲:直接开新轮(dispatch 闭包 = handle 的完整簿记入口,如 prompt())
|
|
297
|
+
await opts.dispatch(text, routeOpts?.images);
|
|
298
|
+
return "dispatched";
|
|
299
|
+
};
|
|
300
|
+
|
|
301
|
+
const at = (i: number | undefined): number => {
|
|
302
|
+
const n = Number(i);
|
|
303
|
+
if (!Number.isInteger(n) || n < 0 || n >= pending.length) throw new Error("队列索引越界");
|
|
304
|
+
return n;
|
|
305
|
+
};
|
|
306
|
+
|
|
307
|
+
const queueManage = async (req: BackendQueueManageReq): Promise<BackendQueueManageResult> => {
|
|
308
|
+
ensureRestored();
|
|
309
|
+
if (req.action === "list") return { ...snapshot(), rev };
|
|
310
|
+
const kind = req.kind ?? "followUp";
|
|
311
|
+
if (kind === "steer") {
|
|
312
|
+
throw new Error("该条目已注入后端服务端 steer 队列(当前轮工具间隙自动消费),协议不支持撤回/移动;如需取消请停止本轮(stop)");
|
|
313
|
+
}
|
|
314
|
+
let entry: BackendQueueEntry | undefined;
|
|
315
|
+
/** clear 前暂存被清空的 followUp 文本——pi clearQueue() 契约返回「被清掉的内容」,
|
|
316
|
+
* 前端「全部编辑」(recallAll)靠它回填输入框;漏存会静默丢消息(2026-09-16 实测)。 */
|
|
317
|
+
let clearedFollowUp: string[] | undefined;
|
|
318
|
+
switch (req.action) {
|
|
319
|
+
case "clear": {
|
|
320
|
+
clearedFollowUp = pending.map((e) => e.text);
|
|
321
|
+
pending = [];
|
|
322
|
+
break;
|
|
323
|
+
}
|
|
324
|
+
case "move": {
|
|
325
|
+
const from = at(req.from);
|
|
326
|
+
const to = at(req.to);
|
|
327
|
+
const [moved] = pending.splice(from, 1);
|
|
328
|
+
pending.splice(to, 0, moved);
|
|
329
|
+
break;
|
|
330
|
+
}
|
|
331
|
+
case "remove":
|
|
332
|
+
case "recall": {
|
|
333
|
+
const i = at(req.index);
|
|
334
|
+
entry = pending.splice(i, 1)[0];
|
|
335
|
+
break;
|
|
336
|
+
}
|
|
337
|
+
case "requeue": {
|
|
338
|
+
const i = Number(req.index);
|
|
339
|
+
const text = String(req.text ?? "");
|
|
340
|
+
if (!Number.isInteger(i) || i < 0 || i > pending.length) throw new Error("队列索引越界");
|
|
341
|
+
if (!text.trim()) throw new Error("requeue 需要非空文本");
|
|
342
|
+
pending.splice(i, 0, { text, queuedAt: Date.now() });
|
|
343
|
+
break;
|
|
344
|
+
}
|
|
345
|
+
case "convert": {
|
|
346
|
+
const i = at(req.index);
|
|
347
|
+
const target = req.targetKind ?? "steer";
|
|
348
|
+
if (target === "followUp") break; // 已在 followUp 组,no-op
|
|
349
|
+
if (opts.isRunning() && opts.steer) {
|
|
350
|
+
// 原生 steer 可用:取出并立即注入
|
|
351
|
+
const picked = pending.splice(i, 1)[0];
|
|
352
|
+
try {
|
|
353
|
+
await opts.steer(picked.text, picked.images);
|
|
354
|
+
} catch (e) {
|
|
355
|
+
degradeToQueue(picked.text, picked.images, e);
|
|
356
|
+
}
|
|
357
|
+
} else if (opts.isRunning()) {
|
|
358
|
+
// 无原生 steer:插队 = 移到队首(settle 后 scheduleDrain 优先续轮发出)。
|
|
359
|
+
// zcode 3.11.2 协议 steer 实测不投递(2026-09-10 探针,见 handle steer:false 注释),
|
|
360
|
+
// 本地队首是协议下唯一能兑现的插队语义。
|
|
361
|
+
const [picked] = pending.splice(i, 1);
|
|
362
|
+
pending.unshift(picked);
|
|
363
|
+
} else {
|
|
364
|
+
// 空闲:开新轮
|
|
365
|
+
const picked = pending.splice(i, 1)[0];
|
|
366
|
+
await opts.dispatch(picked.text, picked.images);
|
|
367
|
+
}
|
|
368
|
+
break;
|
|
369
|
+
}
|
|
370
|
+
default:
|
|
371
|
+
throw new Error(`queueManage: 未知 action "${req.action}"`);
|
|
372
|
+
}
|
|
373
|
+
persist();
|
|
374
|
+
emitUpdate();
|
|
375
|
+
// 空闲且有排队的边角(convert/clear 后 settle 已过):不动——空闲入队由调用方的 scheduleDrain 负责
|
|
376
|
+
return {
|
|
377
|
+
...snapshot(),
|
|
378
|
+
// 变更类 action 的 rev 在 emitUpdate 里已递增——此处读取即变更后版本,与刚发的
|
|
379
|
+
// queue_update 同值;前端据此判定 RPC 结果与事件流的先后。
|
|
380
|
+
rev,
|
|
381
|
+
// clear:followUp 报「清空前」的内容(snapshot 已空)——对齐 pi clearQueue 返回约定
|
|
382
|
+
...(clearedFollowUp ? { followUp: clearedFollowUp } : {}),
|
|
383
|
+
...(entry
|
|
384
|
+
? {
|
|
385
|
+
entry: { text: entry.text, ...(entry.images ? { images: entry.images } : {}) },
|
|
386
|
+
// remove → QueueTrashItem(pi-web core 契约;recall 只有 entry)
|
|
387
|
+
...(req.action === "remove"
|
|
388
|
+
? {
|
|
389
|
+
removed: {
|
|
390
|
+
id: `fu-${entry.queuedAt}`,
|
|
391
|
+
kind: "followUp",
|
|
392
|
+
text: entry.text,
|
|
393
|
+
hasImages: !!(entry.images && entry.images.length),
|
|
394
|
+
queuedAt: entry.queuedAt,
|
|
395
|
+
},
|
|
396
|
+
}
|
|
397
|
+
: {}),
|
|
398
|
+
}
|
|
399
|
+
: {}),
|
|
400
|
+
};
|
|
401
|
+
};
|
|
402
|
+
|
|
403
|
+
const registerSteer = (pendingInputId: string, input: string): void => {
|
|
404
|
+
if (pendingInputId && input && !steerMirror.some((s) => s.pendingInputId === pendingInputId)) {
|
|
405
|
+
steerMirror.push({ pendingInputId, input });
|
|
406
|
+
emitUpdate();
|
|
407
|
+
}
|
|
408
|
+
};
|
|
409
|
+
|
|
410
|
+
const drainSteer = (pendingInputIds: string[]): void => {
|
|
411
|
+
const before = steerMirror.length;
|
|
412
|
+
steerMirror = steerMirror.filter((s) => !pendingInputIds.includes(s.pendingInputId));
|
|
413
|
+
if (steerMirror.length !== before) emitUpdate();
|
|
414
|
+
};
|
|
415
|
+
|
|
416
|
+
const clearSteerMirror = (): void => {
|
|
417
|
+
if (steerMirror.length) {
|
|
418
|
+
steerMirror = [];
|
|
419
|
+
emitUpdate();
|
|
420
|
+
}
|
|
421
|
+
};
|
|
422
|
+
|
|
423
|
+
/** settle 后自动续轮(followUp 队列排空;幂等——running 中直接返回)。
|
|
424
|
+
* 微任务让 agent_settled 先到达前端(流式状态复位)再开新一轮(zcode 实测模式)。 */
|
|
425
|
+
const scheduleDrain = (): void => {
|
|
426
|
+
if (disposed || !alive() || opts.isRunning()) return;
|
|
427
|
+
ensureRestored();
|
|
428
|
+
const next = pending.shift();
|
|
429
|
+
persist();
|
|
430
|
+
emitUpdate();
|
|
431
|
+
if (next) {
|
|
432
|
+
queueMicrotask(() => {
|
|
433
|
+
if (disposed || !alive()) return;
|
|
434
|
+
void Promise.resolve(opts.dispatch(next.text, next.images)).catch((e) => {
|
|
435
|
+
opts.log?.(`[backend-queue] 续轮 dispatch 失败: ${e instanceof Error ? e.message : String(e)}`);
|
|
436
|
+
});
|
|
437
|
+
});
|
|
438
|
+
}
|
|
439
|
+
};
|
|
440
|
+
|
|
441
|
+
const userBubble = (text: string): void => {
|
|
442
|
+
opts.onEvent({
|
|
443
|
+
type: "message_end",
|
|
444
|
+
message: { role: "user", content: [{ type: "text", text }], timestamp: Date.now() },
|
|
445
|
+
});
|
|
446
|
+
};
|
|
447
|
+
|
|
448
|
+
const dispose = (): void => {
|
|
449
|
+
disposed = true;
|
|
450
|
+
pending = [];
|
|
451
|
+
steerMirror = [];
|
|
452
|
+
// 会话正常关闭:崩溃恢复 sidecar 一并丢弃(崩溃时未走到这里 → sidecar 留待恢复)
|
|
453
|
+
try { opts.persistence?.remove(); } catch { /* best effort */ }
|
|
454
|
+
};
|
|
455
|
+
|
|
456
|
+
return {
|
|
457
|
+
routePrompt,
|
|
458
|
+
enqueueFollowUp,
|
|
459
|
+
queueManage,
|
|
460
|
+
registerSteer,
|
|
461
|
+
drainSteer,
|
|
462
|
+
clearSteerMirror,
|
|
463
|
+
scheduleDrain,
|
|
464
|
+
emitUpdate,
|
|
465
|
+
userBubble,
|
|
466
|
+
snapshot,
|
|
467
|
+
dispose,
|
|
468
|
+
};
|
|
469
|
+
}
|
|
@@ -0,0 +1,128 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* blob-save-route —— 二进制文件保存 route 工厂(共享权威源,部署时拷进扩展目录)。
|
|
3
|
+
*
|
|
4
|
+
* 消费方:aiti-sheet-univer / aiti-word-superdoc 等带 edit 能力的实现扩展
|
|
5
|
+
* (docs/aiti-editor-office-plan.md §2.0 共享层)。
|
|
6
|
+
*
|
|
7
|
+
* 端点语义(POST,body JSON):
|
|
8
|
+
* { filePath: string, dataBase64: string, baseMtimeMs?: number, cwd?: string }
|
|
9
|
+
* → 200 { ok: true, mtimeMs, size }
|
|
10
|
+
* → 400 路径不在白名单 / 扩展名不在白名单 / dataBase64 非法
|
|
11
|
+
* → 409 { ok:false, conflict:true, diskMtimeMs } 磁盘已被外部修改(乐观锁)
|
|
12
|
+
* → 413 超过 maxBytes
|
|
13
|
+
* 写盘原子(tmp + rename),目标目录自动创建(同名文件保存必然已存在,目录防御性兜底)。
|
|
14
|
+
*/
|
|
15
|
+
import { createHash } from "node:crypto";
|
|
16
|
+
import { mkdirSync, renameSync, statSync, writeFileSync } from "node:fs";
|
|
17
|
+
import { homedir } from "node:os";
|
|
18
|
+
import { dirname, isAbsolute, join, normalize, sep } from "node:path";
|
|
19
|
+
|
|
20
|
+
/** ~ 展开(浏览器无 homedir;对齐 core /api/files filePathFromSegments) */
|
|
21
|
+
function expandTildePath(p: string): string {
|
|
22
|
+
const home = homedir();
|
|
23
|
+
if (p === "~") return home;
|
|
24
|
+
if (p.startsWith("~/") || p.startsWith("~\\")) return join(home, p.slice(2));
|
|
25
|
+
return p;
|
|
26
|
+
}
|
|
27
|
+
|
|
28
|
+
/** 保存白名单(对标 aiti-editor M1 宽松版:workspace + 用户根) */
|
|
29
|
+
export function resolveAllowedWriteRoot(filePath: string, cwd?: string): string | null {
|
|
30
|
+
if (!filePath) return null;
|
|
31
|
+
const expanded = expandTildePath(filePath);
|
|
32
|
+
if (!isAbsolute(expanded)) return null;
|
|
33
|
+
const home = homedir();
|
|
34
|
+
const roots: string[] = [];
|
|
35
|
+
if (cwd && isAbsolute(cwd)) roots.push(normalize(cwd));
|
|
36
|
+
roots.push(join(home, "workspace"));
|
|
37
|
+
roots.push(home);
|
|
38
|
+
const fp = normalize(expanded);
|
|
39
|
+
return roots.some((r) => fp === r || fp.startsWith(r + sep)) ? fp : null;
|
|
40
|
+
}
|
|
41
|
+
|
|
42
|
+
export interface BlobSaveRouteOptions {
|
|
43
|
+
/** 扩展 id(tmp 文件命名/日志前缀) */
|
|
44
|
+
extId: string;
|
|
45
|
+
/** 允许保存的扩展名白名单(小写含点,如 [".xlsx", ".xlsm"]) */
|
|
46
|
+
allowedExts: string[];
|
|
47
|
+
/** 单文件字节上限(默认 30MB,方案 §2.1 maxBytes feature 档) */
|
|
48
|
+
maxBytes?: number;
|
|
49
|
+
}
|
|
50
|
+
|
|
51
|
+
export interface BlobSaveBody {
|
|
52
|
+
filePath?: unknown;
|
|
53
|
+
dataBase64?: unknown;
|
|
54
|
+
baseMtimeMs?: unknown;
|
|
55
|
+
cwd?: unknown;
|
|
56
|
+
}
|
|
57
|
+
|
|
58
|
+
/**
|
|
59
|
+
* 生成 route handler:`if (p[p.length-1] === "save-blob") return await handle(req);`
|
|
60
|
+
*/
|
|
61
|
+
export function createBlobSaveRoute(opts: BlobSaveRouteOptions) {
|
|
62
|
+
const maxBytes = opts.maxBytes ?? 30 * 1024 * 1024;
|
|
63
|
+
const allowed = new Set(opts.allowedExts.map((e) => e.toLowerCase()));
|
|
64
|
+
const log = (m: string) => console.log("[" + opts.extId + "][save-blob] " + m);
|
|
65
|
+
|
|
66
|
+
return async function handleSaveBlob(req: Request): Promise<Response> {
|
|
67
|
+
const json = (body: unknown, status = 200) => new Response(JSON.stringify(body), {
|
|
68
|
+
status,
|
|
69
|
+
headers: { "content-type": "application/json", "cache-control": "no-store" },
|
|
70
|
+
});
|
|
71
|
+
let body: BlobSaveBody;
|
|
72
|
+
try {
|
|
73
|
+
body = await req.json();
|
|
74
|
+
} catch {
|
|
75
|
+
return json({ ok: false, error: "body 需为 JSON" }, 400);
|
|
76
|
+
}
|
|
77
|
+
const filePath = typeof body.filePath === "string" ? body.filePath : "";
|
|
78
|
+
const dataBase64 = typeof body.dataBase64 === "string" ? body.dataBase64 : "";
|
|
79
|
+
const cwd = typeof body.cwd === "string" ? body.cwd : undefined;
|
|
80
|
+
if (!filePath || !dataBase64) return json({ ok: false, error: "需要 filePath 与 dataBase64" }, 400);
|
|
81
|
+
|
|
82
|
+
const lower = filePath.toLowerCase();
|
|
83
|
+
if (![...allowed].some((ext) => lower.endsWith(ext))) {
|
|
84
|
+
return json({ ok: false, error: "扩展名不在白名单内(" + [...allowed].join(" ") + ")" }, 400);
|
|
85
|
+
}
|
|
86
|
+
const target = resolveAllowedWriteRoot(filePath, cwd);
|
|
87
|
+
if (!target) return json({ ok: false, error: "路径不在可写白名单内" }, 400);
|
|
88
|
+
|
|
89
|
+
let buf: Buffer;
|
|
90
|
+
try {
|
|
91
|
+
buf = Buffer.from(dataBase64, "base64");
|
|
92
|
+
} catch {
|
|
93
|
+
return json({ ok: false, error: "dataBase64 非法" }, 400);
|
|
94
|
+
}
|
|
95
|
+
if (buf.length === 0) return json({ ok: false, error: "空内容拒绝保存" }, 400);
|
|
96
|
+
if (buf.length > maxBytes) return json({ ok: false, error: "文件超过 " + Math.round(maxBytes / 1024 / 1024) + "MB 上限" }, 413);
|
|
97
|
+
|
|
98
|
+
// 乐观锁:baseMtimeMs 与磁盘不一致 → 409(沿用 aiti-editor 冲突 UI 范式)
|
|
99
|
+
let st;
|
|
100
|
+
try { st = statSync(target); } catch { /* 新文件(理论上保存目标必已存在;防御) */ }
|
|
101
|
+
if (st) {
|
|
102
|
+
if (!st.isFile()) return json({ ok: false, error: "目标不是文件" }, 400);
|
|
103
|
+
if (typeof body.baseMtimeMs === "number" && Math.abs(st.mtimeMs - (body.baseMtimeMs as number)) > 1) {
|
|
104
|
+
return json({ ok: false, conflict: true, diskMtimeMs: st.mtimeMs }, 409);
|
|
105
|
+
}
|
|
106
|
+
}
|
|
107
|
+
|
|
108
|
+
// 原子写:tmp 必须与目标同目录(同文件系统,rename 才不跨设备 EXDEV)
|
|
109
|
+
const tmp = join(dirname(target), "." + opts.extId + "-save-tmp-" + process.pid + "-" + Date.now());
|
|
110
|
+
try {
|
|
111
|
+
mkdirSync(dirname(target), { recursive: true });
|
|
112
|
+
writeFileSync(tmp, buf);
|
|
113
|
+
renameSync(tmp, target);
|
|
114
|
+
} catch (e) {
|
|
115
|
+
try { require("node:fs").rmSync(tmp, { force: true }); } catch { /* 忽略 */ }
|
|
116
|
+
log("写盘失败: " + String((e as Error).message || e));
|
|
117
|
+
return json({ ok: false, error: "写盘失败: " + String((e as Error).message || e) }, 500);
|
|
118
|
+
}
|
|
119
|
+
const after = statSync(target);
|
|
120
|
+
log("已保存 " + target + " (" + after.size + " bytes)");
|
|
121
|
+
return json({ ok: true, mtimeMs: after.mtimeMs, size: after.size });
|
|
122
|
+
};
|
|
123
|
+
}
|
|
124
|
+
|
|
125
|
+
/** 内容哈希(调试/日志用) */
|
|
126
|
+
export function blobHash(buf: Buffer): string {
|
|
127
|
+
return createHash("md5").update(buf).digest("hex").slice(0, 8);
|
|
128
|
+
}
|
|
@@ -0,0 +1,86 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* cbc-model-catalog — cbc(CodeBuddy Code)`--help` 内置模型目录解析(权威源)。
|
|
3
|
+
*
|
|
4
|
+
* cbc 无免会话 list-models 命令,但 `--help` 的 `--model` 行内嵌当前支持清单:
|
|
5
|
+
* `--model <model> Model for the current session. ... Currently supported: (a, b, c)`
|
|
6
|
+
* 方案:docs/aiti-acp-model-catalog-startup-plan.md §2/§3.1(D13/D15)。
|
|
7
|
+
*
|
|
8
|
+
* 本文件按部署单元复制进 aiti-acp-agent / aiti-codebuddy-agent
|
|
9
|
+
* (cbc-model-catalog.ts),修改后同步副本(与 cursor-cli-store.ts 同一模式)。
|
|
10
|
+
*/
|
|
11
|
+
|
|
12
|
+
import { spawn } from "node:child_process";
|
|
13
|
+
|
|
14
|
+
/** `--model` 行内嵌清单:`Currently supported: (a, b, c)`(cbc 2.150 实测格式)。 */
|
|
15
|
+
const SUPPORTED_RE = /Currently supported:\s*\(([^)]*)\)/;
|
|
16
|
+
|
|
17
|
+
/**
|
|
18
|
+
* `--help` 输出 → 模型 id 列表(纯函数,样本钉死单测)。
|
|
19
|
+
* 解析不到(格式漂移/被截断)返回 [] —— 调用方回落既有静态清单。
|
|
20
|
+
*/
|
|
21
|
+
export function parseCbcHelpModels(helpText: string): Array<{ id: string }> {
|
|
22
|
+
const m = SUPPORTED_RE.exec(helpText);
|
|
23
|
+
if (!m) return [];
|
|
24
|
+
return m[1]
|
|
25
|
+
.split(",")
|
|
26
|
+
.map((s) => s.trim())
|
|
27
|
+
.filter((s) => /^[A-Za-z0-9][A-Za-z0-9._-]*$/.test(s))
|
|
28
|
+
.map((id) => ({ id }));
|
|
29
|
+
}
|
|
30
|
+
|
|
31
|
+
/** 探测结果:CLI 目录(可能为空 = 解析失败/超时)+ 版本(cli 条目失效判据)。 */
|
|
32
|
+
export interface CbcCatalogProbe {
|
|
33
|
+
models: Array<{ id: string }>;
|
|
34
|
+
cliVersion: string | null;
|
|
35
|
+
timedOut: boolean;
|
|
36
|
+
}
|
|
37
|
+
|
|
38
|
+
/** CLI 三元组(与各扩展 resolveCli 同形:direct = bin 直调;npx = node + npx-cli.js …)。 */
|
|
39
|
+
export interface CliCommand {
|
|
40
|
+
cmd: string;
|
|
41
|
+
baseArgs: string[];
|
|
42
|
+
}
|
|
43
|
+
|
|
44
|
+
/** 通用 CLI 采集(stdout 全量 + 超时杀进程;opencode models 等探测复用)。 */
|
|
45
|
+
export function runCliCapture(cmd: string, args: string[], opts: { timeoutMs: number; env?: Record<string, string> }): Promise<{ stdout: string; code: number | null; timedOut: boolean }> {
|
|
46
|
+
return new Promise((resolve) => {
|
|
47
|
+
const child = spawn(cmd, args, { stdio: ["ignore", "pipe", "pipe"], env: opts.env });
|
|
48
|
+
let stdout = "";
|
|
49
|
+
let settled = false;
|
|
50
|
+
const timer = setTimeout(() => {
|
|
51
|
+
if (settled) return;
|
|
52
|
+
settled = true;
|
|
53
|
+
child.kill("SIGKILL");
|
|
54
|
+
resolve({ stdout, code: null, timedOut: true });
|
|
55
|
+
}, opts.timeoutMs);
|
|
56
|
+
child.stdout?.on("data", (c: Buffer | string) => { stdout += typeof c === "string" ? c : c.toString("utf8"); });
|
|
57
|
+
child.once("error", () => {
|
|
58
|
+
if (settled) return;
|
|
59
|
+
settled = true;
|
|
60
|
+
clearTimeout(timer);
|
|
61
|
+
resolve({ stdout, code: null, timedOut: false });
|
|
62
|
+
});
|
|
63
|
+
child.once("exit", (code) => {
|
|
64
|
+
if (settled) return;
|
|
65
|
+
settled = true;
|
|
66
|
+
clearTimeout(timer);
|
|
67
|
+
resolve({ stdout, code, timedOut: false });
|
|
68
|
+
});
|
|
69
|
+
});
|
|
70
|
+
}
|
|
71
|
+
|
|
72
|
+
/**
|
|
73
|
+
* 探测 cbc 目录:`<cli> --help` 解析模型清单 + `<cli> --version` 取版本。
|
|
74
|
+
* 任何失败 fail-soft(models:[]),由调用方决定回落。
|
|
75
|
+
*/
|
|
76
|
+
export async function probeCbcCatalog(cli: CliCommand, opts: { timeoutMs?: number; env?: Record<string, string> } = {}): Promise<CbcCatalogProbe> {
|
|
77
|
+
const timeoutMs = opts.timeoutMs ?? 60_000;
|
|
78
|
+
const help = await runCliCapture(cli.cmd, [...cli.baseArgs, "--help"], { timeoutMs, env: opts.env });
|
|
79
|
+
const models = parseCbcHelpModels(help.stdout);
|
|
80
|
+
let cliVersion: string | null = null;
|
|
81
|
+
if (models.length) {
|
|
82
|
+
const ver = await runCliCapture(cli.cmd, [...cli.baseArgs, "--version"], { timeoutMs: 15_000, env: opts.env });
|
|
83
|
+
cliVersion = ver.stdout.trim().split("\n").pop()?.trim() || null;
|
|
84
|
+
}
|
|
85
|
+
return { models, cliVersion, timedOut: help.timedOut };
|
|
86
|
+
}
|