@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,26 @@
1
+ /** Session context is metadata only: linking never opens or starts a terminal. */
2
+ export interface ResourceSessionRef {
3
+ namespace: string;
4
+ type: 'note' | 'artifact';
5
+ id: string;
6
+ }
7
+ export interface SavedSessionRef {
8
+ id: string;
9
+ namespace: string;
10
+ }
11
+ type Context = {
12
+ saved: SavedSessionRef;
13
+ } | {
14
+ provider: 'codex' | 'claude';
15
+ nativeId: string;
16
+ };
17
+ export declare function sessionContext(env?: NodeJS.ProcessEnv): Context | null;
18
+ export declare function writtenResource(method: string, pathname: string, response: unknown, payload?: unknown): ResourceSessionRef | null;
19
+ export declare function affiliationPath(resource: ResourceSessionRef, sessionId?: string): string;
20
+ export declare function createAutoAffiliator(deps?: {
21
+ fetch?: typeof fetch;
22
+ warn?: (message: string) => void;
23
+ env?: NodeJS.ProcessEnv;
24
+ }): (url: string, method: string, token: string | null | undefined, response: unknown, payload?: unknown) => Promise<void>;
25
+ export declare const affiliateSuccessfulWrite: (url: string, method: string, token: string | null | undefined, response: unknown, payload?: unknown) => Promise<void>;
26
+ export {};
@@ -0,0 +1,135 @@
1
+ const objectId = /^[a-f0-9]{24}$/;
2
+ const uuid = /^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}$/i;
3
+ const namespace = /^[A-Za-z0-9][A-Za-z0-9_-]{0,63}$/;
4
+ export function sessionContext(env = process.env) {
5
+ if (env.DREAMLAKE_SESSION_AFFILIATION === '0')
6
+ return null;
7
+ const id = env.DREAMLAKE_TERMINAL_SESSION_ID, ns = env.DREAMLAKE_SESSION_NAMESPACE;
8
+ if (id)
9
+ return id && ns && objectId.test(id) && namespace.test(ns) ? { saved: { id, namespace: ns } } : null;
10
+ // Never infer a native identity from arbitrary agent/presence labels.
11
+ const codex = env.CODEX_THREAD_ID, claude = env.CLAUDE_SESSION_ID;
12
+ if (codex && claude)
13
+ return null;
14
+ if (codex && uuid.test(codex))
15
+ return { provider: 'codex', nativeId: codex.toLowerCase() };
16
+ if (claude && uuid.test(claude))
17
+ return { provider: 'claude', nativeId: claude.toLowerCase() };
18
+ return null;
19
+ }
20
+ export function writtenResource(method, pathname, response, payload) {
21
+ if (!['POST', 'PUT', 'PATCH', 'DELETE'].includes(method))
22
+ return null;
23
+ const parts = pathname.split('/').filter(Boolean).map(decodeURIComponent);
24
+ if (parts[0] !== 'namespaces' || !namespace.test(parts[1] ?? ''))
25
+ return null;
26
+ if (parts[2] === 'notes') {
27
+ if (method === 'POST' && parts.length === 3) {
28
+ const id = response?.note?.id;
29
+ return typeof id === 'string' && objectId.test(id) ? { namespace: parts[1], type: 'note', id } : null;
30
+ }
31
+ // Presence, sharing, reads, deletion and administrative operations do not imply contribution.
32
+ if (objectId.test(parts[3] ?? '') && ((method !== 'DELETE' && parts.length === 5 && ['body', 'sections'].includes(parts[4])) ||
33
+ (parts.length === 6 && parts[4] === 'sections' && !!parts[5] && ['PUT', 'PATCH', 'DELETE'].includes(method)))) {
34
+ return { namespace: parts[1], type: 'note', id: parts[3] };
35
+ }
36
+ }
37
+ const body = payload;
38
+ const registeredVersion = parts.length === 4 && typeof body?.version === 'number' && Number.isSafeInteger(body.version) && body.version > 0;
39
+ const appliedContent = parts.length === 5 && parts[4] === 'apply' && typeof body?.contentBase64 === 'string' && body.contentBase64.length > 0;
40
+ if (parts[2] === 'artifacts' && (registeredVersion || appliedContent) && method === 'POST' &&
41
+ !['upload-credentials', 'search', 'restore'].includes(parts[3]) &&
42
+ response && typeof response === 'object' && 'artifactId' in response) {
43
+ const id = response.artifactId;
44
+ if (id === parts[3])
45
+ return { namespace: parts[1], type: 'artifact', id: parts[3] };
46
+ }
47
+ return null;
48
+ }
49
+ export function affiliationPath(resource, sessionId) {
50
+ if (!namespace.test(resource.namespace) || !['note', 'artifact'].includes(resource.type) || !resource.id ||
51
+ resource.id.length > 256 || /[\x00-\x1f\x7f]/.test(resource.id) || (resource.type === 'note' && !objectId.test(resource.id)) ||
52
+ (resource.type === 'artifact' && (!/^[A-Za-z0-9._-]{1,128}$/.test(resource.id) || ['.', '..'].includes(resource.id))) ||
53
+ (sessionId !== undefined && !objectId.test(sessionId)))
54
+ throw new Error('Use an exact note/artifact and saved session ID');
55
+ return `/namespaces/${encodeURIComponent(resource.namespace)}/resources/${resource.type}/${encodeURIComponent(resource.id)}/sessions${sessionId ? '/' + sessionId : ''}`;
56
+ }
57
+ export function createAutoAffiliator(deps = {}) {
58
+ const linked = new Map();
59
+ let warned = false;
60
+ return async (url, method, token, response, payload) => {
61
+ try {
62
+ const env = deps.env ?? process.env;
63
+ const context = sessionContext(env);
64
+ if (!context || !token)
65
+ return;
66
+ const address = new URL(url), resource = writtenResource(method, address.pathname, response, payload);
67
+ if (!resource)
68
+ return;
69
+ if (env.DREAMLAKE_SESSION_VISIBILITY && !['public', 'private'].includes(env.DREAMLAKE_SESSION_VISIBILITY))
70
+ throw new Error('DREAMLAKE_SESSION_VISIBILITY must be public or private; metadata was not published');
71
+ const key = JSON.stringify([address.origin, token, resource, context]);
72
+ if ((linked.get(key) ?? 0) > Date.now() && !env.DREAMLAKE_CONVERSATION_FILE)
73
+ return;
74
+ const fetcher = deps.fetch ?? fetch;
75
+ // Metadata uses one lookup and one link; explicit archive capture adds one metadata read and one PUT.
76
+ // All network calls share the deadline; never follow redirects or retry.
77
+ const signal = AbortSignal.timeout(3000);
78
+ const headers = { Authorization: `Bearer ${token}`, 'Content-Type': 'application/json' };
79
+ let session;
80
+ if ('saved' in context)
81
+ session = context.saved;
82
+ else {
83
+ // Registration is metadata-only and idempotent. It never discovers or launches a terminal.
84
+ const registered = await fetcher(`${address.origin}/terminal-sessions/register`, {
85
+ method: 'POST', headers, signal, redirect: 'error', body: JSON.stringify({ provider: context.provider,
86
+ nativeSessionId: context.nativeId, cwd: process.cwd(),
87
+ ...(env.DREAMLAKE_SESSION_VISIBILITY === 'private' ? { visibility: 'private' } : {}) }),
88
+ });
89
+ if (!registered.ok)
90
+ throw new Error(`registration HTTP ${registered.status}; run dreamlake sessions register --provider ${context.provider} --session ${context.nativeId} --cwd <original-directory>`);
91
+ const row = (await registered.json()).session;
92
+ if (!row || row.canManage !== true || row.provider !== context.provider || row.codexSessionId !== context.nativeId ||
93
+ !objectId.test(row.id ?? '') || !namespace.test(row.namespaceSlug ?? ''))
94
+ throw new Error('invalid registration receipt');
95
+ session = { id: row.id, namespace: row.namespaceSlug };
96
+ }
97
+ const result = await fetcher(address.origin + affiliationPath(resource, session.id), {
98
+ method: 'PUT', headers, signal, redirect: 'error', body: JSON.stringify({ sessionNamespaceSlug: session.namespace }),
99
+ });
100
+ if (!result.ok)
101
+ throw new Error(`link HTTP ${result.status}`);
102
+ const receipt = await result.json();
103
+ if (receipt.linked !== true || receipt.sessionId !== session.id)
104
+ throw new Error('invalid link receipt');
105
+ if (env.DREAMLAKE_CONVERSATION_FILE) {
106
+ const path = `/namespaces/${encodeURIComponent(session.namespace)}/terminal-sessions/${session.id}/conversation`;
107
+ const currentResponse = await fetcher(address.origin + path + '?metadata=true', { headers, signal, redirect: 'error' });
108
+ if (!currentResponse.ok)
109
+ throw new Error(`conversation lookup HTTP ${currentResponse.status}`);
110
+ const current = await currentResponse.json();
111
+ if (!['codex', 'claude'].includes(current.provider) || typeof current.nativeSessionId !== 'string')
112
+ throw new Error('invalid conversation identity');
113
+ const { readConversationFile } = await import('./sessions/conversation.js');
114
+ const conversation = await readConversationFile(env.DREAMLAKE_CONVERSATION_FILE, current.provider, current.nativeSessionId);
115
+ signal.throwIfAborted();
116
+ const uploaded = await fetcher(address.origin + path, { method: 'PUT', headers, signal, redirect: 'error', body: JSON.stringify({ conversation, expectedRevision: current.revision }) });
117
+ if (!uploaded.ok)
118
+ throw new Error(`conversation upload HTTP ${uploaded.status}`);
119
+ const receipt = await uploaded.json();
120
+ if (receipt.sessionId !== session.id || !/^[a-f0-9]{64}$/.test(receipt.revision ?? ''))
121
+ throw new Error('invalid conversation receipt');
122
+ }
123
+ if (linked.size >= 32)
124
+ linked.delete(linked.keys().next().value);
125
+ linked.set(key, Date.now() + 30_000);
126
+ }
127
+ catch (error) {
128
+ if (!warned) {
129
+ warned = true;
130
+ (deps.warn ?? (message => process.stderr.write(message + '\n')))(`Content saved; optional session metadata was not fully recorded (${error instanceof Error ? error.message : 'unavailable'}). Retry only sessions register, sessions link or sessions upload-conversation; do not repeat the content write.`);
131
+ }
132
+ }
133
+ };
134
+ }
135
+ export const affiliateSuccessfulWrite = createAutoAffiliator();
@@ -0,0 +1,8 @@
1
+ import type { Command } from 'commander';
2
+ import { type ResourceSessionRef } from '../session-affiliation.js';
3
+ export declare function resourceFromOptions(opts: {
4
+ note?: string;
5
+ artifact?: string;
6
+ resourceNamespace?: string;
7
+ }): ResourceSessionRef;
8
+ export declare function registerSessionAffiliations(group: Command): void;
@@ -0,0 +1,66 @@
1
+ import { resolveHostNamespace } from '../hosts/inventory.js';
2
+ import { affiliationPath } from '../session-affiliation.js';
3
+ import { connection, requestJson, sessionPath } from './api.js';
4
+ export function resourceFromOptions(opts) {
5
+ if (Boolean(opts.note) === Boolean(opts.artifact))
6
+ throw new Error('Choose exactly one --note NOTE_ID or --artifact ARTIFACT_ID');
7
+ if (!opts.resourceNamespace)
8
+ throw new Error('--resource-namespace is required; the session may belong to another namespace');
9
+ const resource = { namespace: opts.resourceNamespace, type: opts.note ? 'note' : 'artifact', id: opts.note ?? opts.artifact };
10
+ affiliationPath(resource);
11
+ return resource;
12
+ }
13
+ export function registerSessionAffiliations(group) {
14
+ const run = async (operation, json) => {
15
+ try {
16
+ const result = await operation();
17
+ console.log(JSON.stringify(result, null, json ? 2 : undefined));
18
+ }
19
+ catch (error) {
20
+ const message = error instanceof Error ? error.message : 'Session affiliation failed';
21
+ if (json)
22
+ console.log(JSON.stringify({ error: message }));
23
+ else
24
+ console.error(message);
25
+ process.exitCode = 1;
26
+ }
27
+ };
28
+ for (const operation of ['link', 'unlink']) {
29
+ group.command(`${operation} <id>`).description(`${operation} a saved session and a note or artifact without opening a terminal`)
30
+ .option('--namespace <namespace>', 'session personal namespace')
31
+ .requiredOption('--resource-namespace <namespace>', 'namespace containing the note or artifact')
32
+ .option('--note <id>', 'exact note ID')
33
+ .option('--artifact <id>', 'exact artifact logical ID')
34
+ .option('--json')
35
+ .action((id, opts) => run(async () => {
36
+ const resource = resourceFromOptions(opts), path = affiliationPath(resource, id);
37
+ const ns = await resolveHostNamespace(opts.namespace);
38
+ const result = await requestJson(connection(), path, operation === 'link' ? 'PUT' : 'DELETE', { sessionNamespaceSlug: ns });
39
+ if (result?.linked !== (operation === 'link') || result.sessionId !== id)
40
+ throw new Error('Invalid session affiliation receipt');
41
+ return result;
42
+ }, opts.json));
43
+ }
44
+ group.command('resources <id>').description('list readable notes and artifacts affiliated with a saved session')
45
+ .option('--namespace <namespace>', 'session personal namespace')
46
+ .option('--cursor <cursor>', 'continue using the previous nextCursor')
47
+ .option('--page-size <count>', 'bounded page size, 1–50')
48
+ .option('--json')
49
+ .action((id, opts) => run(async () => {
50
+ const ns = await resolveHostNamespace(opts.namespace), query = new URLSearchParams();
51
+ if (opts.pageSize !== undefined) {
52
+ if (!/^\d+$/.test(opts.pageSize) || Number(opts.pageSize) < 1 || Number(opts.pageSize) > 50)
53
+ throw new Error('--page-size must be 1–50');
54
+ query.set('pageSize', opts.pageSize);
55
+ }
56
+ if (opts.cursor !== undefined) {
57
+ if (opts.cursor.length > 1024 || /[\x00-\x1f\x7f]/.test(opts.cursor))
58
+ throw new Error('Use the previous nextCursor');
59
+ query.set('cursor', opts.cursor);
60
+ }
61
+ const result = await requestJson(connection(), sessionPath(ns, id) + '/resources' + (query.size ? '?' + query : ''));
62
+ if (!Array.isArray(result?.resources) || typeof result.hasMore !== 'boolean')
63
+ throw new Error('Invalid linked resource list');
64
+ return result;
65
+ }, opts.json));
66
+ }
@@ -0,0 +1,55 @@
1
+ export interface SessionInput {
2
+ provider?: 'codex' | 'claude';
3
+ claudeConfigDir?: string;
4
+ targetId: string;
5
+ enrollmentId: string;
6
+ cwd: string;
7
+ codexSessionId: string;
8
+ name?: string;
9
+ }
10
+ export interface TerminalSession extends SessionInput {
11
+ id: string;
12
+ name: string;
13
+ hostId: string;
14
+ machineId: string;
15
+ username: string;
16
+ tmuxSession: string;
17
+ createdAt: string;
18
+ modelProvider?: string;
19
+ runState?: 'unknown' | 'running' | 'working' | 'waiting' | 'idle' | 'error' | 'stopped';
20
+ runStateObservedAt?: string | null;
21
+ launch: {
22
+ kind: 'codex' | 'claude';
23
+ claudeConfigDir?: string;
24
+ cwd: string;
25
+ codexSessionId: string;
26
+ enrollmentId: string;
27
+ };
28
+ }
29
+ export interface TerminalTarget {
30
+ id: string;
31
+ name: string;
32
+ enrollmentId?: string;
33
+ hostId?: string;
34
+ machineId: string;
35
+ username: string;
36
+ }
37
+ export interface Connection {
38
+ remote: string;
39
+ token: string;
40
+ }
41
+ export interface Gateway {
42
+ url: string;
43
+ origin: string;
44
+ }
45
+ export declare const validId: (id: unknown) => id is string;
46
+ export declare function sessionPath(namespace: string, id?: string): string;
47
+ export declare function validateSessionInput(input: SessionInput): SessionInput;
48
+ export declare function connection(): Connection;
49
+ /** Never send a custom environment's bearer to the production gateway implicitly. */
50
+ export declare function gatewayFor(remote: string, opts: {
51
+ gateway?: string;
52
+ origin?: string;
53
+ }): Gateway;
54
+ export declare function requestJson(connection: Connection, path: string, method?: string, body?: unknown, gateway?: Gateway): Promise<any>;
55
+ export declare function readSession(value: any): TerminalSession;
@@ -0,0 +1,88 @@
1
+ import { resolveRemote, resolveToken } from '../config.js';
2
+ export const validId = (id) => typeof id === 'string' && /^[a-f0-9]{24}$/.test(id);
3
+ export function sessionPath(namespace, id) {
4
+ if (!/^[A-Za-z0-9][A-Za-z0-9_-]{0,63}$/.test(namespace))
5
+ throw new Error('Invalid namespace');
6
+ if (id !== undefined && !validId(id))
7
+ throw new Error('Use the session ID returned by sessions list or create');
8
+ return `/namespaces/${encodeURIComponent(namespace)}/terminal-sessions${id ? `/${id}` : ''}`;
9
+ }
10
+ export function validateSessionInput(input) {
11
+ if (input.provider !== undefined && !['codex', 'claude'].includes(input.provider))
12
+ throw new Error('--provider must be codex or claude');
13
+ if (input.claudeConfigDir !== undefined && (input.provider !== 'claude' || typeof input.claudeConfigDir !== 'string' || !input.claudeConfigDir.startsWith('/') || Buffer.byteLength(input.claudeConfigDir) > 4096 || /[\x00-\x1f\x7f]/.test(input.claudeConfigDir)))
14
+ throw new Error('--claude-config-dir requires Claude and an absolute path');
15
+ if (!/^[A-Za-z0-9_-]{1,128}$/.test(input.targetId))
16
+ throw new Error('Select --target from sessions targets');
17
+ if (!validId(input.enrollmentId))
18
+ throw new Error('Select --enrollment from sessions targets');
19
+ if (!input.cwd.startsWith('/') || Buffer.byteLength(input.cwd) > 4096 || /[\x00-\x1f\x7f]/.test(input.cwd))
20
+ throw new Error('--cwd must be an absolute target-host path without control characters');
21
+ if (typeof input.codexSessionId !== 'string' || !/^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}$/i.test(input.codexSessionId))
22
+ throw new Error('Use an exact session UUID');
23
+ if (input.name !== undefined && (!input.name.trim() || input.name.length > 128 || /[\x00-\x1f\x7f]/.test(input.name)))
24
+ throw new Error('--name must contain 1–128 printable characters');
25
+ return { ...input, codexSessionId: input.codexSessionId.toLowerCase() };
26
+ }
27
+ export function connection() {
28
+ const token = resolveToken();
29
+ if (!token)
30
+ throw new Error('Log in to DreamLake before using terminal sessions');
31
+ return { remote: resolveRemote(), token };
32
+ }
33
+ function safeOrigin(raw) {
34
+ const url = new URL(raw);
35
+ if (url.username || url.password || url.search || url.hash || url.pathname !== '/' ||
36
+ !(url.protocol === 'https:' || (url.protocol === 'http:' && ['localhost', '127.0.0.1', '[::1]'].includes(url.hostname)))) {
37
+ throw new Error('Terminal endpoints must be HTTPS origins (HTTP is allowed only on loopback)');
38
+ }
39
+ return url.origin;
40
+ }
41
+ /** Never send a custom environment's bearer to the production gateway implicitly. */
42
+ export function gatewayFor(remote, opts) {
43
+ const prod = remote.replace(/\/$/, '') === 'https://api.dreamlake.ai';
44
+ if (!prod && (!opts.gateway || !opts.origin))
45
+ throw new Error('Custom environments require explicit --gateway and --origin');
46
+ if (opts.gateway && !opts.origin)
47
+ throw new Error('An explicit --gateway requires --origin');
48
+ return { url: safeOrigin(opts.gateway ?? 'https://term.dreamlake.ai'), origin: safeOrigin(opts.origin ?? 'https://dreamlake.ai') };
49
+ }
50
+ export async function requestJson(connection, path, method = 'GET', body, gateway) {
51
+ let response;
52
+ try {
53
+ response = await fetch(`${(gateway?.url ?? connection.remote).replace(/\/+$/, '')}${path}`, {
54
+ method, headers: { Authorization: `Bearer ${connection.token}`, 'Content-Type': 'application/json', ...(gateway ? { Origin: gateway.origin } : {}) },
55
+ body: body === undefined ? undefined : JSON.stringify(body), redirect: 'error', signal: AbortSignal.timeout(30_000),
56
+ });
57
+ }
58
+ catch {
59
+ throw new Error('Terminal service unavailable; inspect the saved session before retrying');
60
+ }
61
+ if (!response.ok) {
62
+ const data = await response.json().catch(() => ({}));
63
+ const managedErrors = ['tmux_missing', 'codex_missing', 'claude_missing', 'config_unavailable', 'cwd_unavailable', 'ownership_unverified', 'pane_identity_changed',
64
+ 'runtime_changed', 'runtime_unavailable', 'runtime_output_invalid', 'direct_session_in_use', 'native_session_active'];
65
+ const code = typeof data.error === 'string' && (/^(?:terminal|session|host)_[a-z_]{1,70}$/.test(data.error) || managedErrors.includes(data.error)) ? `: ${data.error}` : '';
66
+ const guidance = data.error === 'terminal_access_denied' ? '; target discovery requires terminal authorization. To register metadata without a host, use sessions register; do not repeat a saved Note write or change enrollment credentials' : data.error === 'direct_session_in_use' ? '; close the existing direct connection before opening another' : data.error === 'native_session_active' ? '; continue in the existing Codex chat; use sessions reconnect only for an already-running managed terminal; do not retry automatically' : '';
67
+ throw new Error(`Terminal request failed (HTTP ${response.status})${code}${guidance}`);
68
+ }
69
+ try {
70
+ return await response.json();
71
+ }
72
+ catch {
73
+ throw new Error('Terminal service returned invalid JSON');
74
+ }
75
+ }
76
+ export function readSession(value) {
77
+ if (value?.archiveOnly === true && validId(value.id) && value.launch === null && typeof value.name === 'string' && typeof value.codexSessionId === 'string')
78
+ return value;
79
+ if (!value || !validId(value.id) || !validId(value.enrollmentId) || typeof value.targetId !== 'string' ||
80
+ typeof value.name !== 'string' || typeof value.username !== 'string' || typeof value.machineId !== 'string' ||
81
+ typeof value.cwd !== 'string' || typeof value.codexSessionId !== 'string' || typeof value.tmuxSession !== 'string' ||
82
+ value.launch?.kind !== (value.provider ?? 'codex') || (value.launch?.claudeConfigDir ?? null) !== (value.claudeConfigDir ?? null) || value.launch.cwd !== value.cwd || value.launch.codexSessionId !== value.codexSessionId || value.launch.enrollmentId !== value.enrollmentId) {
83
+ throw new Error('Terminal API returned an invalid session descriptor');
84
+ }
85
+ validateSessionInput({ ...value, ...(value.claudeConfigDir === null ? { claudeConfigDir: undefined } : {}) });
86
+ // Do not forward unknown launch fields into an execution request.
87
+ return { ...value, launch: { kind: value.provider ?? 'codex', ...(value.claudeConfigDir === undefined || value.claudeConfigDir === null ? {} : { claudeConfigDir: value.claudeConfigDir }), cwd: value.cwd, codexSessionId: value.codexSessionId, enrollmentId: value.enrollmentId } };
88
+ }
@@ -0,0 +1,6 @@
1
+ /** `dreamlake sessions` control-plane commands: the CLI side of the same
2
+ * contract the built-in agent's plugins use. Each command is a thin wrapper
3
+ * over the TypeScript API (`src/api`), so behaviour, permissions and error
4
+ * codes are identical in both. */
5
+ import type { Command } from 'commander';
6
+ export declare function registerSessionControl(group: Command): void;
@@ -0,0 +1,159 @@
1
+ import { loadPodConfig } from './runner/pod.js';
2
+ import { RunnerJournal } from './runner/journal.js';
3
+ import { homedir } from 'node:os';
4
+ import { join } from 'node:path';
5
+ import { resolveHostNamespace } from '../hosts/inventory.js';
6
+ import { resolveRemote, resolveToken } from '../config.js';
7
+ import { ApiError, createClient, isObjectId } from '../../api/index.js';
8
+ import { VERSION } from '../version.js';
9
+ import { serve } from './runner/serve.js';
10
+ function client() {
11
+ const token = resolveToken();
12
+ if (!token)
13
+ throw new Error('Log in to DreamLake before using session control');
14
+ return createClient({ remote: resolveRemote(), token });
15
+ }
16
+ const emit = (value, json) => console.log(json ? JSON.stringify(value, null, 2) : JSON.stringify(value));
17
+ const guard = async (opts, work) => {
18
+ try {
19
+ await work();
20
+ }
21
+ catch (error) {
22
+ const message = error instanceof ApiError ? `(${error.status}) ${error.code}` : error instanceof Error ? error.message : 'Session control failed';
23
+ if (opts.json)
24
+ console.log(JSON.stringify({ status: 'error', error: message }));
25
+ else
26
+ console.error(message);
27
+ process.exitCode = 1;
28
+ }
29
+ };
30
+ const needId = (value) => { if (!isObjectId(value))
31
+ throw new Error('Use the 24-hex session id from sessions list'); return value; };
32
+ export function registerSessionControl(group) {
33
+ const common = (c) => c.option('--namespace <namespace>', 'personal namespace (default: signed-in personal namespace)').option('--json', 'emit JSON');
34
+ common(group.command('serve').description('run the session runner on this machine: executes start/resume/stop/send/sync/status/subagents commands for your sessions with the Codex/Claude CLIs (tmux when available, headless otherwise)'))
35
+ .option('--allow-repo <path>', 'trusted repository for built-in-origin starts; repeat (default current directory)', (value, all) => [...all, value], []).option('--max-agent-permission <level>', 'maximum built-in-origin startup permission', 'workspace-write').option('--pod-config <file>', 'explicit Docker image, repository allowlist, credentials and resource limits').option('--once', 'handle at most one command, then exit').option('--poll <seconds>', 'long-poll length per claim, 1–25', '25')
36
+ .action(opts => guard(opts, async () => {
37
+ const ns = await resolveHostNamespace(opts.namespace), abort = new AbortController();
38
+ process.once('SIGINT', () => abort.abort());
39
+ process.once('SIGTERM', () => abort.abort());
40
+ const poll = Number(opts.poll);
41
+ if (!Number.isInteger(poll) || poll < 1 || poll > 25)
42
+ throw new Error('--poll must be 1–25 seconds');
43
+ if (!['read-only', 'workspace-write', 'full-access'].includes(opts.maxAgentPermission))
44
+ throw new Error('Invalid --max-agent-permission');
45
+ const result = await serve({ client: client(), namespace: ns, version: VERSION, trustedRepositories: opts.allowRepo.length ? opts.allowRepo : undefined, maxAgentPermission: opts.maxAgentPermission, podConfig: opts.podConfig ? loadPodConfig(opts.podConfig) : undefined, once: !!opts.once, signal: abort.signal, pollSeconds: poll });
46
+ if (opts.json)
47
+ emit(result, true);
48
+ }));
49
+ group.command('runner-journal').option('--directory <path>').option('--acknowledge <command-id>', 'release a quarantine after manually verifying its old process is stopped').option('--reason <text>', 'required audit reason for acknowledgement').description('inspect retained local command intents and receipts; never replays work').action(opts => guard({}, async () => {
50
+ const journal = new RunnerJournal(opts.directory ?? join(homedir(), '.dreamlake', 'session-command-journal'));
51
+ if (opts.acknowledge) {
52
+ if (!opts.reason?.trim())
53
+ throw new Error('--acknowledge requires --reason after verifying the old process');
54
+ journal.update(needId(opts.acknowledge), { state: 'acknowledged', operatorResolution: { reason: opts.reason, at: new Date().toISOString() } });
55
+ }
56
+ emit({ entries: journal.list() }, true);
57
+ }));
58
+ common(group.command('runners').description('list the runner machines registered for your sessions and whether each is online')).action(opts => guard(opts, async () => {
59
+ const ns = await resolveHostNamespace(opts.namespace), runners = await client().sessions(ns).runners.list();
60
+ if (opts.json)
61
+ return emit({ namespace: ns, runners }, true);
62
+ console.log(runners.map(r => `${r.id} ${r.hostname} ${r.unixUser} ${r.online ? 'online' : 'offline'} modes=${r.capabilities.modes.join('/')} seen ${r.lastSeenAt}`).join('\n') || 'No runners registered. Start one with: dreamlake sessions serve');
63
+ }));
64
+ const control = group.command('control').description('durable session commands executed by your runner (dreamlake sessions serve)');
65
+ const waitOption = (c) => c.option('--wait <seconds>', 'wait for the receipt (0 returns the pending command)', '60').option('--runner <id>', 'target an explicit runner id');
66
+ const submit = async (opts, kind, input) => {
67
+ const ns = await resolveHostNamespace(opts.namespace), api = client().sessions(ns);
68
+ const wait = Number(opts.wait);
69
+ if (!Number.isInteger(wait) || wait < 0 || wait > 3600)
70
+ throw new Error('--wait must be 0–3600 seconds');
71
+ const { command } = await api.commands.create(kind, input, opts.runner ? { runnerId: opts.runner } : {});
72
+ const final = wait > 0 ? await api.commands.wait(command.id, wait) : command;
73
+ emit({ namespace: ns, command: final, done: ['completed', 'failed', 'cancelled', 'uncertain'].includes(final.status) }, !!opts.json);
74
+ if (final.status === 'failed' || final.status === 'uncertain')
75
+ process.exitCode = 1;
76
+ };
77
+ waitOption(common(control.command('start').description('start a new Codex/Claude session on a runner, isolated in a repo checkout or a fresh git worktree')))
78
+ .requiredOption('--provider <provider>', 'codex or claude').requiredOption('--repo <path>', 'absolute repository path on the runner machine')
79
+ .option('--isolation <kind>', 'repo, worktree, or pod (requires runner --pod-config)', 'worktree').option('--branch <name>', 'worktree branch (default: dreamlake/<date>-<id>)').option('--base <ref>', 'base ref for a new worktree branch')
80
+ .option('--parent <id>', 'managed parent session; child cannot exceed its permission ceiling').option('--permission <level>', 'read-only, workspace-write or full-access', 'workspace-write').option('--name <name>', 'session name').option('--prompt <text>', 'first prompt').option('--mode <mode>', 'tmux or headless (default: runner decides)')
81
+ .action(opts => guard(opts, () => {
82
+ if (!['codex', 'claude'].includes(opts.provider) || !['repo', 'worktree', 'pod'].includes(opts.isolation) || !['read-only', 'workspace-write', 'full-access'].includes(opts.permission) || !String(opts.repo).startsWith('/'))
83
+ throw new Error('Use --provider codex|claude, --isolation repo|worktree, --permission read-only|workspace-write|full-access and an absolute --repo');
84
+ return submit(opts, 'start', { ...(opts.parent ? { parentSessionId: needId(opts.parent) } : {}), provider: opts.provider, isolation: { kind: opts.isolation, repo: opts.repo, ...(opts.branch ? { branch: opts.branch } : {}), ...(opts.base ? { baseRef: opts.base } : {}) }, permissionLevel: opts.permission,
85
+ ...(opts.name ? { name: opts.name } : {}), ...(opts.prompt ? { prompt: opts.prompt } : {}), ...(opts.mode ? { mode: opts.mode } : {}) });
86
+ }));
87
+ const level = (value) => { if (value !== undefined && !['read-only', 'workspace-write', 'full-access'].includes(String(value)))
88
+ throw new Error('--permission must be read-only, workspace-write or full-access'); return value === undefined ? {} : { permissionLevel: value }; };
89
+ waitOption(common(control.command('resume <id>').description('resume a session on its runner, optionally with a prompt'))).option('--prompt <text>').option('--mode <mode>', 'tmux or headless').option('--permission <level>', 'permission ceiling for the new provider process (default: the level recorded at start)')
90
+ .action((id, opts) => guard(opts, () => submit(opts, 'resume', { sessionId: needId(id), ...(opts.prompt ? { prompt: opts.prompt } : {}), ...(opts.mode ? { mode: opts.mode } : {}), ...level(opts.permission) })));
91
+ waitOption(common(control.command('stop <id>').description('stop the managed process of a session; descriptor and conversation are kept'))).option('--yes', 'confirm stopping the process')
92
+ .action((id, opts) => guard(opts, () => { if (!opts.yes)
93
+ throw new Error('Stopping ends the agent process. Pass --yes to confirm'); return submit(opts, 'stop', { sessionId: needId(id) }); }));
94
+ waitOption(common(control.command('send <id> <text>').description('send a message to a session (typed into tmux, or one headless resumed turn)'))).option('--permission <level>', 'permission ceiling for a headless turn (default: the level recorded at start)')
95
+ .action((id, text, opts) => guard(opts, () => submit(opts, 'send', { sessionId: needId(id), text, ...level(opts.permission) })));
96
+ common(control.command('broadcast <text>').description('send the same message to several sessions')).requiredOption('--session <id...>', 'session ids')
97
+ .action((text, opts) => guard(opts, async () => {
98
+ const ns = await resolveHostNamespace(opts.namespace);
99
+ const ids = opts.session.map(needId);
100
+ emit({ namespace: ns, ...(await client().sessions(ns).commands.broadcast(ids, text)) }, !!opts.json);
101
+ }));
102
+ for (const kind of ['sync', 'status', 'subagents'])
103
+ waitOption(common(control.command(`${kind} <id>`).description({ sync: 'upload the latest transcript of a session from its runner', status: 'ask the runner whether the session process is alive and when it was last active', subagents: 'list the subagents a Claude session spawned, as recorded on the runner' }[kind])))
104
+ .action((id, opts) => guard(opts, () => submit(opts, kind, { sessionId: needId(id) })));
105
+ common(control.command('wait <command-id>').description('wait for a command receipt')).option('--wait <seconds>', 'seconds', '60')
106
+ .action((id, opts) => guard(opts, async () => { const ns = await resolveHostNamespace(opts.namespace); emit({ namespace: ns, command: await client().sessions(ns).commands.wait(needId(id), Number(opts.wait)) }, !!opts.json); }));
107
+ common(control.command('cancel <command-id>').description('cancel pending work or request interruption of running work')).action((id, opts) => guard(opts, async () => { const ns = await resolveHostNamespace(opts.namespace); emit({ namespace: ns, command: await client().sessions(ns).commands.cancel(needId(id)) }, !!opts.json); }));
108
+ common(control.command('list').description('list recent commands and their receipts')).option('--session <id>').option('--status <status>').option('--limit <n>', 'max 100', '25')
109
+ .action(opts => guard(opts, async () => { const ns = await resolveHostNamespace(opts.namespace); emit({ namespace: ns, ...(await client().sessions(ns).commands.list({ ...(opts.session ? { sessionId: needId(opts.session) } : {}), ...(opts.status ? { status: opts.status } : {}), limit: Number(opts.limit) })) }, !!opts.json); }));
110
+ common(group.command('children <id>').description('list managed child sessions; control each child by its stable session ID')).option('--cursor <cursor>').action((id, opts) => guard(opts, async () => { const ns = await resolveHostNamespace(opts.namespace); emit(await client().sessions(ns).list({ parentSessionId: needId(id), cursor: opts.cursor, archived: 'include' }), !!opts.json); }));
111
+ common(group.command('rename <id> <name>').description('rename one of your sessions')).action((id, name, opts) => guard(opts, async () => { const ns = await resolveHostNamespace(opts.namespace); emit({ session: await client().sessions(ns).rename(needId(id), name) }, !!opts.json); }));
112
+ common(group.command('archive <id>').description('hide a session from default listings; conversation and links are kept')).action((id, opts) => guard(opts, async () => { const ns = await resolveHostNamespace(opts.namespace); emit({ session: await client().sessions(ns).archive(needId(id), true) }, !!opts.json); }));
113
+ common(group.command('unarchive <id>').description('return an archived session to default listings')).action((id, opts) => guard(opts, async () => { const ns = await resolveHostNamespace(opts.namespace); emit({ session: await client().sessions(ns).archive(needId(id), false) }, !!opts.json); }));
114
+ group.command('chat <message>').description('one turn with the built-in agent (the same harness the app uses); prints the streamed answer and tool receipts')
115
+ .option('--conversation <id>', 'continue a conversation').option('--control', 'allow session control tools this turn').option('--notes-write', 'allow note appends this turn').option('--page <pathname>', 'page context pathname', '/').option('--json', 'emit one JSON event per line')
116
+ .action((message, opts) => guard(opts, async () => {
117
+ const dl = client();
118
+ let conversation;
119
+ for await (const event of dl.agent.chat({ message, sessionId: opts.conversation, capabilities: { ...(opts.control ? { sessionControl: 1 } : {}), ...(opts.notesWrite ? { notesWrite: 1 } : {}) }, page: { pathname: opts.page, layouts: [] } })) {
120
+ if (opts.json) {
121
+ console.log(JSON.stringify(event));
122
+ if (event.type === 'error')
123
+ process.exitCode = 1;
124
+ continue;
125
+ }
126
+ if (event.type === 'context')
127
+ conversation = event.sessionId;
128
+ else if (event.type === 'delta')
129
+ process.stdout.write(event.text);
130
+ else if (event.type === 'tool')
131
+ process.stderr.write(`\n[tool ${event.name} ${event.status}${event.error ? ' ' + event.error : ''}${event.commandId ? ' command=' + event.commandId : ''}]\n`);
132
+ else if (event.type === 'error') {
133
+ process.stdout.write('\n');
134
+ throw new Error(event.error);
135
+ }
136
+ else if (event.type === 'done')
137
+ process.stdout.write('\n');
138
+ }
139
+ if (!opts.json && conversation)
140
+ console.error(`conversation ${conversation} (continue with --conversation ${conversation})`);
141
+ }));
142
+ group.command('browser-actions <conversation-id>').description('inspect durable browser action receipts, including late acknowledgements').action(id => guard({}, async () => emit(await client().agent.browserActions(needId(id)), true)));
143
+ group.command('agent-projects').description('list projects explicitly granted to your built-in agent').action(() => guard({}, async () => emit(await client().agent.projects(), true)));
144
+ group.command('project-search <project-id> <query>').option('--content').option('--cursor <id>').description('search an explicitly granted project with source locations and pagination').action((id, query, opts) => guard({}, async () => emit(await client().agent.searchProject(needId(id), query, { content: !!opts.content, cursor: opts.cursor }), true)));
145
+ group.command('project-file <project-id> <file-id>').description('read a small text file in an explicitly granted project').action((project, file) => guard({}, async () => emit(await client().agent.readFile(needId(project), needId(file)), true)));
146
+ group.command('tool-calls <conversation-id>').description('durable tool-call receipts of a built-in agent conversation').option('--cursor <id>').option('--limit <n>', 'page size, 1–100').option('--json')
147
+ .action((id, opts) => guard(opts, async () => {
148
+ const limit = opts.limit === undefined ? undefined : Number(opts.limit);
149
+ if (limit !== undefined && (!Number.isInteger(limit) || limit < 1 || limit > 100))
150
+ throw new Error('--limit must be 1–100');
151
+ const page = await client().agent.toolCallsPage(needId(id), { cursor: opts.cursor, limit });
152
+ const calls = page.toolCalls;
153
+ if (opts.json)
154
+ return emit(page, true);
155
+ if (page.nextCursor)
156
+ console.error(`next cursor: ${page.nextCursor}`);
157
+ console.log(calls.map(c => `${c.startedAt} ${c.status.padEnd(9)} ${c.tool}${c.commandId ? ` command=${c.commandId}` : ''}${c.error ? ` ${c.error}` : ''}`).join('\n') || 'No tool calls recorded.');
158
+ }));
159
+ }
@@ -0,0 +1,15 @@
1
+ import type { Command } from 'commander';
2
+ export interface Conversation {
3
+ version: 1;
4
+ provider: 'codex' | 'claude';
5
+ nativeSessionId: string;
6
+ messages: {
7
+ role: 'user' | 'assistant' | 'tool' | 'system';
8
+ text: string;
9
+ timestamp?: string;
10
+ }[];
11
+ }
12
+ /** Explicitly selected export only. Never search home directories or upload environment/configuration. */
13
+ export declare function parseConversation(source: string, provider: 'codex' | 'claude', nativeId: string): Conversation;
14
+ export declare function readConversationFile(path: string, provider: 'codex' | 'claude', nativeId: string): Promise<Conversation>;
15
+ export declare function registerSessionConversation(group: Command): void;