@dreamlake/dreamlake-cli 0.88.1 → 0.90.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 (541) 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 +54 -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 +2362 -0
  18. package/dist/api/index.js +116 -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 +102 -0
  38. package/dist/api/note-files.js +107 -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-linger.d.ts +83 -0
  44. package/dist/api/note-linger.js +270 -0
  45. package/dist/api/note-presence.d.ts +82 -0
  46. package/dist/api/note-presence.js +72 -0
  47. package/dist/api/note-toc.d.ts +2 -0
  48. package/dist/api/note-toc.js +2 -0
  49. package/dist/api/notes.d.ts +329 -0
  50. package/dist/api/notes.js +209 -0
  51. package/dist/api/open-resources.d.ts +27 -0
  52. package/dist/api/open-resources.js +102 -0
  53. package/dist/api/ownership.d.ts +12 -0
  54. package/dist/api/ownership.js +24 -0
  55. package/dist/api/platform.d.ts +83 -0
  56. package/dist/api/platform.js +56 -0
  57. package/dist/api/presigned-transfer.d.ts +2 -0
  58. package/dist/api/presigned-transfer.js +2 -0
  59. package/dist/api/registered-runs.d.ts +48 -0
  60. package/dist/api/registered-runs.js +33 -0
  61. package/dist/api/sessions.d.ts +299 -0
  62. package/dist/api/sessions.js +105 -0
  63. package/dist/api/storage.d.ts +46 -0
  64. package/dist/api/storage.js +34 -0
  65. package/dist/api/streams.d.ts +18 -0
  66. package/dist/api/streams.js +70 -0
  67. package/dist/api/vault.d.ts +93 -0
  68. package/dist/api/vault.js +79 -0
  69. package/dist/api/workspace.d.ts +180 -0
  70. package/dist/api/workspace.js +146 -0
  71. package/dist/cli/agent-identity.d.ts +4 -0
  72. package/dist/cli/agent-identity.js +21 -0
  73. package/dist/cli/agents/identity.d.ts +50 -0
  74. package/dist/cli/agents/identity.js +105 -0
  75. package/dist/cli/agents/index.d.ts +31 -0
  76. package/dist/cli/agents/index.js +580 -0
  77. package/dist/cli/agents/manage.d.ts +43 -0
  78. package/dist/cli/agents/manage.js +376 -0
  79. package/dist/cli/agents/spec.d.ts +104 -0
  80. package/dist/cli/agents/spec.js +280 -0
  81. package/dist/cli/agents/web.d.ts +7 -0
  82. package/dist/cli/agents/web.js +109 -0
  83. package/dist/cli/artifact/incremental.d.ts +21 -0
  84. package/dist/cli/artifact/incremental.js +80 -0
  85. package/dist/cli/artifact/index.d.ts +52 -0
  86. package/dist/cli/artifact/index.js +405 -0
  87. package/dist/cli/artifact/meta.d.ts +69 -0
  88. package/dist/cli/artifact/meta.js +189 -0
  89. package/dist/cli/auth/commands.d.ts +29 -0
  90. package/dist/cli/auth/commands.js +327 -0
  91. package/dist/cli/auth/constants.d.ts +13 -0
  92. package/dist/cli/auth/constants.js +18 -0
  93. package/dist/cli/auth/credentials.d.ts +37 -0
  94. package/dist/cli/auth/credentials.js +155 -0
  95. package/dist/cli/auth/device-flow.d.ts +32 -0
  96. package/dist/cli/auth/device-flow.js +154 -0
  97. package/dist/cli/auth/device-secret.d.ts +6 -0
  98. package/dist/cli/auth/device-secret.js +26 -0
  99. package/dist/cli/auth/machine.d.ts +15 -0
  100. package/dist/cli/auth/machine.js +126 -0
  101. package/dist/cli/auth/materialized.d.ts +32 -0
  102. package/dist/cli/auth/materialized.js +102 -0
  103. package/dist/cli/auth/migrate.d.ts +10 -0
  104. package/dist/cli/auth/migrate.js +75 -0
  105. package/dist/cli/client.d.ts +102 -0
  106. package/dist/cli/client.js +206 -0
  107. package/dist/cli/collection-list.d.ts +3 -0
  108. package/dist/cli/collection-list.js +25 -0
  109. package/dist/cli/compat/ctx.d.ts +26 -0
  110. package/dist/cli/compat/ctx.js +76 -0
  111. package/dist/cli/compat/dreamdb-wasm-embedded.d.ts +2 -0
  112. package/dist/cli/compat/dreamdb-wasm-embedded.js +8 -0
  113. package/dist/cli/compat/dreamdb-wasm.d.ts +1 -0
  114. package/dist/cli/compat/dreamdb-wasm.js +26 -0
  115. package/dist/cli/compat/dreamdb.d.ts +112 -0
  116. package/dist/cli/compat/dreamdb.js +219 -0
  117. package/dist/cli/compat/flags.d.ts +2 -0
  118. package/dist/cli/compat/flags.js +13 -0
  119. package/dist/cli/compat/http.d.ts +23 -0
  120. package/dist/cli/compat/http.js +137 -0
  121. package/dist/cli/compat/presignedTransfer.d.ts +139 -0
  122. package/dist/cli/compat/presignedTransfer.js +580 -0
  123. package/dist/cli/compat/s3-backend.d.ts +73 -0
  124. package/dist/cli/compat/s3-backend.js +132 -0
  125. package/dist/cli/config.d.ts +22 -0
  126. package/dist/cli/config.js +96 -0
  127. package/dist/cli/connection/dto.d.ts +159 -0
  128. package/dist/cli/connection/dto.js +497 -0
  129. package/dist/cli/connection/index.d.ts +50 -0
  130. package/dist/cli/connection/index.js +413 -0
  131. package/dist/cli/connection/oauth.d.ts +23 -0
  132. package/dist/cli/connection/oauth.js +290 -0
  133. package/dist/cli/connection/write.d.ts +47 -0
  134. package/dist/cli/connection/write.js +573 -0
  135. package/dist/cli/create/index.d.ts +19 -0
  136. package/dist/cli/create/index.js +209 -0
  137. package/dist/cli/declare/index.d.ts +29 -0
  138. package/dist/cli/declare/index.js +304 -0
  139. package/dist/cli/delete/index.d.ts +18 -0
  140. package/dist/cli/delete/index.js +232 -0
  141. package/dist/cli/download/index.d.ts +9 -0
  142. package/dist/cli/download/index.js +128 -0
  143. package/dist/cli/env/compose.d.ts +88 -0
  144. package/dist/cli/env/compose.js +402 -0
  145. package/dist/cli/env/index.d.ts +176 -0
  146. package/dist/cli/env/index.js +1011 -0
  147. package/dist/cli/experiments/index.d.ts +11 -0
  148. package/dist/cli/experiments/index.js +168 -0
  149. package/dist/cli/glob.d.ts +1 -0
  150. package/dist/cli/glob.js +45 -0
  151. package/dist/cli/graphql-helpers.d.ts +23 -0
  152. package/dist/cli/graphql-helpers.js +42 -0
  153. package/dist/cli/graphql.d.ts +10 -0
  154. package/dist/cli/graphql.js +47 -0
  155. package/dist/cli/help-examples.generated.d.ts +1 -0
  156. package/dist/cli/help-examples.generated.js +192 -0
  157. package/dist/cli/helpers.d.ts +8 -0
  158. package/dist/cli/helpers.js +106 -0
  159. package/dist/cli/hosts/api.d.ts +29 -0
  160. package/dist/cli/hosts/api.js +54 -0
  161. package/dist/cli/hosts/bootstrap-source.d.ts +1 -0
  162. package/dist/cli/hosts/bootstrap-source.js +2 -0
  163. package/dist/cli/hosts/catalog.d.ts +26 -0
  164. package/dist/cli/hosts/catalog.js +55 -0
  165. package/dist/cli/hosts/config.d.ts +45 -0
  166. package/dist/cli/hosts/config.js +179 -0
  167. package/dist/cli/hosts/credentials.d.ts +19 -0
  168. package/dist/cli/hosts/credentials.js +173 -0
  169. package/dist/cli/hosts/enroll.d.ts +17 -0
  170. package/dist/cli/hosts/enroll.js +109 -0
  171. package/dist/cli/hosts/enrollments.d.ts +25 -0
  172. package/dist/cli/hosts/enrollments.js +54 -0
  173. package/dist/cli/hosts/index.d.ts +6 -0
  174. package/dist/cli/hosts/index.js +279 -0
  175. package/dist/cli/hosts/inventory.d.ts +40 -0
  176. package/dist/cli/hosts/inventory.js +91 -0
  177. package/dist/cli/hosts/lifecycle.d.ts +15 -0
  178. package/dist/cli/hosts/lifecycle.js +108 -0
  179. package/dist/cli/hosts/metrics-source.d.ts +12 -0
  180. package/dist/cli/hosts/metrics-source.js +89 -0
  181. package/dist/cli/hosts/observations.d.ts +39 -0
  182. package/dist/cli/hosts/observations.js +102 -0
  183. package/dist/cli/hosts/remote.d.ts +5 -0
  184. package/dist/cli/hosts/remote.js +66 -0
  185. package/dist/cli/hosts/ssh.d.ts +63 -0
  186. package/dist/cli/hosts/ssh.js +276 -0
  187. package/dist/cli/index.d.ts +1 -0
  188. package/dist/cli/index.js +288 -0
  189. package/dist/cli/infra/api.d.ts +95 -0
  190. package/dist/cli/infra/api.js +291 -0
  191. package/dist/cli/infra/index.d.ts +5 -0
  192. package/dist/cli/infra/index.js +102 -0
  193. package/dist/cli/infra/move.d.ts +15 -0
  194. package/dist/cli/infra/move.js +123 -0
  195. package/dist/cli/infra/transfer.d.ts +15 -0
  196. package/dist/cli/infra/transfer.js +280 -0
  197. package/dist/cli/jobs/api.d.ts +69 -0
  198. package/dist/cli/jobs/api.js +121 -0
  199. package/dist/cli/jobs/index.d.ts +5 -0
  200. package/dist/cli/jobs/index.js +140 -0
  201. package/dist/cli/lakeshore/index.d.ts +98 -0
  202. package/dist/cli/lakeshore/index.js +502 -0
  203. package/dist/cli/launch/index.d.ts +43 -0
  204. package/dist/cli/launch/index.js +270 -0
  205. package/dist/cli/layout/index.d.ts +2 -0
  206. package/dist/cli/layout/index.js +44 -0
  207. package/dist/cli/layout/transport.d.ts +12 -0
  208. package/dist/cli/layout/transport.js +70 -0
  209. package/dist/cli/library/add.d.ts +60 -0
  210. package/dist/cli/library/add.js +348 -0
  211. package/dist/cli/library/cache.d.ts +26 -0
  212. package/dist/cli/library/cache.js +88 -0
  213. package/dist/cli/library/config.d.ts +75 -0
  214. package/dist/cli/library/config.js +198 -0
  215. package/dist/cli/library/digest.d.ts +5 -0
  216. package/dist/cli/library/digest.js +19 -0
  217. package/dist/cli/library/discover.d.ts +87 -0
  218. package/dist/cli/library/discover.js +534 -0
  219. package/dist/cli/library/freshness.d.ts +35 -0
  220. package/dist/cli/library/freshness.js +109 -0
  221. package/dist/cli/library/generation.d.ts +35 -0
  222. package/dist/cli/library/generation.js +211 -0
  223. package/dist/cli/library/index.d.ts +2 -0
  224. package/dist/cli/library/index.js +36 -0
  225. package/dist/cli/library/info.d.ts +69 -0
  226. package/dist/cli/library/info.js +311 -0
  227. package/dist/cli/library/list.d.ts +33 -0
  228. package/dist/cli/library/list.js +86 -0
  229. package/dist/cli/library/manifest.d.ts +81 -0
  230. package/dist/cli/library/manifest.js +200 -0
  231. package/dist/cli/library/manifestCache.d.ts +45 -0
  232. package/dist/cli/library/manifestCache.js +169 -0
  233. package/dist/cli/library/pull.d.ts +30 -0
  234. package/dist/cli/library/pull.js +438 -0
  235. package/dist/cli/library/push.d.ts +72 -0
  236. package/dist/cli/library/push.js +642 -0
  237. package/dist/cli/library/rm.d.ts +31 -0
  238. package/dist/cli/library/rm.js +200 -0
  239. package/dist/cli/library/search.d.ts +18 -0
  240. package/dist/cli/library/search.js +181 -0
  241. package/dist/cli/library/stat.d.ts +15 -0
  242. package/dist/cli/library/stat.js +127 -0
  243. package/dist/cli/library/tools.d.ts +104 -0
  244. package/dist/cli/library/tools.js +163 -0
  245. package/dist/cli/library/wire.d.ts +47 -0
  246. package/dist/cli/library/wire.js +120 -0
  247. package/dist/cli/list/index.d.ts +26 -0
  248. package/dist/cli/list/index.js +256 -0
  249. package/dist/cli/notes/api-transport.d.ts +5 -0
  250. package/dist/cli/notes/api-transport.js +20 -0
  251. package/dist/cli/notes/character-plan.d.ts +22 -0
  252. package/dist/cli/notes/character-plan.js +232 -0
  253. package/dist/cli/notes/document.d.ts +73 -0
  254. package/dist/cli/notes/document.js +306 -0
  255. package/dist/cli/notes/edit-commands.d.ts +106 -0
  256. package/dist/cli/notes/edit-commands.js +623 -0
  257. package/dist/cli/notes/editing.d.ts +81 -0
  258. package/dist/cli/notes/editing.js +305 -0
  259. package/dist/cli/notes/events.d.ts +36 -0
  260. package/dist/cli/notes/events.js +54 -0
  261. package/dist/cli/notes/files-commands.d.ts +97 -0
  262. package/dist/cli/notes/files-commands.js +548 -0
  263. package/dist/cli/notes/html-read.d.ts +9 -0
  264. package/dist/cli/notes/html-read.js +90 -0
  265. package/dist/cli/notes/html.d.ts +73 -0
  266. package/dist/cli/notes/html.js +381 -0
  267. package/dist/cli/notes/index.d.ts +123 -0
  268. package/dist/cli/notes/index.js +1300 -0
  269. package/dist/cli/notes/linger.d.ts +4 -0
  270. package/dist/cli/notes/linger.js +96 -0
  271. package/dist/cli/notes/media-commands.d.ts +5 -0
  272. package/dist/cli/notes/media-commands.js +51 -0
  273. package/dist/cli/notes/move-command.d.ts +83 -0
  274. package/dist/cli/notes/move-command.js +259 -0
  275. package/dist/cli/notes/rm-command.d.ts +22 -0
  276. package/dist/cli/notes/rm-command.js +110 -0
  277. package/dist/cli/notes/select-command.d.ts +12 -0
  278. package/dist/cli/notes/select-command.js +63 -0
  279. package/dist/cli/notes/suggest-diff.d.ts +56 -0
  280. package/dist/cli/notes/suggest-diff.js +311 -0
  281. package/dist/cli/notes/toc.d.ts +38 -0
  282. package/dist/cli/notes/toc.js +144 -0
  283. package/dist/cli/notes/transfer-command.d.ts +6 -0
  284. package/dist/cli/notes/transfer-command.js +9 -0
  285. package/dist/cli/notes/version-commands.d.ts +19 -0
  286. package/dist/cli/notes/version-commands.js +178 -0
  287. package/dist/cli/nymph/index.d.ts +74 -0
  288. package/dist/cli/nymph/index.js +349 -0
  289. package/dist/cli/org/index.d.ts +34 -0
  290. package/dist/cli/org/index.js +341 -0
  291. package/dist/cli/ownership/index.d.ts +12 -0
  292. package/dist/cli/ownership/index.js +122 -0
  293. package/dist/cli/ownership/metadata-transfer.d.ts +20 -0
  294. package/dist/cli/ownership/metadata-transfer.js +159 -0
  295. package/dist/cli/page/index.d.ts +58 -0
  296. package/dist/cli/page/index.js +387 -0
  297. package/dist/cli/pipeline/index.d.ts +69 -0
  298. package/dist/cli/pipeline/index.js +604 -0
  299. package/dist/cli/progress.d.ts +60 -0
  300. package/dist/cli/progress.js +276 -0
  301. package/dist/cli/project/attachments.d.ts +10 -0
  302. package/dist/cli/project/attachments.js +39 -0
  303. package/dist/cli/project/grants.d.ts +10 -0
  304. package/dist/cli/project/grants.js +39 -0
  305. package/dist/cli/project/index.d.ts +8 -0
  306. package/dist/cli/project/index.js +92 -0
  307. package/dist/cli/project/move.d.ts +57 -0
  308. package/dist/cli/project/move.js +242 -0
  309. package/dist/cli/project/output.d.ts +2 -0
  310. package/dist/cli/project/output.js +29 -0
  311. package/dist/cli/project/stream.d.ts +55 -0
  312. package/dist/cli/project/stream.js +207 -0
  313. package/dist/cli/project/transfer-preview.d.ts +8 -0
  314. package/dist/cli/project/transfer-preview.js +10 -0
  315. package/dist/cli/prompt.d.ts +1 -0
  316. package/dist/cli/prompt.js +17 -0
  317. package/dist/cli/provider/dreamdir.d.ts +52 -0
  318. package/dist/cli/provider/dreamdir.js +138 -0
  319. package/dist/cli/provider/index.d.ts +4 -0
  320. package/dist/cli/provider/index.js +419 -0
  321. package/dist/cli/provider/jump-worker.d.ts +9 -0
  322. package/dist/cli/provider/jump-worker.js +141 -0
  323. package/dist/cli/provider/lifecycle.d.ts +149 -0
  324. package/dist/cli/provider/lifecycle.js +1390 -0
  325. package/dist/cli/provider/machine.d.ts +17 -0
  326. package/dist/cli/provider/machine.js +116 -0
  327. package/dist/cli/provider/ssh.d.ts +105 -0
  328. package/dist/cli/provider/ssh.js +305 -0
  329. package/dist/cli/provider/terraform.d.ts +140 -0
  330. package/dist/cli/provider/terraform.js +288 -0
  331. package/dist/cli/providers/index.d.ts +18 -0
  332. package/dist/cli/providers/index.js +422 -0
  333. package/dist/cli/python.d.ts +61 -0
  334. package/dist/cli/python.js +255 -0
  335. package/dist/cli/queues/index.d.ts +33 -0
  336. package/dist/cli/queues/index.js +248 -0
  337. package/dist/cli/queues/slurm.d.ts +10 -0
  338. package/dist/cli/queues/slurm.js +134 -0
  339. package/dist/cli/resources.d.ts +72 -0
  340. package/dist/cli/resources.js +137 -0
  341. package/dist/cli/run/index.d.ts +15 -0
  342. package/dist/cli/run/index.js +163 -0
  343. package/dist/cli/run/input.d.ts +34 -0
  344. package/dist/cli/run/input.js +135 -0
  345. package/dist/cli/run/recovery.d.ts +2 -0
  346. package/dist/cli/run/recovery.js +18 -0
  347. package/dist/cli/run/setup.d.ts +3 -0
  348. package/dist/cli/run/setup.js +62 -0
  349. package/dist/cli/runconfig/index.d.ts +12 -0
  350. package/dist/cli/runconfig/index.js +130 -0
  351. package/dist/cli/runnable/index.d.ts +35 -0
  352. package/dist/cli/runnable/index.js +575 -0
  353. package/dist/cli/runnable/path.d.ts +115 -0
  354. package/dist/cli/runnable/path.js +288 -0
  355. package/dist/cli/runnable/run.d.ts +91 -0
  356. package/dist/cli/runnable/run.js +239 -0
  357. package/dist/cli/runnable/upload.d.ts +43 -0
  358. package/dist/cli/runnable/upload.js +342 -0
  359. package/dist/cli/runnable/worker.d.ts +1 -0
  360. package/dist/cli/runnable/worker.js +44 -0
  361. package/dist/cli/schemas/workflow-spec.schema.json +335 -0
  362. package/dist/cli/self-update/index.d.ts +5 -0
  363. package/dist/cli/self-update/index.js +107 -0
  364. package/dist/cli/self-update/install.d.ts +60 -0
  365. package/dist/cli/self-update/install.js +428 -0
  366. package/dist/cli/self-update/paths.d.ts +40 -0
  367. package/dist/cli/self-update/paths.js +87 -0
  368. package/dist/cli/self-update/releases.d.ts +41 -0
  369. package/dist/cli/self-update/releases.js +153 -0
  370. package/dist/cli/self-update/settings.d.ts +16 -0
  371. package/dist/cli/self-update/settings.js +68 -0
  372. package/dist/cli/self-update/update.d.ts +18 -0
  373. package/dist/cli/self-update/update.js +241 -0
  374. package/dist/cli/service-accounts/index.d.ts +3 -0
  375. package/dist/cli/service-accounts/index.js +149 -0
  376. package/dist/cli/session-affiliation.d.ts +26 -0
  377. package/dist/cli/session-affiliation.js +135 -0
  378. package/dist/cli/sessions/affiliation.d.ts +8 -0
  379. package/dist/cli/sessions/affiliation.js +66 -0
  380. package/dist/cli/sessions/api.d.ts +55 -0
  381. package/dist/cli/sessions/api.js +88 -0
  382. package/dist/cli/sessions/control.d.ts +6 -0
  383. package/dist/cli/sessions/control.js +159 -0
  384. package/dist/cli/sessions/conversation.d.ts +15 -0
  385. package/dist/cli/sessions/conversation.js +118 -0
  386. package/dist/cli/sessions/index.d.ts +2 -0
  387. package/dist/cli/sessions/index.js +209 -0
  388. package/dist/cli/sessions/managed.d.ts +39 -0
  389. package/dist/cli/sessions/managed.js +63 -0
  390. package/dist/cli/sessions/redaction.d.ts +2 -0
  391. package/dist/cli/sessions/redaction.js +11 -0
  392. package/dist/cli/sessions/runner/exec.d.ts +108 -0
  393. package/dist/cli/sessions/runner/exec.js +335 -0
  394. package/dist/cli/sessions/runner/journal.d.ts +26 -0
  395. package/dist/cli/sessions/runner/journal.js +49 -0
  396. package/dist/cli/sessions/runner/native.d.ts +48 -0
  397. package/dist/cli/sessions/runner/native.js +170 -0
  398. package/dist/cli/sessions/runner/pod.d.ts +30 -0
  399. package/dist/cli/sessions/runner/pod.js +129 -0
  400. package/dist/cli/sessions/runner/serve.d.ts +85 -0
  401. package/dist/cli/sessions/runner/serve.js +558 -0
  402. package/dist/cli/sessions/sync.d.ts +47 -0
  403. package/dist/cli/sessions/sync.js +80 -0
  404. package/dist/cli/sessions/transport.d.ts +14 -0
  405. package/dist/cli/sessions/transport.js +116 -0
  406. package/dist/cli/share.d.ts +15 -0
  407. package/dist/cli/share.js +139 -0
  408. package/dist/cli/skill/catalog.d.ts +141 -0
  409. package/dist/cli/skill/catalog.js +442 -0
  410. package/dist/cli/skill/files.d.ts +89 -0
  411. package/dist/cli/skill/files.js +264 -0
  412. package/dist/cli/skill/index.d.ts +268 -0
  413. package/dist/cli/skill/index.js +1216 -0
  414. package/dist/cli/skill/manifest.d.ts +30 -0
  415. package/dist/cli/skill/manifest.js +101 -0
  416. package/dist/cli/skill/prefs.d.ts +9 -0
  417. package/dist/cli/skill/prefs.js +32 -0
  418. package/dist/cli/skill/reminders.d.ts +15 -0
  419. package/dist/cli/skill/reminders.js +105 -0
  420. package/dist/cli/skill/tar.d.ts +17 -0
  421. package/dist/cli/skill/tar.js +195 -0
  422. package/dist/cli/snapshot/index.d.ts +24 -0
  423. package/dist/cli/snapshot/index.js +146 -0
  424. package/dist/cli/source/access.d.ts +45 -0
  425. package/dist/cli/source/access.js +563 -0
  426. package/dist/cli/source/control.d.ts +103 -0
  427. package/dist/cli/source/control.js +546 -0
  428. package/dist/cli/source/delete.d.ts +89 -0
  429. package/dist/cli/source/delete.js +463 -0
  430. package/dist/cli/source/index.d.ts +288 -0
  431. package/dist/cli/source/index.js +1348 -0
  432. package/dist/cli/source/share.d.ts +65 -0
  433. package/dist/cli/source/share.js +530 -0
  434. package/dist/cli/source/upload.d.ts +62 -0
  435. package/dist/cli/source/upload.js +258 -0
  436. package/dist/cli/source/write.d.ts +77 -0
  437. package/dist/cli/source/write.js +335 -0
  438. package/dist/cli/spawn.d.ts +28 -0
  439. package/dist/cli/spawn.js +81 -0
  440. package/dist/cli/target.d.ts +22 -0
  441. package/dist/cli/target.js +85 -0
  442. package/dist/cli/tasks/index.d.ts +38 -0
  443. package/dist/cli/tasks/index.js +365 -0
  444. package/dist/cli/team/index.d.ts +37 -0
  445. package/dist/cli/team/index.js +407 -0
  446. package/dist/cli/telemetry.d.ts +23 -0
  447. package/dist/cli/telemetry.js +262 -0
  448. package/dist/cli/telemetryJournal.d.ts +26 -0
  449. package/dist/cli/telemetryJournal.js +104 -0
  450. package/dist/cli/update/index.d.ts +21 -0
  451. package/dist/cli/update/index.js +284 -0
  452. package/dist/cli/upload/index.d.ts +11 -0
  453. package/dist/cli/upload/index.js +261 -0
  454. package/dist/cli/upload/kinds.d.ts +10 -0
  455. package/dist/cli/upload/kinds.js +85 -0
  456. package/dist/cli/upload/multipart.d.ts +21 -0
  457. package/dist/cli/upload/multipart.js +248 -0
  458. package/dist/cli/vault/affected-preview.d.ts +15 -0
  459. package/dist/cli/vault/affected-preview.js +38 -0
  460. package/dist/cli/vault/cloud.d.ts +55 -0
  461. package/dist/cli/vault/cloud.js +287 -0
  462. package/dist/cli/vault/format.d.ts +18 -0
  463. package/dist/cli/vault/format.js +104 -0
  464. package/dist/cli/vault/hostCredentials.d.ts +21 -0
  465. package/dist/cli/vault/hostCredentials.js +71 -0
  466. package/dist/cli/vault/hostSupersessions.d.ts +18 -0
  467. package/dist/cli/vault/hostSupersessions.js +68 -0
  468. package/dist/cli/vault/import.d.ts +3 -0
  469. package/dist/cli/vault/import.js +79 -0
  470. package/dist/cli/vault/index.d.ts +14 -0
  471. package/dist/cli/vault/index.js +225 -0
  472. package/dist/cli/vault/keys.d.ts +5 -0
  473. package/dist/cli/vault/keys.js +165 -0
  474. package/dist/cli/vault/kms.d.ts +6 -0
  475. package/dist/cli/vault/kms.js +169 -0
  476. package/dist/cli/vault/list.d.ts +13 -0
  477. package/dist/cli/vault/list.js +60 -0
  478. package/dist/cli/vault/listView.d.ts +21 -0
  479. package/dist/cli/vault/listView.js +123 -0
  480. package/dist/cli/vault/managementMetadata.d.ts +2 -0
  481. package/dist/cli/vault/managementMetadata.js +23 -0
  482. package/dist/cli/vault/mutations.d.ts +8 -0
  483. package/dist/cli/vault/mutations.js +151 -0
  484. package/dist/cli/vault/otp.d.ts +6 -0
  485. package/dist/cli/vault/otp.js +62 -0
  486. package/dist/cli/vault/otpIntent.d.ts +23 -0
  487. package/dist/cli/vault/otpIntent.js +76 -0
  488. package/dist/cli/vault/passImport.d.ts +25 -0
  489. package/dist/cli/vault/passImport.js +129 -0
  490. package/dist/cli/vault/passOtp.d.ts +51 -0
  491. package/dist/cli/vault/passOtp.js +101 -0
  492. package/dist/cli/vault/passStore.d.ts +26 -0
  493. package/dist/cli/vault/passStore.js +134 -0
  494. package/dist/cli/vault/passwordCommand.d.ts +39 -0
  495. package/dist/cli/vault/passwordCommand.js +101 -0
  496. package/dist/cli/vault/passwordProbe.d.ts +27 -0
  497. package/dist/cli/vault/passwordProbe.js +282 -0
  498. package/dist/cli/vault/passwordRotation.d.ts +9 -0
  499. package/dist/cli/vault/passwordRotation.js +273 -0
  500. package/dist/cli/vault/rotationApi.d.ts +13 -0
  501. package/dist/cli/vault/rotationApi.js +58 -0
  502. package/dist/cli/vault/rotationCommand.d.ts +2 -0
  503. package/dist/cli/vault/rotationCommand.js +75 -0
  504. package/dist/cli/vault/rotationEngine.d.ts +19 -0
  505. package/dist/cli/vault/rotationEngine.js +65 -0
  506. package/dist/cli/vault/rotationHelperSource.d.ts +2 -0
  507. package/dist/cli/vault/rotationHelperSource.js +3 -0
  508. package/dist/cli/vault/rotationInput.d.ts +11 -0
  509. package/dist/cli/vault/rotationInput.js +48 -0
  510. package/dist/cli/vault/rotationJournal.d.ts +16 -0
  511. package/dist/cli/vault/rotationJournal.js +183 -0
  512. package/dist/cli/vault/rotationKeys.d.ts +4 -0
  513. package/dist/cli/vault/rotationKeys.js +48 -0
  514. package/dist/cli/vault/rotationPrepare.d.ts +17 -0
  515. package/dist/cli/vault/rotationPrepare.js +108 -0
  516. package/dist/cli/vault/rotationRemote.d.ts +33 -0
  517. package/dist/cli/vault/rotationRemote.js +156 -0
  518. package/dist/cli/vault/rotationState.d.ts +42 -0
  519. package/dist/cli/vault/rotationState.js +115 -0
  520. package/dist/cli/vault/rotationTransport.d.ts +18 -0
  521. package/dist/cli/vault/rotationTransport.js +71 -0
  522. package/dist/cli/vault/sshSource.d.ts +18 -0
  523. package/dist/cli/vault/sshSource.js +196 -0
  524. package/dist/cli/vault/sshSync.d.ts +17 -0
  525. package/dist/cli/vault/sshSync.js +224 -0
  526. package/dist/cli/vault/sshTransfer.d.ts +22 -0
  527. package/dist/cli/vault/sshTransfer.js +140 -0
  528. package/dist/cli/vault/terraformState.d.ts +66 -0
  529. package/dist/cli/vault/terraformState.js +252 -0
  530. package/dist/cli/vault/terraformStateCommand.d.ts +2 -0
  531. package/dist/cli/vault/terraformStateCommand.js +61 -0
  532. package/dist/cli/vault/tree.d.ts +43 -0
  533. package/dist/cli/vault/tree.js +292 -0
  534. package/dist/cli/version.d.ts +1 -0
  535. package/dist/cli/version.js +9 -0
  536. package/dist/cli/workflow/index.d.ts +76 -0
  537. package/dist/cli/workflow/index.js +826 -0
  538. package/dist/cli/workflow/validate.d.ts +19 -0
  539. package/dist/cli/workflow/validate.js +353 -0
  540. package/dist/package.json +1 -0
  541. package/package.json +28 -10
@@ -0,0 +1,209 @@
1
+ // `dreamlake create bindr|dataset <name> --project <target> ...`.
2
+ // Port of dreamlake-py's cli/commands/create.py.
3
+ //
4
+ // bindr — members are EPISODES matched by `--episode <glob>` (node path)
5
+ // dataset — created empty; add bindrs later via `update dataset`
6
+ import { HttpError, requestJson } from "../client.js";
7
+ import { resolveNamespace, resolveRemote, resolveToken } from "../config.js";
8
+ import { fail, ok, splitCsv } from "../helpers.js";
9
+ import { confirm } from "../prompt.js";
10
+ import { fetchAllEpisodes, matchEpisodes, resolveProjectCtx, } from "../resources.js";
11
+ import { formatProject } from "../target.js";
12
+ export async function runCreateBindr(name, opts) {
13
+ if (!opts.project) {
14
+ fail("--project is required");
15
+ return 1;
16
+ }
17
+ const ctx = await resolveProjectCtx(opts.project);
18
+ if (!ctx)
19
+ return 1;
20
+ const { s, token, remote } = ctx;
21
+ const base = `/namespaces/${s.namespace}/projects/${s.project}/bindrs`;
22
+ let members = [];
23
+ if (opts.episode) {
24
+ const episodes = await fetchAllEpisodes(remote, s.namespace, s.project, token);
25
+ const matched = matchEpisodes(episodes, opts.episode);
26
+ if (matched.length === 0) {
27
+ fail(`no episodes match '${opts.episode}'`);
28
+ return 1;
29
+ }
30
+ process.stdout.write(`Matched ${matched.length} episode(s):\n`);
31
+ for (const ep of matched)
32
+ process.stdout.write(` ${ep.nodePath ?? ep.name ?? ""}\n`);
33
+ const proceed = await confirm(`Create bindr '${name}' with ${matched.length} episodes?`, false);
34
+ if (!proceed) {
35
+ process.stdout.write("Cancelled.\n");
36
+ return 0;
37
+ }
38
+ members = matched.map((ep) => ep.id);
39
+ }
40
+ const body = { name, members };
41
+ if (opts.description)
42
+ body.description = opts.description;
43
+ const tags = splitCsv(opts.tags);
44
+ if (tags.length)
45
+ body.tags = tags;
46
+ try {
47
+ await requestJson(remote, base, { method: "POST", token, json: body });
48
+ }
49
+ catch (err) {
50
+ if (err instanceof HttpError && err.status === 409) {
51
+ fail(`bindr '${name}' already exists in ${formatProject(s)}`);
52
+ return 1;
53
+ }
54
+ if (err instanceof HttpError && err.status === 404) {
55
+ fail(`project '${formatProject(s)}' not found`);
56
+ return 1;
57
+ }
58
+ fail(err.message);
59
+ return 1;
60
+ }
61
+ ok(`Created bindr: ${name} in ${formatProject(s)}`);
62
+ if (members.length)
63
+ process.stdout.write(` episodes: ${members.length}\n`);
64
+ if (opts.description)
65
+ process.stdout.write(` description: ${opts.description}\n`);
66
+ if (tags.length)
67
+ process.stdout.write(` tags: ${tags.join(", ")}\n`);
68
+ return 0;
69
+ }
70
+ export async function runCreateDataset(name, opts) {
71
+ if (!opts.project) {
72
+ fail("--project is required");
73
+ return 1;
74
+ }
75
+ const ctx = await resolveProjectCtx(opts.project);
76
+ if (!ctx)
77
+ return 1;
78
+ const { s, token, remote } = ctx;
79
+ const body = { name };
80
+ if (opts.description)
81
+ body.description = opts.description;
82
+ const tags = splitCsv(opts.tags);
83
+ if (tags.length)
84
+ body.tags = tags;
85
+ try {
86
+ await requestJson(remote, `/namespaces/${s.namespace}/projects/${s.project}/datasets`, {
87
+ method: "POST",
88
+ token,
89
+ json: body,
90
+ });
91
+ }
92
+ catch (err) {
93
+ if (err instanceof HttpError && err.status === 409) {
94
+ fail(`dataset '${name}' already exists in ${formatProject(s)}`);
95
+ return 1;
96
+ }
97
+ if (err instanceof HttpError && err.status === 404) {
98
+ fail(`project '${formatProject(s)}' not found`);
99
+ return 1;
100
+ }
101
+ fail(err.message);
102
+ return 1;
103
+ }
104
+ ok(`Created dataset: ${name} in ${formatProject(s)}`);
105
+ if (opts.description)
106
+ process.stdout.write(` description: ${opts.description}\n`);
107
+ if (tags.length)
108
+ process.stdout.write(` tags: ${tags.join(", ")}\n`);
109
+ return 0;
110
+ }
111
+ export async function runCreateProject(name, opts) {
112
+ if (opts.visibility && opts.visibility !== "public" && opts.visibility !== "private") {
113
+ fail(`--visibility must be 'public' or 'private', got '${opts.visibility}'`);
114
+ return 1;
115
+ }
116
+ const remote = resolveRemote();
117
+ const token = resolveToken();
118
+ if (!token) {
119
+ fail("not authenticated. run 'dreamlake login' first");
120
+ return 1;
121
+ }
122
+ const namespace = await resolveNamespace(opts.namespace, { token, remote });
123
+ if (!namespace) {
124
+ fail("namespace not specified and no authenticated user found. run 'dreamlake login'");
125
+ return 1;
126
+ }
127
+ const body = { name };
128
+ if (opts.slug)
129
+ body.slug = opts.slug;
130
+ if (opts.description)
131
+ body.description = opts.description;
132
+ if (opts.visibility)
133
+ body.visibility = opts.visibility;
134
+ const tags = splitCsv(opts.tags);
135
+ if (tags.length)
136
+ body.tags = tags;
137
+ let created;
138
+ try {
139
+ created = await requestJson(remote, `/namespaces/${namespace}/projects`, {
140
+ method: "POST",
141
+ token,
142
+ json: body,
143
+ });
144
+ }
145
+ catch (err) {
146
+ if (err instanceof HttpError && err.status === 409) {
147
+ // Report the server's reason: a 409 here is not always a duplicate
148
+ // slug. OPERATION_CONFLICT is a write conflict the server gave up on.
149
+ const transient = err.code === "OPERATION_CONFLICT" || err.message === "(409) OPERATION_CONFLICT";
150
+ fail(transient
151
+ ? `${err.message}: a concurrent change conflicted with this request; retrying may succeed`
152
+ : err.message);
153
+ return 1;
154
+ }
155
+ if (err instanceof HttpError && err.status === 404) {
156
+ fail(`namespace '${namespace}' not found`);
157
+ return 1;
158
+ }
159
+ fail(err.message);
160
+ return 1;
161
+ }
162
+ ok(`Created project: ${name} in namespace ${namespace}`);
163
+ process.stdout.write(` slug: ${created.slug ?? "?"} (use this in --project/--episode targets)\n`);
164
+ process.stdout.write(` id: ${created.id ?? "?"}\n`);
165
+ process.stdout.write(` visibility: ${created.visibility ?? "private"}\n`);
166
+ if (opts.description)
167
+ process.stdout.write(` description: ${opts.description}\n`);
168
+ if (tags.length)
169
+ process.stdout.write(` tags: ${tags.join(", ")}\n`);
170
+ return 0;
171
+ }
172
+ export function registerCreateCommand(program) {
173
+ const create = program.command("create").description("create a project, bindr, or dataset");
174
+ create
175
+ .command("project")
176
+ .description("create a project in a namespace (private by default)")
177
+ .argument("<name>", "project display name")
178
+ .option("--namespace <slug>", "namespace (default: your own)")
179
+ .option("--slug <slug>", "URL-safe slug (auto-derived from name if omitted)")
180
+ .option("--visibility <vis>", "'public' or 'private' (default: private)")
181
+ .option("--public", "shortcut for --visibility public")
182
+ .option("--description <text>", "description")
183
+ .option("--tags <list>", "comma-separated tags")
184
+ .action(async (name, opts) => {
185
+ const visibility = opts.public ? "public" : opts.visibility;
186
+ process.exit(await runCreateProject(name, { ...opts, visibility }));
187
+ });
188
+ create
189
+ .command("bindr")
190
+ .description("create a bindr (optionally seeded with episodes by glob)")
191
+ .argument("<name>", "bindr name")
192
+ .requiredOption("--project <target>", "project scope: space[@namespace]")
193
+ .option("--episode <glob>", "glob to match episodes by node path")
194
+ .option("--description <text>", "description")
195
+ .option("--tags <list>", "comma-separated tags")
196
+ .action(async (name, opts) => {
197
+ process.exit(await runCreateBindr(name, opts));
198
+ });
199
+ create
200
+ .command("dataset")
201
+ .description("create a dataset")
202
+ .argument("<name>", "dataset name")
203
+ .requiredOption("--project <target>", "project scope: space[@namespace]")
204
+ .option("--description <text>", "description")
205
+ .option("--tags <list>", "comma-separated tags")
206
+ .action(async (name, opts) => {
207
+ process.exit(await runCreateDataset(name, opts));
208
+ });
209
+ }
@@ -0,0 +1,29 @@
1
+ import type { Command } from "commander";
2
+ export declare const COLLECTIONS: readonly ["lakeshore-providers", "sources", "runnables", "run-configs", "repos"];
3
+ export type Collection = (typeof COLLECTIONS)[number];
4
+ /**
5
+ * Guess the target collection from the payload's own shape. Ported from the
6
+ * starter kit's `bin/dl_declare.py:73-95`, which had to work it out for the
7
+ * same reason: the command takes a bare file path.
8
+ *
9
+ * The five shapes are disjoint enough for this to be unambiguous today.
10
+ * `--collection` overrides it everywhere, and a payload that matches nothing
11
+ * is an error rather than a guess.
12
+ */
13
+ export declare function inferCollection(payload: Record<string, unknown>): Collection | null;
14
+ export interface DeclareResult {
15
+ file: string;
16
+ collection: string;
17
+ status: "created" | "exists" | "dry-run" | "error";
18
+ id?: string;
19
+ name?: string;
20
+ error?: string;
21
+ }
22
+ export declare function runDeclare(files: string[], opts: {
23
+ collection?: string;
24
+ ifExists?: string;
25
+ namespace?: string;
26
+ dryRun?: boolean;
27
+ json?: boolean;
28
+ }): Promise<number>;
29
+ export declare function registerDeclareCommand(program: Command): void;
@@ -0,0 +1,304 @@
1
+ // `dreamlake declare <file>…` — the one writer for the five *head*
2
+ // declaration collections on dreamlake-server.
3
+ //
4
+ // lakeshore-providers how a machine gets launched
5
+ // runnables named code you invoke (udf | session | agent)
6
+ // run-configs the environment a runnable runs inside
7
+ // repos a git remote a worker imports from
8
+ //
9
+ // One generic verb rather than four groups, because all four take the same
10
+ // shape: a JSON (or YAML) object, POSTed verbatim, create-only, 409 on a name
11
+ // collision. Four groups would be four copies of one function.
12
+ //
13
+ // `sources` was a fifth, until a Source stopped being one shape. A managed-only
14
+ // Source needs only a name; an external one needs a connector and a target; and
15
+ // a declaration file says which of the two it is nowhere. `sources` is still
16
+ // recognised — it stays in COLLECTIONS, is
17
+ // still inferred from a payload's `kind`, and is still accepted by
18
+ // `--collection` — but only so that it can be refused with a message that says
19
+ // where to go instead. Dropping it from the tuple would have turned a Source
20
+ // file into "cannot infer the target collection", which tells the operator
21
+ // nothing about why their working command stopped working.
22
+ //
23
+ // Two behaviours here are deliberate and both come from the starter kit, where
24
+ // they were learned the hard way:
25
+ //
26
+ // 1. The target is printed BEFORE the write, never after. If the operator is
27
+ // about to hit the wrong server, the line that tells them has to come
28
+ // first.
29
+ // 2. `--if-exists ok` exists because every head row on the server is
30
+ // create-only. A 409 means the name is taken and nothing was touched —
31
+ // which is a failure for a human typing a command and a success for a
32
+ // re-runnable script. The default stays `fail`, matching the rest of the
33
+ // CLI (create/index.ts:102-113).
34
+ //
35
+ // The sub-resources — `runnables/:id/versions`, `repos/:id/snapshots` — are NOT
36
+ // reachable from here: they hang off a nested path and are append-only, not
37
+ // create-only. `dreamlake runnable version push` owns the one that matters.
38
+ import { HttpError, requestJson } from "../client.js";
39
+ import { resolveNamespace, resolveRemote, resolveToken } from "../config.js";
40
+ import { emitJson, fail, loadStructuredFile, ok, warn } from "../helpers.js";
41
+ // ─── the five head collections ───────────────────────────────────────────────
42
+ export const COLLECTIONS = [
43
+ "lakeshore-providers",
44
+ "sources",
45
+ "runnables",
46
+ "run-configs",
47
+ "repos",
48
+ ];
49
+ /** Singular label used in prose. `run-configs` → "run config". */
50
+ const SINGULAR = {
51
+ "lakeshore-providers": "lakeshore provider",
52
+ sources: "source",
53
+ runnables: "runnable",
54
+ "run-configs": "run config",
55
+ repos: "repo",
56
+ };
57
+ // `kind` vocabularies. Server-side these are free strings on purpose (a new
58
+ // launcher must not need a schema change), so they are used here only to
59
+ // disambiguate a payload — never to reject one.
60
+ const RUNNABLE_KINDS = new Set(["udf", "session", "agent"]);
61
+ const PROVIDER_KINDS = new Set(["local", "slurm-ssh", "aws-ec2", "gce", "k8s"]);
62
+ const SOURCE_KINDS = new Set([
63
+ "s3",
64
+ "gcs",
65
+ "r2",
66
+ "b2",
67
+ "postgres",
68
+ "mysql",
69
+ "databricks",
70
+ ]);
71
+ // ─── collection inference ────────────────────────────────────────────────────
72
+ /**
73
+ * Guess the target collection from the payload's own shape. Ported from the
74
+ * starter kit's `bin/dl_declare.py:73-95`, which had to work it out for the
75
+ * same reason: the command takes a bare file path.
76
+ *
77
+ * The five shapes are disjoint enough for this to be unambiguous today.
78
+ * `--collection` overrides it everywhere, and a payload that matches nothing
79
+ * is an error rather than a guess.
80
+ */
81
+ export function inferCollection(payload) {
82
+ if ("runtime" in payload || "extras" in payload)
83
+ return "run-configs";
84
+ if ("module" in payload || "qualname" in payload)
85
+ return "runnables";
86
+ if ("remote" in payload)
87
+ return "repos";
88
+ const kind = payload.kind;
89
+ if (typeof kind === "string") {
90
+ if (RUNNABLE_KINDS.has(kind))
91
+ return "runnables";
92
+ if (PROVIDER_KINDS.has(kind))
93
+ return "lakeshore-providers";
94
+ if (SOURCE_KINDS.has(kind))
95
+ return "sources";
96
+ }
97
+ return null;
98
+ }
99
+ // ─── shared context resolution ───────────────────────────────────────────────
100
+ async function ctx(nsFlag) {
101
+ const token = resolveToken();
102
+ if (!token) {
103
+ fail("not authenticated — run 'dreamlake login' first");
104
+ return null;
105
+ }
106
+ const remote = resolveRemote();
107
+ const ns = await resolveNamespace(nsFlag, { token, remote });
108
+ if (!ns) {
109
+ fail("could not resolve namespace — run 'dreamlake login' or pass --namespace");
110
+ return null;
111
+ }
112
+ return { token, remote, ns };
113
+ }
114
+ const SOURCE_REFUSAL = "Sources are no longer declared. There are now two separate contracts, and " +
115
+ "this file cannot be mapped onto either one reliably — so it is refused " +
116
+ "rather than guessed at. Pick the one that matches what the Source is:\n" +
117
+ " managed-only — DreamLake stores the data, and a name is all it takes:\n" +
118
+ " dreamlake source create <name> [--description <text>]\n" +
119
+ " external — the data already lives somewhere else, so the connector and\n" +
120
+ " its target have to be named:\n" +
121
+ " dreamlake source import --connector <kind> --target <json>\n" +
122
+ "Nothing was sent.";
123
+ const HOST_KEY_REFUSAL = "hostKey is derived server-side and is never accepted from a client — " +
124
+ "the server recomputes it on every write, so a value here would be silently " +
125
+ "ignored rather than honoured. Remove it from the payload.";
126
+ // ─── dreamlake declare ───────────────────────────────────────────────────────
127
+ export async function runDeclare(files, opts) {
128
+ if (files.length === 0) {
129
+ fail("no files given — usage: dreamlake declare <file>…");
130
+ return 1;
131
+ }
132
+ const ifExists = opts.ifExists ?? "fail";
133
+ if (ifExists !== "ok" && ifExists !== "fail") {
134
+ fail(`--if-exists must be 'ok' or 'fail' (got '${ifExists}')`);
135
+ return 1;
136
+ }
137
+ if (opts.collection && !COLLECTIONS.includes(opts.collection)) {
138
+ fail(`--collection must be one of: ${COLLECTIONS.join(", ")} (got '${opts.collection}')`);
139
+ return 1;
140
+ }
141
+ const c = await ctx(opts.namespace);
142
+ if (!c)
143
+ return 1;
144
+ const results = [];
145
+ let anyFailed = false;
146
+ // Every file is attempted. Stopping at the first failure would leave a
147
+ // half-declared namespace and no record of which half.
148
+ for (const file of files) {
149
+ const record = (r) => {
150
+ results.push(r);
151
+ if (r.status === "error")
152
+ anyFailed = true;
153
+ };
154
+ const reject = (collection, message) => {
155
+ if (!opts.json)
156
+ fail(message);
157
+ record({ file, collection, status: "error", error: message });
158
+ };
159
+ let payload;
160
+ try {
161
+ payload = loadStructuredFile(file);
162
+ }
163
+ catch (err) {
164
+ reject("unknown", err.message);
165
+ continue;
166
+ }
167
+ if ("hostKey" in payload || "host_key" in payload) {
168
+ reject("unknown", `${file}: ${HOST_KEY_REFUSAL}`);
169
+ continue;
170
+ }
171
+ const collection = opts.collection ?? inferCollection(payload);
172
+ if (!collection) {
173
+ reject("unknown", `cannot infer the target collection from ${file}; pass --collection ` +
174
+ `(one of: ${COLLECTIONS.join(", ")})`);
175
+ continue;
176
+ }
177
+ /*
178
+ * Sources leave here, before the target is printed and before anything is
179
+ * sent — including under `--dry-run`, whose whole promise is to say what
180
+ * *would* happen, and what would happen is this refusal.
181
+ *
182
+ * Deliberately no translation of the old payload into a `source create` or
183
+ * `source import` call. Choosing between them means deciding whether the
184
+ * data is managed or external, and a legacy row does not carry that
185
+ * distinction reliably; guessing it would either put data under DreamLake's
186
+ * lifecycle that the operator meant to leave alone, or the reverse. A
187
+ * refusal that names both commands is the honest version.
188
+ *
189
+ * `--if-exists ok` cannot rescue this. That flag turns a 409 — a name
190
+ * already taken, nothing touched — into a success for re-runnable scripts.
191
+ * This is not a 409 and there is no write behind it to be idempotent about.
192
+ */
193
+ if (collection === "sources") {
194
+ reject("sources", `${file}: ${SOURCE_REFUSAL}`);
195
+ continue;
196
+ }
197
+ const declaredName = typeof payload.name === "string" ? payload.name : undefined;
198
+ // ── the target, printed before anything is sent ──
199
+ if (!opts.json) {
200
+ process.stdout.write(`declare ${file}\n`);
201
+ process.stdout.write(` remote: ${c.remote}\n`);
202
+ process.stdout.write(` namespace: ${c.ns}\n`);
203
+ process.stdout.write(` collection: ${collection}\n`);
204
+ }
205
+ if (opts.dryRun) {
206
+ if (!opts.json)
207
+ process.stdout.write(" (dry run — nothing was posted)\n");
208
+ record({ file, collection, status: "dry-run", name: declaredName });
209
+ continue;
210
+ }
211
+ try {
212
+ const created = await requestJson(c.remote, `/namespaces/${c.ns}/${collection}`, { method: "POST", token: c.token, json: payload });
213
+ const name = created?.name ?? declaredName ?? "(unnamed)";
214
+ const id = created?.id;
215
+ if (!opts.json) {
216
+ ok(`declared ${name} → ${collection}${id ? ` (id ${id})` : ""}`);
217
+ }
218
+ record({ file, collection, status: "created", id, name });
219
+ }
220
+ catch (err) {
221
+ if (err instanceof HttpError && err.status === 409) {
222
+ const name = declaredName ?? "(unnamed)";
223
+ if (ifExists === "ok") {
224
+ if (!opts.json)
225
+ warn("already exists — nothing was overwritten");
226
+ record({ file, collection, status: "exists", name });
227
+ continue;
228
+ }
229
+ const message = `${SINGULAR[collection]} '${name}' already exists in namespace '${c.ns}'`;
230
+ if (!opts.json)
231
+ fail(message);
232
+ record({ file, collection, status: "error", name, error: message });
233
+ anyFailed = true;
234
+ continue;
235
+ }
236
+ if (err instanceof HttpError && err.status === 403) {
237
+ reject(collection, `writing to ${collection} needs create permission on namespace '${c.ns}' — READ is not enough`);
238
+ continue;
239
+ }
240
+ if (err instanceof HttpError && err.status === 404) {
241
+ reject(collection, `namespace '${c.ns}' not found on ${c.remote}`);
242
+ continue;
243
+ }
244
+ reject(collection, err.message);
245
+ }
246
+ }
247
+ if (opts.json)
248
+ emitJson(results);
249
+ return anyFailed ? 1 : 0;
250
+ }
251
+ // ─── registration ────────────────────────────────────────────────────────────
252
+ export function registerDeclareCommand(program) {
253
+ program
254
+ .command("declare")
255
+ .description("create declaration rows from JSON or YAML files (providers, runnables, run configs, repos)")
256
+ .argument("<files...>", "one or more JSON or YAML files, each holding a single object")
257
+ .option("--collection <name>", [
258
+ `target collection: ${COLLECTIONS.join(" | ")}.`,
259
+ "Omit it and the collection is inferred from the payload's own shape",
260
+ "(runtime/extras → run-configs, module/qualname → runnables, remote → repos,",
261
+ "otherwise `kind`). Pass it when the shape is ambiguous or you want the",
262
+ "target to be explicit in the command rather than in the file.",
263
+ ].join("\n"))
264
+ .option("--if-exists <mode>", [
265
+ "what a 409 means: fail (default) | ok.",
266
+ "Every head row on the server is create-only, so a 409 means the name is",
267
+ "taken and nothing was touched — which is a success for a re-runnable",
268
+ "script and a failure for a human. `ok` warns and keeps going; `fail`",
269
+ "matches the rest of the CLI and exits 1.",
270
+ ].join("\n"), "fail")
271
+ .option("--namespace <slug>", "namespace slug (default: active login)")
272
+ .option("--dry-run", "check every file and stop: supported collections print their target, a Source is refused. Sends no request at all.")
273
+ .option("--json", "emit one array of { file, collection, status, id?, name?, error? } instead of prose")
274
+ .addHelpText("after", [
275
+ "",
276
+ "Each file must hold a single object. It is POSTed verbatim — no wrapping",
277
+ "envelope, no field rewriting — so what you read in the file is exactly what",
278
+ "the server stores.",
279
+ "",
280
+ "`hostKey` is refused locally: the server derives it on every write and never",
281
+ "reads it from a request body, so a value in your file would be silently",
282
+ "dropped rather than honoured.",
283
+ "",
284
+ "Sources are refused locally too, and for a larger reason: they are no longer",
285
+ "declared at all. A Source is now one of two things, and the two are made in",
286
+ "different ways. A managed-only Source — one whose data DreamLake stores —",
287
+ "needs nothing but a name: `dreamlake source create <name>`. An external",
288
+ "Source points at data that already lives elsewhere, so it needs the connector",
289
+ "and the target: `dreamlake source import --connector <kind> --target <json>`.",
290
+ "A declaration file does not say which of the two it meant, so this command",
291
+ "will not choose on your behalf. `sources` is still recognised here — by",
292
+ "inference and via --collection — so that you get that message rather than an",
293
+ "unhelpful one about an unknown collection.",
294
+ "",
295
+ "Registering a version of a runnable is NOT a declare — versions hang off a",
296
+ "nested, append-only path. Use `dreamlake runnable version push`.",
297
+ "",
298
+ "Examples:",
299
+ " dreamlake declare 01_gpu_udf/runnable.json",
300
+ " dreamlake declare */*.json --if-exists ok",
301
+ " dreamlake declare runconfig.yaml --collection run-configs --dry-run",
302
+ ].join("\n"))
303
+ .action(async (files, opts) => process.exit(await runDeclare(files, opts)));
304
+ }
@@ -0,0 +1,18 @@
1
+ import type { Command } from "commander";
2
+ interface DeleteOpts {
3
+ project?: string;
4
+ yes?: boolean;
5
+ }
6
+ export declare const runDeleteBindr: (name: string, opts: DeleteOpts) => Promise<number>;
7
+ export declare const runDeleteDataset: (name: string, opts: DeleteOpts) => Promise<number>;
8
+ export declare function runDeleteProject(slug: string, opts: {
9
+ namespace?: string;
10
+ yes?: boolean;
11
+ }): Promise<number>;
12
+ export declare function runDeleteEpisode(name: string, opts: DeleteOpts): Promise<number>;
13
+ export declare function runDeleteFile(filePath: string, opts: {
14
+ episode?: string;
15
+ yes?: boolean;
16
+ }): Promise<number>;
17
+ export declare function registerDeleteCommand(program: Command): void;
18
+ export {};