@aiti-ai/ext-shared 0.0.0-stage → 0.1.8
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/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/README.md +0 -3
|
@@ -0,0 +1,262 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* agent-launch 单测 —— _shared/agent-spawn-env.ts 的 P0 launch 解析层
|
|
3
|
+
* (resolveCliLaunch / parseArgsLines / parseCustomAgents / spawn.command / spawn.argsPrefix)。
|
|
4
|
+
*
|
|
5
|
+
* 覆盖 docs/aiti-custom-agent-plan.md §3.3 合并规则:
|
|
6
|
+
* command 覆盖、argv 拼装、$VAR/${cwd} 展开(未定义=空串+warning)、
|
|
7
|
+
* env 合并优先级(基底 < 自动 bridge < 成员 env)、bridge 四档重写、
|
|
8
|
+
* agents.json 校验(非法跳过/去重/行式 env 兼容)。
|
|
9
|
+
*
|
|
10
|
+
* Run: node --experimental-strip-types --test pi-web-ext/_shared/agent-launch.test.mjs
|
|
11
|
+
*/
|
|
12
|
+
import { test } from "node:test";
|
|
13
|
+
import assert from "node:assert/strict";
|
|
14
|
+
import {
|
|
15
|
+
resolveCliLaunch,
|
|
16
|
+
parseArgsLines,
|
|
17
|
+
parseCustomAgents,
|
|
18
|
+
parseEnvList,
|
|
19
|
+
spawnCommand,
|
|
20
|
+
spawnArgsPrefix,
|
|
21
|
+
spawnCommandFeature,
|
|
22
|
+
spawnArgsPrefixFeature,
|
|
23
|
+
captureSpawnEnvFeatures,
|
|
24
|
+
} from "./agent-spawn-env.ts";
|
|
25
|
+
|
|
26
|
+
const PROC_ENV = { PORT: "3001", PI_WEB_BASE_PATH: "/dev", HOME: "/home/pi", PATH: "/usr/bin" };
|
|
27
|
+
|
|
28
|
+
test("resolveCliLaunch:缺省 command=defaultCommand,args=[...prefix, ...driverArgs]", () => {
|
|
29
|
+
const r = resolveCliLaunch({
|
|
30
|
+
defaultCommand: "claude",
|
|
31
|
+
argsPrefix: ["wrap", "-i"],
|
|
32
|
+
driverArgs: ["-p", "--verbose"],
|
|
33
|
+
processEnv: PROC_ENV,
|
|
34
|
+
});
|
|
35
|
+
assert.equal(r.command, "claude");
|
|
36
|
+
assert.deepEqual(r.args, ["wrap", "-i", "-p", "--verbose"]);
|
|
37
|
+
assert.equal(r.warnings.length, 0);
|
|
38
|
+
});
|
|
39
|
+
|
|
40
|
+
test("resolveCliLaunch:command 覆盖生效(driverArgs 不含原 CLI 名由调用方保证)", () => {
|
|
41
|
+
const r = resolveCliLaunch({
|
|
42
|
+
defaultCommand: "claude",
|
|
43
|
+
command: "docker",
|
|
44
|
+
argsPrefix: ["run", "--rm"],
|
|
45
|
+
driverArgs: ["-p"],
|
|
46
|
+
processEnv: PROC_ENV,
|
|
47
|
+
});
|
|
48
|
+
assert.equal(r.command, "docker");
|
|
49
|
+
assert.deepEqual(r.args, ["run", "--rm", "-p"]);
|
|
50
|
+
assert.equal(r.warnings.length, 0);
|
|
51
|
+
});
|
|
52
|
+
|
|
53
|
+
test("resolveCliLaunch:generic 路径自动注入 AITI_BRIDGE_URL(本机实例推导)", () => {
|
|
54
|
+
const r = resolveCliLaunch({ defaultCommand: "job", processEnv: PROC_ENV });
|
|
55
|
+
assert.equal(r.env.AITI_BRIDGE_URL, "http://127.0.0.1:3001/dev/api/extensions/aiti-devtools");
|
|
56
|
+
});
|
|
57
|
+
|
|
58
|
+
test("resolveCliLaunch:显式 env 已带 AITI_BRIDGE_URL 则保持(不重复注入)", () => {
|
|
59
|
+
const r = resolveCliLaunch({
|
|
60
|
+
defaultCommand: "claude",
|
|
61
|
+
env: { AITI_BRIDGE_URL: "http://10.0.0.9:1/x", ONLY_THIS: "1" },
|
|
62
|
+
processEnv: PROC_ENV,
|
|
63
|
+
});
|
|
64
|
+
assert.equal(r.env.AITI_BRIDGE_URL, "http://10.0.0.9:1/x");
|
|
65
|
+
assert.equal(r.env.ONLY_THIS, "1");
|
|
66
|
+
assert.equal(r.env.PORT, undefined, "显式 env 是基底,不混入 processEnv");
|
|
67
|
+
});
|
|
68
|
+
|
|
69
|
+
test("resolveCliLaunch:$VAR / ${cwd} 展开(argsPrefix + memberEnv;工作 env 优先)", () => {
|
|
70
|
+
const r = resolveCliLaunch({
|
|
71
|
+
defaultCommand: "docker",
|
|
72
|
+
argsPrefix: ["-v", "${cwd}:${cwd}", "-w", "${cwd}", "-e", "K=$PORT"],
|
|
73
|
+
memberEnv: { WORK: "${cwd}/x", FROM_ENV: "$HOME/y" },
|
|
74
|
+
processEnv: PROC_ENV,
|
|
75
|
+
cwd: "/tmp/proj",
|
|
76
|
+
});
|
|
77
|
+
assert.deepEqual(r.args, ["-v", "/tmp/proj:/tmp/proj", "-w", "/tmp/proj", "-e", "K=3001"]);
|
|
78
|
+
assert.equal(r.env.WORK, "/tmp/proj/x");
|
|
79
|
+
assert.equal(r.env.FROM_ENV, "/home/pi/y");
|
|
80
|
+
assert.equal(r.warnings.length, 0);
|
|
81
|
+
});
|
|
82
|
+
|
|
83
|
+
test("resolveCliLaunch:成员 env 覆盖基底 env(最高优先)", () => {
|
|
84
|
+
const r = resolveCliLaunch({
|
|
85
|
+
defaultCommand: "x",
|
|
86
|
+
env: { A: "base", B: "base" },
|
|
87
|
+
memberEnv: { A: "member", REF: "$B/2" },
|
|
88
|
+
processEnv: PROC_ENV,
|
|
89
|
+
});
|
|
90
|
+
assert.equal(r.env.A, "member");
|
|
91
|
+
assert.equal(r.env.B, "base");
|
|
92
|
+
assert.equal(r.env.REF, "base/2", "成员 env 引用先取工作 env 当前值");
|
|
93
|
+
});
|
|
94
|
+
|
|
95
|
+
test("resolveCliLaunch:未定义引用 → 空串 + warning(argsPrefix 与 memberEnv 各记一条)", () => {
|
|
96
|
+
const r = resolveCliLaunch({
|
|
97
|
+
defaultCommand: "x",
|
|
98
|
+
argsPrefix: ["$NOPE_1"],
|
|
99
|
+
memberEnv: { E: "$NOPE_2" },
|
|
100
|
+
processEnv: PROC_ENV,
|
|
101
|
+
});
|
|
102
|
+
assert.equal(r.args[0], "");
|
|
103
|
+
assert.equal(r.env.E, "");
|
|
104
|
+
assert.equal(r.warnings.length, 2);
|
|
105
|
+
assert.ok(r.warnings.some((w) => w.includes("$NOPE_1")));
|
|
106
|
+
assert.ok(r.warnings.some((w) => w.includes("$NOPE_2")));
|
|
107
|
+
});
|
|
108
|
+
|
|
109
|
+
test("resolveCliLaunch:bridge=host.docker.internal 替换主机保留端口路径", () => {
|
|
110
|
+
const r = resolveCliLaunch({
|
|
111
|
+
defaultCommand: "claude",
|
|
112
|
+
env: { AITI_BRIDGE_URL: "http://127.0.0.1:3001/dev/api/extensions/aiti-devtools" },
|
|
113
|
+
bridge: "host.docker.internal",
|
|
114
|
+
processEnv: PROC_ENV,
|
|
115
|
+
});
|
|
116
|
+
assert.equal(r.env.AITI_BRIDGE_URL, "http://host.docker.internal:3001/dev/api/extensions/aiti-devtools");
|
|
117
|
+
});
|
|
118
|
+
|
|
119
|
+
test("resolveCliLaunch:bridge=off 移除;显式 URL 直接采用(支持 ${cwd})", () => {
|
|
120
|
+
const off = resolveCliLaunch({ defaultCommand: "x", bridge: "off", processEnv: PROC_ENV });
|
|
121
|
+
assert.equal("AITI_BRIDGE_URL" in off.env, false);
|
|
122
|
+
const url = resolveCliLaunch({
|
|
123
|
+
defaultCommand: "x",
|
|
124
|
+
bridge: "http://bridge.local:8777",
|
|
125
|
+
memberEnv: { HINT: "$AITI_BRIDGE_URL" },
|
|
126
|
+
processEnv: PROC_ENV,
|
|
127
|
+
});
|
|
128
|
+
assert.equal(url.env.AITI_BRIDGE_URL, "http://bridge.local:8777");
|
|
129
|
+
assert.equal(url.env.HINT, "http://127.0.0.1:3001/dev/api/extensions/aiti-devtools",
|
|
130
|
+
"成员 env 在 bridge 重写前展开,看到的是重写前值(自动注入默认)");
|
|
131
|
+
});
|
|
132
|
+
|
|
133
|
+
test("resolveCliLaunch:非法 bridge 模式按 inherit + warning;warn 回调与返回值双通道", () => {
|
|
134
|
+
const viaCb = [];
|
|
135
|
+
const r = resolveCliLaunch({
|
|
136
|
+
defaultCommand: "x",
|
|
137
|
+
bridge: "kubernetes",
|
|
138
|
+
processEnv: PROC_ENV,
|
|
139
|
+
warn: (m) => viaCb.push(m),
|
|
140
|
+
});
|
|
141
|
+
assert.equal(r.env.AITI_BRIDGE_URL, "http://127.0.0.1:3001/dev/api/extensions/aiti-devtools");
|
|
142
|
+
assert.equal(r.warnings.length, 1);
|
|
143
|
+
assert.equal(viaCb.length, 1);
|
|
144
|
+
});
|
|
145
|
+
|
|
146
|
+
test("parseArgsLines:每行一个参数,注释/空行忽略,$VAR 不在此展开", () => {
|
|
147
|
+
const { args, warnings } = parseArgsLines("run\n --rm \n# comment\n\n-i\n$HOME");
|
|
148
|
+
assert.deepEqual(args, ["run", "--rm", "-i", "$HOME"]);
|
|
149
|
+
assert.equal(warnings.length, 0);
|
|
150
|
+
});
|
|
151
|
+
|
|
152
|
+
test("parseCustomAgents:合法条目全字段规整(默认值补齐 + target 透传)", () => {
|
|
153
|
+
const { agents, warnings } = parseCustomAgents({
|
|
154
|
+
agents: [
|
|
155
|
+
{
|
|
156
|
+
id: "claude-docker",
|
|
157
|
+
label: "Claude Code (Docker)",
|
|
158
|
+
command: "docker",
|
|
159
|
+
argsPrefix: "run\n--rm\n-i",
|
|
160
|
+
env: { FOO: "bar" },
|
|
161
|
+
bridge: "host.docker.internal",
|
|
162
|
+
target: "claude-code",
|
|
163
|
+
order: "50",
|
|
164
|
+
},
|
|
165
|
+
],
|
|
166
|
+
});
|
|
167
|
+
assert.equal(warnings.length, 0);
|
|
168
|
+
assert.deepEqual(agents, [{
|
|
169
|
+
id: "claude-docker",
|
|
170
|
+
label: "Claude Code (Docker)",
|
|
171
|
+
driver: "generic",
|
|
172
|
+
command: "docker",
|
|
173
|
+
argsPrefix: ["run", "--rm", "-i"],
|
|
174
|
+
env: { FOO: "bar" },
|
|
175
|
+
bridge: "host.docker.internal",
|
|
176
|
+
target: "claude-code",
|
|
177
|
+
probe: "",
|
|
178
|
+
order: 50,
|
|
179
|
+
enabled: true,
|
|
180
|
+
}]);
|
|
181
|
+
assert.deepEqual(parseCustomAgents({ agents: [{ id: "t2", label: "T", command: "c" }] }).agents[0].target, "",
|
|
182
|
+
"缺省 target 空串");
|
|
183
|
+
});
|
|
184
|
+
|
|
185
|
+
test("parseCustomAgents:JSON 字符串输入 + 行式 env 兼容(KEY=VALUE / -NAME)", () => {
|
|
186
|
+
const { agents, warnings } = parseCustomAgents(JSON.stringify({
|
|
187
|
+
agents: [{ id: "a1", label: "A", command: "cmd", env: "K=1\n-BAD\n# c" }],
|
|
188
|
+
}));
|
|
189
|
+
assert.equal(warnings.length, 0);
|
|
190
|
+
assert.deepEqual(agents[0].env, { K: "1" });
|
|
191
|
+
});
|
|
192
|
+
|
|
193
|
+
test("parseCustomAgents:非法 id / 重复 id / 缺 label / generic 缺 command / 非法 driver 逐条跳过;协议型缺 command 合法", () => {
|
|
194
|
+
const { agents, warnings } = parseCustomAgents({
|
|
195
|
+
agents: [
|
|
196
|
+
{ id: "bad/slash", label: "X", command: "c" },
|
|
197
|
+
{ id: "dup", label: "first", command: "c1" },
|
|
198
|
+
{ id: "dup", label: "second", command: "c2" },
|
|
199
|
+
{ id: "nolabel", command: "c" },
|
|
200
|
+
{ id: "nocmd", label: "N" },
|
|
201
|
+
{ id: "ok", label: "OK", command: "c" },
|
|
202
|
+
{ id: "proto", label: "P", driver: "claude", command: "" },
|
|
203
|
+
{ id: "baddriver", label: "B", command: "c", driver: "claude code!" },
|
|
204
|
+
],
|
|
205
|
+
});
|
|
206
|
+
assert.equal(agents.length, 3);
|
|
207
|
+
assert.equal(agents[0].label, "first", "重复 id 先到先得");
|
|
208
|
+
assert.equal(agents[1].id, "ok");
|
|
209
|
+
assert.equal(agents[2].id, "proto", "协议型 driver 接受、command 可空(可解析性由注册侧裁决)");
|
|
210
|
+
assert.equal(warnings.length, 5);
|
|
211
|
+
});
|
|
212
|
+
|
|
213
|
+
test("parseCustomAgents:坏 JSON / agents 缺失 / 非数组 → 空配置 + warning 不抛错", () => {
|
|
214
|
+
assert.deepEqual(parseCustomAgents("{broken").agents, []);
|
|
215
|
+
assert.equal(parseCustomAgents("{broken").warnings.length, 1);
|
|
216
|
+
assert.deepEqual(parseCustomAgents({}).agents, []);
|
|
217
|
+
assert.deepEqual(parseCustomAgents({ agents: "nope" }).warnings.length, 1);
|
|
218
|
+
assert.deepEqual(parseCustomAgents(null).agents, []);
|
|
219
|
+
});
|
|
220
|
+
|
|
221
|
+
test("parseCustomAgents:非法变量名忽略 + enabled:false 保留 + argsPrefix 数组形态", () => {
|
|
222
|
+
const { agents, warnings } = parseCustomAgents({
|
|
223
|
+
agents: [{ id: "e1", label: "E", command: "c", env: { GOOD: "1", "1BAD": "x" }, enabled: false, argsPrefix: ["a", "b"] }],
|
|
224
|
+
});
|
|
225
|
+
assert.equal(warnings.length, 1);
|
|
226
|
+
assert.ok(warnings[0].includes("1BAD"));
|
|
227
|
+
assert.equal(agents[0].enabled, false);
|
|
228
|
+
assert.deepEqual(agents[0].argsPrefix, ["a", "b"]);
|
|
229
|
+
});
|
|
230
|
+
|
|
231
|
+
test("extman feature 读取:captureSpawnEnvFeatures 后 spawnCommand/spawnArgsPrefix 生效", () => {
|
|
232
|
+
captureSpawnEnvFeatures({
|
|
233
|
+
get: (extId, fid) => {
|
|
234
|
+
if (extId === "aiti-x-agent" && fid === "spawn.command") return "docker";
|
|
235
|
+
if (extId === "aiti-x-agent" && fid === "spawn.argsPrefix") return "run\n--rm";
|
|
236
|
+
return undefined;
|
|
237
|
+
},
|
|
238
|
+
});
|
|
239
|
+
try {
|
|
240
|
+
assert.equal(spawnCommand("aiti-x-agent"), "docker");
|
|
241
|
+
assert.equal(spawnArgsPrefix("aiti-x-agent"), "run\n--rm");
|
|
242
|
+
assert.equal(spawnCommand("aiti-other"), "");
|
|
243
|
+
} finally {
|
|
244
|
+
captureSpawnEnvFeatures(null);
|
|
245
|
+
}
|
|
246
|
+
});
|
|
247
|
+
|
|
248
|
+
test("extman feature 声明:spawn.command=string / spawn.argsPrefix=textlist,id 与读取对齐", () => {
|
|
249
|
+
const cmd = spawnCommandFeature("启动包装");
|
|
250
|
+
const pre = spawnArgsPrefixFeature("启动包装");
|
|
251
|
+
assert.equal(cmd.id, "spawn.command");
|
|
252
|
+
assert.equal(cmd.type, "string");
|
|
253
|
+
assert.equal(cmd.group, "启动包装");
|
|
254
|
+
assert.equal(pre.id, "spawn.argsPrefix");
|
|
255
|
+
assert.equal(pre.type, "textlist");
|
|
256
|
+
assert.ok(pre.description.includes("${cwd}"));
|
|
257
|
+
});
|
|
258
|
+
|
|
259
|
+
test("parseEnvList 回归:既有语义不受 launch 层新增影响", () => {
|
|
260
|
+
const { ops } = parseEnvList("A=$B");
|
|
261
|
+
assert.deepEqual(ops, [{ key: "A", value: "$B" }]);
|
|
262
|
+
});
|
|
@@ -0,0 +1,169 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* agent-spawn-env 单测(node --test,直跑 TS:node ≥ 22.6 --experimental-strip-types)。
|
|
3
|
+
*
|
|
4
|
+
* 覆盖 parseEnvList/applyEnvList/resolveEnvList 全分支(含 -NAME 排除)、
|
|
5
|
+
* agentSpawnEnv 合并优先级(白名单 < 自动 bridge < 扩展注册 < 用户列表)、
|
|
6
|
+
* piWebSelfBase 推导(方案 docs/pi-web-ext-agent-spawn-env-plan.md 验证计划 §1)。
|
|
7
|
+
*/
|
|
8
|
+
import { test } from "node:test";
|
|
9
|
+
import assert from "node:assert/strict";
|
|
10
|
+
// 复制同步模式下,测试权威源本体(副本由 sync 检查保证一致)
|
|
11
|
+
import {
|
|
12
|
+
piWebSelfBase,
|
|
13
|
+
bridgeEnv,
|
|
14
|
+
parseEnvList,
|
|
15
|
+
applyEnvList,
|
|
16
|
+
resolveEnvList,
|
|
17
|
+
agentSpawnEnv,
|
|
18
|
+
registerSpawnEnvDefaults,
|
|
19
|
+
spawnEnvList,
|
|
20
|
+
spawnEnvFeature,
|
|
21
|
+
captureSpawnEnvFeatures,
|
|
22
|
+
resolveCliLaunch,
|
|
23
|
+
} from "./agent-spawn-env.ts";
|
|
24
|
+
|
|
25
|
+
test("piWebSelfBase:PORT + PI_WEB_BASE_PATH 归一(尾斜杠剥除)", () => {
|
|
26
|
+
assert.equal(piWebSelfBase({ PORT: "3001", PI_WEB_BASE_PATH: "/dev/" }), "http://127.0.0.1:3001/dev");
|
|
27
|
+
assert.equal(piWebSelfBase({ PORT: "3002", PI_WEB_BASE_PATH: "" }), "http://127.0.0.1:3002");
|
|
28
|
+
assert.equal(piWebSelfBase({ PI_WEB_BASE_PATH: "/dev" }), "http://127.0.0.1:3000/dev", "缺 PORT 回落 3000");
|
|
29
|
+
});
|
|
30
|
+
|
|
31
|
+
test("bridgeEnv:端点带扩展路径签名", () => {
|
|
32
|
+
assert.equal(bridgeEnv({ PORT: "3002" }).AITI_BRIDGE_URL, "http://127.0.0.1:3002/api/extensions/aiti-devtools");
|
|
33
|
+
});
|
|
34
|
+
|
|
35
|
+
test("parseEnvList:设置/排除/注释/非法行", () => {
|
|
36
|
+
const { ops, warnings } = parseEnvList("A=1\n -B \n# c\nbroken\n1BAD=x\n-C=x");
|
|
37
|
+
assert.deepEqual(ops, [
|
|
38
|
+
{ key: "A", value: "1" },
|
|
39
|
+
{ key: "B", value: null },
|
|
40
|
+
]);
|
|
41
|
+
assert.equal(warnings.length, 3, "broken / 1BAD=x / -C=x 各一条");
|
|
42
|
+
});
|
|
43
|
+
|
|
44
|
+
test("applyEnvList:$引用查工作 env 再回退 base;移除幂等;移除后可重设", () => {
|
|
45
|
+
const env = { HOME: "/h", GONE: "g" };
|
|
46
|
+
const { ops } = parseEnvList("A=$HOME/1\n-GONE\nB=$GONE\nGONE=again");
|
|
47
|
+
const warnings = [];
|
|
48
|
+
applyEnvList(ops, env, { base: { HOME: "/h" }, onWarning: (w) => warnings.push(w) });
|
|
49
|
+
assert.equal(env.A, "/h/1");
|
|
50
|
+
assert.equal("GONE" in env, true);
|
|
51
|
+
assert.equal(env.GONE, "again", "移除行之后可被后续行重新设置");
|
|
52
|
+
assert.equal(env.B, "", "引用时 GONE 已被移除且 base 无 → 空串 + warning");
|
|
53
|
+
assert.equal(warnings.length, 1);
|
|
54
|
+
});
|
|
55
|
+
|
|
56
|
+
test("resolveEnvList:列表内互引 b=$a 就地解析", () => {
|
|
57
|
+
const { env, warnings } = resolveEnvList("A=hello\nB=$A/world\nC=${A}-${B}");
|
|
58
|
+
assert.deepEqual(env, { A: "hello", B: "hello/world", C: "hello-hello/world" });
|
|
59
|
+
assert.equal(warnings.length, 0);
|
|
60
|
+
});
|
|
61
|
+
|
|
62
|
+
test("resolveEnvList:回退父进程 env,未定义置空并记 warning", () => {
|
|
63
|
+
const { env, warnings } = resolveEnvList("X=$HOME/y\nY=$NOPE_zzz", { HOME: "/home/pi" });
|
|
64
|
+
assert.equal(env.X, "/home/pi/y");
|
|
65
|
+
assert.equal(env.Y, "", "未定义 → 空串,不保留字面量");
|
|
66
|
+
assert.ok(warnings.some((w) => w.includes("$NOPE_zzz")));
|
|
67
|
+
});
|
|
68
|
+
|
|
69
|
+
test("resolveEnvList:-NAME 排除(对空白 env 是无害幂等)", () => {
|
|
70
|
+
const { env, warnings } = resolveEnvList("A=1\n-A\n-A");
|
|
71
|
+
assert.deepEqual(env, {});
|
|
72
|
+
assert.equal(warnings.length, 0, "排除未设置的变量幂等无害");
|
|
73
|
+
});
|
|
74
|
+
|
|
75
|
+
test("resolveEnvList:不做引号剥离/%VAR%/命令替换(按字面量)", () => {
|
|
76
|
+
const { env } = resolveEnvList('Q="quoted"\nP=%PATH%\nC=`date`');
|
|
77
|
+
assert.equal(env.Q, '"quoted"');
|
|
78
|
+
assert.equal(env.P, "%PATH%");
|
|
79
|
+
assert.equal(env.C, "`date`");
|
|
80
|
+
});
|
|
81
|
+
|
|
82
|
+
test("agentSpawnEnv:白名单 < 自动 bridge < 用户列表(可覆盖自动值)", () => {
|
|
83
|
+
const governance = (_cli, extra) => ({ PATH: "/bin", ...(extra || {}) });
|
|
84
|
+
const out = agentSpawnEnv({
|
|
85
|
+
cli: "zcode",
|
|
86
|
+
governance,
|
|
87
|
+
envList: "AITI_BRIDGE_URL=http://override:1/mcp\nUSERV=$UNDEF2",
|
|
88
|
+
processEnv: { PORT: "3002", UNDEF2: "pv" },
|
|
89
|
+
warn: () => {},
|
|
90
|
+
});
|
|
91
|
+
assert.equal(out.PATH, "/bin");
|
|
92
|
+
assert.equal(out.AITI_BRIDGE_URL, "http://override:1/mcp", "用户列表覆盖自动注入");
|
|
93
|
+
assert.equal(out.USERV, "pv", "列表引用回退父进程 env");
|
|
94
|
+
});
|
|
95
|
+
|
|
96
|
+
test("agentSpawnEnv:-NAME 急救——拔掉透传漏进来的变量,也可去掉自动注入", () => {
|
|
97
|
+
const governance = (_cli, extra) => ({ PATH: "/bin", LEAKY: "oops", ...(extra || {}) });
|
|
98
|
+
const out = agentSpawnEnv({
|
|
99
|
+
cli: "zcode",
|
|
100
|
+
governance,
|
|
101
|
+
envList: "-LEAKY\n-AITI_BRIDGE_URL",
|
|
102
|
+
processEnv: { PORT: "3002" },
|
|
103
|
+
warn: () => {},
|
|
104
|
+
});
|
|
105
|
+
assert.equal("LEAKY" in out, false, "排除治理透传变量");
|
|
106
|
+
assert.equal("AITI_BRIDGE_URL" in out, false, "排除自动注入项");
|
|
107
|
+
assert.equal(out.PATH, "/bin", "未排除的照常保留");
|
|
108
|
+
});
|
|
109
|
+
|
|
110
|
+
test("agentSpawnEnv:扩展注册列表 < 用户列表;注册侧排除同样生效", () => {
|
|
111
|
+
registerSpawnEnvDefaults("aiti-test-ext", "REG=1\n-LEAKY");
|
|
112
|
+
try {
|
|
113
|
+
const out = agentSpawnEnv({
|
|
114
|
+
extId: "aiti-test-ext",
|
|
115
|
+
envList: "REG=2",
|
|
116
|
+
processEnv: { LEAKY: "x" },
|
|
117
|
+
warn: () => {},
|
|
118
|
+
});
|
|
119
|
+
assert.equal(out.REG, "2", "用户覆盖注册默认");
|
|
120
|
+
assert.equal("LEAKY" in out, false, "注册侧排除生效");
|
|
121
|
+
assert.match(out.AITI_BRIDGE_URL, /api\/extensions\/aiti-devtools$/);
|
|
122
|
+
} finally {
|
|
123
|
+
registerSpawnEnvDefaults("aiti-test-ext", "");
|
|
124
|
+
}
|
|
125
|
+
});
|
|
126
|
+
|
|
127
|
+
test("agentSpawnEnv:引用可解析治理透传(工作 env 优先于 base)", () => {
|
|
128
|
+
const governance = (_cli, extra) => ({ MARK: "m1", ...(extra || {}) });
|
|
129
|
+
const out = agentSpawnEnv({ cli: "x", governance, envList: "USE=$MARK", processEnv: { MARK: "base" }, warn: () => {} });
|
|
130
|
+
assert.equal(out.USE, "m1", "工作 env(透传值)优先");
|
|
131
|
+
});
|
|
132
|
+
|
|
133
|
+
test("agentSpawnEnv:无 governance 派(cursor/qoder)= processEnv 基底 + bridge + 列表", () => {
|
|
134
|
+
const out = agentSpawnEnv({ envList: "K=1", processEnv: { FOO: "f" }, warn: () => {} });
|
|
135
|
+
assert.equal(out.FOO, "f");
|
|
136
|
+
assert.equal(out.K, "1");
|
|
137
|
+
assert.match(out.AITI_BRIDGE_URL, /api\/extensions\/aiti-devtools$/);
|
|
138
|
+
});
|
|
139
|
+
|
|
140
|
+
test("agentSpawnEnv:warning 不抛错(未传 warn 走 console.warn)", () => {
|
|
141
|
+
assert.doesNotThrow(() => agentSpawnEnv({ envList: "bad line", processEnv: {} }));
|
|
142
|
+
});
|
|
143
|
+
|
|
144
|
+
test("spawnEnvList:ctx.features 优先,非字符串按空列表", () => {
|
|
145
|
+
captureSpawnEnvFeatures({ get: (_e, fid) => (fid === "spawn.env" ? "A=1" : undefined) });
|
|
146
|
+
assert.equal(spawnEnvList("aiti-x"), "A=1");
|
|
147
|
+
captureSpawnEnvFeatures({ get: () => true });
|
|
148
|
+
assert.equal(spawnEnvList("aiti-x"), "", "boolean 值(旧 host)按空列表");
|
|
149
|
+
captureSpawnEnvFeatures(null);
|
|
150
|
+
});
|
|
151
|
+
|
|
152
|
+
test("spawnEnvFeature:声明形状(id/type=textlist,含 -NAME 语法说明)", () => {
|
|
153
|
+
const f = spawnEnvFeature("G");
|
|
154
|
+
assert.equal(f.id, "spawn.env");
|
|
155
|
+
assert.equal(f.type, "textlist");
|
|
156
|
+
assert.equal(f.group, "G");
|
|
157
|
+
assert.ok(f.description.includes("-NAME"));
|
|
158
|
+
});
|
|
159
|
+
|
|
160
|
+
test("resolveCliLaunch:win32 下 .cmd/.bat command → shell:true(lessons §0.1 欠账收口)", () => {
|
|
161
|
+
const r = resolveCliLaunch({ defaultCommand: "cli", command: process.platform === "win32" ? "C:\tools\agent.cmd" : "cli", driverArgs: ["--flag"] });
|
|
162
|
+
if (process.platform === "win32") {
|
|
163
|
+
assert.equal(r.shell, true, ".cmd 必须提示 shell:true");
|
|
164
|
+
} else {
|
|
165
|
+
assert.ok(!r.shell, "POSIX 不设 shell 标记");
|
|
166
|
+
}
|
|
167
|
+
const r2 = resolveCliLaunch({ defaultCommand: "claude", driverArgs: [] });
|
|
168
|
+
assert.ok(!r2.shell, "裸名/无扩展名 command 不设 shell 标记");
|
|
169
|
+
});
|