@dreamlake/dreamlake-cli 0.88.1 → 0.90.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (541) hide show
  1. package/dist/api/access.d.ts +83 -0
  2. package/dist/api/access.js +77 -0
  3. package/dist/api/agent.d.ts +156 -0
  4. package/dist/api/agent.js +111 -0
  5. package/dist/api/browser.d.ts +90 -0
  6. package/dist/api/browser.js +102 -0
  7. package/dist/api/client.d.ts +54 -0
  8. package/dist/api/client.js +102 -0
  9. package/dist/api/common.d.ts +28 -0
  10. package/dist/api/common.js +16 -0
  11. package/dist/api/content.d.ts +195 -0
  12. package/dist/api/content.js +147 -0
  13. package/dist/api/execution.d.ts +84 -0
  14. package/dist/api/execution.js +73 -0
  15. package/dist/api/http.d.ts +19 -0
  16. package/dist/api/http.js +66 -0
  17. package/dist/api/index.d.ts +2362 -0
  18. package/dist/api/index.js +116 -0
  19. package/dist/api/infra.d.ts +2 -0
  20. package/dist/api/infra.js +2 -0
  21. package/dist/api/jobs.d.ts +2 -0
  22. package/dist/api/jobs.js +2 -0
  23. package/dist/api/layout.d.ts +2 -0
  24. package/dist/api/layout.js +2 -0
  25. package/dist/api/library-edit.d.ts +3 -0
  26. package/dist/api/library-edit.js +3 -0
  27. package/dist/api/library-manifest.d.ts +2 -0
  28. package/dist/api/library-manifest.js +2 -0
  29. package/dist/api/note-character-plan.d.ts +2 -0
  30. package/dist/api/note-character-plan.js +2 -0
  31. package/dist/api/note-editing.d.ts +2 -0
  32. package/dist/api/note-editing.js +2 -0
  33. package/dist/api/note-edits.d.ts +21 -0
  34. package/dist/api/note-edits.js +10 -0
  35. package/dist/api/note-events.d.ts +5 -0
  36. package/dist/api/note-events.js +11 -0
  37. package/dist/api/note-files.d.ts +102 -0
  38. package/dist/api/note-files.js +107 -0
  39. package/dist/api/note-html-read.d.ts +2 -0
  40. package/dist/api/note-html-read.js +2 -0
  41. package/dist/api/note-html.d.ts +2 -0
  42. package/dist/api/note-html.js +2 -0
  43. package/dist/api/note-linger.d.ts +83 -0
  44. package/dist/api/note-linger.js +270 -0
  45. package/dist/api/note-presence.d.ts +82 -0
  46. package/dist/api/note-presence.js +72 -0
  47. package/dist/api/note-toc.d.ts +2 -0
  48. package/dist/api/note-toc.js +2 -0
  49. package/dist/api/notes.d.ts +329 -0
  50. package/dist/api/notes.js +209 -0
  51. package/dist/api/open-resources.d.ts +27 -0
  52. package/dist/api/open-resources.js +102 -0
  53. package/dist/api/ownership.d.ts +12 -0
  54. package/dist/api/ownership.js +24 -0
  55. package/dist/api/platform.d.ts +83 -0
  56. package/dist/api/platform.js +56 -0
  57. package/dist/api/presigned-transfer.d.ts +2 -0
  58. package/dist/api/presigned-transfer.js +2 -0
  59. package/dist/api/registered-runs.d.ts +48 -0
  60. package/dist/api/registered-runs.js +33 -0
  61. package/dist/api/sessions.d.ts +299 -0
  62. package/dist/api/sessions.js +105 -0
  63. package/dist/api/storage.d.ts +46 -0
  64. package/dist/api/storage.js +34 -0
  65. package/dist/api/streams.d.ts +18 -0
  66. package/dist/api/streams.js +70 -0
  67. package/dist/api/vault.d.ts +93 -0
  68. package/dist/api/vault.js +79 -0
  69. package/dist/api/workspace.d.ts +180 -0
  70. package/dist/api/workspace.js +146 -0
  71. package/dist/cli/agent-identity.d.ts +4 -0
  72. package/dist/cli/agent-identity.js +21 -0
  73. package/dist/cli/agents/identity.d.ts +50 -0
  74. package/dist/cli/agents/identity.js +105 -0
  75. package/dist/cli/agents/index.d.ts +31 -0
  76. package/dist/cli/agents/index.js +580 -0
  77. package/dist/cli/agents/manage.d.ts +43 -0
  78. package/dist/cli/agents/manage.js +376 -0
  79. package/dist/cli/agents/spec.d.ts +104 -0
  80. package/dist/cli/agents/spec.js +280 -0
  81. package/dist/cli/agents/web.d.ts +7 -0
  82. package/dist/cli/agents/web.js +109 -0
  83. package/dist/cli/artifact/incremental.d.ts +21 -0
  84. package/dist/cli/artifact/incremental.js +80 -0
  85. package/dist/cli/artifact/index.d.ts +52 -0
  86. package/dist/cli/artifact/index.js +405 -0
  87. package/dist/cli/artifact/meta.d.ts +69 -0
  88. package/dist/cli/artifact/meta.js +189 -0
  89. package/dist/cli/auth/commands.d.ts +29 -0
  90. package/dist/cli/auth/commands.js +327 -0
  91. package/dist/cli/auth/constants.d.ts +13 -0
  92. package/dist/cli/auth/constants.js +18 -0
  93. package/dist/cli/auth/credentials.d.ts +37 -0
  94. package/dist/cli/auth/credentials.js +155 -0
  95. package/dist/cli/auth/device-flow.d.ts +32 -0
  96. package/dist/cli/auth/device-flow.js +154 -0
  97. package/dist/cli/auth/device-secret.d.ts +6 -0
  98. package/dist/cli/auth/device-secret.js +26 -0
  99. package/dist/cli/auth/machine.d.ts +15 -0
  100. package/dist/cli/auth/machine.js +126 -0
  101. package/dist/cli/auth/materialized.d.ts +32 -0
  102. package/dist/cli/auth/materialized.js +102 -0
  103. package/dist/cli/auth/migrate.d.ts +10 -0
  104. package/dist/cli/auth/migrate.js +75 -0
  105. package/dist/cli/client.d.ts +102 -0
  106. package/dist/cli/client.js +206 -0
  107. package/dist/cli/collection-list.d.ts +3 -0
  108. package/dist/cli/collection-list.js +25 -0
  109. package/dist/cli/compat/ctx.d.ts +26 -0
  110. package/dist/cli/compat/ctx.js +76 -0
  111. package/dist/cli/compat/dreamdb-wasm-embedded.d.ts +2 -0
  112. package/dist/cli/compat/dreamdb-wasm-embedded.js +8 -0
  113. package/dist/cli/compat/dreamdb-wasm.d.ts +1 -0
  114. package/dist/cli/compat/dreamdb-wasm.js +26 -0
  115. package/dist/cli/compat/dreamdb.d.ts +112 -0
  116. package/dist/cli/compat/dreamdb.js +219 -0
  117. package/dist/cli/compat/flags.d.ts +2 -0
  118. package/dist/cli/compat/flags.js +13 -0
  119. package/dist/cli/compat/http.d.ts +23 -0
  120. package/dist/cli/compat/http.js +137 -0
  121. package/dist/cli/compat/presignedTransfer.d.ts +139 -0
  122. package/dist/cli/compat/presignedTransfer.js +580 -0
  123. package/dist/cli/compat/s3-backend.d.ts +73 -0
  124. package/dist/cli/compat/s3-backend.js +132 -0
  125. package/dist/cli/config.d.ts +22 -0
  126. package/dist/cli/config.js +96 -0
  127. package/dist/cli/connection/dto.d.ts +159 -0
  128. package/dist/cli/connection/dto.js +497 -0
  129. package/dist/cli/connection/index.d.ts +50 -0
  130. package/dist/cli/connection/index.js +413 -0
  131. package/dist/cli/connection/oauth.d.ts +23 -0
  132. package/dist/cli/connection/oauth.js +290 -0
  133. package/dist/cli/connection/write.d.ts +47 -0
  134. package/dist/cli/connection/write.js +573 -0
  135. package/dist/cli/create/index.d.ts +19 -0
  136. package/dist/cli/create/index.js +209 -0
  137. package/dist/cli/declare/index.d.ts +29 -0
  138. package/dist/cli/declare/index.js +304 -0
  139. package/dist/cli/delete/index.d.ts +18 -0
  140. package/dist/cli/delete/index.js +232 -0
  141. package/dist/cli/download/index.d.ts +9 -0
  142. package/dist/cli/download/index.js +128 -0
  143. package/dist/cli/env/compose.d.ts +88 -0
  144. package/dist/cli/env/compose.js +402 -0
  145. package/dist/cli/env/index.d.ts +176 -0
  146. package/dist/cli/env/index.js +1011 -0
  147. package/dist/cli/experiments/index.d.ts +11 -0
  148. package/dist/cli/experiments/index.js +168 -0
  149. package/dist/cli/glob.d.ts +1 -0
  150. package/dist/cli/glob.js +45 -0
  151. package/dist/cli/graphql-helpers.d.ts +23 -0
  152. package/dist/cli/graphql-helpers.js +42 -0
  153. package/dist/cli/graphql.d.ts +10 -0
  154. package/dist/cli/graphql.js +47 -0
  155. package/dist/cli/help-examples.generated.d.ts +1 -0
  156. package/dist/cli/help-examples.generated.js +192 -0
  157. package/dist/cli/helpers.d.ts +8 -0
  158. package/dist/cli/helpers.js +106 -0
  159. package/dist/cli/hosts/api.d.ts +29 -0
  160. package/dist/cli/hosts/api.js +54 -0
  161. package/dist/cli/hosts/bootstrap-source.d.ts +1 -0
  162. package/dist/cli/hosts/bootstrap-source.js +2 -0
  163. package/dist/cli/hosts/catalog.d.ts +26 -0
  164. package/dist/cli/hosts/catalog.js +55 -0
  165. package/dist/cli/hosts/config.d.ts +45 -0
  166. package/dist/cli/hosts/config.js +179 -0
  167. package/dist/cli/hosts/credentials.d.ts +19 -0
  168. package/dist/cli/hosts/credentials.js +173 -0
  169. package/dist/cli/hosts/enroll.d.ts +17 -0
  170. package/dist/cli/hosts/enroll.js +109 -0
  171. package/dist/cli/hosts/enrollments.d.ts +25 -0
  172. package/dist/cli/hosts/enrollments.js +54 -0
  173. package/dist/cli/hosts/index.d.ts +6 -0
  174. package/dist/cli/hosts/index.js +279 -0
  175. package/dist/cli/hosts/inventory.d.ts +40 -0
  176. package/dist/cli/hosts/inventory.js +91 -0
  177. package/dist/cli/hosts/lifecycle.d.ts +15 -0
  178. package/dist/cli/hosts/lifecycle.js +108 -0
  179. package/dist/cli/hosts/metrics-source.d.ts +12 -0
  180. package/dist/cli/hosts/metrics-source.js +89 -0
  181. package/dist/cli/hosts/observations.d.ts +39 -0
  182. package/dist/cli/hosts/observations.js +102 -0
  183. package/dist/cli/hosts/remote.d.ts +5 -0
  184. package/dist/cli/hosts/remote.js +66 -0
  185. package/dist/cli/hosts/ssh.d.ts +63 -0
  186. package/dist/cli/hosts/ssh.js +276 -0
  187. package/dist/cli/index.d.ts +1 -0
  188. package/dist/cli/index.js +288 -0
  189. package/dist/cli/infra/api.d.ts +95 -0
  190. package/dist/cli/infra/api.js +291 -0
  191. package/dist/cli/infra/index.d.ts +5 -0
  192. package/dist/cli/infra/index.js +102 -0
  193. package/dist/cli/infra/move.d.ts +15 -0
  194. package/dist/cli/infra/move.js +123 -0
  195. package/dist/cli/infra/transfer.d.ts +15 -0
  196. package/dist/cli/infra/transfer.js +280 -0
  197. package/dist/cli/jobs/api.d.ts +69 -0
  198. package/dist/cli/jobs/api.js +121 -0
  199. package/dist/cli/jobs/index.d.ts +5 -0
  200. package/dist/cli/jobs/index.js +140 -0
  201. package/dist/cli/lakeshore/index.d.ts +98 -0
  202. package/dist/cli/lakeshore/index.js +502 -0
  203. package/dist/cli/launch/index.d.ts +43 -0
  204. package/dist/cli/launch/index.js +270 -0
  205. package/dist/cli/layout/index.d.ts +2 -0
  206. package/dist/cli/layout/index.js +44 -0
  207. package/dist/cli/layout/transport.d.ts +12 -0
  208. package/dist/cli/layout/transport.js +70 -0
  209. package/dist/cli/library/add.d.ts +60 -0
  210. package/dist/cli/library/add.js +348 -0
  211. package/dist/cli/library/cache.d.ts +26 -0
  212. package/dist/cli/library/cache.js +88 -0
  213. package/dist/cli/library/config.d.ts +75 -0
  214. package/dist/cli/library/config.js +198 -0
  215. package/dist/cli/library/digest.d.ts +5 -0
  216. package/dist/cli/library/digest.js +19 -0
  217. package/dist/cli/library/discover.d.ts +87 -0
  218. package/dist/cli/library/discover.js +534 -0
  219. package/dist/cli/library/freshness.d.ts +35 -0
  220. package/dist/cli/library/freshness.js +109 -0
  221. package/dist/cli/library/generation.d.ts +35 -0
  222. package/dist/cli/library/generation.js +211 -0
  223. package/dist/cli/library/index.d.ts +2 -0
  224. package/dist/cli/library/index.js +36 -0
  225. package/dist/cli/library/info.d.ts +69 -0
  226. package/dist/cli/library/info.js +311 -0
  227. package/dist/cli/library/list.d.ts +33 -0
  228. package/dist/cli/library/list.js +86 -0
  229. package/dist/cli/library/manifest.d.ts +81 -0
  230. package/dist/cli/library/manifest.js +200 -0
  231. package/dist/cli/library/manifestCache.d.ts +45 -0
  232. package/dist/cli/library/manifestCache.js +169 -0
  233. package/dist/cli/library/pull.d.ts +30 -0
  234. package/dist/cli/library/pull.js +438 -0
  235. package/dist/cli/library/push.d.ts +72 -0
  236. package/dist/cli/library/push.js +642 -0
  237. package/dist/cli/library/rm.d.ts +31 -0
  238. package/dist/cli/library/rm.js +200 -0
  239. package/dist/cli/library/search.d.ts +18 -0
  240. package/dist/cli/library/search.js +181 -0
  241. package/dist/cli/library/stat.d.ts +15 -0
  242. package/dist/cli/library/stat.js +127 -0
  243. package/dist/cli/library/tools.d.ts +104 -0
  244. package/dist/cli/library/tools.js +163 -0
  245. package/dist/cli/library/wire.d.ts +47 -0
  246. package/dist/cli/library/wire.js +120 -0
  247. package/dist/cli/list/index.d.ts +26 -0
  248. package/dist/cli/list/index.js +256 -0
  249. package/dist/cli/notes/api-transport.d.ts +5 -0
  250. package/dist/cli/notes/api-transport.js +20 -0
  251. package/dist/cli/notes/character-plan.d.ts +22 -0
  252. package/dist/cli/notes/character-plan.js +232 -0
  253. package/dist/cli/notes/document.d.ts +73 -0
  254. package/dist/cli/notes/document.js +306 -0
  255. package/dist/cli/notes/edit-commands.d.ts +106 -0
  256. package/dist/cli/notes/edit-commands.js +623 -0
  257. package/dist/cli/notes/editing.d.ts +81 -0
  258. package/dist/cli/notes/editing.js +305 -0
  259. package/dist/cli/notes/events.d.ts +36 -0
  260. package/dist/cli/notes/events.js +54 -0
  261. package/dist/cli/notes/files-commands.d.ts +97 -0
  262. package/dist/cli/notes/files-commands.js +548 -0
  263. package/dist/cli/notes/html-read.d.ts +9 -0
  264. package/dist/cli/notes/html-read.js +90 -0
  265. package/dist/cli/notes/html.d.ts +73 -0
  266. package/dist/cli/notes/html.js +381 -0
  267. package/dist/cli/notes/index.d.ts +123 -0
  268. package/dist/cli/notes/index.js +1300 -0
  269. package/dist/cli/notes/linger.d.ts +4 -0
  270. package/dist/cli/notes/linger.js +96 -0
  271. package/dist/cli/notes/media-commands.d.ts +5 -0
  272. package/dist/cli/notes/media-commands.js +51 -0
  273. package/dist/cli/notes/move-command.d.ts +83 -0
  274. package/dist/cli/notes/move-command.js +259 -0
  275. package/dist/cli/notes/rm-command.d.ts +22 -0
  276. package/dist/cli/notes/rm-command.js +110 -0
  277. package/dist/cli/notes/select-command.d.ts +12 -0
  278. package/dist/cli/notes/select-command.js +63 -0
  279. package/dist/cli/notes/suggest-diff.d.ts +56 -0
  280. package/dist/cli/notes/suggest-diff.js +311 -0
  281. package/dist/cli/notes/toc.d.ts +38 -0
  282. package/dist/cli/notes/toc.js +144 -0
  283. package/dist/cli/notes/transfer-command.d.ts +6 -0
  284. package/dist/cli/notes/transfer-command.js +9 -0
  285. package/dist/cli/notes/version-commands.d.ts +19 -0
  286. package/dist/cli/notes/version-commands.js +178 -0
  287. package/dist/cli/nymph/index.d.ts +74 -0
  288. package/dist/cli/nymph/index.js +349 -0
  289. package/dist/cli/org/index.d.ts +34 -0
  290. package/dist/cli/org/index.js +341 -0
  291. package/dist/cli/ownership/index.d.ts +12 -0
  292. package/dist/cli/ownership/index.js +122 -0
  293. package/dist/cli/ownership/metadata-transfer.d.ts +20 -0
  294. package/dist/cli/ownership/metadata-transfer.js +159 -0
  295. package/dist/cli/page/index.d.ts +58 -0
  296. package/dist/cli/page/index.js +387 -0
  297. package/dist/cli/pipeline/index.d.ts +69 -0
  298. package/dist/cli/pipeline/index.js +604 -0
  299. package/dist/cli/progress.d.ts +60 -0
  300. package/dist/cli/progress.js +276 -0
  301. package/dist/cli/project/attachments.d.ts +10 -0
  302. package/dist/cli/project/attachments.js +39 -0
  303. package/dist/cli/project/grants.d.ts +10 -0
  304. package/dist/cli/project/grants.js +39 -0
  305. package/dist/cli/project/index.d.ts +8 -0
  306. package/dist/cli/project/index.js +92 -0
  307. package/dist/cli/project/move.d.ts +57 -0
  308. package/dist/cli/project/move.js +242 -0
  309. package/dist/cli/project/output.d.ts +2 -0
  310. package/dist/cli/project/output.js +29 -0
  311. package/dist/cli/project/stream.d.ts +55 -0
  312. package/dist/cli/project/stream.js +207 -0
  313. package/dist/cli/project/transfer-preview.d.ts +8 -0
  314. package/dist/cli/project/transfer-preview.js +10 -0
  315. package/dist/cli/prompt.d.ts +1 -0
  316. package/dist/cli/prompt.js +17 -0
  317. package/dist/cli/provider/dreamdir.d.ts +52 -0
  318. package/dist/cli/provider/dreamdir.js +138 -0
  319. package/dist/cli/provider/index.d.ts +4 -0
  320. package/dist/cli/provider/index.js +419 -0
  321. package/dist/cli/provider/jump-worker.d.ts +9 -0
  322. package/dist/cli/provider/jump-worker.js +141 -0
  323. package/dist/cli/provider/lifecycle.d.ts +149 -0
  324. package/dist/cli/provider/lifecycle.js +1390 -0
  325. package/dist/cli/provider/machine.d.ts +17 -0
  326. package/dist/cli/provider/machine.js +116 -0
  327. package/dist/cli/provider/ssh.d.ts +105 -0
  328. package/dist/cli/provider/ssh.js +305 -0
  329. package/dist/cli/provider/terraform.d.ts +140 -0
  330. package/dist/cli/provider/terraform.js +288 -0
  331. package/dist/cli/providers/index.d.ts +18 -0
  332. package/dist/cli/providers/index.js +422 -0
  333. package/dist/cli/python.d.ts +61 -0
  334. package/dist/cli/python.js +255 -0
  335. package/dist/cli/queues/index.d.ts +33 -0
  336. package/dist/cli/queues/index.js +248 -0
  337. package/dist/cli/queues/slurm.d.ts +10 -0
  338. package/dist/cli/queues/slurm.js +134 -0
  339. package/dist/cli/resources.d.ts +72 -0
  340. package/dist/cli/resources.js +137 -0
  341. package/dist/cli/run/index.d.ts +15 -0
  342. package/dist/cli/run/index.js +163 -0
  343. package/dist/cli/run/input.d.ts +34 -0
  344. package/dist/cli/run/input.js +135 -0
  345. package/dist/cli/run/recovery.d.ts +2 -0
  346. package/dist/cli/run/recovery.js +18 -0
  347. package/dist/cli/run/setup.d.ts +3 -0
  348. package/dist/cli/run/setup.js +62 -0
  349. package/dist/cli/runconfig/index.d.ts +12 -0
  350. package/dist/cli/runconfig/index.js +130 -0
  351. package/dist/cli/runnable/index.d.ts +35 -0
  352. package/dist/cli/runnable/index.js +575 -0
  353. package/dist/cli/runnable/path.d.ts +115 -0
  354. package/dist/cli/runnable/path.js +288 -0
  355. package/dist/cli/runnable/run.d.ts +91 -0
  356. package/dist/cli/runnable/run.js +239 -0
  357. package/dist/cli/runnable/upload.d.ts +43 -0
  358. package/dist/cli/runnable/upload.js +342 -0
  359. package/dist/cli/runnable/worker.d.ts +1 -0
  360. package/dist/cli/runnable/worker.js +44 -0
  361. package/dist/cli/schemas/workflow-spec.schema.json +335 -0
  362. package/dist/cli/self-update/index.d.ts +5 -0
  363. package/dist/cli/self-update/index.js +107 -0
  364. package/dist/cli/self-update/install.d.ts +60 -0
  365. package/dist/cli/self-update/install.js +428 -0
  366. package/dist/cli/self-update/paths.d.ts +40 -0
  367. package/dist/cli/self-update/paths.js +87 -0
  368. package/dist/cli/self-update/releases.d.ts +41 -0
  369. package/dist/cli/self-update/releases.js +153 -0
  370. package/dist/cli/self-update/settings.d.ts +16 -0
  371. package/dist/cli/self-update/settings.js +68 -0
  372. package/dist/cli/self-update/update.d.ts +18 -0
  373. package/dist/cli/self-update/update.js +241 -0
  374. package/dist/cli/service-accounts/index.d.ts +3 -0
  375. package/dist/cli/service-accounts/index.js +149 -0
  376. package/dist/cli/session-affiliation.d.ts +26 -0
  377. package/dist/cli/session-affiliation.js +135 -0
  378. package/dist/cli/sessions/affiliation.d.ts +8 -0
  379. package/dist/cli/sessions/affiliation.js +66 -0
  380. package/dist/cli/sessions/api.d.ts +55 -0
  381. package/dist/cli/sessions/api.js +88 -0
  382. package/dist/cli/sessions/control.d.ts +6 -0
  383. package/dist/cli/sessions/control.js +159 -0
  384. package/dist/cli/sessions/conversation.d.ts +15 -0
  385. package/dist/cli/sessions/conversation.js +118 -0
  386. package/dist/cli/sessions/index.d.ts +2 -0
  387. package/dist/cli/sessions/index.js +209 -0
  388. package/dist/cli/sessions/managed.d.ts +39 -0
  389. package/dist/cli/sessions/managed.js +63 -0
  390. package/dist/cli/sessions/redaction.d.ts +2 -0
  391. package/dist/cli/sessions/redaction.js +11 -0
  392. package/dist/cli/sessions/runner/exec.d.ts +108 -0
  393. package/dist/cli/sessions/runner/exec.js +335 -0
  394. package/dist/cli/sessions/runner/journal.d.ts +26 -0
  395. package/dist/cli/sessions/runner/journal.js +49 -0
  396. package/dist/cli/sessions/runner/native.d.ts +48 -0
  397. package/dist/cli/sessions/runner/native.js +170 -0
  398. package/dist/cli/sessions/runner/pod.d.ts +30 -0
  399. package/dist/cli/sessions/runner/pod.js +129 -0
  400. package/dist/cli/sessions/runner/serve.d.ts +85 -0
  401. package/dist/cli/sessions/runner/serve.js +558 -0
  402. package/dist/cli/sessions/sync.d.ts +47 -0
  403. package/dist/cli/sessions/sync.js +80 -0
  404. package/dist/cli/sessions/transport.d.ts +14 -0
  405. package/dist/cli/sessions/transport.js +116 -0
  406. package/dist/cli/share.d.ts +15 -0
  407. package/dist/cli/share.js +139 -0
  408. package/dist/cli/skill/catalog.d.ts +141 -0
  409. package/dist/cli/skill/catalog.js +442 -0
  410. package/dist/cli/skill/files.d.ts +89 -0
  411. package/dist/cli/skill/files.js +264 -0
  412. package/dist/cli/skill/index.d.ts +268 -0
  413. package/dist/cli/skill/index.js +1216 -0
  414. package/dist/cli/skill/manifest.d.ts +30 -0
  415. package/dist/cli/skill/manifest.js +101 -0
  416. package/dist/cli/skill/prefs.d.ts +9 -0
  417. package/dist/cli/skill/prefs.js +32 -0
  418. package/dist/cli/skill/reminders.d.ts +15 -0
  419. package/dist/cli/skill/reminders.js +105 -0
  420. package/dist/cli/skill/tar.d.ts +17 -0
  421. package/dist/cli/skill/tar.js +195 -0
  422. package/dist/cli/snapshot/index.d.ts +24 -0
  423. package/dist/cli/snapshot/index.js +146 -0
  424. package/dist/cli/source/access.d.ts +45 -0
  425. package/dist/cli/source/access.js +563 -0
  426. package/dist/cli/source/control.d.ts +103 -0
  427. package/dist/cli/source/control.js +546 -0
  428. package/dist/cli/source/delete.d.ts +89 -0
  429. package/dist/cli/source/delete.js +463 -0
  430. package/dist/cli/source/index.d.ts +288 -0
  431. package/dist/cli/source/index.js +1348 -0
  432. package/dist/cli/source/share.d.ts +65 -0
  433. package/dist/cli/source/share.js +530 -0
  434. package/dist/cli/source/upload.d.ts +62 -0
  435. package/dist/cli/source/upload.js +258 -0
  436. package/dist/cli/source/write.d.ts +77 -0
  437. package/dist/cli/source/write.js +335 -0
  438. package/dist/cli/spawn.d.ts +28 -0
  439. package/dist/cli/spawn.js +81 -0
  440. package/dist/cli/target.d.ts +22 -0
  441. package/dist/cli/target.js +85 -0
  442. package/dist/cli/tasks/index.d.ts +38 -0
  443. package/dist/cli/tasks/index.js +365 -0
  444. package/dist/cli/team/index.d.ts +37 -0
  445. package/dist/cli/team/index.js +407 -0
  446. package/dist/cli/telemetry.d.ts +23 -0
  447. package/dist/cli/telemetry.js +262 -0
  448. package/dist/cli/telemetryJournal.d.ts +26 -0
  449. package/dist/cli/telemetryJournal.js +104 -0
  450. package/dist/cli/update/index.d.ts +21 -0
  451. package/dist/cli/update/index.js +284 -0
  452. package/dist/cli/upload/index.d.ts +11 -0
  453. package/dist/cli/upload/index.js +261 -0
  454. package/dist/cli/upload/kinds.d.ts +10 -0
  455. package/dist/cli/upload/kinds.js +85 -0
  456. package/dist/cli/upload/multipart.d.ts +21 -0
  457. package/dist/cli/upload/multipart.js +248 -0
  458. package/dist/cli/vault/affected-preview.d.ts +15 -0
  459. package/dist/cli/vault/affected-preview.js +38 -0
  460. package/dist/cli/vault/cloud.d.ts +55 -0
  461. package/dist/cli/vault/cloud.js +287 -0
  462. package/dist/cli/vault/format.d.ts +18 -0
  463. package/dist/cli/vault/format.js +104 -0
  464. package/dist/cli/vault/hostCredentials.d.ts +21 -0
  465. package/dist/cli/vault/hostCredentials.js +71 -0
  466. package/dist/cli/vault/hostSupersessions.d.ts +18 -0
  467. package/dist/cli/vault/hostSupersessions.js +68 -0
  468. package/dist/cli/vault/import.d.ts +3 -0
  469. package/dist/cli/vault/import.js +79 -0
  470. package/dist/cli/vault/index.d.ts +14 -0
  471. package/dist/cli/vault/index.js +225 -0
  472. package/dist/cli/vault/keys.d.ts +5 -0
  473. package/dist/cli/vault/keys.js +165 -0
  474. package/dist/cli/vault/kms.d.ts +6 -0
  475. package/dist/cli/vault/kms.js +169 -0
  476. package/dist/cli/vault/list.d.ts +13 -0
  477. package/dist/cli/vault/list.js +60 -0
  478. package/dist/cli/vault/listView.d.ts +21 -0
  479. package/dist/cli/vault/listView.js +123 -0
  480. package/dist/cli/vault/managementMetadata.d.ts +2 -0
  481. package/dist/cli/vault/managementMetadata.js +23 -0
  482. package/dist/cli/vault/mutations.d.ts +8 -0
  483. package/dist/cli/vault/mutations.js +151 -0
  484. package/dist/cli/vault/otp.d.ts +6 -0
  485. package/dist/cli/vault/otp.js +62 -0
  486. package/dist/cli/vault/otpIntent.d.ts +23 -0
  487. package/dist/cli/vault/otpIntent.js +76 -0
  488. package/dist/cli/vault/passImport.d.ts +25 -0
  489. package/dist/cli/vault/passImport.js +129 -0
  490. package/dist/cli/vault/passOtp.d.ts +51 -0
  491. package/dist/cli/vault/passOtp.js +101 -0
  492. package/dist/cli/vault/passStore.d.ts +26 -0
  493. package/dist/cli/vault/passStore.js +134 -0
  494. package/dist/cli/vault/passwordCommand.d.ts +39 -0
  495. package/dist/cli/vault/passwordCommand.js +101 -0
  496. package/dist/cli/vault/passwordProbe.d.ts +27 -0
  497. package/dist/cli/vault/passwordProbe.js +282 -0
  498. package/dist/cli/vault/passwordRotation.d.ts +9 -0
  499. package/dist/cli/vault/passwordRotation.js +273 -0
  500. package/dist/cli/vault/rotationApi.d.ts +13 -0
  501. package/dist/cli/vault/rotationApi.js +58 -0
  502. package/dist/cli/vault/rotationCommand.d.ts +2 -0
  503. package/dist/cli/vault/rotationCommand.js +75 -0
  504. package/dist/cli/vault/rotationEngine.d.ts +19 -0
  505. package/dist/cli/vault/rotationEngine.js +65 -0
  506. package/dist/cli/vault/rotationHelperSource.d.ts +2 -0
  507. package/dist/cli/vault/rotationHelperSource.js +3 -0
  508. package/dist/cli/vault/rotationInput.d.ts +11 -0
  509. package/dist/cli/vault/rotationInput.js +48 -0
  510. package/dist/cli/vault/rotationJournal.d.ts +16 -0
  511. package/dist/cli/vault/rotationJournal.js +183 -0
  512. package/dist/cli/vault/rotationKeys.d.ts +4 -0
  513. package/dist/cli/vault/rotationKeys.js +48 -0
  514. package/dist/cli/vault/rotationPrepare.d.ts +17 -0
  515. package/dist/cli/vault/rotationPrepare.js +108 -0
  516. package/dist/cli/vault/rotationRemote.d.ts +33 -0
  517. package/dist/cli/vault/rotationRemote.js +156 -0
  518. package/dist/cli/vault/rotationState.d.ts +42 -0
  519. package/dist/cli/vault/rotationState.js +115 -0
  520. package/dist/cli/vault/rotationTransport.d.ts +18 -0
  521. package/dist/cli/vault/rotationTransport.js +71 -0
  522. package/dist/cli/vault/sshSource.d.ts +18 -0
  523. package/dist/cli/vault/sshSource.js +196 -0
  524. package/dist/cli/vault/sshSync.d.ts +17 -0
  525. package/dist/cli/vault/sshSync.js +224 -0
  526. package/dist/cli/vault/sshTransfer.d.ts +22 -0
  527. package/dist/cli/vault/sshTransfer.js +140 -0
  528. package/dist/cli/vault/terraformState.d.ts +66 -0
  529. package/dist/cli/vault/terraformState.js +252 -0
  530. package/dist/cli/vault/terraformStateCommand.d.ts +2 -0
  531. package/dist/cli/vault/terraformStateCommand.js +61 -0
  532. package/dist/cli/vault/tree.d.ts +43 -0
  533. package/dist/cli/vault/tree.js +292 -0
  534. package/dist/cli/version.d.ts +1 -0
  535. package/dist/cli/version.js +9 -0
  536. package/dist/cli/workflow/index.d.ts +76 -0
  537. package/dist/cli/workflow/index.js +826 -0
  538. package/dist/cli/workflow/validate.d.ts +19 -0
  539. package/dist/cli/workflow/validate.js +353 -0
  540. package/dist/package.json +1 -0
  541. package/package.json +28 -10
@@ -0,0 +1,178 @@
1
+ import { createHash } from "node:crypto";
2
+ import { HttpError, requestJson } from "../client.js";
3
+ import { withConnFlags } from "../compat/flags.js";
4
+ import { emitJson, fail, renderTable } from "../helpers.js";
5
+ import { tokens } from "./document.js";
6
+ import { ctx, resolveNote, seg } from "./index.js";
7
+ const VERSION_ID = /^v_[0-9]{13}_[a-f0-9-]{36}$/;
8
+ function validId(id, label) {
9
+ if (!VERSION_ID.test(id))
10
+ throw new Error(`${label} must be a saved version ID (v_<timestamp>_<uuid>)`);
11
+ }
12
+ function digest(text) { return createHash("sha256").update(text, "utf8").digest("hex"); }
13
+ function errorResult(error, opts, attempted = false) {
14
+ let code = "version_failed";
15
+ let status;
16
+ let message = error instanceof Error ? error.message : String(error);
17
+ if (error instanceof HttpError) {
18
+ status = error.status;
19
+ try {
20
+ const body = JSON.parse(error.body);
21
+ if (typeof body.error === "string")
22
+ code = body.error;
23
+ if (typeof body.message === "string")
24
+ message = body.message;
25
+ }
26
+ catch { /* Preserve the transport diagnostic. */ }
27
+ }
28
+ const stale = status === 412 || (status === 409 && code === "note_changed");
29
+ if (stale)
30
+ message += "; review the current note and its hash before explicitly saving again; no retry was performed";
31
+ else if (attempted)
32
+ message += "; inspect saved versions before resubmitting; no retry was performed";
33
+ if (opts.json)
34
+ emitJson({ error: code, message, ...(status === undefined ? {} : { status }) });
35
+ else
36
+ fail(message);
37
+ return stale ? 3 : status === 503 || status === 409 ? 4 : 1;
38
+ }
39
+ async function target(ref, opts) {
40
+ const c = await ctx(opts);
41
+ if (!c)
42
+ return null;
43
+ const id = await resolveNote(c, ref);
44
+ if (!id)
45
+ return null;
46
+ return { ...c, id, path: `/namespaces/${seg(c.ns)}/notes/${seg(id)}` };
47
+ }
48
+ function metadata(v) {
49
+ return `version: ${v.id}\nhash: sha256:${v.hash}\ntag: ${v.tag}\nsummary: ${v.summary}\nparent: ${v.parentId ?? ""}\ncreatedAt: ${v.createdAt}\n`;
50
+ }
51
+ export async function runVersionCreate(ref, opts) {
52
+ let attempted = false;
53
+ try {
54
+ if (opts.parent !== undefined)
55
+ validId(opts.parent, "--parent");
56
+ if (opts.tag !== undefined && [...opts.tag].length > 80)
57
+ throw new Error("version label is limited to 80 characters");
58
+ if (opts.summary !== undefined && [...opts.summary].length > 2000)
59
+ throw new Error("--summary is limited to 2000 characters");
60
+ const expected = opts.hash?.replace(/^sha256:/, "");
61
+ if (expected !== undefined && !/^[a-f0-9]{64}$/.test(expected))
62
+ throw new Error("--hash requires a SHA-256 content hash, optionally prefixed with sha256:");
63
+ const c = await target(ref, opts);
64
+ if (!c)
65
+ return 1;
66
+ // One full coherent read: never fetch the text and hash independently.
67
+ const snapshot = await requestJson(c.remote, `${c.path}/body?contract=v2`, { token: c.token });
68
+ tokens(snapshot, c.id);
69
+ if (typeof snapshot.content !== "string" || `sha256:${digest(snapshot.content)}` !== snapshot.hash)
70
+ throw new Error("source does not match the returned hash; no version was created");
71
+ const hash = snapshot.hash.slice(7);
72
+ if (expected !== undefined && expected !== hash)
73
+ throw new HttpError(409, JSON.stringify({ error: "note_changed", message: "The current note differs from --hash" }));
74
+ const payload = { hash, ...(opts.tag === undefined ? {} : { tag: opts.tag }),
75
+ ...(opts.summary === undefined ? {} : { summary: opts.summary }),
76
+ ...(opts.parent === undefined ? {} : { parentId: opts.parent }) };
77
+ if (opts.dryRun) {
78
+ if (opts.json)
79
+ emitJson({ dryRun: true, method: "POST", path: `${c.path}/versions`, payload });
80
+ else
81
+ process.stdout.write(`would save a version of ${c.id}\nhash: sha256:${hash}\n`);
82
+ return 0;
83
+ }
84
+ attempted = true;
85
+ const version = await requestJson(c.remote, `${c.path}/versions`, {
86
+ token: c.token, method: "POST", json: payload, redirect: "error"
87
+ });
88
+ if (!version || !VERSION_ID.test(version.id) || version.hash !== hash)
89
+ throw new Error("inconsistent saved version receipt");
90
+ if (opts.json)
91
+ emitJson(version);
92
+ else
93
+ process.stdout.write(metadata(version));
94
+ return 0;
95
+ }
96
+ catch (error) {
97
+ return errorResult(error, opts, attempted);
98
+ }
99
+ }
100
+ export async function runVersionList(ref, opts) {
101
+ try {
102
+ if (opts.before !== undefined)
103
+ validId(opts.before, "--before");
104
+ const c = await target(ref, opts);
105
+ if (!c)
106
+ return 1;
107
+ const result = await requestJson(c.remote, `${c.path}/versions`, {
108
+ token: c.token, query: { before: opts.before }
109
+ });
110
+ if (opts.json)
111
+ emitJson(result);
112
+ else {
113
+ process.stdout.write(renderTable(result.versions.map(v => ({ ID: v.id, TAG: v.tag, CREATED: v.createdAt, SUMMARY: v.summary })), ["ID", "TAG", "CREATED", "SUMMARY"]));
114
+ if (result.nextCursor)
115
+ process.stdout.write(`next cursor (--before): ${result.nextCursor}\n`);
116
+ }
117
+ return 0;
118
+ }
119
+ catch (error) {
120
+ return errorResult(error, opts);
121
+ }
122
+ }
123
+ export async function runVersionRead(ref, id, opts) {
124
+ try {
125
+ validId(id, "version");
126
+ const c = await target(ref, opts);
127
+ if (!c)
128
+ return 1;
129
+ const version = await requestJson(c.remote, `${c.path}/versions/${seg(id)}`, { token: c.token });
130
+ if (version.id !== id || typeof version.text !== "string" || digest(version.text) !== version.hash)
131
+ throw new Error("saved version text does not match its identity or hash");
132
+ if (opts.json)
133
+ emitJson(version);
134
+ else
135
+ process.stdout.write(`${metadata(version)}\n${version.text}`);
136
+ return 0;
137
+ }
138
+ catch (error) {
139
+ return errorResult(error, opts);
140
+ }
141
+ }
142
+ /** Saved reads cannot silently fall back to live, partial or collaborative reads. */
143
+ export async function runSavedVersionRead(ref, opts) {
144
+ try {
145
+ const note = ref ?? opts.note;
146
+ if (!note || (ref && opts.note && ref !== opts.note))
147
+ throw new Error("give one note id, slug or name");
148
+ const incompatible = ["at", "toc", "tag", "since", "format", "legacy", "section", "startLine", "endLine", "numbered", "ifMatch", "linger", "debounce", "throttle", "intent"];
149
+ const present = incompatible.filter(key => opts[key] !== undefined && opts[key] !== false);
150
+ if (present.length || (opts.view !== undefined && opts.view !== "source")) {
151
+ throw new Error("--version reads complete immutable source; do not combine it with live, incremental, partial, HTML or collaboration options");
152
+ }
153
+ return runVersionRead(note, opts.version, opts);
154
+ }
155
+ catch (error) {
156
+ return errorResult(error, opts);
157
+ }
158
+ }
159
+ export function registerVersionCommands(notes) {
160
+ const common = (cmd) => withConnFlags(cmd.allowExcessArguments(false))
161
+ .argument("<note>", "note id, slug or title")
162
+ .option("--namespace <slug>", "note owner namespace")
163
+ .option("--json", "emit JSON");
164
+ const creation = (cmd) => cmd
165
+ .option("--summary <text>", "version summary (up to 2000 characters)")
166
+ .option("--parent <version-id>", "parent saved version in the same note")
167
+ .option("--hash <hash>", "require the content hash retained from a reviewed read")
168
+ .option("--dry-run", "read and validate without saving a version");
169
+ const listing = (cmd) => cmd
170
+ .option("--before <version-id>", "nextCursor from a previous page")
171
+ .action(async (note, opts) => { process.exitCode = await runVersionList(note, opts); });
172
+ creation(common(notes.command("tag")))
173
+ .argument("<label>", "saved version label (up to 80 characters)")
174
+ .description("tag the current note as an immutable saved version")
175
+ .action(async (note, label, opts) => { process.exitCode = await runVersionCreate(note, { ...opts, tag: label }); });
176
+ listing(common(notes.command("hist")))
177
+ .description("list saved versions of a note, newest first (up to 50 per page)");
178
+ }
@@ -0,0 +1,74 @@
1
+ import { Command } from "commander";
2
+ import { confirm } from "../prompt.js";
3
+ import { enrollHost } from "../hosts/enroll.js";
4
+ export declare const ENABLE_PROMPT = "Enable Nymph background service? Supports uploads, command execution and other tools; access permissions are managed separately. [y/N]";
5
+ export interface Context {
6
+ server: string;
7
+ namespace: string;
8
+ name: string;
9
+ }
10
+ export declare function context(name?: string): Context;
11
+ export declare function locations(c: Context): {
12
+ hostRoot: string;
13
+ config: string;
14
+ access: string;
15
+ record: string;
16
+ unit: string;
17
+ label: string;
18
+ };
19
+ export declare function readPrivate(file: string): any | undefined;
20
+ export declare function writePrivate(file: string, value: unknown): void;
21
+ export interface Policy {
22
+ version: 1;
23
+ scope: {
24
+ server: string;
25
+ namespace: string;
26
+ machine_id: string;
27
+ };
28
+ permissions: {
29
+ upload: boolean;
30
+ command_execution: boolean;
31
+ };
32
+ }
33
+ export declare function validatePolicy(p: any): Policy;
34
+ declare function invoke(args: string[]): any;
35
+ export declare function overview(c: Context): {
36
+ name: string;
37
+ managed: boolean;
38
+ configuration: {
39
+ path: string;
40
+ settings: unknown;
41
+ };
42
+ access: {
43
+ path: string;
44
+ configured: {
45
+ upload: boolean;
46
+ command_execution: boolean;
47
+ } | null;
48
+ application: string;
49
+ };
50
+ service: {
51
+ installedByThisSetup: boolean;
52
+ instances: unknown;
53
+ };
54
+ separateServices: string;
55
+ };
56
+ export declare function renderOverview(c: Context, json?: boolean): void;
57
+ export declare function setup(c: Context, opts: {
58
+ lakeshoreId?: string;
59
+ }, enroll?: typeof enrollHost): Promise<Record<string, unknown>>;
60
+ export declare function afterLogin(deps?: {
61
+ interactive?: boolean;
62
+ ask?: typeof confirm;
63
+ enable?: (c: Context) => Promise<unknown>;
64
+ output?: (text: string) => void;
65
+ getContext?: () => Context;
66
+ instances?: () => any;
67
+ }): Promise<void>;
68
+ export declare function setPermission(c: Context, tool: string, allow: boolean, yes?: boolean): Promise<boolean>;
69
+ export declare function editConfig(c: Context, opts: {
70
+ pollSeconds?: string;
71
+ maxInvocations?: string;
72
+ }, inspect?: typeof invoke): void;
73
+ export declare function registerNymphCommand(program: Command): void;
74
+ export {};
@@ -0,0 +1,349 @@
1
+ import { createHash, randomUUID } from "node:crypto";
2
+ import { closeSync, fchmodSync, fstatSync, openSync, readFileSync, renameSync, writeFileSync, mkdirSync, lstatSync, realpathSync, constants, unlinkSync } from "node:fs";
3
+ import { homedir, hostname } from "node:os";
4
+ import path from "node:path";
5
+ import { execFileSync } from "node:child_process";
6
+ import { resolveRemote, resolveToken } from "../config.js";
7
+ import { identityMode } from "../auth/machine.js";
8
+ import { currentEnv } from "../auth/credentials.js";
9
+ import { confirm } from "../prompt.js";
10
+ import { enrollHost } from "../hosts/enroll.js";
11
+ import { resolveEnrollment } from "../hosts/config.js";
12
+ export const ENABLE_PROMPT = "Enable Nymph background service? Supports uploads, command execution and other tools; access permissions are managed separately. [y/N]";
13
+ const digest = (s) => createHash("sha256").update(s).digest("hex");
14
+ export function context(name) {
15
+ const env = currentEnv();
16
+ if (!env?.namespace || !env.server)
17
+ throw new Error("Log in before configuring Nymph");
18
+ if (identityMode() !== "user" || resolveRemote().replace(/\/+$/, "") !== env.server.replace(/\/+$/, "") || resolveToken() !== env.token)
19
+ throw new Error("Nymph setup requires the selected personal login without connection overrides");
20
+ const localName = hostname().replace(/[^A-Za-z0-9_-]/g, "-").slice(0, 63) || "computer";
21
+ const fullName = name ?? `${env.namespace}/computers/${localName}`;
22
+ const plan = resolveEnrollment({ local: true, name: fullName, webTerminal: false });
23
+ if (plan.namespace !== env.namespace)
24
+ throw new Error("Select the login namespace before configuring Nymph");
25
+ return { server: env.server.replace(/\/+$/, ""), namespace: env.namespace, name: plan.name };
26
+ }
27
+ // Resolve only the trusted home mapping, never a settings path. Both the
28
+ // spelling supplied by the OS and its resolved target must have trusted owners
29
+ // and no group/other-writable directories (root-owned sticky ancestors such as
30
+ // /tmp are permitted). This accepts cluster home aliases and macOS /var without
31
+ // permitting symlinked access policies or service records beneath the home.
32
+ function trustedHome() {
33
+ const home = path.resolve(homedir());
34
+ const resolved = realpathSync(home);
35
+ const uid = process.getuid?.();
36
+ for (const spelling of new Set([home, resolved])) {
37
+ for (let current = spelling;; current = path.dirname(current)) {
38
+ const s = lstatSync(current);
39
+ const trustedOwner = uid === undefined || s.uid === uid || s.uid === 0;
40
+ const stickyAncestor = current !== spelling && s.isDirectory() && s.uid === 0 && !!(s.mode & 0o1000);
41
+ if (!trustedOwner || (!s.isSymbolicLink() && (!s.isDirectory() || ((s.mode & 0o022) && !stickyAncestor)))) {
42
+ throw new Error("Nymph home path must have trusted owners and no writable shared directories");
43
+ }
44
+ if (current === path.dirname(current))
45
+ break;
46
+ }
47
+ }
48
+ const target = lstatSync(resolved);
49
+ if (!target.isDirectory() || (uid !== undefined && target.uid !== uid) || (target.mode & 0o022)) {
50
+ throw new Error("Nymph home must resolve to an owned directory without group/other write access");
51
+ }
52
+ return resolved;
53
+ }
54
+ export function locations(c) {
55
+ const home = trustedHome();
56
+ const hostKey = digest(c.name);
57
+ const hostRoot = path.join(home, ".local/state/dreamlake/hosts", hostKey);
58
+ return { hostRoot, config: path.join(hostRoot, "nymph.toml"), access: path.join(hostRoot, "access.json"),
59
+ record: path.join(home, ".dreamlake/nymph", digest(c.server + "\n" + c.name), "service.json"),
60
+ unit: `dreamlake-host-${hostKey.slice(0, 24)}.service`, label: `ai.dreamlake.host.${hostKey.slice(0, 24)}` };
61
+ }
62
+ function noSymlinks(file) {
63
+ for (let p = file;; p = path.dirname(p)) {
64
+ try {
65
+ if (lstatSync(p).isSymbolicLink())
66
+ throw new Error("Nymph settings must not use symlinks");
67
+ }
68
+ catch (e) {
69
+ if (e.code !== "ENOENT")
70
+ throw e;
71
+ }
72
+ if (p === path.dirname(p))
73
+ break;
74
+ }
75
+ }
76
+ export function readPrivate(file) {
77
+ noSymlinks(file);
78
+ let fd;
79
+ try {
80
+ fd = openSync(file, constants.O_RDONLY | constants.O_NOFOLLOW | constants.O_NONBLOCK);
81
+ }
82
+ catch (e) {
83
+ if (e.code === "ENOENT")
84
+ return;
85
+ throw e;
86
+ }
87
+ try {
88
+ const s = fstatSync(fd);
89
+ if (!s.isFile() || s.size > 16_384 || (s.mode & 0o077) || (process.getuid && s.uid !== process.getuid()))
90
+ throw new Error("Nymph settings must be owned private files under 16KiB");
91
+ return JSON.parse(readFileSync(fd, "utf8"));
92
+ }
93
+ finally {
94
+ closeSync(fd);
95
+ }
96
+ }
97
+ export function writePrivate(file, value) {
98
+ noSymlinks(file);
99
+ mkdirSync(path.dirname(file), { recursive: true, mode: 0o700 });
100
+ const parent = lstatSync(path.dirname(file));
101
+ if ((parent.mode & 0o022) || (process.getuid && parent.uid !== process.getuid()))
102
+ throw new Error("Nymph settings directory must be owned and private");
103
+ const temp = file + "." + randomUUID();
104
+ const fd = openSync(temp, "wx", 0o600);
105
+ try {
106
+ fchmodSync(fd, 0o600);
107
+ writeFileSync(fd, JSON.stringify(value, null, 2) + "\n");
108
+ }
109
+ catch (e) {
110
+ unlinkSync(temp);
111
+ throw e;
112
+ }
113
+ finally {
114
+ closeSync(fd);
115
+ }
116
+ renameSync(temp, file);
117
+ }
118
+ export function validatePolicy(p) {
119
+ if (!p || p.version !== 1 || Object.keys(p).sort().join() !== "permissions,scope,version" || !p.scope || Object.keys(p.scope).sort().join() !== "machine_id,namespace,server" ||
120
+ !Object.values(p.scope).every(v => typeof v === "string" && v.length > 0) || !p.permissions || Object.keys(p.permissions).sort().join() !== "command_execution,upload" ||
121
+ typeof p.permissions.upload !== "boolean" || typeof p.permissions.command_execution !== "boolean")
122
+ throw new Error("Invalid Nymph access policy");
123
+ return p;
124
+ }
125
+ function invoke(args) {
126
+ try {
127
+ return JSON.parse(execFileSync("nymph", args, { encoding: "utf8", timeout: 5000, maxBuffer: 256_000, stdio: ["ignore", "pipe", "pipe"] }));
128
+ }
129
+ catch {
130
+ throw new Error("Nymph inspection unavailable; verify the installed release and managed configuration");
131
+ }
132
+ }
133
+ export function overview(c) {
134
+ const paths = locations(c);
135
+ const record = readPrivate(paths.record);
136
+ const raw = readPrivate(paths.access);
137
+ const policy = raw ? validatePolicy(raw) : undefined;
138
+ if (record && (record.server !== c.server || record.name !== c.name || policy?.scope.machine_id !== record.enrollment?.machineId))
139
+ throw new Error("Managed enrollment identity mismatch");
140
+ let instances = null;
141
+ let settings = null;
142
+ try {
143
+ instances = invoke(["instances", "--json"]);
144
+ }
145
+ catch { /* unavailable is unknown, never stopped */ }
146
+ if (record && policy) {
147
+ try {
148
+ settings = invoke(["access", "--config", paths.config]);
149
+ }
150
+ catch { /* no raw config/token output */ }
151
+ }
152
+ return { name: c.name, managed: !!record && !!policy, configuration: { path: paths.config, settings },
153
+ access: { path: paths.access, configured: policy?.permissions ?? null, application: "Startup snapshot; changes require restart. Server authorization is also required." },
154
+ service: { installedByThisSetup: !!record, instances },
155
+ separateServices: "Independent transcript archive collectors are managed separately." };
156
+ }
157
+ export function renderOverview(c, json = false) {
158
+ const view = overview(c);
159
+ if (json) {
160
+ console.log(JSON.stringify(view, null, 2));
161
+ return;
162
+ }
163
+ console.log(`Nymph · ${c.name}\n\nConfiguration\n ${view.configuration.path}\n ${view.configuration.settings ? JSON.stringify(view.configuration.settings.settings) : "Settings not verified"}\n\nAccess\n ${view.access.path}\n Automatic uploads: ${view.access.configured ? (view.access.configured.upload ? "allowed" : "denied") : "unmanaged / unknown"}\n Command execution: ${view.access.configured ? (view.access.configured.command_execution ? "allowed" : "denied") : "unmanaged / unknown"}\n ${view.access.application}\n\nService\n ${view.managed ? "Managed enrollment" : "Not managed by this setup; existing services retain their own settings"}\n Runtime observation: ${view.service.instances ? "available" : "unavailable"}\n\n${view.separateServices}`);
164
+ if (Array.isArray(view.service.instances))
165
+ for (const instance of view.service.instances) {
166
+ const clean = (value) => String(value ?? "unknown").replace(/[\x00-\x1f\x7f-\x9f]/g, " ");
167
+ console.log(` ${clean(instance.name)} · PID ${clean(instance.pid)} · ${clean(instance.processState)} · ${clean(instance.connection)}\n Config: ${clean(instance.configPath)}`);
168
+ }
169
+ }
170
+ export async function setup(c, opts, enroll = enrollHost) {
171
+ const paths = locations(c);
172
+ // Never silently convert an existing legacy enrollment or relax its policy.
173
+ try {
174
+ lstatSync(paths.config);
175
+ if (!readPrivate(paths.access))
176
+ throw new Error("Existing enrollment needs explicit permission migration");
177
+ }
178
+ catch (e) {
179
+ if (e.code !== "ENOENT")
180
+ throw e;
181
+ }
182
+ const result = await enroll(resolveEnrollment({ local: true, name: c.name, webTerminal: false }), { managedAccess: true, lakeshoreId: opts.lakeshoreId });
183
+ const policy = validatePolicy(readPrivate(paths.access));
184
+ // First setup must be deny-all. Replays preserve separately managed consent.
185
+ if (!readPrivate(paths.record) && (policy.permissions.upload || policy.permissions.command_execution))
186
+ throw new Error("New Nymph setup did not return deny-all access");
187
+ if (result.enrollment?.machineId !== policy.scope.machine_id)
188
+ throw new Error("Managed policy identity mismatch");
189
+ writePrivate(paths.record, { version: 1, server: c.server, name: c.name, enrollment: result.enrollment, scope: policy.scope });
190
+ return result;
191
+ }
192
+ export async function afterLogin(deps = {}) {
193
+ if (!(deps.interactive ?? (!!process.stdin.isTTY && !!process.stdout.isTTY && !process.env.CI)))
194
+ return;
195
+ const output = deps.output ?? (s => process.stdout.write(s));
196
+ try {
197
+ const c = (deps.getContext ?? context)();
198
+ if (readPrivate(locations(c).record)) {
199
+ output("Nymph overview: dreamlake nymph\n");
200
+ return;
201
+ }
202
+ // An existing daemon can have a different name: do not enroll a second one at login.
203
+ try {
204
+ const known = deps.instances ? deps.instances() : invoke(["instances", "--json"]);
205
+ if (JSON.stringify(known).includes('"config_path"') || (Array.isArray(known) && known.length) || known?.instances?.length) {
206
+ output("Existing Nymph detected. Review configuration and access with dreamlake nymph.\n");
207
+ return;
208
+ }
209
+ }
210
+ catch { /* Setup performs its own feature/prerequisite checks. */ }
211
+ if (!await (deps.ask ?? confirm)(ENABLE_PROMPT, false))
212
+ return;
213
+ await (deps.enable ?? (c => setup(c, {})))(c);
214
+ output("Nymph setup requested. Upload and command execution permissions are managed separately.\nOverview: dreamlake nymph\n");
215
+ }
216
+ catch {
217
+ output("Login succeeded. Nymph setup was not confirmed; run dreamlake nymph setup to inspect prerequisites.\n");
218
+ }
219
+ }
220
+ export async function setPermission(c, tool, allow, yes = false) {
221
+ if (!["upload", "command-execution"].includes(tool))
222
+ throw new Error("Choose upload or command-execution");
223
+ const paths = locations(c);
224
+ const record = readPrivate(paths.record);
225
+ if (!record)
226
+ throw new Error("Set up a managed Nymph enrollment first");
227
+ noSymlinks(paths.access);
228
+ const lock = openSync(paths.access + ".lock", "wx", 0o600);
229
+ try {
230
+ const policy = validatePolicy(readPrivate(paths.access));
231
+ if (policy.scope.machine_id !== record.enrollment?.machineId || JSON.stringify(policy.scope) !== JSON.stringify(record.scope))
232
+ throw new Error("Managed policy identity mismatch");
233
+ if (allow && !yes && !await confirm(`Allow Nymph ${tool} on ${c.name}? Server authorization is still required.`, false))
234
+ return false;
235
+ const latest = validatePolicy(readPrivate(paths.access));
236
+ if (JSON.stringify(latest) !== JSON.stringify(policy))
237
+ throw new Error("Access changed; inspect and retry");
238
+ latest.permissions[tool === "upload" ? "upload" : "command_execution"] = allow;
239
+ writePrivate(paths.access, latest);
240
+ return true;
241
+ }
242
+ finally {
243
+ closeSync(lock);
244
+ unlinkSync(paths.access + ".lock");
245
+ }
246
+ }
247
+ export function editConfig(c, opts, inspect = invoke) {
248
+ const p = locations(c);
249
+ if (!readPrivate(p.record))
250
+ throw new Error("Set up a managed Nymph enrollment first");
251
+ const changes = [];
252
+ for (const [value, section, key, min, max] of [[opts.pollSeconds, "poll", "wait_max_s", 1, 300], [opts.maxInvocations, "runtime", "max_invocations", 1, 32]]) {
253
+ if (value === undefined)
254
+ continue;
255
+ const n = Number(value);
256
+ if (!Number.isInteger(n) || n < min || n > max)
257
+ throw new Error(`${key} must be ${min}–${max}`);
258
+ changes.push([section, key, n]);
259
+ }
260
+ if (!changes.length)
261
+ throw new Error("Choose --poll-seconds or --max-invocations");
262
+ noSymlinks(p.config);
263
+ const lock = openSync(p.config + ".edit-lock", "wx", 0o600);
264
+ let temp;
265
+ try {
266
+ // Both before and after mutation, validate with the installed daemon's parser.
267
+ inspect(["access", "--config", p.config]);
268
+ const before = readFileSync(p.config, "utf8");
269
+ if (Buffer.byteLength(before) > 65536)
270
+ throw new Error("Managed config exceeds bound");
271
+ let lines = before.split("\n");
272
+ for (const [section, key, n] of changes) {
273
+ let start = lines.findIndex(l => l.trim() === `[${section}]`);
274
+ if (start < 0) {
275
+ lines.push(`[${section}]`, `${key} = ${n}`);
276
+ continue;
277
+ }
278
+ let end = lines.findIndex((l, i) => i > start && l.trim().startsWith("["));
279
+ if (end < 0)
280
+ end = lines.length;
281
+ const found = lines.findIndex((l, i) => i > start && i < end && l.trim().startsWith(key + " ") && l.includes("="));
282
+ if (found >= 0)
283
+ lines[found] = `${key} = ${n}`;
284
+ else
285
+ lines.splice(end, 0, `${key} = ${n}`);
286
+ }
287
+ temp = p.config + "." + randomUUID();
288
+ const fd = openSync(temp, "wx", 0o600);
289
+ try {
290
+ writeFileSync(fd, lines.join("\n") + "\n");
291
+ }
292
+ finally {
293
+ closeSync(fd);
294
+ }
295
+ inspect(["access", "--config", temp]);
296
+ if (readFileSync(p.config, "utf8") !== before)
297
+ throw new Error("Configuration changed; inspect and retry");
298
+ renameSync(temp, p.config);
299
+ temp = undefined;
300
+ }
301
+ finally {
302
+ if (temp)
303
+ unlinkSync(temp);
304
+ closeSync(lock);
305
+ unlinkSync(p.config + ".edit-lock");
306
+ }
307
+ }
308
+ export function registerNymphCommand(program) {
309
+ const root = program.command("nymph").description("Nymph overview: local configuration, separate access permissions and service observations").option("--name <namespace/group/host>", "select this computer's managed enrollment").option("--json", "emit JSON").action(opts => renderOverview(context(opts.name), opts.json));
310
+ root.enablePositionalOptions();
311
+ // Enrollment selectors apply throughout the subtree. Never silently fall
312
+ // back to the default profile when a parent selected another enrollment.
313
+ root.hook("preAction", (_root, action) => {
314
+ let selected;
315
+ for (let current = action; current && current !== root.parent; current = current.parent) {
316
+ const candidate = current.opts().name;
317
+ if (candidate === undefined)
318
+ continue;
319
+ if (selected !== undefined && candidate !== selected)
320
+ throw new Error("Conflicting Nymph enrollment names; select one enrollment");
321
+ selected = candidate;
322
+ }
323
+ if (selected !== undefined)
324
+ action.setOptionValueWithSource("name", selected, "cli");
325
+ });
326
+ root.command("setup").description("enable a background service with upload and command execution denied initially").option("--name <namespace/group/host>").option("--lakeshore-id <id>").action(async (opts) => { console.log(JSON.stringify(await setup(context(opts.name), opts), null, 2)); });
327
+ const config = root.command("config").description("inspect redacted service configuration without reading credentials").option("--name <namespace/group/host>").action(opts => { console.log(JSON.stringify(overview(context(opts.name)).configuration, null, 2)); });
328
+ config.enablePositionalOptions();
329
+ config.command("set").description("edit service pacing; access permissions remain unchanged").option("--name <namespace/group/host>").option("--poll-seconds <seconds>").option("--max-invocations <count>").action(opts => { const c = context(opts.name); editConfig(c, opts); console.log(`Configuration saved for ${c.name}; restart this enrollment to apply. Access permissions unchanged.`); });
330
+ const access = root.command("access").description("manage local consent separately from server authorization");
331
+ access.command("show").option("--name <namespace/group/host>").action(opts => console.log(JSON.stringify(overview(context(opts.name)).access, null, 2)));
332
+ for (const [verb, allow] of [["grant", true], ["revoke", false]])
333
+ access.command(`${verb} <tool>`).description(`${verb} automatic upload or command-execution consent; restart required`).option("--name <namespace/group/host>").option("--yes", "explicitly approve this one permission").action(async (tool, opts) => { const c = context(opts.name); if (await setPermission(c, tool, allow, opts.yes))
334
+ console.log(`Access saved for ${c.name}. Restart this enrollment to apply; the running daemon has not changed yet.`); });
335
+ root.command("restart").description("restart only the selected managed enrollment to apply configuration and access").option("--name <namespace/group/host>").action(opts => {
336
+ const c = context(opts.name), p = locations(c);
337
+ if (!readPrivate(p.record))
338
+ throw new Error("No managed enrollment selected");
339
+ // Validate both policy and service config with the installed daemon before restart.
340
+ invoke(["access", "--config", p.config]);
341
+ if (process.platform === "linux")
342
+ execFileSync("systemctl", ["--user", "restart", p.unit], { stdio: "inherit", timeout: 30000 });
343
+ else if (process.platform === "darwin")
344
+ execFileSync("launchctl", ["kickstart", "-k", `gui/${process.getuid()}/${p.label}`], { stdio: "inherit", timeout: 30000 });
345
+ else
346
+ throw new Error("Nymph background services require Linux or macOS");
347
+ console.log(`Restart requested for ${c.name}; inspect nymph status for runtime confirmation.`);
348
+ });
349
+ }
@@ -0,0 +1,34 @@
1
+ import type { Command } from "commander";
2
+ export declare function runOrgList(opts: {
3
+ json?: boolean;
4
+ }): Promise<number>;
5
+ export declare function runOrgShow(slug: string, opts: {
6
+ json?: boolean;
7
+ }): Promise<number>;
8
+ export declare function runOrgCreate(slug: string, opts: {
9
+ name?: string;
10
+ description?: string;
11
+ }): Promise<number>;
12
+ export declare function runOrgUpdate(slug: string, opts: {
13
+ name?: string;
14
+ description?: string;
15
+ }): Promise<number>;
16
+ export declare function runOrgDelete(slug: string, opts: {
17
+ yes?: boolean;
18
+ }): Promise<number>;
19
+ export declare function runOrgLeave(slug: string, opts: {
20
+ yes?: boolean;
21
+ }): Promise<number>;
22
+ export declare function runOrgMemberList(slug: string, opts: {
23
+ json?: boolean;
24
+ }): Promise<number>;
25
+ export declare function runOrgMemberAdd(slug: string, user: string, opts: {
26
+ role?: string;
27
+ }): Promise<number>;
28
+ export declare function runOrgMemberRole(slug: string, user: string, opts: {
29
+ role?: string;
30
+ }): Promise<number>;
31
+ export declare function runOrgMemberRemove(slug: string, user: string, opts: {
32
+ yes?: boolean;
33
+ }): Promise<number>;
34
+ export declare function registerOrgCommand(program: Command): void;