@dreamlake/dreamlake-cli 0.88.0 → 0.89.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (535) hide show
  1. package/dist/api/access.d.ts +83 -0
  2. package/dist/api/access.js +77 -0
  3. package/dist/api/agent.d.ts +156 -0
  4. package/dist/api/agent.js +111 -0
  5. package/dist/api/browser.d.ts +90 -0
  6. package/dist/api/browser.js +102 -0
  7. package/dist/api/client.d.ts +53 -0
  8. package/dist/api/client.js +102 -0
  9. package/dist/api/common.d.ts +28 -0
  10. package/dist/api/common.js +16 -0
  11. package/dist/api/content.d.ts +195 -0
  12. package/dist/api/content.js +147 -0
  13. package/dist/api/execution.d.ts +84 -0
  14. package/dist/api/execution.js +73 -0
  15. package/dist/api/http.d.ts +19 -0
  16. package/dist/api/http.js +66 -0
  17. package/dist/api/index.d.ts +2330 -0
  18. package/dist/api/index.js +114 -0
  19. package/dist/api/infra.d.ts +2 -0
  20. package/dist/api/infra.js +2 -0
  21. package/dist/api/jobs.d.ts +2 -0
  22. package/dist/api/jobs.js +2 -0
  23. package/dist/api/layout.d.ts +2 -0
  24. package/dist/api/layout.js +2 -0
  25. package/dist/api/library-edit.d.ts +3 -0
  26. package/dist/api/library-edit.js +3 -0
  27. package/dist/api/library-manifest.d.ts +2 -0
  28. package/dist/api/library-manifest.js +2 -0
  29. package/dist/api/note-character-plan.d.ts +2 -0
  30. package/dist/api/note-character-plan.js +2 -0
  31. package/dist/api/note-editing.d.ts +2 -0
  32. package/dist/api/note-editing.js +2 -0
  33. package/dist/api/note-edits.d.ts +21 -0
  34. package/dist/api/note-edits.js +10 -0
  35. package/dist/api/note-events.d.ts +5 -0
  36. package/dist/api/note-events.js +11 -0
  37. package/dist/api/note-files.d.ts +75 -0
  38. package/dist/api/note-files.js +65 -0
  39. package/dist/api/note-html-read.d.ts +2 -0
  40. package/dist/api/note-html-read.js +2 -0
  41. package/dist/api/note-html.d.ts +2 -0
  42. package/dist/api/note-html.js +2 -0
  43. package/dist/api/note-toc.d.ts +2 -0
  44. package/dist/api/note-toc.js +2 -0
  45. package/dist/api/notes.d.ts +304 -0
  46. package/dist/api/notes.js +181 -0
  47. package/dist/api/open-resources.d.ts +27 -0
  48. package/dist/api/open-resources.js +102 -0
  49. package/dist/api/ownership.d.ts +12 -0
  50. package/dist/api/ownership.js +24 -0
  51. package/dist/api/platform.d.ts +83 -0
  52. package/dist/api/platform.js +56 -0
  53. package/dist/api/presigned-transfer.d.ts +2 -0
  54. package/dist/api/presigned-transfer.js +2 -0
  55. package/dist/api/registered-runs.d.ts +48 -0
  56. package/dist/api/registered-runs.js +33 -0
  57. package/dist/api/sessions.d.ts +299 -0
  58. package/dist/api/sessions.js +105 -0
  59. package/dist/api/storage.d.ts +46 -0
  60. package/dist/api/storage.js +34 -0
  61. package/dist/api/streams.d.ts +18 -0
  62. package/dist/api/streams.js +70 -0
  63. package/dist/api/vault.d.ts +93 -0
  64. package/dist/api/vault.js +79 -0
  65. package/dist/api/workspace.d.ts +180 -0
  66. package/dist/api/workspace.js +146 -0
  67. package/dist/cli/agent-identity.d.ts +4 -0
  68. package/dist/cli/agent-identity.js +21 -0
  69. package/dist/cli/agents/identity.d.ts +50 -0
  70. package/dist/cli/agents/identity.js +105 -0
  71. package/dist/cli/agents/index.d.ts +31 -0
  72. package/dist/cli/agents/index.js +580 -0
  73. package/dist/cli/agents/manage.d.ts +43 -0
  74. package/dist/cli/agents/manage.js +376 -0
  75. package/dist/cli/agents/spec.d.ts +104 -0
  76. package/dist/cli/agents/spec.js +280 -0
  77. package/dist/cli/agents/web.d.ts +7 -0
  78. package/dist/cli/agents/web.js +109 -0
  79. package/dist/cli/artifact/incremental.d.ts +21 -0
  80. package/dist/cli/artifact/incremental.js +80 -0
  81. package/dist/cli/artifact/index.d.ts +52 -0
  82. package/dist/cli/artifact/index.js +405 -0
  83. package/dist/cli/artifact/meta.d.ts +69 -0
  84. package/dist/cli/artifact/meta.js +189 -0
  85. package/dist/cli/auth/commands.d.ts +29 -0
  86. package/dist/cli/auth/commands.js +327 -0
  87. package/dist/cli/auth/constants.d.ts +13 -0
  88. package/dist/cli/auth/constants.js +18 -0
  89. package/dist/cli/auth/credentials.d.ts +37 -0
  90. package/dist/cli/auth/credentials.js +155 -0
  91. package/dist/cli/auth/device-flow.d.ts +32 -0
  92. package/dist/cli/auth/device-flow.js +154 -0
  93. package/dist/cli/auth/device-secret.d.ts +6 -0
  94. package/dist/cli/auth/device-secret.js +26 -0
  95. package/dist/cli/auth/machine.d.ts +15 -0
  96. package/dist/cli/auth/machine.js +126 -0
  97. package/dist/cli/auth/materialized.d.ts +32 -0
  98. package/dist/cli/auth/materialized.js +102 -0
  99. package/dist/cli/auth/migrate.d.ts +10 -0
  100. package/dist/cli/auth/migrate.js +75 -0
  101. package/dist/cli/client.d.ts +102 -0
  102. package/dist/cli/client.js +206 -0
  103. package/dist/cli/collection-list.d.ts +3 -0
  104. package/dist/cli/collection-list.js +25 -0
  105. package/dist/cli/compat/ctx.d.ts +26 -0
  106. package/dist/cli/compat/ctx.js +76 -0
  107. package/dist/cli/compat/dreamdb-wasm-embedded.d.ts +2 -0
  108. package/dist/cli/compat/dreamdb-wasm-embedded.js +8 -0
  109. package/dist/cli/compat/dreamdb-wasm.d.ts +1 -0
  110. package/dist/cli/compat/dreamdb-wasm.js +26 -0
  111. package/dist/cli/compat/dreamdb.d.ts +112 -0
  112. package/dist/cli/compat/dreamdb.js +219 -0
  113. package/dist/cli/compat/flags.d.ts +2 -0
  114. package/dist/cli/compat/flags.js +13 -0
  115. package/dist/cli/compat/http.d.ts +23 -0
  116. package/dist/cli/compat/http.js +137 -0
  117. package/dist/cli/compat/presignedTransfer.d.ts +139 -0
  118. package/dist/cli/compat/presignedTransfer.js +580 -0
  119. package/dist/cli/compat/s3-backend.d.ts +73 -0
  120. package/dist/cli/compat/s3-backend.js +132 -0
  121. package/dist/cli/config.d.ts +22 -0
  122. package/dist/cli/config.js +96 -0
  123. package/dist/cli/connection/dto.d.ts +159 -0
  124. package/dist/cli/connection/dto.js +497 -0
  125. package/dist/cli/connection/index.d.ts +50 -0
  126. package/dist/cli/connection/index.js +413 -0
  127. package/dist/cli/connection/oauth.d.ts +23 -0
  128. package/dist/cli/connection/oauth.js +290 -0
  129. package/dist/cli/connection/write.d.ts +47 -0
  130. package/dist/cli/connection/write.js +573 -0
  131. package/dist/cli/create/index.d.ts +19 -0
  132. package/dist/cli/create/index.js +209 -0
  133. package/dist/cli/declare/index.d.ts +29 -0
  134. package/dist/cli/declare/index.js +304 -0
  135. package/dist/cli/delete/index.d.ts +18 -0
  136. package/dist/cli/delete/index.js +232 -0
  137. package/dist/cli/download/index.d.ts +9 -0
  138. package/dist/cli/download/index.js +128 -0
  139. package/dist/cli/env/compose.d.ts +88 -0
  140. package/dist/cli/env/compose.js +402 -0
  141. package/dist/cli/env/index.d.ts +176 -0
  142. package/dist/cli/env/index.js +1011 -0
  143. package/dist/cli/experiments/index.d.ts +11 -0
  144. package/dist/cli/experiments/index.js +168 -0
  145. package/dist/cli/glob.d.ts +1 -0
  146. package/dist/cli/glob.js +45 -0
  147. package/dist/cli/graphql-helpers.d.ts +23 -0
  148. package/dist/cli/graphql-helpers.js +42 -0
  149. package/dist/cli/graphql.d.ts +10 -0
  150. package/dist/cli/graphql.js +47 -0
  151. package/dist/cli/help-examples.generated.d.ts +1 -0
  152. package/dist/cli/help-examples.generated.js +192 -0
  153. package/dist/cli/helpers.d.ts +8 -0
  154. package/dist/cli/helpers.js +106 -0
  155. package/dist/cli/hosts/api.d.ts +29 -0
  156. package/dist/cli/hosts/api.js +54 -0
  157. package/dist/cli/hosts/bootstrap-source.d.ts +1 -0
  158. package/dist/cli/hosts/bootstrap-source.js +2 -0
  159. package/dist/cli/hosts/catalog.d.ts +26 -0
  160. package/dist/cli/hosts/catalog.js +55 -0
  161. package/dist/cli/hosts/config.d.ts +45 -0
  162. package/dist/cli/hosts/config.js +179 -0
  163. package/dist/cli/hosts/credentials.d.ts +19 -0
  164. package/dist/cli/hosts/credentials.js +173 -0
  165. package/dist/cli/hosts/enroll.d.ts +17 -0
  166. package/dist/cli/hosts/enroll.js +109 -0
  167. package/dist/cli/hosts/enrollments.d.ts +25 -0
  168. package/dist/cli/hosts/enrollments.js +54 -0
  169. package/dist/cli/hosts/index.d.ts +6 -0
  170. package/dist/cli/hosts/index.js +279 -0
  171. package/dist/cli/hosts/inventory.d.ts +40 -0
  172. package/dist/cli/hosts/inventory.js +91 -0
  173. package/dist/cli/hosts/lifecycle.d.ts +15 -0
  174. package/dist/cli/hosts/lifecycle.js +108 -0
  175. package/dist/cli/hosts/metrics-source.d.ts +12 -0
  176. package/dist/cli/hosts/metrics-source.js +89 -0
  177. package/dist/cli/hosts/observations.d.ts +39 -0
  178. package/dist/cli/hosts/observations.js +102 -0
  179. package/dist/cli/hosts/remote.d.ts +5 -0
  180. package/dist/cli/hosts/remote.js +66 -0
  181. package/dist/cli/hosts/ssh.d.ts +63 -0
  182. package/dist/cli/hosts/ssh.js +276 -0
  183. package/dist/cli/index.d.ts +1 -0
  184. package/dist/cli/index.js +288 -0
  185. package/dist/cli/infra/api.d.ts +95 -0
  186. package/dist/cli/infra/api.js +291 -0
  187. package/dist/cli/infra/index.d.ts +5 -0
  188. package/dist/cli/infra/index.js +102 -0
  189. package/dist/cli/infra/move.d.ts +15 -0
  190. package/dist/cli/infra/move.js +123 -0
  191. package/dist/cli/infra/transfer.d.ts +15 -0
  192. package/dist/cli/infra/transfer.js +280 -0
  193. package/dist/cli/jobs/api.d.ts +69 -0
  194. package/dist/cli/jobs/api.js +121 -0
  195. package/dist/cli/jobs/index.d.ts +5 -0
  196. package/dist/cli/jobs/index.js +140 -0
  197. package/dist/cli/lakeshore/index.d.ts +98 -0
  198. package/dist/cli/lakeshore/index.js +502 -0
  199. package/dist/cli/launch/index.d.ts +43 -0
  200. package/dist/cli/launch/index.js +270 -0
  201. package/dist/cli/layout/index.d.ts +2 -0
  202. package/dist/cli/layout/index.js +44 -0
  203. package/dist/cli/layout/transport.d.ts +12 -0
  204. package/dist/cli/layout/transport.js +70 -0
  205. package/dist/cli/library/add.d.ts +60 -0
  206. package/dist/cli/library/add.js +348 -0
  207. package/dist/cli/library/cache.d.ts +26 -0
  208. package/dist/cli/library/cache.js +88 -0
  209. package/dist/cli/library/config.d.ts +75 -0
  210. package/dist/cli/library/config.js +198 -0
  211. package/dist/cli/library/digest.d.ts +5 -0
  212. package/dist/cli/library/digest.js +19 -0
  213. package/dist/cli/library/discover.d.ts +87 -0
  214. package/dist/cli/library/discover.js +534 -0
  215. package/dist/cli/library/freshness.d.ts +35 -0
  216. package/dist/cli/library/freshness.js +109 -0
  217. package/dist/cli/library/generation.d.ts +35 -0
  218. package/dist/cli/library/generation.js +211 -0
  219. package/dist/cli/library/index.d.ts +2 -0
  220. package/dist/cli/library/index.js +36 -0
  221. package/dist/cli/library/info.d.ts +69 -0
  222. package/dist/cli/library/info.js +311 -0
  223. package/dist/cli/library/list.d.ts +33 -0
  224. package/dist/cli/library/list.js +86 -0
  225. package/dist/cli/library/manifest.d.ts +81 -0
  226. package/dist/cli/library/manifest.js +200 -0
  227. package/dist/cli/library/manifestCache.d.ts +45 -0
  228. package/dist/cli/library/manifestCache.js +169 -0
  229. package/dist/cli/library/pull.d.ts +30 -0
  230. package/dist/cli/library/pull.js +438 -0
  231. package/dist/cli/library/push.d.ts +72 -0
  232. package/dist/cli/library/push.js +642 -0
  233. package/dist/cli/library/rm.d.ts +31 -0
  234. package/dist/cli/library/rm.js +200 -0
  235. package/dist/cli/library/search.d.ts +18 -0
  236. package/dist/cli/library/search.js +181 -0
  237. package/dist/cli/library/stat.d.ts +15 -0
  238. package/dist/cli/library/stat.js +127 -0
  239. package/dist/cli/library/tools.d.ts +104 -0
  240. package/dist/cli/library/tools.js +163 -0
  241. package/dist/cli/library/wire.d.ts +47 -0
  242. package/dist/cli/library/wire.js +120 -0
  243. package/dist/cli/list/index.d.ts +26 -0
  244. package/dist/cli/list/index.js +256 -0
  245. package/dist/cli/notes/character-plan.d.ts +22 -0
  246. package/dist/cli/notes/character-plan.js +232 -0
  247. package/dist/cli/notes/document.d.ts +73 -0
  248. package/dist/cli/notes/document.js +306 -0
  249. package/dist/cli/notes/edit-commands.d.ts +106 -0
  250. package/dist/cli/notes/edit-commands.js +623 -0
  251. package/dist/cli/notes/editing.d.ts +81 -0
  252. package/dist/cli/notes/editing.js +305 -0
  253. package/dist/cli/notes/events.d.ts +36 -0
  254. package/dist/cli/notes/events.js +54 -0
  255. package/dist/cli/notes/files-commands.d.ts +120 -0
  256. package/dist/cli/notes/files-commands.js +554 -0
  257. package/dist/cli/notes/html-read.d.ts +9 -0
  258. package/dist/cli/notes/html-read.js +90 -0
  259. package/dist/cli/notes/html.d.ts +73 -0
  260. package/dist/cli/notes/html.js +381 -0
  261. package/dist/cli/notes/index.d.ts +123 -0
  262. package/dist/cli/notes/index.js +1303 -0
  263. package/dist/cli/notes/linger.d.ts +59 -0
  264. package/dist/cli/notes/linger.js +339 -0
  265. package/dist/cli/notes/media-commands.d.ts +5 -0
  266. package/dist/cli/notes/media-commands.js +51 -0
  267. package/dist/cli/notes/move-command.d.ts +83 -0
  268. package/dist/cli/notes/move-command.js +259 -0
  269. package/dist/cli/notes/rm-command.d.ts +22 -0
  270. package/dist/cli/notes/rm-command.js +110 -0
  271. package/dist/cli/notes/select-command.d.ts +12 -0
  272. package/dist/cli/notes/select-command.js +84 -0
  273. package/dist/cli/notes/suggest-diff.d.ts +56 -0
  274. package/dist/cli/notes/suggest-diff.js +311 -0
  275. package/dist/cli/notes/toc.d.ts +38 -0
  276. package/dist/cli/notes/toc.js +144 -0
  277. package/dist/cli/notes/transfer-command.d.ts +6 -0
  278. package/dist/cli/notes/transfer-command.js +9 -0
  279. package/dist/cli/notes/version-commands.d.ts +19 -0
  280. package/dist/cli/notes/version-commands.js +178 -0
  281. package/dist/cli/nymph/index.d.ts +74 -0
  282. package/dist/cli/nymph/index.js +349 -0
  283. package/dist/cli/org/index.d.ts +34 -0
  284. package/dist/cli/org/index.js +341 -0
  285. package/dist/cli/ownership/index.d.ts +12 -0
  286. package/dist/cli/ownership/index.js +122 -0
  287. package/dist/cli/ownership/metadata-transfer.d.ts +20 -0
  288. package/dist/cli/ownership/metadata-transfer.js +159 -0
  289. package/dist/cli/page/index.d.ts +58 -0
  290. package/dist/cli/page/index.js +387 -0
  291. package/dist/cli/pipeline/index.d.ts +69 -0
  292. package/dist/cli/pipeline/index.js +604 -0
  293. package/dist/cli/progress.d.ts +60 -0
  294. package/dist/cli/progress.js +276 -0
  295. package/dist/cli/project/attachments.d.ts +10 -0
  296. package/dist/cli/project/attachments.js +39 -0
  297. package/dist/cli/project/grants.d.ts +10 -0
  298. package/dist/cli/project/grants.js +39 -0
  299. package/dist/cli/project/index.d.ts +8 -0
  300. package/dist/cli/project/index.js +92 -0
  301. package/dist/cli/project/move.d.ts +57 -0
  302. package/dist/cli/project/move.js +242 -0
  303. package/dist/cli/project/output.d.ts +2 -0
  304. package/dist/cli/project/output.js +29 -0
  305. package/dist/cli/project/stream.d.ts +55 -0
  306. package/dist/cli/project/stream.js +207 -0
  307. package/dist/cli/project/transfer-preview.d.ts +8 -0
  308. package/dist/cli/project/transfer-preview.js +10 -0
  309. package/dist/cli/prompt.d.ts +1 -0
  310. package/dist/cli/prompt.js +17 -0
  311. package/dist/cli/provider/dreamdir.d.ts +52 -0
  312. package/dist/cli/provider/dreamdir.js +138 -0
  313. package/dist/cli/provider/index.d.ts +4 -0
  314. package/dist/cli/provider/index.js +419 -0
  315. package/dist/cli/provider/jump-worker.d.ts +9 -0
  316. package/dist/cli/provider/jump-worker.js +141 -0
  317. package/dist/cli/provider/lifecycle.d.ts +149 -0
  318. package/dist/cli/provider/lifecycle.js +1390 -0
  319. package/dist/cli/provider/machine.d.ts +17 -0
  320. package/dist/cli/provider/machine.js +116 -0
  321. package/dist/cli/provider/ssh.d.ts +105 -0
  322. package/dist/cli/provider/ssh.js +305 -0
  323. package/dist/cli/provider/terraform.d.ts +140 -0
  324. package/dist/cli/provider/terraform.js +288 -0
  325. package/dist/cli/providers/index.d.ts +18 -0
  326. package/dist/cli/providers/index.js +422 -0
  327. package/dist/cli/python.d.ts +61 -0
  328. package/dist/cli/python.js +255 -0
  329. package/dist/cli/queues/index.d.ts +33 -0
  330. package/dist/cli/queues/index.js +248 -0
  331. package/dist/cli/queues/slurm.d.ts +10 -0
  332. package/dist/cli/queues/slurm.js +134 -0
  333. package/dist/cli/resources.d.ts +72 -0
  334. package/dist/cli/resources.js +137 -0
  335. package/dist/cli/run/index.d.ts +15 -0
  336. package/dist/cli/run/index.js +163 -0
  337. package/dist/cli/run/input.d.ts +34 -0
  338. package/dist/cli/run/input.js +135 -0
  339. package/dist/cli/run/recovery.d.ts +2 -0
  340. package/dist/cli/run/recovery.js +18 -0
  341. package/dist/cli/run/setup.d.ts +3 -0
  342. package/dist/cli/run/setup.js +62 -0
  343. package/dist/cli/runconfig/index.d.ts +12 -0
  344. package/dist/cli/runconfig/index.js +130 -0
  345. package/dist/cli/runnable/index.d.ts +35 -0
  346. package/dist/cli/runnable/index.js +575 -0
  347. package/dist/cli/runnable/path.d.ts +115 -0
  348. package/dist/cli/runnable/path.js +288 -0
  349. package/dist/cli/runnable/run.d.ts +91 -0
  350. package/dist/cli/runnable/run.js +239 -0
  351. package/dist/cli/runnable/upload.d.ts +43 -0
  352. package/dist/cli/runnable/upload.js +342 -0
  353. package/dist/cli/runnable/worker.d.ts +1 -0
  354. package/dist/cli/runnable/worker.js +44 -0
  355. package/dist/cli/schemas/workflow-spec.schema.json +335 -0
  356. package/dist/cli/self-update/index.d.ts +5 -0
  357. package/dist/cli/self-update/index.js +107 -0
  358. package/dist/cli/self-update/install.d.ts +60 -0
  359. package/dist/cli/self-update/install.js +428 -0
  360. package/dist/cli/self-update/paths.d.ts +40 -0
  361. package/dist/cli/self-update/paths.js +87 -0
  362. package/dist/cli/self-update/releases.d.ts +41 -0
  363. package/dist/cli/self-update/releases.js +153 -0
  364. package/dist/cli/self-update/settings.d.ts +16 -0
  365. package/dist/cli/self-update/settings.js +68 -0
  366. package/dist/cli/self-update/update.d.ts +18 -0
  367. package/dist/cli/self-update/update.js +241 -0
  368. package/dist/cli/service-accounts/index.d.ts +3 -0
  369. package/dist/cli/service-accounts/index.js +149 -0
  370. package/dist/cli/session-affiliation.d.ts +26 -0
  371. package/dist/cli/session-affiliation.js +135 -0
  372. package/dist/cli/sessions/affiliation.d.ts +8 -0
  373. package/dist/cli/sessions/affiliation.js +66 -0
  374. package/dist/cli/sessions/api.d.ts +55 -0
  375. package/dist/cli/sessions/api.js +88 -0
  376. package/dist/cli/sessions/control.d.ts +6 -0
  377. package/dist/cli/sessions/control.js +159 -0
  378. package/dist/cli/sessions/conversation.d.ts +15 -0
  379. package/dist/cli/sessions/conversation.js +118 -0
  380. package/dist/cli/sessions/index.d.ts +2 -0
  381. package/dist/cli/sessions/index.js +209 -0
  382. package/dist/cli/sessions/managed.d.ts +39 -0
  383. package/dist/cli/sessions/managed.js +63 -0
  384. package/dist/cli/sessions/redaction.d.ts +2 -0
  385. package/dist/cli/sessions/redaction.js +11 -0
  386. package/dist/cli/sessions/runner/exec.d.ts +108 -0
  387. package/dist/cli/sessions/runner/exec.js +335 -0
  388. package/dist/cli/sessions/runner/journal.d.ts +26 -0
  389. package/dist/cli/sessions/runner/journal.js +49 -0
  390. package/dist/cli/sessions/runner/native.d.ts +48 -0
  391. package/dist/cli/sessions/runner/native.js +170 -0
  392. package/dist/cli/sessions/runner/pod.d.ts +30 -0
  393. package/dist/cli/sessions/runner/pod.js +129 -0
  394. package/dist/cli/sessions/runner/serve.d.ts +85 -0
  395. package/dist/cli/sessions/runner/serve.js +558 -0
  396. package/dist/cli/sessions/sync.d.ts +47 -0
  397. package/dist/cli/sessions/sync.js +80 -0
  398. package/dist/cli/sessions/transport.d.ts +14 -0
  399. package/dist/cli/sessions/transport.js +116 -0
  400. package/dist/cli/share.d.ts +15 -0
  401. package/dist/cli/share.js +139 -0
  402. package/dist/cli/skill/catalog.d.ts +141 -0
  403. package/dist/cli/skill/catalog.js +442 -0
  404. package/dist/cli/skill/files.d.ts +89 -0
  405. package/dist/cli/skill/files.js +264 -0
  406. package/dist/cli/skill/index.d.ts +268 -0
  407. package/dist/cli/skill/index.js +1216 -0
  408. package/dist/cli/skill/manifest.d.ts +30 -0
  409. package/dist/cli/skill/manifest.js +101 -0
  410. package/dist/cli/skill/prefs.d.ts +9 -0
  411. package/dist/cli/skill/prefs.js +32 -0
  412. package/dist/cli/skill/reminders.d.ts +15 -0
  413. package/dist/cli/skill/reminders.js +105 -0
  414. package/dist/cli/skill/tar.d.ts +17 -0
  415. package/dist/cli/skill/tar.js +195 -0
  416. package/dist/cli/snapshot/index.d.ts +24 -0
  417. package/dist/cli/snapshot/index.js +146 -0
  418. package/dist/cli/source/access.d.ts +45 -0
  419. package/dist/cli/source/access.js +563 -0
  420. package/dist/cli/source/control.d.ts +103 -0
  421. package/dist/cli/source/control.js +546 -0
  422. package/dist/cli/source/delete.d.ts +89 -0
  423. package/dist/cli/source/delete.js +463 -0
  424. package/dist/cli/source/index.d.ts +288 -0
  425. package/dist/cli/source/index.js +1348 -0
  426. package/dist/cli/source/share.d.ts +65 -0
  427. package/dist/cli/source/share.js +530 -0
  428. package/dist/cli/source/upload.d.ts +62 -0
  429. package/dist/cli/source/upload.js +258 -0
  430. package/dist/cli/source/write.d.ts +77 -0
  431. package/dist/cli/source/write.js +335 -0
  432. package/dist/cli/spawn.d.ts +28 -0
  433. package/dist/cli/spawn.js +81 -0
  434. package/dist/cli/target.d.ts +22 -0
  435. package/dist/cli/target.js +85 -0
  436. package/dist/cli/tasks/index.d.ts +38 -0
  437. package/dist/cli/tasks/index.js +365 -0
  438. package/dist/cli/team/index.d.ts +37 -0
  439. package/dist/cli/team/index.js +407 -0
  440. package/dist/cli/telemetry.d.ts +23 -0
  441. package/dist/cli/telemetry.js +262 -0
  442. package/dist/cli/telemetryJournal.d.ts +26 -0
  443. package/dist/cli/telemetryJournal.js +104 -0
  444. package/dist/cli/update/index.d.ts +21 -0
  445. package/dist/cli/update/index.js +284 -0
  446. package/dist/cli/upload/index.d.ts +11 -0
  447. package/dist/cli/upload/index.js +261 -0
  448. package/dist/cli/upload/kinds.d.ts +10 -0
  449. package/dist/cli/upload/kinds.js +85 -0
  450. package/dist/cli/upload/multipart.d.ts +21 -0
  451. package/dist/cli/upload/multipart.js +248 -0
  452. package/dist/cli/vault/affected-preview.d.ts +15 -0
  453. package/dist/cli/vault/affected-preview.js +38 -0
  454. package/dist/cli/vault/cloud.d.ts +55 -0
  455. package/dist/cli/vault/cloud.js +287 -0
  456. package/dist/cli/vault/format.d.ts +18 -0
  457. package/dist/cli/vault/format.js +104 -0
  458. package/dist/cli/vault/hostCredentials.d.ts +21 -0
  459. package/dist/cli/vault/hostCredentials.js +71 -0
  460. package/dist/cli/vault/hostSupersessions.d.ts +18 -0
  461. package/dist/cli/vault/hostSupersessions.js +68 -0
  462. package/dist/cli/vault/import.d.ts +3 -0
  463. package/dist/cli/vault/import.js +79 -0
  464. package/dist/cli/vault/index.d.ts +14 -0
  465. package/dist/cli/vault/index.js +225 -0
  466. package/dist/cli/vault/keys.d.ts +5 -0
  467. package/dist/cli/vault/keys.js +165 -0
  468. package/dist/cli/vault/kms.d.ts +6 -0
  469. package/dist/cli/vault/kms.js +169 -0
  470. package/dist/cli/vault/list.d.ts +13 -0
  471. package/dist/cli/vault/list.js +60 -0
  472. package/dist/cli/vault/listView.d.ts +21 -0
  473. package/dist/cli/vault/listView.js +123 -0
  474. package/dist/cli/vault/managementMetadata.d.ts +2 -0
  475. package/dist/cli/vault/managementMetadata.js +23 -0
  476. package/dist/cli/vault/mutations.d.ts +8 -0
  477. package/dist/cli/vault/mutations.js +151 -0
  478. package/dist/cli/vault/otp.d.ts +6 -0
  479. package/dist/cli/vault/otp.js +62 -0
  480. package/dist/cli/vault/otpIntent.d.ts +23 -0
  481. package/dist/cli/vault/otpIntent.js +76 -0
  482. package/dist/cli/vault/passImport.d.ts +25 -0
  483. package/dist/cli/vault/passImport.js +129 -0
  484. package/dist/cli/vault/passOtp.d.ts +51 -0
  485. package/dist/cli/vault/passOtp.js +101 -0
  486. package/dist/cli/vault/passStore.d.ts +26 -0
  487. package/dist/cli/vault/passStore.js +134 -0
  488. package/dist/cli/vault/passwordCommand.d.ts +39 -0
  489. package/dist/cli/vault/passwordCommand.js +101 -0
  490. package/dist/cli/vault/passwordProbe.d.ts +27 -0
  491. package/dist/cli/vault/passwordProbe.js +282 -0
  492. package/dist/cli/vault/passwordRotation.d.ts +9 -0
  493. package/dist/cli/vault/passwordRotation.js +273 -0
  494. package/dist/cli/vault/rotationApi.d.ts +13 -0
  495. package/dist/cli/vault/rotationApi.js +58 -0
  496. package/dist/cli/vault/rotationCommand.d.ts +2 -0
  497. package/dist/cli/vault/rotationCommand.js +75 -0
  498. package/dist/cli/vault/rotationEngine.d.ts +19 -0
  499. package/dist/cli/vault/rotationEngine.js +65 -0
  500. package/dist/cli/vault/rotationHelperSource.d.ts +2 -0
  501. package/dist/cli/vault/rotationHelperSource.js +3 -0
  502. package/dist/cli/vault/rotationInput.d.ts +11 -0
  503. package/dist/cli/vault/rotationInput.js +48 -0
  504. package/dist/cli/vault/rotationJournal.d.ts +16 -0
  505. package/dist/cli/vault/rotationJournal.js +183 -0
  506. package/dist/cli/vault/rotationKeys.d.ts +4 -0
  507. package/dist/cli/vault/rotationKeys.js +48 -0
  508. package/dist/cli/vault/rotationPrepare.d.ts +17 -0
  509. package/dist/cli/vault/rotationPrepare.js +108 -0
  510. package/dist/cli/vault/rotationRemote.d.ts +33 -0
  511. package/dist/cli/vault/rotationRemote.js +156 -0
  512. package/dist/cli/vault/rotationState.d.ts +42 -0
  513. package/dist/cli/vault/rotationState.js +115 -0
  514. package/dist/cli/vault/rotationTransport.d.ts +18 -0
  515. package/dist/cli/vault/rotationTransport.js +71 -0
  516. package/dist/cli/vault/sshSource.d.ts +18 -0
  517. package/dist/cli/vault/sshSource.js +196 -0
  518. package/dist/cli/vault/sshSync.d.ts +17 -0
  519. package/dist/cli/vault/sshSync.js +224 -0
  520. package/dist/cli/vault/sshTransfer.d.ts +22 -0
  521. package/dist/cli/vault/sshTransfer.js +140 -0
  522. package/dist/cli/vault/terraformState.d.ts +66 -0
  523. package/dist/cli/vault/terraformState.js +252 -0
  524. package/dist/cli/vault/terraformStateCommand.d.ts +2 -0
  525. package/dist/cli/vault/terraformStateCommand.js +61 -0
  526. package/dist/cli/vault/tree.d.ts +43 -0
  527. package/dist/cli/vault/tree.js +292 -0
  528. package/dist/cli/version.d.ts +1 -0
  529. package/dist/cli/version.js +9 -0
  530. package/dist/cli/workflow/index.d.ts +76 -0
  531. package/dist/cli/workflow/index.js +826 -0
  532. package/dist/cli/workflow/validate.d.ts +19 -0
  533. package/dist/cli/workflow/validate.js +353 -0
  534. package/dist/package.json +1 -0
  535. package/package.json +28 -10
@@ -0,0 +1,376 @@
1
+ import { collectionList } from "../collection-list.js";
2
+ import { createHash } from "node:crypto";
3
+ import { editor, select } from "@inquirer/prompts";
4
+ import YAML from "yaml";
5
+ import { requestJson } from "../client.js";
6
+ import { resolveNamespace, resolveRemote, resolveToken } from "../config.js";
7
+ import { emitJson, fail, renderTable } from "../helpers.js";
8
+ import { ARGUMENT_TYPES, PERMISSION_MODES, checkPermissionKeys, checkPlaceholders, scanForCredentials, validateRules, } from "./spec.js";
9
+ const seg = encodeURIComponent;
10
+ export const terminalText = (s) => s.replace(/[\x00-\x1f\x7f-\x9f]/g, " ");
11
+ const base = (c) => `/namespaces/${seg(c.ns)}/runnables`;
12
+ export async function agentContext(namespace) {
13
+ const token = resolveToken();
14
+ if (!token)
15
+ throw new Error("not authenticated — run 'dreamlake login' first");
16
+ const remote = resolveRemote();
17
+ const ns = await resolveNamespace(namespace, { token, remote });
18
+ if (!ns)
19
+ throw new Error("could not resolve namespace");
20
+ return { remote, token, ns };
21
+ }
22
+ export function projectSlugs(value) {
23
+ if (value === undefined)
24
+ return [];
25
+ if (!Array.isArray(value) ||
26
+ value.some((v) => typeof v !== "string" || !/^[a-zA-Z0-9][a-zA-Z0-9_-]*$/.test(v)))
27
+ throw new Error("projects must be a YAML list of project slugs in the agent namespace");
28
+ return [...new Set(value)];
29
+ }
30
+ export function validateContext(value) {
31
+ if (value === undefined)
32
+ return;
33
+ if (!Array.isArray(value))
34
+ throw new Error("context must be a list");
35
+ for (const item of value) {
36
+ if (!item || typeof item !== "object" || Array.isArray(item))
37
+ throw new Error("context entries must be mappings");
38
+ const key = { repo: "repo", source: "source", bindr: "bindr" }[item.kind];
39
+ if (!key || typeof item[key] !== "string" || !item[key].trim())
40
+ throw new Error("context needs kind and a repo, source, or bindr reference");
41
+ const allowed = [
42
+ "kind",
43
+ key,
44
+ "path",
45
+ "mode",
46
+ ...(item.kind === "repo"
47
+ ? ["snapshot"]
48
+ : item.kind === "source"
49
+ ? ["revision"]
50
+ : []),
51
+ ];
52
+ if (Object.keys(item).some((k) => !allowed.includes(k)))
53
+ throw new Error("unknown context field");
54
+ if (item.mode !== undefined && !["ro", "rw"].includes(item.mode))
55
+ throw new Error("context mode must be ro or rw");
56
+ if (item.path !== undefined &&
57
+ (typeof item.path !== "string" ||
58
+ item.path.startsWith("/") ||
59
+ item.path.split(/[\\/]/).includes("..")))
60
+ throw new Error("context path must be relative without traversal");
61
+ for (const field of ["snapshot", "revision"])
62
+ if (item[field] !== undefined &&
63
+ (typeof item[field] !== "string" || !item[field].trim()))
64
+ throw new Error(`${field} must be a nonempty reference`);
65
+ }
66
+ }
67
+ export async function validateProjects(c, projects) {
68
+ for (const slug of projects) {
69
+ const project = await requestJson(c.remote, `/namespaces/${seg(c.ns)}/projects/${seg(slug)}`, { token: c.token });
70
+ if (!project?.id)
71
+ throw new Error(`project '${slug}' did not resolve`);
72
+ }
73
+ }
74
+ export async function listAgents(c, opts) {
75
+ const all = [];
76
+ for (let page = 1;; page++) {
77
+ const res = await requestJson(c.remote, base(c), {
78
+ token: c.token,
79
+ query: { kind: "agent", page, pageSize: 200 },
80
+ });
81
+ if (!Array.isArray(res.runnables))
82
+ throw new Error("invalid agent list response");
83
+ all.push(...res.runnables.filter((r) => r.kind === "agent"));
84
+ if (res.totalPages === undefined || page >= res.totalPages)
85
+ break;
86
+ }
87
+ return all
88
+ .filter((r) => (!opts.prefix ||
89
+ r.name.startsWith(opts.prefix) ||
90
+ r.id.startsWith(opts.prefix)) &&
91
+ (!opts.project ||
92
+ projectSlugs(r.metadata?.agent?.projects).includes(opts.project)))
93
+ .sort((a, b) => a.name.localeCompare(b.name));
94
+ }
95
+ export function resolveAgent(rows, prefix) {
96
+ const exact = rows.filter((r) => r.name === prefix || r.id === prefix);
97
+ const matches = exact.length
98
+ ? exact
99
+ : rows.filter((r) => r.name.startsWith(prefix) || r.id.startsWith(prefix));
100
+ if (matches.length !== 1)
101
+ throw new Error(matches.length
102
+ ? `ambiguous agent prefix '${prefix}': ${matches.map((r) => r.name).join(", ")}`
103
+ : `agent '${prefix}' not found`);
104
+ return matches[0];
105
+ }
106
+ export function draftOf(row) {
107
+ return {
108
+ prompt: row.markdown ?? "",
109
+ parameters: {
110
+ ...row.metadata?.agent,
111
+ description: row.description ?? "",
112
+ channel: row.channel ?? null,
113
+ },
114
+ };
115
+ }
116
+ export function validateDraft(draft) {
117
+ if (typeof draft.prompt !== "string" || !draft.prompt.trim())
118
+ throw new Error("prompt must not be empty");
119
+ const p = draft.parameters;
120
+ if (!p || typeof p !== "object" || Array.isArray(p))
121
+ throw new Error("parameters must be a YAML mapping");
122
+ scanForCredentials("parameters", p);
123
+ for (const field of [
124
+ "name",
125
+ "model",
126
+ "run_config",
127
+ "queue",
128
+ "description",
129
+ "spec",
130
+ ])
131
+ if (p[field] !== undefined && typeof p[field] !== "string")
132
+ throw new Error(`${field} must be a string`);
133
+ for (const field of ["tools", "grants"])
134
+ if (p[field] !== undefined &&
135
+ (!Array.isArray(p[field]) ||
136
+ p[field].some((v) => typeof v !== "string")))
137
+ throw new Error(`${field} must be a list of strings`);
138
+ if (p.permissions !== undefined) {
139
+ if (!p.permissions ||
140
+ typeof p.permissions !== "object" ||
141
+ Array.isArray(p.permissions))
142
+ throw new Error("permissions must be a mapping");
143
+ checkPermissionKeys(p.permissions);
144
+ for (const field of ["allow", "ask", "deny", "additionalDirectories"]) {
145
+ const v = p.permissions[field];
146
+ if (v !== undefined &&
147
+ (!Array.isArray(v) || v.some((s) => typeof s !== "string")))
148
+ throw new Error(`permissions.${field} must be a list of strings`);
149
+ if (field !== "additionalDirectories" && v)
150
+ validateRules(field, v, p.tools);
151
+ }
152
+ if (p.permissions.defaultMode !== undefined &&
153
+ !PERMISSION_MODES.includes(p.permissions.defaultMode))
154
+ throw new Error("invalid permission mode");
155
+ }
156
+ if (p.arguments !== undefined && !Array.isArray(p.arguments))
157
+ throw new Error("arguments must be a list");
158
+ const args = p.arguments ?? [];
159
+ const names = new Set();
160
+ for (const a of args) {
161
+ if (!a ||
162
+ typeof a !== "object" ||
163
+ typeof a.name !== "string" ||
164
+ !/^[A-Za-z_][A-Za-z0-9_]*$/.test(a.name) ||
165
+ names.has(a.name))
166
+ throw new Error("argument names must be valid and unique");
167
+ names.add(a.name);
168
+ if (!ARGUMENT_TYPES.includes(a.type))
169
+ throw new Error(`invalid type for '${a.name}'`);
170
+ if (a.required !== undefined && typeof a.required !== "boolean")
171
+ throw new Error("required must be boolean");
172
+ if (a.required && "default" in a)
173
+ throw new Error(`'${a.name}' cannot be required and defaulted`);
174
+ if (a.type === "enum" &&
175
+ (!Array.isArray(a.values) ||
176
+ !a.values.length ||
177
+ a.values.some((v) => typeof v !== "string")))
178
+ throw new Error(`'${a.name}' needs enum values`);
179
+ if ("default" in a) {
180
+ const v = a.default;
181
+ if ((a.type === "string" && typeof v !== "string") ||
182
+ (a.type === "boolean" && typeof v !== "boolean") ||
183
+ (a.type === "integer" && !Number.isSafeInteger(v)) ||
184
+ (a.type === "number" &&
185
+ (typeof v !== "number" || !Number.isFinite(v))) ||
186
+ (a.type === "enum" && !a.values.includes(v)))
187
+ throw new Error(`invalid default for '${a.name}'`);
188
+ }
189
+ }
190
+ checkPlaceholders(draft.prompt, args);
191
+ projectSlugs(p.projects);
192
+ validateContext(p.context);
193
+ if (p.channel != null &&
194
+ (typeof p.channel !== "object" ||
195
+ Array.isArray(p.channel) ||
196
+ typeof p.channel.kind !== "string" ||
197
+ Object.keys(p.channel).some((k) => !["kind", "target", "config"].includes(k))))
198
+ throw new Error("channel must contain kind and optional target/config");
199
+ }
200
+ export const agentFingerprint = (row) => createHash("sha256")
201
+ .update(JSON.stringify([
202
+ row.updatedAt,
203
+ row.markdown,
204
+ row.metadata,
205
+ row.description,
206
+ row.channel,
207
+ ]))
208
+ .digest("hex");
209
+ export async function saveAgent(c, original, draft) {
210
+ validateDraft(draft);
211
+ await validateProjects(c, projectSlugs(draft.parameters.projects));
212
+ const current = await requestJson(c.remote, `${base(c)}/${seg(original.id)}`, { token: c.token });
213
+ if (current.kind !== "agent" ||
214
+ agentFingerprint(current) !== agentFingerprint(original))
215
+ throw new Error("agent changed since opening; reopen before saving");
216
+ const { description, channel, ...agent } = draft.parameters;
217
+ const saved = await requestJson(c.remote, `${base(c)}/${seg(original.id)}`, {
218
+ method: "PATCH",
219
+ token: c.token,
220
+ json: {
221
+ markdown: draft.prompt,
222
+ description: description ?? null,
223
+ channel: channel ?? null,
224
+ metadata: { ...original.metadata, agent },
225
+ },
226
+ });
227
+ if (!saved || saved.id !== original.id || saved.kind !== "agent")
228
+ throw new Error("invalid save receipt; inspect the agent before retrying");
229
+ return saved;
230
+ }
231
+ export function showAgent(row) {
232
+ process.stdout.write(`${terminalText(row.name)} (${terminalText(row.id)})\n\nPrompt\n${(row.markdown ?? "").replace(/[\x00-\x08\x0b-\x1f\x7f-\x9f]/g, "")}\n\nParameters\n${YAML.stringify(draftOf(row).parameters)}`);
233
+ }
234
+ export async function editAgent(c, row) {
235
+ let draft = draftOf(row);
236
+ for (;;) {
237
+ const action = await select({
238
+ message: `${terminalText(row.name)}${JSON.stringify(draft) !== JSON.stringify(draftOf(row)) ? " • unsaved changes" : ""}`,
239
+ choices: [
240
+ { name: "View prompt and parameters", value: "view" },
241
+ { name: "Edit prompt", value: "prompt" },
242
+ { name: "Edit parameters and projects (YAML)", value: "parameters" },
243
+ { name: "Save", value: "save" },
244
+ { name: "Back / discard changes", value: "back" },
245
+ ],
246
+ });
247
+ if (action === "back")
248
+ return;
249
+ if (action === "view") {
250
+ showAgent({
251
+ ...row,
252
+ markdown: draft.prompt,
253
+ metadata: { ...row.metadata, agent: draft.parameters },
254
+ });
255
+ continue;
256
+ }
257
+ try {
258
+ if (action === "prompt")
259
+ draft.prompt = await editor({
260
+ message: "Edit agent prompt",
261
+ default: draft.prompt,
262
+ waitForUserInput: false,
263
+ });
264
+ if (action === "parameters") {
265
+ const text = await editor({
266
+ message: "Edit YAML parameters",
267
+ default: YAML.stringify(draft.parameters),
268
+ waitForUserInput: false,
269
+ });
270
+ const next = { prompt: draft.prompt, parameters: YAML.parse(text) };
271
+ validateDraft(next);
272
+ draft = next;
273
+ }
274
+ if (action === "save") {
275
+ row = await saveAgent(c, row, draft);
276
+ draft = draftOf(row);
277
+ process.stdout.write("Saved prompt and parameters.\n");
278
+ }
279
+ }
280
+ catch (e) {
281
+ if (e.name === "ExitPromptError")
282
+ throw e;
283
+ process.stderr.write(`${terminalText(e.message)}\n`);
284
+ }
285
+ }
286
+ }
287
+ export async function runAgentsManage(action, prefix, opts) {
288
+ try {
289
+ const c = await agentContext(opts.namespace);
290
+ const rows = await listAgents(c, opts);
291
+ if (action !== "list") {
292
+ const row = resolveAgent(rows, prefix);
293
+ if (action === "show") {
294
+ if (opts.json)
295
+ emitJson(row);
296
+ else
297
+ showAgent(row);
298
+ return 0;
299
+ }
300
+ if (opts.web) {
301
+ const { serveAgentEditor } = await import("./web.js");
302
+ await serveAgentEditor(c, row);
303
+ return 0;
304
+ }
305
+ if (!process.stdin.isTTY || !process.stdout.isTTY)
306
+ throw new Error("editing needs a TTY; use --web for a browser editor");
307
+ await editAgent(c, row);
308
+ return 0;
309
+ }
310
+ if (opts.json) {
311
+ emitJson(rows);
312
+ return 0;
313
+ }
314
+ if (!rows.length) {
315
+ process.stdout.write("No agents found.\n");
316
+ return 0;
317
+ }
318
+ if (opts.plain || !process.stdin.isTTY || !process.stdout.isTTY) {
319
+ process.stdout.write(renderTable(rows.map((r) => ({
320
+ name: terminalText(r.name),
321
+ id: r.id,
322
+ projects: projectSlugs(r.metadata?.agent?.projects).join(", ") || "—",
323
+ description: terminalText(r.description ?? ""),
324
+ })), ["name", "id", "projects", "description"]));
325
+ return 0;
326
+ }
327
+ for (;;) {
328
+ const selected = await select({
329
+ message: "Agents — Enter to inspect/edit",
330
+ choices: [
331
+ ...rows.map((r) => ({
332
+ name: `${terminalText(r.name)} ${projectSlugs(r.metadata?.agent?.projects).join(", ")}`,
333
+ value: r.id,
334
+ })),
335
+ { name: "Exit", value: "" },
336
+ ],
337
+ });
338
+ if (!selected)
339
+ return 0;
340
+ const latest = await requestJson(c.remote, `${base(c)}/${seg(selected)}`, { token: c.token });
341
+ await editAgent(c, latest);
342
+ }
343
+ }
344
+ catch (e) {
345
+ if (e.name === "ExitPromptError")
346
+ return 0;
347
+ fail(e.message);
348
+ return 1;
349
+ }
350
+ }
351
+ export function registerAgentManagement(agents) {
352
+ for (const action of ["list", "show", "edit"]) {
353
+ const cmd = (action === "list" ? collectionList(agents) : agents.command(`${action} <prefix>`))
354
+ .description(action === "list"
355
+ ? "browse agents in a TTY; otherwise print text"
356
+ : `${action} an agent by unique name or ID prefix`)
357
+ .option("--namespace <slug>", "agent namespace")
358
+ .option("--project <slug>", "filter project affiliation")
359
+ .option("--json", "print JSON")
360
+ .option("--plain", "print text without a TUI");
361
+ if (action === "show")
362
+ cmd.alias("read");
363
+ if (action === "list")
364
+ cmd.option("--prefix <prefix>", "filter agent names or IDs by prefix");
365
+ if (action === "edit")
366
+ cmd.option("--web", "open a local browser editor with a Save button");
367
+ if (action === "list")
368
+ cmd.action(async (opts) => {
369
+ process.exitCode = await runAgentsManage(action, undefined, opts);
370
+ });
371
+ else
372
+ cmd.action(async (prefix, opts) => {
373
+ process.exitCode = await runAgentsManage(action, prefix, opts);
374
+ });
375
+ }
376
+ }
@@ -0,0 +1,104 @@
1
+ export declare const PERMISSION_MODES: readonly ["default", "acceptEdits", "plan", "bypassPermissions"];
2
+ /** The only keys `permissions` may carry. Anything else is a typo or a smuggle. */
3
+ export declare const PERMISSION_KEYS: readonly ["allow", "ask", "deny", "additionalDirectories", "defaultMode"];
4
+ export declare const ARGUMENT_TYPES: readonly ["string", "integer", "number", "boolean", "enum"];
5
+ export interface AgentArgument {
6
+ name: string;
7
+ type: (typeof ARGUMENT_TYPES)[number];
8
+ required?: boolean;
9
+ default?: unknown;
10
+ values?: unknown[];
11
+ description?: string;
12
+ }
13
+ export interface AgentPermissions {
14
+ allow?: string[];
15
+ ask?: string[];
16
+ deny?: string[];
17
+ additionalDirectories?: string[];
18
+ defaultMode?: string;
19
+ }
20
+ export interface AgentSpec {
21
+ projects?: string[];
22
+ context?: Array<Record<string, unknown>>;
23
+ spec?: string;
24
+ name?: string;
25
+ tools?: string[];
26
+ model?: string;
27
+ permissions?: AgentPermissions;
28
+ run_config?: string;
29
+ queue?: string;
30
+ grants?: string[];
31
+ arguments?: AgentArgument[];
32
+ }
33
+ export interface ParsedAgentFile {
34
+ frontmatter: Record<string, unknown>;
35
+ body: string;
36
+ }
37
+ export declare class SpecError extends Error {
38
+ }
39
+ /**
40
+ * Split `---\n<yaml>\n---\n<markdown>` into its two halves.
41
+ *
42
+ * A file with no frontmatter is not an error: it is a bare prompt, and every
43
+ * field can come from flags. A file whose frontmatter fence is opened and never
44
+ * closed IS an error — silently treating the whole file as prose would store a
45
+ * page of YAML as the system prompt.
46
+ */
47
+ export declare function parseAgentFile(text: string): ParsedAgentFile;
48
+ /** `Read, Grep,Bash` → `["Read","Grep","Bash"]`. Also accepts a YAML list. */
49
+ export declare function parseToolList(raw: string | string[] | undefined): string[] | undefined;
50
+ /**
51
+ * `--arg` mini-syntax, designed so the common cases fit inside one shell word
52
+ * and the uncommon ones are still expressible:
53
+ *
54
+ * invocation_id:string! required
55
+ * max_log_lines:integer=200 defaulted
56
+ * verdict_detail:enum(terse|normal|forensic)=normal
57
+ * dry_run:boolean=false
58
+ * scene:string! "the scene id" trailing description
59
+ *
60
+ * `!` and `=` are mutually exclusive on purpose. `required` plus a `default`
61
+ * are two statements that contradict each other, and either reading silently
62
+ * disables the other — so it is rejected here rather than resolved at dispatch.
63
+ */
64
+ export declare function parseArgumentFlag(raw: string): AgentArgument;
65
+ /** `http-sse:/v1/agents/triage/stream` → `{ kind, target }`. */
66
+ export declare function parseChannelFlag(raw: string): {
67
+ kind: string;
68
+ target?: string;
69
+ };
70
+ /**
71
+ * Reject unknown keys under `permissions`.
72
+ *
73
+ * This exists because the merge below it is an ALLOWLIST — it reads five keys
74
+ * and ignores the rest — and an allowlist that silently drops what it does not
75
+ * recognise is the worst of both worlds: a `permissions.allowed` typo declares
76
+ * nothing and says nothing, and a credential parked there sails past the scan
77
+ * that would otherwise have caught it. The server does exactly this for
78
+ * `channel`, and for exactly this reason.
79
+ */
80
+ export declare function checkPermissionKeys(permissions: Record<string, unknown>): void;
81
+ export declare function validateRules(bucket: string, rules: string[], tools?: string[]): string[];
82
+ /**
83
+ * Cross-check the prompt against the declared arguments, in both directions and
84
+ * with deliberately different severities:
85
+ *
86
+ * a placeholder with no declaration → ERROR. A typo'd {{ invocaton_id }}
87
+ * must never reach a model as literal braces.
88
+ * a declaration with no placeholder → warning. An argument may legitimately
89
+ * be consumed by a tool binding rather than by the prompt.
90
+ */
91
+ export declare function checkPlaceholders(body: string, args: AgentArgument[]): {
92
+ used: string[];
93
+ warnings: string[];
94
+ };
95
+ /**
96
+ * Walk the spec for credential-shaped keys.
97
+ *
98
+ * The server walks `channel`, at full depth, and NOTHING ELSE. The rest of the
99
+ * spec rides in `metadata`, which is stored verbatim and handed back by GET to
100
+ * anyone with read access to the namespace — there are deliberately no secret
101
+ * columns on `Runnable`, so a token here is not untidy, it is published. The
102
+ * CLI refuses locally precisely because the server will not.
103
+ */
104
+ export declare function scanForCredentials(prefix: string, value: unknown, depth?: number): void;