@dreamlake/dreamlake-cli 0.88.0 → 0.89.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (535) hide show
  1. package/dist/api/access.d.ts +83 -0
  2. package/dist/api/access.js +77 -0
  3. package/dist/api/agent.d.ts +156 -0
  4. package/dist/api/agent.js +111 -0
  5. package/dist/api/browser.d.ts +90 -0
  6. package/dist/api/browser.js +102 -0
  7. package/dist/api/client.d.ts +53 -0
  8. package/dist/api/client.js +102 -0
  9. package/dist/api/common.d.ts +28 -0
  10. package/dist/api/common.js +16 -0
  11. package/dist/api/content.d.ts +195 -0
  12. package/dist/api/content.js +147 -0
  13. package/dist/api/execution.d.ts +84 -0
  14. package/dist/api/execution.js +73 -0
  15. package/dist/api/http.d.ts +19 -0
  16. package/dist/api/http.js +66 -0
  17. package/dist/api/index.d.ts +2330 -0
  18. package/dist/api/index.js +114 -0
  19. package/dist/api/infra.d.ts +2 -0
  20. package/dist/api/infra.js +2 -0
  21. package/dist/api/jobs.d.ts +2 -0
  22. package/dist/api/jobs.js +2 -0
  23. package/dist/api/layout.d.ts +2 -0
  24. package/dist/api/layout.js +2 -0
  25. package/dist/api/library-edit.d.ts +3 -0
  26. package/dist/api/library-edit.js +3 -0
  27. package/dist/api/library-manifest.d.ts +2 -0
  28. package/dist/api/library-manifest.js +2 -0
  29. package/dist/api/note-character-plan.d.ts +2 -0
  30. package/dist/api/note-character-plan.js +2 -0
  31. package/dist/api/note-editing.d.ts +2 -0
  32. package/dist/api/note-editing.js +2 -0
  33. package/dist/api/note-edits.d.ts +21 -0
  34. package/dist/api/note-edits.js +10 -0
  35. package/dist/api/note-events.d.ts +5 -0
  36. package/dist/api/note-events.js +11 -0
  37. package/dist/api/note-files.d.ts +75 -0
  38. package/dist/api/note-files.js +65 -0
  39. package/dist/api/note-html-read.d.ts +2 -0
  40. package/dist/api/note-html-read.js +2 -0
  41. package/dist/api/note-html.d.ts +2 -0
  42. package/dist/api/note-html.js +2 -0
  43. package/dist/api/note-toc.d.ts +2 -0
  44. package/dist/api/note-toc.js +2 -0
  45. package/dist/api/notes.d.ts +304 -0
  46. package/dist/api/notes.js +181 -0
  47. package/dist/api/open-resources.d.ts +27 -0
  48. package/dist/api/open-resources.js +102 -0
  49. package/dist/api/ownership.d.ts +12 -0
  50. package/dist/api/ownership.js +24 -0
  51. package/dist/api/platform.d.ts +83 -0
  52. package/dist/api/platform.js +56 -0
  53. package/dist/api/presigned-transfer.d.ts +2 -0
  54. package/dist/api/presigned-transfer.js +2 -0
  55. package/dist/api/registered-runs.d.ts +48 -0
  56. package/dist/api/registered-runs.js +33 -0
  57. package/dist/api/sessions.d.ts +299 -0
  58. package/dist/api/sessions.js +105 -0
  59. package/dist/api/storage.d.ts +46 -0
  60. package/dist/api/storage.js +34 -0
  61. package/dist/api/streams.d.ts +18 -0
  62. package/dist/api/streams.js +70 -0
  63. package/dist/api/vault.d.ts +93 -0
  64. package/dist/api/vault.js +79 -0
  65. package/dist/api/workspace.d.ts +180 -0
  66. package/dist/api/workspace.js +146 -0
  67. package/dist/cli/agent-identity.d.ts +4 -0
  68. package/dist/cli/agent-identity.js +21 -0
  69. package/dist/cli/agents/identity.d.ts +50 -0
  70. package/dist/cli/agents/identity.js +105 -0
  71. package/dist/cli/agents/index.d.ts +31 -0
  72. package/dist/cli/agents/index.js +580 -0
  73. package/dist/cli/agents/manage.d.ts +43 -0
  74. package/dist/cli/agents/manage.js +376 -0
  75. package/dist/cli/agents/spec.d.ts +104 -0
  76. package/dist/cli/agents/spec.js +280 -0
  77. package/dist/cli/agents/web.d.ts +7 -0
  78. package/dist/cli/agents/web.js +109 -0
  79. package/dist/cli/artifact/incremental.d.ts +21 -0
  80. package/dist/cli/artifact/incremental.js +80 -0
  81. package/dist/cli/artifact/index.d.ts +52 -0
  82. package/dist/cli/artifact/index.js +405 -0
  83. package/dist/cli/artifact/meta.d.ts +69 -0
  84. package/dist/cli/artifact/meta.js +189 -0
  85. package/dist/cli/auth/commands.d.ts +29 -0
  86. package/dist/cli/auth/commands.js +327 -0
  87. package/dist/cli/auth/constants.d.ts +13 -0
  88. package/dist/cli/auth/constants.js +18 -0
  89. package/dist/cli/auth/credentials.d.ts +37 -0
  90. package/dist/cli/auth/credentials.js +155 -0
  91. package/dist/cli/auth/device-flow.d.ts +32 -0
  92. package/dist/cli/auth/device-flow.js +154 -0
  93. package/dist/cli/auth/device-secret.d.ts +6 -0
  94. package/dist/cli/auth/device-secret.js +26 -0
  95. package/dist/cli/auth/machine.d.ts +15 -0
  96. package/dist/cli/auth/machine.js +126 -0
  97. package/dist/cli/auth/materialized.d.ts +32 -0
  98. package/dist/cli/auth/materialized.js +102 -0
  99. package/dist/cli/auth/migrate.d.ts +10 -0
  100. package/dist/cli/auth/migrate.js +75 -0
  101. package/dist/cli/client.d.ts +102 -0
  102. package/dist/cli/client.js +206 -0
  103. package/dist/cli/collection-list.d.ts +3 -0
  104. package/dist/cli/collection-list.js +25 -0
  105. package/dist/cli/compat/ctx.d.ts +26 -0
  106. package/dist/cli/compat/ctx.js +76 -0
  107. package/dist/cli/compat/dreamdb-wasm-embedded.d.ts +2 -0
  108. package/dist/cli/compat/dreamdb-wasm-embedded.js +8 -0
  109. package/dist/cli/compat/dreamdb-wasm.d.ts +1 -0
  110. package/dist/cli/compat/dreamdb-wasm.js +26 -0
  111. package/dist/cli/compat/dreamdb.d.ts +112 -0
  112. package/dist/cli/compat/dreamdb.js +219 -0
  113. package/dist/cli/compat/flags.d.ts +2 -0
  114. package/dist/cli/compat/flags.js +13 -0
  115. package/dist/cli/compat/http.d.ts +23 -0
  116. package/dist/cli/compat/http.js +137 -0
  117. package/dist/cli/compat/presignedTransfer.d.ts +139 -0
  118. package/dist/cli/compat/presignedTransfer.js +580 -0
  119. package/dist/cli/compat/s3-backend.d.ts +73 -0
  120. package/dist/cli/compat/s3-backend.js +132 -0
  121. package/dist/cli/config.d.ts +22 -0
  122. package/dist/cli/config.js +96 -0
  123. package/dist/cli/connection/dto.d.ts +159 -0
  124. package/dist/cli/connection/dto.js +497 -0
  125. package/dist/cli/connection/index.d.ts +50 -0
  126. package/dist/cli/connection/index.js +413 -0
  127. package/dist/cli/connection/oauth.d.ts +23 -0
  128. package/dist/cli/connection/oauth.js +290 -0
  129. package/dist/cli/connection/write.d.ts +47 -0
  130. package/dist/cli/connection/write.js +573 -0
  131. package/dist/cli/create/index.d.ts +19 -0
  132. package/dist/cli/create/index.js +209 -0
  133. package/dist/cli/declare/index.d.ts +29 -0
  134. package/dist/cli/declare/index.js +304 -0
  135. package/dist/cli/delete/index.d.ts +18 -0
  136. package/dist/cli/delete/index.js +232 -0
  137. package/dist/cli/download/index.d.ts +9 -0
  138. package/dist/cli/download/index.js +128 -0
  139. package/dist/cli/env/compose.d.ts +88 -0
  140. package/dist/cli/env/compose.js +402 -0
  141. package/dist/cli/env/index.d.ts +176 -0
  142. package/dist/cli/env/index.js +1011 -0
  143. package/dist/cli/experiments/index.d.ts +11 -0
  144. package/dist/cli/experiments/index.js +168 -0
  145. package/dist/cli/glob.d.ts +1 -0
  146. package/dist/cli/glob.js +45 -0
  147. package/dist/cli/graphql-helpers.d.ts +23 -0
  148. package/dist/cli/graphql-helpers.js +42 -0
  149. package/dist/cli/graphql.d.ts +10 -0
  150. package/dist/cli/graphql.js +47 -0
  151. package/dist/cli/help-examples.generated.d.ts +1 -0
  152. package/dist/cli/help-examples.generated.js +192 -0
  153. package/dist/cli/helpers.d.ts +8 -0
  154. package/dist/cli/helpers.js +106 -0
  155. package/dist/cli/hosts/api.d.ts +29 -0
  156. package/dist/cli/hosts/api.js +54 -0
  157. package/dist/cli/hosts/bootstrap-source.d.ts +1 -0
  158. package/dist/cli/hosts/bootstrap-source.js +2 -0
  159. package/dist/cli/hosts/catalog.d.ts +26 -0
  160. package/dist/cli/hosts/catalog.js +55 -0
  161. package/dist/cli/hosts/config.d.ts +45 -0
  162. package/dist/cli/hosts/config.js +179 -0
  163. package/dist/cli/hosts/credentials.d.ts +19 -0
  164. package/dist/cli/hosts/credentials.js +173 -0
  165. package/dist/cli/hosts/enroll.d.ts +17 -0
  166. package/dist/cli/hosts/enroll.js +109 -0
  167. package/dist/cli/hosts/enrollments.d.ts +25 -0
  168. package/dist/cli/hosts/enrollments.js +54 -0
  169. package/dist/cli/hosts/index.d.ts +6 -0
  170. package/dist/cli/hosts/index.js +279 -0
  171. package/dist/cli/hosts/inventory.d.ts +40 -0
  172. package/dist/cli/hosts/inventory.js +91 -0
  173. package/dist/cli/hosts/lifecycle.d.ts +15 -0
  174. package/dist/cli/hosts/lifecycle.js +108 -0
  175. package/dist/cli/hosts/metrics-source.d.ts +12 -0
  176. package/dist/cli/hosts/metrics-source.js +89 -0
  177. package/dist/cli/hosts/observations.d.ts +39 -0
  178. package/dist/cli/hosts/observations.js +102 -0
  179. package/dist/cli/hosts/remote.d.ts +5 -0
  180. package/dist/cli/hosts/remote.js +66 -0
  181. package/dist/cli/hosts/ssh.d.ts +63 -0
  182. package/dist/cli/hosts/ssh.js +276 -0
  183. package/dist/cli/index.d.ts +1 -0
  184. package/dist/cli/index.js +288 -0
  185. package/dist/cli/infra/api.d.ts +95 -0
  186. package/dist/cli/infra/api.js +291 -0
  187. package/dist/cli/infra/index.d.ts +5 -0
  188. package/dist/cli/infra/index.js +102 -0
  189. package/dist/cli/infra/move.d.ts +15 -0
  190. package/dist/cli/infra/move.js +123 -0
  191. package/dist/cli/infra/transfer.d.ts +15 -0
  192. package/dist/cli/infra/transfer.js +280 -0
  193. package/dist/cli/jobs/api.d.ts +69 -0
  194. package/dist/cli/jobs/api.js +121 -0
  195. package/dist/cli/jobs/index.d.ts +5 -0
  196. package/dist/cli/jobs/index.js +140 -0
  197. package/dist/cli/lakeshore/index.d.ts +98 -0
  198. package/dist/cli/lakeshore/index.js +502 -0
  199. package/dist/cli/launch/index.d.ts +43 -0
  200. package/dist/cli/launch/index.js +270 -0
  201. package/dist/cli/layout/index.d.ts +2 -0
  202. package/dist/cli/layout/index.js +44 -0
  203. package/dist/cli/layout/transport.d.ts +12 -0
  204. package/dist/cli/layout/transport.js +70 -0
  205. package/dist/cli/library/add.d.ts +60 -0
  206. package/dist/cli/library/add.js +348 -0
  207. package/dist/cli/library/cache.d.ts +26 -0
  208. package/dist/cli/library/cache.js +88 -0
  209. package/dist/cli/library/config.d.ts +75 -0
  210. package/dist/cli/library/config.js +198 -0
  211. package/dist/cli/library/digest.d.ts +5 -0
  212. package/dist/cli/library/digest.js +19 -0
  213. package/dist/cli/library/discover.d.ts +87 -0
  214. package/dist/cli/library/discover.js +534 -0
  215. package/dist/cli/library/freshness.d.ts +35 -0
  216. package/dist/cli/library/freshness.js +109 -0
  217. package/dist/cli/library/generation.d.ts +35 -0
  218. package/dist/cli/library/generation.js +211 -0
  219. package/dist/cli/library/index.d.ts +2 -0
  220. package/dist/cli/library/index.js +36 -0
  221. package/dist/cli/library/info.d.ts +69 -0
  222. package/dist/cli/library/info.js +311 -0
  223. package/dist/cli/library/list.d.ts +33 -0
  224. package/dist/cli/library/list.js +86 -0
  225. package/dist/cli/library/manifest.d.ts +81 -0
  226. package/dist/cli/library/manifest.js +200 -0
  227. package/dist/cli/library/manifestCache.d.ts +45 -0
  228. package/dist/cli/library/manifestCache.js +169 -0
  229. package/dist/cli/library/pull.d.ts +30 -0
  230. package/dist/cli/library/pull.js +438 -0
  231. package/dist/cli/library/push.d.ts +72 -0
  232. package/dist/cli/library/push.js +642 -0
  233. package/dist/cli/library/rm.d.ts +31 -0
  234. package/dist/cli/library/rm.js +200 -0
  235. package/dist/cli/library/search.d.ts +18 -0
  236. package/dist/cli/library/search.js +181 -0
  237. package/dist/cli/library/stat.d.ts +15 -0
  238. package/dist/cli/library/stat.js +127 -0
  239. package/dist/cli/library/tools.d.ts +104 -0
  240. package/dist/cli/library/tools.js +163 -0
  241. package/dist/cli/library/wire.d.ts +47 -0
  242. package/dist/cli/library/wire.js +120 -0
  243. package/dist/cli/list/index.d.ts +26 -0
  244. package/dist/cli/list/index.js +256 -0
  245. package/dist/cli/notes/character-plan.d.ts +22 -0
  246. package/dist/cli/notes/character-plan.js +232 -0
  247. package/dist/cli/notes/document.d.ts +73 -0
  248. package/dist/cli/notes/document.js +306 -0
  249. package/dist/cli/notes/edit-commands.d.ts +106 -0
  250. package/dist/cli/notes/edit-commands.js +623 -0
  251. package/dist/cli/notes/editing.d.ts +81 -0
  252. package/dist/cli/notes/editing.js +305 -0
  253. package/dist/cli/notes/events.d.ts +36 -0
  254. package/dist/cli/notes/events.js +54 -0
  255. package/dist/cli/notes/files-commands.d.ts +120 -0
  256. package/dist/cli/notes/files-commands.js +554 -0
  257. package/dist/cli/notes/html-read.d.ts +9 -0
  258. package/dist/cli/notes/html-read.js +90 -0
  259. package/dist/cli/notes/html.d.ts +73 -0
  260. package/dist/cli/notes/html.js +381 -0
  261. package/dist/cli/notes/index.d.ts +123 -0
  262. package/dist/cli/notes/index.js +1303 -0
  263. package/dist/cli/notes/linger.d.ts +59 -0
  264. package/dist/cli/notes/linger.js +339 -0
  265. package/dist/cli/notes/media-commands.d.ts +5 -0
  266. package/dist/cli/notes/media-commands.js +51 -0
  267. package/dist/cli/notes/move-command.d.ts +83 -0
  268. package/dist/cli/notes/move-command.js +259 -0
  269. package/dist/cli/notes/rm-command.d.ts +22 -0
  270. package/dist/cli/notes/rm-command.js +110 -0
  271. package/dist/cli/notes/select-command.d.ts +12 -0
  272. package/dist/cli/notes/select-command.js +84 -0
  273. package/dist/cli/notes/suggest-diff.d.ts +56 -0
  274. package/dist/cli/notes/suggest-diff.js +311 -0
  275. package/dist/cli/notes/toc.d.ts +38 -0
  276. package/dist/cli/notes/toc.js +144 -0
  277. package/dist/cli/notes/transfer-command.d.ts +6 -0
  278. package/dist/cli/notes/transfer-command.js +9 -0
  279. package/dist/cli/notes/version-commands.d.ts +19 -0
  280. package/dist/cli/notes/version-commands.js +178 -0
  281. package/dist/cli/nymph/index.d.ts +74 -0
  282. package/dist/cli/nymph/index.js +349 -0
  283. package/dist/cli/org/index.d.ts +34 -0
  284. package/dist/cli/org/index.js +341 -0
  285. package/dist/cli/ownership/index.d.ts +12 -0
  286. package/dist/cli/ownership/index.js +122 -0
  287. package/dist/cli/ownership/metadata-transfer.d.ts +20 -0
  288. package/dist/cli/ownership/metadata-transfer.js +159 -0
  289. package/dist/cli/page/index.d.ts +58 -0
  290. package/dist/cli/page/index.js +387 -0
  291. package/dist/cli/pipeline/index.d.ts +69 -0
  292. package/dist/cli/pipeline/index.js +604 -0
  293. package/dist/cli/progress.d.ts +60 -0
  294. package/dist/cli/progress.js +276 -0
  295. package/dist/cli/project/attachments.d.ts +10 -0
  296. package/dist/cli/project/attachments.js +39 -0
  297. package/dist/cli/project/grants.d.ts +10 -0
  298. package/dist/cli/project/grants.js +39 -0
  299. package/dist/cli/project/index.d.ts +8 -0
  300. package/dist/cli/project/index.js +92 -0
  301. package/dist/cli/project/move.d.ts +57 -0
  302. package/dist/cli/project/move.js +242 -0
  303. package/dist/cli/project/output.d.ts +2 -0
  304. package/dist/cli/project/output.js +29 -0
  305. package/dist/cli/project/stream.d.ts +55 -0
  306. package/dist/cli/project/stream.js +207 -0
  307. package/dist/cli/project/transfer-preview.d.ts +8 -0
  308. package/dist/cli/project/transfer-preview.js +10 -0
  309. package/dist/cli/prompt.d.ts +1 -0
  310. package/dist/cli/prompt.js +17 -0
  311. package/dist/cli/provider/dreamdir.d.ts +52 -0
  312. package/dist/cli/provider/dreamdir.js +138 -0
  313. package/dist/cli/provider/index.d.ts +4 -0
  314. package/dist/cli/provider/index.js +419 -0
  315. package/dist/cli/provider/jump-worker.d.ts +9 -0
  316. package/dist/cli/provider/jump-worker.js +141 -0
  317. package/dist/cli/provider/lifecycle.d.ts +149 -0
  318. package/dist/cli/provider/lifecycle.js +1390 -0
  319. package/dist/cli/provider/machine.d.ts +17 -0
  320. package/dist/cli/provider/machine.js +116 -0
  321. package/dist/cli/provider/ssh.d.ts +105 -0
  322. package/dist/cli/provider/ssh.js +305 -0
  323. package/dist/cli/provider/terraform.d.ts +140 -0
  324. package/dist/cli/provider/terraform.js +288 -0
  325. package/dist/cli/providers/index.d.ts +18 -0
  326. package/dist/cli/providers/index.js +422 -0
  327. package/dist/cli/python.d.ts +61 -0
  328. package/dist/cli/python.js +255 -0
  329. package/dist/cli/queues/index.d.ts +33 -0
  330. package/dist/cli/queues/index.js +248 -0
  331. package/dist/cli/queues/slurm.d.ts +10 -0
  332. package/dist/cli/queues/slurm.js +134 -0
  333. package/dist/cli/resources.d.ts +72 -0
  334. package/dist/cli/resources.js +137 -0
  335. package/dist/cli/run/index.d.ts +15 -0
  336. package/dist/cli/run/index.js +163 -0
  337. package/dist/cli/run/input.d.ts +34 -0
  338. package/dist/cli/run/input.js +135 -0
  339. package/dist/cli/run/recovery.d.ts +2 -0
  340. package/dist/cli/run/recovery.js +18 -0
  341. package/dist/cli/run/setup.d.ts +3 -0
  342. package/dist/cli/run/setup.js +62 -0
  343. package/dist/cli/runconfig/index.d.ts +12 -0
  344. package/dist/cli/runconfig/index.js +130 -0
  345. package/dist/cli/runnable/index.d.ts +35 -0
  346. package/dist/cli/runnable/index.js +575 -0
  347. package/dist/cli/runnable/path.d.ts +115 -0
  348. package/dist/cli/runnable/path.js +288 -0
  349. package/dist/cli/runnable/run.d.ts +91 -0
  350. package/dist/cli/runnable/run.js +239 -0
  351. package/dist/cli/runnable/upload.d.ts +43 -0
  352. package/dist/cli/runnable/upload.js +342 -0
  353. package/dist/cli/runnable/worker.d.ts +1 -0
  354. package/dist/cli/runnable/worker.js +44 -0
  355. package/dist/cli/schemas/workflow-spec.schema.json +335 -0
  356. package/dist/cli/self-update/index.d.ts +5 -0
  357. package/dist/cli/self-update/index.js +107 -0
  358. package/dist/cli/self-update/install.d.ts +60 -0
  359. package/dist/cli/self-update/install.js +428 -0
  360. package/dist/cli/self-update/paths.d.ts +40 -0
  361. package/dist/cli/self-update/paths.js +87 -0
  362. package/dist/cli/self-update/releases.d.ts +41 -0
  363. package/dist/cli/self-update/releases.js +153 -0
  364. package/dist/cli/self-update/settings.d.ts +16 -0
  365. package/dist/cli/self-update/settings.js +68 -0
  366. package/dist/cli/self-update/update.d.ts +18 -0
  367. package/dist/cli/self-update/update.js +241 -0
  368. package/dist/cli/service-accounts/index.d.ts +3 -0
  369. package/dist/cli/service-accounts/index.js +149 -0
  370. package/dist/cli/session-affiliation.d.ts +26 -0
  371. package/dist/cli/session-affiliation.js +135 -0
  372. package/dist/cli/sessions/affiliation.d.ts +8 -0
  373. package/dist/cli/sessions/affiliation.js +66 -0
  374. package/dist/cli/sessions/api.d.ts +55 -0
  375. package/dist/cli/sessions/api.js +88 -0
  376. package/dist/cli/sessions/control.d.ts +6 -0
  377. package/dist/cli/sessions/control.js +159 -0
  378. package/dist/cli/sessions/conversation.d.ts +15 -0
  379. package/dist/cli/sessions/conversation.js +118 -0
  380. package/dist/cli/sessions/index.d.ts +2 -0
  381. package/dist/cli/sessions/index.js +209 -0
  382. package/dist/cli/sessions/managed.d.ts +39 -0
  383. package/dist/cli/sessions/managed.js +63 -0
  384. package/dist/cli/sessions/redaction.d.ts +2 -0
  385. package/dist/cli/sessions/redaction.js +11 -0
  386. package/dist/cli/sessions/runner/exec.d.ts +108 -0
  387. package/dist/cli/sessions/runner/exec.js +335 -0
  388. package/dist/cli/sessions/runner/journal.d.ts +26 -0
  389. package/dist/cli/sessions/runner/journal.js +49 -0
  390. package/dist/cli/sessions/runner/native.d.ts +48 -0
  391. package/dist/cli/sessions/runner/native.js +170 -0
  392. package/dist/cli/sessions/runner/pod.d.ts +30 -0
  393. package/dist/cli/sessions/runner/pod.js +129 -0
  394. package/dist/cli/sessions/runner/serve.d.ts +85 -0
  395. package/dist/cli/sessions/runner/serve.js +558 -0
  396. package/dist/cli/sessions/sync.d.ts +47 -0
  397. package/dist/cli/sessions/sync.js +80 -0
  398. package/dist/cli/sessions/transport.d.ts +14 -0
  399. package/dist/cli/sessions/transport.js +116 -0
  400. package/dist/cli/share.d.ts +15 -0
  401. package/dist/cli/share.js +139 -0
  402. package/dist/cli/skill/catalog.d.ts +141 -0
  403. package/dist/cli/skill/catalog.js +442 -0
  404. package/dist/cli/skill/files.d.ts +89 -0
  405. package/dist/cli/skill/files.js +264 -0
  406. package/dist/cli/skill/index.d.ts +268 -0
  407. package/dist/cli/skill/index.js +1216 -0
  408. package/dist/cli/skill/manifest.d.ts +30 -0
  409. package/dist/cli/skill/manifest.js +101 -0
  410. package/dist/cli/skill/prefs.d.ts +9 -0
  411. package/dist/cli/skill/prefs.js +32 -0
  412. package/dist/cli/skill/reminders.d.ts +15 -0
  413. package/dist/cli/skill/reminders.js +105 -0
  414. package/dist/cli/skill/tar.d.ts +17 -0
  415. package/dist/cli/skill/tar.js +195 -0
  416. package/dist/cli/snapshot/index.d.ts +24 -0
  417. package/dist/cli/snapshot/index.js +146 -0
  418. package/dist/cli/source/access.d.ts +45 -0
  419. package/dist/cli/source/access.js +563 -0
  420. package/dist/cli/source/control.d.ts +103 -0
  421. package/dist/cli/source/control.js +546 -0
  422. package/dist/cli/source/delete.d.ts +89 -0
  423. package/dist/cli/source/delete.js +463 -0
  424. package/dist/cli/source/index.d.ts +288 -0
  425. package/dist/cli/source/index.js +1348 -0
  426. package/dist/cli/source/share.d.ts +65 -0
  427. package/dist/cli/source/share.js +530 -0
  428. package/dist/cli/source/upload.d.ts +62 -0
  429. package/dist/cli/source/upload.js +258 -0
  430. package/dist/cli/source/write.d.ts +77 -0
  431. package/dist/cli/source/write.js +335 -0
  432. package/dist/cli/spawn.d.ts +28 -0
  433. package/dist/cli/spawn.js +81 -0
  434. package/dist/cli/target.d.ts +22 -0
  435. package/dist/cli/target.js +85 -0
  436. package/dist/cli/tasks/index.d.ts +38 -0
  437. package/dist/cli/tasks/index.js +365 -0
  438. package/dist/cli/team/index.d.ts +37 -0
  439. package/dist/cli/team/index.js +407 -0
  440. package/dist/cli/telemetry.d.ts +23 -0
  441. package/dist/cli/telemetry.js +262 -0
  442. package/dist/cli/telemetryJournal.d.ts +26 -0
  443. package/dist/cli/telemetryJournal.js +104 -0
  444. package/dist/cli/update/index.d.ts +21 -0
  445. package/dist/cli/update/index.js +284 -0
  446. package/dist/cli/upload/index.d.ts +11 -0
  447. package/dist/cli/upload/index.js +261 -0
  448. package/dist/cli/upload/kinds.d.ts +10 -0
  449. package/dist/cli/upload/kinds.js +85 -0
  450. package/dist/cli/upload/multipart.d.ts +21 -0
  451. package/dist/cli/upload/multipart.js +248 -0
  452. package/dist/cli/vault/affected-preview.d.ts +15 -0
  453. package/dist/cli/vault/affected-preview.js +38 -0
  454. package/dist/cli/vault/cloud.d.ts +55 -0
  455. package/dist/cli/vault/cloud.js +287 -0
  456. package/dist/cli/vault/format.d.ts +18 -0
  457. package/dist/cli/vault/format.js +104 -0
  458. package/dist/cli/vault/hostCredentials.d.ts +21 -0
  459. package/dist/cli/vault/hostCredentials.js +71 -0
  460. package/dist/cli/vault/hostSupersessions.d.ts +18 -0
  461. package/dist/cli/vault/hostSupersessions.js +68 -0
  462. package/dist/cli/vault/import.d.ts +3 -0
  463. package/dist/cli/vault/import.js +79 -0
  464. package/dist/cli/vault/index.d.ts +14 -0
  465. package/dist/cli/vault/index.js +225 -0
  466. package/dist/cli/vault/keys.d.ts +5 -0
  467. package/dist/cli/vault/keys.js +165 -0
  468. package/dist/cli/vault/kms.d.ts +6 -0
  469. package/dist/cli/vault/kms.js +169 -0
  470. package/dist/cli/vault/list.d.ts +13 -0
  471. package/dist/cli/vault/list.js +60 -0
  472. package/dist/cli/vault/listView.d.ts +21 -0
  473. package/dist/cli/vault/listView.js +123 -0
  474. package/dist/cli/vault/managementMetadata.d.ts +2 -0
  475. package/dist/cli/vault/managementMetadata.js +23 -0
  476. package/dist/cli/vault/mutations.d.ts +8 -0
  477. package/dist/cli/vault/mutations.js +151 -0
  478. package/dist/cli/vault/otp.d.ts +6 -0
  479. package/dist/cli/vault/otp.js +62 -0
  480. package/dist/cli/vault/otpIntent.d.ts +23 -0
  481. package/dist/cli/vault/otpIntent.js +76 -0
  482. package/dist/cli/vault/passImport.d.ts +25 -0
  483. package/dist/cli/vault/passImport.js +129 -0
  484. package/dist/cli/vault/passOtp.d.ts +51 -0
  485. package/dist/cli/vault/passOtp.js +101 -0
  486. package/dist/cli/vault/passStore.d.ts +26 -0
  487. package/dist/cli/vault/passStore.js +134 -0
  488. package/dist/cli/vault/passwordCommand.d.ts +39 -0
  489. package/dist/cli/vault/passwordCommand.js +101 -0
  490. package/dist/cli/vault/passwordProbe.d.ts +27 -0
  491. package/dist/cli/vault/passwordProbe.js +282 -0
  492. package/dist/cli/vault/passwordRotation.d.ts +9 -0
  493. package/dist/cli/vault/passwordRotation.js +273 -0
  494. package/dist/cli/vault/rotationApi.d.ts +13 -0
  495. package/dist/cli/vault/rotationApi.js +58 -0
  496. package/dist/cli/vault/rotationCommand.d.ts +2 -0
  497. package/dist/cli/vault/rotationCommand.js +75 -0
  498. package/dist/cli/vault/rotationEngine.d.ts +19 -0
  499. package/dist/cli/vault/rotationEngine.js +65 -0
  500. package/dist/cli/vault/rotationHelperSource.d.ts +2 -0
  501. package/dist/cli/vault/rotationHelperSource.js +3 -0
  502. package/dist/cli/vault/rotationInput.d.ts +11 -0
  503. package/dist/cli/vault/rotationInput.js +48 -0
  504. package/dist/cli/vault/rotationJournal.d.ts +16 -0
  505. package/dist/cli/vault/rotationJournal.js +183 -0
  506. package/dist/cli/vault/rotationKeys.d.ts +4 -0
  507. package/dist/cli/vault/rotationKeys.js +48 -0
  508. package/dist/cli/vault/rotationPrepare.d.ts +17 -0
  509. package/dist/cli/vault/rotationPrepare.js +108 -0
  510. package/dist/cli/vault/rotationRemote.d.ts +33 -0
  511. package/dist/cli/vault/rotationRemote.js +156 -0
  512. package/dist/cli/vault/rotationState.d.ts +42 -0
  513. package/dist/cli/vault/rotationState.js +115 -0
  514. package/dist/cli/vault/rotationTransport.d.ts +18 -0
  515. package/dist/cli/vault/rotationTransport.js +71 -0
  516. package/dist/cli/vault/sshSource.d.ts +18 -0
  517. package/dist/cli/vault/sshSource.js +196 -0
  518. package/dist/cli/vault/sshSync.d.ts +17 -0
  519. package/dist/cli/vault/sshSync.js +224 -0
  520. package/dist/cli/vault/sshTransfer.d.ts +22 -0
  521. package/dist/cli/vault/sshTransfer.js +140 -0
  522. package/dist/cli/vault/terraformState.d.ts +66 -0
  523. package/dist/cli/vault/terraformState.js +252 -0
  524. package/dist/cli/vault/terraformStateCommand.d.ts +2 -0
  525. package/dist/cli/vault/terraformStateCommand.js +61 -0
  526. package/dist/cli/vault/tree.d.ts +43 -0
  527. package/dist/cli/vault/tree.js +292 -0
  528. package/dist/cli/version.d.ts +1 -0
  529. package/dist/cli/version.js +9 -0
  530. package/dist/cli/workflow/index.d.ts +76 -0
  531. package/dist/cli/workflow/index.js +826 -0
  532. package/dist/cli/workflow/validate.d.ts +19 -0
  533. package/dist/cli/workflow/validate.js +353 -0
  534. package/dist/package.json +1 -0
  535. package/package.json +28 -10
@@ -0,0 +1,442 @@
1
+ // Where skills come from.
2
+ //
3
+ // Two sources, both producing the same in-memory `SkillPayload`:
4
+ //
5
+ // embedded — the one skill (`dreamlake-cli`) the CLI carries for offline
6
+ // use. In a release binary it is the `DREAMLAKE_EMBEDDED_*`
7
+ // defines the build injects; in a source or npm run it is the
8
+ // `skills/` directory next to the package (or
9
+ // `DREAMLAKE_SKILLS_DIR`) as `scripts/fetch-skills.mjs` writes
10
+ // it: `dreamlake-cli/` plus the side files `.manifest.json`
11
+ // (tag, commit, per-file sha256) and `catalog.json` (the
12
+ // snapshot). The same two files travel in the npm package, so
13
+ // a source run, an npm install and a release binary all report
14
+ // the same version; tests point the env at fixtures and never
15
+ // need the network.
16
+ // catalog — the public dreamlake-skills release: `catalog.json` lists
17
+ // every skill, its description and `requires`; `skills.tar.gz`
18
+ // holds the directories. `DREAMLAKE_SKILLS_RELEASE_URL` points
19
+ // at a mirror, or at a local directory holding both files.
20
+ //
21
+ // Nothing here writes to disk. The installer in index.ts decides what to do
22
+ // with a payload; this file only says what a payload is and where it is.
23
+ import { existsSync, readFileSync, readdirSync, statSync } from "node:fs";
24
+ import path from "node:path";
25
+ import { fileURLToPath } from "node:url";
26
+ import { sha256, walkFiles } from "./files.js";
27
+ import { readTarGz } from "./tar.js";
28
+ export const SKILLS_ENV = "DREAMLAKE_SKILLS_DIR";
29
+ export const MANIFEST_ENV = "DREAMLAKE_SKILLS_MANIFEST_FILE";
30
+ export const CATALOG_ENV = "DREAMLAKE_SKILLS_CATALOG_FILE";
31
+ export const RELEASE_ENV = "DREAMLAKE_SKILLS_RELEASE_URL";
32
+ export const RELEASE_BASE = "https://github.com/dreamlake-ai/dreamlake-skills/releases";
33
+ export const EMBEDDED_ROOT = "embedded-skills";
34
+ export const EMBEDDED_SKILL = "dreamlake-cli";
35
+ /** The release asset holding every skill directory. */
36
+ export const TARBALL_ASSET = "skills.tar.gz";
37
+ const embedded = typeof DREAMLAKE_EMBEDDED_SKILLS === "undefined" ? null : DREAMLAKE_EMBEDDED_SKILLS;
38
+ const embeddedManifestDefine = typeof DREAMLAKE_EMBEDDED_SKILLS_MANIFEST === "undefined"
39
+ ? null : DREAMLAKE_EMBEDDED_SKILLS_MANIFEST;
40
+ const embeddedCatalogDefine = typeof DREAMLAKE_EMBEDDED_CATALOG === "undefined"
41
+ ? null : DREAMLAKE_EMBEDDED_CATALOG;
42
+ /**
43
+ * Side files `scripts/fetch-skills.mjs` leaves beside the skill directory.
44
+ * The names are a contract with that script and with `scripts/native-skills.ts`,
45
+ * which embeds the same manifest; change all three together.
46
+ */
47
+ export const BUNDLE_MANIFEST_FILE = ".manifest.json";
48
+ export const BUNDLE_CATALOG_FILE = "catalog.json";
49
+ // ─── the embedded bundle ─────────────────────────────────────────────────────
50
+ //
51
+ // Resolved relative to THIS MODULE, never to cwd, so it works identically
52
+ // under `tsx src/cli/index.ts` (module at src/cli/skill/) and under
53
+ // `node dist/cli/index.js` (module at dist/cli/skill/). Both are three levels
54
+ // below the package root, and `skills/` sits at the package root beside
55
+ // `dist/`. `skills` must be in package.json's `files` array or the published
56
+ // npm tarball carries nothing to install.
57
+ function isDir(p) {
58
+ try {
59
+ return statSync(p).isDirectory();
60
+ }
61
+ catch {
62
+ return false;
63
+ }
64
+ }
65
+ export function resolveBundleDir() {
66
+ const fromEnv = process.env[SKILLS_ENV];
67
+ if (fromEnv)
68
+ return isDir(fromEnv) ? path.resolve(fromEnv) : null;
69
+ if (embedded)
70
+ return EMBEDDED_ROOT;
71
+ const here = path.dirname(fileURLToPath(import.meta.url));
72
+ // src/cli/skill → ../../.. · dist/cli/skill → ../../..
73
+ const candidates = [path.resolve(here, "..", "..", "..", "skills")];
74
+ // Walk up as a fallback: a bundler that flattens the tree, or a future
75
+ // layout change, must not silently break the installer.
76
+ let cur = here;
77
+ for (let i = 0; i < 6; i += 1) {
78
+ const parent = path.dirname(cur);
79
+ if (parent === cur)
80
+ break;
81
+ candidates.push(path.join(parent, "skills"));
82
+ cur = parent;
83
+ }
84
+ for (const c of candidates)
85
+ if (isDir(c))
86
+ return c;
87
+ return null;
88
+ }
89
+ function usingDefine(bundleDir) {
90
+ return bundleDir === EMBEDDED_ROOT && embedded !== null;
91
+ }
92
+ /**
93
+ * Bundled skill names — directories only. A loose `.md` is not a skill, and
94
+ * neither is a dot-directory (the fetch script stages into one before it
95
+ * swaps the real directory in).
96
+ */
97
+ export function listBundledSkills(bundleDir) {
98
+ if (usingDefine(bundleDir)) {
99
+ return [...new Set(Object.keys(embedded).map((key) => key.split("/")[0]))].sort();
100
+ }
101
+ return readdirSync(bundleDir, { withFileTypes: true })
102
+ .filter((e) => e.isDirectory() && !e.name.startsWith("."))
103
+ .map((e) => e.name)
104
+ .sort();
105
+ }
106
+ export function bundledFiles(bundleDir, name) {
107
+ if (usingDefine(bundleDir)) {
108
+ const prefix = `${name}/`;
109
+ return Object.keys(embedded).filter((key) => key.startsWith(prefix))
110
+ .map((key) => key.slice(prefix.length)).sort();
111
+ }
112
+ return walkFiles(path.join(bundleDir, name));
113
+ }
114
+ export function bundledBytes(bundleDir, name, rel) {
115
+ if (usingDefine(bundleDir))
116
+ return Buffer.from(embedded[`${name}/${rel}`], "base64");
117
+ return readFileSync(path.join(bundleDir, name, rel));
118
+ }
119
+ function readJsonFile(file) {
120
+ return JSON.parse(readFileSync(file, "utf8"));
121
+ }
122
+ /**
123
+ * The embedded manifest: tag, commit and per-file hashes of the bundled
124
+ * skill. From the define, else `DREAMLAKE_SKILLS_MANIFEST_FILE`, else
125
+ * `<bundle>/.manifest.json`, else computed from the files with no version.
126
+ */
127
+ export function embeddedManifest(bundleDir = resolveBundleDir()) {
128
+ if (!bundleDir)
129
+ return null;
130
+ const declared = declaredManifest(bundleDir);
131
+ if (declared)
132
+ return declared;
133
+ const files = {};
134
+ for (const name of listBundledSkills(bundleDir)) {
135
+ for (const rel of bundledFiles(bundleDir, name))
136
+ files[`${name}/${rel}`] = sha256(bundledBytes(bundleDir, name, rel));
137
+ }
138
+ return { tag: null, commit: null, files };
139
+ }
140
+ /** The manifest as declared (define, env file, side file) — no hashing, so cheap at startup. */
141
+ function declaredManifest(bundleDir) {
142
+ const fromEnv = process.env[MANIFEST_ENV];
143
+ if (fromEnv)
144
+ return normalizeEmbeddedManifest(readJsonFile(fromEnv));
145
+ if (usingDefine(bundleDir))
146
+ return embeddedManifestDefine ? normalizeEmbeddedManifest(embeddedManifestDefine) : null;
147
+ const side = path.join(bundleDir, BUNDLE_MANIFEST_FILE);
148
+ return existsSync(side) ? normalizeEmbeddedManifest(readJsonFile(side)) : null;
149
+ }
150
+ function normalizeEmbeddedManifest(raw) {
151
+ if (!raw || typeof raw !== "object")
152
+ throw new Error("embedded skills manifest is not an object");
153
+ const m = raw;
154
+ const files = m.files && typeof m.files === "object" && !Array.isArray(m.files)
155
+ ? Object.fromEntries(Object.entries(m.files).filter(([, v]) => typeof v === "string"))
156
+ : {};
157
+ return {
158
+ tag: typeof m.tag === "string" ? m.tag : null,
159
+ commit: typeof m.commit === "string" ? m.commit : null,
160
+ files,
161
+ };
162
+ }
163
+ /** The version the embedded bundle was cut from: its tag, else its commit. */
164
+ export function embeddedVersion(bundleDir = resolveBundleDir()) {
165
+ try {
166
+ if (!bundleDir)
167
+ return null;
168
+ const m = declaredManifest(bundleDir);
169
+ return m?.tag ?? m?.commit ?? null;
170
+ }
171
+ catch {
172
+ return null;
173
+ }
174
+ }
175
+ /**
176
+ * The catalog snapshot the CLI carries. From the define, else
177
+ * `DREAMLAKE_SKILLS_CATALOG_FILE`, else `<bundle>/catalog.json`, else null.
178
+ */
179
+ export function embeddedCatalog(bundleDir = resolveBundleDir()) {
180
+ const fromEnv = process.env[CATALOG_ENV];
181
+ if (fromEnv)
182
+ return normalizeCatalog(readJsonFile(fromEnv));
183
+ if (bundleDir && usingDefine(bundleDir)) {
184
+ return embeddedCatalogDefine ? normalizeCatalog(embeddedCatalogDefine) : null;
185
+ }
186
+ if (bundleDir) {
187
+ const side = path.join(bundleDir, BUNDLE_CATALOG_FILE);
188
+ if (existsSync(side))
189
+ return normalizeCatalog(readJsonFile(side));
190
+ }
191
+ return null;
192
+ }
193
+ export function embeddedPayload(bundleDir, name) {
194
+ const files = new Map();
195
+ for (const rel of bundledFiles(bundleDir, name))
196
+ files.set(rel, bundledBytes(bundleDir, name, rel));
197
+ return { name, version: embeddedVersion(bundleDir), source: "embedded", files };
198
+ }
199
+ // ─── catalog shape ───────────────────────────────────────────────────────────
200
+ export function normalizeCatalog(raw) {
201
+ if (!raw || typeof raw !== "object" || Array.isArray(raw))
202
+ throw new Error("catalog is not an object");
203
+ const c = raw;
204
+ if (typeof c.version !== "string" || c.version === "")
205
+ throw new Error("catalog has no version");
206
+ if (!c.skills || typeof c.skills !== "object" || Array.isArray(c.skills))
207
+ throw new Error("catalog has no skills");
208
+ const skills = {};
209
+ for (const [name, entry] of Object.entries(c.skills)) {
210
+ const e = (entry && typeof entry === "object" ? entry : {});
211
+ skills[name] = {
212
+ description: typeof e.description === "string" ? e.description : "",
213
+ requires: Array.isArray(e.requires) ? e.requires.filter((r) => typeof r === "string") : [],
214
+ ...(e.tools !== undefined ? { tools: e.tools } : {}),
215
+ ...(e.files !== undefined ? { files: e.files } : {}),
216
+ };
217
+ }
218
+ const renamed = {};
219
+ if (c.renamed && typeof c.renamed === "object" && !Array.isArray(c.renamed)) {
220
+ for (const [from, to] of Object.entries(c.renamed)) {
221
+ if (typeof to === "string")
222
+ renamed[from] = to;
223
+ }
224
+ }
225
+ const assets = normalizeAssets(c.assets);
226
+ return {
227
+ schema: typeof c.schema === "number" ? c.schema : 1,
228
+ version: c.version,
229
+ skills,
230
+ renamed,
231
+ ...(assets ? { assets } : {}),
232
+ };
233
+ }
234
+ const SHA256_HEX = /^[0-9a-f]{64}$/;
235
+ /** Keep only well-formed asset records; a malformed one counts as absent, never as a match. */
236
+ function normalizeAssets(raw) {
237
+ if (!raw || typeof raw !== "object" || Array.isArray(raw))
238
+ return null;
239
+ const out = {};
240
+ for (const [name, entry] of Object.entries(raw)) {
241
+ if (!entry || typeof entry !== "object" || Array.isArray(entry))
242
+ continue;
243
+ const e = entry;
244
+ const asset = {};
245
+ if (typeof e.sha256 === "string" && SHA256_HEX.test(e.sha256.toLowerCase()))
246
+ asset.sha256 = e.sha256.toLowerCase();
247
+ if (typeof e.bytes === "number" && Number.isInteger(e.bytes) && e.bytes >= 0)
248
+ asset.bytes = e.bytes;
249
+ if (asset.sha256 !== undefined || asset.bytes !== undefined)
250
+ out[name] = asset;
251
+ }
252
+ return Object.keys(out).length > 0 ? out : null;
253
+ }
254
+ /** File count a catalog entry advertises, when it does. */
255
+ export function catalogFileCount(entry) {
256
+ if (!entry)
257
+ return null;
258
+ if (Array.isArray(entry.files))
259
+ return entry.files.length;
260
+ if (typeof entry.files === "number")
261
+ return entry.files;
262
+ return null;
263
+ }
264
+ // ─── versions ────────────────────────────────────────────────────────────────
265
+ /** `v2026.10.27` and `2026.10.27` are the same release. */
266
+ export function versionsEqual(a, b) {
267
+ if (!a || !b)
268
+ return false;
269
+ return a.replace(/^v/, "") === b.replace(/^v/, "");
270
+ }
271
+ /** Display form: one leading `v` for a tag; a commit pin shows its first 12 hex digits. */
272
+ export function fmtVersion(v) {
273
+ if (!v)
274
+ return "unversioned";
275
+ if (/^[0-9a-f]{40}$/.test(v))
276
+ return v.slice(0, 12);
277
+ return v.startsWith("v") ? v : `v${v}`;
278
+ }
279
+ /** Parse a release tag `vYYYY.MM.DD[.N]` into a comparable tuple. Null for anything else. */
280
+ function parseDateTag(v) {
281
+ const m = /^v?(\d{4})\.(\d{1,2})\.(\d{1,2})(?:\.(\d+))?$/.exec(v);
282
+ if (!m)
283
+ return null;
284
+ return [Number(m[1]), Number(m[2]), Number(m[3]), Number(m[4] ?? 0)];
285
+ }
286
+ /**
287
+ * Order two versions. Identical strings (modulo the leading `v`) are the
288
+ * same version whatever their form, and two absent versions are too; two
289
+ * different release tags `vYYYY.MM.DD[.N]` order by date; anything else —
290
+ * a commit pin, an unknown format, one side missing — is not comparable,
291
+ * and the installer never guesses which is newer.
292
+ */
293
+ export function compareVersions(candidate, installed) {
294
+ const a = candidate || null;
295
+ const b = installed || null;
296
+ if (a === null || b === null)
297
+ return a === null && b === null ? 0 : null;
298
+ if (a.replace(/^v/, "") === b.replace(/^v/, ""))
299
+ return 0;
300
+ const pa = parseDateTag(a);
301
+ const pb = parseDateTag(b);
302
+ if (!pa || !pb)
303
+ return null;
304
+ for (let i = 0; i < pa.length; i += 1) {
305
+ if (pa[i] !== pb[i])
306
+ return pa[i] > pb[i] ? 1 : -1;
307
+ }
308
+ return 0;
309
+ }
310
+ /** True only when both are release tags and `candidate` is strictly newer. */
311
+ export function isNewerVersion(candidate, installed) {
312
+ return compareVersions(candidate, installed) === 1;
313
+ }
314
+ export class ReleaseError extends Error {
315
+ url;
316
+ kind;
317
+ constructor(message, url, kind = "catalog-unreachable") {
318
+ super(message);
319
+ this.url = url;
320
+ this.kind = kind;
321
+ }
322
+ }
323
+ export function releaseSource() {
324
+ const raw = process.env[RELEASE_ENV];
325
+ if (!raw)
326
+ return { kind: "http", base: RELEASE_BASE };
327
+ if (raw.startsWith("file://"))
328
+ return { kind: "dir", dir: fileURLToPath(raw) };
329
+ if (/^https?:\/\//i.test(raw))
330
+ return { kind: "http", base: raw.replace(/\/+$/, "") };
331
+ return { kind: "dir", dir: path.resolve(raw) };
332
+ }
333
+ export function catalogUrl(source = releaseSource()) {
334
+ return source.kind === "http"
335
+ ? `${source.base}/latest/download/catalog.json`
336
+ : path.join(source.dir, "catalog.json");
337
+ }
338
+ export function tarballUrl(version, source = releaseSource()) {
339
+ if (source.kind === "dir")
340
+ return path.join(source.dir, TARBALL_ASSET);
341
+ return version
342
+ ? `${source.base}/download/${encodeURIComponent(version)}/${TARBALL_ASSET}`
343
+ : `${source.base}/latest/download/${TARBALL_ASSET}`;
344
+ }
345
+ /** The address a person can download by hand when the CLI cannot. */
346
+ export function manualDownloadUrl(source = releaseSource()) {
347
+ return tarballUrl(null, source);
348
+ }
349
+ async function fetchBytes(url, timeoutMs) {
350
+ let res;
351
+ try {
352
+ res = await fetch(url, { redirect: "follow", signal: AbortSignal.timeout(timeoutMs) });
353
+ }
354
+ catch (err) {
355
+ throw new ReleaseError(`cannot reach ${url}: ${err.message}`, url);
356
+ }
357
+ if (!res.ok)
358
+ throw new ReleaseError(`${url} answered HTTP ${res.status}`, url);
359
+ return Buffer.from(await res.arrayBuffer());
360
+ }
361
+ function readLocal(file) {
362
+ try {
363
+ return readFileSync(file);
364
+ }
365
+ catch (err) {
366
+ const code = err.code;
367
+ throw new ReleaseError(`cannot read ${file}${code ? ` (${code})` : `: ${err.message}`}`, file);
368
+ }
369
+ }
370
+ /** The latest `catalog.json`. Throws `ReleaseError` when it cannot be had. */
371
+ export async function fetchLatestCatalog(source = releaseSource()) {
372
+ const url = catalogUrl(source);
373
+ const bytes = source.kind === "dir" ? readLocal(url) : await fetchBytes(url, 20_000);
374
+ try {
375
+ return normalizeCatalog(JSON.parse(bytes.toString("utf8")));
376
+ }
377
+ catch (err) {
378
+ throw new ReleaseError(`${url} is not a skills catalog: ${err.message}`, url);
379
+ }
380
+ }
381
+ /**
382
+ * `skills.tar.gz` for the catalog's version, falling back to the latest asset
383
+ * when the tagged one is missing. The release catalog must name the
384
+ * tarball's sha256 under `assets["skills.tar.gz"]`: without it nothing is
385
+ * downloaded, and a download whose bytes do not hash to it is refused. Both
386
+ * are a `ReleaseError` of kind `integrity`. (The committed catalog, and so
387
+ * the embedded snapshot, never carries `assets`; it is never used to fetch.)
388
+ */
389
+ export async function fetchSkillsTarball(catalog, source = releaseSource()) {
390
+ const version = catalog.version || null;
391
+ let url = tarballUrl(version, source);
392
+ const expected = catalog.assets?.[TARBALL_ASSET]?.sha256;
393
+ if (!expected) {
394
+ throw new ReleaseError(`release catalog carries no tarball checksum (assets["${TARBALL_ASSET}"].sha256), so ${url} cannot be verified`, url, "integrity");
395
+ }
396
+ let bytes;
397
+ if (source.kind === "dir") {
398
+ bytes = readLocal(url);
399
+ }
400
+ else {
401
+ try {
402
+ bytes = await fetchBytes(url, 120_000);
403
+ }
404
+ catch (err) {
405
+ if (!version)
406
+ throw err;
407
+ url = tarballUrl(null, source);
408
+ bytes = await fetchBytes(url, 120_000);
409
+ }
410
+ }
411
+ const actual = sha256(bytes);
412
+ if (actual !== expected) {
413
+ throw new ReleaseError(`${url} does not match the catalog: sha256 ${actual}, catalog says ${expected}`, url, "integrity");
414
+ }
415
+ return bytes;
416
+ }
417
+ /**
418
+ * Pull `names` out of a release tarball as payloads. The tarball's top-level
419
+ * entries are skill directories; anything else is ignored. A name missing
420
+ * from the archive is simply absent from the result.
421
+ */
422
+ export function extractSkills(tgz, names, version) {
423
+ const wanted = new Set(names);
424
+ const out = new Map();
425
+ for (const entry of readTarGz(tgz)) {
426
+ if (entry.type !== "file")
427
+ continue;
428
+ const slash = entry.path.indexOf("/");
429
+ if (slash === -1)
430
+ continue;
431
+ const name = entry.path.slice(0, slash);
432
+ if (!wanted.has(name))
433
+ continue;
434
+ let payload = out.get(name);
435
+ if (!payload) {
436
+ payload = { name, version, source: "catalog", files: new Map() };
437
+ out.set(name, payload);
438
+ }
439
+ payload.files.set(entry.path.slice(slash + 1), entry.data);
440
+ }
441
+ return out;
442
+ }
@@ -0,0 +1,89 @@
1
+ export type PathKind = "absent" | "file" | "dir" | "symlink" | "other";
2
+ /** What sits at `p`, without following a symlink. */
3
+ export declare function kindOf(p: string): PathKind;
4
+ export declare function sha256(data: Buffer | string): string;
5
+ export declare function hashFile(p: string): string;
6
+ /**
7
+ * Normalize an archive or manifest path. Returns `null` for anything that is
8
+ * not a plain relative file path: absolute paths, drive letters, `..`
9
+ * segments, backslashes, NULs. `./a/./b` becomes `a/b`.
10
+ */
11
+ export declare function safeRelativePath(raw: unknown): string | null;
12
+ export interface DirListing {
13
+ /** Regular files, forward-slash relative, sorted. */
14
+ files: string[];
15
+ /** Symlinks and anything else that is neither a file nor a directory. Never followed. */
16
+ others: string[];
17
+ }
18
+ /** Every entry under `dir`, never descending into a symlinked directory. */
19
+ export declare function listDir(dir: string, prefix?: string): DirListing;
20
+ /** Every regular file under `dir`, as forward-slash relative paths, sorted. */
21
+ export declare function walkFiles(dir: string): string[];
22
+ /**
23
+ * `p` with every symlink in its longest existing prefix resolved; the part
24
+ * that does not exist yet is appended as given. This is how a scope's skills
25
+ * directory is canonicalised once per command: a symlinked `~/.claude/skills`
26
+ * (a dotfiles setup) is followed to where it points, and every path derived
27
+ * from it is the real one.
28
+ */
29
+ export declare function resolveExisting(p: string): string;
30
+ /** True when `child` is exactly `<parent>/<one segment>`. */
31
+ export declare function isDirectChild(parent: string, child: string): boolean;
32
+ /** True when any directory between `root` and `root/rel` is a symlink. */
33
+ export declare function hasSymlinkAncestor(root: string, rel: string): boolean;
34
+ export declare class ContainmentError extends Error {
35
+ }
36
+ /**
37
+ * A skill directory as the installer is allowed to touch it. `skillDir` is
38
+ * the path addressed (a direct child of the scope's skills directory, which
39
+ * was itself resolved when the command began). `pinnedReal` is what that
40
+ * path resolved to at the same moment — its realpath when it existed, or
41
+ * the intended path below the resolved scope directory when it did not —
42
+ * and it is never recomputed: it is the one value every later write is
43
+ * checked against.
44
+ */
45
+ export interface OwnedDir {
46
+ skillDir: string;
47
+ pinnedReal: string;
48
+ }
49
+ /** Pin a skill directory: the descriptor every mutation under it must present. */
50
+ export declare function pinOwnedDir(skillDir: string): OwnedDir;
51
+ /**
52
+ * The one way the installer addresses a path under a skill directory. Runs
53
+ * in full on every call, `rel === ""` (the skill directory itself) included:
54
+ *
55
+ * - `rel` must be a plain relative path: already normalised, no `..`, not
56
+ * absolute, no backslash, no NUL.
57
+ * - (a) Every existing component from the pinned scope directory down to
58
+ * the target — the scope directory, the skill directory, each part of
59
+ * `rel` — is `lstat`ed and must not be a symlink.
60
+ * - (b) The realpath of the target's longest existing prefix must equal,
61
+ * as a string, the same-depth prefix of `pinnedReal/rel`. A parent
62
+ * swapped for a symlink after the pin was taken resolves elsewhere and
63
+ * is refused, however plausible the new place looks.
64
+ *
65
+ * Throws `ContainmentError`; never returns a path it did not prove.
66
+ */
67
+ export declare function safeTarget(owned: OwnedDir, rel: string): string;
68
+ /** `mkdir -p` of `rel` (a directory path; `""` for the skill directory itself) inside the owned directory. */
69
+ export declare function ensureOwnedDir(owned: OwnedDir, rel: string): string;
70
+ /** Write `bytes` at `rel` inside the owned directory, creating parent directories. Returns the absolute path. */
71
+ export declare function writeOwnedFile(owned: OwnedDir, rel: string, bytes: Buffer | string): string;
72
+ /** Unlink the regular file at `rel` inside the owned directory. Returns the absolute path. */
73
+ export declare function unlinkOwnedFile(owned: OwnedDir, rel: string): string;
74
+ /** Remove the directory at `rel` (`""` for the skill directory itself) when it is empty. True when removed. */
75
+ export declare function removeEmptyOwnedDir(owned: OwnedDir, rel: string): boolean;
76
+ /**
77
+ * Write one of the installer's own state files (preferences, reminder
78
+ * receipts) under the CLI state directory: the directory is created, a
79
+ * symlink at the file's path is refused rather than written through, and
80
+ * the bytes land atomically (a temporary file beside it, then rename) so a
81
+ * reader never sees a half-written file.
82
+ */
83
+ export declare function writeStateFile(file: string, data: string): void;
84
+ /**
85
+ * Remove now-empty parent directories of `rel` inside the owned directory,
86
+ * innermost first. The skill directory itself is removed only when
87
+ * `includeRoot` is set and it is empty.
88
+ */
89
+ export declare function pruneEmptyDirs(owned: OwnedDir, rel: string, includeRoot?: boolean): void;