@zqagent/core 0.2.20 → 0.3.6

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.
Files changed (238) hide show
  1. package/README.md +1 -1
  2. package/README.oss.en.md +3 -3
  3. package/README.oss.md +8 -3
  4. package/README.oss.zh-TW.md +3 -3
  5. package/dist/McpClient-CEQBUPuC.d.cts +145 -0
  6. package/dist/McpClient-CEQBUPuC.d.ts +145 -0
  7. package/dist/{ToolRegistry-C3pTFiaJ.d.cts → ToolRegistry-Cy0fQxrb.d.ts} +2 -111
  8. package/dist/{ToolRegistry-C3pTFiaJ.d.ts → ToolRegistry-DouDvn9E.d.cts} +2 -111
  9. package/dist/{explore-RtZtb-V6.d.ts → TurnEngine-BPKhWuSI.d.cts} +108 -73
  10. package/dist/{explore-BgRhj6SP.d.cts → TurnEngine-DtGEuVLT.d.ts} +108 -73
  11. package/dist/conflictGuard-BBOOIxxK.d.cts +42 -0
  12. package/dist/conflictGuard-BBOOIxxK.d.ts +42 -0
  13. package/dist/index.cjs +5418 -1096
  14. package/dist/index.cjs.map +1 -1
  15. package/dist/index.d.cts +577 -195
  16. package/dist/index.d.ts +577 -195
  17. package/dist/index.js +5299 -1011
  18. package/dist/index.js.map +1 -1
  19. package/dist/internal/crypto/secrets.cjs +25 -0
  20. package/dist/internal/crypto/secrets.cjs.map +1 -0
  21. package/dist/internal/crypto/secrets.d.cts +2 -0
  22. package/dist/internal/crypto/secrets.d.ts +2 -0
  23. package/dist/internal/crypto/secrets.js +3 -0
  24. package/dist/internal/crypto/secrets.js.map +1 -0
  25. package/dist/internal/engine/FileLogHook.cjs +179 -0
  26. package/dist/internal/engine/FileLogHook.cjs.map +1 -0
  27. package/dist/internal/engine/FileLogHook.d.cts +67 -0
  28. package/dist/internal/engine/FileLogHook.d.ts +67 -0
  29. package/dist/internal/engine/FileLogHook.js +144 -0
  30. package/dist/internal/engine/FileLogHook.js.map +1 -0
  31. package/dist/internal/engine/approvalView.cjs +25 -0
  32. package/dist/internal/engine/approvalView.cjs.map +1 -0
  33. package/dist/internal/engine/approvalView.d.cts +1 -0
  34. package/dist/internal/engine/approvalView.d.ts +1 -0
  35. package/dist/internal/engine/approvalView.js +3 -0
  36. package/dist/internal/engine/approvalView.js.map +1 -0
  37. package/dist/internal/engine/limits.cjs +59 -0
  38. package/dist/internal/engine/limits.cjs.map +1 -0
  39. package/dist/internal/engine/limits.d.cts +32 -0
  40. package/dist/internal/engine/limits.d.ts +32 -0
  41. package/dist/internal/engine/limits.js +31 -0
  42. package/dist/internal/engine/limits.js.map +1 -0
  43. package/dist/internal/engine/sessionNaming.cjs +47 -0
  44. package/dist/internal/engine/sessionNaming.cjs.map +1 -0
  45. package/dist/internal/engine/sessionNaming.d.cts +25 -0
  46. package/dist/internal/engine/sessionNaming.d.ts +25 -0
  47. package/dist/internal/engine/sessionNaming.js +20 -0
  48. package/dist/internal/engine/sessionNaming.js.map +1 -0
  49. package/dist/internal/llmConfig.cjs +561 -0
  50. package/dist/internal/llmConfig.cjs.map +1 -0
  51. package/dist/internal/llmConfig.d.cts +75 -0
  52. package/dist/internal/llmConfig.d.ts +75 -0
  53. package/dist/internal/llmConfig.js +535 -0
  54. package/dist/internal/llmConfig.js.map +1 -0
  55. package/dist/internal/mcp/builtin/index.cjs +685 -0
  56. package/dist/internal/mcp/builtin/index.cjs.map +1 -0
  57. package/dist/internal/mcp/builtin/index.d.cts +21 -0
  58. package/dist/internal/mcp/builtin/index.d.ts +21 -0
  59. package/dist/internal/mcp/builtin/index.js +652 -0
  60. package/dist/internal/mcp/builtin/index.js.map +1 -0
  61. package/dist/internal/mcp/config.cjs +278 -0
  62. package/dist/internal/mcp/config.cjs.map +1 -0
  63. package/dist/internal/mcp/config.d.cts +61 -0
  64. package/dist/internal/mcp/config.d.ts +61 -0
  65. package/dist/internal/mcp/config.js +235 -0
  66. package/dist/internal/mcp/config.js.map +1 -0
  67. package/dist/internal/mcp/presets.cjs +184 -0
  68. package/dist/internal/mcp/presets.cjs.map +1 -0
  69. package/dist/internal/mcp/presets.d.cts +39 -0
  70. package/dist/internal/mcp/presets.d.ts +39 -0
  71. package/dist/internal/mcp/presets.js +158 -0
  72. package/dist/internal/mcp/presets.js.map +1 -0
  73. package/dist/internal/node-name.cjs +45 -0
  74. package/dist/internal/node-name.cjs.map +1 -0
  75. package/dist/internal/node-name.d.cts +3 -0
  76. package/dist/internal/node-name.d.ts +3 -0
  77. package/dist/internal/node-name.js +10 -0
  78. package/dist/internal/node-name.js.map +1 -0
  79. package/dist/internal/paths.cjs +63 -0
  80. package/dist/internal/paths.cjs.map +1 -0
  81. package/dist/internal/paths.d.cts +17 -0
  82. package/dist/internal/paths.d.ts +17 -0
  83. package/dist/internal/paths.js +25 -0
  84. package/dist/internal/paths.js.map +1 -0
  85. package/dist/internal/providers/diagnostics.cjs +288 -0
  86. package/dist/internal/providers/diagnostics.cjs.map +1 -0
  87. package/dist/internal/providers/diagnostics.d.cts +103 -0
  88. package/dist/internal/providers/diagnostics.d.ts +103 -0
  89. package/dist/internal/providers/diagnostics.js +250 -0
  90. package/dist/internal/providers/diagnostics.js.map +1 -0
  91. package/dist/internal/providers/models.cjs +699 -0
  92. package/dist/internal/providers/models.cjs.map +1 -0
  93. package/dist/internal/providers/models.d.cts +136 -0
  94. package/dist/internal/providers/models.d.ts +136 -0
  95. package/dist/internal/providers/models.js +654 -0
  96. package/dist/internal/providers/models.js.map +1 -0
  97. package/dist/internal/terminal.cjs +161 -0
  98. package/dist/internal/terminal.cjs.map +1 -0
  99. package/dist/internal/terminal.d.cts +58 -0
  100. package/dist/internal/terminal.d.ts +58 -0
  101. package/dist/internal/terminal.js +128 -0
  102. package/dist/internal/terminal.js.map +1 -0
  103. package/dist/internal/tools/execAsync.cjs +187 -0
  104. package/dist/internal/tools/execAsync.cjs.map +1 -0
  105. package/dist/internal/tools/execAsync.d.cts +30 -0
  106. package/dist/internal/tools/execAsync.d.ts +30 -0
  107. package/dist/internal/tools/execAsync.js +162 -0
  108. package/dist/internal/tools/execAsync.js.map +1 -0
  109. package/dist/internal/tools/git.cjs +935 -0
  110. package/dist/internal/tools/git.cjs.map +1 -0
  111. package/dist/internal/tools/git.d.cts +206 -0
  112. package/dist/internal/tools/git.d.ts +206 -0
  113. package/dist/internal/tools/git.js +883 -0
  114. package/dist/internal/tools/git.js.map +1 -0
  115. package/dist/internal/tools/pathSafety.cjs +99 -0
  116. package/dist/internal/tools/pathSafety.cjs.map +1 -0
  117. package/dist/internal/tools/pathSafety.d.cts +44 -0
  118. package/dist/internal/tools/pathSafety.d.ts +44 -0
  119. package/dist/internal/tools/pathSafety.js +61 -0
  120. package/dist/internal/tools/pathSafety.js.map +1 -0
  121. package/dist/internal/tools/plan.cjs +146 -0
  122. package/dist/internal/tools/plan.cjs.map +1 -0
  123. package/dist/internal/tools/plan.d.cts +48 -0
  124. package/dist/internal/tools/plan.d.ts +48 -0
  125. package/dist/internal/tools/plan.js +117 -0
  126. package/dist/internal/tools/plan.js.map +1 -0
  127. package/dist/internal/tools/ripgrep.cjs +118 -0
  128. package/dist/internal/tools/ripgrep.cjs.map +1 -0
  129. package/dist/internal/tools/ripgrep.d.cts +6 -0
  130. package/dist/internal/tools/ripgrep.d.ts +6 -0
  131. package/dist/internal/tools/ripgrep.js +89 -0
  132. package/dist/internal/tools/ripgrep.js.map +1 -0
  133. package/dist/internal/tools/sandbox.cjs +253 -0
  134. package/dist/internal/tools/sandbox.cjs.map +1 -0
  135. package/dist/internal/tools/sandbox.d.cts +67 -0
  136. package/dist/internal/tools/sandbox.d.ts +67 -0
  137. package/dist/internal/tools/sandbox.js +213 -0
  138. package/dist/internal/tools/sandbox.js.map +1 -0
  139. package/dist/internal/tools/shell.cjs +771 -0
  140. package/dist/internal/tools/shell.cjs.map +1 -0
  141. package/dist/internal/tools/shell.d.cts +47 -0
  142. package/dist/internal/tools/shell.d.ts +47 -0
  143. package/dist/internal/tools/shell.js +731 -0
  144. package/dist/internal/tools/shell.js.map +1 -0
  145. package/dist/internal/tools/shellRuntime.cjs +220 -0
  146. package/dist/internal/tools/shellRuntime.cjs.map +1 -0
  147. package/dist/internal/tools/shellRuntime.d.cts +67 -0
  148. package/dist/internal/tools/shellRuntime.d.ts +67 -0
  149. package/dist/internal/tools/shellRuntime.js +181 -0
  150. package/dist/internal/tools/shellRuntime.js.map +1 -0
  151. package/dist/internal/update/controller.cjs +1035 -0
  152. package/dist/internal/update/controller.cjs.map +1 -0
  153. package/dist/internal/update/controller.d.cts +150 -0
  154. package/dist/internal/update/controller.d.ts +150 -0
  155. package/dist/internal/update/controller.js +991 -0
  156. package/dist/internal/update/controller.js.map +1 -0
  157. package/dist/internal/update/platform.cjs +234 -0
  158. package/dist/internal/update/platform.cjs.map +1 -0
  159. package/dist/internal/update/platform.d.cts +77 -0
  160. package/dist/internal/update/platform.d.ts +77 -0
  161. package/dist/internal/update/platform.js +184 -0
  162. package/dist/internal/update/platform.js.map +1 -0
  163. package/dist/tools/ask.d.cts +3 -1
  164. package/dist/tools/ask.d.ts +3 -1
  165. package/dist/tools/diff.cjs +17 -6
  166. package/dist/tools/diff.cjs.map +1 -1
  167. package/dist/tools/diff.d.cts +5 -2
  168. package/dist/tools/diff.d.ts +5 -2
  169. package/dist/tools/diff.js +17 -6
  170. package/dist/tools/diff.js.map +1 -1
  171. package/dist/tools/directories.d.cts +3 -1
  172. package/dist/tools/directories.d.ts +3 -1
  173. package/dist/tools/explore.cjs +1778 -204
  174. package/dist/tools/explore.cjs.map +1 -1
  175. package/dist/tools/explore.d.cts +82 -2
  176. package/dist/tools/explore.d.ts +82 -2
  177. package/dist/tools/explore.js +1780 -204
  178. package/dist/tools/explore.js.map +1 -1
  179. package/dist/tools/files.cjs +56 -21
  180. package/dist/tools/files.cjs.map +1 -1
  181. package/dist/tools/files.d.cts +6 -3
  182. package/dist/tools/files.d.ts +6 -3
  183. package/dist/tools/files.js +56 -21
  184. package/dist/tools/files.js.map +1 -1
  185. package/dist/tools/git.cjs +34 -25
  186. package/dist/tools/git.cjs.map +1 -1
  187. package/dist/tools/git.d.cts +4 -204
  188. package/dist/tools/git.d.ts +4 -204
  189. package/dist/tools/git.js +34 -25
  190. package/dist/tools/git.js.map +1 -1
  191. package/dist/tools/media.cjs +280 -3
  192. package/dist/tools/media.cjs.map +1 -1
  193. package/dist/tools/media.d.cts +3 -1
  194. package/dist/tools/media.d.ts +3 -1
  195. package/dist/tools/media.js +278 -1
  196. package/dist/tools/media.js.map +1 -1
  197. package/dist/tools/plan.cjs +62 -0
  198. package/dist/tools/plan.cjs.map +1 -1
  199. package/dist/tools/plan.d.cts +4 -17
  200. package/dist/tools/plan.d.ts +4 -17
  201. package/dist/tools/plan.js +59 -0
  202. package/dist/tools/plan.js.map +1 -1
  203. package/dist/tools/search.cjs +3 -0
  204. package/dist/tools/search.cjs.map +1 -1
  205. package/dist/tools/search.d.cts +3 -1
  206. package/dist/tools/search.d.ts +3 -1
  207. package/dist/tools/search.js +3 -0
  208. package/dist/tools/search.js.map +1 -1
  209. package/dist/tools/shell.cjs +76 -11
  210. package/dist/tools/shell.cjs.map +1 -1
  211. package/dist/tools/shell.d.cts +5 -39
  212. package/dist/tools/shell.d.ts +5 -39
  213. package/dist/tools/shell.js +75 -11
  214. package/dist/tools/shell.js.map +1 -1
  215. package/dist/tools/todo.d.cts +3 -1
  216. package/dist/tools/todo.d.ts +3 -1
  217. package/dist/tools/web.cjs +279 -5
  218. package/dist/tools/web.cjs.map +1 -1
  219. package/dist/tools/web.d.cts +3 -1
  220. package/dist/tools/web.d.ts +3 -1
  221. package/dist/tools/web.js +275 -3
  222. package/dist/tools/web.js.map +1 -1
  223. package/dist/types-BYyXWWPW.d.cts +237 -0
  224. package/dist/types-BYyXWWPW.d.ts +237 -0
  225. package/package.json +26 -37
  226. package/bin/zqagent +0 -2
  227. package/dist/cli/index.cjs +0 -25218
  228. package/dist/cli/index.cjs.map +0 -1
  229. package/dist/cli/index.d.cts +0 -2
  230. package/dist/cli/index.d.ts +0 -2
  231. package/dist/cli/index.js +0 -25201
  232. package/dist/cli/index.js.map +0 -1
  233. package/dist/server/index.cjs +0 -20510
  234. package/dist/server/index.cjs.map +0 -1
  235. package/dist/server/index.d.cts +0 -2
  236. package/dist/server/index.d.ts +0 -2
  237. package/dist/server/index.js +0 -20493
  238. package/dist/server/index.js.map +0 -1
@@ -0,0 +1,187 @@
1
+ "use strict";
2
+ var __defProp = Object.defineProperty;
3
+ var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
4
+ var __getOwnPropNames = Object.getOwnPropertyNames;
5
+ var __hasOwnProp = Object.prototype.hasOwnProperty;
6
+ var __export = (target, all) => {
7
+ for (var name in all)
8
+ __defProp(target, name, { get: all[name], enumerable: true });
9
+ };
10
+ var __copyProps = (to, from, except, desc) => {
11
+ if (from && typeof from === "object" || typeof from === "function") {
12
+ for (let key of __getOwnPropNames(from))
13
+ if (!__hasOwnProp.call(to, key) && key !== except)
14
+ __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
15
+ }
16
+ return to;
17
+ };
18
+ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
19
+
20
+ // src/tools/execAsync.ts
21
+ var execAsync_exports = {};
22
+ __export(execAsync_exports, {
23
+ execAsync: () => execAsync
24
+ });
25
+ module.exports = __toCommonJS(execAsync_exports);
26
+ var import_node_child_process2 = require("child_process");
27
+
28
+ // src/tools/killTree.ts
29
+ var import_node_child_process = require("child_process");
30
+ function killTree(pid) {
31
+ if (!pid) return;
32
+ if (process.platform === "win32") {
33
+ try {
34
+ (0, import_node_child_process.spawnSync)("taskkill", ["/pid", String(pid), "/T", "/F"], { windowsHide: true });
35
+ } catch {
36
+ }
37
+ return;
38
+ }
39
+ try {
40
+ process.kill(-pid, "SIGKILL");
41
+ } catch {
42
+ try {
43
+ process.kill(pid, "SIGKILL");
44
+ } catch {
45
+ }
46
+ }
47
+ }
48
+
49
+ // src/tools/execAsync.ts
50
+ var liveChildren = /* @__PURE__ */ new Set();
51
+ var exitCleanupInstalled = false;
52
+ function trackChild(pid) {
53
+ if (!pid) return;
54
+ liveChildren.add(pid);
55
+ if (exitCleanupInstalled) return;
56
+ exitCleanupInstalled = true;
57
+ process.once("exit", () => {
58
+ for (const p of liveChildren) killTree(p);
59
+ });
60
+ }
61
+ var DEFAULT_MAX_BUFFER = 1024 * 1024 * 5;
62
+ var KILL_GRACE_MS = 1e3;
63
+ function makeSink(maxBuffer) {
64
+ const chunks = [];
65
+ let len = 0;
66
+ let over = false;
67
+ return {
68
+ push(chunk) {
69
+ if (len >= maxBuffer) {
70
+ over = true;
71
+ return;
72
+ }
73
+ const room = maxBuffer - len;
74
+ if (chunk.length > room) {
75
+ chunks.push(chunk.subarray(0, room));
76
+ len = maxBuffer;
77
+ over = true;
78
+ return;
79
+ }
80
+ chunks.push(chunk);
81
+ len += chunk.length;
82
+ },
83
+ done: () => Buffer.concat(chunks),
84
+ over: () => over
85
+ };
86
+ }
87
+ function execAsync(file, argv, opts = {}) {
88
+ return new Promise((resolve) => {
89
+ const maxBuffer = opts.maxBuffer ?? DEFAULT_MAX_BUFFER;
90
+ const out = makeSink(maxBuffer);
91
+ const err = makeSink(maxBuffer);
92
+ if (opts.signal?.aborted) {
93
+ resolve({
94
+ status: null,
95
+ stdout: Buffer.alloc(0),
96
+ stderr: Buffer.alloc(0),
97
+ timedOut: false,
98
+ truncated: false,
99
+ aborted: true
100
+ });
101
+ return;
102
+ }
103
+ let child;
104
+ try {
105
+ child = (0, import_node_child_process2.spawn)(file, argv, {
106
+ ...opts.cwd !== void 0 ? { cwd: opts.cwd } : {},
107
+ ...opts.env !== void 0 ? { env: opts.env } : {},
108
+ // 自成进程组(POSIX):超时/中断时用 killTree 一次收掉整棵进程树
109
+ detached: process.platform !== "win32",
110
+ stdio: [opts.input === void 0 ? "ignore" : "pipe", "pipe", "pipe"],
111
+ windowsHide: true
112
+ });
113
+ } catch (e) {
114
+ resolve({
115
+ status: null,
116
+ stdout: Buffer.alloc(0),
117
+ stderr: Buffer.alloc(0),
118
+ error: e,
119
+ timedOut: false,
120
+ truncated: false
121
+ });
122
+ return;
123
+ }
124
+ trackChild(child.pid);
125
+ let settled = false;
126
+ let timedOut = false;
127
+ let aborted = false;
128
+ let spawnError;
129
+ let timer = null;
130
+ let graceTimer = null;
131
+ const onAbort = () => {
132
+ aborted = true;
133
+ killAndSettle();
134
+ };
135
+ const finish = (status) => {
136
+ if (settled) return;
137
+ settled = true;
138
+ if (timer) clearTimeout(timer);
139
+ if (graceTimer) clearTimeout(graceTimer);
140
+ if (child.pid !== void 0) liveChildren.delete(child.pid);
141
+ opts.signal?.removeEventListener("abort", onAbort);
142
+ const result = {
143
+ status,
144
+ stdout: out.done(),
145
+ stderr: err.done(),
146
+ timedOut,
147
+ truncated: out.over() || err.over()
148
+ };
149
+ if (aborted) result.aborted = true;
150
+ if (spawnError) result.error = spawnError;
151
+ resolve(result);
152
+ };
153
+ const killAndSettle = () => {
154
+ killTree(child.pid);
155
+ if (settled || graceTimer) return;
156
+ graceTimer = setTimeout(() => {
157
+ child.stdout?.destroy();
158
+ child.stderr?.destroy();
159
+ finish(null);
160
+ }, KILL_GRACE_MS);
161
+ };
162
+ if (opts.timeoutMs !== void 0 && opts.timeoutMs > 0) {
163
+ timer = setTimeout(() => {
164
+ timedOut = true;
165
+ killAndSettle();
166
+ }, opts.timeoutMs);
167
+ }
168
+ opts.signal?.addEventListener("abort", onAbort, { once: true });
169
+ child.stdout?.on("data", (c) => out.push(c));
170
+ child.stderr?.on("data", (c) => err.push(c));
171
+ child.on("error", (e) => {
172
+ spawnError = e;
173
+ if (child.pid === void 0) finish(null);
174
+ });
175
+ if (opts.input !== void 0 && child.stdin) {
176
+ child.stdin.on("error", () => {
177
+ });
178
+ child.stdin.end(opts.input);
179
+ }
180
+ child.on("close", (code) => finish(code));
181
+ });
182
+ }
183
+ // Annotate the CommonJS export names for ESM import in node:
184
+ 0 && (module.exports = {
185
+ execAsync
186
+ });
187
+ //# sourceMappingURL=execAsync.cjs.map
@@ -0,0 +1 @@
1
+ {"version":3,"sources":["../../../src/tools/execAsync.ts","../../../src/tools/killTree.ts"],"sourcesContent":["/**\n * 异步子进程执行(spawnSync 的异步替身)\n *\n * 为什么需要:spawnSync 期间 Node 事件循环被整体阻塞,单进程节点上多个会话\n * 并发跑命令时会互相拖死——一条长命令(run_shell / ffmpeg 可达数百秒)就让\n * server 停止响应,SSE 心跳、HTTP 请求、其他会话的工具调用全部排队。\n * 换成异步 spawn 后,等待子进程的时间可以正常处理事件循环。\n *\n * 与 spawnSync 的差异(异步 spawn 不自带的语义在这里补齐):\n * - 超时:自行计时 + SIGKILL,结果里给出 `timedOut` 布尔\n * (spawnSync 是 ETIMEDOUT 错误码);\n * - 中断:监听 opts.signal,abort 时终止整棵进程树,结果里给出 `aborted` 布尔;\n * - 结算兜底:kill 后若仍有后代持有管道(`close` 不触发),宽限期到点强制结算,\n * 保证 Promise 一定有界,绝不永久挂起;\n * - 输出上限:自行累积 + 截断,结果里给出 `truncated` 布尔\n * (spawnSync 是 ENOBUFS 错误);\n * - stdout/stderr 保留原始 Buffer,交调用方的 decodeOutput 做编码回退。\n *\n * 参数一律用数组传递,不经 shell 解释,保持与原先一致的注入防护。\n */\nimport { spawn } from \"node:child_process\";\nimport { killTree } from \"./killTree.js\";\n\nexport interface ExecAsyncOptions {\n cwd?: string;\n /** 超时毫秒数;到点 SIGKILL 子进程并置 timedOut。不传则不限时 */\n timeoutMs?: number;\n /** stdout / stderr 各自的累积上限(字节);超出部分丢弃并置 truncated */\n maxBuffer?: number;\n env?: NodeJS.ProcessEnv;\n /** 需要向 stdin 写入的内容(如 git apply 的补丁);不传则 stdin 关闭 */\n input?: string;\n /**\n * 中断信号:abort 时终止整棵进程树并置 aborted。\n * 用于把 TurnEngine 的用户中断传导到正在执行的命令。\n */\n signal?: AbortSignal;\n}\n\nexport interface ExecAsyncResult {\n /** 退出码;被信号杀死或启动失败时为 null */\n status: number | null;\n stdout: Buffer;\n stderr: Buffer;\n /** 仅启动失败(命令不存在 ENOENT、无执行权限等)时存在 */\n error?: NodeJS.ErrnoException;\n timedOut: boolean;\n truncated: boolean;\n /** 是否因 signal abort 被终止 */\n aborted?: boolean;\n}\n\n/**\n * 存活的子进程(pid)。子进程以 detached 启动(自成进程组,便于整组终止),\n * 因此终端 Ctrl+C 不再波及它们;进程退出时统一收掉,避免遗留孤儿。\n */\nconst liveChildren = new Set<number>();\nlet exitCleanupInstalled = false;\n\nfunction trackChild(pid: number | undefined): void {\n if (!pid) return;\n liveChildren.add(pid);\n if (exitCleanupInstalled) return;\n exitCleanupInstalled = true;\n process.once(\"exit\", () => {\n for (const p of liveChildren) killTree(p);\n });\n}\n\nconst DEFAULT_MAX_BUFFER = 1024 * 1024 * 5;\n\n/**\n * 终止进程树后等待 stdio 关闭的宽限期(毫秒)。\n *\n * 结算挂在 `close` 上,而 `close` 要求子进程的 stdout/stderr 全部关闭。子进程虽以\n * detached 启动(自成进程组,killTree 的 `-pid` 覆盖整组),但仍有后代存活的可能:\n * detached 未生效、`process.kill(-pid)` 抛错走了只杀直接 pid 的兜底分支、或后代\n * 自行 setsid / 被 reparent 脱离进程组。此时管道写端不关,`close` 永不触发,\n * Promise 永久挂起(会话卡在 running,interrupt 也因等不到安全点而无效)。\n */\nconst KILL_GRACE_MS = 1000;\n\n/** 累积器:到上限后丢弃后续数据,但仍消费流避免子进程写阻塞 */\nfunction makeSink(maxBuffer: number): {\n push: (chunk: Buffer) => void;\n done: () => Buffer;\n over: () => boolean;\n} {\n const chunks: Buffer[] = [];\n let len = 0;\n let over = false;\n return {\n push(chunk: Buffer) {\n if (len >= maxBuffer) {\n over = true;\n return;\n }\n const room = maxBuffer - len;\n if (chunk.length > room) {\n chunks.push(chunk.subarray(0, room));\n len = maxBuffer;\n over = true;\n return;\n }\n chunks.push(chunk);\n len += chunk.length;\n },\n done: () => Buffer.concat(chunks),\n over: () => over,\n };\n}\n\nexport function execAsync(\n file: string,\n argv: string[],\n opts: ExecAsyncOptions = {},\n): Promise<ExecAsyncResult> {\n return new Promise<ExecAsyncResult>((resolve) => {\n const maxBuffer = opts.maxBuffer ?? DEFAULT_MAX_BUFFER;\n const out = makeSink(maxBuffer);\n const err = makeSink(maxBuffer);\n\n // 调用前已被中断:不必启动进程\n if (opts.signal?.aborted) {\n resolve({\n status: null,\n stdout: Buffer.alloc(0),\n stderr: Buffer.alloc(0),\n timedOut: false,\n truncated: false,\n aborted: true,\n });\n return;\n }\n\n let child: ReturnType<typeof spawn>;\n try {\n child = spawn(file, argv, {\n ...(opts.cwd !== undefined ? { cwd: opts.cwd } : {}),\n ...(opts.env !== undefined ? { env: opts.env } : {}),\n // 自成进程组(POSIX):超时/中断时用 killTree 一次收掉整棵进程树\n detached: process.platform !== \"win32\",\n stdio: [opts.input === undefined ? \"ignore\" : \"pipe\", \"pipe\", \"pipe\"],\n windowsHide: true,\n });\n } catch (e) {\n resolve({\n status: null,\n stdout: Buffer.alloc(0),\n stderr: Buffer.alloc(0),\n error: e as NodeJS.ErrnoException,\n timedOut: false,\n truncated: false,\n });\n return;\n }\n\n trackChild(child.pid);\n\n let settled = false;\n let timedOut = false;\n let aborted = false;\n let spawnError: NodeJS.ErrnoException | undefined;\n let timer: ReturnType<typeof setTimeout> | null = null;\n let graceTimer: ReturnType<typeof setTimeout> | null = null;\n\n const onAbort = (): void => {\n aborted = true;\n killAndSettle();\n };\n\n const finish = (status: number | null): void => {\n if (settled) return;\n settled = true;\n if (timer) clearTimeout(timer);\n if (graceTimer) clearTimeout(graceTimer);\n if (child.pid !== undefined) liveChildren.delete(child.pid);\n opts.signal?.removeEventListener(\"abort\", onAbort);\n const result: ExecAsyncResult = {\n status,\n stdout: out.done(),\n stderr: err.done(),\n timedOut,\n truncated: out.over() || err.over(),\n };\n if (aborted) result.aborted = true;\n if (spawnError) result.error = spawnError;\n resolve(result);\n };\n\n /**\n * 终止子进程树,并在宽限期内仍未结算时强制结算。\n *\n * 只调 killTree 是不够的:结算依赖 `close`,而后代存活会让它永不触发\n * (原因见 KILL_GRACE_MS 注释)——本次会话卡死的直接成因。\n */\n const killAndSettle = (): void => {\n killTree(child.pid);\n if (settled || graceTimer) return;\n graceTimer = setTimeout(() => {\n // 输出已随 kill 前的 data 事件收完;这里放下可能仍被后代持有的管道,\n // 结算语义已由 timedOut / aborted 确定,不再继续等待\n child.stdout?.destroy();\n child.stderr?.destroy();\n finish(null);\n }, KILL_GRACE_MS);\n };\n\n if (opts.timeoutMs !== undefined && opts.timeoutMs > 0) {\n timer = setTimeout(() => {\n timedOut = true;\n killAndSettle();\n }, opts.timeoutMs);\n }\n\n opts.signal?.addEventListener(\"abort\", onAbort, { once: true });\n\n child.stdout?.on(\"data\", (c: Buffer) => out.push(c));\n child.stderr?.on(\"data\", (c: Buffer) => err.push(c));\n\n child.on(\"error\", (e) => {\n spawnError = e as NodeJS.ErrnoException;\n // 进程根本没起来时不会有 close 事件,立即结算避免调用方永久挂起\n if (child.pid === undefined) finish(null);\n });\n\n if (opts.input !== undefined && child.stdin) {\n // 子进程可能已退出(EPIPE),忽略写入错误\n child.stdin.on(\"error\", () => {});\n child.stdin.end(opts.input);\n }\n\n child.on(\"close\", (code) => finish(code));\n });\n}\n","/**\n * 终止整棵进程树\n *\n * 前台命令(execAsync 的超时/中断)与后台任务(ShellTaskManager.kill)共用:\n * 只有以 detached 启动的子进程才是进程组组长,负 pid 才能覆盖其派生的孙进程。\n */\nimport { spawnSync } from \"node:child_process\";\n\nexport function killTree(pid: number | undefined): void {\n if (!pid) return;\n if (process.platform === \"win32\") {\n try {\n spawnSync(\"taskkill\", [\"/pid\", String(pid), \"/T\", \"/F\"], { windowsHide: true });\n } catch {\n /* 尽力而为 */\n }\n return;\n }\n // POSIX:detached 启动使子进程成为进程组组长,负 pid 即整组\n try {\n process.kill(-pid, \"SIGKILL\");\n } catch {\n try {\n process.kill(pid, \"SIGKILL\");\n } catch {\n /* 已退出 */\n }\n }\n}\n"],"mappings":"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","names":["import_node_child_process"]}
@@ -0,0 +1,30 @@
1
+ interface ExecAsyncOptions {
2
+ cwd?: string;
3
+ /** 超时毫秒数;到点 SIGKILL 子进程并置 timedOut。不传则不限时 */
4
+ timeoutMs?: number;
5
+ /** stdout / stderr 各自的累积上限(字节);超出部分丢弃并置 truncated */
6
+ maxBuffer?: number;
7
+ env?: NodeJS.ProcessEnv;
8
+ /** 需要向 stdin 写入的内容(如 git apply 的补丁);不传则 stdin 关闭 */
9
+ input?: string;
10
+ /**
11
+ * 中断信号:abort 时终止整棵进程树并置 aborted。
12
+ * 用于把 TurnEngine 的用户中断传导到正在执行的命令。
13
+ */
14
+ signal?: AbortSignal;
15
+ }
16
+ interface ExecAsyncResult {
17
+ /** 退出码;被信号杀死或启动失败时为 null */
18
+ status: number | null;
19
+ stdout: Buffer;
20
+ stderr: Buffer;
21
+ /** 仅启动失败(命令不存在 ENOENT、无执行权限等)时存在 */
22
+ error?: NodeJS.ErrnoException;
23
+ timedOut: boolean;
24
+ truncated: boolean;
25
+ /** 是否因 signal abort 被终止 */
26
+ aborted?: boolean;
27
+ }
28
+ declare function execAsync(file: string, argv: string[], opts?: ExecAsyncOptions): Promise<ExecAsyncResult>;
29
+
30
+ export { type ExecAsyncOptions, type ExecAsyncResult, execAsync };
@@ -0,0 +1,30 @@
1
+ interface ExecAsyncOptions {
2
+ cwd?: string;
3
+ /** 超时毫秒数;到点 SIGKILL 子进程并置 timedOut。不传则不限时 */
4
+ timeoutMs?: number;
5
+ /** stdout / stderr 各自的累积上限(字节);超出部分丢弃并置 truncated */
6
+ maxBuffer?: number;
7
+ env?: NodeJS.ProcessEnv;
8
+ /** 需要向 stdin 写入的内容(如 git apply 的补丁);不传则 stdin 关闭 */
9
+ input?: string;
10
+ /**
11
+ * 中断信号:abort 时终止整棵进程树并置 aborted。
12
+ * 用于把 TurnEngine 的用户中断传导到正在执行的命令。
13
+ */
14
+ signal?: AbortSignal;
15
+ }
16
+ interface ExecAsyncResult {
17
+ /** 退出码;被信号杀死或启动失败时为 null */
18
+ status: number | null;
19
+ stdout: Buffer;
20
+ stderr: Buffer;
21
+ /** 仅启动失败(命令不存在 ENOENT、无执行权限等)时存在 */
22
+ error?: NodeJS.ErrnoException;
23
+ timedOut: boolean;
24
+ truncated: boolean;
25
+ /** 是否因 signal abort 被终止 */
26
+ aborted?: boolean;
27
+ }
28
+ declare function execAsync(file: string, argv: string[], opts?: ExecAsyncOptions): Promise<ExecAsyncResult>;
29
+
30
+ export { type ExecAsyncOptions, type ExecAsyncResult, execAsync };
@@ -0,0 +1,162 @@
1
+ // src/tools/execAsync.ts
2
+ import { spawn } from "child_process";
3
+
4
+ // src/tools/killTree.ts
5
+ import { spawnSync } from "child_process";
6
+ function killTree(pid) {
7
+ if (!pid) return;
8
+ if (process.platform === "win32") {
9
+ try {
10
+ spawnSync("taskkill", ["/pid", String(pid), "/T", "/F"], { windowsHide: true });
11
+ } catch {
12
+ }
13
+ return;
14
+ }
15
+ try {
16
+ process.kill(-pid, "SIGKILL");
17
+ } catch {
18
+ try {
19
+ process.kill(pid, "SIGKILL");
20
+ } catch {
21
+ }
22
+ }
23
+ }
24
+
25
+ // src/tools/execAsync.ts
26
+ var liveChildren = /* @__PURE__ */ new Set();
27
+ var exitCleanupInstalled = false;
28
+ function trackChild(pid) {
29
+ if (!pid) return;
30
+ liveChildren.add(pid);
31
+ if (exitCleanupInstalled) return;
32
+ exitCleanupInstalled = true;
33
+ process.once("exit", () => {
34
+ for (const p of liveChildren) killTree(p);
35
+ });
36
+ }
37
+ var DEFAULT_MAX_BUFFER = 1024 * 1024 * 5;
38
+ var KILL_GRACE_MS = 1e3;
39
+ function makeSink(maxBuffer) {
40
+ const chunks = [];
41
+ let len = 0;
42
+ let over = false;
43
+ return {
44
+ push(chunk) {
45
+ if (len >= maxBuffer) {
46
+ over = true;
47
+ return;
48
+ }
49
+ const room = maxBuffer - len;
50
+ if (chunk.length > room) {
51
+ chunks.push(chunk.subarray(0, room));
52
+ len = maxBuffer;
53
+ over = true;
54
+ return;
55
+ }
56
+ chunks.push(chunk);
57
+ len += chunk.length;
58
+ },
59
+ done: () => Buffer.concat(chunks),
60
+ over: () => over
61
+ };
62
+ }
63
+ function execAsync(file, argv, opts = {}) {
64
+ return new Promise((resolve) => {
65
+ const maxBuffer = opts.maxBuffer ?? DEFAULT_MAX_BUFFER;
66
+ const out = makeSink(maxBuffer);
67
+ const err = makeSink(maxBuffer);
68
+ if (opts.signal?.aborted) {
69
+ resolve({
70
+ status: null,
71
+ stdout: Buffer.alloc(0),
72
+ stderr: Buffer.alloc(0),
73
+ timedOut: false,
74
+ truncated: false,
75
+ aborted: true
76
+ });
77
+ return;
78
+ }
79
+ let child;
80
+ try {
81
+ child = spawn(file, argv, {
82
+ ...opts.cwd !== void 0 ? { cwd: opts.cwd } : {},
83
+ ...opts.env !== void 0 ? { env: opts.env } : {},
84
+ // 自成进程组(POSIX):超时/中断时用 killTree 一次收掉整棵进程树
85
+ detached: process.platform !== "win32",
86
+ stdio: [opts.input === void 0 ? "ignore" : "pipe", "pipe", "pipe"],
87
+ windowsHide: true
88
+ });
89
+ } catch (e) {
90
+ resolve({
91
+ status: null,
92
+ stdout: Buffer.alloc(0),
93
+ stderr: Buffer.alloc(0),
94
+ error: e,
95
+ timedOut: false,
96
+ truncated: false
97
+ });
98
+ return;
99
+ }
100
+ trackChild(child.pid);
101
+ let settled = false;
102
+ let timedOut = false;
103
+ let aborted = false;
104
+ let spawnError;
105
+ let timer = null;
106
+ let graceTimer = null;
107
+ const onAbort = () => {
108
+ aborted = true;
109
+ killAndSettle();
110
+ };
111
+ const finish = (status) => {
112
+ if (settled) return;
113
+ settled = true;
114
+ if (timer) clearTimeout(timer);
115
+ if (graceTimer) clearTimeout(graceTimer);
116
+ if (child.pid !== void 0) liveChildren.delete(child.pid);
117
+ opts.signal?.removeEventListener("abort", onAbort);
118
+ const result = {
119
+ status,
120
+ stdout: out.done(),
121
+ stderr: err.done(),
122
+ timedOut,
123
+ truncated: out.over() || err.over()
124
+ };
125
+ if (aborted) result.aborted = true;
126
+ if (spawnError) result.error = spawnError;
127
+ resolve(result);
128
+ };
129
+ const killAndSettle = () => {
130
+ killTree(child.pid);
131
+ if (settled || graceTimer) return;
132
+ graceTimer = setTimeout(() => {
133
+ child.stdout?.destroy();
134
+ child.stderr?.destroy();
135
+ finish(null);
136
+ }, KILL_GRACE_MS);
137
+ };
138
+ if (opts.timeoutMs !== void 0 && opts.timeoutMs > 0) {
139
+ timer = setTimeout(() => {
140
+ timedOut = true;
141
+ killAndSettle();
142
+ }, opts.timeoutMs);
143
+ }
144
+ opts.signal?.addEventListener("abort", onAbort, { once: true });
145
+ child.stdout?.on("data", (c) => out.push(c));
146
+ child.stderr?.on("data", (c) => err.push(c));
147
+ child.on("error", (e) => {
148
+ spawnError = e;
149
+ if (child.pid === void 0) finish(null);
150
+ });
151
+ if (opts.input !== void 0 && child.stdin) {
152
+ child.stdin.on("error", () => {
153
+ });
154
+ child.stdin.end(opts.input);
155
+ }
156
+ child.on("close", (code) => finish(code));
157
+ });
158
+ }
159
+ export {
160
+ execAsync
161
+ };
162
+ //# sourceMappingURL=execAsync.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"sources":["../../../src/tools/execAsync.ts","../../../src/tools/killTree.ts"],"sourcesContent":["/**\n * 异步子进程执行(spawnSync 的异步替身)\n *\n * 为什么需要:spawnSync 期间 Node 事件循环被整体阻塞,单进程节点上多个会话\n * 并发跑命令时会互相拖死——一条长命令(run_shell / ffmpeg 可达数百秒)就让\n * server 停止响应,SSE 心跳、HTTP 请求、其他会话的工具调用全部排队。\n * 换成异步 spawn 后,等待子进程的时间可以正常处理事件循环。\n *\n * 与 spawnSync 的差异(异步 spawn 不自带的语义在这里补齐):\n * - 超时:自行计时 + SIGKILL,结果里给出 `timedOut` 布尔\n * (spawnSync 是 ETIMEDOUT 错误码);\n * - 中断:监听 opts.signal,abort 时终止整棵进程树,结果里给出 `aborted` 布尔;\n * - 结算兜底:kill 后若仍有后代持有管道(`close` 不触发),宽限期到点强制结算,\n * 保证 Promise 一定有界,绝不永久挂起;\n * - 输出上限:自行累积 + 截断,结果里给出 `truncated` 布尔\n * (spawnSync 是 ENOBUFS 错误);\n * - stdout/stderr 保留原始 Buffer,交调用方的 decodeOutput 做编码回退。\n *\n * 参数一律用数组传递,不经 shell 解释,保持与原先一致的注入防护。\n */\nimport { spawn } from \"node:child_process\";\nimport { killTree } from \"./killTree.js\";\n\nexport interface ExecAsyncOptions {\n cwd?: string;\n /** 超时毫秒数;到点 SIGKILL 子进程并置 timedOut。不传则不限时 */\n timeoutMs?: number;\n /** stdout / stderr 各自的累积上限(字节);超出部分丢弃并置 truncated */\n maxBuffer?: number;\n env?: NodeJS.ProcessEnv;\n /** 需要向 stdin 写入的内容(如 git apply 的补丁);不传则 stdin 关闭 */\n input?: string;\n /**\n * 中断信号:abort 时终止整棵进程树并置 aborted。\n * 用于把 TurnEngine 的用户中断传导到正在执行的命令。\n */\n signal?: AbortSignal;\n}\n\nexport interface ExecAsyncResult {\n /** 退出码;被信号杀死或启动失败时为 null */\n status: number | null;\n stdout: Buffer;\n stderr: Buffer;\n /** 仅启动失败(命令不存在 ENOENT、无执行权限等)时存在 */\n error?: NodeJS.ErrnoException;\n timedOut: boolean;\n truncated: boolean;\n /** 是否因 signal abort 被终止 */\n aborted?: boolean;\n}\n\n/**\n * 存活的子进程(pid)。子进程以 detached 启动(自成进程组,便于整组终止),\n * 因此终端 Ctrl+C 不再波及它们;进程退出时统一收掉,避免遗留孤儿。\n */\nconst liveChildren = new Set<number>();\nlet exitCleanupInstalled = false;\n\nfunction trackChild(pid: number | undefined): void {\n if (!pid) return;\n liveChildren.add(pid);\n if (exitCleanupInstalled) return;\n exitCleanupInstalled = true;\n process.once(\"exit\", () => {\n for (const p of liveChildren) killTree(p);\n });\n}\n\nconst DEFAULT_MAX_BUFFER = 1024 * 1024 * 5;\n\n/**\n * 终止进程树后等待 stdio 关闭的宽限期(毫秒)。\n *\n * 结算挂在 `close` 上,而 `close` 要求子进程的 stdout/stderr 全部关闭。子进程虽以\n * detached 启动(自成进程组,killTree 的 `-pid` 覆盖整组),但仍有后代存活的可能:\n * detached 未生效、`process.kill(-pid)` 抛错走了只杀直接 pid 的兜底分支、或后代\n * 自行 setsid / 被 reparent 脱离进程组。此时管道写端不关,`close` 永不触发,\n * Promise 永久挂起(会话卡在 running,interrupt 也因等不到安全点而无效)。\n */\nconst KILL_GRACE_MS = 1000;\n\n/** 累积器:到上限后丢弃后续数据,但仍消费流避免子进程写阻塞 */\nfunction makeSink(maxBuffer: number): {\n push: (chunk: Buffer) => void;\n done: () => Buffer;\n over: () => boolean;\n} {\n const chunks: Buffer[] = [];\n let len = 0;\n let over = false;\n return {\n push(chunk: Buffer) {\n if (len >= maxBuffer) {\n over = true;\n return;\n }\n const room = maxBuffer - len;\n if (chunk.length > room) {\n chunks.push(chunk.subarray(0, room));\n len = maxBuffer;\n over = true;\n return;\n }\n chunks.push(chunk);\n len += chunk.length;\n },\n done: () => Buffer.concat(chunks),\n over: () => over,\n };\n}\n\nexport function execAsync(\n file: string,\n argv: string[],\n opts: ExecAsyncOptions = {},\n): Promise<ExecAsyncResult> {\n return new Promise<ExecAsyncResult>((resolve) => {\n const maxBuffer = opts.maxBuffer ?? DEFAULT_MAX_BUFFER;\n const out = makeSink(maxBuffer);\n const err = makeSink(maxBuffer);\n\n // 调用前已被中断:不必启动进程\n if (opts.signal?.aborted) {\n resolve({\n status: null,\n stdout: Buffer.alloc(0),\n stderr: Buffer.alloc(0),\n timedOut: false,\n truncated: false,\n aborted: true,\n });\n return;\n }\n\n let child: ReturnType<typeof spawn>;\n try {\n child = spawn(file, argv, {\n ...(opts.cwd !== undefined ? { cwd: opts.cwd } : {}),\n ...(opts.env !== undefined ? { env: opts.env } : {}),\n // 自成进程组(POSIX):超时/中断时用 killTree 一次收掉整棵进程树\n detached: process.platform !== \"win32\",\n stdio: [opts.input === undefined ? \"ignore\" : \"pipe\", \"pipe\", \"pipe\"],\n windowsHide: true,\n });\n } catch (e) {\n resolve({\n status: null,\n stdout: Buffer.alloc(0),\n stderr: Buffer.alloc(0),\n error: e as NodeJS.ErrnoException,\n timedOut: false,\n truncated: false,\n });\n return;\n }\n\n trackChild(child.pid);\n\n let settled = false;\n let timedOut = false;\n let aborted = false;\n let spawnError: NodeJS.ErrnoException | undefined;\n let timer: ReturnType<typeof setTimeout> | null = null;\n let graceTimer: ReturnType<typeof setTimeout> | null = null;\n\n const onAbort = (): void => {\n aborted = true;\n killAndSettle();\n };\n\n const finish = (status: number | null): void => {\n if (settled) return;\n settled = true;\n if (timer) clearTimeout(timer);\n if (graceTimer) clearTimeout(graceTimer);\n if (child.pid !== undefined) liveChildren.delete(child.pid);\n opts.signal?.removeEventListener(\"abort\", onAbort);\n const result: ExecAsyncResult = {\n status,\n stdout: out.done(),\n stderr: err.done(),\n timedOut,\n truncated: out.over() || err.over(),\n };\n if (aborted) result.aborted = true;\n if (spawnError) result.error = spawnError;\n resolve(result);\n };\n\n /**\n * 终止子进程树,并在宽限期内仍未结算时强制结算。\n *\n * 只调 killTree 是不够的:结算依赖 `close`,而后代存活会让它永不触发\n * (原因见 KILL_GRACE_MS 注释)——本次会话卡死的直接成因。\n */\n const killAndSettle = (): void => {\n killTree(child.pid);\n if (settled || graceTimer) return;\n graceTimer = setTimeout(() => {\n // 输出已随 kill 前的 data 事件收完;这里放下可能仍被后代持有的管道,\n // 结算语义已由 timedOut / aborted 确定,不再继续等待\n child.stdout?.destroy();\n child.stderr?.destroy();\n finish(null);\n }, KILL_GRACE_MS);\n };\n\n if (opts.timeoutMs !== undefined && opts.timeoutMs > 0) {\n timer = setTimeout(() => {\n timedOut = true;\n killAndSettle();\n }, opts.timeoutMs);\n }\n\n opts.signal?.addEventListener(\"abort\", onAbort, { once: true });\n\n child.stdout?.on(\"data\", (c: Buffer) => out.push(c));\n child.stderr?.on(\"data\", (c: Buffer) => err.push(c));\n\n child.on(\"error\", (e) => {\n spawnError = e as NodeJS.ErrnoException;\n // 进程根本没起来时不会有 close 事件,立即结算避免调用方永久挂起\n if (child.pid === undefined) finish(null);\n });\n\n if (opts.input !== undefined && child.stdin) {\n // 子进程可能已退出(EPIPE),忽略写入错误\n child.stdin.on(\"error\", () => {});\n child.stdin.end(opts.input);\n }\n\n child.on(\"close\", (code) => finish(code));\n });\n}\n","/**\n * 终止整棵进程树\n *\n * 前台命令(execAsync 的超时/中断)与后台任务(ShellTaskManager.kill)共用:\n * 只有以 detached 启动的子进程才是进程组组长,负 pid 才能覆盖其派生的孙进程。\n */\nimport { spawnSync } from \"node:child_process\";\n\nexport function killTree(pid: number | undefined): void {\n if (!pid) return;\n if (process.platform === \"win32\") {\n try {\n spawnSync(\"taskkill\", [\"/pid\", String(pid), \"/T\", \"/F\"], { windowsHide: true });\n } catch {\n /* 尽力而为 */\n }\n return;\n }\n // POSIX:detached 启动使子进程成为进程组组长,负 pid 即整组\n try {\n process.kill(-pid, \"SIGKILL\");\n } catch {\n try {\n process.kill(pid, \"SIGKILL\");\n } catch {\n /* 已退出 */\n }\n }\n}\n"],"mappings":"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","names":[]}