@dreamlake/dreamlake-cli 0.88.1 → 0.89.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (535) hide show
  1. package/dist/api/access.d.ts +83 -0
  2. package/dist/api/access.js +77 -0
  3. package/dist/api/agent.d.ts +156 -0
  4. package/dist/api/agent.js +111 -0
  5. package/dist/api/browser.d.ts +90 -0
  6. package/dist/api/browser.js +102 -0
  7. package/dist/api/client.d.ts +53 -0
  8. package/dist/api/client.js +102 -0
  9. package/dist/api/common.d.ts +28 -0
  10. package/dist/api/common.js +16 -0
  11. package/dist/api/content.d.ts +195 -0
  12. package/dist/api/content.js +147 -0
  13. package/dist/api/execution.d.ts +84 -0
  14. package/dist/api/execution.js +73 -0
  15. package/dist/api/http.d.ts +19 -0
  16. package/dist/api/http.js +66 -0
  17. package/dist/api/index.d.ts +2330 -0
  18. package/dist/api/index.js +114 -0
  19. package/dist/api/infra.d.ts +2 -0
  20. package/dist/api/infra.js +2 -0
  21. package/dist/api/jobs.d.ts +2 -0
  22. package/dist/api/jobs.js +2 -0
  23. package/dist/api/layout.d.ts +2 -0
  24. package/dist/api/layout.js +2 -0
  25. package/dist/api/library-edit.d.ts +3 -0
  26. package/dist/api/library-edit.js +3 -0
  27. package/dist/api/library-manifest.d.ts +2 -0
  28. package/dist/api/library-manifest.js +2 -0
  29. package/dist/api/note-character-plan.d.ts +2 -0
  30. package/dist/api/note-character-plan.js +2 -0
  31. package/dist/api/note-editing.d.ts +2 -0
  32. package/dist/api/note-editing.js +2 -0
  33. package/dist/api/note-edits.d.ts +21 -0
  34. package/dist/api/note-edits.js +10 -0
  35. package/dist/api/note-events.d.ts +5 -0
  36. package/dist/api/note-events.js +11 -0
  37. package/dist/api/note-files.d.ts +75 -0
  38. package/dist/api/note-files.js +65 -0
  39. package/dist/api/note-html-read.d.ts +2 -0
  40. package/dist/api/note-html-read.js +2 -0
  41. package/dist/api/note-html.d.ts +2 -0
  42. package/dist/api/note-html.js +2 -0
  43. package/dist/api/note-toc.d.ts +2 -0
  44. package/dist/api/note-toc.js +2 -0
  45. package/dist/api/notes.d.ts +304 -0
  46. package/dist/api/notes.js +181 -0
  47. package/dist/api/open-resources.d.ts +27 -0
  48. package/dist/api/open-resources.js +102 -0
  49. package/dist/api/ownership.d.ts +12 -0
  50. package/dist/api/ownership.js +24 -0
  51. package/dist/api/platform.d.ts +83 -0
  52. package/dist/api/platform.js +56 -0
  53. package/dist/api/presigned-transfer.d.ts +2 -0
  54. package/dist/api/presigned-transfer.js +2 -0
  55. package/dist/api/registered-runs.d.ts +48 -0
  56. package/dist/api/registered-runs.js +33 -0
  57. package/dist/api/sessions.d.ts +299 -0
  58. package/dist/api/sessions.js +105 -0
  59. package/dist/api/storage.d.ts +46 -0
  60. package/dist/api/storage.js +34 -0
  61. package/dist/api/streams.d.ts +18 -0
  62. package/dist/api/streams.js +70 -0
  63. package/dist/api/vault.d.ts +93 -0
  64. package/dist/api/vault.js +79 -0
  65. package/dist/api/workspace.d.ts +180 -0
  66. package/dist/api/workspace.js +146 -0
  67. package/dist/cli/agent-identity.d.ts +4 -0
  68. package/dist/cli/agent-identity.js +21 -0
  69. package/dist/cli/agents/identity.d.ts +50 -0
  70. package/dist/cli/agents/identity.js +105 -0
  71. package/dist/cli/agents/index.d.ts +31 -0
  72. package/dist/cli/agents/index.js +580 -0
  73. package/dist/cli/agents/manage.d.ts +43 -0
  74. package/dist/cli/agents/manage.js +376 -0
  75. package/dist/cli/agents/spec.d.ts +104 -0
  76. package/dist/cli/agents/spec.js +280 -0
  77. package/dist/cli/agents/web.d.ts +7 -0
  78. package/dist/cli/agents/web.js +109 -0
  79. package/dist/cli/artifact/incremental.d.ts +21 -0
  80. package/dist/cli/artifact/incremental.js +80 -0
  81. package/dist/cli/artifact/index.d.ts +52 -0
  82. package/dist/cli/artifact/index.js +405 -0
  83. package/dist/cli/artifact/meta.d.ts +69 -0
  84. package/dist/cli/artifact/meta.js +189 -0
  85. package/dist/cli/auth/commands.d.ts +29 -0
  86. package/dist/cli/auth/commands.js +327 -0
  87. package/dist/cli/auth/constants.d.ts +13 -0
  88. package/dist/cli/auth/constants.js +18 -0
  89. package/dist/cli/auth/credentials.d.ts +37 -0
  90. package/dist/cli/auth/credentials.js +155 -0
  91. package/dist/cli/auth/device-flow.d.ts +32 -0
  92. package/dist/cli/auth/device-flow.js +154 -0
  93. package/dist/cli/auth/device-secret.d.ts +6 -0
  94. package/dist/cli/auth/device-secret.js +26 -0
  95. package/dist/cli/auth/machine.d.ts +15 -0
  96. package/dist/cli/auth/machine.js +126 -0
  97. package/dist/cli/auth/materialized.d.ts +32 -0
  98. package/dist/cli/auth/materialized.js +102 -0
  99. package/dist/cli/auth/migrate.d.ts +10 -0
  100. package/dist/cli/auth/migrate.js +75 -0
  101. package/dist/cli/client.d.ts +102 -0
  102. package/dist/cli/client.js +206 -0
  103. package/dist/cli/collection-list.d.ts +3 -0
  104. package/dist/cli/collection-list.js +25 -0
  105. package/dist/cli/compat/ctx.d.ts +26 -0
  106. package/dist/cli/compat/ctx.js +76 -0
  107. package/dist/cli/compat/dreamdb-wasm-embedded.d.ts +2 -0
  108. package/dist/cli/compat/dreamdb-wasm-embedded.js +8 -0
  109. package/dist/cli/compat/dreamdb-wasm.d.ts +1 -0
  110. package/dist/cli/compat/dreamdb-wasm.js +26 -0
  111. package/dist/cli/compat/dreamdb.d.ts +112 -0
  112. package/dist/cli/compat/dreamdb.js +219 -0
  113. package/dist/cli/compat/flags.d.ts +2 -0
  114. package/dist/cli/compat/flags.js +13 -0
  115. package/dist/cli/compat/http.d.ts +23 -0
  116. package/dist/cli/compat/http.js +137 -0
  117. package/dist/cli/compat/presignedTransfer.d.ts +139 -0
  118. package/dist/cli/compat/presignedTransfer.js +580 -0
  119. package/dist/cli/compat/s3-backend.d.ts +73 -0
  120. package/dist/cli/compat/s3-backend.js +132 -0
  121. package/dist/cli/config.d.ts +22 -0
  122. package/dist/cli/config.js +96 -0
  123. package/dist/cli/connection/dto.d.ts +159 -0
  124. package/dist/cli/connection/dto.js +497 -0
  125. package/dist/cli/connection/index.d.ts +50 -0
  126. package/dist/cli/connection/index.js +413 -0
  127. package/dist/cli/connection/oauth.d.ts +23 -0
  128. package/dist/cli/connection/oauth.js +290 -0
  129. package/dist/cli/connection/write.d.ts +47 -0
  130. package/dist/cli/connection/write.js +573 -0
  131. package/dist/cli/create/index.d.ts +19 -0
  132. package/dist/cli/create/index.js +209 -0
  133. package/dist/cli/declare/index.d.ts +29 -0
  134. package/dist/cli/declare/index.js +304 -0
  135. package/dist/cli/delete/index.d.ts +18 -0
  136. package/dist/cli/delete/index.js +232 -0
  137. package/dist/cli/download/index.d.ts +9 -0
  138. package/dist/cli/download/index.js +128 -0
  139. package/dist/cli/env/compose.d.ts +88 -0
  140. package/dist/cli/env/compose.js +402 -0
  141. package/dist/cli/env/index.d.ts +176 -0
  142. package/dist/cli/env/index.js +1011 -0
  143. package/dist/cli/experiments/index.d.ts +11 -0
  144. package/dist/cli/experiments/index.js +168 -0
  145. package/dist/cli/glob.d.ts +1 -0
  146. package/dist/cli/glob.js +45 -0
  147. package/dist/cli/graphql-helpers.d.ts +23 -0
  148. package/dist/cli/graphql-helpers.js +42 -0
  149. package/dist/cli/graphql.d.ts +10 -0
  150. package/dist/cli/graphql.js +47 -0
  151. package/dist/cli/help-examples.generated.d.ts +1 -0
  152. package/dist/cli/help-examples.generated.js +192 -0
  153. package/dist/cli/helpers.d.ts +8 -0
  154. package/dist/cli/helpers.js +106 -0
  155. package/dist/cli/hosts/api.d.ts +29 -0
  156. package/dist/cli/hosts/api.js +54 -0
  157. package/dist/cli/hosts/bootstrap-source.d.ts +1 -0
  158. package/dist/cli/hosts/bootstrap-source.js +2 -0
  159. package/dist/cli/hosts/catalog.d.ts +26 -0
  160. package/dist/cli/hosts/catalog.js +55 -0
  161. package/dist/cli/hosts/config.d.ts +45 -0
  162. package/dist/cli/hosts/config.js +179 -0
  163. package/dist/cli/hosts/credentials.d.ts +19 -0
  164. package/dist/cli/hosts/credentials.js +173 -0
  165. package/dist/cli/hosts/enroll.d.ts +17 -0
  166. package/dist/cli/hosts/enroll.js +109 -0
  167. package/dist/cli/hosts/enrollments.d.ts +25 -0
  168. package/dist/cli/hosts/enrollments.js +54 -0
  169. package/dist/cli/hosts/index.d.ts +6 -0
  170. package/dist/cli/hosts/index.js +279 -0
  171. package/dist/cli/hosts/inventory.d.ts +40 -0
  172. package/dist/cli/hosts/inventory.js +91 -0
  173. package/dist/cli/hosts/lifecycle.d.ts +15 -0
  174. package/dist/cli/hosts/lifecycle.js +108 -0
  175. package/dist/cli/hosts/metrics-source.d.ts +12 -0
  176. package/dist/cli/hosts/metrics-source.js +89 -0
  177. package/dist/cli/hosts/observations.d.ts +39 -0
  178. package/dist/cli/hosts/observations.js +102 -0
  179. package/dist/cli/hosts/remote.d.ts +5 -0
  180. package/dist/cli/hosts/remote.js +66 -0
  181. package/dist/cli/hosts/ssh.d.ts +63 -0
  182. package/dist/cli/hosts/ssh.js +276 -0
  183. package/dist/cli/index.d.ts +1 -0
  184. package/dist/cli/index.js +288 -0
  185. package/dist/cli/infra/api.d.ts +95 -0
  186. package/dist/cli/infra/api.js +291 -0
  187. package/dist/cli/infra/index.d.ts +5 -0
  188. package/dist/cli/infra/index.js +102 -0
  189. package/dist/cli/infra/move.d.ts +15 -0
  190. package/dist/cli/infra/move.js +123 -0
  191. package/dist/cli/infra/transfer.d.ts +15 -0
  192. package/dist/cli/infra/transfer.js +280 -0
  193. package/dist/cli/jobs/api.d.ts +69 -0
  194. package/dist/cli/jobs/api.js +121 -0
  195. package/dist/cli/jobs/index.d.ts +5 -0
  196. package/dist/cli/jobs/index.js +140 -0
  197. package/dist/cli/lakeshore/index.d.ts +98 -0
  198. package/dist/cli/lakeshore/index.js +502 -0
  199. package/dist/cli/launch/index.d.ts +43 -0
  200. package/dist/cli/launch/index.js +270 -0
  201. package/dist/cli/layout/index.d.ts +2 -0
  202. package/dist/cli/layout/index.js +44 -0
  203. package/dist/cli/layout/transport.d.ts +12 -0
  204. package/dist/cli/layout/transport.js +70 -0
  205. package/dist/cli/library/add.d.ts +60 -0
  206. package/dist/cli/library/add.js +348 -0
  207. package/dist/cli/library/cache.d.ts +26 -0
  208. package/dist/cli/library/cache.js +88 -0
  209. package/dist/cli/library/config.d.ts +75 -0
  210. package/dist/cli/library/config.js +198 -0
  211. package/dist/cli/library/digest.d.ts +5 -0
  212. package/dist/cli/library/digest.js +19 -0
  213. package/dist/cli/library/discover.d.ts +87 -0
  214. package/dist/cli/library/discover.js +534 -0
  215. package/dist/cli/library/freshness.d.ts +35 -0
  216. package/dist/cli/library/freshness.js +109 -0
  217. package/dist/cli/library/generation.d.ts +35 -0
  218. package/dist/cli/library/generation.js +211 -0
  219. package/dist/cli/library/index.d.ts +2 -0
  220. package/dist/cli/library/index.js +36 -0
  221. package/dist/cli/library/info.d.ts +69 -0
  222. package/dist/cli/library/info.js +311 -0
  223. package/dist/cli/library/list.d.ts +33 -0
  224. package/dist/cli/library/list.js +86 -0
  225. package/dist/cli/library/manifest.d.ts +81 -0
  226. package/dist/cli/library/manifest.js +200 -0
  227. package/dist/cli/library/manifestCache.d.ts +45 -0
  228. package/dist/cli/library/manifestCache.js +169 -0
  229. package/dist/cli/library/pull.d.ts +30 -0
  230. package/dist/cli/library/pull.js +438 -0
  231. package/dist/cli/library/push.d.ts +72 -0
  232. package/dist/cli/library/push.js +642 -0
  233. package/dist/cli/library/rm.d.ts +31 -0
  234. package/dist/cli/library/rm.js +200 -0
  235. package/dist/cli/library/search.d.ts +18 -0
  236. package/dist/cli/library/search.js +181 -0
  237. package/dist/cli/library/stat.d.ts +15 -0
  238. package/dist/cli/library/stat.js +127 -0
  239. package/dist/cli/library/tools.d.ts +104 -0
  240. package/dist/cli/library/tools.js +163 -0
  241. package/dist/cli/library/wire.d.ts +47 -0
  242. package/dist/cli/library/wire.js +120 -0
  243. package/dist/cli/list/index.d.ts +26 -0
  244. package/dist/cli/list/index.js +256 -0
  245. package/dist/cli/notes/character-plan.d.ts +22 -0
  246. package/dist/cli/notes/character-plan.js +232 -0
  247. package/dist/cli/notes/document.d.ts +73 -0
  248. package/dist/cli/notes/document.js +306 -0
  249. package/dist/cli/notes/edit-commands.d.ts +106 -0
  250. package/dist/cli/notes/edit-commands.js +623 -0
  251. package/dist/cli/notes/editing.d.ts +81 -0
  252. package/dist/cli/notes/editing.js +305 -0
  253. package/dist/cli/notes/events.d.ts +36 -0
  254. package/dist/cli/notes/events.js +54 -0
  255. package/dist/cli/notes/files-commands.d.ts +120 -0
  256. package/dist/cli/notes/files-commands.js +554 -0
  257. package/dist/cli/notes/html-read.d.ts +9 -0
  258. package/dist/cli/notes/html-read.js +90 -0
  259. package/dist/cli/notes/html.d.ts +73 -0
  260. package/dist/cli/notes/html.js +381 -0
  261. package/dist/cli/notes/index.d.ts +123 -0
  262. package/dist/cli/notes/index.js +1303 -0
  263. package/dist/cli/notes/linger.d.ts +59 -0
  264. package/dist/cli/notes/linger.js +339 -0
  265. package/dist/cli/notes/media-commands.d.ts +5 -0
  266. package/dist/cli/notes/media-commands.js +51 -0
  267. package/dist/cli/notes/move-command.d.ts +83 -0
  268. package/dist/cli/notes/move-command.js +259 -0
  269. package/dist/cli/notes/rm-command.d.ts +22 -0
  270. package/dist/cli/notes/rm-command.js +110 -0
  271. package/dist/cli/notes/select-command.d.ts +12 -0
  272. package/dist/cli/notes/select-command.js +84 -0
  273. package/dist/cli/notes/suggest-diff.d.ts +56 -0
  274. package/dist/cli/notes/suggest-diff.js +311 -0
  275. package/dist/cli/notes/toc.d.ts +38 -0
  276. package/dist/cli/notes/toc.js +144 -0
  277. package/dist/cli/notes/transfer-command.d.ts +6 -0
  278. package/dist/cli/notes/transfer-command.js +9 -0
  279. package/dist/cli/notes/version-commands.d.ts +19 -0
  280. package/dist/cli/notes/version-commands.js +178 -0
  281. package/dist/cli/nymph/index.d.ts +74 -0
  282. package/dist/cli/nymph/index.js +349 -0
  283. package/dist/cli/org/index.d.ts +34 -0
  284. package/dist/cli/org/index.js +341 -0
  285. package/dist/cli/ownership/index.d.ts +12 -0
  286. package/dist/cli/ownership/index.js +122 -0
  287. package/dist/cli/ownership/metadata-transfer.d.ts +20 -0
  288. package/dist/cli/ownership/metadata-transfer.js +159 -0
  289. package/dist/cli/page/index.d.ts +58 -0
  290. package/dist/cli/page/index.js +387 -0
  291. package/dist/cli/pipeline/index.d.ts +69 -0
  292. package/dist/cli/pipeline/index.js +604 -0
  293. package/dist/cli/progress.d.ts +60 -0
  294. package/dist/cli/progress.js +276 -0
  295. package/dist/cli/project/attachments.d.ts +10 -0
  296. package/dist/cli/project/attachments.js +39 -0
  297. package/dist/cli/project/grants.d.ts +10 -0
  298. package/dist/cli/project/grants.js +39 -0
  299. package/dist/cli/project/index.d.ts +8 -0
  300. package/dist/cli/project/index.js +92 -0
  301. package/dist/cli/project/move.d.ts +57 -0
  302. package/dist/cli/project/move.js +242 -0
  303. package/dist/cli/project/output.d.ts +2 -0
  304. package/dist/cli/project/output.js +29 -0
  305. package/dist/cli/project/stream.d.ts +55 -0
  306. package/dist/cli/project/stream.js +207 -0
  307. package/dist/cli/project/transfer-preview.d.ts +8 -0
  308. package/dist/cli/project/transfer-preview.js +10 -0
  309. package/dist/cli/prompt.d.ts +1 -0
  310. package/dist/cli/prompt.js +17 -0
  311. package/dist/cli/provider/dreamdir.d.ts +52 -0
  312. package/dist/cli/provider/dreamdir.js +138 -0
  313. package/dist/cli/provider/index.d.ts +4 -0
  314. package/dist/cli/provider/index.js +419 -0
  315. package/dist/cli/provider/jump-worker.d.ts +9 -0
  316. package/dist/cli/provider/jump-worker.js +141 -0
  317. package/dist/cli/provider/lifecycle.d.ts +149 -0
  318. package/dist/cli/provider/lifecycle.js +1390 -0
  319. package/dist/cli/provider/machine.d.ts +17 -0
  320. package/dist/cli/provider/machine.js +116 -0
  321. package/dist/cli/provider/ssh.d.ts +105 -0
  322. package/dist/cli/provider/ssh.js +305 -0
  323. package/dist/cli/provider/terraform.d.ts +140 -0
  324. package/dist/cli/provider/terraform.js +288 -0
  325. package/dist/cli/providers/index.d.ts +18 -0
  326. package/dist/cli/providers/index.js +422 -0
  327. package/dist/cli/python.d.ts +61 -0
  328. package/dist/cli/python.js +255 -0
  329. package/dist/cli/queues/index.d.ts +33 -0
  330. package/dist/cli/queues/index.js +248 -0
  331. package/dist/cli/queues/slurm.d.ts +10 -0
  332. package/dist/cli/queues/slurm.js +134 -0
  333. package/dist/cli/resources.d.ts +72 -0
  334. package/dist/cli/resources.js +137 -0
  335. package/dist/cli/run/index.d.ts +15 -0
  336. package/dist/cli/run/index.js +163 -0
  337. package/dist/cli/run/input.d.ts +34 -0
  338. package/dist/cli/run/input.js +135 -0
  339. package/dist/cli/run/recovery.d.ts +2 -0
  340. package/dist/cli/run/recovery.js +18 -0
  341. package/dist/cli/run/setup.d.ts +3 -0
  342. package/dist/cli/run/setup.js +62 -0
  343. package/dist/cli/runconfig/index.d.ts +12 -0
  344. package/dist/cli/runconfig/index.js +130 -0
  345. package/dist/cli/runnable/index.d.ts +35 -0
  346. package/dist/cli/runnable/index.js +575 -0
  347. package/dist/cli/runnable/path.d.ts +115 -0
  348. package/dist/cli/runnable/path.js +288 -0
  349. package/dist/cli/runnable/run.d.ts +91 -0
  350. package/dist/cli/runnable/run.js +239 -0
  351. package/dist/cli/runnable/upload.d.ts +43 -0
  352. package/dist/cli/runnable/upload.js +342 -0
  353. package/dist/cli/runnable/worker.d.ts +1 -0
  354. package/dist/cli/runnable/worker.js +44 -0
  355. package/dist/cli/schemas/workflow-spec.schema.json +335 -0
  356. package/dist/cli/self-update/index.d.ts +5 -0
  357. package/dist/cli/self-update/index.js +107 -0
  358. package/dist/cli/self-update/install.d.ts +60 -0
  359. package/dist/cli/self-update/install.js +428 -0
  360. package/dist/cli/self-update/paths.d.ts +40 -0
  361. package/dist/cli/self-update/paths.js +87 -0
  362. package/dist/cli/self-update/releases.d.ts +41 -0
  363. package/dist/cli/self-update/releases.js +153 -0
  364. package/dist/cli/self-update/settings.d.ts +16 -0
  365. package/dist/cli/self-update/settings.js +68 -0
  366. package/dist/cli/self-update/update.d.ts +18 -0
  367. package/dist/cli/self-update/update.js +241 -0
  368. package/dist/cli/service-accounts/index.d.ts +3 -0
  369. package/dist/cli/service-accounts/index.js +149 -0
  370. package/dist/cli/session-affiliation.d.ts +26 -0
  371. package/dist/cli/session-affiliation.js +135 -0
  372. package/dist/cli/sessions/affiliation.d.ts +8 -0
  373. package/dist/cli/sessions/affiliation.js +66 -0
  374. package/dist/cli/sessions/api.d.ts +55 -0
  375. package/dist/cli/sessions/api.js +88 -0
  376. package/dist/cli/sessions/control.d.ts +6 -0
  377. package/dist/cli/sessions/control.js +159 -0
  378. package/dist/cli/sessions/conversation.d.ts +15 -0
  379. package/dist/cli/sessions/conversation.js +118 -0
  380. package/dist/cli/sessions/index.d.ts +2 -0
  381. package/dist/cli/sessions/index.js +209 -0
  382. package/dist/cli/sessions/managed.d.ts +39 -0
  383. package/dist/cli/sessions/managed.js +63 -0
  384. package/dist/cli/sessions/redaction.d.ts +2 -0
  385. package/dist/cli/sessions/redaction.js +11 -0
  386. package/dist/cli/sessions/runner/exec.d.ts +108 -0
  387. package/dist/cli/sessions/runner/exec.js +335 -0
  388. package/dist/cli/sessions/runner/journal.d.ts +26 -0
  389. package/dist/cli/sessions/runner/journal.js +49 -0
  390. package/dist/cli/sessions/runner/native.d.ts +48 -0
  391. package/dist/cli/sessions/runner/native.js +170 -0
  392. package/dist/cli/sessions/runner/pod.d.ts +30 -0
  393. package/dist/cli/sessions/runner/pod.js +129 -0
  394. package/dist/cli/sessions/runner/serve.d.ts +85 -0
  395. package/dist/cli/sessions/runner/serve.js +558 -0
  396. package/dist/cli/sessions/sync.d.ts +47 -0
  397. package/dist/cli/sessions/sync.js +80 -0
  398. package/dist/cli/sessions/transport.d.ts +14 -0
  399. package/dist/cli/sessions/transport.js +116 -0
  400. package/dist/cli/share.d.ts +15 -0
  401. package/dist/cli/share.js +139 -0
  402. package/dist/cli/skill/catalog.d.ts +141 -0
  403. package/dist/cli/skill/catalog.js +442 -0
  404. package/dist/cli/skill/files.d.ts +89 -0
  405. package/dist/cli/skill/files.js +264 -0
  406. package/dist/cli/skill/index.d.ts +268 -0
  407. package/dist/cli/skill/index.js +1216 -0
  408. package/dist/cli/skill/manifest.d.ts +30 -0
  409. package/dist/cli/skill/manifest.js +101 -0
  410. package/dist/cli/skill/prefs.d.ts +9 -0
  411. package/dist/cli/skill/prefs.js +32 -0
  412. package/dist/cli/skill/reminders.d.ts +15 -0
  413. package/dist/cli/skill/reminders.js +105 -0
  414. package/dist/cli/skill/tar.d.ts +17 -0
  415. package/dist/cli/skill/tar.js +195 -0
  416. package/dist/cli/snapshot/index.d.ts +24 -0
  417. package/dist/cli/snapshot/index.js +146 -0
  418. package/dist/cli/source/access.d.ts +45 -0
  419. package/dist/cli/source/access.js +563 -0
  420. package/dist/cli/source/control.d.ts +103 -0
  421. package/dist/cli/source/control.js +546 -0
  422. package/dist/cli/source/delete.d.ts +89 -0
  423. package/dist/cli/source/delete.js +463 -0
  424. package/dist/cli/source/index.d.ts +288 -0
  425. package/dist/cli/source/index.js +1348 -0
  426. package/dist/cli/source/share.d.ts +65 -0
  427. package/dist/cli/source/share.js +530 -0
  428. package/dist/cli/source/upload.d.ts +62 -0
  429. package/dist/cli/source/upload.js +258 -0
  430. package/dist/cli/source/write.d.ts +77 -0
  431. package/dist/cli/source/write.js +335 -0
  432. package/dist/cli/spawn.d.ts +28 -0
  433. package/dist/cli/spawn.js +81 -0
  434. package/dist/cli/target.d.ts +22 -0
  435. package/dist/cli/target.js +85 -0
  436. package/dist/cli/tasks/index.d.ts +38 -0
  437. package/dist/cli/tasks/index.js +365 -0
  438. package/dist/cli/team/index.d.ts +37 -0
  439. package/dist/cli/team/index.js +407 -0
  440. package/dist/cli/telemetry.d.ts +23 -0
  441. package/dist/cli/telemetry.js +262 -0
  442. package/dist/cli/telemetryJournal.d.ts +26 -0
  443. package/dist/cli/telemetryJournal.js +104 -0
  444. package/dist/cli/update/index.d.ts +21 -0
  445. package/dist/cli/update/index.js +284 -0
  446. package/dist/cli/upload/index.d.ts +11 -0
  447. package/dist/cli/upload/index.js +261 -0
  448. package/dist/cli/upload/kinds.d.ts +10 -0
  449. package/dist/cli/upload/kinds.js +85 -0
  450. package/dist/cli/upload/multipart.d.ts +21 -0
  451. package/dist/cli/upload/multipart.js +248 -0
  452. package/dist/cli/vault/affected-preview.d.ts +15 -0
  453. package/dist/cli/vault/affected-preview.js +38 -0
  454. package/dist/cli/vault/cloud.d.ts +55 -0
  455. package/dist/cli/vault/cloud.js +287 -0
  456. package/dist/cli/vault/format.d.ts +18 -0
  457. package/dist/cli/vault/format.js +104 -0
  458. package/dist/cli/vault/hostCredentials.d.ts +21 -0
  459. package/dist/cli/vault/hostCredentials.js +71 -0
  460. package/dist/cli/vault/hostSupersessions.d.ts +18 -0
  461. package/dist/cli/vault/hostSupersessions.js +68 -0
  462. package/dist/cli/vault/import.d.ts +3 -0
  463. package/dist/cli/vault/import.js +79 -0
  464. package/dist/cli/vault/index.d.ts +14 -0
  465. package/dist/cli/vault/index.js +225 -0
  466. package/dist/cli/vault/keys.d.ts +5 -0
  467. package/dist/cli/vault/keys.js +165 -0
  468. package/dist/cli/vault/kms.d.ts +6 -0
  469. package/dist/cli/vault/kms.js +169 -0
  470. package/dist/cli/vault/list.d.ts +13 -0
  471. package/dist/cli/vault/list.js +60 -0
  472. package/dist/cli/vault/listView.d.ts +21 -0
  473. package/dist/cli/vault/listView.js +123 -0
  474. package/dist/cli/vault/managementMetadata.d.ts +2 -0
  475. package/dist/cli/vault/managementMetadata.js +23 -0
  476. package/dist/cli/vault/mutations.d.ts +8 -0
  477. package/dist/cli/vault/mutations.js +151 -0
  478. package/dist/cli/vault/otp.d.ts +6 -0
  479. package/dist/cli/vault/otp.js +62 -0
  480. package/dist/cli/vault/otpIntent.d.ts +23 -0
  481. package/dist/cli/vault/otpIntent.js +76 -0
  482. package/dist/cli/vault/passImport.d.ts +25 -0
  483. package/dist/cli/vault/passImport.js +129 -0
  484. package/dist/cli/vault/passOtp.d.ts +51 -0
  485. package/dist/cli/vault/passOtp.js +101 -0
  486. package/dist/cli/vault/passStore.d.ts +26 -0
  487. package/dist/cli/vault/passStore.js +134 -0
  488. package/dist/cli/vault/passwordCommand.d.ts +39 -0
  489. package/dist/cli/vault/passwordCommand.js +101 -0
  490. package/dist/cli/vault/passwordProbe.d.ts +27 -0
  491. package/dist/cli/vault/passwordProbe.js +282 -0
  492. package/dist/cli/vault/passwordRotation.d.ts +9 -0
  493. package/dist/cli/vault/passwordRotation.js +273 -0
  494. package/dist/cli/vault/rotationApi.d.ts +13 -0
  495. package/dist/cli/vault/rotationApi.js +58 -0
  496. package/dist/cli/vault/rotationCommand.d.ts +2 -0
  497. package/dist/cli/vault/rotationCommand.js +75 -0
  498. package/dist/cli/vault/rotationEngine.d.ts +19 -0
  499. package/dist/cli/vault/rotationEngine.js +65 -0
  500. package/dist/cli/vault/rotationHelperSource.d.ts +2 -0
  501. package/dist/cli/vault/rotationHelperSource.js +3 -0
  502. package/dist/cli/vault/rotationInput.d.ts +11 -0
  503. package/dist/cli/vault/rotationInput.js +48 -0
  504. package/dist/cli/vault/rotationJournal.d.ts +16 -0
  505. package/dist/cli/vault/rotationJournal.js +183 -0
  506. package/dist/cli/vault/rotationKeys.d.ts +4 -0
  507. package/dist/cli/vault/rotationKeys.js +48 -0
  508. package/dist/cli/vault/rotationPrepare.d.ts +17 -0
  509. package/dist/cli/vault/rotationPrepare.js +108 -0
  510. package/dist/cli/vault/rotationRemote.d.ts +33 -0
  511. package/dist/cli/vault/rotationRemote.js +156 -0
  512. package/dist/cli/vault/rotationState.d.ts +42 -0
  513. package/dist/cli/vault/rotationState.js +115 -0
  514. package/dist/cli/vault/rotationTransport.d.ts +18 -0
  515. package/dist/cli/vault/rotationTransport.js +71 -0
  516. package/dist/cli/vault/sshSource.d.ts +18 -0
  517. package/dist/cli/vault/sshSource.js +196 -0
  518. package/dist/cli/vault/sshSync.d.ts +17 -0
  519. package/dist/cli/vault/sshSync.js +224 -0
  520. package/dist/cli/vault/sshTransfer.d.ts +22 -0
  521. package/dist/cli/vault/sshTransfer.js +140 -0
  522. package/dist/cli/vault/terraformState.d.ts +66 -0
  523. package/dist/cli/vault/terraformState.js +252 -0
  524. package/dist/cli/vault/terraformStateCommand.d.ts +2 -0
  525. package/dist/cli/vault/terraformStateCommand.js +61 -0
  526. package/dist/cli/vault/tree.d.ts +43 -0
  527. package/dist/cli/vault/tree.js +292 -0
  528. package/dist/cli/version.d.ts +1 -0
  529. package/dist/cli/version.js +9 -0
  530. package/dist/cli/workflow/index.d.ts +76 -0
  531. package/dist/cli/workflow/index.js +826 -0
  532. package/dist/cli/workflow/validate.d.ts +19 -0
  533. package/dist/cli/workflow/validate.js +353 -0
  534. package/dist/package.json +1 -0
  535. package/package.json +28 -10
@@ -0,0 +1,348 @@
1
+ // `dreamlake library add <spec> <path>` — add ONE asset to a remote library
2
+ // without holding a full local copy (RFC 0008 §5.7).
3
+ //
4
+ // The mechanism is the register contract itself: register serves whatever
5
+ // manifest was last uploaded, whole-document, CAS'd on `revision`. So a
6
+ // remote single-asset edit is: read the remote manifest → merge one entry in
7
+ // memory → upload only that asset's files (paths already present with the
8
+ // same sha256 are reused, assets may share files) → upload the merged
9
+ // manifest → register with expectedRevision. A 409 means another writer
10
+ // advanced the library first: refetch, RE-MERGE against the fresh document
11
+ // (registering the stale merge would revert their change), and retry ONCE.
12
+ //
13
+ // The local path is one asset: a directory (files stored under `<id>/…`) or
14
+ // a single file (a loose single-file asset, stored at its basename). Kind,
15
+ // entry, entryPoints and a shipped thumbnail.<ext>/preview.<ext> are
16
+ // detected exactly the way push's discovery does. No model calls — thumbnail
17
+ // rendering and embeddings stay push-time work.
18
+ import { createHash } from 'node:crypto';
19
+ import { libraryGenerationRequired, publishLibraryManifestGeneration } from './generation.js';
20
+ import { librariesCacheDir } from './cache.js';
21
+ import { mkdtempSync, rmSync, statSync, writeFileSync } from "node:fs";
22
+ import { tmpdir } from "node:os";
23
+ import path from "node:path";
24
+ import { emitJson, fail, humanSize, ok, splitCsv } from "../helpers.js";
25
+ import { resolveCtx } from "../compat/ctx.js";
26
+ import { errorMessage, jsonRequest, requireNamespace, requireToken } from "../compat/http.js";
27
+ import { executePresignedBatch } from "../compat/presignedTransfer.js";
28
+ import { ASSET_ID_RE } from "./config.js";
29
+ import { detectAssetShape, findShippedThumbnail, walkUserFiles } from "./discover.js";
30
+ import { hashFiles } from "./cache.js";
31
+ import { MANIFEST_PATH_PRIMARY, assertLibraryManifest, manifestFileMap, } from "./manifest.js";
32
+ import { thumbnailGeneratedPath } from "./wire.js";
33
+ import { assertLibraryAuthorization, planBatches } from "./push.js";
34
+ import { parseLibrarySpec } from "./pull.js";
35
+ const ADD_CONCURRENCY = 4;
36
+ /**
37
+ * The remote document a single-asset edit merges against: the detail row's
38
+ * revision (the CAS token) and the manifest. A library that answers 404 on
39
+ * either has never been pushed — remote edits need an existing library.
40
+ */
41
+ export async function fetchRemoteLibrary(base, token, spec) {
42
+ const detail = await jsonRequest("GET", base, token);
43
+ if (detail.status === 404) {
44
+ return { error: `library ${spec} not found — create it with \`dreamlake library push\`` };
45
+ }
46
+ if (detail.status !== 200) {
47
+ return { error: `could not read the library → ${detail.status}: ${errorMessage(detail)}` };
48
+ }
49
+ const rev = detail.body?.revision;
50
+ const revision = typeof rev === "number" ? rev : 0;
51
+ const mRes = await jsonRequest("GET", `${base}/manifest`, token);
52
+ if (mRes.status === 404) {
53
+ return { error: `library ${spec} not found — create it with \`dreamlake library push\`` };
54
+ }
55
+ if (mRes.status !== 200) {
56
+ return { error: `could not read the remote manifest → ${mRes.status}: ${errorMessage(mRes)}` };
57
+ }
58
+ const manifest = assertLibraryManifest(mRes.body, "the remote manifest");
59
+ return { revision, manifest };
60
+ }
61
+ /**
62
+ * Upload `items` (positional, already batch-safe sizes) through the library
63
+ * presign flow. `absByRel` maps each relativePath to the local file that
64
+ * carries its bytes.
65
+ */
66
+ export async function uploadLibraryFiles(base, token, items, absByRel, fetchFn) {
67
+ for (const batch of planBatches([...items])) {
68
+ const authRes = await jsonRequest("POST", `${base}/upload-authorizations`, token, {
69
+ files: batch.map(({ relativePath, size }) => ({ relativePath, size })),
70
+ });
71
+ if (authRes.status < 200 || authRes.status >= 300) {
72
+ throw new Error(`could not authorize the upload → ${authRes.status}: ${errorMessage(authRes)}`);
73
+ }
74
+ const authorization = assertLibraryAuthorization(authRes.body, { files: batch });
75
+ await executePresignedBatch(authorization.files, {
76
+ localPath: (f) => absByRel.get(f.relativePath),
77
+ concurrency: ADD_CONCURRENCY,
78
+ fetchFn,
79
+ });
80
+ }
81
+ }
82
+ /** Serialize a merged manifest into `dir` for upload at the reserved path. */
83
+ export function writeManifestFile(dir, manifest) {
84
+ const abs = path.join(dir, "manifest.json");
85
+ writeFileSync(abs, JSON.stringify(manifest, null, 2));
86
+ return { abs, size: statSync(abs).size };
87
+ }
88
+ /**
89
+ * Read the one asset at `assetPath`: walk (directory) or take the file, hash
90
+ * through the shared cache, detect shape, and emit the wire-manifest entry
91
+ * with metadata flags overlaid. Wire paths live under `<id>/…` for a
92
+ * directory asset and at the basename for a single-file asset — exactly the
93
+ * push conventions.
94
+ */
95
+ async function readLocalAsset(args, deps) {
96
+ const abs = path.resolve(args.assetPath);
97
+ let st;
98
+ try {
99
+ st = statSync(abs);
100
+ }
101
+ catch {
102
+ throw new Error(`no such file or directory: ${args.assetPath}`);
103
+ }
104
+ const isDir = st.isDirectory();
105
+ const base = path.basename(abs);
106
+ const defaultId = isDir ? base : base.slice(0, base.lastIndexOf(".") > 0 ? base.lastIndexOf(".") : base.length);
107
+ const id = args.id ?? defaultId;
108
+ if (!ASSET_ID_RE.test(id)) {
109
+ throw new Error(`asset id '${id}' is not a valid id — ids must match ^[a-zA-Z0-9][a-zA-Z0-9._-]{0,127}$; pass --id <id>`);
110
+ }
111
+ // Disk-relative file list + the root detection reads from.
112
+ let hashRoot;
113
+ let relInside;
114
+ let wireOf;
115
+ if (isDir) {
116
+ hashRoot = abs;
117
+ relInside = walkUserFiles(abs);
118
+ if (relInside.length === 0)
119
+ throw new Error(`no files found in ${args.assetPath}`);
120
+ wireOf = (rel) => `${id}/${rel}`;
121
+ }
122
+ else {
123
+ hashRoot = path.dirname(abs);
124
+ relInside = [base];
125
+ wireOf = () => base;
126
+ }
127
+ const hashes = await hashFiles(hashRoot, relInside, { cacheFile: deps.hashCacheFile });
128
+ const detected = detectAssetShape(hashRoot, "", relInside);
129
+ const shipped = findShippedThumbnail("", relInside);
130
+ const tags = splitCsv(args.tags);
131
+ const absByRel = new Map();
132
+ let totalBytes = 0;
133
+ const files = relInside.map((rel) => {
134
+ const h = hashes.get(rel);
135
+ const wire = wireOf(rel);
136
+ absByRel.set(wire, path.join(hashRoot, rel));
137
+ totalBytes += h.size;
138
+ return { path: wire, size: h.size, sha256: h.sha256 };
139
+ });
140
+ const entry = {
141
+ id,
142
+ ...(args.title ? { title: args.title } : {}),
143
+ ...(args.description ? { description: args.description } : {}),
144
+ ...(args.category ? { category: args.category } : {}),
145
+ ...(tags.length > 0 ? { tags } : {}),
146
+ kind: detected.kind,
147
+ // The detected sub-format (sog / lod) selects the viewer, exactly as in a
148
+ // full push — `add` writes straight into the wire manifest, so dropping it
149
+ // here would leave a single added splat directory unrenderable.
150
+ ...(detected.format ? { format: detected.format } : {}),
151
+ ...(args.license ? { license: args.license } : {}),
152
+ ...(args.attribution ? { attribution: args.attribution } : {}),
153
+ ...(detected.entry ? { entry: wireOf(detected.entry) } : {}),
154
+ ...(detected.entryPoints
155
+ ? {
156
+ entryPoints: Object.fromEntries(Object.entries(detected.entryPoints).map(([name, ep]) => [
157
+ name,
158
+ { kind: ep.kind, file: wireOf(ep.file) },
159
+ ])),
160
+ }
161
+ : {}),
162
+ files,
163
+ ...(shipped ? { thumbnail: wireOf(shipped) } : {}),
164
+ };
165
+ return { id, absByRel, entry, fileCount: files.length, totalBytes };
166
+ }
167
+ /**
168
+ * The merged document: remote manifest verbatim with the new entry appended
169
+ * (or swapped in place under --replace). generated[] is carried verbatim —
170
+ * the objects are still in storage and reconcile keeps what the manifest
171
+ * lists. A replaced asset that loses its own thumbnail keeps pointing at its
172
+ * still-listed generated render, matching push's carry-forward.
173
+ */
174
+ export function mergeAssetEntry(remote, entry, replace) {
175
+ const existing = remote.assets.find((a) => a.id === entry.id);
176
+ if (existing && !replace) {
177
+ return { error: `asset '${entry.id}' already exists in the library — pass --replace to overwrite it` };
178
+ }
179
+ let mergedEntry = entry;
180
+ if (existing && !entry.thumbnail) {
181
+ const carried = thumbnailGeneratedPath(entry.id);
182
+ if (existing.thumbnail === carried &&
183
+ (remote.generated ?? []).includes(carried)) {
184
+ mergedEntry = { ...entry, thumbnail: carried };
185
+ }
186
+ }
187
+ const assets = existing
188
+ ? remote.assets.map((a) => (a.id === entry.id ? mergedEntry : a))
189
+ : [...remote.assets, mergedEntry];
190
+ return { merged: { ...remote, assets } };
191
+ }
192
+ export async function runLibraryAdd(args, deps = {}) {
193
+ const parsed = parseLibrarySpec(args.spec);
194
+ if ("error" in parsed) {
195
+ fail(parsed.error);
196
+ return 1;
197
+ }
198
+ let local;
199
+ try {
200
+ local = await readLocalAsset(args, deps);
201
+ }
202
+ catch (e) {
203
+ fail(e instanceof Error ? e.message : String(e));
204
+ return 1;
205
+ }
206
+ const ctx = resolveCtx(args);
207
+ const token = requireToken(ctx);
208
+ if (!token)
209
+ return 1;
210
+ const namespace = parsed.namespace ?? (await requireNamespace(ctx, undefined));
211
+ if (!namespace)
212
+ return 1;
213
+ const spec = `${namespace}/${parsed.name}`;
214
+ const base = `${ctx.remote}/namespaces/${encodeURIComponent(namespace)}/libraries/${encodeURIComponent(parsed.name)}`;
215
+ const tmp = mkdtempSync(path.join(tmpdir(), "dreamlake-add-"));
216
+ try {
217
+ // Two attempts: the second exists only for one register 409, and it
218
+ // re-merges against the refetched document — see the header.
219
+ for (let attempt = 0;; attempt++) {
220
+ const remote = await fetchRemoteLibrary(base, token, spec);
221
+ if ("error" in remote) {
222
+ fail(remote.error);
223
+ return 1;
224
+ }
225
+ const mergedOr = mergeAssetEntry(remote.manifest, local.entry, args.replace === true);
226
+ if ("error" in mergedOr) {
227
+ fail(mergedOr.error);
228
+ return 1;
229
+ }
230
+ const merged = mergedOr.merged;
231
+ // One path, one content — across the WHOLE merged document. This is
232
+ // the same conflict the server rejects as manifest_file_conflict;
233
+ // catching it here costs no upload.
234
+ let remoteMap;
235
+ try {
236
+ manifestFileMap(merged);
237
+ remoteMap = manifestFileMap(remote.manifest);
238
+ }
239
+ catch (e) {
240
+ fail(e instanceof Error ? e.message : String(e));
241
+ return 1;
242
+ }
243
+ // Only bytes the library does not already hold move: a wire path
244
+ // present remotely with the same sha256 is reused (shared files, or an
245
+ // unchanged file under --replace).
246
+ const toUpload = [];
247
+ let reusedShared = 0;
248
+ let uploadBytes = 0;
249
+ for (const f of local.entry.files) {
250
+ const theirs = remoteMap.get(f.path);
251
+ if (theirs && theirs.sha256 === f.sha256.toLowerCase()) {
252
+ reusedShared++;
253
+ continue;
254
+ }
255
+ toUpload.push({ relativePath: f.path, size: f.size });
256
+ uploadBytes += f.size;
257
+ }
258
+ if (args.dryRun) {
259
+ process.stdout.write(`Adding asset '${local.id}' to ${spec} (revision ${remote.revision})\n`);
260
+ process.stdout.write(` files: ${toUpload.length} to upload (${humanSize(uploadBytes)}), ${reusedShared} already present\n`);
261
+ if (args.json) {
262
+ emitJson({
263
+ library: spec,
264
+ asset: local.id,
265
+ dryRun: true,
266
+ uploaded: toUpload.length,
267
+ reusedShared,
268
+ bytes: uploadBytes,
269
+ });
270
+ }
271
+ else {
272
+ ok("dry run — nothing uploaded, nothing registered");
273
+ }
274
+ return 0;
275
+ }
276
+ const manifestFile = writeManifestFile(tmp, merged);
277
+ const absByRel = new Map(local.absByRel);
278
+ absByRel.set(MANIFEST_PATH_PRIMARY, manifestFile.abs);
279
+ const generation = await libraryGenerationRequired(base, token);
280
+ let reg;
281
+ if (generation) {
282
+ reg = await publishLibraryManifestGeneration({ base, token, manifest: merged, manifestFile, localByRel: absByRel, expectedRevision: remote.revision, fetchFn: deps.fetchFn, cacheDir: path.join(librariesCacheDir(), 'generation-edits', createHash('sha256').update(base).digest('hex')) });
283
+ }
284
+ else {
285
+ try {
286
+ await uploadLibraryFiles(base, token, [...toUpload, { relativePath: MANIFEST_PATH_PRIMARY, size: manifestFile.size }], absByRel, deps.fetchFn);
287
+ }
288
+ catch (e) {
289
+ fail(`upload failed: ${e instanceof Error ? e.message : String(e)}`);
290
+ return 1;
291
+ }
292
+ reg = await jsonRequest("POST", `${base}/register`, token, {
293
+ expectedRevision: remote.revision,
294
+ });
295
+ }
296
+ if (reg.status === 409 && attempt === 0)
297
+ continue;
298
+ if (reg.status < 200 || reg.status >= 300) {
299
+ fail(`could not register the library → ${reg.status}: ${errorMessage(reg)}`);
300
+ if (reg.status === 409) {
301
+ process.stderr.write(` another writer is racing this add — re-run \`dreamlake library add\`.\n`);
302
+ }
303
+ return 1;
304
+ }
305
+ const receipt = reg.body;
306
+ const revision = generation ? receipt?.publishedRevision ?? receipt?.revision : receipt?.revision;
307
+ const verb = remote.manifest.assets.some((a) => a.id === local.id) ? "replaced" : "added";
308
+ if (args.json) {
309
+ emitJson({
310
+ library: spec,
311
+ asset: local.id,
312
+ revision: typeof revision === "number" ? revision : null,
313
+ uploaded: toUpload.length,
314
+ reusedShared,
315
+ bytes: uploadBytes,
316
+ });
317
+ }
318
+ else {
319
+ ok(`${spec} revision ${typeof revision === "number" ? revision : "?"} — ` +
320
+ `asset ${local.id} ${verb} (${local.fileCount} files, ${humanSize(local.totalBytes)})`);
321
+ }
322
+ return 0;
323
+ }
324
+ }
325
+ finally {
326
+ rmSync(tmp, { recursive: true, force: true });
327
+ }
328
+ }
329
+ export function registerLibraryAddCommand(library, withConnFlags) {
330
+ withConnFlags(library
331
+ .command("add")
332
+ .description("add ONE asset to a remote library without a full local copy — merges the remote manifest, " +
333
+ "uploads only the asset's files, registers with CAS")
334
+ .argument("<spec>", "<namespace>/<name>, or a bare <name> under the active login")
335
+ .argument("<path>", "the asset: a directory (stored under <id>/…) or a single file")
336
+ .option("--id <id>", "asset id (default: the directory/file basename)")
337
+ .option("--title <title>", "display title")
338
+ .option("--description <text>", "description (search keyword + embedding text)")
339
+ .option("--category <category>", "category facet")
340
+ .option("--tags <tags>", "comma-separated tags")
341
+ .option("--license <license>", "license (falls back to the library default when unset)")
342
+ .option("--attribution <text>", "required credit line (CC-BY etc.)")
343
+ .option("--replace", "overwrite an existing asset with this id")
344
+ .option("--dry-run", "print the transfer plan, then exit")
345
+ .option("--json", "emit the result as JSON")).action(async (spec, assetPath, opts) => {
346
+ process.exit(await runLibraryAdd({ ...opts, spec, assetPath }));
347
+ });
348
+ }
@@ -0,0 +1,26 @@
1
+ export declare function librariesCacheDir(): string;
2
+ export declare function hashCachePath(): string;
3
+ /** The build dir for one source directory — keyed by the resolved path so
4
+ * repeated pushes of the same tree reuse it. */
5
+ export declare function pushCacheDir(srcDir: string): string;
6
+ export interface HashCacheEntry {
7
+ mtimeMs: number;
8
+ size: number;
9
+ sha256: string;
10
+ }
11
+ export declare function loadHashCache(file?: string): Record<string, HashCacheEntry>;
12
+ export declare function saveHashCache(cache: Record<string, HashCacheEntry>, file?: string): void;
13
+ export interface HashedFile {
14
+ size: number;
15
+ sha256: string;
16
+ }
17
+ /**
18
+ * {size, sha256} for every rel path under `root`, through the cache. A miss
19
+ * (new path, or mtime/size moved) streams a fresh sha256 and updates the
20
+ * cache; `verify` re-hashes unconditionally. The cache file is written once,
21
+ * at the end. A missing file throws with the path named.
22
+ */
23
+ export declare function hashFiles(root: string, relPaths: readonly string[], opts?: {
24
+ verify?: boolean;
25
+ cacheFile?: string;
26
+ }): Promise<Map<string, HashedFile>>;
@@ -0,0 +1,88 @@
1
+ // Push-time caches for `dreamlake library` — both DISPOSABLE, both under
2
+ // `~/.dreamlake/cache/libraries/`:
3
+ //
4
+ // hashes.json absPath → {mtimeMs, size, sha256}, so an
5
+ // unchanged file is never re-hashed. A
6
+ // (mtime, size) hit trusts the cached
7
+ // digest; `--verify` re-hashes everything.
8
+ // <hash-of-source-path>/ the per-source build dir: the generated
9
+ // wire manifest, thumbnail renders and
10
+ // vector sidecars land here — NEVER in the
11
+ // user's source tree — and upload from
12
+ // here under the reserved `.dreamlake/`
13
+ // prefix.
14
+ import { createHash } from "node:crypto";
15
+ import { mkdirSync, readFileSync, renameSync, statSync, writeFileSync } from "node:fs";
16
+ import path from "node:path";
17
+ import { dreamlakeDir } from "../auth/materialized.js";
18
+ import { sha256File } from "./manifest.js";
19
+ export function librariesCacheDir() {
20
+ return path.join(dreamlakeDir(), "cache", "libraries");
21
+ }
22
+ export function hashCachePath() {
23
+ return path.join(librariesCacheDir(), "hashes.json");
24
+ }
25
+ /** The build dir for one source directory — keyed by the resolved path so
26
+ * repeated pushes of the same tree reuse it. */
27
+ export function pushCacheDir(srcDir) {
28
+ const key = createHash("sha256").update(path.resolve(srcDir)).digest("hex").slice(0, 16);
29
+ return path.join(librariesCacheDir(), key);
30
+ }
31
+ export function loadHashCache(file = hashCachePath()) {
32
+ try {
33
+ const parsed = JSON.parse(readFileSync(file, "utf8"));
34
+ if (parsed && typeof parsed === "object" && !Array.isArray(parsed)) {
35
+ return parsed;
36
+ }
37
+ }
38
+ catch {
39
+ /* absent or corrupt — the cache is disposable */
40
+ }
41
+ return {};
42
+ }
43
+ export function saveHashCache(cache, file = hashCachePath()) {
44
+ mkdirSync(path.dirname(file), { recursive: true });
45
+ const tmp = `${file}.${process.pid}.tmp`;
46
+ writeFileSync(tmp, JSON.stringify(cache));
47
+ renameSync(tmp, file);
48
+ }
49
+ /**
50
+ * {size, sha256} for every rel path under `root`, through the cache. A miss
51
+ * (new path, or mtime/size moved) streams a fresh sha256 and updates the
52
+ * cache; `verify` re-hashes unconditionally. The cache file is written once,
53
+ * at the end. A missing file throws with the path named.
54
+ */
55
+ export async function hashFiles(root, relPaths, opts = {}) {
56
+ const cacheFile = opts.cacheFile ?? hashCachePath();
57
+ const cache = loadHashCache(cacheFile);
58
+ const out = new Map();
59
+ let dirty = false;
60
+ for (const rel of relPaths) {
61
+ const abs = path.join(root, rel);
62
+ let st;
63
+ try {
64
+ st = statSync(abs);
65
+ if (!st.isFile())
66
+ throw new Error("not a regular file");
67
+ }
68
+ catch {
69
+ throw new Error(`'${rel}' disappeared while hashing — re-run the push`);
70
+ }
71
+ const cached = cache[abs];
72
+ if (!opts.verify &&
73
+ cached &&
74
+ cached.mtimeMs === st.mtimeMs &&
75
+ cached.size === st.size &&
76
+ /^[0-9a-f]{64}$/.test(cached.sha256 ?? "")) {
77
+ out.set(rel, { size: st.size, sha256: cached.sha256 });
78
+ continue;
79
+ }
80
+ const sha256 = await sha256File(abs);
81
+ out.set(rel, { size: st.size, sha256 });
82
+ cache[abs] = { mtimeMs: st.mtimeMs, size: st.size, sha256 };
83
+ dirty = true;
84
+ }
85
+ if (dirty)
86
+ saveHashCache(cache, cacheFile);
87
+ return out;
88
+ }
@@ -0,0 +1,75 @@
1
+ export declare const DREAMLAKE_YML = "dreamlake.yml";
2
+ /** Server-side mirrors (assetLibraryManifest.ts) — checked here so a bad id
3
+ * fails at discovery with a rename hint, not at register. */
4
+ export declare const ASSET_ID_RE: RegExp;
5
+ export declare const ASSET_KIND_RE: RegExp;
6
+ export interface YmlLibrary {
7
+ type?: string;
8
+ title?: string;
9
+ description?: string;
10
+ provider?: string;
11
+ homepage?: string;
12
+ license?: string;
13
+ tags?: string[];
14
+ upstream?: {
15
+ repo?: string;
16
+ commit?: string;
17
+ };
18
+ }
19
+ export interface YmlDiscover {
20
+ /** Glob dir patterns; each match = one asset root (id = dir basename). */
21
+ assets?: string[];
22
+ /** Pruned from discovery AND from any asset's files. */
23
+ exclude?: string[];
24
+ }
25
+ export interface YmlDefaults {
26
+ category?: string;
27
+ license?: string;
28
+ /** Merged (union, defaults first) into every asset's tags. */
29
+ tags?: string[];
30
+ }
31
+ export interface YmlEntryPoint {
32
+ kind: string;
33
+ file: string;
34
+ }
35
+ export interface YmlAsset {
36
+ title?: string;
37
+ description?: string;
38
+ category?: string;
39
+ tags?: string[];
40
+ kind?: string;
41
+ format?: string;
42
+ license?: string;
43
+ attribution?: string;
44
+ upstream?: {
45
+ id?: string;
46
+ url?: string;
47
+ };
48
+ entry?: string;
49
+ entryPoints?: Record<string, YmlEntryPoint>;
50
+ /** Explicit file set (globs or paths, relative to the source root) —
51
+ * overrides discovery for this asset, or adds an undiscovered one. */
52
+ files?: string[];
53
+ /** User-provided image override — a real user file, never `.dreamlake/`. */
54
+ thumbnail?: string;
55
+ }
56
+ export interface LibraryYml {
57
+ library?: YmlLibrary;
58
+ discover?: YmlDiscover;
59
+ defaults?: YmlDefaults;
60
+ assets?: Record<string, YmlAsset>;
61
+ }
62
+ /**
63
+ * Validate a parsed dreamlake.yml document. Exported for tests; `where`
64
+ * feeds error messages.
65
+ */
66
+ export declare function assertLibraryYml(doc: unknown): LibraryYml;
67
+ /**
68
+ * Read and validate `<dir>/dreamlake.yml`. `null` when the file does not
69
+ * exist — the file is optional, and its absence means pure-convention
70
+ * discovery.
71
+ */
72
+ export declare function loadLibraryYml(dir: string): {
73
+ yml: LibraryYml;
74
+ ymlPath: string;
75
+ } | null;