mu-agent-bridge 1.0.73 → 1.0.78

package/plugins/workbuddy/dist/src-ts/plugins/workbuddy/index.js

@@ -17,7 +17,7 @@ const session_history_1 = require("./session-history");
 const desktop_launch_1 = require("../desktop-launch");
 const desktop_launch_2 = require("./desktop-launch");
 exports.workbuddyManifest = {
-    id: "workbuddy", version: "1.1.34", displayName: "WorkBuddy", type: "agent",
+    id: "workbuddy", version: "1.1.35", displayName: "WorkBuddy", type: "agent",
     entry: "dist/index.js", apiVersion: "1", process: "in-process",
     capabilities: ["chat", "health", "model-provider"], configSchema: "config.schema.json",
 };
@@ -52,7 +52,8 @@ class WorkbuddyPlugin {
     cliPath;
     model;
     transport = "auto";
-    timeoutMs = 3_600_000;
+    replyTimeoutLimitMs;
+    timeoutMs = cdp_client_1.WORKBUDDY_MAX_WAIT_MS;
     queue = Promise.resolve();
     pending = 0;
     activeSessionId;
@@ -76,6 +77,7 @@ class WorkbuddyPlugin {
     sessionHistory;
     constructor(options = {}) {
         this.options = options;
+        this.replyTimeoutLimitMs = options.replyTimeoutLimitMs ?? cdp_client_1.WORKBUDDY_MAX_WAIT_MS;
     }
     get attachmentInput() { return Boolean(this.client?.attachmentInput && this.client.complete && this.transport !== "cli" && (!this.cliPath || this.transport === "cdp")); }
     async activate(context) {
@@ -83,7 +85,7 @@ class WorkbuddyPlugin {
         if (config.transport !== undefined && !["auto", "cli", "cdp"].includes(String(config.transport)))
             throw new Error("transport 只能是 auto、cli 或 cdp");
         this.transport = config.transport ?? "auto";
-        this.timeoutMs = typeof config.timeoutMs === "number" && config.timeoutMs > 0 ? config.timeoutMs : 3_600_000;
+        this.timeoutMs = Math.min(typeof config.timeoutMs === "number" && config.timeoutMs > 0 ? config.timeoutMs : 3_600_000, this.replyTimeoutLimitMs);
         this.model = typeof config.model === "string" && config.model.trim() ? config.model : undefined;
         this.cliPath = (0, cli_client_1.findCli)(typeof config.cliPath === "string" ? config.cliPath : undefined);
         this.failure = undefined;
@@ -237,18 +239,23 @@ class WorkbuddyPlugin {
             return { status: "ready", details: { transport: "cdp" } };
         if (this.transport !== "cdp" && this.cliPath && (0, node_fs_1.existsSync)(this.cliPath))
             return { status: "ready", details: { transport: "cli" } };
-        return { status: "failed", message: this.failure ?? "WorkBuddy 未连接", details: { transport: this.transport } };
+        return { status: "failed", message: this.failure ?? "WorkBuddy CDP 未连接；桌面升级后请在后台使用“重启桌面”恢复连接", details: { transport: this.transport } };
     }
     async handle(request) {
         if (!request.task.trim())
             throw new Error("消息内容不能为空");
         (0, attachments_1.validateAttachments)(request.attachments);
         const run = this.enqueue(async () => {
+            request.signal?.throwIfAborted();
             try {
-                return await this.complete(request);
-            }
-            finally {
+                const response = await this.complete(request);
                 await this.synchronizeSession();
+                return response;
+            }
+            catch (error) {
+                // 失败时桌面可能已切换，保留原绑定并要求重新校验或恢复。
+                this.desktopSessionValid = false;
+                throw error;
             }
         });
         const response = await run;
@@ -257,7 +264,12 @@ class WorkbuddyPlugin {
     async synchronizeSession() {
         if (this.activeSessionId && this.desktopSessionValid && this.client?.conversationId) {
             try {
-                this.activeDesktopConversationId = await this.client.conversationId();
+                const conversationId = await this.client.conversationId();
+                if (this.activeDesktopConversationId && conversationId !== this.activeDesktopConversationId) {
+                    this.desktopSessionValid = false;
+                    throw new Error("WorkBuddy 桌面任务已切换，已保留原会话绑定");
+                }
+                this.activeDesktopConversationId = conversationId;
                 if (this.activeDesktopConversationId)
                     this.sessionBindings.set(this.activeSessionId, { conversationId: this.activeDesktopConversationId, expert: this.activeExpert });
                 await this.persistKnownSessions();
@@ -337,8 +349,8 @@ class WorkbuddyPlugin {
     async complete(request, modelRequest = false) {
         let stage = "连接 WorkBuddy 桌面";
         try {
-            const timeout = request.timeoutMs ?? this.timeoutMs;
-            const expert = modelRequest ? undefined : extractExpertQuery(request.task);
+            const timeout = Math.min(request.timeoutMs ?? this.timeoutMs, this.replyTimeoutLimitMs);
+            const expert = modelRequest || this.options.expertSelection === false ? undefined : extractExpertQuery(request.task);
             const usesCli = Boolean(this.cliPath && this.transport !== "cdp" && !expert);
             const hasAttachments = Array.isArray(request.attachments) && request.attachments.length > 0;
             if (hasAttachments && !this.attachmentInput)
@@ -372,7 +384,7 @@ class WorkbuddyPlugin {
                 this.expertSession = true;
                 try {
                     if (this.client.complete)
-                        return await this.client.complete({ ...request, timeoutMs: timeout }, select, false);
+                        return await this.client.complete({ ...request, timeoutMs: timeout }, select, false, request.sessionId ? this.activeDesktopConversationId ?? null : undefined);
                     return { text: await this.client.direct(request.task, timeout, select) };
                 }
                 catch (error) {
@@ -392,7 +404,7 @@ class WorkbuddyPlugin {
                 this.activeExpert = null;
             try {
                 if (this.client.complete)
-                    return await this.client.complete({ ...request, timeoutMs: timeout }, undefined, reset);
+                    return await this.client.complete({ ...request, timeoutMs: timeout }, undefined, reset, request.sessionId ? this.activeDesktopConversationId ?? null : undefined);
                 return { text: await this.client.direct(request.task, timeout, undefined, reset) };
             }
             catch (error) {

package/plugins/workbuddy/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agent-bridge-workbuddy",
-  "version": "1.1.34",
+  "version": "1.1.35",
   "description": "mu-agent-bridge 的 WorkBuddy 桌面端插件。",
   "keywords": [
     "mu-agent-bridge-plugin",

package/plugins/workbuddy/plugin.json

@@ -1,6 +1,6 @@
 {
   "id": "workbuddy",
-  "version": "1.1.34",
+  "version": "1.1.35",
   "type": "agent",
   "displayName": "WorkBuddy",
   "entry": "dist/src-ts/plugins/workbuddy/index.js",

package/plugins/zcode/config.schema.json

@@ -0,0 +1,13 @@
+{
+  "type": "object",
+  "properties": {
+    "aid": { "type": "string", "description": "关联的 AID" },
+    "autoStart": { "type": "boolean", "default": true, "description": "CDP 端口拒绝连接时自动发现并启动 ZCode" },
+    "executablePath": { "type": "string", "description": "可选的 ZCode.exe 路径，留空时从注册表、开始菜单和安装目录自动发现" },
+    "startupArgs": { "type": "array", "items": { "type": "string" }, "default": [], "description": "附加启动参数；CDP 地址和端口由插件自动传入" },
+    "startupTimeoutMs": { "type": "integer", "minimum": 1, "default": 30000, "description": "启动后等待 CDP 就绪的时间（毫秒）" },
+    "cdpPort": { "type": "integer", "minimum": 1, "maximum": 65535, "default": 9231, "description": "ZCode CDP 端口" },
+    "timeoutMs": { "type": "integer", "minimum": 1, "default": 3600000, "description": "单次回复等待时间（毫秒）" }
+  },
+  "additionalProperties": false
+}

package/plugins/zcode/dist/src-ts/agent.js

@@ -0,0 +1,69 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AgentOperationError = exports.AgentError = void 0;
+exports.abortable = abortable;
+exports.errorDetails = errorDetails;
+async function abortable(promise, signal) {
+    if (!signal)
+        return promise;
+    if (signal.aborted) {
+        // promise 已在调用方启动，先观察其拒绝，避免预取消时产生未处理拒绝。
+        void promise.catch(() => undefined);
+        signal.throwIfAborted();
+    }
+    return new Promise((resolve, reject) => {
+        let settled = false;
+        const cleanup = () => signal.removeEventListener("abort", abort);
+        const abort = () => {
+            if (settled)
+                return;
+            settled = true;
+            cleanup();
+            reject(signal.reason);
+        };
+        signal.addEventListener("abort", abort, { once: true });
+        promise.then((value) => {
+            if (settled)
+                return;
+            settled = true;
+            cleanup();
+            resolve(value);
+        }, (error) => {
+            if (settled)
+                return;
+            settled = true;
+            cleanup();
+            reject(error);
+        });
+    });
+}
+class AgentError extends Error {
+    constructor(message, options) {
+        super(message, options);
+        this.name = "AgentError";
+    }
+}
+exports.AgentError = AgentError;
+/** 保留底层错误码，避免只留下 fetch failed 或超时这类表层提示。 */
+function errorDetails(error) {
+    const parts = [];
+    const seen = new Set();
+    for (let current = error; current && !seen.has(current) && seen.size < 5;) {
+        seen.add(current);
+        const value = current;
+        const message = typeof value.message === "string" ? value.message : String(current);
+        parts.push(`${message}${value.code ? `（${String(value.code)}）` : ""}`);
+        current = value.cause;
+    }
+    return parts.join("；原因：") || String(error);
+}
+class AgentOperationError extends AgentError {
+    code;
+    stage;
+    constructor(code, stage, cause) {
+        super(`${code}：${stage}失败：${errorDetails(cause)}`, { cause });
+        this.code = code;
+        this.stage = stage;
+    }
+}
+exports.AgentOperationError = AgentOperationError;

package/plugins/zcode/dist/src-ts/attachments.js

@@ -0,0 +1,62 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MAX_TOTAL_ATTACHMENT_BYTES = exports.MAX_ATTACHMENTS = exports.MAX_ATTACHMENT_BYTES = void 0;
+exports.detectImageContentType = detectImageContentType;
+exports.attachmentFilename = attachmentFilename;
+exports.validateAttachment = validateAttachment;
+exports.validateAttachments = validateAttachments;
+exports.asAttachments = asAttachments;
+exports.MAX_ATTACHMENT_BYTES = 32 * 1024 * 1024;
+exports.MAX_ATTACHMENTS = 8;
+exports.MAX_TOTAL_ATTACHMENT_BYTES = 64 * 1024 * 1024;
+function detectImageContentType(data) {
+    if (data.length >= 8 && data.slice(0, 8).every((value, index) => value === [137, 80, 78, 71, 13, 10, 26, 10][index]))
+        return "image/png";
+    if (data.length >= 3 && data[0] === 0xff && data[1] === 0xd8 && data[2] === 0xff)
+        return "image/jpeg";
+    if (data.length >= 12 && String.fromCharCode(...data.slice(0, 4)) === "RIFF" && String.fromCharCode(...data.slice(8, 12)) === "WEBP")
+        return "image/webp";
+    return undefined;
+}
+function attachmentFilename(filename) {
+    if (typeof filename !== "string" || /[\u0000-\u001f\u007f]/.test(filename))
+        throw new Error("附件文件名无效");
+    const name = filename.split(/[\\/]/).pop() ?? "";
+    if (!name.trim() || name === "." || name === "..")
+        throw new Error("附件文件名无效");
+    return name;
+}
+function validateAttachment(item) {
+    if (!item || !(item.data instanceof Uint8Array) || item.data.byteLength === 0)
+        throw new Error("附件内容不能为空");
+    if (item.data.byteLength > exports.MAX_ATTACHMENT_BYTES)
+        throw new Error("单个附件不能超过 32 MiB");
+    attachmentFilename(item.filename);
+    if (item.kind !== "image" && item.kind !== "file")
+        throw new Error("附件类型无效");
+    if (typeof item.contentType !== "string" || !/^[A-Za-z0-9!#$&^_.+-]+\/[A-Za-z0-9!#$&^_.+-]+$/.test(item.contentType))
+        throw new Error("附件 MIME 类型无效");
+    if (item.kind === "image") {
+        const detected = detectImageContentType(item.data);
+        if (!detected || detected !== item.contentType.toLowerCase())
+            throw new Error("图片内容与 MIME 类型不一致");
+    }
+}
+function validateAttachments(items) {
+    if (!items)
+        return;
+    if (!Array.isArray(items))
+        throw new Error("附件列表无效");
+    if (items.length > exports.MAX_ATTACHMENTS)
+        throw new Error("单条消息最多包含 8 个附件");
+    let total = 0;
+    for (const item of items) {
+        validateAttachment(item);
+        total += item.data.byteLength;
+    }
+    if (total > exports.MAX_TOTAL_ATTACHMENT_BYTES)
+        throw new Error("单条消息附件总大小不能超过 64 MiB");
+}
+function asAttachments(images) {
+    return (images ?? []).map((image) => ({ ...image, kind: "image" }));
+}

package/plugins/zcode/dist/src-ts/plugin.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveRuntimePort = resolveRuntimePort;
+function resolveRuntimePort(config, runtime, pluginId, envName, fallback) {
+    const injected = runtime?.ports?.[pluginId];
+    if (typeof injected === "number" && Number.isInteger(injected) && injected > 0)
+        return injected;
+    const configured = config.cdpPort;
+    if (typeof configured === "number" && Number.isInteger(configured) && configured > 0)
+        return configured;
+    const environment = Number(process.env[envName] ?? "");
+    return Number.isInteger(environment) && environment > 0 ? environment : fallback;
+}

package/plugins/zcode/dist/src-ts/plugins/desktop-launch.js

@@ -0,0 +1,238 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.findWindowsExecutable = findWindowsExecutable;
+exports.findExecutableInTree = findExecutableInTree;
+exports.launchAndWait = launchAndWait;
+exports.launchManagedAndWait = launchManagedAndWait;
+exports.restartOwnedAndWait = restartOwnedAndWait;
+exports.terminateWindowsDesktop = terminateWindowsDesktop;
+exports.terminateOwnedProcess = terminateOwnedProcess;
+exports.findChatgptExecutable = findChatgptExecutable;
+exports.waitFor = waitFor;
+const node_child_process_1 = require("node:child_process");
+const promises_1 = require("node:fs/promises");
+const node_fs_1 = require("node:fs");
+const node_path_1 = require("node:path");
+const node_util_1 = require("node:util");
+const execFileAsync = (0, node_util_1.promisify)(node_child_process_1.execFile);
+const versionDirectory = /^(?:app[-_ ]?)?v?\d+(?:[.-]\d+)+$/i;
+/** 先从 Windows 注册信息和开始菜单解析，失败时再查常见安装目录。 */
+async function findWindowsExecutable(fileName, configured, run = execFileAsync) {
+    if (configured?.trim()) {
+        const configuredPath = (0, node_path_1.resolve)(configured);
+        if (fileName.toLowerCase() === "doubao.exe") {
+            let root = (0, node_path_1.dirname)(configuredPath);
+            while (/^(?:app|launcher|doubao_update)$/i.test((0, node_path_1.basename)(root)) || versionDirectory.test((0, node_path_1.basename)(root)))
+                root = (0, node_path_1.dirname)(root);
+            const updated = (0, node_path_1.join)(root, "Doubao_update", fileName);
+            if ((0, node_fs_1.existsSync)(updated))
+                return updated;
+            const latest = await findExecutableInTree(root, fileName, /^/, 3);
+            if (latest)
+                return latest;
+        }
+        // 千问升级会保留或删除旧版本目录，从同一安装位置重新定位新版。
+        if (fileName.toLowerCase() === "qwenworkcn.exe" && /^v?\d+(?:[.-]\d+)+$/i.test((0, node_path_1.basename)((0, node_path_1.dirname)(configuredPath)))) {
+            const latest = await findExecutableInTree((0, node_path_1.dirname)((0, node_path_1.dirname)(configuredPath)), fileName, /^/, 1);
+            if (latest)
+                return latest;
+        }
+        if ((0, node_fs_1.existsSync)(configuredPath))
+            return configuredPath;
+    }
+    if (process.platform !== "win32")
+        return undefined;
+    const registered = await findRegisteredWindowsExecutable(fileName, run);
+    if (registered)
+        return registered;
+    const pattern = /doubao|豆包|qwen|qwwork|千问|deepseek|harness|dsh|zcode/i;
+    const roots = [...new Set([
+            process.env.DSH_INSTALL_DIR,
+            "D:\\Programs\\DeepSeek Harness",
+            "D:\\DSH",
+            process.env.LOCALAPPDATA && (0, node_path_1.join)(process.env.LOCALAPPDATA, "Programs"),
+            process.env.LOCALAPPDATA,
+            process.env.ProgramFiles,
+            process.env["ProgramFiles(x86)"],
+            ...Array.from({ length: 24 }, (_, index) => `${String.fromCharCode(67 + index)}:\\`),
+        ].filter((value) => typeof value === "string" && (0, node_fs_1.existsSync)(value)))];
+    for (const root of roots) {
+        const found = await findExecutableInTree(root, fileName, pattern, 6);
+        if (found)
+            return found;
+    }
+    return undefined;
+}
+async function findRegisteredWindowsExecutable(fileName, run) {
+    const target = fileName.replace(/'/g, "''");
+    const script = `$ErrorActionPreference='SilentlyContinue';[Console]::OutputEncoding=[Text.Encoding]::UTF8;$target='${target}'
+function Emit-Path($value){if(-not $value){return};$value=[Environment]::ExpandEnvironmentVariables(([string]$value).Trim());if($value.StartsWith('"')){$end=$value.IndexOf('"',1);if($end -gt 1){$value=$value.Substring(1,$end-1)}}elseif($value -match '^(\S+?\.exe)(?:\s|$)'){$value=$Matches[1]};if($value -match '(?i)\.exe$'){[Console]::WriteLine($value)}}
+$keys=@("HKCU:\\Software\\Microsoft\\Windows\\CurrentVersion\\App Paths\\$target","HKLM:\\Software\\Microsoft\\Windows\\CurrentVersion\\App Paths\\$target","HKLM:\\Software\\WOW6432Node\\Microsoft\\Windows\\CurrentVersion\\App Paths\\$target","HKCU:\\Software\\Classes\\Applications\\$target\\shell\\open\\command","HKLM:\\Software\\Classes\\Applications\\$target\\shell\\open\\command")
+foreach($key in $keys){$item=Get-Item $key -ErrorAction SilentlyContinue;if($item){Emit-Path $item.GetValue('')}}
+$dirs=@();if($env:APPDATA){$dirs+=[IO.Path]::Combine($env:APPDATA,'Microsoft\\Windows\\Start Menu\\Programs')};if($env:ProgramData){$dirs+=[IO.Path]::Combine($env:ProgramData,'Microsoft\\Windows\\Start Menu\\Programs')};$shell=New-Object -ComObject WScript.Shell
+foreach($dir in $dirs){Get-ChildItem $dir -Filter '*.lnk' -File -Recurse -ErrorAction SilentlyContinue|ForEach-Object{$link=$shell.CreateShortcut($_.FullName);if($link.TargetPath -and [IO.Path]::GetFileName($link.TargetPath) -ieq $target){Emit-Path $link.TargetPath}}}`;
+    try {
+        const { stdout } = await run("powershell.exe", ["-NoProfile", "-NonInteractive", "-EncodedCommand", Buffer.from(script, "utf16le").toString("base64")], { timeout: 10_000, windowsHide: true });
+        for (const candidate of stdout.split(/\r?\n/).map(value => value.trim()).filter(Boolean)) {
+            const found = await resolveRegisteredCandidate(fileName, candidate);
+            if (found)
+                return found;
+        }
+    }
+    catch { /* 注册表或开始菜单不可读时继续使用目录兜底 */ }
+    return undefined;
+}
+async function resolveRegisteredCandidate(fileName, candidate) {
+    const candidatePath = (0, node_path_1.resolve)(candidate.replace(/^"|"$/g, ""));
+    if (fileName.toLowerCase() === "doubao.exe" && (0, node_path_1.basename)((0, node_path_1.dirname)(candidatePath)).toLowerCase() === "application") {
+        const client = (0, node_path_1.join)((0, node_path_1.dirname)(candidatePath), "app", fileName);
+        if ((0, node_fs_1.existsSync)(client))
+            return client;
+    }
+    if ((0, node_fs_1.existsSync)(candidatePath) && (0, node_path_1.basename)(candidatePath).toLowerCase() === fileName.toLowerCase())
+        return candidatePath;
+    return findExecutableInTree((0, node_path_1.dirname)(candidatePath), fileName, /^/, 3);
+}
+async function findExecutableInTree(directory, fileName, pattern, depth) {
+    return search(directory, fileName, pattern, depth, pattern.test(directory));
+}
+async function search(directory, fileName, pattern, depth, insideProduct) {
+    try {
+        const entries = await (0, promises_1.readdir)(directory, { withFileTypes: true });
+        // 豆包上层文件是启动器，优先查找新版目录或 app 中的实际程序。
+        if (insideProduct && depth > 0 && fileName.toLowerCase() === "doubao.exe") {
+            const versions = entries.filter(entry => entry.isDirectory() && (versionDirectory.test(entry.name) || /^(?:app|doubao_update)$/i.test(entry.name)));
+            versions.sort((left, right) => {
+                const rank = (name) => /^doubao_update$/i.test(name) ? 2 : /^app$/i.test(name) ? 0 : 1;
+                return rank(right.name) - rank(left.name) || right.name.replace(/^\D+/, "").localeCompare(left.name.replace(/^\D+/, ""), "en", { numeric: true });
+            });
+            for (const entry of versions) {
+                const found = await search((0, node_path_1.join)(directory, entry.name), fileName, pattern, depth - 1, true);
+                if (found)
+                    return found;
+            }
+        }
+        for (const entry of entries)
+            if (entry.isFile() && insideProduct && entry.name.toLowerCase() === fileName.toLowerCase() && !(fileName.toLowerCase() === "doubao.exe" && /^(?:launcher|doubao)$/i.test((0, node_path_1.basename)(directory))))
+                return (0, node_path_1.join)(directory, entry.name);
+        if (depth <= 0)
+            return undefined;
+        // 按数字比较版本目录，避免 1.2.5 排在 1.2.10 之前。
+        entries.sort((left, right) => right.name.localeCompare(left.name, "en", { numeric: true }));
+        for (const entry of entries)
+            if (entry.isDirectory() && !entry.name.startsWith(".") && (insideProduct || pattern.test(entry.name) || /^(?:Program Files(?: \(x86\))?|Programs)$/i.test(entry.name))) {
+                const found = await search((0, node_path_1.join)(directory, entry.name), fileName, pattern, depth - 1, insideProduct || pattern.test(entry.name));
+                if (found)
+                    return found;
+            }
+    }
+    catch { /* 无权限或目录在扫描期间消失时继续查找 */ }
+    return undefined;
+}
+async function launchAndWait(executable, args, connect, timeoutMs, launch = (file, argv) => (0, node_child_process_1.spawn)(file, argv, { detached: true, stdio: "ignore", windowsHide: false })) {
+    const child = launch(executable, args);
+    child.unref();
+    return waitFor(connect, timeoutMs, 250);
+}
+async function launchManagedAndWait(executable, args, profileDirectory, connect, timeoutMs, onProcess, launch = (file, argv) => (0, node_child_process_1.spawn)(file, argv, { detached: true, stdio: "ignore", windowsHide: false })) {
+    if (profileDirectory)
+        await (0, promises_1.mkdir)(profileDirectory, { recursive: true });
+    const child = launch(executable, profileDirectory ? [...args, `--user-data-dir=${profileDirectory}`] : args);
+    // 先等待 spawn，避免异步 error 终止 daemon 或在启动失败后继续轮询。
+    const events = child;
+    const started = typeof events.once === "function" ? new Promise((resolve, reject) => {
+        events.once("error", reject);
+        events.once("spawn", resolve);
+    }) : Promise.resolve();
+    child.unref();
+    onProcess(child);
+    try {
+        await started;
+        return await waitFor(connect, timeoutMs, 250);
+    }
+    catch (error) {
+        await terminateOwnedProcess(child).catch(() => undefined);
+        onProcess(undefined);
+        throw error;
+    }
+}
+async function restartOwnedAndWait(child, executable, args, profileDirectory, connect, timeoutMs, onProcess) {
+    await terminateOwnedProcess(child);
+    onProcess(undefined);
+    return launchManagedAndWait(executable, args, profileDirectory, connect, timeoutMs, onProcess);
+}
+/** 仅在用户确认重启后清理同一用户、同一安装路径的桌面进程。 */
+async function terminateWindowsDesktop(executable) {
+    if (process.platform !== "win32")
+        return [];
+    const script = `
+$ErrorActionPreference = 'Stop'
+$target = '${(0, node_path_1.resolve)(executable).replace(/'/g, "''")}'
+$sid = [Security.Principal.WindowsIdentity]::GetCurrent().User.Value
+$processes = @(Get-CimInstance Win32_Process | Where-Object { $_.ExecutablePath -ieq $target } | Where-Object { (Invoke-CimMethod -InputObject $_ -MethodName GetOwnerSid).Sid -eq $sid })
+$ids = @($processes.ProcessId)
+$roots = @($processes | Where-Object { $ids -notcontains $_.ParentProcessId })
+foreach ($item in $roots) {
+  $current = Get-CimInstance Win32_Process -Filter "ProcessId=$($item.ProcessId)"
+  if (-not $current -or $current.CreationDate -ne $item.CreationDate) { continue }
+  & taskkill.exe /PID $item.ProcessId /T /F | Out-Null
+  if ($LASTEXITCODE -ne 0 -and (Get-Process -Id $item.ProcessId -ErrorAction SilentlyContinue)) { throw "无法结束桌面进程 $($item.ProcessId)" }
+  $remaining = Get-Process -Id $item.ProcessId -ErrorAction SilentlyContinue
+  if ($remaining -and -not $remaining.WaitForExit(10000)) { throw "等待桌面进程退出超时 $($item.ProcessId)" }
+}
+ConvertTo-Json -Compress -InputObject @($roots | ForEach-Object { [int]$_.ProcessId })
+`;
+    const { stdout } = await execFileAsync("powershell.exe", ["-NoProfile", "-NonInteractive", "-EncodedCommand", Buffer.from(script, "utf16le").toString("base64")], { timeout: 30_000, windowsHide: true });
+    return JSON.parse(stdout.trim());
+}
+async function terminateOwnedProcess(child, platform = process.platform, run = async (file, args) => execFileAsync(file, args, { timeout: 10_000 })) {
+    const pid = child?.pid;
+    if (!Number.isSafeInteger(pid) || !pid || child?.exitCode !== null && child?.exitCode !== undefined || child?.signalCode)
+        return;
+    if (platform === "win32") {
+        try {
+            await run("taskkill.exe", ["/PID", String(pid), "/T", "/F"]);
+        }
+        catch (error) {
+            if (!child.exitCode && !child.signalCode && error.code !== "ESRCH")
+                throw error;
+        }
+    }
+    else {
+        try {
+            process.kill(pid, "SIGTERM");
+        }
+        catch (error) {
+            if (error.code !== "ESRCH")
+                throw error;
+        }
+    }
+}
+async function findChatgptExecutable(configured) {
+    if (configured?.trim() && (0, node_fs_1.existsSync)((0, node_path_1.resolve)(configured)))
+        return (0, node_path_1.resolve)(configured);
+    if (process.platform !== "win32")
+        return undefined;
+    const script = "$candidates = foreach ($package in (Get-AppxPackage | Where-Object { $_.Name -like 'OpenAI.Codex*' })) { $appDir = Join-Path $package.InstallLocation 'app'; $path = Join-Path $appDir 'ChatGPT.exe'; if (-not (Test-Path -LiteralPath $path)) { $path = Get-ChildItem -LiteralPath $appDir -Filter 'ChatGPT*.exe' -File -ErrorAction SilentlyContinue | Select-Object -First 1 -ExpandProperty FullName }; if ($path) { [pscustomobject]@{ Version = [version]$package.Version; Executable = $path } } }; $candidate = $candidates | Sort-Object Version -Descending | Select-Object -First 1; if ($candidate) { $candidate.Executable }";
+    try {
+        const { stdout } = await execFileAsync("powershell.exe", ["-NoProfile", "-NonInteractive", "-Command", script], { timeout: 10_000 });
+        return stdout.trim().split(/\r?\n/).at(-1)?.trim() || undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+async function waitFor(action, timeoutMs, intervalMs = 500) {
+    const deadline = Date.now() + timeoutMs;
+    let last;
+    while (Date.now() < deadline) {
+        try {
+            return await action();
+        }
+        catch (error) {
+            last = error;
+            await new Promise((resolve) => setTimeout(resolve, intervalMs));
+        }
+    }
+    throw last instanceof Error ? last : new Error("桌面程序启动超时");
+}