@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,17 @@
1
+ import type { Command } from "commander";
2
+ export type MachineAction = "status" | "start" | "stop" | "terminal";
3
+ export interface MachineOptions {
4
+ name: string;
5
+ account: string;
6
+ dreamDir?: string;
7
+ profile?: string;
8
+ yes?: boolean;
9
+ json?: boolean;
10
+ }
11
+ export interface MachineDeps {
12
+ outputs?: (dir: string) => unknown;
13
+ aws?: (args: string[], interactive: boolean) => unknown;
14
+ }
15
+ /** Terraform state supplies identity, never executable shell text. Every operation rechecks account and ownership. */
16
+ export declare function machineOperation(action: MachineAction, opts: MachineOptions, deps?: MachineDeps): unknown;
17
+ export declare function registerMachineCommands(provider: Command): void;
@@ -0,0 +1,116 @@
1
+ import { spawnSync } from "node:child_process";
2
+ import path from "node:path";
3
+ import { invalidNameMessage, providerDir, readProviderRecord, resolveDreamRoot } from "./dreamdir.js";
4
+ import { resolveTerraform, runTerraform } from "./terraform.js";
5
+ function object(value) {
6
+ if (!value || typeof value !== "object" || Array.isArray(value))
7
+ throw new Error("Expected an AWS/Terraform JSON object");
8
+ return value;
9
+ }
10
+ function output(outputs, name, pattern) {
11
+ const value = object(outputs[name]).value;
12
+ if (typeof value !== "string" || !pattern.test(value))
13
+ throw new Error(`Missing or invalid Terraform output ${name}; update the EC2 scaffold outputs and refresh Terraform state`);
14
+ return value;
15
+ }
16
+ function terraformOutputs(dir) {
17
+ const resolved = resolveTerraform();
18
+ if (!resolved.ok)
19
+ throw new Error(resolved.message);
20
+ const result = runTerraform(resolved.bin, path.join(dir, "terraform"), ["output", "-json"], 30000, { quiet: true });
21
+ if (result.spawnError || result.status !== 0)
22
+ throw new Error(result.spawnError || "Cannot read Terraform outputs; apply the provider first");
23
+ return JSON.parse(result.stdout);
24
+ }
25
+ function awsCommand(args, interactive) {
26
+ const result = spawnSync("aws", args, {
27
+ shell: false, encoding: "utf8", stdio: interactive ? "inherit" : "pipe",
28
+ timeout: interactive ? undefined : 30000, maxBuffer: 4 * 1024 * 1024,
29
+ env: { ...process.env, AWS_PAGER: "", AWS_CLI_AUTO_PROMPT: "off" },
30
+ });
31
+ if (result.error || result.status !== 0)
32
+ throw new Error(result.error?.message || `AWS command failed (exit ${result.status}); check AWS permissions and session-manager-plugin`);
33
+ return interactive ? { sessionClosed: true } : JSON.parse(result.stdout);
34
+ }
35
+ /** Terraform state supplies identity, never executable shell text. Every operation rechecks account and ownership. */
36
+ export function machineOperation(action, opts, deps = {}) {
37
+ const invalid = invalidNameMessage(opts.name);
38
+ if (invalid)
39
+ throw new Error(invalid);
40
+ if (!/^\d{12}$/.test(opts.account))
41
+ throw new Error("--account must be the expected 12-digit AWS account ID");
42
+ if ((action === "start" || action === "stop") && !opts.yes)
43
+ throw new Error(`${action} requires --yes (start incurs charges; stop interrupts active work)`);
44
+ if (action === "terminal" && opts.json)
45
+ throw new Error("terminal is interactive and does not support --json");
46
+ const dir = providerDir(resolveDreamRoot(opts.dreamDir), opts.name);
47
+ const record = readProviderRecord(dir);
48
+ if (record?.name !== opts.name || record.vendor !== "ec2" || record.kind !== "aws-ec2")
49
+ throw new Error("Machine access requires the named local EC2 provider scaffold");
50
+ const outputs = object((deps.outputs ?? terraformOutputs)(dir));
51
+ const instanceId = output(outputs, "head_instance_id", /^i-(?:[0-9a-f]{8}|[0-9a-f]{17})$/);
52
+ const region = output(outputs, "region", /^[a-z]{2}(?:-[a-z]+)+-\d+$/);
53
+ const account = output(outputs, "account_id", /^\d{12}$/);
54
+ const project = output(outputs, "project", /^[A-Za-z0-9][A-Za-z0-9._-]{0,127}$/);
55
+ if (account !== opts.account)
56
+ throw new Error("Terraform account does not match --account; refusing access");
57
+ const global = ["--region", region, "--output", "json", "--no-cli-pager", ...(opts.profile ? ["--profile", opts.profile] : [])];
58
+ const aws = (args, interactive = false) => (deps.aws ?? awsCommand)([...global, ...args], interactive);
59
+ if (object(aws(["sts", "get-caller-identity"])).Account !== account)
60
+ throw new Error("Active AWS credentials belong to a different account");
61
+ const reservations = object(aws(["ec2", "describe-instances", "--instance-ids", instanceId])).Reservations;
62
+ if (!Array.isArray(reservations) || reservations.length !== 1 || reservations[0]?.OwnerId !== account || !Array.isArray(reservations[0]?.Instances) || reservations[0].Instances.length !== 1)
63
+ throw new Error("Ambiguous or unowned EC2 instance response");
64
+ const instance = object(reservations[0].Instances[0]);
65
+ if (instance.InstanceId !== instanceId || !Array.isArray(instance.Tags))
66
+ throw new Error("EC2 instance identity mismatch");
67
+ for (const [key, value] of Object.entries({ Project: project, Name: `${project}-head`, ManagedBy: "terraform" })) {
68
+ const matches = instance.Tags.filter((tag) => tag?.Key === key);
69
+ if (matches.length !== 1 || matches[0].Value !== value)
70
+ throw new Error(`EC2 ownership tag ${key} does not match Terraform identity`);
71
+ }
72
+ const state = object(instance.State).Name;
73
+ if (!["pending", "running", "stopping", "stopped", "shutting-down", "terminated"].includes(state))
74
+ throw new Error("Invalid EC2 state response");
75
+ const receipt = { provider: opts.name, account, region, instanceId, state };
76
+ if (action === "status")
77
+ return receipt;
78
+ if (action === "terminal") {
79
+ if (state !== "running")
80
+ throw new Error(`Machine is ${state}; terminal requires running state`);
81
+ aws(["ssm", "start-session", "--target", instanceId], true);
82
+ return { ...receipt, sessionClosed: true };
83
+ }
84
+ const desired = action === "start" ? "running" : "stopped";
85
+ if (state === desired)
86
+ return { ...receipt, unchanged: true };
87
+ if (state !== (action === "start" ? "stopped" : "running"))
88
+ throw new Error(`Cannot ${action} a machine in ${state} state; check status after its transition`);
89
+ const result = object(aws(["ec2", `${action}-instances`, "--instance-ids", instanceId]));
90
+ const changes = result[action === "start" ? "StartingInstances" : "StoppingInstances"];
91
+ if (!Array.isArray(changes) || changes.length !== 1 || changes[0]?.InstanceId !== instanceId || changes[0]?.PreviousState?.Name !== state || ![desired, action === "start" ? "pending" : "stopping"].includes(changes[0]?.CurrentState?.Name))
92
+ throw new Error("AWS may have accepted the request but returned an invalid receipt; check machine status before retrying");
93
+ return { ...receipt, state: changes[0].CurrentState.Name, requested: action };
94
+ }
95
+ export function registerMachineCommands(provider) {
96
+ const group = provider.command("machine").description("verified EC2 head-node lifecycle and SSM terminal access");
97
+ for (const action of ["status", "start", "stop", "terminal"]) {
98
+ const command = group.command(action).requiredOption("-n, --name <name>", "local EC2 provider name")
99
+ .requiredOption("--account <id>", "expected AWS account ID")
100
+ .option("--dream-dir <path>", "provider scaffold root")
101
+ .option("--profile <profile>", "AWS CLI credential profile");
102
+ if (action !== "terminal")
103
+ command.option("--json", "emit JSON receipt");
104
+ if (action === "start" || action === "stop")
105
+ command.option("--yes", "authorize the lifecycle change");
106
+ command.action((opts) => {
107
+ try {
108
+ console.log(JSON.stringify(machineOperation(action, opts), null, opts.json ? 0 : 2));
109
+ }
110
+ catch (error) {
111
+ console.error(JSON.stringify({ error: error.message }));
112
+ process.exitCode = 1;
113
+ }
114
+ });
115
+ }
116
+ }
@@ -0,0 +1,105 @@
1
+ import { type Spawn } from "../spawn.js";
2
+ export interface SshDeps {
3
+ spawn?: Spawn;
4
+ quiet?: boolean;
5
+ }
6
+ /** 30 s. An ssh that has not connected in 30 s is not going to. */
7
+ export declare const SSH_TIMEOUT_MS = 30000;
8
+ export declare const SSH_BASE_ARGS: string[];
9
+ export declare function sshBinary(): string;
10
+ export interface SshOutcome {
11
+ status: number | null;
12
+ stdout: string;
13
+ stderr: string;
14
+ spawnError?: string;
15
+ }
16
+ /** One remote command. No pty, no prompt, no shell on this side. */
17
+ export declare function ssh(host: string, remoteCommand: string, deps?: SshDeps): SshOutcome;
18
+ /**
19
+ * Reachability, and nothing else. `true` is the cheapest remote command there
20
+ * is, so a failure here is the connection and never the payload.
21
+ */
22
+ export declare function probeHost(host: string, deps?: SshDeps): SshOutcome;
23
+ /** The sentence a refused connection turns into, plus the command that fixes it. */
24
+ export declare function unreachableMessage(host: string, outcome: SshOutcome): string;
25
+ export type Supervisor = "systemd-user" | "systemd-system" | "tmux" | "none";
26
+ /**
27
+ * Best first, checked on the HOST rather than assumed:
28
+ *
29
+ * systemctl --user + loginctl enable-linger → a user unit, Restart=always
30
+ * systemd + passwordless sudo → a system unit, Restart=always
31
+ * tmux → reattachable, NOT supervised
32
+ *
33
+ * One round trip, not three: the probe is a single shell expression that prints
34
+ * the best rung it finds. Three sequential ssh connections to answer one
35
+ * question would triple the latency of the slowest thing `connect` does.
36
+ */
37
+ export declare const SUPERVISOR_PROBE: string;
38
+ export declare function detectSupervisor(host: string, deps?: SshDeps): {
39
+ supervisor: Supervisor;
40
+ outcome: SshOutcome;
41
+ };
42
+ /** `nymph-<provider>` — the unit name and the tmux session name, one string. */
43
+ export declare function sessionName(provider: string): string;
44
+ /**
45
+ * The command that actually runs on the host.
46
+ *
47
+ * DELIBERATELY OVERRIDABLE, and honestly so: whether a published nymph tarball
48
+ * is reachable over ssh is UNVERIFIED, and inventing an installer that has
49
+ * never been run would be worse than saying which command we are about to
50
+ * issue. `--nymph-command` (or DREAMLAKE_NYMPH) replaces it wholesale; the
51
+ * default assumes `nymph` is already on the host's PATH, which is true of the
52
+ * local-dist install path.
53
+ */
54
+ export declare function nymphCommand(opts: {
55
+ command?: string;
56
+ server?: string;
57
+ queue?: string;
58
+ }): string;
59
+ /** Single-quote for a POSIX shell. The provider name is user-supplied. */
60
+ export declare function shellQuote(value: string): string;
61
+ /**
62
+ * Start the nymph under `supervisor`, and return as soon as the start command
63
+ * does. Nothing here waits for a claim — that is `status`'s job, and holding
64
+ * the ssh connection open to watch would make the CLI the supervisor.
65
+ */
66
+ export declare function startNymph(host: string, provider: string, supervisor: Supervisor, command: string, deps?: SshDeps): SshOutcome;
67
+ /**
68
+ * What `stopNymph` found before it acted. THE THREE ANSWERS ARE DELIBERATELY
69
+ * DISTINCT, because "I stopped it" and "there was nothing to stop" are both
70
+ * successes and a person is owed the difference:
71
+ *
72
+ * stopped — it was running, and it is not now.
73
+ * inactive — the unit exists but was already stopped. A no-op.
74
+ * absent — there is no such unit or session on this host at all.
75
+ *
76
+ * `absent` and `inactive` are NOT failures. Stopping something twice has to be
77
+ * as safe as stopping it once, or no script can ever call this.
78
+ */
79
+ export type StopResult = "stopped" | "inactive" | "absent";
80
+ /**
81
+ * Stop the nymph under `supervisor` — the exact counterpart of `startNymph`,
82
+ * and it MUST be handed the supervisor the ladder actually reported rather than
83
+ * a guess: a nymph started under tmux is not stopped by systemctl, and a
84
+ * systemctl that answers "Unit not loaded" would otherwise read as a failure.
85
+ *
86
+ * ONE ROUND TRIP, same as the probe. The check-then-act is a single remote
87
+ * shell expression that prints which of the three answers it found, so
88
+ * idempotence is decided on the HOST where the truth is, not inferred here from
89
+ * an exit code that means different things on different systemd versions.
90
+ */
91
+ export declare function stopNymph(host: string, provider: string, supervisor: Supervisor, deps?: SshDeps): {
92
+ outcome: SshOutcome;
93
+ result: StopResult | null;
94
+ };
95
+ /**
96
+ * The single command that stops this nymph, spelled out. Printed in prose and
97
+ * handed back as the manual fallback when the remote stop fails — the same
98
+ * `ssh <host> …` the docs page currently lists as the workaround, except now
99
+ * the CLI names it for you instead of the other way round.
100
+ */
101
+ export declare function stopCommand(supervisor: Supervisor, provider: string): string;
102
+ /** How the stop is described in prose, one line — the command, plus the disable. */
103
+ export declare function stopLabel(supervisor: Supervisor, provider: string): string;
104
+ /** How the chosen supervisor is described in prose, one line. */
105
+ export declare function supervisorLabel(supervisor: Supervisor, provider: string): string;
@@ -0,0 +1,305 @@
1
+ // The ssh runner — `dreamlake provider connect`'s half of the adopt path, and
2
+ // `disconnect`'s. THE LADDER IS CLIMBED ONCE AND USED BY BOTH: whatever
3
+ // `detectSupervisor` reports is what `startNymph` starts under and what
4
+ // `stopNymph` stops, so a nymph can never be started by systemd and looked for
5
+ // in tmux.
6
+ //
7
+ // `-o BatchMode=yes` IS THE NEVER-BLOCK-ON-A-TTY RULE, APPLIED TO SSH. Without
8
+ // it, ssh will sit at a password prompt forever against an agent that has no
9
+ // terminal to type into. With it, a key that is not accepted is an immediate
10
+ // non-zero exit and a sentence: `nextAction: {kind:"shell", command:"ssh-copy-id …"}`.
11
+ //
12
+ // `-o StrictHostKeyChecking=accept-new` is the other half. The default,
13
+ // `ask`, is also a prompt; `no` would accept a CHANGED key, which is the one
14
+ // case worth refusing. `accept-new` trusts a host it has never seen and still
15
+ // refuses one whose key changed underneath it.
16
+ //
17
+ // TMUX IS FOR ATTACHING, NOT FOR SUPERVISING. The ladder below prefers systemd
18
+ // precisely because tmux does not restart anything. tmux beats `nohup` and
19
+ // `screen` for one reason — the session is reattachable, which is how you debug
20
+ // a bridge that is misbehaving — but reattachable is not supervised, and the
21
+ // prose in lifecycle.ts says so plainly rather than implying otherwise.
22
+ //
23
+ // THE SSH CONNECTION IS NEVER THE SUPERVISOR. Every command here returns as
24
+ // soon as the remote command does; nothing holds a socket open. Killing the CLI
25
+ // does not touch the nymph.
26
+ import { boundedSpawn, lastNonEmptyLine, truncate, } from "../spawn.js";
27
+ /** 30 s. An ssh that has not connected in 30 s is not going to. */
28
+ export const SSH_TIMEOUT_MS = 30_000;
29
+ export const SSH_BASE_ARGS = [
30
+ "-o",
31
+ "BatchMode=yes",
32
+ "-o",
33
+ "StrictHostKeyChecking=accept-new",
34
+ "-o",
35
+ "ConnectTimeout=15",
36
+ ];
37
+ export function sshBinary() {
38
+ return process.env.DREAMLAKE_SSH || "ssh";
39
+ }
40
+ /** One remote command. No pty, no prompt, no shell on this side. */
41
+ export function ssh(host, remoteCommand, deps = {}) {
42
+ const sp = deps.spawn ?? boundedSpawn(SSH_TIMEOUT_MS);
43
+ const r = sp(sshBinary(), [...SSH_BASE_ARGS, host, remoteCommand]);
44
+ if (r.error?.code === "ENOENT") {
45
+ return {
46
+ status: null,
47
+ stdout: "",
48
+ stderr: "",
49
+ spawnError: "no ssh binary found — install openssh, or set DREAMLAKE_SSH=/path/to/ssh",
50
+ };
51
+ }
52
+ if (r.error) {
53
+ return {
54
+ status: null,
55
+ stdout: r.stdout,
56
+ stderr: r.stderr,
57
+ spawnError: `ssh ${host} failed to run: ${r.error.message}`,
58
+ };
59
+ }
60
+ if (!deps.quiet && r.stderr)
61
+ process.stderr.write(r.stderr);
62
+ return { status: r.status, stdout: r.stdout, stderr: r.stderr };
63
+ }
64
+ /**
65
+ * Reachability, and nothing else. `true` is the cheapest remote command there
66
+ * is, so a failure here is the connection and never the payload.
67
+ */
68
+ export function probeHost(host, deps = {}) {
69
+ return ssh(host, "true", deps);
70
+ }
71
+ /** The sentence a refused connection turns into, plus the command that fixes it. */
72
+ export function unreachableMessage(host, outcome) {
73
+ if (outcome.spawnError)
74
+ return outcome.spawnError;
75
+ const detail = lastNonEmptyLine(truncate(outcome.stderr, 400));
76
+ return (`ssh could not reach ${host}` +
77
+ (detail ? ` — ${detail}` : "") +
78
+ `\n BatchMode is on, so ssh never prompts: an unaccepted key fails here rather than hanging.`);
79
+ }
80
+ /**
81
+ * Best first, checked on the HOST rather than assumed:
82
+ *
83
+ * systemctl --user + loginctl enable-linger → a user unit, Restart=always
84
+ * systemd + passwordless sudo → a system unit, Restart=always
85
+ * tmux → reattachable, NOT supervised
86
+ *
87
+ * One round trip, not three: the probe is a single shell expression that prints
88
+ * the best rung it finds. Three sequential ssh connections to answer one
89
+ * question would triple the latency of the slowest thing `connect` does.
90
+ */
91
+ export const SUPERVISOR_PROBE = [
92
+ "if command -v systemctl >/dev/null 2>&1 && systemctl --user show-environment >/dev/null 2>&1; then echo systemd-user;",
93
+ "elif command -v systemctl >/dev/null 2>&1 && sudo -n true >/dev/null 2>&1; then echo systemd-system;",
94
+ "elif command -v tmux >/dev/null 2>&1; then echo tmux;",
95
+ "else echo none; fi",
96
+ ].join(" ");
97
+ export function detectSupervisor(host, deps = {}) {
98
+ const outcome = ssh(host, SUPERVISOR_PROBE, deps);
99
+ const answer = lastNonEmptyLine(outcome.stdout);
100
+ const supervisor = answer === "systemd-user" || answer === "systemd-system" || answer === "tmux"
101
+ ? answer
102
+ : "none";
103
+ return { supervisor, outcome };
104
+ }
105
+ /** `nymph-<provider>` — the unit name and the tmux session name, one string. */
106
+ export function sessionName(provider) {
107
+ return `nymph-${provider}`;
108
+ }
109
+ /**
110
+ * The command that actually runs on the host.
111
+ *
112
+ * DELIBERATELY OVERRIDABLE, and honestly so: whether a published nymph tarball
113
+ * is reachable over ssh is UNVERIFIED, and inventing an installer that has
114
+ * never been run would be worse than saying which command we are about to
115
+ * issue. `--nymph-command` (or DREAMLAKE_NYMPH) replaces it wholesale; the
116
+ * default assumes `nymph` is already on the host's PATH, which is true of the
117
+ * local-dist install path.
118
+ */
119
+ export function nymphCommand(opts) {
120
+ if (opts.command && opts.command.trim())
121
+ return opts.command.trim();
122
+ const fromEnv = process.env.DREAMLAKE_NYMPH;
123
+ if (fromEnv && fromEnv.trim())
124
+ return fromEnv.trim();
125
+ if (!opts.server?.trim()) {
126
+ throw new Error("no control plane — pass --server or set LAKESHORE_URL");
127
+ }
128
+ // Match nymph's DREAMLAKE_QUEUE/default precedence; a provider name is not
129
+ // a queue name. Namespace belongs in the remote config.
130
+ const queue = opts.queue?.trim() || process.env.DREAMLAKE_QUEUE?.trim() || "default";
131
+ const parts = ["nymph", "--server", shellQuote(opts.server), "--queue", shellQuote(queue)];
132
+ return parts.join(" ");
133
+ }
134
+ /** Single-quote for a POSIX shell. The provider name is user-supplied. */
135
+ export function shellQuote(value) {
136
+ return `'${value.replace(/'/g, "'\\''")}'`;
137
+ }
138
+ /**
139
+ * Start the nymph under `supervisor`, and return as soon as the start command
140
+ * does. Nothing here waits for a claim — that is `status`'s job, and holding
141
+ * the ssh connection open to watch would make the CLI the supervisor.
142
+ */
143
+ export function startNymph(host, provider, supervisor, command, deps = {}) {
144
+ const name = sessionName(provider);
145
+ switch (supervisor) {
146
+ case "systemd-user":
147
+ return ssh(host, systemdUserScript(name, command), deps);
148
+ case "systemd-system":
149
+ return ssh(host, systemdSystemScript(name, command), deps);
150
+ case "tmux":
151
+ // `has-session` first: a second `new-session -d` with the same name is an
152
+ // error, and re-running `connect` must be a no-op rather than a failure.
153
+ return ssh(host, `tmux has-session -t ${shellQuote(name)} 2>/dev/null || ` +
154
+ `tmux new-session -d -s ${shellQuote(name)} ${shellQuote(command)}`, deps);
155
+ default:
156
+ return { status: 1, stdout: "", stderr: "", spawnError: "no supervisor on this host" };
157
+ }
158
+ }
159
+ /**
160
+ * Stop the nymph under `supervisor` — the exact counterpart of `startNymph`,
161
+ * and it MUST be handed the supervisor the ladder actually reported rather than
162
+ * a guess: a nymph started under tmux is not stopped by systemctl, and a
163
+ * systemctl that answers "Unit not loaded" would otherwise read as a failure.
164
+ *
165
+ * ONE ROUND TRIP, same as the probe. The check-then-act is a single remote
166
+ * shell expression that prints which of the three answers it found, so
167
+ * idempotence is decided on the HOST where the truth is, not inferred here from
168
+ * an exit code that means different things on different systemd versions.
169
+ */
170
+ export function stopNymph(host, provider, supervisor, deps = {}) {
171
+ const name = sessionName(provider);
172
+ let script;
173
+ switch (supervisor) {
174
+ case "systemd-user":
175
+ // Reads need no privilege; only the mutations go through `--user`'s own
176
+ // manager, which is the one that owns the unit `connect` wrote.
177
+ script = systemdStopScript(name, "systemctl --user", "systemctl --user");
178
+ break;
179
+ case "systemd-system":
180
+ // `sudo -n` for the mutations only — `-n` because BatchMode's rule holds
181
+ // here too: never sit at a prompt. detectSupervisor already proved
182
+ // passwordless sudo works before this rung was chosen.
183
+ script = systemdStopScript(name, "systemctl", "sudo -n systemctl");
184
+ break;
185
+ case "tmux":
186
+ script = tmuxStopScript(name);
187
+ break;
188
+ default:
189
+ return {
190
+ outcome: { status: 1, stdout: "", stderr: "", spawnError: "no supervisor on this host" },
191
+ result: null,
192
+ };
193
+ }
194
+ const outcome = ssh(host, script, deps);
195
+ const answer = lastNonEmptyLine(outcome.stdout);
196
+ const result = answer === "stopped" || answer === "inactive" || answer === "absent" ? answer : null;
197
+ return { outcome, result };
198
+ }
199
+ function systemdStopScript(name, read, write) {
200
+ const unit = shellQuote(`${name}.service`);
201
+ return [
202
+ // No unit at all is `absent` and a SUCCESS. `systemctl stop` on a unit that
203
+ // was never installed exits 5 on most versions, which is indistinguishable
204
+ // from a real failure — so the existence question is asked first, plainly.
205
+ `if ! ${read} cat ${unit} >/dev/null 2>&1; then echo absent; exit 0; fi`,
206
+ `if ${read} is-active --quiet ${unit}; then was=stopped; else was=inactive; fi`,
207
+ `${write} stop ${unit} || exit 1`,
208
+ // `disable` is BEST EFFORT and deliberately cannot fail the command: a unit
209
+ // that was never enabled exits non-zero here, and "it was not set to start
210
+ // at boot" is not a failure to stop it. Without the disable, a reboot would
211
+ // bring back the nymph you just disconnected.
212
+ `${write} disable ${unit} >/dev/null 2>&1 || true`,
213
+ 'echo "$was"',
214
+ ].join("\n");
215
+ }
216
+ function tmuxStopScript(name) {
217
+ const session = shellQuote(name);
218
+ return [
219
+ // `has-session` also covers "no tmux server is running at all", which exits
220
+ // 1 and prints to stderr — swallowed, because it means `absent`.
221
+ `if ! tmux has-session -t ${session} 2>/dev/null; then echo absent; exit 0; fi`,
222
+ `tmux kill-session -t ${session} || exit 1`,
223
+ "echo stopped",
224
+ ].join("\n");
225
+ }
226
+ /**
227
+ * The single command that stops this nymph, spelled out. Printed in prose and
228
+ * handed back as the manual fallback when the remote stop fails — the same
229
+ * `ssh <host> …` the docs page currently lists as the workaround, except now
230
+ * the CLI names it for you instead of the other way round.
231
+ */
232
+ export function stopCommand(supervisor, provider) {
233
+ const name = sessionName(provider);
234
+ switch (supervisor) {
235
+ case "systemd-user":
236
+ return `systemctl --user stop ${name}`;
237
+ case "systemd-system":
238
+ return `sudo -n systemctl stop ${name}`;
239
+ case "tmux":
240
+ return `tmux kill-session -t ${name}`;
241
+ default:
242
+ return "";
243
+ }
244
+ }
245
+ /** How the stop is described in prose, one line — the command, plus the disable. */
246
+ export function stopLabel(supervisor, provider) {
247
+ const command = stopCommand(supervisor, provider);
248
+ if (!command)
249
+ return "nothing";
250
+ return supervisor === "tmux" ? command : `${command} (and disable)`;
251
+ }
252
+ function unitFile(command) {
253
+ return [
254
+ "[Unit]",
255
+ "Description=dreamlake nymph",
256
+ "After=network-online.target",
257
+ "",
258
+ "[Service]",
259
+ `ExecStart=${command}`,
260
+ // The whole reason systemd outranks tmux on this ladder.
261
+ "Restart=always",
262
+ "RestartSec=5",
263
+ "",
264
+ "[Install]",
265
+ "WantedBy=default.target",
266
+ ].join("\n");
267
+ }
268
+ function systemdUserScript(name, command) {
269
+ const unit = unitFile(command);
270
+ return [
271
+ // enable-linger is what keeps a user unit running after the ssh session
272
+ // ends. Without it systemd stops the whole user slice on logout and the
273
+ // nymph dies the moment `connect` returns.
274
+ "loginctl enable-linger \"$USER\" >/dev/null 2>&1 || true",
275
+ "mkdir -p ~/.config/systemd/user",
276
+ `cat > ~/.config/systemd/user/${name}.service <<'DREAMLAKE_UNIT'`,
277
+ unit,
278
+ "DREAMLAKE_UNIT",
279
+ "systemctl --user daemon-reload",
280
+ `systemctl --user enable --now ${name}.service`,
281
+ ].join("\n");
282
+ }
283
+ function systemdSystemScript(name, command) {
284
+ const unit = unitFile(command);
285
+ return [
286
+ `sudo -n tee /etc/systemd/system/${name}.service >/dev/null <<'DREAMLAKE_UNIT'`,
287
+ unit,
288
+ "DREAMLAKE_UNIT",
289
+ "sudo -n systemctl daemon-reload",
290
+ `sudo -n systemctl enable --now ${name}.service`,
291
+ ].join("\n");
292
+ }
293
+ /** How the chosen supervisor is described in prose, one line. */
294
+ export function supervisorLabel(supervisor, provider) {
295
+ switch (supervisor) {
296
+ case "systemd-user":
297
+ return "systemd --user (restart=always)";
298
+ case "systemd-system":
299
+ return "systemd (restart=always)";
300
+ case "tmux":
301
+ return `tmux (session ${sessionName(provider)})`;
302
+ default:
303
+ return "nothing";
304
+ }
305
+ }