@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,273 @@
1
+ import { constants, closeSync, fstatSync, openSync, readSync } from "node:fs";
2
+ import { resolve } from "node:path";
3
+ import { request } from "./index.js";
4
+ import { resolveRemote, resolveToken } from "../config.js";
5
+ const INTENT = [
6
+ "expectedEntryId",
7
+ "expectedEntryRevision",
8
+ "replacementEntryId",
9
+ "replacementEntryRevision",
10
+ "remoteIdentity",
11
+ "recoveryKeyFingerprint",
12
+ "recoveryVerifiedAt",
13
+ ];
14
+ const PROOF = [
15
+ "method",
16
+ "remoteIdentity",
17
+ "recoveryKeyFingerprint",
18
+ "newLoginVerifiedAt",
19
+ "oldLoginDeniedAt",
20
+ "replacementReverifiedAt",
21
+ "recoveryReverifiedAt",
22
+ ];
23
+ function fail() {
24
+ throw new Error("Invalid password rotation metadata");
25
+ }
26
+ const canonical = (v) => JSON.stringify(v, (_key, item) => item && typeof item === "object" && !Array.isArray(item)
27
+ ? Object.fromEntries(Object.keys(item)
28
+ .sort()
29
+ .map((k) => [k, item[k]]))
30
+ : item);
31
+ function exact(v, keys) {
32
+ if (!v ||
33
+ typeof v !== "object" ||
34
+ Array.isArray(v) ||
35
+ Object.keys(v).sort().join(",") !== [...keys].sort().join(","))
36
+ fail();
37
+ }
38
+ export function passwordOperationId(v) {
39
+ if (typeof v !== "string" || !/^[A-Za-z0-9_-]{1,128}$/.test(v))
40
+ fail();
41
+ }
42
+ function timestamp(v) {
43
+ if (typeof v !== "string" ||
44
+ !/^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}\.\d{3}Z$/.test(v) ||
45
+ !Number.isFinite(Date.parse(v)) ||
46
+ new Date(v).toISOString() !== v)
47
+ fail();
48
+ }
49
+ function fingerprint(v) {
50
+ if (typeof v !== "string" || !/^SHA256:[A-Za-z0-9+/]{43}$/.test(v))
51
+ fail();
52
+ }
53
+ function identity(v) {
54
+ exact(v, ["user", "uid", "home", "machineId", "homeDevice", "homeInode"]);
55
+ if (typeof v.user !== "string" ||
56
+ !/^[a-z_][a-z0-9_-]{0,63}$/.test(v.user) ||
57
+ typeof v.home !== "string" ||
58
+ !v.home.startsWith("/") ||
59
+ v.home.length > 4096 ||
60
+ /[\0\r\n]/.test(v.home) ||
61
+ typeof v.machineId !== "string" ||
62
+ !/^[a-fA-F0-9]{32}$/.test(v.machineId) ||
63
+ ["uid", "homeDevice", "homeInode"].some((k) => !Number.isSafeInteger(v[k]) || v[k] < 0))
64
+ fail();
65
+ }
66
+ export function passwordRotationIntent(raw) {
67
+ const v = structuredClone(raw);
68
+ exact(v, INTENT);
69
+ passwordOperationId(v.expectedEntryId);
70
+ passwordOperationId(v.replacementEntryId);
71
+ if (v.expectedEntryId === v.replacementEntryId ||
72
+ ["expectedEntryRevision", "replacementEntryRevision"].some((k) => !Number.isSafeInteger(v[k]) || v[k] < 1))
73
+ fail();
74
+ identity(v.remoteIdentity);
75
+ fingerprint(v.recoveryKeyFingerprint);
76
+ timestamp(v.recoveryVerifiedAt);
77
+ return v;
78
+ }
79
+ export function passwordRotationProof(raw) {
80
+ const v = structuredClone(raw);
81
+ exact(v, PROOF);
82
+ if (v.method !== "ssh_password")
83
+ fail();
84
+ identity(v.remoteIdentity);
85
+ fingerprint(v.recoveryKeyFingerprint);
86
+ const times = PROOF.slice(3).map((k) => v[k]);
87
+ times.forEach(timestamp);
88
+ if (canonical(times) !== canonical([...times].sort()))
89
+ fail();
90
+ return v;
91
+ }
92
+ export function passwordRotationReceipt(raw, operationId, bindingId, expected) {
93
+ const op = raw?.operation;
94
+ const required = [
95
+ ...INTENT,
96
+ "operationId",
97
+ "bindingId",
98
+ "hostId",
99
+ "enrollmentId",
100
+ "role",
101
+ "endpoint",
102
+ "state",
103
+ "createdAt",
104
+ "verificationSource",
105
+ ];
106
+ const optional = [
107
+ "startedAt",
108
+ "terminalAt",
109
+ "purgeAt",
110
+ "verification",
111
+ "snapshotsPurgedAt",
112
+ ];
113
+ if (!op ||
114
+ typeof op !== "object" ||
115
+ Array.isArray(op) ||
116
+ required.some((k) => !(k in op)) ||
117
+ Object.keys(op).some((k) => ![...required, ...optional].includes(k)))
118
+ fail();
119
+ passwordRotationIntent(Object.fromEntries(INTENT.map((k) => [k, op[k]])));
120
+ if (op.operationId !== operationId ||
121
+ (bindingId !== undefined && op.bindingId !== bindingId) ||
122
+ (expected &&
123
+ Object.keys(expected).some((k) => canonical(op[k]) !== canonical(expected[k]))))
124
+ fail();
125
+ if (typeof op.bindingId !== "string" ||
126
+ !/^[a-f0-9-]{36}$/.test(op.bindingId) ||
127
+ ["hostId", "enrollmentId"].some((k) => typeof op[k] !== "string" || !/^[a-f0-9]{24}$/.test(op[k])) ||
128
+ !["target", "jump"].includes(op.role) ||
129
+ typeof op.endpoint !== "string" ||
130
+ !/^[A-Za-z0-9_.@:\[\]-]{1,255}$/.test(op.endpoint) ||
131
+ op.verificationSource !== "client_attestation" ||
132
+ !["reserved", "mutation_pending", "confirmed", "cancelled"].includes(op.state))
133
+ fail();
134
+ ["createdAt", "startedAt", "terminalAt", "purgeAt", "snapshotsPurgedAt"]
135
+ .filter((k) => k in op)
136
+ .forEach((k) => timestamp(op[k]));
137
+ if ((["mutation_pending", "confirmed"].includes(op.state) && !op.startedAt) ||
138
+ (["confirmed", "cancelled"].includes(op.state) &&
139
+ (!op.terminalAt || !op.purgeAt)))
140
+ fail();
141
+ if ((op.state === "reserved" && optional.some((k) => k in op)) ||
142
+ (op.state === "mutation_pending" &&
143
+ optional.filter((k) => k !== "startedAt").some((k) => k in op)) ||
144
+ (op.state === "cancelled" && ("startedAt" in op || "verification" in op)))
145
+ fail();
146
+ if (op.state === "confirmed") {
147
+ const p = passwordRotationProof(op.verification);
148
+ if (canonical(p.remoteIdentity) !== canonical(op.remoteIdentity) ||
149
+ p.recoveryKeyFingerprint !== op.recoveryKeyFingerprint ||
150
+ p.newLoginVerifiedAt < op.startedAt)
151
+ fail();
152
+ }
153
+ return structuredClone(op);
154
+ }
155
+ function inputFile(path) {
156
+ const fd = openSync(resolve(path), constants.O_RDONLY | constants.O_NOFOLLOW | constants.O_NONBLOCK);
157
+ try {
158
+ const stat = fstatSync(fd);
159
+ if (!stat.isFile() ||
160
+ stat.nlink !== 1 ||
161
+ stat.uid !== process.getuid?.() ||
162
+ (stat.mode & 0o077) !== 0 ||
163
+ stat.size > 8192)
164
+ fail();
165
+ const bytes = Buffer.alloc(8193);
166
+ const length = readSync(fd, bytes, 0, 8193, 0);
167
+ if (length > 8192)
168
+ fail();
169
+ return JSON.parse(new TextDecoder("utf-8", { fatal: true }).decode(bytes.subarray(0, length)));
170
+ }
171
+ finally {
172
+ closeSync(fd);
173
+ }
174
+ }
175
+ /** Low-level recovery only. The future rotate-password command owns remote work. */
176
+ export function registerPasswordRotations(vault) {
177
+ const group = vault
178
+ .command("password-rotation")
179
+ .description("reserve and recover password rotation metadata; never changes SSH passwords");
180
+ for (const action of [
181
+ "reserve",
182
+ "show",
183
+ "read",
184
+ "start",
185
+ "cancel",
186
+ "confirm",
187
+ ]) {
188
+ const cmd = group
189
+ .command(action)
190
+ .requiredOption("--operation-id <id>", "persisted immutable operation identity");
191
+ if (action === "reserve")
192
+ cmd.requiredOption("--binding-id <id>", "exact password binding identity");
193
+ if (action === "reserve" || action === "confirm")
194
+ cmd.requiredOption("--input <file>", "private metadata-only JSON intent/proof file");
195
+ if (action === "read")
196
+ cmd
197
+ .requiredOption("--slot <old|new>", "explicit pending recovery snapshot")
198
+ .option("--to-json", "explicitly output selected secret as JSON");
199
+ cmd.action(async (opts) => {
200
+ try {
201
+ passwordOperationId(opts.operationId);
202
+ let body;
203
+ if (action === "reserve") {
204
+ if (!/^[a-f0-9-]{36}$/.test(opts.bindingId))
205
+ fail();
206
+ body = passwordRotationIntent(inputFile(opts.input));
207
+ }
208
+ if (action === "confirm")
209
+ body = passwordRotationProof(inputFile(opts.input));
210
+ if (action === "read" && !["old", "new"].includes(opts.slot))
211
+ fail();
212
+ const token = resolveToken();
213
+ if (!token)
214
+ fail();
215
+ const remote = resolveRemote();
216
+ const origin = new URL(remote);
217
+ if (origin.username || origin.password || origin.search || origin.hash ||
218
+ !['https:', 'http:'].includes(origin.protocol) ||
219
+ origin.protocol === 'http:' && !['localhost', '127.0.0.1', '[::1]'].includes(origin.hostname))
220
+ fail();
221
+ const connection = { remote, token };
222
+ const send = (path, data, method) => request(path, data, method, undefined, {}, connection);
223
+ const base = "/v1/vault/host-password-rotations/" + opts.operationId;
224
+ if (action === "read") {
225
+ const op = passwordRotationReceipt(await send(base), opts.operationId);
226
+ if (!["reserved", "mutation_pending"].includes(op.state))
227
+ fail();
228
+ const result = await send(base + "/read", { slot: opts.slot });
229
+ exact(result, [
230
+ "operationId",
231
+ "slot",
232
+ "entryId",
233
+ "entryRevision",
234
+ "value",
235
+ ]);
236
+ const prefix = opts.slot === "old" ? "expected" : "replacement";
237
+ if (result.operationId !== opts.operationId ||
238
+ result.slot !== opts.slot ||
239
+ result.entryId !== op[prefix + "EntryId"] ||
240
+ result.entryRevision !== op[prefix + "EntryRevision"] ||
241
+ typeof result.value !== "string")
242
+ fail();
243
+ process.stdout.write(opts.toJson ? JSON.stringify(result) + "\n" : result.value);
244
+ return;
245
+ }
246
+ const result = action === "reserve"
247
+ ? await send("/v1/vault/host-credentials/" +
248
+ opts.bindingId +
249
+ "/password-rotations/" +
250
+ opts.operationId, body, "PUT")
251
+ : action === "show"
252
+ ? await send(base)
253
+ : await send(base + "/" + action, body ?? {});
254
+ const op = passwordRotationReceipt(result, opts.operationId, action === "reserve" ? opts.bindingId : undefined, action === "reserve" ? body : undefined);
255
+ const expectedState = {
256
+ start: "mutation_pending",
257
+ cancel: "cancelled",
258
+ confirm: "confirmed",
259
+ }[action];
260
+ if (expectedState && op.state !== expectedState)
261
+ fail();
262
+ if (action === "confirm" &&
263
+ canonical(op.verification) !== canonical(body))
264
+ fail();
265
+ console.log(JSON.stringify(op, null, 2));
266
+ }
267
+ catch {
268
+ console.error("Password operation not confirmed. Retain its original ID and exact metadata; recover with vault password-rotation show or replay the same operation. No SSH change or rollback is confirmed.");
269
+ process.exitCode = 1;
270
+ }
271
+ });
272
+ }
273
+ }
@@ -0,0 +1,13 @@
1
+ import type { RotationState } from './rotationState.js';
2
+ import type { VaultCall } from './sshTransfer.js';
3
+ export declare function liveRotationEntry(entry: any, id: string, revision: number, name: string, now?: number): any;
4
+ export declare function currentRotationBinding(call: VaultCall, state: RotationState, selected: 'old' | 'new'): Promise<{
5
+ binding: {
6
+ [k: string]: any;
7
+ };
8
+ entry: any;
9
+ }>;
10
+ export declare function supersedeRotation(call: VaultCall, state: RotationState): Promise<{
11
+ [k: string]: any;
12
+ }>;
13
+ export declare function confirmRotationCleanup(call: VaultCall, state: RotationState): Promise<void>;
@@ -0,0 +1,58 @@
1
+ import { isDeepStrictEqual } from 'node:util';
2
+ import { bindingView } from './hostCredentials.js';
3
+ import { supersessionReceipt } from './hostSupersessions.js';
4
+ import { validateEntries } from './format.js';
5
+ export function liveRotationEntry(entry, id, revision, name, now = Date.now()) {
6
+ validateEntries([entry]);
7
+ if (entry.id !== id || entry.revision !== revision || entry.name !== name || entry.type !== 'string' || entry.deleteAt != null ||
8
+ entry.expiresAt != null && (!Number.isFinite(Date.parse(entry.expiresAt)) || Date.parse(entry.expiresAt) <= now))
9
+ throw new Error('Selected rotation entry is no longer live');
10
+ return entry;
11
+ }
12
+ export async function currentRotationBinding(call, state, selected) {
13
+ const result = await call('/v1/vault/host-credentials/' + encodeURIComponent(state.bindingId));
14
+ const b = bindingView(result?.binding);
15
+ if (b.id !== state.bindingId || b.releasedAt != null)
16
+ throw new Error('Rotation binding changed');
17
+ for (const key of ['hostId', 'enrollmentId', 'role', 'endpoint', 'kind'])
18
+ if (b[key] !== state[key])
19
+ throw new Error('Rotation binding scope changed');
20
+ const id = selected === 'old' ? state.expectedEntryId : state.replacementEntryId;
21
+ const revision = selected === 'old' ? state.expectedEntryRevision : state.replacementEntryRevision;
22
+ const name = selected === 'old' ? state.oldEntryName : state.replacementEntryName;
23
+ if (!id || !revision || b.entryId !== id || b.entryRevision !== revision)
24
+ throw new Error('Rotation binding revision changed');
25
+ liveRotationEntry(result.entry, id, revision, name);
26
+ return { binding: b, entry: result.entry };
27
+ }
28
+ export async function supersedeRotation(call, state) {
29
+ const intent = { operationId: state.operationId, expectedEntryId: state.expectedEntryId, expectedEntryRevision: state.expectedEntryRevision,
30
+ replacementEntryId: state.replacementEntryId, replacementEntryRevision: state.replacementEntryRevision };
31
+ const response = await call('/v1/vault/host-credentials/' + encodeURIComponent(state.bindingId) + '/supersede', intent, 'POST');
32
+ const receipt = supersessionReceipt(response, state.operationId, state.bindingId, intent);
33
+ for (const key of ['hostId', 'enrollmentId', 'role', 'endpoint', 'kind'])
34
+ if (receipt[key] !== state[key])
35
+ throw new Error('Rotation receipt scope changed');
36
+ return receipt;
37
+ }
38
+ export async function confirmRotationCleanup(call, state) {
39
+ if (state.phase !== 'old_login_denied_and_new_verified')
40
+ throw new Error('Cleanup proof is not durable');
41
+ const body = { bindingId: state.bindingId, expectedEntryId: state.expectedEntryId, expectedEntryRevision: state.expectedEntryRevision,
42
+ replacementEntryId: state.replacementEntryId, replacementEntryRevision: state.replacementEntryRevision,
43
+ verification: { oldFingerprint: state.oldFingerprint, newFingerprint: state.newFingerprint, remoteIdentity: state.remoteIdentity, ...state.verification } };
44
+ const response = await call('/v1/vault/host-credential-operations/' + encodeURIComponent(state.operationId) + '/confirm-cleanup', body, 'POST');
45
+ const operation = response?.operation;
46
+ if (!operation || operation.state !== 'cleanup_confirmed' || operation.verificationSource !== 'client_attestation' ||
47
+ typeof operation.cleanupConfirmedAt !== 'string' || !Number.isFinite(Date.parse(operation.cleanupConfirmedAt)) ||
48
+ !isDeepStrictEqual(operation.confirmation, body))
49
+ throw new Error('Cleanup confirmation mismatch');
50
+ // Validate the original immutable receipt separately from added confirmation.
51
+ const original = { ...operation, state: 'cleanup_pending' };
52
+ const receipt = supersessionReceipt({ operation: original }, state.operationId, state.bindingId, {
53
+ operationId: state.operationId, expectedEntryId: state.expectedEntryId, expectedEntryRevision: state.expectedEntryRevision,
54
+ replacementEntryId: state.replacementEntryId, replacementEntryRevision: state.replacementEntryRevision
55
+ });
56
+ if (!isDeepStrictEqual(receipt, state.receipt))
57
+ throw new Error('Cleanup receipt changed');
58
+ }
@@ -0,0 +1,2 @@
1
+ import type { Command } from 'commander';
2
+ export declare function registerRotation(vault: Command): void;
@@ -0,0 +1,75 @@
1
+ import { resolve } from 'node:path';
2
+ import { resolveRemote, resolveToken } from '../config.js';
3
+ import { request, invocationPrefix, collectPrefix } from './index.js';
4
+ import { entryName, writeReceipt } from './mutations.js';
5
+ import { rotationTransportInput } from './rotationInput.js';
6
+ import { prepareRotation, checkRotationIntent, RotationPreparationError } from './rotationPrepare.js';
7
+ import { resumeRotation } from './rotationEngine.js';
8
+ import { currentRotationBinding, supersedeRotation, confirmRotationCleanup, liveRotationEntry } from './rotationApi.js';
9
+ import { rotationPublicKey, rotationRemoteStep, removeRotationLocalKeys } from './rotationKeys.js';
10
+ import { readRotationRecord } from './rotationJournal.js';
11
+ export function registerRotation(vault) {
12
+ vault.command('rotate-key').description('rotate one selected host SSH key with durable local recovery; requires remote Python 3')
13
+ .requiredOption('--binding-id <id>', 'exact target or jump credential binding')
14
+ .requiredOption('--operation-file <path>', 'private durable operation path; reuse for recovery')
15
+ .requiredOption('--new-entry <name>', 'new vault entry destination')
16
+ .requiredOption('--ssh <arguments>', 'explicit user@host with optional -l and -p; no ambient SSH config')
17
+ .requiredOption('--known-hosts <path>', 'absolute trusted known-hosts file')
18
+ .option('--jump-ssh <arguments>', 'separate explicit jump endpoint')
19
+ .option('--jump-identity <path>', 'absolute separate jump private key')
20
+ .option('--jump-known-hosts <path>', 'separate trusted jump known-hosts file')
21
+ .option('-p, --prefix <prefix>', 'destination vault prefix', collectPrefix)
22
+ .action(async (options, command) => {
23
+ let stage = 'input validation';
24
+ try {
25
+ const remote = resolveRemote(), token = resolveToken();
26
+ const url = new URL(remote);
27
+ if (!token || url.origin !== remote || url.username || url.password || url.protocol !== 'https:' && !(url.protocol === 'http:' && ['localhost', '127.0.0.1', '[::1]'].includes(url.hostname)))
28
+ throw new Error('Invalid session origin');
29
+ const account = JSON.parse(Buffer.from(token.split('.')[1] ?? '', 'base64url').toString()).sub;
30
+ if (typeof account !== 'string' || !account)
31
+ throw new Error('Account session required');
32
+ const connection = { remote, token };
33
+ const call = (path, body, method, revision) => request(path, body, method, revision, {}, connection);
34
+ const intent = { bindingId: options.bindingId, newEntry: entryName(options.newEntry, invocationPrefix(command)), operationFile: resolve(options.operationFile),
35
+ profile: rotationTransportInput(options), origin: remote, account };
36
+ stage = 'preparation';
37
+ const prepared = await prepareRotation(call, intent);
38
+ checkRotationIntent(prepared, intent);
39
+ stage = 'rotation or recovery';
40
+ const state = await resumeRotation(intent.operationFile, {
41
+ now: () => new Date().toISOString(), checkCurrent: async (state, key) => { await currentRotationBinding(call, state, key); },
42
+ remote: rotationRemoteStep, supersede: state => supersedeRotation(call, state), confirmCleanup: state => confirmRotationCleanup(call, state), removeLocalKeys: removeRotationLocalKeys,
43
+ saveReplacement: async (state) => {
44
+ if (await rotationPublicKey(state.newKeyPath) !== state.newPublicKey)
45
+ throw new Error('Replacement key changed');
46
+ const bytes = await readRotationRecord(state.newKeyPath);
47
+ try {
48
+ let response;
49
+ try {
50
+ response = await request('/v1/vault/entry', { name: state.replacementEntryName, type: 'string', value: bytes.toString('utf8') }, 'PUT', undefined, { 'Idempotency-Key': state.writeRequestId }, connection);
51
+ }
52
+ catch {
53
+ response = await call('/v1/vault/write-operations/' + state.writeRequestId);
54
+ }
55
+ const entry = writeReceipt(response, state.writeRequestId).entry;
56
+ if (entry.id === state.expectedEntryId)
57
+ throw new Error('Replacement identity collision');
58
+ liveRotationEntry(entry, entry.id, entry.revision, state.replacementEntryName);
59
+ return { id: entry.id, revision: entry.revision };
60
+ }
61
+ finally {
62
+ bytes.fill(0);
63
+ }
64
+ },
65
+ });
66
+ console.log(JSON.stringify({ operationId: state.operationId, phase: state.phase, bindingId: state.bindingId, replacementEntryId: state.replacementEntryId, operationFile: intent.operationFile }, null, 2));
67
+ }
68
+ catch (error) {
69
+ if (error instanceof RotationPreparationError)
70
+ stage = 'preparation / ' + error.stage;
71
+ console.error('Rotation is not confirmed during ' + stage + '. Retain the operation file and recovery keys; retry identical arguments with the same account. No automatic rollback or shared-entry retirement was performed.');
72
+ process.exitCode = 1;
73
+ }
74
+ });
75
+ }
@@ -0,0 +1,19 @@
1
+ import { type RotationState } from './rotationState.js';
2
+ import type { RotationHelperReply } from './rotationRemote.js';
3
+ /** Adapters must validate exact API receipts and use stable IDs from state.
4
+ * Remote adapters authenticate with only the requested selected key. */
5
+ export interface RotationSteps {
6
+ checkCurrent(state: RotationState, selected: 'old' | 'new'): Promise<void>;
7
+ saveReplacement(state: RotationState): Promise<{
8
+ id: string;
9
+ revision: number;
10
+ }>;
11
+ remote(state: RotationState, key: 'old' | 'new', action: 'inspect' | 'install' | 'remove_old', expectDenied?: boolean): Promise<RotationHelperReply | 'publickey-denied'>;
12
+ supersede(state: RotationState): Promise<Record<string, unknown>>;
13
+ confirmCleanup(state: RotationState): Promise<void>;
14
+ removeLocalKeys(state: RotationState): Promise<void>;
15
+ now(): string;
16
+ }
17
+ /** Run only from an already prepared durable genesis; uncertain side effects
18
+ * replay the same intent. A phase is published only after its evidence passes. */
19
+ export declare function resumeRotation(file: string, steps: RotationSteps): Promise<RotationState>;
@@ -0,0 +1,65 @@
1
+ import { appendRotationPhase, loadRotationJournal, rotationPhases } from './rotationJournal.js';
2
+ import { validateRotationState, validateRotationTransition } from './rotationState.js';
3
+ import { isDeepStrictEqual } from 'node:util';
4
+ function reply(value, state, oldPresent) {
5
+ if (value === 'publickey-denied' || !isDeepStrictEqual(value.identity, state.remoteIdentity) || !value.newPresent ||
6
+ oldPresent !== undefined && value.oldPresent !== oldPresent)
7
+ throw new Error('Remote rotation evidence mismatch');
8
+ }
9
+ /** Run only from an already prepared durable genesis; uncertain side effects
10
+ * replay the same intent. A phase is published only after its evidence passes. */
11
+ export async function resumeRotation(file, steps) {
12
+ let current = await loadRotationJournal(file, validateRotationState, validateRotationTransition);
13
+ for (;;) {
14
+ const state = current.state;
15
+ if (state.phase === 'cleanup_confirmed') {
16
+ await steps.removeLocalKeys(state);
17
+ return state;
18
+ }
19
+ const next = structuredClone(state);
20
+ switch (state.phase) {
21
+ case 'prepared': {
22
+ await steps.checkCurrent(state, 'old');
23
+ const saved = await steps.saveReplacement(state);
24
+ next.replacementEntryId = saved.id;
25
+ next.replacementEntryRevision = saved.revision;
26
+ break;
27
+ }
28
+ case 'replacement_saved':
29
+ await steps.checkCurrent(state, 'old');
30
+ reply(await steps.remote(state, 'old', 'install'), state, true);
31
+ break;
32
+ case 'new_key_installed':
33
+ await steps.checkCurrent(state, 'old');
34
+ reply(await steps.remote(state, 'new', 'inspect'), state, true);
35
+ next.verification.newLoginVerifiedAt = steps.now();
36
+ break;
37
+ case 'new_login_verified':
38
+ // Re-probe before committing even after a long offline pause. The API
39
+ // adapter reconciles an already-committed same-operation receipt.
40
+ reply(await steps.remote(state, 'new', 'inspect'), state);
41
+ next.receipt = await steps.supersede(state);
42
+ break;
43
+ case 'binding_superseded':
44
+ await steps.checkCurrent(state, 'new');
45
+ reply(await steps.remote(state, 'new', 'inspect'), state);
46
+ reply(await steps.remote(state, 'new', 'remove_old'), state, false);
47
+ break;
48
+ case 'old_key_removed':
49
+ await steps.checkCurrent(state, 'new');
50
+ if (await steps.remote(state, 'old', 'inspect', true) !== 'publickey-denied')
51
+ throw new Error('Old credential rejection unconfirmed');
52
+ next.verification.oldLoginDeniedAt = steps.now();
53
+ reply(await steps.remote(state, 'new', 'inspect'), state, false);
54
+ next.verification.replacementReverifiedAt = steps.now();
55
+ break;
56
+ case 'old_login_denied_and_new_verified':
57
+ // The exact persisted verification tuple is retried after response loss.
58
+ await steps.confirmCleanup(state);
59
+ break;
60
+ }
61
+ next.phase = rotationPhases[rotationPhases.indexOf(state.phase) + 1];
62
+ next.timestamps[next.phase] = steps.now();
63
+ current = await appendRotationPhase(file, current, next, validateRotationState, validateRotationTransition);
64
+ }
65
+ }
@@ -0,0 +1,2 @@
1
+ export declare const ROTATION_HELPER_SHA256 = "41647b71447adaef4995a9970248726b2fc15943f666cf40945e897c32d23ce0";
2
+ export declare const ROTATION_HELPER_SOURCE = "\"\"\"Standalone remote Python3 helper: public-key metadata only; no SDK dependency.\"\"\"\nimport base64\nimport fcntl\nimport hashlib\nimport json\nimport os\nfrom pathlib import Path\nimport pwd\nimport re\nimport stat\nimport sys\nimport uuid\n\n\nclass Refused(Exception):\n pass\n\n\ndef checked(path, directory=False, private=False):\n info = path.lstat()\n kind = stat.S_ISDIR if directory else stat.S_ISREG\n if not kind(info.st_mode) or info.st_uid != os.getuid() or info.st_mode & 0o022 or not directory and info.st_nlink != 1:\n raise Refused('UNSAFE_PATH')\n if private and info.st_mode & 0o077:\n raise Refused('UNSAFE_PATH')\n return info\n\n\ndef public(value):\n if not isinstance(value, str) or not re.fullmatch(r'(ssh-ed25519|ssh-rsa|ecdsa-sha2-nistp(?:256|384|521)) [A-Za-z0-9+/]+={0,3}', value) or len(value) > 8192:\n raise Refused('INVALID_PUBLIC_KEY')\n kind, encoded = value.split(' ')\n try:\n raw = base64.b64decode(encoded, validate=True)\n size = int.from_bytes(raw[:4], 'big')\n if raw[4:4 + size].decode() != kind or len(raw) < 4 + size + 4:\n raise ValueError()\n except (ValueError, UnicodeError):\n raise Refused('INVALID_PUBLIC_KEY') from None\n return value.encode()\n\n\ndef restrictions(prefix):\n \"\"\"Preserve allowed options byte-for-byte; never silently broaden access.\"\"\"\n text = prefix.strip().decode('utf-8', errors='strict')\n if not text:\n return\n chunks, current, quoted, escaped = [], '', False, False\n for char in text:\n if escaped:\n current += char; escaped = False; continue\n if char == '\\\\' and quoted:\n current += char; escaped = True; continue\n if char == '\"':\n quoted = not quoted\n if char == ',' and not quoted:\n chunks.append(current); current = ''; continue\n if char.isspace() and not quoted:\n raise Refused('UNSUPPORTED_KEY_CONSTRAINTS')\n current += char\n chunks.append(current)\n flags = {'restrict', 'no-agent-forwarding', 'no-port-forwarding', 'no-pty', 'no-user-rc', 'no-X11-forwarding', 'agent-forwarding', 'port-forwarding', 'pty', 'user-rc', 'X11-forwarding'}\n values = {'command', 'from', 'environment', 'permitopen', 'permitlisten', 'expiry-time', 'tunnel'}\n if quoted or escaped or any(c not in flags and not any(c.startswith(k + '=\"') and c.endswith('\"') for k in values) for c in chunks):\n raise Refused('UNSUPPORTED_KEY_CONSTRAINTS')\n\n\ndef matching(lines, key):\n kind, blob = key.split(b' ')\n result = []\n expression = re.compile(rb'(?<!\\S)' + re.escape(kind) + rb'[ \\t]+' + re.escape(blob) + rb'(?=[ \\t]|$)')\n for index, line in enumerate(lines):\n content = line.rstrip(b'\\r\\n')\n matches = list(expression.finditer(content))\n if not matches:\n continue\n if len(matches) != 1:\n raise Refused('AMBIGUOUS_KEY')\n match = matches[0]\n prefix = content[:match.start()]\n restrictions(prefix)\n result.append((index, prefix, line))\n if len(result) > 1:\n raise Refused('DUPLICATE_KEY')\n return result\n\n\ndef digest(value):\n return hashlib.sha256(value).hexdigest()\n\n\ndef read_checked(name, parent_fd, private=False):\n try:\n fd = os.open(name, os.O_RDONLY | os.O_NOFOLLOW | os.O_NONBLOCK, dir_fd=parent_fd)\n except OSError:\n raise Refused('UNSAFE_PATH') from None\n with os.fdopen(fd, 'rb') as stream:\n info = os.fstat(stream.fileno())\n if not stat.S_ISREG(info.st_mode) or info.st_uid != os.getuid() or info.st_mode & 0o022 or info.st_nlink != 1 or private and info.st_mode & 0o077:\n raise Refused('UNSAFE_PATH')\n data = stream.read(1024 * 1024 + 1)\n after = os.fstat(stream.fileno())\n if len(data) > 1024 * 1024 or (info.st_size, info.st_mtime_ns) != (after.st_size, after.st_mtime_ns):\n raise Refused('FILE_CHANGED')\n return data, info\n\n\ndef same_directory(path, parent_fd):\n current, pinned = checked(path, directory=True), os.fstat(parent_fd)\n if (current.st_dev, current.st_ino) != (pinned.st_dev, pinned.st_ino):\n raise Refused('REMOTE_IDENTITY_CHANGED')\n\n\ndef atomic(path, value, mode, parent_fd, group=None, expected=None):\n temporary = '.rotation-' + uuid.uuid4().hex\n descriptor = os.open(temporary, os.O_WRONLY | os.O_CREAT | os.O_EXCL | os.O_NOFOLLOW, 0o600, dir_fd=parent_fd)\n try:\n os.fchmod(descriptor, mode)\n if group is not None: os.fchown(descriptor, -1, group)\n with os.fdopen(descriptor, 'wb') as stream:\n stream.write(value); stream.flush(); os.fsync(stream.fileno())\n same_directory(path.parent, parent_fd)\n if expected is not None:\n old_bytes, old_info = expected\n current_bytes, current_info = read_checked(path.name, parent_fd)\n fields = ('st_dev', 'st_ino', 'st_mode', 'st_uid', 'st_gid', 'st_size', 'st_mtime_ns')\n if current_bytes != old_bytes or any(getattr(current_info, k) != getattr(old_info, k) for k in fields):\n raise Refused('AUTHORIZED_KEYS_CHANGED')\n os.replace(temporary, path.name, src_dir_fd=parent_fd, dst_dir_fd=parent_fd)\n os.fsync(parent_fd)\n finally:\n try: os.unlink(temporary, dir_fd=parent_fd)\n except FileNotFoundError: pass\n\n\ndef operate(payload, *, home=None, machine_id=None):\n allowed = {'action', 'operationId', 'oldPublicKey', 'newPublicKey', 'expectedIdentity'}\n if not isinstance(payload, dict) or set(payload) - allowed or payload.get('action') not in ('inspect', 'install', 'remove_old', 'remove_new') or not isinstance(payload.get('operationId'), str) or not re.fullmatch(r'[A-Za-z0-9_-]{1,128}', payload['operationId']):\n raise Refused('INVALID_REQUEST')\n old, new = public(payload.get('oldPublicKey')), public(payload.get('newPublicKey'))\n if old == new: raise Refused('SAME_KEY')\n home = Path(home) if home is not None else Path(pwd.getpwuid(os.getuid()).pw_dir)\n checked(home, directory=True)\n folder = home / '.ssh'; info = checked(folder, directory=True)\n machine = machine_id if machine_id is not None else Path('/etc/machine-id').read_text().strip()\n if not re.fullmatch(r'[A-Za-z0-9_-]{1,128}', machine): raise Refused('INVALID_MACHINE_ID')\n identity = {'uid': os.getuid(), 'home': str(home), 'machineId': machine, 'sshDirectoryDevice': info.st_dev, 'sshDirectoryInode': info.st_ino}\n if payload.get('expectedIdentity') is not None and payload['expectedIdentity'] != identity:\n raise Refused('REMOTE_IDENTITY_CHANGED')\n if payload['action'] != 'inspect' and payload.get('expectedIdentity') is None:\n raise Refused('EXPECTED_IDENTITY_REQUIRED')\n lock = folder / '.dreamlake-vault-rotation.lock'\n folder_fd = os.open(folder, os.O_RDONLY | os.O_DIRECTORY | os.O_NOFOLLOW)\n fd = os.open(lock.name, os.O_WRONLY | os.O_CREAT | os.O_NOFOLLOW | os.O_NONBLOCK, 0o600, dir_fd=folder_fd)\n journal_fd = None\n try:\n lock_info = checked(lock, private=True)\n if (lock_info.st_dev, lock_info.st_ino) != (os.fstat(fd).st_dev, os.fstat(fd).st_ino): raise Refused('UNSAFE_PATH')\n fcntl.flock(fd, fcntl.LOCK_EX)\n same_directory(folder, folder_fd)\n authorized = folder / 'authorized_keys'\n contents, metadata = read_checked(authorized.name, folder_fd)\n lines = contents.splitlines(keepends=True)\n old_matches, new_matches = matching(lines, old), matching(lines, new)\n journal_dir = folder / '.dreamlake-vault-rotations'\n if journal_dir.exists():\n checked(journal_dir, directory=True, private=True)\n journal_fd = os.open(journal_dir.name, os.O_RDONLY | os.O_DIRECTORY | os.O_NOFOLLOW, dir_fd=folder_fd)\n same_directory(journal_dir, journal_fd)\n journal_path = journal_dir / (payload['operationId'] + '.json')\n journal = None\n if journal_path.exists():\n if journal_fd is None: raise Refused('UNSAFE_PATH')\n journal_bytes, _ = read_checked(journal_path.name, journal_fd, private=True)\n journal = json.loads(journal_bytes)\n if any(journal.get(k) != v for k, v in {'operationId': payload['operationId'], 'oldPublicKey': old.decode(), 'newPublicKey': new.decode(), 'identity': identity}.items()):\n raise Refused('OPERATION_CONFLICT')\n if not old_matches and not journal:\n raise Refused('OLD_KEY_NOT_FOUND')\n if new_matches and not journal:\n raise Refused('REPLACEMENT_ALREADY_PRESENT')\n if journal:\n if journal.get('state') not in ('prepared', 'installed', 'removing_old', 'old_removed', 'removing_new', 'new_removed'): raise Refused('INVALID_JOURNAL')\n if not old_matches and journal['state'] not in ('removing_old', 'old_removed'): raise Refused('OLD_KEY_NOT_FOUND')\n if old_matches and digest(old_matches[0][2]) != journal['oldLineHash']:\n raise Refused('OLD_KEY_CHANGED')\n if new_matches and digest(new_matches[0][2]) != journal['newLineHash']:\n raise Refused('NEW_KEY_CHANGED')\n action = payload['action']\n if action == 'install':\n if journal and journal['state'] not in ('prepared', 'installed'): raise Refused('OPERATION_TERMINAL')\n if not old_matches: raise Refused('OLD_KEY_NOT_FOUND')\n if journal is None:\n ending = b'\\r\\n' if old_matches[0][2].endswith(b'\\r\\n') else b'\\n'\n new_line = old_matches[0][1] + new + b' dreamlake-vault:' + payload['operationId'].encode() + ending\n journal = {'operationId': payload['operationId'], 'oldPublicKey': old.decode(), 'newPublicKey': new.decode(), 'identity': identity, 'oldLineHash': digest(old_matches[0][2]), 'newLineHash': digest(new_line), 'state': 'prepared'}\n journal_dir.mkdir(mode=0o700, exist_ok=True); checked(journal_dir, directory=True, private=True)\n if journal_fd is None: journal_fd = os.open(journal_dir.name, os.O_RDONLY | os.O_DIRECTORY | os.O_NOFOLLOW, dir_fd=folder_fd)\n atomic(journal_path, json.dumps(journal).encode(), 0o600, journal_fd)\n else:\n ending = b'\\r\\n' if old_matches[0][2].endswith(b'\\r\\n') else b'\\n'\n new_line = old_matches[0][1] + new + b' dreamlake-vault:' + payload['operationId'].encode() + ending\n if digest(new_line) != journal['newLineHash']: raise Refused('NEW_KEY_CHANGED')\n if not new_matches:\n atomic(authorized, new_line + contents, stat.S_IMODE(metadata.st_mode), folder_fd, metadata.st_gid, (contents, metadata))\n journal['state'] = 'installed'\n elif action in ('remove_old', 'remove_new'):\n if not journal: raise Refused('OPERATION_NOT_FOUND')\n if action == 'remove_old' and not new_matches: raise Refused('NEW_KEY_NOT_FOUND')\n if action == 'remove_new' and not old_matches: raise Refused('OLD_KEY_NOT_FOUND')\n if action == 'remove_old' and journal['state'] not in ('installed', 'removing_old', 'old_removed'): raise Refused('OPERATION_TERMINAL')\n if action == 'remove_new' and journal['state'] not in ('prepared', 'installed', 'removing_new', 'new_removed'): raise Refused('OPERATION_TERMINAL')\n selected = old_matches if action == 'remove_old' else new_matches\n journal['state'] = 'removing_old' if action == 'remove_old' else 'removing_new'\n atomic(journal_path, json.dumps(journal).encode(), 0o600, journal_fd)\n if selected:\n del lines[selected[0][0]]\n atomic(authorized, b''.join(lines), stat.S_IMODE(metadata.st_mode), folder_fd, metadata.st_gid, (contents, metadata))\n journal['state'] = 'old_removed' if action == 'remove_old' else 'new_removed'\n if action != 'inspect': atomic(journal_path, json.dumps(journal).encode(), 0o600, journal_fd)\n final = read_checked(authorized.name, folder_fd)[0].splitlines(keepends=True)\n return {'identity': identity, 'oldPresent': bool(matching(final, old)), 'newPresent': bool(matching(final, new))}\n finally:\n os.close(fd)\n os.close(folder_fd)\n if journal_fd is not None: os.close(journal_fd)\n\n\ndef main():\n try:\n raw = sys.stdin.buffer.read(65537)\n if len(raw) > 65536: raise Refused(\"INPUT_TOO_LARGE\")\n payload = json.loads(raw)\n result = operate(payload)\n print(json.dumps(result))\n except Exception as error:\n code = str(error) if isinstance(error, Refused) else 'REMOTE_OPERATION_FAILED'\n print(json.dumps({'error': code})); raise SystemExit(1)\n\n\nif __name__ == '__main__': main()\n";
@@ -0,0 +1,3 @@
1
+ // Generated from Python SDK src/dreamlake/host_key_remote.py. Keep exact bytes in sync.
2
+ export const ROTATION_HELPER_SHA256 = "41647b71447adaef4995a9970248726b2fc15943f666cf40945e897c32d23ce0";
3
+ export const ROTATION_HELPER_SOURCE = "\"\"\"Standalone remote Python3 helper: public-key metadata only; no SDK dependency.\"\"\"\nimport base64\nimport fcntl\nimport hashlib\nimport json\nimport os\nfrom pathlib import Path\nimport pwd\nimport re\nimport stat\nimport sys\nimport uuid\n\n\nclass Refused(Exception):\n pass\n\n\ndef checked(path, directory=False, private=False):\n info = path.lstat()\n kind = stat.S_ISDIR if directory else stat.S_ISREG\n if not kind(info.st_mode) or info.st_uid != os.getuid() or info.st_mode & 0o022 or not directory and info.st_nlink != 1:\n raise Refused('UNSAFE_PATH')\n if private and info.st_mode & 0o077:\n raise Refused('UNSAFE_PATH')\n return info\n\n\ndef public(value):\n if not isinstance(value, str) or not re.fullmatch(r'(ssh-ed25519|ssh-rsa|ecdsa-sha2-nistp(?:256|384|521)) [A-Za-z0-9+/]+={0,3}', value) or len(value) > 8192:\n raise Refused('INVALID_PUBLIC_KEY')\n kind, encoded = value.split(' ')\n try:\n raw = base64.b64decode(encoded, validate=True)\n size = int.from_bytes(raw[:4], 'big')\n if raw[4:4 + size].decode() != kind or len(raw) < 4 + size + 4:\n raise ValueError()\n except (ValueError, UnicodeError):\n raise Refused('INVALID_PUBLIC_KEY') from None\n return value.encode()\n\n\ndef restrictions(prefix):\n \"\"\"Preserve allowed options byte-for-byte; never silently broaden access.\"\"\"\n text = prefix.strip().decode('utf-8', errors='strict')\n if not text:\n return\n chunks, current, quoted, escaped = [], '', False, False\n for char in text:\n if escaped:\n current += char; escaped = False; continue\n if char == '\\\\' and quoted:\n current += char; escaped = True; continue\n if char == '\"':\n quoted = not quoted\n if char == ',' and not quoted:\n chunks.append(current); current = ''; continue\n if char.isspace() and not quoted:\n raise Refused('UNSUPPORTED_KEY_CONSTRAINTS')\n current += char\n chunks.append(current)\n flags = {'restrict', 'no-agent-forwarding', 'no-port-forwarding', 'no-pty', 'no-user-rc', 'no-X11-forwarding', 'agent-forwarding', 'port-forwarding', 'pty', 'user-rc', 'X11-forwarding'}\n values = {'command', 'from', 'environment', 'permitopen', 'permitlisten', 'expiry-time', 'tunnel'}\n if quoted or escaped or any(c not in flags and not any(c.startswith(k + '=\"') and c.endswith('\"') for k in values) for c in chunks):\n raise Refused('UNSUPPORTED_KEY_CONSTRAINTS')\n\n\ndef matching(lines, key):\n kind, blob = key.split(b' ')\n result = []\n expression = re.compile(rb'(?<!\\S)' + re.escape(kind) + rb'[ \\t]+' + re.escape(blob) + rb'(?=[ \\t]|$)')\n for index, line in enumerate(lines):\n content = line.rstrip(b'\\r\\n')\n matches = list(expression.finditer(content))\n if not matches:\n continue\n if len(matches) != 1:\n raise Refused('AMBIGUOUS_KEY')\n match = matches[0]\n prefix = content[:match.start()]\n restrictions(prefix)\n result.append((index, prefix, line))\n if len(result) > 1:\n raise Refused('DUPLICATE_KEY')\n return result\n\n\ndef digest(value):\n return hashlib.sha256(value).hexdigest()\n\n\ndef read_checked(name, parent_fd, private=False):\n try:\n fd = os.open(name, os.O_RDONLY | os.O_NOFOLLOW | os.O_NONBLOCK, dir_fd=parent_fd)\n except OSError:\n raise Refused('UNSAFE_PATH') from None\n with os.fdopen(fd, 'rb') as stream:\n info = os.fstat(stream.fileno())\n if not stat.S_ISREG(info.st_mode) or info.st_uid != os.getuid() or info.st_mode & 0o022 or info.st_nlink != 1 or private and info.st_mode & 0o077:\n raise Refused('UNSAFE_PATH')\n data = stream.read(1024 * 1024 + 1)\n after = os.fstat(stream.fileno())\n if len(data) > 1024 * 1024 or (info.st_size, info.st_mtime_ns) != (after.st_size, after.st_mtime_ns):\n raise Refused('FILE_CHANGED')\n return data, info\n\n\ndef same_directory(path, parent_fd):\n current, pinned = checked(path, directory=True), os.fstat(parent_fd)\n if (current.st_dev, current.st_ino) != (pinned.st_dev, pinned.st_ino):\n raise Refused('REMOTE_IDENTITY_CHANGED')\n\n\ndef atomic(path, value, mode, parent_fd, group=None, expected=None):\n temporary = '.rotation-' + uuid.uuid4().hex\n descriptor = os.open(temporary, os.O_WRONLY | os.O_CREAT | os.O_EXCL | os.O_NOFOLLOW, 0o600, dir_fd=parent_fd)\n try:\n os.fchmod(descriptor, mode)\n if group is not None: os.fchown(descriptor, -1, group)\n with os.fdopen(descriptor, 'wb') as stream:\n stream.write(value); stream.flush(); os.fsync(stream.fileno())\n same_directory(path.parent, parent_fd)\n if expected is not None:\n old_bytes, old_info = expected\n current_bytes, current_info = read_checked(path.name, parent_fd)\n fields = ('st_dev', 'st_ino', 'st_mode', 'st_uid', 'st_gid', 'st_size', 'st_mtime_ns')\n if current_bytes != old_bytes or any(getattr(current_info, k) != getattr(old_info, k) for k in fields):\n raise Refused('AUTHORIZED_KEYS_CHANGED')\n os.replace(temporary, path.name, src_dir_fd=parent_fd, dst_dir_fd=parent_fd)\n os.fsync(parent_fd)\n finally:\n try: os.unlink(temporary, dir_fd=parent_fd)\n except FileNotFoundError: pass\n\n\ndef operate(payload, *, home=None, machine_id=None):\n allowed = {'action', 'operationId', 'oldPublicKey', 'newPublicKey', 'expectedIdentity'}\n if not isinstance(payload, dict) or set(payload) - allowed or payload.get('action') not in ('inspect', 'install', 'remove_old', 'remove_new') or not isinstance(payload.get('operationId'), str) or not re.fullmatch(r'[A-Za-z0-9_-]{1,128}', payload['operationId']):\n raise Refused('INVALID_REQUEST')\n old, new = public(payload.get('oldPublicKey')), public(payload.get('newPublicKey'))\n if old == new: raise Refused('SAME_KEY')\n home = Path(home) if home is not None else Path(pwd.getpwuid(os.getuid()).pw_dir)\n checked(home, directory=True)\n folder = home / '.ssh'; info = checked(folder, directory=True)\n machine = machine_id if machine_id is not None else Path('/etc/machine-id').read_text().strip()\n if not re.fullmatch(r'[A-Za-z0-9_-]{1,128}', machine): raise Refused('INVALID_MACHINE_ID')\n identity = {'uid': os.getuid(), 'home': str(home), 'machineId': machine, 'sshDirectoryDevice': info.st_dev, 'sshDirectoryInode': info.st_ino}\n if payload.get('expectedIdentity') is not None and payload['expectedIdentity'] != identity:\n raise Refused('REMOTE_IDENTITY_CHANGED')\n if payload['action'] != 'inspect' and payload.get('expectedIdentity') is None:\n raise Refused('EXPECTED_IDENTITY_REQUIRED')\n lock = folder / '.dreamlake-vault-rotation.lock'\n folder_fd = os.open(folder, os.O_RDONLY | os.O_DIRECTORY | os.O_NOFOLLOW)\n fd = os.open(lock.name, os.O_WRONLY | os.O_CREAT | os.O_NOFOLLOW | os.O_NONBLOCK, 0o600, dir_fd=folder_fd)\n journal_fd = None\n try:\n lock_info = checked(lock, private=True)\n if (lock_info.st_dev, lock_info.st_ino) != (os.fstat(fd).st_dev, os.fstat(fd).st_ino): raise Refused('UNSAFE_PATH')\n fcntl.flock(fd, fcntl.LOCK_EX)\n same_directory(folder, folder_fd)\n authorized = folder / 'authorized_keys'\n contents, metadata = read_checked(authorized.name, folder_fd)\n lines = contents.splitlines(keepends=True)\n old_matches, new_matches = matching(lines, old), matching(lines, new)\n journal_dir = folder / '.dreamlake-vault-rotations'\n if journal_dir.exists():\n checked(journal_dir, directory=True, private=True)\n journal_fd = os.open(journal_dir.name, os.O_RDONLY | os.O_DIRECTORY | os.O_NOFOLLOW, dir_fd=folder_fd)\n same_directory(journal_dir, journal_fd)\n journal_path = journal_dir / (payload['operationId'] + '.json')\n journal = None\n if journal_path.exists():\n if journal_fd is None: raise Refused('UNSAFE_PATH')\n journal_bytes, _ = read_checked(journal_path.name, journal_fd, private=True)\n journal = json.loads(journal_bytes)\n if any(journal.get(k) != v for k, v in {'operationId': payload['operationId'], 'oldPublicKey': old.decode(), 'newPublicKey': new.decode(), 'identity': identity}.items()):\n raise Refused('OPERATION_CONFLICT')\n if not old_matches and not journal:\n raise Refused('OLD_KEY_NOT_FOUND')\n if new_matches and not journal:\n raise Refused('REPLACEMENT_ALREADY_PRESENT')\n if journal:\n if journal.get('state') not in ('prepared', 'installed', 'removing_old', 'old_removed', 'removing_new', 'new_removed'): raise Refused('INVALID_JOURNAL')\n if not old_matches and journal['state'] not in ('removing_old', 'old_removed'): raise Refused('OLD_KEY_NOT_FOUND')\n if old_matches and digest(old_matches[0][2]) != journal['oldLineHash']:\n raise Refused('OLD_KEY_CHANGED')\n if new_matches and digest(new_matches[0][2]) != journal['newLineHash']:\n raise Refused('NEW_KEY_CHANGED')\n action = payload['action']\n if action == 'install':\n if journal and journal['state'] not in ('prepared', 'installed'): raise Refused('OPERATION_TERMINAL')\n if not old_matches: raise Refused('OLD_KEY_NOT_FOUND')\n if journal is None:\n ending = b'\\r\\n' if old_matches[0][2].endswith(b'\\r\\n') else b'\\n'\n new_line = old_matches[0][1] + new + b' dreamlake-vault:' + payload['operationId'].encode() + ending\n journal = {'operationId': payload['operationId'], 'oldPublicKey': old.decode(), 'newPublicKey': new.decode(), 'identity': identity, 'oldLineHash': digest(old_matches[0][2]), 'newLineHash': digest(new_line), 'state': 'prepared'}\n journal_dir.mkdir(mode=0o700, exist_ok=True); checked(journal_dir, directory=True, private=True)\n if journal_fd is None: journal_fd = os.open(journal_dir.name, os.O_RDONLY | os.O_DIRECTORY | os.O_NOFOLLOW, dir_fd=folder_fd)\n atomic(journal_path, json.dumps(journal).encode(), 0o600, journal_fd)\n else:\n ending = b'\\r\\n' if old_matches[0][2].endswith(b'\\r\\n') else b'\\n'\n new_line = old_matches[0][1] + new + b' dreamlake-vault:' + payload['operationId'].encode() + ending\n if digest(new_line) != journal['newLineHash']: raise Refused('NEW_KEY_CHANGED')\n if not new_matches:\n atomic(authorized, new_line + contents, stat.S_IMODE(metadata.st_mode), folder_fd, metadata.st_gid, (contents, metadata))\n journal['state'] = 'installed'\n elif action in ('remove_old', 'remove_new'):\n if not journal: raise Refused('OPERATION_NOT_FOUND')\n if action == 'remove_old' and not new_matches: raise Refused('NEW_KEY_NOT_FOUND')\n if action == 'remove_new' and not old_matches: raise Refused('OLD_KEY_NOT_FOUND')\n if action == 'remove_old' and journal['state'] not in ('installed', 'removing_old', 'old_removed'): raise Refused('OPERATION_TERMINAL')\n if action == 'remove_new' and journal['state'] not in ('prepared', 'installed', 'removing_new', 'new_removed'): raise Refused('OPERATION_TERMINAL')\n selected = old_matches if action == 'remove_old' else new_matches\n journal['state'] = 'removing_old' if action == 'remove_old' else 'removing_new'\n atomic(journal_path, json.dumps(journal).encode(), 0o600, journal_fd)\n if selected:\n del lines[selected[0][0]]\n atomic(authorized, b''.join(lines), stat.S_IMODE(metadata.st_mode), folder_fd, metadata.st_gid, (contents, metadata))\n journal['state'] = 'old_removed' if action == 'remove_old' else 'new_removed'\n if action != 'inspect': atomic(journal_path, json.dumps(journal).encode(), 0o600, journal_fd)\n final = read_checked(authorized.name, folder_fd)[0].splitlines(keepends=True)\n return {'identity': identity, 'oldPresent': bool(matching(final, old)), 'newPresent': bool(matching(final, new))}\n finally:\n os.close(fd)\n os.close(folder_fd)\n if journal_fd is not None: os.close(journal_fd)\n\n\ndef main():\n try:\n raw = sys.stdin.buffer.read(65537)\n if len(raw) > 65536: raise Refused(\"INPUT_TOO_LARGE\")\n payload = json.loads(raw)\n result = operate(payload)\n print(json.dumps(result))\n except Exception as error:\n code = str(error) if isinstance(error, Refused) else 'REMOTE_OPERATION_FAILED'\n print(json.dumps({'error': code})); raise SystemExit(1)\n\n\nif __name__ == '__main__': main()\n";
@@ -0,0 +1,11 @@
1
+ import { type RotationEndpoint, type RotationTransport } from './rotationTransport.js';
2
+ /** Explicit endpoint grammar, normalized before any key or network access.
3
+ * Keys come from the selected binding, never an ambient SSH configuration. */
4
+ export declare function rotationEndpoint(input: string, knownHostsFile: string): RotationEndpoint;
5
+ export declare function rotationTransportInput(options: {
6
+ ssh: string;
7
+ knownHosts: string;
8
+ jumpSsh?: string;
9
+ jumpKnownHosts?: string;
10
+ jumpIdentity?: string;
11
+ }): RotationTransport;