@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,428 @@
1
+ // `dreamlake install [latest|stable|X.Y.Z]` — place a native build under
2
+ // ~/.local/share/dreamlake/versions and point ~/.local/bin/dreamlake at it.
3
+ //
4
+ // install.sh does the minimum needed to get *a* verified binary onto disk,
5
+ // then hands over to this command. Keeping the real install logic in the
6
+ // binary means the bootstrap script published at dl.dreamlake.ai
7
+ // almost never has to change — improvements ship with the next release
8
+ // instead of requiring every user to re-curl a new script.
9
+ import { spawnSync } from "node:child_process";
10
+ import { createHash } from "node:crypto";
11
+ import { chmodSync, copyFileSync, existsSync, lstatSync, mkdirSync, readdirSync, readFileSync, readlinkSync, renameSync, rmSync, symlinkSync, writeFileSync, } from "node:fs";
12
+ import { homedir } from "node:os";
13
+ import path from "node:path";
14
+ import { binDir, canonical, isWindows, launcherPath, versionFromEntry, versionPath, versionsDir, } from "./paths.js";
15
+ import { compareVersions, detectPlatform, downloadBinary, fetchManifest, isChannel, resolveChannel, VERSION_RE, } from "./releases.js";
16
+ import { activeChannel, pinnedVersion, updatesDisabled, writeSettings } from "./settings.js";
17
+ import { BytesProgress } from "../progress.js";
18
+ import { VERSION } from "../version.js";
19
+ /**
20
+ * Resolve a user-supplied target into a concrete version. Accepts a channel
21
+ * name or an exact version; a channel also becomes the saved default for
22
+ * future auto-updates, matching how the install target picks your channel.
23
+ */
24
+ export async function resolveTarget(target) {
25
+ if (!target) {
26
+ const channel = activeChannel();
27
+ return { version: await resolveChannel(channel), channel };
28
+ }
29
+ if (isChannel(target)) {
30
+ return { version: await resolveChannel(target), channel: target };
31
+ }
32
+ if (VERSION_RE.test(target))
33
+ return { version: target, channel: null };
34
+ throw new Error(`invalid target "${target}" — expected latest, stable, or a version like 1.2.3`);
35
+ }
36
+ /**
37
+ * Materialise `version` at versions/<version>, reusing the running binary
38
+ * when it already is that version. install.sh always downloads the newest
39
+ * build (so the installer logic is current) and then asks for the target;
40
+ * when those coincide, copying ourselves saves a second ~60 MB download.
41
+ *
42
+ * Unless `quiet`, a download reports its progress on stderr — stdout stays
43
+ * clean for the result lines the callers print.
44
+ */
45
+ async function materialise(version, manifest, platform, quiet) {
46
+ const dest = versionPath(version);
47
+ const expected = manifest.platforms[platform]?.checksum;
48
+ if (existsSync(dest) && expected && sha256File(dest) === expected)
49
+ return;
50
+ mkdirSync(versionsDir(), { recursive: true });
51
+ const tmp = `${dest}.tmp-${process.pid}`;
52
+ let bytes = null;
53
+ if (version === VERSION && expected) {
54
+ const self = selfBytes();
55
+ if (self && sha256(self) === expected)
56
+ bytes = self;
57
+ }
58
+ if (!bytes) {
59
+ if (!quiet)
60
+ process.stderr.write(`Downloading dreamlake ${version} (${platform})…\n`);
61
+ // Constructed on the first chunk, when the total is known — the size
62
+ // can come from the manifest or fall back to Content-Length. Boxed
63
+ // because TS cannot see the callback's assignment from the finally.
64
+ const progress = { bar: null };
65
+ try {
66
+ bytes = await downloadBinary(version, platform, manifest, undefined, quiet
67
+ ? undefined
68
+ : (chunkBytes, totalBytes) => {
69
+ progress.bar ??= new BytesProgress(totalBytes);
70
+ progress.bar.advance(chunkBytes);
71
+ });
72
+ }
73
+ finally {
74
+ // Also on the error path: hand the line back so the failure message
75
+ // does not print onto the tail of a half-drawn progress line.
76
+ progress.bar?.finish();
77
+ }
78
+ }
79
+ try {
80
+ writeFileSync(tmp, bytes, { mode: 0o755 });
81
+ chmodSync(tmp, 0o755);
82
+ renameSync(tmp, dest);
83
+ }
84
+ catch (err) {
85
+ rmSync(tmp, { force: true });
86
+ throw err;
87
+ }
88
+ }
89
+ function selfBytes() {
90
+ try {
91
+ return readFileSync(process.execPath);
92
+ }
93
+ catch {
94
+ return null;
95
+ }
96
+ }
97
+ function sha256(buf) {
98
+ return createHash("sha256").update(buf).digest("hex");
99
+ }
100
+ function sha256File(p) {
101
+ try {
102
+ return sha256(readFileSync(p));
103
+ }
104
+ catch {
105
+ return null;
106
+ }
107
+ }
108
+ /** Version the launcher currently resolves to, or null. */
109
+ export function installedVersion() {
110
+ if (isWindows) {
111
+ // The launcher is a copy, so identify it by matching its hash against
112
+ // the installed versions.
113
+ const launcher = sha256File(launcherPath());
114
+ if (!launcher)
115
+ return null;
116
+ for (const entry of listVersions()) {
117
+ if (sha256File(versionPath(entry)) === launcher)
118
+ return entry;
119
+ }
120
+ return null;
121
+ }
122
+ try {
123
+ const target = readlinkSync(launcherPath());
124
+ const resolved = path.resolve(path.dirname(launcherPath()), target);
125
+ if (canonical(path.dirname(resolved)) !== canonical(versionsDir()))
126
+ return null;
127
+ return versionFromEntry(path.basename(resolved));
128
+ }
129
+ catch {
130
+ return null;
131
+ }
132
+ }
133
+ /** Versions currently present under versions/. */
134
+ function listVersions() {
135
+ try {
136
+ return readdirSync(versionsDir())
137
+ .map(versionFromEntry)
138
+ .filter((v) => v !== null);
139
+ }
140
+ catch {
141
+ return [];
142
+ }
143
+ }
144
+ /**
145
+ * Point ~/.local/bin/dreamlake at a version. A launcher that we did not
146
+ * create (a wrapper script the user wrote, say) is left untouched — the new
147
+ * version still lands under versions/, and their launcher stays in charge
148
+ * of which one runs. That case is reported back so the caller can say so;
149
+ * silently claiming success there leaves the user running someone else's
150
+ * binary, or nothing at all.
151
+ */
152
+ function linkLauncher(version) {
153
+ const link = launcherPath();
154
+ const target = versionPath(version);
155
+ mkdirSync(binDir(), { recursive: true });
156
+ // Windows has no usable symlink for unprivileged users, so the launcher
157
+ // is a copy. That also means there is no link to read a version back
158
+ // from — `installedVersion()` compares bytes instead.
159
+ if (isWindows) {
160
+ const previous = installedVersion();
161
+ try {
162
+ copyFileSync(target, link);
163
+ }
164
+ catch (err) {
165
+ // A running dreamlake.exe is locked by Windows and cannot be
166
+ // overwritten. Renaming it out of the way is permitted, and the
167
+ // stale copy is cleaned up on the next install.
168
+ if (err.code !== "EBUSY" && err.code !== "EPERM") {
169
+ throw err;
170
+ }
171
+ renameSync(link, `${link}.old-${process.pid}`);
172
+ copyFileSync(target, link);
173
+ }
174
+ return { previous, conflict: null };
175
+ }
176
+ let previous = null;
177
+ if (isSymlink(link)) {
178
+ previous = installedVersion();
179
+ }
180
+ else if (existsSync(link)) {
181
+ return { previous: null, conflict: link };
182
+ }
183
+ // Symlink-then-rename, not rm-then-symlink: the background updater swaps
184
+ // the launcher underneath live shells, and rm leaves a window where
185
+ // `dreamlake` is command-not-found for whoever types it right then.
186
+ const staging = `${link}.new-${process.pid}`;
187
+ rmSync(staging, { force: true });
188
+ symlinkSync(target, staging);
189
+ renameSync(staging, link);
190
+ return { previous, conflict: null };
191
+ }
192
+ function isSymlink(p) {
193
+ try {
194
+ return lstatSync(p).isSymbolicLink();
195
+ }
196
+ catch {
197
+ return false;
198
+ }
199
+ }
200
+ /** Delete installed versions other than the ones we still need. */
201
+ function prune(keep) {
202
+ for (const version of listVersions()) {
203
+ if (keep.includes(version))
204
+ continue;
205
+ rmSync(versionPath(version), { force: true });
206
+ }
207
+ // Launchers renamed out of the way because Windows had them locked.
208
+ try {
209
+ for (const entry of readdirSync(binDir())) {
210
+ if (/^dreamlake\.exe\.old-\d+$/.test(entry)) {
211
+ rmSync(path.join(binDir(), entry), { force: true });
212
+ }
213
+ }
214
+ }
215
+ catch {
216
+ /* bin dir may not exist yet */
217
+ }
218
+ }
219
+ // ─── PATH setup ──────────────────────────────────────────────────────
220
+ const PATH_MARKER = "# added by the dreamlake installer";
221
+ function onPath(dir) {
222
+ const entries = (process.env.PATH ?? "").split(path.delimiter).filter(Boolean);
223
+ return entries.some((e) => path.resolve(e) === path.resolve(dir));
224
+ }
225
+ /**
226
+ * Config file for the user's login shell, plus the syntax to extend PATH in
227
+ * it. Only the active shell is touched: appending to every rc we can find
228
+ * means fish users get a line in ~/.bashrc that fish never reads, and
229
+ * everyone gets four blocks to clean up at uninstall time for one install.
230
+ */
231
+ function shellRc() {
232
+ const home = homedir();
233
+ const shell = path.basename(process.env.SHELL ?? "");
234
+ if (shell === "fish") {
235
+ return {
236
+ file: path.join(home, ".config", "fish", "config.fish"),
237
+ // fish_add_path is already a no-op when the entry is present.
238
+ line: `\n${PATH_MARKER}\nfish_add_path "$HOME/.local/bin"\n`,
239
+ };
240
+ }
241
+ // Guarded, so re-sourcing the rc in a live shell does not prepend a
242
+ // second copy. An unguarded `export PATH=...:$PATH` grows PATH every
243
+ // time the file is sourced, and `where dreamlake` starts listing the
244
+ // same binary twice. Same shape uv uses in ~/.local/bin/env.
245
+ const posixLine = `\n${PATH_MARKER}\n` +
246
+ `case ":$PATH:" in\n` +
247
+ ` *":$HOME/.local/bin:"*) ;;\n` +
248
+ ` *) export PATH="$HOME/.local/bin:$PATH" ;;\n` +
249
+ `esac\n`;
250
+ if (shell === "zsh")
251
+ return { file: path.join(home, ".zshrc"), line: posixLine };
252
+ if (shell === "bash") {
253
+ // bash reads .bash_profile for login shells and .bashrc otherwise;
254
+ // prefer whichever already exists so we extend the user's setup
255
+ // instead of creating a second file that shadows it.
256
+ const profile = path.join(home, ".bash_profile");
257
+ const rc = path.join(home, ".bashrc");
258
+ return { file: existsSync(rc) || !existsSync(profile) ? rc : profile, line: posixLine };
259
+ }
260
+ return { file: path.join(home, ".profile"), line: posixLine };
261
+ }
262
+ /**
263
+ * Add binDir() to the user's persistent PATH on Windows, via the registry
264
+ * environment block that PowerShell exposes.
265
+ *
266
+ * Deliberately NOT `setx`, which silently truncates PATH at 1024
267
+ * characters and has eaten many people's environment.
268
+ * SetEnvironmentVariable writes the registry properly and broadcasts
269
+ * WM_SETTINGCHANGE so new shells see it.
270
+ */
271
+ function ensureOnPathWindows() {
272
+ const script = [
273
+ "$dir = $env:DREAMLAKE_BIN_DIR",
274
+ "$cur = [Environment]::GetEnvironmentVariable('Path','User')",
275
+ "if ($null -eq $cur) { $cur = '' }",
276
+ "$parts = $cur.Split(';') | Where-Object { $_ -ne '' }",
277
+ "if ($parts -notcontains $dir) {",
278
+ " $next = (@($parts) + $dir) -join ';'",
279
+ " [Environment]::SetEnvironmentVariable('Path', $next, 'User')",
280
+ " Write-Output 'added'",
281
+ "}",
282
+ ].join("\n");
283
+ const res = spawnSync("powershell", ["-NoProfile", "-NonInteractive", "-ExecutionPolicy", "Bypass", "-Command", script], { env: { ...process.env, DREAMLAKE_BIN_DIR: binDir() }, encoding: "utf8" });
284
+ if (res.status !== 0)
285
+ return [];
286
+ return res.stdout?.includes("added") ? ["your user PATH"] : [];
287
+ }
288
+ /**
289
+ * Put ~/.local/bin on PATH for the next login shell. Returns the files
290
+ * touched (at most one). Idempotent via PATH_MARKER — re-running the
291
+ * installer does not stack up duplicate exports.
292
+ */
293
+ function ensureOnPath() {
294
+ if (isWindows)
295
+ return onPath(binDir()) ? [] : ensureOnPathWindows();
296
+ const { file, line } = shellRc();
297
+ let current = "";
298
+ try {
299
+ current = readFileSync(file, "utf8");
300
+ }
301
+ catch {
302
+ /* new file */
303
+ }
304
+ if (current.includes(PATH_MARKER)) {
305
+ // Earlier versions wrote an unguarded export, which prepends again on
306
+ // every `source ~/.zshrc`. Upgrade our own block in place; leaving it
307
+ // means the duplicate never goes away for anyone already installed.
308
+ const legacy = `${PATH_MARKER}\nexport PATH="$HOME/.local/bin:$PATH"\n`;
309
+ if (current.includes(legacy)) {
310
+ writeFileSync(file, current.replace(legacy, line.replace(/^\n/, "")));
311
+ return [file];
312
+ }
313
+ return [];
314
+ }
315
+ if (onPath(binDir()))
316
+ return [];
317
+ mkdirSync(path.dirname(file), { recursive: true });
318
+ writeFileSync(file, current + line);
319
+ return [file];
320
+ }
321
+ /**
322
+ * The `dreamlake` the user's current PATH would actually run, when that is
323
+ * something other than the launcher we manage.
324
+ *
325
+ * Without this an install onto a machine that already has a `dreamlake`
326
+ * earlier in PATH — an old npm global, a `npm link`, the retired Python
327
+ * console script — looks like it worked and then silently keeps running the
328
+ * old one. `command not found` at least tells you something is wrong; this
329
+ * failure mode tells you nothing at all.
330
+ */
331
+ export function shadowingBinary() {
332
+ const exe = isWindows ? "dreamlake.exe" : "dreamlake";
333
+ const ours = canonical(launcherPath());
334
+ for (const dir of (process.env.PATH ?? "").split(path.delimiter)) {
335
+ if (!dir)
336
+ continue;
337
+ const candidate = path.join(dir, exe);
338
+ if (!existsSync(candidate))
339
+ continue;
340
+ return canonical(candidate) === ours ? null : candidate;
341
+ }
342
+ return null;
343
+ }
344
+ export async function performInstall(target, opts = {}) {
345
+ // DREAMLAKE_DISABLE_UPDATES blocks every path that would change which
346
+ // version runs — that is the whole point of it, and it is what the docs
347
+ // promise. DREAMLAKE_DISABLE_AUTOUPDATER, by contrast, only silences the
348
+ // background check and leaves explicit commands working.
349
+ if (updatesDisabled()) {
350
+ throw new Error("updates are disabled (DREAMLAKE_DISABLE_UPDATES)");
351
+ }
352
+ const { version, channel } = await resolveTarget(target);
353
+ const platform = detectPlatform();
354
+ const manifest = await fetchManifest(version);
355
+ await materialise(version, manifest, platform, opts.background === true);
356
+ // The background updater decided to install before the download started;
357
+ // a pin that appeared since is the user explicitly freezing the version
358
+ // mid-flight (`self-update 1.2.3` racing the detached child), and going
359
+ // on would clobber both their pin and their launcher.
360
+ if (opts.background && pinnedVersion()) {
361
+ throw new Error(`superseded by a pin to ${pinnedVersion()} set while downloading`);
362
+ }
363
+ const { previous, conflict } = linkLauncher(version);
364
+ // Asking for an exact version pins it; asking for a channel resumes
365
+ // following that channel. Without this the background updater would move
366
+ // you straight off the version you just asked for.
367
+ if (channel)
368
+ writeSettings({ channel, pinned: null });
369
+ else
370
+ writeSettings({ pinned: version });
371
+ // Keep the version we just installed plus whatever is still running, so
372
+ // a long-lived session does not lose its own executable mid-run.
373
+ const running = installedVersion();
374
+ prune([version, ...(running ? [running] : []), ...(previous ? [previous] : [])].filter(Boolean));
375
+ const touched = ensureOnPath();
376
+ // Only meaningful once the launcher is really ours; a conflict there is
377
+ // reported on its own and would otherwise produce two warnings for one
378
+ // problem.
379
+ const shadowedBy = conflict ? null : shadowingBinary();
380
+ return {
381
+ version,
382
+ previous: previous && previous !== version ? previous : null,
383
+ launcher: launcherPath(),
384
+ pinned: channel ? null : version,
385
+ launcherConflict: conflict,
386
+ shadowedBy,
387
+ pathAdvice: touched.length
388
+ ? `Added ~/.local/bin to PATH in ${touched.map((f) => f.replace(homedir(), "~")).join(", ")} — open a new shell or run: export PATH="$HOME/.local/bin:$PATH"`
389
+ : onPath(binDir())
390
+ ? null
391
+ : `~/.local/bin is not on your PATH — add it with: export PATH="$HOME/.local/bin:$PATH"`,
392
+ };
393
+ }
394
+ /**
395
+ * Lines describing anything that stops the install being the plain success
396
+ * it looks like. Empty when all is well.
397
+ */
398
+ export function installWarnings(result) {
399
+ const tilde = (p) => p.replace(homedir(), "~");
400
+ if (result.launcherConflict) {
401
+ return [
402
+ `Warning: ${tilde(result.launcherConflict)} already exists and is not a symlink we manage.`,
403
+ `It was left alone, so \`dreamlake\` on your PATH is NOT ${result.version}.`,
404
+ `The new version is at ${tilde(versionPath(result.version))}.`,
405
+ `Remove or rename that file and re-run to switch over.`,
406
+ ];
407
+ }
408
+ if (result.shadowedBy) {
409
+ return [
410
+ `Warning: another dreamlake is earlier on your PATH and will keep running instead:`,
411
+ ` ${tilde(result.shadowedBy)}`,
412
+ `Installed ${result.version} at ${tilde(result.launcher)}.`,
413
+ `Remove the other one (for an npm install: npm uninstall -g @dreamlake/dreamlake-cli),`,
414
+ `or put ~/.local/bin ahead of it in PATH. Check with: dreamlake doctor`,
415
+ ];
416
+ }
417
+ return [];
418
+ }
419
+ /** Newest version available on `channel`, or null when the check fails. */
420
+ export async function latestAvailable(channel) {
421
+ try {
422
+ return await resolveChannel(channel);
423
+ }
424
+ catch {
425
+ return null;
426
+ }
427
+ }
428
+ export { compareVersions };
@@ -0,0 +1,40 @@
1
+ /** `~/.local/share/dreamlake` — installed versions. */
2
+ export declare function dataDir(): string;
3
+ export declare const isWindows: boolean;
4
+ /** `~/.local/share/dreamlake/versions` — one file per installed version. */
5
+ export declare function versionsDir(): string;
6
+ /** Path the binary for `version` is stored at. */
7
+ export declare function versionPath(version: string): string;
8
+ /** Version a `versions/` entry represents, or null if it is not one of ours. */
9
+ export declare function versionFromEntry(entry: string): string | null;
10
+ /** `~/.local/bin` — where the launcher symlink goes. */
11
+ export declare function binDir(): string;
12
+ /**
13
+ * `~/.local/bin/dreamlake` — what users actually invoke. A symlink into
14
+ * `versions/` on POSIX; on Windows a plain copy, since creating a symlink
15
+ * there needs admin rights or Developer Mode.
16
+ */
17
+ export declare function launcherPath(): string;
18
+ /** `~/.dreamlake` — shared with auth.yml and the SDK's files. */
19
+ export declare function configDir(): string;
20
+ export declare function settingsPath(): string;
21
+ /** `~/.local/state/dreamlake/update.json` — auto-update throttle state. */
22
+ export declare function updateStatePath(): string;
23
+ /**
24
+ * Canonical form of a path, following symlinks where they exist.
25
+ *
26
+ * Needed because process.execPath is already resolved by the OS while our
27
+ * paths are built from homedir(), and the two differ whenever a symlink
28
+ * sits anywhere above HOME — /var vs /private/var on macOS, or a homedir
29
+ * reached through an automounter. A plain string compare says "not a
30
+ * native install" for what is in fact a perfectly normal install, which
31
+ * silently disables auto-update.
32
+ */
33
+ export declare function canonical(p: string): string;
34
+ /**
35
+ * True when the running executable is a native install we manage — i.e. it
36
+ * lives under `versionsDir()`. False for `pnpm cli`, an npm install, or a
37
+ * binary run straight out of a download directory; in those cases we must
38
+ * not silently replace anything.
39
+ */
40
+ export declare function isNativeInstall(execPath?: string): boolean;
@@ -0,0 +1,87 @@
1
+ // Where a native install lives on disk.
2
+ //
3
+ // ~/.local/share/dreamlake/versions/<version> the binary for each version
4
+ // ~/.local/bin/dreamlake symlink → the active version
5
+ // ~/.dreamlake/settings.yml release channel
6
+ // ~/.local/state/dreamlake/update.json last auto-update check
7
+ //
8
+ // Everything is under $HOME, which is why install.sh refuses to run under
9
+ // sudo: with sudo these resolve to root's home and the `dreamlake` command
10
+ // is then missing from the user's own shell.
11
+ import { realpathSync } from "node:fs";
12
+ import { homedir } from "node:os";
13
+ import path from "node:path";
14
+ function xdg(envVar, fallback) {
15
+ const v = process.env[envVar];
16
+ return v && path.isAbsolute(v) ? v : path.join(homedir(), fallback);
17
+ }
18
+ /** `~/.local/share/dreamlake` — installed versions. */
19
+ export function dataDir() {
20
+ return path.join(xdg("XDG_DATA_HOME", path.join(".local", "share")), "dreamlake");
21
+ }
22
+ export const isWindows = process.platform === "win32";
23
+ /** Windows will not execute a file that has no extension. */
24
+ const EXE = isWindows ? ".exe" : "";
25
+ /** `~/.local/share/dreamlake/versions` — one file per installed version. */
26
+ export function versionsDir() {
27
+ return path.join(dataDir(), "versions");
28
+ }
29
+ /** Path the binary for `version` is stored at. */
30
+ export function versionPath(version) {
31
+ return path.join(versionsDir(), version + EXE);
32
+ }
33
+ /** Version a `versions/` entry represents, or null if it is not one of ours. */
34
+ export function versionFromEntry(entry) {
35
+ const base = EXE && entry.endsWith(EXE) ? entry.slice(0, -EXE.length) : entry;
36
+ return /^\d+\.\d+\.\d+(-[^\s]+)?$/.test(base) ? base : null;
37
+ }
38
+ /** `~/.local/bin` — where the launcher symlink goes. */
39
+ export function binDir() {
40
+ return path.join(homedir(), ".local", "bin");
41
+ }
42
+ /**
43
+ * `~/.local/bin/dreamlake` — what users actually invoke. A symlink into
44
+ * `versions/` on POSIX; on Windows a plain copy, since creating a symlink
45
+ * there needs admin rights or Developer Mode.
46
+ */
47
+ export function launcherPath() {
48
+ return path.join(binDir(), `dreamlake${EXE}`);
49
+ }
50
+ /** `~/.dreamlake` — shared with auth.yml and the SDK's files. */
51
+ export function configDir() {
52
+ return path.join(homedir(), ".dreamlake");
53
+ }
54
+ export function settingsPath() {
55
+ return path.join(configDir(), "settings.yml");
56
+ }
57
+ /** `~/.local/state/dreamlake/update.json` — auto-update throttle state. */
58
+ export function updateStatePath() {
59
+ return path.join(xdg("XDG_STATE_HOME", path.join(".local", "state")), "dreamlake", "update.json");
60
+ }
61
+ /**
62
+ * Canonical form of a path, following symlinks where they exist.
63
+ *
64
+ * Needed because process.execPath is already resolved by the OS while our
65
+ * paths are built from homedir(), and the two differ whenever a symlink
66
+ * sits anywhere above HOME — /var vs /private/var on macOS, or a homedir
67
+ * reached through an automounter. A plain string compare says "not a
68
+ * native install" for what is in fact a perfectly normal install, which
69
+ * silently disables auto-update.
70
+ */
71
+ export function canonical(p) {
72
+ try {
73
+ return realpathSync(p);
74
+ }
75
+ catch {
76
+ return path.resolve(p);
77
+ }
78
+ }
79
+ /**
80
+ * True when the running executable is a native install we manage — i.e. it
81
+ * lives under `versionsDir()`. False for `pnpm cli`, an npm install, or a
82
+ * binary run straight out of a download directory; in those cases we must
83
+ * not silently replace anything.
84
+ */
85
+ export function isNativeInstall(execPath = process.execPath) {
86
+ return canonical(execPath).startsWith(canonical(versionsDir()) + path.sep);
87
+ }
@@ -0,0 +1,41 @@
1
+ export declare const DEFAULT_BASE_URL = "https://dl.dreamlake.ai/dreamlake-cli/releases";
2
+ /** Release bucket base. `DREAMLAKE_DOWNLOAD_BASE_URL` overrides it for testing. */
3
+ export declare function baseUrl(): string;
4
+ export type Channel = "latest" | "stable";
5
+ export declare const CHANNELS: Channel[];
6
+ export declare function isChannel(v: string): v is Channel;
7
+ export declare const VERSION_RE: RegExp;
8
+ export interface PlatformEntry {
9
+ binary: string;
10
+ checksum: string;
11
+ size: number;
12
+ }
13
+ export interface Manifest {
14
+ version: string;
15
+ buildDate?: string;
16
+ platforms: Record<string, PlatformEntry>;
17
+ }
18
+ /**
19
+ * Platform key for the running machine, matching the keys install.sh
20
+ * derives from `uname`. musl distros get their own build because a
21
+ * glibc-linked binary will not start on Alpine.
22
+ */
23
+ export declare function detectPlatform(): string;
24
+ /**
25
+ * Newest version on a channel. The pointer is a bare version string; we
26
+ * validate its shape before it can reach a URL, so an HTML error page (a
27
+ * captive portal, say) fails here rather than being pasted into a path.
28
+ */
29
+ export declare function resolveChannel(channel: Channel, signal?: AbortSignal): Promise<string>;
30
+ export declare function fetchManifest(version: string, signal?: AbortSignal): Promise<Manifest>;
31
+ /**
32
+ * Download a platform binary and verify it against the manifest checksum.
33
+ * Throws on mismatch — the caller must never write an unverified binary to
34
+ * a path that later gets executed.
35
+ *
36
+ * `onProgress` receives each body chunk's size plus the best-known total
37
+ * (manifest size, else Content-Length, else 0 for "unknown").
38
+ */
39
+ export declare function downloadBinary(version: string, platform: string, manifest: Manifest, signal?: AbortSignal, onProgress?: (chunkBytes: number, totalBytes: number) => void): Promise<Buffer>;
40
+ /** Numeric-ish semver compare. Returns >0 when `a` is newer than `b`. */
41
+ export declare function compareVersions(a: string, b: string): number;