@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,169 @@
1
+ import { affectedPageOptions, affectedView } from './affected-preview.js';
2
+ import { collectPrefix, invocationPrefix, request } from './index.js';
3
+ const validPath = (value) => typeof value === 'string' && /^[A-Za-z0-9_-]+(?:\/[A-Za-z0-9_-]+)*$/.test(value);
4
+ const validRef = (value) => typeof value === 'string' && /^[A-Za-z0-9_-]{1,64}$/.test(value);
5
+ const id = (value) => { if (!/^[A-Za-z0-9_-]{1,128}$/.test(value))
6
+ throw Error('Invalid request ID'); return value; };
7
+ const instant = (value) => typeof value === 'string' && /^\d{4}-\d\d-\d\dT\d\d:\d\d:\d\d\.\d{3}Z$/.test(value) && !value.startsWith('0000-') && Number.isFinite(Date.parse(value)) && new Date(value).toISOString() === value;
8
+ /** Metadata-only allowlist: unexpected server fields never reach console output. */
9
+ export function kmsView(value, operation = false) {
10
+ if (!value || !validPath(value.prefix) || !['aws-kms', 'gcp-kms'].includes(value.provider))
11
+ throw Error('Invalid KMS response');
12
+ const result = { prefix: value.prefix, provider: value.provider };
13
+ if (operation) {
14
+ if (!validRef(value.keyRef) || typeof value.requestId !== 'string' || id(value.requestId) !== value.requestId || value.state !== 'committed' || !instant(value.committedAt))
15
+ throw Error('Invalid KMS receipt');
16
+ return { ...result, keyRef: value.keyRef, requestId: value.requestId, state: 'committed', committedAt: value.committedAt };
17
+ }
18
+ if (value.governingPrefix !== null && !validPath(value.governingPrefix))
19
+ throw Error('Invalid governing prefix');
20
+ if (value.keyRef !== null && !validRef(value.keyRef))
21
+ throw Error('Invalid key reference');
22
+ if (!Array.isArray(value.overlappingPrefixes) || !value.overlappingPrefixes.every(validPath))
23
+ throw Error('Invalid KMS overlaps');
24
+ Object.assign(result, { governingPrefix: value.governingPrefix, keyRef: value.keyRef, overlappingPrefixes: value.overlappingPrefixes });
25
+ for (const key of ['hasEntries', 'hasWriteReceipts', 'hasHotpReceipts', 'hasPasswordSnapshots', 'canActivate', 'migrationRequired', 'migrationSupported', 'canMigrate']) {
26
+ if (key in value) {
27
+ if (typeof value[key] !== 'boolean')
28
+ throw Error('Invalid KMS state');
29
+ result[key] = value[key];
30
+ }
31
+ }
32
+ for (const key of ['entryCount', 'writeReceiptCount', 'hotpReceiptCount', 'passwordSnapshotCount', 'totalRetainedRecordCount']) {
33
+ if (key in value) {
34
+ if (!Number.isSafeInteger(value[key]) || value[key] < 0)
35
+ throw Error('Invalid KMS count');
36
+ result[key] = value[key];
37
+ }
38
+ }
39
+ if ('retainedRecordSchemaVersion' in value || 'retainedRecordKinds' in value) {
40
+ const kinds = ['entry', 'write_receipt', 'hotp_receipt', 'password_snapshot'];
41
+ if (value.retainedRecordSchemaVersion !== 2 || !Array.isArray(value.retainedRecordKinds) || JSON.stringify(value.retainedRecordKinds) !== JSON.stringify(kinds))
42
+ throw Error('Unsupported retained record schema');
43
+ Object.assign(result, { retainedRecordSchemaVersion: 2, retainedRecordKinds: kinds });
44
+ }
45
+ if ('selectedKeyRef' in value) {
46
+ if (!validRef(value.selectedKeyRef) || value.readiness !== 'not-probed')
47
+ throw Error('Invalid KMS preview');
48
+ Object.assign(result, { selectedKeyRef: value.selectedKeyRef, readiness: value.readiness });
49
+ }
50
+ if ('availableKeys' in value) {
51
+ if (!Array.isArray(value.availableKeys) || value.availableKeys.length > 1001)
52
+ throw Error('Invalid key registry');
53
+ result.availableKeys = value.availableKeys.map((key) => { if (!validRef(key.ref) || !['aws-kms', 'gcp-kms'].includes(key.provider))
54
+ throw Error('Invalid key registry'); return { ref: key.ref, provider: key.provider }; });
55
+ }
56
+ if ('affectedEntries' in value) {
57
+ if (!validRef(value.selectedKeyRef))
58
+ throw Error('Invalid KMS preview');
59
+ result.affectedEntries = affectedView(value.affectedEntries, value.prefix, value.selectedKeyRef);
60
+ }
61
+ return result;
62
+ }
63
+ export function kmsMigrationView(value) {
64
+ if (!value || !validPath(value.prefix) || !validRef(value.keyRef) || typeof value.requestId !== 'string' || id(value.requestId) !== value.requestId || !['aws-kms', 'gcp-kms'].includes(value.provider) || !['migrating', 'completed'].includes(value.state) || !Number.isSafeInteger(value.migrated) || value.migrated < 0 || !instant(value.startedAt) || (value.state === 'completed' ? (!instant(value.completedAt) || Date.parse(value.completedAt) < Date.parse(value.startedAt)) : value.completedAt !== null))
65
+ throw Error('Invalid KMS migration response');
66
+ if ('requiredRetainedRecordSchemaVersion' in value && ![1, 2].includes(value.requiredRetainedRecordSchemaVersion))
67
+ throw Error('Unsupported retained record schema');
68
+ return { ...(value.requiredRetainedRecordSchemaVersion === undefined ? {} : { requiredRetainedRecordSchemaVersion: value.requiredRetainedRecordSchemaVersion }), prefix: value.prefix, keyRef: value.keyRef, requestId: value.requestId, provider: value.provider, state: value.state, migrated: value.migrated, startedAt: value.startedAt, completedAt: value.completedAt };
69
+ }
70
+ export function kmsReadView(value, prefix, keyRef, affectedLimit) {
71
+ const view = kmsView(value);
72
+ if (view.prefix !== prefix || (keyRef !== undefined && view.selectedKeyRef !== keyRef)) {
73
+ throw Error('Mismatched KMS response');
74
+ }
75
+ if (affectedLimit !== undefined && (!view.affectedEntries || view.affectedEntries.entries.length > affectedLimit))
76
+ throw Error('Missing or oversized affected-entry page');
77
+ return view;
78
+ }
79
+ export function registerVaultKms(vault) {
80
+ const kms = vault.command('kms').description('inspect operator-configured prefix encryption; no arbitrary key onboarding')
81
+ .option('-p, --prefix <prefix>', 'personal prefix', collectPrefix);
82
+ const scope = (command) => { const prefix = invocationPrefix(command).replace(/\/$/, ''); if (!validPath(prefix))
83
+ throw Error('An explicit personal --prefix is required'); return prefix; };
84
+ const emit = (value) => console.log(JSON.stringify(value, null, 2));
85
+ kms.command('show').option('-p, --prefix <prefix>', 'personal prefix', collectPrefix).action(async (_opts, command) => {
86
+ try {
87
+ const prefix = scope(command);
88
+ emit(kmsReadView(await request('/v1/vault/kms?' + new URLSearchParams({ prefix })), prefix));
89
+ }
90
+ catch {
91
+ console.error('KMS metadata unavailable; use an explicit authorized prefix.');
92
+ process.exitCode = 1;
93
+ }
94
+ });
95
+ kms.command('preview').requiredOption('--key <ref>', 'operator-configured key reference').option('--affected-limit <count>', 'opt in to one retained-entry metadata page (1-200)').option('--affected-cursor <cursor>', 'continue the same prefix/key policy observation').option('-p, --prefix <prefix>', 'personal prefix', collectPrefix).action(async (opts, command) => {
96
+ try {
97
+ if (!validRef(opts.key))
98
+ throw Error();
99
+ const prefix = scope(command), affectedEntries = affectedPageOptions(opts.affectedLimit, opts.affectedCursor);
100
+ emit(kmsReadView(await request('/v1/vault/kms/preview', { prefix, keyRef: opts.key, ...(affectedEntries ? { affectedEntries } : {}) }), prefix, opts.key, affectedEntries?.limit));
101
+ }
102
+ catch {
103
+ console.error('KMS preview unavailable; no policy changed.');
104
+ process.exitCode = 1;
105
+ }
106
+ });
107
+ kms.command('activate').requiredOption('--key <ref>', 'operator-configured key reference').requiredOption('--request-id <id>', 'persist and reuse this ID with identical prefix/key on retry')
108
+ .option('-p, --prefix <prefix>', 'empty personal prefix', collectPrefix).action(async (opts, command) => {
109
+ try {
110
+ const requestId = id(opts.requestId), prefix = scope(command);
111
+ if (!validRef(opts.key))
112
+ throw Error();
113
+ const view = kmsView(await request('/v1/vault/kms', { prefix, keyRef: opts.key }, 'PUT', undefined, { 'Idempotency-Key': requestId }), true);
114
+ if (view.requestId !== requestId || view.prefix !== prefix || view.keyRef !== opts.key)
115
+ throw Error();
116
+ emit(view);
117
+ }
118
+ catch {
119
+ console.error('KMS activation unconfirmed. Inspect kms status with the same request ID; retry only the identical prefix/key/ID. Populated prefixes require migration.');
120
+ process.exitCode = 1;
121
+ }
122
+ });
123
+ kms.command('migrate').requiredOption('--key <ref>', 'operator-approved target reference or managed').requiredOption('--request-id <id>', 'persist and reuse identical prefix/key/ID')
124
+ .option('-p, --prefix <prefix>', 'personal prefix', collectPrefix).action(async (opts, command) => {
125
+ try {
126
+ const requestId = id(opts.requestId), prefix = scope(command);
127
+ if (!validRef(opts.key))
128
+ throw Error();
129
+ const view = kmsMigrationView(await request('/v1/vault/kms/migrations', { prefix, keyRef: opts.key, retainedRecordSchemaVersion: 2 }, 'POST', undefined, { 'Idempotency-Key': requestId }));
130
+ if (view.requestId !== requestId || view.prefix !== prefix || view.keyRef !== opts.key)
131
+ throw Error();
132
+ emit(view);
133
+ }
134
+ catch {
135
+ console.error('KMS migration start unconfirmed. Inspect kms status with the original request ID; never replace an uncertain intent.');
136
+ process.exitCode = 1;
137
+ }
138
+ });
139
+ kms.command('resume <request-id>').option('--limit <count>', 'maximum ciphertext candidates per call (1-100)', '50').option('-p, --prefix <prefix>', 'assert the original migration prefix', collectPrefix).action(async (requestId, opts, command) => {
140
+ try {
141
+ id(requestId);
142
+ if (!/^[1-9][0-9]*$/.test(opts.limit) || Number(opts.limit) > 100)
143
+ throw Error();
144
+ const prefix = invocationPrefix(command) ? scope(command) : undefined;
145
+ const view = kmsMigrationView(await request('/v1/vault/kms/migrations/' + encodeURIComponent(requestId) + '/resume', { retainedRecordSchemaVersion: 2, limit: Number(opts.limit), ...(prefix ? { expectedPrefix: prefix } : {}) }));
146
+ if (view.requestId !== requestId || (prefix !== undefined && view.prefix !== prefix))
147
+ throw Error();
148
+ emit(view);
149
+ }
150
+ catch {
151
+ console.error('KMS migration progress unconfirmed. Retain the original request ID; status and the same resume operation recover committed progress.');
152
+ process.exitCode = 1;
153
+ }
154
+ });
155
+ kms.command('status <request-id>').description('read activation or migration metadata; absence is not proof of no commit').option('-p, --prefix <prefix>', 'assert the original operation prefix', collectPrefix).action(async (requestId, _opts, command) => {
156
+ try {
157
+ const prefix = invocationPrefix(command) ? scope(command) : undefined;
158
+ const value = await request('/v1/vault/kms/operations/' + encodeURIComponent(id(requestId)));
159
+ const view = value?.state === 'committed' ? kmsView(value, true) : kmsMigrationView(value);
160
+ if (view.requestId !== requestId || (prefix !== undefined && view.prefix !== prefix))
161
+ throw Error();
162
+ emit(view);
163
+ }
164
+ catch {
165
+ console.error('KMS operation status unavailable; retain the original prefix/key/request ID for recovery.');
166
+ process.exitCode = 1;
167
+ }
168
+ });
169
+ }
@@ -0,0 +1,13 @@
1
+ export declare function pageSize(value?: unknown): number;
2
+ export declare function validCursor(value: unknown): string;
3
+ export declare function listEntries(prefix: string, options: {
4
+ limit?: string;
5
+ cursor?: string;
6
+ includeDeleted?: boolean;
7
+ }): Promise<{
8
+ entries: Record<string, unknown>[];
9
+ nextCursor: string | null;
10
+ } | {
11
+ entries: Record<string, unknown>[];
12
+ nextCursor?: undefined;
13
+ }>;
@@ -0,0 +1,60 @@
1
+ import { resolveRemote, resolveToken } from '../config.js';
2
+ import { request } from './index.js';
3
+ import { validateEntries } from './format.js';
4
+ export function pageSize(value = 100) {
5
+ if (typeof value === 'string' && !/^[1-9][0-9]{0,2}$/.test(value))
6
+ throw Error('Invalid page size');
7
+ if (typeof value !== 'string' && typeof value !== 'number')
8
+ throw Error('Invalid page size');
9
+ const limit = Number(value);
10
+ if (!Number.isSafeInteger(limit) || limit < 1 || limit > 200)
11
+ throw Error('Invalid page size');
12
+ return limit;
13
+ }
14
+ export function validCursor(value) {
15
+ if (typeof value !== 'string' || !/^[A-Za-z0-9_-]{1,2048}$/.test(value))
16
+ throw Error('Invalid cursor');
17
+ return value;
18
+ }
19
+ export async function listEntries(prefix, options) {
20
+ const token = resolveToken();
21
+ if (!token)
22
+ throw Error('Vault authentication required');
23
+ const connection = { remote: resolveRemote(), token };
24
+ const limit = pageSize(options.limit);
25
+ const single = options.limit !== undefined || options.cursor !== undefined;
26
+ let cursor = options.cursor === undefined ? undefined : validCursor(options.cursor);
27
+ const seen = new Set();
28
+ const entries = [];
29
+ let last;
30
+ do {
31
+ const query = new URLSearchParams({ prefix, limit: String(limit) });
32
+ if (options.includeDeleted)
33
+ query.set('includeDeleted', 'true');
34
+ if (cursor !== undefined) {
35
+ if (seen.has(cursor))
36
+ throw Error('Repeated cursor');
37
+ seen.add(cursor);
38
+ query.set('cursor', cursor);
39
+ }
40
+ const result = await request('/v1/vault/entries?' + query, undefined, 'GET', undefined, {}, connection);
41
+ validateEntries(result.entries);
42
+ const nextCursor = result.nextCursor == null ? null : validCursor(result.nextCursor);
43
+ // Older servers omit nextCursor and return the complete list. Preserve that
44
+ // rolling-upgrade response; new pages must progress in binary name order.
45
+ if (Object.hasOwn(result, 'nextCursor')) {
46
+ if (result.entries.length > limit || nextCursor && result.entries.length === 0)
47
+ throw Error('Invalid page');
48
+ for (const entry of result.entries) {
49
+ if (last !== undefined && entry.name <= last)
50
+ throw Error('Non-progressing page');
51
+ last = entry.name;
52
+ }
53
+ }
54
+ entries.push(...result.entries.map((entry) => Object.fromEntries(['name', 'type', 'env', 'keyName', 'fileName', 'deleteAt', 'purgeAt', 'expiresAt', 'revision'].filter(key => entry[key] !== undefined).map(key => [key, entry[key]]))));
55
+ if (single)
56
+ return { entries, nextCursor };
57
+ cursor = nextCursor ?? undefined;
58
+ } while (cursor !== undefined);
59
+ return { entries };
60
+ }
@@ -0,0 +1,21 @@
1
+ type Entry = Record<string, unknown>;
2
+ export type ListPage = {
3
+ entries: Entry[];
4
+ nextCursor?: string | null;
5
+ };
6
+ export declare const interactiveList: (json: boolean, input?: boolean, output?: boolean) => boolean;
7
+ export declare class ListSelection {
8
+ readonly entries: Entry[];
9
+ query: string;
10
+ focused: number;
11
+ marked: Set<string>;
12
+ constructor(entries: Entry[]);
13
+ visible(): Entry[];
14
+ filter(query: string): void;
15
+ move(delta: number): void;
16
+ toggle(): void;
17
+ selected(): Entry[];
18
+ }
19
+ /** Metadata only. Alternate-screen cleanup preserves the caller's terminal. */
20
+ export declare function showList(page: ListPage, prefix: string): Promise<ListPage | null>;
21
+ export {};
@@ -0,0 +1,123 @@
1
+ import { emitKeypressEvents } from 'node:readline';
2
+ import { terminalText } from './tree.js';
3
+ export const interactiveList = (json, input = process.stdin.isTTY, output = process.stdout.isTTY) => !json && !!input && !!output;
4
+ export class ListSelection {
5
+ entries;
6
+ query = '';
7
+ focused = 0;
8
+ marked = new Set();
9
+ constructor(entries) {
10
+ this.entries = entries;
11
+ }
12
+ visible() { return this.entries.filter(e => String(e.name).toLowerCase().includes(this.query.toLowerCase())); }
13
+ filter(query) { this.query = query; this.focused = 0; }
14
+ move(delta) { this.focused = Math.max(0, Math.min(this.visible().length - 1, this.focused + delta)); }
15
+ toggle() {
16
+ const name = this.visible()[this.focused]?.name;
17
+ if (typeof name !== 'string')
18
+ return;
19
+ if (this.marked.has(name))
20
+ this.marked.delete(name);
21
+ else
22
+ this.marked.add(name);
23
+ }
24
+ selected() {
25
+ if (this.marked.size)
26
+ return this.entries.filter(e => this.marked.has(String(e.name)));
27
+ const entry = this.visible()[this.focused];
28
+ return entry ? [entry] : [];
29
+ }
30
+ }
31
+ /** Metadata only. Alternate-screen cleanup preserves the caller's terminal. */
32
+ export async function showList(page, prefix) {
33
+ const input = process.stdin, output = process.stdout;
34
+ const state = new ListSelection(page.entries);
35
+ let filtering = false;
36
+ const render = () => {
37
+ const width = Math.max(1, output.columns || 80);
38
+ const height = Math.max(1, (output.rows || 24) - 7);
39
+ const visible = state.visible();
40
+ const start = Math.max(0, state.focused - height + 1);
41
+ const lines = [
42
+ `Vault ${terminalText(prefix || 'all')} — ${visible.length}/${page.entries.length} entries · ${state.marked.size} selected`,
43
+ '↑/↓ move · Space select · / filter · Enter finish · Esc cancel',
44
+ `${filtering ? 'Filter> ' : 'Filter: '}${terminalText(state.query) || '(all)'}`,
45
+ ];
46
+ for (const [index, entry] of visible.slice(start, start + height).entries()) {
47
+ lines.push(`${start + index === state.focused ? '>' : ' '} [${state.marked.has(String(entry.name)) ? 'x' : ' '}] ${terminalText(entry.name)} ${terminalText(entry.type)}${entry.deleteAt ? ' (retired)' : ''}`);
48
+ }
49
+ if (!visible.length)
50
+ lines.push('No matching entries.');
51
+ const entry = visible[state.focused];
52
+ if (entry)
53
+ lines.push(`Revision: ${terminalText(entry.revision)} · File: ${terminalText(entry.fileName ?? '—')}`);
54
+ lines.push(page.nextCursor ? 'Partial page: use --cursor with the returned nextCursor for more.' : 'Metadata only — no secret values read.');
55
+ output.write('\x1b[H\x1b[2J' + lines.map(line => line.slice(0, width)).join('\r\n'));
56
+ };
57
+ const wasRaw = input.isRaw;
58
+ emitKeypressEvents(input);
59
+ let onKey = () => { };
60
+ let onEnd = () => { };
61
+ try {
62
+ input.setRawMode(true);
63
+ input.resume();
64
+ output.write('\x1b[?1049h\x1b[?25l');
65
+ return await new Promise(resolve => {
66
+ const done = (entries) => resolve(entries ? { ...page, entries } : null);
67
+ onEnd = () => done(null);
68
+ onKey = (text, key) => {
69
+ if (key?.ctrl && key.name === 'c') {
70
+ done(null);
71
+ return;
72
+ }
73
+ if (filtering) {
74
+ if (key?.name === 'escape') {
75
+ state.filter('');
76
+ filtering = false;
77
+ }
78
+ else if (key?.name === 'return')
79
+ filtering = false;
80
+ else if (key?.name === 'backspace')
81
+ state.filter([...state.query].slice(0, -1).join(''));
82
+ else if (text && !key?.ctrl && !key?.meta && !/[\x00-\x1f\x7f-\x9f]/.test(text))
83
+ state.filter(state.query + text);
84
+ }
85
+ else {
86
+ if (key?.name === 'escape' || text === 'q') {
87
+ done(null);
88
+ return;
89
+ }
90
+ if (key?.name === 'return') {
91
+ done(state.selected());
92
+ return;
93
+ }
94
+ if (key?.name === 'up')
95
+ state.move(-1);
96
+ if (key?.name === 'down')
97
+ state.move(1);
98
+ if (key?.name === 'pageup')
99
+ state.move(-Math.max(1, (output.rows || 24) - 7));
100
+ if (key?.name === 'pagedown')
101
+ state.move(Math.max(1, (output.rows || 24) - 7));
102
+ if (text === ' ')
103
+ state.toggle();
104
+ if (text === '/')
105
+ filtering = true;
106
+ }
107
+ render();
108
+ };
109
+ input.on('keypress', onKey);
110
+ input.once('end', onEnd);
111
+ output.on('resize', render);
112
+ render();
113
+ });
114
+ }
115
+ finally {
116
+ input.off('keypress', onKey);
117
+ input.off('end', onEnd);
118
+ output.off('resize', render);
119
+ input.setRawMode(!!wasRaw);
120
+ input.pause();
121
+ output.write('\x1b[?25h\x1b[?1049l');
122
+ }
123
+ }
@@ -0,0 +1,2 @@
1
+ /** Strictly metadata-only projections: never print unsolicited response fields. */
2
+ export declare function managementMetadata(raw: any): any;
@@ -0,0 +1,23 @@
1
+ /** Strictly metadata-only projections: never print unsolicited response fields. */
2
+ export function managementMetadata(raw) {
3
+ const pick = (row, keys) => Object.fromEntries(keys.filter(key => row[key] !== undefined).map(key => [key, row[key]]));
4
+ if (!raw || typeof raw !== 'object' || Array.isArray(raw))
5
+ throw Error('Invalid vault metadata');
6
+ if (raw.operationId !== undefined) {
7
+ if (!/^[a-f0-9-]{36}$/.test(raw.operationId) || !['pending', 'completed', 'cancelled', 'expired'].includes(raw.state))
8
+ throw Error('Invalid copy receipt');
9
+ return pick(raw, ['apiVersion', 'operationId', 'requestId', 'state', 'sourceScope', 'destinationScope', 'sourceName', 'destinationName', 'sourceRevision', 'sourcePolicyRevision', 'sourceEntryId', 'destinationEntryId', 'expiresAt', 'mode', 'sourceRetained', 'destinationResealed']);
10
+ }
11
+ if (raw.events !== undefined) {
12
+ if (!Array.isArray(raw.events))
13
+ throw Error('Invalid audit metadata');
14
+ return { events: raw.events.map((row) => pick(row, ['tenantId', 'actorId', 'operationId', 'action', 'createdAt'])) };
15
+ }
16
+ if (raw.policy !== undefined)
17
+ return { capabilities: raw.capabilities?.filter((value) => typeof value === 'string' && value.startsWith('vault.')) ?? [], policy: managementMetadata(raw.policy) };
18
+ if (raw.capabilities !== undefined)
19
+ return { apiVersion: raw.apiVersion, capabilities: raw.capabilities.filter((value) => typeof value === 'string' && value.startsWith('vault.')), authorizationEpoch: raw.authorizationEpoch };
20
+ if (!Number.isSafeInteger(raw.revision) || typeof raw.exportEnabled !== 'boolean')
21
+ throw Error('Invalid policy metadata');
22
+ return pick(raw, ['revision', 'exportEnabled']);
23
+ }
@@ -0,0 +1,8 @@
1
+ import type { Command } from "commander";
2
+ export declare function entryName(name: string, prefix?: string): string;
3
+ export declare function revisionNumber(value?: string): number | undefined;
4
+ export declare function expiryValue(value: string | undefined, clear?: boolean): string | null | undefined;
5
+ export declare function secretValue(raw: string, json?: boolean): string | Record<string, string>;
6
+ export declare function writeRequestId(value: unknown): string;
7
+ export declare function writeReceipt(result: any, id: string): Record<string, unknown>;
8
+ export declare function registerVaultMutations(vault: Command): void;
@@ -0,0 +1,151 @@
1
+ import { randomUUID } from "node:crypto";
2
+ import { password } from "@inquirer/prompts";
3
+ import { collectPrefix, invocationPrefix, request, vaultScope } from "./index.js";
4
+ import { resolveSelector, validateEntries } from "./format.js";
5
+ export function entryName(name, prefix = "") {
6
+ const resolved = resolveSelector(name, prefix);
7
+ if (resolved.includes(".") || resolved.includes("="))
8
+ throw new Error("Expected an entry path, not a field or alias");
9
+ return resolved;
10
+ }
11
+ export function revisionNumber(value) {
12
+ if (value === undefined)
13
+ return undefined;
14
+ if (!/^[1-9][0-9]*$/.test(value) || !Number.isSafeInteger(Number(value)))
15
+ throw new Error("Invalid revision");
16
+ return Number(value);
17
+ }
18
+ export function expiryValue(value, clear = false) {
19
+ if (clear && value !== undefined)
20
+ throw new Error("Choose --expires-at or --no-expiry");
21
+ if (clear)
22
+ return null;
23
+ if (value === undefined)
24
+ return undefined;
25
+ if (!/^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(?:\.\d{3})?Z$/.test(value))
26
+ throw new Error("Invalid expiry; use UTC RFC3339");
27
+ const date = new Date(value);
28
+ if (!Number.isFinite(date.getTime()) || date.toISOString().slice(0, 19) !== value.slice(0, 19))
29
+ throw new Error("Invalid expiry; use UTC RFC3339");
30
+ return date.toISOString();
31
+ }
32
+ export function secretValue(raw, json = false) {
33
+ let value = raw;
34
+ if (json) {
35
+ try {
36
+ value = JSON.parse(raw);
37
+ }
38
+ catch {
39
+ throw new Error("Invalid secret JSON");
40
+ }
41
+ }
42
+ if (typeof value !== "string" && (!value || typeof value !== "object" || Array.isArray(value) || !Object.keys(value).length || Object.entries(value).some(([key, item]) => !/^[A-Za-z0-9_-]+$/.test(key) || ["__proto__", "prototype", "constructor"].includes(key) || typeof item !== "string")))
43
+ throw new Error("Expected a string or nonempty string field map");
44
+ if (Buffer.byteLength(JSON.stringify(value)) > 65536)
45
+ throw new Error("Secret value exceeds 64 KiB");
46
+ return value;
47
+ }
48
+ function metadata(result, name) {
49
+ validateEntries([result?.entry]);
50
+ if (result.entry.name !== name)
51
+ throw new Error("Invalid vault response");
52
+ return Object.fromEntries(["id", "name", "type", "env", "keyName", "fileName", "revision", "deleteAt", "purgeAt", "expiresAt"].filter(key => result.entry[key] !== undefined).map(key => [key, result.entry[key]]));
53
+ }
54
+ async function stdinValue() {
55
+ const chunks = [];
56
+ let length = 0;
57
+ for await (const chunk of process.stdin) {
58
+ const buffer = Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk);
59
+ length += buffer.length;
60
+ if (length > 131072)
61
+ throw new Error("Secret input exceeds size limit");
62
+ chunks.push(buffer);
63
+ }
64
+ // Preserve all bytes represented by UTF-8, including trailing newlines.
65
+ return new TextDecoder("utf-8", { fatal: true }).decode(Buffer.concat(chunks));
66
+ }
67
+ export function writeRequestId(value) {
68
+ if (typeof value !== "string" || !/^[A-Za-z0-9_-]{1,128}$/.test(value))
69
+ throw new Error("Invalid request ID");
70
+ return value;
71
+ }
72
+ export function writeReceipt(result, id) {
73
+ const op = result?.operation;
74
+ if (!op || op.requestId !== id || op.state !== "committed" || !Number.isSafeInteger(op.entry?.revision) || op.entry.revision < 1)
75
+ throw new Error("Invalid vault write receipt");
76
+ for (const key of ["committedAt", "retainUntil"])
77
+ if (typeof op[key] !== "string" || !/^\d{4}-\d\d-\d\dT\d\d:\d\d:\d\d\.\d{3}Z$/.test(op[key]))
78
+ throw new Error("Invalid vault write receipt");
79
+ return { requestId: id, state: "committed", entry: metadata({ entry: op.entry }, op.entry.name), committedAt: op.committedAt, retainUntil: op.retainUntil };
80
+ }
81
+ export function registerVaultMutations(vault) {
82
+ vault.command("write-status").description("look up a committed write by request ID; missing status does not prove failure")
83
+ .requiredOption("--request-id <id>", "non-secret write request ID")
84
+ .action(async (options) => {
85
+ try {
86
+ const id = writeRequestId(options.requestId);
87
+ const result = await request(`/v1/vault/write-operations/${id}`);
88
+ process.stdout.write(JSON.stringify(writeReceipt(result, id), null, 2) + "\n");
89
+ }
90
+ catch {
91
+ console.error("Vault write status unavailable; outcome remains unknown");
92
+ process.exitCode = 1;
93
+ }
94
+ });
95
+ for (const operation of ["add", "show", "delete", "restore"]) {
96
+ const command = vault.command(operation).description(operation === "add" ? "create an entry or replace with --if-match; input never accepted in arguments" : operation === "show" ? "show entry metadata, including retired entries" : operation === "delete" ? "soft-delete an entry; host access is not revoked" : "restore a retired entry before retention expires")
97
+ .requiredOption("-n, --name <name>", "entry path")
98
+ .option("-p, --prefix <prefix>", "vault path prefix", collectPrefix);
99
+ if (operation !== "show")
100
+ command.option("--if-match <revision>", "require this entry revision");
101
+ if (operation === "add")
102
+ command
103
+ .option("--request-id <id>", "stable non-secret write ID for retry; default generates one")
104
+ .option("--stdin", "read exact string value from stdin")
105
+ .option("--stdin-json", "read string or field map JSON from stdin")
106
+ .option("--expires-at <timestamp>", "UTC expiry for vault retrieval; omitted preserves current expiry")
107
+ .option("--no-expiry", "explicitly clear vault retrieval expiry")
108
+ .option("--env <name>", "saved environment variable name")
109
+ .option("--key-name <name>", "saved composed JSON key")
110
+ .option("--file-name <name>", "suggested filename; does not write a file");
111
+ command.action(async (options, cmd) => {
112
+ let writeId;
113
+ let sent = false;
114
+ try {
115
+ const name = entryName(options.name, invocationPrefix(cmd));
116
+ const revision = revisionNumber(options.ifMatch);
117
+ let result;
118
+ if (operation === "add") {
119
+ writeId = writeRequestId(options.requestId ?? randomUUID());
120
+ if (options.stdin && options.stdinJson)
121
+ throw new Error("Choose --stdin or --stdin-json");
122
+ if (!options.stdin && !options.stdinJson && !process.stdin.isTTY)
123
+ throw new Error("Noninteractive add requires --stdin or --stdin-json");
124
+ const expiresAt = expiryValue(options.expiresAt, options.expiry === false);
125
+ const raw = options.stdin || options.stdinJson ? await stdinValue() : await password({ message: "Secret value", mask: "*" }, { output: process.stderr });
126
+ const value = secretValue(raw, options.stdinJson);
127
+ console.error(`Write request ID: ${writeId}`);
128
+ sent = true;
129
+ result = await request("/v1/vault/entry", { name, type: "string", value, ...(expiresAt === undefined ? {} : { expiresAt }), ...(options.env === undefined ? {} : { env: options.env }), ...(options.keyName === undefined ? {} : { keyName: options.keyName }), ...(options.fileName === undefined ? {} : { fileName: options.fileName }) }, "PUT", revision, { "Idempotency-Key": writeId });
130
+ const receipt = writeReceipt(result, writeId);
131
+ if (receipt.entry.name !== name || typeof result.replayed !== "boolean")
132
+ throw new Error("Invalid vault write receipt");
133
+ result.entry = receipt.entry;
134
+ }
135
+ else if (operation === "restore")
136
+ result = await request("/v1/vault/restore", { name }, "POST", revision);
137
+ else
138
+ result = await request(`/v1/vault/entry?name=${encodeURIComponent(name)}`, undefined, operation === "show" ? "GET" : "DELETE", revision);
139
+ process.stdout.write(JSON.stringify(operation === "add" ? { ...metadata(result, name), requestId: writeId, replayed: result.replayed } : metadata(result, name), null, 2) + "\n");
140
+ }
141
+ catch (error) {
142
+ // Parsing and transport wrappers supply fixed messages; do not emit arbitrary prompt/decoder diagnostics.
143
+ const message = error instanceof Error && /^(Vault |Invalid |Expected |Choose |Noninteractive |Secret |Expected an entry)/.test(error.message) ? error.message : "Vault operation failed";
144
+ console.error(message);
145
+ if (sent && writeId)
146
+ console.error(`Write outcome unknown. Request ID: ${writeId}. An HTTP error does not prove this operation never committed. Use vault${vaultScope() ? ' --scope ' + vaultScope() : ''} write-status --request-id ${writeId}; missing status is not proof of failure. Retry only identical input and revision with this ID within its original 30-day retention window.`);
147
+ process.exitCode = 1;
148
+ }
149
+ });
150
+ }
151
+ }
@@ -0,0 +1,6 @@
1
+ import type { Command } from 'commander';
2
+ export declare function validateOtpResponse(result: unknown): {
3
+ code: string;
4
+ validUntil: string;
5
+ };
6
+ export declare function registerVaultOtp(vault: Command): void;