@dreamlake/dreamlake-cli 0.88.1 → 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,115 @@
1
+ import { isDeepStrictEqual } from 'node:util';
2
+ import { isAbsolute } from 'node:path';
3
+ import { createHash } from 'node:crypto';
4
+ import { bindingInput } from './hostCredentials.js';
5
+ import { supersessionReceipt } from './hostSupersessions.js';
6
+ import { remoteIdentity, validateHelperRequest } from './rotationRemote.js';
7
+ import { rotationSshConfig } from './rotationTransport.js';
8
+ import { rotationPhases } from './rotationJournal.js';
9
+ const immutable = ['schema', 'operationId', 'origin', 'account', 'bindingId', 'hostId', 'enrollmentId', 'role', 'endpoint', 'kind',
10
+ 'expectedEntryId', 'expectedEntryRevision', 'oldEntryName', 'replacementEntryName', 'writeRequestId', 'sshProfile',
11
+ 'oldKeyPath', 'newKeyPath', 'oldPublicKey', 'newPublicKey', 'oldFingerprint', 'newFingerprint', 'remoteIdentity'];
12
+ const allowed = [...immutable, 'replacementEntryId', 'replacementEntryRevision', 'phase', 'timestamps', 'verification', 'receipt'];
13
+ function object(value) {
14
+ if (!value || typeof value !== 'object' || Array.isArray(value))
15
+ throw new Error('Invalid rotation metadata');
16
+ }
17
+ function exact(value, fields) {
18
+ object(value);
19
+ if (Object.keys(value).some(key => !fields.includes(key)))
20
+ throw new Error('Unexpected rotation metadata');
21
+ }
22
+ function timestamp(value) {
23
+ return typeof value === 'string' && /^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(?:\.\d{1,6})?Z$/.test(value) && Number.isFinite(Date.parse(value)) && new Date(value).toISOString().slice(0, 19) === value.slice(0, 19);
24
+ }
25
+ function name(value) {
26
+ if (typeof value !== 'string' || value.length > 512 || !/^[A-Za-z0-9_.-]+(?:\/[A-Za-z0-9_.-]+)+$/.test(value) || value.split('/').some(x => x === '.' || x === '..'))
27
+ throw new Error('Invalid rotation entry name');
28
+ }
29
+ function profile(value) {
30
+ exact(value, ['host', 'user', 'port', 'knownHostsFile', 'jump']);
31
+ if (value.jump !== undefined)
32
+ exact(value.jump, ['host', 'user', 'port', 'knownHostsFile', 'identityFile']);
33
+ rotationSshConfig(value, '/rotation-validation-only');
34
+ }
35
+ export function publicFingerprint(key) {
36
+ const [kind, encoded] = key.split(' ');
37
+ const bytes = Buffer.from(encoded ?? '', 'base64');
38
+ if (bytes.toString('base64') !== encoded || bytes.length < 8)
39
+ throw new Error('Invalid public key encoding');
40
+ const size = bytes.readUInt32BE(0);
41
+ if (size > bytes.length - 8 || bytes.subarray(4, 4 + size).toString() !== kind)
42
+ throw new Error('Invalid public key type');
43
+ return 'SHA256:' + createHash('sha256').update(bytes).digest('base64').replace(/=+$/, '');
44
+ }
45
+ export function validateRotationState(value) {
46
+ const v = value;
47
+ exact(v, allowed);
48
+ if (immutable.some(key => v[key] === undefined) || v.schema !== 'dreamlake.host-key-rotation/v1' || v.kind !== 'private_key' ||
49
+ !/^[0-9a-f-]{36}$/.test(v.bindingId) || typeof v.account !== 'string' || !/^[A-Za-z0-9_.:@|-]{1,255}$/.test(v.account))
50
+ throw new Error('Invalid rotation identity');
51
+ const url = new URL(v.origin);
52
+ if (url.origin !== v.origin || url.username || url.password || (url.protocol !== 'https:' && !(url.protocol === 'http:' && ['localhost', '127.0.0.1', '[::1]'].includes(url.hostname))))
53
+ throw new Error('Invalid rotation origin');
54
+ bindingInput({ ...v, entryId: v.expectedEntryId, entryRevision: v.expectedEntryRevision });
55
+ name(v.oldEntryName);
56
+ name(v.replacementEntryName);
57
+ if (v.oldEntryName === v.replacementEntryName || v.oldKeyPath === v.newKeyPath || v.oldPublicKey === v.newPublicKey ||
58
+ v.writeRequestId !== 'rotate_' + v.operationId.replace(/-/g, ''))
59
+ throw new Error('Invalid replacement intent');
60
+ for (const path of [v.oldKeyPath, v.newKeyPath])
61
+ if (typeof path !== 'string' || !isAbsolute(path) || /[\r\n\0%$]/.test(path))
62
+ throw new Error('Invalid rotation key path');
63
+ profile(v.sshProfile);
64
+ remoteIdentity(v.remoteIdentity);
65
+ validateHelperRequest({ action: 'inspect', operationId: v.operationId, oldPublicKey: v.oldPublicKey, newPublicKey: v.newPublicKey });
66
+ if (v.oldFingerprint !== publicFingerprint(v.oldPublicKey) || v.newFingerprint !== publicFingerprint(v.newPublicKey))
67
+ throw new Error('Fingerprint mismatch');
68
+ const index = rotationPhases.indexOf(v.phase);
69
+ if (index < 0)
70
+ throw new Error('Invalid phase');
71
+ exact(v.timestamps, rotationPhases.slice(0, index + 1));
72
+ let previous = -Infinity;
73
+ for (const phase of rotationPhases.slice(0, index + 1)) {
74
+ if (!timestamp(v.timestamps[phase]) || Date.parse(v.timestamps[phase]) < previous)
75
+ throw new Error('Invalid phase timestamp');
76
+ previous = Date.parse(v.timestamps[phase]);
77
+ }
78
+ exact(v.verification, index >= 6 ? ['newLoginVerifiedAt', 'oldLoginDeniedAt', 'replacementReverifiedAt'] : index >= 3 ? ['newLoginVerifiedAt'] : []);
79
+ if (index >= 3 && !timestamp(v.verification.newLoginVerifiedAt))
80
+ throw new Error('Missing new-key verification');
81
+ if (index >= 6 && (!timestamp(v.verification.oldLoginDeniedAt) || !timestamp(v.verification.replacementReverifiedAt) || Date.parse(v.verification.oldLoginDeniedAt) > Date.parse(v.verification.replacementReverifiedAt)))
82
+ throw new Error('Missing revocation verification');
83
+ if (index >= 1) {
84
+ if (typeof v.replacementEntryId !== 'string' || v.replacementEntryId === v.expectedEntryId || !Number.isSafeInteger(v.replacementEntryRevision) || v.replacementEntryRevision < 1)
85
+ throw new Error('Invalid replacement receipt');
86
+ }
87
+ else if (v.replacementEntryId !== undefined || v.replacementEntryRevision !== undefined)
88
+ throw new Error('Premature replacement receipt');
89
+ if (index >= 4) {
90
+ const clean = supersessionReceipt({ operation: v.receipt }, v.operationId, v.bindingId, v);
91
+ if (!isDeepStrictEqual(clean, v.receipt))
92
+ throw new Error('Unexpected receipt metadata');
93
+ for (const key of ['hostId', 'enrollmentId', 'role', 'endpoint', 'kind'])
94
+ if (v.receipt[key] !== v[key])
95
+ throw new Error('Receipt scope mismatch');
96
+ }
97
+ else if (v.receipt !== undefined)
98
+ throw new Error('Premature supersession receipt');
99
+ return v;
100
+ }
101
+ /** Validate every adjacent pair, including immutable evidence already recorded. */
102
+ export function validateRotationTransition(previous, next) {
103
+ if (rotationPhases.indexOf(next.phase) !== rotationPhases.indexOf(previous.phase) + 1)
104
+ throw new Error('Invalid rotation transition');
105
+ for (const key of immutable)
106
+ if (!isDeepStrictEqual(previous[key], next[key]))
107
+ throw new Error('Rotation intent changed');
108
+ for (const key of ['replacementEntryId', 'replacementEntryRevision', 'receipt'])
109
+ if (previous[key] !== undefined && !isDeepStrictEqual(previous[key], next[key]))
110
+ throw new Error('Rotation evidence changed');
111
+ for (const group of ['timestamps', 'verification'])
112
+ for (const [key, item] of Object.entries(previous[group]))
113
+ if (next[group][key] !== item)
114
+ throw new Error('Rotation history changed');
115
+ }
@@ -0,0 +1,18 @@
1
+ /** Explicit transport metadata; no ambient ssh_config or agent identities. */
2
+ export interface RotationEndpoint {
3
+ host: string;
4
+ user: string;
5
+ port: number;
6
+ knownHostsFile: string;
7
+ }
8
+ export interface RotationTransport extends RotationEndpoint {
9
+ jump?: RotationEndpoint & {
10
+ identityFile: string;
11
+ };
12
+ }
13
+ /** Invoke ssh with `-F <this private config> rotation-target`, never `-i` alone.
14
+ * A supplied IdentityFile normally accumulates with ambient identities, which
15
+ * would invalidate both replacement-success and old-key-denial evidence. */
16
+ export declare function rotationSshConfig(transport: RotationTransport, selectedKey: string): string;
17
+ /** Refuse special files, shared key files and keys readable by other users. */
18
+ export declare function verifyRotationKey(path: string): Promise<void>;
@@ -0,0 +1,71 @@
1
+ import { constants } from 'node:fs';
2
+ import { open } from 'node:fs/promises';
3
+ import { isAbsolute } from 'node:path';
4
+ function pathValue(value) {
5
+ // OpenSSH expands percent and environment tokens even inside quoted values.
6
+ if (typeof value !== 'string' || !isAbsolute(value) || /[\r\n\0%$]/.test(value)) {
7
+ throw new Error('Rotation requires literal absolute file paths');
8
+ }
9
+ return '"' + value.replace(/\\/g, '\\\\').replace(/"/g, '\\"') + '"';
10
+ }
11
+ function endpointLines(alias, endpoint, key) {
12
+ if (!/^[A-Za-z0-9][A-Za-z0-9.:-]{0,253}$/.test(endpoint.host) ||
13
+ !/^[A-Za-z0-9_][A-Za-z0-9_.-]{0,127}$/.test(endpoint.user) ||
14
+ !Number.isSafeInteger(endpoint.port) || endpoint.port < 1 || endpoint.port > 65535) {
15
+ throw new Error('Invalid explicit rotation endpoint');
16
+ }
17
+ return [
18
+ `Host ${alias}`,
19
+ ` HostName ${endpoint.host}`,
20
+ ` User ${endpoint.user}`,
21
+ ` Port ${endpoint.port}`,
22
+ ` IdentityFile ${pathValue(key)}`,
23
+ ` UserKnownHostsFile ${pathValue(endpoint.knownHostsFile)}`,
24
+ ' GlobalKnownHostsFile /dev/null',
25
+ ' StrictHostKeyChecking yes',
26
+ ' UpdateHostKeys no',
27
+ ' VerifyHostKeyDNS no',
28
+ ' IdentitiesOnly yes',
29
+ ' IdentityAgent none',
30
+ ' CertificateFile none',
31
+ ' PKCS11Provider none',
32
+ ' PreferredAuthentications publickey',
33
+ ' PasswordAuthentication no',
34
+ ' KbdInteractiveAuthentication no',
35
+ ' BatchMode yes',
36
+ ' ControlMaster no',
37
+ ' ControlPath none',
38
+ ' ControlPersist no',
39
+ ' ForwardAgent no',
40
+ ' ClearAllForwardings yes',
41
+ ' PermitLocalCommand no',
42
+ ' RequestTTY no',
43
+ ' ConnectionAttempts 1',
44
+ ' ConnectTimeout 10',
45
+ ];
46
+ }
47
+ /** Invoke ssh with `-F <this private config> rotation-target`, never `-i` alone.
48
+ * A supplied IdentityFile normally accumulates with ambient identities, which
49
+ * would invalidate both replacement-success and old-key-denial evidence. */
50
+ export function rotationSshConfig(transport, selectedKey) {
51
+ const lines = endpointLines('rotation-target', transport, selectedKey);
52
+ if (transport.jump) {
53
+ lines.push(' ProxyJump rotation-jump', '', ...endpointLines('rotation-jump', transport.jump, transport.jump.identityFile));
54
+ }
55
+ return lines.join('\n') + '\n';
56
+ }
57
+ /** Refuse special files, shared key files and keys readable by other users. */
58
+ export async function verifyRotationKey(path) {
59
+ pathValue(path);
60
+ const handle = await open(path, constants.O_RDONLY | constants.O_NOFOLLOW | constants.O_NONBLOCK);
61
+ try {
62
+ const stat = await handle.stat();
63
+ if (!stat.isFile() || stat.nlink !== 1 || stat.uid !== process.getuid?.() ||
64
+ (stat.mode & 0o777) !== 0o600 || stat.size === 0 || stat.size > 65536) {
65
+ throw new Error('Unsafe rotation identity file');
66
+ }
67
+ }
68
+ finally {
69
+ await handle.close();
70
+ }
71
+ }
@@ -0,0 +1,18 @@
1
+ export interface SshItem {
2
+ id: string;
3
+ kind: 'profile' | 'private-key';
4
+ alias: string;
5
+ profile: Record<string, string>;
6
+ keyPath?: string;
7
+ reference?: string;
8
+ }
9
+ export interface SshDiscovery {
10
+ items: SshItem[];
11
+ warnings: string[];
12
+ }
13
+ /** Bounded regular-file reads; no symlink components, devices, FIFOs or permissive keys.
14
+ * The file descriptor and path are checked before and after reading. Never log OS errors.
15
+ */
16
+ export declare function readSshFile(path: string, privateKey?: boolean): Promise<string>;
17
+ export declare function keyReferencePath(reference: string, home?: string): string | undefined;
18
+ export declare function discoverSsh(config: string, home?: string): SshDiscovery;
@@ -0,0 +1,196 @@
1
+ import { constants } from 'node:fs';
2
+ import { lstat, open, realpath } from 'node:fs/promises';
3
+ import { homedir } from 'node:os';
4
+ import { isAbsolute, resolve } from 'node:path';
5
+ const LIMIT = 65536;
6
+ /** Bounded regular-file reads; no symlink components, devices, FIFOs or permissive keys.
7
+ * The file descriptor and path are checked before and after reading. Never log OS errors.
8
+ */
9
+ export async function readSshFile(path, privateKey = false) {
10
+ let buffer;
11
+ try {
12
+ if (!isAbsolute(path) || await realpath(path) !== path)
13
+ throw new Error();
14
+ const before = await lstat(path);
15
+ if (!before.isFile() || before.isSymbolicLink())
16
+ throw new Error();
17
+ const file = await open(path, constants.O_RDONLY | constants.O_NOFOLLOW | constants.O_NONBLOCK);
18
+ try {
19
+ const stat = await file.stat();
20
+ const allowed = (s) => s.isFile() && s.size <= LIMIT && s.nlink === 1 &&
21
+ (process.getuid === undefined || s.uid === process.getuid()) &&
22
+ (s.mode & (privateKey ? 0o077 : 0o022)) === 0;
23
+ if (!allowed(stat) || stat.ino !== before.ino || stat.dev !== before.dev)
24
+ throw new Error();
25
+ buffer = Buffer.alloc(LIMIT + 1);
26
+ let total = 0;
27
+ while (total < buffer.length) {
28
+ const { bytesRead } = await file.read(buffer, total, buffer.length - total, null);
29
+ if (!bytesRead)
30
+ break;
31
+ total += bytesRead;
32
+ }
33
+ const after = await file.stat(), current = await lstat(path);
34
+ if (total > LIMIT || !allowed(after) || after.size !== stat.size || after.mtimeMs !== stat.mtimeMs ||
35
+ after.ctimeMs !== stat.ctimeMs || current.ino !== stat.ino || current.dev !== stat.dev ||
36
+ await realpath(path) !== path)
37
+ throw new Error();
38
+ const value = new TextDecoder('utf-8', { fatal: true, ignoreBOM: true }).decode(buffer.subarray(0, total));
39
+ if (value.includes('\0'))
40
+ throw new Error();
41
+ return value;
42
+ }
43
+ finally {
44
+ await file.close();
45
+ }
46
+ }
47
+ catch {
48
+ throw new Error(privateKey ? 'Selected private-key file is unsafe, changed, unreadable or invalid UTF-8' : 'SSH config is unsafe, changed, unreadable or invalid UTF-8');
49
+ }
50
+ finally {
51
+ buffer?.fill(0);
52
+ }
53
+ }
54
+ // Deliberately a subset, not OpenSSH evaluation. No shell, ssh -G, Includes,
55
+ // environment expansion, token expansion, wildcard inheritance or Match execution.
56
+ function words(line) {
57
+ const result = [];
58
+ let word = '', quote = '', started = false;
59
+ for (const char of line) {
60
+ if (char === '\\')
61
+ return null; // ambiguous escapes/continuations require manual simplification
62
+ if (quote) {
63
+ if (char === quote)
64
+ quote = '';
65
+ else
66
+ word += char;
67
+ started = true;
68
+ }
69
+ else if (char === '"' || char === "'") {
70
+ quote = char;
71
+ started = true;
72
+ }
73
+ else if (char === '#')
74
+ break;
75
+ else if (/\s/.test(char)) {
76
+ if (started)
77
+ result.push(word);
78
+ word = '';
79
+ started = false;
80
+ }
81
+ else {
82
+ word += char;
83
+ started = true;
84
+ }
85
+ }
86
+ if (quote)
87
+ return null;
88
+ if (started)
89
+ result.push(word);
90
+ return result;
91
+ }
92
+ export function keyReferencePath(reference, home = homedir()) {
93
+ if (/[\x00-\x1f\x7f%$`*?!]/.test(reference) || reference === 'none')
94
+ return undefined;
95
+ const path = reference.startsWith('~/') ? resolve(home, reference.slice(2)) : reference;
96
+ return isAbsolute(path) ? resolve(path) : undefined;
97
+ }
98
+ export function discoverSsh(config, home = homedir()) {
99
+ if (Buffer.byteLength(config) > LIMIT || /[\x00-\x08\x0b\x0c\x0e-\x1f\x7f]/.test(config))
100
+ throw new Error('SSH config contains unsupported control characters or exceeds 64 KiB');
101
+ const warnings = new Set();
102
+ const blocks = [];
103
+ let block;
104
+ for (const [index, raw] of config.split(/\r?\n/).entries()) {
105
+ const line = raw.trim();
106
+ if (!line || line.startsWith('#'))
107
+ continue;
108
+ const match = /^([A-Za-z][A-Za-z0-9]*)\s*(?:=\s*|\s+)(.*)$/.exec(line);
109
+ if (!match) {
110
+ if (block)
111
+ block.invalid = true;
112
+ warnings.add(`Line ${index + 1}: unsupported syntax; current profile excluded`);
113
+ continue;
114
+ }
115
+ const directive = match[1].toLowerCase();
116
+ // Do not tokenize or copy values of arbitrary directives (they may contain secrets).
117
+ if (directive === 'match') {
118
+ block = undefined;
119
+ warnings.add('Match sections ignored; no conditions executed');
120
+ continue;
121
+ }
122
+ if (directive === 'include') {
123
+ warnings.add('Include ignored; no files followed');
124
+ continue;
125
+ }
126
+ if (directive === 'host') {
127
+ const aliases = words(match[2]);
128
+ block = { aliases: aliases ?? [], values: {}, keys: [], invalid: aliases === null };
129
+ blocks.push(block);
130
+ if (!aliases)
131
+ warnings.add(`Line ${index + 1}: unsupported Host syntax excluded`);
132
+ continue;
133
+ }
134
+ if (!['hostname', 'user', 'port', 'proxyjump', 'identityfile'].includes(directive)) {
135
+ warnings.add(`Line ${index + 1}: directive omitted from portable profiles`);
136
+ continue;
137
+ }
138
+ if (!block) {
139
+ warnings.add('Global and Match settings ignored');
140
+ continue;
141
+ }
142
+ const args = words(match[2]);
143
+ if (!args || args.length !== 1 || !args[0]) {
144
+ block.invalid = true;
145
+ warnings.add(`Line ${index + 1}: unsupported value; profile excluded`);
146
+ continue;
147
+ }
148
+ if (directive === 'identityfile')
149
+ block.keys.push(args[0]);
150
+ else if (!(directive in block.values))
151
+ block.values[directive] = args[0];
152
+ }
153
+ const counts = new Map();
154
+ for (const b of blocks)
155
+ for (const alias of b.aliases)
156
+ counts.set(alias.toLowerCase(), (counts.get(alias.toLowerCase()) ?? 0) + 1);
157
+ const items = [];
158
+ for (const b of blocks) {
159
+ for (const alias of b.aliases) {
160
+ if (!/^[A-Za-z0-9][A-Za-z0-9_-]{0,127}$/.test(alias)) {
161
+ warnings.add('Wildcard, negated or unsafe aliases excluded (supported: letters, digits, underscore, hyphen)');
162
+ continue;
163
+ }
164
+ // Mixed positive/negative or wildcard stanzas are not concrete profiles.
165
+ if (b.aliases.some(a => /[*?!]/.test(a))) {
166
+ warnings.add('Pattern-containing Host blocks excluded');
167
+ continue;
168
+ }
169
+ if (counts.get(alias.toLowerCase()) !== 1) {
170
+ warnings.add(`Duplicate alias ${alias} excluded`);
171
+ continue;
172
+ }
173
+ const host = b.values.hostname ?? alias, user = b.values.user, port = b.values.port, jump = b.values.proxyjump;
174
+ if (b.invalid || !/^[A-Za-z0-9][A-Za-z0-9.:-]*$/.test(host) ||
175
+ (user !== undefined && !/^[A-Za-z0-9_][A-Za-z0-9_.-]*$/.test(user)) ||
176
+ (port !== undefined && (!/^[0-9]+$/.test(port) || Number(port) < 1 || Number(port) > 65535)) ||
177
+ (jump !== undefined && !/^[A-Za-z0-9_.@,:\[\]-]+$/.test(jump))) {
178
+ warnings.add(`Profile ${alias} excluded: unsupported connection fields`);
179
+ continue;
180
+ }
181
+ const profile = { schema: 'dreamlake-ssh-profile-v1', alias, hostname: host,
182
+ ...(user ? { user } : {}), ...(port ? { port } : {}), ...(jump ? { proxyjump: jump } : {}),
183
+ identityfiles: JSON.stringify(b.keys), interpretation: 'explicit-fields-only; dependencies are references' };
184
+ items.push({ id: `profile:${alias}`, kind: 'profile', alias, profile });
185
+ b.keys.forEach((reference, index) => {
186
+ const keyPath = keyReferencePath(reference, home);
187
+ if (keyPath)
188
+ items.push({ id: `key:${alias}:${index + 1}`, kind: 'private-key', alias, profile, keyPath, reference });
189
+ else
190
+ warnings.add(`Profile ${alias}: identity reference ${index + 1} is reference-only (relative, tokenized, hardware or unsupported path)`);
191
+ });
192
+ }
193
+ }
194
+ warnings.add('Only explicit portable fields are copied; defaults, Include, wildcard and Match inheritance are not resolved. Jump hosts and keys remain references unless separately selected.');
195
+ return { items, warnings: [...warnings] };
196
+ }
@@ -0,0 +1,17 @@
1
+ import type { Command } from 'commander';
2
+ import { type SshItem } from './sshSource.js';
3
+ import { type Transfer } from './sshTransfer.js';
4
+ export declare function selectSshItems(items: SshItem[]): Promise<string[] | null>;
5
+ export declare function confirm(message: string): Promise<boolean>;
6
+ export declare function planSsh(items: SshItem[], selected: string[], prefix: string, revisions: string[]): Transfer[];
7
+ export interface SshImportOptions {
8
+ config: string;
9
+ select: string[];
10
+ ifMatch: string[];
11
+ retry: string;
12
+ dryRun?: boolean;
13
+ json?: boolean;
14
+ }
15
+ export declare function configureSshImport(command: Command): Command;
16
+ export declare function registerSshSync(vault: Command): void;
17
+ export declare function runSshImport(options: SshImportOptions, command: Command): Promise<void>;
@@ -0,0 +1,224 @@
1
+ import { emitKeypressEvents } from 'node:readline';
2
+ import { homedir } from 'node:os';
3
+ import { resolve } from 'node:path';
4
+ import { resolveRemote, resolveToken } from '../config.js';
5
+ import { collectPrefix, invocationPrefix } from './index.js';
6
+ import { entryName, revisionNumber } from './mutations.js';
7
+ import { discoverSsh, readSshFile } from './sshSource.js';
8
+ import { boundVault, prepareTransfers, transferReport, transferSelected } from './sshTransfer.js';
9
+ function label(item) {
10
+ const p = item.profile;
11
+ return `${item.id} (${item.kind}) ${p.user ?? '(default user)'}@${p.hostname}:${p.port ?? '(default port)'} jump=${JSON.stringify(p.proxyjump ?? 'none')} keys=${p.identityfiles}${item.reference ? ` export=${JSON.stringify(item.reference)}` : ''}`;
12
+ }
13
+ function terminal(render, keypress) {
14
+ return new Promise((done, reject) => {
15
+ const raw = process.stdin.isRaw;
16
+ const paused = process.stdin.readableFlowing !== true;
17
+ const finish = (value) => { cleanup(); done(value); };
18
+ const onKey = (text, key = {}) => { try {
19
+ const result = keypress(key, text);
20
+ if (result)
21
+ finish(result.value);
22
+ }
23
+ catch {
24
+ cleanup();
25
+ reject(new Error('SSH terminal input failed'));
26
+ } };
27
+ const cleanup = () => {
28
+ process.stdin.off('keypress', onKey);
29
+ process.stdin.off('end', onEnd);
30
+ process.stdin.setRawMode(raw);
31
+ if (paused)
32
+ process.stdin.pause();
33
+ };
34
+ const onEnd = () => onKey('', { name: 'escape' });
35
+ emitKeypressEvents(process.stdin);
36
+ process.stdin.setRawMode(true);
37
+ process.stdin.resume();
38
+ process.stdin.on('keypress', onKey);
39
+ process.stdin.on('end', onEnd);
40
+ render();
41
+ });
42
+ }
43
+ function isCancel(key) { return key.name === 'escape' || key.ctrl && key.name === 'c'; }
44
+ export async function selectSshItems(items) {
45
+ const selected = new Set();
46
+ let cursor = 0;
47
+ const render = () => {
48
+ process.stderr.write('\x1b[2J\x1b[HSelect SSH entries to upload (nothing selected by default)\n');
49
+ const height = Math.max(3, (process.stderr.rows || 24) - 6);
50
+ const start = Math.max(0, Math.min(cursor - Math.floor(height / 2), items.length - height));
51
+ items.slice(start, start + height).forEach((item, i) => process.stderr.write(`${cursor === start + i ? '>' : ' '} [${selected.has(item.id) ? 'x' : ' '}] ${label(item)}\n`));
52
+ process.stderr.write(`${selected.size} selected; ${items.length} discovered\n`);
53
+ process.stderr.write('Space: toggle | Up/Down: move | Enter: review selected | Esc/Ctrl-C: cancel\n');
54
+ };
55
+ return terminal(render, (key) => {
56
+ if (isCancel(key))
57
+ return { value: null };
58
+ if (key.name === 'return' || key.name === 'enter')
59
+ return { value: [...selected] };
60
+ if (key.name === 'up')
61
+ cursor = (cursor + items.length - 1) % items.length;
62
+ if (key.name === 'down')
63
+ cursor = (cursor + 1) % items.length;
64
+ if (key.name === 'space' && items[cursor]) {
65
+ const id = items[cursor].id;
66
+ if (selected.has(id))
67
+ selected.delete(id);
68
+ else
69
+ selected.add(id);
70
+ }
71
+ render();
72
+ });
73
+ }
74
+ export function confirm(message) {
75
+ return terminal(() => process.stderr.write(`${message} [y/N] (Esc/Ctrl-C cancels)\n`), (key, text) => {
76
+ if (isCancel(key) || ['n', 'N'].includes(text) || key.name === 'return' || key.name === 'enter')
77
+ return { value: false };
78
+ if (text === 'y' || text === 'Y')
79
+ return { value: true };
80
+ });
81
+ }
82
+ export function planSsh(items, selected, prefix, revisions) {
83
+ if (!prefix)
84
+ throw new Error('SSH import requires an explicit vault --prefix');
85
+ entryName('ssh/probe', prefix);
86
+ if (new Set(selected).size !== selected.length)
87
+ throw new Error('Duplicate SSH selection');
88
+ const revs = new Map();
89
+ for (const revision of revisions) {
90
+ const [id, value, extra] = revision.split('=');
91
+ if (!id || !value || extra !== undefined || !selected.includes(id) || revs.has(id))
92
+ throw new Error('Invalid SSH revision selection');
93
+ revs.set(id, revisionNumber(value));
94
+ }
95
+ return selected.map(id => {
96
+ const item = items.find(item => item.id === id);
97
+ if (!item)
98
+ throw new Error('Unknown or unsafe SSH selection');
99
+ const suffix = item.kind === 'profile' ? `profiles/${item.alias}` : `keys/${item.alias}-${id.split(':')[2]}`;
100
+ return { item, name: entryName(`ssh/${suffix}`, prefix), revision: revs.get(id), status: 'pending', detail: 'Not attempted' };
101
+ });
102
+ }
103
+ function remoteDestination() {
104
+ const remote = resolveRemote();
105
+ const url = new URL(remote);
106
+ if (url.username || url.password || url.search || url.hash || !['https:', 'http:'].includes(url.protocol) ||
107
+ url.protocol === 'http:' && !['localhost', '127.0.0.1', '[::1]'].includes(url.hostname))
108
+ throw new Error('SSH import requires HTTPS (HTTP allowed only for loopback fixtures)');
109
+ return remote;
110
+ }
111
+ export function configureSshImport(command) {
112
+ const repeat = (value, previous) => [...previous, value];
113
+ return command
114
+ .option('-p, --prefix <prefix>', 'explicit destination prefix', collectPrefix)
115
+ .option('--config <file>', 'SSH config file (no Include expansion)', resolve(homedir(), '.ssh/config'))
116
+ .option('--select <item>', 'explicit profile:alias or key:alias:index (repeatable)', repeat, [])
117
+ .option('--if-match <item=revision>', 'explicit replacement revision for a selected item (repeatable)', repeat, [])
118
+ .option('--dry-run', 'discover/review metadata only; never read private keys or call vault')
119
+ .option('--json', 'noninteractive JSON result; explicit selection required for upload')
120
+ .option('--retry <count>', 'bounded retries of the same selection; unknown writes reconcile only', '0');
121
+ }
122
+ export function registerSshSync(vault) {
123
+ const legacy = vault.command('ssh').description('compatibility commands; prefer vault import --ssh')
124
+ .option('-p, --prefix <prefix>', 'vault destination prefix', collectPrefix)
125
+ .command('sync').description('compatibility alias for vault import --ssh; selected one-way upload');
126
+ configureSshImport(legacy).action(runSshImport);
127
+ }
128
+ export async function runSshImport(options, command) {
129
+ let transfers = [];
130
+ try {
131
+ if (!/^[0-3]$/.test(options.retry))
132
+ throw new Error('SSH retry count must be 0 to 3');
133
+ const interactive = !!process.stdin.isTTY && !!process.stderr.isTTY && !options.json;
134
+ if (!interactive && !options.dryRun && !options.select.length)
135
+ throw new Error('Noninteractive SSH import requires explicit --select items');
136
+ const prefix = invocationPrefix(command);
137
+ planSsh([], [], prefix, []); // validate destination before reading any source
138
+ const configPath = resolve(options.config);
139
+ const config = await readSshFile(configPath);
140
+ const discovery = discoverSsh(config);
141
+ const remote = remoteDestination();
142
+ const token = options.dryRun ? null : resolveToken();
143
+ let selection = options.select;
144
+ if (interactive && !selection.length && !options.dryRun)
145
+ selection = await selectSshItems(discovery.items);
146
+ if (selection === null) {
147
+ process.stdout.write(JSON.stringify({ cancelled: true, entries: [] }) + '\n');
148
+ return;
149
+ }
150
+ transfers = planSsh(discovery.items, selection, prefix, options.ifMatch);
151
+ const review = { remote, prefix, warnings: discovery.warnings, entries: transfers.map(t => ({ id: t.item.id, kind: t.item.kind, name: t.name, ifMatch: t.revision, connection: label(t.item) })) };
152
+ if (options.dryRun) {
153
+ process.stdout.write(JSON.stringify({ dryRun: true, ...review, discovered: discovery.items.map(item => ({ id: item.id, kind: item.kind, connection: label(item) })) }, null, 2) + '\n');
154
+ return;
155
+ }
156
+ process.stderr.write(`SSH destination review (current authenticated account):\n${JSON.stringify(review, null, 2)}\n`);
157
+ if (!transfers.length) {
158
+ process.stdout.write(JSON.stringify({ entries: [], message: 'Empty selection; nothing uploaded' }) + '\n');
159
+ return;
160
+ }
161
+ if (!token)
162
+ throw new Error('Vault authentication required; run dreamlake login');
163
+ if (interactive && !await confirm('Upload these selected items to the reviewed vault destinations?')) {
164
+ process.stdout.write(JSON.stringify({ cancelled: true, entries: transferReport(transfers) }) + '\n');
165
+ return;
166
+ }
167
+ // Pin config bytes, target and token for the whole attempt/retry session.
168
+ if (await readSshFile(configPath) !== config)
169
+ throw new Error('SSH config changed since selection; start a new review');
170
+ const call = boundVault(remote, token);
171
+ let cancelled = false;
172
+ const cancel = () => { cancelled = true; };
173
+ const onKey = (_text, key = {}) => { if (isCancel(key))
174
+ cancel(); };
175
+ const raw = process.stdin.isRaw, paused = process.stdin.readableFlowing !== true;
176
+ process.on('SIGINT', cancel);
177
+ process.on('SIGTERM', cancel);
178
+ if (interactive) {
179
+ emitKeypressEvents(process.stdin);
180
+ process.stdin.setRawMode(true);
181
+ process.stdin.resume();
182
+ process.stdin.on('keypress', onKey);
183
+ }
184
+ try {
185
+ await prepareTransfers(transfers);
186
+ let remaining = Number(options.retry);
187
+ while (!cancelled) {
188
+ await transferSelected(transfers, call, () => cancelled);
189
+ process.stderr.write(JSON.stringify({ entries: transferReport(transfers) }, null, 2) + '\n');
190
+ if (cancelled || transfers.every(t => t.status === 'success'))
191
+ break;
192
+ if (remaining > 0) {
193
+ remaining--;
194
+ continue;
195
+ }
196
+ if (!interactive || !await confirm('Retry this same selection? Successful entries are retained; unknown writes are only reconciled.'))
197
+ break;
198
+ }
199
+ }
200
+ finally {
201
+ process.off('SIGINT', cancel);
202
+ process.off('SIGTERM', cancel);
203
+ if (interactive) {
204
+ process.stdin.off('keypress', onKey);
205
+ process.stdin.setRawMode(raw);
206
+ if (paused)
207
+ process.stdin.pause();
208
+ }
209
+ for (const transfer of transfers)
210
+ delete transfer.value;
211
+ }
212
+ process.stdout.write(JSON.stringify({ cancelled, entries: transferReport(transfers), message: 'Completed writes are retained. No rollback performed.' }, null, 2) + '\n');
213
+ if (cancelled || transfers.some(t => t.status !== 'success'))
214
+ process.exitCode = 1;
215
+ }
216
+ catch (error) {
217
+ for (const transfer of transfers)
218
+ delete transfer.value;
219
+ const message = error instanceof Error && /^(SSH |Noninteractive SSH |Duplicate SSH |Invalid SSH |Unknown or unsafe SSH |Vault authentication|Selected private-key)/.test(error.message) ? error.message : 'SSH import failed; source and response details redacted';
220
+ process.stderr.write(message + '\n');
221
+ process.stdout.write(JSON.stringify({ error: message, entries: transferReport(transfers) }) + '\n');
222
+ process.exitCode = 1;
223
+ }
224
+ }