@dreamlake/dreamlake-cli 0.88.1 → 0.90.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (541) hide show
  1. package/dist/api/access.d.ts +83 -0
  2. package/dist/api/access.js +77 -0
  3. package/dist/api/agent.d.ts +156 -0
  4. package/dist/api/agent.js +111 -0
  5. package/dist/api/browser.d.ts +90 -0
  6. package/dist/api/browser.js +102 -0
  7. package/dist/api/client.d.ts +54 -0
  8. package/dist/api/client.js +102 -0
  9. package/dist/api/common.d.ts +28 -0
  10. package/dist/api/common.js +16 -0
  11. package/dist/api/content.d.ts +195 -0
  12. package/dist/api/content.js +147 -0
  13. package/dist/api/execution.d.ts +84 -0
  14. package/dist/api/execution.js +73 -0
  15. package/dist/api/http.d.ts +19 -0
  16. package/dist/api/http.js +66 -0
  17. package/dist/api/index.d.ts +2362 -0
  18. package/dist/api/index.js +116 -0
  19. package/dist/api/infra.d.ts +2 -0
  20. package/dist/api/infra.js +2 -0
  21. package/dist/api/jobs.d.ts +2 -0
  22. package/dist/api/jobs.js +2 -0
  23. package/dist/api/layout.d.ts +2 -0
  24. package/dist/api/layout.js +2 -0
  25. package/dist/api/library-edit.d.ts +3 -0
  26. package/dist/api/library-edit.js +3 -0
  27. package/dist/api/library-manifest.d.ts +2 -0
  28. package/dist/api/library-manifest.js +2 -0
  29. package/dist/api/note-character-plan.d.ts +2 -0
  30. package/dist/api/note-character-plan.js +2 -0
  31. package/dist/api/note-editing.d.ts +2 -0
  32. package/dist/api/note-editing.js +2 -0
  33. package/dist/api/note-edits.d.ts +21 -0
  34. package/dist/api/note-edits.js +10 -0
  35. package/dist/api/note-events.d.ts +5 -0
  36. package/dist/api/note-events.js +11 -0
  37. package/dist/api/note-files.d.ts +102 -0
  38. package/dist/api/note-files.js +107 -0
  39. package/dist/api/note-html-read.d.ts +2 -0
  40. package/dist/api/note-html-read.js +2 -0
  41. package/dist/api/note-html.d.ts +2 -0
  42. package/dist/api/note-html.js +2 -0
  43. package/dist/api/note-linger.d.ts +83 -0
  44. package/dist/api/note-linger.js +270 -0
  45. package/dist/api/note-presence.d.ts +82 -0
  46. package/dist/api/note-presence.js +72 -0
  47. package/dist/api/note-toc.d.ts +2 -0
  48. package/dist/api/note-toc.js +2 -0
  49. package/dist/api/notes.d.ts +329 -0
  50. package/dist/api/notes.js +209 -0
  51. package/dist/api/open-resources.d.ts +27 -0
  52. package/dist/api/open-resources.js +102 -0
  53. package/dist/api/ownership.d.ts +12 -0
  54. package/dist/api/ownership.js +24 -0
  55. package/dist/api/platform.d.ts +83 -0
  56. package/dist/api/platform.js +56 -0
  57. package/dist/api/presigned-transfer.d.ts +2 -0
  58. package/dist/api/presigned-transfer.js +2 -0
  59. package/dist/api/registered-runs.d.ts +48 -0
  60. package/dist/api/registered-runs.js +33 -0
  61. package/dist/api/sessions.d.ts +299 -0
  62. package/dist/api/sessions.js +105 -0
  63. package/dist/api/storage.d.ts +46 -0
  64. package/dist/api/storage.js +34 -0
  65. package/dist/api/streams.d.ts +18 -0
  66. package/dist/api/streams.js +70 -0
  67. package/dist/api/vault.d.ts +93 -0
  68. package/dist/api/vault.js +79 -0
  69. package/dist/api/workspace.d.ts +180 -0
  70. package/dist/api/workspace.js +146 -0
  71. package/dist/cli/agent-identity.d.ts +4 -0
  72. package/dist/cli/agent-identity.js +21 -0
  73. package/dist/cli/agents/identity.d.ts +50 -0
  74. package/dist/cli/agents/identity.js +105 -0
  75. package/dist/cli/agents/index.d.ts +31 -0
  76. package/dist/cli/agents/index.js +580 -0
  77. package/dist/cli/agents/manage.d.ts +43 -0
  78. package/dist/cli/agents/manage.js +376 -0
  79. package/dist/cli/agents/spec.d.ts +104 -0
  80. package/dist/cli/agents/spec.js +280 -0
  81. package/dist/cli/agents/web.d.ts +7 -0
  82. package/dist/cli/agents/web.js +109 -0
  83. package/dist/cli/artifact/incremental.d.ts +21 -0
  84. package/dist/cli/artifact/incremental.js +80 -0
  85. package/dist/cli/artifact/index.d.ts +52 -0
  86. package/dist/cli/artifact/index.js +405 -0
  87. package/dist/cli/artifact/meta.d.ts +69 -0
  88. package/dist/cli/artifact/meta.js +189 -0
  89. package/dist/cli/auth/commands.d.ts +29 -0
  90. package/dist/cli/auth/commands.js +327 -0
  91. package/dist/cli/auth/constants.d.ts +13 -0
  92. package/dist/cli/auth/constants.js +18 -0
  93. package/dist/cli/auth/credentials.d.ts +37 -0
  94. package/dist/cli/auth/credentials.js +155 -0
  95. package/dist/cli/auth/device-flow.d.ts +32 -0
  96. package/dist/cli/auth/device-flow.js +154 -0
  97. package/dist/cli/auth/device-secret.d.ts +6 -0
  98. package/dist/cli/auth/device-secret.js +26 -0
  99. package/dist/cli/auth/machine.d.ts +15 -0
  100. package/dist/cli/auth/machine.js +126 -0
  101. package/dist/cli/auth/materialized.d.ts +32 -0
  102. package/dist/cli/auth/materialized.js +102 -0
  103. package/dist/cli/auth/migrate.d.ts +10 -0
  104. package/dist/cli/auth/migrate.js +75 -0
  105. package/dist/cli/client.d.ts +102 -0
  106. package/dist/cli/client.js +206 -0
  107. package/dist/cli/collection-list.d.ts +3 -0
  108. package/dist/cli/collection-list.js +25 -0
  109. package/dist/cli/compat/ctx.d.ts +26 -0
  110. package/dist/cli/compat/ctx.js +76 -0
  111. package/dist/cli/compat/dreamdb-wasm-embedded.d.ts +2 -0
  112. package/dist/cli/compat/dreamdb-wasm-embedded.js +8 -0
  113. package/dist/cli/compat/dreamdb-wasm.d.ts +1 -0
  114. package/dist/cli/compat/dreamdb-wasm.js +26 -0
  115. package/dist/cli/compat/dreamdb.d.ts +112 -0
  116. package/dist/cli/compat/dreamdb.js +219 -0
  117. package/dist/cli/compat/flags.d.ts +2 -0
  118. package/dist/cli/compat/flags.js +13 -0
  119. package/dist/cli/compat/http.d.ts +23 -0
  120. package/dist/cli/compat/http.js +137 -0
  121. package/dist/cli/compat/presignedTransfer.d.ts +139 -0
  122. package/dist/cli/compat/presignedTransfer.js +580 -0
  123. package/dist/cli/compat/s3-backend.d.ts +73 -0
  124. package/dist/cli/compat/s3-backend.js +132 -0
  125. package/dist/cli/config.d.ts +22 -0
  126. package/dist/cli/config.js +96 -0
  127. package/dist/cli/connection/dto.d.ts +159 -0
  128. package/dist/cli/connection/dto.js +497 -0
  129. package/dist/cli/connection/index.d.ts +50 -0
  130. package/dist/cli/connection/index.js +413 -0
  131. package/dist/cli/connection/oauth.d.ts +23 -0
  132. package/dist/cli/connection/oauth.js +290 -0
  133. package/dist/cli/connection/write.d.ts +47 -0
  134. package/dist/cli/connection/write.js +573 -0
  135. package/dist/cli/create/index.d.ts +19 -0
  136. package/dist/cli/create/index.js +209 -0
  137. package/dist/cli/declare/index.d.ts +29 -0
  138. package/dist/cli/declare/index.js +304 -0
  139. package/dist/cli/delete/index.d.ts +18 -0
  140. package/dist/cli/delete/index.js +232 -0
  141. package/dist/cli/download/index.d.ts +9 -0
  142. package/dist/cli/download/index.js +128 -0
  143. package/dist/cli/env/compose.d.ts +88 -0
  144. package/dist/cli/env/compose.js +402 -0
  145. package/dist/cli/env/index.d.ts +176 -0
  146. package/dist/cli/env/index.js +1011 -0
  147. package/dist/cli/experiments/index.d.ts +11 -0
  148. package/dist/cli/experiments/index.js +168 -0
  149. package/dist/cli/glob.d.ts +1 -0
  150. package/dist/cli/glob.js +45 -0
  151. package/dist/cli/graphql-helpers.d.ts +23 -0
  152. package/dist/cli/graphql-helpers.js +42 -0
  153. package/dist/cli/graphql.d.ts +10 -0
  154. package/dist/cli/graphql.js +47 -0
  155. package/dist/cli/help-examples.generated.d.ts +1 -0
  156. package/dist/cli/help-examples.generated.js +192 -0
  157. package/dist/cli/helpers.d.ts +8 -0
  158. package/dist/cli/helpers.js +106 -0
  159. package/dist/cli/hosts/api.d.ts +29 -0
  160. package/dist/cli/hosts/api.js +54 -0
  161. package/dist/cli/hosts/bootstrap-source.d.ts +1 -0
  162. package/dist/cli/hosts/bootstrap-source.js +2 -0
  163. package/dist/cli/hosts/catalog.d.ts +26 -0
  164. package/dist/cli/hosts/catalog.js +55 -0
  165. package/dist/cli/hosts/config.d.ts +45 -0
  166. package/dist/cli/hosts/config.js +179 -0
  167. package/dist/cli/hosts/credentials.d.ts +19 -0
  168. package/dist/cli/hosts/credentials.js +173 -0
  169. package/dist/cli/hosts/enroll.d.ts +17 -0
  170. package/dist/cli/hosts/enroll.js +109 -0
  171. package/dist/cli/hosts/enrollments.d.ts +25 -0
  172. package/dist/cli/hosts/enrollments.js +54 -0
  173. package/dist/cli/hosts/index.d.ts +6 -0
  174. package/dist/cli/hosts/index.js +279 -0
  175. package/dist/cli/hosts/inventory.d.ts +40 -0
  176. package/dist/cli/hosts/inventory.js +91 -0
  177. package/dist/cli/hosts/lifecycle.d.ts +15 -0
  178. package/dist/cli/hosts/lifecycle.js +108 -0
  179. package/dist/cli/hosts/metrics-source.d.ts +12 -0
  180. package/dist/cli/hosts/metrics-source.js +89 -0
  181. package/dist/cli/hosts/observations.d.ts +39 -0
  182. package/dist/cli/hosts/observations.js +102 -0
  183. package/dist/cli/hosts/remote.d.ts +5 -0
  184. package/dist/cli/hosts/remote.js +66 -0
  185. package/dist/cli/hosts/ssh.d.ts +63 -0
  186. package/dist/cli/hosts/ssh.js +276 -0
  187. package/dist/cli/index.d.ts +1 -0
  188. package/dist/cli/index.js +288 -0
  189. package/dist/cli/infra/api.d.ts +95 -0
  190. package/dist/cli/infra/api.js +291 -0
  191. package/dist/cli/infra/index.d.ts +5 -0
  192. package/dist/cli/infra/index.js +102 -0
  193. package/dist/cli/infra/move.d.ts +15 -0
  194. package/dist/cli/infra/move.js +123 -0
  195. package/dist/cli/infra/transfer.d.ts +15 -0
  196. package/dist/cli/infra/transfer.js +280 -0
  197. package/dist/cli/jobs/api.d.ts +69 -0
  198. package/dist/cli/jobs/api.js +121 -0
  199. package/dist/cli/jobs/index.d.ts +5 -0
  200. package/dist/cli/jobs/index.js +140 -0
  201. package/dist/cli/lakeshore/index.d.ts +98 -0
  202. package/dist/cli/lakeshore/index.js +502 -0
  203. package/dist/cli/launch/index.d.ts +43 -0
  204. package/dist/cli/launch/index.js +270 -0
  205. package/dist/cli/layout/index.d.ts +2 -0
  206. package/dist/cli/layout/index.js +44 -0
  207. package/dist/cli/layout/transport.d.ts +12 -0
  208. package/dist/cli/layout/transport.js +70 -0
  209. package/dist/cli/library/add.d.ts +60 -0
  210. package/dist/cli/library/add.js +348 -0
  211. package/dist/cli/library/cache.d.ts +26 -0
  212. package/dist/cli/library/cache.js +88 -0
  213. package/dist/cli/library/config.d.ts +75 -0
  214. package/dist/cli/library/config.js +198 -0
  215. package/dist/cli/library/digest.d.ts +5 -0
  216. package/dist/cli/library/digest.js +19 -0
  217. package/dist/cli/library/discover.d.ts +87 -0
  218. package/dist/cli/library/discover.js +534 -0
  219. package/dist/cli/library/freshness.d.ts +35 -0
  220. package/dist/cli/library/freshness.js +109 -0
  221. package/dist/cli/library/generation.d.ts +35 -0
  222. package/dist/cli/library/generation.js +211 -0
  223. package/dist/cli/library/index.d.ts +2 -0
  224. package/dist/cli/library/index.js +36 -0
  225. package/dist/cli/library/info.d.ts +69 -0
  226. package/dist/cli/library/info.js +311 -0
  227. package/dist/cli/library/list.d.ts +33 -0
  228. package/dist/cli/library/list.js +86 -0
  229. package/dist/cli/library/manifest.d.ts +81 -0
  230. package/dist/cli/library/manifest.js +200 -0
  231. package/dist/cli/library/manifestCache.d.ts +45 -0
  232. package/dist/cli/library/manifestCache.js +169 -0
  233. package/dist/cli/library/pull.d.ts +30 -0
  234. package/dist/cli/library/pull.js +438 -0
  235. package/dist/cli/library/push.d.ts +72 -0
  236. package/dist/cli/library/push.js +642 -0
  237. package/dist/cli/library/rm.d.ts +31 -0
  238. package/dist/cli/library/rm.js +200 -0
  239. package/dist/cli/library/search.d.ts +18 -0
  240. package/dist/cli/library/search.js +181 -0
  241. package/dist/cli/library/stat.d.ts +15 -0
  242. package/dist/cli/library/stat.js +127 -0
  243. package/dist/cli/library/tools.d.ts +104 -0
  244. package/dist/cli/library/tools.js +163 -0
  245. package/dist/cli/library/wire.d.ts +47 -0
  246. package/dist/cli/library/wire.js +120 -0
  247. package/dist/cli/list/index.d.ts +26 -0
  248. package/dist/cli/list/index.js +256 -0
  249. package/dist/cli/notes/api-transport.d.ts +5 -0
  250. package/dist/cli/notes/api-transport.js +20 -0
  251. package/dist/cli/notes/character-plan.d.ts +22 -0
  252. package/dist/cli/notes/character-plan.js +232 -0
  253. package/dist/cli/notes/document.d.ts +73 -0
  254. package/dist/cli/notes/document.js +306 -0
  255. package/dist/cli/notes/edit-commands.d.ts +106 -0
  256. package/dist/cli/notes/edit-commands.js +623 -0
  257. package/dist/cli/notes/editing.d.ts +81 -0
  258. package/dist/cli/notes/editing.js +305 -0
  259. package/dist/cli/notes/events.d.ts +36 -0
  260. package/dist/cli/notes/events.js +54 -0
  261. package/dist/cli/notes/files-commands.d.ts +97 -0
  262. package/dist/cli/notes/files-commands.js +548 -0
  263. package/dist/cli/notes/html-read.d.ts +9 -0
  264. package/dist/cli/notes/html-read.js +90 -0
  265. package/dist/cli/notes/html.d.ts +73 -0
  266. package/dist/cli/notes/html.js +381 -0
  267. package/dist/cli/notes/index.d.ts +123 -0
  268. package/dist/cli/notes/index.js +1300 -0
  269. package/dist/cli/notes/linger.d.ts +4 -0
  270. package/dist/cli/notes/linger.js +96 -0
  271. package/dist/cli/notes/media-commands.d.ts +5 -0
  272. package/dist/cli/notes/media-commands.js +51 -0
  273. package/dist/cli/notes/move-command.d.ts +83 -0
  274. package/dist/cli/notes/move-command.js +259 -0
  275. package/dist/cli/notes/rm-command.d.ts +22 -0
  276. package/dist/cli/notes/rm-command.js +110 -0
  277. package/dist/cli/notes/select-command.d.ts +12 -0
  278. package/dist/cli/notes/select-command.js +63 -0
  279. package/dist/cli/notes/suggest-diff.d.ts +56 -0
  280. package/dist/cli/notes/suggest-diff.js +311 -0
  281. package/dist/cli/notes/toc.d.ts +38 -0
  282. package/dist/cli/notes/toc.js +144 -0
  283. package/dist/cli/notes/transfer-command.d.ts +6 -0
  284. package/dist/cli/notes/transfer-command.js +9 -0
  285. package/dist/cli/notes/version-commands.d.ts +19 -0
  286. package/dist/cli/notes/version-commands.js +178 -0
  287. package/dist/cli/nymph/index.d.ts +74 -0
  288. package/dist/cli/nymph/index.js +349 -0
  289. package/dist/cli/org/index.d.ts +34 -0
  290. package/dist/cli/org/index.js +341 -0
  291. package/dist/cli/ownership/index.d.ts +12 -0
  292. package/dist/cli/ownership/index.js +122 -0
  293. package/dist/cli/ownership/metadata-transfer.d.ts +20 -0
  294. package/dist/cli/ownership/metadata-transfer.js +159 -0
  295. package/dist/cli/page/index.d.ts +58 -0
  296. package/dist/cli/page/index.js +387 -0
  297. package/dist/cli/pipeline/index.d.ts +69 -0
  298. package/dist/cli/pipeline/index.js +604 -0
  299. package/dist/cli/progress.d.ts +60 -0
  300. package/dist/cli/progress.js +276 -0
  301. package/dist/cli/project/attachments.d.ts +10 -0
  302. package/dist/cli/project/attachments.js +39 -0
  303. package/dist/cli/project/grants.d.ts +10 -0
  304. package/dist/cli/project/grants.js +39 -0
  305. package/dist/cli/project/index.d.ts +8 -0
  306. package/dist/cli/project/index.js +92 -0
  307. package/dist/cli/project/move.d.ts +57 -0
  308. package/dist/cli/project/move.js +242 -0
  309. package/dist/cli/project/output.d.ts +2 -0
  310. package/dist/cli/project/output.js +29 -0
  311. package/dist/cli/project/stream.d.ts +55 -0
  312. package/dist/cli/project/stream.js +207 -0
  313. package/dist/cli/project/transfer-preview.d.ts +8 -0
  314. package/dist/cli/project/transfer-preview.js +10 -0
  315. package/dist/cli/prompt.d.ts +1 -0
  316. package/dist/cli/prompt.js +17 -0
  317. package/dist/cli/provider/dreamdir.d.ts +52 -0
  318. package/dist/cli/provider/dreamdir.js +138 -0
  319. package/dist/cli/provider/index.d.ts +4 -0
  320. package/dist/cli/provider/index.js +419 -0
  321. package/dist/cli/provider/jump-worker.d.ts +9 -0
  322. package/dist/cli/provider/jump-worker.js +141 -0
  323. package/dist/cli/provider/lifecycle.d.ts +149 -0
  324. package/dist/cli/provider/lifecycle.js +1390 -0
  325. package/dist/cli/provider/machine.d.ts +17 -0
  326. package/dist/cli/provider/machine.js +116 -0
  327. package/dist/cli/provider/ssh.d.ts +105 -0
  328. package/dist/cli/provider/ssh.js +305 -0
  329. package/dist/cli/provider/terraform.d.ts +140 -0
  330. package/dist/cli/provider/terraform.js +288 -0
  331. package/dist/cli/providers/index.d.ts +18 -0
  332. package/dist/cli/providers/index.js +422 -0
  333. package/dist/cli/python.d.ts +61 -0
  334. package/dist/cli/python.js +255 -0
  335. package/dist/cli/queues/index.d.ts +33 -0
  336. package/dist/cli/queues/index.js +248 -0
  337. package/dist/cli/queues/slurm.d.ts +10 -0
  338. package/dist/cli/queues/slurm.js +134 -0
  339. package/dist/cli/resources.d.ts +72 -0
  340. package/dist/cli/resources.js +137 -0
  341. package/dist/cli/run/index.d.ts +15 -0
  342. package/dist/cli/run/index.js +163 -0
  343. package/dist/cli/run/input.d.ts +34 -0
  344. package/dist/cli/run/input.js +135 -0
  345. package/dist/cli/run/recovery.d.ts +2 -0
  346. package/dist/cli/run/recovery.js +18 -0
  347. package/dist/cli/run/setup.d.ts +3 -0
  348. package/dist/cli/run/setup.js +62 -0
  349. package/dist/cli/runconfig/index.d.ts +12 -0
  350. package/dist/cli/runconfig/index.js +130 -0
  351. package/dist/cli/runnable/index.d.ts +35 -0
  352. package/dist/cli/runnable/index.js +575 -0
  353. package/dist/cli/runnable/path.d.ts +115 -0
  354. package/dist/cli/runnable/path.js +288 -0
  355. package/dist/cli/runnable/run.d.ts +91 -0
  356. package/dist/cli/runnable/run.js +239 -0
  357. package/dist/cli/runnable/upload.d.ts +43 -0
  358. package/dist/cli/runnable/upload.js +342 -0
  359. package/dist/cli/runnable/worker.d.ts +1 -0
  360. package/dist/cli/runnable/worker.js +44 -0
  361. package/dist/cli/schemas/workflow-spec.schema.json +335 -0
  362. package/dist/cli/self-update/index.d.ts +5 -0
  363. package/dist/cli/self-update/index.js +107 -0
  364. package/dist/cli/self-update/install.d.ts +60 -0
  365. package/dist/cli/self-update/install.js +428 -0
  366. package/dist/cli/self-update/paths.d.ts +40 -0
  367. package/dist/cli/self-update/paths.js +87 -0
  368. package/dist/cli/self-update/releases.d.ts +41 -0
  369. package/dist/cli/self-update/releases.js +153 -0
  370. package/dist/cli/self-update/settings.d.ts +16 -0
  371. package/dist/cli/self-update/settings.js +68 -0
  372. package/dist/cli/self-update/update.d.ts +18 -0
  373. package/dist/cli/self-update/update.js +241 -0
  374. package/dist/cli/service-accounts/index.d.ts +3 -0
  375. package/dist/cli/service-accounts/index.js +149 -0
  376. package/dist/cli/session-affiliation.d.ts +26 -0
  377. package/dist/cli/session-affiliation.js +135 -0
  378. package/dist/cli/sessions/affiliation.d.ts +8 -0
  379. package/dist/cli/sessions/affiliation.js +66 -0
  380. package/dist/cli/sessions/api.d.ts +55 -0
  381. package/dist/cli/sessions/api.js +88 -0
  382. package/dist/cli/sessions/control.d.ts +6 -0
  383. package/dist/cli/sessions/control.js +159 -0
  384. package/dist/cli/sessions/conversation.d.ts +15 -0
  385. package/dist/cli/sessions/conversation.js +118 -0
  386. package/dist/cli/sessions/index.d.ts +2 -0
  387. package/dist/cli/sessions/index.js +209 -0
  388. package/dist/cli/sessions/managed.d.ts +39 -0
  389. package/dist/cli/sessions/managed.js +63 -0
  390. package/dist/cli/sessions/redaction.d.ts +2 -0
  391. package/dist/cli/sessions/redaction.js +11 -0
  392. package/dist/cli/sessions/runner/exec.d.ts +108 -0
  393. package/dist/cli/sessions/runner/exec.js +335 -0
  394. package/dist/cli/sessions/runner/journal.d.ts +26 -0
  395. package/dist/cli/sessions/runner/journal.js +49 -0
  396. package/dist/cli/sessions/runner/native.d.ts +48 -0
  397. package/dist/cli/sessions/runner/native.js +170 -0
  398. package/dist/cli/sessions/runner/pod.d.ts +30 -0
  399. package/dist/cli/sessions/runner/pod.js +129 -0
  400. package/dist/cli/sessions/runner/serve.d.ts +85 -0
  401. package/dist/cli/sessions/runner/serve.js +558 -0
  402. package/dist/cli/sessions/sync.d.ts +47 -0
  403. package/dist/cli/sessions/sync.js +80 -0
  404. package/dist/cli/sessions/transport.d.ts +14 -0
  405. package/dist/cli/sessions/transport.js +116 -0
  406. package/dist/cli/share.d.ts +15 -0
  407. package/dist/cli/share.js +139 -0
  408. package/dist/cli/skill/catalog.d.ts +141 -0
  409. package/dist/cli/skill/catalog.js +442 -0
  410. package/dist/cli/skill/files.d.ts +89 -0
  411. package/dist/cli/skill/files.js +264 -0
  412. package/dist/cli/skill/index.d.ts +268 -0
  413. package/dist/cli/skill/index.js +1216 -0
  414. package/dist/cli/skill/manifest.d.ts +30 -0
  415. package/dist/cli/skill/manifest.js +101 -0
  416. package/dist/cli/skill/prefs.d.ts +9 -0
  417. package/dist/cli/skill/prefs.js +32 -0
  418. package/dist/cli/skill/reminders.d.ts +15 -0
  419. package/dist/cli/skill/reminders.js +105 -0
  420. package/dist/cli/skill/tar.d.ts +17 -0
  421. package/dist/cli/skill/tar.js +195 -0
  422. package/dist/cli/snapshot/index.d.ts +24 -0
  423. package/dist/cli/snapshot/index.js +146 -0
  424. package/dist/cli/source/access.d.ts +45 -0
  425. package/dist/cli/source/access.js +563 -0
  426. package/dist/cli/source/control.d.ts +103 -0
  427. package/dist/cli/source/control.js +546 -0
  428. package/dist/cli/source/delete.d.ts +89 -0
  429. package/dist/cli/source/delete.js +463 -0
  430. package/dist/cli/source/index.d.ts +288 -0
  431. package/dist/cli/source/index.js +1348 -0
  432. package/dist/cli/source/share.d.ts +65 -0
  433. package/dist/cli/source/share.js +530 -0
  434. package/dist/cli/source/upload.d.ts +62 -0
  435. package/dist/cli/source/upload.js +258 -0
  436. package/dist/cli/source/write.d.ts +77 -0
  437. package/dist/cli/source/write.js +335 -0
  438. package/dist/cli/spawn.d.ts +28 -0
  439. package/dist/cli/spawn.js +81 -0
  440. package/dist/cli/target.d.ts +22 -0
  441. package/dist/cli/target.js +85 -0
  442. package/dist/cli/tasks/index.d.ts +38 -0
  443. package/dist/cli/tasks/index.js +365 -0
  444. package/dist/cli/team/index.d.ts +37 -0
  445. package/dist/cli/team/index.js +407 -0
  446. package/dist/cli/telemetry.d.ts +23 -0
  447. package/dist/cli/telemetry.js +262 -0
  448. package/dist/cli/telemetryJournal.d.ts +26 -0
  449. package/dist/cli/telemetryJournal.js +104 -0
  450. package/dist/cli/update/index.d.ts +21 -0
  451. package/dist/cli/update/index.js +284 -0
  452. package/dist/cli/upload/index.d.ts +11 -0
  453. package/dist/cli/upload/index.js +261 -0
  454. package/dist/cli/upload/kinds.d.ts +10 -0
  455. package/dist/cli/upload/kinds.js +85 -0
  456. package/dist/cli/upload/multipart.d.ts +21 -0
  457. package/dist/cli/upload/multipart.js +248 -0
  458. package/dist/cli/vault/affected-preview.d.ts +15 -0
  459. package/dist/cli/vault/affected-preview.js +38 -0
  460. package/dist/cli/vault/cloud.d.ts +55 -0
  461. package/dist/cli/vault/cloud.js +287 -0
  462. package/dist/cli/vault/format.d.ts +18 -0
  463. package/dist/cli/vault/format.js +104 -0
  464. package/dist/cli/vault/hostCredentials.d.ts +21 -0
  465. package/dist/cli/vault/hostCredentials.js +71 -0
  466. package/dist/cli/vault/hostSupersessions.d.ts +18 -0
  467. package/dist/cli/vault/hostSupersessions.js +68 -0
  468. package/dist/cli/vault/import.d.ts +3 -0
  469. package/dist/cli/vault/import.js +79 -0
  470. package/dist/cli/vault/index.d.ts +14 -0
  471. package/dist/cli/vault/index.js +225 -0
  472. package/dist/cli/vault/keys.d.ts +5 -0
  473. package/dist/cli/vault/keys.js +165 -0
  474. package/dist/cli/vault/kms.d.ts +6 -0
  475. package/dist/cli/vault/kms.js +169 -0
  476. package/dist/cli/vault/list.d.ts +13 -0
  477. package/dist/cli/vault/list.js +60 -0
  478. package/dist/cli/vault/listView.d.ts +21 -0
  479. package/dist/cli/vault/listView.js +123 -0
  480. package/dist/cli/vault/managementMetadata.d.ts +2 -0
  481. package/dist/cli/vault/managementMetadata.js +23 -0
  482. package/dist/cli/vault/mutations.d.ts +8 -0
  483. package/dist/cli/vault/mutations.js +151 -0
  484. package/dist/cli/vault/otp.d.ts +6 -0
  485. package/dist/cli/vault/otp.js +62 -0
  486. package/dist/cli/vault/otpIntent.d.ts +23 -0
  487. package/dist/cli/vault/otpIntent.js +76 -0
  488. package/dist/cli/vault/passImport.d.ts +25 -0
  489. package/dist/cli/vault/passImport.js +129 -0
  490. package/dist/cli/vault/passOtp.d.ts +51 -0
  491. package/dist/cli/vault/passOtp.js +101 -0
  492. package/dist/cli/vault/passStore.d.ts +26 -0
  493. package/dist/cli/vault/passStore.js +134 -0
  494. package/dist/cli/vault/passwordCommand.d.ts +39 -0
  495. package/dist/cli/vault/passwordCommand.js +101 -0
  496. package/dist/cli/vault/passwordProbe.d.ts +27 -0
  497. package/dist/cli/vault/passwordProbe.js +282 -0
  498. package/dist/cli/vault/passwordRotation.d.ts +9 -0
  499. package/dist/cli/vault/passwordRotation.js +273 -0
  500. package/dist/cli/vault/rotationApi.d.ts +13 -0
  501. package/dist/cli/vault/rotationApi.js +58 -0
  502. package/dist/cli/vault/rotationCommand.d.ts +2 -0
  503. package/dist/cli/vault/rotationCommand.js +75 -0
  504. package/dist/cli/vault/rotationEngine.d.ts +19 -0
  505. package/dist/cli/vault/rotationEngine.js +65 -0
  506. package/dist/cli/vault/rotationHelperSource.d.ts +2 -0
  507. package/dist/cli/vault/rotationHelperSource.js +3 -0
  508. package/dist/cli/vault/rotationInput.d.ts +11 -0
  509. package/dist/cli/vault/rotationInput.js +48 -0
  510. package/dist/cli/vault/rotationJournal.d.ts +16 -0
  511. package/dist/cli/vault/rotationJournal.js +183 -0
  512. package/dist/cli/vault/rotationKeys.d.ts +4 -0
  513. package/dist/cli/vault/rotationKeys.js +48 -0
  514. package/dist/cli/vault/rotationPrepare.d.ts +17 -0
  515. package/dist/cli/vault/rotationPrepare.js +108 -0
  516. package/dist/cli/vault/rotationRemote.d.ts +33 -0
  517. package/dist/cli/vault/rotationRemote.js +156 -0
  518. package/dist/cli/vault/rotationState.d.ts +42 -0
  519. package/dist/cli/vault/rotationState.js +115 -0
  520. package/dist/cli/vault/rotationTransport.d.ts +18 -0
  521. package/dist/cli/vault/rotationTransport.js +71 -0
  522. package/dist/cli/vault/sshSource.d.ts +18 -0
  523. package/dist/cli/vault/sshSource.js +196 -0
  524. package/dist/cli/vault/sshSync.d.ts +17 -0
  525. package/dist/cli/vault/sshSync.js +224 -0
  526. package/dist/cli/vault/sshTransfer.d.ts +22 -0
  527. package/dist/cli/vault/sshTransfer.js +140 -0
  528. package/dist/cli/vault/terraformState.d.ts +66 -0
  529. package/dist/cli/vault/terraformState.js +252 -0
  530. package/dist/cli/vault/terraformStateCommand.d.ts +2 -0
  531. package/dist/cli/vault/terraformStateCommand.js +61 -0
  532. package/dist/cli/vault/tree.d.ts +43 -0
  533. package/dist/cli/vault/tree.js +292 -0
  534. package/dist/cli/version.d.ts +1 -0
  535. package/dist/cli/version.js +9 -0
  536. package/dist/cli/workflow/index.d.ts +76 -0
  537. package/dist/cli/workflow/index.js +826 -0
  538. package/dist/cli/workflow/validate.d.ts +19 -0
  539. package/dist/cli/workflow/validate.js +353 -0
  540. package/dist/package.json +1 -0
  541. package/package.json +28 -10
@@ -0,0 +1,62 @@
1
+ import { otpIdentity, otpIntent } from './otpIntent.js';
2
+ import { resolveRemote, resolveToken } from '../config.js';
3
+ import { collectPrefix, invocationPrefix, request } from './index.js';
4
+ import { entryName } from './mutations.js';
5
+ export function validateOtpResponse(result) {
6
+ const item = result;
7
+ if (!item || typeof item.code !== 'string' || !/^[0-9]{6,8}$/.test(item.code) || typeof item.validUntil !== 'string' || !/^\d{4}-\d\d-\d\dT\d\d:\d\d:\d\d\.\d{3}Z$/.test(item.validUntil) || !Number.isFinite(Date.parse(item.validUntil)) || new Date(item.validUntil).toISOString() !== item.validUntil || Date.parse(item.validUntil) <= Date.now())
8
+ throw new Error('Invalid or expired OTP response');
9
+ return { code: item.code, validUntil: item.validUntil };
10
+ }
11
+ export function registerVaultOtp(vault) {
12
+ vault.command('otp').description('explicitly reveal TOTP or issue/replay HOTP (owner only)')
13
+ .requiredOption('-n, --name <name>', 'one OTP entry path')
14
+ .option('-p, --prefix <prefix>', 'vault path prefix', collectPrefix)
15
+ .option('--to-json', 'emit OTP result as JSON')
16
+ .option('--request-file <path>', 'durable metadata-only HOTP intent; reuse after uncertain responses')
17
+ .option('--activate', 'activate inactive HOTP without generating a code')
18
+ .option('--counter-owner <owner>', 'explicit HOTP authority: dreamlake')
19
+ .option('--if-match <revision>', 'current entry revision for activation')
20
+ .action(async (options, command) => {
21
+ try {
22
+ const name = entryName(options.name, invocationPrefix(command));
23
+ const token = resolveToken();
24
+ if (!token)
25
+ throw new Error('Owner session required');
26
+ const connection = { remote: resolveRemote(), token };
27
+ if (options.activate) {
28
+ if (options.requestFile || options.counterOwner !== 'dreamlake' || !/^[1-9][0-9]*$/.test(options.ifMatch ?? '') || !Number.isSafeInteger(Number(options.ifMatch)))
29
+ throw new Error('Invalid activation options');
30
+ const result = await request('/v1/vault/otp/activate', { name, expectedRevision: Number(options.ifMatch), counterOwner: options.counterOwner }, 'POST', undefined, {}, connection);
31
+ const entry = result?.entry;
32
+ if (entry?.name !== name || entry?.type !== 'hotp' || entry?.revision !== Number(options.ifMatch) + 1)
33
+ throw new Error('Invalid activation response');
34
+ process.stdout.write(JSON.stringify({ name, type: 'hotp', revision: entry.revision }) + '\n');
35
+ return;
36
+ }
37
+ if (options.counterOwner || options.ifMatch)
38
+ throw new Error('Activation options require --activate');
39
+ if (options.requestFile) {
40
+ const intent = await otpIntent(options.requestFile, { ...otpIdentity(connection.remote, connection.token), name }, () => request('/v1/vault/entry?name=' + encodeURIComponent(name), undefined, 'GET', undefined, {}, connection));
41
+ const result = await request('/v1/vault/otp', { name, entryId: intent.entryId, expectedRevision: intent.expectedRevision, requestId: intent.requestId }, 'POST', undefined, {}, connection);
42
+ if (result?.type !== 'hotp' || typeof result.code !== 'string' || !/^[0-9]{6,8}$/.test(result.code) || result.requestId !== intent.requestId || result.revision !== intent.expectedRevision + 1 || typeof result.replayed !== 'boolean' || typeof result.recoverUntil !== 'string' || !/^\d{4}-\d\d-\d\dT\d\d:\d\d:\d\d\.\d{3}Z$/.test(result.recoverUntil) || !Number.isFinite(Date.parse(result.recoverUntil)) || Date.parse(result.recoverUntil) <= Date.now())
43
+ throw new Error('Invalid HOTP response');
44
+ const safe = { type: 'hotp', code: result.code, requestId: result.requestId, revision: result.revision, replayed: result.replayed, recoverUntil: result.recoverUntil };
45
+ process.stdout.write(options.toJson ? JSON.stringify(safe) + '\n' : safe.code + '\n');
46
+ }
47
+ else {
48
+ const result = validateOtpResponse(await request('/v1/vault/otp', { name }, 'POST', undefined, {}, connection));
49
+ process.stdout.write(options.toJson ? JSON.stringify(result) + '\n' : result.code + '\n');
50
+ }
51
+ }
52
+ catch {
53
+ if (options.activate) {
54
+ process.stderr.write('HOTP activation failed: requires inactive SHA1, a 128-bit seed, explicit dreamlake ownership and current revision. Check metadata before retrying.\n');
55
+ process.exitCode = 1;
56
+ return;
57
+ }
58
+ process.stderr.write('OTP operation failed or outcome unknown. HOTP requires --request-file; after submission reuse the same file, never create a fresh intent to retry.\n');
59
+ process.exitCode = 1;
60
+ }
61
+ });
62
+ }
@@ -0,0 +1,23 @@
1
+ export type OtpIntent = {
2
+ version: 1;
3
+ origin: string;
4
+ account: string;
5
+ name: string;
6
+ entryId: string;
7
+ expectedRevision: number;
8
+ requestId: string;
9
+ };
10
+ export declare function otpIdentity(remote: string, token: string): {
11
+ origin: string;
12
+ account: string;
13
+ };
14
+ export declare function validateIntent(item: any, binding: {
15
+ origin: string;
16
+ account: string;
17
+ name: string;
18
+ }): OtpIntent;
19
+ export declare function otpIntent(file: string, binding: {
20
+ origin: string;
21
+ account: string;
22
+ name: string;
23
+ }, metadata: () => Promise<any>): Promise<OtpIntent>;
@@ -0,0 +1,76 @@
1
+ import { constants } from 'node:fs';
2
+ import { open } from 'node:fs/promises';
3
+ import { dirname } from 'node:path';
4
+ import { randomUUID } from 'node:crypto';
5
+ export function otpIdentity(remote, token) {
6
+ const url = new URL(remote);
7
+ if (url.username || url.password || url.search || url.hash || !['http:', 'https:'].includes(url.protocol) || url.protocol === 'http:' && !['localhost', '127.0.0.1', '[::1]'].includes(url.hostname))
8
+ throw new Error('Invalid OTP destination');
9
+ const account = JSON.parse(Buffer.from(token.split('.')[1] ?? '', 'base64url').toString()).sub;
10
+ if (typeof account !== 'string' || !account || account.length > 512)
11
+ throw new Error('Owner session required');
12
+ return { origin: url.toString().replace(/\/$/, ''), account };
13
+ }
14
+ export function validateIntent(item, binding) {
15
+ if (!item || Object.keys(item).sort().join(',') !== ['version', 'origin', 'account', 'name', 'entryId', 'expectedRevision', 'requestId'].sort().join(',') || item.version !== 1
16
+ || item.origin !== binding.origin || item.account !== binding.account || item.name !== binding.name || typeof item.entryId !== 'string' || !item.entryId || item.entryId.length > 128
17
+ || !Number.isSafeInteger(item.expectedRevision) || item.expectedRevision < 1 || typeof item.requestId !== 'string' || !/^[A-Za-z0-9_-]{1,128}$/.test(item.requestId))
18
+ throw new Error('Invalid or mismatched OTP request file');
19
+ return item;
20
+ }
21
+ export async function otpIntent(file, binding, metadata) {
22
+ async function syncDirectory() {
23
+ const directory = await open(dirname(file), constants.O_RDONLY | constants.O_DIRECTORY | constants.O_NOFOLLOW);
24
+ try {
25
+ await directory.sync();
26
+ }
27
+ finally {
28
+ await directory.close();
29
+ }
30
+ }
31
+ async function read() {
32
+ const handle = await open(file, constants.O_RDONLY | constants.O_NOFOLLOW | constants.O_NONBLOCK);
33
+ try {
34
+ const stat = await handle.stat();
35
+ if (!stat.isFile() || stat.nlink !== 1 || (stat.mode & 0o777) !== 0o600 || stat.uid !== process.getuid?.() || stat.size > 4096)
36
+ throw new Error('Unsafe OTP request file');
37
+ const intent = validateIntent(JSON.parse(await handle.readFile('utf8')), binding);
38
+ await handle.sync();
39
+ await syncDirectory();
40
+ return intent;
41
+ }
42
+ finally {
43
+ await handle.close();
44
+ }
45
+ }
46
+ try {
47
+ return await read();
48
+ }
49
+ catch (error) {
50
+ if (error.code !== 'ENOENT')
51
+ throw error;
52
+ }
53
+ const entry = (await metadata())?.entry;
54
+ if (!entry || entry.name !== binding.name || entry.type !== 'hotp' || entry.deleteAt)
55
+ throw new Error('HOTP entry required');
56
+ const intent = validateIntent({ version: 1, ...binding, entryId: entry.id, expectedRevision: entry.revision, requestId: randomUUID() }, binding);
57
+ let handle;
58
+ try {
59
+ handle = await open(file, constants.O_WRONLY | constants.O_CREAT | constants.O_EXCL | constants.O_NOFOLLOW, 0o600);
60
+ }
61
+ catch (error) {
62
+ if (error.code === 'EEXIST')
63
+ return read();
64
+ throw error;
65
+ }
66
+ try {
67
+ await handle.chmod(0o600);
68
+ await handle.writeFile(JSON.stringify(intent) + '\n');
69
+ await handle.sync();
70
+ }
71
+ finally {
72
+ await handle.close();
73
+ }
74
+ await syncDirectory();
75
+ return intent;
76
+ }
@@ -0,0 +1,25 @@
1
+ type Entry = {
2
+ path: string;
3
+ name: string;
4
+ status: string;
5
+ };
6
+ /** Only selected canonical paths, bounded regular files, no symlink ancestors. */
7
+ export declare function readPassCiphertext(root: string, path: string): Promise<Buffer>;
8
+ export declare function importPassOtp(options: {
9
+ store: string;
10
+ prefix: string;
11
+ select: string[];
12
+ gpgHome?: string;
13
+ hotpOwner?: string;
14
+ }, consent?: (entries: Entry[]) => Promise<boolean>, isCancelled?: () => boolean): Promise<{
15
+ cancelled: boolean;
16
+ uploaded: boolean;
17
+ entries: Entry[];
18
+ error?: undefined;
19
+ } | {
20
+ cancelled: boolean;
21
+ uploaded: boolean;
22
+ error: string;
23
+ entries: Entry[];
24
+ }>;
25
+ export {};
@@ -0,0 +1,129 @@
1
+ import { constants } from 'node:fs';
2
+ import { lstat, open, realpath } from 'node:fs/promises';
3
+ import { resolve } from 'node:path';
4
+ import { createHash } from 'node:crypto';
5
+ import { decrypt } from './passStore.js';
6
+ import { parseOtpUri } from './passOtp.js';
7
+ import { entryName } from './mutations.js';
8
+ import { request, VaultRequestError } from './index.js';
9
+ import { resolveRemote, resolveToken } from '../config.js';
10
+ /** Only selected canonical paths, bounded regular files, no symlink ancestors. */
11
+ export async function readPassCiphertext(root, path) {
12
+ const filePath = resolve(root, path + '.gpg');
13
+ if (await realpath(root) !== root || !(await lstat(root)).isDirectory() || await realpath(filePath) !== filePath)
14
+ throw new Error('Unsafe pass source');
15
+ const file = await open(filePath, constants.O_RDONLY | constants.O_NOFOLLOW | constants.O_NONBLOCK);
16
+ try {
17
+ const before = await file.stat();
18
+ if (!before.isFile() || before.size > 1048576)
19
+ throw new Error('Unsafe pass source');
20
+ const buffer = Buffer.alloc(1048577);
21
+ let total = 0;
22
+ while (total < buffer.length) {
23
+ const { bytesRead } = await file.read(buffer, total, buffer.length - total, null);
24
+ if (!bytesRead)
25
+ break;
26
+ total += bytesRead;
27
+ }
28
+ const after = await lstat(filePath);
29
+ if (total > 1048576 || before.dev !== after.dev || before.ino !== after.ino || before.mtimeMs !== after.mtimeMs || before.ctimeMs !== after.ctimeMs || await realpath(filePath) !== filePath) {
30
+ buffer.fill(0);
31
+ throw new Error('Pass source changed');
32
+ }
33
+ return buffer.subarray(0, total);
34
+ }
35
+ finally {
36
+ await file.close();
37
+ }
38
+ }
39
+ const hash = (bytes) => createHash('sha256').update(bytes).digest('hex');
40
+ export async function importPassOtp(options, consent, isCancelled = () => false) {
41
+ if (options.hotpOwner !== undefined && options.hotpOwner !== 'dreamlake')
42
+ throw new Error('HOTP owner must be dreamlake');
43
+ if (!options.prefix || !options.store)
44
+ throw new Error('Pass OTP import requires explicit --prefix and --store');
45
+ entryName('probe', options.prefix);
46
+ if (!Array.isArray(options.select) || !options.select.length || options.select.length > 100 || new Set(options.select).size !== options.select.length || options.select.some(p => !/^[A-Za-z0-9_-]+(?:\/[A-Za-z0-9_-]+)*$/.test(p)))
47
+ throw new Error('Pass OTP import requires unique canonical --select paths (maximum 100)');
48
+ const remote = resolveRemote(), token = resolveToken();
49
+ const url = new URL(remote);
50
+ if (url.username || url.password || url.search || url.hash || !['https:', 'http:'].includes(url.protocol) || url.protocol === 'http:' && !['localhost', '127.0.0.1', '[::1]'].includes(url.hostname))
51
+ throw new Error('Pass OTP import requires HTTPS or loopback HTTP');
52
+ if (!token)
53
+ throw new Error('Vault authentication required');
54
+ const root = resolve(options.store);
55
+ const entries = options.select.map(path => ({ path, name: entryName(path, options.prefix), status: 'not-attempted' }));
56
+ const prepared = [];
57
+ try {
58
+ // Complete validation before any write; adjacent ordinary passwords never leave memory.
59
+ for (const entry of entries) {
60
+ const bytes = await readPassCiphertext(root, entry.path);
61
+ try {
62
+ const content = await decrypt(bytes, options.gpgHome);
63
+ const lines = content.split(/\r?\n/).filter(line => line.startsWith('otpauth://'));
64
+ if (lines.length !== 1)
65
+ throw new Error('Invalid OTP source');
66
+ const registration = parseOtpUri(lines[0]);
67
+ const payload = registration.reveal();
68
+ if (registration.type === 'hotp') {
69
+ payload.counterMeaning = 'pass-last-generated';
70
+ if (options.hotpOwner === 'dreamlake') {
71
+ if (payload.algorithm !== 'SHA1' || Math.floor(payload.seed.length * 5 / 8) < 16 || BigInt(payload.counter) === 18446744073709551615n)
72
+ throw new Error('HOTP activation unsupported or exhausted');
73
+ payload.counter = String(BigInt(payload.counter) + 1n);
74
+ payload.counterMeaning = 'next-unused';
75
+ payload.counterOwner = 'dreamlake';
76
+ payload.active = true;
77
+ }
78
+ }
79
+ prepared.push({ fingerprint: hash(bytes), value: JSON.stringify(payload) });
80
+ }
81
+ finally {
82
+ bytes.fill(0);
83
+ }
84
+ }
85
+ if (consent && !await consent(entries.map(e => ({ ...e }))))
86
+ return { cancelled: true, uploaded: false, entries };
87
+ const revalidate = async (i) => {
88
+ const bytes = await readPassCiphertext(root, entries[i].path);
89
+ try {
90
+ if (hash(bytes) !== prepared[i].fingerprint)
91
+ throw new Error('Pass source changed');
92
+ }
93
+ finally {
94
+ bytes.fill(0);
95
+ }
96
+ };
97
+ for (let i = 0; i < entries.length; i++)
98
+ await revalidate(i);
99
+ for (let i = 0; i < entries.length; i++) {
100
+ const entry = entries[i];
101
+ if (isCancelled())
102
+ break;
103
+ try {
104
+ await revalidate(i);
105
+ }
106
+ catch {
107
+ entry.status = 'source-changed';
108
+ break;
109
+ }
110
+ try {
111
+ const result = await request('/v1/vault/entry', { name: entry.name, type: JSON.parse(prepared[i].value).type, value: prepared[i].value }, 'PUT', undefined, {}, { remote, token });
112
+ if (result?.entry?.name !== entry.name || result.entry.type !== JSON.parse(prepared[i].value).type || result.entry.revision !== 1)
113
+ throw new Error('Invalid vault response');
114
+ entry.status = 'success';
115
+ }
116
+ catch (error) {
117
+ entry.status = error instanceof VaultRequestError && error.status === 409 ? 'conflict' : error instanceof VaultRequestError && error.status && [400, 401, 403, 404, 405, 413, 422].includes(error.status) ? 'denied' : 'unknown';
118
+ break; // Never blindly retry uncertain writes or continue a failed batch.
119
+ }
120
+ }
121
+ return { cancelled: isCancelled(), uploaded: entries.every(e => e.status === 'success'), entries };
122
+ }
123
+ catch {
124
+ return { cancelled: false, uploaded: false, error: 'Pass OTP preparation or source revalidation failed; no further writes attempted', entries };
125
+ }
126
+ finally {
127
+ prepared.length = 0;
128
+ }
129
+ }
@@ -0,0 +1,51 @@
1
+ import { inspect } from 'node:util';
2
+ export type OtpPayload = {
3
+ type: 'totp' | 'hotp';
4
+ seed: string;
5
+ algorithm: 'SHA1' | 'SHA256' | 'SHA512';
6
+ digits: number;
7
+ label: string;
8
+ issuer?: string;
9
+ period?: number;
10
+ counter?: string;
11
+ active: boolean;
12
+ };
13
+ export declare class OtpRegistration {
14
+ #private;
15
+ constructor(payload: OtpPayload);
16
+ get type(): "totp" | "hotp";
17
+ /** Explicit secret boundary. Never log the returned object. */
18
+ reveal(): OtpPayload;
19
+ toJSON(): {
20
+ type: "totp" | "hotp";
21
+ secret: string;
22
+ };
23
+ [inspect.custom](): string;
24
+ }
25
+ /** Pure parser: never generates a code, advances a counter, or reads pass files. */
26
+ export declare function parseOtpUri(uri: string): OtpRegistration;
27
+ export interface PassOtpSource {
28
+ path: string;
29
+ content: string;
30
+ }
31
+ /** Redacted inventory only. Caller explicitly provides decrypted source records.
32
+ * Multiple URI records are ambiguous; no implicit naming or upload decisions.
33
+ */
34
+ export declare function previewPassOtp(records: PassOtpSource[]): {
35
+ entries: ({
36
+ path: string;
37
+ status: "invalid";
38
+ type?: undefined;
39
+ } | {
40
+ path: string;
41
+ status: "no-otp";
42
+ type?: undefined;
43
+ } | {
44
+ path: string;
45
+ status: "ready";
46
+ type: "totp" | "hotp";
47
+ })[];
48
+ ready: number;
49
+ invalid: number;
50
+ skipped: number;
51
+ };
@@ -0,0 +1,101 @@
1
+ import { inspect } from 'node:util';
2
+ export class OtpRegistration {
3
+ #payload;
4
+ constructor(payload) { this.#payload = payload; }
5
+ get type() { return this.#payload.type; }
6
+ /** Explicit secret boundary. Never log the returned object. */
7
+ reveal() { return { ...this.#payload }; }
8
+ toJSON() { return { type: this.type, secret: '[REDACTED]' }; }
9
+ [inspect.custom]() { return `OtpRegistration(${this.type}, [REDACTED])`; }
10
+ }
11
+ const invalid = () => new Error('Invalid or unsupported OTP registration');
12
+ function seed(value) {
13
+ const text = value.toUpperCase();
14
+ if (!/^[A-Z2-7]+={0,6}$/.test(text))
15
+ throw invalid();
16
+ const raw = text.replace(/=+$/, '');
17
+ if (![0, 2, 4, 5, 7].includes(raw.length % 8) || (text.includes('=') && (text.length % 8 !== 0 || text.length !== Math.ceil(raw.length / 8) * 8)))
18
+ throw invalid();
19
+ const alphabet = 'ABCDEFGHIJKLMNOPQRSTUVWXYZ234567';
20
+ let bits = 0, buffer = 0;
21
+ for (const char of raw) {
22
+ buffer = (buffer << 5) | alphabet.indexOf(char);
23
+ bits += 5;
24
+ if (bits >= 8) {
25
+ bits -= 8;
26
+ buffer &= (1 << bits) - 1;
27
+ }
28
+ }
29
+ if (buffer !== 0)
30
+ throw invalid();
31
+ return raw;
32
+ }
33
+ /** Pure parser: never generates a code, advances a counter, or reads pass files. */
34
+ export function parseOtpUri(uri) {
35
+ try {
36
+ if (/[\u0000-\u001f\u007f]/.test(uri) || uri.length > 16384 || !/^otpauth:\/\/(totp|hotp)\//.test(uri) || /%(?![0-9a-fA-F]{2})/.test(uri))
37
+ throw invalid();
38
+ decodeURIComponent(uri);
39
+ const url = new URL(uri), type = url.hostname;
40
+ if (url.username || url.password || url.port || url.hash || !['totp', 'hotp'].includes(type))
41
+ throw invalid();
42
+ const label = decodeURIComponent(url.pathname.slice(1));
43
+ if (!label || /[\u0000-\u001f\u007f]/.test(label))
44
+ throw invalid();
45
+ const allowed = new Set(['secret', 'issuer', 'algorithm', 'digits', 'period', 'counter']);
46
+ const seen = new Set();
47
+ for (const [key] of url.searchParams) {
48
+ if (!allowed.has(key) || seen.has(key))
49
+ throw invalid();
50
+ seen.add(key);
51
+ }
52
+ const get = (key, fallback) => url.searchParams.get(key) ?? fallback;
53
+ const algorithm = get('algorithm', 'SHA1').toUpperCase();
54
+ const digits = get('digits', '6');
55
+ if (!['SHA1', 'SHA256', 'SHA512'].includes(algorithm) || !/^[678]$/.test(digits))
56
+ throw invalid();
57
+ const issuer = get('issuer');
58
+ if (issuer !== undefined && (!issuer || /[\u0000-\u001f\u007f]/.test(issuer) || (label.includes(':') && label.split(':')[0] !== issuer)))
59
+ throw invalid();
60
+ const payload = { type, seed: seed(get('secret', '')), algorithm: algorithm, digits: Number(digits), label, ...(issuer ? { issuer } : {}), active: type === 'totp' };
61
+ if (type === 'totp') {
62
+ const period = get('period', '30');
63
+ if (seen.has('counter') || !/^[1-9][0-9]*$/.test(period) || Number(period) > 2147483647)
64
+ throw invalid();
65
+ payload.period = Number(period);
66
+ }
67
+ else {
68
+ const counter = get('counter', '');
69
+ if (seen.has('period') || !/^(0|[1-9][0-9]*)$/.test(counter) || BigInt(counter) > 18446744073709551615n)
70
+ throw invalid();
71
+ payload.counter = counter;
72
+ }
73
+ return new OtpRegistration(payload);
74
+ }
75
+ catch {
76
+ throw invalid();
77
+ }
78
+ }
79
+ /** Redacted inventory only. Caller explicitly provides decrypted source records.
80
+ * Multiple URI records are ambiguous; no implicit naming or upload decisions.
81
+ */
82
+ export function previewPassOtp(records) {
83
+ if (records.length > 10000)
84
+ throw new Error('OTP preview exceeds record limit');
85
+ const entries = records.map(record => {
86
+ if (record.content.length > 1048576)
87
+ return { path: record.path, status: 'invalid' };
88
+ const lines = record.content.split(/\r?\n/).filter(line => line.startsWith('otpauth://'));
89
+ if (!lines.length)
90
+ return { path: record.path, status: 'no-otp' };
91
+ if (record.content.length > 1048576 || lines.length !== 1)
92
+ return { path: record.path, status: 'invalid' };
93
+ try {
94
+ return { path: record.path, status: 'ready', type: parseOtpUri(lines[0]).type };
95
+ }
96
+ catch {
97
+ return { path: record.path, status: 'invalid' };
98
+ }
99
+ });
100
+ return { entries, ready: entries.filter(e => e.status === 'ready').length, invalid: entries.filter(e => e.status === 'invalid').length, skipped: entries.filter(e => e.status === 'no-otp').length };
101
+ }
@@ -0,0 +1,26 @@
1
+ import type { Command } from 'commander';
2
+ export interface PassPreviewOptions {
3
+ store: string;
4
+ gpgHome?: string;
5
+ prefix?: string;
6
+ otp: boolean;
7
+ dryRun: boolean;
8
+ }
9
+ export declare function decrypt(ciphertext: Buffer, gpgHome?: string): Promise<string>;
10
+ /** Explicit source only; never invokes pass extensions or reads GPG configuration. */
11
+ export declare function previewPassStore(options: PassPreviewOptions): Promise<{
12
+ dryRun: boolean;
13
+ uploaded: boolean;
14
+ prefix: string;
15
+ entries: {
16
+ path: string;
17
+ status: string;
18
+ type?: string;
19
+ }[];
20
+ mappingRequired: number;
21
+ ready: number;
22
+ invalid: number;
23
+ skipped: number;
24
+ failed: number;
25
+ }>;
26
+ export declare function registerPassCommands(vault: Command, prefixFor: (command: Command) => string): void;
@@ -0,0 +1,134 @@
1
+ import { constants } from 'node:fs';
2
+ import { lstat, open, readdir, realpath } from 'node:fs/promises';
3
+ import { resolve, relative, isAbsolute } from 'node:path';
4
+ import { spawn } from 'node:child_process';
5
+ import { previewPassOtp } from './passOtp.js';
6
+ import { resolveSelector } from './format.js';
7
+ export function decrypt(ciphertext, gpgHome) {
8
+ return new Promise((resolveOutput, reject) => {
9
+ const args = ['--no-options', '--batch', '--no-tty', '--pinentry-mode', 'error', ...(gpgHome ? ['--homedir', gpgHome] : []), '--decrypt'];
10
+ const process = spawn('gpg', args, { stdio: ['pipe', 'pipe', 'ignore'] });
11
+ const chunks = [];
12
+ let size = 0, failed = false;
13
+ const timer = setTimeout(() => { failed = true; process.kill('SIGKILL'); }, 15000);
14
+ process.stdout.on('data', (chunk) => { size += chunk.length; if (size > 1048576) {
15
+ failed = true;
16
+ process.kill('SIGKILL');
17
+ }
18
+ else
19
+ chunks.push(chunk); });
20
+ process.on('error', () => { clearTimeout(timer); reject(new Error('Credential decryption failed')); });
21
+ process.stdin.on('error', () => { });
22
+ process.on('close', code => { clearTimeout(timer); const output = Buffer.concat(chunks); try {
23
+ if (code !== 0 || failed)
24
+ reject(new Error('Credential decryption failed'));
25
+ else {
26
+ try {
27
+ resolveOutput(new TextDecoder('utf-8', { fatal: true }).decode(output));
28
+ }
29
+ catch {
30
+ reject(new Error('Credential decryption failed'));
31
+ }
32
+ }
33
+ }
34
+ finally {
35
+ output.fill(0);
36
+ chunks.forEach(c => c.fill(0));
37
+ } });
38
+ process.stdin.end(ciphertext);
39
+ });
40
+ }
41
+ /** Explicit source only; never invokes pass extensions or reads GPG configuration. */
42
+ export async function previewPassStore(options) {
43
+ if (!options.otp || !options.dryRun)
44
+ throw new Error('Only --otp --dry-run preview is implemented; no upload is available');
45
+ if (!options.store)
46
+ throw new Error('An explicit pass store directory is required');
47
+ if (options.prefix)
48
+ resolveSelector('probe', options.prefix);
49
+ const root = resolve(options.store);
50
+ if ((await lstat(root)).isSymbolicLink() || !(await lstat(root)).isDirectory() || await realpath(root) !== root)
51
+ throw new Error('Pass store must be a real directory without symlink ancestors');
52
+ const entries = [];
53
+ async function walk(dir) {
54
+ for (const item of await readdir(dir, { withFileTypes: true })) {
55
+ if (item.name === '.git')
56
+ continue;
57
+ const path = resolve(dir, item.name), rel = relative(root, path);
58
+ if (isAbsolute(rel) || rel.startsWith('..') || item.isSymbolicLink())
59
+ throw new Error('Symlinks are not supported in pass preview');
60
+ if (item.isDirectory()) {
61
+ await walk(path);
62
+ continue;
63
+ }
64
+ if (!item.name.endsWith('.gpg'))
65
+ continue;
66
+ if (entries.length >= 10000)
67
+ throw new Error('OTP preview exceeds record limit');
68
+ if (!item.isFile() || await realpath(path) !== path)
69
+ throw new Error('Invalid pass store file');
70
+ const file = await open(path, constants.O_RDONLY | constants.O_NOFOLLOW);
71
+ let ciphertext;
72
+ const name = rel.slice(0, -4);
73
+ try {
74
+ const stat = await file.stat();
75
+ if (!stat.isFile() || stat.size > 1048576 || await realpath(path) !== path)
76
+ throw new Error('Invalid pass store file');
77
+ const current = await lstat(path);
78
+ if (current.dev !== stat.dev || current.ino !== stat.ino || current.isSymbolicLink())
79
+ throw new Error('Pass store changed during preview');
80
+ const buffer = Buffer.alloc(1048577);
81
+ let total = 0;
82
+ while (total < buffer.length) {
83
+ const { bytesRead } = await file.read(buffer, total, buffer.length - total, null);
84
+ if (!bytesRead)
85
+ break;
86
+ total += bytesRead;
87
+ }
88
+ if (total > 1048576) {
89
+ buffer.fill(0);
90
+ throw new Error('Pass store file exceeds size limit');
91
+ }
92
+ const after = await lstat(path);
93
+ if (after.dev !== stat.dev || after.ino !== stat.ino || await realpath(path) !== path) {
94
+ buffer.fill(0);
95
+ throw new Error('Pass store changed during preview');
96
+ }
97
+ ciphertext = buffer.subarray(0, total);
98
+ try {
99
+ const content = await decrypt(ciphertext, options.gpgHome);
100
+ entries.push(previewPassOtp([{ path: name, content }]).entries[0]);
101
+ }
102
+ catch {
103
+ entries.push({ path: name, status: 'decrypt-failed' });
104
+ }
105
+ }
106
+ finally {
107
+ ciphertext?.fill(0);
108
+ await file.close();
109
+ }
110
+ }
111
+ }
112
+ await walk(root);
113
+ for (const entry of entries)
114
+ if (entry.status === 'ready' && !/^[A-Za-z0-9_-]+(?:\/[A-Za-z0-9_-]+)*$/.test(entry.path))
115
+ entry.status = 'mapping-required';
116
+ entries.sort((a, b) => a.path.localeCompare(b.path));
117
+ return { dryRun: true, uploaded: false, prefix: options.prefix ?? '', entries, mappingRequired: entries.filter(e => e.status === 'mapping-required').length, ready: entries.filter(e => e.status === 'ready').length, invalid: entries.filter(e => e.status === 'invalid').length, skipped: entries.filter(e => e.status === 'no-otp').length, failed: entries.filter(e => e.status === 'decrypt-failed').length };
118
+ }
119
+ export function registerPassCommands(vault, prefixFor) {
120
+ const collect = (value, previous) => { if (previous !== undefined && previous !== value)
121
+ throw new Error('Conflicting prefixes'); return value; };
122
+ vault.command('pass').description('compatibility commands; prefer vault import --pass-otp').option('-p, --prefix <prefix>', 'vault path prefix', collect).command('sync').description('compatibility alias for pass-OTP preview; no upload').option('-p, --prefix <prefix>', 'vault path prefix', collect).option('--otp', 'preview OTP registrations only').option('--dry-run', 'read local registrations without upload').requiredOption('--store <directory>', 'explicit pass store directory').option('--gpg-home <directory>', 'explicit GPG keyring directory').action(async (options, command) => {
123
+ try {
124
+ const result = await previewPassStore({ ...options, prefix: prefixFor(command) });
125
+ process.stdout.write(JSON.stringify(result, null, 2) + '\n');
126
+ if (result.failed || result.invalid)
127
+ process.exitCode = 1;
128
+ }
129
+ catch {
130
+ console.error('Pass OTP preview failed or unsupported; requires --otp --dry-run and an explicit real store');
131
+ process.exitCode = 1;
132
+ }
133
+ });
134
+ }