devharness 0.8.0

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 (627) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +185 -0
  3. package/build/atomic-write.d.ts +28 -0
  4. package/build/atomic-write.d.ts.map +1 -0
  5. package/build/atomic-write.js +126 -0
  6. package/build/atomic-write.js.map +1 -0
  7. package/build/cdp-manager.d.ts +524 -0
  8. package/build/cdp-manager.d.ts.map +1 -0
  9. package/build/cdp-manager.js +1828 -0
  10. package/build/cdp-manager.js.map +1 -0
  11. package/build/cdp-manager.test.d.ts +6 -0
  12. package/build/cdp-manager.test.d.ts.map +1 -0
  13. package/build/cdp-manager.test.js +546 -0
  14. package/build/cdp-manager.test.js.map +1 -0
  15. package/build/chrome-launcher.d.ts +400 -0
  16. package/build/chrome-launcher.d.ts.map +1 -0
  17. package/build/chrome-launcher.js +1071 -0
  18. package/build/chrome-launcher.js.map +1 -0
  19. package/build/chrome-launcher.test.d.ts +11 -0
  20. package/build/chrome-launcher.test.d.ts.map +1 -0
  21. package/build/chrome-launcher.test.js +204 -0
  22. package/build/chrome-launcher.test.js.map +1 -0
  23. package/build/clickable-cache.d.ts +73 -0
  24. package/build/clickable-cache.d.ts.map +1 -0
  25. package/build/clickable-cache.js +90 -0
  26. package/build/clickable-cache.js.map +1 -0
  27. package/build/command-recorder.d.ts +401 -0
  28. package/build/command-recorder.d.ts.map +1 -0
  29. package/build/command-recorder.js +701 -0
  30. package/build/command-recorder.js.map +1 -0
  31. package/build/config.d.ts +390 -0
  32. package/build/config.d.ts.map +1 -0
  33. package/build/config.js +826 -0
  34. package/build/config.js.map +1 -0
  35. package/build/config.test.d.ts +2 -0
  36. package/build/config.test.d.ts.map +1 -0
  37. package/build/config.test.js +112 -0
  38. package/build/config.test.js.map +1 -0
  39. package/build/connection-manager.d.ts +159 -0
  40. package/build/connection-manager.d.ts.map +1 -0
  41. package/build/connection-manager.js +432 -0
  42. package/build/connection-manager.js.map +1 -0
  43. package/build/connection-manager.test.d.ts +11 -0
  44. package/build/connection-manager.test.d.ts.map +1 -0
  45. package/build/connection-manager.test.js +114 -0
  46. package/build/connection-manager.test.js.map +1 -0
  47. package/build/console-monitor.d.ts +150 -0
  48. package/build/console-monitor.d.ts.map +1 -0
  49. package/build/console-monitor.js +454 -0
  50. package/build/console-monitor.js.map +1 -0
  51. package/build/dashboard/bundle.js +1 -0
  52. package/build/dashboard/dashboard-client.d.ts +42 -0
  53. package/build/dashboard/dashboard-client.d.ts.map +1 -0
  54. package/build/dashboard/dashboard-client.js +184 -0
  55. package/build/dashboard/dashboard-client.js.map +1 -0
  56. package/build/dashboard/dashboard-hub.d.ts +50 -0
  57. package/build/dashboard/dashboard-hub.d.ts.map +1 -0
  58. package/build/dashboard/dashboard-hub.js +654 -0
  59. package/build/dashboard/dashboard-hub.js.map +1 -0
  60. package/build/dashboard/hub-lock.d.ts +16 -0
  61. package/build/dashboard/hub-lock.d.ts.map +1 -0
  62. package/build/dashboard/hub-lock.js +77 -0
  63. package/build/dashboard/hub-lock.js.map +1 -0
  64. package/build/dashboard/index.d.ts +25 -0
  65. package/build/dashboard/index.d.ts.map +1 -0
  66. package/build/dashboard/index.js +77 -0
  67. package/build/dashboard/index.js.map +1 -0
  68. package/build/dashboard/types.d.ts +83 -0
  69. package/build/dashboard/types.d.ts.map +1 -0
  70. package/build/dashboard/types.js +6 -0
  71. package/build/dashboard/types.js.map +1 -0
  72. package/build/debug-logger.d.ts +85 -0
  73. package/build/debug-logger.d.ts.map +1 -0
  74. package/build/debug-logger.js +195 -0
  75. package/build/debug-logger.js.map +1 -0
  76. package/build/debugger-aware-wrapper.d.ts +37 -0
  77. package/build/debugger-aware-wrapper.d.ts.map +1 -0
  78. package/build/debugger-aware-wrapper.js +128 -0
  79. package/build/debugger-aware-wrapper.js.map +1 -0
  80. package/build/dom-change-monitor.d.ts +92 -0
  81. package/build/dom-change-monitor.d.ts.map +1 -0
  82. package/build/dom-change-monitor.js +437 -0
  83. package/build/dom-change-monitor.js.map +1 -0
  84. package/build/element-collector.d.ts +16 -0
  85. package/build/element-collector.d.ts.map +1 -0
  86. package/build/element-collector.js +207 -0
  87. package/build/element-collector.js.map +1 -0
  88. package/build/error-helpers.d.ts +43 -0
  89. package/build/error-helpers.d.ts.map +1 -0
  90. package/build/error-helpers.js +143 -0
  91. package/build/error-helpers.js.map +1 -0
  92. package/build/formatters/console-formatter.d.ts +160 -0
  93. package/build/formatters/console-formatter.d.ts.map +1 -0
  94. package/build/formatters/console-formatter.js +338 -0
  95. package/build/formatters/console-formatter.js.map +1 -0
  96. package/build/helpers/parser-plugins.d.ts +44 -0
  97. package/build/helpers/parser-plugins.d.ts.map +1 -0
  98. package/build/helpers/parser-plugins.js +102 -0
  99. package/build/helpers/parser-plugins.js.map +1 -0
  100. package/build/helpers/paths.d.ts +79 -0
  101. package/build/helpers/paths.d.ts.map +1 -0
  102. package/build/helpers/paths.js +168 -0
  103. package/build/helpers/paths.js.map +1 -0
  104. package/build/helpers/process-liveness.d.ts +24 -0
  105. package/build/helpers/process-liveness.d.ts.map +1 -0
  106. package/build/helpers/process-liveness.js +36 -0
  107. package/build/helpers/process-liveness.js.map +1 -0
  108. package/build/helpers/process-liveness.test.d.ts +2 -0
  109. package/build/helpers/process-liveness.test.d.ts.map +1 -0
  110. package/build/helpers/process-liveness.test.js +40 -0
  111. package/build/helpers/process-liveness.test.js.map +1 -0
  112. package/build/helpers/sequence-tree.d.ts +27 -0
  113. package/build/helpers/sequence-tree.d.ts.map +1 -0
  114. package/build/helpers/sequence-tree.js +80 -0
  115. package/build/helpers/sequence-tree.js.map +1 -0
  116. package/build/helpers/sequence-tree.test.d.ts +2 -0
  117. package/build/helpers/sequence-tree.test.d.ts.map +1 -0
  118. package/build/helpers/sequence-tree.test.js +122 -0
  119. package/build/helpers/sequence-tree.test.js.map +1 -0
  120. package/build/index.d.ts +3 -0
  121. package/build/index.d.ts.map +1 -0
  122. package/build/index.js +2007 -0
  123. package/build/index.js.map +1 -0
  124. package/build/interaction-recorder.d.ts +214 -0
  125. package/build/interaction-recorder.d.ts.map +1 -0
  126. package/build/interaction-recorder.js +2007 -0
  127. package/build/interaction-recorder.js.map +1 -0
  128. package/build/issue-tracker.d.ts +107 -0
  129. package/build/issue-tracker.d.ts.map +1 -0
  130. package/build/issue-tracker.js +582 -0
  131. package/build/issue-tracker.js.map +1 -0
  132. package/build/issue-tracker.test.d.ts +2 -0
  133. package/build/issue-tracker.test.d.ts.map +1 -0
  134. package/build/issue-tracker.test.js +88 -0
  135. package/build/issue-tracker.test.js.map +1 -0
  136. package/build/launch-chrome-port.test.d.ts +14 -0
  137. package/build/launch-chrome-port.test.d.ts.map +1 -0
  138. package/build/launch-chrome-port.test.js +97 -0
  139. package/build/launch-chrome-port.test.js.map +1 -0
  140. package/build/log-processor/orchestrator.d.ts +32 -0
  141. package/build/log-processor/orchestrator.d.ts.map +1 -0
  142. package/build/log-processor/orchestrator.js +27 -0
  143. package/build/log-processor/orchestrator.js.map +1 -0
  144. package/build/logpoint-execution-tracker.d.ts +57 -0
  145. package/build/logpoint-execution-tracker.d.ts.map +1 -0
  146. package/build/logpoint-execution-tracker.js +112 -0
  147. package/build/logpoint-execution-tracker.js.map +1 -0
  148. package/build/mcp-supervisor.d.ts +3 -0
  149. package/build/mcp-supervisor.d.ts.map +1 -0
  150. package/build/mcp-supervisor.js +211 -0
  151. package/build/mcp-supervisor.js.map +1 -0
  152. package/build/messages.d.ts +165 -0
  153. package/build/messages.d.ts.map +1 -0
  154. package/build/messages.js +574 -0
  155. package/build/messages.js.map +1 -0
  156. package/build/network-monitor.d.ts +172 -0
  157. package/build/network-monitor.d.ts.map +1 -0
  158. package/build/network-monitor.js +350 -0
  159. package/build/network-monitor.js.map +1 -0
  160. package/build/overlays.d.ts +49 -0
  161. package/build/overlays.d.ts.map +1 -0
  162. package/build/overlays.js +409 -0
  163. package/build/overlays.js.map +1 -0
  164. package/build/persistent-profiles.test.d.ts +15 -0
  165. package/build/persistent-profiles.test.d.ts.map +1 -0
  166. package/build/persistent-profiles.test.js +470 -0
  167. package/build/persistent-profiles.test.js.map +1 -0
  168. package/build/port-reserver.d.ts +32 -0
  169. package/build/port-reserver.d.ts.map +1 -0
  170. package/build/port-reserver.js +118 -0
  171. package/build/port-reserver.js.map +1 -0
  172. package/build/puppeteer-manager.d.ts +47 -0
  173. package/build/puppeteer-manager.d.ts.map +1 -0
  174. package/build/puppeteer-manager.js +116 -0
  175. package/build/puppeteer-manager.js.map +1 -0
  176. package/build/recording-coverage.test.d.ts +12 -0
  177. package/build/recording-coverage.test.d.ts.map +1 -0
  178. package/build/recording-coverage.test.js +72 -0
  179. package/build/recording-coverage.test.js.map +1 -0
  180. package/build/reference-validator.d.ts +47 -0
  181. package/build/reference-validator.d.ts.map +1 -0
  182. package/build/reference-validator.js +86 -0
  183. package/build/reference-validator.js.map +1 -0
  184. package/build/reference-validator.test.d.ts +5 -0
  185. package/build/reference-validator.test.d.ts.map +1 -0
  186. package/build/reference-validator.test.js +243 -0
  187. package/build/reference-validator.test.js.map +1 -0
  188. package/build/replay-cursor.d.ts +27 -0
  189. package/build/replay-cursor.d.ts.map +1 -0
  190. package/build/replay-cursor.js +240 -0
  191. package/build/replay-cursor.js.map +1 -0
  192. package/build/runners/docker-compose-runner.d.ts +69 -0
  193. package/build/runners/docker-compose-runner.d.ts.map +1 -0
  194. package/build/runners/docker-compose-runner.js +438 -0
  195. package/build/runners/docker-compose-runner.js.map +1 -0
  196. package/build/runners/docker-runner.d.ts +65 -0
  197. package/build/runners/docker-runner.d.ts.map +1 -0
  198. package/build/runners/docker-runner.js +414 -0
  199. package/build/runners/docker-runner.js.map +1 -0
  200. package/build/runners/index.d.ts +19 -0
  201. package/build/runners/index.d.ts.map +1 -0
  202. package/build/runners/index.js +35 -0
  203. package/build/runners/index.js.map +1 -0
  204. package/build/runners/native-runner.d.ts +95 -0
  205. package/build/runners/native-runner.d.ts.map +1 -0
  206. package/build/runners/native-runner.js +370 -0
  207. package/build/runners/native-runner.js.map +1 -0
  208. package/build/runners/types.d.ts +147 -0
  209. package/build/runners/types.d.ts.map +1 -0
  210. package/build/runners/types.js +25 -0
  211. package/build/runners/types.js.map +1 -0
  212. package/build/self-restart.d.ts +12 -0
  213. package/build/self-restart.d.ts.map +1 -0
  214. package/build/self-restart.js +41 -0
  215. package/build/self-restart.js.map +1 -0
  216. package/build/self-restart.test.d.ts +2 -0
  217. package/build/self-restart.test.d.ts.map +1 -0
  218. package/build/self-restart.test.js +34 -0
  219. package/build/self-restart.test.js.map +1 -0
  220. package/build/server-claims.d.ts +161 -0
  221. package/build/server-claims.d.ts.map +1 -0
  222. package/build/server-claims.js +382 -0
  223. package/build/server-claims.js.map +1 -0
  224. package/build/server-claims.test.d.ts +2 -0
  225. package/build/server-claims.test.d.ts.map +1 -0
  226. package/build/server-claims.test.js +197 -0
  227. package/build/server-claims.test.js.map +1 -0
  228. package/build/server-manager.d.ts +438 -0
  229. package/build/server-manager.d.ts.map +1 -0
  230. package/build/server-manager.js +1674 -0
  231. package/build/server-manager.js.map +1 -0
  232. package/build/server-manager.test.d.ts +17 -0
  233. package/build/server-manager.test.d.ts.map +1 -0
  234. package/build/server-manager.test.js +122 -0
  235. package/build/server-manager.test.js.map +1 -0
  236. package/build/server-ownership.test.d.ts +2 -0
  237. package/build/server-ownership.test.d.ts.map +1 -0
  238. package/build/server-ownership.test.js +238 -0
  239. package/build/server-ownership.test.js.map +1 -0
  240. package/build/server-watcher.d.ts +21 -0
  241. package/build/server-watcher.d.ts.map +1 -0
  242. package/build/server-watcher.js +105 -0
  243. package/build/server-watcher.js.map +1 -0
  244. package/build/session-detector.d.ts +47 -0
  245. package/build/session-detector.d.ts.map +1 -0
  246. package/build/session-detector.js +229 -0
  247. package/build/session-detector.js.map +1 -0
  248. package/build/session-detector.test.d.ts +9 -0
  249. package/build/session-detector.test.d.ts.map +1 -0
  250. package/build/session-detector.test.js +45 -0
  251. package/build/session-detector.test.js.map +1 -0
  252. package/build/sourcemap-handler.d.ts +114 -0
  253. package/build/sourcemap-handler.d.ts.map +1 -0
  254. package/build/sourcemap-handler.js +479 -0
  255. package/build/sourcemap-handler.js.map +1 -0
  256. package/build/supervisor/child-manager.d.ts +43 -0
  257. package/build/supervisor/child-manager.d.ts.map +1 -0
  258. package/build/supervisor/child-manager.js +148 -0
  259. package/build/supervisor/child-manager.js.map +1 -0
  260. package/build/supervisor/child-manager.test.d.ts +2 -0
  261. package/build/supervisor/child-manager.test.d.ts.map +1 -0
  262. package/build/supervisor/child-manager.test.js +107 -0
  263. package/build/supervisor/child-manager.test.js.map +1 -0
  264. package/build/supervisor/client-watcher.d.ts +48 -0
  265. package/build/supervisor/client-watcher.d.ts.map +1 -0
  266. package/build/supervisor/client-watcher.js +186 -0
  267. package/build/supervisor/client-watcher.js.map +1 -0
  268. package/build/supervisor/client-watcher.test.d.ts +2 -0
  269. package/build/supervisor/client-watcher.test.d.ts.map +1 -0
  270. package/build/supervisor/client-watcher.test.js +121 -0
  271. package/build/supervisor/client-watcher.test.js.map +1 -0
  272. package/build/supervisor/idle-config.d.ts +30 -0
  273. package/build/supervisor/idle-config.d.ts.map +1 -0
  274. package/build/supervisor/idle-config.js +76 -0
  275. package/build/supervisor/idle-config.js.map +1 -0
  276. package/build/supervisor/idle-config.test.d.ts +2 -0
  277. package/build/supervisor/idle-config.test.d.ts.map +1 -0
  278. package/build/supervisor/idle-config.test.js +119 -0
  279. package/build/supervisor/idle-config.test.js.map +1 -0
  280. package/build/supervisor/ndjson-reader.d.ts +47 -0
  281. package/build/supervisor/ndjson-reader.d.ts.map +1 -0
  282. package/build/supervisor/ndjson-reader.js +75 -0
  283. package/build/supervisor/ndjson-reader.js.map +1 -0
  284. package/build/supervisor/ndjson-reader.test.d.ts +2 -0
  285. package/build/supervisor/ndjson-reader.test.d.ts.map +1 -0
  286. package/build/supervisor/ndjson-reader.test.js +92 -0
  287. package/build/supervisor/ndjson-reader.test.js.map +1 -0
  288. package/build/supervisor/pidfile.d.ts +11 -0
  289. package/build/supervisor/pidfile.d.ts.map +1 -0
  290. package/build/supervisor/pidfile.js +29 -0
  291. package/build/supervisor/pidfile.js.map +1 -0
  292. package/build/supervisor/pidfile.test.d.ts +8 -0
  293. package/build/supervisor/pidfile.test.d.ts.map +1 -0
  294. package/build/supervisor/pidfile.test.js +46 -0
  295. package/build/supervisor/pidfile.test.js.map +1 -0
  296. package/build/supervisor/restart-coordinator.d.ts +73 -0
  297. package/build/supervisor/restart-coordinator.d.ts.map +1 -0
  298. package/build/supervisor/restart-coordinator.js +300 -0
  299. package/build/supervisor/restart-coordinator.js.map +1 -0
  300. package/build/supervisor/restart-coordinator.test.d.ts +2 -0
  301. package/build/supervisor/restart-coordinator.test.d.ts.map +1 -0
  302. package/build/supervisor/restart-coordinator.test.js +434 -0
  303. package/build/supervisor/restart-coordinator.test.js.map +1 -0
  304. package/build/test-support/fake-execute-tool-call.d.ts +11 -0
  305. package/build/test-support/fake-execute-tool-call.d.ts.map +1 -0
  306. package/build/test-support/fake-execute-tool-call.js +19 -0
  307. package/build/test-support/fake-execute-tool-call.js.map +1 -0
  308. package/build/tool-error.d.ts +14 -0
  309. package/build/tool-error.d.ts.map +1 -0
  310. package/build/tool-error.js +18 -0
  311. package/build/tool-error.js.map +1 -0
  312. package/build/tool-response.d.ts +293 -0
  313. package/build/tool-response.d.ts.map +1 -0
  314. package/build/tool-response.js +365 -0
  315. package/build/tool-response.js.map +1 -0
  316. package/build/tools/assert-tools.d.ts +62 -0
  317. package/build/tools/assert-tools.d.ts.map +1 -0
  318. package/build/tools/assert-tools.js +330 -0
  319. package/build/tools/assert-tools.js.map +1 -0
  320. package/build/tools/breakpoint-await-abort.test.d.ts +2 -0
  321. package/build/tools/breakpoint-await-abort.test.d.ts.map +1 -0
  322. package/build/tools/breakpoint-await-abort.test.js +124 -0
  323. package/build/tools/breakpoint-await-abort.test.js.map +1 -0
  324. package/build/tools/breakpoint-tools.d.ts +99 -0
  325. package/build/tools/breakpoint-tools.d.ts.map +1 -0
  326. package/build/tools/breakpoint-tools.js +1197 -0
  327. package/build/tools/breakpoint-tools.js.map +1 -0
  328. package/build/tools/config-tools.d.ts +58 -0
  329. package/build/tools/config-tools.d.ts.map +1 -0
  330. package/build/tools/config-tools.js +180 -0
  331. package/build/tools/config-tools.js.map +1 -0
  332. package/build/tools/connection-routing.test.d.ts +12 -0
  333. package/build/tools/connection-routing.test.d.ts.map +1 -0
  334. package/build/tools/connection-routing.test.js +206 -0
  335. package/build/tools/connection-routing.test.js.map +1 -0
  336. package/build/tools/console-tools.d.ts +84 -0
  337. package/build/tools/console-tools.d.ts.map +1 -0
  338. package/build/tools/console-tools.js +241 -0
  339. package/build/tools/console-tools.js.map +1 -0
  340. package/build/tools/content-tools.d.ts +74 -0
  341. package/build/tools/content-tools.d.ts.map +1 -0
  342. package/build/tools/content-tools.js +582 -0
  343. package/build/tools/content-tools.js.map +1 -0
  344. package/build/tools/dashboard-tools.d.ts +38 -0
  345. package/build/tools/dashboard-tools.d.ts.map +1 -0
  346. package/build/tools/dashboard-tools.js +123 -0
  347. package/build/tools/dashboard-tools.js.map +1 -0
  348. package/build/tools/dom-tools.d.ts +41 -0
  349. package/build/tools/dom-tools.d.ts.map +1 -0
  350. package/build/tools/dom-tools.js +277 -0
  351. package/build/tools/dom-tools.js.map +1 -0
  352. package/build/tools/download-tools.d.ts +55 -0
  353. package/build/tools/download-tools.d.ts.map +1 -0
  354. package/build/tools/download-tools.js +280 -0
  355. package/build/tools/download-tools.js.map +1 -0
  356. package/build/tools/execution-tools.d.ts +40 -0
  357. package/build/tools/execution-tools.d.ts.map +1 -0
  358. package/build/tools/execution-tools.js +121 -0
  359. package/build/tools/execution-tools.js.map +1 -0
  360. package/build/tools/input-abort.test.d.ts +2 -0
  361. package/build/tools/input-abort.test.d.ts.map +1 -0
  362. package/build/tools/input-abort.test.js +227 -0
  363. package/build/tools/input-abort.test.js.map +1 -0
  364. package/build/tools/input-ambiguous-selector.test.d.ts +2 -0
  365. package/build/tools/input-ambiguous-selector.test.d.ts.map +1 -0
  366. package/build/tools/input-ambiguous-selector.test.js +34 -0
  367. package/build/tools/input-ambiguous-selector.test.js.map +1 -0
  368. package/build/tools/input-tools.d.ts +168 -0
  369. package/build/tools/input-tools.d.ts.map +1 -0
  370. package/build/tools/input-tools.js +1397 -0
  371. package/build/tools/input-tools.js.map +1 -0
  372. package/build/tools/inspection-tools.d.ts +112 -0
  373. package/build/tools/inspection-tools.d.ts.map +1 -0
  374. package/build/tools/inspection-tools.js +637 -0
  375. package/build/tools/inspection-tools.js.map +1 -0
  376. package/build/tools/interpolation.d.ts +30 -0
  377. package/build/tools/interpolation.d.ts.map +1 -0
  378. package/build/tools/interpolation.js +143 -0
  379. package/build/tools/interpolation.js.map +1 -0
  380. package/build/tools/issues-abort-hygiene.test.d.ts +2 -0
  381. package/build/tools/issues-abort-hygiene.test.d.ts.map +1 -0
  382. package/build/tools/issues-abort-hygiene.test.js +79 -0
  383. package/build/tools/issues-abort-hygiene.test.js.map +1 -0
  384. package/build/tools/issues-tools.d.ts +98 -0
  385. package/build/tools/issues-tools.d.ts.map +1 -0
  386. package/build/tools/issues-tools.js +821 -0
  387. package/build/tools/issues-tools.js.map +1 -0
  388. package/build/tools/issues-tools.test.d.ts +8 -0
  389. package/build/tools/issues-tools.test.d.ts.map +1 -0
  390. package/build/tools/issues-tools.test.js +184 -0
  391. package/build/tools/issues-tools.test.js.map +1 -0
  392. package/build/tools/modal-tools.d.ts +73 -0
  393. package/build/tools/modal-tools.d.ts.map +1 -0
  394. package/build/tools/modal-tools.js +161 -0
  395. package/build/tools/modal-tools.js.map +1 -0
  396. package/build/tools/network-tools.d.ts +72 -0
  397. package/build/tools/network-tools.d.ts.map +1 -0
  398. package/build/tools/network-tools.js +432 -0
  399. package/build/tools/network-tools.js.map +1 -0
  400. package/build/tools/page-tools.d.ts +78 -0
  401. package/build/tools/page-tools.d.ts.map +1 -0
  402. package/build/tools/page-tools.js +255 -0
  403. package/build/tools/page-tools.js.map +1 -0
  404. package/build/tools/plugin-tools.d.ts +16 -0
  405. package/build/tools/plugin-tools.d.ts.map +1 -0
  406. package/build/tools/plugin-tools.js +17 -0
  407. package/build/tools/plugin-tools.js.map +1 -0
  408. package/build/tools/replay-abort.test.d.ts +2 -0
  409. package/build/tools/replay-abort.test.d.ts.map +1 -0
  410. package/build/tools/replay-abort.test.js +259 -0
  411. package/build/tools/replay-abort.test.js.map +1 -0
  412. package/build/tools/replay-add-conditional.test.d.ts +2 -0
  413. package/build/tools/replay-add-conditional.test.d.ts.map +1 -0
  414. package/build/tools/replay-add-conditional.test.js +205 -0
  415. package/build/tools/replay-add-conditional.test.js.map +1 -0
  416. package/build/tools/replay-background-run.test.d.ts +2 -0
  417. package/build/tools/replay-background-run.test.d.ts.map +1 -0
  418. package/build/tools/replay-background-run.test.js +176 -0
  419. package/build/tools/replay-background-run.test.js.map +1 -0
  420. package/build/tools/replay-capture-variables.test.d.ts +2 -0
  421. package/build/tools/replay-capture-variables.test.d.ts.map +1 -0
  422. package/build/tools/replay-capture-variables.test.js +331 -0
  423. package/build/tools/replay-capture-variables.test.js.map +1 -0
  424. package/build/tools/replay-conditional-idb-and-launch.test.d.ts +11 -0
  425. package/build/tools/replay-conditional-idb-and-launch.test.d.ts.map +1 -0
  426. package/build/tools/replay-conditional-idb-and-launch.test.js +429 -0
  427. package/build/tools/replay-conditional-idb-and-launch.test.js.map +1 -0
  428. package/build/tools/replay-conditional-timeout.test.d.ts +14 -0
  429. package/build/tools/replay-conditional-timeout.test.d.ts.map +1 -0
  430. package/build/tools/replay-conditional-timeout.test.js +126 -0
  431. package/build/tools/replay-conditional-timeout.test.js.map +1 -0
  432. package/build/tools/replay-declare.test.d.ts +2 -0
  433. package/build/tools/replay-declare.test.d.ts.map +1 -0
  434. package/build/tools/replay-declare.test.js +106 -0
  435. package/build/tools/replay-declare.test.js.map +1 -0
  436. package/build/tools/replay-declared-browser-cleanup.test.d.ts +2 -0
  437. package/build/tools/replay-declared-browser-cleanup.test.d.ts.map +1 -0
  438. package/build/tools/replay-declared-browser-cleanup.test.js +103 -0
  439. package/build/tools/replay-declared-browser-cleanup.test.js.map +1 -0
  440. package/build/tools/replay-declared-profile.test.d.ts +2 -0
  441. package/build/tools/replay-declared-profile.test.d.ts.map +1 -0
  442. package/build/tools/replay-declared-profile.test.js +116 -0
  443. package/build/tools/replay-declared-profile.test.js.map +1 -0
  444. package/build/tools/replay-executor.d.ts +556 -0
  445. package/build/tools/replay-executor.d.ts.map +1 -0
  446. package/build/tools/replay-executor.js +2347 -0
  447. package/build/tools/replay-executor.js.map +1 -0
  448. package/build/tools/replay-folder-save.test.d.ts +2 -0
  449. package/build/tools/replay-folder-save.test.d.ts.map +1 -0
  450. package/build/tools/replay-folder-save.test.js +63 -0
  451. package/build/tools/replay-folder-save.test.js.map +1 -0
  452. package/build/tools/replay-formatters.d.ts +148 -0
  453. package/build/tools/replay-formatters.d.ts.map +1 -0
  454. package/build/tools/replay-formatters.js +856 -0
  455. package/build/tools/replay-formatters.js.map +1 -0
  456. package/build/tools/replay-kill-chrome-on-finish.test.d.ts +2 -0
  457. package/build/tools/replay-kill-chrome-on-finish.test.d.ts.map +1 -0
  458. package/build/tools/replay-kill-chrome-on-finish.test.js +175 -0
  459. package/build/tools/replay-kill-chrome-on-finish.test.js.map +1 -0
  460. package/build/tools/replay-multi-connection.test.d.ts +2 -0
  461. package/build/tools/replay-multi-connection.test.d.ts.map +1 -0
  462. package/build/tools/replay-multi-connection.test.js +547 -0
  463. package/build/tools/replay-multi-connection.test.js.map +1 -0
  464. package/build/tools/replay-output-and-record-options.test.d.ts +2 -0
  465. package/build/tools/replay-output-and-record-options.test.d.ts.map +1 -0
  466. package/build/tools/replay-output-and-record-options.test.js +240 -0
  467. package/build/tools/replay-output-and-record-options.test.js.map +1 -0
  468. package/build/tools/replay-production-error-shape.test.d.ts +7 -0
  469. package/build/tools/replay-production-error-shape.test.d.ts.map +1 -0
  470. package/build/tools/replay-production-error-shape.test.js +93 -0
  471. package/build/tools/replay-production-error-shape.test.js.map +1 -0
  472. package/build/tools/replay-rebase.test.d.ts +2 -0
  473. package/build/tools/replay-rebase.test.d.ts.map +1 -0
  474. package/build/tools/replay-rebase.test.js +58 -0
  475. package/build/tools/replay-rebase.test.js.map +1 -0
  476. package/build/tools/replay-retry-classification.test.d.ts +9 -0
  477. package/build/tools/replay-retry-classification.test.d.ts.map +1 -0
  478. package/build/tools/replay-retry-classification.test.js +57 -0
  479. package/build/tools/replay-retry-classification.test.js.map +1 -0
  480. package/build/tools/replay-run-registry.d.ts +55 -0
  481. package/build/tools/replay-run-registry.d.ts.map +1 -0
  482. package/build/tools/replay-run-registry.js +65 -0
  483. package/build/tools/replay-run-registry.js.map +1 -0
  484. package/build/tools/replay-sequence-reload.test.d.ts +2 -0
  485. package/build/tools/replay-sequence-reload.test.d.ts.map +1 -0
  486. package/build/tools/replay-sequence-reload.test.js +82 -0
  487. package/build/tools/replay-sequence-reload.test.js.map +1 -0
  488. package/build/tools/replay-socket-scope.test.d.ts +2 -0
  489. package/build/tools/replay-socket-scope.test.d.ts.map +1 -0
  490. package/build/tools/replay-socket-scope.test.js +75 -0
  491. package/build/tools/replay-socket-scope.test.js.map +1 -0
  492. package/build/tools/replay-step-connection.test.d.ts +2 -0
  493. package/build/tools/replay-step-connection.test.d.ts.map +1 -0
  494. package/build/tools/replay-step-connection.test.js +292 -0
  495. package/build/tools/replay-step-connection.test.js.map +1 -0
  496. package/build/tools/replay-step-timeout.test.d.ts +2 -0
  497. package/build/tools/replay-step-timeout.test.d.ts.map +1 -0
  498. package/build/tools/replay-step-timeout.test.js +204 -0
  499. package/build/tools/replay-step-timeout.test.js.map +1 -0
  500. package/build/tools/replay-tags.test.d.ts +2 -0
  501. package/build/tools/replay-tags.test.d.ts.map +1 -0
  502. package/build/tools/replay-tags.test.js +99 -0
  503. package/build/tools/replay-tags.test.js.map +1 -0
  504. package/build/tools/replay-teardown-and-foreach.test.d.ts +13 -0
  505. package/build/tools/replay-teardown-and-foreach.test.d.ts.map +1 -0
  506. package/build/tools/replay-teardown-and-foreach.test.js +318 -0
  507. package/build/tools/replay-teardown-and-foreach.test.js.map +1 -0
  508. package/build/tools/replay-tool-name-validation.test.d.ts +2 -0
  509. package/build/tools/replay-tool-name-validation.test.d.ts.map +1 -0
  510. package/build/tools/replay-tool-name-validation.test.js +280 -0
  511. package/build/tools/replay-tool-name-validation.test.js.map +1 -0
  512. package/build/tools/replay-tools.d.ts +288 -0
  513. package/build/tools/replay-tools.d.ts.map +1 -0
  514. package/build/tools/replay-tools.js +2994 -0
  515. package/build/tools/replay-tools.js.map +1 -0
  516. package/build/tools/request-abort.test.d.ts +2 -0
  517. package/build/tools/request-abort.test.d.ts.map +1 -0
  518. package/build/tools/request-abort.test.js +130 -0
  519. package/build/tools/request-abort.test.js.map +1 -0
  520. package/build/tools/request-tools.d.ts +56 -0
  521. package/build/tools/request-tools.d.ts.map +1 -0
  522. package/build/tools/request-tools.js +174 -0
  523. package/build/tools/request-tools.js.map +1 -0
  524. package/build/tools/screenshot-tools.d.ts +135 -0
  525. package/build/tools/screenshot-tools.d.ts.map +1 -0
  526. package/build/tools/screenshot-tools.js +636 -0
  527. package/build/tools/screenshot-tools.js.map +1 -0
  528. package/build/tools/server-tools.d.ts +88 -0
  529. package/build/tools/server-tools.d.ts.map +1 -0
  530. package/build/tools/server-tools.js +485 -0
  531. package/build/tools/server-tools.js.map +1 -0
  532. package/build/tools/source-tools.d.ts +46 -0
  533. package/build/tools/source-tools.d.ts.map +1 -0
  534. package/build/tools/source-tools.js +47 -0
  535. package/build/tools/source-tools.js.map +1 -0
  536. package/build/tools/storage-tools.d.ts +141 -0
  537. package/build/tools/storage-tools.d.ts.map +1 -0
  538. package/build/tools/storage-tools.js +894 -0
  539. package/build/tools/storage-tools.js.map +1 -0
  540. package/build/tools/storage-tools.test.d.ts +13 -0
  541. package/build/tools/storage-tools.test.d.ts.map +1 -0
  542. package/build/tools/storage-tools.test.js +707 -0
  543. package/build/tools/storage-tools.test.js.map +1 -0
  544. package/build/tools/tab-tools.d.ts +42 -0
  545. package/build/tools/tab-tools.d.ts.map +1 -0
  546. package/build/tools/tab-tools.js +296 -0
  547. package/build/tools/tab-tools.js.map +1 -0
  548. package/build/tools/wait-tools.d.ts +85 -0
  549. package/build/tools/wait-tools.d.ts.map +1 -0
  550. package/build/tools/wait-tools.js +236 -0
  551. package/build/tools/wait-tools.js.map +1 -0
  552. package/build/tools/wait-tools.test.d.ts +9 -0
  553. package/build/tools/wait-tools.test.d.ts.map +1 -0
  554. package/build/tools/wait-tools.test.js +193 -0
  555. package/build/tools/wait-tools.test.js.map +1 -0
  556. package/build/types.d.ts +133 -0
  557. package/build/types.d.ts.map +1 -0
  558. package/build/types.js +5 -0
  559. package/build/types.js.map +1 -0
  560. package/build/ui-verifier.d.ts +88 -0
  561. package/build/ui-verifier.d.ts.map +1 -0
  562. package/build/ui-verifier.js +540 -0
  563. package/build/ui-verifier.js.map +1 -0
  564. package/build/utils/abort.d.ts +68 -0
  565. package/build/utils/abort.d.ts.map +1 -0
  566. package/build/utils/abort.js +159 -0
  567. package/build/utils/abort.js.map +1 -0
  568. package/build/utils/abort.test.d.ts +2 -0
  569. package/build/utils/abort.test.d.ts.map +1 -0
  570. package/build/utils/abort.test.js +174 -0
  571. package/build/utils/abort.test.js.map +1 -0
  572. package/build/utils/modal-detection-core.d.ts +150 -0
  573. package/build/utils/modal-detection-core.d.ts.map +1 -0
  574. package/build/utils/modal-detection-core.js +332 -0
  575. package/build/utils/modal-detection-core.js.map +1 -0
  576. package/build/utils/modal-detection-core.test.d.ts +5 -0
  577. package/build/utils/modal-detection-core.test.d.ts.map +1 -0
  578. package/build/utils/modal-detection-core.test.js +492 -0
  579. package/build/utils/modal-detection-core.test.js.map +1 -0
  580. package/build/utils/modal-detector.d.ts +29 -0
  581. package/build/utils/modal-detector.d.ts.map +1 -0
  582. package/build/utils/modal-detector.js +281 -0
  583. package/build/utils/modal-detector.js.map +1 -0
  584. package/build/utils/modal-dismissal.d.ts +32 -0
  585. package/build/utils/modal-dismissal.d.ts.map +1 -0
  586. package/build/utils/modal-dismissal.js +190 -0
  587. package/build/utils/modal-dismissal.js.map +1 -0
  588. package/build/utils/port-check.d.ts +31 -0
  589. package/build/utils/port-check.d.ts.map +1 -0
  590. package/build/utils/port-check.js +87 -0
  591. package/build/utils/port-check.js.map +1 -0
  592. package/build/utils/port-check.test.d.ts +2 -0
  593. package/build/utils/port-check.test.d.ts.map +1 -0
  594. package/build/utils/port-check.test.js +66 -0
  595. package/build/utils/port-check.test.js.map +1 -0
  596. package/build/utils/selector-resolver.d.ts +66 -0
  597. package/build/utils/selector-resolver.d.ts.map +1 -0
  598. package/build/utils/selector-resolver.js +200 -0
  599. package/build/utils/selector-resolver.js.map +1 -0
  600. package/build/validation-helpers.d.ts +41 -0
  601. package/build/validation-helpers.d.ts.map +1 -0
  602. package/build/validation-helpers.js +236 -0
  603. package/build/validation-helpers.js.map +1 -0
  604. package/build/window-sizing.d.ts +26 -0
  605. package/build/window-sizing.d.ts.map +1 -0
  606. package/build/window-sizing.js +87 -0
  607. package/build/window-sizing.js.map +1 -0
  608. package/build/window-sizing.test.d.ts +8 -0
  609. package/build/window-sizing.test.d.ts.map +1 -0
  610. package/build/window-sizing.test.js +113 -0
  611. package/build/window-sizing.test.js.map +1 -0
  612. package/docs/README.md +74 -0
  613. package/docs/automation.md +562 -0
  614. package/docs/debugging.md +229 -0
  615. package/docs/installation.md +133 -0
  616. package/docs/instructions.md +227 -0
  617. package/docs/mcp-instructions.md +15 -0
  618. package/docs/message-system.md +327 -0
  619. package/docs/messages.md +3480 -0
  620. package/docs/parser-plugins.md +132 -0
  621. package/docs/replay.md +1411 -0
  622. package/docs/troubleshooting.md +272 -0
  623. package/docs/working_with_llm_notes.md +5 -0
  624. package/package.json +87 -0
  625. package/skills/devharness/SKILL.md +195 -0
  626. package/skills/devharness/references/sequences.md +613 -0
  627. package/skills/devharness/references/tool-categories.md +99 -0
@@ -0,0 +1,437 @@
1
+ /**
2
+ * DOM Change Monitor
3
+ * Uses MutationObserver to track DOM changes during browser actions
4
+ * Replaces snapshot-based diffing with real-time observation
5
+ */
6
+ import { debugLog } from './debug-logger.js';
7
+ export const DEFAULT_CHANGE_DETECTION_CONFIG = {
8
+ enabled: true,
9
+ settleTimeout: 2000,
10
+ quietPeriod: 300,
11
+ navigationTimeout: 3000,
12
+ };
13
+ /**
14
+ * DOM Change Monitor
15
+ * Manages MutationObserver injection and result collection
16
+ */
17
+ export class DOMChangeMonitor {
18
+ sessions = new Map();
19
+ /**
20
+ * Start observing DOM changes before an action
21
+ */
22
+ async startObserving(connectionRef, page) {
23
+ // Stop any existing session for this connection
24
+ if (this.sessions.has(connectionRef)) {
25
+ await this.cleanup(connectionRef);
26
+ }
27
+ try {
28
+ // Inject MutationObserver into page
29
+ await page.evaluate(() => {
30
+ // @ts-ignore - runs in browser context
31
+ window.__cdpChangeObserver = {
32
+ startTime: Date.now(),
33
+ mutations: [],
34
+ addedNodes: [],
35
+ removedNodes: [],
36
+ visibilityChanges: [],
37
+ textChanges: [],
38
+ lastMutationTime: Date.now(),
39
+ // Helper to get selector for element
40
+ // @ts-ignore - runs in browser context
41
+ getSelector(el) {
42
+ if (el.id)
43
+ return `#${el.id}`;
44
+ if (el.getAttribute?.('name'))
45
+ return `[name="${el.getAttribute('name')}"]`;
46
+ const tag = el.tagName?.toLowerCase() || 'unknown';
47
+ const text = el.textContent?.trim()?.substring(0, 30);
48
+ if (text && text.length > 0) {
49
+ return `${tag}:has-text("${text.replace(/"/g, '\\"')}")`;
50
+ }
51
+ const className = el.className;
52
+ if (className && typeof className === 'string') {
53
+ const classes = className.split(' ').filter((c) => c.length > 0 && c.length <= 20);
54
+ if (classes.length > 0) {
55
+ return `${tag}.${classes.slice(0, 2).join('.')}`;
56
+ }
57
+ }
58
+ return tag;
59
+ },
60
+ // Helper to get semantic context
61
+ // @ts-ignore - runs in browser context
62
+ getContext(el) {
63
+ let parent = el.parentElement;
64
+ while (parent) {
65
+ const tag = parent.tagName?.toLowerCase();
66
+ if (tag === 'nav')
67
+ return 'nav';
68
+ if (tag === 'main')
69
+ return 'main';
70
+ if (tag === 'footer')
71
+ return 'footer';
72
+ if (tag === 'header')
73
+ return 'header';
74
+ if (tag === 'form')
75
+ return 'form';
76
+ if (parent.getAttribute?.('role') === 'alert')
77
+ return 'alert';
78
+ if (parent.className?.includes?.('alert'))
79
+ return 'alert';
80
+ parent = parent.parentElement;
81
+ }
82
+ return 'main';
83
+ },
84
+ // Helper to check if element is interactive
85
+ // @ts-ignore - runs in browser context
86
+ isInteractive(el) {
87
+ const tag = el.tagName?.toLowerCase();
88
+ if (!tag)
89
+ return false;
90
+ if (['button', 'a', 'input', 'select', 'textarea'].includes(tag))
91
+ return true;
92
+ if (el.getAttribute?.('role') === 'button')
93
+ return true;
94
+ if (el.getAttribute?.('onclick'))
95
+ return true;
96
+ return false;
97
+ },
98
+ // Helper to serialize element info
99
+ // @ts-ignore - runs in browser context
100
+ serializeElement(el) {
101
+ if (!el || !el.tagName)
102
+ return null;
103
+ const tag = el.tagName.toLowerCase();
104
+ // Skip script, style, meta elements
105
+ if (['script', 'style', 'meta', 'link', 'noscript'].includes(tag))
106
+ return null;
107
+ return {
108
+ tag,
109
+ selector: this.getSelector(el),
110
+ text: el.textContent?.trim()?.substring(0, 50) || undefined,
111
+ context: this.getContext(el),
112
+ };
113
+ },
114
+ // Check if element was hidden and is now visible (or vice versa)
115
+ // @ts-ignore - runs in browser context
116
+ checkVisibilityChange(el, oldValue, attrName) {
117
+ // @ts-ignore
118
+ const style = window.getComputedStyle(el);
119
+ const isVisible = style.display !== 'none' &&
120
+ style.visibility !== 'hidden' &&
121
+ parseFloat(style.opacity) > 0;
122
+ // Check if this was a visibility-related change
123
+ if (attrName === 'style' || attrName === 'class' || attrName === 'hidden') {
124
+ // Rough check: if old value suggested hidden and now visible
125
+ if (oldValue?.includes('display: none') || oldValue?.includes('visibility: hidden') || oldValue?.includes('opacity: 0')) {
126
+ if (isVisible)
127
+ return 'shown';
128
+ }
129
+ // If hidden attribute was removed
130
+ if (attrName === 'hidden' && oldValue !== null && !el.hasAttribute('hidden')) {
131
+ return 'shown';
132
+ }
133
+ if (attrName === 'hidden' && oldValue === null && el.hasAttribute('hidden')) {
134
+ return 'hidden';
135
+ }
136
+ }
137
+ return null;
138
+ },
139
+ start() {
140
+ // @ts-ignore
141
+ this.observer = new MutationObserver((mutations) => {
142
+ this.lastMutationTime = Date.now();
143
+ for (const mutation of mutations) {
144
+ this.mutations.push({
145
+ type: mutation.type,
146
+ time: Date.now() - this.startTime,
147
+ });
148
+ // Helper to recursively find interactive elements in a node tree
149
+ const findInteractiveInTree = (node, results) => {
150
+ if (!node || node.nodeType !== 1)
151
+ return;
152
+ // Check this node
153
+ if (this.isInteractive(node)) {
154
+ const info = this.serializeElement(node);
155
+ if (info)
156
+ results.push(info);
157
+ }
158
+ // Recursively check children
159
+ if (node.children) {
160
+ for (const child of node.children) {
161
+ findInteractiveInTree(child, results);
162
+ }
163
+ }
164
+ };
165
+ // Track added nodes (including interactive children)
166
+ if (mutation.addedNodes.length > 0) {
167
+ mutation.addedNodes.forEach((node) => {
168
+ findInteractiveInTree(node, this.addedNodes);
169
+ });
170
+ }
171
+ // Track removed nodes (including interactive children)
172
+ if (mutation.removedNodes.length > 0) {
173
+ mutation.removedNodes.forEach((node) => {
174
+ findInteractiveInTree(node, this.removedNodes);
175
+ });
176
+ }
177
+ // Track attribute changes (visibility)
178
+ if (mutation.type === 'attributes' && mutation.target.nodeType === 1) {
179
+ const el = mutation.target;
180
+ const attrName = mutation.attributeName || '';
181
+ if (['style', 'class', 'hidden', 'aria-hidden'].includes(attrName)) {
182
+ const change = this.checkVisibilityChange(el, mutation.oldValue, attrName);
183
+ if (change && this.isInteractive(el)) {
184
+ const info = this.serializeElement(el);
185
+ if (info) {
186
+ this.visibilityChanges.push({ ...info, change });
187
+ }
188
+ }
189
+ }
190
+ }
191
+ // Track text changes
192
+ if (mutation.type === 'characterData' && mutation.target.parentElement) {
193
+ const parent = mutation.target.parentElement;
194
+ if (this.isInteractive(parent)) {
195
+ this.textChanges.push({
196
+ selector: this.getSelector(parent),
197
+ before: (mutation.oldValue || '').substring(0, 50),
198
+ after: (mutation.target.textContent || '').substring(0, 50),
199
+ });
200
+ }
201
+ }
202
+ }
203
+ });
204
+ // @ts-ignore
205
+ this.observer.observe(document.body, {
206
+ childList: true,
207
+ subtree: true,
208
+ attributes: true,
209
+ attributeOldValue: true,
210
+ attributeFilter: ['style', 'class', 'hidden', 'aria-hidden', 'disabled'],
211
+ characterData: true,
212
+ characterDataOldValue: true,
213
+ });
214
+ },
215
+ stop() {
216
+ // @ts-ignore
217
+ if (this.observer) {
218
+ // @ts-ignore
219
+ this.observer.disconnect();
220
+ }
221
+ return {
222
+ mutationCount: this.mutations.length,
223
+ added: this.addedNodes,
224
+ removed: this.removedNodes,
225
+ visibilityChanges: this.visibilityChanges,
226
+ textChanges: this.textChanges,
227
+ lastMutationTime: this.lastMutationTime,
228
+ };
229
+ },
230
+ };
231
+ // @ts-ignore
232
+ window.__cdpChangeObserver.start();
233
+ });
234
+ this.sessions.set(connectionRef, {
235
+ startTime: Date.now(),
236
+ page,
237
+ });
238
+ await debugLog('DOMChangeMonitor', `Started observing for ${connectionRef}`);
239
+ }
240
+ catch (err) {
241
+ await debugLog('DOMChangeMonitor', `Failed to start observer: ${err}`);
242
+ // Don't throw - we want actions to succeed even if observation fails
243
+ }
244
+ }
245
+ /**
246
+ * Stop observing and collect results
247
+ * Waits for mutations to settle before collecting
248
+ */
249
+ async stopObserving(connectionRef, options = {}) {
250
+ const session = this.sessions.get(connectionRef);
251
+ if (!session) {
252
+ return null;
253
+ }
254
+ const settleTimeout = options.settleTimeout ?? DEFAULT_CHANGE_DETECTION_CONFIG.settleTimeout;
255
+ const quietPeriod = options.quietPeriod ?? DEFAULT_CHANGE_DETECTION_CONFIG.quietPeriod;
256
+ const { page, startTime } = session;
257
+ try {
258
+ // Wait for mutations to settle
259
+ const settleResult = await this.waitForSettle(page, settleTimeout, quietPeriod, options.signal);
260
+ // Collect results
261
+ const rawResults = await page.evaluate(() => {
262
+ // @ts-ignore
263
+ if (window.__cdpChangeObserver) {
264
+ // @ts-ignore
265
+ return window.__cdpChangeObserver.stop();
266
+ }
267
+ return null;
268
+ });
269
+ if (!rawResults) {
270
+ return null;
271
+ }
272
+ // Process visibility changes into shown/hidden
273
+ const shown = [];
274
+ const hidden = [];
275
+ for (const change of rawResults.visibilityChanges) {
276
+ const info = {
277
+ tag: change.tag,
278
+ selector: change.selector,
279
+ text: change.text,
280
+ context: change.context,
281
+ };
282
+ if (change.change === 'shown') {
283
+ shown.push(info);
284
+ }
285
+ else if (change.change === 'hidden') {
286
+ hidden.push(info);
287
+ }
288
+ }
289
+ const result = {
290
+ added: rawResults.added,
291
+ removed: rawResults.removed,
292
+ shown,
293
+ hidden,
294
+ textChanged: rawResults.textChanges,
295
+ settled: settleResult.settled,
296
+ duration: Date.now() - startTime,
297
+ mutationCount: rawResults.mutationCount,
298
+ };
299
+ await debugLog('DOMChangeMonitor', `Stopped observing for ${connectionRef}: ${result.mutationCount} mutations, ` +
300
+ `${result.added.length} added, ${result.removed.length} removed, ` +
301
+ `${result.shown.length} shown, ${result.hidden.length} hidden`);
302
+ return result;
303
+ }
304
+ catch (err) {
305
+ await debugLog('DOMChangeMonitor', `Failed to stop observer: ${err}`);
306
+ return null;
307
+ }
308
+ finally {
309
+ this.sessions.delete(connectionRef);
310
+ // Cleanup browser-side observer
311
+ await this.cleanup(connectionRef).catch(() => { });
312
+ }
313
+ }
314
+ /**
315
+ * Wait for mutations to settle (no new mutations for quietPeriod)
316
+ */
317
+ async waitForSettle(page, timeout, quietPeriod, signal) {
318
+ const startTime = Date.now();
319
+ const checkInterval = 50; // Check every 50ms
320
+ while (Date.now() - startTime < timeout) {
321
+ // Cancelled: stop waiting for quiet - report unsettled with whatever
322
+ // was observed so far.
323
+ if (signal?.aborted) {
324
+ return { settled: false, waitTime: Date.now() - startTime };
325
+ }
326
+ const timeSinceLastMutation = await page.evaluate(() => {
327
+ // @ts-ignore
328
+ if (window.__cdpChangeObserver) {
329
+ // @ts-ignore
330
+ return Date.now() - window.__cdpChangeObserver.lastMutationTime;
331
+ }
332
+ return Infinity;
333
+ });
334
+ if (timeSinceLastMutation >= quietPeriod) {
335
+ return { settled: true, waitTime: Date.now() - startTime };
336
+ }
337
+ await new Promise(resolve => setTimeout(resolve, checkInterval));
338
+ }
339
+ return { settled: false, waitTime: timeout };
340
+ }
341
+ /**
342
+ * Cleanup browser-side observer
343
+ */
344
+ async cleanup(connectionRef) {
345
+ const session = this.sessions.get(connectionRef);
346
+ if (!session)
347
+ return;
348
+ try {
349
+ await session.page.evaluate(() => {
350
+ // @ts-ignore
351
+ if (window.__cdpChangeObserver?.observer) {
352
+ // @ts-ignore
353
+ window.__cdpChangeObserver.observer.disconnect();
354
+ }
355
+ // @ts-ignore
356
+ delete window.__cdpChangeObserver;
357
+ });
358
+ }
359
+ catch {
360
+ // Ignore cleanup errors (page may have navigated)
361
+ }
362
+ this.sessions.delete(connectionRef);
363
+ }
364
+ /**
365
+ * Check if currently observing for a connection
366
+ */
367
+ isObserving(connectionRef) {
368
+ return this.sessions.has(connectionRef);
369
+ }
370
+ /**
371
+ * Clear all sessions (for shutdown)
372
+ */
373
+ async clearAll() {
374
+ for (const connectionRef of this.sessions.keys()) {
375
+ await this.cleanup(connectionRef);
376
+ }
377
+ }
378
+ }
379
+ // Singleton instance
380
+ export const domChangeMonitor = new DOMChangeMonitor();
381
+ /**
382
+ * Format DOM changes for display in action response
383
+ */
384
+ export function formatDOMChanges(changes) {
385
+ if (!changes)
386
+ return '';
387
+ const hasChanges = changes.added.length > 0 ||
388
+ changes.removed.length > 0 ||
389
+ changes.shown.length > 0 ||
390
+ changes.hidden.length > 0 ||
391
+ changes.textChanged.length > 0;
392
+ if (!hasChanges)
393
+ return '';
394
+ const lines = [];
395
+ const settleStatus = changes.settled ? `${changes.duration}ms` : `timeout ${changes.duration}ms`;
396
+ // Summary line
397
+ const parts = [];
398
+ if (changes.added.length > 0)
399
+ parts.push(`+${changes.added.length}`);
400
+ if (changes.removed.length > 0)
401
+ parts.push(`-${changes.removed.length}`);
402
+ if (changes.shown.length > 0)
403
+ parts.push(`${changes.shown.length} shown`);
404
+ if (changes.hidden.length > 0)
405
+ parts.push(`${changes.hidden.length} hidden`);
406
+ if (changes.textChanged.length > 0)
407
+ parts.push(`${changes.textChanged.length} text`);
408
+ lines.push(`**Changes (${settleStatus}):** ${parts.join(', ')}`);
409
+ // Group by context for details
410
+ const byContext = new Map();
411
+ const addToContext = (items, prefix) => {
412
+ for (const item of items.slice(0, 3)) { // Limit to 3 per category
413
+ const ctx = item.context || 'main';
414
+ if (!byContext.has(ctx))
415
+ byContext.set(ctx, []);
416
+ const text = item.text ? `: ${item.text.substring(0, 30)}` : '';
417
+ byContext.get(ctx).push(`${prefix}${item.tag}${text}`);
418
+ }
419
+ };
420
+ addToContext(changes.added, '+');
421
+ addToContext(changes.shown, '→');
422
+ addToContext(changes.removed, '-');
423
+ addToContext(changes.hidden, '←');
424
+ // Format context groups
425
+ for (const [ctx, items] of byContext) {
426
+ if (items.length > 0) {
427
+ lines.push(` ${ctx}: ${items.join(', ')}`);
428
+ }
429
+ }
430
+ // Text changes
431
+ if (changes.textChanged.length > 0) {
432
+ const tc = changes.textChanged[0];
433
+ lines.push(` text: "${tc.before}" → "${tc.after}"`);
434
+ }
435
+ return '\n\n' + lines.join('\n');
436
+ }
437
+ //# sourceMappingURL=dom-change-monitor.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"dom-change-monitor.js","sourceRoot":"","sources":["../src/dom-change-monitor.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,16 @@
1
+ /**
2
+ * Shared element collection logic for interactive elements
3
+ * Used by both page-tools.ts (navigation caching) and content-tools.ts (findInteractive)
4
+ */
5
+ import type { ClickableElement } from './clickable-cache.js';
6
+ export interface CollectionResult {
7
+ elements: ClickableElement[];
8
+ viewportHeight: number;
9
+ viewportWidth: number;
10
+ }
11
+ /**
12
+ * Collect all interactive elements from a page
13
+ * Includes links, buttons, and form inputs with semantic context
14
+ */
15
+ export declare function collectInteractiveElements(page: any): Promise<CollectionResult>;
16
+ //# sourceMappingURL=element-collector.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"element-collector.d.ts","sourceRoot":"","sources":["../src/element-collector.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAE7D,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,gBAAgB,EAAE,CAAC;IAC7B,cAAc,EAAE,MAAM,CAAC;IACvB,aAAa,EAAE,MAAM,CAAC;CACvB;AAED;;;GAGG;AACH,wBAAsB,0BAA0B,CAAC,IAAI,EAAE,GAAG,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAmMrF"}