@speedkit/cli 4.51.0-run-control.5 → 4.51.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 (485) hide show
  1. package/CHANGELOG.md +30 -0
  2. package/README.md +14 -1426
  3. package/dist/commands/diff.d.ts +1 -7
  4. package/dist/commands/diff.js +3 -9
  5. package/dist/commands/login.d.ts +0 -3
  6. package/dist/commands/login.js +3 -14
  7. package/dist/commands/onboarding.d.ts +0 -26
  8. package/dist/commands/onboarding.js +4 -221
  9. package/dist/commands/origin-request.d.ts +0 -4
  10. package/dist/commands/origin-request.js +0 -4
  11. package/dist/services/browser-fetch/device-emulation.d.ts +0 -11
  12. package/dist/services/browser-fetch/device-emulation.js +0 -14
  13. package/dist/services/bundler/bundle-service-factory.d.ts +3 -0
  14. package/dist/services/bundler/bundle-service-factory.js +5 -1
  15. package/dist/services/bundler/bundle-service.d.ts +10 -1
  16. package/dist/services/bundler/bundle-service.js +16 -1
  17. package/dist/services/bundler/error/packjockel-error.d.ts +3 -0
  18. package/dist/services/bundler/error/packjockel-error.js +3 -0
  19. package/dist/services/bundler/index.d.ts +1 -0
  20. package/dist/services/bundler/index.js +1 -0
  21. package/dist/services/bundler/packjockel-service.d.ts +112 -0
  22. package/dist/services/bundler/packjockel-service.js +202 -0
  23. package/dist/services/bundler/spec/packjockel-service.spec.js +186 -0
  24. package/dist/services/cli/cli-environment-factory.d.ts +0 -3
  25. package/dist/services/cli/cli-environment-factory.js +0 -1
  26. package/dist/services/cli/cli-service-build-context.d.ts +0 -3
  27. package/dist/services/cli/cli-service-factory.js +1 -1
  28. package/dist/services/cli/cli-service-model.d.ts +10 -29
  29. package/dist/services/cli/cli-service.d.ts +11 -60
  30. package/dist/services/cli/cli-service.js +32 -196
  31. package/dist/services/cli/index.d.ts +0 -2
  32. package/dist/services/cli/index.js +0 -2
  33. package/dist/services/cli/spec/cli-service.spec.js +50 -113
  34. package/dist/services/deploy/checks/activation/customer-approval-check.js +1 -1
  35. package/dist/services/deploy/checks/pre-deploy/device-detection-changed-check.js +2 -3
  36. package/dist/services/deploy/checks/pre-deploy/split-change-check.js +2 -3
  37. package/dist/services/deploy/handler/customer-config-handler.d.ts +9 -0
  38. package/dist/services/deploy/handler/customer-config-handler.js +41 -6
  39. package/dist/services/deploy/interface/install.d.ts +7 -1
  40. package/dist/services/deploy/mr/live-state-check.js +21 -2
  41. package/dist/services/deploy/policy/auto-deploy-policy.js +2 -0
  42. package/dist/services/deploy/policy/deploy-policy-model.d.ts +4 -0
  43. package/dist/services/deploy/policy/deploy-policy-model.js +4 -0
  44. package/dist/services/deploy/policy/testing-deploy-policy.js +2 -0
  45. package/dist/services/deploy/spec/handler/customer-config-handler.spec.js +98 -0
  46. package/dist/services/deploy/spec/mr/live-state-check.spec.js +45 -4
  47. package/dist/services/deploy/spec/policy/auto-deploy-policy.spec.js +2 -0
  48. package/dist/services/deploy/spec/policy/testing-deploy-policy.spec.js +3 -1
  49. package/dist/services/diff/diff-service-build-context.d.ts +0 -12
  50. package/dist/services/diff/diff-service-build-context.js +1 -45
  51. package/dist/services/diff/diff-service-factory.d.ts +0 -2
  52. package/dist/services/diff/diff-service-factory.js +25 -65
  53. package/dist/services/diff/diff-service.d.ts +0 -11
  54. package/dist/services/diff/diff-service.js +11 -37
  55. package/dist/services/diff/page-source.d.ts +0 -12
  56. package/dist/services/diff/page-source.js +11 -16
  57. package/dist/services/diff/sinks/tool-diff-sink.d.ts +2 -3
  58. package/dist/services/diff/sinks/tool-diff-sink.js +2 -3
  59. package/dist/services/diff/spec/diff-service-build-context.spec.js +0 -19
  60. package/dist/services/diff/spec/diff-service.spec.js +0 -95
  61. package/dist/services/document-handler-runtime/document-handler-browser-mock.d.ts +13 -0
  62. package/dist/services/document-handler-runtime/document-handler-browser-mock.js +69 -0
  63. package/dist/services/document-handler-runtime/document-handler-server.d.ts +27 -0
  64. package/dist/services/document-handler-runtime/document-handler-server.js +112 -19
  65. package/dist/services/document-handler-runtime/spec/document-handler-browser-mock.spec.js +34 -0
  66. package/dist/services/git/git-repository.d.ts +0 -2
  67. package/dist/services/git/git-repository.js +0 -6
  68. package/dist/services/integration-api/customer-config-flags.js +0 -1
  69. package/dist/services/integration-api/integration-api-model.d.ts +4 -1
  70. package/dist/services/integration-api/spec/customer-config-file.spec.js +56 -0
  71. package/dist/services/integration-api/spec/speed-kit-config-file.spec.js +68 -8
  72. package/dist/services/integration-api/struct/customer-config-file.d.ts +15 -0
  73. package/dist/services/integration-api/struct/customer-config-file.js +42 -0
  74. package/dist/services/integration-api/struct/customer-config.d.ts +55 -1
  75. package/dist/services/integration-api/struct/customer-config.js +70 -3
  76. package/dist/services/integration-api/struct/speed-kit-config-file.d.ts +11 -4
  77. package/dist/services/integration-api/struct/speed-kit-config-file.js +31 -10
  78. package/dist/services/onboarding/browse/browse-service.d.ts +1 -13
  79. package/dist/services/onboarding/browse/browse-service.js +7 -43
  80. package/dist/services/onboarding/browser/baqend-response.d.ts +1 -17
  81. package/dist/services/onboarding/browser/baqend-response.js +0 -23
  82. package/dist/services/onboarding/browser/emulate-device.d.ts +1 -12
  83. package/dist/services/onboarding/browser/emulate-device.js +13 -68
  84. package/dist/services/onboarding/browser/executable/executable-validator.js +2 -4
  85. package/dist/services/onboarding/browser/extension/extension-bridge.js +3 -5
  86. package/dist/services/onboarding/browser/extension/extension-downloader.js +8 -17
  87. package/dist/services/onboarding/browser/extension/extension-validator.js +4 -9
  88. package/dist/services/onboarding/browser/launch-browser.d.ts +1 -2
  89. package/dist/services/onboarding/browser/launch-browser.js +1 -6
  90. package/dist/services/onboarding/config-renderer/speed-kit-install-context.d.ts +2 -0
  91. package/dist/services/onboarding/config-renderer/speed-kit-install-context.js +29 -8
  92. package/dist/services/onboarding/dashboard/diff-against-current-page.js +1 -3
  93. package/dist/services/onboarding/dashboard/index.js +2 -7
  94. package/dist/services/onboarding/fetch-event-handler.d.ts +5 -24
  95. package/dist/services/onboarding/fetch-event-handler.js +32 -103
  96. package/dist/services/onboarding/fetch-events/speed-kit-install-js.js +2 -11
  97. package/dist/services/onboarding/fetch-events/speed-kit-rum-pi-request.d.ts +0 -14
  98. package/dist/services/onboarding/fetch-events/speed-kit-rum-pi-request.js +0 -30
  99. package/dist/services/onboarding/fetch-events/speed-kit-service-worker-js.d.ts +3 -14
  100. package/dist/services/onboarding/fetch-events/speed-kit-service-worker-js.js +10 -29
  101. package/dist/services/onboarding/file-events/file-watcher.d.ts +4 -43
  102. package/dist/services/onboarding/file-events/file-watcher.js +21 -119
  103. package/dist/services/onboarding/inject/inject-service.js +1 -1
  104. package/dist/services/onboarding/onboarding-model.d.ts +7 -40
  105. package/dist/services/onboarding/onboarding-model.js +9 -20
  106. package/dist/services/onboarding/onboarding-service-build-context.d.ts +0 -4
  107. package/dist/services/onboarding/onboarding-service-build-context.js +1 -7
  108. package/dist/services/onboarding/onboarding-service-factory.d.ts +1 -17
  109. package/dist/services/onboarding/onboarding-service-factory.js +35 -152
  110. package/dist/services/onboarding/onboarding-service.d.ts +1 -40
  111. package/dist/services/onboarding/onboarding-service.js +23 -139
  112. package/dist/services/onboarding/request-cache/cache.d.ts +5 -62
  113. package/dist/services/onboarding/request-cache/cache.js +17 -128
  114. package/dist/services/onboarding/spec/file-events/file-watcher.spec.js +67 -0
  115. package/dist/services/onboarding/spec/onboarding-model.spec.js +3 -39
  116. package/dist/services/onboarding/spec/onboarding-service-factory.spec.js +1 -25
  117. package/dist/services/onboarding/templates/install-speed-kit-js-template.js +5 -0
  118. package/dist/services/onboarding/todo-collector.d.ts +2 -7
  119. package/dist/services/onboarding/todo-collector.js +12 -49
  120. package/dist/services/onboarding/virtual-orestes-app/index.d.ts +0 -38
  121. package/dist/services/onboarding/virtual-orestes-app/index.js +27 -113
  122. package/dist/services/origin-request/asset-variations.d.ts +0 -14
  123. package/dist/services/origin-request/asset-variations.js +4 -11
  124. package/dist/services/origin-request/origin-fetcher.d.ts +0 -7
  125. package/dist/services/origin-request/origin-fetcher.js +5 -43
  126. package/dist/services/origin-request/origin-request-service-build-context.d.ts +0 -17
  127. package/dist/services/origin-request/origin-request-service-build-context.js +0 -8
  128. package/dist/services/origin-request/origin-request-service-factory.d.ts +5 -0
  129. package/dist/services/origin-request/origin-request-service-factory.js +30 -2
  130. package/dist/services/origin-request/origin-request-service.d.ts +6 -121
  131. package/dist/services/origin-request/origin-request-service.js +49 -273
  132. package/dist/services/origin-request/runtime-config-source.d.ts +0 -6
  133. package/dist/services/origin-request/runtime-config-source.js +4 -15
  134. package/dist/services/origin-request/spec/asset-variations.spec.js +0 -20
  135. package/dist/services/origin-request/spec/origin-request-service.spec.js +6 -329
  136. package/dist/services/pull/pull-service.js +23 -5
  137. package/dist/services/query-builder/query-builder-factory.js +3 -3
  138. package/dist/services/setup/os/tool-registry.js +2 -2
  139. package/oclif.manifest.json +288 -3409
  140. package/package.json +3 -20
  141. package/dist/base/run-control-command.d.ts +0 -15
  142. package/dist/base/run-control-command.js +0 -20
  143. package/dist/build-info.json +0 -6
  144. package/dist/commands/onboarding/browser/click.d.ts +0 -75
  145. package/dist/commands/onboarding/browser/click.js +0 -19
  146. package/dist/commands/onboarding/browser/emulate.d.ts +0 -105
  147. package/dist/commands/onboarding/browser/emulate.js +0 -26
  148. package/dist/commands/onboarding/browser/navigate.d.ts +0 -75
  149. package/dist/commands/onboarding/browser/navigate.js +0 -19
  150. package/dist/commands/onboarding/browser/panel.d.ts +0 -63
  151. package/dist/commands/onboarding/browser/panel.js +0 -12
  152. package/dist/commands/onboarding/browser/reinstall-sw.d.ts +0 -63
  153. package/dist/commands/onboarding/browser/reinstall-sw.js +0 -14
  154. package/dist/commands/onboarding/browser/reset.d.ts +0 -71
  155. package/dist/commands/onboarding/browser/reset.js +0 -18
  156. package/dist/commands/onboarding/browser/screenshot.d.ts +0 -77
  157. package/dist/commands/onboarding/browser/screenshot.js +0 -19
  158. package/dist/commands/onboarding/browser/state.d.ts +0 -63
  159. package/dist/commands/onboarding/browser/state.js +0 -12
  160. package/dist/commands/onboarding/browser/tabs.d.ts +0 -58
  161. package/dist/commands/onboarding/browser/tabs.js +0 -16
  162. package/dist/commands/onboarding/cache/clear.d.ts +0 -58
  163. package/dist/commands/onboarding/cache/clear.js +0 -12
  164. package/dist/commands/onboarding/cache/errors.d.ts +0 -58
  165. package/dist/commands/onboarding/cache/errors.js +0 -12
  166. package/dist/commands/onboarding/cache/evict.d.ts +0 -62
  167. package/dist/commands/onboarding/cache/evict.js +0 -15
  168. package/dist/commands/onboarding/cache/get.d.ts +0 -85
  169. package/dist/commands/onboarding/cache/get.js +0 -17
  170. package/dist/commands/onboarding/cache/list.d.ts +0 -58
  171. package/dist/commands/onboarding/cache/list.js +0 -15
  172. package/dist/commands/onboarding/cache/prewarm.d.ts +0 -73
  173. package/dist/commands/onboarding/cache/prewarm.js +0 -20
  174. package/dist/commands/onboarding/cache/refresh.d.ts +0 -62
  175. package/dist/commands/onboarding/cache/refresh.js +0 -18
  176. package/dist/commands/onboarding/cdp.d.ts +0 -81
  177. package/dist/commands/onboarding/cdp.js +0 -18
  178. package/dist/commands/onboarding/debug/arm.d.ts +0 -83
  179. package/dist/commands/onboarding/debug/arm.js +0 -19
  180. package/dist/commands/onboarding/debug/await.d.ts +0 -71
  181. package/dist/commands/onboarding/debug/await.js +0 -18
  182. package/dist/commands/onboarding/debug/disarm.d.ts +0 -63
  183. package/dist/commands/onboarding/debug/disarm.js +0 -12
  184. package/dist/commands/onboarding/debug/eval.d.ts +0 -75
  185. package/dist/commands/onboarding/debug/eval.js +0 -16
  186. package/dist/commands/onboarding/debug/release.d.ts +0 -63
  187. package/dist/commands/onboarding/debug/release.js +0 -12
  188. package/dist/commands/onboarding/debug/resume.d.ts +0 -63
  189. package/dist/commands/onboarding/debug/resume.js +0 -12
  190. package/dist/commands/onboarding/debug/status.d.ts +0 -63
  191. package/dist/commands/onboarding/debug/status.js +0 -12
  192. package/dist/commands/onboarding/debug/step.d.ts +0 -67
  193. package/dist/commands/onboarding/debug/step.js +0 -15
  194. package/dist/commands/onboarding/files/list.d.ts +0 -58
  195. package/dist/commands/onboarding/files/list.js +0 -12
  196. package/dist/commands/onboarding/files/read.d.ts +0 -73
  197. package/dist/commands/onboarding/files/read.js +0 -16
  198. package/dist/commands/onboarding/files/rebuild.d.ts +0 -63
  199. package/dist/commands/onboarding/files/rebuild.js +0 -18
  200. package/dist/commands/onboarding/files/validate.d.ts +0 -58
  201. package/dist/commands/onboarding/files/validate.js +0 -12
  202. package/dist/commands/onboarding/fouc.d.ts +0 -77
  203. package/dist/commands/onboarding/fouc.js +0 -16
  204. package/dist/commands/onboarding/inject/add.d.ts +0 -89
  205. package/dist/commands/onboarding/inject/add.js +0 -17
  206. package/dist/commands/onboarding/inject/clear.d.ts +0 -63
  207. package/dist/commands/onboarding/inject/clear.js +0 -12
  208. package/dist/commands/onboarding/inject/list.d.ts +0 -63
  209. package/dist/commands/onboarding/inject/list.js +0 -12
  210. package/dist/commands/onboarding/inject/read.d.ts +0 -75
  211. package/dist/commands/onboarding/inject/read.js +0 -18
  212. package/dist/commands/onboarding/inject/recipes.d.ts +0 -63
  213. package/dist/commands/onboarding/inject/recipes.js +0 -12
  214. package/dist/commands/onboarding/inject/remove.d.ts +0 -67
  215. package/dist/commands/onboarding/inject/remove.js +0 -15
  216. package/dist/commands/onboarding/list.d.ts +0 -13
  217. package/dist/commands/onboarding/list.js +0 -12
  218. package/dist/commands/onboarding/logs.d.ts +0 -41
  219. package/dist/commands/onboarding/logs.js +0 -257
  220. package/dist/commands/onboarding/navwalk.d.ts +0 -95
  221. package/dist/commands/onboarding/navwalk.js +0 -19
  222. package/dist/commands/onboarding/response.d.ts +0 -67
  223. package/dist/commands/onboarding/response.js +0 -18
  224. package/dist/commands/onboarding/rum/beacons.d.ts +0 -75
  225. package/dist/commands/onboarding/rum/beacons.js +0 -16
  226. package/dist/commands/onboarding/rum/get.d.ts +0 -77
  227. package/dist/commands/onboarding/rum/get.js +0 -18
  228. package/dist/commands/onboarding/rum/key.d.ts +0 -67
  229. package/dist/commands/onboarding/rum/key.js +0 -13
  230. package/dist/commands/onboarding/rum/previous.d.ts +0 -63
  231. package/dist/commands/onboarding/rum/previous.js +0 -12
  232. package/dist/commands/onboarding/status.d.ts +0 -13
  233. package/dist/commands/onboarding/status.js +0 -17
  234. package/dist/commands/onboarding/stop.d.ts +0 -13
  235. package/dist/commands/onboarding/stop.js +0 -17
  236. package/dist/commands/onboarding/todo.d.ts +0 -58
  237. package/dist/commands/onboarding/todo.js +0 -12
  238. package/dist/commands/onboarding/viewport.d.ts +0 -101
  239. package/dist/commands/onboarding/viewport.js +0 -18
  240. package/dist/commands/onboarding/watch.d.ts +0 -93
  241. package/dist/commands/onboarding/watch.js +0 -16
  242. package/dist/commands/spec/onboarding.spec.js +0 -127
  243. package/dist/services/cli/build-info.d.ts +0 -33
  244. package/dist/services/cli/build-info.js +0 -63
  245. package/dist/services/cli/sink.d.ts +0 -47
  246. package/dist/services/cli/sink.js +0 -31
  247. package/dist/services/cli/spec/build-identity.spec.js +0 -85
  248. package/dist/services/cli/spec/build-info.spec.js +0 -10
  249. package/dist/services/cli/spec/cli-service-log.spec.js +0 -133
  250. package/dist/services/cli/spec/memory-cli.d.ts +0 -9
  251. package/dist/services/cli/spec/memory-cli.js +0 -9
  252. package/dist/services/diff/config-at-ref.d.ts +0 -20
  253. package/dist/services/diff/config-at-ref.js +0 -33
  254. package/dist/services/diff/run-runtime-config.d.ts +0 -33
  255. package/dist/services/diff/run-runtime-config.js +0 -74
  256. package/dist/services/diff/spec/config-at-ref.spec.js +0 -46
  257. package/dist/services/diff/spec/run-runtime-config.spec.d.ts +0 -1
  258. package/dist/services/diff/spec/run-runtime-config.spec.js +0 -87
  259. package/dist/services/onboarding/browser/answer-dialogs.d.ts +0 -12
  260. package/dist/services/onboarding/browser/answer-dialogs.js +0 -25
  261. package/dist/services/onboarding/browser/console-log.d.ts +0 -9
  262. package/dist/services/onboarding/browser/console-log.js +0 -27
  263. package/dist/services/onboarding/browser/resume-restarted-workers.d.ts +0 -14
  264. package/dist/services/onboarding/browser/resume-restarted-workers.js +0 -26
  265. package/dist/services/onboarding/control/body-inspect.d.ts +0 -24
  266. package/dist/services/onboarding/control/body-inspect.js +0 -106
  267. package/dist/services/onboarding/control/browser-session.d.ts +0 -547
  268. package/dist/services/onboarding/control/browser-session.js +0 -1337
  269. package/dist/services/onboarding/control/config-validation.d.ts +0 -17
  270. package/dist/services/onboarding/control/config-validation.js +0 -46
  271. package/dist/services/onboarding/control/control-protocol.d.ts +0 -1430
  272. package/dist/services/onboarding/control/control-protocol.js +0 -58
  273. package/dist/services/onboarding/control/control-server.d.ts +0 -292
  274. package/dist/services/onboarding/control/control-server.js +0 -1629
  275. package/dist/services/onboarding/control/debug-session.d.ts +0 -219
  276. package/dist/services/onboarding/control/debug-session.js +0 -897
  277. package/dist/services/onboarding/control/fouc.d.ts +0 -23
  278. package/dist/services/onboarding/control/fouc.js +0 -151
  279. package/dist/services/onboarding/control/index.d.ts +0 -4
  280. package/dist/services/onboarding/control/index.js +0 -4
  281. package/dist/services/onboarding/control/navigate-wait.d.ts +0 -33
  282. package/dist/services/onboarding/control/navigate-wait.js +0 -56
  283. package/dist/services/onboarding/control/navwalk.d.ts +0 -65
  284. package/dist/services/onboarding/control/navwalk.js +0 -248
  285. package/dist/services/onboarding/control/preload-registry.d.ts +0 -150
  286. package/dist/services/onboarding/control/preload-registry.js +0 -829
  287. package/dist/services/onboarding/control/response-explainer.d.ts +0 -24
  288. package/dist/services/onboarding/control/response-explainer.js +0 -257
  289. package/dist/services/onboarding/control/rum.d.ts +0 -8
  290. package/dist/services/onboarding/control/rum.js +0 -220
  291. package/dist/services/onboarding/control/service-worker-tracker.d.ts +0 -68
  292. package/dist/services/onboarding/control/service-worker-tracker.js +0 -120
  293. package/dist/services/onboarding/control/viewport.d.ts +0 -45
  294. package/dist/services/onboarding/control/viewport.js +0 -344
  295. package/dist/services/onboarding/control/watch.d.ts +0 -26
  296. package/dist/services/onboarding/control/watch.js +0 -157
  297. package/dist/services/onboarding/request-cache/asset-key.d.ts +0 -61
  298. package/dist/services/onboarding/request-cache/asset-key.js +0 -115
  299. package/dist/services/onboarding/spec/browser/answer-dialogs.spec.d.ts +0 -1
  300. package/dist/services/onboarding/spec/browser/answer-dialogs.spec.js +0 -66
  301. package/dist/services/onboarding/spec/browser/console-log.spec.d.ts +0 -1
  302. package/dist/services/onboarding/spec/browser/console-log.spec.js +0 -42
  303. package/dist/services/onboarding/spec/browser/resume-restarted-workers.spec.d.ts +0 -1
  304. package/dist/services/onboarding/spec/browser/resume-restarted-workers.spec.js +0 -45
  305. package/dist/services/onboarding/spec/control/browser-session.spec.d.ts +0 -1
  306. package/dist/services/onboarding/spec/control/browser-session.spec.js +0 -753
  307. package/dist/services/onboarding/spec/control/control-server.spec.d.ts +0 -1
  308. package/dist/services/onboarding/spec/control/control-server.spec.js +0 -371
  309. package/dist/services/onboarding/spec/control/debug-session.spec.d.ts +0 -1
  310. package/dist/services/onboarding/spec/control/debug-session.spec.js +0 -751
  311. package/dist/services/onboarding/spec/control/fakes.d.ts +0 -31
  312. package/dist/services/onboarding/spec/control/fakes.js +0 -67
  313. package/dist/services/onboarding/spec/control/fouc.spec.d.ts +0 -1
  314. package/dist/services/onboarding/spec/control/fouc.spec.js +0 -167
  315. package/dist/services/onboarding/spec/control/navigate-wait.spec.d.ts +0 -1
  316. package/dist/services/onboarding/spec/control/navigate-wait.spec.js +0 -47
  317. package/dist/services/onboarding/spec/control/navwalk.spec.d.ts +0 -1
  318. package/dist/services/onboarding/spec/control/navwalk.spec.js +0 -222
  319. package/dist/services/onboarding/spec/control/preload-registry.spec.d.ts +0 -1
  320. package/dist/services/onboarding/spec/control/preload-registry.spec.js +0 -432
  321. package/dist/services/onboarding/spec/control/response-explainer.spec.d.ts +0 -1
  322. package/dist/services/onboarding/spec/control/response-explainer.spec.js +0 -324
  323. package/dist/services/onboarding/spec/control/rum.spec.d.ts +0 -1
  324. package/dist/services/onboarding/spec/control/rum.spec.js +0 -222
  325. package/dist/services/onboarding/spec/control/service-worker-tracker.spec.d.ts +0 -1
  326. package/dist/services/onboarding/spec/control/service-worker-tracker.spec.js +0 -193
  327. package/dist/services/onboarding/spec/control/viewport.spec.d.ts +0 -1
  328. package/dist/services/onboarding/spec/control/viewport.spec.js +0 -200
  329. package/dist/services/onboarding/spec/control/watch.spec.d.ts +0 -1
  330. package/dist/services/onboarding/spec/control/watch.spec.js +0 -187
  331. package/dist/services/onboarding/spec/fetch-event-handler.spec.d.ts +0 -1
  332. package/dist/services/onboarding/spec/fetch-event-handler.spec.js +0 -219
  333. package/dist/services/onboarding/spec/fetch-events/speed-kit-service-worker-js.spec.d.ts +0 -1
  334. package/dist/services/onboarding/spec/fetch-events/speed-kit-service-worker-js.spec.js +0 -41
  335. package/dist/services/onboarding/spec/request-cache/cache.spec.d.ts +0 -1
  336. package/dist/services/onboarding/spec/request-cache/cache.spec.js +0 -107
  337. package/dist/services/onboarding/spec/todo-collector.spec.d.ts +0 -1
  338. package/dist/services/onboarding/spec/todo-collector.spec.js +0 -136
  339. package/dist/services/onboarding/spec/virtual-orestes-app/virtual-orestes-app.spec.d.ts +0 -1
  340. package/dist/services/onboarding/spec/virtual-orestes-app/virtual-orestes-app.spec.js +0 -65
  341. package/dist/services/query-builder/rules/rule-match.d.ts +0 -35
  342. package/dist/services/query-builder/rules/rule-match.js +0 -70
  343. package/dist/services/query-builder/spec/rules/rule-match.spec.d.ts +0 -1
  344. package/dist/services/query-builder/spec/rules/rule-match.spec.js +0 -121
  345. package/dist/services/run-control/browser/run-browser-contexts.d.ts +0 -557
  346. package/dist/services/run-control/browser/run-browser-contexts.js +0 -91
  347. package/dist/services/run-control/browser/run-browser-service-factory.d.ts +0 -5
  348. package/dist/services/run-control/browser/run-browser-service-factory.js +0 -7
  349. package/dist/services/run-control/browser/run-browser-service.d.ts +0 -68
  350. package/dist/services/run-control/browser/run-browser-service.js +0 -206
  351. package/dist/services/run-control/cache/run-cache-contexts.d.ts +0 -349
  352. package/dist/services/run-control/cache/run-cache-contexts.js +0 -51
  353. package/dist/services/run-control/cache/run-cache-service-factory.d.ts +0 -6
  354. package/dist/services/run-control/cache/run-cache-service-factory.js +0 -12
  355. package/dist/services/run-control/cache/run-cache-service.d.ts +0 -35
  356. package/dist/services/run-control/cache/run-cache-service.js +0 -151
  357. package/dist/services/run-control/control-client.d.ts +0 -36
  358. package/dist/services/run-control/control-client.js +0 -147
  359. package/dist/services/run-control/debug/run-debug-contexts.d.ts +0 -416
  360. package/dist/services/run-control/debug/run-debug-contexts.js +0 -47
  361. package/dist/services/run-control/debug/run-debug-service-factory.d.ts +0 -5
  362. package/dist/services/run-control/debug/run-debug-service-factory.js +0 -7
  363. package/dist/services/run-control/debug/run-debug-service.d.ts +0 -39
  364. package/dist/services/run-control/debug/run-debug-service.js +0 -164
  365. package/dist/services/run-control/files/run-files-contexts.d.ts +0 -238
  366. package/dist/services/run-control/files/run-files-contexts.js +0 -26
  367. package/dist/services/run-control/files/run-files-service-factory.d.ts +0 -5
  368. package/dist/services/run-control/files/run-files-service-factory.js +0 -7
  369. package/dist/services/run-control/files/run-files-service.d.ts +0 -29
  370. package/dist/services/run-control/files/run-files-service.js +0 -120
  371. package/dist/services/run-control/index.d.ts +0 -32
  372. package/dist/services/run-control/index.js +0 -31
  373. package/dist/services/run-control/inject/run-inject-contexts.d.ts +0 -319
  374. package/dist/services/run-control/inject/run-inject-contexts.js +0 -38
  375. package/dist/services/run-control/inject/run-inject-service-factory.d.ts +0 -5
  376. package/dist/services/run-control/inject/run-inject-service-factory.js +0 -7
  377. package/dist/services/run-control/inject/run-inject-service.d.ts +0 -31
  378. package/dist/services/run-control/inject/run-inject-service.js +0 -227
  379. package/dist/services/run-control/live-run.d.ts +0 -37
  380. package/dist/services/run-control/live-run.js +0 -56
  381. package/dist/services/run-control/probe/run-probe-contexts.d.ts +0 -333
  382. package/dist/services/run-control/probe/run-probe-contexts.js +0 -73
  383. package/dist/services/run-control/probe/run-probe-service-factory.d.ts +0 -5
  384. package/dist/services/run-control/probe/run-probe-service-factory.js +0 -7
  385. package/dist/services/run-control/probe/run-probe-service.d.ts +0 -54
  386. package/dist/services/run-control/probe/run-probe-service.js +0 -194
  387. package/dist/services/run-control/rum/run-rum-contexts.d.ts +0 -216
  388. package/dist/services/run-control/rum/run-rum-contexts.js +0 -34
  389. package/dist/services/run-control/rum/run-rum-service-factory.d.ts +0 -5
  390. package/dist/services/run-control/rum/run-rum-service-factory.js +0 -7
  391. package/dist/services/run-control/rum/run-rum-service.d.ts +0 -36
  392. package/dist/services/run-control/rum/run-rum-service.js +0 -122
  393. package/dist/services/run-control/run-answer.d.ts +0 -28
  394. package/dist/services/run-control/run-answer.js +0 -58
  395. package/dist/services/run-control/run-control-context.d.ts +0 -102
  396. package/dist/services/run-control/run-control-context.js +0 -36
  397. package/dist/services/run-control/run-control-flags.d.ts +0 -12
  398. package/dist/services/run-control/run-control-flags.js +0 -22
  399. package/dist/services/run-control/run-control-model.d.ts +0 -9
  400. package/dist/services/run-control/run-control-model.js +0 -1
  401. package/dist/services/run-control/run-control-service-factory.d.ts +0 -14
  402. package/dist/services/run-control/run-control-service-factory.js +0 -26
  403. package/dist/services/run-control/session/run-session-contexts.d.ts +0 -25
  404. package/dist/services/run-control/session/run-session-contexts.js +0 -20
  405. package/dist/services/run-control/session/run-session-service-factory.d.ts +0 -8
  406. package/dist/services/run-control/session/run-session-service-factory.js +0 -18
  407. package/dist/services/run-control/session/run-session-service.d.ts +0 -32
  408. package/dist/services/run-control/session/run-session-service.js +0 -151
  409. package/dist/services/run-control/spec/browser/run-browser-service.spec.d.ts +0 -1
  410. package/dist/services/run-control/spec/browser/run-browser-service.spec.js +0 -328
  411. package/dist/services/run-control/spec/cache/run-cache-service.spec.d.ts +0 -1
  412. package/dist/services/run-control/spec/cache/run-cache-service.spec.js +0 -454
  413. package/dist/services/run-control/spec/debug/run-debug-service.spec.d.ts +0 -1
  414. package/dist/services/run-control/spec/debug/run-debug-service.spec.js +0 -113
  415. package/dist/services/run-control/spec/files/run-files-service.spec.d.ts +0 -1
  416. package/dist/services/run-control/spec/files/run-files-service.spec.js +0 -234
  417. package/dist/services/run-control/spec/inject/run-inject-service.spec.d.ts +0 -1
  418. package/dist/services/run-control/spec/inject/run-inject-service.spec.js +0 -251
  419. package/dist/services/run-control/spec/live-run-fixture.d.ts +0 -32
  420. package/dist/services/run-control/spec/live-run-fixture.js +0 -109
  421. package/dist/services/run-control/spec/probe/run-probe-service.spec.d.ts +0 -1
  422. package/dist/services/run-control/spec/probe/run-probe-service.spec.js +0 -108
  423. package/dist/services/run-control/spec/rum/run-rum-service.spec.d.ts +0 -1
  424. package/dist/services/run-control/spec/rum/run-rum-service.spec.js +0 -47
  425. package/dist/services/run-control/spec/run-answer.spec.d.ts +0 -1
  426. package/dist/services/run-control/spec/run-answer.spec.js +0 -57
  427. package/dist/services/run-control/spec/session/run-session-service.spec.d.ts +0 -1
  428. package/dist/services/run-control/spec/session/run-session-service.spec.js +0 -150
  429. package/dist/services/run-log/crash-mirror.d.ts +0 -31
  430. package/dist/services/run-log/crash-mirror.js +0 -69
  431. package/dist/services/run-log/index.d.ts +0 -11
  432. package/dist/services/run-log/index.js +0 -11
  433. package/dist/services/run-log/jsonl-appender.d.ts +0 -46
  434. package/dist/services/run-log/jsonl-appender.js +0 -91
  435. package/dist/services/run-log/log-event-model.d.ts +0 -104
  436. package/dist/services/run-log/log-event-model.js +0 -56
  437. package/dist/services/run-log/log-query-service-factory.d.ts +0 -11
  438. package/dist/services/run-log/log-query-service-factory.js +0 -14
  439. package/dist/services/run-log/log-query-service.d.ts +0 -59
  440. package/dist/services/run-log/log-query-service.js +0 -111
  441. package/dist/services/run-log/log-reader.d.ts +0 -84
  442. package/dist/services/run-log/log-reader.js +0 -180
  443. package/dist/services/run-log/log-summary.d.ts +0 -72
  444. package/dist/services/run-log/log-summary.js +0 -208
  445. package/dist/services/run-log/redaction.d.ts +0 -34
  446. package/dist/services/run-log/redaction.js +0 -124
  447. package/dist/services/run-log/request-log.d.ts +0 -82
  448. package/dist/services/run-log/request-log.js +0 -69
  449. package/dist/services/run-log/request-summary.d.ts +0 -76
  450. package/dist/services/run-log/request-summary.js +0 -0
  451. package/dist/services/run-log/run-log.d.ts +0 -61
  452. package/dist/services/run-log/run-log.js +0 -102
  453. package/dist/services/run-log/spec/log-query-service.spec.d.ts +0 -1
  454. package/dist/services/run-log/spec/log-query-service.spec.js +0 -197
  455. package/dist/services/run-log/spec/log-reader.spec.d.ts +0 -1
  456. package/dist/services/run-log/spec/log-reader.spec.js +0 -109
  457. package/dist/services/run-log/spec/log-summary.spec.d.ts +0 -1
  458. package/dist/services/run-log/spec/log-summary.spec.js +0 -153
  459. package/dist/services/run-log/spec/redaction.spec.d.ts +0 -1
  460. package/dist/services/run-log/spec/redaction.spec.js +0 -61
  461. package/dist/services/run-log/spec/request-log.spec.d.ts +0 -1
  462. package/dist/services/run-log/spec/request-log.spec.js +0 -101
  463. package/dist/services/run-log/spec/request-summary.spec.d.ts +0 -1
  464. package/dist/services/run-log/spec/request-summary.spec.js +0 -171
  465. package/dist/services/run-log/spec/run-log.spec.d.ts +0 -1
  466. package/dist/services/run-log/spec/run-log.spec.js +0 -122
  467. package/dist/services/run-registry/exit-classification.d.ts +0 -39
  468. package/dist/services/run-registry/exit-classification.js +0 -42
  469. package/dist/services/run-registry/index.d.ts +0 -3
  470. package/dist/services/run-registry/index.js +0 -3
  471. package/dist/services/run-registry/process-identity.d.ts +0 -28
  472. package/dist/services/run-registry/process-identity.js +0 -80
  473. package/dist/services/run-registry/run-registry-model.d.ts +0 -128
  474. package/dist/services/run-registry/run-registry-model.js +0 -16
  475. package/dist/services/run-registry/run-registry.d.ts +0 -155
  476. package/dist/services/run-registry/run-registry.js +0 -430
  477. package/dist/services/run-registry/spec/exit-classification.spec.d.ts +0 -1
  478. package/dist/services/run-registry/spec/exit-classification.spec.js +0 -82
  479. package/dist/services/run-registry/spec/run-registry.spec.d.ts +0 -1
  480. package/dist/services/run-registry/spec/run-registry.spec.js +0 -526
  481. /package/dist/{commands/spec/onboarding.spec.d.ts → services/bundler/spec/packjockel-service.spec.d.ts} +0 -0
  482. /package/dist/services/{cli/spec/build-identity.spec.d.ts → deploy/spec/handler/customer-config-handler.spec.d.ts} +0 -0
  483. /package/dist/services/{cli/spec/build-info.spec.d.ts → document-handler-runtime/spec/document-handler-browser-mock.spec.d.ts} +0 -0
  484. /package/dist/services/{cli/spec/cli-service-log.spec.d.ts → integration-api/spec/customer-config-file.spec.d.ts} +0 -0
  485. /package/dist/services/{diff/spec/config-at-ref.spec.d.ts → onboarding/spec/file-events/file-watcher.spec.d.ts} +0 -0
@@ -1,12 +0,0 @@
1
- import { RunControlServiceFactory } from "../run-control-service-factory.js";
2
- import { RunCacheService } from "./run-cache-service.js";
3
- /** Finds the live run a cache op means, and builds the service that asks it. */
4
- export class RunCacheServiceFactory extends RunControlServiceFactory {
5
- buildService() {
6
- return new RunCacheService(
7
- // The bodies outlive the process; the index that maps urls to them does
8
- // not. Saying so is the difference between "look on disk" and "there is
9
- // nothing".
10
- this.deps((dead) => `Run ${dead.meta.id} is ${dead.status}. Its cached bodies are still on disk under ${dead.dir}/dh-cache, but the index that maps urls to them lived in the process, so nothing can look them up.`));
11
- }
12
- }
@@ -1,35 +0,0 @@
1
- import { RunControlServiceDeps } from "../run-control-model.js";
2
- export interface CacheGetInput {
3
- key: string;
4
- variation?: string;
5
- select?: string;
6
- grep?: string;
7
- maxMatches?: number;
8
- }
9
- export interface CachePrewarmInput {
10
- url: string;
11
- variations?: string[];
12
- all?: boolean;
13
- }
14
- /**
15
- * The local documentHandler cache of a live run: the in-memory cache the
16
- * documentHandler fills — not the CDN, and not what the browser rendered.
17
- */
18
- export declare class RunCacheService {
19
- private readonly cli;
20
- private readonly run;
21
- private readonly answer;
22
- constructor(deps: RunControlServiceDeps);
23
- list(): Promise<void>;
24
- /** One entry; the body goes to a file, never to the terminal. */
25
- get(input: CacheGetInput): Promise<void>;
26
- /** Build entries for a url nothing has requested, one per variation. */
27
- prewarm(input: CachePrewarmInput): Promise<void>;
28
- /** Rebuild what is cached and say whether the origin's bytes moved. */
29
- refresh(key?: string): Promise<void>;
30
- /** Drop every entry whose key contains `key`. */
31
- evict(key: string): Promise<void>;
32
- clear(): Promise<void>;
33
- /** What the documentHandler is failing to build right now. */
34
- errors(): Promise<void>;
35
- }
@@ -1,151 +0,0 @@
1
- /** One origin fetch and one transform per variation, so not a question's 5s. */
2
- const BUILD_BUDGET_MS = 120_000;
3
- /**
4
- * The local documentHandler cache of a live run: the in-memory cache the
5
- * documentHandler fills — not the CDN, and not what the browser rendered.
6
- */
7
- export class RunCacheService {
8
- cli;
9
- run;
10
- answer;
11
- constructor(deps) {
12
- this.cli = deps.cli;
13
- this.run = deps.run;
14
- this.answer = deps.answer;
15
- }
16
- async list() {
17
- const { entries } = await this.run.request({
18
- op: "cache.list",
19
- });
20
- this.answer.give(`${entries.length} cached entr${entries.length === 1 ? "y" : "ies"} in ${this.run.id}`, { run: this.run.id, entries }, () => {
21
- if (entries.length === 0) {
22
- return;
23
- }
24
- // Lines, not a table: a table sized to the terminal wraps the url,
25
- // which is the column people read.
26
- const width = Math.max(...entries.map((entry) => (entry.variation ?? "default").length));
27
- for (const entry of entries) {
28
- this.cli.write(`${(entry.variation ?? "default").padEnd(width)} ${entry.status} ${this.cli.style.grey(String(entry.bytes).padStart(8))} ${entry.originUrl}`);
29
- }
30
- });
31
- }
32
- /** One entry; the body goes to a file, never to the terminal. */
33
- async get(input) {
34
- const entry = await this.run.request({
35
- op: "cache.get",
36
- ...input,
37
- });
38
- this.answer.give(summariseEntry(entry), { run: this.run.id, entry }, () => {
39
- this.cli.comment(`key ${entry.key}`);
40
- this.cli.comment(`body ${entry.bodyPath}`);
41
- for (const match of entry.select?.matches ?? []) {
42
- this.cli.write(` ${match}`);
43
- }
44
- for (const match of entry.grep?.matches ?? []) {
45
- this.cli.write(` ${this.cli.style.grey(`${match.line}:`)} ${match.text}`);
46
- }
47
- if (entry.select?.truncated || entry.grep?.truncated) {
48
- this.cli.comment("More matched; raise --max-matches to see them.");
49
- }
50
- });
51
- }
52
- /** Build entries for a url nothing has requested, one per variation. */
53
- async prewarm(input) {
54
- const data = await this.run.request({ op: "cache.prewarm", ...input }, BUILD_BUDGET_MS);
55
- this.answer.give(summarisePrewarm(data), { run: this.run.id, ...data }, () => {
56
- for (const entry of data.entries) {
57
- this.cli.write(` ${entry.variation ?? "default"} ${entry.built ? "built" : "cached"} ${entry.bodyPath}`);
58
- }
59
- for (const failure of data.failed) {
60
- this.cli.writeError(` ${failure.variation} ${failure.error}`);
61
- }
62
- });
63
- }
64
- /** Rebuild what is cached and say whether the origin's bytes moved. */
65
- async refresh(key) {
66
- const data = await this.run.request({ op: "cache.refresh", key }, BUILD_BUDGET_MS);
67
- this.answer.give(summariseRefresh(data), { run: this.run.id, ...data }, () => {
68
- for (const entry of data.entries.filter((one) => one.changed)) {
69
- this.cli.write(` changed ${describe(entry)} ${entry.bodyPath}`);
70
- }
71
- for (const failure of data.failed) {
72
- this.cli.writeError(` ${failure.variation} ${failure.error}`);
73
- }
74
- });
75
- }
76
- /** Drop every entry whose key contains `key`. */
77
- async evict(key) {
78
- const data = await this.run.request({
79
- op: "cache.evict",
80
- key,
81
- });
82
- this.answer.give(`removed ${data.removed.length} entr${data.removed.length === 1 ? "y" : "ies"} matching "${data.key}", ${data.remaining} left`, { run: this.run.id, ...data }, () => {
83
- for (const removed of data.removed) {
84
- this.cli.write(` ${removed}`);
85
- }
86
- });
87
- }
88
- async clear() {
89
- const data = await this.run.request({ op: "cache.clear" });
90
- this.answer.give(`cleared ${data.cleared} entr${data.cleared === 1 ? "y" : "ies"} — the next request for any of them goes to origin`, { run: this.run.id, ...data });
91
- }
92
- /** What the documentHandler is failing to build right now. */
93
- async errors() {
94
- const data = await this.run.request({
95
- op: "cache.errors",
96
- });
97
- this.answer.give(data.errors.length === 0
98
- ? "nothing is currently failing to build"
99
- : `${data.errors.length} url${data.errors.length === 1 ? "" : "s"} the documentHandler could not build`, { run: this.run.id, ...data }, () => {
100
- for (const error of data.errors) {
101
- this.cli.writeError(` ${error.url} (${error.variation})`);
102
- this.cli.comment(` ${error.error}`);
103
- }
104
- });
105
- }
106
- }
107
- function describe(entry) {
108
- return `${entry.originUrl}${entry.variation ? ` (${entry.variation})` : ""}`;
109
- }
110
- /** Leads with whatever was asked about, because that is the answer. */
111
- function summariseEntry(entry) {
112
- const parts = [`${entry.bytes} bytes, ${entry.status}`];
113
- if (entry.select) {
114
- parts.unshift(entry.select.error
115
- ? `selector rejected: ${entry.select.error}`
116
- : `${entry.select.count} × ${entry.select.selector}`);
117
- }
118
- if (entry.grep) {
119
- parts.unshift(entry.grep.error
120
- ? `pattern rejected: ${entry.grep.error}`
121
- : `${entry.grep.count} line${entry.grep.count === 1 ? "" : "s"} match /${entry.grep.pattern}/`);
122
- }
123
- return `${describe(entry)} — ${parts.join(", ")}`;
124
- }
125
- /** Leads with what is now comparable, because that is what it was asked for. */
126
- function summarisePrewarm(data) {
127
- const built = data.entries.filter((entry) => entry.built).length;
128
- const parts = [
129
- `${data.entries.length} entr${data.entries.length === 1 ? "y" : "ies"} for ${data.url}`,
130
- `${built} built, ${data.entries.length - built} already cached`,
131
- ];
132
- if (data.failed.length) {
133
- parts.push(`${data.failed.length} failed: ${data.failed.map((one) => one.variation).join(", ")}`);
134
- }
135
- return parts.join(" — ");
136
- }
137
- /**
138
- * Leads with what changed, because that is the question `refresh` answers:
139
- * not "rebuilt 4 entries", but "the origin moved under one of them".
140
- */
141
- function summariseRefresh(data) {
142
- const parts = [
143
- data.changed === 0
144
- ? `${data.entries.length} rebuilt, none changed — the origin is serving the same bytes`
145
- : `${data.changed} of ${data.entries.length} changed at origin`,
146
- ];
147
- if (data.failed.length) {
148
- parts.push(`${data.failed.length} failed: ${data.failed.map((one) => one.variation).join(", ")}`);
149
- }
150
- return parts.join(" — ");
151
- }
@@ -1,36 +0,0 @@
1
- import { Run } from "../run-registry/index.js";
2
- import { ControlCommand, HelloData } from "../onboarding/control/control-protocol.js";
3
- export declare class ControlError extends Error {
4
- readonly code: string;
5
- readonly detail: Record<string, unknown>;
6
- constructor(code: string, message: string, detail?: Record<string, unknown>);
7
- /**
8
- * The failures of finding a run, in the one shape a command reports.
9
- *
10
- * Anything else is not a failure to reach the run but a bug, and stays what
11
- * it was.
12
- */
13
- static from(error: unknown): ControlError | undefined;
14
- }
15
- /**
16
- * Talks to one live onboarding run over its control socket.
17
- *
18
- * Short-lived by design: connect, ask, close. Nothing is cached between calls,
19
- * because the generation counter exists precisely because state moves
20
- * underneath.
21
- */
22
- export declare class ControlClient {
23
- private readonly socket;
24
- readonly hello: HelloData;
25
- private constructor();
26
- /**
27
- * Connect to a run and complete the handshake.
28
- *
29
- * Refuses when the pid behind the socket is not the pid the run recorded. A
30
- * socket that answers is not proof of liveness — socket files outlive their
31
- * process, and the next thing to bind that path is not necessarily this run.
32
- */
33
- static connectTo(run: Run, timeoutMs?: number): Promise<ControlClient>;
34
- request<T>(op: ControlCommand, timeoutMs?: number): Promise<T>;
35
- close(): void;
36
- }
@@ -1,147 +0,0 @@
1
- import { connect } from "node:net";
2
- import { existsSync } from "node:fs";
3
- import { join } from "node:path";
4
- import { AmbiguousRunError, NoSuchRunError, } from "../run-registry/index.js";
5
- import { CONTROL_PROTOCOL_VERSION, CONTROL_SOCKET, } from "../onboarding/control/control-protocol.js";
6
- /** Long enough for a slow handler, short enough that a stall is reported. */
7
- const DEFAULT_TIMEOUT_MS = 5000;
8
- export class ControlError extends Error {
9
- code;
10
- detail;
11
- constructor(code, message, detail = {}) {
12
- super(message);
13
- this.code = code;
14
- this.detail = detail;
15
- }
16
- /**
17
- * The failures of finding a run, in the one shape a command reports.
18
- *
19
- * Anything else is not a failure to reach the run but a bug, and stays what
20
- * it was.
21
- */
22
- static from(error) {
23
- if (error instanceof ControlError) {
24
- return error;
25
- }
26
- if (error instanceof AmbiguousRunError) {
27
- return new ControlError("AMBIGUOUS_RUN", error.message, {
28
- candidates: error.candidates.map((run) => run.meta.id),
29
- next: "Name one with --run.",
30
- });
31
- }
32
- if (error instanceof NoSuchRunError) {
33
- return new ControlError("NO_SUCH_RUN", error.message, {
34
- next: "`sk onboarding list` shows the recorded runs.",
35
- });
36
- }
37
- return undefined;
38
- }
39
- }
40
- /**
41
- * Talks to one live onboarding run over its control socket.
42
- *
43
- * Short-lived by design: connect, ask, close. Nothing is cached between calls,
44
- * because the generation counter exists precisely because state moves
45
- * underneath.
46
- */
47
- export class ControlClient {
48
- socket;
49
- hello;
50
- constructor(socket, hello) {
51
- this.socket = socket;
52
- this.hello = hello;
53
- }
54
- /**
55
- * Connect to a run and complete the handshake.
56
- *
57
- * Refuses when the pid behind the socket is not the pid the run recorded. A
58
- * socket that answers is not proof of liveness — socket files outlive their
59
- * process, and the next thing to bind that path is not necessarily this run.
60
- */
61
- static async connectTo(run, timeoutMs = DEFAULT_TIMEOUT_MS) {
62
- const path = join(run.dir, CONTROL_SOCKET);
63
- if (!existsSync(path)) {
64
- throw new ControlError("NO_CONTROL_SOCKET", `Run ${run.meta.id} has no control socket. It may predate this feature, or have exited.`, { run: run.meta.id, status: run.status });
65
- }
66
- const socket = await openSocket(path, timeoutMs);
67
- const client = new ControlClient(socket, {
68
- pid: 0,
69
- runId: "",
70
- version: 0,
71
- });
72
- const hello = await client.request({ op: "hello", version: CONTROL_PROTOCOL_VERSION }, timeoutMs);
73
- if (hello.pid !== run.meta.pid) {
74
- socket.destroy();
75
- throw new ControlError("RUN_IDENTITY_MISMATCH", `The socket for ${run.meta.id} answers from pid ${hello.pid}, but the run recorded ${run.meta.pid}.`, { expected: run.meta.pid, actual: hello.pid });
76
- }
77
- return new ControlClient(socket, hello);
78
- }
79
- async request(op, timeoutMs = DEFAULT_TIMEOUT_MS) {
80
- const id = `${Date.now().toString(36)}-${Math.random().toString(36).slice(2, 8)}`;
81
- const frame = `${JSON.stringify({ id, ...op })}\n`;
82
- return new Promise((resolve, reject) => {
83
- let buffer = "";
84
- const timer = setTimeout(() => {
85
- cleanup();
86
- reject(new ControlError("CONTROL_TIMEOUT", `The run did not answer \`${op.op}\` within ${timeoutMs}ms. It may still be working on it.`, { op: op.op, timeoutMs }));
87
- }, timeoutMs);
88
- const onData = (chunk) => {
89
- buffer += chunk.toString();
90
- let newline = buffer.indexOf("\n");
91
- while (newline !== -1) {
92
- const line = buffer.slice(0, newline);
93
- buffer = buffer.slice(newline + 1);
94
- newline = buffer.indexOf("\n");
95
- if (!line.trim()) {
96
- continue;
97
- }
98
- const response = JSON.parse(line);
99
- // Responses for other requests are not ours to consume.
100
- if (response.id !== id) {
101
- continue;
102
- }
103
- cleanup();
104
- if (response.status === "ok") {
105
- resolve(response.data);
106
- }
107
- else {
108
- reject(new ControlError(response.error.code, response.error.message, response.error));
109
- }
110
- return;
111
- }
112
- };
113
- const onClose = () => {
114
- cleanup();
115
- reject(new ControlError("CONTROL_CLOSED", "The run closed the connection before answering.", { op: op.op }));
116
- };
117
- const cleanup = () => {
118
- clearTimeout(timer);
119
- this.socket.off("data", onData);
120
- this.socket.off("close", onClose);
121
- };
122
- this.socket.on("data", onData);
123
- this.socket.once("close", onClose);
124
- this.socket.write(frame);
125
- });
126
- }
127
- close() {
128
- this.socket.destroy();
129
- }
130
- }
131
- function openSocket(path, timeoutMs) {
132
- return new Promise((resolve, reject) => {
133
- const socket = connect(path);
134
- const timer = setTimeout(() => {
135
- socket.destroy();
136
- reject(new ControlError("CONTROL_TIMEOUT", `Could not reach the run's control socket within ${timeoutMs}ms.`, { path }));
137
- }, timeoutMs);
138
- socket.once("connect", () => {
139
- clearTimeout(timer);
140
- resolve(socket);
141
- });
142
- socket.once("error", (error) => {
143
- clearTimeout(timer);
144
- reject(new ControlError("CONTROL_UNREACHABLE", error.message, { path }));
145
- });
146
- });
147
- }