@marinoscar/platform-cli 0.1.0-next.3 → 0.1.0-next.31

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 (943) hide show
  1. package/CHANGELOG.md +365 -0
  2. package/README.md +163 -31
  3. package/dist/android/build.d.ts +30 -0
  4. package/dist/android/build.d.ts.map +1 -0
  5. package/dist/android/build.js +126 -0
  6. package/dist/android/build.js.map +1 -0
  7. package/dist/android/command.d.ts +21 -0
  8. package/dist/android/command.d.ts.map +1 -0
  9. package/dist/android/command.js +355 -0
  10. package/dist/android/command.js.map +1 -0
  11. package/dist/android/deploy-step.d.ts +85 -0
  12. package/dist/android/deploy-step.d.ts.map +1 -0
  13. package/dist/android/deploy-step.js +268 -0
  14. package/dist/android/deploy-step.js.map +1 -0
  15. package/dist/android/doctor.d.ts +47 -0
  16. package/dist/android/doctor.d.ts.map +1 -0
  17. package/dist/android/doctor.js +219 -0
  18. package/dist/android/doctor.js.map +1 -0
  19. package/dist/android/exec.d.ts +42 -0
  20. package/dist/android/exec.d.ts.map +1 -0
  21. package/dist/android/exec.js +103 -0
  22. package/dist/android/exec.js.map +1 -0
  23. package/dist/android/fix-plan.d.ts +44 -0
  24. package/dist/android/fix-plan.d.ts.map +1 -0
  25. package/dist/android/fix-plan.js +86 -0
  26. package/dist/android/fix-plan.js.map +1 -0
  27. package/dist/android/git-freshness.d.ts +34 -0
  28. package/dist/android/git-freshness.d.ts.map +1 -0
  29. package/dist/android/git-freshness.js +120 -0
  30. package/dist/android/git-freshness.js.map +1 -0
  31. package/dist/android/gradle.d.ts +32 -0
  32. package/dist/android/gradle.d.ts.map +1 -0
  33. package/dist/android/gradle.js +55 -0
  34. package/dist/android/gradle.js.map +1 -0
  35. package/dist/android/identity.d.ts +27 -0
  36. package/dist/android/identity.d.ts.map +1 -0
  37. package/dist/android/identity.js +60 -0
  38. package/dist/android/identity.js.map +1 -0
  39. package/dist/android/index.d.ts +7 -0
  40. package/dist/android/index.d.ts.map +1 -0
  41. package/dist/android/index.js +8 -0
  42. package/dist/android/index.js.map +1 -0
  43. package/dist/android/installer.d.ts +28 -0
  44. package/dist/android/installer.d.ts.map +1 -0
  45. package/dist/android/installer.js +96 -0
  46. package/dist/android/installer.js.map +1 -0
  47. package/dist/android/java.d.ts +26 -0
  48. package/dist/android/java.d.ts.map +1 -0
  49. package/dist/android/java.js +65 -0
  50. package/dist/android/java.js.map +1 -0
  51. package/dist/android/keystore.d.ts +54 -0
  52. package/dist/android/keystore.d.ts.map +1 -0
  53. package/dist/android/keystore.js +159 -0
  54. package/dist/android/keystore.js.map +1 -0
  55. package/dist/android/metadata.d.ts +39 -0
  56. package/dist/android/metadata.d.ts.map +1 -0
  57. package/dist/android/metadata.js +61 -0
  58. package/dist/android/metadata.js.map +1 -0
  59. package/dist/android/operations.d.ts +42 -0
  60. package/dist/android/operations.d.ts.map +1 -0
  61. package/dist/android/operations.js +59 -0
  62. package/dist/android/operations.js.map +1 -0
  63. package/dist/android/paths.d.ts +29 -0
  64. package/dist/android/paths.d.ts.map +1 -0
  65. package/dist/android/paths.js +97 -0
  66. package/dist/android/paths.js.map +1 -0
  67. package/dist/android/publish.d.ts +37 -0
  68. package/dist/android/publish.d.ts.map +1 -0
  69. package/dist/android/publish.js +119 -0
  70. package/dist/android/publish.js.map +1 -0
  71. package/dist/android/registrations.d.ts +92 -0
  72. package/dist/android/registrations.d.ts.map +1 -0
  73. package/dist/android/registrations.js +112 -0
  74. package/dist/android/registrations.js.map +1 -0
  75. package/dist/android/release-status.d.ts +73 -0
  76. package/dist/android/release-status.d.ts.map +1 -0
  77. package/dist/android/release-status.js +161 -0
  78. package/dist/android/release-status.js.map +1 -0
  79. package/dist/android/release.d.ts +33 -0
  80. package/dist/android/release.d.ts.map +1 -0
  81. package/dist/android/release.js +59 -0
  82. package/dist/android/release.js.map +1 -0
  83. package/dist/android/screen-layout.d.ts +26 -0
  84. package/dist/android/screen-layout.d.ts.map +1 -0
  85. package/dist/android/screen-layout.js +24 -0
  86. package/dist/android/screen-layout.js.map +1 -0
  87. package/dist/android/screen-model.d.ts +56 -0
  88. package/dist/android/screen-model.d.ts.map +1 -0
  89. package/dist/android/screen-model.js +207 -0
  90. package/dist/android/screen-model.js.map +1 -0
  91. package/dist/android/screen.d.ts +8 -0
  92. package/dist/android/screen.d.ts.map +1 -0
  93. package/dist/android/screen.js +395 -0
  94. package/dist/android/screen.js.map +1 -0
  95. package/dist/android/sdk.d.ts +48 -0
  96. package/dist/android/sdk.d.ts.map +1 -0
  97. package/dist/android/sdk.js +82 -0
  98. package/dist/android/sdk.js.map +1 -0
  99. package/dist/android/server-url.d.ts +19 -0
  100. package/dist/android/server-url.d.ts.map +1 -0
  101. package/dist/android/server-url.js +36 -0
  102. package/dist/android/server-url.js.map +1 -0
  103. package/dist/android/upload-progress.d.ts +3 -0
  104. package/dist/android/upload-progress.d.ts.map +1 -0
  105. package/dist/android/upload-progress.js +47 -0
  106. package/dist/android/upload-progress.js.map +1 -0
  107. package/dist/android/version.d.ts +47 -0
  108. package/dist/android/version.d.ts.map +1 -0
  109. package/dist/android/version.js +136 -0
  110. package/dist/android/version.js.map +1 -0
  111. package/dist/api-client/index.d.ts +3 -0
  112. package/dist/api-client/index.d.ts.map +1 -0
  113. package/dist/api-client/index.js +5 -0
  114. package/dist/api-client/index.js.map +1 -0
  115. package/dist/commands/index.d.ts +52 -0
  116. package/dist/commands/index.d.ts.map +1 -0
  117. package/dist/commands/index.js +63 -0
  118. package/dist/commands/index.js.map +1 -0
  119. package/dist/core/cli-registry.d.ts +41 -0
  120. package/dist/core/cli-registry.d.ts.map +1 -0
  121. package/dist/core/cli-registry.js +49 -0
  122. package/dist/core/cli-registry.js.map +1 -0
  123. package/dist/core/command-registry.d.ts +10 -0
  124. package/dist/core/command-registry.d.ts.map +1 -1
  125. package/dist/core/command-registry.js +17 -0
  126. package/dist/core/command-registry.js.map +1 -1
  127. package/dist/core/env-annotation-registry.d.ts +58 -0
  128. package/dist/core/env-annotation-registry.d.ts.map +1 -0
  129. package/dist/core/env-annotation-registry.js +80 -0
  130. package/dist/core/env-annotation-registry.js.map +1 -0
  131. package/dist/core/env-generator-registry.d.ts +59 -0
  132. package/dist/core/env-generator-registry.d.ts.map +1 -0
  133. package/dist/core/env-generator-registry.js +102 -0
  134. package/dist/core/env-generator-registry.js.map +1 -0
  135. package/dist/core/env-group-registry.d.ts +65 -0
  136. package/dist/core/env-group-registry.d.ts.map +1 -0
  137. package/dist/core/env-group-registry.js +77 -0
  138. package/dist/core/env-group-registry.js.map +1 -0
  139. package/dist/core/env-spec-registry.d.ts +16 -2
  140. package/dist/core/env-spec-registry.d.ts.map +1 -1
  141. package/dist/core/env-spec-registry.js +15 -0
  142. package/dist/core/env-spec-registry.js.map +1 -1
  143. package/dist/core/env-values.d.ts +3 -2
  144. package/dist/core/env-values.d.ts.map +1 -1
  145. package/dist/core/env-values.js +5 -3
  146. package/dist/core/env-values.js.map +1 -1
  147. package/dist/core/index.d.ts +10 -2
  148. package/dist/core/index.d.ts.map +1 -1
  149. package/dist/core/index.js +6 -2
  150. package/dist/core/index.js.map +1 -1
  151. package/dist/deploy/index.d.ts +3 -0
  152. package/dist/deploy/index.d.ts.map +1 -0
  153. package/dist/deploy/index.js +5 -0
  154. package/dist/deploy/index.js.map +1 -0
  155. package/dist/engine/api-client.d.ts +211 -0
  156. package/dist/engine/api-client.d.ts.map +1 -0
  157. package/dist/engine/api-client.js +350 -0
  158. package/dist/engine/api-client.js.map +1 -0
  159. package/dist/engine/browser.d.ts +18 -0
  160. package/dist/engine/browser.d.ts.map +1 -0
  161. package/dist/engine/browser.js +115 -0
  162. package/dist/engine/browser.js.map +1 -0
  163. package/dist/engine/builtin-registrations.d.ts +20 -0
  164. package/dist/engine/builtin-registrations.d.ts.map +1 -0
  165. package/dist/engine/builtin-registrations.js +86 -0
  166. package/dist/engine/builtin-registrations.js.map +1 -0
  167. package/dist/engine/commands/api.d.ts +88 -0
  168. package/dist/engine/commands/api.d.ts.map +1 -0
  169. package/dist/engine/commands/api.js +398 -0
  170. package/dist/engine/commands/api.js.map +1 -0
  171. package/dist/engine/commands/config.d.ts +5 -0
  172. package/dist/engine/commands/config.d.ts.map +1 -0
  173. package/dist/engine/commands/config.js +83 -0
  174. package/dist/engine/commands/config.js.map +1 -0
  175. package/dist/engine/commands/deploy.d.ts +250 -0
  176. package/dist/engine/commands/deploy.d.ts.map +1 -0
  177. package/dist/engine/commands/deploy.js +1186 -0
  178. package/dist/engine/commands/deploy.js.map +1 -0
  179. package/dist/engine/commands/init.d.ts +18 -0
  180. package/dist/engine/commands/init.d.ts.map +1 -0
  181. package/dist/engine/commands/init.js +50 -0
  182. package/dist/engine/commands/init.js.map +1 -0
  183. package/dist/engine/commands/login.d.ts +4 -0
  184. package/dist/engine/commands/login.d.ts.map +1 -0
  185. package/dist/engine/commands/login.js +205 -0
  186. package/dist/engine/commands/login.js.map +1 -0
  187. package/dist/engine/commands/node.d.ts +21 -0
  188. package/dist/engine/commands/node.d.ts.map +1 -0
  189. package/dist/engine/commands/node.js +503 -0
  190. package/dist/engine/commands/node.js.map +1 -0
  191. package/dist/engine/config.d.ts +284 -0
  192. package/dist/engine/config.d.ts.map +1 -0
  193. package/dist/engine/config.js +469 -0
  194. package/dist/engine/config.js.map +1 -0
  195. package/dist/engine/conformance.d.ts +193 -0
  196. package/dist/engine/conformance.d.ts.map +1 -0
  197. package/dist/engine/conformance.js +243 -0
  198. package/dist/engine/conformance.js.map +1 -0
  199. package/dist/engine/create-cli.d.ts +181 -0
  200. package/dist/engine/create-cli.d.ts.map +1 -0
  201. package/dist/engine/create-cli.js +91 -0
  202. package/dist/engine/create-cli.js.map +1 -0
  203. package/dist/engine/deploy/about.d.ts +12 -0
  204. package/dist/engine/deploy/about.d.ts.map +1 -0
  205. package/dist/engine/deploy/about.js +110 -0
  206. package/dist/engine/deploy/about.js.map +1 -0
  207. package/dist/engine/deploy/adopt.d.ts +21 -0
  208. package/dist/engine/deploy/adopt.d.ts.map +1 -0
  209. package/dist/engine/deploy/adopt.js +78 -0
  210. package/dist/engine/deploy/adopt.js.map +1 -0
  211. package/dist/engine/deploy/answers-file.d.ts +7 -0
  212. package/dist/engine/deploy/answers-file.d.ts.map +1 -0
  213. package/dist/engine/deploy/answers-file.js +49 -0
  214. package/dist/engine/deploy/answers-file.js.map +1 -0
  215. package/dist/engine/deploy/app-role.d.ts +278 -0
  216. package/dist/engine/deploy/app-role.d.ts.map +1 -0
  217. package/dist/engine/deploy/app-role.js +826 -0
  218. package/dist/engine/deploy/app-role.js.map +1 -0
  219. package/dist/engine/deploy/app-version.d.ts +103 -0
  220. package/dist/engine/deploy/app-version.d.ts.map +1 -0
  221. package/dist/engine/deploy/app-version.js +344 -0
  222. package/dist/engine/deploy/app-version.js.map +1 -0
  223. package/dist/engine/deploy/checks/compose.d.ts +16 -0
  224. package/dist/engine/deploy/checks/compose.d.ts.map +1 -0
  225. package/dist/engine/deploy/checks/compose.js +149 -0
  226. package/dist/engine/deploy/checks/compose.js.map +1 -0
  227. package/dist/engine/deploy/checks/database.d.ts +83 -0
  228. package/dist/engine/deploy/checks/database.d.ts.map +1 -0
  229. package/dist/engine/deploy/checks/database.js +455 -0
  230. package/dist/engine/deploy/checks/database.js.map +1 -0
  231. package/dist/engine/deploy/checks/dns.d.ts +3 -0
  232. package/dist/engine/deploy/checks/dns.d.ts.map +1 -0
  233. package/dist/engine/deploy/checks/dns.js +85 -0
  234. package/dist/engine/deploy/checks/dns.js.map +1 -0
  235. package/dist/engine/deploy/checks/host.d.ts +19 -0
  236. package/dist/engine/deploy/checks/host.d.ts.map +1 -0
  237. package/dist/engine/deploy/checks/host.js +543 -0
  238. package/dist/engine/deploy/checks/host.js.map +1 -0
  239. package/dist/engine/deploy/checks/index.d.ts +35 -0
  240. package/dist/engine/deploy/checks/index.d.ts.map +1 -0
  241. package/dist/engine/deploy/checks/index.js +75 -0
  242. package/dist/engine/deploy/checks/index.js.map +1 -0
  243. package/dist/engine/deploy/checks/registry.d.ts +110 -0
  244. package/dist/engine/deploy/checks/registry.d.ts.map +1 -0
  245. package/dist/engine/deploy/checks/registry.js +104 -0
  246. package/dist/engine/deploy/checks/registry.js.map +1 -0
  247. package/dist/engine/deploy/checks/source.d.ts +45 -0
  248. package/dist/engine/deploy/checks/source.d.ts.map +1 -0
  249. package/dist/engine/deploy/checks/source.js +175 -0
  250. package/dist/engine/deploy/checks/source.js.map +1 -0
  251. package/dist/engine/deploy/checks/stack-ports.d.ts +4 -0
  252. package/dist/engine/deploy/checks/stack-ports.d.ts.map +1 -0
  253. package/dist/engine/deploy/checks/stack-ports.js +261 -0
  254. package/dist/engine/deploy/checks/stack-ports.js.map +1 -0
  255. package/dist/engine/deploy/checks/tls.d.ts +87 -0
  256. package/dist/engine/deploy/checks/tls.d.ts.map +1 -0
  257. package/dist/engine/deploy/checks/tls.js +552 -0
  258. package/dist/engine/deploy/checks/tls.js.map +1 -0
  259. package/dist/engine/deploy/checks/types.d.ts +202 -0
  260. package/dist/engine/deploy/checks/types.d.ts.map +1 -0
  261. package/dist/engine/deploy/checks/types.js +199 -0
  262. package/dist/engine/deploy/checks/types.js.map +1 -0
  263. package/dist/engine/deploy/compose-command.d.ts +16 -0
  264. package/dist/engine/deploy/compose-command.d.ts.map +1 -0
  265. package/dist/engine/deploy/compose-command.js +40 -0
  266. package/dist/engine/deploy/compose-command.js.map +1 -0
  267. package/dist/engine/deploy/compose-containers.d.ts +101 -0
  268. package/dist/engine/deploy/compose-containers.d.ts.map +1 -0
  269. package/dist/engine/deploy/compose-containers.js +191 -0
  270. package/dist/engine/deploy/compose-containers.js.map +1 -0
  271. package/dist/engine/deploy/compose-files.d.ts +29 -0
  272. package/dist/engine/deploy/compose-files.d.ts.map +1 -0
  273. package/dist/engine/deploy/compose-files.js +118 -0
  274. package/dist/engine/deploy/compose-files.js.map +1 -0
  275. package/dist/engine/deploy/compose-hints.d.ts +11 -0
  276. package/dist/engine/deploy/compose-hints.d.ts.map +1 -0
  277. package/dist/engine/deploy/compose-hints.js +70 -0
  278. package/dist/engine/deploy/compose-hints.js.map +1 -0
  279. package/dist/engine/deploy/compose-port-variables.d.ts +58 -0
  280. package/dist/engine/deploy/compose-port-variables.d.ts.map +1 -0
  281. package/dist/engine/deploy/compose-port-variables.js +184 -0
  282. package/dist/engine/deploy/compose-port-variables.js.map +1 -0
  283. package/dist/engine/deploy/compose-ports.d.ts +98 -0
  284. package/dist/engine/deploy/compose-ports.d.ts.map +1 -0
  285. package/dist/engine/deploy/compose-ports.js +204 -0
  286. package/dist/engine/deploy/compose-ports.js.map +1 -0
  287. package/dist/engine/deploy/compose-project.d.ts +113 -0
  288. package/dist/engine/deploy/compose-project.d.ts.map +1 -0
  289. package/dist/engine/deploy/compose-project.js +177 -0
  290. package/dist/engine/deploy/compose-project.js.map +1 -0
  291. package/dist/engine/deploy/consent.d.ts +29 -0
  292. package/dist/engine/deploy/consent.d.ts.map +1 -0
  293. package/dist/engine/deploy/consent.js +35 -0
  294. package/dist/engine/deploy/consent.js.map +1 -0
  295. package/dist/engine/deploy/database-drop.d.ts +22 -0
  296. package/dist/engine/deploy/database-drop.d.ts.map +1 -0
  297. package/dist/engine/deploy/database-drop.js +135 -0
  298. package/dist/engine/deploy/database-drop.js.map +1 -0
  299. package/dist/engine/deploy/database.d.ts +116 -0
  300. package/dist/engine/deploy/database.d.ts.map +1 -0
  301. package/dist/engine/deploy/database.js +252 -0
  302. package/dist/engine/deploy/database.js.map +1 -0
  303. package/dist/engine/deploy/deploy-info.d.ts +48 -0
  304. package/dist/engine/deploy/deploy-info.d.ts.map +1 -0
  305. package/dist/engine/deploy/deploy-info.js +163 -0
  306. package/dist/engine/deploy/deploy-info.js.map +1 -0
  307. package/dist/engine/deploy/deployment-evidence.d.ts +38 -0
  308. package/dist/engine/deploy/deployment-evidence.d.ts.map +1 -0
  309. package/dist/engine/deploy/deployment-evidence.js +92 -0
  310. package/dist/engine/deploy/deployment-evidence.js.map +1 -0
  311. package/dist/engine/deploy/edge-config.d.ts +103 -0
  312. package/dist/engine/deploy/edge-config.d.ts.map +1 -0
  313. package/dist/engine/deploy/edge-config.js +170 -0
  314. package/dist/engine/deploy/edge-config.js.map +1 -0
  315. package/dist/engine/deploy/env-absence.d.ts +61 -0
  316. package/dist/engine/deploy/env-absence.d.ts.map +1 -0
  317. package/dist/engine/deploy/env-absence.js +33 -0
  318. package/dist/engine/deploy/env-absence.js.map +1 -0
  319. package/dist/engine/deploy/env-file.d.ts +14 -0
  320. package/dist/engine/deploy/env-file.d.ts.map +1 -0
  321. package/dist/engine/deploy/env-file.js +58 -0
  322. package/dist/engine/deploy/env-file.js.map +1 -0
  323. package/dist/engine/deploy/env-fragments.d.ts +29 -0
  324. package/dist/engine/deploy/env-fragments.d.ts.map +1 -0
  325. package/dist/engine/deploy/env-fragments.js +73 -0
  326. package/dist/engine/deploy/env-fragments.js.map +1 -0
  327. package/dist/engine/deploy/env-metadata.d.ts +73 -0
  328. package/dist/engine/deploy/env-metadata.d.ts.map +1 -0
  329. package/dist/engine/deploy/env-metadata.js +227 -0
  330. package/dist/engine/deploy/env-metadata.js.map +1 -0
  331. package/dist/engine/deploy/env-spec.d.ts +75 -0
  332. package/dist/engine/deploy/env-spec.d.ts.map +1 -0
  333. package/dist/engine/deploy/env-spec.js +239 -0
  334. package/dist/engine/deploy/env-spec.js.map +1 -0
  335. package/dist/engine/deploy/env-wizard.d.ts +56 -0
  336. package/dist/engine/deploy/env-wizard.d.ts.map +1 -0
  337. package/dist/engine/deploy/env-wizard.js +235 -0
  338. package/dist/engine/deploy/env-wizard.js.map +1 -0
  339. package/dist/engine/deploy/executor.d.ts +81 -0
  340. package/dist/engine/deploy/executor.d.ts.map +1 -0
  341. package/dist/engine/deploy/executor.js +247 -0
  342. package/dist/engine/deploy/executor.js.map +1 -0
  343. package/dist/engine/deploy/free-ports.d.ts +145 -0
  344. package/dist/engine/deploy/free-ports.d.ts.map +1 -0
  345. package/dist/engine/deploy/free-ports.js +235 -0
  346. package/dist/engine/deploy/free-ports.js.map +1 -0
  347. package/dist/engine/deploy/health.d.ts +153 -0
  348. package/dist/engine/deploy/health.d.ts.map +1 -0
  349. package/dist/engine/deploy/health.js +335 -0
  350. package/dist/engine/deploy/health.js.map +1 -0
  351. package/dist/engine/deploy/hooks.d.ts +66 -0
  352. package/dist/engine/deploy/hooks.d.ts.map +1 -0
  353. package/dist/engine/deploy/hooks.js +19 -0
  354. package/dist/engine/deploy/hooks.js.map +1 -0
  355. package/dist/engine/deploy/host-facts.d.ts +23 -0
  356. package/dist/engine/deploy/host-facts.d.ts.map +1 -0
  357. package/dist/engine/deploy/host-facts.js +67 -0
  358. package/dist/engine/deploy/host-facts.js.map +1 -0
  359. package/dist/engine/deploy/install.d.ts +239 -0
  360. package/dist/engine/deploy/install.d.ts.map +1 -0
  361. package/dist/engine/deploy/install.js +1474 -0
  362. package/dist/engine/deploy/install.js.map +1 -0
  363. package/dist/engine/deploy/inventory.d.ts +30 -0
  364. package/dist/engine/deploy/inventory.d.ts.map +1 -0
  365. package/dist/engine/deploy/inventory.js +122 -0
  366. package/dist/engine/deploy/inventory.js.map +1 -0
  367. package/dist/engine/deploy/journal.d.ts +77 -0
  368. package/dist/engine/deploy/journal.d.ts.map +1 -0
  369. package/dist/engine/deploy/journal.js +221 -0
  370. package/dist/engine/deploy/journal.js.map +1 -0
  371. package/dist/engine/deploy/layout.d.ts +77 -0
  372. package/dist/engine/deploy/layout.d.ts.map +1 -0
  373. package/dist/engine/deploy/layout.js +191 -0
  374. package/dist/engine/deploy/layout.js.map +1 -0
  375. package/dist/engine/deploy/oauth-check.d.ts +58 -0
  376. package/dist/engine/deploy/oauth-check.d.ts.map +1 -0
  377. package/dist/engine/deploy/oauth-check.js +213 -0
  378. package/dist/engine/deploy/oauth-check.js.map +1 -0
  379. package/dist/engine/deploy/proxy-bootstrap.d.ts +149 -0
  380. package/dist/engine/deploy/proxy-bootstrap.d.ts.map +1 -0
  381. package/dist/engine/deploy/proxy-bootstrap.js +416 -0
  382. package/dist/engine/deploy/proxy-bootstrap.js.map +1 -0
  383. package/dist/engine/deploy/proxy-streams.d.ts +110 -0
  384. package/dist/engine/deploy/proxy-streams.d.ts.map +1 -0
  385. package/dist/engine/deploy/proxy-streams.js +208 -0
  386. package/dist/engine/deploy/proxy-streams.js.map +1 -0
  387. package/dist/engine/deploy/proxy.d.ts +375 -0
  388. package/dist/engine/deploy/proxy.d.ts.map +1 -0
  389. package/dist/engine/deploy/proxy.js +758 -0
  390. package/dist/engine/deploy/proxy.js.map +1 -0
  391. package/dist/engine/deploy/renewal.d.ts +54 -0
  392. package/dist/engine/deploy/renewal.d.ts.map +1 -0
  393. package/dist/engine/deploy/renewal.js +169 -0
  394. package/dist/engine/deploy/renewal.js.map +1 -0
  395. package/dist/engine/deploy/repo.d.ts +119 -0
  396. package/dist/engine/deploy/repo.d.ts.map +1 -0
  397. package/dist/engine/deploy/repo.js +282 -0
  398. package/dist/engine/deploy/repo.js.map +1 -0
  399. package/dist/engine/deploy/run-record.d.ts +28 -0
  400. package/dist/engine/deploy/run-record.d.ts.map +1 -0
  401. package/dist/engine/deploy/run-record.js +44 -0
  402. package/dist/engine/deploy/run-record.js.map +1 -0
  403. package/dist/engine/deploy/stack-ports-gate.d.ts +19 -0
  404. package/dist/engine/deploy/stack-ports-gate.d.ts.map +1 -0
  405. package/dist/engine/deploy/stack-ports-gate.js +54 -0
  406. package/dist/engine/deploy/stack-ports-gate.js.map +1 -0
  407. package/dist/engine/deploy/state.d.ts +289 -0
  408. package/dist/engine/deploy/state.d.ts.map +1 -0
  409. package/dist/engine/deploy/state.js +163 -0
  410. package/dist/engine/deploy/state.js.map +1 -0
  411. package/dist/engine/deploy/steps/app-step-context.d.ts +24 -0
  412. package/dist/engine/deploy/steps/app-step-context.d.ts.map +1 -0
  413. package/dist/engine/deploy/steps/app-step-context.js +45 -0
  414. package/dist/engine/deploy/steps/app-step-context.js.map +1 -0
  415. package/dist/engine/deploy/steps/pipeline.d.ts +46 -0
  416. package/dist/engine/deploy/steps/pipeline.d.ts.map +1 -0
  417. package/dist/engine/deploy/steps/pipeline.js +73 -0
  418. package/dist/engine/deploy/steps/pipeline.js.map +1 -0
  419. package/dist/engine/deploy/steps/plan.d.ts +28 -0
  420. package/dist/engine/deploy/steps/plan.d.ts.map +1 -0
  421. package/dist/engine/deploy/steps/plan.js +32 -0
  422. package/dist/engine/deploy/steps/plan.js.map +1 -0
  423. package/dist/engine/deploy/steps/registry.d.ts +182 -0
  424. package/dist/engine/deploy/steps/registry.d.ts.map +1 -0
  425. package/dist/engine/deploy/steps/registry.js +214 -0
  426. package/dist/engine/deploy/steps/registry.js.map +1 -0
  427. package/dist/engine/deploy/steps/step-values.d.ts +28 -0
  428. package/dist/engine/deploy/steps/step-values.d.ts.map +1 -0
  429. package/dist/engine/deploy/steps/step-values.js +33 -0
  430. package/dist/engine/deploy/steps/step-values.js.map +1 -0
  431. package/dist/engine/deploy/testing/fake-containers.d.ts +29 -0
  432. package/dist/engine/deploy/testing/fake-containers.d.ts.map +1 -0
  433. package/dist/engine/deploy/testing/fake-containers.js +32 -0
  434. package/dist/engine/deploy/testing/fake-containers.js.map +1 -0
  435. package/dist/engine/deploy/testing/fake-postgres.d.ts +88 -0
  436. package/dist/engine/deploy/testing/fake-postgres.d.ts.map +1 -0
  437. package/dist/engine/deploy/testing/fake-postgres.js +236 -0
  438. package/dist/engine/deploy/testing/fake-postgres.js.map +1 -0
  439. package/dist/engine/deploy/testing/fake-vps.d.ts +147 -0
  440. package/dist/engine/deploy/testing/fake-vps.d.ts.map +1 -0
  441. package/dist/engine/deploy/testing/fake-vps.js +371 -0
  442. package/dist/engine/deploy/testing/fake-vps.js.map +1 -0
  443. package/dist/engine/deploy/uninstall.d.ts +87 -0
  444. package/dist/engine/deploy/uninstall.d.ts.map +1 -0
  445. package/dist/engine/deploy/uninstall.js +321 -0
  446. package/dist/engine/deploy/uninstall.js.map +1 -0
  447. package/dist/engine/deploy/update.d.ts +114 -0
  448. package/dist/engine/deploy/update.d.ts.map +1 -0
  449. package/dist/engine/deploy/update.js +1385 -0
  450. package/dist/engine/deploy/update.js.map +1 -0
  451. package/dist/engine/deploy/version-step.d.ts +74 -0
  452. package/dist/engine/deploy/version-step.d.ts.map +1 -0
  453. package/dist/engine/deploy/version-step.js +177 -0
  454. package/dist/engine/deploy/version-step.js.map +1 -0
  455. package/dist/engine/device-auth.d.ts +240 -0
  456. package/dist/engine/device-auth.d.ts.map +1 -0
  457. package/dist/engine/device-auth.js +442 -0
  458. package/dist/engine/device-auth.js.map +1 -0
  459. package/dist/engine/device-login.d.ts +126 -0
  460. package/dist/engine/device-login.d.ts.map +1 -0
  461. package/dist/engine/device-login.js +164 -0
  462. package/dist/engine/device-login.js.map +1 -0
  463. package/dist/engine/errors.d.ts +314 -0
  464. package/dist/engine/errors.d.ts.map +1 -0
  465. package/dist/engine/errors.js +561 -0
  466. package/dist/engine/errors.js.map +1 -0
  467. package/dist/engine/github-raw-manifest.d.ts +59 -0
  468. package/dist/engine/github-raw-manifest.d.ts.map +1 -0
  469. package/dist/engine/github-raw-manifest.js +197 -0
  470. package/dist/engine/github-raw-manifest.js.map +1 -0
  471. package/dist/engine/identity.d.ts +169 -0
  472. package/dist/engine/identity.d.ts.map +1 -0
  473. package/dist/engine/identity.js +227 -0
  474. package/dist/engine/identity.js.map +1 -0
  475. package/dist/engine/index.d.ts +141 -0
  476. package/dist/engine/index.d.ts.map +1 -0
  477. package/dist/engine/index.js +147 -0
  478. package/dist/engine/index.js.map +1 -0
  479. package/dist/engine/init/local-profile.d.ts +93 -0
  480. package/dist/engine/init/local-profile.d.ts.map +1 -0
  481. package/dist/engine/init/local-profile.js +295 -0
  482. package/dist/engine/init/local-profile.js.map +1 -0
  483. package/dist/engine/init/run-init.d.ts +41 -0
  484. package/dist/engine/init/run-init.d.ts.map +1 -0
  485. package/dist/engine/init/run-init.js +297 -0
  486. package/dist/engine/init/run-init.js.map +1 -0
  487. package/dist/engine/node/capabilities.d.ts +433 -0
  488. package/dist/engine/node/capabilities.d.ts.map +1 -0
  489. package/dist/engine/node/capabilities.js +597 -0
  490. package/dist/engine/node/capabilities.js.map +1 -0
  491. package/dist/engine/node/daemon-channels.d.ts +66 -0
  492. package/dist/engine/node/daemon-channels.d.ts.map +1 -0
  493. package/dist/engine/node/daemon-channels.js +65 -0
  494. package/dist/engine/node/daemon-channels.js.map +1 -0
  495. package/dist/engine/node/daemon.d.ts +63 -0
  496. package/dist/engine/node/daemon.d.ts.map +1 -0
  497. package/dist/engine/node/daemon.js +279 -0
  498. package/dist/engine/node/daemon.js.map +1 -0
  499. package/dist/engine/node/doctor.d.ts +60 -0
  500. package/dist/engine/node/doctor.d.ts.map +1 -0
  501. package/dist/engine/node/doctor.js +447 -0
  502. package/dist/engine/node/doctor.js.map +1 -0
  503. package/dist/engine/node/enrollment.d.ts +98 -0
  504. package/dist/engine/node/enrollment.d.ts.map +1 -0
  505. package/dist/engine/node/enrollment.js +189 -0
  506. package/dist/engine/node/enrollment.js.map +1 -0
  507. package/dist/engine/node/env-flags.d.ts +5 -0
  508. package/dist/engine/node/env-flags.d.ts.map +1 -0
  509. package/dist/engine/node/env-flags.js +22 -0
  510. package/dist/engine/node/env-flags.js.map +1 -0
  511. package/dist/engine/node/executors/credential-hygiene.d.ts +63 -0
  512. package/dist/engine/node/executors/credential-hygiene.d.ts.map +1 -0
  513. package/dist/engine/node/executors/credential-hygiene.js +210 -0
  514. package/dist/engine/node/executors/credential-hygiene.js.map +1 -0
  515. package/dist/engine/node/executors/db-backup-run.d.ts +73 -0
  516. package/dist/engine/node/executors/db-backup-run.d.ts.map +1 -0
  517. package/dist/engine/node/executors/db-backup-run.js +362 -0
  518. package/dist/engine/node/executors/db-backup-run.js.map +1 -0
  519. package/dist/engine/node/executors/example-checksum.d.ts +30 -0
  520. package/dist/engine/node/executors/example-checksum.d.ts.map +1 -0
  521. package/dist/engine/node/executors/example-checksum.js +56 -0
  522. package/dist/engine/node/executors/example-checksum.js.map +1 -0
  523. package/dist/engine/node/executors/index.d.ts +213 -0
  524. package/dist/engine/node/executors/index.d.ts.map +1 -0
  525. package/dist/engine/node/executors/index.js +58 -0
  526. package/dist/engine/node/executors/index.js.map +1 -0
  527. package/dist/engine/node/executors/registry.d.ts +38 -0
  528. package/dist/engine/node/executors/registry.d.ts.map +1 -0
  529. package/dist/engine/node/executors/registry.js +103 -0
  530. package/dist/engine/node/executors/registry.js.map +1 -0
  531. package/dist/engine/node/heap-snapshot.d.ts +37 -0
  532. package/dist/engine/node/heap-snapshot.d.ts.map +1 -0
  533. package/dist/engine/node/heap-snapshot.js +160 -0
  534. package/dist/engine/node/heap-snapshot.js.map +1 -0
  535. package/dist/engine/node/host-telemetry.d.ts +38 -0
  536. package/dist/engine/node/host-telemetry.d.ts.map +1 -0
  537. package/dist/engine/node/host-telemetry.js +39 -0
  538. package/dist/engine/node/host-telemetry.js.map +1 -0
  539. package/dist/engine/node/host-vitals.d.ts +51 -0
  540. package/dist/engine/node/host-vitals.d.ts.map +1 -0
  541. package/dist/engine/node/host-vitals.js +117 -0
  542. package/dist/engine/node/host-vitals.js.map +1 -0
  543. package/dist/engine/node/install-deps.d.ts +231 -0
  544. package/dist/engine/node/install-deps.d.ts.map +1 -0
  545. package/dist/engine/node/install-deps.js +392 -0
  546. package/dist/engine/node/install-deps.js.map +1 -0
  547. package/dist/engine/node/ipc-protocol.d.ts +114 -0
  548. package/dist/engine/node/ipc-protocol.d.ts.map +1 -0
  549. package/dist/engine/node/ipc-protocol.js +122 -0
  550. package/dist/engine/node/ipc-protocol.js.map +1 -0
  551. package/dist/engine/node/lifecycle.d.ts +103 -0
  552. package/dist/engine/node/lifecycle.d.ts.map +1 -0
  553. package/dist/engine/node/lifecycle.js +260 -0
  554. package/dist/engine/node/lifecycle.js.map +1 -0
  555. package/dist/engine/node/logger.d.ts +95 -0
  556. package/dist/engine/node/logger.d.ts.map +1 -0
  557. package/dist/engine/node/logger.js +241 -0
  558. package/dist/engine/node/logger.js.map +1 -0
  559. package/dist/engine/node/memory-watchdog.d.ts +89 -0
  560. package/dist/engine/node/memory-watchdog.d.ts.map +1 -0
  561. package/dist/engine/node/memory-watchdog.js +248 -0
  562. package/dist/engine/node/memory-watchdog.js.map +1 -0
  563. package/dist/engine/node/models.d.ts +195 -0
  564. package/dist/engine/node/models.d.ts.map +1 -0
  565. package/dist/engine/node/models.js +379 -0
  566. package/dist/engine/node/models.js.map +1 -0
  567. package/dist/engine/node/node-api.d.ts +439 -0
  568. package/dist/engine/node/node-api.d.ts.map +1 -0
  569. package/dist/engine/node/node-api.js +125 -0
  570. package/dist/engine/node/node-api.js.map +1 -0
  571. package/dist/engine/node/node-config.d.ts +128 -0
  572. package/dist/engine/node/node-config.d.ts.map +1 -0
  573. package/dist/engine/node/node-config.js +237 -0
  574. package/dist/engine/node/node-config.js.map +1 -0
  575. package/dist/engine/node/node-dashboard-source.d.ts +83 -0
  576. package/dist/engine/node/node-dashboard-source.d.ts.map +1 -0
  577. package/dist/engine/node/node-dashboard-source.js +181 -0
  578. package/dist/engine/node/node-dashboard-source.js.map +1 -0
  579. package/dist/engine/node/node-engine.d.ts +282 -0
  580. package/dist/engine/node/node-engine.d.ts.map +1 -0
  581. package/dist/engine/node/node-engine.js +925 -0
  582. package/dist/engine/node/node-engine.js.map +1 -0
  583. package/dist/engine/node/node-errors.d.ts +54 -0
  584. package/dist/engine/node/node-errors.d.ts.map +1 -0
  585. package/dist/engine/node/node-errors.js +71 -0
  586. package/dist/engine/node/node-errors.js.map +1 -0
  587. package/dist/engine/node/node-events-queue.d.ts +27 -0
  588. package/dist/engine/node/node-events-queue.d.ts.map +1 -0
  589. package/dist/engine/node/node-events-queue.js +46 -0
  590. package/dist/engine/node/node-events-queue.js.map +1 -0
  591. package/dist/engine/node/node-events.d.ts +132 -0
  592. package/dist/engine/node/node-events.d.ts.map +1 -0
  593. package/dist/engine/node/node-events.js +2 -0
  594. package/dist/engine/node/node-events.js.map +1 -0
  595. package/dist/engine/node/node-vitals.d.ts +123 -0
  596. package/dist/engine/node/node-vitals.d.ts.map +1 -0
  597. package/dist/engine/node/node-vitals.js +266 -0
  598. package/dist/engine/node/node-vitals.js.map +1 -0
  599. package/dist/engine/node/paths.d.ts +39 -0
  600. package/dist/engine/node/paths.d.ts.map +1 -0
  601. package/dist/engine/node/paths.js +60 -0
  602. package/dist/engine/node/paths.js.map +1 -0
  603. package/dist/engine/node/pg-dump.d.ts +126 -0
  604. package/dist/engine/node/pg-dump.d.ts.map +1 -0
  605. package/dist/engine/node/pg-dump.js +223 -0
  606. package/dist/engine/node/pg-dump.js.map +1 -0
  607. package/dist/engine/node/pidfile.d.ts +38 -0
  608. package/dist/engine/node/pidfile.d.ts.map +1 -0
  609. package/dist/engine/node/pidfile.js +156 -0
  610. package/dist/engine/node/pidfile.js.map +1 -0
  611. package/dist/engine/node/power-probe.d.ts +59 -0
  612. package/dist/engine/node/power-probe.d.ts.map +1 -0
  613. package/dist/engine/node/power-probe.js +240 -0
  614. package/dist/engine/node/power-probe.js.map +1 -0
  615. package/dist/engine/node/power-watcher.d.ts +30 -0
  616. package/dist/engine/node/power-watcher.d.ts.map +1 -0
  617. package/dist/engine/node/power-watcher.js +116 -0
  618. package/dist/engine/node/power-watcher.js.map +1 -0
  619. package/dist/engine/node/runtime-state.d.ts +24 -0
  620. package/dist/engine/node/runtime-state.d.ts.map +1 -0
  621. package/dist/engine/node/runtime-state.js +19 -0
  622. package/dist/engine/node/runtime-state.js.map +1 -0
  623. package/dist/engine/node/runtime-tuning.d.ts +174 -0
  624. package/dist/engine/node/runtime-tuning.d.ts.map +1 -0
  625. package/dist/engine/node/runtime-tuning.js +327 -0
  626. package/dist/engine/node/runtime-tuning.js.map +1 -0
  627. package/dist/engine/node/service.d.ts +39 -0
  628. package/dist/engine/node/service.d.ts.map +1 -0
  629. package/dist/engine/node/service.js +215 -0
  630. package/dist/engine/node/service.js.map +1 -0
  631. package/dist/engine/node/start.d.ts +69 -0
  632. package/dist/engine/node/start.d.ts.map +1 -0
  633. package/dist/engine/node/start.js +325 -0
  634. package/dist/engine/node/start.js.map +1 -0
  635. package/dist/engine/node/worker-env-aliases.d.ts +39 -0
  636. package/dist/engine/node/worker-env-aliases.d.ts.map +1 -0
  637. package/dist/engine/node/worker-env-aliases.js +126 -0
  638. package/dist/engine/node/worker-env-aliases.js.map +1 -0
  639. package/dist/engine/node/worker-env-table.d.ts +15 -0
  640. package/dist/engine/node/worker-env-table.d.ts.map +1 -0
  641. package/dist/engine/node/worker-env-table.js +100 -0
  642. package/dist/engine/node/worker-env-table.js.map +1 -0
  643. package/dist/engine/node/worker-env.d.ts +67 -0
  644. package/dist/engine/node/worker-env.d.ts.map +1 -0
  645. package/dist/engine/node/worker-env.js +114 -0
  646. package/dist/engine/node/worker-env.js.map +1 -0
  647. package/dist/engine/output.d.ts +97 -0
  648. package/dist/engine/output.d.ts.map +1 -0
  649. package/dist/engine/output.js +274 -0
  650. package/dist/engine/output.js.map +1 -0
  651. package/dist/engine/package-info.d.ts +7 -0
  652. package/dist/engine/package-info.d.ts.map +1 -0
  653. package/dist/engine/package-info.js +38 -0
  654. package/dist/engine/package-info.js.map +1 -0
  655. package/dist/engine/program.d.ts +53 -0
  656. package/dist/engine/program.d.ts.map +1 -0
  657. package/dist/engine/program.js +213 -0
  658. package/dist/engine/program.js.map +1 -0
  659. package/dist/engine/prompt.d.ts +69 -0
  660. package/dist/engine/prompt.d.ts.map +1 -0
  661. package/dist/engine/prompt.js +205 -0
  662. package/dist/engine/prompt.js.map +1 -0
  663. package/dist/engine/registries.d.ts +5 -0
  664. package/dist/engine/registries.d.ts.map +1 -0
  665. package/dist/engine/registries.js +68 -0
  666. package/dist/engine/registries.js.map +1 -0
  667. package/dist/engine/request-body.d.ts +31 -0
  668. package/dist/engine/request-body.d.ts.map +1 -0
  669. package/dist/engine/request-body.js +156 -0
  670. package/dist/engine/request-body.js.map +1 -0
  671. package/dist/engine/semver.d.ts +31 -0
  672. package/dist/engine/semver.d.ts.map +1 -0
  673. package/dist/engine/semver.js +100 -0
  674. package/dist/engine/semver.js.map +1 -0
  675. package/dist/engine/test-support.d.ts +50 -0
  676. package/dist/engine/test-support.d.ts.map +1 -0
  677. package/dist/engine/test-support.js +86 -0
  678. package/dist/engine/test-support.js.map +1 -0
  679. package/dist/engine/tui/app-registry.d.ts +103 -0
  680. package/dist/engine/tui/app-registry.d.ts.map +1 -0
  681. package/dist/engine/tui/app-registry.js +103 -0
  682. package/dist/engine/tui/app-registry.js.map +1 -0
  683. package/dist/engine/tui/app.d.ts +11 -0
  684. package/dist/engine/tui/app.d.ts.map +1 -0
  685. package/dist/engine/tui/app.js +134 -0
  686. package/dist/engine/tui/app.js.map +1 -0
  687. package/dist/engine/tui/builtin-screens.d.ts +11 -0
  688. package/dist/engine/tui/builtin-screens.d.ts.map +1 -0
  689. package/dist/engine/tui/builtin-screens.js +69 -0
  690. package/dist/engine/tui/builtin-screens.js.map +1 -0
  691. package/dist/engine/tui/conformance.d.ts +149 -0
  692. package/dist/engine/tui/conformance.d.ts.map +1 -0
  693. package/dist/engine/tui/conformance.js +428 -0
  694. package/dist/engine/tui/conformance.js.map +1 -0
  695. package/dist/engine/tui/context.d.ts +220 -0
  696. package/dist/engine/tui/context.d.ts.map +1 -0
  697. package/dist/engine/tui/context.js +258 -0
  698. package/dist/engine/tui/context.js.map +1 -0
  699. package/dist/engine/tui/dashboard/index.d.ts +8 -0
  700. package/dist/engine/tui/dashboard/index.d.ts.map +1 -0
  701. package/dist/engine/tui/dashboard/index.js +5 -0
  702. package/dist/engine/tui/dashboard/index.js.map +1 -0
  703. package/dist/engine/tui/dashboard/jobs-insights.d.ts +145 -0
  704. package/dist/engine/tui/dashboard/jobs-insights.d.ts.map +1 -0
  705. package/dist/engine/tui/dashboard/jobs-insights.js +63 -0
  706. package/dist/engine/tui/dashboard/jobs-insights.js.map +1 -0
  707. package/dist/engine/tui/dashboard/node-embedded.d.ts +33 -0
  708. package/dist/engine/tui/dashboard/node-embedded.d.ts.map +1 -0
  709. package/dist/engine/tui/dashboard/node-embedded.js +81 -0
  710. package/dist/engine/tui/dashboard/node-embedded.js.map +1 -0
  711. package/dist/engine/tui/dashboard/source.d.ts +294 -0
  712. package/dist/engine/tui/dashboard/source.d.ts.map +1 -0
  713. package/dist/engine/tui/dashboard/source.js +397 -0
  714. package/dist/engine/tui/dashboard/source.js.map +1 -0
  715. package/dist/engine/tui/dashboard/use-dashboard.d.ts +23 -0
  716. package/dist/engine/tui/dashboard/use-dashboard.d.ts.map +1 -0
  717. package/dist/engine/tui/dashboard/use-dashboard.js +32 -0
  718. package/dist/engine/tui/dashboard/use-dashboard.js.map +1 -0
  719. package/dist/engine/tui/index.d.ts +25 -0
  720. package/dist/engine/tui/index.d.ts.map +1 -0
  721. package/dist/engine/tui/index.js +89 -0
  722. package/dist/engine/tui/index.js.map +1 -0
  723. package/dist/engine/tui/layout.d.ts +152 -0
  724. package/dist/engine/tui/layout.d.ts.map +1 -0
  725. package/dist/engine/tui/layout.js +214 -0
  726. package/dist/engine/tui/layout.js.map +1 -0
  727. package/dist/engine/tui/menu-registry.d.ts +201 -0
  728. package/dist/engine/tui/menu-registry.d.ts.map +1 -0
  729. package/dist/engine/tui/menu-registry.js +205 -0
  730. package/dist/engine/tui/menu-registry.js.map +1 -0
  731. package/dist/engine/tui/menu-tree.d.ts +198 -0
  732. package/dist/engine/tui/menu-tree.d.ts.map +1 -0
  733. package/dist/engine/tui/menu-tree.js +276 -0
  734. package/dist/engine/tui/menu-tree.js.map +1 -0
  735. package/dist/engine/tui/raw-mode.d.ts +54 -0
  736. package/dist/engine/tui/raw-mode.d.ts.map +1 -0
  737. package/dist/engine/tui/raw-mode.js +106 -0
  738. package/dist/engine/tui/raw-mode.js.map +1 -0
  739. package/dist/engine/tui/routes.d.ts +5 -0
  740. package/dist/engine/tui/routes.d.ts.map +1 -0
  741. package/dist/engine/tui/routes.js +16 -0
  742. package/dist/engine/tui/routes.js.map +1 -0
  743. package/dist/engine/tui/screen-registry.d.ts +170 -0
  744. package/dist/engine/tui/screen-registry.d.ts.map +1 -0
  745. package/dist/engine/tui/screen-registry.js +180 -0
  746. package/dist/engine/tui/screen-registry.js.map +1 -0
  747. package/dist/engine/tui/screen-sections.d.ts +9 -0
  748. package/dist/engine/tui/screen-sections.d.ts.map +1 -0
  749. package/dist/engine/tui/screen-sections.js +45 -0
  750. package/dist/engine/tui/screen-sections.js.map +1 -0
  751. package/dist/engine/tui/screens/deploy/advanced-model.d.ts +69 -0
  752. package/dist/engine/tui/screens/deploy/advanced-model.d.ts.map +1 -0
  753. package/dist/engine/tui/screens/deploy/advanced-model.js +228 -0
  754. package/dist/engine/tui/screens/deploy/advanced-model.js.map +1 -0
  755. package/dist/engine/tui/screens/deploy/doctor-model.d.ts +37 -0
  756. package/dist/engine/tui/screens/deploy/doctor-model.d.ts.map +1 -0
  757. package/dist/engine/tui/screens/deploy/doctor-model.js +89 -0
  758. package/dist/engine/tui/screens/deploy/doctor-model.js.map +1 -0
  759. package/dist/engine/tui/screens/deploy/doctor.d.ts +8 -0
  760. package/dist/engine/tui/screens/deploy/doctor.d.ts.map +1 -0
  761. package/dist/engine/tui/screens/deploy/doctor.js +163 -0
  762. package/dist/engine/tui/screens/deploy/doctor.js.map +1 -0
  763. package/dist/engine/tui/screens/deploy/fields.d.ts +123 -0
  764. package/dist/engine/tui/screens/deploy/fields.d.ts.map +1 -0
  765. package/dist/engine/tui/screens/deploy/fields.js +202 -0
  766. package/dist/engine/tui/screens/deploy/fields.js.map +1 -0
  767. package/dist/engine/tui/screens/deploy/flags-model.d.ts +67 -0
  768. package/dist/engine/tui/screens/deploy/flags-model.d.ts.map +1 -0
  769. package/dist/engine/tui/screens/deploy/flags-model.js +302 -0
  770. package/dist/engine/tui/screens/deploy/flags-model.js.map +1 -0
  771. package/dist/engine/tui/screens/deploy/index.d.ts +6 -0
  772. package/dist/engine/tui/screens/deploy/index.d.ts.map +1 -0
  773. package/dist/engine/tui/screens/deploy/index.js +83 -0
  774. package/dist/engine/tui/screens/deploy/index.js.map +1 -0
  775. package/dist/engine/tui/screens/deploy/install-model.d.ts +159 -0
  776. package/dist/engine/tui/screens/deploy/install-model.d.ts.map +1 -0
  777. package/dist/engine/tui/screens/deploy/install-model.js +319 -0
  778. package/dist/engine/tui/screens/deploy/install-model.js.map +1 -0
  779. package/dist/engine/tui/screens/deploy/install.d.ts +8 -0
  780. package/dist/engine/tui/screens/deploy/install.d.ts.map +1 -0
  781. package/dist/engine/tui/screens/deploy/install.js +365 -0
  782. package/dist/engine/tui/screens/deploy/install.js.map +1 -0
  783. package/dist/engine/tui/screens/deploy/model.d.ts +49 -0
  784. package/dist/engine/tui/screens/deploy/model.d.ts.map +1 -0
  785. package/dist/engine/tui/screens/deploy/model.js +59 -0
  786. package/dist/engine/tui/screens/deploy/model.js.map +1 -0
  787. package/dist/engine/tui/screens/deploy/run-model.d.ts +58 -0
  788. package/dist/engine/tui/screens/deploy/run-model.d.ts.map +1 -0
  789. package/dist/engine/tui/screens/deploy/run-model.js +117 -0
  790. package/dist/engine/tui/screens/deploy/run-model.js.map +1 -0
  791. package/dist/engine/tui/screens/deploy/run.d.ts +75 -0
  792. package/dist/engine/tui/screens/deploy/run.d.ts.map +1 -0
  793. package/dist/engine/tui/screens/deploy/run.js +201 -0
  794. package/dist/engine/tui/screens/deploy/run.js.map +1 -0
  795. package/dist/engine/tui/screens/deploy/status.d.ts +17 -0
  796. package/dist/engine/tui/screens/deploy/status.d.ts.map +1 -0
  797. package/dist/engine/tui/screens/deploy/status.js +107 -0
  798. package/dist/engine/tui/screens/deploy/status.js.map +1 -0
  799. package/dist/engine/tui/screens/deploy/update.d.ts +41 -0
  800. package/dist/engine/tui/screens/deploy/update.d.ts.map +1 -0
  801. package/dist/engine/tui/screens/deploy/update.js +175 -0
  802. package/dist/engine/tui/screens/deploy/update.js.map +1 -0
  803. package/dist/engine/tui/screens/deploy.d.ts +12 -0
  804. package/dist/engine/tui/screens/deploy.d.ts.map +1 -0
  805. package/dist/engine/tui/screens/deploy.js +23 -0
  806. package/dist/engine/tui/screens/deploy.js.map +1 -0
  807. package/dist/engine/tui/screens/invoke.d.ts +6 -0
  808. package/dist/engine/tui/screens/invoke.d.ts.map +1 -0
  809. package/dist/engine/tui/screens/invoke.js +196 -0
  810. package/dist/engine/tui/screens/invoke.js.map +1 -0
  811. package/dist/engine/tui/screens/jobs.d.ts +12 -0
  812. package/dist/engine/tui/screens/jobs.d.ts.map +1 -0
  813. package/dist/engine/tui/screens/jobs.js +72 -0
  814. package/dist/engine/tui/screens/jobs.js.map +1 -0
  815. package/dist/engine/tui/screens/login.d.ts +6 -0
  816. package/dist/engine/tui/screens/login.d.ts.map +1 -0
  817. package/dist/engine/tui/screens/login.js +263 -0
  818. package/dist/engine/tui/screens/login.js.map +1 -0
  819. package/dist/engine/tui/screens/logout.d.ts +6 -0
  820. package/dist/engine/tui/screens/logout.d.ts.map +1 -0
  821. package/dist/engine/tui/screens/logout.js +149 -0
  822. package/dist/engine/tui/screens/logout.js.map +1 -0
  823. package/dist/engine/tui/screens/menu.d.ts +25 -0
  824. package/dist/engine/tui/screens/menu.d.ts.map +1 -0
  825. package/dist/engine/tui/screens/menu.js +124 -0
  826. package/dist/engine/tui/screens/menu.js.map +1 -0
  827. package/dist/engine/tui/screens/node.d.ts +6 -0
  828. package/dist/engine/tui/screens/node.d.ts.map +1 -0
  829. package/dist/engine/tui/screens/node.js +277 -0
  830. package/dist/engine/tui/screens/node.js.map +1 -0
  831. package/dist/engine/tui/screens/not-logged-in.d.ts +12 -0
  832. package/dist/engine/tui/screens/not-logged-in.d.ts.map +1 -0
  833. package/dist/engine/tui/screens/not-logged-in.js +14 -0
  834. package/dist/engine/tui/screens/not-logged-in.js.map +1 -0
  835. package/dist/engine/tui/screens/status.d.ts +6 -0
  836. package/dist/engine/tui/screens/status.d.ts.map +1 -0
  837. package/dist/engine/tui/screens/status.js +138 -0
  838. package/dist/engine/tui/screens/status.js.map +1 -0
  839. package/dist/engine/tui/scroll-box.d.ts +42 -0
  840. package/dist/engine/tui/scroll-box.d.ts.map +1 -0
  841. package/dist/engine/tui/scroll-box.js +62 -0
  842. package/dist/engine/tui/scroll-box.js.map +1 -0
  843. package/dist/engine/tui/section-registry.d.ts +65 -0
  844. package/dist/engine/tui/section-registry.d.ts.map +1 -0
  845. package/dist/engine/tui/section-registry.js +90 -0
  846. package/dist/engine/tui/section-registry.js.map +1 -0
  847. package/dist/engine/tui/terminal.d.ts +31 -0
  848. package/dist/engine/tui/terminal.d.ts.map +1 -0
  849. package/dist/engine/tui/terminal.js +142 -0
  850. package/dist/engine/tui/terminal.js.map +1 -0
  851. package/dist/engine/tui/testing/feeds.d.ts +58 -0
  852. package/dist/engine/tui/testing/feeds.d.ts.map +1 -0
  853. package/dist/engine/tui/testing/feeds.js +67 -0
  854. package/dist/engine/tui/testing/feeds.js.map +1 -0
  855. package/dist/engine/tui/testing/harness.d.ts +243 -0
  856. package/dist/engine/tui/testing/harness.d.ts.map +1 -0
  857. package/dist/engine/tui/testing/harness.js +332 -0
  858. package/dist/engine/tui/testing/harness.js.map +1 -0
  859. package/dist/engine/tui/theme.d.ts +179 -0
  860. package/dist/engine/tui/theme.d.ts.map +1 -0
  861. package/dist/engine/tui/theme.js +111 -0
  862. package/dist/engine/tui/theme.js.map +1 -0
  863. package/dist/engine/tui/tty.d.ts +56 -0
  864. package/dist/engine/tui/tty.d.ts.map +1 -0
  865. package/dist/engine/tui/tty.js +146 -0
  866. package/dist/engine/tui/tty.js.map +1 -0
  867. package/dist/engine/tui/ui/active-items.d.ts +40 -0
  868. package/dist/engine/tui/ui/active-items.d.ts.map +1 -0
  869. package/dist/engine/tui/ui/active-items.js +38 -0
  870. package/dist/engine/tui/ui/active-items.js.map +1 -0
  871. package/dist/engine/tui/ui/event-log.d.ts +58 -0
  872. package/dist/engine/tui/ui/event-log.d.ts.map +1 -0
  873. package/dist/engine/tui/ui/event-log.js +32 -0
  874. package/dist/engine/tui/ui/event-log.js.map +1 -0
  875. package/dist/engine/tui/ui/index.d.ts +20 -0
  876. package/dist/engine/tui/ui/index.d.ts.map +1 -0
  877. package/dist/engine/tui/ui/index.js +14 -0
  878. package/dist/engine/tui/ui/index.js.map +1 -0
  879. package/dist/engine/tui/ui/meter-legend.d.ts +26 -0
  880. package/dist/engine/tui/ui/meter-legend.d.ts.map +1 -0
  881. package/dist/engine/tui/ui/meter-legend.js +25 -0
  882. package/dist/engine/tui/ui/meter-legend.js.map +1 -0
  883. package/dist/engine/tui/ui/run-summary.d.ts +58 -0
  884. package/dist/engine/tui/ui/run-summary.d.ts.map +1 -0
  885. package/dist/engine/tui/ui/run-summary.js +29 -0
  886. package/dist/engine/tui/ui/run-summary.js.map +1 -0
  887. package/dist/engine/tui/ui/segment-meter.d.ts +72 -0
  888. package/dist/engine/tui/ui/segment-meter.d.ts.map +1 -0
  889. package/dist/engine/tui/ui/segment-meter.js +128 -0
  890. package/dist/engine/tui/ui/segment-meter.js.map +1 -0
  891. package/dist/engine/tui/ui/status-line.d.ts +42 -0
  892. package/dist/engine/tui/ui/status-line.d.ts.map +1 -0
  893. package/dist/engine/tui/ui/status-line.js +35 -0
  894. package/dist/engine/tui/ui/status-line.js.map +1 -0
  895. package/dist/engine/tui/ui/tone.d.ts +46 -0
  896. package/dist/engine/tui/ui/tone.d.ts.map +1 -0
  897. package/dist/engine/tui/ui/tone.js +48 -0
  898. package/dist/engine/tui/ui/tone.js.map +1 -0
  899. package/dist/engine/update-notice-options.d.ts +70 -0
  900. package/dist/engine/update-notice-options.d.ts.map +1 -0
  901. package/dist/engine/update-notice-options.js +79 -0
  902. package/dist/engine/update-notice-options.js.map +1 -0
  903. package/dist/engine/update-notice.d.ts +69 -0
  904. package/dist/engine/update-notice.d.ts.map +1 -0
  905. package/dist/engine/update-notice.js +204 -0
  906. package/dist/engine/update-notice.js.map +1 -0
  907. package/dist/index.d.ts +4 -5
  908. package/dist/index.d.ts.map +1 -1
  909. package/dist/index.js +5 -5
  910. package/dist/index.js.map +1 -1
  911. package/dist/node/index.d.ts +3 -0
  912. package/dist/node/index.d.ts.map +1 -0
  913. package/dist/node/index.js +5 -0
  914. package/dist/node/index.js.map +1 -0
  915. package/dist/telemetry/index.d.ts +2 -1
  916. package/dist/telemetry/index.d.ts.map +1 -1
  917. package/dist/telemetry/index.js +1 -0
  918. package/dist/telemetry/index.js.map +1 -1
  919. package/dist/telemetry/node-span-relay.d.ts +1 -1
  920. package/dist/telemetry/node-span-relay.d.ts.map +1 -1
  921. package/dist/telemetry/node-span-relay.js +39 -6
  922. package/dist/telemetry/node-span-relay.js.map +1 -1
  923. package/dist/telemetry/node-span.d.ts +39 -7
  924. package/dist/telemetry/node-span.d.ts.map +1 -1
  925. package/dist/telemetry/node-span.js +19 -1
  926. package/dist/telemetry/node-span.js.map +1 -1
  927. package/dist/testing/index.d.ts +3 -0
  928. package/dist/testing/index.d.ts.map +1 -0
  929. package/dist/testing/index.js +4 -0
  930. package/dist/testing/index.js.map +1 -0
  931. package/dist/tui/index.d.ts +3 -0
  932. package/dist/tui/index.d.ts.map +1 -0
  933. package/dist/tui/index.js +7 -0
  934. package/dist/tui/index.js.map +1 -0
  935. package/dist/tui/testing/index.d.ts +5 -0
  936. package/dist/tui/testing/index.d.ts.map +1 -0
  937. package/dist/tui/testing/index.js +12 -0
  938. package/dist/tui/testing/index.js.map +1 -0
  939. package/dist/tui/ui/index.d.ts +2 -0
  940. package/dist/tui/ui/index.d.ts.map +1 -0
  941. package/dist/tui/ui/index.js +10 -0
  942. package/dist/tui/ui/index.js.map +1 -0
  943. package/package.json +56 -5
@@ -0,0 +1,925 @@
1
+ import { createWriteStream } from 'node:fs';
2
+ import { mkdir, rm } from 'node:fs/promises';
3
+ import { randomBytes } from 'node:crypto';
4
+ import { join } from 'node:path';
5
+ import { Readable } from 'node:stream';
6
+ import { pipeline } from 'node:stream/promises';
7
+ import { SERVER_FEATURE_HOST_VITALS, } from './node-api.js';
8
+ import { resolveInputMode } from './executors/index.js';
9
+ import { defaultExecutorRegistry } from './executors/registry.js';
10
+ import { MissingJobInputError, ProviderRateLimitError } from './node-errors.js';
11
+ import { NodeEventQueue } from './node-events-queue.js';
12
+ import { sanitizeExtraVitals } from './node-vitals.js';
13
+ import { ApiError } from '../errors.js';
14
+ import { JobSpanRecorder, NodeSpanRelay } from '../../telemetry/index.js';
15
+ const realScheduler = {
16
+ setInterval: (fn, ms) => setInterval(fn, ms),
17
+ clearInterval: (handle) => clearInterval(handle),
18
+ };
19
+ /** How many settled jobs the snapshot remembers. A daemon runs for months. */
20
+ export const HISTORY_LIMIT = 50;
21
+ /**
22
+ * Default lease-renew cadence: comfortably inside any sane lease window.
23
+ *
24
+ * ⚠ A FALLBACK, NOT THE ANSWER, since the server started sending
25
+ * `renewIntervalMs` on every assignment. It is a fixed number chosen to be
26
+ * safe against the shortest lease a server might grant, which necessarily
27
+ * makes it wasteful against the longest: a job type declaring a six-hour
28
+ * runtime ceiling takes a six-hour lease, and renewing that every 30 seconds
29
+ * is 720 round trips to tell the server something it derived itself. The
30
+ * server's per-job number wins wherever it is present; this covers an older
31
+ * control plane, and the `--lease-renew-ms` operator override still outranks
32
+ * both (see `processJob`).
33
+ */
34
+ export const DEFAULT_LEASE_RENEW_MS = 30_000;
35
+ /** Default heartbeat cadence. */
36
+ export const DEFAULT_HEARTBEAT_MS = 15_000;
37
+ const DEFAULT_POLL_MS = 5_000;
38
+ export class NodeEngine {
39
+ api;
40
+ executors;
41
+ scheduler;
42
+ sleep;
43
+ now;
44
+ fetchImpl;
45
+ onEvent;
46
+ persistConcurrency;
47
+ leaseRenewIntervalMs;
48
+ heartbeatIntervalMs;
49
+ pollIntervalMs;
50
+ tmpDir;
51
+ capabilities;
52
+ refreshCapabilities;
53
+ withheldTypes;
54
+ requestedTypes;
55
+ nodeId;
56
+ concurrency;
57
+ draining = false;
58
+ stopped = false;
59
+ running = false;
60
+ heartbeatHandle;
61
+ lastHeartbeatMs;
62
+ startedAtMs;
63
+ /**
64
+ * Resolved to wake the loop out of a `Promise.race` it would otherwise sit
65
+ * in until a job finished.
66
+ *
67
+ * Needed because the two blocking waits in `run()` are on IN-FLIGHT WORK,
68
+ * and both `setConcurrency` (raising the cap) and `drain()` are decisions
69
+ * made from OUTSIDE that work. Without this, raising the cap on a saturated
70
+ * worker would take effect only when the next job happened to finish —
71
+ * which, for a worker running one long job, is not "the next iteration" in
72
+ * any useful sense.
73
+ */
74
+ wake;
75
+ inFlight = new Set();
76
+ activeJobs = new Map();
77
+ history = [];
78
+ counters = { claimed: 0, succeeded: 0, failed: 0, rateLimited: 0 };
79
+ loopCounters = {
80
+ emptyPolls: 0,
81
+ claimFailures: 0,
82
+ leaseRenewals: 0,
83
+ leaseRenewFailures: 0,
84
+ heartbeatFailures: 0,
85
+ };
86
+ collectVitals;
87
+ /**
88
+ * Cleared, for the rest of the process, the first time the server refuses a
89
+ * heartbeat that carried vitals with a 400 — see `beat()`.
90
+ */
91
+ vitalsEnabled;
92
+ hostTelemetry;
93
+ /** Cleared for the process when the server refuses a beat carrying host fields. */
94
+ hostEnabled;
95
+ /** Set once the server refuses host fields; never re-enabled in this process. */
96
+ hostRefused = false;
97
+ eventQueue = new NodeEventQueue();
98
+ powerPollIntervalMs;
99
+ powerPollHandle;
100
+ lastExtraBeatMs;
101
+ lastDiskFree;
102
+ /** The span relay (#608), or `undefined` when disabled by option. */
103
+ spanRelay;
104
+ constructor(options) {
105
+ this.api = options.api;
106
+ this.nodeId = options.nodeId;
107
+ this.concurrency = options.concurrency;
108
+ // The built-ins plus every app executor (`registerNodeExecutor`, #715).
109
+ this.executors = options.executors ?? defaultExecutorRegistry();
110
+ this.requestedTypes = options.eligibleTypes ?? [];
111
+ this.pollIntervalMs = options.pollIntervalMs ?? DEFAULT_POLL_MS;
112
+ this.leaseRenewIntervalMs = options.leaseRenewIntervalMs ?? DEFAULT_LEASE_RENEW_MS;
113
+ this.heartbeatIntervalMs = options.heartbeatIntervalMs ?? DEFAULT_HEARTBEAT_MS;
114
+ this.scheduler = options.scheduler ?? realScheduler;
115
+ this.now = options.now ?? Date.now;
116
+ this.sleep = options.sleep ?? ((ms) => new Promise((resolve) => setTimeout(resolve, ms)));
117
+ this.fetchImpl = options.fetch ?? globalThis.fetch.bind(globalThis);
118
+ this.onEvent = options.onEvent;
119
+ this.persistConcurrency = options.persistConcurrency;
120
+ this.tmpDir = options.tmpDir ?? join(process.cwd(), '.node-tmp');
121
+ this.capabilities = options.capabilities;
122
+ this.refreshCapabilities = options.refreshCapabilities;
123
+ this.withheldTypes = new Set(options.withheldTypes ?? []);
124
+ this.collectVitals = options.collectVitals;
125
+ this.vitalsEnabled = options.collectVitals !== undefined;
126
+ this.hostTelemetry = options.hostTelemetry;
127
+ this.hostEnabled = options.hostTelemetry !== undefined && (options.serverFeatures ?? []).includes(SERVER_FEATURE_HOST_VITALS);
128
+ this.powerPollIntervalMs = options.powerPollIntervalMs ?? 10_000;
129
+ this.startedAtMs = this.now();
130
+ this.spanRelay =
131
+ options.relaySpans === false
132
+ ? undefined
133
+ : new NodeSpanRelay({
134
+ // Compile-time proof that the app's client is a span sink.
135
+ api: this.api,
136
+ nodeId: this.nodeId,
137
+ onDisabled: (reason) => this.emit({ kind: 'telemetry-disabled', at: this.iso(), error: reason }),
138
+ });
139
+ }
140
+ /**
141
+ * Resolves once every queued span has been sent or dropped. Never rejects.
142
+ * The engine never awaits this on a job's path; `stop()` does, briefly, so
143
+ * a clean shutdown does not throw away the last job's spans.
144
+ */
145
+ flushSpans() {
146
+ return this.spanRelay?.flush() ?? Promise.resolve();
147
+ }
148
+ // ---------------------------------------------------------------------------
149
+ // Public control surface — what the daemon's IPC and the TUI drive
150
+ // ---------------------------------------------------------------------------
151
+ /**
152
+ * The types this node advertises: the operator's list intersected with what
153
+ * it can actually run, or everything it can run when they named nothing.
154
+ *
155
+ * The intersection is not pedantry. Claiming a type with no executor means
156
+ * accepting a lease and immediately failing it — the worst outcome, because
157
+ * the job is charged an attempt for a decision this node could have made
158
+ * before asking.
159
+ */
160
+ claimableTypes() {
161
+ const types = this.requestedTypes.length === 0
162
+ ? this.executors.types()
163
+ : this.requestedTypes.filter((type) => this.executors.has(type));
164
+ return this.withheldTypes.size === 0 ? types : types.filter((type) => !this.withheldTypes.has(type));
165
+ }
166
+ /**
167
+ * Change the cap live.
168
+ *
169
+ * Fires an IMMEDIATE heartbeat rather than waiting for the next one, so the
170
+ * server's own claim cap for this node updates within a second. Without
171
+ * that, a scale-down would keep receiving work at the old rate for a full
172
+ * heartbeat interval.
173
+ */
174
+ setConcurrency(value) {
175
+ if (!Number.isInteger(value) || value < 1 || value > 64) {
176
+ throw new RangeError(`Concurrency must be a whole number between 1 and 64 (got ${value}).`);
177
+ }
178
+ if (value === this.concurrency)
179
+ return;
180
+ this.concurrency = value;
181
+ this.emit({ kind: 'concurrency-changed', at: this.iso(), concurrency: value });
182
+ this.persistConcurrency?.(value);
183
+ this.signalWake();
184
+ void this.beat();
185
+ }
186
+ /** Finish in-flight work and stop claiming. Does NOT deregister. */
187
+ async drain() {
188
+ if (this.draining)
189
+ return;
190
+ this.draining = true;
191
+ this.signalWake();
192
+ this.emit({ kind: 'draining', at: this.iso(), inFlight: this.inFlight.size });
193
+ await Promise.allSettled([...this.inFlight]);
194
+ }
195
+ /**
196
+ * Drain, then tear down.
197
+ *
198
+ * `deregister: false` is the headless/container contract: a restarting
199
+ * replica must RE-ATTACH to its existing node row, not leak a new one on
200
+ * every restart. #277's memory valve relies on the same thing.
201
+ */
202
+ async stop(options) {
203
+ await this.drain();
204
+ await this.flushSpans();
205
+ if (this.powerPollHandle !== undefined) {
206
+ this.scheduler.clearInterval(this.powerPollHandle);
207
+ this.powerPollHandle = undefined;
208
+ }
209
+ if (this.heartbeatHandle !== undefined) {
210
+ this.scheduler.clearInterval(this.heartbeatHandle);
211
+ this.heartbeatHandle = undefined;
212
+ }
213
+ const deregister = options?.deregister !== false;
214
+ if (deregister) {
215
+ try {
216
+ await this.api.deregister(this.nodeId);
217
+ }
218
+ catch {
219
+ // A deregister that fails is not worth failing a shutdown over: the
220
+ // server's own liveness cron marks a silent node offline anyway (#270).
221
+ }
222
+ }
223
+ this.stopped = true;
224
+ this.emit({ kind: 'stopped', at: this.iso(), deregistered: deregister });
225
+ }
226
+ /** One shape, consumed by `node status`, the daemon IPC and the TUI alike. */
227
+ getSnapshot() {
228
+ const heartbeatAgeMs = this.lastHeartbeatMs === undefined ? null : this.now() - this.lastHeartbeatMs;
229
+ return {
230
+ nodeId: this.nodeId,
231
+ status: this.stopped
232
+ ? 'stopped'
233
+ : this.draining
234
+ ? 'draining'
235
+ : !this.running
236
+ ? 'starting'
237
+ : this.activeJobs.size > 0
238
+ ? 'working'
239
+ : 'idle',
240
+ concurrency: this.concurrency,
241
+ eligibleTypes: this.claimableTypes(),
242
+ activeJobs: [...this.activeJobs.values()].map(({ jobId, type, startedAt, attempts, leaseExpiresAt }) => ({
243
+ jobId,
244
+ type,
245
+ startedAt,
246
+ attempts,
247
+ leaseExpiresAt,
248
+ })),
249
+ // A COPY, so a consumer holding a snapshot cannot see it mutate under
250
+ // them — the TUI renders asynchronously and would otherwise show a list
251
+ // that changed between two reads of the same object.
252
+ history: [...this.history],
253
+ counters: { ...this.counters },
254
+ startedAt: new Date(this.startedAtMs).toISOString(),
255
+ lastHeartbeatAt: this.lastHeartbeatMs === undefined ? null : new Date(this.lastHeartbeatMs).toISOString(),
256
+ heartbeatAgeMs,
257
+ };
258
+ }
259
+ /**
260
+ * Every cumulative counter, in the heartbeat's `vitals.counters` shape
261
+ * (#605) — `claims` is the snapshot's `claimed`. `watchdogTrips` is absent:
262
+ * the watchdog, not the engine, owns it.
263
+ */
264
+ getVitalsCounters() {
265
+ return {
266
+ claims: this.counters.claimed,
267
+ emptyPolls: this.loopCounters.emptyPolls,
268
+ claimFailures: this.loopCounters.claimFailures,
269
+ succeeded: this.counters.succeeded,
270
+ failed: this.counters.failed,
271
+ rateLimited: this.counters.rateLimited,
272
+ leaseRenewals: this.loopCounters.leaseRenewals,
273
+ leaseRenewFailures: this.loopCounters.leaseRenewFailures,
274
+ heartbeatFailures: this.loopCounters.heartbeatFailures,
275
+ };
276
+ }
277
+ // ---------------------------------------------------------------------------
278
+ // The loop
279
+ // ---------------------------------------------------------------------------
280
+ /**
281
+ * Run until drained. Resolves only once every in-flight job has settled.
282
+ *
283
+ * NOTE THE `Promise.race` GUARD: `processJob` never rejects (it reports the
284
+ * failure to the server and resolves), because a rejected member would make
285
+ * every `race` in this loop throw and take the worker down on the first
286
+ * failed job.
287
+ */
288
+ async run() {
289
+ this.running = true;
290
+ this.startHeartbeat();
291
+ this.emit({ kind: 'started', at: this.iso(), nodeId: this.nodeId, concurrency: this.concurrency });
292
+ while (!this.draining) {
293
+ const free = this.concurrency - this.inFlight.size; // re-read each pass
294
+ if (free <= 0) {
295
+ // `waitForWake()` is in the race so a cap RAISE or a drain is acted on
296
+ // now rather than whenever a job happens to end.
297
+ await Promise.race([...this.inFlight, this.waitForWake()]);
298
+ continue;
299
+ }
300
+ let claimed;
301
+ try {
302
+ claimed = await this.api.claim(this.nodeId, { limit: free, types: this.claimableTypes() });
303
+ }
304
+ catch (error) {
305
+ // A claim failure is transient by nature — a restarting API, a blip.
306
+ // Back off one poll interval and try again rather than exiting: a
307
+ // worker that dies on a deploy is a worker somebody has to restart.
308
+ this.loopCounters.claimFailures += 1;
309
+ this.emit({ kind: 'claim-failed', at: this.iso(), error: messageOf(error) });
310
+ await this.sleep(this.pollIntervalMs);
311
+ continue;
312
+ }
313
+ if (claimed.length > 0) {
314
+ this.counters.claimed += claimed.length;
315
+ this.emit({ kind: 'claimed', at: this.iso(), jobs: claimed });
316
+ for (const assignment of claimed) {
317
+ const promise = this.processJob(assignment).finally(() => {
318
+ this.inFlight.delete(promise);
319
+ });
320
+ this.inFlight.add(promise);
321
+ }
322
+ continue; // refill the remaining slots immediately
323
+ }
324
+ this.loopCounters.emptyPolls += 1;
325
+ if (this.inFlight.size > 0) {
326
+ // Wake on whichever comes first: a slot freeing up, or the poll
327
+ // interval. Waiting only on the sleep would leave a freed slot idle
328
+ // for the rest of the interval; waiting only on the jobs would never
329
+ // re-check a queue that filled up while we were busy.
330
+ await Promise.race([...this.inFlight, this.sleep(this.pollIntervalMs), this.waitForWake()]);
331
+ continue;
332
+ }
333
+ this.emit({ kind: 'idle', at: this.iso() });
334
+ await this.sleep(this.pollIntervalMs);
335
+ }
336
+ await Promise.allSettled([...this.inFlight]);
337
+ }
338
+ // ---------------------------------------------------------------------------
339
+ // One job
340
+ // ---------------------------------------------------------------------------
341
+ /** NEVER REJECTS. See `run()`. */
342
+ async processJob(assignment) {
343
+ const { job, params } = assignment;
344
+ // THE CLAIM TOKEN IS HELD FOR THE WHOLE RUN, in this local, because that
345
+ // is exactly the lifetime it describes (#364). It identifies THIS
346
+ // assignment of this job — not this node, which `claimedByNodeId` already
347
+ // did and which is precisely the ambiguity that let a stalled slot renew,
348
+ // or settle, the run its own re-claim was executing. Reading it off the
349
+ // engine or re-fetching it mid-run would reintroduce that: a later claim
350
+ // would overwrite the value the ticker below quotes, and the stale slot
351
+ // would once again be indistinguishable from the live one. Captured by
352
+ // the ticker's closure, threaded through every call this run makes on the
353
+ // job's behalf, and dropped with the frame when the run ends.
354
+ //
355
+ // ⚠ `undefined` HERE IS A LEGITIMATE STEADY STATE, NOT A DEGRADED ONE. An
356
+ // older control plane sends no token, and a row claimed before the column
357
+ // existed sends `null`; both mean "nothing to quote", every call below
358
+ // then omits the key, and the server identifies this node exactly as it
359
+ // did before. Nothing warns, and nothing should.
360
+ const claimToken = assignment.claimToken;
361
+ // THE JOB'S PHASE SPANS (#608): recorded as it runs, relayed after it
362
+ // settles. Recording is synchronous and cannot fail the job; sending is
363
+ // off this promise entirely (see `NodeSpanRelay`).
364
+ const spans = new JobSpanRecorder(job.id, this.now);
365
+ const startedMs = this.now();
366
+ const controller = new AbortController();
367
+ const record = {
368
+ jobId: job.id,
369
+ type: job.type,
370
+ startedAt: new Date(startedMs).toISOString(),
371
+ attempts: job.attempts,
372
+ leaseExpiresAt: job.leaseExpiresAt,
373
+ controller,
374
+ startedMs,
375
+ renewHandle: undefined,
376
+ };
377
+ this.activeJobs.set(job.id, record);
378
+ this.emit({ kind: 'job-started', at: this.iso(), jobId: job.id, type: job.type });
379
+ // The renew ticker runs for the WHOLE job, input download included: a
380
+ // multi-gigabyte download can outlive a lease just as easily as the
381
+ // compute can.
382
+ //
383
+ // THE SERVER'S NUMBER WINS WHEN IT SENT ONE. It derived `renewIntervalMs`
384
+ // from the lease it granted THIS job (a third of it, clamped), so it is
385
+ // the only cadence that is correct for a type whose lease is not the
386
+ // deployment default — and it is per job, because a node claims across
387
+ // several types at once and those rows no longer share a lease. The local
388
+ // value stays the fallback for an older control plane that sends nothing.
389
+ // Validated rather than trusted: a non-finite or non-positive number out
390
+ // of a JSON body would become a `setInterval` firing flat out.
391
+ const renewIntervalMs = typeof assignment.renewIntervalMs === 'number' &&
392
+ Number.isFinite(assignment.renewIntervalMs) &&
393
+ assignment.renewIntervalMs > 0
394
+ ? assignment.renewIntervalMs
395
+ : this.leaseRenewIntervalMs;
396
+ record.renewHandle = this.scheduler.setInterval(() => {
397
+ void this.renewLease(job.id, claimToken);
398
+ }, renewIntervalMs);
399
+ let inputPath;
400
+ try {
401
+ const executor = this.executors.require(job.type);
402
+ let input;
403
+ let inputUrl;
404
+ let refreshInputUrl = async () => {
405
+ throw new Error(`Job ${job.id} (${job.type}) does not use input: 'url'; there is no input URL to refresh.`);
406
+ };
407
+ const inputMode = resolveInputMode(executor);
408
+ if (inputMode === 'download') {
409
+ const resolved = await spans.phase('job.download', () => this.downloadInput(job.id, job.type, claimToken), (downloaded) => ({ bytes: Number(downloaded.meta.size), inputMode: 'download' }));
410
+ inputPath = resolved.path;
411
+ input = resolved.meta;
412
+ this.emit({
413
+ kind: 'job-input',
414
+ at: this.iso(),
415
+ jobId: job.id,
416
+ objectId: resolved.meta.objectId,
417
+ bytes: resolved.meta.size,
418
+ });
419
+ }
420
+ else if (inputMode === 'url') {
421
+ // Nothing is downloaded: the span times only the URL request, and
422
+ // carries no byte count because no byte moved.
423
+ const holder = new InputUrlHolder(() => this.requestInputUrl(job.id, job.type, claimToken), () => this.now());
424
+ const resolved = await spans.phase('job.download', () => holder.first(), () => ({ inputMode: 'url' }));
425
+ inputUrl = resolved.url;
426
+ input = resolved.meta;
427
+ refreshInputUrl = () => holder.refresh();
428
+ this.emit({
429
+ kind: 'job-input',
430
+ at: this.iso(),
431
+ jobId: job.id,
432
+ objectId: resolved.meta.objectId,
433
+ bytes: resolved.meta.size,
434
+ });
435
+ }
436
+ const result = await spans.phase('job.execute', () => executor.execute({
437
+ job,
438
+ params,
439
+ inputPath,
440
+ inputUrl,
441
+ refreshInputUrl,
442
+ input,
443
+ // The same API, with `jobSecret` timed as the `job.secret` phase.
444
+ api: withSecretSpan(this.api, spans),
445
+ nodeId: this.nodeId,
446
+ // Handed on rather than kept private: `db.backup.run` asks for an
447
+ // upload target and a database credential ITSELF, and those are calls
448
+ // against a held job just as much as the renewal is.
449
+ claimToken,
450
+ signal: controller.signal,
451
+ log: (message, fields) => {
452
+ this.emit({
453
+ kind: 'job-log',
454
+ at: this.iso(),
455
+ jobId: job.id,
456
+ type: job.type,
457
+ message,
458
+ ...(fields !== undefined ? { fields } : {}),
459
+ });
460
+ },
461
+ // For a phase only the executor can see — an upload streamed from
462
+ // inside `execute`. Same recorder, same never-fails contract.
463
+ phase: (name, work, attributes) => spans.phase(name, work, attributes),
464
+ }), { attempt: job.attempts });
465
+ const settlement = await spans.phase('job.submit', () => this.api.submitResult(this.nodeId, job.id, job.type, result, claimToken));
466
+ this.counters.succeeded += 1;
467
+ const durationMs = this.now() - startedMs;
468
+ this.remember({
469
+ jobId: job.id,
470
+ type: job.type,
471
+ outcome: 'succeeded',
472
+ durationMs,
473
+ finishedAt: this.iso(),
474
+ });
475
+ this.emit({
476
+ kind: 'job-succeeded',
477
+ at: this.iso(),
478
+ jobId: job.id,
479
+ type: job.type,
480
+ durationMs,
481
+ outcome: settlement.outcome,
482
+ });
483
+ }
484
+ catch (error) {
485
+ await this.reportFailure(job.id, job.type, startedMs, error, claimToken, spans);
486
+ }
487
+ finally {
488
+ if (record.renewHandle !== undefined)
489
+ this.scheduler.clearInterval(record.renewHandle);
490
+ this.activeJobs.delete(job.id);
491
+ // AFTER the settle, and not awaited: the relay queues and sends on its
492
+ // own time. A slow or absent telemetry route cannot hold this slot.
493
+ this.spanRelay?.enqueue(spans.drain());
494
+ // ON SUCCESS, ON FAILURE AND ON DRAIN. A worker that leaks one temp file
495
+ // per job fills its volume in a week, and the failure that follows looks
496
+ // like a storage problem rather than a cleanup one.
497
+ if (inputPath !== undefined)
498
+ await safeUnlink(inputPath);
499
+ }
500
+ }
501
+ /**
502
+ * The one place a failure is classified.
503
+ *
504
+ * A `ProviderRateLimitError` and nothing else sets `rateLimited`. `willRetry`
505
+ * is advisory — the server owns the attempt budget and has the final word.
506
+ */
507
+ async reportFailure(jobId, type, startedMs, error, claimToken, spans) {
508
+ const rateLimit = error instanceof ProviderRateLimitError ? error : null;
509
+ const message = messageOf(error);
510
+ const durationMs = this.now() - startedMs;
511
+ this.counters.failed += 1;
512
+ if (rateLimit !== null)
513
+ this.counters.rateLimited += 1;
514
+ let willRetry = true;
515
+ try {
516
+ const report = () => this.api.reportJobFailure(this.nodeId, jobId, {
517
+ error: message,
518
+ willRetry: true,
519
+ ...(rateLimit !== null ? { rateLimited: true, retryAfterMs: rateLimit.retryAfterMs } : {}),
520
+ }, claimToken);
521
+ const settlement = spans !== undefined ? await spans.phase('job.submit', report) : await report();
522
+ willRetry = settlement.willRetry;
523
+ }
524
+ catch {
525
+ // The job is already leased to us and the server's reaper is the
526
+ // backstop; failing to REPORT a failure must not take the worker down.
527
+ }
528
+ this.remember({
529
+ jobId,
530
+ type,
531
+ outcome: 'failed',
532
+ durationMs,
533
+ finishedAt: this.iso(),
534
+ error: message,
535
+ ...(rateLimit !== null ? { rateLimited: true } : {}),
536
+ });
537
+ this.emit({
538
+ kind: 'job-failed',
539
+ at: this.iso(),
540
+ jobId,
541
+ type,
542
+ durationMs,
543
+ error: message,
544
+ rateLimited: rateLimit !== null,
545
+ willRetry,
546
+ });
547
+ }
548
+ /**
549
+ * Asks the server for the job's presigned input URL. Shared by both input
550
+ * modes; a failure or an empty URL is the named `MissingJobInputError`.
551
+ * The URL is a bearer capability: it is never put in an error message.
552
+ */
553
+ async requestInputUrl(jobId, type, claimToken) {
554
+ let signed;
555
+ try {
556
+ signed = await this.api.downloadUrl(this.nodeId, jobId, claimToken);
557
+ }
558
+ catch (error) {
559
+ throw new MissingJobInputError(jobId, type, messageOf(error));
560
+ }
561
+ if (signed?.url === undefined || signed.url.length === 0) {
562
+ throw new MissingJobInputError(jobId, type, 'the server returned an empty URL');
563
+ }
564
+ return signed;
565
+ }
566
+ /**
567
+ * Stream the job's input to a temp file.
568
+ *
569
+ * A `requiresInput` type with no download URL fails with a NAMED error here
570
+ * — never an empty path handed downstream, which surfaces much later as an
571
+ * opaque `ENOENT … open ''` that names neither the job nor the type.
572
+ */
573
+ async downloadInput(jobId, type, claimToken) {
574
+ const signed = await this.requestInputUrl(jobId, type, claimToken);
575
+ await mkdir(this.tmpDir, { recursive: true, mode: 0o700 });
576
+ // Randomised, not job-id-derived: two attempts of the same job on the same
577
+ // machine must not race on one path.
578
+ const path = join(this.tmpDir, `${jobId}.${randomBytes(6).toString('hex')}.input`);
579
+ const response = await this.fetchImpl(signed.url);
580
+ if (!response.ok || response.body === null) {
581
+ throw new MissingJobInputError(jobId, type, `download failed with HTTP ${response.status}`);
582
+ }
583
+ // Streamed, never buffered. The whole reason this type is worth running on
584
+ // a node is that a 10 GB object costs a file handle, not 10 GB of heap.
585
+ await pipeline(Readable.fromWeb(response.body), createWriteStream(path, { mode: 0o600 }));
586
+ return {
587
+ path,
588
+ meta: { objectId: signed.objectId, size: signed.size, mimeType: signed.mimeType },
589
+ };
590
+ }
591
+ /**
592
+ * Renew failure is NON-FATAL: the server's reaper is the backstop.
593
+ *
594
+ * That already covered the lease simply having expired, and since #364 it
595
+ * covers one more case on the same path: a `409` because the token quoted
596
+ * belongs to an EARLIER claim of this job. Deliberately no new handling —
597
+ * both mean "this slot no longer speaks for this job", the emitted
598
+ * `lease-renew-failed` says so, and the executor keeps running until it
599
+ * finishes or is drained. Tearing the job down here instead would be this
600
+ * slot acting on a fact it cannot verify, which is the shape of the bug
601
+ * #364 is fixing rather than a fix for it.
602
+ */
603
+ async renewLease(jobId, claimToken) {
604
+ const record = this.activeJobs.get(jobId);
605
+ if (record === undefined)
606
+ return;
607
+ try {
608
+ const renewed = await this.api.renewLease(this.nodeId, jobId, claimToken);
609
+ record.leaseExpiresAt = renewed.leaseExpiresAt;
610
+ this.loopCounters.leaseRenewals += 1;
611
+ this.emit({ kind: 'lease-renewed', at: this.iso(), jobId, leaseExpiresAt: renewed.leaseExpiresAt });
612
+ }
613
+ catch (error) {
614
+ this.loopCounters.leaseRenewFailures += 1;
615
+ this.emit({ kind: 'lease-renew-failed', at: this.iso(), jobId, error: messageOf(error) });
616
+ }
617
+ }
618
+ // ---------------------------------------------------------------------------
619
+ // Heartbeat
620
+ // ---------------------------------------------------------------------------
621
+ startHeartbeat() {
622
+ if (this.heartbeatHandle !== undefined)
623
+ return;
624
+ // NOT `unref`'d — see the file header. This timer is what keeps an idle
625
+ // worker process alive.
626
+ this.heartbeatHandle = this.scheduler.setInterval(() => {
627
+ void this.beat();
628
+ }, this.heartbeatIntervalMs);
629
+ this.ensurePowerPoll();
630
+ void this.beat();
631
+ }
632
+ /** A plug/unplug is worth reporting within seconds, not a heartbeat later. */
633
+ ensurePowerPoll() {
634
+ if (this.powerPollHandle !== undefined || !this.hostEnabled || this.hostTelemetry === undefined)
635
+ return;
636
+ this.powerPollHandle = this.scheduler.setInterval(() => {
637
+ void this.pollPower();
638
+ }, this.powerPollIntervalMs);
639
+ }
640
+ /**
641
+ * Learns the server's features from a heartbeat response (an already
642
+ * registered node never calls register again). The first heartbeat carries
643
+ * plain vitals; once the response advertises `node_host_vitals`, later ones
644
+ * carry host, power and events.
645
+ */
646
+ learnServerFeatures(response) {
647
+ const features = response?.serverFeatures;
648
+ if (!Array.isArray(features) || this.hostTelemetry === undefined || this.hostRefused)
649
+ return;
650
+ if (features.includes(SERVER_FEATURE_HOST_VITALS) && !this.hostEnabled) {
651
+ this.hostEnabled = true;
652
+ if (this.heartbeatHandle !== undefined)
653
+ this.ensurePowerPoll();
654
+ }
655
+ }
656
+ /**
657
+ * Re-read power between heartbeats. Events go to the queue; a power SOURCE
658
+ * change also fires one extra heartbeat (debounced to one per 5 s).
659
+ */
660
+ async pollPower() {
661
+ if (!this.hostEnabled || this.hostTelemetry === undefined)
662
+ return;
663
+ try {
664
+ const snapshot = await this.hostTelemetry.collect({ disk: this.lastDiskFree, fresh: true });
665
+ if (snapshot.events.length === 0)
666
+ return;
667
+ this.eventQueue.push(snapshot.events);
668
+ if (snapshot.events.some((event) => event.type === 'power.source_changed')) {
669
+ const nowMs = this.now();
670
+ if (this.lastExtraBeatMs === undefined || nowMs - this.lastExtraBeatMs >= 5_000) {
671
+ this.lastExtraBeatMs = nowMs;
672
+ void this.beat();
673
+ }
674
+ }
675
+ }
676
+ catch {
677
+ // best-effort
678
+ }
679
+ }
680
+ /**
681
+ * One heartbeat. NEVER REJECTS, and a failure never stops the engine: the
682
+ * server's liveness sweep is what acts on a silent node, and the next tick
683
+ * tries again.
684
+ *
685
+ * THE VITALS FALLBACK (#605). A server older than #604 may refuse the
686
+ * unknown `vitals` key with a 400 — and a node whose every heartbeat is a
687
+ * 400 goes stale and is swept offline, which is a far worse outcome than a
688
+ * fleet page without vitals. So a 400 on a beat that CARRIED vitals is
689
+ * retried once, immediately, without them, and vitals are dropped for the
690
+ * rest of this process (a restart — typically an upgrade — tries again).
691
+ * Announced once, through `vitals-disabled`. A 400 on a beat without vitals
692
+ * is an ordinary failure: there is nothing left to take out.
693
+ */
694
+ async beat() {
695
+ if (this.refreshCapabilities !== undefined) {
696
+ try {
697
+ const fresh = await this.refreshCapabilities();
698
+ if (fresh !== undefined)
699
+ this.capabilities = fresh;
700
+ }
701
+ catch {
702
+ // a failed refresh keeps the last summary; a probe must not cost a heartbeat
703
+ }
704
+ }
705
+ const base = {
706
+ status: 'online',
707
+ concurrency: this.concurrency,
708
+ ...(this.capabilities !== undefined ? { capabilities: this.capabilities } : {}),
709
+ };
710
+ let vitals = this.vitalsEnabled ? this.sampleVitals() : undefined;
711
+ let events = [];
712
+ if (this.hostEnabled && this.hostTelemetry !== undefined) {
713
+ const disk = { freeBytes: vitals?.stateDirFreeBytes, totalBytes: vitals?.stateDirTotalBytes };
714
+ this.lastDiskFree = disk;
715
+ try {
716
+ const snapshot = await this.hostTelemetry.collect({ disk });
717
+ this.eventQueue.push(snapshot.events);
718
+ if (vitals !== undefined || this.collectVitals === undefined) {
719
+ vitals = { ...(vitals ?? {}), host: snapshot.host, ...(snapshot.power !== undefined ? { power: snapshot.power } : {}) };
720
+ }
721
+ }
722
+ catch {
723
+ // best-effort: the heartbeat goes without host fields
724
+ }
725
+ events = this.eventQueue.drain();
726
+ }
727
+ const withHost = vitals !== undefined && (vitals.host !== undefined || vitals.power !== undefined);
728
+ const carriesHostFields = withHost || events.length > 0;
729
+ const full = (v, ev) => ({
730
+ ...base,
731
+ ...(v !== undefined ? { vitals: v } : {}),
732
+ ...(ev.length > 0 ? { events: ev } : {}),
733
+ });
734
+ try {
735
+ try {
736
+ this.learnServerFeatures(await this.api.heartbeat(this.nodeId, full(vitals, events)));
737
+ }
738
+ catch (error) {
739
+ const refused = error instanceof ApiError && error.status === 400;
740
+ if (refused && carriesHostFields) {
741
+ // The server advertised the feature but refused the body: stop sending host fields for this process.
742
+ this.hostEnabled = false;
743
+ this.hostRefused = true;
744
+ this.eventQueue.requeue(events);
745
+ events = [];
746
+ const { host: _host, power: _power, ...plain } = vitals ?? {};
747
+ vitals = vitals === undefined ? undefined : plain;
748
+ this.emit({ kind: 'vitals-disabled', at: this.iso(), error: messageOf(error) });
749
+ try {
750
+ await this.api.heartbeat(this.nodeId, full(vitals, []));
751
+ }
752
+ catch (second) {
753
+ if (vitals === undefined || !(second instanceof ApiError) || second.status !== 400)
754
+ throw second;
755
+ this.vitalsEnabled = false;
756
+ await this.api.heartbeat(this.nodeId, base);
757
+ }
758
+ }
759
+ else {
760
+ if (vitals === undefined || !(error instanceof ApiError) || error.status !== 400)
761
+ throw error;
762
+ if (this.vitalsEnabled) {
763
+ this.vitalsEnabled = false;
764
+ this.emit({ kind: 'vitals-disabled', at: this.iso(), error: messageOf(error) });
765
+ }
766
+ await this.api.heartbeat(this.nodeId, base);
767
+ }
768
+ }
769
+ this.lastHeartbeatMs = this.now();
770
+ this.emit({ kind: 'heartbeat', at: this.iso(), concurrency: this.concurrency });
771
+ }
772
+ catch (error) {
773
+ this.eventQueue.requeue(events);
774
+ this.loopCounters.heartbeatFailures += 1;
775
+ this.emit({ kind: 'heartbeat-failed', at: this.iso(), error: messageOf(error) });
776
+ }
777
+ }
778
+ /** The collector's snapshot, or `undefined` if it threw. Never throws. */
779
+ sampleVitals() {
780
+ if (this.collectVitals === undefined)
781
+ return undefined;
782
+ try {
783
+ const vitals = this.collectVitals({
784
+ slotsUsed: this.inFlight.size,
785
+ slotsTotal: this.concurrency,
786
+ counters: this.getVitalsCounters(),
787
+ });
788
+ const extra = this.collectExtraVitals();
789
+ return extra === undefined ? vitals : { ...vitals, extra };
790
+ }
791
+ catch {
792
+ return undefined;
793
+ }
794
+ }
795
+ /**
796
+ * The executors' app-defined vitals, merged (a later executor in type order
797
+ * wins a repeated key) and sanitized to the server's bounds. Never throws:
798
+ * one executor's faulty `vitals()` costs only its own numbers.
799
+ */
800
+ collectExtraVitals() {
801
+ const merged = {};
802
+ for (const executor of this.executors.list()) {
803
+ if (typeof executor.vitals !== 'function')
804
+ continue;
805
+ try {
806
+ // Sanitized per executor FIRST: only pattern-checked keys are copied,
807
+ // so no executor can write a prototype key into the merged record.
808
+ const own = sanitizeExtraVitals(executor.vitals());
809
+ if (own !== undefined)
810
+ for (const key of Object.keys(own))
811
+ merged[key] = own[key];
812
+ }
813
+ catch {
814
+ // An app vital never costs the heartbeat.
815
+ }
816
+ }
817
+ return sanitizeExtraVitals(merged);
818
+ }
819
+ // ---------------------------------------------------------------------------
820
+ // Small internals
821
+ // ---------------------------------------------------------------------------
822
+ /** Bounded at HISTORY_LIMIT: a daemon runs for months. */
823
+ remember(entry) {
824
+ this.history.unshift(entry);
825
+ if (this.history.length > HISTORY_LIMIT)
826
+ this.history.length = HISTORY_LIMIT;
827
+ }
828
+ /** Memoised, so every racer in one pass awaits the SAME promise. */
829
+ waitForWake() {
830
+ if (this.wake === undefined) {
831
+ let resolve;
832
+ const promise = new Promise((res) => {
833
+ resolve = res;
834
+ });
835
+ this.wake = { promise, resolve };
836
+ }
837
+ return this.wake.promise;
838
+ }
839
+ signalWake() {
840
+ const pending = this.wake;
841
+ this.wake = undefined;
842
+ pending?.resolve();
843
+ }
844
+ emit(event) {
845
+ try {
846
+ this.onEvent?.(event);
847
+ }
848
+ catch {
849
+ // A consumer that throws — a wedged renderer, a broken IPC client — must
850
+ // never take the worker down. #275's backlog guard is the other half.
851
+ }
852
+ }
853
+ iso() {
854
+ return new Date(this.now()).toISOString();
855
+ }
856
+ }
857
+ /**
858
+ * `api` as an executor sees it: identical, except that `jobSecret` is timed as
859
+ * the `job.secret` phase (#608). A Proxy rather than a copied object because
860
+ * `HttpNodeApi`'s methods live on its prototype, which a spread would drop.
861
+ */
862
+ function withSecretSpan(api, spans) {
863
+ return new Proxy(api, {
864
+ get(target, property, receiver) {
865
+ if (property === 'jobSecret') {
866
+ return (...args) => spans.phase('job.secret', () => target.jobSecret(...args));
867
+ }
868
+ const value = Reflect.get(target, property, receiver);
869
+ return typeof value === 'function' ? value.bind(target) : value;
870
+ },
871
+ });
872
+ }
873
+ function messageOf(error) {
874
+ return error instanceof Error ? error.message : String(error);
875
+ }
876
+ async function safeUnlink(path) {
877
+ try {
878
+ await rm(path, { force: true });
879
+ }
880
+ catch {
881
+ // Best effort. A file we cannot remove is a disk-space problem to log,
882
+ // never a reason to fail a job that already succeeded.
883
+ }
884
+ }
885
+ /** Refresh the input URL once it has less than this long left. */
886
+ const INPUT_URL_REFRESH_WINDOW_MS = 60_000;
887
+ /**
888
+ * Holds a job's presigned input URL for `input: 'url'` mode and re-requests it
889
+ * shortly before it expires. Single-flight: concurrent `refresh()` calls share
890
+ * one request. The URL never leaves this object except as a return value.
891
+ */
892
+ class InputUrlHolder {
893
+ request;
894
+ now;
895
+ current;
896
+ inflight;
897
+ constructor(request, now) {
898
+ this.request = request;
899
+ this.now = now;
900
+ }
901
+ async first() {
902
+ const signed = await this.request();
903
+ this.current = signed;
904
+ return { url: signed.url, meta: { objectId: signed.objectId, size: signed.size, mimeType: signed.mimeType } };
905
+ }
906
+ refresh() {
907
+ const held = this.current;
908
+ if (held !== undefined) {
909
+ const expiresMs = Date.parse(held.expiresAt);
910
+ // An unparseable expiry is treated as expired: asking again is safe.
911
+ if (Number.isFinite(expiresMs) && expiresMs - this.now() > INPUT_URL_REFRESH_WINDOW_MS)
912
+ return Promise.resolve(held.url);
913
+ }
914
+ this.inflight ??= this.request()
915
+ .then((signed) => {
916
+ this.current = signed;
917
+ return signed.url;
918
+ })
919
+ .finally(() => {
920
+ this.inflight = undefined;
921
+ });
922
+ return this.inflight;
923
+ }
924
+ }
925
+ //# sourceMappingURL=node-engine.js.map