@dreamlake/dreamlake-cli 0.88.1 → 0.90.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (541) hide show
  1. package/dist/api/access.d.ts +83 -0
  2. package/dist/api/access.js +77 -0
  3. package/dist/api/agent.d.ts +156 -0
  4. package/dist/api/agent.js +111 -0
  5. package/dist/api/browser.d.ts +90 -0
  6. package/dist/api/browser.js +102 -0
  7. package/dist/api/client.d.ts +54 -0
  8. package/dist/api/client.js +102 -0
  9. package/dist/api/common.d.ts +28 -0
  10. package/dist/api/common.js +16 -0
  11. package/dist/api/content.d.ts +195 -0
  12. package/dist/api/content.js +147 -0
  13. package/dist/api/execution.d.ts +84 -0
  14. package/dist/api/execution.js +73 -0
  15. package/dist/api/http.d.ts +19 -0
  16. package/dist/api/http.js +66 -0
  17. package/dist/api/index.d.ts +2362 -0
  18. package/dist/api/index.js +116 -0
  19. package/dist/api/infra.d.ts +2 -0
  20. package/dist/api/infra.js +2 -0
  21. package/dist/api/jobs.d.ts +2 -0
  22. package/dist/api/jobs.js +2 -0
  23. package/dist/api/layout.d.ts +2 -0
  24. package/dist/api/layout.js +2 -0
  25. package/dist/api/library-edit.d.ts +3 -0
  26. package/dist/api/library-edit.js +3 -0
  27. package/dist/api/library-manifest.d.ts +2 -0
  28. package/dist/api/library-manifest.js +2 -0
  29. package/dist/api/note-character-plan.d.ts +2 -0
  30. package/dist/api/note-character-plan.js +2 -0
  31. package/dist/api/note-editing.d.ts +2 -0
  32. package/dist/api/note-editing.js +2 -0
  33. package/dist/api/note-edits.d.ts +21 -0
  34. package/dist/api/note-edits.js +10 -0
  35. package/dist/api/note-events.d.ts +5 -0
  36. package/dist/api/note-events.js +11 -0
  37. package/dist/api/note-files.d.ts +102 -0
  38. package/dist/api/note-files.js +107 -0
  39. package/dist/api/note-html-read.d.ts +2 -0
  40. package/dist/api/note-html-read.js +2 -0
  41. package/dist/api/note-html.d.ts +2 -0
  42. package/dist/api/note-html.js +2 -0
  43. package/dist/api/note-linger.d.ts +83 -0
  44. package/dist/api/note-linger.js +270 -0
  45. package/dist/api/note-presence.d.ts +82 -0
  46. package/dist/api/note-presence.js +72 -0
  47. package/dist/api/note-toc.d.ts +2 -0
  48. package/dist/api/note-toc.js +2 -0
  49. package/dist/api/notes.d.ts +329 -0
  50. package/dist/api/notes.js +209 -0
  51. package/dist/api/open-resources.d.ts +27 -0
  52. package/dist/api/open-resources.js +102 -0
  53. package/dist/api/ownership.d.ts +12 -0
  54. package/dist/api/ownership.js +24 -0
  55. package/dist/api/platform.d.ts +83 -0
  56. package/dist/api/platform.js +56 -0
  57. package/dist/api/presigned-transfer.d.ts +2 -0
  58. package/dist/api/presigned-transfer.js +2 -0
  59. package/dist/api/registered-runs.d.ts +48 -0
  60. package/dist/api/registered-runs.js +33 -0
  61. package/dist/api/sessions.d.ts +299 -0
  62. package/dist/api/sessions.js +105 -0
  63. package/dist/api/storage.d.ts +46 -0
  64. package/dist/api/storage.js +34 -0
  65. package/dist/api/streams.d.ts +18 -0
  66. package/dist/api/streams.js +70 -0
  67. package/dist/api/vault.d.ts +93 -0
  68. package/dist/api/vault.js +79 -0
  69. package/dist/api/workspace.d.ts +180 -0
  70. package/dist/api/workspace.js +146 -0
  71. package/dist/cli/agent-identity.d.ts +4 -0
  72. package/dist/cli/agent-identity.js +21 -0
  73. package/dist/cli/agents/identity.d.ts +50 -0
  74. package/dist/cli/agents/identity.js +105 -0
  75. package/dist/cli/agents/index.d.ts +31 -0
  76. package/dist/cli/agents/index.js +580 -0
  77. package/dist/cli/agents/manage.d.ts +43 -0
  78. package/dist/cli/agents/manage.js +376 -0
  79. package/dist/cli/agents/spec.d.ts +104 -0
  80. package/dist/cli/agents/spec.js +280 -0
  81. package/dist/cli/agents/web.d.ts +7 -0
  82. package/dist/cli/agents/web.js +109 -0
  83. package/dist/cli/artifact/incremental.d.ts +21 -0
  84. package/dist/cli/artifact/incremental.js +80 -0
  85. package/dist/cli/artifact/index.d.ts +52 -0
  86. package/dist/cli/artifact/index.js +405 -0
  87. package/dist/cli/artifact/meta.d.ts +69 -0
  88. package/dist/cli/artifact/meta.js +189 -0
  89. package/dist/cli/auth/commands.d.ts +29 -0
  90. package/dist/cli/auth/commands.js +327 -0
  91. package/dist/cli/auth/constants.d.ts +13 -0
  92. package/dist/cli/auth/constants.js +18 -0
  93. package/dist/cli/auth/credentials.d.ts +37 -0
  94. package/dist/cli/auth/credentials.js +155 -0
  95. package/dist/cli/auth/device-flow.d.ts +32 -0
  96. package/dist/cli/auth/device-flow.js +154 -0
  97. package/dist/cli/auth/device-secret.d.ts +6 -0
  98. package/dist/cli/auth/device-secret.js +26 -0
  99. package/dist/cli/auth/machine.d.ts +15 -0
  100. package/dist/cli/auth/machine.js +126 -0
  101. package/dist/cli/auth/materialized.d.ts +32 -0
  102. package/dist/cli/auth/materialized.js +102 -0
  103. package/dist/cli/auth/migrate.d.ts +10 -0
  104. package/dist/cli/auth/migrate.js +75 -0
  105. package/dist/cli/client.d.ts +102 -0
  106. package/dist/cli/client.js +206 -0
  107. package/dist/cli/collection-list.d.ts +3 -0
  108. package/dist/cli/collection-list.js +25 -0
  109. package/dist/cli/compat/ctx.d.ts +26 -0
  110. package/dist/cli/compat/ctx.js +76 -0
  111. package/dist/cli/compat/dreamdb-wasm-embedded.d.ts +2 -0
  112. package/dist/cli/compat/dreamdb-wasm-embedded.js +8 -0
  113. package/dist/cli/compat/dreamdb-wasm.d.ts +1 -0
  114. package/dist/cli/compat/dreamdb-wasm.js +26 -0
  115. package/dist/cli/compat/dreamdb.d.ts +112 -0
  116. package/dist/cli/compat/dreamdb.js +219 -0
  117. package/dist/cli/compat/flags.d.ts +2 -0
  118. package/dist/cli/compat/flags.js +13 -0
  119. package/dist/cli/compat/http.d.ts +23 -0
  120. package/dist/cli/compat/http.js +137 -0
  121. package/dist/cli/compat/presignedTransfer.d.ts +139 -0
  122. package/dist/cli/compat/presignedTransfer.js +580 -0
  123. package/dist/cli/compat/s3-backend.d.ts +73 -0
  124. package/dist/cli/compat/s3-backend.js +132 -0
  125. package/dist/cli/config.d.ts +22 -0
  126. package/dist/cli/config.js +96 -0
  127. package/dist/cli/connection/dto.d.ts +159 -0
  128. package/dist/cli/connection/dto.js +497 -0
  129. package/dist/cli/connection/index.d.ts +50 -0
  130. package/dist/cli/connection/index.js +413 -0
  131. package/dist/cli/connection/oauth.d.ts +23 -0
  132. package/dist/cli/connection/oauth.js +290 -0
  133. package/dist/cli/connection/write.d.ts +47 -0
  134. package/dist/cli/connection/write.js +573 -0
  135. package/dist/cli/create/index.d.ts +19 -0
  136. package/dist/cli/create/index.js +209 -0
  137. package/dist/cli/declare/index.d.ts +29 -0
  138. package/dist/cli/declare/index.js +304 -0
  139. package/dist/cli/delete/index.d.ts +18 -0
  140. package/dist/cli/delete/index.js +232 -0
  141. package/dist/cli/download/index.d.ts +9 -0
  142. package/dist/cli/download/index.js +128 -0
  143. package/dist/cli/env/compose.d.ts +88 -0
  144. package/dist/cli/env/compose.js +402 -0
  145. package/dist/cli/env/index.d.ts +176 -0
  146. package/dist/cli/env/index.js +1011 -0
  147. package/dist/cli/experiments/index.d.ts +11 -0
  148. package/dist/cli/experiments/index.js +168 -0
  149. package/dist/cli/glob.d.ts +1 -0
  150. package/dist/cli/glob.js +45 -0
  151. package/dist/cli/graphql-helpers.d.ts +23 -0
  152. package/dist/cli/graphql-helpers.js +42 -0
  153. package/dist/cli/graphql.d.ts +10 -0
  154. package/dist/cli/graphql.js +47 -0
  155. package/dist/cli/help-examples.generated.d.ts +1 -0
  156. package/dist/cli/help-examples.generated.js +192 -0
  157. package/dist/cli/helpers.d.ts +8 -0
  158. package/dist/cli/helpers.js +106 -0
  159. package/dist/cli/hosts/api.d.ts +29 -0
  160. package/dist/cli/hosts/api.js +54 -0
  161. package/dist/cli/hosts/bootstrap-source.d.ts +1 -0
  162. package/dist/cli/hosts/bootstrap-source.js +2 -0
  163. package/dist/cli/hosts/catalog.d.ts +26 -0
  164. package/dist/cli/hosts/catalog.js +55 -0
  165. package/dist/cli/hosts/config.d.ts +45 -0
  166. package/dist/cli/hosts/config.js +179 -0
  167. package/dist/cli/hosts/credentials.d.ts +19 -0
  168. package/dist/cli/hosts/credentials.js +173 -0
  169. package/dist/cli/hosts/enroll.d.ts +17 -0
  170. package/dist/cli/hosts/enroll.js +109 -0
  171. package/dist/cli/hosts/enrollments.d.ts +25 -0
  172. package/dist/cli/hosts/enrollments.js +54 -0
  173. package/dist/cli/hosts/index.d.ts +6 -0
  174. package/dist/cli/hosts/index.js +279 -0
  175. package/dist/cli/hosts/inventory.d.ts +40 -0
  176. package/dist/cli/hosts/inventory.js +91 -0
  177. package/dist/cli/hosts/lifecycle.d.ts +15 -0
  178. package/dist/cli/hosts/lifecycle.js +108 -0
  179. package/dist/cli/hosts/metrics-source.d.ts +12 -0
  180. package/dist/cli/hosts/metrics-source.js +89 -0
  181. package/dist/cli/hosts/observations.d.ts +39 -0
  182. package/dist/cli/hosts/observations.js +102 -0
  183. package/dist/cli/hosts/remote.d.ts +5 -0
  184. package/dist/cli/hosts/remote.js +66 -0
  185. package/dist/cli/hosts/ssh.d.ts +63 -0
  186. package/dist/cli/hosts/ssh.js +276 -0
  187. package/dist/cli/index.d.ts +1 -0
  188. package/dist/cli/index.js +288 -0
  189. package/dist/cli/infra/api.d.ts +95 -0
  190. package/dist/cli/infra/api.js +291 -0
  191. package/dist/cli/infra/index.d.ts +5 -0
  192. package/dist/cli/infra/index.js +102 -0
  193. package/dist/cli/infra/move.d.ts +15 -0
  194. package/dist/cli/infra/move.js +123 -0
  195. package/dist/cli/infra/transfer.d.ts +15 -0
  196. package/dist/cli/infra/transfer.js +280 -0
  197. package/dist/cli/jobs/api.d.ts +69 -0
  198. package/dist/cli/jobs/api.js +121 -0
  199. package/dist/cli/jobs/index.d.ts +5 -0
  200. package/dist/cli/jobs/index.js +140 -0
  201. package/dist/cli/lakeshore/index.d.ts +98 -0
  202. package/dist/cli/lakeshore/index.js +502 -0
  203. package/dist/cli/launch/index.d.ts +43 -0
  204. package/dist/cli/launch/index.js +270 -0
  205. package/dist/cli/layout/index.d.ts +2 -0
  206. package/dist/cli/layout/index.js +44 -0
  207. package/dist/cli/layout/transport.d.ts +12 -0
  208. package/dist/cli/layout/transport.js +70 -0
  209. package/dist/cli/library/add.d.ts +60 -0
  210. package/dist/cli/library/add.js +348 -0
  211. package/dist/cli/library/cache.d.ts +26 -0
  212. package/dist/cli/library/cache.js +88 -0
  213. package/dist/cli/library/config.d.ts +75 -0
  214. package/dist/cli/library/config.js +198 -0
  215. package/dist/cli/library/digest.d.ts +5 -0
  216. package/dist/cli/library/digest.js +19 -0
  217. package/dist/cli/library/discover.d.ts +87 -0
  218. package/dist/cli/library/discover.js +534 -0
  219. package/dist/cli/library/freshness.d.ts +35 -0
  220. package/dist/cli/library/freshness.js +109 -0
  221. package/dist/cli/library/generation.d.ts +35 -0
  222. package/dist/cli/library/generation.js +211 -0
  223. package/dist/cli/library/index.d.ts +2 -0
  224. package/dist/cli/library/index.js +36 -0
  225. package/dist/cli/library/info.d.ts +69 -0
  226. package/dist/cli/library/info.js +311 -0
  227. package/dist/cli/library/list.d.ts +33 -0
  228. package/dist/cli/library/list.js +86 -0
  229. package/dist/cli/library/manifest.d.ts +81 -0
  230. package/dist/cli/library/manifest.js +200 -0
  231. package/dist/cli/library/manifestCache.d.ts +45 -0
  232. package/dist/cli/library/manifestCache.js +169 -0
  233. package/dist/cli/library/pull.d.ts +30 -0
  234. package/dist/cli/library/pull.js +438 -0
  235. package/dist/cli/library/push.d.ts +72 -0
  236. package/dist/cli/library/push.js +642 -0
  237. package/dist/cli/library/rm.d.ts +31 -0
  238. package/dist/cli/library/rm.js +200 -0
  239. package/dist/cli/library/search.d.ts +18 -0
  240. package/dist/cli/library/search.js +181 -0
  241. package/dist/cli/library/stat.d.ts +15 -0
  242. package/dist/cli/library/stat.js +127 -0
  243. package/dist/cli/library/tools.d.ts +104 -0
  244. package/dist/cli/library/tools.js +163 -0
  245. package/dist/cli/library/wire.d.ts +47 -0
  246. package/dist/cli/library/wire.js +120 -0
  247. package/dist/cli/list/index.d.ts +26 -0
  248. package/dist/cli/list/index.js +256 -0
  249. package/dist/cli/notes/api-transport.d.ts +5 -0
  250. package/dist/cli/notes/api-transport.js +20 -0
  251. package/dist/cli/notes/character-plan.d.ts +22 -0
  252. package/dist/cli/notes/character-plan.js +232 -0
  253. package/dist/cli/notes/document.d.ts +73 -0
  254. package/dist/cli/notes/document.js +306 -0
  255. package/dist/cli/notes/edit-commands.d.ts +106 -0
  256. package/dist/cli/notes/edit-commands.js +623 -0
  257. package/dist/cli/notes/editing.d.ts +81 -0
  258. package/dist/cli/notes/editing.js +305 -0
  259. package/dist/cli/notes/events.d.ts +36 -0
  260. package/dist/cli/notes/events.js +54 -0
  261. package/dist/cli/notes/files-commands.d.ts +97 -0
  262. package/dist/cli/notes/files-commands.js +548 -0
  263. package/dist/cli/notes/html-read.d.ts +9 -0
  264. package/dist/cli/notes/html-read.js +90 -0
  265. package/dist/cli/notes/html.d.ts +73 -0
  266. package/dist/cli/notes/html.js +381 -0
  267. package/dist/cli/notes/index.d.ts +123 -0
  268. package/dist/cli/notes/index.js +1300 -0
  269. package/dist/cli/notes/linger.d.ts +4 -0
  270. package/dist/cli/notes/linger.js +96 -0
  271. package/dist/cli/notes/media-commands.d.ts +5 -0
  272. package/dist/cli/notes/media-commands.js +51 -0
  273. package/dist/cli/notes/move-command.d.ts +83 -0
  274. package/dist/cli/notes/move-command.js +259 -0
  275. package/dist/cli/notes/rm-command.d.ts +22 -0
  276. package/dist/cli/notes/rm-command.js +110 -0
  277. package/dist/cli/notes/select-command.d.ts +12 -0
  278. package/dist/cli/notes/select-command.js +63 -0
  279. package/dist/cli/notes/suggest-diff.d.ts +56 -0
  280. package/dist/cli/notes/suggest-diff.js +311 -0
  281. package/dist/cli/notes/toc.d.ts +38 -0
  282. package/dist/cli/notes/toc.js +144 -0
  283. package/dist/cli/notes/transfer-command.d.ts +6 -0
  284. package/dist/cli/notes/transfer-command.js +9 -0
  285. package/dist/cli/notes/version-commands.d.ts +19 -0
  286. package/dist/cli/notes/version-commands.js +178 -0
  287. package/dist/cli/nymph/index.d.ts +74 -0
  288. package/dist/cli/nymph/index.js +349 -0
  289. package/dist/cli/org/index.d.ts +34 -0
  290. package/dist/cli/org/index.js +341 -0
  291. package/dist/cli/ownership/index.d.ts +12 -0
  292. package/dist/cli/ownership/index.js +122 -0
  293. package/dist/cli/ownership/metadata-transfer.d.ts +20 -0
  294. package/dist/cli/ownership/metadata-transfer.js +159 -0
  295. package/dist/cli/page/index.d.ts +58 -0
  296. package/dist/cli/page/index.js +387 -0
  297. package/dist/cli/pipeline/index.d.ts +69 -0
  298. package/dist/cli/pipeline/index.js +604 -0
  299. package/dist/cli/progress.d.ts +60 -0
  300. package/dist/cli/progress.js +276 -0
  301. package/dist/cli/project/attachments.d.ts +10 -0
  302. package/dist/cli/project/attachments.js +39 -0
  303. package/dist/cli/project/grants.d.ts +10 -0
  304. package/dist/cli/project/grants.js +39 -0
  305. package/dist/cli/project/index.d.ts +8 -0
  306. package/dist/cli/project/index.js +92 -0
  307. package/dist/cli/project/move.d.ts +57 -0
  308. package/dist/cli/project/move.js +242 -0
  309. package/dist/cli/project/output.d.ts +2 -0
  310. package/dist/cli/project/output.js +29 -0
  311. package/dist/cli/project/stream.d.ts +55 -0
  312. package/dist/cli/project/stream.js +207 -0
  313. package/dist/cli/project/transfer-preview.d.ts +8 -0
  314. package/dist/cli/project/transfer-preview.js +10 -0
  315. package/dist/cli/prompt.d.ts +1 -0
  316. package/dist/cli/prompt.js +17 -0
  317. package/dist/cli/provider/dreamdir.d.ts +52 -0
  318. package/dist/cli/provider/dreamdir.js +138 -0
  319. package/dist/cli/provider/index.d.ts +4 -0
  320. package/dist/cli/provider/index.js +419 -0
  321. package/dist/cli/provider/jump-worker.d.ts +9 -0
  322. package/dist/cli/provider/jump-worker.js +141 -0
  323. package/dist/cli/provider/lifecycle.d.ts +149 -0
  324. package/dist/cli/provider/lifecycle.js +1390 -0
  325. package/dist/cli/provider/machine.d.ts +17 -0
  326. package/dist/cli/provider/machine.js +116 -0
  327. package/dist/cli/provider/ssh.d.ts +105 -0
  328. package/dist/cli/provider/ssh.js +305 -0
  329. package/dist/cli/provider/terraform.d.ts +140 -0
  330. package/dist/cli/provider/terraform.js +288 -0
  331. package/dist/cli/providers/index.d.ts +18 -0
  332. package/dist/cli/providers/index.js +422 -0
  333. package/dist/cli/python.d.ts +61 -0
  334. package/dist/cli/python.js +255 -0
  335. package/dist/cli/queues/index.d.ts +33 -0
  336. package/dist/cli/queues/index.js +248 -0
  337. package/dist/cli/queues/slurm.d.ts +10 -0
  338. package/dist/cli/queues/slurm.js +134 -0
  339. package/dist/cli/resources.d.ts +72 -0
  340. package/dist/cli/resources.js +137 -0
  341. package/dist/cli/run/index.d.ts +15 -0
  342. package/dist/cli/run/index.js +163 -0
  343. package/dist/cli/run/input.d.ts +34 -0
  344. package/dist/cli/run/input.js +135 -0
  345. package/dist/cli/run/recovery.d.ts +2 -0
  346. package/dist/cli/run/recovery.js +18 -0
  347. package/dist/cli/run/setup.d.ts +3 -0
  348. package/dist/cli/run/setup.js +62 -0
  349. package/dist/cli/runconfig/index.d.ts +12 -0
  350. package/dist/cli/runconfig/index.js +130 -0
  351. package/dist/cli/runnable/index.d.ts +35 -0
  352. package/dist/cli/runnable/index.js +575 -0
  353. package/dist/cli/runnable/path.d.ts +115 -0
  354. package/dist/cli/runnable/path.js +288 -0
  355. package/dist/cli/runnable/run.d.ts +91 -0
  356. package/dist/cli/runnable/run.js +239 -0
  357. package/dist/cli/runnable/upload.d.ts +43 -0
  358. package/dist/cli/runnable/upload.js +342 -0
  359. package/dist/cli/runnable/worker.d.ts +1 -0
  360. package/dist/cli/runnable/worker.js +44 -0
  361. package/dist/cli/schemas/workflow-spec.schema.json +335 -0
  362. package/dist/cli/self-update/index.d.ts +5 -0
  363. package/dist/cli/self-update/index.js +107 -0
  364. package/dist/cli/self-update/install.d.ts +60 -0
  365. package/dist/cli/self-update/install.js +428 -0
  366. package/dist/cli/self-update/paths.d.ts +40 -0
  367. package/dist/cli/self-update/paths.js +87 -0
  368. package/dist/cli/self-update/releases.d.ts +41 -0
  369. package/dist/cli/self-update/releases.js +153 -0
  370. package/dist/cli/self-update/settings.d.ts +16 -0
  371. package/dist/cli/self-update/settings.js +68 -0
  372. package/dist/cli/self-update/update.d.ts +18 -0
  373. package/dist/cli/self-update/update.js +241 -0
  374. package/dist/cli/service-accounts/index.d.ts +3 -0
  375. package/dist/cli/service-accounts/index.js +149 -0
  376. package/dist/cli/session-affiliation.d.ts +26 -0
  377. package/dist/cli/session-affiliation.js +135 -0
  378. package/dist/cli/sessions/affiliation.d.ts +8 -0
  379. package/dist/cli/sessions/affiliation.js +66 -0
  380. package/dist/cli/sessions/api.d.ts +55 -0
  381. package/dist/cli/sessions/api.js +88 -0
  382. package/dist/cli/sessions/control.d.ts +6 -0
  383. package/dist/cli/sessions/control.js +159 -0
  384. package/dist/cli/sessions/conversation.d.ts +15 -0
  385. package/dist/cli/sessions/conversation.js +118 -0
  386. package/dist/cli/sessions/index.d.ts +2 -0
  387. package/dist/cli/sessions/index.js +209 -0
  388. package/dist/cli/sessions/managed.d.ts +39 -0
  389. package/dist/cli/sessions/managed.js +63 -0
  390. package/dist/cli/sessions/redaction.d.ts +2 -0
  391. package/dist/cli/sessions/redaction.js +11 -0
  392. package/dist/cli/sessions/runner/exec.d.ts +108 -0
  393. package/dist/cli/sessions/runner/exec.js +335 -0
  394. package/dist/cli/sessions/runner/journal.d.ts +26 -0
  395. package/dist/cli/sessions/runner/journal.js +49 -0
  396. package/dist/cli/sessions/runner/native.d.ts +48 -0
  397. package/dist/cli/sessions/runner/native.js +170 -0
  398. package/dist/cli/sessions/runner/pod.d.ts +30 -0
  399. package/dist/cli/sessions/runner/pod.js +129 -0
  400. package/dist/cli/sessions/runner/serve.d.ts +85 -0
  401. package/dist/cli/sessions/runner/serve.js +558 -0
  402. package/dist/cli/sessions/sync.d.ts +47 -0
  403. package/dist/cli/sessions/sync.js +80 -0
  404. package/dist/cli/sessions/transport.d.ts +14 -0
  405. package/dist/cli/sessions/transport.js +116 -0
  406. package/dist/cli/share.d.ts +15 -0
  407. package/dist/cli/share.js +139 -0
  408. package/dist/cli/skill/catalog.d.ts +141 -0
  409. package/dist/cli/skill/catalog.js +442 -0
  410. package/dist/cli/skill/files.d.ts +89 -0
  411. package/dist/cli/skill/files.js +264 -0
  412. package/dist/cli/skill/index.d.ts +268 -0
  413. package/dist/cli/skill/index.js +1216 -0
  414. package/dist/cli/skill/manifest.d.ts +30 -0
  415. package/dist/cli/skill/manifest.js +101 -0
  416. package/dist/cli/skill/prefs.d.ts +9 -0
  417. package/dist/cli/skill/prefs.js +32 -0
  418. package/dist/cli/skill/reminders.d.ts +15 -0
  419. package/dist/cli/skill/reminders.js +105 -0
  420. package/dist/cli/skill/tar.d.ts +17 -0
  421. package/dist/cli/skill/tar.js +195 -0
  422. package/dist/cli/snapshot/index.d.ts +24 -0
  423. package/dist/cli/snapshot/index.js +146 -0
  424. package/dist/cli/source/access.d.ts +45 -0
  425. package/dist/cli/source/access.js +563 -0
  426. package/dist/cli/source/control.d.ts +103 -0
  427. package/dist/cli/source/control.js +546 -0
  428. package/dist/cli/source/delete.d.ts +89 -0
  429. package/dist/cli/source/delete.js +463 -0
  430. package/dist/cli/source/index.d.ts +288 -0
  431. package/dist/cli/source/index.js +1348 -0
  432. package/dist/cli/source/share.d.ts +65 -0
  433. package/dist/cli/source/share.js +530 -0
  434. package/dist/cli/source/upload.d.ts +62 -0
  435. package/dist/cli/source/upload.js +258 -0
  436. package/dist/cli/source/write.d.ts +77 -0
  437. package/dist/cli/source/write.js +335 -0
  438. package/dist/cli/spawn.d.ts +28 -0
  439. package/dist/cli/spawn.js +81 -0
  440. package/dist/cli/target.d.ts +22 -0
  441. package/dist/cli/target.js +85 -0
  442. package/dist/cli/tasks/index.d.ts +38 -0
  443. package/dist/cli/tasks/index.js +365 -0
  444. package/dist/cli/team/index.d.ts +37 -0
  445. package/dist/cli/team/index.js +407 -0
  446. package/dist/cli/telemetry.d.ts +23 -0
  447. package/dist/cli/telemetry.js +262 -0
  448. package/dist/cli/telemetryJournal.d.ts +26 -0
  449. package/dist/cli/telemetryJournal.js +104 -0
  450. package/dist/cli/update/index.d.ts +21 -0
  451. package/dist/cli/update/index.js +284 -0
  452. package/dist/cli/upload/index.d.ts +11 -0
  453. package/dist/cli/upload/index.js +261 -0
  454. package/dist/cli/upload/kinds.d.ts +10 -0
  455. package/dist/cli/upload/kinds.js +85 -0
  456. package/dist/cli/upload/multipart.d.ts +21 -0
  457. package/dist/cli/upload/multipart.js +248 -0
  458. package/dist/cli/vault/affected-preview.d.ts +15 -0
  459. package/dist/cli/vault/affected-preview.js +38 -0
  460. package/dist/cli/vault/cloud.d.ts +55 -0
  461. package/dist/cli/vault/cloud.js +287 -0
  462. package/dist/cli/vault/format.d.ts +18 -0
  463. package/dist/cli/vault/format.js +104 -0
  464. package/dist/cli/vault/hostCredentials.d.ts +21 -0
  465. package/dist/cli/vault/hostCredentials.js +71 -0
  466. package/dist/cli/vault/hostSupersessions.d.ts +18 -0
  467. package/dist/cli/vault/hostSupersessions.js +68 -0
  468. package/dist/cli/vault/import.d.ts +3 -0
  469. package/dist/cli/vault/import.js +79 -0
  470. package/dist/cli/vault/index.d.ts +14 -0
  471. package/dist/cli/vault/index.js +225 -0
  472. package/dist/cli/vault/keys.d.ts +5 -0
  473. package/dist/cli/vault/keys.js +165 -0
  474. package/dist/cli/vault/kms.d.ts +6 -0
  475. package/dist/cli/vault/kms.js +169 -0
  476. package/dist/cli/vault/list.d.ts +13 -0
  477. package/dist/cli/vault/list.js +60 -0
  478. package/dist/cli/vault/listView.d.ts +21 -0
  479. package/dist/cli/vault/listView.js +123 -0
  480. package/dist/cli/vault/managementMetadata.d.ts +2 -0
  481. package/dist/cli/vault/managementMetadata.js +23 -0
  482. package/dist/cli/vault/mutations.d.ts +8 -0
  483. package/dist/cli/vault/mutations.js +151 -0
  484. package/dist/cli/vault/otp.d.ts +6 -0
  485. package/dist/cli/vault/otp.js +62 -0
  486. package/dist/cli/vault/otpIntent.d.ts +23 -0
  487. package/dist/cli/vault/otpIntent.js +76 -0
  488. package/dist/cli/vault/passImport.d.ts +25 -0
  489. package/dist/cli/vault/passImport.js +129 -0
  490. package/dist/cli/vault/passOtp.d.ts +51 -0
  491. package/dist/cli/vault/passOtp.js +101 -0
  492. package/dist/cli/vault/passStore.d.ts +26 -0
  493. package/dist/cli/vault/passStore.js +134 -0
  494. package/dist/cli/vault/passwordCommand.d.ts +39 -0
  495. package/dist/cli/vault/passwordCommand.js +101 -0
  496. package/dist/cli/vault/passwordProbe.d.ts +27 -0
  497. package/dist/cli/vault/passwordProbe.js +282 -0
  498. package/dist/cli/vault/passwordRotation.d.ts +9 -0
  499. package/dist/cli/vault/passwordRotation.js +273 -0
  500. package/dist/cli/vault/rotationApi.d.ts +13 -0
  501. package/dist/cli/vault/rotationApi.js +58 -0
  502. package/dist/cli/vault/rotationCommand.d.ts +2 -0
  503. package/dist/cli/vault/rotationCommand.js +75 -0
  504. package/dist/cli/vault/rotationEngine.d.ts +19 -0
  505. package/dist/cli/vault/rotationEngine.js +65 -0
  506. package/dist/cli/vault/rotationHelperSource.d.ts +2 -0
  507. package/dist/cli/vault/rotationHelperSource.js +3 -0
  508. package/dist/cli/vault/rotationInput.d.ts +11 -0
  509. package/dist/cli/vault/rotationInput.js +48 -0
  510. package/dist/cli/vault/rotationJournal.d.ts +16 -0
  511. package/dist/cli/vault/rotationJournal.js +183 -0
  512. package/dist/cli/vault/rotationKeys.d.ts +4 -0
  513. package/dist/cli/vault/rotationKeys.js +48 -0
  514. package/dist/cli/vault/rotationPrepare.d.ts +17 -0
  515. package/dist/cli/vault/rotationPrepare.js +108 -0
  516. package/dist/cli/vault/rotationRemote.d.ts +33 -0
  517. package/dist/cli/vault/rotationRemote.js +156 -0
  518. package/dist/cli/vault/rotationState.d.ts +42 -0
  519. package/dist/cli/vault/rotationState.js +115 -0
  520. package/dist/cli/vault/rotationTransport.d.ts +18 -0
  521. package/dist/cli/vault/rotationTransport.js +71 -0
  522. package/dist/cli/vault/sshSource.d.ts +18 -0
  523. package/dist/cli/vault/sshSource.js +196 -0
  524. package/dist/cli/vault/sshSync.d.ts +17 -0
  525. package/dist/cli/vault/sshSync.js +224 -0
  526. package/dist/cli/vault/sshTransfer.d.ts +22 -0
  527. package/dist/cli/vault/sshTransfer.js +140 -0
  528. package/dist/cli/vault/terraformState.d.ts +66 -0
  529. package/dist/cli/vault/terraformState.js +252 -0
  530. package/dist/cli/vault/terraformStateCommand.d.ts +2 -0
  531. package/dist/cli/vault/terraformStateCommand.js +61 -0
  532. package/dist/cli/vault/tree.d.ts +43 -0
  533. package/dist/cli/vault/tree.js +292 -0
  534. package/dist/cli/version.d.ts +1 -0
  535. package/dist/cli/version.js +9 -0
  536. package/dist/cli/workflow/index.d.ts +76 -0
  537. package/dist/cli/workflow/index.js +826 -0
  538. package/dist/cli/workflow/validate.d.ts +19 -0
  539. package/dist/cli/workflow/validate.js +353 -0
  540. package/dist/package.json +1 -0
  541. package/package.json +28 -10
@@ -0,0 +1,30 @@
1
+ import { type OwnedDir } from "./files.js";
2
+ export declare const MANIFEST_FILE = ".dreamlake-skill.json";
3
+ export type SkillAgent = "claude" | "codex";
4
+ export type SkillScope = "project" | "global" | "dir";
5
+ export type SkillSourceKind = "embedded" | "catalog";
6
+ export interface SkillManifest {
7
+ name: string;
8
+ /** Release tag (or commit) the files came from; null when the source carried none. */
9
+ version: string | null;
10
+ source: SkillSourceKind;
11
+ agent: SkillAgent;
12
+ scope: SkillScope;
13
+ /** `<relative path>` → sha256 hex of the bytes the installer wrote. */
14
+ files: Record<string, string>;
15
+ }
16
+ export declare class ManifestError extends Error {
17
+ readonly file: string;
18
+ constructor(message: string, file: string);
19
+ }
20
+ export declare const AGENTS: readonly SkillAgent[];
21
+ export declare function isAgent(v: unknown): v is SkillAgent;
22
+ export declare function manifestPath(target: string): string;
23
+ /** Validate a parsed manifest. Throws `ManifestError` naming the first problem. */
24
+ export declare function validateManifest(raw: unknown, file: string): SkillManifest;
25
+ /**
26
+ * Read the manifest under `target`. `null` when there is none; throws
27
+ * `ManifestError` when one exists but is a symlink, unparsable or unsafe.
28
+ */
29
+ export declare function readManifest(target: string): SkillManifest | null;
30
+ export declare function writeManifest(owned: OwnedDir, manifest: SkillManifest): string;
@@ -0,0 +1,101 @@
1
+ // The install manifest: `<skill dir>/.dreamlake-skill.json`.
2
+ //
3
+ // It is the only thing `update` and `remove` trust. It records what version
4
+ // was installed, from where, for which agent and scope, and the sha256 of
5
+ // every file the installer wrote — so a later run can tell "unchanged since
6
+ // install" from "the user edited this" without guessing. Paths are relative,
7
+ // forward-slash, no `..`; a manifest that violates that is rejected on read,
8
+ // never partially honoured.
9
+ import { readFileSync } from "node:fs";
10
+ import path from "node:path";
11
+ import { kindOf, safeRelativePath, writeOwnedFile } from "./files.js";
12
+ export const MANIFEST_FILE = ".dreamlake-skill.json";
13
+ export class ManifestError extends Error {
14
+ file;
15
+ constructor(message, file) {
16
+ super(message);
17
+ this.file = file;
18
+ }
19
+ }
20
+ export const AGENTS = ["claude", "codex"];
21
+ const SCOPES = ["project", "global", "dir"];
22
+ const SOURCES = ["embedded", "catalog"];
23
+ const NAME = /^[A-Za-z0-9][A-Za-z0-9._-]*$/;
24
+ const SHA256 = /^[0-9a-f]{64}$/;
25
+ export function isAgent(v) {
26
+ return typeof v === "string" && AGENTS.includes(v);
27
+ }
28
+ export function manifestPath(target) {
29
+ return path.join(target, MANIFEST_FILE);
30
+ }
31
+ /** Validate a parsed manifest. Throws `ManifestError` naming the first problem. */
32
+ export function validateManifest(raw, file) {
33
+ if (!raw || typeof raw !== "object" || Array.isArray(raw)) {
34
+ throw new ManifestError("manifest is not an object", file);
35
+ }
36
+ const m = raw;
37
+ if (typeof m.name !== "string" || !NAME.test(m.name)) {
38
+ throw new ManifestError("manifest 'name' is not a valid skill name", file);
39
+ }
40
+ if (m.version !== null && typeof m.version !== "string") {
41
+ throw new ManifestError("manifest 'version' must be a string or null", file);
42
+ }
43
+ if (!SOURCES.includes(m.source)) {
44
+ throw new ManifestError("manifest 'source' must be embedded or catalog", file);
45
+ }
46
+ if (!isAgent(m.agent))
47
+ throw new ManifestError("manifest 'agent' must be claude or codex", file);
48
+ if (!SCOPES.includes(m.scope)) {
49
+ throw new ManifestError("manifest 'scope' must be project, global or dir", file);
50
+ }
51
+ if (!m.files || typeof m.files !== "object" || Array.isArray(m.files)) {
52
+ throw new ManifestError("manifest 'files' must be an object", file);
53
+ }
54
+ const files = {};
55
+ for (const [rel, hash] of Object.entries(m.files)) {
56
+ if (safeRelativePath(rel) !== rel || rel === MANIFEST_FILE) {
57
+ throw new ManifestError(`manifest lists an unsafe path: ${JSON.stringify(rel)}`, file);
58
+ }
59
+ if (typeof hash !== "string" || !SHA256.test(hash)) {
60
+ throw new ManifestError(`manifest hash for ${rel} is not a sha256 hex digest`, file);
61
+ }
62
+ files[rel] = hash;
63
+ }
64
+ return {
65
+ name: m.name,
66
+ version: m.version,
67
+ source: m.source,
68
+ agent: m.agent,
69
+ scope: m.scope,
70
+ files,
71
+ };
72
+ }
73
+ /**
74
+ * Read the manifest under `target`. `null` when there is none; throws
75
+ * `ManifestError` when one exists but is a symlink, unparsable or unsafe.
76
+ */
77
+ export function readManifest(target) {
78
+ const file = manifestPath(target);
79
+ const kind = kindOf(file);
80
+ if (kind === "absent")
81
+ return null;
82
+ if (kind !== "file")
83
+ throw new ManifestError(`manifest is not a regular file`, file);
84
+ let parsed;
85
+ try {
86
+ parsed = JSON.parse(readFileSync(file, "utf8"));
87
+ }
88
+ catch (err) {
89
+ throw new ManifestError(`manifest is not valid JSON: ${err.message}`, file);
90
+ }
91
+ return validateManifest(parsed, file);
92
+ }
93
+ export function writeManifest(owned, manifest) {
94
+ const file = manifestPath(owned.skillDir);
95
+ const kind = kindOf(file);
96
+ // Never write through a symlink or onto a directory someone put at this path.
97
+ if (kind !== "absent" && kind !== "file")
98
+ throw new ManifestError("manifest path is not a regular file", file);
99
+ const files = Object.fromEntries(Object.keys(manifest.files).sort().map((k) => [k, manifest.files[k]]));
100
+ return writeOwnedFile(owned, MANIFEST_FILE, JSON.stringify({ ...manifest, files }, null, 2) + "\n");
101
+ }
@@ -0,0 +1,9 @@
1
+ import { type SkillAgent } from "./manifest.js";
2
+ export interface SkillPreferences {
3
+ agent: SkillAgent;
4
+ scope: "project" | "global";
5
+ }
6
+ export declare function preferencesPath(): string;
7
+ /** `null` when nothing was saved or the file is unreadable — never throws. */
8
+ export declare function readSkillPreferences(): SkillPreferences | null;
9
+ export declare function writeSkillPreferences(prefs: SkillPreferences): string;
@@ -0,0 +1,32 @@
1
+ // The agent and scope `dreamlake init` chose, remembered so every later
2
+ // `skill` subcommand defaults to them. Lives in the CLI state directory next
3
+ // to `skill-reminders.json`; `--agent`, `--global`, `--project` and `--dir`
4
+ // override it per invocation and never rewrite it.
5
+ import { readFileSync } from "node:fs";
6
+ import path from "node:path";
7
+ import { updateStatePath } from "../self-update/paths.js";
8
+ import { writeStateFile } from "./files.js";
9
+ import { isAgent } from "./manifest.js";
10
+ export function preferencesPath() {
11
+ return path.join(path.dirname(updateStatePath()), "skill-preferences.json");
12
+ }
13
+ /** `null` when nothing was saved or the file is unreadable — never throws. */
14
+ export function readSkillPreferences() {
15
+ try {
16
+ const parsed = JSON.parse(readFileSync(preferencesPath(), "utf8"));
17
+ if (!parsed || typeof parsed !== "object")
18
+ return null;
19
+ const { agent, scope } = parsed;
20
+ if (!isAgent(agent))
21
+ return null;
22
+ return { agent, scope: scope === "global" ? "global" : "project" };
23
+ }
24
+ catch {
25
+ return null;
26
+ }
27
+ }
28
+ export function writeSkillPreferences(prefs) {
29
+ const file = preferencesPath();
30
+ writeStateFile(file, JSON.stringify(prefs, null, 2) + "\n");
31
+ return file;
32
+ }
@@ -0,0 +1,15 @@
1
+ import { type SkillAgent, type SkillListEntry } from "./index.js";
2
+ export interface AgentSkills {
3
+ agent: SkillAgent;
4
+ skills: SkillListEntry[];
5
+ }
6
+ /** Exposed for offline verification. Reads are isolated so one broken agent path
7
+ * does not hide a reminder for the other agent. Manifest files are not hashed:
8
+ * only versions matter here, and this runs at the start of every command. */
9
+ export declare function currentSkillEntries(): AgentSkills[];
10
+ export declare function remindStaleSkills(version: string, entries: AgentSkills[]): void;
11
+ /** Handles npm upgrades and background swaps using the binary now running. */
12
+ export declare function maybeRemindStaleSkills(argv: string[], terminal?: boolean): void;
13
+ /** The updater process still contains the OLD bundle. Ask the installed binary
14
+ * through its existing read-only JSON API, with background work disabled. */
15
+ export declare function remindAfterInstall(version: string): void;
@@ -0,0 +1,105 @@
1
+ // Best-effort local reminders. Never modify installed skills or use the network.
2
+ //
3
+ // Compares each installed skill's manifest version with the newest version
4
+ // this binary knows of — the embedded manifest for `dreamlake-cli`, the
5
+ // embedded catalog snapshot for everything else — and prints one line per
6
+ // installed path per CLI version when something newer exists. Nothing is
7
+ // fetched here; `skill list --refresh` is the networked check.
8
+ import { spawnSync } from "node:child_process";
9
+ import { readFileSync } from "node:fs";
10
+ import path from "node:path";
11
+ import { canonical, updateStatePath, versionPath } from "../self-update/paths.js";
12
+ import { VERSION } from "../version.js";
13
+ import { fmtVersion, isNewerVersion } from "./catalog.js";
14
+ import { writeStateFile } from "./files.js";
15
+ import { installedSkillEntries, skillCommand } from "./index.js";
16
+ const agents = ["claude", "codex"];
17
+ const receiptPath = () => path.join(path.dirname(updateStatePath()), "skill-reminders.json");
18
+ /** Exposed for offline verification. Reads are isolated so one broken agent path
19
+ * does not hide a reminder for the other agent. Manifest files are not hashed:
20
+ * only versions matter here, and this runs at the start of every command. */
21
+ export function currentSkillEntries() {
22
+ return agents.flatMap(agent => {
23
+ try {
24
+ return [{ agent, skills: installedSkillEntries(agent, { verify: false }) }];
25
+ }
26
+ catch {
27
+ return [];
28
+ }
29
+ });
30
+ }
31
+ export function remindStaleSkills(version, entries) {
32
+ try {
33
+ let receipts = {};
34
+ try {
35
+ const parsed = JSON.parse(readFileSync(receiptPath(), "utf8"));
36
+ if (parsed && typeof parsed === "object" && !Array.isArray(parsed)) {
37
+ receipts = Object.fromEntries(Object.entries(parsed).filter(([, v]) => typeof v === "string"));
38
+ }
39
+ }
40
+ catch { /* A missing or malformed receipt simply allows a new reminder. */ }
41
+ let changed = false;
42
+ for (const { agent, skills } of entries) {
43
+ for (const skill of skills) {
44
+ for (const scope of ["project", "global"]) {
45
+ const installed = skill[scope];
46
+ if (!installed || (installed.state !== "installed" && installed.state !== "modified"))
47
+ continue;
48
+ if (!isNewerVersion(skill.latest, installed.version))
49
+ continue;
50
+ const key = canonical(installed.path);
51
+ if (receipts[key] === version)
52
+ continue;
53
+ const command = skillCommand("update", skill.name, {
54
+ agent,
55
+ ...(scope === "global" ? { global: true } : {
56
+ dir: path.resolve(installed.path, "..", "..", ".."),
57
+ }),
58
+ }, false);
59
+ process.stderr.write(`Installed skill ${installed.path} is ${fmtVersion(installed.version)}; ${fmtVersion(skill.latest)} is available. Update with: ${command}\n`);
60
+ delete receipts[key];
61
+ receipts[key] = version;
62
+ changed = true;
63
+ }
64
+ }
65
+ }
66
+ if (changed)
67
+ writeStateFile(receiptPath(), JSON.stringify(receipts, null, 2));
68
+ }
69
+ catch { /* Reminders must never fail the user's command or update. */ }
70
+ }
71
+ /** Handles npm upgrades and background swaps using the binary now running. */
72
+ export function maybeRemindStaleSkills(argv, terminal = Boolean(process.stdout.isTTY && process.stderr.isTTY)) {
73
+ if (!terminal || process.env.DREAMLAKE_UPDATE_BACKGROUND === "1")
74
+ return;
75
+ if (argv.some(arg => arg === "--json" || arg.startsWith("--json=") || arg === "--background"))
76
+ return;
77
+ // Explicit install/update checks the newly installed binary afterward.
78
+ if (["install", "self-update", "skill", "init"].includes(argv[2] ?? ""))
79
+ return;
80
+ try {
81
+ remindStaleSkills(VERSION, currentSkillEntries());
82
+ }
83
+ catch { /* Invalid/missing bundle or unreadable cwd. */ }
84
+ }
85
+ /** The updater process still contains the OLD bundle. Ask the installed binary
86
+ * through its existing read-only JSON API, with background work disabled. */
87
+ export function remindAfterInstall(version) {
88
+ try {
89
+ const entries = [];
90
+ for (const agent of agents) {
91
+ const result = spawnSync(versionPath(version), ["skill", "list", "--agent", agent, "--json"], {
92
+ encoding: "utf8", timeout: 3000, maxBuffer: 1024 * 1024,
93
+ env: { ...process.env, DREAMLAKE_SKILLS_DIR: undefined, DREAMLAKE_UPDATE_BACKGROUND: "1", DREAMLAKE_DISABLE_AUTOUPDATER: "1" },
94
+ stdio: ["ignore", "pipe", "pipe"],
95
+ });
96
+ if (result.status !== 0)
97
+ continue;
98
+ const parsed = JSON.parse(result.stdout);
99
+ if (parsed.status === "ok" && Array.isArray(parsed.skills))
100
+ entries.push({ agent, skills: parsed.skills });
101
+ }
102
+ remindStaleSkills(version, entries);
103
+ }
104
+ catch { /* Older binaries without --agent, failed reads, etc. */ }
105
+ }
@@ -0,0 +1,17 @@
1
+ export interface TarEntry {
2
+ /** Normalized forward-slash relative path. */
3
+ path: string;
4
+ type: "file" | "dir";
5
+ data: Buffer;
6
+ }
7
+ export declare class TarError extends Error {
8
+ }
9
+ export declare function readTarGz(gz: Buffer): TarEntry[];
10
+ export declare function readTar(tar: Buffer): TarEntry[];
11
+ export interface TarInput {
12
+ path: string;
13
+ data?: Buffer | string;
14
+ type?: "file" | "dir" | "symlink";
15
+ linkTarget?: string;
16
+ }
17
+ export declare function writeTar(inputs: TarInput[]): Buffer;
@@ -0,0 +1,195 @@
1
+ // A small ustar / pax / GNU-longname reader over `node:zlib`.
2
+ //
3
+ // The release tarball is a handful of markdown files per skill, so the whole
4
+ // archive is read into memory; no streaming, no shelling out to `tar` (which
5
+ // Windows does not have). The reader is deliberately strict: a checksum
6
+ // mismatch, an absolute path, a `..` segment, or any link entry rejects the
7
+ // whole archive, because our release never contains those and an archive
8
+ // that does is not one we should write to a user's disk.
9
+ import { gunzipSync } from "node:zlib";
10
+ import { safeRelativePath } from "./files.js";
11
+ export class TarError extends Error {
12
+ }
13
+ const BLOCK = 512;
14
+ function text(buf, off, len) {
15
+ let end = off;
16
+ while (end < off + len && buf[end] !== 0)
17
+ end += 1;
18
+ return buf.toString("utf8", off, end);
19
+ }
20
+ function numeric(buf, off, len) {
21
+ // GNU base-256 encoding for values that do not fit in octal.
22
+ if ((buf[off] & 0x80) !== 0) {
23
+ let v = buf[off] & 0x7f;
24
+ for (let i = 1; i < len; i += 1)
25
+ v = v * 256 + buf[off + i];
26
+ return v;
27
+ }
28
+ const raw = text(buf, off, len).trim();
29
+ if (raw === "")
30
+ return 0;
31
+ const v = parseInt(raw, 8);
32
+ if (Number.isNaN(v))
33
+ throw new TarError(`invalid numeric field '${raw}'`);
34
+ return v;
35
+ }
36
+ function checksumOk(header) {
37
+ const stored = numeric(header, 148, 8);
38
+ let unsigned = 0;
39
+ let signed = 0;
40
+ for (let i = 0; i < BLOCK; i += 1) {
41
+ const b = i >= 148 && i < 156 ? 0x20 : header[i];
42
+ unsigned += b;
43
+ signed += (b << 24) >> 24;
44
+ }
45
+ return stored === unsigned || stored === signed;
46
+ }
47
+ function isZeroBlock(block) {
48
+ for (let i = 0; i < block.length; i += 1)
49
+ if (block[i] !== 0)
50
+ return false;
51
+ return true;
52
+ }
53
+ /** pax extended header: repeated `"<len> <key>=<value>\n"` records. */
54
+ function parsePax(data) {
55
+ const out = {};
56
+ let pos = 0;
57
+ while (pos < data.length) {
58
+ const space = data.indexOf(0x20, pos);
59
+ if (space === -1)
60
+ break;
61
+ const len = parseInt(data.toString("utf8", pos, space), 10);
62
+ if (!Number.isFinite(len) || len <= 0 || pos + len > data.length) {
63
+ throw new TarError("malformed pax header");
64
+ }
65
+ const record = data.toString("utf8", space + 1, pos + len - 1);
66
+ const eq = record.indexOf("=");
67
+ if (eq > 0)
68
+ out[record.slice(0, eq)] = record.slice(eq + 1);
69
+ pos += len;
70
+ }
71
+ return out;
72
+ }
73
+ function headerName(header) {
74
+ const name = text(header, 0, 100);
75
+ const magic = text(header, 257, 6);
76
+ const prefix = magic.startsWith("ustar") ? text(header, 345, 155) : "";
77
+ return prefix ? `${prefix}/${name}` : name;
78
+ }
79
+ export function readTarGz(gz) {
80
+ let tar;
81
+ try {
82
+ tar = gunzipSync(gz);
83
+ }
84
+ catch (err) {
85
+ throw new TarError(`not a gzip stream: ${err.message}`);
86
+ }
87
+ return readTar(tar);
88
+ }
89
+ export function readTar(tar) {
90
+ const entries = [];
91
+ let off = 0;
92
+ let longName = null;
93
+ let paxPath = null;
94
+ while (off + BLOCK <= tar.length) {
95
+ const header = tar.subarray(off, off + BLOCK);
96
+ if (isZeroBlock(header))
97
+ break;
98
+ if (!checksumOk(header))
99
+ throw new TarError(`corrupt header at offset ${off}`);
100
+ const size = numeric(header, 124, 12);
101
+ const type = String.fromCharCode(header[156]);
102
+ const dataStart = off + BLOCK;
103
+ const dataEnd = dataStart + size;
104
+ if (dataEnd > tar.length)
105
+ throw new TarError("truncated archive");
106
+ const data = tar.subarray(dataStart, dataEnd);
107
+ off = dataStart + Math.ceil(size / BLOCK) * BLOCK;
108
+ if (type === "L") {
109
+ longName = data.toString("utf8").replace(/\0+$/, "");
110
+ continue;
111
+ }
112
+ if (type === "x") {
113
+ paxPath = parsePax(data).path ?? null;
114
+ continue;
115
+ }
116
+ if (type === "g")
117
+ continue;
118
+ if (type === "K" || type === "1" || type === "2") {
119
+ const name = paxPath ?? longName ?? headerName(header);
120
+ throw new TarError(`archive contains a link entry: ${name}`);
121
+ }
122
+ const rawName = paxPath ?? longName ?? headerName(header);
123
+ paxPath = null;
124
+ longName = null;
125
+ const isDir = type === "5" || (rawName.endsWith("/") && (type === "0" || type === "\0"));
126
+ const rel = safeRelativePath(rawName);
127
+ if (rel === null)
128
+ throw new TarError(`unsafe path in archive: ${JSON.stringify(rawName)}`);
129
+ if (isDir)
130
+ entries.push({ path: rel, type: "dir", data: Buffer.alloc(0) });
131
+ else if (type === "0" || type === "\0" || type === "7")
132
+ entries.push({ path: rel, type: "file", data: Buffer.from(data) });
133
+ // Character/block devices and FIFOs are skipped: nothing to write.
134
+ }
135
+ return entries;
136
+ }
137
+ function octal(value, len) {
138
+ return Buffer.from(value.toString(8).padStart(len - 1, "0") + "\0", "ascii");
139
+ }
140
+ export function writeTar(inputs) {
141
+ const blocks = [];
142
+ for (const input of inputs) {
143
+ const data = input.type === "dir" || input.type === "symlink"
144
+ ? Buffer.alloc(0)
145
+ : Buffer.isBuffer(input.data) ? input.data : Buffer.from(input.data ?? "", "utf8");
146
+ const header = Buffer.alloc(BLOCK);
147
+ const name = input.type === "dir" && !input.path.endsWith("/") ? `${input.path}/` : input.path;
148
+ if (Buffer.byteLength(name) > 100) {
149
+ // GNU long name: an `L` entry carrying the path, then the real header.
150
+ blocks.push(longLinkHeader(name), pad(Buffer.from(name + "\0", "utf8")));
151
+ }
152
+ header.write(name.slice(0, 100), 0, "utf8");
153
+ octal(input.type === "dir" ? 0o755 : 0o644, 8).copy(header, 100);
154
+ octal(0, 8).copy(header, 108);
155
+ octal(0, 8).copy(header, 116);
156
+ octal(data.length, 12).copy(header, 124);
157
+ octal(0, 12).copy(header, 136);
158
+ header.write(input.type === "dir" ? "5" : input.type === "symlink" ? "2" : "0", 156, "ascii");
159
+ if (input.type === "symlink")
160
+ header.write((input.linkTarget ?? "").slice(0, 100), 157, "utf8");
161
+ header.write("ustar\0", 257, "ascii");
162
+ header.write("00", 263, "ascii");
163
+ header.fill(0x20, 148, 156);
164
+ let sum = 0;
165
+ for (let i = 0; i < BLOCK; i += 1)
166
+ sum += header[i];
167
+ Buffer.from(sum.toString(8).padStart(6, "0") + "\0 ", "ascii").copy(header, 148);
168
+ blocks.push(header, pad(data));
169
+ }
170
+ blocks.push(Buffer.alloc(BLOCK * 2));
171
+ return Buffer.concat(blocks);
172
+ }
173
+ function longLinkHeader(name) {
174
+ const header = Buffer.alloc(BLOCK);
175
+ const payload = Buffer.byteLength(name) + 1;
176
+ header.write("././@LongLink", 0, "ascii");
177
+ octal(0o644, 8).copy(header, 100);
178
+ octal(0, 8).copy(header, 108);
179
+ octal(0, 8).copy(header, 116);
180
+ octal(payload, 12).copy(header, 124);
181
+ octal(0, 12).copy(header, 136);
182
+ header.write("L", 156, "ascii");
183
+ header.write("ustar\0", 257, "ascii");
184
+ header.write("00", 263, "ascii");
185
+ header.fill(0x20, 148, 156);
186
+ let sum = 0;
187
+ for (let i = 0; i < BLOCK; i += 1)
188
+ sum += header[i];
189
+ Buffer.from(sum.toString(8).padStart(6, "0") + "\0 ", "ascii").copy(header, 148);
190
+ return header;
191
+ }
192
+ function pad(data) {
193
+ const rem = data.length % BLOCK;
194
+ return rem === 0 ? data : Buffer.concat([data, Buffer.alloc(BLOCK - rem)]);
195
+ }
@@ -0,0 +1,24 @@
1
+ import type { Command } from "commander";
2
+ import { type BridgeDeps } from "../python.js";
3
+ export interface SnapshotResult {
4
+ status: "created" | "exists" | "error";
5
+ server: string;
6
+ namespace: string;
7
+ id?: string;
8
+ remote?: string;
9
+ commit?: string;
10
+ branch?: string;
11
+ dirty?: boolean;
12
+ archiveKey?: string;
13
+ storageName?: string;
14
+ sizeBytes?: number;
15
+ error?: string;
16
+ kind?: string;
17
+ }
18
+ export interface SnapshotOptions {
19
+ server?: string;
20
+ namespace?: string;
21
+ json?: boolean;
22
+ }
23
+ export declare function runSnapshot(opts: SnapshotOptions, deps?: BridgeDeps): Promise<number>;
24
+ export declare function registerSnapshotCommand(program: Command): void;