@speedkit/cli 4.51.1 → 4.52.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 (439) hide show
  1. package/CHANGELOG.md +7 -0
  2. package/README.md +1426 -14
  3. package/dist/base/run-control-command.d.ts +15 -0
  4. package/dist/base/run-control-command.js +20 -0
  5. package/dist/build-info.json +6 -0
  6. package/dist/commands/diff.d.ts +7 -1
  7. package/dist/commands/diff.js +9 -3
  8. package/dist/commands/login.d.ts +3 -0
  9. package/dist/commands/login.js +14 -3
  10. package/dist/commands/onboarding/browser/click.d.ts +75 -0
  11. package/dist/commands/onboarding/browser/click.js +19 -0
  12. package/dist/commands/onboarding/browser/emulate.d.ts +105 -0
  13. package/dist/commands/onboarding/browser/emulate.js +26 -0
  14. package/dist/commands/onboarding/browser/navigate.d.ts +75 -0
  15. package/dist/commands/onboarding/browser/navigate.js +19 -0
  16. package/dist/commands/onboarding/browser/panel.d.ts +63 -0
  17. package/dist/commands/onboarding/browser/panel.js +12 -0
  18. package/dist/commands/onboarding/browser/reinstall-sw.d.ts +63 -0
  19. package/dist/commands/onboarding/browser/reinstall-sw.js +14 -0
  20. package/dist/commands/onboarding/browser/reset.d.ts +71 -0
  21. package/dist/commands/onboarding/browser/reset.js +18 -0
  22. package/dist/commands/onboarding/browser/screenshot.d.ts +77 -0
  23. package/dist/commands/onboarding/browser/screenshot.js +19 -0
  24. package/dist/commands/onboarding/browser/state.d.ts +63 -0
  25. package/dist/commands/onboarding/browser/state.js +12 -0
  26. package/dist/commands/onboarding/browser/tabs.d.ts +58 -0
  27. package/dist/commands/onboarding/browser/tabs.js +16 -0
  28. package/dist/commands/onboarding/cache/clear.d.ts +58 -0
  29. package/dist/commands/onboarding/cache/clear.js +12 -0
  30. package/dist/commands/onboarding/cache/errors.d.ts +58 -0
  31. package/dist/commands/onboarding/cache/errors.js +12 -0
  32. package/dist/commands/onboarding/cache/evict.d.ts +62 -0
  33. package/dist/commands/onboarding/cache/evict.js +15 -0
  34. package/dist/commands/onboarding/cache/get.d.ts +85 -0
  35. package/dist/commands/onboarding/cache/get.js +17 -0
  36. package/dist/commands/onboarding/cache/list.d.ts +58 -0
  37. package/dist/commands/onboarding/cache/list.js +15 -0
  38. package/dist/commands/onboarding/cache/prewarm.d.ts +73 -0
  39. package/dist/commands/onboarding/cache/prewarm.js +20 -0
  40. package/dist/commands/onboarding/cache/refresh.d.ts +62 -0
  41. package/dist/commands/onboarding/cache/refresh.js +18 -0
  42. package/dist/commands/onboarding/cdp.d.ts +81 -0
  43. package/dist/commands/onboarding/cdp.js +18 -0
  44. package/dist/commands/onboarding/debug/arm.d.ts +83 -0
  45. package/dist/commands/onboarding/debug/arm.js +19 -0
  46. package/dist/commands/onboarding/debug/await.d.ts +71 -0
  47. package/dist/commands/onboarding/debug/await.js +18 -0
  48. package/dist/commands/onboarding/debug/disarm.d.ts +63 -0
  49. package/dist/commands/onboarding/debug/disarm.js +12 -0
  50. package/dist/commands/onboarding/debug/eval.d.ts +75 -0
  51. package/dist/commands/onboarding/debug/eval.js +16 -0
  52. package/dist/commands/onboarding/debug/release.d.ts +63 -0
  53. package/dist/commands/onboarding/debug/release.js +12 -0
  54. package/dist/commands/onboarding/debug/resume.d.ts +63 -0
  55. package/dist/commands/onboarding/debug/resume.js +12 -0
  56. package/dist/commands/onboarding/debug/status.d.ts +63 -0
  57. package/dist/commands/onboarding/debug/status.js +12 -0
  58. package/dist/commands/onboarding/debug/step.d.ts +67 -0
  59. package/dist/commands/onboarding/debug/step.js +15 -0
  60. package/dist/commands/onboarding/files/list.d.ts +58 -0
  61. package/dist/commands/onboarding/files/list.js +12 -0
  62. package/dist/commands/onboarding/files/read.d.ts +73 -0
  63. package/dist/commands/onboarding/files/read.js +16 -0
  64. package/dist/commands/onboarding/files/rebuild.d.ts +63 -0
  65. package/dist/commands/onboarding/files/rebuild.js +18 -0
  66. package/dist/commands/onboarding/files/validate.d.ts +58 -0
  67. package/dist/commands/onboarding/files/validate.js +12 -0
  68. package/dist/commands/onboarding/fouc.d.ts +77 -0
  69. package/dist/commands/onboarding/fouc.js +16 -0
  70. package/dist/commands/onboarding/inject/add.d.ts +89 -0
  71. package/dist/commands/onboarding/inject/add.js +17 -0
  72. package/dist/commands/onboarding/inject/clear.d.ts +63 -0
  73. package/dist/commands/onboarding/inject/clear.js +12 -0
  74. package/dist/commands/onboarding/inject/list.d.ts +63 -0
  75. package/dist/commands/onboarding/inject/list.js +12 -0
  76. package/dist/commands/onboarding/inject/read.d.ts +75 -0
  77. package/dist/commands/onboarding/inject/read.js +18 -0
  78. package/dist/commands/onboarding/inject/recipes.d.ts +63 -0
  79. package/dist/commands/onboarding/inject/recipes.js +12 -0
  80. package/dist/commands/onboarding/inject/remove.d.ts +67 -0
  81. package/dist/commands/onboarding/inject/remove.js +15 -0
  82. package/dist/commands/onboarding/list.d.ts +13 -0
  83. package/dist/commands/onboarding/list.js +12 -0
  84. package/dist/commands/onboarding/logs.d.ts +41 -0
  85. package/dist/commands/onboarding/logs.js +257 -0
  86. package/dist/commands/onboarding/navwalk.d.ts +95 -0
  87. package/dist/commands/onboarding/navwalk.js +19 -0
  88. package/dist/commands/onboarding/response.d.ts +67 -0
  89. package/dist/commands/onboarding/response.js +18 -0
  90. package/dist/commands/onboarding/rum/beacons.d.ts +75 -0
  91. package/dist/commands/onboarding/rum/beacons.js +16 -0
  92. package/dist/commands/onboarding/rum/get.d.ts +77 -0
  93. package/dist/commands/onboarding/rum/get.js +18 -0
  94. package/dist/commands/onboarding/rum/key.d.ts +67 -0
  95. package/dist/commands/onboarding/rum/key.js +13 -0
  96. package/dist/commands/onboarding/rum/previous.d.ts +63 -0
  97. package/dist/commands/onboarding/rum/previous.js +12 -0
  98. package/dist/commands/onboarding/status.d.ts +13 -0
  99. package/dist/commands/onboarding/status.js +17 -0
  100. package/dist/commands/onboarding/stop.d.ts +13 -0
  101. package/dist/commands/onboarding/stop.js +17 -0
  102. package/dist/commands/onboarding/todo.d.ts +58 -0
  103. package/dist/commands/onboarding/todo.js +12 -0
  104. package/dist/commands/onboarding/viewport.d.ts +101 -0
  105. package/dist/commands/onboarding/viewport.js +18 -0
  106. package/dist/commands/onboarding/watch.d.ts +93 -0
  107. package/dist/commands/onboarding/watch.js +16 -0
  108. package/dist/commands/onboarding.d.ts +26 -0
  109. package/dist/commands/onboarding.js +221 -4
  110. package/dist/commands/origin-request.d.ts +4 -0
  111. package/dist/commands/origin-request.js +4 -0
  112. package/dist/commands/spec/onboarding.spec.d.ts +1 -0
  113. package/dist/commands/spec/onboarding.spec.js +127 -0
  114. package/dist/services/browser-fetch/device-emulation.d.ts +11 -0
  115. package/dist/services/browser-fetch/device-emulation.js +14 -0
  116. package/dist/services/cli/build-info.d.ts +33 -0
  117. package/dist/services/cli/build-info.js +63 -0
  118. package/dist/services/cli/cli-environment-factory.d.ts +3 -0
  119. package/dist/services/cli/cli-environment-factory.js +1 -0
  120. package/dist/services/cli/cli-service-build-context.d.ts +3 -0
  121. package/dist/services/cli/cli-service-factory.js +1 -1
  122. package/dist/services/cli/cli-service-model.d.ts +29 -10
  123. package/dist/services/cli/cli-service.d.ts +60 -11
  124. package/dist/services/cli/cli-service.js +196 -32
  125. package/dist/services/cli/index.d.ts +2 -0
  126. package/dist/services/cli/index.js +2 -0
  127. package/dist/services/cli/sink.d.ts +47 -0
  128. package/dist/services/cli/sink.js +31 -0
  129. package/dist/services/cli/spec/build-identity.spec.d.ts +1 -0
  130. package/dist/services/cli/spec/build-identity.spec.js +85 -0
  131. package/dist/services/cli/spec/build-info.spec.d.ts +1 -0
  132. package/dist/services/cli/spec/build-info.spec.js +10 -0
  133. package/dist/services/cli/spec/cli-service-log.spec.d.ts +1 -0
  134. package/dist/services/cli/spec/cli-service-log.spec.js +133 -0
  135. package/dist/services/cli/spec/cli-service.spec.js +113 -50
  136. package/dist/services/cli/spec/memory-cli.d.ts +9 -0
  137. package/dist/services/cli/spec/memory-cli.js +9 -0
  138. package/dist/services/diff/config-at-ref.d.ts +20 -0
  139. package/dist/services/diff/config-at-ref.js +33 -0
  140. package/dist/services/diff/diff-service-build-context.d.ts +12 -0
  141. package/dist/services/diff/diff-service-build-context.js +45 -1
  142. package/dist/services/diff/diff-service-factory.d.ts +2 -0
  143. package/dist/services/diff/diff-service-factory.js +65 -25
  144. package/dist/services/diff/diff-service.d.ts +11 -0
  145. package/dist/services/diff/diff-service.js +37 -11
  146. package/dist/services/diff/page-source.d.ts +12 -0
  147. package/dist/services/diff/page-source.js +16 -11
  148. package/dist/services/diff/run-runtime-config.d.ts +33 -0
  149. package/dist/services/diff/run-runtime-config.js +74 -0
  150. package/dist/services/diff/sinks/tool-diff-sink.d.ts +3 -2
  151. package/dist/services/diff/sinks/tool-diff-sink.js +3 -2
  152. package/dist/services/diff/spec/config-at-ref.spec.d.ts +1 -0
  153. package/dist/services/diff/spec/config-at-ref.spec.js +46 -0
  154. package/dist/services/diff/spec/diff-service-build-context.spec.js +19 -0
  155. package/dist/services/diff/spec/diff-service.spec.js +95 -0
  156. package/dist/services/diff/spec/run-runtime-config.spec.d.ts +1 -0
  157. package/dist/services/diff/spec/run-runtime-config.spec.js +87 -0
  158. package/dist/services/git/git-repository.d.ts +2 -0
  159. package/dist/services/git/git-repository.js +6 -0
  160. package/dist/services/integration-api/customer-config-flags.js +1 -0
  161. package/dist/services/onboarding/browse/browse-service.d.ts +13 -1
  162. package/dist/services/onboarding/browse/browse-service.js +43 -7
  163. package/dist/services/onboarding/browser/answer-dialogs.d.ts +12 -0
  164. package/dist/services/onboarding/browser/answer-dialogs.js +25 -0
  165. package/dist/services/onboarding/browser/baqend-response.d.ts +17 -1
  166. package/dist/services/onboarding/browser/baqend-response.js +23 -0
  167. package/dist/services/onboarding/browser/console-log.d.ts +9 -0
  168. package/dist/services/onboarding/browser/console-log.js +27 -0
  169. package/dist/services/onboarding/browser/emulate-device.d.ts +12 -1
  170. package/dist/services/onboarding/browser/emulate-device.js +68 -13
  171. package/dist/services/onboarding/browser/executable/executable-validator.js +4 -2
  172. package/dist/services/onboarding/browser/extension/extension-bridge.js +5 -3
  173. package/dist/services/onboarding/browser/extension/extension-downloader.js +17 -8
  174. package/dist/services/onboarding/browser/extension/extension-validator.js +9 -4
  175. package/dist/services/onboarding/browser/launch-browser.d.ts +2 -1
  176. package/dist/services/onboarding/browser/launch-browser.js +6 -1
  177. package/dist/services/onboarding/browser/resume-restarted-workers.d.ts +14 -0
  178. package/dist/services/onboarding/browser/resume-restarted-workers.js +26 -0
  179. package/dist/services/onboarding/control/body-inspect.d.ts +24 -0
  180. package/dist/services/onboarding/control/body-inspect.js +106 -0
  181. package/dist/services/onboarding/control/browser-session.d.ts +547 -0
  182. package/dist/services/onboarding/control/browser-session.js +1337 -0
  183. package/dist/services/onboarding/control/config-validation.d.ts +17 -0
  184. package/dist/services/onboarding/control/config-validation.js +46 -0
  185. package/dist/services/onboarding/control/control-protocol.d.ts +1430 -0
  186. package/dist/services/onboarding/control/control-protocol.js +58 -0
  187. package/dist/services/onboarding/control/control-server.d.ts +292 -0
  188. package/dist/services/onboarding/control/control-server.js +1629 -0
  189. package/dist/services/onboarding/control/debug-session.d.ts +219 -0
  190. package/dist/services/onboarding/control/debug-session.js +897 -0
  191. package/dist/services/onboarding/control/fouc.d.ts +23 -0
  192. package/dist/services/onboarding/control/fouc.js +151 -0
  193. package/dist/services/onboarding/control/index.d.ts +4 -0
  194. package/dist/services/onboarding/control/index.js +4 -0
  195. package/dist/services/onboarding/control/navigate-wait.d.ts +33 -0
  196. package/dist/services/onboarding/control/navigate-wait.js +56 -0
  197. package/dist/services/onboarding/control/navwalk.d.ts +65 -0
  198. package/dist/services/onboarding/control/navwalk.js +248 -0
  199. package/dist/services/onboarding/control/preload-registry.d.ts +150 -0
  200. package/dist/services/onboarding/control/preload-registry.js +829 -0
  201. package/dist/services/onboarding/control/response-explainer.d.ts +24 -0
  202. package/dist/services/onboarding/control/response-explainer.js +257 -0
  203. package/dist/services/onboarding/control/rum.d.ts +8 -0
  204. package/dist/services/onboarding/control/rum.js +220 -0
  205. package/dist/services/onboarding/control/service-worker-tracker.d.ts +68 -0
  206. package/dist/services/onboarding/control/service-worker-tracker.js +120 -0
  207. package/dist/services/onboarding/control/viewport.d.ts +45 -0
  208. package/dist/services/onboarding/control/viewport.js +344 -0
  209. package/dist/services/onboarding/control/watch.d.ts +26 -0
  210. package/dist/services/onboarding/control/watch.js +157 -0
  211. package/dist/services/onboarding/dashboard/diff-against-current-page.js +3 -1
  212. package/dist/services/onboarding/dashboard/index.js +7 -2
  213. package/dist/services/onboarding/fetch-event-handler.d.ts +24 -5
  214. package/dist/services/onboarding/fetch-event-handler.js +103 -32
  215. package/dist/services/onboarding/fetch-events/speed-kit-install-js.js +11 -2
  216. package/dist/services/onboarding/fetch-events/speed-kit-rum-pi-request.d.ts +14 -0
  217. package/dist/services/onboarding/fetch-events/speed-kit-rum-pi-request.js +30 -0
  218. package/dist/services/onboarding/fetch-events/speed-kit-service-worker-js.d.ts +13 -0
  219. package/dist/services/onboarding/fetch-events/speed-kit-service-worker-js.js +28 -1
  220. package/dist/services/onboarding/file-events/file-watcher.d.ts +42 -1
  221. package/dist/services/onboarding/file-events/file-watcher.js +117 -12
  222. package/dist/services/onboarding/inject/inject-service.js +1 -1
  223. package/dist/services/onboarding/onboarding-model.d.ts +40 -7
  224. package/dist/services/onboarding/onboarding-model.js +20 -9
  225. package/dist/services/onboarding/onboarding-service-build-context.d.ts +4 -0
  226. package/dist/services/onboarding/onboarding-service-build-context.js +7 -1
  227. package/dist/services/onboarding/onboarding-service-factory.d.ts +17 -1
  228. package/dist/services/onboarding/onboarding-service-factory.js +150 -23
  229. package/dist/services/onboarding/onboarding-service.d.ts +40 -1
  230. package/dist/services/onboarding/onboarding-service.js +139 -23
  231. package/dist/services/onboarding/request-cache/asset-key.d.ts +61 -0
  232. package/dist/services/onboarding/request-cache/asset-key.js +115 -0
  233. package/dist/services/onboarding/request-cache/cache.d.ts +62 -5
  234. package/dist/services/onboarding/request-cache/cache.js +128 -17
  235. package/dist/services/onboarding/spec/browser/answer-dialogs.spec.d.ts +1 -0
  236. package/dist/services/onboarding/spec/browser/answer-dialogs.spec.js +66 -0
  237. package/dist/services/onboarding/spec/browser/console-log.spec.d.ts +1 -0
  238. package/dist/services/onboarding/spec/browser/console-log.spec.js +42 -0
  239. package/dist/services/onboarding/spec/browser/resume-restarted-workers.spec.d.ts +1 -0
  240. package/dist/services/onboarding/spec/browser/resume-restarted-workers.spec.js +45 -0
  241. package/dist/services/onboarding/spec/control/browser-session.spec.d.ts +1 -0
  242. package/dist/services/onboarding/spec/control/browser-session.spec.js +753 -0
  243. package/dist/services/onboarding/spec/control/control-server.spec.d.ts +1 -0
  244. package/dist/services/onboarding/spec/control/control-server.spec.js +371 -0
  245. package/dist/services/onboarding/spec/control/debug-session.spec.d.ts +1 -0
  246. package/dist/services/onboarding/spec/control/debug-session.spec.js +751 -0
  247. package/dist/services/onboarding/spec/control/fakes.d.ts +31 -0
  248. package/dist/services/onboarding/spec/control/fakes.js +67 -0
  249. package/dist/services/onboarding/spec/control/fouc.spec.d.ts +1 -0
  250. package/dist/services/onboarding/spec/control/fouc.spec.js +167 -0
  251. package/dist/services/onboarding/spec/control/navigate-wait.spec.d.ts +1 -0
  252. package/dist/services/onboarding/spec/control/navigate-wait.spec.js +47 -0
  253. package/dist/services/onboarding/spec/control/navwalk.spec.d.ts +1 -0
  254. package/dist/services/onboarding/spec/control/navwalk.spec.js +222 -0
  255. package/dist/services/onboarding/spec/control/preload-registry.spec.d.ts +1 -0
  256. package/dist/services/onboarding/spec/control/preload-registry.spec.js +432 -0
  257. package/dist/services/onboarding/spec/control/response-explainer.spec.d.ts +1 -0
  258. package/dist/services/onboarding/spec/control/response-explainer.spec.js +324 -0
  259. package/dist/services/onboarding/spec/control/rum.spec.d.ts +1 -0
  260. package/dist/services/onboarding/spec/control/rum.spec.js +222 -0
  261. package/dist/services/onboarding/spec/control/service-worker-tracker.spec.d.ts +1 -0
  262. package/dist/services/onboarding/spec/control/service-worker-tracker.spec.js +193 -0
  263. package/dist/services/onboarding/spec/control/viewport.spec.d.ts +1 -0
  264. package/dist/services/onboarding/spec/control/viewport.spec.js +200 -0
  265. package/dist/services/onboarding/spec/control/watch.spec.d.ts +1 -0
  266. package/dist/services/onboarding/spec/control/watch.spec.js +187 -0
  267. package/dist/services/onboarding/spec/fetch-event-handler.spec.d.ts +1 -0
  268. package/dist/services/onboarding/spec/fetch-event-handler.spec.js +219 -0
  269. package/dist/services/onboarding/spec/fetch-events/speed-kit-service-worker-js.spec.d.ts +1 -0
  270. package/dist/services/onboarding/spec/fetch-events/speed-kit-service-worker-js.spec.js +41 -0
  271. package/dist/services/onboarding/spec/onboarding-model.spec.js +39 -3
  272. package/dist/services/onboarding/spec/onboarding-service-factory.spec.js +25 -1
  273. package/dist/services/onboarding/spec/request-cache/cache.spec.d.ts +1 -0
  274. package/dist/services/onboarding/spec/request-cache/cache.spec.js +107 -0
  275. package/dist/services/onboarding/spec/todo-collector.spec.d.ts +1 -0
  276. package/dist/services/onboarding/spec/todo-collector.spec.js +136 -0
  277. package/dist/services/onboarding/spec/virtual-orestes-app/virtual-orestes-app.spec.d.ts +1 -0
  278. package/dist/services/onboarding/spec/virtual-orestes-app/virtual-orestes-app.spec.js +65 -0
  279. package/dist/services/onboarding/todo-collector.d.ts +7 -2
  280. package/dist/services/onboarding/todo-collector.js +49 -12
  281. package/dist/services/onboarding/virtual-orestes-app/index.d.ts +38 -0
  282. package/dist/services/onboarding/virtual-orestes-app/index.js +113 -27
  283. package/dist/services/origin-request/asset-variations.d.ts +14 -0
  284. package/dist/services/origin-request/asset-variations.js +11 -4
  285. package/dist/services/origin-request/origin-fetcher.d.ts +7 -0
  286. package/dist/services/origin-request/origin-fetcher.js +43 -5
  287. package/dist/services/origin-request/origin-request-service-build-context.d.ts +17 -0
  288. package/dist/services/origin-request/origin-request-service-build-context.js +8 -0
  289. package/dist/services/origin-request/origin-request-service-factory.d.ts +0 -5
  290. package/dist/services/origin-request/origin-request-service-factory.js +2 -30
  291. package/dist/services/origin-request/origin-request-service.d.ts +121 -6
  292. package/dist/services/origin-request/origin-request-service.js +273 -49
  293. package/dist/services/origin-request/runtime-config-source.d.ts +6 -0
  294. package/dist/services/origin-request/runtime-config-source.js +15 -4
  295. package/dist/services/origin-request/spec/asset-variations.spec.js +20 -0
  296. package/dist/services/origin-request/spec/origin-request-service.spec.js +329 -6
  297. package/dist/services/query-builder/rules/rule-match.d.ts +35 -0
  298. package/dist/services/query-builder/rules/rule-match.js +70 -0
  299. package/dist/services/query-builder/spec/rules/rule-match.spec.d.ts +1 -0
  300. package/dist/services/query-builder/spec/rules/rule-match.spec.js +121 -0
  301. package/dist/services/run-control/browser/run-browser-contexts.d.ts +557 -0
  302. package/dist/services/run-control/browser/run-browser-contexts.js +91 -0
  303. package/dist/services/run-control/browser/run-browser-service-factory.d.ts +5 -0
  304. package/dist/services/run-control/browser/run-browser-service-factory.js +7 -0
  305. package/dist/services/run-control/browser/run-browser-service.d.ts +68 -0
  306. package/dist/services/run-control/browser/run-browser-service.js +206 -0
  307. package/dist/services/run-control/cache/run-cache-contexts.d.ts +349 -0
  308. package/dist/services/run-control/cache/run-cache-contexts.js +51 -0
  309. package/dist/services/run-control/cache/run-cache-service-factory.d.ts +6 -0
  310. package/dist/services/run-control/cache/run-cache-service-factory.js +12 -0
  311. package/dist/services/run-control/cache/run-cache-service.d.ts +35 -0
  312. package/dist/services/run-control/cache/run-cache-service.js +151 -0
  313. package/dist/services/run-control/control-client.d.ts +36 -0
  314. package/dist/services/run-control/control-client.js +147 -0
  315. package/dist/services/run-control/debug/run-debug-contexts.d.ts +416 -0
  316. package/dist/services/run-control/debug/run-debug-contexts.js +47 -0
  317. package/dist/services/run-control/debug/run-debug-service-factory.d.ts +5 -0
  318. package/dist/services/run-control/debug/run-debug-service-factory.js +7 -0
  319. package/dist/services/run-control/debug/run-debug-service.d.ts +39 -0
  320. package/dist/services/run-control/debug/run-debug-service.js +164 -0
  321. package/dist/services/run-control/files/run-files-contexts.d.ts +238 -0
  322. package/dist/services/run-control/files/run-files-contexts.js +26 -0
  323. package/dist/services/run-control/files/run-files-service-factory.d.ts +5 -0
  324. package/dist/services/run-control/files/run-files-service-factory.js +7 -0
  325. package/dist/services/run-control/files/run-files-service.d.ts +29 -0
  326. package/dist/services/run-control/files/run-files-service.js +120 -0
  327. package/dist/services/run-control/index.d.ts +32 -0
  328. package/dist/services/run-control/index.js +31 -0
  329. package/dist/services/run-control/inject/run-inject-contexts.d.ts +319 -0
  330. package/dist/services/run-control/inject/run-inject-contexts.js +38 -0
  331. package/dist/services/run-control/inject/run-inject-service-factory.d.ts +5 -0
  332. package/dist/services/run-control/inject/run-inject-service-factory.js +7 -0
  333. package/dist/services/run-control/inject/run-inject-service.d.ts +31 -0
  334. package/dist/services/run-control/inject/run-inject-service.js +227 -0
  335. package/dist/services/run-control/live-run.d.ts +37 -0
  336. package/dist/services/run-control/live-run.js +56 -0
  337. package/dist/services/run-control/probe/run-probe-contexts.d.ts +333 -0
  338. package/dist/services/run-control/probe/run-probe-contexts.js +73 -0
  339. package/dist/services/run-control/probe/run-probe-service-factory.d.ts +5 -0
  340. package/dist/services/run-control/probe/run-probe-service-factory.js +7 -0
  341. package/dist/services/run-control/probe/run-probe-service.d.ts +54 -0
  342. package/dist/services/run-control/probe/run-probe-service.js +194 -0
  343. package/dist/services/run-control/rum/run-rum-contexts.d.ts +216 -0
  344. package/dist/services/run-control/rum/run-rum-contexts.js +34 -0
  345. package/dist/services/run-control/rum/run-rum-service-factory.d.ts +5 -0
  346. package/dist/services/run-control/rum/run-rum-service-factory.js +7 -0
  347. package/dist/services/run-control/rum/run-rum-service.d.ts +36 -0
  348. package/dist/services/run-control/rum/run-rum-service.js +122 -0
  349. package/dist/services/run-control/run-answer.d.ts +28 -0
  350. package/dist/services/run-control/run-answer.js +58 -0
  351. package/dist/services/run-control/run-control-context.d.ts +102 -0
  352. package/dist/services/run-control/run-control-context.js +36 -0
  353. package/dist/services/run-control/run-control-flags.d.ts +12 -0
  354. package/dist/services/run-control/run-control-flags.js +22 -0
  355. package/dist/services/run-control/run-control-model.d.ts +9 -0
  356. package/dist/services/run-control/run-control-model.js +1 -0
  357. package/dist/services/run-control/run-control-service-factory.d.ts +14 -0
  358. package/dist/services/run-control/run-control-service-factory.js +26 -0
  359. package/dist/services/run-control/session/run-session-contexts.d.ts +25 -0
  360. package/dist/services/run-control/session/run-session-contexts.js +20 -0
  361. package/dist/services/run-control/session/run-session-service-factory.d.ts +8 -0
  362. package/dist/services/run-control/session/run-session-service-factory.js +18 -0
  363. package/dist/services/run-control/session/run-session-service.d.ts +32 -0
  364. package/dist/services/run-control/session/run-session-service.js +151 -0
  365. package/dist/services/run-control/spec/browser/run-browser-service.spec.d.ts +1 -0
  366. package/dist/services/run-control/spec/browser/run-browser-service.spec.js +328 -0
  367. package/dist/services/run-control/spec/cache/run-cache-service.spec.d.ts +1 -0
  368. package/dist/services/run-control/spec/cache/run-cache-service.spec.js +454 -0
  369. package/dist/services/run-control/spec/debug/run-debug-service.spec.d.ts +1 -0
  370. package/dist/services/run-control/spec/debug/run-debug-service.spec.js +113 -0
  371. package/dist/services/run-control/spec/files/run-files-service.spec.d.ts +1 -0
  372. package/dist/services/run-control/spec/files/run-files-service.spec.js +234 -0
  373. package/dist/services/run-control/spec/inject/run-inject-service.spec.d.ts +1 -0
  374. package/dist/services/run-control/spec/inject/run-inject-service.spec.js +251 -0
  375. package/dist/services/run-control/spec/live-run-fixture.d.ts +32 -0
  376. package/dist/services/run-control/spec/live-run-fixture.js +109 -0
  377. package/dist/services/run-control/spec/probe/run-probe-service.spec.d.ts +1 -0
  378. package/dist/services/run-control/spec/probe/run-probe-service.spec.js +108 -0
  379. package/dist/services/run-control/spec/rum/run-rum-service.spec.d.ts +1 -0
  380. package/dist/services/run-control/spec/rum/run-rum-service.spec.js +47 -0
  381. package/dist/services/run-control/spec/run-answer.spec.d.ts +1 -0
  382. package/dist/services/run-control/spec/run-answer.spec.js +57 -0
  383. package/dist/services/run-control/spec/session/run-session-service.spec.d.ts +1 -0
  384. package/dist/services/run-control/spec/session/run-session-service.spec.js +150 -0
  385. package/dist/services/run-log/crash-mirror.d.ts +31 -0
  386. package/dist/services/run-log/crash-mirror.js +69 -0
  387. package/dist/services/run-log/index.d.ts +11 -0
  388. package/dist/services/run-log/index.js +11 -0
  389. package/dist/services/run-log/jsonl-appender.d.ts +46 -0
  390. package/dist/services/run-log/jsonl-appender.js +91 -0
  391. package/dist/services/run-log/log-event-model.d.ts +104 -0
  392. package/dist/services/run-log/log-event-model.js +56 -0
  393. package/dist/services/run-log/log-query-service-factory.d.ts +11 -0
  394. package/dist/services/run-log/log-query-service-factory.js +14 -0
  395. package/dist/services/run-log/log-query-service.d.ts +59 -0
  396. package/dist/services/run-log/log-query-service.js +111 -0
  397. package/dist/services/run-log/log-reader.d.ts +84 -0
  398. package/dist/services/run-log/log-reader.js +180 -0
  399. package/dist/services/run-log/log-summary.d.ts +72 -0
  400. package/dist/services/run-log/log-summary.js +208 -0
  401. package/dist/services/run-log/redaction.d.ts +34 -0
  402. package/dist/services/run-log/redaction.js +124 -0
  403. package/dist/services/run-log/request-log.d.ts +82 -0
  404. package/dist/services/run-log/request-log.js +69 -0
  405. package/dist/services/run-log/request-summary.d.ts +76 -0
  406. package/dist/services/run-log/request-summary.js +0 -0
  407. package/dist/services/run-log/run-log.d.ts +61 -0
  408. package/dist/services/run-log/run-log.js +102 -0
  409. package/dist/services/run-log/spec/log-query-service.spec.d.ts +1 -0
  410. package/dist/services/run-log/spec/log-query-service.spec.js +197 -0
  411. package/dist/services/run-log/spec/log-reader.spec.d.ts +1 -0
  412. package/dist/services/run-log/spec/log-reader.spec.js +109 -0
  413. package/dist/services/run-log/spec/log-summary.spec.d.ts +1 -0
  414. package/dist/services/run-log/spec/log-summary.spec.js +153 -0
  415. package/dist/services/run-log/spec/redaction.spec.d.ts +1 -0
  416. package/dist/services/run-log/spec/redaction.spec.js +61 -0
  417. package/dist/services/run-log/spec/request-log.spec.d.ts +1 -0
  418. package/dist/services/run-log/spec/request-log.spec.js +101 -0
  419. package/dist/services/run-log/spec/request-summary.spec.d.ts +1 -0
  420. package/dist/services/run-log/spec/request-summary.spec.js +171 -0
  421. package/dist/services/run-log/spec/run-log.spec.d.ts +1 -0
  422. package/dist/services/run-log/spec/run-log.spec.js +122 -0
  423. package/dist/services/run-registry/exit-classification.d.ts +39 -0
  424. package/dist/services/run-registry/exit-classification.js +42 -0
  425. package/dist/services/run-registry/index.d.ts +3 -0
  426. package/dist/services/run-registry/index.js +3 -0
  427. package/dist/services/run-registry/process-identity.d.ts +28 -0
  428. package/dist/services/run-registry/process-identity.js +80 -0
  429. package/dist/services/run-registry/run-registry-model.d.ts +128 -0
  430. package/dist/services/run-registry/run-registry-model.js +16 -0
  431. package/dist/services/run-registry/run-registry.d.ts +155 -0
  432. package/dist/services/run-registry/run-registry.js +430 -0
  433. package/dist/services/run-registry/spec/exit-classification.spec.d.ts +1 -0
  434. package/dist/services/run-registry/spec/exit-classification.spec.js +82 -0
  435. package/dist/services/run-registry/spec/run-registry.spec.d.ts +1 -0
  436. package/dist/services/run-registry/spec/run-registry.spec.js +526 -0
  437. package/dist/services/setup/os/tool-registry.js +2 -2
  438. package/oclif.manifest.json +3493 -372
  439. package/package.json +20 -2
@@ -5,6 +5,17 @@ import { Cache } from "../request-cache/cache.js";
5
5
  import { ConfigFileInterface, CustomerConfig, FileListInterface } from "../../integration-api/index.js";
6
6
  import { BrowserContext } from "../onboarding-model.js";
7
7
  import { VirtualOrestesApp } from "../virtual-orestes-app/index.js";
8
+ /**
9
+ * A rebuild asked for before the run wired its watchers.
10
+ *
11
+ * Typed rather than a bare `Error` so the control server can answer it as
12
+ * `NO_REBUILD` — "ask again once the page is up" is a different instruction to
13
+ * the caller than "the rebuild failed", and the two are indistinguishable once
14
+ * they are both a message string.
15
+ */
16
+ export declare class NoRebuildContextError extends Error {
17
+ constructor();
18
+ }
8
19
  /**
9
20
  * Add different callbacks that will be executed if a local file is changed.
10
21
  */
@@ -16,6 +27,8 @@ export declare class FileWatcher {
16
27
  private browserContext;
17
28
  private cache;
18
29
  private cacheRefresher?;
30
+ /** What the watchers were wired with, so a rebuild can reuse it. */
31
+ private rebuildContext?;
19
32
  constructor(cli: CliServiceInterface, customerConfig: CustomerConfig, files: FileListInterface, documentHandler: DocumentHandlerServer, browserContext: BrowserContext, cache: Cache);
20
33
  setCacheRefresher(cacheRefresher: VirtualOrestesApp): void;
21
34
  /**
@@ -33,7 +46,7 @@ export declare class FileWatcher {
33
46
  * @param page
34
47
  * @param serviceWorkerReinstallCallback
35
48
  */
36
- addCallbackOnFileChange(page: Page, serviceWorkerReinstallCallback: (file: ConfigFileInterface) => Promise<void>, signal: AbortSignal): void;
49
+ addCallbackOnFileChange(page: Page, serviceWorkerReinstallCallback: (file?: ConfigFileInterface) => Promise<void>, signal: AbortSignal): void;
37
50
  /**
38
51
  * changes on these files will trigger
39
52
  * - a rebuild of the serviceWorker
@@ -81,6 +94,34 @@ export declare class FileWatcher {
81
94
  * @private
82
95
  */
83
96
  private onChangeServiceWorkerCallback;
97
+ /**
98
+ * The service-worker group's effects, without a file having changed.
99
+ *
100
+ * Split out of the callback above rather than reimplemented beside it: the
101
+ * blast radius of this group is the thing a caller is asking for when it
102
+ * asks for a rebuild, and a second copy of it would drift from the one the
103
+ * watcher actually runs — at which point `sk onboarding files rebuild` would be
104
+ * reproducing something the run never does.
105
+ */
106
+ private rebuildServiceWorkerGroup;
107
+ /** The generic-config group's effects, without a file having changed. */
108
+ private rebuildDocumentHandlerGroup;
109
+ /**
110
+ * Run a rebuild group on demand, as if one of its files had changed.
111
+ *
112
+ * The groups are the run's own, so what this does to the browser and the
113
+ * caches is exactly what an edit to one of those files does — which is the
114
+ * point. It reports what it did rather than returning void, because the
115
+ * effects reach past the files: a documentHandler rebuild empties the
116
+ * dh-cache, and a caller comparing two measurements across one of these has
117
+ * to know that the second is against a cold cache.
118
+ *
119
+ * @returns what each group did, in the order it ran.
120
+ */
121
+ rebuild(target: "install" | "documentHandler" | "all"): Promise<{
122
+ target: "install" | "documentHandler";
123
+ did: string[];
124
+ }[]>;
84
125
  /**
85
126
  * fileWatcherCallback that will rebuild the local documentHandler
86
127
  *
@@ -2,6 +2,19 @@ import { safe } from "../../../helpers/safe.js";
2
2
  import { FILE_TYPE, usesConfigPlugins, } from "../../integration-api/index.js";
3
3
  import { INTEGRATION_FILES } from "../../../models/files.js";
4
4
  import { race } from "../../../helpers/race.js";
5
+ /**
6
+ * A rebuild asked for before the run wired its watchers.
7
+ *
8
+ * Typed rather than a bare `Error` so the control server can answer it as
9
+ * `NO_REBUILD` — "ask again once the page is up" is a different instruction to
10
+ * the caller than "the rebuild failed", and the two are indistinguishable once
11
+ * they are both a message string.
12
+ */
13
+ export class NoRebuildContextError extends Error {
14
+ constructor() {
15
+ super("this run has not wired its file watchers yet, so there are no rebuild groups to trigger — they are wired once the page is ready");
16
+ }
17
+ }
5
18
  /**
6
19
  * Add different callbacks that will be executed if a local file is changed.
7
20
  */
@@ -15,6 +28,8 @@ export class FileWatcher {
15
28
  // Set by OnboardingServiceFactory. When present, config changes re-warm the
16
29
  // dh-cache in the background instead of just clearing it.
17
30
  cacheRefresher;
31
+ /** What the watchers were wired with, so a rebuild can reuse it. */
32
+ rebuildContext;
18
33
  constructor(cli, customerConfig, files, documentHandler, browserContext, cache) {
19
34
  this.cli = cli;
20
35
  this.customerConfig = customerConfig;
@@ -54,6 +69,15 @@ export class FileWatcher {
54
69
  */
55
70
  addCallbackOnFileChange(page, serviceWorkerReinstallCallback, signal) {
56
71
  const installResource = this.files.getByName(INTEGRATION_FILES.BUILD.INSTALL);
72
+ // Kept so the same groups can be triggered without a file having changed —
73
+ // which is what `rebuild()` is. Held rather than re-derived because the
74
+ // page and the reinstall callback belong to the run, and rediscovering them
75
+ // later would mean guessing at things the run already decided.
76
+ this.rebuildContext = {
77
+ page,
78
+ installResource,
79
+ serviceWorkerReinstallCallback,
80
+ };
57
81
  this.handleServiceWorkerDependencies(page, installResource, serviceWorkerReinstallCallback, signal);
58
82
  this.handleGenericConfigFiles(page, installResource, signal);
59
83
  this.handleDynamicStyles(page, signal);
@@ -89,7 +113,10 @@ export class FileWatcher {
89
113
  file.onChange(async (file) => {
90
114
  const result = await safe(this.onChangeServiceWorkerCallback(file, page, installResource, serviceWorkerReinstallCallback));
91
115
  if (result.success === false) {
92
- this.cli.writeError(`error after fileChange: ${file.name}: ${result.error}`);
116
+ this.cli.writeError(`error after fileChange: ${file.name}: ${result.error}`, false, {
117
+ scope: "config",
118
+ data: { file: file.name, error: result.error },
119
+ });
93
120
  }
94
121
  }, { signal });
95
122
  }
@@ -123,7 +150,10 @@ export class FileWatcher {
123
150
  file.onChange(async (file) => {
124
151
  const result = await safe(this.onChangeConfigFileCallback(page, installResource, file));
125
152
  if (result.success === false) {
126
- this.cli.writeError(`error after fileChange: ${file.name}: ${result.error}`);
153
+ this.cli.writeError(`error after fileChange: ${file.name}: ${result.error}`, false, {
154
+ scope: "config",
155
+ data: { file: file.name, error: result.error },
156
+ });
127
157
  }
128
158
  }, { signal });
129
159
  }
@@ -148,7 +178,10 @@ export class FileWatcher {
148
178
  .onChange(async (file) => {
149
179
  const result = await safe(this.onChangeDynamicStyleCallback(file, page));
150
180
  if (result.success === false) {
151
- this.cli.writeError(`error after fileChange: ${file.name}: ${result.error}`);
181
+ this.cli.writeError(`error after fileChange: ${file.name}: ${result.error}`, false, {
182
+ scope: "config",
183
+ data: { file: file.name, error: result.error },
184
+ });
152
185
  }
153
186
  }, { signal });
154
187
  }
@@ -164,7 +197,19 @@ export class FileWatcher {
164
197
  * @private
165
198
  */
166
199
  async onChangeServiceWorkerCallback(file, page, installResource, serviceWorkerReinstallCallback) {
167
- this.cli.writeWarning(`changed file: ${file.name} (reinstall serviceWorker)`);
200
+ this.cli.writeWarning(`changed file: ${file.name} (reinstall serviceWorker)`, false, { scope: "config", data: { file: file.name, reinstallsSw: true } });
201
+ await this.rebuildServiceWorkerGroup(page, installResource, serviceWorkerReinstallCallback, file);
202
+ }
203
+ /**
204
+ * The service-worker group's effects, without a file having changed.
205
+ *
206
+ * Split out of the callback above rather than reimplemented beside it: the
207
+ * blast radius of this group is the thing a caller is asking for when it
208
+ * asks for a rebuild, and a second copy of it would drift from the one the
209
+ * watcher actually runs — at which point `sk onboarding files rebuild` would be
210
+ * reproducing something the run never does.
211
+ */
212
+ async rebuildServiceWorkerGroup(page, installResource, serviceWorkerReinstallCallback, file) {
168
213
  // clear speed-kit-service-worker-caches and uninstall serviceWorker
169
214
  await this.safeClearPageBrowsersCacheStorage(page);
170
215
  await this.unregisterServiceWorker(page);
@@ -178,6 +223,63 @@ export class FileWatcher {
178
223
  // tell puppeteer to reinstall serviceworker on next navigate
179
224
  await serviceWorkerReinstallCallback(file);
180
225
  }
226
+ /** The generic-config group's effects, without a file having changed. */
227
+ async rebuildDocumentHandlerGroup(page, installResource) {
228
+ await this.safeClearPageBrowsersCacheStorage(page);
229
+ await this.documentHandler.buildDocumentHandler();
230
+ this.clearOrRefreshCache(page);
231
+ await installResource.buildContent();
232
+ }
233
+ /**
234
+ * Run a rebuild group on demand, as if one of its files had changed.
235
+ *
236
+ * The groups are the run's own, so what this does to the browser and the
237
+ * caches is exactly what an edit to one of those files does — which is the
238
+ * point. It reports what it did rather than returning void, because the
239
+ * effects reach past the files: a documentHandler rebuild empties the
240
+ * dh-cache, and a caller comparing two measurements across one of these has
241
+ * to know that the second is against a cold cache.
242
+ *
243
+ * @returns what each group did, in the order it ran.
244
+ */
245
+ async rebuild(target) {
246
+ if (!this.rebuildContext) {
247
+ throw new NoRebuildContextError();
248
+ }
249
+ const { page, installResource, serviceWorkerReinstallCallback } = this.rebuildContext;
250
+ const steps = [];
251
+ // documentHandler first when both are asked for. It ends by rebuilding the
252
+ // install resource, and so does the service-worker group — running install
253
+ // last means the reinstall is armed after the final build rather than
254
+ // before it.
255
+ if (target === "documentHandler" || target === "all") {
256
+ await this.rebuildDocumentHandlerGroup(page, installResource);
257
+ steps.push({
258
+ target: "documentHandler",
259
+ did: [
260
+ "rebuilt the local documentHandler",
261
+ this.cacheRefresher
262
+ ? "cleared the dh-cache and re-warmed the open page's entries in the background"
263
+ : "cleared the dh-cache",
264
+ "cleared Speed Kit's caches in the browser",
265
+ "rebuilt the install resource",
266
+ ],
267
+ });
268
+ }
269
+ if (target === "install" || target === "all") {
270
+ await this.rebuildServiceWorkerGroup(page, installResource, serviceWorkerReinstallCallback);
271
+ steps.push({
272
+ target: "install",
273
+ did: [
274
+ "cleared Speed Kit's caches in the browser",
275
+ "unregistered the service worker",
276
+ "rebuilt the install resource",
277
+ "armed a service-worker reinstall for the next navigation",
278
+ ],
279
+ });
280
+ }
281
+ return steps;
282
+ }
181
283
  /**
182
284
  * fileWatcherCallback that will rebuild the local documentHandler
183
285
  *
@@ -187,11 +289,11 @@ export class FileWatcher {
187
289
  * @private
188
290
  */
189
291
  async onChangeConfigFileCallback(page, installResource, file) {
190
- this.cli.writeWarning(`changed file: ${file.name}`);
191
- await this.safeClearPageBrowsersCacheStorage(page);
192
- await this.documentHandler.buildDocumentHandler();
193
- this.clearOrRefreshCache(page);
194
- await installResource.buildContent();
292
+ this.cli.writeWarning(`changed file: ${file.name}`, false, {
293
+ scope: "config",
294
+ data: { file: file.name },
295
+ });
296
+ await this.rebuildDocumentHandlerGroup(page, installResource);
195
297
  }
196
298
  /**
197
299
  * fileWatcherCallback that will reinstall the serviceWorker
@@ -201,7 +303,10 @@ export class FileWatcher {
201
303
  * @private
202
304
  */
203
305
  async onChangeDynamicStyleCallback(file, page) {
204
- this.cli.writeWarning(`changed file: ${file.name}`);
306
+ this.cli.writeWarning(`changed file: ${file.name}`, false, {
307
+ scope: "config",
308
+ data: { file: file.name },
309
+ });
205
310
  await this.documentHandler.buildDocumentHandler();
206
311
  this.clearOrRefreshCache(page);
207
312
  const escapedStyles = encodeURI(file.getContent());
@@ -212,7 +317,7 @@ export class FileWatcher {
212
317
  if (evaluateResult.success === false &&
213
318
  !evaluateResult.error.includes("timeout")) {
214
319
  // The stack already starts with the message, so this is not a duplicate.
215
- this.cli.writeError(evaluateResult.errorObj?.stack ?? evaluateResult.error);
320
+ this.cli.writeError(evaluateResult.errorObj?.stack ?? evaluateResult.error, false, { scope: "config", data: { file: file.name } });
216
321
  }
217
322
  }
218
323
  /**
@@ -224,7 +329,7 @@ export class FileWatcher {
224
329
  async safeClearPageBrowsersCacheStorage(page) {
225
330
  const result = await safe(this.clearPageBrowsersCacheStorage(page));
226
331
  if (result.success === false) {
227
- this.cli.writeError(result.error);
332
+ this.cli.writeError(result.error, false, { scope: "cache" });
228
333
  }
229
334
  }
230
335
  /**
@@ -31,7 +31,7 @@ export class InjectService {
31
31
  externalSignal,
32
32
  disconnected.signal,
33
33
  ]);
34
- const browser = await launchBrowser(this.browserContext);
34
+ const browser = await launchBrowser(this.browserContext, this.cli);
35
35
  for (const target of browser.targets()) {
36
36
  if (target.type() === "browser") {
37
37
  await this.fetchEventHandler.handleRequestFetchEvents(target);
@@ -1,18 +1,16 @@
1
- import { CDPSession, Viewport } from "puppeteer";
1
+ import { CDPSession } from "puppeteer";
2
2
  import { Protocol } from "puppeteer-core";
3
3
  import { AbortResponse } from "./browser/abort-response.js";
4
4
  import { task } from "./todo-collector.js";
5
5
  import { VanillaPuppeteer } from "puppeteer-extra";
6
6
  import { ChromeFeatureFinding, ChromeFlagDuplicate } from "../../helpers/chrome-flags.js";
7
7
  import { CliEnvironment } from "../cli/index.js";
8
- import { DeviceEmulation, FetchDevice } from "../browser-fetch/device-emulation.js";
8
+ import { FetchDevice, OnboardingDeviceEmulation } from "../browser-fetch/device-emulation.js";
9
9
  export declare const HEADLESS_PARITY_ARGS: string[];
10
10
  declare const HEADLESS_DEFAULT_ARGS_TO_DROP: string[];
11
11
  export { HEADLESS_DEFAULT_ARGS_TO_DROP };
12
- /** A device as `--device` emulates it: always with a viewport, also for the desktop. */
13
- export type BrowserDeviceEmulation = DeviceEmulation & {
14
- viewport: Viewport;
15
- };
12
+ /** What Chrome reports for a touchscreen phone or tablet. */
13
+ export declare const MAX_TOUCH_POINTS = 5;
16
14
  export declare const BROWSER_EVENTS: {
17
15
  DISCONNECTED: string;
18
16
  FETCH_AUTH_REQUIRED: string;
@@ -55,7 +53,12 @@ export declare class BrowserContext {
55
53
  readonly browserArgs: string[];
56
54
  readonly chromePath: string;
57
55
  /** The device of `--device`, or undefined to leave Chrome as it launches. */
58
- readonly emulation?: BrowserDeviceEmulation;
56
+ readonly emulation?: OnboardingDeviceEmulation;
57
+ /**
58
+ * Switches the touch of `--device` on every page, set by `emulateDevice`. Only the CDP session
59
+ * that turned Chrome's mouse-to-touch translation on can keep it off across a navigation.
60
+ */
61
+ setDeviceTouch?: (touch: boolean) => Promise<void>;
59
62
  constructor(domain: string, browserVersionString?: string, chromeFlags?: string[], environment?: CliEnvironment, userAgent?: string, debuggingPort?: boolean, headless?: boolean, debugPort?: number, device?: FetchDevice);
60
63
  /**
61
64
  * The user agent is a launch flag rather than only a CDP override on purpose: a per-page
@@ -186,9 +189,39 @@ export interface LocalCacheError {
186
189
  stack: string | null;
187
190
  occurredAt: number;
188
191
  }
192
+ /**
193
+ * What a run command is doing to this browser right now.
194
+ *
195
+ * Read by the devtools extension, which turns the tab strip red while it is
196
+ * active — see `lib/agent-tab-state.ts` there. Additive to the union on
197
+ * purpose: an extension too old to know the id ignores it, so the protocol
198
+ * version does not move.
199
+ */
200
+ export interface AgentActivity {
201
+ active: boolean;
202
+ /** The sharpest thing installed — `sk debug` over `sk inject (3)`. */
203
+ label: string | null;
204
+ /** ISO, when it became active. */
205
+ since?: string;
206
+ /**
207
+ * The breakpoints `sk onboarding debug` has armed, in its 1–4 numbering.
208
+ *
209
+ * The CLI sets the page's sessionStorage flags directly and the extension's
210
+ * injector reads them, so the pause already lands in the right place without
211
+ * this. The panel is the part that needs telling: its switches are backed by
212
+ * extension storage rather than read back from the page, deliberately —
213
+ * an `inspectedWindow.eval` during a navigation races the document swap and
214
+ * queues behind a paused JS thread, which is exactly what an armed
215
+ * breakpoint produces.
216
+ */
217
+ breakpoints?: number[];
218
+ }
189
219
  export type DevelopmentToolsMessage = {
190
220
  id: "skCli";
191
221
  data: SkCliInfo;
222
+ } | {
223
+ id: "agent";
224
+ data: AgentActivity;
192
225
  } | {
193
226
  id: "athena";
194
227
  data: AthenaInfo;
@@ -3,7 +3,7 @@ import { buildHeadedUserAgent } from "./browser/executable/headed-user-agent.js"
3
3
  import { resolve } from "node:path";
4
4
  import { defaultArgs } from "puppeteer";
5
5
  import { findChromeFeatureFindings, findDuplicateChromeFlags, isFeatureListFlag, mergeChromeFeatureFlags, } from "../../helpers/chrome-flags.js";
6
- import { DEVICE_VIEWPORTS, deviceEmulation, } from "../browser-fetch/device-emulation.js";
6
+ import { onboardingDeviceEmulation, } from "../browser-fetch/device-emulation.js";
7
7
  const DEFAULT_BROWSER_ARGS = [
8
8
  // No `Translate`: Chrome's translate code has no feature of that name, and Puppeteer disables it anyway.
9
9
  "--enable-features=NetworkService",
@@ -37,12 +37,10 @@ const HEADLESS_DEFAULT_ARGS_TO_DROP = [
37
37
  "--hide-scrollbars",
38
38
  ];
39
39
  export { HEADLESS_DEFAULT_ARGS_TO_DROP };
40
- /** `--device desktop` presents Chrome on Windows, the most common Chrome desktop in RUM (60%). */
41
- const DESKTOP_PLATFORM = "win32";
42
40
  /** Room next to an emulated viewport for the DevTools panel that `devtools: true` docks in headed mode. */
43
41
  const DEVTOOLS_GUTTER = 520;
44
42
  /** What Chrome reports for a touchscreen phone or tablet. */
45
- const MAX_TOUCH_POINTS = 5;
43
+ export const MAX_TOUCH_POINTS = 5;
46
44
  export const BROWSER_EVENTS = {
47
45
  DISCONNECTED: "disconnected",
48
46
  FETCH_AUTH_REQUIRED: "Fetch.authRequired",
@@ -86,6 +84,11 @@ export class BrowserContext {
86
84
  chromePath;
87
85
  /** The device of `--device`, or undefined to leave Chrome as it launches. */
88
86
  emulation;
87
+ /**
88
+ * Switches the touch of `--device` on every page, set by `emulateDevice`. Only the CDP session
89
+ * that turned Chrome's mouse-to-touch translation on can keep it off across a navigation.
90
+ */
91
+ setDeviceTouch;
89
92
  constructor(domain, browserVersionString = "unknown", chromeFlags, environment, userAgent, debuggingPort = false, headless = false, debugPort = 9222, device) {
90
93
  this.domain = domain;
91
94
  this.browserVersionString = browserVersionString;
@@ -110,10 +113,7 @@ export class BrowserContext {
110
113
  browserArguments.push(`--user-data-dir=${temporaryProfileDirectory}`);
111
114
  }
112
115
  if (device) {
113
- this.emulation = {
114
- ...deviceEmulation(browserVersionString, device, DESKTOP_PLATFORM),
115
- viewport: DEVICE_VIEWPORTS[device],
116
- };
116
+ this.emulation = onboardingDeviceEmulation(browserVersionString, device);
117
117
  }
118
118
  this.userAgent ??=
119
119
  this.emulation?.userAgent ??
@@ -230,7 +230,8 @@ export class BrowserContext {
230
230
  /** Args that depend on how Chrome is launched, added after the customer's chromeFlags. */
231
231
  getLaunchOnlyArgs() {
232
232
  const args = [];
233
- if (this.debuggingPort || this.headless) {
233
+ // Headless needs no port: run control goes through the CLI's own connection.
234
+ if (this.debuggingPort) {
234
235
  args.push(`--remote-debugging-port=${this.debugPort}`);
235
236
  // Puppeteer adds the pipe switch for `pipe: true` only when no other
236
237
  // `--remote-debugging-*` switch is present, and it refuses
@@ -253,6 +254,16 @@ export class BrowserContext {
253
254
  ...this.getLaunchOnlyArgs(),
254
255
  ...this.getSystemChromeFlags(),
255
256
  ]),
257
+ // Puppeteer installs its own signal handlers by default, and its SIGINT
258
+ // one is `this.kill(); process.exit(130)` — a bare exit, out from under
259
+ // whatever the CLI was doing. That would skip the run's status stamp, the
260
+ // control-socket unlink and the cache teardown, all of which live in the
261
+ // `finally` of `commands/onboarding.ts`. The command registers its own
262
+ // handlers before the browser launches and owns shutdown; the browser
263
+ // closes as part of it.
264
+ handleSIGINT: false,
265
+ handleSIGTERM: false,
266
+ handleSIGHUP: false,
256
267
  // Strip Puppeteer's default `--enable-automation` so Chrome doesn't show
257
268
  // the "Chrome is being controlled by automated test software" infobar.
258
269
  ignoreDefaultArgs: [
@@ -17,6 +17,7 @@ declare const flags: {
17
17
  debuggingPort: Interfaces.BooleanFlag<boolean>;
18
18
  debugPort: Interfaces.OptionFlag<number, Interfaces.CustomOptions>;
19
19
  verboseLevel: Interfaces.BooleanFlag<boolean>;
20
+ logFile: Interfaces.BooleanFlag<boolean>;
20
21
  ignoreContentSecurityPolicy: Interfaces.BooleanFlag<boolean>;
21
22
  headless: Interfaces.BooleanFlag<boolean>;
22
23
  device: Interfaces.OptionFlag<string, Interfaces.CustomOptions>;
@@ -50,6 +51,8 @@ export interface OnboardingServiceBuildContextValues extends CommandContextValue
50
51
  readonly testing?: string;
51
52
  /** The app of `--inject`, when no customer config names it. */
52
53
  readonly app?: string;
54
+ /** Whether the run writes a structured copy of its output to `log.jsonl`. */
55
+ readonly logFile: boolean;
53
56
  }
54
57
  declare const OnboardingServiceBuildContext_base: new (values: OnboardingServiceBuildContextValues) => Readonly<OnboardingServiceBuildContextValues>;
55
58
  /** What `sk onboarding` starts: a local Speed Kit dev environment for one customer. */
@@ -65,6 +68,7 @@ export declare class OnboardingServiceBuildContext extends OnboardingServiceBuil
65
68
  debuggingPort: Interfaces.BooleanFlag<boolean>;
66
69
  debugPort: Interfaces.OptionFlag<number, Interfaces.CustomOptions>;
67
70
  verboseLevel: Interfaces.BooleanFlag<boolean>;
71
+ logFile: Interfaces.BooleanFlag<boolean>;
68
72
  ignoreContentSecurityPolicy: Interfaces.BooleanFlag<boolean>;
69
73
  headless: Interfaces.BooleanFlag<boolean>;
70
74
  device: Interfaces.OptionFlag<string, Interfaces.CustomOptions>;
@@ -49,13 +49,18 @@ const flags = {
49
49
  }),
50
50
  debugPort: Flags.integer({
51
51
  default: 9222,
52
- description: "Chrome remote debugging port (only used with -p/--headless). Use distinct ports to run multiple onboarding processes at once.",
52
+ description: "Chrome remote debugging port (only used with -p). Use distinct ports to run multiple onboarding processes with -p at once.",
53
53
  }),
54
54
  verboseLevel: Flags.boolean({
55
55
  char: "v",
56
56
  default: false,
57
57
  description: "Show all messages",
58
58
  }),
59
+ logFile: Flags.boolean({
60
+ allowNo: true,
61
+ default: true,
62
+ description: "Write a structured copy of this run's output to log.jsonl in the run directory, readable afterwards with `sk onboarding logs`. Use --no-log-file to keep the run off disk entirely.",
63
+ }),
59
64
  ignoreContentSecurityPolicy: Flags.boolean({
60
65
  char: "s",
61
66
  default: false,
@@ -118,6 +123,7 @@ export class OnboardingServiceBuildContext extends Context() {
118
123
  testing: parsedFlags.inject === LATEST_INSTALLATION
119
124
  ? undefined
120
125
  : parsedFlags.inject,
126
+ logFile: parsedFlags.logFile,
121
127
  });
122
128
  }
123
129
  }
@@ -1,13 +1,29 @@
1
1
  import { OnboardingServiceBuildContext } from "./onboarding-service-build-context.js";
2
+ import { RunHandle } from "../run-registry/index.js";
2
3
  import { BrowserContext } from "./onboarding-model.js";
3
4
  import { OnboardingService } from "./onboarding-service.js";
4
5
  import { BrowseService } from "./browse/browse-service.js";
5
6
  import { InjectService } from "./inject/inject-service.js";
6
7
  import { DeployedInstallation } from "./inject/deployed-installation.js";
7
8
  import { BrowserExtensions } from "./browser/extension/extension-validator.js";
9
+ import { RequestLogInterface } from "../run-log/index.js";
8
10
  export declare class OnboardingServiceFactory {
9
11
  private readonly context;
10
- constructor(context: OnboardingServiceBuildContext);
12
+ /** Recorded by the command; filled in here once the config is known. */
13
+ private readonly run?;
14
+ /**
15
+ * Where intercepted requests go. Owned by the command, because it is the
16
+ * one place that decides whether this run writes anything to disk.
17
+ */
18
+ private readonly requestLog?;
19
+ constructor(context: OnboardingServiceBuildContext,
20
+ /** Recorded by the command; filled in here once the config is known. */
21
+ run?: RunHandle,
22
+ /**
23
+ * Where intercepted requests go. Owned by the command, because it is the
24
+ * one place that decides whether this run writes anything to disk.
25
+ */
26
+ requestLog?: RequestLogInterface);
11
27
  /**
12
28
  * The service `sk onboarding` runs: the browse service under `--browse`, the inject service under
13
29
  * `--inject`, the onboarding service otherwise.