@dreamlake/dreamlake-cli 0.88.0 → 0.89.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 (535) hide show
  1. package/dist/api/access.d.ts +83 -0
  2. package/dist/api/access.js +77 -0
  3. package/dist/api/agent.d.ts +156 -0
  4. package/dist/api/agent.js +111 -0
  5. package/dist/api/browser.d.ts +90 -0
  6. package/dist/api/browser.js +102 -0
  7. package/dist/api/client.d.ts +53 -0
  8. package/dist/api/client.js +102 -0
  9. package/dist/api/common.d.ts +28 -0
  10. package/dist/api/common.js +16 -0
  11. package/dist/api/content.d.ts +195 -0
  12. package/dist/api/content.js +147 -0
  13. package/dist/api/execution.d.ts +84 -0
  14. package/dist/api/execution.js +73 -0
  15. package/dist/api/http.d.ts +19 -0
  16. package/dist/api/http.js +66 -0
  17. package/dist/api/index.d.ts +2330 -0
  18. package/dist/api/index.js +114 -0
  19. package/dist/api/infra.d.ts +2 -0
  20. package/dist/api/infra.js +2 -0
  21. package/dist/api/jobs.d.ts +2 -0
  22. package/dist/api/jobs.js +2 -0
  23. package/dist/api/layout.d.ts +2 -0
  24. package/dist/api/layout.js +2 -0
  25. package/dist/api/library-edit.d.ts +3 -0
  26. package/dist/api/library-edit.js +3 -0
  27. package/dist/api/library-manifest.d.ts +2 -0
  28. package/dist/api/library-manifest.js +2 -0
  29. package/dist/api/note-character-plan.d.ts +2 -0
  30. package/dist/api/note-character-plan.js +2 -0
  31. package/dist/api/note-editing.d.ts +2 -0
  32. package/dist/api/note-editing.js +2 -0
  33. package/dist/api/note-edits.d.ts +21 -0
  34. package/dist/api/note-edits.js +10 -0
  35. package/dist/api/note-events.d.ts +5 -0
  36. package/dist/api/note-events.js +11 -0
  37. package/dist/api/note-files.d.ts +75 -0
  38. package/dist/api/note-files.js +65 -0
  39. package/dist/api/note-html-read.d.ts +2 -0
  40. package/dist/api/note-html-read.js +2 -0
  41. package/dist/api/note-html.d.ts +2 -0
  42. package/dist/api/note-html.js +2 -0
  43. package/dist/api/note-toc.d.ts +2 -0
  44. package/dist/api/note-toc.js +2 -0
  45. package/dist/api/notes.d.ts +304 -0
  46. package/dist/api/notes.js +181 -0
  47. package/dist/api/open-resources.d.ts +27 -0
  48. package/dist/api/open-resources.js +102 -0
  49. package/dist/api/ownership.d.ts +12 -0
  50. package/dist/api/ownership.js +24 -0
  51. package/dist/api/platform.d.ts +83 -0
  52. package/dist/api/platform.js +56 -0
  53. package/dist/api/presigned-transfer.d.ts +2 -0
  54. package/dist/api/presigned-transfer.js +2 -0
  55. package/dist/api/registered-runs.d.ts +48 -0
  56. package/dist/api/registered-runs.js +33 -0
  57. package/dist/api/sessions.d.ts +299 -0
  58. package/dist/api/sessions.js +105 -0
  59. package/dist/api/storage.d.ts +46 -0
  60. package/dist/api/storage.js +34 -0
  61. package/dist/api/streams.d.ts +18 -0
  62. package/dist/api/streams.js +70 -0
  63. package/dist/api/vault.d.ts +93 -0
  64. package/dist/api/vault.js +79 -0
  65. package/dist/api/workspace.d.ts +180 -0
  66. package/dist/api/workspace.js +146 -0
  67. package/dist/cli/agent-identity.d.ts +4 -0
  68. package/dist/cli/agent-identity.js +21 -0
  69. package/dist/cli/agents/identity.d.ts +50 -0
  70. package/dist/cli/agents/identity.js +105 -0
  71. package/dist/cli/agents/index.d.ts +31 -0
  72. package/dist/cli/agents/index.js +580 -0
  73. package/dist/cli/agents/manage.d.ts +43 -0
  74. package/dist/cli/agents/manage.js +376 -0
  75. package/dist/cli/agents/spec.d.ts +104 -0
  76. package/dist/cli/agents/spec.js +280 -0
  77. package/dist/cli/agents/web.d.ts +7 -0
  78. package/dist/cli/agents/web.js +109 -0
  79. package/dist/cli/artifact/incremental.d.ts +21 -0
  80. package/dist/cli/artifact/incremental.js +80 -0
  81. package/dist/cli/artifact/index.d.ts +52 -0
  82. package/dist/cli/artifact/index.js +405 -0
  83. package/dist/cli/artifact/meta.d.ts +69 -0
  84. package/dist/cli/artifact/meta.js +189 -0
  85. package/dist/cli/auth/commands.d.ts +29 -0
  86. package/dist/cli/auth/commands.js +327 -0
  87. package/dist/cli/auth/constants.d.ts +13 -0
  88. package/dist/cli/auth/constants.js +18 -0
  89. package/dist/cli/auth/credentials.d.ts +37 -0
  90. package/dist/cli/auth/credentials.js +155 -0
  91. package/dist/cli/auth/device-flow.d.ts +32 -0
  92. package/dist/cli/auth/device-flow.js +154 -0
  93. package/dist/cli/auth/device-secret.d.ts +6 -0
  94. package/dist/cli/auth/device-secret.js +26 -0
  95. package/dist/cli/auth/machine.d.ts +15 -0
  96. package/dist/cli/auth/machine.js +126 -0
  97. package/dist/cli/auth/materialized.d.ts +32 -0
  98. package/dist/cli/auth/materialized.js +102 -0
  99. package/dist/cli/auth/migrate.d.ts +10 -0
  100. package/dist/cli/auth/migrate.js +75 -0
  101. package/dist/cli/client.d.ts +102 -0
  102. package/dist/cli/client.js +206 -0
  103. package/dist/cli/collection-list.d.ts +3 -0
  104. package/dist/cli/collection-list.js +25 -0
  105. package/dist/cli/compat/ctx.d.ts +26 -0
  106. package/dist/cli/compat/ctx.js +76 -0
  107. package/dist/cli/compat/dreamdb-wasm-embedded.d.ts +2 -0
  108. package/dist/cli/compat/dreamdb-wasm-embedded.js +8 -0
  109. package/dist/cli/compat/dreamdb-wasm.d.ts +1 -0
  110. package/dist/cli/compat/dreamdb-wasm.js +26 -0
  111. package/dist/cli/compat/dreamdb.d.ts +112 -0
  112. package/dist/cli/compat/dreamdb.js +219 -0
  113. package/dist/cli/compat/flags.d.ts +2 -0
  114. package/dist/cli/compat/flags.js +13 -0
  115. package/dist/cli/compat/http.d.ts +23 -0
  116. package/dist/cli/compat/http.js +137 -0
  117. package/dist/cli/compat/presignedTransfer.d.ts +139 -0
  118. package/dist/cli/compat/presignedTransfer.js +580 -0
  119. package/dist/cli/compat/s3-backend.d.ts +73 -0
  120. package/dist/cli/compat/s3-backend.js +132 -0
  121. package/dist/cli/config.d.ts +22 -0
  122. package/dist/cli/config.js +96 -0
  123. package/dist/cli/connection/dto.d.ts +159 -0
  124. package/dist/cli/connection/dto.js +497 -0
  125. package/dist/cli/connection/index.d.ts +50 -0
  126. package/dist/cli/connection/index.js +413 -0
  127. package/dist/cli/connection/oauth.d.ts +23 -0
  128. package/dist/cli/connection/oauth.js +290 -0
  129. package/dist/cli/connection/write.d.ts +47 -0
  130. package/dist/cli/connection/write.js +573 -0
  131. package/dist/cli/create/index.d.ts +19 -0
  132. package/dist/cli/create/index.js +209 -0
  133. package/dist/cli/declare/index.d.ts +29 -0
  134. package/dist/cli/declare/index.js +304 -0
  135. package/dist/cli/delete/index.d.ts +18 -0
  136. package/dist/cli/delete/index.js +232 -0
  137. package/dist/cli/download/index.d.ts +9 -0
  138. package/dist/cli/download/index.js +128 -0
  139. package/dist/cli/env/compose.d.ts +88 -0
  140. package/dist/cli/env/compose.js +402 -0
  141. package/dist/cli/env/index.d.ts +176 -0
  142. package/dist/cli/env/index.js +1011 -0
  143. package/dist/cli/experiments/index.d.ts +11 -0
  144. package/dist/cli/experiments/index.js +168 -0
  145. package/dist/cli/glob.d.ts +1 -0
  146. package/dist/cli/glob.js +45 -0
  147. package/dist/cli/graphql-helpers.d.ts +23 -0
  148. package/dist/cli/graphql-helpers.js +42 -0
  149. package/dist/cli/graphql.d.ts +10 -0
  150. package/dist/cli/graphql.js +47 -0
  151. package/dist/cli/help-examples.generated.d.ts +1 -0
  152. package/dist/cli/help-examples.generated.js +192 -0
  153. package/dist/cli/helpers.d.ts +8 -0
  154. package/dist/cli/helpers.js +106 -0
  155. package/dist/cli/hosts/api.d.ts +29 -0
  156. package/dist/cli/hosts/api.js +54 -0
  157. package/dist/cli/hosts/bootstrap-source.d.ts +1 -0
  158. package/dist/cli/hosts/bootstrap-source.js +2 -0
  159. package/dist/cli/hosts/catalog.d.ts +26 -0
  160. package/dist/cli/hosts/catalog.js +55 -0
  161. package/dist/cli/hosts/config.d.ts +45 -0
  162. package/dist/cli/hosts/config.js +179 -0
  163. package/dist/cli/hosts/credentials.d.ts +19 -0
  164. package/dist/cli/hosts/credentials.js +173 -0
  165. package/dist/cli/hosts/enroll.d.ts +17 -0
  166. package/dist/cli/hosts/enroll.js +109 -0
  167. package/dist/cli/hosts/enrollments.d.ts +25 -0
  168. package/dist/cli/hosts/enrollments.js +54 -0
  169. package/dist/cli/hosts/index.d.ts +6 -0
  170. package/dist/cli/hosts/index.js +279 -0
  171. package/dist/cli/hosts/inventory.d.ts +40 -0
  172. package/dist/cli/hosts/inventory.js +91 -0
  173. package/dist/cli/hosts/lifecycle.d.ts +15 -0
  174. package/dist/cli/hosts/lifecycle.js +108 -0
  175. package/dist/cli/hosts/metrics-source.d.ts +12 -0
  176. package/dist/cli/hosts/metrics-source.js +89 -0
  177. package/dist/cli/hosts/observations.d.ts +39 -0
  178. package/dist/cli/hosts/observations.js +102 -0
  179. package/dist/cli/hosts/remote.d.ts +5 -0
  180. package/dist/cli/hosts/remote.js +66 -0
  181. package/dist/cli/hosts/ssh.d.ts +63 -0
  182. package/dist/cli/hosts/ssh.js +276 -0
  183. package/dist/cli/index.d.ts +1 -0
  184. package/dist/cli/index.js +288 -0
  185. package/dist/cli/infra/api.d.ts +95 -0
  186. package/dist/cli/infra/api.js +291 -0
  187. package/dist/cli/infra/index.d.ts +5 -0
  188. package/dist/cli/infra/index.js +102 -0
  189. package/dist/cli/infra/move.d.ts +15 -0
  190. package/dist/cli/infra/move.js +123 -0
  191. package/dist/cli/infra/transfer.d.ts +15 -0
  192. package/dist/cli/infra/transfer.js +280 -0
  193. package/dist/cli/jobs/api.d.ts +69 -0
  194. package/dist/cli/jobs/api.js +121 -0
  195. package/dist/cli/jobs/index.d.ts +5 -0
  196. package/dist/cli/jobs/index.js +140 -0
  197. package/dist/cli/lakeshore/index.d.ts +98 -0
  198. package/dist/cli/lakeshore/index.js +502 -0
  199. package/dist/cli/launch/index.d.ts +43 -0
  200. package/dist/cli/launch/index.js +270 -0
  201. package/dist/cli/layout/index.d.ts +2 -0
  202. package/dist/cli/layout/index.js +44 -0
  203. package/dist/cli/layout/transport.d.ts +12 -0
  204. package/dist/cli/layout/transport.js +70 -0
  205. package/dist/cli/library/add.d.ts +60 -0
  206. package/dist/cli/library/add.js +348 -0
  207. package/dist/cli/library/cache.d.ts +26 -0
  208. package/dist/cli/library/cache.js +88 -0
  209. package/dist/cli/library/config.d.ts +75 -0
  210. package/dist/cli/library/config.js +198 -0
  211. package/dist/cli/library/digest.d.ts +5 -0
  212. package/dist/cli/library/digest.js +19 -0
  213. package/dist/cli/library/discover.d.ts +87 -0
  214. package/dist/cli/library/discover.js +534 -0
  215. package/dist/cli/library/freshness.d.ts +35 -0
  216. package/dist/cli/library/freshness.js +109 -0
  217. package/dist/cli/library/generation.d.ts +35 -0
  218. package/dist/cli/library/generation.js +211 -0
  219. package/dist/cli/library/index.d.ts +2 -0
  220. package/dist/cli/library/index.js +36 -0
  221. package/dist/cli/library/info.d.ts +69 -0
  222. package/dist/cli/library/info.js +311 -0
  223. package/dist/cli/library/list.d.ts +33 -0
  224. package/dist/cli/library/list.js +86 -0
  225. package/dist/cli/library/manifest.d.ts +81 -0
  226. package/dist/cli/library/manifest.js +200 -0
  227. package/dist/cli/library/manifestCache.d.ts +45 -0
  228. package/dist/cli/library/manifestCache.js +169 -0
  229. package/dist/cli/library/pull.d.ts +30 -0
  230. package/dist/cli/library/pull.js +438 -0
  231. package/dist/cli/library/push.d.ts +72 -0
  232. package/dist/cli/library/push.js +642 -0
  233. package/dist/cli/library/rm.d.ts +31 -0
  234. package/dist/cli/library/rm.js +200 -0
  235. package/dist/cli/library/search.d.ts +18 -0
  236. package/dist/cli/library/search.js +181 -0
  237. package/dist/cli/library/stat.d.ts +15 -0
  238. package/dist/cli/library/stat.js +127 -0
  239. package/dist/cli/library/tools.d.ts +104 -0
  240. package/dist/cli/library/tools.js +163 -0
  241. package/dist/cli/library/wire.d.ts +47 -0
  242. package/dist/cli/library/wire.js +120 -0
  243. package/dist/cli/list/index.d.ts +26 -0
  244. package/dist/cli/list/index.js +256 -0
  245. package/dist/cli/notes/character-plan.d.ts +22 -0
  246. package/dist/cli/notes/character-plan.js +232 -0
  247. package/dist/cli/notes/document.d.ts +73 -0
  248. package/dist/cli/notes/document.js +306 -0
  249. package/dist/cli/notes/edit-commands.d.ts +106 -0
  250. package/dist/cli/notes/edit-commands.js +623 -0
  251. package/dist/cli/notes/editing.d.ts +81 -0
  252. package/dist/cli/notes/editing.js +305 -0
  253. package/dist/cli/notes/events.d.ts +36 -0
  254. package/dist/cli/notes/events.js +54 -0
  255. package/dist/cli/notes/files-commands.d.ts +120 -0
  256. package/dist/cli/notes/files-commands.js +554 -0
  257. package/dist/cli/notes/html-read.d.ts +9 -0
  258. package/dist/cli/notes/html-read.js +90 -0
  259. package/dist/cli/notes/html.d.ts +73 -0
  260. package/dist/cli/notes/html.js +381 -0
  261. package/dist/cli/notes/index.d.ts +123 -0
  262. package/dist/cli/notes/index.js +1303 -0
  263. package/dist/cli/notes/linger.d.ts +59 -0
  264. package/dist/cli/notes/linger.js +339 -0
  265. package/dist/cli/notes/media-commands.d.ts +5 -0
  266. package/dist/cli/notes/media-commands.js +51 -0
  267. package/dist/cli/notes/move-command.d.ts +83 -0
  268. package/dist/cli/notes/move-command.js +259 -0
  269. package/dist/cli/notes/rm-command.d.ts +22 -0
  270. package/dist/cli/notes/rm-command.js +110 -0
  271. package/dist/cli/notes/select-command.d.ts +12 -0
  272. package/dist/cli/notes/select-command.js +84 -0
  273. package/dist/cli/notes/suggest-diff.d.ts +56 -0
  274. package/dist/cli/notes/suggest-diff.js +311 -0
  275. package/dist/cli/notes/toc.d.ts +38 -0
  276. package/dist/cli/notes/toc.js +144 -0
  277. package/dist/cli/notes/transfer-command.d.ts +6 -0
  278. package/dist/cli/notes/transfer-command.js +9 -0
  279. package/dist/cli/notes/version-commands.d.ts +19 -0
  280. package/dist/cli/notes/version-commands.js +178 -0
  281. package/dist/cli/nymph/index.d.ts +74 -0
  282. package/dist/cli/nymph/index.js +349 -0
  283. package/dist/cli/org/index.d.ts +34 -0
  284. package/dist/cli/org/index.js +341 -0
  285. package/dist/cli/ownership/index.d.ts +12 -0
  286. package/dist/cli/ownership/index.js +122 -0
  287. package/dist/cli/ownership/metadata-transfer.d.ts +20 -0
  288. package/dist/cli/ownership/metadata-transfer.js +159 -0
  289. package/dist/cli/page/index.d.ts +58 -0
  290. package/dist/cli/page/index.js +387 -0
  291. package/dist/cli/pipeline/index.d.ts +69 -0
  292. package/dist/cli/pipeline/index.js +604 -0
  293. package/dist/cli/progress.d.ts +60 -0
  294. package/dist/cli/progress.js +276 -0
  295. package/dist/cli/project/attachments.d.ts +10 -0
  296. package/dist/cli/project/attachments.js +39 -0
  297. package/dist/cli/project/grants.d.ts +10 -0
  298. package/dist/cli/project/grants.js +39 -0
  299. package/dist/cli/project/index.d.ts +8 -0
  300. package/dist/cli/project/index.js +92 -0
  301. package/dist/cli/project/move.d.ts +57 -0
  302. package/dist/cli/project/move.js +242 -0
  303. package/dist/cli/project/output.d.ts +2 -0
  304. package/dist/cli/project/output.js +29 -0
  305. package/dist/cli/project/stream.d.ts +55 -0
  306. package/dist/cli/project/stream.js +207 -0
  307. package/dist/cli/project/transfer-preview.d.ts +8 -0
  308. package/dist/cli/project/transfer-preview.js +10 -0
  309. package/dist/cli/prompt.d.ts +1 -0
  310. package/dist/cli/prompt.js +17 -0
  311. package/dist/cli/provider/dreamdir.d.ts +52 -0
  312. package/dist/cli/provider/dreamdir.js +138 -0
  313. package/dist/cli/provider/index.d.ts +4 -0
  314. package/dist/cli/provider/index.js +419 -0
  315. package/dist/cli/provider/jump-worker.d.ts +9 -0
  316. package/dist/cli/provider/jump-worker.js +141 -0
  317. package/dist/cli/provider/lifecycle.d.ts +149 -0
  318. package/dist/cli/provider/lifecycle.js +1390 -0
  319. package/dist/cli/provider/machine.d.ts +17 -0
  320. package/dist/cli/provider/machine.js +116 -0
  321. package/dist/cli/provider/ssh.d.ts +105 -0
  322. package/dist/cli/provider/ssh.js +305 -0
  323. package/dist/cli/provider/terraform.d.ts +140 -0
  324. package/dist/cli/provider/terraform.js +288 -0
  325. package/dist/cli/providers/index.d.ts +18 -0
  326. package/dist/cli/providers/index.js +422 -0
  327. package/dist/cli/python.d.ts +61 -0
  328. package/dist/cli/python.js +255 -0
  329. package/dist/cli/queues/index.d.ts +33 -0
  330. package/dist/cli/queues/index.js +248 -0
  331. package/dist/cli/queues/slurm.d.ts +10 -0
  332. package/dist/cli/queues/slurm.js +134 -0
  333. package/dist/cli/resources.d.ts +72 -0
  334. package/dist/cli/resources.js +137 -0
  335. package/dist/cli/run/index.d.ts +15 -0
  336. package/dist/cli/run/index.js +163 -0
  337. package/dist/cli/run/input.d.ts +34 -0
  338. package/dist/cli/run/input.js +135 -0
  339. package/dist/cli/run/recovery.d.ts +2 -0
  340. package/dist/cli/run/recovery.js +18 -0
  341. package/dist/cli/run/setup.d.ts +3 -0
  342. package/dist/cli/run/setup.js +62 -0
  343. package/dist/cli/runconfig/index.d.ts +12 -0
  344. package/dist/cli/runconfig/index.js +130 -0
  345. package/dist/cli/runnable/index.d.ts +35 -0
  346. package/dist/cli/runnable/index.js +575 -0
  347. package/dist/cli/runnable/path.d.ts +115 -0
  348. package/dist/cli/runnable/path.js +288 -0
  349. package/dist/cli/runnable/run.d.ts +91 -0
  350. package/dist/cli/runnable/run.js +239 -0
  351. package/dist/cli/runnable/upload.d.ts +43 -0
  352. package/dist/cli/runnable/upload.js +342 -0
  353. package/dist/cli/runnable/worker.d.ts +1 -0
  354. package/dist/cli/runnable/worker.js +44 -0
  355. package/dist/cli/schemas/workflow-spec.schema.json +335 -0
  356. package/dist/cli/self-update/index.d.ts +5 -0
  357. package/dist/cli/self-update/index.js +107 -0
  358. package/dist/cli/self-update/install.d.ts +60 -0
  359. package/dist/cli/self-update/install.js +428 -0
  360. package/dist/cli/self-update/paths.d.ts +40 -0
  361. package/dist/cli/self-update/paths.js +87 -0
  362. package/dist/cli/self-update/releases.d.ts +41 -0
  363. package/dist/cli/self-update/releases.js +153 -0
  364. package/dist/cli/self-update/settings.d.ts +16 -0
  365. package/dist/cli/self-update/settings.js +68 -0
  366. package/dist/cli/self-update/update.d.ts +18 -0
  367. package/dist/cli/self-update/update.js +241 -0
  368. package/dist/cli/service-accounts/index.d.ts +3 -0
  369. package/dist/cli/service-accounts/index.js +149 -0
  370. package/dist/cli/session-affiliation.d.ts +26 -0
  371. package/dist/cli/session-affiliation.js +135 -0
  372. package/dist/cli/sessions/affiliation.d.ts +8 -0
  373. package/dist/cli/sessions/affiliation.js +66 -0
  374. package/dist/cli/sessions/api.d.ts +55 -0
  375. package/dist/cli/sessions/api.js +88 -0
  376. package/dist/cli/sessions/control.d.ts +6 -0
  377. package/dist/cli/sessions/control.js +159 -0
  378. package/dist/cli/sessions/conversation.d.ts +15 -0
  379. package/dist/cli/sessions/conversation.js +118 -0
  380. package/dist/cli/sessions/index.d.ts +2 -0
  381. package/dist/cli/sessions/index.js +209 -0
  382. package/dist/cli/sessions/managed.d.ts +39 -0
  383. package/dist/cli/sessions/managed.js +63 -0
  384. package/dist/cli/sessions/redaction.d.ts +2 -0
  385. package/dist/cli/sessions/redaction.js +11 -0
  386. package/dist/cli/sessions/runner/exec.d.ts +108 -0
  387. package/dist/cli/sessions/runner/exec.js +335 -0
  388. package/dist/cli/sessions/runner/journal.d.ts +26 -0
  389. package/dist/cli/sessions/runner/journal.js +49 -0
  390. package/dist/cli/sessions/runner/native.d.ts +48 -0
  391. package/dist/cli/sessions/runner/native.js +170 -0
  392. package/dist/cli/sessions/runner/pod.d.ts +30 -0
  393. package/dist/cli/sessions/runner/pod.js +129 -0
  394. package/dist/cli/sessions/runner/serve.d.ts +85 -0
  395. package/dist/cli/sessions/runner/serve.js +558 -0
  396. package/dist/cli/sessions/sync.d.ts +47 -0
  397. package/dist/cli/sessions/sync.js +80 -0
  398. package/dist/cli/sessions/transport.d.ts +14 -0
  399. package/dist/cli/sessions/transport.js +116 -0
  400. package/dist/cli/share.d.ts +15 -0
  401. package/dist/cli/share.js +139 -0
  402. package/dist/cli/skill/catalog.d.ts +141 -0
  403. package/dist/cli/skill/catalog.js +442 -0
  404. package/dist/cli/skill/files.d.ts +89 -0
  405. package/dist/cli/skill/files.js +264 -0
  406. package/dist/cli/skill/index.d.ts +268 -0
  407. package/dist/cli/skill/index.js +1216 -0
  408. package/dist/cli/skill/manifest.d.ts +30 -0
  409. package/dist/cli/skill/manifest.js +101 -0
  410. package/dist/cli/skill/prefs.d.ts +9 -0
  411. package/dist/cli/skill/prefs.js +32 -0
  412. package/dist/cli/skill/reminders.d.ts +15 -0
  413. package/dist/cli/skill/reminders.js +105 -0
  414. package/dist/cli/skill/tar.d.ts +17 -0
  415. package/dist/cli/skill/tar.js +195 -0
  416. package/dist/cli/snapshot/index.d.ts +24 -0
  417. package/dist/cli/snapshot/index.js +146 -0
  418. package/dist/cli/source/access.d.ts +45 -0
  419. package/dist/cli/source/access.js +563 -0
  420. package/dist/cli/source/control.d.ts +103 -0
  421. package/dist/cli/source/control.js +546 -0
  422. package/dist/cli/source/delete.d.ts +89 -0
  423. package/dist/cli/source/delete.js +463 -0
  424. package/dist/cli/source/index.d.ts +288 -0
  425. package/dist/cli/source/index.js +1348 -0
  426. package/dist/cli/source/share.d.ts +65 -0
  427. package/dist/cli/source/share.js +530 -0
  428. package/dist/cli/source/upload.d.ts +62 -0
  429. package/dist/cli/source/upload.js +258 -0
  430. package/dist/cli/source/write.d.ts +77 -0
  431. package/dist/cli/source/write.js +335 -0
  432. package/dist/cli/spawn.d.ts +28 -0
  433. package/dist/cli/spawn.js +81 -0
  434. package/dist/cli/target.d.ts +22 -0
  435. package/dist/cli/target.js +85 -0
  436. package/dist/cli/tasks/index.d.ts +38 -0
  437. package/dist/cli/tasks/index.js +365 -0
  438. package/dist/cli/team/index.d.ts +37 -0
  439. package/dist/cli/team/index.js +407 -0
  440. package/dist/cli/telemetry.d.ts +23 -0
  441. package/dist/cli/telemetry.js +262 -0
  442. package/dist/cli/telemetryJournal.d.ts +26 -0
  443. package/dist/cli/telemetryJournal.js +104 -0
  444. package/dist/cli/update/index.d.ts +21 -0
  445. package/dist/cli/update/index.js +284 -0
  446. package/dist/cli/upload/index.d.ts +11 -0
  447. package/dist/cli/upload/index.js +261 -0
  448. package/dist/cli/upload/kinds.d.ts +10 -0
  449. package/dist/cli/upload/kinds.js +85 -0
  450. package/dist/cli/upload/multipart.d.ts +21 -0
  451. package/dist/cli/upload/multipart.js +248 -0
  452. package/dist/cli/vault/affected-preview.d.ts +15 -0
  453. package/dist/cli/vault/affected-preview.js +38 -0
  454. package/dist/cli/vault/cloud.d.ts +55 -0
  455. package/dist/cli/vault/cloud.js +287 -0
  456. package/dist/cli/vault/format.d.ts +18 -0
  457. package/dist/cli/vault/format.js +104 -0
  458. package/dist/cli/vault/hostCredentials.d.ts +21 -0
  459. package/dist/cli/vault/hostCredentials.js +71 -0
  460. package/dist/cli/vault/hostSupersessions.d.ts +18 -0
  461. package/dist/cli/vault/hostSupersessions.js +68 -0
  462. package/dist/cli/vault/import.d.ts +3 -0
  463. package/dist/cli/vault/import.js +79 -0
  464. package/dist/cli/vault/index.d.ts +14 -0
  465. package/dist/cli/vault/index.js +225 -0
  466. package/dist/cli/vault/keys.d.ts +5 -0
  467. package/dist/cli/vault/keys.js +165 -0
  468. package/dist/cli/vault/kms.d.ts +6 -0
  469. package/dist/cli/vault/kms.js +169 -0
  470. package/dist/cli/vault/list.d.ts +13 -0
  471. package/dist/cli/vault/list.js +60 -0
  472. package/dist/cli/vault/listView.d.ts +21 -0
  473. package/dist/cli/vault/listView.js +123 -0
  474. package/dist/cli/vault/managementMetadata.d.ts +2 -0
  475. package/dist/cli/vault/managementMetadata.js +23 -0
  476. package/dist/cli/vault/mutations.d.ts +8 -0
  477. package/dist/cli/vault/mutations.js +151 -0
  478. package/dist/cli/vault/otp.d.ts +6 -0
  479. package/dist/cli/vault/otp.js +62 -0
  480. package/dist/cli/vault/otpIntent.d.ts +23 -0
  481. package/dist/cli/vault/otpIntent.js +76 -0
  482. package/dist/cli/vault/passImport.d.ts +25 -0
  483. package/dist/cli/vault/passImport.js +129 -0
  484. package/dist/cli/vault/passOtp.d.ts +51 -0
  485. package/dist/cli/vault/passOtp.js +101 -0
  486. package/dist/cli/vault/passStore.d.ts +26 -0
  487. package/dist/cli/vault/passStore.js +134 -0
  488. package/dist/cli/vault/passwordCommand.d.ts +39 -0
  489. package/dist/cli/vault/passwordCommand.js +101 -0
  490. package/dist/cli/vault/passwordProbe.d.ts +27 -0
  491. package/dist/cli/vault/passwordProbe.js +282 -0
  492. package/dist/cli/vault/passwordRotation.d.ts +9 -0
  493. package/dist/cli/vault/passwordRotation.js +273 -0
  494. package/dist/cli/vault/rotationApi.d.ts +13 -0
  495. package/dist/cli/vault/rotationApi.js +58 -0
  496. package/dist/cli/vault/rotationCommand.d.ts +2 -0
  497. package/dist/cli/vault/rotationCommand.js +75 -0
  498. package/dist/cli/vault/rotationEngine.d.ts +19 -0
  499. package/dist/cli/vault/rotationEngine.js +65 -0
  500. package/dist/cli/vault/rotationHelperSource.d.ts +2 -0
  501. package/dist/cli/vault/rotationHelperSource.js +3 -0
  502. package/dist/cli/vault/rotationInput.d.ts +11 -0
  503. package/dist/cli/vault/rotationInput.js +48 -0
  504. package/dist/cli/vault/rotationJournal.d.ts +16 -0
  505. package/dist/cli/vault/rotationJournal.js +183 -0
  506. package/dist/cli/vault/rotationKeys.d.ts +4 -0
  507. package/dist/cli/vault/rotationKeys.js +48 -0
  508. package/dist/cli/vault/rotationPrepare.d.ts +17 -0
  509. package/dist/cli/vault/rotationPrepare.js +108 -0
  510. package/dist/cli/vault/rotationRemote.d.ts +33 -0
  511. package/dist/cli/vault/rotationRemote.js +156 -0
  512. package/dist/cli/vault/rotationState.d.ts +42 -0
  513. package/dist/cli/vault/rotationState.js +115 -0
  514. package/dist/cli/vault/rotationTransport.d.ts +18 -0
  515. package/dist/cli/vault/rotationTransport.js +71 -0
  516. package/dist/cli/vault/sshSource.d.ts +18 -0
  517. package/dist/cli/vault/sshSource.js +196 -0
  518. package/dist/cli/vault/sshSync.d.ts +17 -0
  519. package/dist/cli/vault/sshSync.js +224 -0
  520. package/dist/cli/vault/sshTransfer.d.ts +22 -0
  521. package/dist/cli/vault/sshTransfer.js +140 -0
  522. package/dist/cli/vault/terraformState.d.ts +66 -0
  523. package/dist/cli/vault/terraformState.js +252 -0
  524. package/dist/cli/vault/terraformStateCommand.d.ts +2 -0
  525. package/dist/cli/vault/terraformStateCommand.js +61 -0
  526. package/dist/cli/vault/tree.d.ts +43 -0
  527. package/dist/cli/vault/tree.js +292 -0
  528. package/dist/cli/version.d.ts +1 -0
  529. package/dist/cli/version.js +9 -0
  530. package/dist/cli/workflow/index.d.ts +76 -0
  531. package/dist/cli/workflow/index.js +826 -0
  532. package/dist/cli/workflow/validate.d.ts +19 -0
  533. package/dist/cli/workflow/validate.js +353 -0
  534. package/dist/package.json +1 -0
  535. package/package.json +28 -10
@@ -0,0 +1,422 @@
1
+ import { collectionList } from "../collection-list.js";
2
+ import { waitForWebTerminal } from "../hosts/enroll.js";
3
+ import { hostRequest, HostApiError } from "../hosts/api.js";
4
+ import { readFileSync, statSync } from "node:fs";
5
+ import { parseLayer } from "@dreamlake/json-layer";
6
+ import { resolveRemote, resolveToken } from "../config.js";
7
+ const SEGMENT = /^[A-Za-z0-9][A-Za-z0-9_.-]{0,127}$/;
8
+ const ID = /^[a-f0-9]{24}$/;
9
+ const REQUEST = /^[A-Za-z0-9][A-Za-z0-9_.:-]{0,127}$/;
10
+ const ROLE = /^arn:aws:iam::[0-9]{12}:role\/[A-Za-z0-9_+=,.@/-]+$/;
11
+ const REGION = /^[a-z]{2}-[a-z]+-[0-9]{1,2}$/;
12
+ const LAUNCH_SERVER_CODES = [
13
+ "invalid_launch_server", "invalid_launch_server_binding", "invalid_launch_server_receipt",
14
+ "launch_server_required", "launch_server_identity_denied", "launch_server_account_mismatch",
15
+ "launch_server_role_mismatch", "launch_server_outcome_unknown", "launch_server_operation_pending",
16
+ "launch_server_operation_denied", "launch_server_request_required", "launch_server_access_denied",
17
+ "launch_server_transport_unavailable", "launch_server_cloud_unavailable",
18
+ ];
19
+ const KUBERNETES_CODES = [
20
+ "invalid_kubernetes_namespace", "invalid_kubernetes_credentials", "invalid_kubernetes_path",
21
+ "kubernetes_access_denied", "kubernetes_unavailable", "kubernetes_requires_one_pod_without_enrollment",
22
+ "kubernetes_launch_rejected", "kubernetes_launch_outcome_unknown", "kubernetes_launch_identity_conflict",
23
+ "kubernetes_provider_configuration_changed", "kubernetes_pod_replaced", "too_many_kubernetes_providers",
24
+ "kubernetes_response_too_large", "invalid_kubernetes_pagination", "invalid_kubernetes_response",
25
+ "kubernetes_inventory_too_large",
26
+ ];
27
+ const CODES = new Set([...LAUNCH_SERVER_CODES, ...KUBERNETES_CODES, "bootstrap_protected_delivery_not_configured", "bootstrap_instance_profile_required", "bootstrap_provider_delivery_mismatch", "bootstrap_cli_version_not_pinned", "bootstrap_cli_version_unsupported", "bootstrap_nymph_version_unsupported", "machine_auth_not_configured", "host_not_online", "runner_capability_missing", "invalid_provider_check", "placement_configuration_invalid", "placement_target_mismatch", "unauthorized", "forbidden", "namespace_not_found", "provider_not_found", "enrollment_not_found", "association_not_found", "operation_not_found", "invalid_provider_declaration", "invalid_provider_association", "invalid_provider_retirement", "invalid_request_id", "invalid_resource_id", "invalid_pagination", "runner_not_supported", "request_id_conflict", "provider_name_conflict", "association_exists", "provider_revision_conflict", "association_revision_conflict", "provider_retired", "association_retired", "legacy_provider_requires_upgrade", "runner_configuration_mismatch", "provider_service_unavailable", "invalid_launch_layer", "invalid_preflight", "launch_not_supported", "layer_not_found", "layer_retired", "layer_revision_conflict", "layer_name_conflict", "invalid_launch_request", "invalid_instance_request", "invalid_instance_id", "launch_configuration_invalid", "launch_credentials_missing", "launch_credentials_unavailable", "launch_credentials_invalid", "launch_credentials_rejected", "launch_capacity_unavailable", "launch_rejected_by_aws", "launch_image_not_found", "cloud_provider_unavailable", "instance_not_found", "unknown_instance_action", "bootstrap_configuration_missing", "bootstrap_configuration_invalid", "bootstrap_version_not_pinned", "bootstrap_checksums_missing", "bootstrap_userdata_too_large", "bootstrap_encryption_unavailable", "root_daemon_forbidden", "service_account_already_reserved", "host_identity_conflict", "bootstrap_execution_connection_required", "bootstrap_unavailable", "invalid_launch_receipt", "bootstrap_instance_conflict"]);
28
+ // Declaration config fields per kind; the server validates values.
29
+ const CONFIG_FIELDS = {
30
+ "slurm-ssh": ["cluster", "partitions", "accounts", "credentialRef"],
31
+ k8s: ["cluster", "context", "namespace", "credentialRef", "region", "accountId", "launchServer"],
32
+ "aws-ec2": ["region", "accountId", "credentialRef", "launchServer"],
33
+ "gcp-gce": ["project", "zone", "credentialRef"],
34
+ };
35
+ export class ProviderApiError extends Error {
36
+ status;
37
+ code;
38
+ requestId;
39
+ info;
40
+ constructor(message, status, code, requestId, info = {}) {
41
+ super(message);
42
+ this.status = status;
43
+ this.code = code;
44
+ this.requestId = requestId;
45
+ this.info = info;
46
+ }
47
+ }
48
+ function launchFailureInfo(code, detail) {
49
+ if (typeof detail !== "string" || detail.length > 2048)
50
+ return {};
51
+ if (["launch_server_outcome_unknown", "launch_server_operation_pending"].includes(code ?? "")) {
52
+ const id = /^Inspect provider operation ([a-f0-9]{24});/.exec(detail)?.[1];
53
+ return id ? { recoveryOperationId: id } : {};
54
+ }
55
+ if (!["launch_server_access_denied", "launch_credentials_rejected"].includes(code ?? ""))
56
+ return {};
57
+ try {
58
+ const d = JSON.parse(detail);
59
+ const codes = ["AccessDenied", "AccessDeniedException", "UnauthorizedOperation", "UnauthorizedException", "AuthFailure", "UnrecognizedClientException", "InvalidClientTokenId", "ExpiredToken", "ExpiredTokenException", "InvalidSignatureException", "SignatureDoesNotMatch"];
60
+ const operations = ["GetCallerIdentity", "DescribeCluster", "DescribeImages", "DescribeInstances", "RunInstances", "StartInstances", "StopInstances", "TerminateInstances"];
61
+ if (!codes.includes(d?.code) || !operations.includes(d?.operation) || typeof d.region !== "string" || !REGION.test(d.region))
62
+ return {};
63
+ return { diagnostic: { code: d.code, operation: d.operation, region: d.region,
64
+ ...(Number.isInteger(d.httpStatus) && d.httpStatus >= 400 && d.httpStatus <= 599 ? { httpStatus: d.httpStatus } : {}),
65
+ ...(typeof d.requestId === "string" && /^[A-Za-z0-9-]{1,128}$/.test(d.requestId) ? { requestId: d.requestId } : {}),
66
+ } };
67
+ }
68
+ catch {
69
+ return {};
70
+ }
71
+ }
72
+ function namespace(value) {
73
+ if (!SEGMENT.test(value))
74
+ throw new Error("Use a single namespace name");
75
+ return `/namespaces/${encodeURIComponent(value)}`;
76
+ }
77
+ function selector(value, nameAllowed = false) {
78
+ const parts = value.split("/");
79
+ if (parts.length !== 2 || !(nameAllowed ? SEGMENT : ID).test(parts[1]))
80
+ throw new Error("Use namespace/resource-id");
81
+ return [namespace(parts[0]), encodeURIComponent(parts[1])];
82
+ }
83
+ function fields(value, allowed) {
84
+ if (!value || typeof value !== "object" || Array.isArray(value) || Object.keys(value).some(k => !allowed.includes(k)))
85
+ throw new Error("Provider input contains unsupported fields or is not an object");
86
+ }
87
+ function validateLaunchServer(value) {
88
+ fields(value, ["enrollmentId", "expectedRoleArn"]);
89
+ if (typeof value.enrollmentId !== "string" || !ID.test(value.enrollmentId) ||
90
+ typeof value.expectedRoleArn !== "string" || value.expectedRoleArn.length > 2048 ||
91
+ !ROLE.test(value.expectedRoleArn) || value.expectedRoleArn.endsWith("/")) {
92
+ throw new Error("Use an enrollment ID and an IAM role ARN for the launch server");
93
+ }
94
+ }
95
+ function inputFile(path, kind) {
96
+ let value;
97
+ try {
98
+ if (!statSync(path).isFile() || statSync(path).size > 32768)
99
+ throw new Error();
100
+ value = JSON.parse(readFileSync(path, "utf8"));
101
+ }
102
+ catch {
103
+ throw new Error("Read a JSON object from a provider input file of at most 32 KiB");
104
+ }
105
+ if (kind === "declaration") {
106
+ fields(value, ["version", "name", "kind", "config", "launch"]);
107
+ if (value.launch !== undefined && typeof value.launch !== "string")
108
+ throw new Error("Declaration launch must be JSON Layer text");
109
+ if (!Object.hasOwn(CONFIG_FIELDS, value.kind))
110
+ throw new Error("Provider kind must be slurm-ssh, k8s, aws-ec2 or gcp-gce");
111
+ fields(value.config, CONFIG_FIELDS[value.kind]);
112
+ if (value.config.credentialRef !== undefined)
113
+ fields(value.config.credentialRef, ["namespace", "entryName", "profile"]);
114
+ if (value.config.launchServer !== undefined)
115
+ validateLaunchServer(value.config.launchServer);
116
+ }
117
+ else {
118
+ fields(value, ["providerRevision", "enrollmentId", "runner"]);
119
+ fields(value.runner, ["kind", "partition", "account", "staging", "environment"]);
120
+ if (value.runner.kind !== "slurm")
121
+ throw new Error("Only Slurm associations are implemented");
122
+ fields(value.runner.staging, ["submissionRoot", "computeRoot"]);
123
+ fields(value.runner.environment, ["uvExecutable", "pythonExecutable"]);
124
+ }
125
+ return value;
126
+ }
127
+ const POD = /^(?=.{1,253}$)[a-z0-9](?:[-a-z0-9]*[a-z0-9])?(?:\.[a-z0-9](?:[-a-z0-9]*[a-z0-9])?)*$/;
128
+ const INSTANCE = /^i-[0-9a-f]{8}(?:[0-9a-f]{9})?$/;
129
+ const collect = (value, all) => [...all, value];
130
+ // Named layers in order, plus this request's layer file.
131
+ function stack(opts) {
132
+ if (opts.layer.length > 16 || opts.layer.some((l) => !SEGMENT.test(l)) || new Set(opts.layer).size !== opts.layer.length)
133
+ throw new Error("Use at most 16 distinct layer names");
134
+ return { ...(opts.layer.length ? { layers: opts.layer } : {}), ...(opts.file ? { request: layerFile(opts.file) } : {}) };
135
+ }
136
+ // A launch layer file: JSON Layer text of at most 16 KiB, checked locally so a
137
+ // syntax error names its line without a request.
138
+ function layerFile(path) {
139
+ let text;
140
+ try {
141
+ if (!statSync(path).isFile() || statSync(path).size > 16384)
142
+ throw new Error();
143
+ text = readFileSync(path, "utf8");
144
+ }
145
+ catch {
146
+ throw new Error("Read a JSON Layer file of at most 16 KiB");
147
+ }
148
+ parseLayer(path, text);
149
+ return text;
150
+ }
151
+ export async function providerRequest(path, method = "GET", body, requestId, operationId, check = false, plain = false) {
152
+ const token = resolveToken();
153
+ if (!token)
154
+ throw new ProviderApiError("DreamLake authentication is required", 401, "unauthorized", requestId);
155
+ const encoded = body === undefined ? undefined : JSON.stringify(body);
156
+ if (encoded !== undefined && Buffer.byteLength(encoded) > 32768)
157
+ throw new ProviderApiError("Provider request exceeds 32 KiB", undefined, undefined, requestId);
158
+ let response;
159
+ try {
160
+ response = await fetch(`${resolveRemote()}${path}`, { method,
161
+ headers: { Authorization: `Bearer ${token}`, "Content-Type": "application/json" },
162
+ body: encoded, redirect: "error", signal: AbortSignal.timeout(30_000) });
163
+ }
164
+ catch {
165
+ throw new ProviderApiError("Provider response unavailable; recover a submitted write by its request ID", undefined, undefined, requestId);
166
+ }
167
+ let data;
168
+ try {
169
+ data = await response.json();
170
+ }
171
+ catch { /* Never echo server text. */ }
172
+ if (!response.ok) {
173
+ const code = typeof data?.code === "string" && CODES.has(data.code) ? data.code : undefined;
174
+ throw new ProviderApiError(`Provider request failed (HTTP ${response.status})${code ? `: ${code}` : ""}`, response.status, code, requestId, launchFailureInfo(code, data?.detail));
175
+ }
176
+ if (!data || typeof data !== "object" || Array.isArray(data))
177
+ throw new ProviderApiError("Provider response is invalid; recover submitted writes by request ID", response.status, undefined, requestId);
178
+ if (check && (!data.run || !ID.test(data.run.id ?? "") || typeof data.run.status !== "string" || data.run.purpose !== "provider_check"))
179
+ throw new ProviderApiError("Provider returned an invalid check receipt; retry with the same request ID", response.status, undefined, requestId);
180
+ const recoveryRead = method === "GET" && path.includes("/provider-operations/");
181
+ const validStatus = data.status === "committed" || (recoveryRead && ["pending", "failed"].includes(data.status));
182
+ if (!check && !plain && (method === "POST" || recoveryRead) && (!validStatus || (operationId !== undefined && data.operationId !== operationId) || !REQUEST.test(data.requestId ?? "") || (requestId !== undefined && data.requestId !== requestId) || !ID.test(data.operationId ?? "") || !data.resource || !ID.test(data.resource.id ?? ""))) {
183
+ throw new ProviderApiError("Provider returned an invalid receipt; recover by request ID", response.status, undefined, requestId);
184
+ }
185
+ return data;
186
+ }
187
+ function page(value, defaultValue, max) {
188
+ const n = Number(value ?? defaultValue);
189
+ if (!Number.isSafeInteger(n) || n < 1 || n > max)
190
+ throw new Error("Invalid pagination");
191
+ return n;
192
+ }
193
+ async function execute(opts, work) {
194
+ try {
195
+ if (opts.requestId !== undefined && !REQUEST.test(opts.requestId))
196
+ throw new Error("Invalid provider request ID");
197
+ console.log(JSON.stringify(await work(), null, opts.json ? undefined : 2));
198
+ }
199
+ catch (e) {
200
+ const error = e instanceof Error ? e.message : "Provider request failed";
201
+ const result = { error, ...(opts.requestId && REQUEST.test(opts.requestId) ? { requestId: opts.requestId } : {}),
202
+ ...(e instanceof ProviderApiError ? { status: e.status, code: e.code, ...e.info } : {}) };
203
+ if (opts.json)
204
+ console.log(JSON.stringify(result));
205
+ else
206
+ console.error(JSON.stringify(result));
207
+ process.exitCode = 1;
208
+ }
209
+ }
210
+ export function registerProvidersCommand(program) {
211
+ const group = program.command("providers").description("register provider metadata (Slurm, Kubernetes, EC2, GCE) and associate owned Slurm enrollments");
212
+ group.command("register <namespace>").requiredOption("--file <path>", "declaration JSON; credential references only")
213
+ .option("--launch <path>", "the provider's launch layer (JSON Layer file)")
214
+ .requiredOption("--request-id <id>", "stable ID; reuse identical input after a lost response").option("--json")
215
+ .action((ns, opts) => execute(opts, () => {
216
+ const declaration = inputFile(opts.file, "declaration");
217
+ if (opts.launch)
218
+ declaration.launch = layerFile(opts.launch);
219
+ return providerRequest(`${namespace(ns)}/lakeshore-providers/registrations`, "POST", { requestId: opts.requestId, declaration }, opts.requestId);
220
+ }));
221
+ group.command("launch-server <provider>").description("bind an owned launch-server enrollment and its expected IAM role; preserves provider identity")
222
+ .requiredOption("--enrollment <id>", "owned launch-server enrollment ID")
223
+ .requiredOption("--role-arn <arn>", "expected IAM role ARN on the server")
224
+ .requiredOption("--region <region>", "AWS provider region")
225
+ .requiredOption("--revision <n>", "expected provider revision")
226
+ .requiredOption("--request-id <id>", "stable ID for this binding change").option("--json")
227
+ .action((value, opts) => execute(opts, () => {
228
+ const [ns, id] = selector(value);
229
+ const launchServer = { enrollmentId: opts.enrollment, expectedRoleArn: opts.roleArn };
230
+ validateLaunchServer(launchServer);
231
+ if (!REGION.test(opts.region))
232
+ throw new Error("Use an AWS region such as us-east-1");
233
+ return providerRequest(`${ns}/lakeshore-providers/${id}/launch-server`, "POST", {
234
+ requestId: opts.requestId, revision: page(opts.revision, 1, 2147483647), launchServer, region: opts.region,
235
+ }, opts.requestId);
236
+ }));
237
+ group.command("launch <provider>").description("set or clear the provider's launch layer; bumps the provider revision")
238
+ .option("--file <path>", "JSON Layer file").option("--clear", "remove the provider layer")
239
+ .requiredOption("--revision <n>", "expected provider revision").requiredOption("--request-id <id>").option("--json")
240
+ .action((value, opts) => execute(opts, () => {
241
+ const [ns, id] = selector(value);
242
+ if (!opts.file === !opts.clear)
243
+ throw new Error("Pass exactly one of --file or --clear");
244
+ return providerRequest(`${ns}/lakeshore-providers/${id}/launch`, "POST", { requestId: opts.requestId,
245
+ revision: page(opts.revision, 1, 2147483647), launch: opts.clear ? null : layerFile(opts.file) }, opts.requestId);
246
+ }));
247
+ const layers = group.command("layers").description("named launch layers, resolved over the latest provider layer");
248
+ collectionList(layers, "list <provider>").option("--json")
249
+ .action((value, opts) => execute(opts, () => { const [ns, id] = selector(value); return providerRequest(`${ns}/lakeshore-providers/${id}/layers`); }));
250
+ layers.command("create <provider>").requiredOption("--name <name>").requiredOption("--file <path>", "JSON Layer file")
251
+ .requiredOption("--request-id <id>").option("--json")
252
+ .action((value, opts) => execute(opts, () => {
253
+ const [ns, id] = selector(value);
254
+ if (!SEGMENT.test(opts.name))
255
+ throw new Error("Invalid layer name");
256
+ return providerRequest(`${ns}/lakeshore-providers/${id}/layers`, "POST", { requestId: opts.requestId, name: opts.name, text: layerFile(opts.file) }, opts.requestId);
257
+ }));
258
+ layers.command("update <provider>").requiredOption("--layer <id>").requiredOption("--file <path>", "JSON Layer file")
259
+ .requiredOption("--revision <n>", "expected layer revision").requiredOption("--request-id <id>").option("--json")
260
+ .action((value, opts) => execute(opts, () => {
261
+ const [ns, id] = selector(value);
262
+ if (!ID.test(opts.layer))
263
+ throw new Error("Invalid layer ID");
264
+ return providerRequest(`${ns}/lakeshore-providers/${id}/layers/${opts.layer}`, "POST", { requestId: opts.requestId,
265
+ revision: page(opts.revision, 1, 2147483647), text: layerFile(opts.file) }, opts.requestId);
266
+ }));
267
+ layers.command("retire <provider>").requiredOption("--layer <id>").requiredOption("--revision <n>", "expected layer revision")
268
+ .requiredOption("--request-id <id>").option("--json")
269
+ .action((value, opts) => execute(opts, () => {
270
+ const [ns, id] = selector(value);
271
+ if (!ID.test(opts.layer))
272
+ throw new Error("Invalid layer ID");
273
+ return providerRequest(`${ns}/lakeshore-providers/${id}/layers/${opts.layer}/retire`, "POST", { requestId: opts.requestId, revision: page(opts.revision, 1, 2147483647) }, opts.requestId);
274
+ }));
275
+ group.command("preflight <provider>").description("resolve and validate launch configuration; never launches")
276
+ .option("--layer <name>", "named layer to apply; repeat to stack layers in order", collect, [])
277
+ .option("--file <path>", "this request's JSON Layer file").option("--json")
278
+ .action((value, opts) => execute(opts, () => {
279
+ const [ns, id] = selector(value);
280
+ return providerRequest(`${ns}/lakeshore-providers/${id}/preflight`, "POST", stack(opts), undefined, undefined, false, true);
281
+ }));
282
+ const instances = group.command("instances").description("launch and manage EC2 instances or Kubernetes Pods");
283
+ registerProviderLaunchCommand(instances);
284
+ collectionList(instances, "list <provider>").option("--json")
285
+ .action((value, opts) => execute(opts, () => { const [ns, id] = selector(value); return providerRequest(`${ns}/lakeshore-providers/${id}/instances`); }));
286
+ instances.command("logs <provider>").description("read bounded logs of an owned Kubernetes Pod")
287
+ .requiredOption("--instance <name>", "Kubernetes Pod name").option("--tail <n>", "most recent lines (1-1000)", "100").option("--json")
288
+ .action((value, opts) => execute(opts, () => {
289
+ const [ns, id] = selector(value);
290
+ if (!POD.test(opts.instance))
291
+ throw new Error("Invalid Kubernetes Pod name");
292
+ return providerRequest(`${ns}/lakeshore-providers/${id}/instances/${encodeURIComponent(opts.instance)}/logs?tailLines=${page(opts.tail, 100, 1000)}`);
293
+ }));
294
+ group.command("nodes <provider>").description("inspect Kubernetes node capacity and readiness").option("--json")
295
+ .action((value, opts) => execute(opts, () => {
296
+ const [ns, id] = selector(value);
297
+ return providerRequest(`${ns}/kubernetes-clusters/${id}`);
298
+ }));
299
+ for (const action of ["start", "stop", "terminate"]) {
300
+ instances.command(`${action} <provider>`).description(action === "terminate" ? "delete an owned Kubernetes Pod or terminate an EC2 instance" : `${action} the instance`)
301
+ .requiredOption("--instance <id>").requiredOption("--request-id <id>").option("--json")
302
+ .action((value, opts) => execute(opts, () => {
303
+ const [ns, id] = selector(value);
304
+ if (!INSTANCE.test(opts.instance) && !(action === "terminate" && POD.test(opts.instance)))
305
+ throw new Error("Use an EC2 instance ID, or a Kubernetes Pod name for terminate");
306
+ return providerRequest(`${ns}/lakeshore-providers/${id}/instances/${encodeURIComponent(opts.instance)}/${action}`, "POST", { requestId: opts.requestId }, opts.requestId);
307
+ }));
308
+ }
309
+ group.command("associate <provider>").requiredOption("--file <path>", "association JSON with enrollment, revision and runner paths")
310
+ .requiredOption("--request-id <id>").option("--json")
311
+ .action((value, opts) => execute(opts, () => { const [ns, id] = selector(value); return providerRequest(`${ns}/lakeshore-providers/${id}/associations`, "POST", { ...inputFile(opts.file, "association"), requestId: opts.requestId }, opts.requestId); }));
312
+ group.command("check <provider>").description("explicitly submit a small Slurm probe; consumes an allocation")
313
+ .requiredOption("--association <id>").requiredOption("--revision <n>", "expected association revision")
314
+ .requiredOption("--request-id <id>").option("--json")
315
+ .action((value, opts) => execute(opts, () => {
316
+ const [ns, id] = selector(value);
317
+ if (!ID.test(opts.association))
318
+ throw new Error("Invalid association ID");
319
+ return providerRequest(`${ns}/lakeshore-providers/${id}/checks`, "POST", {
320
+ requestId: opts.requestId, associationId: opts.association,
321
+ associationRevision: page(opts.revision, 1, Number.MAX_SAFE_INTEGER),
322
+ }, opts.requestId, undefined, true);
323
+ }));
324
+ group.command("status <provider>").option("--page <n>").option("--page-size <n>").option("--json")
325
+ .action((value, opts) => execute(opts, () => { const [ns, id] = selector(value); return providerRequest(`${ns}/lakeshore-providers/${id}/status?page=${page(opts.page, 1, 100000)}&pageSize=${page(opts.pageSize, 50, 100)}`); }));
326
+ group.command("show <provider>").option("--json")
327
+ .action((value, opts) => execute(opts, () => { const [ns, id] = selector(value, true); return providerRequest(`${ns}/lakeshore-providers/${id}`); }));
328
+ collectionList(group, "list <namespace>").option("--page <n>").option("--page-size <n>").option("--json")
329
+ .action((ns, opts) => execute(opts, () => providerRequest(`${namespace(ns)}/lakeshore-providers?page=${page(opts.page, 1, 100000)}&pageSize=${page(opts.pageSize, 50, 200)}`)));
330
+ group.command("retire <provider>").option("--association <id>", "retire only this owned association")
331
+ .requiredOption("--revision <n>", "expected resource revision").requiredOption("--request-id <id>").option("--json")
332
+ .action((value, opts) => execute(opts, () => {
333
+ const [ns, id] = selector(value);
334
+ if (opts.association && !ID.test(opts.association))
335
+ throw new Error("Invalid association ID");
336
+ const path = `${ns}/lakeshore-providers/${id}${opts.association ? `/associations/${opts.association}` : ""}/retire`;
337
+ return providerRequest(path, "POST", { requestId: opts.requestId, revision: page(opts.revision, 1, 2147483647) }, opts.requestId);
338
+ }));
339
+ const ops = group.command("operations").description("recover historical receipts without repeating a write");
340
+ ops.command("show <operation>").option("--json")
341
+ .action((value, opts) => execute(opts, () => { const [ns, id] = selector(value); return providerRequest(`${ns}/provider-operations/${id}`, "GET", undefined, undefined, id); }));
342
+ ops.command("find <namespace>").requiredOption("--request-id <id>").option("--json")
343
+ .action((ns, opts) => execute(opts, () => providerRequest(`${namespace(ns)}/provider-operations/by-request/${encodeURIComponent(opts.requestId)}`, "GET", undefined, opts.requestId)));
344
+ }
345
+ /** Shared launch implementation: hosts create always requests automatic enrollment. */
346
+ export function registerProviderLaunchCommand(parent, name = "launch") {
347
+ const command = parent.command(`${name} <provider>`).description("launch EC2 instances or a Kubernetes Pod from resolved layers")
348
+ .option("--web-terminal", "enable browser SSH for the automatically enrolled host (default)")
349
+ .option("--no-web-terminal", "launch without browser SSH access")
350
+ .option("--wait-seconds <seconds>", "wait for enrollment and web terminal setup (default 300)")
351
+ .option("--service-account <id>", "unused service account for this Nymph (default create a dedicated account)")
352
+ .option("--host-name <name>", "namespace/group/host name for automatic Nymph enrollment")
353
+ .option("--unix-user <name>", "Nymph operating-system user (default ubuntu)")
354
+ .option("--lakeshore-id <id>", "namespace control-plane connection for automatic enrollment")
355
+ .option("--layer <name>", "named layer to apply; repeat to stack layers in order", collect, [])
356
+ .option("--file <path>", "this request's JSON Layer file").option("--count <n>", "number of EC2 instances (1-64); Kubernetes requires 1", "1")
357
+ .requiredOption("--request-id <id>", "stable ID; repeating it returns the same instances").option("--json")
358
+ .action((value, opts) => execute(opts, async () => {
359
+ if (name === "create" && !opts.hostName)
360
+ throw new Error("hosts create requires --host-name");
361
+ const [ns, id] = selector(value);
362
+ const waitSeconds = Number(opts.waitSeconds ?? 300);
363
+ if (!Number.isFinite(waitSeconds) || waitSeconds < 0 || waitSeconds > 600)
364
+ throw new Error("--wait-seconds must be between 0 and 600");
365
+ const count = page(opts.count, 1, 64);
366
+ const wantsEnrollment = [opts.serviceAccount, opts.hostName, opts.unixUser, opts.lakeshoreId].some(v => v !== undefined);
367
+ let enrollment;
368
+ if (wantsEnrollment) {
369
+ if (typeof opts.hostName !== "string")
370
+ throw new Error("Automatic enrollment requires --host-name");
371
+ if (opts.serviceAccount !== undefined && !ID.test(opts.serviceAccount))
372
+ throw new Error("Invalid service account ID");
373
+ const parts = opts.hostName.split("/");
374
+ if (parts.length !== 3 || parts.some((p) => !/^[A-Za-z0-9][A-Za-z0-9_-]{0,63}$/.test(p)) || `/namespaces/${encodeURIComponent(parts[0])}` !== ns)
375
+ throw new Error("Host name must be namespace/group/host in the provider namespace");
376
+ if (count !== 1)
377
+ throw new Error("Automatic enrollment requires --count 1; each Nymph needs its own service account");
378
+ if (opts.unixUser !== undefined && (!/^[a-z_][a-z0-9_-]{0,31}$/.test(opts.unixUser) || opts.unixUser === "root"))
379
+ throw new Error("Use a non-root Unix user");
380
+ if (opts.lakeshoreId !== undefined && !ID.test(opts.lakeshoreId))
381
+ throw new Error("Invalid Lakeshore ID");
382
+ enrollment = { name: opts.hostName, webTerminal: opts.webTerminal ?? true, ...(opts.serviceAccount ? { serviceAccountId: opts.serviceAccount } : {}),
383
+ ...(opts.unixUser ? { unixUser: opts.unixUser } : {}), ...(opts.lakeshoreId ? { lakeshoreId: opts.lakeshoreId } : {}) };
384
+ }
385
+ const receipt = await providerRequest(`${ns}/lakeshore-providers/${id}/launches`, "POST", { requestId: opts.requestId, ...stack(opts), count,
386
+ ...(enrollment ? { enrollment } : {}) }, opts.requestId);
387
+ if (!enrollment || !enrollment.webTerminal)
388
+ return receipt;
389
+ const pendingLaunch = (message) => {
390
+ process.exitCode = 1;
391
+ return { ...receipt, webTerminal: { status: "pending" }, message };
392
+ };
393
+ const deadline = Date.now() + waitSeconds * 1000;
394
+ const bootstrapId = receipt.resource?.enrollment?.bootstrapId;
395
+ if (!ID.test(bootstrapId ?? ""))
396
+ return pendingLaunch("Instance launched; its enrollment binding is unavailable. Retry with the same request ID to reuse the instance.");
397
+ while (true) {
398
+ try {
399
+ const binding = await hostRequest(`${ns}/hosts/launches/${bootstrapId}`);
400
+ if (binding.hostId && binding.enrollmentId) {
401
+ const webTerminal = await waitForWebTerminal(opts.hostName.split("/")[0], binding.hostId, binding.enrollmentId, deadline);
402
+ if (webTerminal.status !== "ready")
403
+ process.exitCode = 1;
404
+ return { ...receipt, webTerminal, ...(webTerminal.status !== "ready" ? { message: "Instance launched; web terminal setup is pending. Retry with the same request ID, which reuses the existing instance." } : {}) };
405
+ }
406
+ }
407
+ catch (error) {
408
+ if (!(error instanceof HostApiError) || ![409, 503].includes(error.status ?? 0))
409
+ return pendingLaunch("Instance launched; terminal readiness could not be verified. Retry with the same request ID to reuse the instance.");
410
+ }
411
+ if (Date.now() >= deadline) {
412
+ process.exitCode = 1;
413
+ return { ...receipt, webTerminal: { status: "pending" }, message: "Instance launched; enrollment is pending. Retry with the same request ID to finish setup without launching another instance." };
414
+ }
415
+ await new Promise(resolve => setTimeout(resolve, 1000));
416
+ }
417
+ }));
418
+ if (name === "create") {
419
+ command.description("provision and enroll one host through an existing provider");
420
+ command.options.find(option => option.long === "--host-name").mandatory = true;
421
+ }
422
+ }
@@ -0,0 +1,61 @@
1
+ import { type Spawn } from "./spawn.js";
2
+ export { spawn, lastNonEmptyLine, type Spawn, type SpawnResult } from "./spawn.js";
3
+ export interface BridgeDeps {
4
+ /** Injected in tests. Defaults to the real subprocess. */
5
+ spawn?: Spawn;
6
+ /** `--json` mode: the child's stderr is not written through. */
7
+ quiet?: boolean;
8
+ }
9
+ export declare const NO_SERVER_MESSAGE: string;
10
+ /** `--server` → `LAKESHORE_URL` → null (the caller turns null into the error). */
11
+ export declare function resolveServer(flag?: string): string | null;
12
+ /** `--namespace` → `LAKESHORE_NAMESPACE` → `"default"`. */
13
+ export declare function resolveCpNamespace(flag?: string): string;
14
+ /**
15
+ * Nearest `.dreamrc` walking up from `from` (default: cwd). Returns the file
16
+ * path, or null. Shared with `launch`, which reads its `queue:` key.
17
+ */
18
+ export declare function findDreamRc(from?: string): string | null;
19
+ /**
20
+ * `DREAMLAKE_PYTHON` → `.venv/bin/python` beside the nearest `.dreamrc` →
21
+ * `python3` on PATH.
22
+ *
23
+ * Existence of the chosen interpreter is proved by the PROBE, not by a stat —
24
+ * the probe has to run anyway and its failure message is the good one. The one
25
+ * `existsSync` here is about the *rule*, not the interpreter: a repo with a
26
+ * `.dreamrc` and no virtualenv should fall through to `python3` rather than
27
+ * insist on a path that was never created.
28
+ */
29
+ export declare function resolveInterpreter(): string;
30
+ export declare const PROTOCOL = 1;
31
+ export type ProbeResult = {
32
+ ok: true;
33
+ } | {
34
+ ok: false;
35
+ message: string;
36
+ };
37
+ /** Tests only — the cache would otherwise leak one test's fake into the next. */
38
+ export declare function resetProbeCache(): void;
39
+ export declare function probe(py: string, deps?: BridgeDeps): ProbeResult;
40
+ export type BridgeOutcome = {
41
+ ok: true;
42
+ data: Record<string, unknown>;
43
+ } | {
44
+ ok: false;
45
+ message: string;
46
+ kind?: string;
47
+ };
48
+ /**
49
+ * `<py> -m dreamlake.lakeshore.bridge <command> …argv` → one envelope.
50
+ *
51
+ * The child's stderr is NOT swallowed on success. `launch --wait` can sit for
52
+ * minutes and the progress lines on stderr are the only sign it is alive; a
53
+ * silent CLI that eventually prints an answer reads as a hang. Under `--json`
54
+ * (`deps.quiet`) it is suppressed, because that mode promises one object and
55
+ * nothing else.
56
+ */
57
+ export declare function callBridge(command: string, argv: string[], deps?: BridgeDeps): BridgeOutcome;
58
+ export declare function str(data: Record<string, unknown>, key: string): string | undefined;
59
+ export declare function num(data: Record<string, unknown>, key: string): number | undefined;
60
+ export declare function bool(data: Record<string, unknown>, key: string): boolean | undefined;
61
+ export declare function obj(data: Record<string, unknown>, key: string): Record<string, unknown> | undefined;