@waq666/pneuma 0.0.0-stage → 0.7.1

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 (708) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +206 -3
  3. package/bin/dsc.js +91 -0
  4. package/bin/headless.cjs +40 -0
  5. package/lib/adapter/core-runtime.d.ts +11 -0
  6. package/lib/adapter/core-runtime.js +259 -0
  7. package/lib/adapter/host.d.ts +18 -0
  8. package/lib/adapter/host.js +14 -0
  9. package/lib/adapter/runtime.d.ts +15 -0
  10. package/lib/adapter/runtime.js +290 -0
  11. package/lib/adapter/transcript.d.ts +184 -0
  12. package/lib/adapter/transcript.js +605 -0
  13. package/lib/app/AgentsOverlay.d.ts +18 -0
  14. package/lib/app/AgentsOverlay.js +63 -0
  15. package/lib/app/App.d.ts +15 -0
  16. package/lib/app/App.js +1650 -0
  17. package/lib/app/App.js.nv-backup +1650 -0
  18. package/lib/app/ApprovalCard.d.ts +12 -0
  19. package/lib/app/ApprovalCard.js +76 -0
  20. package/lib/app/AskCard.d.ts +20 -0
  21. package/lib/app/AskCard.js +45 -0
  22. package/lib/app/ChatView.d.ts +63 -0
  23. package/lib/app/ChatView.js +310 -0
  24. package/lib/app/Composer.d.ts +50 -0
  25. package/lib/app/Composer.js +282 -0
  26. package/lib/app/DiffBlock.d.ts +6 -0
  27. package/lib/app/DiffBlock.js +37 -0
  28. package/lib/app/MarkdownView.d.ts +6 -0
  29. package/lib/app/MarkdownView.js +99 -0
  30. package/lib/app/ModelPicker.d.ts +7 -0
  31. package/lib/app/ModelPicker.js +18 -0
  32. package/lib/app/PlanReviewCard.d.ts +13 -0
  33. package/lib/app/PlanReviewCard.js +54 -0
  34. package/lib/app/PresetPicker.d.ts +11 -0
  35. package/lib/app/PresetPicker.js +19 -0
  36. package/lib/app/PreviewOverlay.d.ts +14 -0
  37. package/lib/app/PreviewOverlay.js +22 -0
  38. package/lib/app/SessionPicker.d.ts +43 -0
  39. package/lib/app/SessionPicker.js +56 -0
  40. package/lib/app/SettingsOverlay.d.ts +32 -0
  41. package/lib/app/SettingsOverlay.js +157 -0
  42. package/lib/app/SkillsPicker.d.ts +7 -0
  43. package/lib/app/SkillsPicker.js +19 -0
  44. package/lib/app/StatusBar.d.ts +22 -0
  45. package/lib/app/StatusBar.js +201 -0
  46. package/lib/app/TaskStrips.d.ts +13 -0
  47. package/lib/app/TaskStrips.js +40 -0
  48. package/lib/app/TimelineRail.d.ts +22 -0
  49. package/lib/app/TimelineRail.js +160 -0
  50. package/lib/app/TimelineRail.js.negbak +98 -0
  51. package/lib/app/TimelineRail.js.nv-backup +160 -0
  52. package/lib/app/ToolCard.d.ts +11 -0
  53. package/lib/app/ToolCard.js +64 -0
  54. package/lib/app/ToolCard.js.nv-backup +64 -0
  55. package/lib/app/TranscriptOverlay.d.ts +27 -0
  56. package/lib/app/TranscriptOverlay.js +36 -0
  57. package/lib/app/TranscriptViewport.d.ts +78 -0
  58. package/lib/app/TranscriptViewport.js +218 -0
  59. package/lib/app/Welcome.d.ts +6 -0
  60. package/lib/app/Welcome.js +71 -0
  61. package/lib/app/attach.d.ts +16 -0
  62. package/lib/app/attach.js +58 -0
  63. package/lib/app/click.d.ts +40 -0
  64. package/lib/app/click.js +103 -0
  65. package/lib/app/clipboard-image.d.ts +11 -0
  66. package/lib/app/clipboard-image.js +66 -0
  67. package/lib/app/cursor.d.ts +4 -0
  68. package/lib/app/cursor.js +24 -0
  69. package/lib/app/hello.d.ts +11 -0
  70. package/lib/app/hello.js +8 -0
  71. package/lib/app/history-store.d.ts +4 -0
  72. package/lib/app/history-store.js +41 -0
  73. package/lib/app/image-blocks.d.ts +12 -0
  74. package/lib/app/image-blocks.js +125 -0
  75. package/lib/app/keymap.d.ts +56 -0
  76. package/lib/app/keymap.js +56 -0
  77. package/lib/app/markdown.d.ts +54 -0
  78. package/lib/app/markdown.js +189 -0
  79. package/lib/app/mouse.d.ts +33 -0
  80. package/lib/app/mouse.js +35 -0
  81. package/lib/app/pointer.d.ts +16 -0
  82. package/lib/app/pointer.js +60 -0
  83. package/lib/app/scroll-model.d.ts +240 -0
  84. package/lib/app/scroll-model.js +347 -0
  85. package/lib/app/settings-model.d.ts +69 -0
  86. package/lib/app/settings-model.js +114 -0
  87. package/lib/app/snapshot-subscribe.d.ts +34 -0
  88. package/lib/app/snapshot-subscribe.js +110 -0
  89. package/lib/app/theme.d.ts +194 -0
  90. package/lib/app/theme.js +186 -0
  91. package/lib/app/ticker.d.ts +7 -0
  92. package/lib/app/ticker.js +53 -0
  93. package/lib/boot.d.ts +1 -0
  94. package/lib/boot.js +34 -0
  95. package/lib/commands.d.ts +49 -0
  96. package/lib/commands.js +115 -0
  97. package/lib/contract.d.ts +1973 -0
  98. package/lib/contract.js +36 -0
  99. package/lib/core/agent-roles.d.ts +52 -0
  100. package/lib/core/agent-roles.js +274 -0
  101. package/lib/core/approval-floor.d.ts +183 -0
  102. package/lib/core/approval-floor.js +679 -0
  103. package/lib/core/approval.d.ts +42 -0
  104. package/lib/core/approval.js +8 -0
  105. package/lib/core/audit.d.ts +61 -0
  106. package/lib/core/audit.js +59 -0
  107. package/lib/core/boot-notices.d.ts +6 -0
  108. package/lib/core/boot-notices.js +61 -0
  109. package/lib/core/cdp/actions.d.ts +182 -0
  110. package/lib/core/cdp/actions.js +649 -0
  111. package/lib/core/cdp/launch.d.ts +192 -0
  112. package/lib/core/cdp/launch.js +491 -0
  113. package/lib/core/cdp/snapshot.d.ts +139 -0
  114. package/lib/core/cdp/snapshot.js +316 -0
  115. package/lib/core/cdp/transport.d.ts +160 -0
  116. package/lib/core/cdp/transport.js +359 -0
  117. package/lib/core/command-policy.d.ts +108 -0
  118. package/lib/core/command-policy.js +580 -0
  119. package/lib/core/commands-completion.d.ts +78 -0
  120. package/lib/core/commands-completion.js +167 -0
  121. package/lib/core/compact-anchors.d.ts +76 -0
  122. package/lib/core/compact-anchors.js +284 -0
  123. package/lib/core/compact.d.ts +110 -0
  124. package/lib/core/compact.js +210 -0
  125. package/lib/core/config-store.d.ts +38 -0
  126. package/lib/core/config-store.js +307 -0
  127. package/lib/core/config.d.ts +36 -0
  128. package/lib/core/config.js +124 -0
  129. package/lib/core/connection-test.d.ts +60 -0
  130. package/lib/core/connection-test.js +84 -0
  131. package/lib/core/desktop-control.d.ts +298 -0
  132. package/lib/core/desktop-control.js +1311 -0
  133. package/lib/core/diff-text.d.ts +74 -0
  134. package/lib/core/diff-text.js +257 -0
  135. package/lib/core/dock-browser.d.ts +137 -0
  136. package/lib/core/dock-browser.js +146 -0
  137. package/lib/core/dock-ops.d.ts +59 -0
  138. package/lib/core/dock-ops.js +104 -0
  139. package/lib/core/dock-session.d.ts +39 -0
  140. package/lib/core/dock-session.js +28 -0
  141. package/lib/core/dsh-compat/hook.d.ts +18 -0
  142. package/lib/core/dsh-compat/hook.js +52 -0
  143. package/lib/core/dsh-compat/resolve-hook.d.ts +5 -0
  144. package/lib/core/dsh-compat/resolve-hook.js +59 -0
  145. package/lib/core/dsh-compat/tools-facade.d.ts +47 -0
  146. package/lib/core/dsh-compat/tools-facade.js +108 -0
  147. package/lib/core/err-text.d.ts +13 -0
  148. package/lib/core/err-text.js +15 -0
  149. package/lib/core/events.d.ts +149 -0
  150. package/lib/core/events.js +1 -0
  151. package/lib/core/git-exec.d.ts +23 -0
  152. package/lib/core/git-exec.js +72 -0
  153. package/lib/core/git-info.d.ts +47 -0
  154. package/lib/core/git-info.js +157 -0
  155. package/lib/core/goal.d.ts +89 -0
  156. package/lib/core/goal.js +189 -0
  157. package/lib/core/hooks.d.ts +272 -0
  158. package/lib/core/hooks.js +818 -0
  159. package/lib/core/host-browser-link.d.ts +59 -0
  160. package/lib/core/host-browser-link.js +9 -0
  161. package/lib/core/host-methods.d.ts +25 -0
  162. package/lib/core/host-methods.js +103 -0
  163. package/lib/core/image-diet.d.ts +77 -0
  164. package/lib/core/image-diet.js +127 -0
  165. package/lib/core/learnings/ledger.d.ts +73 -0
  166. package/lib/core/learnings/ledger.js +273 -0
  167. package/lib/core/learnings/skill-write.d.ts +250 -0
  168. package/lib/core/learnings/skill-write.js +854 -0
  169. package/lib/core/learnings/store.d.ts +102 -0
  170. package/lib/core/learnings/store.js +266 -0
  171. package/lib/core/lifecycle-hooks.d.ts +189 -0
  172. package/lib/core/lifecycle-hooks.js +576 -0
  173. package/lib/core/llm.d.ts +283 -0
  174. package/lib/core/llm.js +565 -0
  175. package/lib/core/lockfile.d.ts +17 -0
  176. package/lib/core/lockfile.js +110 -0
  177. package/lib/core/loop.d.ts +185 -0
  178. package/lib/core/loop.js +587 -0
  179. package/lib/core/lsp/client.d.ts +189 -0
  180. package/lib/core/lsp/client.js +690 -0
  181. package/lib/core/lsp/framing.d.ts +84 -0
  182. package/lib/core/lsp/framing.js +181 -0
  183. package/lib/core/lsp/line-shift.d.ts +28 -0
  184. package/lib/core/lsp/line-shift.js +127 -0
  185. package/lib/core/lsp/manager.d.ts +93 -0
  186. package/lib/core/lsp/manager.js +418 -0
  187. package/lib/core/lsp/normalize.d.ts +32 -0
  188. package/lib/core/lsp/normalize.js +139 -0
  189. package/lib/core/lsp/servers.d.ts +106 -0
  190. package/lib/core/lsp/servers.js +352 -0
  191. package/lib/core/lsp/uri.d.ts +76 -0
  192. package/lib/core/lsp/uri.js +179 -0
  193. package/lib/core/market.d.ts +51 -0
  194. package/lib/core/market.js +358 -0
  195. package/lib/core/mcp.d.ts +201 -0
  196. package/lib/core/mcp.js +836 -0
  197. package/lib/core/memory-eval.d.ts +158 -0
  198. package/lib/core/memory-eval.js +215 -0
  199. package/lib/core/memory.d.ts +266 -0
  200. package/lib/core/memory.js +703 -0
  201. package/lib/core/mention.d.ts +57 -0
  202. package/lib/core/mention.js +129 -0
  203. package/lib/core/microcompact.d.ts +48 -0
  204. package/lib/core/microcompact.js +79 -0
  205. package/lib/core/migrate.d.ts +56 -0
  206. package/lib/core/migrate.js +134 -0
  207. package/lib/core/model-caps.d.ts +83 -0
  208. package/lib/core/model-caps.js +150 -0
  209. package/lib/core/model-discovery.d.ts +19 -0
  210. package/lib/core/model-discovery.js +69 -0
  211. package/lib/core/modes.d.ts +72 -0
  212. package/lib/core/modes.js +152 -0
  213. package/lib/core/native-bridge.d.ts +135 -0
  214. package/lib/core/native-bridge.js +563 -0
  215. package/lib/core/path-policy.d.ts +32 -0
  216. package/lib/core/path-policy.js +248 -0
  217. package/lib/core/permission-presets.d.ts +67 -0
  218. package/lib/core/permission-presets.js +75 -0
  219. package/lib/core/plugin-loader.d.ts +36 -0
  220. package/lib/core/plugin-loader.js +294 -0
  221. package/lib/core/plugin-registry.d.ts +113 -0
  222. package/lib/core/plugin-registry.js +256 -0
  223. package/lib/core/prefs.d.ts +82 -0
  224. package/lib/core/prefs.js +372 -0
  225. package/lib/core/presets.d.ts +80 -0
  226. package/lib/core/presets.js +373 -0
  227. package/lib/core/pricing.d.ts +90 -0
  228. package/lib/core/pricing.js +126 -0
  229. package/lib/core/prompt.d.ts +92 -0
  230. package/lib/core/prompt.js +339 -0
  231. package/lib/core/ptc.d.ts +66 -0
  232. package/lib/core/ptc.js +70 -0
  233. package/lib/core/remote/frames.d.ts +91 -0
  234. package/lib/core/remote/frames.js +174 -0
  235. package/lib/core/remote/notify.d.ts +54 -0
  236. package/lib/core/remote/notify.js +77 -0
  237. package/lib/core/remote/owner.d.ts +32 -0
  238. package/lib/core/remote/owner.js +75 -0
  239. package/lib/core/remote/pairing.d.ts +104 -0
  240. package/lib/core/remote/pairing.js +261 -0
  241. package/lib/core/remote/push.d.ts +80 -0
  242. package/lib/core/remote/push.js +222 -0
  243. package/lib/core/remote/store.d.ts +18 -0
  244. package/lib/core/remote/store.js +59 -0
  245. package/lib/core/remote/tickets.d.ts +20 -0
  246. package/lib/core/remote/tickets.js +49 -0
  247. package/lib/core/remote/uploads.d.ts +63 -0
  248. package/lib/core/remote/uploads.js +161 -0
  249. package/lib/core/request-attribution.d.ts +26 -0
  250. package/lib/core/request-attribution.js +86 -0
  251. package/lib/core/request-invariant.d.ts +61 -0
  252. package/lib/core/request-invariant.js +199 -0
  253. package/lib/core/sandbox/backends.d.ts +64 -0
  254. package/lib/core/sandbox/backends.js +194 -0
  255. package/lib/core/sandbox/execpolicy.d.ts +93 -0
  256. package/lib/core/sandbox/execpolicy.js +452 -0
  257. package/lib/core/sandbox/net-proxy.d.ts +31 -0
  258. package/lib/core/sandbox/net-proxy.js +162 -0
  259. package/lib/core/sandbox/policy.d.ts +211 -0
  260. package/lib/core/sandbox/policy.js +559 -0
  261. package/lib/core/sandbox/win/abi.d.ts +161 -0
  262. package/lib/core/sandbox/win/abi.js +169 -0
  263. package/lib/core/sandbox/win/account.d.ts +71 -0
  264. package/lib/core/sandbox/win/account.js +206 -0
  265. package/lib/core/sandbox/win/acl.d.ts +54 -0
  266. package/lib/core/sandbox/win/acl.js +339 -0
  267. package/lib/core/sandbox/win/backend.d.ts +61 -0
  268. package/lib/core/sandbox/win/backend.js +249 -0
  269. package/lib/core/sandbox/win/doctor.d.ts +24 -0
  270. package/lib/core/sandbox/win/doctor.js +272 -0
  271. package/lib/core/sandbox/win/ffi.d.ts +107 -0
  272. package/lib/core/sandbox/win/ffi.js +166 -0
  273. package/lib/core/sandbox/win/net-abi.d.ts +154 -0
  274. package/lib/core/sandbox/win/net-abi.js +316 -0
  275. package/lib/core/sandbox/win/runner-entry.d.ts +35 -0
  276. package/lib/core/sandbox/win/runner-entry.js +391 -0
  277. package/lib/core/sandbox/win/setup.d.ts +60 -0
  278. package/lib/core/sandbox/win/setup.js +986 -0
  279. package/lib/core/sandbox/win/token.d.ts +35 -0
  280. package/lib/core/sandbox/win/token.js +238 -0
  281. package/lib/core/sandbox/win/wfp.d.ts +41 -0
  282. package/lib/core/sandbox/win/wfp.js +200 -0
  283. package/lib/core/sandbox/win/workspace-sid.d.ts +9 -0
  284. package/lib/core/sandbox/win/workspace-sid.js +45 -0
  285. package/lib/core/schedule/rule.d.ts +184 -0
  286. package/lib/core/schedule/rule.js +745 -0
  287. package/lib/core/schedule/runner.d.ts +185 -0
  288. package/lib/core/schedule/runner.js +678 -0
  289. package/lib/core/schedule/store.d.ts +182 -0
  290. package/lib/core/schedule/store.js +455 -0
  291. package/lib/core/secrets.d.ts +41 -0
  292. package/lib/core/secrets.js +150 -0
  293. package/lib/core/session-export.d.ts +18 -0
  294. package/lib/core/session-export.js +73 -0
  295. package/lib/core/session-index.d.ts +159 -0
  296. package/lib/core/session-index.js +683 -0
  297. package/lib/core/session-meta.d.ts +41 -0
  298. package/lib/core/session-meta.js +97 -0
  299. package/lib/core/session.d.ts +356 -0
  300. package/lib/core/session.js +998 -0
  301. package/lib/core/skills.d.ts +60 -0
  302. package/lib/core/skills.js +171 -0
  303. package/lib/core/spill.d.ts +159 -0
  304. package/lib/core/spill.js +329 -0
  305. package/lib/core/surface-registry.d.ts +45 -0
  306. package/lib/core/surface-registry.js +67 -0
  307. package/lib/core/team-board.d.ts +95 -0
  308. package/lib/core/team-board.js +316 -0
  309. package/lib/core/throughput.d.ts +46 -0
  310. package/lib/core/throughput.js +40 -0
  311. package/lib/core/todo-reminder.d.ts +44 -0
  312. package/lib/core/todo-reminder.js +55 -0
  313. package/lib/core/todo.d.ts +81 -0
  314. package/lib/core/todo.js +222 -0
  315. package/lib/core/token-estimate.d.ts +55 -0
  316. package/lib/core/token-estimate.js +82 -0
  317. package/lib/core/tool-guards.d.ts +103 -0
  318. package/lib/core/tool-guards.js +77 -0
  319. package/lib/core/tool-search.d.ts +152 -0
  320. package/lib/core/tool-search.js +311 -0
  321. package/lib/core/tools/bash.d.ts +281 -0
  322. package/lib/core/tools/bash.js +871 -0
  323. package/lib/core/tools/command-runner.d.ts +84 -0
  324. package/lib/core/tools/command-runner.js +68 -0
  325. package/lib/core/tools/fs-tools.d.ts +23 -0
  326. package/lib/core/tools/fs-tools.js +247 -0
  327. package/lib/core/tools/index.d.ts +8 -0
  328. package/lib/core/tools/index.js +4 -0
  329. package/lib/core/tools/sandbox-args.d.ts +51 -0
  330. package/lib/core/tools/sandbox-args.js +90 -0
  331. package/lib/core/tools/search-tools.d.ts +3 -0
  332. package/lib/core/tools/search-tools.js +153 -0
  333. package/lib/core/tools.d.ts +96 -0
  334. package/lib/core/tools.js +53 -0
  335. package/lib/core/ui-boot-source.d.ts +71 -0
  336. package/lib/core/ui-boot-source.js +121 -0
  337. package/lib/core/ui-bundles.d.ts +249 -0
  338. package/lib/core/ui-bundles.js +830 -0
  339. package/lib/core/ui-combo.d.ts +49 -0
  340. package/lib/core/ui-combo.js +55 -0
  341. package/lib/core/ui-events.d.ts +81 -0
  342. package/lib/core/ui-events.js +364 -0
  343. package/lib/core/ui-hmr.d.ts +36 -0
  344. package/lib/core/ui-hmr.js +128 -0
  345. package/lib/core/ui-methods.d.ts +69 -0
  346. package/lib/core/ui-methods.js +341 -0
  347. package/lib/core/ui-route.d.ts +69 -0
  348. package/lib/core/ui-route.js +122 -0
  349. package/lib/core/ui-server.d.ts +75 -0
  350. package/lib/core/ui-server.js +369 -0
  351. package/lib/core/ui-trust.d.ts +47 -0
  352. package/lib/core/ui-trust.js +164 -0
  353. package/lib/core/untrusted.d.ts +30 -0
  354. package/lib/core/untrusted.js +48 -0
  355. package/lib/core/update-check.d.ts +81 -0
  356. package/lib/core/update-check.js +177 -0
  357. package/lib/core/usage-log.d.ts +82 -0
  358. package/lib/core/usage-log.js +306 -0
  359. package/lib/core/version.d.ts +1 -0
  360. package/lib/core/version.js +37 -0
  361. package/lib/core/web-http.d.ts +57 -0
  362. package/lib/core/web-http.js +137 -0
  363. package/lib/core/web-static.d.ts +31 -0
  364. package/lib/core/web-static.js +75 -0
  365. package/lib/headless.d.ts +1 -0
  366. package/lib/headless.js +31 -0
  367. package/lib/host/kernel.d.ts +33 -0
  368. package/lib/host/kernel.js +451 -0
  369. package/lib/index.d.ts +41 -0
  370. package/lib/index.js +35 -0
  371. package/lib/plugins/agent.d.ts +2 -0
  372. package/lib/plugins/agent.js +274 -0
  373. package/lib/plugins/approval-floor.d.ts +2 -0
  374. package/lib/plugins/approval-floor.js +223 -0
  375. package/lib/plugins/approval.d.ts +16 -0
  376. package/lib/plugins/approval.js +674 -0
  377. package/lib/plugins/ask.d.ts +2 -0
  378. package/lib/plugins/ask.js +245 -0
  379. package/lib/plugins/browser.d.ts +68 -0
  380. package/lib/plugins/browser.js +1341 -0
  381. package/lib/plugins/commands.d.ts +23 -0
  382. package/lib/plugins/commands.js +498 -0
  383. package/lib/plugins/compact.d.ts +21 -0
  384. package/lib/plugins/compact.js +274 -0
  385. package/lib/plugins/computer-use.d.ts +47 -0
  386. package/lib/plugins/computer-use.js +539 -0
  387. package/lib/plugins/desktop-dock.d.ts +2 -0
  388. package/lib/plugins/desktop-dock.js +626 -0
  389. package/lib/plugins/dock-browser.d.ts +34 -0
  390. package/lib/plugins/dock-browser.js +765 -0
  391. package/lib/plugins/dsh-compat.d.ts +25 -0
  392. package/lib/plugins/dsh-compat.js +37 -0
  393. package/lib/plugins/file-review.d.ts +108 -0
  394. package/lib/plugins/file-review.js +393 -0
  395. package/lib/plugins/git.d.ts +26 -0
  396. package/lib/plugins/git.js +132 -0
  397. package/lib/plugins/goal.d.ts +20 -0
  398. package/lib/plugins/goal.js +245 -0
  399. package/lib/plugins/guards.d.ts +14 -0
  400. package/lib/plugins/guards.js +18 -0
  401. package/lib/plugins/hooks.d.ts +19 -0
  402. package/lib/plugins/hooks.js +583 -0
  403. package/lib/plugins/host-stdio.d.ts +88 -0
  404. package/lib/plugins/host-stdio.js +317 -0
  405. package/lib/plugins/image-diet.d.ts +17 -0
  406. package/lib/plugins/image-diet.js +85 -0
  407. package/lib/plugins/lifecycle-hooks.d.ts +26 -0
  408. package/lib/plugins/lifecycle-hooks.js +338 -0
  409. package/lib/plugins/llm.d.ts +13 -0
  410. package/lib/plugins/llm.js +215 -0
  411. package/lib/plugins/lsp.d.ts +54 -0
  412. package/lib/plugins/lsp.js +608 -0
  413. package/lib/plugins/mcp.d.ts +16 -0
  414. package/lib/plugins/mcp.js +673 -0
  415. package/lib/plugins/memory.d.ts +17 -0
  416. package/lib/plugins/memory.js +858 -0
  417. package/lib/plugins/microcompact.d.ts +18 -0
  418. package/lib/plugins/microcompact.js +119 -0
  419. package/lib/plugins/mode.d.ts +18 -0
  420. package/lib/plugins/mode.js +115 -0
  421. package/lib/plugins/permission-presets.d.ts +18 -0
  422. package/lib/plugins/permission-presets.js +135 -0
  423. package/lib/plugins/plan.d.ts +2 -0
  424. package/lib/plugins/plan.js +192 -0
  425. package/lib/plugins/plugin-manager.d.ts +2 -0
  426. package/lib/plugins/plugin-manager.js +165 -0
  427. package/lib/plugins/presets.d.ts +2 -0
  428. package/lib/plugins/presets.js +182 -0
  429. package/lib/plugins/prompt.d.ts +2 -0
  430. package/lib/plugins/prompt.js +264 -0
  431. package/lib/plugins/ptc.d.ts +2 -0
  432. package/lib/plugins/ptc.js +272 -0
  433. package/lib/plugins/remote/http.d.ts +11 -0
  434. package/lib/plugins/remote/http.js +11 -0
  435. package/lib/plugins/remote/routes.d.ts +24 -0
  436. package/lib/plugins/remote/routes.js +384 -0
  437. package/lib/plugins/remote/types.d.ts +135 -0
  438. package/lib/plugins/remote/types.js +87 -0
  439. package/lib/plugins/remote.d.ts +17 -0
  440. package/lib/plugins/remote.js +1028 -0
  441. package/lib/plugins/runtime-api.d.ts +16 -0
  442. package/lib/plugins/runtime-api.js +99 -0
  443. package/lib/plugins/runtime.d.ts +10 -0
  444. package/lib/plugins/runtime.js +451 -0
  445. package/lib/plugins/sandbox.d.ts +2 -0
  446. package/lib/plugins/sandbox.js +761 -0
  447. package/lib/plugins/schedule.d.ts +26 -0
  448. package/lib/plugins/schedule.js +538 -0
  449. package/lib/plugins/self-improve.d.ts +61 -0
  450. package/lib/plugins/self-improve.js +953 -0
  451. package/lib/plugins/session-search.d.ts +16 -0
  452. package/lib/plugins/session-search.js +308 -0
  453. package/lib/plugins/session-title.d.ts +19 -0
  454. package/lib/plugins/session-title.js +109 -0
  455. package/lib/plugins/session.d.ts +7 -0
  456. package/lib/plugins/session.js +296 -0
  457. package/lib/plugins/settings.d.ts +3 -0
  458. package/lib/plugins/settings.js +705 -0
  459. package/lib/plugins/skills.d.ts +2 -0
  460. package/lib/plugins/skills.js +360 -0
  461. package/lib/plugins/spill.d.ts +16 -0
  462. package/lib/plugins/spill.js +200 -0
  463. package/lib/plugins/subagent.d.ts +2 -0
  464. package/lib/plugins/subagent.js +896 -0
  465. package/lib/plugins/surfaces.d.ts +11 -0
  466. package/lib/plugins/surfaces.js +20 -0
  467. package/lib/plugins/team.d.ts +16 -0
  468. package/lib/plugins/team.js +149 -0
  469. package/lib/plugins/todo.d.ts +19 -0
  470. package/lib/plugins/todo.js +188 -0
  471. package/lib/plugins/tool-search.d.ts +2 -0
  472. package/lib/plugins/tool-search.js +434 -0
  473. package/lib/plugins/tool-search.js.nv-backup +434 -0
  474. package/lib/plugins/tools-default.d.ts +12 -0
  475. package/lib/plugins/tools-default.js +275 -0
  476. package/lib/plugins/tools.d.ts +16 -0
  477. package/lib/plugins/tools.js +62 -0
  478. package/lib/plugins/transcript.d.ts +15 -0
  479. package/lib/plugins/transcript.js +311 -0
  480. package/lib/plugins/tui.d.ts +2 -0
  481. package/lib/plugins/tui.js +98 -0
  482. package/lib/plugins/waiting.d.ts +12 -0
  483. package/lib/plugins/waiting.js +34 -0
  484. package/lib/plugins/web-search.d.ts +14 -0
  485. package/lib/plugins/web-search.js +263 -0
  486. package/lib/plugins/webserver.d.ts +48 -0
  487. package/lib/plugins/webserver.js +228 -0
  488. package/lib/remote/assets/app-DAcUCOEn.js +14 -0
  489. package/lib/remote/assets/icon-192.png +0 -0
  490. package/lib/remote/assets/icon-512.png +0 -0
  491. package/lib/remote/assets/index.html +34 -0
  492. package/lib/remote/assets/manifest.json +27 -0
  493. package/lib/remote/assets/style-DIB6729x.css +1 -0
  494. package/lib/remote/assets/sw.js +66 -0
  495. package/lib/services/types.d.ts +1228 -0
  496. package/lib/services/types.js +1 -0
  497. package/lib/tools/config-cli.d.ts +1 -0
  498. package/lib/tools/config-cli.js +89 -0
  499. package/lib/ui/arrival.d.ts +72 -0
  500. package/lib/ui/arrival.js +105 -0
  501. package/lib/ui/assets/app-B70nVIKd.js +69 -0
  502. package/lib/ui/assets/chunk-2UxHyX5q.js +1 -0
  503. package/lib/ui/assets/chunk-B1dDrJ26.js +1 -0
  504. package/lib/ui/assets/chunk-B6aJPvgy.js +1 -0
  505. package/lib/ui/assets/chunk-BEwlwnbL.js +1 -0
  506. package/lib/ui/assets/chunk-BGcgwlCI.js +12 -0
  507. package/lib/ui/assets/chunk-BIGW1oBm.js +1 -0
  508. package/lib/ui/assets/chunk-BPQ3VLAy.js +1 -0
  509. package/lib/ui/assets/chunk-BRH0KZbk.js +141 -0
  510. package/lib/ui/assets/chunk-BX6H_ySx.js +1 -0
  511. package/lib/ui/assets/chunk-B_P3UbPa.js +1 -0
  512. package/lib/ui/assets/chunk-B_TYUkTI.js +1 -0
  513. package/lib/ui/assets/chunk-B_vNuMnf.js +1 -0
  514. package/lib/ui/assets/chunk-BajyYBss.js +10 -0
  515. package/lib/ui/assets/chunk-BdnUsdx6.js +1 -0
  516. package/lib/ui/assets/chunk-Buea-lGh.js +1 -0
  517. package/lib/ui/assets/chunk-C0PvZCCE.js +1 -0
  518. package/lib/ui/assets/chunk-C0m74zRD.js +1 -0
  519. package/lib/ui/assets/chunk-C27-OAKa.js +1 -0
  520. package/lib/ui/assets/chunk-C2oV4EkX.js +1 -0
  521. package/lib/ui/assets/chunk-C7zT0LnQ.js +1 -0
  522. package/lib/ui/assets/chunk-C9GSunVT.js +1 -0
  523. package/lib/ui/assets/chunk-C9tS-k6U.js +1 -0
  524. package/lib/ui/assets/chunk-CHLpvVh8.js +1 -0
  525. package/lib/ui/assets/chunk-CLxacb5B.js +1 -0
  526. package/lib/ui/assets/chunk-COt5Ahok.js +1 -0
  527. package/lib/ui/assets/chunk-CPTIWCL2.js +1 -0
  528. package/lib/ui/assets/chunk-CQLl-L-p.js +1 -0
  529. package/lib/ui/assets/chunk-CUWRgxuq.js +55 -0
  530. package/lib/ui/assets/chunk-CWanVSXC.js +1 -0
  531. package/lib/ui/assets/chunk-Cf5RLm7j.js +1 -0
  532. package/lib/ui/assets/chunk-CickPsom.js +1 -0
  533. package/lib/ui/assets/chunk-Cj5Yp3dK.js +1 -0
  534. package/lib/ui/assets/chunk-Cmh6b_Ma.js +1 -0
  535. package/lib/ui/assets/chunk-Cp-IABpG.js +1 -0
  536. package/lib/ui/assets/chunk-CqE71os6.js +1 -0
  537. package/lib/ui/assets/chunk-CtKP3W-j.js +1 -0
  538. package/lib/ui/assets/chunk-Cvjx9yec.js +1 -0
  539. package/lib/ui/assets/chunk-CxGP3dtY.js +1 -0
  540. package/lib/ui/assets/chunk-CylS5w8V.js +1 -0
  541. package/lib/ui/assets/chunk-D38fbIBN.js +1 -0
  542. package/lib/ui/assets/chunk-D97Zzqfu.js +1 -0
  543. package/lib/ui/assets/chunk-DAi9KRSo.js +1 -0
  544. package/lib/ui/assets/chunk-DHK4yRfg.js +1 -0
  545. package/lib/ui/assets/chunk-DJeabLx-.js +1 -0
  546. package/lib/ui/assets/chunk-DNRxmY5a.js +1 -0
  547. package/lib/ui/assets/chunk-DNSN1z5r.js +1 -0
  548. package/lib/ui/assets/chunk-DNasK_ZG.js +1 -0
  549. package/lib/ui/assets/chunk-DPvrY3IQ.js +1 -0
  550. package/lib/ui/assets/chunk-DXmwc3jG.js +1 -0
  551. package/lib/ui/assets/chunk-Dd0kTxKP.js +1 -0
  552. package/lib/ui/assets/chunk-De0Btta0.js +1 -0
  553. package/lib/ui/assets/chunk-Des-eS-w.js +1 -0
  554. package/lib/ui/assets/chunk-Df6bDoY_.js +1 -0
  555. package/lib/ui/assets/chunk-DijEV5ha.js +1 -0
  556. package/lib/ui/assets/chunk-DkvoVjww.js +1 -0
  557. package/lib/ui/assets/chunk-DlC-OlHO.js +1 -0
  558. package/lib/ui/assets/chunk-DnzrXTVv.js +1 -0
  559. package/lib/ui/assets/chunk-Dualf0xi.js +1 -0
  560. package/lib/ui/assets/chunk-EXT84bkm.js +1 -0
  561. package/lib/ui/assets/chunk-GwR3hkPK.js +1 -0
  562. package/lib/ui/assets/chunk-P80f7IUj.js +1 -0
  563. package/lib/ui/assets/chunk-VOosw3JB.js +1 -0
  564. package/lib/ui/assets/chunk-YQ4lDkt_.js +140 -0
  565. package/lib/ui/assets/chunk-Yzrsuije.js +1 -0
  566. package/lib/ui/assets/chunk-Z72CF80r.js +1 -0
  567. package/lib/ui/assets/chunk-g9-lgVsj.js +1 -0
  568. package/lib/ui/assets/chunk-vGWfd6FD.js +1 -0
  569. package/lib/ui/assets/chunk-wDzz0qaB.js +1 -0
  570. package/lib/ui/assets/chunk-ySF7HWmS.js +1 -0
  571. package/lib/ui/assets/icon.png +0 -0
  572. package/lib/ui/assets/index.html +14 -0
  573. package/lib/ui/assets/pdf.worker.min-CjEcRF4W.mjs +28 -0
  574. package/lib/ui/assets/style-Bq01xH_b.css +1 -0
  575. package/lib/ui/frames.d.ts +67 -0
  576. package/lib/ui/frames.js +146 -0
  577. package/lib/ui/index.d.ts +59 -0
  578. package/lib/ui/index.js +50 -0
  579. package/lib/ui/manifest.d.ts +172 -0
  580. package/lib/ui/manifest.js +158 -0
  581. package/lib/ui/plugin.d.ts +161 -0
  582. package/lib/ui/plugin.js +7 -0
  583. package/lib/ui/plugins/browser/client.js +290 -0
  584. package/lib/ui/plugins/browser/icon.png +0 -0
  585. package/lib/ui/plugins/composer/client.js +1843 -0
  586. package/lib/ui/plugins/composer/icon.png +0 -0
  587. package/lib/ui/plugins/files/client.js +646 -0
  588. package/lib/ui/plugins/files/icon.png +0 -0
  589. package/lib/ui/plugins/manifest.json +107 -0
  590. package/lib/ui/plugins/plugins/client.js +682 -0
  591. package/lib/ui/plugins/plugins/icon.png +0 -0
  592. package/lib/ui/plugins/preview/client.js +197 -0
  593. package/lib/ui/plugins/preview/icon.png +0 -0
  594. package/lib/ui/plugins/prompt/client.js +653 -0
  595. package/lib/ui/plugins/prompt/icon.png +0 -0
  596. package/lib/ui/plugins/sessions/client.js +1577 -0
  597. package/lib/ui/plugins/sessions/icon.png +0 -0
  598. package/lib/ui/plugins/settings/client.js +5470 -0
  599. package/lib/ui/plugins/settings/icon.png +0 -0
  600. package/lib/ui/plugins/skills/client.js +485 -0
  601. package/lib/ui/plugins/skills/icon.png +0 -0
  602. package/lib/ui/plugins/status/client.js +1420 -0
  603. package/lib/ui/plugins/status/icon.png +0 -0
  604. package/lib/ui/plugins/statusbar/client.js +504 -0
  605. package/lib/ui/plugins/statusbar/icon.png +0 -0
  606. package/lib/ui/plugins/tasks/client.js +52 -0
  607. package/lib/ui/plugins/tasks/icon.png +0 -0
  608. package/lib/ui/plugins/team/client.js +527 -0
  609. package/lib/ui/plugins/team/icon.png +0 -0
  610. package/lib/ui/plugins/terminal/client.js +232 -0
  611. package/lib/ui/plugins/terminal/icon.png +0 -0
  612. package/lib/ui/plugins/trace/client.js +1376 -0
  613. package/lib/ui/plugins/trace/icon.png +0 -0
  614. package/lib/ui/plugins/transcript/client.js +2661 -0
  615. package/lib/ui/plugins/transcript/icon.png +0 -0
  616. package/lib/ui/scoped-slots.d.ts +20 -0
  617. package/lib/ui/scoped-slots.js +21 -0
  618. package/lib/ui/sdk/@dsc/ui/index.d.ts +242 -0
  619. package/lib/ui/sdk/@dsc/ui/package.json +16 -0
  620. package/lib/ui/sdk/@dsc/ui-core/contract.d.ts +1973 -0
  621. package/lib/ui/sdk/@dsc/ui-core/core/diff-text.d.ts +74 -0
  622. package/lib/ui/sdk/@dsc/ui-core/core/dock-browser.d.ts +137 -0
  623. package/lib/ui/sdk/@dsc/ui-core/core/dock-ops.d.ts +59 -0
  624. package/lib/ui/sdk/@dsc/ui-core/core/model-caps.d.ts +83 -0
  625. package/lib/ui/sdk/@dsc/ui-core/core/native-bridge.d.ts +135 -0
  626. package/lib/ui/sdk/@dsc/ui-core/core/token-estimate.d.ts +55 -0
  627. package/lib/ui/sdk/@dsc/ui-core/package.json +16 -0
  628. package/lib/ui/sdk/@dsc/ui-core/ui/arrival.d.ts +72 -0
  629. package/lib/ui/sdk/@dsc/ui-core/ui/frames.d.ts +67 -0
  630. package/lib/ui/sdk/@dsc/ui-core/ui/index.d.ts +59 -0
  631. package/lib/ui/sdk/@dsc/ui-core/ui/manifest.d.ts +172 -0
  632. package/lib/ui/sdk/@dsc/ui-core/ui/plugin.d.ts +161 -0
  633. package/lib/ui/sdk/@dsc/ui-core/ui/scoped-slots.d.ts +20 -0
  634. package/lib/ui/sdk/@dsc/ui-core/ui/services-react.d.ts +27 -0
  635. package/lib/ui/sdk/@dsc/ui-core/ui/services.d.ts +63 -0
  636. package/lib/ui/sdk/@dsc/ui-core/ui/slots-react.d.ts +28 -0
  637. package/lib/ui/sdk/@dsc/ui-core/ui/slots.d.ts +481 -0
  638. package/lib/ui/sdk/@dsc/ui-core/ui/store.d.ts +89 -0
  639. package/lib/ui/sdk/@dsc/ui-dockkit/dock-model.d.ts +238 -0
  640. package/lib/ui/sdk/@dsc/ui-dockkit/dock-state.d.ts +163 -0
  641. package/lib/ui/sdk/@dsc/ui-dockkit/dock.d.ts +24 -0
  642. package/lib/ui/sdk/@dsc/ui-dockkit/index.d.ts +15 -0
  643. package/lib/ui/sdk/@dsc/ui-dockkit/package.json +16 -0
  644. package/lib/ui/sdk/@dsc/ui-layout/app.d.ts +74 -0
  645. package/lib/ui/sdk/@dsc/ui-layout/appearance.d.ts +70 -0
  646. package/lib/ui/sdk/@dsc/ui-layout/host-channel.d.ts +112 -0
  647. package/lib/ui/sdk/@dsc/ui-layout/index.d.ts +34 -0
  648. package/lib/ui/sdk/@dsc/ui-layout/package.json +16 -0
  649. package/lib/ui/sdk/@dsc/ui-layout/page-state.d.ts +14 -0
  650. package/lib/ui/sdk/@dsc/ui-layout/review-pane.d.ts +21 -0
  651. package/lib/ui/sdk/@dsc/ui-layout/runtime-context.d.ts +44 -0
  652. package/lib/ui/sdk/@dsc/ui-layout/thread-view.d.ts +28 -0
  653. package/lib/ui/sdk/@dsc/ui-layout/update-button.d.ts +21 -0
  654. package/lib/ui/sdk/@dsc/ui-primitives/code-file-icon-artwork.d.ts +53 -0
  655. package/lib/ui/sdk/@dsc/ui-primitives/code-view.d.ts +15 -0
  656. package/lib/ui/sdk/@dsc/ui-primitives/compat.d.ts +27 -0
  657. package/lib/ui/sdk/@dsc/ui-primitives/completion-sound.d.ts +24 -0
  658. package/lib/ui/sdk/@dsc/ui-primitives/confirm.d.ts +33 -0
  659. package/lib/ui/sdk/@dsc/ui-primitives/css.d.ts +47 -0
  660. package/lib/ui/sdk/@dsc/ui-primitives/diff-rows.d.ts +20 -0
  661. package/lib/ui/sdk/@dsc/ui-primitives/file-icons.d.ts +38 -0
  662. package/lib/ui/sdk/@dsc/ui-primitives/file-type-classify.d.ts +66 -0
  663. package/lib/ui/sdk/@dsc/ui-primitives/file-type-icon.d.ts +57 -0
  664. package/lib/ui/sdk/@dsc/ui-primitives/highlight.d.ts +24 -0
  665. package/lib/ui/sdk/@dsc/ui-primitives/hover-delay.d.ts +17 -0
  666. package/lib/ui/sdk/@dsc/ui-primitives/icons.d.ts +109 -0
  667. package/lib/ui/sdk/@dsc/ui-primitives/index.d.ts +55 -0
  668. package/lib/ui/sdk/@dsc/ui-primitives/lang-table.d.ts +10 -0
  669. package/lib/ui/sdk/@dsc/ui-primitives/markdown.d.ts +20 -0
  670. package/lib/ui/sdk/@dsc/ui-primitives/native.d.ts +41 -0
  671. package/lib/ui/sdk/@dsc/ui-primitives/package.json +16 -0
  672. package/lib/ui/sdk/@dsc/ui-primitives/panels.d.ts +86 -0
  673. package/lib/ui/sdk/@dsc/ui-primitives/paths.d.ts +11 -0
  674. package/lib/ui/sdk/@dsc/ui-primitives/pdf-view.d.ts +13 -0
  675. package/lib/ui/sdk/@dsc/ui-primitives/plugin-text.d.ts +15 -0
  676. package/lib/ui/sdk/@dsc/ui-primitives/select.d.ts +35 -0
  677. package/lib/ui/sdk/@dsc/ui-primitives/table-view.d.ts +23 -0
  678. package/lib/ui/sdk/@dsc/ui-primitives/thread-resizer.d.ts +22 -0
  679. package/lib/ui/sdk/@dsc/ui-primitives/time.d.ts +33 -0
  680. package/lib/ui/sdk/@dsc/ui-primitives/toast.d.ts +16 -0
  681. package/lib/ui/sdk/@dsc/ui-primitives/tokens.d.ts +14 -0
  682. package/lib/ui/sdk/@dsc/ui-primitives/tool-args.d.ts +49 -0
  683. package/lib/ui/sdk/@dsc/ui-primitives/tool-summary.d.ts +64 -0
  684. package/lib/ui/sdk/@dsc/ui-renderer/boot.d.ts +121 -0
  685. package/lib/ui/sdk/@dsc/ui-renderer/hmr.d.ts +43 -0
  686. package/lib/ui/sdk/@dsc/ui-renderer/index.d.ts +20 -0
  687. package/lib/ui/sdk/@dsc/ui-renderer/package.json +16 -0
  688. package/lib/ui/sdk/@dsc/ui-slots/index.d.ts +19 -0
  689. package/lib/ui/sdk/@dsc/ui-slots/package.json +16 -0
  690. package/lib/ui/sdk/@dsc/ui-slots/slots-react.d.ts +48 -0
  691. package/lib/ui/sdk/@dsc/ui-slots/slots.d.ts +102 -0
  692. package/lib/ui/services-react.d.ts +27 -0
  693. package/lib/ui/services-react.js +32 -0
  694. package/lib/ui/services.d.ts +63 -0
  695. package/lib/ui/services.js +121 -0
  696. package/lib/ui/slots-ink.d.ts +26 -0
  697. package/lib/ui/slots-ink.js +78 -0
  698. package/lib/ui/slots-react.d.ts +28 -0
  699. package/lib/ui/slots-react.js +88 -0
  700. package/lib/ui/slots.d.ts +481 -0
  701. package/lib/ui/slots.js +550 -0
  702. package/lib/ui/store.d.ts +89 -0
  703. package/lib/ui/store.js +62 -0
  704. package/lib/ui/tui-plugin-api.d.ts +23 -0
  705. package/lib/ui/tui-plugin-api.js +23 -0
  706. package/lib/ui/tui-plugins.d.ts +47 -0
  707. package/lib/ui/tui-plugins.js +220 -0
  708. package/package.json +58 -6
@@ -0,0 +1,192 @@
1
+ import { CdpTransport, type CdpTransportOptions } from './transport.js';
2
+ /** 启动+清理需要的配置(由插件从设置里读)。 */
3
+ export interface BrowserLaunchConfig {
4
+ /** 用户填的浏览器路径;空 = 自动探测。 */
5
+ executablePath: string;
6
+ /** 用户填的 profile 目录;空 = 自建临时目录(收尾时连目录一起删)。 */
7
+ profileDir: string;
8
+ /** 无窗口运行。 */
9
+ headless: boolean;
10
+ }
11
+ /** 探测用的环境根(注入点,自检可以造假路径)。 */
12
+ export interface BrowserProbeEnv {
13
+ localAppData: string;
14
+ programFiles: string;
15
+ programFilesX86: string;
16
+ }
17
+ /** 取本机环境里的三个安装根目录。 */
18
+ export declare function probeEnv(): BrowserProbeEnv;
19
+ /**
20
+ * 候选可执行文件,按优先级排。
21
+ * Program Files 里的系统级安装优先,再退到 %LOCALAPPDATA% 的用户级安装
22
+ * (Chrome 从官网装到用户目录时只在那里)。
23
+ */
24
+ export declare function candidateExecutables(env: BrowserProbeEnv): string[];
25
+ /** 探测入参:存在性判断与环境根都可注入,自检不需要真装浏览器。 */
26
+ export interface ProbeOptions {
27
+ exists?: (path: string) => boolean;
28
+ env?: BrowserProbeEnv;
29
+ }
30
+ /**
31
+ * 找浏览器可执行文件。
32
+ *
33
+ * @param config - 用户配置(`executablePath` 非空时优先用它,但仍然要存在)。
34
+ * @param options - 注入点,见 {@link ProbeOptions}。
35
+ * @returns 绝对路径;一个都没有返回 null(调用方负责报一句能照做的错)。
36
+ */
37
+ export declare function probeExecutable(config: BrowserLaunchConfig, options?: ProbeOptions): string | null;
38
+ /**
39
+ * 拼启动参数串。
40
+ *
41
+ * 为什么 `about:blank` 放最后:它是位置参数,前面全是开关。
42
+ * 为什么不经 shell:参数里可能带空格与中文(用户目录名),走 shell 会拼接引号踩坑;
43
+ * `spawn(exe, args)` 每个参数原样进 argv,Chrome 的 `--switch=value` 解析器认得值里的空格。
44
+ *
45
+ * @param config - 启动配置。
46
+ * @param profileDir - 已经定下来的 profile 目录(自建临时目录或用户配置的那个)。
47
+ */
48
+ export declare function buildLaunchArgs(config: BrowserLaunchConfig, profileDir: string): string[];
49
+ /**
50
+ * 解析 profile 目录里的 `DevToolsActivePort` 文件。
51
+ *
52
+ * 文件两行:第一行是端口,第二行是 `/devtools/browser/<uuid>` 路径。
53
+ * 第二行可能缺(老版本、被截断),所以单独容忍。
54
+ *
55
+ * @returns 端口非法就返回 null。
56
+ */
57
+ export declare function parseDevToolsActivePort(text: string): {
58
+ port: number;
59
+ browserPath: string;
60
+ } | null;
61
+ /** 端点发现的入参。 */
62
+ export interface EndpointOptions {
63
+ timeoutMs?: number;
64
+ intervalMs?: number;
65
+ signal?: AbortSignal;
66
+ /** 探到端点后的自检注入点:返回 true 表示「这个端点可以用」。 */
67
+ probe?: (endpoint: string) => boolean;
68
+ }
69
+ /**
70
+ * 等端点出现。
71
+ *
72
+ * 主路:轮询读 `DevToolsActivePort`。
73
+ * 退路:文件只给了端口没给路径时,问一句 `http://127.0.0.1:<port>/json/version`
74
+ * 拿 `webSocketDebuggerUrl`——注意这条**不能**替代主路:`--remote-debugging-port=0` 下
75
+ * 端口号只有那个文件知道,没有文件就没有端口可问。
76
+ */
77
+ export declare function waitForEndpoint(profileDir: string, options?: EndpointOptions): Promise<string>;
78
+ /** 问一次 `/json/version` 拿浏览器级 WebSocket 地址(仅在端点文件缺路径时用)。 */
79
+ export declare function fetchBrowserWebSocket(port: number, timeoutMs?: number, signal?: AbortSignal): Promise<string>;
80
+ /** 一次成功启动的结果。 */
81
+ export interface LaunchedBrowser {
82
+ /** 用的可执行文件。 */
83
+ exe: string;
84
+ /** 主进程 pid(整树杀要用它)。 */
85
+ pid: number;
86
+ /** profile 目录。 */
87
+ profileDir: string;
88
+ /** true = 这个目录是我们建的,收尾时要删;false = 用户配置的目录,只杀进程不动文件。 */
89
+ ownedProfile: boolean;
90
+ /** 浏览器级 CDP 端点。 */
91
+ endpoint: string;
92
+ /** 主进程还活着吗(重连之前先问它:进程死了重连多少次都是白费)。 */
93
+ isAlive(): boolean;
94
+ }
95
+ /**
96
+ * 起一个受控浏览器并等它的调试端点就绪。
97
+ *
98
+ * `stdio: 'ignore'`:Chrome 的 stderr 在 Windows 上是 GBK,读进来也是乱码,
99
+ * 端点又从 `DevToolsActivePort` 读,所以干脆别接管道(顺带避免管道写满卡死)。
100
+ * 起不来(进程提前退出/超时)时自己把残留杀掉、把自建 profile 删掉再抛错。
101
+ */
102
+ export declare function launchBrowser(config: BrowserLaunchConfig, signal: AbortSignal, options?: ProbeOptions & EndpointOptions): Promise<LaunchedBrowser>;
103
+ /**
104
+ * 连接断了之后该做什么。抽成纯函数是为了在没有浏览器的情况下也能自检这条判断:
105
+ * 进程还活着才谈得上「重连」;进程已经死了,重连只是对着一个死端点白等超时。
106
+ */
107
+ export declare function reconnectDecision(state: {
108
+ processAlive: boolean;
109
+ canReconnect: boolean;
110
+ canRestart: boolean;
111
+ }): 'reconnect' | 'restart' | 'fail';
112
+ /** 一条重连/重开的额度账。抽出来是为了在没有浏览器的情况下也能自检。 */
113
+ export declare class ReconnectBudget {
114
+ /** 同一个进程最多重连几次(缺省 5)。 */
115
+ private readonly maxReconnects;
116
+ /** 进程死了最多重开几次(缺省 2;`close` 之后重开不算在内)。 */
117
+ private readonly maxRestarts;
118
+ private usedReconnects;
119
+ private usedRestarts;
120
+ constructor(
121
+ /** 同一个进程最多重连几次(缺省 5)。 */
122
+ maxReconnects?: number,
123
+ /** 进程死了最多重开几次(缺省 2;`close` 之后重开不算在内)。 */
124
+ maxRestarts?: number);
125
+ get reconnects(): number;
126
+ get restarts(): number;
127
+ canReconnect(): boolean;
128
+ canRestart(): boolean;
129
+ noteReconnect(): void;
130
+ /** 重开之后重连额度重新算(新进程是新的开始)。 */
131
+ noteRestart(): void;
132
+ /** 用户主动收工:下一次是干净的开始,不背之前的重试账。 */
133
+ reset(): void;
134
+ }
135
+ /** 一个受控浏览器进程的持有者:懒启动、崩溃重连/重开、整树清理。 */
136
+ export declare class BrowserProcess {
137
+ private readonly readConfig;
138
+ private launched;
139
+ private transport;
140
+ private readonly budget;
141
+ private readonly connectOptions;
142
+ private closed;
143
+ /**
144
+ * @param readConfig - 每次启动现读配置(设置改了就生效,不必重启插件)。
145
+ * @param connectOptions - 传输层注入点(自检用假 socket)。
146
+ */
147
+ constructor(readConfig: () => BrowserLaunchConfig, connectOptions?: CdpTransportOptions);
148
+ /** 进程还活着吗(退出码为 null 才算活着)。 */
149
+ get alive(): boolean;
150
+ /** 当前 profile 目录(没启动过就是 null)。 */
151
+ get profileDir(): string | null;
152
+ /** 当前用的可执行文件(没启动过就是 null)。 */
153
+ get executable(): string | null;
154
+ /** 主进程 pid(没启动过就是 null)。 */
155
+ get pid(): number | null;
156
+ /**
157
+ * 拿一条可用的浏览器级连接。
158
+ *
159
+ * 三种情况:
160
+ * - 连接还在 → 直接用;
161
+ * - 连接断了但进程还活着(CDP 会话被浏览器自己关掉)→ 重连,最多 5 次;
162
+ * - 进程死了 → 清理残留后重开,最多 2 次(额度用完就让人来 `close` 一次,别无限重开)。
163
+ */
164
+ browserTransport(signal?: AbortSignal): Promise<CdpTransport>;
165
+ /**
166
+ * 收掉这台浏览器:整树杀 → 等 300ms → 删自建 profile。
167
+ * 同步实现是刻意的:`apply` 返回的 disposer 与 `dsc/exit` 监听器都必须同步跑完,
168
+ * 异步清理在这里会被宿主直接跳过。
169
+ */
170
+ killSync(): void;
171
+ /** 永久收工(插件卸载/宿主退出):killSync 之外再记一笔「别再自动重开」。 */
172
+ shutdown(): void;
173
+ /**
174
+ * 用户主动关掉(`browser action=close` 与设置里的「关闭浏览器」):
175
+ * 资源照样清干净,但重试额度重置——下次调用工具是一次干净的新开始,
176
+ * 不能因为用户关过两次浏览器就说「反复退出」。
177
+ */
178
+ close(): void;
179
+ }
180
+ /**
181
+ * 整树杀进程。
182
+ *
183
+ * Windows 没有进程组,`child.kill()` 只带走主进程,renderer/gpu/utility 会变成孤儿
184
+ * 继续攥着 profile;`taskkill /T` 沿着父子关系整棵带走,`/F` 是必须的(Chrome
185
+ * 对 SIGTERM 类软信号经常不理)。
186
+ * 非 Windows 退回 `process.kill`(这条代码路径主要面向 Windows,留着是为了不炸)。
187
+ */
188
+ export declare function killProcessTree(pid: number): void;
189
+ /** 递归删 profile 目录(删不掉就留着,别把退出流程搞崩)。 */
190
+ export declare function removeProfileDirSync(dir: string): void;
191
+ /** 同步睡一会儿(disposer 里不能 await)。 */
192
+ export declare function sleepSync(ms: number): void;
@@ -0,0 +1,491 @@
1
+ /**
2
+ * 受控浏览器的启动、端点发现与整树清理。
3
+ *
4
+ * 为什么自己起浏览器而不是连用户的日常实例:
5
+ * 1. Chrome 136+ 起,对默认 profile 目录**静默忽略** `--remote-debugging-port`;
6
+ * 144+ 每次还要弹一次授权。想稳,就必须给一个自建 profile;
7
+ * 2. 自建 profile 才敢在收尾时整个删掉——用户自己的 profile 里是书签、密码、登录态,
8
+ * 碰不得,也不该被自动化流程污染;
9
+ * 3. `--remote-debugging-port=0` 让系统分配空闲端口,避免和用户已经开着的调试实例撞端口。
10
+ * 代价是「端口号事先不知道」,所以端点只能从 profile 目录里的 `DevToolsActivePort`
11
+ * 文件读——这比解析 stderr 稳:Windows 上 stderr 是 GBK,中文路径一进来就乱码。
12
+ *
13
+ * 清理是这里最大的坑:Windows 没有进程组信号,`child.kill()` 只杀得掉浏览器主进程,
14
+ * renderer/gpu/utility 一堆子进程会活下来继续占着 profile 目录,下一次启动就报
15
+ * 「profile 已被占用」。所以必须 `taskkill /PID <pid> /T /F` 整树杀,等 300ms 让文件句柄
16
+ * 释放,再递归删自建 profile。
17
+ *
18
+ * 这里刻意**不**装 SIGINT/SIGTERM 处理器:宿主统一走 `dsc/exit` 事件收尾,
19
+ * 插件抢着处理信号会让宿主自己的退出流程半路失效(stagehand 那份也是
20
+ * `handleSIGINT/SIGTERM: false`)。
21
+ *
22
+ * @module dsc/core/cdp/launch
23
+ */
24
+ import { spawn, spawnSync } from 'node:child_process';
25
+ import { existsSync, mkdtempSync, mkdirSync, readFileSync, rmSync } from 'node:fs';
26
+ import { tmpdir } from 'node:os';
27
+ import { join, resolve } from 'node:path';
28
+ import { CdpTransport } from './transport.js';
29
+ /** 取本机环境里的三个安装根目录。 */
30
+ export function probeEnv() {
31
+ return {
32
+ localAppData: process.env.LOCALAPPDATA ?? '',
33
+ programFiles: process.env.ProgramFiles ?? process.env.PROGRAMFILES ?? 'C:\\Program Files',
34
+ programFilesX86: process.env['ProgramFiles(x86)'] ?? 'C:\\Program Files (x86)',
35
+ };
36
+ }
37
+ /**
38
+ * 候选可执行文件,按优先级排。
39
+ * Program Files 里的系统级安装优先,再退到 %LOCALAPPDATA% 的用户级安装
40
+ * (Chrome 从官网装到用户目录时只在那里)。
41
+ */
42
+ export function candidateExecutables(env) {
43
+ const list = [
44
+ join(env.programFiles, 'Google', 'Chrome', 'Application', 'chrome.exe'),
45
+ join(env.programFilesX86, 'Microsoft', 'Edge', 'Application', 'msedge.exe'),
46
+ join(env.programFiles, 'Microsoft', 'Edge', 'Application', 'msedge.exe'),
47
+ ];
48
+ if (env.localAppData !== '') {
49
+ list.push(join(env.localAppData, 'Google', 'Chrome', 'Application', 'chrome.exe'));
50
+ list.push(join(env.localAppData, 'Microsoft', 'Edge', 'Application', 'msedge.exe'));
51
+ }
52
+ return list;
53
+ }
54
+ /**
55
+ * 找浏览器可执行文件。
56
+ *
57
+ * @param config - 用户配置(`executablePath` 非空时优先用它,但仍然要存在)。
58
+ * @param options - 注入点,见 {@link ProbeOptions}。
59
+ * @returns 绝对路径;一个都没有返回 null(调用方负责报一句能照做的错)。
60
+ */
61
+ export function probeExecutable(config, options = {}) {
62
+ const exists = options.exists ?? existsSync;
63
+ const configured = config.executablePath.trim();
64
+ if (configured !== '') {
65
+ const full = resolve(configured);
66
+ return exists(full) ? full : null;
67
+ }
68
+ for (const candidate of candidateExecutables(options.env ?? probeEnv())) {
69
+ if (exists(candidate))
70
+ return candidate;
71
+ }
72
+ return null;
73
+ }
74
+ /**
75
+ * 拼启动参数串。
76
+ *
77
+ * 为什么 `about:blank` 放最后:它是位置参数,前面全是开关。
78
+ * 为什么不经 shell:参数里可能带空格与中文(用户目录名),走 shell 会拼接引号踩坑;
79
+ * `spawn(exe, args)` 每个参数原样进 argv,Chrome 的 `--switch=value` 解析器认得值里的空格。
80
+ *
81
+ * @param config - 启动配置。
82
+ * @param profileDir - 已经定下来的 profile 目录(自建临时目录或用户配置的那个)。
83
+ */
84
+ export function buildLaunchArgs(config, profileDir) {
85
+ return [
86
+ '--remote-debugging-port=0',
87
+ `--user-data-dir=${profileDir}`,
88
+ // 不加 --remote-allow-origins:dsc 自己的客户端(Node)发 WebSocket 不带 Origin 头,
89
+ // Chrome 只拦「带 Origin 且不在白名单」的连接——恶意页面扫到端口也握不上手(2026-09-29 审查)。
90
+ '--no-first-run',
91
+ '--no-default-browser-check',
92
+ ...(config.headless ? ['--headless=new'] : []),
93
+ 'about:blank',
94
+ ];
95
+ }
96
+ /**
97
+ * 解析 profile 目录里的 `DevToolsActivePort` 文件。
98
+ *
99
+ * 文件两行:第一行是端口,第二行是 `/devtools/browser/<uuid>` 路径。
100
+ * 第二行可能缺(老版本、被截断),所以单独容忍。
101
+ *
102
+ * @returns 端口非法就返回 null。
103
+ */
104
+ export function parseDevToolsActivePort(text) {
105
+ const lines = text.split(/\r?\n/).map((line) => line.trim());
106
+ const port = Number(lines[0] ?? '');
107
+ if (!Number.isInteger(port) || port <= 0 || port > 65535)
108
+ return null;
109
+ const browserPath = lines[1] ?? '';
110
+ return { port, browserPath: browserPath.startsWith('/') ? browserPath : '' };
111
+ }
112
+ const LAUNCH_TIMEOUT_MS = 30_000;
113
+ const ENDPOINT_INTERVAL_MS = 100;
114
+ /**
115
+ * 等端点出现。
116
+ *
117
+ * 主路:轮询读 `DevToolsActivePort`。
118
+ * 退路:文件只给了端口没给路径时,问一句 `http://127.0.0.1:<port>/json/version`
119
+ * 拿 `webSocketDebuggerUrl`——注意这条**不能**替代主路:`--remote-debugging-port=0` 下
120
+ * 端口号只有那个文件知道,没有文件就没有端口可问。
121
+ */
122
+ export async function waitForEndpoint(profileDir, options = {}) {
123
+ const timeoutMs = options.timeoutMs ?? LAUNCH_TIMEOUT_MS;
124
+ const intervalMs = options.intervalMs ?? ENDPOINT_INTERVAL_MS;
125
+ const started = Date.now();
126
+ const portFile = join(profileDir, 'DevToolsActivePort');
127
+ let lastProblem = 'DevToolsActivePort 还没出现';
128
+ for (;;) {
129
+ options.signal?.throwIfAborted();
130
+ if (existsSync(portFile)) {
131
+ let parsed = null;
132
+ try {
133
+ parsed = parseDevToolsActivePort(readFileSync(portFile, 'utf8'));
134
+ }
135
+ catch (error) {
136
+ lastProblem = `读 DevToolsActivePort 失败:${error instanceof Error ? error.message : String(error)}`;
137
+ }
138
+ if (parsed !== null) {
139
+ if (parsed.browserPath !== '') {
140
+ const endpoint = `ws://127.0.0.1:${parsed.port}${parsed.browserPath}`;
141
+ if (options.probe === undefined || options.probe(endpoint))
142
+ return endpoint;
143
+ lastProblem = '端点存在但连不上';
144
+ }
145
+ else {
146
+ try {
147
+ const endpoint = await fetchBrowserWebSocket(parsed.port, 2000, options.signal);
148
+ if (options.probe === undefined || options.probe(endpoint))
149
+ return endpoint;
150
+ lastProblem = '端点存在但连不上';
151
+ }
152
+ catch (error) {
153
+ lastProblem = `端口 ${parsed.port} 上没有可用的调试端点:${error instanceof Error ? error.message : String(error)}`;
154
+ }
155
+ }
156
+ }
157
+ else {
158
+ lastProblem = 'DevToolsActivePort 内容还不是合法端口';
159
+ }
160
+ }
161
+ if (Date.now() - started >= timeoutMs) {
162
+ throw new Error(`等浏览器调试端点超时(${timeoutMs}ms):${lastProblem}。路径:${profileDir}`);
163
+ }
164
+ await delay(intervalMs, options.signal);
165
+ }
166
+ }
167
+ /** 问一次 `/json/version` 拿浏览器级 WebSocket 地址(仅在端点文件缺路径时用)。 */
168
+ export async function fetchBrowserWebSocket(port, timeoutMs = 3000, signal) {
169
+ const response = await fetch(`http://127.0.0.1:${port}/json/version`, {
170
+ signal: signal === undefined ? AbortSignal.timeout(timeoutMs) : AbortSignal.any([signal, AbortSignal.timeout(timeoutMs)]),
171
+ });
172
+ if (!response.ok)
173
+ throw new Error(`HTTP ${response.status}`);
174
+ const doc = (await response.json());
175
+ if (typeof doc.webSocketDebuggerUrl !== 'string' || doc.webSocketDebuggerUrl === '') {
176
+ throw new Error('/json/version 里没有 webSocketDebuggerUrl');
177
+ }
178
+ return doc.webSocketDebuggerUrl;
179
+ }
180
+ /**
181
+ * 起一个受控浏览器并等它的调试端点就绪。
182
+ *
183
+ * `stdio: 'ignore'`:Chrome 的 stderr 在 Windows 上是 GBK,读进来也是乱码,
184
+ * 端点又从 `DevToolsActivePort` 读,所以干脆别接管道(顺带避免管道写满卡死)。
185
+ * 起不来(进程提前退出/超时)时自己把残留杀掉、把自建 profile 删掉再抛错。
186
+ */
187
+ export async function launchBrowser(config, signal, options = {}) {
188
+ signal.throwIfAborted();
189
+ const exe = probeExecutable(config, options);
190
+ if (exe === null) {
191
+ const configured = config.executablePath.trim();
192
+ throw new Error(configured === ''
193
+ ? '没找到 Chrome 或 Edge。请在设置「浏览器自动化」里把 executablePath 填成浏览器可执行文件的绝对路径'
194
+ : `配置的浏览器路径不存在:${configured}(请在设置「浏览器自动化」里改掉)`);
195
+ }
196
+ const ownedProfile = config.profileDir.trim() === '';
197
+ const profileDir = ownedProfile ? mkdtempSync(join(tmpdir(), 'dsc-browser-')) : resolve(config.profileDir.trim());
198
+ if (!ownedProfile)
199
+ mkdirSync(profileDir, { recursive: true });
200
+ const args = buildLaunchArgs(config, profileDir);
201
+ const proc = spawn(exe, args, { stdio: 'ignore', windowsHide: true });
202
+ const pid = proc.pid ?? 0;
203
+ let spawnError = null;
204
+ let exited = false;
205
+ proc.on('error', (error) => {
206
+ spawnError = error instanceof Error ? error : new Error(String(error));
207
+ });
208
+ proc.on('exit', () => {
209
+ exited = true;
210
+ });
211
+ // 进程提前退出(或 spawn 直接失败)就别再干等端口了,否则要白等 30 秒
212
+ let failLaunch = null;
213
+ const failed = new Promise((_resolve, reject) => {
214
+ failLaunch = reject;
215
+ });
216
+ const watchdog = setInterval(() => {
217
+ if (spawnError !== null)
218
+ failLaunch?.(new Error(`浏览器进程起不来:${spawnError.message}`));
219
+ else if (exited) {
220
+ failLaunch?.(new Error('浏览器进程启动后立刻退出了(可执行文件可能被安全软件拦下,或 profile 目录不可写)'));
221
+ }
222
+ }, 100);
223
+ watchdog.unref?.();
224
+ try {
225
+ const endpoint = await Promise.race([
226
+ waitForEndpoint(profileDir, {
227
+ timeoutMs: options.timeoutMs,
228
+ intervalMs: options.intervalMs,
229
+ probe: options.probe,
230
+ signal,
231
+ }),
232
+ failed,
233
+ ]);
234
+ return { exe, pid, profileDir, ownedProfile, endpoint, isAlive: () => !exited && proc.exitCode === null };
235
+ }
236
+ catch (error) {
237
+ if (pid !== 0)
238
+ killProcessTree(pid);
239
+ sleepSync(300);
240
+ if (ownedProfile)
241
+ removeProfileDirSync(profileDir);
242
+ throw error;
243
+ }
244
+ finally {
245
+ clearInterval(watchdog);
246
+ }
247
+ }
248
+ /**
249
+ * 连接断了之后该做什么。抽成纯函数是为了在没有浏览器的情况下也能自检这条判断:
250
+ * 进程还活着才谈得上「重连」;进程已经死了,重连只是对着一个死端点白等超时。
251
+ */
252
+ export function reconnectDecision(state) {
253
+ if (state.processAlive && state.canReconnect)
254
+ return 'reconnect';
255
+ if (state.canRestart)
256
+ return 'restart';
257
+ return 'fail';
258
+ }
259
+ /** 一条重连/重开的额度账。抽出来是为了在没有浏览器的情况下也能自检。 */
260
+ export class ReconnectBudget {
261
+ maxReconnects;
262
+ maxRestarts;
263
+ usedReconnects = 0;
264
+ usedRestarts = 0;
265
+ constructor(
266
+ /** 同一个进程最多重连几次(缺省 5)。 */
267
+ maxReconnects = 5,
268
+ /** 进程死了最多重开几次(缺省 2;`close` 之后重开不算在内)。 */
269
+ maxRestarts = 2) {
270
+ this.maxReconnects = maxReconnects;
271
+ this.maxRestarts = maxRestarts;
272
+ }
273
+ get reconnects() {
274
+ return this.usedReconnects;
275
+ }
276
+ get restarts() {
277
+ return this.usedRestarts;
278
+ }
279
+ canReconnect() {
280
+ return this.usedReconnects < this.maxReconnects;
281
+ }
282
+ canRestart() {
283
+ return this.usedRestarts < this.maxRestarts;
284
+ }
285
+ noteReconnect() {
286
+ this.usedReconnects += 1;
287
+ }
288
+ /** 重开之后重连额度重新算(新进程是新的开始)。 */
289
+ noteRestart() {
290
+ this.usedRestarts += 1;
291
+ this.usedReconnects = 0;
292
+ }
293
+ /** 用户主动收工:下一次是干净的开始,不背之前的重试账。 */
294
+ reset() {
295
+ this.usedReconnects = 0;
296
+ this.usedRestarts = 0;
297
+ }
298
+ }
299
+ /** 一个受控浏览器进程的持有者:懒启动、崩溃重连/重开、整树清理。 */
300
+ export class BrowserProcess {
301
+ readConfig;
302
+ launched = null;
303
+ transport = null;
304
+ budget = new ReconnectBudget();
305
+ connectOptions;
306
+ closed = false;
307
+ /**
308
+ * @param readConfig - 每次启动现读配置(设置改了就生效,不必重启插件)。
309
+ * @param connectOptions - 传输层注入点(自检用假 socket)。
310
+ */
311
+ constructor(readConfig, connectOptions = {}) {
312
+ this.readConfig = readConfig;
313
+ this.connectOptions = { label: '浏览器级 CDP', ...connectOptions };
314
+ }
315
+ /** 进程还活着吗(退出码为 null 才算活着)。 */
316
+ get alive() {
317
+ return this.launched !== null && !this.closed && this.launched.isAlive();
318
+ }
319
+ /** 当前 profile 目录(没启动过就是 null)。 */
320
+ get profileDir() {
321
+ return this.launched?.profileDir ?? null;
322
+ }
323
+ /** 当前用的可执行文件(没启动过就是 null)。 */
324
+ get executable() {
325
+ return this.launched?.exe ?? null;
326
+ }
327
+ /** 主进程 pid(没启动过就是 null)。 */
328
+ get pid() {
329
+ return this.launched?.pid ?? null;
330
+ }
331
+ /**
332
+ * 拿一条可用的浏览器级连接。
333
+ *
334
+ * 三种情况:
335
+ * - 连接还在 → 直接用;
336
+ * - 连接断了但进程还活着(CDP 会话被浏览器自己关掉)→ 重连,最多 5 次;
337
+ * - 进程死了 → 清理残留后重开,最多 2 次(额度用完就让人来 `close` 一次,别无限重开)。
338
+ */
339
+ async browserTransport(signal) {
340
+ if (this.closed)
341
+ throw new Error('受控浏览器已被关掉;下一次调用工具会自动重开');
342
+ if (this.transport !== null && !this.transport.closed)
343
+ return this.transport;
344
+ const decision = reconnectDecision({
345
+ processAlive: this.launched !== null && this.launched.isAlive(),
346
+ canReconnect: this.budget.canReconnect(),
347
+ canRestart: this.budget.canRestart(),
348
+ });
349
+ // 1) 进程还在:CDP 会话被浏览器自己关掉了,重连即可(最多 5 次)
350
+ if (decision === 'reconnect' && this.launched !== null) {
351
+ this.budget.noteReconnect();
352
+ try {
353
+ this.transport = await connectWithRetry(this.launched.endpoint, this.connectOptions, signal);
354
+ return this.transport;
355
+ }
356
+ catch (error) {
357
+ throw new Error(`CDP 连接断了,第 ${this.budget.reconnects} 次重连也没成功(${error instanceof Error ? error.message : String(error)})。` +
358
+ '可以再试一次;连着几次都不行就 browser action=close 收掉这台浏览器,下次调用会重开一台');
359
+ }
360
+ }
361
+ if (decision === 'fail') {
362
+ throw new Error(`受控浏览器反复退出或连不上(重连 ${this.budget.reconnects} 次、重开 ${this.budget.restarts} 次都没稳住)。` +
363
+ '先 browser action=close 收掉它,再检查是不是有别的程序在杀浏览器进程');
364
+ }
365
+ // 2) 进程死了(或重连额度用完):重开一台。
366
+ // 额度在「启动之前」就扣,起不来也算一次——否则启动失败会变成无限重开。
367
+ this.budget.noteRestart();
368
+ if (this.launched !== null)
369
+ this.killSync(); // 清掉可能残留的整棵进程树,再重开
370
+ const signalOrNever = signal ?? new AbortController().signal;
371
+ try {
372
+ this.launched = await launchBrowser(this.readConfig(), signalOrNever);
373
+ }
374
+ catch (error) {
375
+ throw new Error(`启动受控浏览器失败:${error instanceof Error ? error.message : String(error)}`);
376
+ }
377
+ this.transport = await connectWithRetry(this.launched.endpoint, this.connectOptions, signal);
378
+ return this.transport;
379
+ }
380
+ /**
381
+ * 收掉这台浏览器:整树杀 → 等 300ms → 删自建 profile。
382
+ * 同步实现是刻意的:`apply` 返回的 disposer 与 `dsc/exit` 监听器都必须同步跑完,
383
+ * 异步清理在这里会被宿主直接跳过。
384
+ */
385
+ killSync() {
386
+ const current = this.launched;
387
+ this.transport?.close();
388
+ this.transport = null;
389
+ this.launched = null;
390
+ if (current === null)
391
+ return;
392
+ if (current.pid !== 0)
393
+ killProcessTree(current.pid);
394
+ // 等句柄释放再删目录:Chrome 退出后要几十到几百毫秒才放开 profile 里的文件
395
+ sleepSync(300);
396
+ if (current.ownedProfile)
397
+ removeProfileDirSync(current.profileDir);
398
+ }
399
+ /** 永久收工(插件卸载/宿主退出):killSync 之外再记一笔「别再自动重开」。 */
400
+ shutdown() {
401
+ this.closed = true;
402
+ this.killSync();
403
+ }
404
+ /**
405
+ * 用户主动关掉(`browser action=close` 与设置里的「关闭浏览器」):
406
+ * 资源照样清干净,但重试额度重置——下次调用工具是一次干净的新开始,
407
+ * 不能因为用户关过两次浏览器就说「反复退出」。
408
+ */
409
+ close() {
410
+ this.killSync();
411
+ this.budget.reset();
412
+ }
413
+ }
414
+ /** 建连重试:浏览器刚起来时监听可能还差一拍。 */
415
+ async function connectWithRetry(endpoint, options, signal) {
416
+ let lastError = null;
417
+ for (let attempt = 0; attempt < 3; attempt += 1) {
418
+ try {
419
+ return await CdpTransport.open(endpoint, options, signal);
420
+ }
421
+ catch (error) {
422
+ lastError = error instanceof Error ? error : new Error(String(error));
423
+ await delay(200, signal);
424
+ }
425
+ }
426
+ throw lastError ?? new Error('CDP 建连失败');
427
+ }
428
+ /**
429
+ * 整树杀进程。
430
+ *
431
+ * Windows 没有进程组,`child.kill()` 只带走主进程,renderer/gpu/utility 会变成孤儿
432
+ * 继续攥着 profile;`taskkill /T` 沿着父子关系整棵带走,`/F` 是必须的(Chrome
433
+ * 对 SIGTERM 类软信号经常不理)。
434
+ * 非 Windows 退回 `process.kill`(这条代码路径主要面向 Windows,留着是为了不炸)。
435
+ */
436
+ export function killProcessTree(pid) {
437
+ if (!Number.isInteger(pid) || pid <= 0)
438
+ return;
439
+ if (process.platform === 'win32') {
440
+ try {
441
+ spawnSync('taskkill', ['/PID', String(pid), '/T', '/F'], { stdio: 'ignore', windowsHide: true });
442
+ }
443
+ catch {
444
+ // taskkill 不在 PATH 或进程已经没了:忽略,反正后面还会删目录
445
+ }
446
+ return;
447
+ }
448
+ try {
449
+ process.kill(pid, 'SIGKILL');
450
+ }
451
+ catch {
452
+ // 进程已经没了
453
+ }
454
+ }
455
+ /** 递归删 profile 目录(删不掉就留着,别把退出流程搞崩)。 */
456
+ export function removeProfileDirSync(dir) {
457
+ try {
458
+ rmSync(dir, { recursive: true, force: true, maxRetries: 3, retryDelay: 200 });
459
+ }
460
+ catch {
461
+ // 有句柄没放开时会失败;下一次启动用新目录,不影响功能
462
+ }
463
+ }
464
+ /** 同步睡一会儿(disposer 里不能 await)。 */
465
+ export function sleepSync(ms) {
466
+ if (ms <= 0)
467
+ return;
468
+ Atomics.wait(new Int32Array(new SharedArrayBuffer(4)), 0, 0, ms);
469
+ }
470
+ /** 可取消的延时。 */
471
+ function delay(ms, signal) {
472
+ return new Promise((resolvePromise, rejectPromise) => {
473
+ const timer = setTimeout(() => {
474
+ if (signal !== undefined)
475
+ signal.removeEventListener('abort', onAbort);
476
+ resolvePromise();
477
+ }, ms);
478
+ const onAbort = () => {
479
+ clearTimeout(timer);
480
+ rejectPromise(new Error('操作已取消'));
481
+ };
482
+ if (signal !== undefined) {
483
+ if (signal.aborted) {
484
+ clearTimeout(timer);
485
+ rejectPromise(new Error('操作已取消'));
486
+ return;
487
+ }
488
+ signal.addEventListener('abort', onAbort, { once: true });
489
+ }
490
+ });
491
+ }