@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,405 @@
1
+ import { collectionList } from "../collection-list.js";
2
+ import { registerShareCommands } from "../share.js";
3
+ // `dreamlake artifact push|list|delete|restore`.
4
+ //
5
+ // list / delete / restore are thin dreamlake-server REST calls.
6
+ // `push` writes the version itself: it brokers short-lived, prefix-scoped
7
+ // credentials from the server, appends to the artifact's own DreamDB
8
+ // dataset straight in S3, then registers the catalog row. The content
9
+ // never transits the API server. See compat/dreamdb.ts.
10
+ import { readFileSync, statSync } from "node:fs";
11
+ import path from "node:path";
12
+ import { uploadIncremental, MAX_SIZE } from "./incremental.js";
13
+ import { metaError, putArtifactCover, readCoverFile, registerArtifactMetaCommand } from "./meta.js";
14
+ // ../prompt.js, NOT @inquirer/prompts directly. This file used to import the
15
+ // inquirer prompt straight, which bypassed prompt.ts's `!process.stdin.isTTY`
16
+ // guard — so `dreamlake artifact delete <id>` without `-y` could block an agent
17
+ // or a CI job forever, waiting at a question nothing was ever going to answer.
18
+ // Every other confirmation in this CLI goes through the guarded wrapper.
19
+ import { confirm } from "../prompt.js";
20
+ import { emitJson, fail, ok } from "../helpers.js";
21
+ import { resolveCtx } from "../compat/ctx.js";
22
+ import { errorMessage, jsonRequest, requireNamespace, requireToken } from "../compat/http.js";
23
+ import { webBase } from "../workflow/index.js";
24
+ import { ARTIFACT_SCHEMA, backendFrom, realDreamdbIO, } from "../compat/dreamdb.js";
25
+ import { Option } from "commander";
26
+ import { withConnFlags } from "../compat/flags.js";
27
+ // ─── push ────────────────────────────────────────────────────────────
28
+ export const EXT_TO_KIND = {
29
+ ".html": "html",
30
+ ".htm": "html",
31
+ ".jsx": "react",
32
+ ".tsx": "react",
33
+ ".md": "markdown",
34
+ ".markdown": "markdown",
35
+ ".svg": "svg",
36
+ ".mmd": "mermaid",
37
+ ".mermaid": "mermaid",
38
+ ".js": "code",
39
+ ".ts": "code",
40
+ ".py": "code",
41
+ ".css": "code",
42
+ ".json": "code",
43
+ ".txt": "code",
44
+ ".sh": "code",
45
+ ".rs": "code",
46
+ ".go": "code",
47
+ };
48
+ export const KINDS = new Set(["html", "react", "markdown", "svg", "code", "mermaid"]);
49
+ export function slugify(text) {
50
+ let out = text
51
+ .toLowerCase()
52
+ .replace(/[^a-z0-9]/g, "-")
53
+ .replace(/^-+|-+$/g, "");
54
+ while (out.includes("--"))
55
+ out = out.replaceAll("--", "-");
56
+ return out || "artifact";
57
+ }
58
+ export function detectKind(file, override) {
59
+ if (override)
60
+ return KINDS.has(override) ? override : null;
61
+ return EXT_TO_KIND[path.extname(file).toLowerCase()] ?? null;
62
+ }
63
+ /**
64
+ * Whether a soft-deleted artifact with this id exists, and its title. `unknown`
65
+ * is a distinct answer: a Trash listing that failed, or that was not the Trash
66
+ * at all (a non-member asking for `?deleted=true` is handed the public list),
67
+ * establishes nothing — and nothing established means no renaming.
68
+ */
69
+ async function findTrashedTitle(remote, token, namespace, artifactId) {
70
+ const trash = await jsonRequest("GET", `${remote}/namespaces/${encodeURIComponent(namespace)}/artifacts?deleted=true`, token).catch(() => null);
71
+ if (!trash || trash.status !== 200)
72
+ return { kind: "unknown" };
73
+ const body = trash.body;
74
+ if (body?.viewerIsMember !== true || !Array.isArray(body.artifacts))
75
+ return { kind: "unknown" };
76
+ const row = body.artifacts.find((r) => r.artifactId === artifactId);
77
+ if (!row)
78
+ return { kind: "absent" };
79
+ return typeof row.title === "string" ? { kind: "present", title: row.title } : { kind: "unknown" };
80
+ }
81
+ /** Shell-quote one argument for a command a person will copy. */
82
+ function shellQuote(value) {
83
+ return /^[A-Za-z0-9_./:@%+=-]+$/.test(value) ? value : `'${value.replaceAll("'", "'\\''")}'`;
84
+ }
85
+ export async function runDreamlakeArtifactPush(args, deps = {}) {
86
+ const incremental = !args.full && args.incremental !== false;
87
+ let content;
88
+ try {
89
+ const stat = statSync(args.file);
90
+ if (!stat.isFile())
91
+ throw new Error("not a file");
92
+ if (incremental && stat.size > MAX_SIZE) {
93
+ fail("incremental artifacts are limited to 512 MiB");
94
+ return 1;
95
+ }
96
+ content = readFileSync(args.file);
97
+ }
98
+ catch {
99
+ fail(`file not found: ${args.file}`);
100
+ return 1;
101
+ }
102
+ const kind = detectKind(args.file, args.kind);
103
+ if (!kind) {
104
+ fail(`cannot determine kind for '${path.extname(args.file)}'. ` +
105
+ `use --kind (${[...KINDS].sort().join(", ")})`);
106
+ return 1;
107
+ }
108
+ if (args.visibility && args.visibility !== "public" && args.visibility !== "private") {
109
+ fail(`--visibility must be public or private (got '${args.visibility}')`);
110
+ return 1;
111
+ }
112
+ const defaultTitle = path.basename(args.file, path.extname(args.file));
113
+ const artifactId = args.artifactId ?? slugify(args.title ?? defaultTitle);
114
+ // Read the cover before any network call so a bad file fails fast.
115
+ let coverBytes = null;
116
+ if (args.cover) {
117
+ try {
118
+ coverBytes = readCoverFile(args.cover);
119
+ }
120
+ catch (e) {
121
+ fail(e instanceof Error ? e.message : String(e));
122
+ return 1;
123
+ }
124
+ }
125
+ const ctx = resolveCtx(args);
126
+ const token = requireToken(ctx);
127
+ if (!token)
128
+ return 1;
129
+ const namespace = await requireNamespace(ctx, args.namespace);
130
+ if (!namespace)
131
+ return 1;
132
+ // A title the user set once must survive every later push. Without
133
+ // --title, ask the catalog first: an existing row keeps its title (the
134
+ // registration below then carries none), a new one gets the file stem.
135
+ // The preflight is read-only; the register endpoint is an upsert and must
136
+ // not be used to look.
137
+ let title = args.title ?? defaultTitle;
138
+ let sendTitle = args.title !== undefined;
139
+ if (!sendTitle) {
140
+ const existing = await jsonRequest("GET", `${ctx.remote}/namespaces/${encodeURIComponent(namespace)}/artifacts/${encodeURIComponent(artifactId)}`, token);
141
+ if (existing.status === 200 && typeof existing.body?.title === "string") {
142
+ title = existing.body.title;
143
+ }
144
+ else if (existing.status === 404) {
145
+ // The detail hides Trash. A re-push restores a trashed artifact, and
146
+ // that restore must not rename it either — so look there before
147
+ // treating the id as new.
148
+ const trashed = await findTrashedTitle(ctx.remote, token, namespace, artifactId);
149
+ if (trashed.kind === "absent")
150
+ sendTitle = true;
151
+ else if (trashed.kind === "present")
152
+ title = trashed.title;
153
+ }
154
+ // Any other answer: keep whatever the catalog holds rather than risk
155
+ // renaming it from a file name.
156
+ }
157
+ // 1) broker: short-lived, prefix-scoped credentials + this artifact's own
158
+ // dataset backend. The content itself never goes through the server.
159
+ const cred = await jsonRequest("POST", `${ctx.remote}/namespaces/${encodeURIComponent(namespace)}/artifacts/upload-credentials`, token, { artifactId });
160
+ if (cred.status < 200 || cred.status >= 300) {
161
+ fail(`could not get upload credentials → ${cred.status}: ${errorMessage(cred)}`);
162
+ return 1;
163
+ }
164
+ const broker = cred.body;
165
+ if (!broker?.credentials?.accessKeyId || !broker.backendUrl) {
166
+ fail("unexpected upload-credentials response (missing credentials or backendUrl)");
167
+ return 1;
168
+ }
169
+ const refName = broker.refName ?? "artifacts";
170
+ const backend = backendFrom(broker);
171
+ const io = deps.dreamdb ?? realDreamdbIO;
172
+ // 2) write the version straight to S3 via DreamDB.
173
+ let version;
174
+ try {
175
+ version = await io.nextVersion(broker.backendUrl, refName, backend, "artifact_id", artifactId);
176
+ }
177
+ catch (e) {
178
+ // Abort BEFORE writing — never guess v1 on a read failure and clobber
179
+ // the existing history.
180
+ fail(`could not determine the next version: ${e instanceof Error ? e.message : String(e)}`);
181
+ return 1;
182
+ }
183
+ process.stdout.write(`Uploading ${path.basename(args.file)} (${kind})\n`);
184
+ process.stdout.write(` namespace: ${namespace}\n`);
185
+ process.stdout.write(` artifact: ${artifactId} v${version}\n`);
186
+ process.stdout.write(` size: ${content.length} bytes\n`);
187
+ try {
188
+ let storedContent = content;
189
+ if (incremental) {
190
+ const result = await uploadIncremental(content, backend);
191
+ storedContent = result.content;
192
+ process.stdout.write(` incremental: ${result.uploadedChunks} new chunks, ${result.uploadedBytes} compressed bytes uploaded, ${result.reusedBytes} source bytes reused\n`);
193
+ }
194
+ await io.writeRow(broker.backendUrl, refName, ARTIFACT_SCHEMA, backend, {
195
+ content: { kind: "image", bytes: storedContent },
196
+ artifact_id: { kind: "string", value: artifactId },
197
+ title: { kind: "string", value: title },
198
+ kind: { kind: "categorical", value: kind },
199
+ version: { kind: "int", value: version },
200
+ });
201
+ }
202
+ catch (e) {
203
+ fail(`upload failed: ${e instanceof Error ? e.message : String(e)}`);
204
+ return 1;
205
+ }
206
+ ok(`pushed ${artifactId} v${version} — '${title}'`);
207
+ // 3) register in the server catalog (metadata + visibility). Always runs so
208
+ // the gallery and `artifact list` stay in sync.
209
+ const reg = await jsonRequest("POST", `${ctx.remote}/namespaces/${encodeURIComponent(namespace)}` +
210
+ `/artifacts/${encodeURIComponent(artifactId)}`, token, {
211
+ ...(sendTitle ? { title } : {}),
212
+ kind,
213
+ version,
214
+ ...(args.visibility ? { visibility: args.visibility } : {}),
215
+ ...(args.share ? { share: true } : {}),
216
+ ...(args.description !== undefined ? { description: args.description } : {}),
217
+ });
218
+ if (reg.status < 200 || reg.status >= 300) {
219
+ // The content is written, but without a catalog row it won't appear in
220
+ // the gallery or `list`. Report FAILURE so CI doesn't read a
221
+ // half-created artifact as success.
222
+ fail(`uploaded the content but failed to register it in the catalog → ${reg.status}: ${metaError(reg)}`);
223
+ process.stderr.write(` it won't show in the gallery/list until you re-push the same id.\n`);
224
+ return 1;
225
+ }
226
+ const cat = (reg.body ?? {});
227
+ if (cat.visibility)
228
+ process.stdout.write(` visibility: ${cat.visibility}\n`);
229
+ if (args.description !== undefined)
230
+ process.stdout.write(` description: ${cat.descriptionSource ?? "user"}\n`);
231
+ // The cover is a second call: the catalog row has to exist first. A
232
+ // failure here leaves content and catalog registered — say so, and point
233
+ // at the command that finishes the job.
234
+ if (coverBytes) {
235
+ const put = await putArtifactCover(ctx.remote, token, namespace, artifactId, coverBytes)
236
+ .catch((e) => ({ ok: false, error: `request failed (${e instanceof Error ? e.message : String(e)}); cover storage unconfirmed` }));
237
+ if (!put.ok) {
238
+ fail(`pushed ${artifactId} v${version}, but the cover was not stored → ${put.error}`);
239
+ // Content and catalog are registered; only the cover is missing. The
240
+ // command below finishes the job against the same namespace and the
241
+ // same server — never the active login's, which may differ. A token
242
+ // passed explicitly is the one thing it cannot repeat for you.
243
+ const conn = `--remote ${shellQuote(ctx.remote)}${ctx.debug ? " --debug" : ""}${args.token ? " --token <the same --token>" : ""}`;
244
+ process.stderr.write(` re-run: dreamlake artifact meta set ${shellQuote(artifactId)} --namespace ${shellQuote(namespace)} ${conn} --cover ${shellQuote(args.cover)}\n`);
245
+ return 1;
246
+ }
247
+ process.stdout.write(` cover: ${put.summary}\n`);
248
+ }
249
+ let url = `${webBase(ctx.remote)}/${namespace}/artifacts/${artifactId}`;
250
+ if (cat.shareToken)
251
+ url += `?share=${cat.shareToken}`;
252
+ process.stdout.write(` open: ${url}\n`);
253
+ return 0;
254
+ }
255
+ export async function runDreamlakeArtifactList(args) {
256
+ const ctx = resolveCtx(args);
257
+ const namespace = await requireNamespace(ctx, args.namespace);
258
+ if (!namespace)
259
+ return 1;
260
+ const r = await jsonRequest("GET", `${ctx.remote}/namespaces/${encodeURIComponent(namespace)}/artifacts`, ctx.token);
261
+ if (r.status !== 200) {
262
+ fail(`could not list artifacts → ${r.status}: ${errorMessage(r)}`);
263
+ return 1;
264
+ }
265
+ const artifacts = (r.body.artifacts ?? []);
266
+ if (args.json) {
267
+ emitJson(artifacts);
268
+ return 0;
269
+ }
270
+ if (artifacts.length === 0) {
271
+ process.stdout.write(`no artifacts in namespace '${namespace}'.\n`);
272
+ return 0;
273
+ }
274
+ process.stdout.write(`Artifacts in ${namespace}:\n`);
275
+ for (const a of artifacts) {
276
+ const vis = typeof a.visibility === "string" ? a.visibility : "private";
277
+ const vtag = vis === "private" ? "" : ` [${vis}]`;
278
+ process.stdout.write(` ${String(a.artifactId)} v${String(a.latestVersion)} · ${String(a.kind)} ${String(a.title)}${vtag}\n`);
279
+ }
280
+ return 0;
281
+ }
282
+ export async function runDreamlakeArtifactDelete(args, deps = {}) {
283
+ const ctx = resolveCtx(args);
284
+ const namespace = await requireNamespace(ctx, args.namespace);
285
+ if (!namespace)
286
+ return 1;
287
+ const token = requireToken(ctx);
288
+ if (!token)
289
+ return 1;
290
+ if (!args.yes) {
291
+ const message = args.permanent
292
+ ? `PERMANENTLY delete artifact '${args.artifactId}' from '${namespace}'? This erases all versions and cannot be undone.`
293
+ : `Delete artifact '${args.artifactId}' from '${namespace}'?`;
294
+ // confirm() returns the default (false) without prompting on a non-TTY
295
+ // (prompt.ts:12-14), so a scripted run neither hangs nor deletes.
296
+ const confirmFn = deps.confirmFn ?? ((m) => confirm(m, false));
297
+ if (!(await confirmFn(message))) {
298
+ process.stdout.write("aborted.\n");
299
+ // 0, NOT 1. "I deliberately did not do the thing" has always been a
300
+ // success in this CLI — a cancelled `provider delete` returns 0
301
+ // (lakeshore/index.ts:604), and this was the one path that disagreed.
302
+ // An agent under `set -e` must not die because it declined a delete.
303
+ return 0;
304
+ }
305
+ }
306
+ const base = `${ctx.remote}/namespaces/${encodeURIComponent(namespace)}` +
307
+ `/artifacts/${encodeURIComponent(args.artifactId)}`;
308
+ const r = await jsonRequest("DELETE", args.permanent ? `${base}/purge` : base, token);
309
+ if (r.status < 200 || r.status >= 300) {
310
+ fail(`could not delete artifact → ${r.status}: ${errorMessage(r)}`);
311
+ return 1;
312
+ }
313
+ if (args.permanent) {
314
+ const n = r.body?.objectsDeleted;
315
+ ok(`permanently deleted ${args.artifactId}${typeof n === "number" ? ` (${n} objects removed)` : ""}`);
316
+ }
317
+ else {
318
+ ok(`deleted ${args.artifactId} (restore with \`dreamlake artifact restore ${args.artifactId}\`)`);
319
+ }
320
+ return 0;
321
+ }
322
+ export async function runDreamlakeArtifactRestore(args) {
323
+ const ctx = resolveCtx(args);
324
+ const namespace = await requireNamespace(ctx, args.namespace);
325
+ if (!namespace)
326
+ return 1;
327
+ const token = requireToken(ctx);
328
+ if (!token)
329
+ return 1;
330
+ const r = await jsonRequest("POST", `${ctx.remote}/namespaces/${encodeURIComponent(namespace)}` +
331
+ `/artifacts/${encodeURIComponent(args.artifactId)}/restore`, token);
332
+ if (r.status < 200 || r.status >= 300) {
333
+ fail(`could not restore artifact → ${r.status}: ${errorMessage(r)}`);
334
+ return 1;
335
+ }
336
+ ok(`restored ${args.artifactId}`);
337
+ return 0;
338
+ }
339
+ // ─── append-local (pointer stub) ──────────────────────────────────────────────
340
+ // dreamlake-server's artifact Apply endpoint spawns `dreamlake artifact
341
+ // append-local` expecting the CANONICAL Python writer (DreamDB has no TS
342
+ // writer). If PATH resolves to THIS CLI instead, answer on stdout with
343
+ // the same one-line JSON error contract the server parses, so the
344
+ // operator sees a precise fix instead of a generic writer failure.
345
+ export const ARTIFACT_APPEND_LOCAL_ERROR = {
346
+ error: "no_writer",
347
+ message: "append-local needs the canonical Python writer (pip install dreamlake) — " +
348
+ "the TS CLI has no DreamDB writer. Point the artifact apply bin at the Python `dreamlake` bin.",
349
+ };
350
+ export async function runDreamlakeArtifactAppendLocal() {
351
+ process.stdout.write(JSON.stringify(ARTIFACT_APPEND_LOCAL_ERROR) + "\n");
352
+ return 1;
353
+ }
354
+ // ─── registration ─────────────────────────────────────────────────────────────
355
+ export function registerArtifactCommand(program) {
356
+ const artifact = program
357
+ .command("artifact")
358
+ .description("renderable artifacts (HTML/React/Markdown/SVG/code)");
359
+ registerShareCommands(artifact, "artifact");
360
+ withConnFlags(artifact
361
+ .command("push")
362
+ .description("push a renderable artifact — a new version of --id (written straight to storage)")
363
+ .argument("<file>", "file to push (kind auto-detected from the extension)")
364
+ .option("--title <title>", "human title (default: file stem)")
365
+ .option("--kind <kind>", "html, react, markdown, svg, code, mermaid (default: auto)")
366
+ .option("--id <artifact-id>", "stable artifact id for versioning (default: slug of title)")
367
+ .option("--namespace <slug>", "namespace (default: active login)")
368
+ .option("--visibility <visibility>", "read visibility: public | private (default: private)")
369
+ .option("--incremental", "upload only new compressed chunks (default; requires an updated viewer)", true)
370
+ .option("--full", "upload the entire file in the original single-blob format")
371
+ .addOption(new Option("--no-incremental", "compatibility alias for --full").hideHelp())
372
+ .option("--share", "issue a share token so the artifact can be read via a ?share= link")
373
+ .option("--description <text>", "preview description for link cards (kept across later pushes)")
374
+ .option("--cover <file>", "preview cover image: PNG, JPEG or WebP, 1200×900 (4:3) recommended (kept across later pushes)")).action(async (file, opts) => {
375
+ process.exit(await runDreamlakeArtifactPush({ ...opts, file, artifactId: opts.id }));
376
+ });
377
+ withConnFlags(collectionList(artifact, "list")
378
+ .description("list artifacts in a namespace")
379
+ .option("--namespace <slug>", "namespace (default: active login)")
380
+ .option("--json", "emit raw JSON")).action(async (opts) => {
381
+ process.exit(await runDreamlakeArtifactList(opts));
382
+ });
383
+ withConnFlags(artifact
384
+ .command("delete")
385
+ .description("soft-delete an artifact (restorable), or purge with --permanent")
386
+ .argument("<artifact-id>", "artifact id")
387
+ .option("--namespace <slug>", "namespace (default: active login)")
388
+ .option("-y, --yes", "skip the confirmation prompt")
389
+ .option("-p, --permanent", "purge storage + catalog — irreversible")).action(async (artifactId, opts) => {
390
+ process.exit(await runDreamlakeArtifactDelete({ ...opts, artifactId }));
391
+ });
392
+ withConnFlags(artifact
393
+ .command("restore")
394
+ .description("restore a soft-deleted artifact")
395
+ .argument("<artifact-id>", "artifact id")
396
+ .option("--namespace <slug>", "namespace (default: active login)")).action(async (artifactId, opts) => {
397
+ process.exit(await runDreamlakeArtifactRestore({ ...opts, artifactId }));
398
+ });
399
+ registerArtifactMetaCommand(artifact);
400
+ artifact
401
+ .command("append-local", { hidden: true })
402
+ .allowUnknownOption(true)
403
+ .argument("[args...]")
404
+ .action(async () => process.exit(await runDreamlakeArtifactAppendLocal()));
405
+ }
@@ -0,0 +1,69 @@
1
+ import type { Command } from "commander";
2
+ import { type DreamlakeOpts } from "../compat/ctx.js";
3
+ export declare const COVER_MAX_BYTES: number;
4
+ /** Read a cover file, refusing what the server would refuse anyway. */
5
+ export declare function readCoverFile(file: string): Buffer;
6
+ interface MetaCover {
7
+ rev: number;
8
+ source: string;
9
+ version: number;
10
+ contentType: string;
11
+ width: number;
12
+ height: number;
13
+ bytes: number;
14
+ updatedAt: string;
15
+ url: string | null;
16
+ }
17
+ interface MetaResponse {
18
+ artifactId: string;
19
+ latestVersion: number;
20
+ description: string | null;
21
+ descriptionSource: string | null;
22
+ descriptionVersion: number | null;
23
+ cover: MetaCover | null;
24
+ resolved: {
25
+ description: string;
26
+ descriptionSource: string;
27
+ cover: {
28
+ rev: number;
29
+ source: string;
30
+ version: number;
31
+ } | null;
32
+ };
33
+ }
34
+ /**
35
+ * The meta routes answer validation failures as `{error: code, message: why}`.
36
+ * `errorMessage` would keep only the code; the "why" is the part a person
37
+ * needs ("cover too small (300×200; minimum 600×315 …)").
38
+ */
39
+ export declare function metaError(r: {
40
+ status: number;
41
+ body?: unknown;
42
+ }): string;
43
+ /** PUT a cover; shared by `push --cover` and `meta set --cover`. */
44
+ export declare function putArtifactCover(remote: string, token: string, namespace: string, artifactId: string, bytes: Buffer): Promise<{
45
+ ok: true;
46
+ summary: string;
47
+ meta: MetaResponse;
48
+ } | {
49
+ ok: false;
50
+ error: string;
51
+ }>;
52
+ export interface ArtifactMetaShowArgs extends DreamlakeOpts {
53
+ artifactId: string;
54
+ namespace?: string;
55
+ json?: boolean;
56
+ }
57
+ export declare function runDreamlakeArtifactMetaShow(args: ArtifactMetaShowArgs): Promise<number>;
58
+ export interface ArtifactMetaSetArgs extends DreamlakeOpts {
59
+ artifactId: string;
60
+ namespace?: string;
61
+ description?: string;
62
+ clearDescription?: boolean;
63
+ cover?: string;
64
+ clearCover?: boolean;
65
+ json?: boolean;
66
+ }
67
+ export declare function runDreamlakeArtifactMetaSet(args: ArtifactMetaSetArgs): Promise<number>;
68
+ export declare function registerArtifactMetaCommand(artifact: Command): void;
69
+ export {};
@@ -0,0 +1,189 @@
1
+ // `dreamlake artifact meta show|set` — the description and cover image an
2
+ // artifact's link preview is built from (and that the list/gallery card
3
+ // shows), plus the helpers `artifact push --cover` shares with `set`.
4
+ //
5
+ // Values set here are the user's: a later `push` never changes them. `set`
6
+ // with --clear-description / --clear-cover returns a field to automatic.
7
+ // The cover transits the API server as base64 (it is validated there:
8
+ // PNG/JPEG/WebP, ≥600×315, ≤2 MiB); the artifact's content never does.
9
+ import { readFileSync, statSync } from "node:fs";
10
+ import path from "node:path";
11
+ import { emitJson, fail, ok, renderTable } from "../helpers.js";
12
+ import { resolveCtx } from "../compat/ctx.js";
13
+ import { errorMessage, jsonRequest, requireNamespace, requireToken } from "../compat/http.js";
14
+ import { withConnFlags } from "../compat/flags.js";
15
+ export const COVER_MAX_BYTES = 2 * 1024 * 1024;
16
+ const COVER_EXTENSIONS = new Set([".png", ".jpg", ".jpeg", ".webp"]);
17
+ /** Read a cover file, refusing what the server would refuse anyway. */
18
+ export function readCoverFile(file) {
19
+ const ext = path.extname(file).toLowerCase();
20
+ if (!COVER_EXTENSIONS.has(ext))
21
+ throw new Error(`cover must be a .png, .jpg or .webp file (got '${ext || "no extension"}')`);
22
+ let size;
23
+ try {
24
+ const stat = statSync(file);
25
+ if (!stat.isFile())
26
+ throw new Error("not a file");
27
+ size = stat.size;
28
+ }
29
+ catch {
30
+ throw new Error(`cover file not found: ${file}`);
31
+ }
32
+ if (size === 0)
33
+ throw new Error(`cover file is empty: ${file}`);
34
+ if (size > COVER_MAX_BYTES)
35
+ throw new Error(`cover is ${size} bytes; the limit is ${COVER_MAX_BYTES} (2 MiB)`);
36
+ return readFileSync(file);
37
+ }
38
+ /**
39
+ * The meta routes answer validation failures as `{error: code, message: why}`.
40
+ * `errorMessage` would keep only the code; the "why" is the part a person
41
+ * needs ("cover too small (300×200; minimum 600×315 …)").
42
+ */
43
+ export function metaError(r) {
44
+ const b = r.body;
45
+ if (b && typeof b === "object" && typeof b.message === "string" && b.message) {
46
+ return typeof b.error === "string" && b.error ? `${b.error}: ${b.message}` : b.message;
47
+ }
48
+ return errorMessage(r);
49
+ }
50
+ function metaUrl(remote, namespace, artifactId) {
51
+ return `${remote}/namespaces/${encodeURIComponent(namespace)}/artifacts/${encodeURIComponent(artifactId)}/meta`;
52
+ }
53
+ /** PUT a cover; shared by `push --cover` and `meta set --cover`. */
54
+ export async function putArtifactCover(remote, token, namespace, artifactId, bytes) {
55
+ const r = await jsonRequest("PUT", metaUrl(remote, namespace, artifactId), token, {
56
+ cover: { imageBase64: bytes.toString("base64") },
57
+ });
58
+ if (r.status < 200 || r.status >= 300)
59
+ return { ok: false, error: `${r.status}: ${metaError(r)}` };
60
+ const meta = r.body;
61
+ return { ok: true, summary: coverSummary(meta.cover), meta };
62
+ }
63
+ function coverSummary(cover) {
64
+ if (!cover)
65
+ return "none";
66
+ const type = cover.contentType.replace("image/", "");
67
+ return `${cover.width}×${cover.height} ${type}, r${cover.rev} (${cover.source}, v${cover.version})`;
68
+ }
69
+ function printMeta(meta) {
70
+ const freshness = (source, version) => source === "generated" && version !== meta.latestVersion ? " — stale, not shown" : "";
71
+ process.stdout.write(renderTable([
72
+ {
73
+ FIELD: "description",
74
+ VALUE: meta.description ?? "(none)",
75
+ SOURCE: meta.description ? `${meta.descriptionSource} v${meta.descriptionVersion}${freshness(meta.descriptionSource, meta.descriptionVersion)}` : "automatic",
76
+ },
77
+ {
78
+ FIELD: "cover",
79
+ VALUE: coverSummary(meta.cover),
80
+ SOURCE: meta.cover ? `${meta.cover.source} v${meta.cover.version}${freshness(meta.cover.source, meta.cover.version)}` : "automatic",
81
+ },
82
+ ], ["FIELD", "VALUE", "SOURCE"]));
83
+ process.stdout.write(`shown now: "${meta.resolved.description}" (${meta.resolved.descriptionSource})`);
84
+ process.stdout.write(meta.resolved.cover ? `, cover r${meta.resolved.cover.rev}\n` : ", default card\n");
85
+ if (meta.cover?.url)
86
+ process.stdout.write(`cover url (expires): ${meta.cover.url}\n`);
87
+ }
88
+ export async function runDreamlakeArtifactMetaShow(args) {
89
+ const ctx = resolveCtx(args);
90
+ const token = requireToken(ctx);
91
+ if (!token)
92
+ return 1;
93
+ const namespace = await requireNamespace(ctx, args.namespace);
94
+ if (!namespace)
95
+ return 1;
96
+ const r = await jsonRequest("GET", metaUrl(ctx.remote, namespace, args.artifactId), token);
97
+ if (r.status !== 200) {
98
+ fail(`could not read artifact metadata → ${r.status}: ${metaError(r)}`);
99
+ return 1;
100
+ }
101
+ if (args.json)
102
+ emitJson(r.body);
103
+ else
104
+ printMeta(r.body);
105
+ return 0;
106
+ }
107
+ export async function runDreamlakeArtifactMetaSet(args) {
108
+ if (args.description !== undefined && args.clearDescription) {
109
+ fail("--description and --clear-description are mutually exclusive");
110
+ return 1;
111
+ }
112
+ if (args.cover !== undefined && args.clearCover) {
113
+ fail("--cover and --clear-cover are mutually exclusive");
114
+ return 1;
115
+ }
116
+ const body = {};
117
+ if (args.clearDescription)
118
+ body.description = null;
119
+ else if (args.description !== undefined)
120
+ body.description = args.description;
121
+ if (args.clearCover)
122
+ body.cover = null;
123
+ else if (args.cover !== undefined) {
124
+ try {
125
+ body.cover = { imageBase64: readCoverFile(args.cover).toString("base64") };
126
+ }
127
+ catch (e) {
128
+ fail(e instanceof Error ? e.message : String(e));
129
+ return 1;
130
+ }
131
+ }
132
+ if (body.description === undefined && body.cover === undefined) {
133
+ fail("nothing to set: pass --description, --clear-description, --cover or --clear-cover");
134
+ return 1;
135
+ }
136
+ const ctx = resolveCtx(args);
137
+ const token = requireToken(ctx);
138
+ if (!token)
139
+ return 1;
140
+ const namespace = await requireNamespace(ctx, args.namespace);
141
+ if (!namespace)
142
+ return 1;
143
+ let r;
144
+ try {
145
+ r = await jsonRequest("PUT", metaUrl(ctx.remote, namespace, args.artifactId), token, body);
146
+ }
147
+ catch (e) {
148
+ fail(`could not update artifact metadata → request failed (${e instanceof Error ? e.message : String(e)}); nothing is confirmed`);
149
+ return 1;
150
+ }
151
+ if (r.status < 200 || r.status >= 300) {
152
+ fail(`could not update artifact metadata → ${r.status}: ${metaError(r)}`);
153
+ return 1;
154
+ }
155
+ const meta = r.body;
156
+ if (args.json) {
157
+ emitJson(meta);
158
+ return 0;
159
+ }
160
+ ok(`updated ${args.artifactId}`);
161
+ printMeta(meta);
162
+ return 0;
163
+ }
164
+ // ─── registration ────────────────────────────────────────────────────
165
+ export function registerArtifactMetaCommand(artifact) {
166
+ const meta = artifact
167
+ .command("meta")
168
+ .description("preview metadata — the description and cover behind an artifact's link card");
169
+ withConnFlags(meta
170
+ .command("show")
171
+ .description("show an artifact's description and cover, and what a link card shows right now")
172
+ .argument("<artifact-id>", "artifact id")
173
+ .option("--namespace <slug>", "namespace (default: active login)")
174
+ .option("--json", "emit raw JSON")).action(async (artifactId, opts) => {
175
+ process.exit(await runDreamlakeArtifactMetaShow({ ...opts, artifactId }));
176
+ });
177
+ withConnFlags(meta
178
+ .command("set")
179
+ .description("set or clear the description and/or cover (yours — later pushes keep them)")
180
+ .argument("<artifact-id>", "artifact id")
181
+ .option("--namespace <slug>", "namespace (default: active login)")
182
+ .option("--description <text>", "preview description (up to 1000 characters)")
183
+ .option("--clear-description", "back to the automatic description")
184
+ .option("--cover <file>", "cover image: PNG, JPEG or WebP, at least 600×315, 1200×900 (4:3) recommended, ≤ 2 MiB")
185
+ .option("--clear-cover", "back to the default card")
186
+ .option("--json", "emit raw JSON")).action(async (artifactId, opts) => {
187
+ process.exit(await runDreamlakeArtifactMetaSet({ ...opts, artifactId }));
188
+ });
189
+ }