@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,38 @@
1
+ /** Strict metadata projection for the optional retained-entry preview page. */
2
+ const fail = () => { throw Error('Invalid affected-entry preview'); };
3
+ const path = (v) => typeof v === 'string' && v.length <= 512 && /^[A-Za-z0-9_-]+(?:\/[A-Za-z0-9_-]+)*$/.test(v);
4
+ const ref = (v) => typeof v === 'string' && /^[A-Za-z0-9_-]{1,64}$/.test(v);
5
+ const within = (v, p) => v === p || v.startsWith(p + '/');
6
+ const identity = (v) => typeof v === 'string' && /^[A-Za-z0-9_-]{1,128}$/.test(v);
7
+ const cursor = (v) => typeof v === 'string' && /^[A-Za-z0-9_-]{1,4096}$/.test(v);
8
+ const date = (v) => v === null ? null : typeof v === 'string' && /^\d{4}-\d\d-\d\dT\d\d:\d\d:\d\d\.\d{3}Z$/.test(v) && !v.startsWith('0000-') && Number.isFinite(Date.parse(v)) && new Date(v).toISOString() === v ? v : fail();
9
+ export function affectedPageOptions(limit, after) {
10
+ if (limit === undefined && after === undefined)
11
+ return undefined;
12
+ if (typeof limit !== 'string' || !/^[1-9][0-9]{0,2}$/.test(limit) || Number(limit) > 200 || (after !== undefined && !cursor(after)))
13
+ return fail();
14
+ return { limit: Number(limit), ...(after === undefined ? {} : { cursor: after }) };
15
+ }
16
+ export function affectedView(value, prefix, keyRef) {
17
+ if (!value || typeof value.observedAt !== 'string' || date(value.observedAt) === null || typeof value.contextFingerprint !== 'string' || !/^[a-f0-9]{64}$/.test(value.contextFingerprint) || value.schemaVersion !== 1 || value.consistency !== 'page-snapshot' || value.includesRetired !== true || value.comparison !== 'policy-only' || ![null, 'active-migration', 'overlapping-boundary'].includes(value.blockedReason) || !Array.isArray(value.entries) || value.entries.length > 200 || !(value.nextCursor === null || cursor(value.nextCursor)))
18
+ return fail();
19
+ let previous;
20
+ const entries = value.entries.map((row) => {
21
+ if (!row || !identity(row.id) || !path(row.name) || !within(row.name, prefix) || !Number.isSafeInteger(row.revision) || row.revision < 1 || !['string', 'totp', 'hotp'].includes(row.type))
22
+ return fail();
23
+ if (previous && (row.name < previous.name || (row.name === previous.name && row.id <= previous.id)))
24
+ return fail();
25
+ previous = { name: row.name, id: row.id };
26
+ const current = row.currentPolicy, proposed = row.proposedPolicy;
27
+ if (!current || !(current.prefix === null || path(current.prefix) && within(row.name, current.prefix)) || !(current.keyRef === null || ref(current.keyRef)) || !['aws-kms', 'gcp-kms'].includes(current.provider) || !(current.epoch === null || identity(current.epoch)))
28
+ return fail();
29
+ if (value.blockedReason !== null ? proposed !== null : !proposed || proposed.prefix !== prefix || proposed.keyRef !== keyRef || !['aws-kms', 'gcp-kms'].includes(proposed.provider))
30
+ return fail();
31
+ return { id: row.id, name: row.name, revision: row.revision, type: row.type, deleteAt: date(row.deleteAt), purgeAt: date(row.purgeAt), expiresAt: date(row.expiresAt),
32
+ currentPolicy: { prefix: current.prefix, keyRef: current.keyRef, provider: current.provider, epoch: current.epoch },
33
+ proposedPolicy: proposed === null ? null : { prefix: proposed.prefix, keyRef: proposed.keyRef, provider: proposed.provider } };
34
+ });
35
+ if (value.nextCursor !== null && !entries.length)
36
+ return fail();
37
+ return { observedAt: value.observedAt, contextFingerprint: value.contextFingerprint, schemaVersion: 1, consistency: 'page-snapshot', includesRetired: true, comparison: 'policy-only', blockedReason: value.blockedReason, entries, nextCursor: value.nextCursor };
38
+ }
@@ -0,0 +1,55 @@
1
+ import type { Command } from 'commander';
2
+ import { request } from './index.js';
3
+ export type CloudProvider = 'aws' | 'gcp' | 'other';
4
+ export type CloudCall = typeof request;
5
+ type Summary = {
6
+ profiles?: string[];
7
+ credentialType?: string;
8
+ project?: string;
9
+ externalReferences?: boolean;
10
+ };
11
+ export interface CloudFile {
12
+ source: string;
13
+ name: string;
14
+ fileName: string;
15
+ bytes: number;
16
+ summary: Summary;
17
+ value: string;
18
+ }
19
+ export declare function cloudProvider(value: string): CloudProvider;
20
+ export declare function cloudCandidates(provider: CloudProvider, home?: string, env?: NodeJS.ProcessEnv): string[];
21
+ export declare function prepareCloudFiles(provider: CloudProvider, files: string[], prefix: string): Promise<CloudFile[]>;
22
+ export declare function cloudPreview(files: CloudFile[]): {
23
+ source: string;
24
+ name: string;
25
+ fileName: string;
26
+ bytes: number;
27
+ summary: Summary;
28
+ }[];
29
+ export declare function uploadCloudFiles(files: CloudFile[], call?: CloudCall, revision?: number, suppliedId?: string, announce?: (id: string, name: string) => void): Promise<{
30
+ entries: {
31
+ name: string;
32
+ requestId: string;
33
+ status: string;
34
+ revision?: number;
35
+ }[];
36
+ complete: boolean;
37
+ unattempted: string[];
38
+ }>;
39
+ export declare function resolveRestorePath(path: string, home?: string): string;
40
+ export declare function writeCloudFile(path: string, value: string, overwrite?: boolean): Promise<{
41
+ destination: string;
42
+ mode: string;
43
+ restored: boolean;
44
+ }>;
45
+ export declare function restoreCloudFile(name: string, to: string, apply: boolean, overwrite: boolean, call?: CloudCall): Promise<{
46
+ restored: boolean;
47
+ name: string;
48
+ destination: string;
49
+ fileName: any;
50
+ exists: boolean;
51
+ overwrite: boolean;
52
+ mode: string;
53
+ }>;
54
+ export declare function registerVaultCloud(vault: Command): void;
55
+ export {};
@@ -0,0 +1,287 @@
1
+ import { randomUUID } from 'node:crypto';
2
+ import { constants } from 'node:fs';
3
+ import { lstat, open, realpath, link, rename, unlink } from 'node:fs/promises';
4
+ import { homedir } from 'node:os';
5
+ import { basename, dirname, join, resolve, relative, isAbsolute } from 'node:path';
6
+ import { collectPrefix, invocationPrefix, request } from './index.js';
7
+ import { validateEntries } from './format.js';
8
+ import { entryName, revisionNumber, secretValue, writeReceipt, writeRequestId } from './mutations.js';
9
+ import { readSshFile } from './sshSource.js';
10
+ export function cloudProvider(value) {
11
+ if (!['aws', 'gcp', 'other'].includes(value))
12
+ throw new Error('Choose --provider aws, gcp or other');
13
+ return value;
14
+ }
15
+ export function cloudCandidates(provider, home = homedir(), env = process.env) {
16
+ if (provider === 'aws')
17
+ return [...new Set([
18
+ resolve(env.AWS_CONFIG_FILE || join(home, '.aws/config')),
19
+ resolve(env.AWS_SHARED_CREDENTIALS_FILE || join(home, '.aws/credentials')),
20
+ ])];
21
+ if (provider === 'gcp')
22
+ return [...new Set([
23
+ ...(env.GOOGLE_APPLICATION_CREDENTIALS ? [resolve(env.GOOGLE_APPLICATION_CREDENTIALS)] : []),
24
+ resolve(env.CLOUDSDK_CONFIG || (process.platform === 'win32' && env.APPDATA ? join(env.APPDATA, 'gcloud') : join(home, '.config/gcloud')), 'application_default_credentials.json'),
25
+ ])];
26
+ return [];
27
+ }
28
+ function summarize(provider, value) {
29
+ if (provider === 'other')
30
+ return {};
31
+ if (provider === 'aws') {
32
+ const sections = [...value.matchAll(/^\s*\[([^\]\r\n]+)\]\s*(?:[#;].*)?$/gm)].map(m => m[1]);
33
+ if (!sections.length)
34
+ throw new Error('Selected AWS file must contain INI sections');
35
+ return {
36
+ profiles: [...new Set(sections.filter(s => !/^(sso-session|services) /.test(s)).map(s => s.replace(/^profile /, '')))],
37
+ externalReferences: /^\s*(credential_process|source_profile|sso_session|web_identity_token_file)\s*=/m.test(value),
38
+ };
39
+ }
40
+ let data;
41
+ try {
42
+ data = JSON.parse(value.replace(/^\uFEFF/, ''));
43
+ }
44
+ catch {
45
+ throw new Error('Selected GCP file must be credential JSON');
46
+ }
47
+ if (!data || typeof data !== 'object' || Array.isArray(data) || !['service_account', 'authorized_user', 'external_account'].includes(data.type)) {
48
+ throw new Error('Unsupported GCP credential type; use --provider other for plain config files');
49
+ }
50
+ const required = data.type === 'service_account' ? ['client_email', 'private_key'] : data.type === 'authorized_user' ? ['client_id', 'client_secret', 'refresh_token'] : ['audience', 'subject_token_type'];
51
+ if (required.some(key => typeof data[key] !== 'string' || !data[key]))
52
+ throw new Error('Incomplete GCP credential JSON');
53
+ const project = data.project_id ?? data.quota_project_id;
54
+ return { credentialType: data.type, externalReferences: data.type === 'external_account', ...(typeof project === 'string' && /^[a-z0-9][a-z0-9:.-]{0,127}$/.test(project) ? { project } : {}) };
55
+ }
56
+ export async function prepareCloudFiles(provider, files, prefix) {
57
+ if (!prefix || !files.length)
58
+ throw new Error('Import requires explicit --prefix and --file selections');
59
+ entryName('probe', prefix);
60
+ const seen = new Set();
61
+ const planned = files.map(file => {
62
+ const source = resolve(file), fileName = basename(source);
63
+ if (!/^[A-Za-z0-9_.-]{1,128}$/.test(fileName) || fileName === '.' || fileName === '..')
64
+ throw new Error('Unsupported source basename');
65
+ const leaf = fileName.replace(/\./g, '-').replace(/^-+|-+$/g, '');
66
+ const name = entryName(leaf, prefix);
67
+ if (seen.has(name))
68
+ throw new Error('Selected files collide at the destination; use distinct prefixes');
69
+ seen.add(name);
70
+ return { source, fileName, name };
71
+ });
72
+ const results = [];
73
+ for (const item of planned) {
74
+ let value;
75
+ try {
76
+ value = await readSshFile(item.source);
77
+ }
78
+ catch {
79
+ throw new Error('Selected cloud file is unsafe, changed, unreadable or invalid UTF-8');
80
+ }
81
+ if (!value || /[\u0000-\u0008\u000b\u000c\u000e-\u001f\u007f]/.test(value))
82
+ throw new Error('Selected cloud file is empty or contains binary/control bytes');
83
+ secretValue(value);
84
+ results.push({ ...item, value, bytes: Buffer.byteLength(value), summary: summarize(provider, value) });
85
+ }
86
+ return results;
87
+ }
88
+ export function cloudPreview(files) {
89
+ return files.map(({ value: _value, ...metadata }) => metadata);
90
+ }
91
+ export async function uploadCloudFiles(files, call = request, revision, suppliedId, announce = (id, name) => {
92
+ process.stderr.write(JSON.stringify({ requestId: id, name }) + '\n');
93
+ }) {
94
+ if (!files.length || (files.length !== 1 && (revision !== undefined || suppliedId !== undefined)))
95
+ throw new Error('--if-match and --request-id require exactly one selected file');
96
+ if (suppliedId !== undefined)
97
+ writeRequestId(suppliedId);
98
+ const results = [];
99
+ for (const file of files) {
100
+ const id = suppliedId ?? randomUUID();
101
+ announce(id, file.name);
102
+ let committed = false;
103
+ try {
104
+ const response = await call('/v1/vault/entry', { name: file.name, type: 'string', value: file.value, fileName: file.fileName }, 'PUT', revision, { 'Idempotency-Key': id });
105
+ const receipt = writeReceipt(response, id);
106
+ const meta = receipt.entry;
107
+ if (meta.name !== file.name)
108
+ throw new Error();
109
+ committed = true;
110
+ const read = await call('/v1/vault/entries/read', { selectors: [file.name] });
111
+ validateEntries(read?.entries, true);
112
+ if (read.entries.length !== 1 || read.entries[0].name !== file.name || read.entries[0].value !== file.value || read.entries[0].fileName !== file.fileName)
113
+ throw new Error();
114
+ results.push({ name: file.name, requestId: id, status: 'verified', revision: meta.revision });
115
+ }
116
+ catch {
117
+ results.push({ name: file.name, requestId: id, status: committed ? 'committed-readback-unverified' : 'unknown-check-write-status' });
118
+ break; // Never replay or continue a batch after an uncertain write.
119
+ }
120
+ }
121
+ return { entries: results, complete: results.length === files.length && results.every(item => item.status === 'verified'), unattempted: files.slice(results.length).map(file => file.name) };
122
+ }
123
+ export function resolveRestorePath(path, home = homedir()) {
124
+ const match = /^(?:~|\$HOME|\$\{HOME\})(?:\/(.*))?$/.exec(path);
125
+ if (!match) {
126
+ if (path.startsWith('~') || path.startsWith('$'))
127
+ throw new Error('Unsupported restore path expansion');
128
+ return resolve(path);
129
+ }
130
+ const root = resolve(home), target = resolve(root, match[1] || '');
131
+ const child = relative(root, target);
132
+ if (child === '..' || child.startsWith('../') || isAbsolute(child))
133
+ throw new Error('Restore path escapes the receiving home directory');
134
+ return target;
135
+ }
136
+ async function destination(path) {
137
+ if (process.platform === 'win32')
138
+ throw new Error('Secure cloud restore currently requires POSIX file permissions');
139
+ const target = resolveRestorePath(path), parent = dirname(target);
140
+ try {
141
+ if (await realpath(parent) !== parent)
142
+ throw new Error();
143
+ const directory = await lstat(parent);
144
+ if (!directory.isDirectory() || directory.uid !== process.getuid() || (directory.mode & 0o022) !== 0)
145
+ throw new Error();
146
+ let existing;
147
+ try {
148
+ existing = await lstat(target);
149
+ }
150
+ catch (error) {
151
+ if (error.code !== 'ENOENT')
152
+ throw error;
153
+ }
154
+ if (existing && (!existing.isFile() || existing.isSymbolicLink() || existing.nlink !== 1 || existing.uid !== process.getuid()))
155
+ throw new Error();
156
+ return { target, parent, existing };
157
+ }
158
+ catch {
159
+ throw new Error('Restore needs an existing owned directory without writable peers, and a regular non-symlink destination');
160
+ }
161
+ }
162
+ export async function writeCloudFile(path, value, overwrite = false) {
163
+ const before = await destination(path);
164
+ if (before.existing && !overwrite)
165
+ throw new Error('Destination exists; explicit --overwrite is required');
166
+ const temporary = join(before.parent, `.dreamlake-restore-${randomUUID()}`);
167
+ let created = false;
168
+ try {
169
+ const file = await open(temporary, constants.O_WRONLY | constants.O_CREAT | constants.O_EXCL | constants.O_NOFOLLOW, 0o600);
170
+ created = true;
171
+ try {
172
+ await file.chmod(0o600);
173
+ await file.writeFile(value, 'utf8');
174
+ await file.sync();
175
+ }
176
+ finally {
177
+ await file.close();
178
+ }
179
+ const now = await destination(path);
180
+ const a = before.existing, b = now.existing;
181
+ if (!!a !== !!b || (a && b && (a.ino !== b.ino || a.dev !== b.dev || a.mtimeMs !== b.mtimeMs || a.ctimeMs !== b.ctimeMs || a.size !== b.size)))
182
+ throw new Error('Destination changed during restore');
183
+ if (overwrite && before.existing)
184
+ await rename(temporary, before.target);
185
+ else
186
+ await link(temporary, before.target); // Atomic no-clobber publication.
187
+ const directory = await open(before.parent, constants.O_RDONLY);
188
+ try {
189
+ await directory.sync();
190
+ }
191
+ finally {
192
+ await directory.close();
193
+ }
194
+ return { destination: before.target, mode: '0600', restored: true };
195
+ }
196
+ finally {
197
+ if (created) {
198
+ try {
199
+ await unlink(temporary);
200
+ }
201
+ catch (error) {
202
+ if (error.code !== 'ENOENT')
203
+ throw new Error('Restore temporary file cleanup failed; inspect destination before retrying');
204
+ }
205
+ }
206
+ }
207
+ }
208
+ export async function restoreCloudFile(name, to, apply, overwrite, call = request) {
209
+ name = entryName(name);
210
+ const target = await destination(to);
211
+ const result = await call(`/v1/vault/entry?name=${encodeURIComponent(name)}`);
212
+ validateEntries([result?.entry]);
213
+ const meta = result.entry;
214
+ if (meta.name !== name || meta.type !== 'string' || !Number.isSafeInteger(meta.revision) || meta.revision < 1 || meta.deleteAt || (meta.expiresAt && Date.parse(meta.expiresAt) <= Date.now()))
215
+ throw new Error('Selected entry is unavailable for file restore');
216
+ const preview = { name, destination: target.target, fileName: meta.fileName, exists: !!target.existing, overwrite, mode: '0600' };
217
+ if (!apply)
218
+ return { ...preview, restored: false };
219
+ if (target.existing && !overwrite)
220
+ throw new Error('Destination exists; explicit --overwrite is required');
221
+ const read = await call('/v1/vault/entries/read', { selectors: [name] });
222
+ validateEntries(read?.entries, true);
223
+ const entry = read.entries[0];
224
+ if (read.entries.length !== 1 || entry.name !== name || entry.type !== 'string' || typeof entry.value !== 'string' || entry.revision !== meta.revision)
225
+ throw new Error('Entry changed or is not a text file; preview again');
226
+ secretValue(entry.value);
227
+ await writeCloudFile(target.target, entry.value, overwrite);
228
+ return { ...preview, restored: true };
229
+ }
230
+ export function registerVaultCloud(vault) {
231
+ const cloud = vault.command('cloud').description('preview, import and restore selected cloud configuration files');
232
+ cloud.command('import').requiredOption('--provider <provider>', 'aws, gcp or other')
233
+ .option('-p, --prefix <prefix>', 'explicit destination prefix', collectPrefix)
234
+ .option('--file <path>', 'selected UTF-8 file (repeatable)', (v, values) => [...values, v], [])
235
+ .option('--apply', 'upload selected files; otherwise preview only')
236
+ .option('--if-match <revision>', 'replace one selected entry at this revision')
237
+ .option('--request-id <id>', 'single-file write recovery ID; reuse only for identical input')
238
+ .action(async (options, command) => {
239
+ try {
240
+ const provider = cloudProvider(options.provider), prefix = invocationPrefix(command);
241
+ if (!prefix)
242
+ throw new Error('Choose an explicit destination --prefix');
243
+ entryName('probe', prefix);
244
+ const revision = revisionNumber(options.ifMatch);
245
+ if (options.requestId)
246
+ writeRequestId(options.requestId);
247
+ if ((revision !== undefined || options.requestId !== undefined) && (!options.apply || options.file.length !== 1))
248
+ throw new Error('--if-match and --request-id require --apply with one file');
249
+ if (!options.file.length) {
250
+ if (options.apply)
251
+ throw new Error('Upload requires explicit --file selection');
252
+ process.stdout.write(JSON.stringify({ provider, prefix, candidates: cloudCandidates(provider), uploaded: false }, null, 2) + '\n');
253
+ return;
254
+ }
255
+ const files = await prepareCloudFiles(provider, options.file, prefix);
256
+ const preview = { provider, entries: cloudPreview(files), uploaded: false };
257
+ if (!options.apply) {
258
+ process.stdout.write(JSON.stringify(preview, null, 2) + '\n');
259
+ return;
260
+ }
261
+ process.stderr.write(JSON.stringify(preview, null, 2) + '\n');
262
+ const result = await uploadCloudFiles(files, request, revision, options.requestId);
263
+ process.stdout.write(JSON.stringify(result, null, 2) + '\n');
264
+ if (!result.complete)
265
+ process.exitCode = 1;
266
+ }
267
+ catch (error) {
268
+ process.stderr.write((error instanceof Error ? error.message : 'Cloud import failed') + '\n');
269
+ process.exitCode = 1;
270
+ }
271
+ });
272
+ cloud.command('restore').requiredOption('-n, --name <name>', 'one vault entry')
273
+ .option('-p, --prefix <prefix>', 'vault prefix', collectPrefix)
274
+ .requiredOption('--to <path>', 'explicit destination file in an existing directory')
275
+ .option('--apply', 'write the file; otherwise metadata-only preview')
276
+ .option('--overwrite', 'explicitly replace an existing regular file')
277
+ .action(async (options, command) => {
278
+ try {
279
+ const result = await restoreCloudFile(entryName(options.name, invocationPrefix(command)), options.to, !!options.apply, !!options.overwrite);
280
+ process.stdout.write(JSON.stringify(result, null, 2) + '\n');
281
+ }
282
+ catch {
283
+ process.stderr.write('Cloud restore failed; check the entry, destination permissions and explicit --overwrite. If --apply was used, inspect the destination before retrying. No secret values logged.\n');
284
+ process.exitCode = 1;
285
+ }
286
+ });
287
+ }
@@ -0,0 +1,18 @@
1
+ /** Vault names are root-relative unless an invocation prefix is supplied. */
2
+ export declare function resolveSelector(name: string, prefix?: string): string;
3
+ export interface VaultEntry {
4
+ name: string;
5
+ type: string;
6
+ value: string | Record<string, string>;
7
+ env?: string;
8
+ keyName?: string;
9
+ fileName?: string;
10
+ }
11
+ export declare function validateEntries(entries: unknown, secrets?: boolean): asserts entries is VaultEntry[];
12
+ export interface OutputOptions {
13
+ toJson?: boolean;
14
+ toEnvs?: boolean;
15
+ envPrefix?: string;
16
+ }
17
+ export declare function validateOutputRequest(selectors: string[], options?: OutputOptions): void;
18
+ export declare function formatEntries(entries: VaultEntry[], selectors: string[], options?: OutputOptions): string;
@@ -0,0 +1,104 @@
1
+ /** Vault names are root-relative unless an invocation prefix is supplied. */
2
+ export function resolveSelector(name, prefix = "") {
3
+ if (name.split("=").length > 2)
4
+ throw new Error("Invalid output alias");
5
+ if (name.includes("=")) {
6
+ const [alias, ...rest] = name.split("=");
7
+ if (!/^[A-Za-z_][A-Za-z0-9_]*$/.test(alias))
8
+ throw new Error("Invalid output alias");
9
+ return `${alias}=${resolveSelector(rest.join("="), prefix)}`;
10
+ }
11
+ const absolute = name.startsWith("/");
12
+ const path = name.replace(/^\//, "");
13
+ if (!/^[A-Za-z0-9_-]+(?:\/[A-Za-z0-9_-]+)*(?:\.[A-Za-z0-9_-]+)?$/.test(path))
14
+ throw new Error("Invalid vault selector");
15
+ if (prefix && !/^[A-Za-z0-9_-]+(?:\/[A-Za-z0-9_-]+)*\/?$/.test(prefix))
16
+ throw new Error("Invalid vault prefix");
17
+ return !absolute && prefix ? `${prefix.replace(/\/$/, "")}/${path}` : path;
18
+ }
19
+ export function validateEntries(entries, secrets = false) {
20
+ if (!Array.isArray(entries))
21
+ throw new Error("Invalid vault response");
22
+ const names = new Set();
23
+ for (const entry of entries) {
24
+ if (!entry || typeof entry !== "object" || Array.isArray(entry) || typeof entry.name !== "string" || typeof entry.type !== "string" || names.has(entry.name))
25
+ throw new Error("Invalid vault response");
26
+ resolveSelector(entry.name);
27
+ names.add(entry.name);
28
+ if (entry.revision !== undefined && (!Number.isSafeInteger(entry.revision) || entry.revision < 1))
29
+ throw new Error("Invalid vault response");
30
+ for (const key of ["deleteAt", "purgeAt", "expiresAt"])
31
+ if (entry[key] != null && (typeof entry[key] !== "string" || !/^\d{4}-\d\d-\d\dT\d\d:\d\d:\d\d(?:\.\d+)?Z$/.test(entry[key])))
32
+ throw new Error("Invalid vault response");
33
+ for (const key of ["env", "keyName", "fileName"])
34
+ if (entry[key] != null && typeof entry[key] !== "string")
35
+ throw new Error("Invalid vault response");
36
+ if (secrets && !(typeof entry.value === "string" || entry.value && typeof entry.value === "object" && !Array.isArray(entry.value) && Object.values(entry.value).every(v => typeof v === "string")))
37
+ throw new Error("Invalid vault response");
38
+ }
39
+ }
40
+ export function validateOutputRequest(selectors, options = {}) {
41
+ if (options.toJson && options.toEnvs)
42
+ throw new Error("Choose --to-json or --to-envs");
43
+ if (options.envPrefix && !options.toEnvs)
44
+ throw new Error("--env-prefix requires --to-envs");
45
+ if (options.envPrefix && !/^[A-Za-z_][A-Za-z0-9_]*$/.test(options.envPrefix))
46
+ throw new Error("Invalid environment prefix");
47
+ if (new Set(selectors).size !== selectors.length)
48
+ throw new Error("Colliding output keys");
49
+ const known = new Set();
50
+ for (const selector of selectors) {
51
+ const [alias, path] = selector.includes("=") ? selector.split("=") : [undefined, selector];
52
+ const field = path.split(".")[1];
53
+ let key = alias ?? field;
54
+ if (key === undefined)
55
+ continue; // Saved entry metadata determines this output name.
56
+ if (options.toEnvs && !alias)
57
+ key = key.replace(/-/g, "_").toUpperCase();
58
+ if (known.has(key))
59
+ throw new Error("Colliding output keys");
60
+ known.add(key);
61
+ }
62
+ }
63
+ export function formatEntries(entries, selectors, options = {}) {
64
+ validateOutputRequest(selectors, options);
65
+ validateEntries(entries, true);
66
+ const expected = new Set(selectors.map(s => s.split("=").at(-1).split(".")[0]));
67
+ if (entries.length !== expected.size || entries.some(e => !expected.has(e.name)))
68
+ throw new Error("Invalid vault response");
69
+ const selected = selectors.map(selector => {
70
+ const [alias, path] = selector.includes("=") ? selector.split("=") : [undefined, selector];
71
+ const [name, field] = path.split(".");
72
+ const entry = entries.find(item => item.name === name);
73
+ if (!entry || !["string", "totp", "hotp"].includes(entry.type))
74
+ throw new Error("Entry unavailable or unsupported type");
75
+ const value = field ? typeof entry.value === "object" && Object.hasOwn(entry.value, field) ? entry.value[field] : undefined : entry.value;
76
+ if (value === undefined || !(typeof value === "string" || value && !Array.isArray(value) && typeof value === "object" && Object.values(value).every(v => typeof v === "string")))
77
+ throw new Error("Invalid or missing secret value");
78
+ return { explicitEnv: !!(alias || (!field && entry.env)), key: alias ?? field ?? entry.keyName ?? name, env: alias ?? field ?? entry.env ?? entry.keyName ?? name.split("/").at(-1), value };
79
+ });
80
+ if (options.toEnvs) {
81
+ const envs = new Map();
82
+ for (const item of selected) {
83
+ const fields = typeof item.value === "string" ? [[item.env, item.value]] : Object.entries(item.value);
84
+ for (const [key, value] of fields) {
85
+ const env = `${options.envPrefix ?? ""}${typeof item.value === "string" && item.explicitEnv ? key : key.replace(/-/g, "_").toUpperCase()}`;
86
+ if (!/^[A-Za-z_][A-Za-z0-9_]*$/.test(env) || envs.has(env) || value.includes("\0"))
87
+ throw new Error("Invalid or colliding environment name/value");
88
+ envs.set(env, value);
89
+ }
90
+ }
91
+ return [...envs].map(([key, value]) => `export ${key}='${value.replace(/'/g, "'\\''")}'`).join("\n") + "\n";
92
+ }
93
+ if (selected.length === 1) {
94
+ const value = selected[0].value;
95
+ return typeof value === "string" && !options.toJson ? value : JSON.stringify(value, null, 2) + "\n";
96
+ }
97
+ const composed = Object.create(null);
98
+ for (const item of selected) {
99
+ if (Object.hasOwn(composed, item.key))
100
+ throw new Error("Colliding output keys");
101
+ composed[item.key] = item.value;
102
+ }
103
+ return JSON.stringify(composed, null, 2) + "\n";
104
+ }
@@ -0,0 +1,21 @@
1
+ import type { Command } from 'commander';
2
+ export interface HostBindingInput {
3
+ hostId: string;
4
+ enrollmentId: string;
5
+ role: string;
6
+ endpoint: string;
7
+ kind: string;
8
+ entryId: string;
9
+ entryRevision: number;
10
+ }
11
+ export declare function bindingInput(value: HostBindingInput): HostBindingInput;
12
+ export declare function bindingView(binding: any): {
13
+ [k: string]: any;
14
+ };
15
+ export declare function bindHostCredential(data: HostBindingInput, connection?: {
16
+ remote: string;
17
+ token: string;
18
+ }): Promise<{
19
+ [k: string]: any;
20
+ }>;
21
+ export declare function registerHostBindings(vault: Command): void;
@@ -0,0 +1,71 @@
1
+ import { request } from './index.js';
2
+ export function bindingInput(value) {
3
+ if (!/^[0-9a-f]{24}$/.test(value.hostId ?? '') || !/^[0-9a-f]{24}$/.test(value.enrollmentId ?? '') || !/^[A-Za-z0-9_-]{1,128}$/.test(value.entryId ?? '') || !Number.isSafeInteger(value.entryRevision) || value.entryRevision < 1 || !['target', 'jump'].includes(value.role) || !['password', 'private_key'].includes(value.kind) || !/^[A-Za-z0-9_.@:\[\]-]{1,255}$/.test(value.endpoint ?? ''))
4
+ throw new Error('Invalid host credential binding');
5
+ return value;
6
+ }
7
+ export function bindingView(binding) {
8
+ bindingInput(binding);
9
+ if (typeof binding.id !== 'string')
10
+ throw new Error('Invalid binding response');
11
+ return Object.fromEntries(['id', 'hostId', 'enrollmentId', 'role', 'endpoint', 'kind', 'entryId', 'entryRevision', 'createdAt', 'releasedAt', 'status'].filter(k => binding[k] !== undefined).map(k => [k, binding[k]]));
12
+ }
13
+ export async function bindHostCredential(data, connection) {
14
+ bindingInput(data);
15
+ const binding = (await request('/v1/vault/host-credentials', data, 'PUT', undefined, {}, connection)).binding;
16
+ if (!binding || Object.entries(data).some(([k, v]) => binding[k] !== v))
17
+ throw new Error('Invalid binding response');
18
+ return bindingView(binding);
19
+ }
20
+ export function registerHostBindings(vault) {
21
+ vault.command('unbind').description('release a personal retention reference; does NOT revoke remote SSH access')
22
+ .requiredOption('--binding-id <id>', 'binding identity from vault bindings')
23
+ .requiredOption('--entry-id <id>', 'exact referenced entry identity')
24
+ .requiredOption('--entry-revision <number>', 'exact referenced entry revision')
25
+ .action(async (opts) => {
26
+ try {
27
+ const revision = Number(opts.entryRevision);
28
+ if (!/^[a-f0-9-]{36}$/.test(opts.bindingId) || !/^[A-Za-z0-9_-]{1,128}$/.test(opts.entryId) || !Number.isSafeInteger(revision) || revision < 1)
29
+ throw new Error();
30
+ const result = await request('/v1/vault/host-credentials/' + opts.bindingId + '/release', { entryId: opts.entryId, entryRevision: revision }, 'POST');
31
+ const b = result.binding;
32
+ if (!b || b.id !== opts.bindingId || b.entryId !== opts.entryId || b.entryRevision !== revision || typeof b.releasedAt !== 'string' || !b.releasedAt || b.remoteAccessRevoked !== false)
33
+ throw new Error();
34
+ console.log(JSON.stringify({ ...bindingView(b), remoteAccessRevoked: false }, null, 2));
35
+ }
36
+ catch {
37
+ console.error('Release was not confirmed; retry the same metadata arguments. Remote SSH access is not revoked.');
38
+ process.exitCode = 1;
39
+ }
40
+ });
41
+ vault.command('bind').description('recover a saved credential binding; metadata only, no SSH or secret reread')
42
+ .requiredOption('--host-id <id>', 'host identity').requiredOption('--enrollment-id <id>', 'your enrollment identity')
43
+ .requiredOption('--entry-id <id>', 'stable saved entry identity').requiredOption('--entry-revision <number>', 'saved entry revision')
44
+ .requiredOption('--role <target|jump>', 'target or separately selected jump host').requiredOption('--endpoint <endpoint>', 'SSH destination or alias')
45
+ .requiredOption('--kind <password|private_key>', 'credential source kind')
46
+ .action(async (opts) => {
47
+ try {
48
+ console.log(JSON.stringify(await bindHostCredential({ hostId: opts.hostId, enrollmentId: opts.enrollmentId, entryId: opts.entryId, entryRevision: Number(opts.entryRevision), role: opts.role, endpoint: opts.endpoint, kind: opts.kind }), null, 2));
49
+ }
50
+ catch {
51
+ console.error('Binding was not confirmed; inspect vault bindings and retry these same metadata arguments. No SSH access changed.');
52
+ process.exitCode = 1;
53
+ }
54
+ });
55
+ vault.command('bindings').description('list account-owned host credential references; no secret values')
56
+ .requiredOption('--host-id <id>', 'host identity').requiredOption('--enrollment-id <id>', 'your enrollment identity')
57
+ .action(async (opts) => {
58
+ try {
59
+ if (!/^[0-9a-f]{24}$/.test(opts.hostId) || !/^[0-9a-f]{24}$/.test(opts.enrollmentId))
60
+ throw new Error();
61
+ const result = await request('/v1/vault/host-credentials?' + new URLSearchParams({ hostId: opts.hostId, enrollmentId: opts.enrollmentId }));
62
+ if (!Array.isArray(result.bindings))
63
+ throw new Error();
64
+ console.log(JSON.stringify({ bindings: result.bindings.map(bindingView) }, null, 2));
65
+ }
66
+ catch {
67
+ console.error('Host credential bindings unavailable');
68
+ process.exitCode = 1;
69
+ }
70
+ });
71
+ }
@@ -0,0 +1,18 @@
1
+ import type { Command } from 'commander';
2
+ export type SupersessionIntent = {
3
+ operationId: string;
4
+ expectedEntryId: string;
5
+ expectedEntryRevision: number;
6
+ replacementEntryId: string;
7
+ replacementEntryRevision: number;
8
+ };
9
+ export declare function validateSupersession(bindingId: string, data: SupersessionIntent): SupersessionIntent;
10
+ export declare function supersessionReceipt(result: any, operationId: string, bindingId?: string, expected?: SupersessionIntent): {
11
+ [k: string]: any;
12
+ };
13
+ /** Operation lookup can expose a later cleanup lifecycle without changing the
14
+ * immutable original supersession receipt returned by an exact POST replay. */
15
+ export declare function hostOperationReceipt(result: any, operationId: string): {
16
+ [k: string]: any;
17
+ };
18
+ export declare function registerHostSupersessions(vault: Command): void;