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,280 @@
1
+ /**
2
+ * Download Tools
3
+ * Tools for downloading files from URLs with security and quarantine features
4
+ */
5
+ import { z } from 'zod';
6
+ import { createTool } from '../validation-helpers.js';
7
+ import { createSuccessResponse, createErrorResponse } from '../messages.js';
8
+ import { promises as fs } from 'fs';
9
+ import { join, basename, normalize } from 'path';
10
+ import { getOutputPath } from '../helpers/paths.js';
11
+ // Computed fresh on each call (not cached) so they follow a later
12
+ // setWorkingDirOverride() / config useLocal(path) switch.
13
+ function getDownloadsDir() {
14
+ return getOutputPath('downloads');
15
+ }
16
+ function getQuarantineDir() {
17
+ return join(getDownloadsDir(), 'quarantine');
18
+ }
19
+ // Security limits
20
+ const MAX_FILE_SIZE = 50 * 1024 * 1024; // 50 MB
21
+ const SUSPICIOUS_EXTENSIONS = ['.exe', '.dll', '.so', '.dylib', '.bin', '.app', '.bat', '.cmd', '.sh', '.ps1', '.vbs', '.scr'];
22
+ const ALLOWED_CONTENT_TYPES = ['image/', 'text/', 'application/json', 'application/xml', 'application/pdf', 'application/javascript', 'application/typescript'];
23
+ // In-memory quarantine registry
24
+ const quarantineRegistry = [];
25
+ /**
26
+ * Validate filename for security (prevent path traversal)
27
+ */
28
+ function validateFilename(filename) {
29
+ // Check for path traversal attempts
30
+ if (filename.includes('..') || filename.includes('/') || filename.includes('\\')) {
31
+ return { valid: false, error: 'Filename cannot contain path separators or parent directory references' };
32
+ }
33
+ // Check for null bytes
34
+ if (filename.includes('\0')) {
35
+ return { valid: false, error: 'Filename cannot contain null bytes' };
36
+ }
37
+ // Must have a filename
38
+ if (!filename.trim()) {
39
+ return { valid: false, error: 'Filename cannot be empty' };
40
+ }
41
+ // Normalize and check it matches original (catches various tricks)
42
+ const normalized = basename(normalize(filename));
43
+ if (normalized !== filename) {
44
+ return { valid: false, error: 'Invalid filename format' };
45
+ }
46
+ return { valid: true };
47
+ }
48
+ /**
49
+ * Check if file/content is suspicious
50
+ */
51
+ function isSuspicious(filename, contentType) {
52
+ // Check extension
53
+ const ext = filename.toLowerCase().match(/\.[^.]+$/)?.[0];
54
+ if (ext && SUSPICIOUS_EXTENSIONS.includes(ext)) {
55
+ return { suspicious: true, reason: `Suspicious file extension: ${ext}` };
56
+ }
57
+ // Check content type if available
58
+ if (contentType) {
59
+ const isAllowed = ALLOWED_CONTENT_TYPES.some(allowed => contentType.toLowerCase().startsWith(allowed));
60
+ if (!isAllowed) {
61
+ return { suspicious: true, reason: `Suspicious content-type: ${contentType}` };
62
+ }
63
+ }
64
+ return { suspicious: false };
65
+ }
66
+ /**
67
+ * Remove executable permissions from a file (security measure)
68
+ */
69
+ async function removeExecutablePermissions(filepath) {
70
+ try {
71
+ // Set to read-only for owner, group, and others (0o444)
72
+ await fs.chmod(filepath, 0o444);
73
+ }
74
+ catch (error) {
75
+ // Ignore chmod errors (might not be supported on all platforms)
76
+ console.error(`Warning: Could not remove executable permissions from ${filepath}:`, error);
77
+ }
78
+ }
79
+ /**
80
+ * Add file to quarantine
81
+ */
82
+ async function quarantineFile(url, filename, reason, size, contentType, buffer) {
83
+ const quarantineDir = getQuarantineDir();
84
+ await fs.mkdir(quarantineDir, { recursive: true });
85
+ // Add .quarantined extension to prevent execution on all platforms (especially Windows)
86
+ const quarantinedFilename = `${filename}.quarantined`;
87
+ const quarantinePath = join(quarantineDir, quarantinedFilename);
88
+ await fs.writeFile(quarantinePath, buffer);
89
+ // Remove executable permissions for security (Unix systems)
90
+ await removeExecutablePermissions(quarantinePath);
91
+ quarantineRegistry.push({
92
+ filename: quarantinedFilename,
93
+ url,
94
+ reason,
95
+ size,
96
+ contentType,
97
+ timestamp: new Date().toISOString(),
98
+ });
99
+ }
100
+ /**
101
+ * Get quarantine summary for reporting
102
+ */
103
+ export function getQuarantineSummary() {
104
+ return [...quarantineRegistry];
105
+ }
106
+ /**
107
+ * Clear quarantine registry (called after reporting)
108
+ */
109
+ export function clearQuarantineRegistry() {
110
+ quarantineRegistry.length = 0;
111
+ }
112
+ /**
113
+ * Download tools for saving files from URLs
114
+ */
115
+ export function createDownloadTools() {
116
+ return {
117
+ saveToDisk: createTool('Download file to disk', z.object({
118
+ url: z.string().url().describe('URL to download'),
119
+ filename: z.string().describe('Filename to save as'),
120
+ overwriteIfExists: z.boolean().optional().default(false).describe('Overwrite if exists'),
121
+ }).strict(), async (args) => {
122
+ try {
123
+ // Validate filename
124
+ const filenameValidation = validateFilename(args.filename);
125
+ if (!filenameValidation.valid) {
126
+ return createErrorResponse('INVALID_FILENAME', {
127
+ filename: args.filename,
128
+ reason: filenameValidation.error
129
+ });
130
+ }
131
+ // Ensure downloads directory exists
132
+ const downloadsDir = getDownloadsDir();
133
+ await fs.mkdir(downloadsDir, { recursive: true });
134
+ const filepath = join(downloadsDir, args.filename);
135
+ // Check if file already exists BEFORE fetching
136
+ let existingFileStats = null;
137
+ try {
138
+ existingFileStats = await fs.stat(filepath);
139
+ }
140
+ catch {
141
+ // File doesn't exist, which is fine
142
+ }
143
+ // Check if overwriteIfExists is set to true when file doesn't exist
144
+ if (args.overwriteIfExists && !existingFileStats) {
145
+ return createErrorResponse('CANNOT_OVERWRITE_NONEXISTENT', {
146
+ filename: args.filename,
147
+ filepath: filepath
148
+ });
149
+ }
150
+ // If file exists and overwrite not allowed, return error BEFORE downloading
151
+ if (existingFileStats && !args.overwriteIfExists) {
152
+ // Do a HEAD request to get new file size without downloading
153
+ let newFileSize = 'Unknown';
154
+ try {
155
+ const headResponse = await fetch(args.url, { method: 'HEAD' });
156
+ if (headResponse.ok) {
157
+ const contentLength = headResponse.headers.get('content-length');
158
+ if (contentLength) {
159
+ newFileSize = `${(parseInt(contentLength) / 1024).toFixed(2)} KB`;
160
+ }
161
+ }
162
+ }
163
+ catch {
164
+ // Ignore HEAD request failures, just show unknown size
165
+ }
166
+ const existingFileSizeKB = (existingFileStats.size / 1024).toFixed(2);
167
+ return createErrorResponse('FILE_ALREADY_EXISTS', {
168
+ filename: args.filename,
169
+ filepath: filepath,
170
+ existingSize: `${existingFileSizeKB} KB`,
171
+ existingModified: existingFileStats.mtime.toISOString(),
172
+ newSize: newFileSize,
173
+ url: args.url
174
+ });
175
+ }
176
+ // Fetch the URL
177
+ const response = await fetch(args.url);
178
+ if (!response.ok) {
179
+ return createErrorResponse('FILE_DOWNLOAD_FAILED', {
180
+ url: args.url,
181
+ status: response.status.toString(),
182
+ statusText: response.statusText
183
+ });
184
+ }
185
+ // Check content-length header for size limits
186
+ const contentLength = response.headers.get('content-length');
187
+ const contentType = response.headers.get('content-type');
188
+ if (contentLength) {
189
+ const sizeBytes = parseInt(contentLength);
190
+ if (sizeBytes > MAX_FILE_SIZE) {
191
+ return createErrorResponse('FILE_TOO_LARGE', {
192
+ url: args.url,
193
+ size: `${(sizeBytes / 1024 / 1024).toFixed(2)} MB`,
194
+ maxSize: `${(MAX_FILE_SIZE / 1024 / 1024).toFixed(2)} MB`
195
+ });
196
+ }
197
+ }
198
+ // Get the response body
199
+ const arrayBuffer = await response.arrayBuffer();
200
+ const buffer = Buffer.from(arrayBuffer);
201
+ const actualSize = buffer.length;
202
+ // Double-check size after download
203
+ if (actualSize > MAX_FILE_SIZE) {
204
+ return createErrorResponse('FILE_TOO_LARGE', {
205
+ url: args.url,
206
+ size: `${(actualSize / 1024 / 1024).toFixed(2)} MB`,
207
+ maxSize: `${(MAX_FILE_SIZE / 1024 / 1024).toFixed(2)} MB`
208
+ });
209
+ }
210
+ const newFileSizeKB = (actualSize / 1024).toFixed(2);
211
+ // Check if file is suspicious
212
+ const suspiciousCheck = isSuspicious(args.filename, contentType);
213
+ if (suspiciousCheck.suspicious) {
214
+ // Quarantine the file instead of saving to downloads
215
+ await quarantineFile(args.url, args.filename, suspiciousCheck.reason, actualSize, contentType, buffer);
216
+ const quarantinedFilename = `${args.filename}.quarantined`;
217
+ return createErrorResponse('FILE_QUARANTINED', {
218
+ filename: quarantinedFilename,
219
+ reason: suspiciousCheck.reason,
220
+ size: `${newFileSizeKB} KB`,
221
+ contentType: contentType || 'Unknown',
222
+ quarantinePath: join(getQuarantineDir(), quarantinedFilename)
223
+ });
224
+ }
225
+ // Use atomic write with rename to avoid race conditions
226
+ const tempFilepath = `${filepath}.tmp.${Date.now()}`;
227
+ try {
228
+ await fs.writeFile(tempFilepath, buffer);
229
+ await fs.rename(tempFilepath, filepath);
230
+ // Remove executable permissions for security
231
+ await removeExecutablePermissions(filepath);
232
+ }
233
+ catch (saveError) {
234
+ // Clean up temp file if it exists
235
+ try {
236
+ await fs.unlink(tempFilepath);
237
+ }
238
+ catch {
239
+ // Ignore cleanup errors
240
+ }
241
+ return createErrorResponse('FILE_SAVE_FAILED', {
242
+ filepath: filepath,
243
+ error: saveError.message
244
+ });
245
+ }
246
+ // Return appropriate message based on whether we overwrote
247
+ if (existingFileStats && args.overwriteIfExists) {
248
+ return createSuccessResponse('FILE_DOWNLOADED_OVERWROTE', {
249
+ filename: args.filename,
250
+ filepath: filepath,
251
+ size: `${newFileSizeKB} KB`,
252
+ url: args.url
253
+ });
254
+ }
255
+ else {
256
+ return createSuccessResponse('FILE_DOWNLOADED', {
257
+ filename: args.filename,
258
+ filepath: filepath,
259
+ size: `${newFileSizeKB} KB`,
260
+ url: args.url
261
+ });
262
+ }
263
+ }
264
+ catch (error) {
265
+ // Differentiate between fetch and save errors
266
+ if (error.cause?.code === 'ECONNREFUSED' || error.cause?.code === 'ENOTFOUND') {
267
+ return createErrorResponse('FILE_DOWNLOAD_NETWORK_ERROR', {
268
+ url: args.url,
269
+ error: error.message
270
+ });
271
+ }
272
+ return createErrorResponse('FILE_DOWNLOAD_FAILED', {
273
+ url: args.url,
274
+ error: error.message
275
+ });
276
+ }
277
+ }),
278
+ };
279
+ }
280
+ //# sourceMappingURL=download-tools.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"download-tools.js","sourceRoot":"","sources":["../../src/tools/download-tools.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,40 @@
1
+ /**
2
+ * Execution Control Tools
3
+ */
4
+ import { z } from 'zod';
5
+ import { CDPManager } from '../cdp-manager.js';
6
+ import type { ConnectionManager } from '../connection-manager.js';
7
+ export declare function createExecutionTools(cdpManager: CDPManager, resolveConnectionFromReason?: (connectionReason: string) => Promise<{
8
+ connection: any;
9
+ cdpManager: CDPManager;
10
+ puppeteerManager: any;
11
+ consoleMonitor: any;
12
+ networkMonitor: any;
13
+ } | null>, connectionManager?: ConnectionManager,
14
+ /** Give a watch-mode restart deferred by this connection's pause a chance to fire now that it's resuming. */
15
+ retryPendingRestart?: (port: number) => void): {
16
+ execution: {
17
+ description: string;
18
+ zodSchema: z.ZodObject<{
19
+ action: z.ZodEnum<["pause", "resume", "stepOver", "stepInto", "stepOut", "acknowledge"]>;
20
+ connectionReason: z.ZodOptional<z.ZodString>;
21
+ }, "strict", z.ZodTypeAny, {
22
+ action: "acknowledge" | "pause" | "resume" | "stepOver" | "stepInto" | "stepOut";
23
+ connectionReason?: string | undefined;
24
+ }, {
25
+ action: "acknowledge" | "pause" | "resume" | "stepOver" | "stepInto" | "stepOut";
26
+ connectionReason?: string | undefined;
27
+ }>;
28
+ inputSchema: import("zod-to-json-schema").JsonSchema7Type & {
29
+ $schema?: string | undefined;
30
+ definitions?: {
31
+ [key: string]: import("zod-to-json-schema").JsonSchema7Type;
32
+ } | undefined;
33
+ };
34
+ handler: (args: {
35
+ action: "acknowledge" | "pause" | "resume" | "stepOver" | "stepInto" | "stepOut";
36
+ connectionReason?: string | undefined;
37
+ }, abortSignal?: AbortSignal) => Promise<any>;
38
+ };
39
+ };
40
+ //# sourceMappingURL=execution-tools.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"execution-tools.d.ts","sourceRoot":"","sources":["../../src/tools/execution-tools.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAG/C,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAQlE,wBAAgB,oBAAoB,CAClC,UAAU,EAAE,UAAU,EACtB,2BAA2B,CAAC,EAAE,CAAC,gBAAgB,EAAE,MAAM,KAAK,OAAO,CAAC;IAClE,UAAU,EAAE,GAAG,CAAC;IAChB,UAAU,EAAE,UAAU,CAAC;IACvB,gBAAgB,EAAE,GAAG,CAAC;IACtB,cAAc,EAAE,GAAG,CAAC;IACpB,cAAc,EAAE,GAAG,CAAC;CACrB,GAAG,IAAI,CAAC,EACT,iBAAiB,CAAC,EAAE,iBAAiB;AACrC,6GAA6G;AAC7G,mBAAmB,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI;;;;;;;;;;;;;;;;;;;;;;;;EA8H7C"}
@@ -0,0 +1,121 @@
1
+ /**
2
+ * Execution Control Tools
3
+ */
4
+ import { z } from 'zod';
5
+ import { createTool } from '../validation-helpers.js';
6
+ import { createSuccessResponse, createErrorResponse, formatCodeBlock } from '../messages.js';
7
+ // Consolidated schema with action parameter
8
+ const executionSchema = z.object({
9
+ action: z.enum(['pause', 'resume', 'stepOver', 'stepInto', 'stepOut', 'acknowledge']).describe('Execution control action to perform'),
10
+ connectionReason: z.string().optional().describe('Connection reference (use the reference from launchChrome output, e.g., "unnamed-connection-default" or your renamed tab)'),
11
+ }).strict();
12
+ export function createExecutionTools(cdpManager, resolveConnectionFromReason, connectionManager,
13
+ /** Give a watch-mode restart deferred by this connection's pause a chance to fire now that it's resuming. */
14
+ retryPendingRestart) {
15
+ return {
16
+ execution: createTool('Control execution flow when paused at breakpoints. Actions: pause (pause execution), resume (resume execution), stepOver (step to next line), stepInto (step into function call), stepOut (step out of current function), acknowledge (acknowledge breakpoint pause to allow other tools to run while paused)', executionSchema, async (args) => {
17
+ const { action, connectionReason } = args;
18
+ // Resolve connection if connectionReason is provided
19
+ let targetCdpManager = cdpManager;
20
+ let resolvedConnection = null;
21
+ if (connectionReason && resolveConnectionFromReason) {
22
+ const resolved = await resolveConnectionFromReason(connectionReason);
23
+ if (!resolved) {
24
+ return createErrorResponse('CONNECTION_NOT_FOUND');
25
+ }
26
+ targetCdpManager = resolved.cdpManager;
27
+ resolvedConnection = resolved.connection;
28
+ }
29
+ // Helper to clear acknowledged flag when execution moves
30
+ const clearAcknowledgedFlag = () => {
31
+ if (resolvedConnection) {
32
+ resolvedConnection.breakpointPauseAcknowledged = false;
33
+ }
34
+ else if (connectionManager) {
35
+ // Clear for all connections when no specific connection is specified
36
+ for (const conn of connectionManager.getAllConnections()) {
37
+ conn.breakpointPauseAcknowledged = false;
38
+ }
39
+ }
40
+ };
41
+ // Handle each action
42
+ switch (action) {
43
+ case 'pause':
44
+ await targetCdpManager.pause();
45
+ return createSuccessResponse('EXECUTION_PAUSED');
46
+ case 'resume': {
47
+ // Check if execution was paused due to logpoint limit exceeded
48
+ const logpointLimit = targetCdpManager.getLogpointLimitExceeded();
49
+ if (logpointLimit) {
50
+ // Format logs as a code block
51
+ const logsFormatted = formatCodeBlock(logpointLimit.logs);
52
+ return createErrorResponse('LOGPOINT_LIMIT_EXCEEDED', {
53
+ url: logpointLimit.url,
54
+ lineNumber: logpointLimit.lineNumber,
55
+ executionCount: logpointLimit.executionCount,
56
+ maxExecutions: logpointLimit.maxExecutions,
57
+ breakpointId: logpointLimit.breakpointId,
58
+ logs: logsFormatted,
59
+ });
60
+ }
61
+ // Clear acknowledged flag when resuming (auto-unblock)
62
+ clearAcknowledgedFlag();
63
+ // Normal resume
64
+ await targetCdpManager.resume();
65
+ // A watch-mode restart may have been queued while this
66
+ // connection was paused - give it a chance to fire now.
67
+ if (retryPendingRestart) {
68
+ if (resolvedConnection) {
69
+ retryPendingRestart(resolvedConnection.port);
70
+ }
71
+ else if (connectionManager) {
72
+ for (const conn of connectionManager.getAllConnections()) {
73
+ retryPendingRestart(conn.port);
74
+ }
75
+ }
76
+ }
77
+ return createSuccessResponse('EXECUTION_RESUMED');
78
+ }
79
+ case 'stepOver':
80
+ clearAcknowledgedFlag();
81
+ await targetCdpManager.stepOver();
82
+ return createSuccessResponse('EXECUTION_STEP_OVER');
83
+ case 'stepInto':
84
+ clearAcknowledgedFlag();
85
+ await targetCdpManager.stepInto();
86
+ return createSuccessResponse('EXECUTION_STEP_INTO');
87
+ case 'stepOut':
88
+ clearAcknowledgedFlag();
89
+ await targetCdpManager.stepOut();
90
+ return createSuccessResponse('EXECUTION_STEP_OUT');
91
+ case 'acknowledge': {
92
+ // Acknowledge the breakpoint pause to allow other tools to run
93
+ if (!targetCdpManager.isPaused()) {
94
+ return createErrorResponse('NOT_PAUSED');
95
+ }
96
+ if (resolvedConnection) {
97
+ resolvedConnection.breakpointPauseAcknowledged = true;
98
+ }
99
+ else if (connectionManager) {
100
+ // Acknowledge all paused connections
101
+ for (const conn of connectionManager.getAllConnections()) {
102
+ if (conn.cdpManager.isPaused()) {
103
+ conn.breakpointPauseAcknowledged = true;
104
+ }
105
+ }
106
+ }
107
+ const pauseInfo = targetCdpManager.getPausedInfo();
108
+ const location = pauseInfo.location
109
+ ? `${pauseInfo.location.url}:${pauseInfo.location.lineNumber}`
110
+ : 'unknown location';
111
+ return createSuccessResponse('BREAKPOINT_ACKNOWLEDGED', {
112
+ location,
113
+ });
114
+ }
115
+ default:
116
+ return createErrorResponse('INVALID_ACTION', { action });
117
+ }
118
+ }),
119
+ };
120
+ }
121
+ //# sourceMappingURL=execution-tools.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"execution-tools.js","sourceRoot":"","sources":["../../src/tools/execution-tools.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=input-abort.test.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"input-abort.test.d.ts","sourceRoot":"","sources":["../../src/tools/input-abort.test.ts"],"names":[],"mappings":""}