@speedkit/cli 4.51.0 → 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 (441) hide show
  1. package/CHANGELOG.md +14 -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/spec/speed-kit-install-js.spec.d.ts +1 -0
  216. package/dist/services/onboarding/fetch-events/spec/speed-kit-install-js.spec.js +59 -0
  217. package/dist/services/onboarding/fetch-events/speed-kit-install-js.js +16 -5
  218. package/dist/services/onboarding/fetch-events/speed-kit-rum-pi-request.d.ts +14 -0
  219. package/dist/services/onboarding/fetch-events/speed-kit-rum-pi-request.js +30 -0
  220. package/dist/services/onboarding/fetch-events/speed-kit-service-worker-js.d.ts +13 -0
  221. package/dist/services/onboarding/fetch-events/speed-kit-service-worker-js.js +28 -1
  222. package/dist/services/onboarding/file-events/file-watcher.d.ts +42 -1
  223. package/dist/services/onboarding/file-events/file-watcher.js +117 -12
  224. package/dist/services/onboarding/inject/inject-service.js +1 -1
  225. package/dist/services/onboarding/onboarding-model.d.ts +40 -7
  226. package/dist/services/onboarding/onboarding-model.js +20 -9
  227. package/dist/services/onboarding/onboarding-service-build-context.d.ts +4 -0
  228. package/dist/services/onboarding/onboarding-service-build-context.js +7 -1
  229. package/dist/services/onboarding/onboarding-service-factory.d.ts +17 -1
  230. package/dist/services/onboarding/onboarding-service-factory.js +150 -23
  231. package/dist/services/onboarding/onboarding-service.d.ts +40 -1
  232. package/dist/services/onboarding/onboarding-service.js +139 -23
  233. package/dist/services/onboarding/request-cache/asset-key.d.ts +61 -0
  234. package/dist/services/onboarding/request-cache/asset-key.js +115 -0
  235. package/dist/services/onboarding/request-cache/cache.d.ts +62 -5
  236. package/dist/services/onboarding/request-cache/cache.js +128 -17
  237. package/dist/services/onboarding/spec/browser/answer-dialogs.spec.d.ts +1 -0
  238. package/dist/services/onboarding/spec/browser/answer-dialogs.spec.js +66 -0
  239. package/dist/services/onboarding/spec/browser/console-log.spec.d.ts +1 -0
  240. package/dist/services/onboarding/spec/browser/console-log.spec.js +42 -0
  241. package/dist/services/onboarding/spec/browser/resume-restarted-workers.spec.d.ts +1 -0
  242. package/dist/services/onboarding/spec/browser/resume-restarted-workers.spec.js +45 -0
  243. package/dist/services/onboarding/spec/control/browser-session.spec.d.ts +1 -0
  244. package/dist/services/onboarding/spec/control/browser-session.spec.js +753 -0
  245. package/dist/services/onboarding/spec/control/control-server.spec.d.ts +1 -0
  246. package/dist/services/onboarding/spec/control/control-server.spec.js +371 -0
  247. package/dist/services/onboarding/spec/control/debug-session.spec.d.ts +1 -0
  248. package/dist/services/onboarding/spec/control/debug-session.spec.js +751 -0
  249. package/dist/services/onboarding/spec/control/fakes.d.ts +31 -0
  250. package/dist/services/onboarding/spec/control/fakes.js +67 -0
  251. package/dist/services/onboarding/spec/control/fouc.spec.d.ts +1 -0
  252. package/dist/services/onboarding/spec/control/fouc.spec.js +167 -0
  253. package/dist/services/onboarding/spec/control/navigate-wait.spec.d.ts +1 -0
  254. package/dist/services/onboarding/spec/control/navigate-wait.spec.js +47 -0
  255. package/dist/services/onboarding/spec/control/navwalk.spec.d.ts +1 -0
  256. package/dist/services/onboarding/spec/control/navwalk.spec.js +222 -0
  257. package/dist/services/onboarding/spec/control/preload-registry.spec.d.ts +1 -0
  258. package/dist/services/onboarding/spec/control/preload-registry.spec.js +432 -0
  259. package/dist/services/onboarding/spec/control/response-explainer.spec.d.ts +1 -0
  260. package/dist/services/onboarding/spec/control/response-explainer.spec.js +324 -0
  261. package/dist/services/onboarding/spec/control/rum.spec.d.ts +1 -0
  262. package/dist/services/onboarding/spec/control/rum.spec.js +222 -0
  263. package/dist/services/onboarding/spec/control/service-worker-tracker.spec.d.ts +1 -0
  264. package/dist/services/onboarding/spec/control/service-worker-tracker.spec.js +193 -0
  265. package/dist/services/onboarding/spec/control/viewport.spec.d.ts +1 -0
  266. package/dist/services/onboarding/spec/control/viewport.spec.js +200 -0
  267. package/dist/services/onboarding/spec/control/watch.spec.d.ts +1 -0
  268. package/dist/services/onboarding/spec/control/watch.spec.js +187 -0
  269. package/dist/services/onboarding/spec/fetch-event-handler.spec.d.ts +1 -0
  270. package/dist/services/onboarding/spec/fetch-event-handler.spec.js +219 -0
  271. package/dist/services/onboarding/spec/fetch-events/speed-kit-service-worker-js.spec.d.ts +1 -0
  272. package/dist/services/onboarding/spec/fetch-events/speed-kit-service-worker-js.spec.js +41 -0
  273. package/dist/services/onboarding/spec/onboarding-model.spec.js +39 -3
  274. package/dist/services/onboarding/spec/onboarding-service-factory.spec.js +25 -1
  275. package/dist/services/onboarding/spec/request-cache/cache.spec.d.ts +1 -0
  276. package/dist/services/onboarding/spec/request-cache/cache.spec.js +107 -0
  277. package/dist/services/onboarding/spec/todo-collector.spec.d.ts +1 -0
  278. package/dist/services/onboarding/spec/todo-collector.spec.js +136 -0
  279. package/dist/services/onboarding/spec/virtual-orestes-app/virtual-orestes-app.spec.d.ts +1 -0
  280. package/dist/services/onboarding/spec/virtual-orestes-app/virtual-orestes-app.spec.js +65 -0
  281. package/dist/services/onboarding/todo-collector.d.ts +7 -2
  282. package/dist/services/onboarding/todo-collector.js +49 -12
  283. package/dist/services/onboarding/virtual-orestes-app/index.d.ts +38 -0
  284. package/dist/services/onboarding/virtual-orestes-app/index.js +113 -27
  285. package/dist/services/origin-request/asset-variations.d.ts +14 -0
  286. package/dist/services/origin-request/asset-variations.js +11 -4
  287. package/dist/services/origin-request/origin-fetcher.d.ts +7 -0
  288. package/dist/services/origin-request/origin-fetcher.js +43 -5
  289. package/dist/services/origin-request/origin-request-service-build-context.d.ts +17 -0
  290. package/dist/services/origin-request/origin-request-service-build-context.js +8 -0
  291. package/dist/services/origin-request/origin-request-service-factory.d.ts +0 -5
  292. package/dist/services/origin-request/origin-request-service-factory.js +2 -30
  293. package/dist/services/origin-request/origin-request-service.d.ts +121 -6
  294. package/dist/services/origin-request/origin-request-service.js +273 -49
  295. package/dist/services/origin-request/runtime-config-source.d.ts +6 -0
  296. package/dist/services/origin-request/runtime-config-source.js +15 -4
  297. package/dist/services/origin-request/spec/asset-variations.spec.js +20 -0
  298. package/dist/services/origin-request/spec/origin-request-service.spec.js +329 -6
  299. package/dist/services/query-builder/rules/rule-match.d.ts +35 -0
  300. package/dist/services/query-builder/rules/rule-match.js +70 -0
  301. package/dist/services/query-builder/spec/rules/rule-match.spec.d.ts +1 -0
  302. package/dist/services/query-builder/spec/rules/rule-match.spec.js +121 -0
  303. package/dist/services/run-control/browser/run-browser-contexts.d.ts +557 -0
  304. package/dist/services/run-control/browser/run-browser-contexts.js +91 -0
  305. package/dist/services/run-control/browser/run-browser-service-factory.d.ts +5 -0
  306. package/dist/services/run-control/browser/run-browser-service-factory.js +7 -0
  307. package/dist/services/run-control/browser/run-browser-service.d.ts +68 -0
  308. package/dist/services/run-control/browser/run-browser-service.js +206 -0
  309. package/dist/services/run-control/cache/run-cache-contexts.d.ts +349 -0
  310. package/dist/services/run-control/cache/run-cache-contexts.js +51 -0
  311. package/dist/services/run-control/cache/run-cache-service-factory.d.ts +6 -0
  312. package/dist/services/run-control/cache/run-cache-service-factory.js +12 -0
  313. package/dist/services/run-control/cache/run-cache-service.d.ts +35 -0
  314. package/dist/services/run-control/cache/run-cache-service.js +151 -0
  315. package/dist/services/run-control/control-client.d.ts +36 -0
  316. package/dist/services/run-control/control-client.js +147 -0
  317. package/dist/services/run-control/debug/run-debug-contexts.d.ts +416 -0
  318. package/dist/services/run-control/debug/run-debug-contexts.js +47 -0
  319. package/dist/services/run-control/debug/run-debug-service-factory.d.ts +5 -0
  320. package/dist/services/run-control/debug/run-debug-service-factory.js +7 -0
  321. package/dist/services/run-control/debug/run-debug-service.d.ts +39 -0
  322. package/dist/services/run-control/debug/run-debug-service.js +164 -0
  323. package/dist/services/run-control/files/run-files-contexts.d.ts +238 -0
  324. package/dist/services/run-control/files/run-files-contexts.js +26 -0
  325. package/dist/services/run-control/files/run-files-service-factory.d.ts +5 -0
  326. package/dist/services/run-control/files/run-files-service-factory.js +7 -0
  327. package/dist/services/run-control/files/run-files-service.d.ts +29 -0
  328. package/dist/services/run-control/files/run-files-service.js +120 -0
  329. package/dist/services/run-control/index.d.ts +32 -0
  330. package/dist/services/run-control/index.js +31 -0
  331. package/dist/services/run-control/inject/run-inject-contexts.d.ts +319 -0
  332. package/dist/services/run-control/inject/run-inject-contexts.js +38 -0
  333. package/dist/services/run-control/inject/run-inject-service-factory.d.ts +5 -0
  334. package/dist/services/run-control/inject/run-inject-service-factory.js +7 -0
  335. package/dist/services/run-control/inject/run-inject-service.d.ts +31 -0
  336. package/dist/services/run-control/inject/run-inject-service.js +227 -0
  337. package/dist/services/run-control/live-run.d.ts +37 -0
  338. package/dist/services/run-control/live-run.js +56 -0
  339. package/dist/services/run-control/probe/run-probe-contexts.d.ts +333 -0
  340. package/dist/services/run-control/probe/run-probe-contexts.js +73 -0
  341. package/dist/services/run-control/probe/run-probe-service-factory.d.ts +5 -0
  342. package/dist/services/run-control/probe/run-probe-service-factory.js +7 -0
  343. package/dist/services/run-control/probe/run-probe-service.d.ts +54 -0
  344. package/dist/services/run-control/probe/run-probe-service.js +194 -0
  345. package/dist/services/run-control/rum/run-rum-contexts.d.ts +216 -0
  346. package/dist/services/run-control/rum/run-rum-contexts.js +34 -0
  347. package/dist/services/run-control/rum/run-rum-service-factory.d.ts +5 -0
  348. package/dist/services/run-control/rum/run-rum-service-factory.js +7 -0
  349. package/dist/services/run-control/rum/run-rum-service.d.ts +36 -0
  350. package/dist/services/run-control/rum/run-rum-service.js +122 -0
  351. package/dist/services/run-control/run-answer.d.ts +28 -0
  352. package/dist/services/run-control/run-answer.js +58 -0
  353. package/dist/services/run-control/run-control-context.d.ts +102 -0
  354. package/dist/services/run-control/run-control-context.js +36 -0
  355. package/dist/services/run-control/run-control-flags.d.ts +12 -0
  356. package/dist/services/run-control/run-control-flags.js +22 -0
  357. package/dist/services/run-control/run-control-model.d.ts +9 -0
  358. package/dist/services/run-control/run-control-model.js +1 -0
  359. package/dist/services/run-control/run-control-service-factory.d.ts +14 -0
  360. package/dist/services/run-control/run-control-service-factory.js +26 -0
  361. package/dist/services/run-control/session/run-session-contexts.d.ts +25 -0
  362. package/dist/services/run-control/session/run-session-contexts.js +20 -0
  363. package/dist/services/run-control/session/run-session-service-factory.d.ts +8 -0
  364. package/dist/services/run-control/session/run-session-service-factory.js +18 -0
  365. package/dist/services/run-control/session/run-session-service.d.ts +32 -0
  366. package/dist/services/run-control/session/run-session-service.js +151 -0
  367. package/dist/services/run-control/spec/browser/run-browser-service.spec.d.ts +1 -0
  368. package/dist/services/run-control/spec/browser/run-browser-service.spec.js +328 -0
  369. package/dist/services/run-control/spec/cache/run-cache-service.spec.d.ts +1 -0
  370. package/dist/services/run-control/spec/cache/run-cache-service.spec.js +454 -0
  371. package/dist/services/run-control/spec/debug/run-debug-service.spec.d.ts +1 -0
  372. package/dist/services/run-control/spec/debug/run-debug-service.spec.js +113 -0
  373. package/dist/services/run-control/spec/files/run-files-service.spec.d.ts +1 -0
  374. package/dist/services/run-control/spec/files/run-files-service.spec.js +234 -0
  375. package/dist/services/run-control/spec/inject/run-inject-service.spec.d.ts +1 -0
  376. package/dist/services/run-control/spec/inject/run-inject-service.spec.js +251 -0
  377. package/dist/services/run-control/spec/live-run-fixture.d.ts +32 -0
  378. package/dist/services/run-control/spec/live-run-fixture.js +109 -0
  379. package/dist/services/run-control/spec/probe/run-probe-service.spec.d.ts +1 -0
  380. package/dist/services/run-control/spec/probe/run-probe-service.spec.js +108 -0
  381. package/dist/services/run-control/spec/rum/run-rum-service.spec.d.ts +1 -0
  382. package/dist/services/run-control/spec/rum/run-rum-service.spec.js +47 -0
  383. package/dist/services/run-control/spec/run-answer.spec.d.ts +1 -0
  384. package/dist/services/run-control/spec/run-answer.spec.js +57 -0
  385. package/dist/services/run-control/spec/session/run-session-service.spec.d.ts +1 -0
  386. package/dist/services/run-control/spec/session/run-session-service.spec.js +150 -0
  387. package/dist/services/run-log/crash-mirror.d.ts +31 -0
  388. package/dist/services/run-log/crash-mirror.js +69 -0
  389. package/dist/services/run-log/index.d.ts +11 -0
  390. package/dist/services/run-log/index.js +11 -0
  391. package/dist/services/run-log/jsonl-appender.d.ts +46 -0
  392. package/dist/services/run-log/jsonl-appender.js +91 -0
  393. package/dist/services/run-log/log-event-model.d.ts +104 -0
  394. package/dist/services/run-log/log-event-model.js +56 -0
  395. package/dist/services/run-log/log-query-service-factory.d.ts +11 -0
  396. package/dist/services/run-log/log-query-service-factory.js +14 -0
  397. package/dist/services/run-log/log-query-service.d.ts +59 -0
  398. package/dist/services/run-log/log-query-service.js +111 -0
  399. package/dist/services/run-log/log-reader.d.ts +84 -0
  400. package/dist/services/run-log/log-reader.js +180 -0
  401. package/dist/services/run-log/log-summary.d.ts +72 -0
  402. package/dist/services/run-log/log-summary.js +208 -0
  403. package/dist/services/run-log/redaction.d.ts +34 -0
  404. package/dist/services/run-log/redaction.js +124 -0
  405. package/dist/services/run-log/request-log.d.ts +82 -0
  406. package/dist/services/run-log/request-log.js +69 -0
  407. package/dist/services/run-log/request-summary.d.ts +76 -0
  408. package/dist/services/run-log/request-summary.js +0 -0
  409. package/dist/services/run-log/run-log.d.ts +61 -0
  410. package/dist/services/run-log/run-log.js +102 -0
  411. package/dist/services/run-log/spec/log-query-service.spec.d.ts +1 -0
  412. package/dist/services/run-log/spec/log-query-service.spec.js +197 -0
  413. package/dist/services/run-log/spec/log-reader.spec.d.ts +1 -0
  414. package/dist/services/run-log/spec/log-reader.spec.js +109 -0
  415. package/dist/services/run-log/spec/log-summary.spec.d.ts +1 -0
  416. package/dist/services/run-log/spec/log-summary.spec.js +153 -0
  417. package/dist/services/run-log/spec/redaction.spec.d.ts +1 -0
  418. package/dist/services/run-log/spec/redaction.spec.js +61 -0
  419. package/dist/services/run-log/spec/request-log.spec.d.ts +1 -0
  420. package/dist/services/run-log/spec/request-log.spec.js +101 -0
  421. package/dist/services/run-log/spec/request-summary.spec.d.ts +1 -0
  422. package/dist/services/run-log/spec/request-summary.spec.js +171 -0
  423. package/dist/services/run-log/spec/run-log.spec.d.ts +1 -0
  424. package/dist/services/run-log/spec/run-log.spec.js +122 -0
  425. package/dist/services/run-registry/exit-classification.d.ts +39 -0
  426. package/dist/services/run-registry/exit-classification.js +42 -0
  427. package/dist/services/run-registry/index.d.ts +3 -0
  428. package/dist/services/run-registry/index.js +3 -0
  429. package/dist/services/run-registry/process-identity.d.ts +28 -0
  430. package/dist/services/run-registry/process-identity.js +80 -0
  431. package/dist/services/run-registry/run-registry-model.d.ts +128 -0
  432. package/dist/services/run-registry/run-registry-model.js +16 -0
  433. package/dist/services/run-registry/run-registry.d.ts +155 -0
  434. package/dist/services/run-registry/run-registry.js +430 -0
  435. package/dist/services/run-registry/spec/exit-classification.spec.d.ts +1 -0
  436. package/dist/services/run-registry/spec/exit-classification.spec.js +82 -0
  437. package/dist/services/run-registry/spec/run-registry.spec.d.ts +1 -0
  438. package/dist/services/run-registry/spec/run-registry.spec.js +526 -0
  439. package/dist/services/setup/os/tool-registry.js +2 -2
  440. package/oclif.manifest.json +3479 -358
  441. package/package.json +20 -2
@@ -0,0 +1,58 @@
1
+ /**
2
+ * How an op on a live run answers: a summary and its detail for a person, or
3
+ * the data as one JSON document for whatever reads stdout.
4
+ *
5
+ * The two never mix. Under `--json` nothing but the document reaches stdout,
6
+ * so `sk onboarding cache list --json | jq` needs no `--quiet`.
7
+ */
8
+ export class RunAnswer {
9
+ cli;
10
+ json;
11
+ constructor(cli, json) {
12
+ this.cli = cli;
13
+ this.json = json;
14
+ }
15
+ /**
16
+ * @param summary the one line that answers the question.
17
+ * @param data what `--json` prints. It names the run, so a saved answer
18
+ * still says where it came from.
19
+ * @param detail what a person reads below the summary.
20
+ */
21
+ give(summary, data, detail) {
22
+ if (this.json) {
23
+ this.cli.pipe(`${JSON.stringify(data, undefined, 2)}\n`);
24
+ return;
25
+ }
26
+ this.cli.write(summary);
27
+ detail?.();
28
+ }
29
+ /**
30
+ * A failure, in the same two shapes.
31
+ *
32
+ * The `code` is the contract: a script branches on it, and the message is
33
+ * free to change. `next`, where there is one, is the move that gets past it.
34
+ */
35
+ fail(error) {
36
+ if (this.json) {
37
+ this.cli.pipe(`${JSON.stringify({ code: error.code, message: error.message, ...error.detail }, undefined, 2)}\n`);
38
+ return;
39
+ }
40
+ this.cli.writeError(error.message);
41
+ // Candidates are the answer to "which did you mean"; leaving them to
42
+ // --json made the text form say "matches 3" and nothing else.
43
+ const candidates = error.detail["candidates"];
44
+ if (Array.isArray(candidates)) {
45
+ for (const candidate of candidates) {
46
+ this.cli.write(` ${String(candidate)}`);
47
+ }
48
+ const total = error.detail["total"];
49
+ if (typeof total === "number" && total > candidates.length) {
50
+ this.cli.comment(` … and ${total - candidates.length} more`);
51
+ }
52
+ }
53
+ const next = error.detail["next"];
54
+ if (typeof next === "string") {
55
+ this.cli.comment(next);
56
+ }
57
+ }
58
+ }
@@ -0,0 +1,102 @@
1
+ import { Interfaces } from "@oclif/core";
2
+ import { CliEnvironment, CommandContextValues } from "../cli/index.js";
3
+ /** What every op on a live run is built from: which run, how to answer, and the op's own input. */
4
+ export interface RunControlBuildContextValues<Input = unknown> extends CommandContextValues {
5
+ /** The `--run` selector; absent means the one live run. */
6
+ readonly run?: string;
7
+ readonly json: boolean;
8
+ /** Overrides the op's own budget, in ms. */
9
+ readonly timeout?: number;
10
+ /** `--tab`, on the ops that act on a page. */
11
+ readonly tab?: string;
12
+ /** The op's args and flags, without the shared ones. */
13
+ readonly input: Input;
14
+ }
15
+ export type RunControlBuildContext<Input = unknown> = Readonly<RunControlBuildContextValues<Input>>;
16
+ /**
17
+ * What oclif parses from `T`, as a type of its own.
18
+ *
19
+ * oclif names an empty input `ArgOutput` / `FlagOutput`, which it does not
20
+ * export, so a context with no args or no flags could not be declared. An op
21
+ * without input gets an empty object instead.
22
+ */
23
+ type Parsed<T> = keyof T extends never ? Record<never, never> : {
24
+ [K in keyof T]: T[K];
25
+ };
26
+ /**
27
+ * The build context of one op on a live run: the op's own args and flags, plus
28
+ * `--run`, `--json` and `--timeout`.
29
+ *
30
+ * One per op rather than one per tool, because the ops of one tool take
31
+ * different inputs and a shared flag set would offer `--select` on `clear`.
32
+ * Generated rather than written out, because all that differs between them is
33
+ * that input.
34
+ */
35
+ export declare function runControlContext<A extends Interfaces.ArgInput, F extends Interfaces.FlagInput>(opArgs: A, opFlags: F): {
36
+ new (values: RunControlBuildContextValues<Parsed<Interfaces.InferredArgs<A>> & Parsed<Interfaces.InferredFlags<F>>>): {
37
+ readonly run?: string;
38
+ readonly json: boolean;
39
+ readonly timeout?: number;
40
+ readonly tab?: string;
41
+ readonly input: Parsed<Interfaces.InferredArgs<A>> & Parsed<Interfaces.InferredFlags<F>>;
42
+ readonly environment: CliEnvironment;
43
+ };
44
+ readonly args: A;
45
+ readonly flags: {
46
+ run: Interfaces.OptionFlag<string, Interfaces.CustomOptions>;
47
+ json: Interfaces.BooleanFlag<boolean>;
48
+ timeout: Interfaces.OptionFlag<number, Interfaces.CustomOptions>;
49
+ } & F;
50
+ create(parsedArgs: Parsed<Interfaces.InferredArgs<A>>, parsedFlags: Parsed<Interfaces.InferredFlags<{
51
+ run: Interfaces.OptionFlag<string, Interfaces.CustomOptions>;
52
+ json: Interfaces.BooleanFlag<boolean>;
53
+ timeout: Interfaces.OptionFlag<number, Interfaces.CustomOptions>;
54
+ } & F>>, environment: CliEnvironment): {
55
+ readonly run?: string;
56
+ readonly json: boolean;
57
+ readonly timeout?: number;
58
+ readonly tab?: string;
59
+ readonly input: Parsed<Interfaces.InferredArgs<A>> & Parsed<Interfaces.InferredFlags<F>>;
60
+ readonly environment: CliEnvironment;
61
+ };
62
+ };
63
+ /** {@link runControlContext} for an op on a page, which takes `--tab`. */
64
+ export declare function pageControlContext<A extends Interfaces.ArgInput, F extends Interfaces.FlagInput>(opArgs: A, opFlags: F): {
65
+ new (values: RunControlBuildContextValues<Parsed<Interfaces.InferredArgs<A>> & Parsed<Interfaces.InferredFlags<F & {
66
+ tab: Interfaces.OptionFlag<string, Interfaces.CustomOptions>;
67
+ }>>>): {
68
+ readonly run?: string;
69
+ readonly json: boolean;
70
+ readonly timeout?: number;
71
+ readonly tab?: string;
72
+ readonly input: Parsed<Interfaces.InferredArgs<A>> & Parsed<Interfaces.InferredFlags<F & {
73
+ tab: Interfaces.OptionFlag<string, Interfaces.CustomOptions>;
74
+ }>>;
75
+ readonly environment: CliEnvironment;
76
+ };
77
+ readonly args: A;
78
+ readonly flags: {
79
+ run: Interfaces.OptionFlag<string, Interfaces.CustomOptions>;
80
+ json: Interfaces.BooleanFlag<boolean>;
81
+ timeout: Interfaces.OptionFlag<number, Interfaces.CustomOptions>;
82
+ } & F & {
83
+ tab: Interfaces.OptionFlag<string, Interfaces.CustomOptions>;
84
+ };
85
+ create(parsedArgs: Parsed<Interfaces.InferredArgs<A>>, parsedFlags: Parsed<Interfaces.InferredFlags<{
86
+ run: Interfaces.OptionFlag<string, Interfaces.CustomOptions>;
87
+ json: Interfaces.BooleanFlag<boolean>;
88
+ timeout: Interfaces.OptionFlag<number, Interfaces.CustomOptions>;
89
+ } & F & {
90
+ tab: Interfaces.OptionFlag<string, Interfaces.CustomOptions>;
91
+ }>>, environment: CliEnvironment): {
92
+ readonly run?: string;
93
+ readonly json: boolean;
94
+ readonly timeout?: number;
95
+ readonly tab?: string;
96
+ readonly input: Parsed<Interfaces.InferredArgs<A>> & Parsed<Interfaces.InferredFlags<F & {
97
+ tab: Interfaces.OptionFlag<string, Interfaces.CustomOptions>;
98
+ }>>;
99
+ readonly environment: CliEnvironment;
100
+ };
101
+ };
102
+ export {};
@@ -0,0 +1,36 @@
1
+ import { Context } from "../../models/context.js";
2
+ import { RUN_CONTROL_FLAGS, TAB_FLAG } from "./run-control-flags.js";
3
+ /**
4
+ * The build context of one op on a live run: the op's own args and flags, plus
5
+ * `--run`, `--json` and `--timeout`.
6
+ *
7
+ * One per op rather than one per tool, because the ops of one tool take
8
+ * different inputs and a shared flag set would offer `--select` on `clear`.
9
+ * Generated rather than written out, because all that differs between them is
10
+ * that input.
11
+ */
12
+ export function runControlContext(opArgs, opFlags) {
13
+ const args = opArgs;
14
+ const flags = { ...RUN_CONTROL_FLAGS, ...opFlags };
15
+ class OpBuildContext extends Context() {
16
+ static args = args;
17
+ static flags = flags;
18
+ static create(parsedArgs, parsedFlags, environment) {
19
+ const { run, json, timeout, tab, ...own } = parsedFlags;
20
+ return new OpBuildContext({
21
+ environment,
22
+ run: run,
23
+ json: Boolean(json),
24
+ timeout: timeout,
25
+ tab: tab,
26
+ input: { ...parsedArgs, ...own },
27
+ });
28
+ }
29
+ }
30
+ OpBuildContext;
31
+ return OpBuildContext;
32
+ }
33
+ /** {@link runControlContext} for an op on a page, which takes `--tab`. */
34
+ export function pageControlContext(opArgs, opFlags) {
35
+ return runControlContext(opArgs, { ...opFlags, tab: TAB_FLAG });
36
+ }
@@ -0,0 +1,12 @@
1
+ /** The flags every `sk onboarding <tool> <op>` shares. */
2
+ export declare const RUN_CONTROL_FLAGS: {
3
+ run: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
4
+ json: import("@oclif/core/interfaces").BooleanFlag<boolean>;
5
+ timeout: import("@oclif/core/interfaces").OptionFlag<number, import("@oclif/core/interfaces").CustomOptions>;
6
+ };
7
+ /**
8
+ * `--tab`, on every command that acts on a page rather than on the run.
9
+ * Not on the cache or the files: those belong to the run, whichever tab is
10
+ * looking.
11
+ */
12
+ export declare const TAB_FLAG: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
@@ -0,0 +1,22 @@
1
+ import { Flags } from "@oclif/core";
2
+ /** The flags every `sk onboarding <tool> <op>` shares. */
3
+ export const RUN_CONTROL_FLAGS = {
4
+ run: Flags.string({
5
+ description: "Which run: its id, its customer name, or the path it was started with. Omit when exactly one run is live.",
6
+ }),
7
+ json: Flags.boolean({
8
+ default: false,
9
+ description: "The answer as one JSON document on stdout; a failure as { code, message } with exit code 1",
10
+ }),
11
+ timeout: Flags.integer({
12
+ description: "How long to wait for the run to answer, in ms. The default suits the op",
13
+ }),
14
+ };
15
+ /**
16
+ * `--tab`, on every command that acts on a page rather than on the run.
17
+ * Not on the cache or the files: those belong to the run, whichever tab is
18
+ * looking.
19
+ */
20
+ export const TAB_FLAG = Flags.string({
21
+ description: "Which tab: its index from `sk onboarding browser tabs`, or part of its url. Omitted means the run's own page",
22
+ });
@@ -0,0 +1,9 @@
1
+ import { CliServiceInterface } from "../cli/index.js";
2
+ import { LiveRun } from "./live-run.js";
3
+ import { RunAnswer } from "./run-answer.js";
4
+ /** What every service on a live run is built from. */
5
+ export interface RunControlServiceDeps {
6
+ cli: CliServiceInterface;
7
+ run: LiveRun;
8
+ answer: RunAnswer;
9
+ }
@@ -0,0 +1 @@
1
+ export {};
@@ -0,0 +1,14 @@
1
+ import { NotLiveMessage } from "./live-run.js";
2
+ import { RunControlBuildContext } from "./run-control-context.js";
3
+ import { RunControlServiceDeps } from "./run-control-model.js";
4
+ /**
5
+ * The base of every factory here: it resolves the run `--run` names, refuses
6
+ * one that is not live, and wires the answer to `--json`.
7
+ */
8
+ export declare abstract class RunControlServiceFactory<Service> {
9
+ protected readonly context: RunControlBuildContext;
10
+ constructor(context: RunControlBuildContext);
11
+ abstract buildService(): Service;
12
+ /** @param notLive what to say about an ended run, when the tool knows better than "it is gone". */
13
+ protected deps(notLive?: NotLiveMessage): RunControlServiceDeps;
14
+ }
@@ -0,0 +1,26 @@
1
+ import { RunRegistry } from "../run-registry/index.js";
2
+ import { LiveRun } from "./live-run.js";
3
+ import { RunAnswer } from "./run-answer.js";
4
+ /**
5
+ * The base of every factory here: it resolves the run `--run` names, refuses
6
+ * one that is not live, and wires the answer to `--json`.
7
+ */
8
+ export class RunControlServiceFactory {
9
+ context;
10
+ constructor(context) {
11
+ this.context = context;
12
+ }
13
+ /** @param notLive what to say about an ended run, when the tool knows better than "it is gone". */
14
+ deps(notLive) {
15
+ const { environment, run, timeout, json, tab } = this.context;
16
+ return {
17
+ cli: environment.cli,
18
+ run: LiveRun.resolve(new RunRegistry(environment.cacheDir), run, {
19
+ timeoutMs: timeout,
20
+ tab,
21
+ notLive,
22
+ }),
23
+ answer: new RunAnswer(environment.cli, json),
24
+ };
25
+ }
26
+ }
@@ -0,0 +1,25 @@
1
+ import { Interfaces } from "@oclif/core";
2
+ import { CliEnvironment, CommandContextValues } from "../../cli/index.js";
3
+ export interface RunSessionBuildContextValues extends CommandContextValues {
4
+ readonly run?: string;
5
+ readonly json: boolean;
6
+ }
7
+ declare const args: {};
8
+ declare const flags: {
9
+ run: Interfaces.OptionFlag<string, Interfaces.CustomOptions>;
10
+ json: Interfaces.BooleanFlag<boolean>;
11
+ };
12
+ declare const RunSessionBuildContext_base: new (values: RunSessionBuildContextValues) => Readonly<RunSessionBuildContextValues>;
13
+ /**
14
+ * What `sk onboarding list` and `status` are built from. No `--timeout`: they
15
+ * read the registry and never ask a run anything.
16
+ */
17
+ export declare class RunSessionBuildContext extends RunSessionBuildContext_base {
18
+ static readonly args: {};
19
+ static readonly flags: {
20
+ run: Interfaces.OptionFlag<string, Interfaces.CustomOptions>;
21
+ json: Interfaces.BooleanFlag<boolean>;
22
+ };
23
+ static create(_parsedArgs: Interfaces.InferredArgs<typeof args>, parsedFlags: Interfaces.InferredFlags<typeof flags>, environment: CliEnvironment): RunSessionBuildContext;
24
+ }
25
+ export {};
@@ -0,0 +1,20 @@
1
+ import { Context } from "../../../models/context.js";
2
+ import { RUN_CONTROL_FLAGS } from "../run-control-flags.js";
3
+ const args = {};
4
+ const flags = { run: RUN_CONTROL_FLAGS.run, json: RUN_CONTROL_FLAGS.json };
5
+ /**
6
+ * What `sk onboarding list` and `status` are built from. No `--timeout`: they
7
+ * read the registry and never ask a run anything.
8
+ */
9
+ export class RunSessionBuildContext extends Context() {
10
+ static args = args;
11
+ static flags = flags;
12
+ static create(_parsedArgs, parsedFlags, environment) {
13
+ return new RunSessionBuildContext({
14
+ environment,
15
+ run: parsedFlags.run,
16
+ json: parsedFlags.json,
17
+ });
18
+ }
19
+ }
20
+ RunSessionBuildContext;
@@ -0,0 +1,8 @@
1
+ import { RunSessionBuildContext } from "./run-session-contexts.js";
2
+ import { RunSessionService } from "./run-session-service.js";
3
+ /** Needs no run: the registry is the whole answer. */
4
+ export declare class RunSessionServiceFactory {
5
+ private readonly context;
6
+ constructor(context: RunSessionBuildContext);
7
+ buildService(): RunSessionService;
8
+ }
@@ -0,0 +1,18 @@
1
+ import { RunRegistry } from "../../run-registry/index.js";
2
+ import { RunAnswer } from "../run-answer.js";
3
+ import { RunSessionService } from "./run-session-service.js";
4
+ /** Needs no run: the registry is the whole answer. */
5
+ export class RunSessionServiceFactory {
6
+ context;
7
+ constructor(context) {
8
+ this.context = context;
9
+ }
10
+ buildService() {
11
+ const { environment, json } = this.context;
12
+ return new RunSessionService({
13
+ cli: environment.cli,
14
+ registry: new RunRegistry(environment.cacheDir),
15
+ answer: new RunAnswer(environment.cli, json),
16
+ });
17
+ }
18
+ }
@@ -0,0 +1,32 @@
1
+ import { CliServiceInterface } from "../../cli/index.js";
2
+ import { RunRegistry } from "../../run-registry/index.js";
3
+ import { RunAnswer } from "../run-answer.js";
4
+ export interface RunSessionServiceDeps {
5
+ cli: CliServiceInterface;
6
+ registry: RunRegistry;
7
+ answer: RunAnswer;
8
+ }
9
+ /**
10
+ * The runs on this machine. Reads the registry only, so it answers with no run
11
+ * live — which is when it is most often asked.
12
+ */
13
+ export declare class RunSessionService {
14
+ private readonly cli;
15
+ private readonly registry;
16
+ private readonly answer;
17
+ constructor(deps: RunSessionServiceDeps);
18
+ /** Every recorded run, live and finished, newest first. */
19
+ list(): void;
20
+ /**
21
+ * The run `--run` names, or the one live run. Refuses rather than guesses
22
+ * between two live ones, the same way every op on a run does.
23
+ */
24
+ status(selector?: string, probeMs?: number): Promise<void>;
25
+ /**
26
+ * Ends the run the way Ctrl+C does, and waits until its process is gone, so
27
+ * its browser and its files are released when this returns.
28
+ *
29
+ * @throws {ControlError} `STOP_TIMEOUT` when the process outlives `waitMs`.
30
+ */
31
+ stop(selector?: string, waitMs?: number): Promise<void>;
32
+ }
@@ -0,0 +1,151 @@
1
+ import { ControlError } from "../control-client.js";
2
+ import { LiveRun } from "../live-run.js";
3
+ /** The shape a run takes in an answer: its meta, minus what nobody asks for. */
4
+ function describe(run) {
5
+ return {
6
+ id: run.meta.id,
7
+ customer: run.meta.customer,
8
+ customerPath: run.meta.customerPath,
9
+ configName: run.meta.configName,
10
+ app: run.meta.app,
11
+ status: run.status,
12
+ /** Why it ended, when it said. Without this the status is a dead end. */
13
+ error: run.meta.error,
14
+ live: run.live,
15
+ // `live` without it is a claim of the same kind the run's own status was.
16
+ liveVerified: run.liveVerified,
17
+ pid: run.meta.pid,
18
+ /** Which build recorded the run — `cliVersion` cannot tell two apart. */
19
+ commit: run.meta.commit,
20
+ buildTime: run.meta.buildTime,
21
+ signal: run.meta.signal,
22
+ startedAt: run.meta.startedAt,
23
+ endedAt: run.meta.endedAt,
24
+ debugPort: run.meta.debugPort,
25
+ flags: run.meta.flags,
26
+ dir: run.dir,
27
+ };
28
+ }
29
+ /**
30
+ * Whether the page of a live run answers a CDP evaluation within `probeMs`.
31
+ *
32
+ * A live process says nothing about its page: a page blocked by a dialog or a
33
+ * busy renderer kept `live: true` while every tool timed out.
34
+ */
35
+ async function probePage(run, probeMs) {
36
+ const started = Date.now();
37
+ try {
38
+ const data = await new LiveRun(run).request({ op: "debug.eval", expression: "1" }, probeMs);
39
+ return {
40
+ answers: true,
41
+ paused: data.onCallFrame,
42
+ ms: Date.now() - started,
43
+ };
44
+ }
45
+ catch (error) {
46
+ const failed = ControlError.from(error);
47
+ return {
48
+ answers: false,
49
+ code: failed?.code ?? "PROBE_FAILED",
50
+ message: failed?.message ?? String(error),
51
+ };
52
+ }
53
+ }
54
+ /**
55
+ * The runs on this machine. Reads the registry only, so it answers with no run
56
+ * live — which is when it is most often asked.
57
+ */
58
+ export class RunSessionService {
59
+ cli;
60
+ registry;
61
+ answer;
62
+ constructor(deps) {
63
+ this.cli = deps.cli;
64
+ this.registry = deps.registry;
65
+ this.answer = deps.answer;
66
+ }
67
+ /** Every recorded run, live and finished, newest first. */
68
+ list() {
69
+ const runs = this.registry.list();
70
+ const live = runs.filter((run) => run.live).length;
71
+ this.answer.give(runs.length === 0
72
+ ? "No runs recorded yet. Start one with `sk onboarding <customerPath>`."
73
+ : `${runs.length} run${runs.length === 1 ? "" : "s"}, ${live} live`, { runs: runs.map(describe) }, () => {
74
+ if (runs.length === 0) {
75
+ return;
76
+ }
77
+ // Lines, not a table: a run id is long, and a table sized to the
78
+ // terminal truncates the status, which is the column that matters.
79
+ const width = Math.max(...runs.map((run) => run.meta.id.length));
80
+ for (const run of runs) {
81
+ const status = run.live
82
+ ? this.cli.style.green(run.status.padEnd(8))
83
+ : run.status.padEnd(8);
84
+ this.cli.write(`${run.meta.id.padEnd(width)} ${status} ${this.cli.style.grey(run.meta.startedAt)}${run.meta.debugPort ? this.cli.style.grey(` :${run.meta.debugPort}`) : ""}`);
85
+ }
86
+ });
87
+ }
88
+ /**
89
+ * The run `--run` names, or the one live run. Refuses rather than guesses
90
+ * between two live ones, the same way every op on a run does.
91
+ */
92
+ async status(selector, probeMs = 3000) {
93
+ const live = this.registry.liveRuns();
94
+ if (!selector && live.length === 0) {
95
+ throw new ControlError("NO_LIVE_RUN", "No onboarding run is live.", {
96
+ next: "Start one with `sk onboarding <customerPath>`, or `sk onboarding list` for the finished ones.",
97
+ });
98
+ }
99
+ const run = this.registry.resolve(selector);
100
+ const described = describe(run);
101
+ const page = run.live ? await probePage(run, probeMs) : undefined;
102
+ this.answer.give(`${run.meta.id} — ${run.status}${page && !page.answers ? `, but its page does not answer: ${page.message}` : page?.paused ? ", paused in the debugger" : ""}`, { run: described, ...(page ? { page } : {}) }, () => {
103
+ for (const field of [
104
+ "customerPath",
105
+ "configName",
106
+ "app",
107
+ "pid",
108
+ "debugPort",
109
+ "startedAt",
110
+ "endedAt",
111
+ "error",
112
+ "commit",
113
+ "dir",
114
+ ]) {
115
+ const value = described[field];
116
+ if (value !== undefined && value !== null) {
117
+ this.cli.write(` ${field.padEnd(13)} ${value}`);
118
+ }
119
+ }
120
+ });
121
+ }
122
+ /**
123
+ * Ends the run the way Ctrl+C does, and waits until its process is gone, so
124
+ * its browser and its files are released when this returns.
125
+ *
126
+ * @throws {ControlError} `STOP_TIMEOUT` when the process outlives `waitMs`.
127
+ */
128
+ async stop(selector, waitMs = 15_000) {
129
+ const run = this.registry.resolve(selector);
130
+ if (!this.registry.processAlive(run)) {
131
+ this.answer.give(`${run.meta.id} had already ended — ${run.status}`, {
132
+ run: describe(run),
133
+ stopped: false,
134
+ });
135
+ return;
136
+ }
137
+ process.kill(run.meta.pid, "SIGTERM");
138
+ const deadline = Date.now() + waitMs;
139
+ while (this.registry.processAlive(run)) {
140
+ if (Date.now() > deadline) {
141
+ throw new ControlError("STOP_TIMEOUT", `${run.meta.id} still runs ${waitMs} ms after SIGTERM.`, { pid: run.meta.pid, next: `kill ${run.meta.pid}` });
142
+ }
143
+ await new Promise((resolve) => setTimeout(resolve, 200));
144
+ }
145
+ const ended = this.registry.resolve(run.meta.id);
146
+ this.answer.give(`${ended.meta.id} stopped — ${ended.status}`, {
147
+ run: describe(ended),
148
+ stopped: true,
149
+ });
150
+ }
151
+ }