@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,255 @@
1
+ // The Python bridge — the ONE place in this CLI that knows Python exists.
2
+ //
3
+ // WHY THERE IS A SUBPROCESS HERE AT ALL. `dreamlake snapshot` and
4
+ // `dreamlake launch` drive logic that already exists, is tested, and was proven
5
+ // end to end against a live control plane: git-archive with `.dreamrc` exclude
6
+ // pathspecs, dirty-tree commit-object synthesis, the presign POST, the S3 PUT,
7
+ // submodule parsing, the `CodeRepo` register, the msgpack envelope, and
8
+ // `host_key` — which is normative across three languages with twelve golden
9
+ // vectors. Reimplementing that in TypeScript means a second implementation of
10
+ // eight things, four of which had bugs this week, in a language with no tests
11
+ // for any of them. So the CLI drives the Python; it does not replace it.
12
+ //
13
+ // The honest cost: `withFetchStub` cannot see a subprocess, and there is no
14
+ // precedent in this CLI for spawning Python (`auth` and `self-update` spawn
15
+ // children, but none produce data). We pay for it with SPAWN INJECTION — every
16
+ // entry point takes `deps: { spawn?: Spawn }` and defaults to the real one, so
17
+ // the tests hand over a fake that returns canned stdout and records the argv it
18
+ // was given. That argv assertion is the contract with the SDK half; it is what
19
+ // catches drift between the two.
20
+ //
21
+ // The precedent is one repo over: dreamlake-server spawns `dreamlake …
22
+ // append-local` (Python) as its canonical writer and parses that process's
23
+ // stdout as a machine contract. Same shape, same rules — so the rules are
24
+ // stated here rather than assumed:
25
+ //
26
+ // * stdout carries EXACTLY ONE JSON object and nothing else. All progress
27
+ // goes to stderr. We still parse only the LAST non-empty stdout line,
28
+ // because somebody's `sitecustomize.py` gets to print and that is not the
29
+ // bridge's fault.
30
+ // * exit 0 → ok:true · exit 1 → ok:false with `error` · exit 2 → the CLI
31
+ // handed the bridge bad argv, which is a CLI BUG, and saying so is more
32
+ // useful than a parse failure.
33
+ // * a missing or wrong interpreter is a sentence, never a traceback.
34
+ import { existsSync } from "node:fs";
35
+ import path from "node:path";
36
+ import { boundedSpawn, lastNonEmptyLine, spawn, truncate, } from "./spawn.js";
37
+ // ─── the injection point ─────────────────────────────────────────────────────
38
+ //
39
+ // `Spawn` / `SpawnResult` / `spawn` MOVED to ./spawn.ts when terraform and ssh
40
+ // became a second subprocess family — one type, two families. They are
41
+ // re-exported here so every existing `from "../python.js"` import keeps
42
+ // resolving, and so this file still reads as the one place that knows Python
43
+ // exists.
44
+ export { spawn, lastNonEmptyLine } from "./spawn.js";
45
+ /**
46
+ * The probe's spawner. The real one with a bound, because `import dreamlake…`
47
+ * is an ~80 ms operation and anything past two minutes is a hang, not a slow
48
+ * import. Kept separate from `spawn` so the exported `Spawn` signature stays
49
+ * the three arguments the tests implement.
50
+ */
51
+ const probeSpawn = boundedSpawn(120_000);
52
+ // ─── connection resolution (the CONTROL PLANE's, not DreamLake's) ────────────
53
+ //
54
+ // Deliberately NOT `config.ts`. That module knows DREAMLAKE_REMOTE /
55
+ // DREAMLAKE_API_KEY — the dreamlake-server connection — and
56
+ // these two commands write no dreamlake-server row in v1: the archive lands in
57
+ // the control plane's `CodeRepo`, because dreamlake-server has no PUT-presign
58
+ // that can receive a code tarball and the worker resolves the archive through a
59
+ // control-plane path. A snapshot that exists only on DreamLake is not
60
+ // launchable by anything.
61
+ //
62
+ // So neither command calls `ctx()` and neither requires `dreamlake login`.
63
+ // Gating a job launch behind a DreamLake login would be a false gate. When the
64
+ // `Repo`/`RepoSnapshot` mirror lands, `ctx()` gets added then — not now.
65
+ export const NO_SERVER_MESSAGE = "no control plane — pass --server or set LAKESHORE_URL " +
66
+ "(local: cd dreamlake-starter-kit && make up)";
67
+ /** `--server` → `LAKESHORE_URL` → null (the caller turns null into the error). */
68
+ export function resolveServer(flag) {
69
+ const v = flag || process.env.LAKESHORE_URL;
70
+ if (!v)
71
+ return null;
72
+ return v.replace(/\/+$/, "");
73
+ }
74
+ /** `--namespace` → `LAKESHORE_NAMESPACE` → `"default"`. */
75
+ export function resolveCpNamespace(flag) {
76
+ return flag || process.env.LAKESHORE_NAMESPACE || "default";
77
+ }
78
+ // ─── `.dreamrc` discovery ────────────────────────────────────────────────────
79
+ /**
80
+ * Nearest `.dreamrc` walking up from `from` (default: cwd). Returns the file
81
+ * path, or null. Shared with `launch`, which reads its `queue:` key.
82
+ */
83
+ export function findDreamRc(from) {
84
+ let dir = path.resolve(from ?? process.cwd());
85
+ for (;;) {
86
+ const candidate = path.join(dir, ".dreamrc");
87
+ if (existsSync(candidate))
88
+ return candidate;
89
+ const parent = path.dirname(dir);
90
+ if (parent === dir)
91
+ return null;
92
+ dir = parent;
93
+ }
94
+ }
95
+ // ─── interpreter resolution ──────────────────────────────────────────────────
96
+ /**
97
+ * `DREAMLAKE_PYTHON` → `.venv/bin/python` beside the nearest `.dreamrc` →
98
+ * `python3` on PATH.
99
+ *
100
+ * Existence of the chosen interpreter is proved by the PROBE, not by a stat —
101
+ * the probe has to run anyway and its failure message is the good one. The one
102
+ * `existsSync` here is about the *rule*, not the interpreter: a repo with a
103
+ * `.dreamrc` and no virtualenv should fall through to `python3` rather than
104
+ * insist on a path that was never created.
105
+ */
106
+ export function resolveInterpreter() {
107
+ const explicit = process.env.DREAMLAKE_PYTHON;
108
+ if (explicit)
109
+ return explicit;
110
+ const rc = findDreamRc();
111
+ if (rc) {
112
+ const venv = path.join(path.dirname(rc), ".venv", "bin", "python");
113
+ if (existsSync(venv))
114
+ return venv;
115
+ }
116
+ return "python3";
117
+ }
118
+ // ─── the probe ───────────────────────────────────────────────────────────────
119
+ export const PROTOCOL = 1;
120
+ const NO_INTERPRETER_MESSAGE = "no python interpreter found — set DREAMLAKE_PYTHON=/path/to/python " +
121
+ "(the interpreter that has dreamlake-lakeshore installed)";
122
+ function protocolMismatch(n) {
123
+ return (`dreamlake-lakeshore speaks protocol ${n}, this CLI speaks ${PROTOCOL} — ` +
124
+ `upgrade the CLI (dreamlake self-update) or the SDK`);
125
+ }
126
+ // One probe per interpreter per process, so `launch` pays ~80 ms once rather
127
+ // than once per bridge call. Keyed by the resolved interpreter path.
128
+ const probeCache = new Map();
129
+ /** Tests only — the cache would otherwise leak one test's fake into the next. */
130
+ export function resetProbeCache() {
131
+ probeCache.clear();
132
+ }
133
+ export function probe(py, deps = {}) {
134
+ const cached = probeCache.get(py);
135
+ if (cached)
136
+ return cached;
137
+ const sp = deps.spawn ?? probeSpawn;
138
+ const r = sp(py, [
139
+ "-c",
140
+ "import dreamlake.lakeshore.bridge as b; print(b.PROTOCOL)",
141
+ ]);
142
+ let result;
143
+ if (r.error?.code === "ENOENT") {
144
+ result = { ok: false, message: NO_INTERPRETER_MESSAGE };
145
+ }
146
+ else if (r.status !== 0) {
147
+ const detail = lastNonEmptyLine(r.stderr);
148
+ result = {
149
+ ok: false,
150
+ message: `${py} cannot import dreamlake-lakeshore — pip install ` +
151
+ `dreamlake-lakeshore, or set DREAMLAKE_PYTHON` +
152
+ (detail ? `\n ${detail}` : ""),
153
+ };
154
+ }
155
+ else {
156
+ const n = Number.parseInt(lastNonEmptyLine(r.stdout), 10);
157
+ result = Number.isFinite(n) && n === PROTOCOL
158
+ ? { ok: true }
159
+ : { ok: false, message: protocolMismatch(n) };
160
+ }
161
+ probeCache.set(py, result);
162
+ return result;
163
+ }
164
+ const NO_RESULT_MESSAGE = "the dreamlake-lakeshore bridge produced no result";
165
+ const INTERNAL_ARGV_MESSAGE = "internal error: the dreamlake-lakeshore bridge rejected its arguments";
166
+ /**
167
+ * `<py> -m dreamlake.lakeshore.bridge <command> …argv` → one envelope.
168
+ *
169
+ * The child's stderr is NOT swallowed on success. `launch --wait` can sit for
170
+ * minutes and the progress lines on stderr are the only sign it is alive; a
171
+ * silent CLI that eventually prints an answer reads as a hang. Under `--json`
172
+ * (`deps.quiet`) it is suppressed, because that mode promises one object and
173
+ * nothing else.
174
+ */
175
+ export function callBridge(command, argv, deps = {}) {
176
+ const py = resolveInterpreter();
177
+ const probed = probe(py, deps);
178
+ if (!probed.ok)
179
+ return { ok: false, message: probed.message };
180
+ const sp = deps.spawn ?? spawn;
181
+ const r = sp(py, ["-m", "dreamlake.lakeshore.bridge", command, ...argv]);
182
+ if (r.error?.code === "ENOENT") {
183
+ return { ok: false, message: NO_INTERPRETER_MESSAGE };
184
+ }
185
+ // Exit 2 is "the CLI built bad argv" — our bug, not the operator's. Naming it
186
+ // as an internal error and printing the child's complaint verbatim is more
187
+ // useful than reporting that some JSON failed to parse.
188
+ if (r.status === 2) {
189
+ const detail = truncate(r.stderr);
190
+ return {
191
+ ok: false,
192
+ message: detail ? `${INTERNAL_ARGV_MESSAGE}\n${detail}` : INTERNAL_ARGV_MESSAGE,
193
+ kind: "BridgeArgvError",
194
+ };
195
+ }
196
+ if (!deps.quiet && r.stderr)
197
+ process.stderr.write(r.stderr);
198
+ let envelope;
199
+ try {
200
+ const line = lastNonEmptyLine(r.stdout);
201
+ const parsed = JSON.parse(line);
202
+ if (!parsed || typeof parsed !== "object" || Array.isArray(parsed)) {
203
+ throw new Error("not an object");
204
+ }
205
+ envelope = parsed;
206
+ }
207
+ catch {
208
+ const detail = truncate(r.stderr);
209
+ return {
210
+ ok: false,
211
+ message: detail ? `${NO_RESULT_MESSAGE}\n${detail}` : NO_RESULT_MESSAGE,
212
+ kind: "BridgeNoResult",
213
+ };
214
+ }
215
+ const protocol = envelope.protocol;
216
+ if (typeof protocol === "number" && protocol !== PROTOCOL) {
217
+ return { ok: false, message: protocolMismatch(protocol) };
218
+ }
219
+ if (envelope.ok === false) {
220
+ const err = (envelope.error ?? {});
221
+ const message = typeof err.message === "string" && err.message
222
+ ? err.message
223
+ : `${command} failed`;
224
+ const kind = typeof err.kind === "string" ? err.kind : undefined;
225
+ return { ok: false, message, kind };
226
+ }
227
+ const data = envelope.data;
228
+ if (!data || typeof data !== "object" || Array.isArray(data)) {
229
+ return { ok: false, message: NO_RESULT_MESSAGE, kind: "BridgeNoResult" };
230
+ }
231
+ return { ok: true, data: data };
232
+ }
233
+ // ─── envelope field readers ──────────────────────────────────────────────────
234
+ //
235
+ // The envelope crosses a language boundary, so nothing here trusts a field's
236
+ // type. A missing `sizeBytes` prints as a blank, never as `undefined`.
237
+ export function str(data, key) {
238
+ const v = data[key];
239
+ return typeof v === "string" ? v : undefined;
240
+ }
241
+ export function num(data, key) {
242
+ const v = data[key];
243
+ return typeof v === "number" ? v : undefined;
244
+ }
245
+ export function bool(data, key) {
246
+ const v = data[key];
247
+ return typeof v === "boolean" ? v : undefined;
248
+ }
249
+ export function obj(data, key) {
250
+ const v = data[key];
251
+ if (v && typeof v === "object" && !Array.isArray(v)) {
252
+ return v;
253
+ }
254
+ return undefined;
255
+ }
@@ -0,0 +1,33 @@
1
+ import type { Command } from "commander";
2
+ export interface QueueOpts {
3
+ namespace?: string;
4
+ json?: boolean;
5
+ }
6
+ export interface MountOpts extends QueueOpts {
7
+ uri: string;
8
+ prefix: string;
9
+ lakeshoreNamespace?: string;
10
+ tokenStdin?: boolean;
11
+ }
12
+ export interface MountInput {
13
+ interactive: boolean;
14
+ namespace(): Promise<string>;
15
+ token(): Promise<string>;
16
+ stdin(): Promise<string>;
17
+ }
18
+ export declare function runQueuesMount(opts: MountOpts, io?: MountInput): Promise<number>;
19
+ export declare function runQueuesMounts(opts: QueueOpts & {
20
+ page?: string;
21
+ pageSize?: string;
22
+ }): Promise<number>;
23
+ export declare function runQueuesInspect(prefix: string, opts: QueueOpts): Promise<number>;
24
+ export declare function runQueuesList(prefix: string, opts: QueueOpts): Promise<number>;
25
+ export declare function runQueuesUnmount(prefix: string, opts: QueueOpts): Promise<number>;
26
+ export declare function runQueuesToken(prefix: string, opts: QueueOpts & {
27
+ tokenStdin?: boolean;
28
+ }, io?: MountInput): Promise<number>;
29
+ export declare function runQueuesResources(prefix: string, resource: "workers" | "jobs", opts: QueueOpts & {
30
+ limit?: string;
31
+ offset?: string;
32
+ }): Promise<number>;
33
+ export declare function registerQueuesCommand(program: Command): void;
@@ -0,0 +1,248 @@
1
+ import { collectionList } from "../collection-list.js";
2
+ import { registerSlurmCommands } from "./slurm.js";
3
+ import { input, password } from "@inquirer/prompts";
4
+ import { HttpError, requestJson } from "../client.js";
5
+ import { resolveNamespace, resolveRemote, resolveToken } from "../config.js";
6
+ import { emitJson, fail, renderTable } from "../helpers.js";
7
+ const mountInput = {
8
+ get interactive() { return !!process.stdin.isTTY; },
9
+ namespace: () => input({ message: "Lakeshore namespace (on the queue server):" }),
10
+ token: () => password({ message: "Lakeshore access token (not the admin token):" }),
11
+ stdin: async () => {
12
+ let value = "";
13
+ for await (const chunk of process.stdin) {
14
+ value += chunk.toString();
15
+ if (value.length > 16384)
16
+ throw new Error("access token input is too long");
17
+ }
18
+ return value;
19
+ },
20
+ };
21
+ const seg = encodeURIComponent;
22
+ async function context(opts) {
23
+ const remote = resolveRemote();
24
+ const token = resolveToken();
25
+ if (!token)
26
+ throw new Error("not authenticated — run 'dreamlake login' first");
27
+ const ns = await resolveNamespace(opts.namespace, { remote, token });
28
+ if (!ns)
29
+ throw new Error("choose a DreamLake namespace with --namespace <slug>");
30
+ return { remote, token, ns, path: `/namespaces/${seg(ns)}/lakeshores` };
31
+ }
32
+ function error(err, secret) {
33
+ // Never reflect a supplied token, even if an upstream error includes it.
34
+ let message = err instanceof Error ? err.message : String(err);
35
+ if (secret && err instanceof HttpError) {
36
+ // HttpError may already have truncated a raw echoed token. Do not print
37
+ // any upstream body for a request carrying a credential.
38
+ const advice = err.status === 409 ? "check whether this prefix is already mounted" :
39
+ err.status === 401 ? "check your DreamLake login" :
40
+ err.status === 403 ? "check your DreamLake namespace permissions" :
41
+ "check the server URL, Lakeshore namespace, and access token";
42
+ message = `DreamLake rejected the credential request (HTTP ${err.status}); ${advice}`;
43
+ }
44
+ else if (secret)
45
+ message = message.split(secret).join("[redacted]");
46
+ if (err instanceof HttpError && err.status === 404) {
47
+ message += "; the mount or queues API may not be available on this DreamLake deployment";
48
+ }
49
+ fail(message);
50
+ return 1;
51
+ }
52
+ export async function runQueuesMount(opts, io = mountInput) {
53
+ let secret;
54
+ try {
55
+ const uri = new URL(opts.uri);
56
+ if (uri.protocol !== "https:" || uri.username || uri.password || uri.search || uri.hash || uri.pathname !== "/") {
57
+ throw new Error("--uri must be an HTTPS server URL without credentials, path, query, or fragment");
58
+ }
59
+ if (!/^[a-z0-9][a-z0-9_-]{0,63}$/.test(opts.prefix)) {
60
+ throw new Error("--prefix must be 1–64 lowercase letters, numbers, underscores, or hyphens, starting with a letter or number");
61
+ }
62
+ const c = await context(opts);
63
+ process.stderr.write(`DreamLake: ${c.remote}\nDreamLake namespace: ${c.ns}\nLakeshore: ${uri.toString().replace(/\/+$/, "")}\nMount prefix: ${opts.prefix}\n`);
64
+ let lakeshoreNamespace = opts.lakeshoreNamespace?.trim();
65
+ if (!lakeshoreNamespace) {
66
+ if (!io.interactive || opts.tokenStdin)
67
+ throw new Error("provide --lakeshore-namespace when using noninteractive input");
68
+ lakeshoreNamespace = (await io.namespace()).trim();
69
+ }
70
+ if (!/^[a-zA-Z0-9][a-zA-Z0-9_-]{0,127}$/.test(lakeshoreNamespace)) {
71
+ throw new Error("Lakeshore namespace must be a simple name of 1–128 letters, numbers, underscores, or hyphens, starting with a letter or number");
72
+ }
73
+ if (!opts.tokenStdin && !io.interactive)
74
+ throw new Error("provide the access token through --token-stdin, or run in a terminal for a hidden prompt");
75
+ secret = (opts.tokenStdin ? await io.stdin() : await io.token()).trim();
76
+ if (!secret || /\s/.test(secret) || secret.length > 16384)
77
+ throw new Error("provide one nonempty access token");
78
+ const result = await requestJson(c.remote, `${c.path}/mount`, {
79
+ token: c.token, method: "POST", redirect: "error",
80
+ json: { uri: uri.toString().replace(/\/+$/, ""), prefix: opts.prefix, lakeshoreNamespace, token: secret },
81
+ });
82
+ // Select the non-secret DTO fields rather than printing an arbitrary response.
83
+ const mount = publicMount(result);
84
+ if (opts.json)
85
+ emitJson(mount);
86
+ else
87
+ process.stdout.write(`Mounted ${mount.slug} in ${c.ns}.\nNext: dreamlake queues list ${mount.slug} --namespace ${c.ns}\n`);
88
+ return 0;
89
+ }
90
+ catch (err) {
91
+ return error(err, secret);
92
+ }
93
+ }
94
+ function publicMount(value) {
95
+ if (!value || typeof value !== "object" || Array.isArray(value)) {
96
+ throw new Error("DreamLake returned an invalid mount response; no mount was confirmed");
97
+ }
98
+ const m = value;
99
+ for (const field of ["id", "name", "slug", "baseUrl", "lakeshoreNs"]) {
100
+ if (typeof m[field] !== "string" || !m[field].trim()) {
101
+ throw new Error("DreamLake returned an invalid mount response; no mount was confirmed");
102
+ }
103
+ }
104
+ if (typeof m.hasToken !== "boolean" || !["unverified", "ok", "error"].includes(m.status)) {
105
+ throw new Error("DreamLake returned an invalid mount response; no mount was confirmed");
106
+ }
107
+ return { id: m.id, name: m.name, slug: m.slug, baseUrl: m.baseUrl, lakeshoreNs: m.lakeshoreNs, status: m.status, hasToken: m.hasToken };
108
+ }
109
+ export async function runQueuesMounts(opts) {
110
+ try {
111
+ const c = await context(opts);
112
+ const result = await requestJson(c.remote, c.path, {
113
+ token: c.token, query: { page: opts.page, pageSize: opts.pageSize },
114
+ });
115
+ const mounts = result.lakeshores.map(publicMount);
116
+ if (opts.json)
117
+ emitJson({ lakeshores: mounts, page: result.page, pageSize: result.pageSize, total: result.total, totalPages: result.totalPages });
118
+ else
119
+ process.stdout.write(renderTable(mounts.map(m => ({ ...m })), ["slug", "baseUrl", "lakeshoreNs", "status"]) + `\n${result.total} mount(s)\n`);
120
+ return 0;
121
+ }
122
+ catch (err) {
123
+ return error(err);
124
+ }
125
+ }
126
+ export async function runQueuesInspect(prefix, opts) {
127
+ try {
128
+ const c = await context(opts);
129
+ const path = `${c.path}/${seg(prefix)}`;
130
+ const mount = publicMount(await requestJson(c.remote, path, { token: c.token }));
131
+ const connection = await requestJson(c.remote, `${path}/test`, { token: c.token, method: "POST" });
132
+ mount.status = connection.status ?? (connection.ok ? "ok" : "error");
133
+ if (opts.json)
134
+ emitJson({ mount, connection });
135
+ else {
136
+ process.stdout.write(renderTable([{ ...mount }], ["slug", "baseUrl", "lakeshoreNs", "status"]));
137
+ process.stdout.write(`\nConnection: ${connection.ok ? "online" : "failed"}\n`);
138
+ }
139
+ return connection.ok ? 0 : 1;
140
+ }
141
+ catch (err) {
142
+ return error(err);
143
+ }
144
+ }
145
+ export async function runQueuesList(prefix, opts) {
146
+ try {
147
+ const c = await context(opts);
148
+ const path = `${c.path}/${seg(prefix)}`;
149
+ const mount = await requestJson(c.remote, path, { token: c.token });
150
+ const result = await requestJson(c.remote, `${path}/proxy/v1/namespaces/${seg(mount.lakeshoreNs)}/queues`, { token: c.token });
151
+ if (opts.json)
152
+ emitJson(result);
153
+ else {
154
+ const rows = result.map(q => ({ ...q, mountedName: `${mount.slug}/${q.name}` }));
155
+ process.stdout.write(renderTable(rows, ["mountedName", "kind", "state", "memberCount"]) + `\n${rows.length} queue(s)\n`);
156
+ }
157
+ return 0;
158
+ }
159
+ catch (err) {
160
+ return error(err);
161
+ }
162
+ }
163
+ export async function runQueuesUnmount(prefix, opts) {
164
+ try {
165
+ const c = await context(opts);
166
+ await requestJson(c.remote, `${c.path}/${seg(prefix)}`, { token: c.token, method: "DELETE" });
167
+ if (opts.json)
168
+ emitJson({ unmounted: prefix });
169
+ else
170
+ process.stdout.write(`Unmounted ${prefix} from ${c.ns}. The Lakeshore server is still running; Vault entries and remote tokens are retained.\n`);
171
+ return 0;
172
+ }
173
+ catch (err) {
174
+ return error(err);
175
+ }
176
+ }
177
+ export async function runQueuesToken(prefix, opts, io = mountInput) {
178
+ let secret;
179
+ try {
180
+ const c = await context(opts);
181
+ process.stderr.write(`DreamLake: ${c.remote}\nDreamLake namespace: ${c.ns}\nMount prefix: ${prefix}\n`);
182
+ if (!opts.tokenStdin && !io.interactive)
183
+ throw new Error("provide --token-stdin, or run in a terminal for a hidden prompt");
184
+ secret = (opts.tokenStdin ? await io.stdin() : await io.token()).trim();
185
+ if (!secret || /\s/.test(secret) || secret.length > 16384)
186
+ throw new Error("provide one nonempty access token");
187
+ const result = await requestJson(c.remote, `${c.path}/${seg(prefix)}`, {
188
+ token: c.token, method: "PATCH", redirect: "error", json: { token: secret },
189
+ });
190
+ if (opts.json)
191
+ emitJson(publicMount(result));
192
+ else
193
+ process.stdout.write(`Updated the saved access token for ${prefix}.\n`);
194
+ return 0;
195
+ }
196
+ catch (err) {
197
+ return error(err, secret);
198
+ }
199
+ }
200
+ export async function runQueuesResources(prefix, resource, opts) {
201
+ try {
202
+ const c = await context(opts);
203
+ const path = `${c.path}/${seg(prefix)}`;
204
+ const mount = await requestJson(c.remote, path, { token: c.token });
205
+ const endpoint = resource === "jobs" ? "invocations" : "workers";
206
+ const result = await requestJson(c.remote, `${path}/proxy/v1/namespaces/${seg(mount.lakeshoreNs)}/${endpoint}`, {
207
+ token: c.token, query: resource === "jobs" ? { limit: opts.limit, offset: opts.offset } : undefined,
208
+ });
209
+ if (opts.json)
210
+ emitJson(result);
211
+ else {
212
+ const rows = Array.isArray(result) ? result : result.invocations;
213
+ process.stdout.write(renderTable(rows, resource === "jobs" ? ["id", "state", "queueName", "workerId"] : ["id", "label", "state", "lastSeenAt"]));
214
+ process.stdout.write(`\n${rows.length} ${resource} returned\n`);
215
+ }
216
+ return 0;
217
+ }
218
+ catch (err) {
219
+ return error(err);
220
+ }
221
+ }
222
+ export function registerQueuesCommand(program) {
223
+ const queues = program.command("queues").description("mount Lakeshore servers and view live queues through DreamLake");
224
+ registerSlurmCommands(queues);
225
+ const common = (cmd) => cmd.option("--namespace <slug>", "DreamLake namespace (default: active login)").option("--json", "emit JSON");
226
+ common(queues.command("mount").description("verify and save a Lakeshore server and its access token in DreamLake Vault")
227
+ .requiredOption("--uri <url>", "Lakeshore HTTPS server URL")
228
+ .requiredOption("--prefix <name>", "simple mount name, for example lab")
229
+ .option("--lakeshore-namespace <slug>", "namespace on Lakeshore (prompted if omitted)")
230
+ .option("--token-stdin", "read the Lakeshore access token from stdin instead of a hidden prompt"))
231
+ .action(async (opts) => { process.exitCode = await runQueuesMount(opts); });
232
+ common(queues.command("mounts").description("list mounted servers")
233
+ .option("--page <number>", "page of mounted servers")
234
+ .option("--page-size <count>", "mounts per page (maximum 200)"))
235
+ .action(async (opts) => { process.exitCode = await runQueuesMounts(opts); });
236
+ common(queues.command("inspect <prefix>").description("inspect a mount and check its live connection"))
237
+ .action(async (prefix, opts) => { process.exitCode = await runQueuesInspect(prefix, opts); });
238
+ common(queues.command("unmount <prefix>").description("remove the DreamLake mount; retain Vault entries and the running server"))
239
+ .action(async (prefix, opts) => { process.exitCode = await runQueuesUnmount(prefix, opts); });
240
+ common(queues.command("token <prefix>").description("replace the saved access token for a mount").option("--token-stdin", "read access token from stdin"))
241
+ .action(async (prefix, opts) => { process.exitCode = await runQueuesToken(prefix, opts); });
242
+ common(queues.command("workers <prefix>").description("view workers on a mounted server"))
243
+ .action(async (prefix, opts) => { process.exitCode = await runQueuesResources(prefix, "workers", opts); });
244
+ common(queues.command("jobs <prefix>").description("view jobs on a mounted server").option("--limit <count>", "maximum jobs").option("--offset <count>", "pagination offset"))
245
+ .action(async (prefix, opts) => { process.exitCode = await runQueuesResources(prefix, "jobs", opts); });
246
+ common(collectionList(queues, "list <prefix>").description("list live queues on a mounted server"))
247
+ .action(async (prefix, opts) => { process.exitCode = await runQueuesList(prefix, opts); });
248
+ }
@@ -0,0 +1,10 @@
1
+ import type { Command } from "commander";
2
+ interface Options {
3
+ namespace?: string;
4
+ json?: boolean;
5
+ details?: boolean;
6
+ }
7
+ export declare function runSlurmClusters(opts: Options): Promise<number>;
8
+ export declare function runSlurmJobs(clusterId: string, opts: Options): Promise<number>;
9
+ export declare function registerSlurmCommands(queues: Command): void;
10
+ export {};