@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,649 @@
1
+ /**
2
+ * CDP 动作层:把「模型给的 ref」变成真正的鼠标键盘事件,外加对话框、上传、frame/tab。
3
+ *
4
+ * 设计要点:
5
+ * 1. **动作前先复核 ref**({@link verifyRef}):`DOM.describeNode` 只能说明「这个后端节点号还在」,
6
+ * 它看不到 ARIA 角色与可访问名——页面把「删除」按钮换成「清空」按钮,后端节点号往往不变。
7
+ * 所以复核要两问:`DOM.describeNode`(还在吗)+ `Accessibility.getPartialAXTree`(role/name 变了吗)。
8
+ * 两家都不对就报「页面已变,请重新 snapshot」,绝不照着旧快照乱点;
9
+ * 2. **定位靠 `DOM.getBoxModel`**:取 content 四边形的中心,再做 `Input.dispatchMouseEvent`
10
+ * moved → pressed → released。不用 `Runtime.evaluate` 自己算坐标:iframe 与滚动偏移
11
+ * 由 CDP 换算好,少一类坐标对不上的 bug;
12
+ * 3. **等待是简化版**:短轮询「box model 算得出来 + 面积非零 + DOM 域已 enable」,
13
+ * **不是** Playwright 那套 actionability(元素稳定、命中测试落在自己身上、
14
+ * receives-events 判定全都没做)。做不到就写在注释与错误信息里,不假装做了;
15
+ * 4. **对话框有超时兜底**:页面弹了 JS 对话框之后,这个页面上的多数 CDP 命令会被浏览器挂住,
16
+ * 只留 `Page.handleJavaScriptDialog` 能过——所以对话框必须在超时后自动放掉,
17
+ * 否则一次 `alert()` 就能把整条自动化卡死(策略与计时在插件层)。
18
+ *
19
+ * 形参一律收 {@link CdpCommandTarget} 而不是 `CdpSessionView`:后者是 WebSocket 连接上的
20
+ * 一个 session,而 dock 视图(侧栏那台浏览器)没有 WebSocket——它由 `createDockSession`
21
+ * 包成同样形状。放宽成结构类型后,两条后端共用这一份动作逻辑,`CdpSessionView` 仍然满足它,
22
+ * 调用方一行不用改。
23
+ *
24
+ * @module dsc/core/cdp/actions
25
+ */
26
+ import { existsSync } from 'node:fs';
27
+ import { isAbsolute, resolve } from 'node:path';
28
+ import { refRecordMatches } from './snapshot.js';
29
+ /** 鼠标键位掩码(dispatchMouseEvent 的 buttons 字段)。 */
30
+ const BUTTON_MASK = { left: 1, right: 2, middle: 4 };
31
+ /** 视口外的点先滚进可视区,再取坐标。 */
32
+ const SCROLL_MARGIN = 8;
33
+ /** 特殊键表(照 `examples/plugins/browser-control.js:241-251` 扩了一版)。 */
34
+ const KEY_TABLE = {
35
+ enter: { vk: 13, code: 'Enter', text: '\r' },
36
+ return: { vk: 13, code: 'Enter', text: '\r' },
37
+ tab: { vk: 9, code: 'Tab', text: '\t' },
38
+ escape: { vk: 27, code: 'Escape' },
39
+ esc: { vk: 27, code: 'Escape' },
40
+ backspace: { vk: 8, code: 'Backspace' },
41
+ delete: { vk: 46, code: 'Delete' },
42
+ del: { vk: 46, code: 'Delete' },
43
+ insert: { vk: 45, code: 'Insert' },
44
+ arrowup: { vk: 38, code: 'ArrowUp' },
45
+ arrowdown: { vk: 40, code: 'ArrowDown' },
46
+ arrowleft: { vk: 37, code: 'ArrowLeft' },
47
+ arrowright: { vk: 39, code: 'ArrowRight' },
48
+ home: { vk: 36, code: 'Home' },
49
+ end: { vk: 35, code: 'End' },
50
+ pageup: { vk: 33, code: 'PageUp' },
51
+ pagedown: { vk: 34, code: 'PageDown' },
52
+ space: { vk: 32, code: 'Space', text: ' ' },
53
+ f1: { vk: 112, code: 'F1' },
54
+ f2: { vk: 113, code: 'F2' },
55
+ f3: { vk: 114, code: 'F3' },
56
+ f4: { vk: 115, code: 'F4' },
57
+ f5: { vk: 116, code: 'F5' },
58
+ f6: { vk: 117, code: 'F6' },
59
+ f7: { vk: 118, code: 'F7' },
60
+ f8: { vk: 119, code: 'F8' },
61
+ f9: { vk: 120, code: 'F9' },
62
+ f10: { vk: 121, code: 'F10' },
63
+ f11: { vk: 122, code: 'F11' },
64
+ f12: { vk: 123, code: 'F12' },
65
+ };
66
+ /** 修饰键位掩码。 */
67
+ const MODIFIER_TABLE = {
68
+ alt: 1,
69
+ option: 1,
70
+ ctrl: 2,
71
+ control: 2,
72
+ meta: 4,
73
+ win: 4,
74
+ cmd: 4,
75
+ command: 4,
76
+ super: 4,
77
+ shift: 8,
78
+ };
79
+ /** 敏感原语黑名单:网页上下文里这些本来也不该出现,出现就说明这次求值来路不对。 */
80
+ const SENSITIVE_PRIMITIVES = [
81
+ { name: 'require(', re: /(?<![\w.])require\s*\(/ },
82
+ { name: 'process.binding', re: /process\s*\.\s*binding\b/ },
83
+ { name: 'process.mainModule', re: /process\s*\.\s*mainModule\b/ },
84
+ { name: 'process.dlopen', re: /process\s*\.\s*dlopen\b/ },
85
+ { name: 'module.constructor', re: /module\s*\.\s*constructor\b/ },
86
+ { name: 'child_process', re: /child_process/ },
87
+ { name: 'electron', re: /\belectron\b\s*\.\s*(?:remote|ipcRenderer)/ },
88
+ ];
89
+ /**
90
+ * 解析键名。
91
+ *
92
+ * 支持 `enter` / `ctrl+a` / `Control+Shift+Delete` 这类写法。
93
+ * 字母与数字按键现算虚拟键码(虚拟键码就是大写 ASCII)。
94
+ */
95
+ export function resolveKey(key) {
96
+ const parts = key.split('+').map((part) => part.trim()).filter((part) => part !== '');
97
+ if (parts.length === 0)
98
+ throw new Error('按键名是空的');
99
+ const main = parts[parts.length - 1];
100
+ let modifiers = 0;
101
+ for (const part of parts.slice(0, -1)) {
102
+ const bit = MODIFIER_TABLE[part.toLowerCase()];
103
+ if (bit === undefined)
104
+ throw new Error(`不认识的修饰键:${part}(可用 Ctrl/Alt/Shift/Meta)`);
105
+ modifiers |= bit;
106
+ }
107
+ const special = KEY_TABLE[main.toLowerCase()];
108
+ if (special !== undefined) {
109
+ const stroke = { key: special.code, code: special.code, vk: special.vk, modifiers };
110
+ // 带 Ctrl/Alt/Meta 的按键不该产生字符(Ctrl+A 是全选,不是输入一个 a)
111
+ if (special.text !== undefined && (modifiers & (1 | 2 | 4)) === 0)
112
+ stroke.text = special.text;
113
+ return stroke;
114
+ }
115
+ if ([...main].length === 1) {
116
+ const char = main;
117
+ const upper = char.toUpperCase();
118
+ const vk = upper.charCodeAt(0);
119
+ const isLetter = /[A-Za-z]/.test(char);
120
+ const isDigit = /[0-9]/.test(char);
121
+ const stroke = {
122
+ key: char,
123
+ code: isLetter ? `Key${upper}` : isDigit ? `Digit${char}` : '',
124
+ vk,
125
+ modifiers,
126
+ };
127
+ if ((modifiers & (1 | 2 | 4)) === 0)
128
+ stroke.text = (modifiers & 8) !== 0 ? upper : char;
129
+ return stroke;
130
+ }
131
+ throw new Error(`不认识的按键:${key}。可用:Enter / Tab / Escape / Backspace / Delete / 方向键 / Home / End / PageUp / PageDown / Space / F1-F12 / 单个字符,组合键写成 ctrl+a`);
132
+ }
133
+ /**
134
+ * 求值表达式预扫:敏感原语 + 地址字面量。
135
+ *
136
+ * 这一步是**给守卫看的**(守卫在动手前拒绝),不是沙箱:页面里的 JS 本来就跑在网页上下文,
137
+ * 真正要拦的是「模型写了个从本机读东西的表达式」和「表达式里塞了个私网/元数据地址」。
138
+ */
139
+ export function scanExpression(expression) {
140
+ const sensitive = [];
141
+ for (const { name, re } of SENSITIVE_PRIMITIVES) {
142
+ if (new RegExp(re.source, re.flags).test(expression))
143
+ sensitive.push(name);
144
+ }
145
+ const urls = [];
146
+ // 用 `\S+` 而不是自己写字符类:少一个量词就会退化成「http:// 加一个字符」,
147
+ // 尾部的引号/括号/逗号由 TRIM_TAIL 去掉,判定才是干净的地址。
148
+ for (const match of expression.matchAll(URL_PATTERN)) {
149
+ const url = match[0].replace(TRIM_TAIL, '');
150
+ if (url !== '')
151
+ urls.push(url);
152
+ }
153
+ return { sensitive, urls };
154
+ }
155
+ /** 表达式里的地址字面量(最小匹配到空白为止,再修掉尾巴)。 */
156
+ const URL_PATTERN = /https?:\/\/\S+/gi;
157
+ /** 地址尾巴上不该算进去的标点。 */
158
+ const TRIM_TAIL = /["'`<>)\],;]+$/;
159
+ /**
160
+ * 复核 ref 还指得着同一个东西。
161
+ *
162
+ * 抛错信息统一成「页面已变,请重新 snapshot」,模型照做即可自愈。
163
+ */
164
+ export async function verifyRef(page, ref) {
165
+ const stale = () => new Error(`ref「${ref.ref}」对应的元素已经变了(${ref.role}${ref.name === '' ? '' : ` "${ref.name}"`} 不在原处或已换名):` +
166
+ '页面已变,请重新 snapshot(browser_look action=snapshot)拿新 ref 再动手');
167
+ let described;
168
+ try {
169
+ described = await page.send('DOM.describeNode', {
170
+ backendNodeId: ref.backendNodeId,
171
+ });
172
+ }
173
+ catch {
174
+ throw stale(); // 后端节点号已经算不出节点:元素被删了
175
+ }
176
+ const backendNodeId = described.node?.backendNodeId;
177
+ if (typeof backendNodeId !== 'number' || backendNodeId !== ref.backendNodeId)
178
+ throw stale();
179
+ // describeNode 看不到 ARIA 角色与可访问名,必须再问一次无障碍域
180
+ let partial;
181
+ try {
182
+ partial = await page.send('Accessibility.getPartialAXTree', {
183
+ backendNodeId: ref.backendNodeId,
184
+ fetchRelatives: false,
185
+ });
186
+ }
187
+ catch {
188
+ throw stale();
189
+ }
190
+ const node = (partial.nodes ?? []).find((candidate) => candidate.backendDOMNodeId === ref.backendNodeId) ?? partial.nodes?.[0];
191
+ if (!refRecordMatches(ref, node))
192
+ throw stale();
193
+ }
194
+ /**
195
+ * 等元素有非空 box model,并算出可点中心。
196
+ *
197
+ * 这是**简化版**可交互等待:只问「框算得出来吗、面积是不是零」,
198
+ * 没做 Playwright 那套(元素在两次测量之间是否稳定、中心点命中测试是否落在自己身上、
199
+ * 上方有没有别的东西挡住)。所以点完必须再看一眼页面,别假设一定生效。
200
+ */
201
+ export async function waitForClickPoint(page, ref, timeoutMs, signal) {
202
+ const deadline = Date.now() + Math.max(0, timeoutMs);
203
+ let lastProblem = '还没等到元素出现';
204
+ for (;;) {
205
+ signal?.throwIfAborted();
206
+ let model = null;
207
+ try {
208
+ // 注意 `DOM.getBoxModel` 的应答是**两层**:`{ model: { content: [...] } }`。写成
209
+ // `send<{content?}>` 再读 `.content` 会永远拿到 undefined,然后安静地等到超时。
210
+ model = await page.send('DOM.getBoxModel', { backendNodeId: ref.backendNodeId });
211
+ }
212
+ catch (error) {
213
+ lastProblem = error instanceof Error ? error.message : String(error);
214
+ }
215
+ const content = model?.model?.content;
216
+ if (content !== undefined && content.length >= 8) {
217
+ const points = quadToPoints(content);
218
+ if (quadArea(points) > 0) {
219
+ const center = quadCenter(points);
220
+ if (await ensureInViewport(page, ref.backendNodeId, center)) {
221
+ const refreshed = await boxCenter(page, ref.backendNodeId);
222
+ if (refreshed !== null)
223
+ return refreshed;
224
+ }
225
+ else {
226
+ lastProblem = '元素在视口外,滚动后还是没进可视区';
227
+ }
228
+ }
229
+ else {
230
+ lastProblem = '元素算得出框,但面积是零(不可见)';
231
+ }
232
+ }
233
+ if (Date.now() >= deadline) {
234
+ throw new Error(`等 ref「${ref.ref}」可点击超时(${timeoutMs}ms):${lastProblem}。` +
235
+ '这是简化版等待(只看框算不算得出来),页面如果还在加载,可以加大 waitTimeoutMs 或先 browser_look action=wait_for');
236
+ }
237
+ await sleep(100, signal);
238
+ }
239
+ }
240
+ /** 点击(moved → pressed → released;双击发两轮,第二轮 clickCount=2)。 */
241
+ export async function clickRef(page, ref, options = {}, signal) {
242
+ await verifyRef(page, ref);
243
+ await assertEnabled(page, ref);
244
+ const timeoutMs = options.timeoutMs ?? 5000;
245
+ const point = await waitForClickPoint(page, ref, timeoutMs, signal);
246
+ const button = options.button ?? 'left';
247
+ const mask = BUTTON_MASK[button] ?? 1;
248
+ const clicks = options.double === true ? 2 : 1;
249
+ await page.send('Input.dispatchMouseEvent', { type: 'mouseMoved', x: point.x, y: point.y, button: 'none', buttons: 0 });
250
+ const rounds = options.double === true ? [1, 2] : [1];
251
+ for (const clickCount of rounds) {
252
+ await page.send('Input.dispatchMouseEvent', {
253
+ type: 'mousePressed',
254
+ x: point.x,
255
+ y: point.y,
256
+ button,
257
+ buttons: mask,
258
+ clickCount,
259
+ });
260
+ await page.send('Input.dispatchMouseEvent', {
261
+ type: 'mouseReleased',
262
+ x: point.x,
263
+ y: point.y,
264
+ button,
265
+ buttons: 0,
266
+ clickCount,
267
+ });
268
+ }
269
+ return { ...point, clicks, button };
270
+ }
271
+ /** 悬停(只发 mouseMoved,不按)。 */
272
+ export async function hoverRef(page, ref, timeoutMs = 5000, signal) {
273
+ await verifyRef(page, ref);
274
+ const point = await waitForClickPoint(page, ref, timeoutMs, signal);
275
+ await page.send('Input.dispatchMouseEvent', { type: 'mouseMoved', x: point.x, y: point.y, button: 'none', buttons: 0 });
276
+ return point;
277
+ }
278
+ /** 往元素里输入文本(`DOM.focus` + `Input.insertText`,中文与特殊字符都过)。 */
279
+ export async function typeIntoRef(page, ref, text, options = {}) {
280
+ await verifyRef(page, ref);
281
+ await assertEnabled(page, ref);
282
+ await page.send('DOM.focus', { backendNodeId: ref.backendNodeId });
283
+ let cleared = false;
284
+ if (options.clear === true) {
285
+ // 全选 + 删:比读一次旧值再逐字退格可靠(值可能是密码框里的点,读不出来)
286
+ await pressKey(page, 'ctrl+a');
287
+ await pressKey(page, 'Delete');
288
+ cleared = true;
289
+ }
290
+ if (text !== '')
291
+ await page.send('Input.insertText', { text });
292
+ let submitted = false;
293
+ if (options.submit === true) {
294
+ await pressKey(page, 'Enter');
295
+ submitted = true;
296
+ }
297
+ return { chars: [...text].length, cleared, submitted };
298
+ }
299
+ /** 按键(可先聚焦某个 ref)。 */
300
+ export async function pressKey(page, key, ref) {
301
+ const stroke = resolveKey(key);
302
+ if (ref !== undefined)
303
+ await page.send('DOM.focus', { backendNodeId: ref.backendNodeId });
304
+ const base = {
305
+ modifiers: stroke.modifiers,
306
+ windowsVirtualKeyCode: stroke.vk,
307
+ nativeVirtualKeyCode: stroke.vk,
308
+ key: stroke.key,
309
+ };
310
+ if (stroke.code !== '')
311
+ base.code = stroke.code;
312
+ // 带修饰键的按键用 rawKeyDown:keyDown 会顺带产出字符,Ctrl+A 会变成「输入 a」
313
+ const downType = stroke.text === undefined ? 'rawKeyDown' : 'keyDown';
314
+ await page.send('Input.dispatchKeyEvent', {
315
+ ...base,
316
+ type: downType,
317
+ ...(stroke.text === undefined ? {} : { text: stroke.text, unmodifiedText: stroke.text }),
318
+ });
319
+ await page.send('Input.dispatchKeyEvent', { ...base, type: 'keyUp' });
320
+ return stroke;
321
+ }
322
+ /** 选择下拉项(按 value 或可见文本匹配,大小写与首尾空白都忽略)。 */
323
+ export async function selectRef(page, ref, values) {
324
+ await verifyRef(page, ref);
325
+ // 同 `getBoxModel`:`DOM.resolveNode` 的应答也是两层——`{ object: { objectId } }`。
326
+ const resolved = await page.send('DOM.resolveNode', { backendNodeId: ref.backendNodeId });
327
+ const objectId = resolved.object?.objectId;
328
+ if (typeof objectId !== 'string')
329
+ throw new Error(`ref「${ref.ref}」拿不到页面里的对象句柄,可能已经不是元素了`);
330
+ const response = await page.send('Runtime.callFunctionOn', {
331
+ objectId,
332
+ functionDeclaration: `function (wanted) {
333
+ if (typeof this.options === 'undefined') return null;
334
+ const wantedList = wanted.map((v) => String(v).trim().toLowerCase());
335
+ for (const option of Array.from(this.options)) {
336
+ const value = String(option.value).trim().toLowerCase();
337
+ const label = String(option.textContent ?? '').trim().toLowerCase();
338
+ option.selected = wantedList.includes(value) || wantedList.includes(label);
339
+ }
340
+ this.dispatchEvent(new Event('input', { bubbles: true }));
341
+ this.dispatchEvent(new Event('change', { bubbles: true }));
342
+ return Array.from(this.selectedOptions ?? []).map((option) => String(option.textContent ?? '').trim());
343
+ }`,
344
+ arguments: [{ value: [...values] }],
345
+ returnByValue: true,
346
+ });
347
+ if (response.exceptionDetails !== undefined) {
348
+ throw new Error(`设置下拉项时页面报错:${response.exceptionDetails.text ?? '未知异常'}`);
349
+ }
350
+ if (response.result?.value === null || response.result?.value === undefined) {
351
+ throw new Error(`ref「${ref.ref}」不是 <select>(没有 options),下拉选择用不上它`);
352
+ }
353
+ const selected = Array.isArray(response.result.value) ? response.result.value.map((item) => String(item)) : [];
354
+ if (selected.length === 0)
355
+ throw new Error(`给定的值 ${values.join('、')} 在这个下拉里一个都没匹配上`);
356
+ return { selected };
357
+ }
358
+ /** 滚动:方向上用鼠标滚轮事件(跟真人一样会触发 scroll 与懒加载),top/bottom 直接用 scrollTo。 */
359
+ export async function scrollPage(page, options = {}, signal) {
360
+ const direction = options.direction ?? 'down';
361
+ if (direction === 'top' || direction === 'bottom') {
362
+ const target = direction === 'top' ? '0' : 'Math.max(document.body.scrollHeight, document.documentElement.scrollHeight)';
363
+ await page.send('Runtime.evaluate', {
364
+ expression: `window.scrollTo(0, ${target}); document.scrollingElement ? document.scrollingElement.scrollTop : 0`,
365
+ returnByValue: true,
366
+ });
367
+ return { x: 0, y: 0, deltaX: 0, deltaY: 0 };
368
+ }
369
+ const amount = Math.abs(options.deltaY ?? options.deltaX ?? 500);
370
+ const deltaX = direction === 'left' ? -amount : direction === 'right' ? amount : (options.deltaX ?? 0);
371
+ const deltaY = direction === 'up' ? -amount : direction === 'down' ? amount : (options.deltaY ?? 0);
372
+ let point;
373
+ if (options.ref !== undefined) {
374
+ point = await waitForClickPoint(page, options.ref, options.timeoutMs ?? 5000, signal);
375
+ }
376
+ else {
377
+ const metrics = await page.send('Page.getLayoutMetrics');
378
+ const width = metrics.cssLayoutViewport?.clientWidth ?? 800;
379
+ const height = metrics.cssLayoutViewport?.clientHeight ?? 600;
380
+ point = { x: Math.round(width / 2), y: Math.round(height / 2) };
381
+ }
382
+ await page.send('Input.dispatchMouseEvent', {
383
+ type: 'mouseWheel',
384
+ x: point.x,
385
+ y: point.y,
386
+ deltaX,
387
+ deltaY,
388
+ });
389
+ return { x: point.x, y: point.y, deltaX, deltaY };
390
+ }
391
+ /** 一次填多个字段(先把所有 ref 复核完再动手,避免填一半才发现有个 ref 过期)。 */
392
+ export async function fillForm(page, entries, options = {}) {
393
+ for (const entry of entries) {
394
+ await verifyRef(page, entry.ref);
395
+ await assertEnabled(page, entry.ref);
396
+ }
397
+ const fields = [];
398
+ for (const entry of entries) {
399
+ await typeIntoRef(page, entry.ref, entry.value, { clear: options.clear !== false });
400
+ fields.push(entry.ref.ref);
401
+ }
402
+ return { filled: fields.length, fields };
403
+ }
404
+ /**
405
+ * 页面内求值。
406
+ *
407
+ * `returnByValue: true` 让普通值直接回来;对象拿不到值就用 `description` 兜底(形如 `Object`)。
408
+ * 结果一律 JSON 化再截断:页面可能返回整个 DOM,全文塞回模型就是白烧上下文。
409
+ */
410
+ export async function evaluateInPage(page, expression, timeoutMs = 15_000) {
411
+ const response = await page.send('Runtime.evaluate', { expression, returnByValue: true, awaitPromise: true, timeout: timeoutMs });
412
+ if (response.exceptionDetails !== undefined) {
413
+ const detail = response.exceptionDetails.exception?.description ?? response.exceptionDetails.text ?? '未知异常';
414
+ throw new Error(`页面 JS 抛异常:${detail.split('\n')[0]?.slice(0, 300) ?? detail}`);
415
+ }
416
+ const raw = response.result?.value;
417
+ let text;
418
+ if (raw !== undefined) {
419
+ try {
420
+ text = typeof raw === 'string' ? raw : JSON.stringify(raw) ?? String(raw);
421
+ }
422
+ catch {
423
+ text = String(raw);
424
+ }
425
+ }
426
+ else {
427
+ text = response.result?.description ?? String(response.result?.type ?? 'undefined');
428
+ }
429
+ const truncated = text.length > 2000;
430
+ return { text: truncated ? `${text.slice(0, 2000)}…(结果更长,已截断到 2000 字)` : text, truncated };
431
+ }
432
+ /** 给文件输入框塞本机文件。 */
433
+ export async function uploadFiles(page, ref, paths, baseDir) {
434
+ if (paths.length === 0)
435
+ throw new Error('没有给要上传的文件路径');
436
+ const files = paths.map((entry) => {
437
+ const full = isAbsolute(entry) ? entry : resolve(baseDir, entry);
438
+ if (!existsSync(full))
439
+ throw new Error(`要上传的文件不存在:${full}`);
440
+ return full; // Windows 上用原生反斜杠路径,DOM.setFileInputFiles 就这么收
441
+ });
442
+ await verifyRef(page, ref);
443
+ await page.send('DOM.setFileInputFiles', { files, backendNodeId: ref.backendNodeId });
444
+ return { files };
445
+ }
446
+ /** 应答(或关掉)JS 对话框。 */
447
+ export async function handleDialog(page, options) {
448
+ await page.send('Page.handleJavaScriptDialog', {
449
+ accept: options.accept,
450
+ ...(options.promptText === undefined ? {} : { promptText: options.promptText }),
451
+ });
452
+ }
453
+ /** 截图。 */
454
+ export async function captureScreenshot(page, fullPage) {
455
+ const shot = await page.send('Page.captureScreenshot', {
456
+ format: 'png',
457
+ ...(fullPage ? { captureBeyondViewport: true } : {}),
458
+ });
459
+ if (typeof shot.data !== 'string' || shot.data === '')
460
+ throw new Error('截图失败:浏览器没返回图像数据');
461
+ return { base64: shot.data, fullPage };
462
+ }
463
+ /** 读页面地址、标题与加载状态。 */
464
+ export async function readDocumentState(page) {
465
+ const response = await page.send('Runtime.evaluate', {
466
+ expression: '({ url: location.href, title: document.title, readyState: document.readyState })',
467
+ returnByValue: true,
468
+ });
469
+ const value = response.result?.value;
470
+ return {
471
+ url: typeof value?.url === 'string' ? value.url : '',
472
+ title: typeof value?.title === 'string' ? value.title : '',
473
+ readyState: typeof value?.readyState === 'string' ? value.readyState : 'unknown',
474
+ };
475
+ }
476
+ /** 等页面加载完(readyState 到 interactive/complete 就算,别为了一两个慢图片卡死)。 */
477
+ export async function waitForPageLoad(page, timeoutMs = 15_000, signal) {
478
+ const deadline = Date.now() + timeoutMs;
479
+ let state = await readDocumentState(page);
480
+ while (state.readyState !== 'complete' && state.readyState !== 'interactive') {
481
+ if (Date.now() >= deadline)
482
+ return state;
483
+ await sleep(200, signal);
484
+ try {
485
+ state = await readDocumentState(page);
486
+ }
487
+ catch {
488
+ // 导航中途执行上下文会被换掉,这一轮读失败很正常
489
+ }
490
+ }
491
+ return state;
492
+ }
493
+ /** 等文本出现或选择器命中(wait_for 用)。 */
494
+ export async function waitForCondition(page, condition, timeoutMs, signal) {
495
+ const expression = condition.selector !== undefined && condition.selector !== ''
496
+ ? `!!document.querySelector(${JSON.stringify(condition.selector)})`
497
+ : `!!(document.body && typeof document.body.innerText === 'string' && document.body.innerText.includes(${JSON.stringify(condition.text ?? '')}))`;
498
+ const started = Date.now();
499
+ for (;;) {
500
+ signal?.throwIfAborted();
501
+ try {
502
+ const response = await page.send('Runtime.evaluate', { expression, returnByValue: true });
503
+ if (response.result?.value === true)
504
+ return { matched: true, waitedMs: Date.now() - started };
505
+ }
506
+ catch {
507
+ // 页面正在导航:这一轮当没命中
508
+ }
509
+ if (Date.now() - started >= timeoutMs)
510
+ return { matched: false, waitedMs: Date.now() - started };
511
+ await sleep(200, signal);
512
+ }
513
+ }
514
+ /** 设下载目录(不设的话下载会落在临时 profile 里,关掉浏览器就没了)。 */
515
+ export async function setDownloadBehavior(sender, downloadDir) {
516
+ await sender.send('Browser.setDownloadBehavior', {
517
+ behavior: 'allow',
518
+ downloadPath: downloadDir,
519
+ eventsEnabled: false,
520
+ });
521
+ }
522
+ /** 列全部目标(标签页 + 独立进程 iframe,后者靠它才能 frame 进去)。 */
523
+ export async function listTargets(browser) {
524
+ const response = await browser.send('Target.getTargets');
525
+ return response.targetInfos ?? [];
526
+ }
527
+ /** 附加到目标(flatten 才支持一条连接里挂多个 session)。返回 sessionId。 */
528
+ export async function attachToTarget(browser, targetId) {
529
+ const response = await browser.send('Target.attachToTarget', { targetId, flatten: true });
530
+ if (typeof response.sessionId !== 'string' || response.sessionId === '') {
531
+ throw new Error(`附加到目标 ${targetId} 失败:浏览器没给 sessionId`);
532
+ }
533
+ return response.sessionId;
534
+ }
535
+ /** 新开标签页。 */
536
+ export async function createTarget(browser, url) {
537
+ const response = await browser.send('Target.createTarget', { url });
538
+ if (typeof response.targetId !== 'string' || response.targetId === '')
539
+ throw new Error('新建标签页失败:浏览器没给 targetId');
540
+ return response.targetId;
541
+ }
542
+ /** 关标签页。 */
543
+ export async function closeTarget(browser, targetId) {
544
+ await browser.send('Target.closeTarget', { targetId });
545
+ }
546
+ /** 把标签页切到前台(不然截图拿到的是别的页)。 */
547
+ export async function activateTarget(browser, targetId) {
548
+ await browser.send('Target.activateTarget', { targetId });
549
+ }
550
+ /** 取页面主框架的 frameId(frame 路由要用)。 */
551
+ export async function mainFrameId(page) {
552
+ const tree = await page.send('Page.getFrameTree');
553
+ const id = tree.frameTree?.frame?.id;
554
+ return typeof id === 'string' ? id : '';
555
+ }
556
+ /** 元素是不是禁用了(禁用就别点,点了也不会生效,白白让模型以为成功)。 */
557
+ async function assertEnabled(page, ref) {
558
+ try {
559
+ const partial = await page.send('Accessibility.getPartialAXTree', {
560
+ backendNodeId: ref.backendNodeId,
561
+ fetchRelatives: false,
562
+ });
563
+ const node = (partial.nodes ?? [])[0];
564
+ const disabled = (node?.properties ?? []).find((property) => property.name?.toLowerCase() === 'disabled');
565
+ if (disabled?.value?.value === true || disabled?.value?.value === 'true') {
566
+ throw new Error(`ref「${ref.ref}」现在是禁用状态(disabled),点它/填它都不会生效;先解决页面上的前置条件`);
567
+ }
568
+ }
569
+ catch (error) {
570
+ // 「禁用」这个判断是我们自己抛的,别的错误(取不到无障碍信息)不该拦住动作
571
+ if (error instanceof Error && error.message.includes('禁用状态'))
572
+ throw error;
573
+ }
574
+ }
575
+ /** 元素不在视口里就滚进来。返回 false = 滚了还是不在(多半被固定定位挡住或页面不滚)。 */
576
+ async function ensureInViewport(page, backendNodeId, point) {
577
+ const metrics = await page.send('Page.getLayoutMetrics');
578
+ const width = metrics.cssLayoutViewport?.clientWidth ?? 0;
579
+ const height = metrics.cssLayoutViewport?.clientHeight ?? 0;
580
+ if (width === 0 || height === 0)
581
+ return true; // 拿不到视口尺寸就别自作聪明
582
+ const visible = point.x >= SCROLL_MARGIN && point.y >= SCROLL_MARGIN && point.x <= width - SCROLL_MARGIN && point.y <= height - SCROLL_MARGIN;
583
+ if (visible)
584
+ return true;
585
+ await page.send('DOM.scrollIntoViewIfNeeded', { backendNodeId });
586
+ const again = await boxCenter(page, backendNodeId);
587
+ if (again === null)
588
+ return false;
589
+ return again.x >= 0 && again.y >= 0 && again.x <= width && again.y <= height;
590
+ }
591
+ /** 直接取 box model 的中心(不滚动、不等待)。 */
592
+ async function boxCenter(page, backendNodeId) {
593
+ try {
594
+ const model = await page.send('DOM.getBoxModel', { backendNodeId });
595
+ const content = model.model?.content;
596
+ if (content === undefined || content.length < 8)
597
+ return null;
598
+ const center = quadCenter(quadToPoints(content));
599
+ return { x: Math.round(center.x), y: Math.round(center.y) };
600
+ }
601
+ catch {
602
+ return null;
603
+ }
604
+ }
605
+ /** 四边形(8 个数)→ 4 个点。 */
606
+ function quadToPoints(quad) {
607
+ return [
608
+ { x: quad[0] ?? 0, y: quad[1] ?? 0 },
609
+ { x: quad[2] ?? 0, y: quad[3] ?? 0 },
610
+ { x: quad[4] ?? 0, y: quad[5] ?? 0 },
611
+ { x: quad[6] ?? 0, y: quad[7] ?? 0 },
612
+ ];
613
+ }
614
+ /** 四边形面积(鞋带公式;零面积 = 看不见)。 */
615
+ function quadArea(points) {
616
+ let sum = 0;
617
+ for (let index = 0; index < points.length; index += 1) {
618
+ const current = points[index];
619
+ const next = points[(index + 1) % points.length];
620
+ sum += current.x * next.y - next.x * current.y;
621
+ }
622
+ return Math.abs(sum) / 2;
623
+ }
624
+ /** 四边形中心。 */
625
+ function quadCenter(points) {
626
+ const sum = points.reduce((acc, point) => ({ x: acc.x + point.x, y: acc.y + point.y }), { x: 0, y: 0 });
627
+ return { x: sum.x / points.length, y: sum.y / points.length };
628
+ }
629
+ /** 可取消的短延时。 */
630
+ function sleep(ms, signal) {
631
+ return new Promise((resolvePromise, rejectPromise) => {
632
+ const timer = setTimeout(() => {
633
+ signal?.removeEventListener('abort', onAbort);
634
+ resolvePromise();
635
+ }, ms);
636
+ const onAbort = () => {
637
+ clearTimeout(timer);
638
+ rejectPromise(new Error('操作已取消'));
639
+ };
640
+ if (signal !== undefined) {
641
+ if (signal.aborted) {
642
+ clearTimeout(timer);
643
+ rejectPromise(new Error('操作已取消'));
644
+ return;
645
+ }
646
+ signal.addEventListener('abort', onAbort, { once: true });
647
+ }
648
+ });
649
+ }