@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,253 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* 共享:@到新会话 CWD 判定(不随便变更当前 CWD,归一化到 workspace 粒度)
|
|
3
|
+
* 方案:docs/pi-web-at-new-session-cwd-plan.md(v1)+ docs/pi-web-at-new-session-cwd-v2-plan.md(v2)
|
|
4
|
+
*
|
|
5
|
+
* 原则(v2,2026-09-17):目标定位优先于目录切换,且 CWD 必须落在 workspace 粒度——
|
|
6
|
+
* ① 目标已在当前 CWD 内 → 保持当前;② 目标在当前 CWD 的关注目录(git-trace watchPaths,
|
|
7
|
+
* repoRoot ?? path)内 → 切到该关注目录(最深命中);③ 目标在已有 workspace(左侧下拉候选,
|
|
8
|
+
* /api/sessions 派生 projectRoot ?? cwd)内 → 用最长覆盖项;④ 否则用自己的目录,向上剥离
|
|
9
|
+
* 常规目录名(docs/doc/tmp/temp/design/designs),剥离结果命中 workspace 则用 workspace。
|
|
10
|
+
* 无当前 CWD 时 ②③④ 同样执行(修 v1:无 cwd 直接落文件父目录 → 深子目录 bug)。
|
|
11
|
+
*
|
|
12
|
+
* 纯函数(无 DOM/fs 依赖):server 端(jiti)与 client 端(vite 打包,经 `../../../_shared/…` 相对导入)
|
|
13
|
+
* 双端 import 同一源——与 `_shared/ext-float-dock.ts` 同款引用方式。
|
|
14
|
+
*
|
|
15
|
+
* 能力收口:session-manager client 注册 `session-manager.mention` 服务(buildAtText + openNewSession);
|
|
16
|
+
* 消费方优先经服务调用(`openNewSessionWithExtSvc`),服务缺席时降级本文件同源实现(行为不变)。
|
|
17
|
+
*/
|
|
18
|
+
|
|
19
|
+
/** 常规目录名(剥离候选:目标目录是这些名字时不当 CWD,向上找;v2 用户拍板写死,暂不可配置) */
|
|
20
|
+
export const DEFAULT_EXCLUDE_DIR_NAMES = ["docs", "doc", "tmp", "temp", "design", "designs"];
|
|
21
|
+
|
|
22
|
+
/** 路径归一:win 反斜杠 → 斜杠,去尾斜杠。 */
|
|
23
|
+
export function normDir(p: string): string {
|
|
24
|
+
return String(p || "").replace(/\\/g, "/").replace(/\/+$/, "");
|
|
25
|
+
}
|
|
26
|
+
|
|
27
|
+
/** containment:a 与 b 相等或互为路径前缀(doc-center wsCovers 同款;兼容 win 反斜杠与尾斜杠)。 */
|
|
28
|
+
export function pathCovers(a: string, b: string): boolean {
|
|
29
|
+
if (!a || !b) return false;
|
|
30
|
+
const na = normDir(a);
|
|
31
|
+
const nb = normDir(b);
|
|
32
|
+
if (!na || !nb) return false;
|
|
33
|
+
return na === nb || na.startsWith(nb + "/") || nb.startsWith(na + "/");
|
|
34
|
+
}
|
|
35
|
+
|
|
36
|
+
/** 严格单向覆盖:c 是 target 的前缀(或相等)——用于「切到覆盖者」候选,避免把目标的子目录误选。 */
|
|
37
|
+
function coversDir(c: string, target: string): boolean {
|
|
38
|
+
if (!c || !target) return false;
|
|
39
|
+
return target === c || target.startsWith(c + "/");
|
|
40
|
+
}
|
|
41
|
+
|
|
42
|
+
/** 向上剥离常规目录名(docs/tmp/design…,大小写不敏感),返回首个非常规目录;无可剥则返回原目录。 */
|
|
43
|
+
export function stripCommonDirs(dir: string, excludeNames?: string[]): string {
|
|
44
|
+
const ex = new Set((excludeNames ?? DEFAULT_EXCLUDE_DIR_NAMES).map((s) => String(s).toLowerCase()));
|
|
45
|
+
let d = normDir(dir);
|
|
46
|
+
for (;;) {
|
|
47
|
+
const name = d.split("/").pop() || "";
|
|
48
|
+
if (!name || !ex.has(name.toLowerCase())) break;
|
|
49
|
+
const idx = d.lastIndexOf("/");
|
|
50
|
+
if (idx <= 0) break; // 根级(/docs 或 D:)不再上溯
|
|
51
|
+
d = d.slice(0, idx);
|
|
52
|
+
}
|
|
53
|
+
return d;
|
|
54
|
+
}
|
|
55
|
+
|
|
56
|
+
/** 候选(candidates,绝对路径)中严格覆盖 target 的最长(最深)项;无则 null。 */
|
|
57
|
+
export function longestCovering(target: string, candidates: Iterable<string>): string | null {
|
|
58
|
+
let best: string | null = null;
|
|
59
|
+
for (const raw of candidates) {
|
|
60
|
+
const c = normDir(String(raw || ""));
|
|
61
|
+
if (!c) continue;
|
|
62
|
+
if (coversDir(c, target)) {
|
|
63
|
+
if (!best || c.length > best.length) best = c;
|
|
64
|
+
}
|
|
65
|
+
}
|
|
66
|
+
return best;
|
|
67
|
+
}
|
|
68
|
+
|
|
69
|
+
export interface ResolveNewSessionCwdResult {
|
|
70
|
+
/** 判定后应使用的工作目录(绝对路径)。 */
|
|
71
|
+
cwd: string;
|
|
72
|
+
/** 是否相对当前 CWD 发生了切换(无当前 CWD 时恒 false)。 */
|
|
73
|
+
switched: boolean;
|
|
74
|
+
}
|
|
75
|
+
|
|
76
|
+
/**
|
|
77
|
+
* 判定「@到新会话」应使用的工作目录(v2)。
|
|
78
|
+
* @param targetDir 目标目录(绝对路径;文件传其所在目录、目录传自身——调用方提取)
|
|
79
|
+
* @param targetPath 目标文件/目录全路径(可选;文件场景传文件路径,覆盖判定更精确;缺省回退 targetDir)
|
|
80
|
+
* @param currentCwd 当前会话 cwd(空/无 → 跳过 ①,②③④ 照常执行)
|
|
81
|
+
* @param watchPaths 当前 cwd 的关注路径(git-trace watchPaths;元素可为字符串或 {path, repoRoot},
|
|
82
|
+
* 命中时取 repoRoot ?? path —— v2 用户拍板仓库根优先)
|
|
83
|
+
* @param knownWorkspaces 已有 workspace 候选(左侧下拉 = /api/sessions 派生 projectRoot ?? cwd 去重;可空)
|
|
84
|
+
* @param excludeNames 常规目录名清单(缺省 DEFAULT_EXCLUDE_DIR_NAMES)
|
|
85
|
+
*/
|
|
86
|
+
export function resolveNewSessionCwd(opts: {
|
|
87
|
+
targetDir: string;
|
|
88
|
+
targetPath?: string | null;
|
|
89
|
+
currentCwd?: string | null;
|
|
90
|
+
watchPaths?: (string | { path?: string | null; repoRoot?: string | null })[];
|
|
91
|
+
knownWorkspaces?: (string | null | undefined)[];
|
|
92
|
+
excludeNames?: string[];
|
|
93
|
+
}): ResolveNewSessionCwdResult {
|
|
94
|
+
const target = normDir(opts.targetPath || opts.targetDir || "");
|
|
95
|
+
const dir = normDir(opts.targetDir || opts.targetPath || "");
|
|
96
|
+
const cur = normDir(opts.currentCwd || "");
|
|
97
|
+
if (!target && !dir) return { cwd: cur, switched: false };
|
|
98
|
+
|
|
99
|
+
// ① 目标在当前 CWD 内(双向 containment,doc-center wsCovers 同款)→ 保持
|
|
100
|
+
if (cur && (pathCovers(cur, target) || (dir && dir !== target && pathCovers(cur, dir)))) {
|
|
101
|
+
return { cwd: cur, switched: false };
|
|
102
|
+
}
|
|
103
|
+
|
|
104
|
+
// ② 目标在当前 CWD 的关注目录(watchPaths,repoRoot ?? path)内 → 切到该关注目录(最深)
|
|
105
|
+
const watchCands: string[] = [];
|
|
106
|
+
for (const w of Array.isArray(opts.watchPaths) ? opts.watchPaths : []) {
|
|
107
|
+
if (typeof w === "string") { if (w) watchCands.push(w); continue; }
|
|
108
|
+
const o = (w ?? {}) as { path?: string | null; repoRoot?: string | null };
|
|
109
|
+
watchCands.push(normDir(o.repoRoot || o.path || ""));
|
|
110
|
+
}
|
|
111
|
+
const wh = longestCovering(target, watchCands) ?? (dir && dir !== target ? longestCovering(dir, watchCands) : null);
|
|
112
|
+
if (wh) return { cwd: wh, switched: !!cur && wh !== cur };
|
|
113
|
+
|
|
114
|
+
// ③ 目标在已有 workspace(左侧下拉候选)内 → 用最长覆盖项
|
|
115
|
+
const wsCands = (Array.isArray(opts.knownWorkspaces) ? opts.knownWorkspaces : []).filter(Boolean) as string[];
|
|
116
|
+
const ws = longestCovering(target, wsCands) ?? (dir && dir !== target ? longestCovering(dir, wsCands) : null);
|
|
117
|
+
if (ws) return { cwd: ws, switched: !!cur && ws !== cur };
|
|
118
|
+
|
|
119
|
+
// ④ 自己的目录:向上剥离常规目录名;剥离结果命中 workspace 则用 workspace
|
|
120
|
+
const stripped = stripCommonDirs(dir || target, opts.excludeNames);
|
|
121
|
+
const ws2 = longestCovering(stripped, wsCands);
|
|
122
|
+
const out = ws2 || stripped || dir || target || "";
|
|
123
|
+
return { cwd: out, switched: !!cur && out !== cur };
|
|
124
|
+
}
|
|
125
|
+
|
|
126
|
+
/**
|
|
127
|
+
* @ 引用文本:与宿主 `pi-web/lib/file-fuzzy.ts` `buildAtMentionText` 同格式(空格加引号、目录尾斜杠)。
|
|
128
|
+
* 传入最终要显示的路径(调用方决定相对/绝对口径),本函数只负责 `@` 与引号。
|
|
129
|
+
*/
|
|
130
|
+
export function buildAtText(path: string, isDir?: boolean): string {
|
|
131
|
+
const p = isDir ? path.replace(/\\/g, "/").replace(/\/+$/, "") + "/" : path;
|
|
132
|
+
return p.includes(" ") ? `@"${p}" ` : `@${p} `;
|
|
133
|
+
}
|
|
134
|
+
|
|
135
|
+
// ── 已知 workspace 列表(宿主 /api/sessions 派生,对齐左侧 workspace 下拉)──────────
|
|
136
|
+
// 模块级 TTL 缓存(60s):一次性 fetch 的 Memory cache,无定时器(禁轮询红线自查);
|
|
137
|
+
// 失败静默降级 [](本地判定兜底),并进入冷却避免短时网络故障反复重拉。
|
|
138
|
+
const KNOWN_WS_TTL_MS = 60_000;
|
|
139
|
+
const wsCache: { t: number; list: string[] } = { t: 0, list: [] };
|
|
140
|
+
|
|
141
|
+
export function _resetWsCacheForTest(): void { wsCache.t = 0; wsCache.list = []; }
|
|
142
|
+
|
|
143
|
+
async function fetchKnownWorkspaces(apiUrl: (path: string) => string, fetchFn: typeof fetch): Promise<string[]> {
|
|
144
|
+
const now = Date.now();
|
|
145
|
+
if (now - wsCache.t < KNOWN_WS_TTL_MS) return wsCache.list;
|
|
146
|
+
try {
|
|
147
|
+
const r = await fetchFn(apiUrl("/api/sessions"), { headers: { accept: "application/json" } });
|
|
148
|
+
const d = await r.json().catch(() => null) as { sessions?: Array<{ projectRoot?: string; cwd?: string }> } | null;
|
|
149
|
+
const set = new Set<string>();
|
|
150
|
+
for (const s of d?.sessions ?? []) {
|
|
151
|
+
const root = normDir((s as any)?.projectRoot ?? (s as any)?.cwd ?? "");
|
|
152
|
+
if (root) set.add(root);
|
|
153
|
+
}
|
|
154
|
+
wsCache.list = [...set];
|
|
155
|
+
} catch {
|
|
156
|
+
wsCache.list = [];
|
|
157
|
+
}
|
|
158
|
+
wsCache.t = now;
|
|
159
|
+
return wsCache.list;
|
|
160
|
+
}
|
|
161
|
+
|
|
162
|
+
/**
|
|
163
|
+
* client 便捷:快路径(目标在当前 CWD 内 → 零请求保持)→ 需要进一步判定时拉已知 workspace
|
|
164
|
+
* (/api/sessions 派生,TTL 缓存)+ POST git-trace 端点(关注路径 + 已知列表复核)→ 失败降级
|
|
165
|
+
* 本地判定(knownWorkspaces 在手、watchPaths 缺席)。
|
|
166
|
+
* 返回最终 cwd 字符串;调用方据此派发 pi-web:new-session。
|
|
167
|
+
* @param apiUrl 扩展各自的 apiUrl(host-shim)——用于拼 git-trace 端点与宿主 /api/sessions
|
|
168
|
+
* @param fetchFn 测试注入用(缺省浏览器 fetch)
|
|
169
|
+
*/
|
|
170
|
+
export async function resolveNewSessionCwdClient(opts: {
|
|
171
|
+
targetDir: string;
|
|
172
|
+
targetPath?: string | null;
|
|
173
|
+
currentCwd?: string | null;
|
|
174
|
+
apiUrl: (path: string) => string;
|
|
175
|
+
fetchFn?: typeof fetch;
|
|
176
|
+
}): Promise<string> {
|
|
177
|
+
const target = normDir(opts.targetPath || opts.targetDir || "");
|
|
178
|
+
const cur = normDir(opts.currentCwd || "");
|
|
179
|
+
// 快路径:当前 CWD 覆盖目标 → 保持(零请求;v2 唯一短路点——无 cwd 时仍需 ②③④ 归一化)
|
|
180
|
+
if (cur && target && pathCovers(cur, target)) return cur;
|
|
181
|
+
// 空目标(消息引用等无路径场景)→ 恒保持当前
|
|
182
|
+
if (!opts.targetDir && !opts.targetPath) return cur;
|
|
183
|
+
const fetchFn = opts.fetchFn ?? ((...a: Parameters<typeof fetch>) => fetch(...a));
|
|
184
|
+
const knownWs = await fetchKnownWorkspaces(opts.apiUrl, fetchFn);
|
|
185
|
+
try {
|
|
186
|
+
const r = await fetchFn(opts.apiUrl("/api/extensions/aiti-git-trace/new-session-cwd"), {
|
|
187
|
+
method: "POST",
|
|
188
|
+
headers: { "content-type": "application/json" },
|
|
189
|
+
body: JSON.stringify({
|
|
190
|
+
targetDir: opts.targetDir, targetPath: opts.targetPath || "", cwd: opts.currentCwd || "",
|
|
191
|
+
knownWorkspaces: knownWs,
|
|
192
|
+
}),
|
|
193
|
+
});
|
|
194
|
+
const d = await r.json().catch(() => ({} as any));
|
|
195
|
+
if (d?.ok && typeof d.cwd === "string" && d.cwd) return d.cwd;
|
|
196
|
+
} catch { /* 端点缺席/失败 → 本地判定兜底(fail-silent) */ }
|
|
197
|
+
return resolveNewSessionCwd({
|
|
198
|
+
targetDir: opts.targetDir, targetPath: opts.targetPath, currentCwd: opts.currentCwd, knownWorkspaces: knownWs,
|
|
199
|
+
}).cwd;
|
|
200
|
+
}
|
|
201
|
+
|
|
202
|
+
/**
|
|
203
|
+
* @到新会话完整动作(client 专用):写 pending composer 预填 → CWD 判定(v2,git-trace 端点复核)
|
|
204
|
+
* → 派发 pi-web:new-session。与宿主 ChatInput 消费端(15s 时效)配套。
|
|
205
|
+
* @param windowRef 测试注入(node 环境无 window;缺省取全局 window)
|
|
206
|
+
*/
|
|
207
|
+
export async function openNewSession(opts: {
|
|
208
|
+
text: string;
|
|
209
|
+
targetDir: string;
|
|
210
|
+
targetPath?: string | null;
|
|
211
|
+
currentCwd?: string | null;
|
|
212
|
+
apiUrl: (path: string) => string;
|
|
213
|
+
fetchFn?: typeof fetch;
|
|
214
|
+
dispatch?: (evt: Event) => void; // 测试注入(缺省 window.dispatchEvent)
|
|
215
|
+
windowRef?: { __piWebPendingComposer?: unknown } | null;
|
|
216
|
+
}): Promise<void> {
|
|
217
|
+
const win = opts.windowRef !== undefined ? opts.windowRef : (typeof window !== "undefined" ? window : null);
|
|
218
|
+
if (win) win.__piWebPendingComposer = { text: opts.text, at: Date.now() };
|
|
219
|
+
const finalCwd = await resolveNewSessionCwdClient({
|
|
220
|
+
targetDir: opts.targetDir, targetPath: opts.targetPath, currentCwd: opts.currentCwd, apiUrl: opts.apiUrl, fetchFn: opts.fetchFn,
|
|
221
|
+
});
|
|
222
|
+
const dispatch = opts.dispatch ?? ((evt: Event) => (typeof window !== "undefined" ? window : null)?.dispatchEvent?.(evt));
|
|
223
|
+
dispatch(new CustomEvent("pi-web:new-session", { detail: { cwd: finalCwd } }));
|
|
224
|
+
}
|
|
225
|
+
|
|
226
|
+
/**
|
|
227
|
+
* 消费方统一入口:优先 session-manager 的 `session-manager.mention` 客户端服务(能力收口),
|
|
228
|
+
* 服务缺席(session-manager 禁用/未就绪)→ 降级本文件同源实现(行为不变)。
|
|
229
|
+
* @param extSvc 消费方 host-shim 的 extSvc(`getExtService` 封装;未提供则直接降级)
|
|
230
|
+
*/
|
|
231
|
+
export async function openNewSessionWithExtSvc(opts: {
|
|
232
|
+
text: string;
|
|
233
|
+
targetDir: string;
|
|
234
|
+
targetPath?: string | null;
|
|
235
|
+
currentCwd?: string | null;
|
|
236
|
+
apiUrl: (path: string) => string;
|
|
237
|
+
extSvc?: <T>(key: string) => T | undefined;
|
|
238
|
+
fetchFn?: typeof fetch;
|
|
239
|
+
dispatch?: (evt: Event) => void;
|
|
240
|
+
windowRef?: { __piWebPendingComposer?: unknown } | null;
|
|
241
|
+
}): Promise<void> {
|
|
242
|
+
const svc = opts.extSvc?.("session-manager.mention") as
|
|
243
|
+
| { openNewSession: (t: string, o: { targetDir: string; targetPath?: string | null; currentCwd?: string | null }) => Promise<void> }
|
|
244
|
+
| undefined;
|
|
245
|
+
if (svc?.openNewSession) {
|
|
246
|
+
await svc.openNewSession(opts.text, { targetDir: opts.targetDir, targetPath: opts.targetPath, currentCwd: opts.currentCwd });
|
|
247
|
+
return;
|
|
248
|
+
}
|
|
249
|
+
await openNewSession({
|
|
250
|
+
text: opts.text, targetDir: opts.targetDir, targetPath: opts.targetPath, currentCwd: opts.currentCwd, apiUrl: opts.apiUrl,
|
|
251
|
+
fetchFn: opts.fetchFn, dispatch: opts.dispatch, windowRef: opts.windowRef,
|
|
252
|
+
});
|
|
253
|
+
}
|
|
@@ -0,0 +1,65 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* open-viewer-window — 「在新窗口打开」共享实现(aiti-viewer 协议 + 大窗口居中)。
|
|
3
|
+
*
|
|
4
|
+
* 使用方:aiti-editor(文件查看器工具条)/ aiti-folder(文件夹树右键)——两处原本
|
|
5
|
+
* 各自内联同款逻辑(ticket 换票 + ready 握手 + window.open),收敛于此,改窗口策略
|
|
6
|
+
* 一处生效。经相对路径 import(../../_shared/,同 aiti-editor-inject.mjs 先例),
|
|
7
|
+
* 各扩展 vite 构建自行打包,无运行时共享。
|
|
8
|
+
*
|
|
9
|
+
* aiti-viewer 协议(路径不进 URL):
|
|
10
|
+
* 1. POST /api/files/ticket 换一次性票(TTL 5 分钟);
|
|
11
|
+
* 2. window.open("/viewer") 开空白窗;
|
|
12
|
+
* 3. 子窗加载后向 opener 发 {source:"aiti-viewer",type:"ready"};
|
|
13
|
+
* 4. 本侧回 {source:"aiti-viewer",type:"init",ticket},子窗兑票打开目标。
|
|
14
|
+
* 注意不能带 noopener——子窗需要 window.opener 完成握手(同源可信)。
|
|
15
|
+
*
|
|
16
|
+
* 窗口尺寸:屏幕可用区 ~90% 并居中(含多屏 availLeft/Top 偏移)。不传 features 时
|
|
17
|
+
* 浏览器按默认弹窗尺寸开窗(实测 ~880px 且位置随缘),viewer 大面积查看
|
|
18
|
+
* (md 全宽 / 代码 / 表格)体验差——这是 2026-09-06「viewer 居左受限宽度」的根因。
|
|
19
|
+
* 已知边界:Chrome 把 height 当窗口外框高度(扣掉地址栏后 viewport 略小于请求值,
|
|
20
|
+
* ~85-90% 屏高),宽度精确命中;不再补偿(地址栏高度随浏览器/缩放变化,补死值不稳)。
|
|
21
|
+
*/
|
|
22
|
+
|
|
23
|
+
/** 计算 /viewer 新窗口的 window.open features:屏幕可用区 ~90% 居中。 */
|
|
24
|
+
export function viewerWindowFeatures(): string {
|
|
25
|
+
const scr = window.screen;
|
|
26
|
+
const aw = scr.availWidth || 1280;
|
|
27
|
+
const ah = scr.availHeight || 800;
|
|
28
|
+
const vw = Math.round(aw * 0.9);
|
|
29
|
+
const vh = Math.round(ah * 0.9);
|
|
30
|
+
// availLeft/Top:多屏场景当前屏原点(TS lib.dom 未收录,运行时广泛支持)
|
|
31
|
+
const sl = (scr as unknown as { availLeft?: number }).availLeft ?? 0;
|
|
32
|
+
const st = (scr as unknown as { availTop?: number }).availTop ?? 0;
|
|
33
|
+
const left = sl + Math.max(0, Math.round((aw - vw) / 2));
|
|
34
|
+
const top = st + Math.max(0, Math.round((ah - vh) / 2));
|
|
35
|
+
return `width=${vw},height=${vh},left=${left},top=${top}`;
|
|
36
|
+
}
|
|
37
|
+
|
|
38
|
+
/** 打开独立查看窗口(pi-web /viewer):换票 → 开窗 → ready 握手交票。失败静默(调用方 UI 无感知路径)。 */
|
|
39
|
+
export function openViewerWindow(
|
|
40
|
+
apiUrl: (p: string) => string,
|
|
41
|
+
target: { path: string; kind: "file" | "folder"; cwd?: string },
|
|
42
|
+
): void {
|
|
43
|
+
try {
|
|
44
|
+
// 换票 type:folder 必须显式传 "list"——缺省 type="download" 会对目标做 isFile 校验,
|
|
45
|
+
// 文件夹恒 400 "Not a file"(aiti-folder 开文件夹长期无响应的根因,2026-09-06 深审逮到)。
|
|
46
|
+
// list 允许目录目标;file 走缺省 download(与既有 aiti-editor 行为一致)。
|
|
47
|
+
const type = target.kind === "folder" ? "list" : undefined;
|
|
48
|
+
fetch(apiUrl("/api/files/ticket"), { method: "POST", headers: { "content-type": "application/json" }, body: JSON.stringify({ path: target.path, ...(type ? { type } : {}), kind: target.kind, cwd: target.cwd }) })
|
|
49
|
+
.then((r) => r.json()).then((d: { ticket?: string }) => {
|
|
50
|
+
if (!d || !d.ticket) return;
|
|
51
|
+
let win: Window | null = null;
|
|
52
|
+
const onMsg = (ev: MessageEvent) => {
|
|
53
|
+
if (ev.origin !== location.origin || ev.source !== win) return;
|
|
54
|
+
const m: { source?: string; type?: string } = ev.data;
|
|
55
|
+
if (m && m.source === "aiti-viewer" && m.type === "ready" && win && !win.closed) {
|
|
56
|
+
win.postMessage({ source: "aiti-viewer", type: "init", ticket: d.ticket }, location.origin);
|
|
57
|
+
window.removeEventListener("message", onMsg);
|
|
58
|
+
}
|
|
59
|
+
};
|
|
60
|
+
window.addEventListener("message", onMsg);
|
|
61
|
+
win = window.open(apiUrl("/viewer"), "_blank", viewerWindowFeatures());
|
|
62
|
+
if (!win) window.removeEventListener("message", onMsg);
|
|
63
|
+
}).catch(() => { /* noop */ });
|
|
64
|
+
} catch { /* noop */ }
|
|
65
|
+
}
|
|
@@ -0,0 +1,123 @@
|
|
|
1
|
+
// _shared/overlay-back-client 单测(扩展端返回关闭接线薄封装)。
|
|
2
|
+
// 覆盖:小屏门控 / 断点动态重估 / 服务缺席与抛错降级 / acquire 异常兜底 / release 幂等。
|
|
3
|
+
// Run: node --experimental-strip-types --test pi-web-ext/_shared/overlay-back-client.test.mjs
|
|
4
|
+
import assert from "node:assert/strict";
|
|
5
|
+
import test from "node:test";
|
|
6
|
+
|
|
7
|
+
import { dismissOnBack, OVERLAY_BACK_MOBILE_QUERY } from "./overlay-back-client.ts";
|
|
8
|
+
|
|
9
|
+
/** 可控 matchMedia 桩:matches 可翻转并派发 change。 */
|
|
10
|
+
function makeMedia(initial) {
|
|
11
|
+
const listeners = [];
|
|
12
|
+
let matches = initial;
|
|
13
|
+
const mq = {
|
|
14
|
+
get matches() { return matches; },
|
|
15
|
+
addEventListener(type, fn) { if (type === "change") listeners.push(fn); },
|
|
16
|
+
removeEventListener(type, fn) {
|
|
17
|
+
const i = listeners.indexOf(fn);
|
|
18
|
+
if (i >= 0) listeners.splice(i, 1);
|
|
19
|
+
},
|
|
20
|
+
addListener(fn) { listeners.push(fn); },
|
|
21
|
+
removeListener(fn) {
|
|
22
|
+
const i = listeners.indexOf(fn);
|
|
23
|
+
if (i >= 0) listeners.splice(i, 1);
|
|
24
|
+
},
|
|
25
|
+
};
|
|
26
|
+
return {
|
|
27
|
+
mq,
|
|
28
|
+
listenerCount: () => listeners.length,
|
|
29
|
+
set(value) {
|
|
30
|
+
matches = value;
|
|
31
|
+
for (const fn of [...listeners]) fn({ matches: value, media: OVERLAY_BACK_MOBILE_QUERY });
|
|
32
|
+
},
|
|
33
|
+
};
|
|
34
|
+
}
|
|
35
|
+
|
|
36
|
+
function withWindow(media, fn) {
|
|
37
|
+
const prev = globalThis.window;
|
|
38
|
+
globalThis.window = { matchMedia: () => media.mq };
|
|
39
|
+
try {
|
|
40
|
+
return fn();
|
|
41
|
+
} finally {
|
|
42
|
+
if (prev === undefined) delete globalThis.window;
|
|
43
|
+
else globalThis.window = prev;
|
|
44
|
+
}
|
|
45
|
+
}
|
|
46
|
+
|
|
47
|
+
function makeService() {
|
|
48
|
+
const acquired = [];
|
|
49
|
+
const released = [];
|
|
50
|
+
return {
|
|
51
|
+
acquired,
|
|
52
|
+
released,
|
|
53
|
+
acquire(close) {
|
|
54
|
+
const handle = { release: () => released.push(close) };
|
|
55
|
+
acquired.push({ close, handle });
|
|
56
|
+
return handle;
|
|
57
|
+
},
|
|
58
|
+
};
|
|
59
|
+
}
|
|
60
|
+
|
|
61
|
+
test("desktop does not register; mobile does; release is idempotent", () => {
|
|
62
|
+
const media = makeMedia(false);
|
|
63
|
+
withWindow(media, () => {
|
|
64
|
+
const svc = makeService();
|
|
65
|
+
const release = dismissOnBack(() => svc, () => {});
|
|
66
|
+
assert.equal(svc.acquired.length, 0, "桌面不得注册");
|
|
67
|
+
media.set(true);
|
|
68
|
+
assert.equal(svc.acquired.length, 1, "进小屏自动补注册");
|
|
69
|
+
media.set(false);
|
|
70
|
+
assert.equal(svc.released.length, 1, "回大屏自动释放");
|
|
71
|
+
media.set(true);
|
|
72
|
+
assert.equal(svc.acquired.length, 2, "再进小屏重新注册");
|
|
73
|
+
release();
|
|
74
|
+
assert.equal(svc.released.length, 2);
|
|
75
|
+
release();
|
|
76
|
+
assert.equal(svc.released.length, 2, "release 幂等");
|
|
77
|
+
assert.equal(media.listenerCount(), 0, "release 反注册 matchMedia 监听");
|
|
78
|
+
});
|
|
79
|
+
});
|
|
80
|
+
|
|
81
|
+
test("passes the close callback through to the host service", () => {
|
|
82
|
+
const media = makeMedia(true);
|
|
83
|
+
withWindow(media, () => {
|
|
84
|
+
const svc = makeService();
|
|
85
|
+
let closed = 0;
|
|
86
|
+
dismissOnBack(() => svc, () => { closed += 1; });
|
|
87
|
+
svc.acquired[0].close();
|
|
88
|
+
assert.equal(closed, 1);
|
|
89
|
+
});
|
|
90
|
+
});
|
|
91
|
+
|
|
92
|
+
test("degrades silently when the service is missing or throws", () => {
|
|
93
|
+
const media = makeMedia(true);
|
|
94
|
+
withWindow(media, () => {
|
|
95
|
+
const releaseNull = dismissOnBack(() => null, () => {});
|
|
96
|
+
const releaseUndefined = dismissOnBack(() => undefined, () => {});
|
|
97
|
+
const releaseThrows = dismissOnBack(() => { throw new Error("boom"); }, () => {});
|
|
98
|
+
const releaseBadAcquire = dismissOnBack(() => ({ acquire: null }), () => {});
|
|
99
|
+
const releaseAcquireThrows = dismissOnBack(() => ({ acquire: () => { throw new Error("boom"); } }), () => {});
|
|
100
|
+
for (const release of [releaseNull, releaseUndefined, releaseThrows, releaseBadAcquire, releaseAcquireThrows]) {
|
|
101
|
+
assert.doesNotThrow(release);
|
|
102
|
+
}
|
|
103
|
+
});
|
|
104
|
+
});
|
|
105
|
+
|
|
106
|
+
test("late service is picked up on a later breakpoint re-evaluation", () => {
|
|
107
|
+
const media = makeMedia(true);
|
|
108
|
+
withWindow(media, () => {
|
|
109
|
+
let svc = null;
|
|
110
|
+
const release = dismissOnBack(() => svc, () => {});
|
|
111
|
+
assert.equal(media.listenerCount(), 1);
|
|
112
|
+
svc = makeService();
|
|
113
|
+
media.set(false); // 触发一次重估(服务已上线)
|
|
114
|
+
media.set(true);
|
|
115
|
+
assert.equal(svc.acquired.length, 1, "服务后上线:重估时补注册");
|
|
116
|
+
release();
|
|
117
|
+
assert.equal(svc.released.length, 1);
|
|
118
|
+
});
|
|
119
|
+
});
|
|
120
|
+
|
|
121
|
+
test("mobile query matches the host/float breakpoint", () => {
|
|
122
|
+
assert.equal(OVERLAY_BACK_MOBILE_QUERY, "(max-width: 640px)");
|
|
123
|
+
});
|
|
@@ -0,0 +1,87 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* 扩展端「小屏系统返回关闭浮层」接线(宿主退栈服务 `pi-web.overlayBack` 消费薄封装)。
|
|
3
|
+
*
|
|
4
|
+
* 宿主侧:`pi-web/lib/overlay-back.ts`(历史退栈唯一写入口)+ 客户端服务
|
|
5
|
+
* `ctx.getExtService("pi-web.overlayBack")`。扩展**不要**自己监听 popstate(两套栈会互踩)。
|
|
6
|
+
*
|
|
7
|
+
* 用法(React 扩展,二选一):
|
|
8
|
+
* // ① 组件挂载即弹(确认框/选择器这类面板本身就是 open 态)
|
|
9
|
+
* useEffect(() => dismissOnBack(() => extSvc("pi-web.overlayBack"), onClose), []);
|
|
10
|
+
* // ② 有 open 状态(弹窗常驻渲染 but 条件显示)
|
|
11
|
+
* useEffect(() => (open ? dismissOnBack(() => extSvc("pi-web.overlayBack"), () => close()) : undefined), [open]);
|
|
12
|
+
*
|
|
13
|
+
* 降级:旧宿主 / 服务缺席 / 桌面(>640px,与全仓移动断点一致)/ 非浏览器 → 返回 no-op,
|
|
14
|
+
* 浏览器返回语义不变。是否注册由小屏判定内置,调用方无需自己 matchMedia。
|
|
15
|
+
* 断点动态重估(与 aiti-float back-layer 同款):注册期间跨断点(旋转/拉窗)自动 acquire/release,
|
|
16
|
+
* 不会出现「桌面宽度注册的层残留到窄窗口」或「窄窗口开启的弹窗回宽屏后无返回关闭」。
|
|
17
|
+
* 方案:docs/pi-web-mobile-back-dismiss-coverage-plan.md;契约:docs/aiti-web-ext-float-dialogs.md。
|
|
18
|
+
*/
|
|
19
|
+
export interface OverlayBackHandle {
|
|
20
|
+
release(): void;
|
|
21
|
+
}
|
|
22
|
+
|
|
23
|
+
export interface OverlayBackService {
|
|
24
|
+
acquire(close: () => void): OverlayBackHandle;
|
|
25
|
+
}
|
|
26
|
+
|
|
27
|
+
/** 小屏断点(与宿主 useIsMobile / data-ext-float-full 同款)。 */
|
|
28
|
+
export const OVERLAY_BACK_MOBILE_QUERY = "(max-width: 640px)";
|
|
29
|
+
|
|
30
|
+
/**
|
|
31
|
+
* 注册「系统返回时关闭」层。返回 release(幂等;组件卸载/关闭时调用)。
|
|
32
|
+
* @param getService 取宿主服务(断点重估/重注册时都重新读,兼容懒加载/服务后上线)
|
|
33
|
+
* @param close 返回触发时执行的关闭动作(点 ✕ / 取消 / dismiss 同款)
|
|
34
|
+
*/
|
|
35
|
+
export function dismissOnBack(
|
|
36
|
+
getService: () => OverlayBackService | null | undefined,
|
|
37
|
+
close: () => void,
|
|
38
|
+
): () => void {
|
|
39
|
+
if (typeof window === "undefined" || typeof window.matchMedia !== "function") return () => {};
|
|
40
|
+
const mq = window.matchMedia(OVERLAY_BACK_MOBILE_QUERY);
|
|
41
|
+
let handle: OverlayBackHandle | null = null;
|
|
42
|
+
let released = false;
|
|
43
|
+
const sync = (): void => {
|
|
44
|
+
if (released) return;
|
|
45
|
+
let service: OverlayBackService | null | undefined;
|
|
46
|
+
try {
|
|
47
|
+
service = getService();
|
|
48
|
+
} catch {
|
|
49
|
+
service = null;
|
|
50
|
+
}
|
|
51
|
+
const should = mq.matches && !!service && typeof service.acquire === "function";
|
|
52
|
+
if (should && !handle) {
|
|
53
|
+
try {
|
|
54
|
+
handle = service!.acquire(close);
|
|
55
|
+
} catch {
|
|
56
|
+
handle = null;
|
|
57
|
+
}
|
|
58
|
+
} else if (!should && handle) {
|
|
59
|
+
const prev = handle;
|
|
60
|
+
handle = null;
|
|
61
|
+
try {
|
|
62
|
+
prev.release();
|
|
63
|
+
} catch {
|
|
64
|
+
/* 宿主降级不阻断扩展 */
|
|
65
|
+
}
|
|
66
|
+
}
|
|
67
|
+
};
|
|
68
|
+
sync();
|
|
69
|
+
const onChange = () => sync();
|
|
70
|
+
if (typeof mq.addEventListener === "function") mq.addEventListener("change", onChange);
|
|
71
|
+
else mq.addListener(onChange);
|
|
72
|
+
return () => {
|
|
73
|
+
if (released) return;
|
|
74
|
+
released = true;
|
|
75
|
+
if (typeof mq.removeEventListener === "function") mq.removeEventListener("change", onChange);
|
|
76
|
+
else mq.removeListener(onChange);
|
|
77
|
+
const prev = handle;
|
|
78
|
+
handle = null;
|
|
79
|
+
if (prev) {
|
|
80
|
+
try {
|
|
81
|
+
prev.release();
|
|
82
|
+
} catch {
|
|
83
|
+
/* ignore */
|
|
84
|
+
}
|
|
85
|
+
}
|
|
86
|
+
};
|
|
87
|
+
}
|
package/package.json
CHANGED
|
@@ -1,6 +1,67 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@aiti-ai/ext-shared",
|
|
3
|
-
"version": "0.
|
|
4
|
-
"
|
|
5
|
-
"description": "
|
|
6
|
-
|
|
3
|
+
"version": "0.1.8",
|
|
4
|
+
"type": "module",
|
|
5
|
+
"description": "pi-web 扩展共享层(_shared 原地 package 化)——exports 子路径逐文件暴露",
|
|
6
|
+
"exports": {
|
|
7
|
+
"./agent-accounts": "./agent-accounts.ts",
|
|
8
|
+
"./agent-interaction": "./agent-interaction.ts",
|
|
9
|
+
"./agent-spawn-env": "./agent-spawn-env.ts",
|
|
10
|
+
"./aiti-editor-inject": "./aiti-editor-inject.mjs",
|
|
11
|
+
"./backend-queue": "./backend-queue.ts",
|
|
12
|
+
"./blob-save-route": "./blob-save-route.ts",
|
|
13
|
+
"./cbc-model-catalog": "./cbc-model-catalog.ts",
|
|
14
|
+
"./check-client": "./check-client.mjs",
|
|
15
|
+
"./check-ext-globals": "./check-ext-globals.mjs",
|
|
16
|
+
"./controlled-login": "./controlled-login.mjs",
|
|
17
|
+
"./controlled-login-dialog": "./controlled-login-dialog.mjs",
|
|
18
|
+
"./convert-saveas": "./convert-saveas.ts",
|
|
19
|
+
"./copy-client-bundle": "./copy-client-bundle.mjs",
|
|
20
|
+
"./cursor-cli-store": "./cursor-cli-store.ts",
|
|
21
|
+
"./dedupe-fetch": "./dedupe-fetch.ts",
|
|
22
|
+
"./deploy-commit": "./deploy-commit.mjs",
|
|
23
|
+
"./dev-pack": "./dev-pack.mjs",
|
|
24
|
+
"./dock-icons": "./dock-icons.ts",
|
|
25
|
+
"./esbuild-bin": "./esbuild-bin.ts",
|
|
26
|
+
"./exec-async": "./exec-async.ts",
|
|
27
|
+
"./ext-display-names": "./ext-display-names.ts",
|
|
28
|
+
"./ext-float-dock": "./ext-float-dock.ts",
|
|
29
|
+
"./ext-float-dock-core": "./ext-float-dock-core.ts",
|
|
30
|
+
"./ext-float-dock-lite": "./ext-float-dock-lite.ts",
|
|
31
|
+
"./ext-icons-deploy": "./ext-icons-deploy.mjs",
|
|
32
|
+
"./ext-lazy": "./ext-lazy.tsx",
|
|
33
|
+
"./ext-model-state": "./ext-model-state.ts",
|
|
34
|
+
"./ext-protocol": "./ext-protocol.mjs",
|
|
35
|
+
"./ext-session-usage": "./ext-session-usage.ts",
|
|
36
|
+
"./external-cli-governance": "./external-cli-governance.ts",
|
|
37
|
+
"./host-tools-allow": "./host-tools-allow.ts",
|
|
38
|
+
"./ignore-semantics": "./ignore-semantics.ts",
|
|
39
|
+
"./lazy-loading-metrics": "./lazy-loading-metrics.mjs",
|
|
40
|
+
"./new-session-cwd": "./new-session-cwd.ts",
|
|
41
|
+
"./open-viewer-window": "./open-viewer-window.ts",
|
|
42
|
+
"./overlay-back-client": "./overlay-back-client.ts",
|
|
43
|
+
"./package.json": "./package.json",
|
|
44
|
+
"./popup-anchor": "./popup-anchor.ts",
|
|
45
|
+
"./reconcile-deps": "./reconcile-deps.mjs",
|
|
46
|
+
"./reload-instances": "./reload-instances.mjs",
|
|
47
|
+
"./seed-tool": "./seed-tool.ts",
|
|
48
|
+
"./session-recycle": "./session-recycle.ts",
|
|
49
|
+
"./soffice-locate": "./soffice-locate.ts",
|
|
50
|
+
"./soffice-panel": "./soffice-panel.ts",
|
|
51
|
+
"./sync-dir": "./sync-dir.mjs",
|
|
52
|
+
"./task-list": "./task-list.ts",
|
|
53
|
+
"./ui-dialogs": "./ui-dialogs.ts"
|
|
54
|
+
},
|
|
55
|
+
"license": "MIT",
|
|
56
|
+
"aitiExtProtocol": "1.0",
|
|
57
|
+
"contentHash": "98e4559181401cb6",
|
|
58
|
+
"repository": {
|
|
59
|
+
"type": "git",
|
|
60
|
+
"url": "git+https://github.com/aiti-ai/aiti-ai.git",
|
|
61
|
+
"directory": "extensions/_shared"
|
|
62
|
+
},
|
|
63
|
+
"homepage": "https://github.com/aiti-ai/aiti-ai#readme",
|
|
64
|
+
"bugs": {
|
|
65
|
+
"url": "https://github.com/aiti-ai/aiti-ai/issues"
|
|
66
|
+
}
|
|
67
|
+
}
|
|
@@ -0,0 +1,12 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* pi-fork-rpc — pi 系 fork 家族 RPC spawn 的最小公共层(载体无关)。
|
|
3
|
+
*
|
|
4
|
+
* 拆分背景(docs/aiti-pi-agent-split-plan.md):aiti-pi-agent 曾用一份 PiForkSpec
|
|
5
|
+
* 参数化同时承载 pi / omp 两个后端,差异已大到「共享抽象反而耦合」——拆成两个独立
|
|
6
|
+
* 扩展后,本层只保留「线协议解析 + CLI 解析 + spawn env + 家族类型」,不含任何 fork
|
|
7
|
+
* 语义(命令映射 / 能力面 / 生命周期收口由各扩展自己的 handle 实现负责)。
|
|
8
|
+
*
|
|
9
|
+
* 权威源在本目录(git 管理);消费扩展(aiti-pi-agent / aiti-omp-agent)以**副本**
|
|
10
|
+
* 形式携带(fork-rpc/ 子目录,deploy 时随扩展拷入部署目录;同步见 scripts/sync-pi-fork-rpc.mjs)。
|
|
11
|
+
* 本层无宿主依赖(不 import pi-web lib),可被 node:test 直载(--experimental-strip-types)。
|
|
12
|
+
*/
|
|
@@ -0,0 +1,42 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* cli-resolve.test — 共享层 which()/isExecutableFile 行为测试(加固 P2-10 回归)。
|
|
3
|
+
* which 现要求:候选是文件(目录不算)+ POSIX 可执行位 + Windows PATHEXT(本机 Linux 只测 POSIX 面)。
|
|
4
|
+
*/
|
|
5
|
+
|
|
6
|
+
import assert from "node:assert/strict";
|
|
7
|
+
import test from "node:test";
|
|
8
|
+
import { mkdtempSync, mkdirSync, chmodSync, writeFileSync } from "node:fs";
|
|
9
|
+
import { tmpdir } from "node:os";
|
|
10
|
+
import { join } from "node:path";
|
|
11
|
+
import { which } from "./cli-resolve.ts";
|
|
12
|
+
|
|
13
|
+
function withPath(dirs, fn) {
|
|
14
|
+
const saved = process.env.PATH;
|
|
15
|
+
try {
|
|
16
|
+
process.env.PATH = dirs.join(":");
|
|
17
|
+
return fn();
|
|
18
|
+
} finally {
|
|
19
|
+
process.env.PATH = saved;
|
|
20
|
+
}
|
|
21
|
+
}
|
|
22
|
+
|
|
23
|
+
test("which:PATH 上的可执行文件命中", () => {
|
|
24
|
+
const dir = mkdtempSync(join(tmpdir(), "forkrpc-which-"));
|
|
25
|
+
const bin = join(dir, "fakeforkbin");
|
|
26
|
+
writeFileSync(bin, "#!/bin/sh\n");
|
|
27
|
+
chmodSync(bin, 0o755);
|
|
28
|
+
withPath([dir], () => assert.equal(which("fakeforkbin"), bin));
|
|
29
|
+
});
|
|
30
|
+
|
|
31
|
+
test("which:无可执行位/目录同名/PATH 外 均不命中", () => {
|
|
32
|
+
const dir = mkdtempSync(join(tmpdir(), "forkrpc-which-"));
|
|
33
|
+
const noexec = join(dir, "fakeforkbin2");
|
|
34
|
+
writeFileSync(noexec, "#!/bin/sh\n");
|
|
35
|
+
chmodSync(noexec, 0o644);
|
|
36
|
+
mkdirSync(join(dir, "fakeforkdir"));
|
|
37
|
+
withPath([dir], () => {
|
|
38
|
+
if (process.platform !== "win32") assert.equal(which("fakeforkbin2"), undefined, "644 文件不算可执行(POSIX 可执行位语义;win32 可执行性按扩展名,644 无意义)");
|
|
39
|
+
assert.equal(which("fakeforkdir"), undefined, "目录不算可执行候选");
|
|
40
|
+
assert.equal(which("totally-absent-bin"), undefined);
|
|
41
|
+
});
|
|
42
|
+
});
|