@stigmer/cli 0.1.0-dev.20261017064309.g94d062a29f89 → 0.1.1

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 (760) hide show
  1. package/README.md +5 -4
  2. package/auth/auth0.js +1 -1
  3. package/auth/auth0.js.map +1 -1
  4. package/auth/token.d.ts +26 -4
  5. package/auth/token.d.ts.map +1 -1
  6. package/auth/token.js +120 -24
  7. package/auth/token.js.map +1 -1
  8. package/client/client.d.ts.map +1 -1
  9. package/client/client.js +21 -8
  10. package/client/client.js.map +1 -1
  11. package/command-tree.d.ts +63 -0
  12. package/command-tree.d.ts.map +1 -0
  13. package/command-tree.js +128 -0
  14. package/command-tree.js.map +1 -0
  15. package/commands/access-history/index.d.ts.map +1 -1
  16. package/commands/access-history/index.js +13 -1
  17. package/commands/access-history/index.js.map +1 -1
  18. package/commands/agent-exec-flags.d.ts +2 -0
  19. package/commands/agent-exec-flags.d.ts.map +1 -1
  20. package/commands/agent-exec-flags.js +9 -5
  21. package/commands/agent-exec-flags.js.map +1 -1
  22. package/commands/apikey/duration.d.ts.map +1 -1
  23. package/commands/apikey/duration.js +1 -2
  24. package/commands/apikey/duration.js.map +1 -1
  25. package/commands/apikey/index.d.ts.map +1 -1
  26. package/commands/apikey/index.js +3 -4
  27. package/commands/apikey/index.js.map +1 -1
  28. package/commands/apply.d.ts.map +1 -1
  29. package/commands/apply.js +2 -32
  30. package/commands/apply.js.map +1 -1
  31. package/commands/auth/index.d.ts.map +1 -1
  32. package/commands/auth/index.js +7 -5
  33. package/commands/auth/index.js.map +1 -1
  34. package/commands/auth/whoami.js +1 -1
  35. package/commands/config/index.js +3 -3
  36. package/commands/config/kv.d.ts.map +1 -1
  37. package/commands/config/kv.js +18 -14
  38. package/commands/config/kv.js.map +1 -1
  39. package/commands/connect.d.ts.map +1 -1
  40. package/commands/connect.js +18 -2
  41. package/commands/connect.js.map +1 -1
  42. package/commands/download.d.ts.map +1 -1
  43. package/commands/download.js +81 -54
  44. package/commands/download.js.map +1 -1
  45. package/commands/eval.d.ts.map +1 -1
  46. package/commands/eval.js +17 -19
  47. package/commands/eval.js.map +1 -1
  48. package/commands/file.d.ts +3 -0
  49. package/commands/file.d.ts.map +1 -0
  50. package/commands/file.js +64 -0
  51. package/commands/file.js.map +1 -0
  52. package/commands/get.d.ts.map +1 -1
  53. package/commands/get.js +20 -13
  54. package/commands/get.js.map +1 -1
  55. package/commands/help.d.ts +15 -0
  56. package/commands/help.d.ts.map +1 -0
  57. package/commands/help.js +175 -0
  58. package/commands/help.js.map +1 -0
  59. package/commands/internal-daemon.d.ts.map +1 -1
  60. package/commands/internal-daemon.js +9 -2
  61. package/commands/internal-daemon.js.map +1 -1
  62. package/commands/list.d.ts.map +1 -1
  63. package/commands/list.js +22 -1
  64. package/commands/list.js.map +1 -1
  65. package/commands/logs.js +1 -1
  66. package/commands/logs.js.map +1 -1
  67. package/commands/mcp-server.d.ts +16 -6
  68. package/commands/mcp-server.d.ts.map +1 -1
  69. package/commands/mcp-server.js +51 -26
  70. package/commands/mcp-server.js.map +1 -1
  71. package/commands/provider-key/index.d.ts +3 -0
  72. package/commands/provider-key/index.d.ts.map +1 -0
  73. package/commands/provider-key/index.js +156 -0
  74. package/commands/provider-key/index.js.map +1 -0
  75. package/commands/push.js +8 -8
  76. package/commands/push.js.map +1 -1
  77. package/commands/resume.d.ts.map +1 -1
  78. package/commands/resume.js +17 -11
  79. package/commands/resume.js.map +1 -1
  80. package/commands/routine.d.ts.map +1 -1
  81. package/commands/routine.js +42 -3
  82. package/commands/routine.js.map +1 -1
  83. package/commands/run.d.ts.map +1 -1
  84. package/commands/run.js +34 -15
  85. package/commands/run.js.map +1 -1
  86. package/commands/runs/approve.d.ts.map +1 -1
  87. package/commands/runs/approve.js +10 -2
  88. package/commands/runs/approve.js.map +1 -1
  89. package/commands/runs/control.d.ts.map +1 -1
  90. package/commands/runs/control.js +24 -16
  91. package/commands/runs/control.js.map +1 -1
  92. package/commands/runs/index.d.ts.map +1 -1
  93. package/commands/runs/index.js +1 -2
  94. package/commands/runs/index.js.map +1 -1
  95. package/commands/runs/logs.d.ts.map +1 -1
  96. package/commands/runs/logs.js +7 -4
  97. package/commands/runs/logs.js.map +1 -1
  98. package/commands/runs/to-eval-case.d.ts.map +1 -1
  99. package/commands/runs/to-eval-case.js +13 -4
  100. package/commands/runs/to-eval-case.js.map +1 -1
  101. package/commands/runs/trace.js +1 -1
  102. package/commands/runs/trace.js.map +1 -1
  103. package/commands/search.js +2 -3
  104. package/commands/search.js.map +1 -1
  105. package/commands/service-account/index.d.ts.map +1 -1
  106. package/commands/service-account/index.js +4 -2
  107. package/commands/service-account/index.js.map +1 -1
  108. package/commands/session-help.d.ts +5 -0
  109. package/commands/session-help.d.ts.map +1 -0
  110. package/commands/session-help.js +38 -0
  111. package/commands/session-help.js.map +1 -0
  112. package/commands/setup.js +5 -5
  113. package/commands/setup.js.map +1 -1
  114. package/commands/shared.d.ts +10 -2
  115. package/commands/shared.d.ts.map +1 -1
  116. package/commands/shared.js +30 -3
  117. package/commands/shared.js.map +1 -1
  118. package/commands/tag.d.ts.map +1 -1
  119. package/commands/tag.js +11 -6
  120. package/commands/tag.js.map +1 -1
  121. package/commands/up.d.ts.map +1 -1
  122. package/commands/up.js +51 -21
  123. package/commands/up.js.map +1 -1
  124. package/commands/validate.js +2 -2
  125. package/commands/validate.js.map +1 -1
  126. package/commands/version.d.ts.map +1 -1
  127. package/commands/version.js +8 -4
  128. package/commands/version.js.map +1 -1
  129. package/config/config.d.ts +5 -22
  130. package/config/config.d.ts.map +1 -1
  131. package/config/config.js +56 -47
  132. package/config/config.js.map +1 -1
  133. package/config/index.d.ts +2 -2
  134. package/config/index.d.ts.map +1 -1
  135. package/config/index.js +1 -1
  136. package/config/index.js.map +1 -1
  137. package/config/keys.js +4 -4
  138. package/config/keys.js.map +1 -1
  139. package/config/paths.js +2 -2
  140. package/config/paths.js.map +1 -1
  141. package/config/resolve.d.ts +12 -2
  142. package/config/resolve.d.ts.map +1 -1
  143. package/config/resolve.js +18 -8
  144. package/config/resolve.js.map +1 -1
  145. package/errors/classify.d.ts +20 -0
  146. package/errors/classify.d.ts.map +1 -1
  147. package/errors/classify.js +97 -21
  148. package/errors/classify.js.map +1 -1
  149. package/errors/command-line.d.ts +14 -0
  150. package/errors/command-line.d.ts.map +1 -0
  151. package/errors/command-line.js +90 -0
  152. package/errors/command-line.js.map +1 -0
  153. package/errors/handle.js +2 -2
  154. package/errors/handle.js.map +1 -1
  155. package/errors/index.d.ts +2 -2
  156. package/errors/index.d.ts.map +1 -1
  157. package/errors/index.js +12 -2
  158. package/errors/index.js.map +1 -1
  159. package/errors/usage-error.js +1 -1
  160. package/errors/usage-error.js.map +1 -1
  161. package/global-options.d.ts +35 -0
  162. package/global-options.d.ts.map +1 -0
  163. package/global-options.js +81 -0
  164. package/global-options.js.map +1 -0
  165. package/local/artifact.d.ts +1 -20
  166. package/local/artifact.d.ts.map +1 -1
  167. package/local/artifact.js +35 -117
  168. package/local/artifact.js.map +1 -1
  169. package/local/constants.d.ts +3 -9
  170. package/local/constants.d.ts.map +1 -1
  171. package/local/constants.js +3 -9
  172. package/local/constants.js.map +1 -1
  173. package/local/daemon/components.d.ts +18 -5
  174. package/local/daemon/components.d.ts.map +1 -1
  175. package/local/daemon/components.js +61 -23
  176. package/local/daemon/components.js.map +1 -1
  177. package/local/daemon/env.d.ts +1 -5
  178. package/local/daemon/env.d.ts.map +1 -1
  179. package/local/daemon/env.js +0 -2
  180. package/local/daemon/env.js.map +1 -1
  181. package/local/daemon/host.d.ts +5 -0
  182. package/local/daemon/host.d.ts.map +1 -1
  183. package/local/daemon/host.js +68 -21
  184. package/local/daemon/host.js.map +1 -1
  185. package/local/daemon/index.d.ts +2 -1
  186. package/local/daemon/index.d.ts.map +1 -1
  187. package/local/daemon/index.js +2 -1
  188. package/local/daemon/index.js.map +1 -1
  189. package/local/daemon/launch.d.ts +58 -9
  190. package/local/daemon/launch.d.ts.map +1 -1
  191. package/local/daemon/launch.js +210 -64
  192. package/local/daemon/launch.js.map +1 -1
  193. package/local/daemon/process.d.ts +11 -7
  194. package/local/daemon/process.d.ts.map +1 -1
  195. package/local/daemon/process.js +74 -38
  196. package/local/daemon/process.js.map +1 -1
  197. package/local/daemon/signals.d.ts +3 -0
  198. package/local/daemon/signals.d.ts.map +1 -0
  199. package/local/daemon/signals.js +19 -0
  200. package/local/daemon/signals.js.map +1 -0
  201. package/local/daemon/supervisor.d.ts +9 -2
  202. package/local/daemon/supervisor.d.ts.map +1 -1
  203. package/local/daemon/supervisor.js +81 -22
  204. package/local/daemon/supervisor.js.map +1 -1
  205. package/local/daemon/types.d.ts +6 -1
  206. package/local/daemon/types.d.ts.map +1 -1
  207. package/local/daemon/types.js +2 -3
  208. package/local/daemon/types.js.map +1 -1
  209. package/local/llm-config.d.ts +4 -2
  210. package/local/llm-config.d.ts.map +1 -1
  211. package/local/llm-config.js +15 -9
  212. package/local/llm-config.js.map +1 -1
  213. package/local/logs/view.d.ts.map +1 -1
  214. package/local/logs/view.js +5 -6
  215. package/local/logs/view.js.map +1 -1
  216. package/local/net/tcp.d.ts +8 -6
  217. package/local/net/tcp.d.ts.map +1 -1
  218. package/local/net/tcp.js +13 -8
  219. package/local/net/tcp.js.map +1 -1
  220. package/local/paths.d.ts +1 -1
  221. package/local/paths.d.ts.map +1 -1
  222. package/local/paths.js +2 -3
  223. package/local/paths.js.map +1 -1
  224. package/local/provider-reach.d.ts +18 -0
  225. package/local/provider-reach.d.ts.map +1 -0
  226. package/local/provider-reach.js +109 -0
  227. package/local/provider-reach.js.map +1 -0
  228. package/local/reset.d.ts.map +1 -1
  229. package/local/reset.js +1 -2
  230. package/local/reset.js.map +1 -1
  231. package/local/runtime/index.d.ts.map +1 -1
  232. package/local/runtime/index.js +1 -2
  233. package/local/runtime/index.js.map +1 -1
  234. package/local/runtime/node.js +1 -1
  235. package/local/runtime/runner.js +2 -2
  236. package/local/runtime/runner.js.map +1 -1
  237. package/local/runtime/runtimes-install.js +1 -1
  238. package/local/runtime/server.d.ts.map +1 -1
  239. package/local/runtime/server.js +2 -4
  240. package/local/runtime/server.js.map +1 -1
  241. package/local/runtime/which.js +1 -1
  242. package/local/runtime/which.js.map +1 -1
  243. package/local/setup/wizard.d.ts +1 -1
  244. package/local/setup/wizard.d.ts.map +1 -1
  245. package/local/setup/wizard.js +7 -5
  246. package/local/setup/wizard.js.map +1 -1
  247. package/local/state/health-state.d.ts +6 -0
  248. package/local/state/health-state.d.ts.map +1 -1
  249. package/local/state/health-state.js +6 -2
  250. package/local/state/health-state.js.map +1 -1
  251. package/local/state/lock.d.ts +3 -2
  252. package/local/state/lock.d.ts.map +1 -1
  253. package/local/state/lock.js +26 -28
  254. package/local/state/lock.js.map +1 -1
  255. package/local/state/log-rotation.d.ts.map +1 -1
  256. package/local/state/log-rotation.js +2 -3
  257. package/local/state/log-rotation.js.map +1 -1
  258. package/local/state/pidfile.d.ts +24 -1
  259. package/local/state/pidfile.d.ts.map +1 -1
  260. package/local/state/pidfile.js +54 -6
  261. package/local/state/pidfile.js.map +1 -1
  262. package/local/state/proc.d.ts +31 -0
  263. package/local/state/proc.d.ts.map +1 -1
  264. package/local/state/proc.js +98 -1
  265. package/local/state/proc.js.map +1 -1
  266. package/local/state/startup-config.d.ts +2 -2
  267. package/local/status.d.ts +2 -4
  268. package/local/status.d.ts.map +1 -1
  269. package/local/status.js +26 -41
  270. package/local/status.js.map +1 -1
  271. package/local/temporal/download.d.ts +9 -5
  272. package/local/temporal/download.d.ts.map +1 -1
  273. package/local/temporal/download.js +29 -8
  274. package/local/temporal/download.js.map +1 -1
  275. package/local/temporal/index.d.ts +1 -1
  276. package/local/temporal/index.d.ts.map +1 -1
  277. package/local/temporal/index.js +1 -1
  278. package/local/temporal/index.js.map +1 -1
  279. package/local/temporal/manager.d.ts +31 -5
  280. package/local/temporal/manager.d.ts.map +1 -1
  281. package/local/temporal/manager.js +74 -35
  282. package/local/temporal/manager.js.map +1 -1
  283. package/local/temporal/supervisor.js +1 -1
  284. package/local/temporal/supervisor.js.map +1 -1
  285. package/local/webconsole/index.d.ts +5 -2
  286. package/local/webconsole/index.d.ts.map +1 -1
  287. package/local/webconsole/index.js +8 -6
  288. package/local/webconsole/index.js.map +1 -1
  289. package/marketplace/github.js +1 -1
  290. package/marketplace/github.js.map +1 -1
  291. package/marketplace/official.js +1 -1
  292. package/marketplace/official.js.map +1 -1
  293. package/output/command-result.d.ts +6 -0
  294. package/output/command-result.d.ts.map +1 -1
  295. package/output/command-result.js +13 -2
  296. package/output/command-result.js.map +1 -1
  297. package/output/confirm.d.ts.map +1 -1
  298. package/output/confirm.js +2 -3
  299. package/output/confirm.js.map +1 -1
  300. package/output/format.d.ts.map +1 -1
  301. package/output/format.js +5 -6
  302. package/output/format.js.map +1 -1
  303. package/output/index.d.ts +2 -2
  304. package/output/index.d.ts.map +1 -1
  305. package/output/index.js +2 -2
  306. package/output/index.js.map +1 -1
  307. package/output/printable.d.ts +8 -0
  308. package/output/printable.d.ts.map +1 -0
  309. package/output/printable.js +24 -0
  310. package/output/printable.js.map +1 -0
  311. package/output/proto.d.ts.map +1 -1
  312. package/output/proto.js +3 -4
  313. package/output/proto.js.map +1 -1
  314. package/output/style.js +2 -2
  315. package/output/style.js.map +1 -1
  316. package/output/table.d.ts +20 -1
  317. package/output/table.d.ts.map +1 -1
  318. package/output/table.js +75 -17
  319. package/output/table.js.map +1 -1
  320. package/package.json +13 -10
  321. package/program.d.ts +0 -14
  322. package/program.d.ts.map +1 -1
  323. package/program.js +57 -119
  324. package/program.js.map +1 -1
  325. package/registry/aliases.d.ts.map +1 -1
  326. package/registry/aliases.js +0 -3
  327. package/registry/aliases.js.map +1 -1
  328. package/registry/index.d.ts +1 -1
  329. package/registry/index.d.ts.map +1 -1
  330. package/registry/index.js +1 -1
  331. package/registry/index.js.map +1 -1
  332. package/registry/metadata.d.ts +0 -15
  333. package/registry/metadata.d.ts.map +1 -1
  334. package/registry/metadata.js +16 -57
  335. package/registry/metadata.js.map +1 -1
  336. package/registry/registry.d.ts +1 -5
  337. package/registry/registry.d.ts.map +1 -1
  338. package/registry/registry.js +3 -11
  339. package/registry/registry.js.map +1 -1
  340. package/registry/verb-support.d.ts.map +1 -1
  341. package/registry/verb-support.js +28 -5
  342. package/registry/verb-support.js.map +1 -1
  343. package/resources/agent/quality.d.ts +10 -5
  344. package/resources/agent/quality.d.ts.map +1 -1
  345. package/resources/agent/quality.js +19 -9
  346. package/resources/agent/quality.js.map +1 -1
  347. package/resources/agent/resolve.js +3 -3
  348. package/resources/agent/resolve.js.map +1 -1
  349. package/resources/apply/apply.d.ts +4 -3
  350. package/resources/apply/apply.d.ts.map +1 -1
  351. package/resources/apply/apply.js +54 -41
  352. package/resources/apply/apply.js.map +1 -1
  353. package/resources/apply/handlers.d.ts.map +1 -1
  354. package/resources/apply/handlers.js +3 -4
  355. package/resources/apply/handlers.js.map +1 -1
  356. package/resources/channel.d.ts.map +1 -1
  357. package/resources/channel.js +3 -4
  358. package/resources/channel.js.map +1 -1
  359. package/resources/connect/connect.js +2 -2
  360. package/resources/connect/connect.js.map +1 -1
  361. package/resources/delete.d.ts.map +1 -1
  362. package/resources/delete.js +38 -4
  363. package/resources/delete.js.map +1 -1
  364. package/resources/documents.js +1 -1
  365. package/resources/documents.js.map +1 -1
  366. package/resources/download.d.ts +43 -3
  367. package/resources/download.d.ts.map +1 -1
  368. package/resources/download.js +169 -34
  369. package/resources/download.js.map +1 -1
  370. package/resources/eval-run/options.d.ts +3 -1
  371. package/resources/eval-run/options.d.ts.map +1 -1
  372. package/resources/eval-run/options.js +36 -18
  373. package/resources/eval-run/options.js.map +1 -1
  374. package/resources/eval-run/report.d.ts +4 -2
  375. package/resources/eval-run/report.d.ts.map +1 -1
  376. package/resources/eval-run/report.js +9 -7
  377. package/resources/eval-run/report.js.map +1 -1
  378. package/resources/eval-run/run.d.ts +2 -1
  379. package/resources/eval-run/run.d.ts.map +1 -1
  380. package/resources/eval-run/run.js +13 -7
  381. package/resources/eval-run/run.js.map +1 -1
  382. package/resources/file.d.ts +27 -0
  383. package/resources/file.d.ts.map +1 -0
  384. package/resources/file.js +82 -0
  385. package/resources/file.js.map +1 -0
  386. package/resources/get-bindings.d.ts.map +1 -1
  387. package/resources/get-bindings.js +18 -0
  388. package/resources/get-bindings.js.map +1 -1
  389. package/resources/git.d.ts +1 -1
  390. package/resources/git.js +1 -1
  391. package/resources/list.d.ts +21 -2
  392. package/resources/list.d.ts.map +1 -1
  393. package/resources/list.js +148 -31
  394. package/resources/list.js.map +1 -1
  395. package/resources/plugin.d.ts.map +1 -1
  396. package/resources/plugin.js +4 -0
  397. package/resources/plugin.js.map +1 -1
  398. package/resources/provider-key.d.ts +81 -0
  399. package/resources/provider-key.d.ts.map +1 -0
  400. package/resources/provider-key.js +261 -0
  401. package/resources/provider-key.js.map +1 -0
  402. package/resources/reference.d.ts +15 -21
  403. package/resources/reference.d.ts.map +1 -1
  404. package/resources/reference.js +42 -88
  405. package/resources/reference.js.map +1 -1
  406. package/resources/render.d.ts +31 -7
  407. package/resources/render.d.ts.map +1 -1
  408. package/resources/render.js +66 -38
  409. package/resources/render.js.map +1 -1
  410. package/resources/routine.d.ts +21 -5
  411. package/resources/routine.d.ts.map +1 -1
  412. package/resources/routine.js +104 -15
  413. package/resources/routine.js.map +1 -1
  414. package/resources/run/agent-exec.d.ts +12 -2
  415. package/resources/run/agent-exec.d.ts.map +1 -1
  416. package/resources/run/agent-exec.js +85 -38
  417. package/resources/run/agent-exec.js.map +1 -1
  418. package/resources/run/create.d.ts +16 -12
  419. package/resources/run/create.d.ts.map +1 -1
  420. package/resources/run/create.js +14 -15
  421. package/resources/run/create.js.map +1 -1
  422. package/resources/run/engines.d.ts +32 -0
  423. package/resources/run/engines.d.ts.map +1 -0
  424. package/resources/run/engines.js +39 -0
  425. package/resources/run/engines.js.map +1 -0
  426. package/resources/run/environment.d.ts +11 -0
  427. package/resources/run/environment.d.ts.map +1 -0
  428. package/resources/run/environment.js +30 -0
  429. package/resources/run/environment.js.map +1 -0
  430. package/resources/run/epilogue.d.ts +1 -1
  431. package/resources/run/epilogue.d.ts.map +1 -1
  432. package/resources/run/epilogue.js +18 -19
  433. package/resources/run/epilogue.js.map +1 -1
  434. package/resources/run/files.d.ts +104 -0
  435. package/resources/run/files.d.ts.map +1 -0
  436. package/resources/run/files.js +316 -0
  437. package/resources/run/files.js.map +1 -0
  438. package/resources/run/header.d.ts +11 -9
  439. package/resources/run/header.d.ts.map +1 -1
  440. package/resources/run/header.js +14 -14
  441. package/resources/run/header.js.map +1 -1
  442. package/resources/run/prepare.d.ts +31 -25
  443. package/resources/run/prepare.d.ts.map +1 -1
  444. package/resources/run/prepare.js +42 -51
  445. package/resources/run/prepare.js.map +1 -1
  446. package/resources/run/references.d.ts.map +1 -1
  447. package/resources/run/references.js +6 -5
  448. package/resources/run/references.js.map +1 -1
  449. package/resources/run/resolve.js +1 -1
  450. package/resources/run/resolve.js.map +1 -1
  451. package/resources/run/resume.d.ts +3 -1
  452. package/resources/run/resume.d.ts.map +1 -1
  453. package/resources/run/resume.js +25 -10
  454. package/resources/run/resume.js.map +1 -1
  455. package/resources/run/stream.d.ts +34 -2
  456. package/resources/run/stream.d.ts.map +1 -1
  457. package/resources/run/stream.js +92 -8
  458. package/resources/run/stream.js.map +1 -1
  459. package/resources/run/workspace.d.ts +9 -12
  460. package/resources/run/workspace.d.ts.map +1 -1
  461. package/resources/run/workspace.js +29 -36
  462. package/resources/run/workspace.js.map +1 -1
  463. package/resources/run-approve.d.ts.map +1 -1
  464. package/resources/run-approve.js +2 -11
  465. package/resources/run-approve.js.map +1 -1
  466. package/resources/run-control.d.ts +3 -3
  467. package/resources/run-control.d.ts.map +1 -1
  468. package/resources/run-control.js +4 -5
  469. package/resources/run-control.js.map +1 -1
  470. package/resources/run-format.d.ts +2 -2
  471. package/resources/run-format.d.ts.map +1 -1
  472. package/resources/run-format.js +3 -4
  473. package/resources/run-format.js.map +1 -1
  474. package/resources/run-logs.d.ts +2 -0
  475. package/resources/run-logs.d.ts.map +1 -1
  476. package/resources/run-logs.js +16 -6
  477. package/resources/run-logs.js.map +1 -1
  478. package/resources/run-scores.d.ts +6 -2
  479. package/resources/run-scores.d.ts.map +1 -1
  480. package/resources/run-scores.js +7 -4
  481. package/resources/run-scores.js.map +1 -1
  482. package/resources/run-to-eval-case.js +2 -2
  483. package/resources/run-to-eval-case.js.map +1 -1
  484. package/resources/runs.d.ts +3 -3
  485. package/resources/runs.d.ts.map +1 -1
  486. package/resources/runs.js +5 -5
  487. package/resources/runs.js.map +1 -1
  488. package/resources/search.d.ts.map +1 -1
  489. package/resources/search.js +1 -2
  490. package/resources/search.js.map +1 -1
  491. package/resources/service-account.d.ts +2 -0
  492. package/resources/service-account.d.ts.map +1 -1
  493. package/resources/service-account.js +3 -1
  494. package/resources/service-account.js.map +1 -1
  495. package/resources/session.d.ts +4 -3
  496. package/resources/session.d.ts.map +1 -1
  497. package/resources/session.js +10 -7
  498. package/resources/session.js.map +1 -1
  499. package/resources/skill.d.ts +1 -1
  500. package/resources/skill.d.ts.map +1 -1
  501. package/resources/skill.js +7 -8
  502. package/resources/skill.js.map +1 -1
  503. package/resources/stream/answer.d.ts +1 -2
  504. package/resources/stream/answer.d.ts.map +1 -1
  505. package/resources/stream/answer.js +3 -16
  506. package/resources/stream/answer.js.map +1 -1
  507. package/resources/stream/composer.d.ts +16 -0
  508. package/resources/stream/composer.d.ts.map +1 -0
  509. package/resources/stream/composer.js +171 -0
  510. package/resources/stream/composer.js.map +1 -0
  511. package/resources/stream/ink.d.ts +20 -4
  512. package/resources/stream/ink.d.ts.map +1 -1
  513. package/resources/stream/ink.js +34 -3
  514. package/resources/stream/ink.js.map +1 -1
  515. package/resources/stream/render-plaintext.d.ts +1 -0
  516. package/resources/stream/render-plaintext.d.ts.map +1 -1
  517. package/resources/stream/render-plaintext.js +21 -4
  518. package/resources/stream/render-plaintext.js.map +1 -1
  519. package/resources/stream/tty.js +1 -1
  520. package/resources/stream/tty.js.map +1 -1
  521. package/resources/tag.d.ts.map +1 -1
  522. package/resources/tag.js +7 -8
  523. package/resources/tag.js.map +1 -1
  524. package/resources/usage.d.ts +3 -2
  525. package/resources/usage.d.ts.map +1 -1
  526. package/resources/usage.js +19 -16
  527. package/resources/usage.js.map +1 -1
  528. package/resources/validate.d.ts.map +1 -1
  529. package/resources/validate.js +1 -12
  530. package/resources/validate.js.map +1 -1
  531. package/resources/version.d.ts +17 -3
  532. package/resources/version.d.ts.map +1 -1
  533. package/resources/version.js +105 -14
  534. package/resources/version.js.map +1 -1
  535. package/resources/views/agent.d.ts +3 -0
  536. package/resources/views/agent.d.ts.map +1 -0
  537. package/resources/views/agent.js +54 -0
  538. package/resources/views/agent.js.map +1 -0
  539. package/resources/views/environment.d.ts +3 -0
  540. package/resources/views/environment.d.ts.map +1 -0
  541. package/resources/views/environment.js +37 -0
  542. package/resources/views/environment.js.map +1 -0
  543. package/resources/views/index.d.ts +22 -0
  544. package/resources/views/index.d.ts.map +1 -0
  545. package/resources/views/index.js +70 -0
  546. package/resources/views/index.js.map +1 -0
  547. package/resources/views/organization.d.ts +3 -0
  548. package/resources/views/organization.d.ts.map +1 -0
  549. package/resources/views/organization.js +27 -0
  550. package/resources/views/organization.js.map +1 -0
  551. package/resources/views/routine.d.ts +3 -0
  552. package/resources/views/routine.d.ts.map +1 -0
  553. package/resources/views/routine.js +37 -0
  554. package/resources/views/routine.js.map +1 -0
  555. package/resources/views/run.d.ts +3 -0
  556. package/resources/views/run.d.ts.map +1 -0
  557. package/resources/views/run.js +45 -0
  558. package/resources/views/run.js.map +1 -0
  559. package/resources/views/session.d.ts +5 -0
  560. package/resources/views/session.d.ts.map +1 -0
  561. package/resources/views/session.js +85 -0
  562. package/resources/views/session.js.map +1 -0
  563. package/resources/views/skill.d.ts +5 -0
  564. package/resources/views/skill.d.ts.map +1 -0
  565. package/resources/views/skill.js +48 -0
  566. package/resources/views/skill.js.map +1 -0
  567. package/resources/views/view.d.ts +66 -0
  568. package/resources/views/view.d.ts.map +1 -0
  569. package/resources/views/view.js +130 -0
  570. package/resources/views/view.js.map +1 -0
  571. package/resources/views/words.d.ts +52 -0
  572. package/resources/views/words.d.ts.map +1 -0
  573. package/resources/views/words.js +190 -0
  574. package/resources/views/words.js.map +1 -0
  575. package/runtime.d.ts +22 -0
  576. package/runtime.d.ts.map +1 -1
  577. package/runtime.js +33 -2
  578. package/runtime.js.map +1 -1
  579. package/src/auth/auth0.ts +1 -1
  580. package/src/auth/token.ts +136 -26
  581. package/src/client/client.ts +23 -16
  582. package/src/command-tree.ts +152 -0
  583. package/src/commands/access-history/index.ts +15 -2
  584. package/src/commands/agent-exec-flags.ts +11 -5
  585. package/src/commands/apikey/duration.ts +1 -2
  586. package/src/commands/apikey/index.ts +3 -4
  587. package/src/commands/apply.ts +3 -22
  588. package/src/commands/auth/index.ts +7 -5
  589. package/src/commands/auth/whoami.ts +1 -1
  590. package/src/commands/config/index.ts +3 -3
  591. package/src/commands/config/kv.ts +18 -14
  592. package/src/commands/connect.ts +21 -3
  593. package/src/commands/download.ts +106 -62
  594. package/src/commands/eval.ts +22 -21
  595. package/src/commands/file.ts +80 -0
  596. package/src/commands/get.ts +19 -13
  597. package/src/commands/help.ts +182 -0
  598. package/src/commands/internal-daemon.ts +9 -2
  599. package/src/commands/list.ts +22 -1
  600. package/src/commands/logs.ts +1 -1
  601. package/src/commands/mcp-server.ts +57 -28
  602. package/src/commands/provider-key/index.ts +192 -0
  603. package/src/commands/push.ts +8 -8
  604. package/src/commands/resume.ts +20 -12
  605. package/src/commands/routine.ts +58 -5
  606. package/src/commands/run.ts +37 -17
  607. package/src/commands/runs/approve.ts +13 -4
  608. package/src/commands/runs/control.ts +50 -27
  609. package/src/commands/runs/index.ts +1 -2
  610. package/src/commands/runs/logs.ts +9 -5
  611. package/src/commands/runs/to-eval-case.ts +18 -6
  612. package/src/commands/runs/trace.ts +1 -1
  613. package/src/commands/search.ts +2 -3
  614. package/src/commands/service-account/index.ts +7 -2
  615. package/src/commands/session-help.ts +39 -0
  616. package/src/commands/setup.ts +5 -5
  617. package/src/commands/shared.ts +32 -3
  618. package/src/commands/tag.ts +13 -7
  619. package/src/commands/up.ts +55 -21
  620. package/src/commands/validate.ts +2 -2
  621. package/src/commands/version.ts +9 -4
  622. package/src/config/config.ts +66 -69
  623. package/src/config/index.ts +1 -2
  624. package/src/config/keys.ts +4 -4
  625. package/src/config/paths.ts +2 -2
  626. package/src/config/resolve.ts +20 -8
  627. package/src/errors/classify.ts +110 -21
  628. package/src/errors/command-line.ts +95 -0
  629. package/src/errors/handle.ts +2 -2
  630. package/src/errors/index.ts +12 -2
  631. package/src/errors/usage-error.ts +1 -1
  632. package/src/global-options.ts +100 -0
  633. package/src/local/artifact.ts +46 -140
  634. package/src/local/constants.ts +3 -9
  635. package/src/local/daemon/components.ts +78 -22
  636. package/src/local/daemon/env.ts +3 -8
  637. package/src/local/daemon/host.ts +64 -19
  638. package/src/local/daemon/index.ts +2 -1
  639. package/src/local/daemon/launch.ts +251 -72
  640. package/src/local/daemon/process.ts +78 -46
  641. package/src/local/daemon/signals.ts +19 -0
  642. package/src/local/daemon/supervisor.ts +84 -21
  643. package/src/local/daemon/types.ts +8 -4
  644. package/src/local/llm-config.ts +15 -9
  645. package/src/local/logs/view.ts +5 -6
  646. package/src/local/net/tcp.ts +18 -11
  647. package/src/local/paths.ts +2 -3
  648. package/src/local/provider-reach.ts +124 -0
  649. package/src/local/reset.ts +1 -2
  650. package/src/local/runtime/index.ts +1 -2
  651. package/src/local/runtime/node.ts +1 -1
  652. package/src/local/runtime/runner.ts +2 -2
  653. package/src/local/runtime/runtimes-install.ts +1 -1
  654. package/src/local/runtime/server.ts +2 -4
  655. package/src/local/runtime/which.ts +1 -1
  656. package/src/local/setup/wizard.ts +7 -5
  657. package/src/local/state/health-state.ts +10 -2
  658. package/src/local/state/lock.ts +26 -28
  659. package/src/local/state/log-rotation.ts +2 -3
  660. package/src/local/state/pidfile.ts +61 -6
  661. package/src/local/state/proc.ts +104 -1
  662. package/src/local/state/startup-config.ts +2 -2
  663. package/src/local/status.ts +30 -41
  664. package/src/local/temporal/download.ts +31 -9
  665. package/src/local/temporal/index.ts +1 -1
  666. package/src/local/temporal/manager.ts +94 -34
  667. package/src/local/temporal/supervisor.ts +1 -1
  668. package/src/local/webconsole/index.ts +8 -5
  669. package/src/marketplace/github.ts +1 -1
  670. package/src/marketplace/official.ts +1 -1
  671. package/src/output/command-result.ts +14 -2
  672. package/src/output/confirm.ts +2 -3
  673. package/src/output/format.ts +5 -6
  674. package/src/output/index.ts +8 -1
  675. package/src/output/printable.ts +26 -0
  676. package/src/output/proto.ts +3 -4
  677. package/src/output/style.ts +2 -2
  678. package/src/output/table.ts +118 -15
  679. package/src/program.ts +58 -128
  680. package/src/registry/aliases.ts +0 -3
  681. package/src/registry/index.ts +0 -1
  682. package/src/registry/metadata.ts +16 -64
  683. package/src/registry/registry.ts +3 -13
  684. package/src/registry/verb-support.ts +28 -5
  685. package/src/resources/agent/quality.ts +29 -8
  686. package/src/resources/agent/resolve.ts +3 -3
  687. package/src/resources/apply/apply.ts +58 -49
  688. package/src/resources/apply/handlers.ts +3 -4
  689. package/src/resources/channel.ts +3 -4
  690. package/src/resources/connect/connect.ts +2 -2
  691. package/src/resources/delete.ts +44 -4
  692. package/src/resources/documents.ts +1 -1
  693. package/src/resources/download.ts +239 -43
  694. package/src/resources/eval-run/options.ts +38 -17
  695. package/src/resources/eval-run/report.ts +11 -5
  696. package/src/resources/eval-run/run.ts +13 -9
  697. package/src/resources/file.ts +114 -0
  698. package/src/resources/get-bindings.ts +18 -0
  699. package/src/resources/git.ts +1 -1
  700. package/src/resources/list.ts +178 -34
  701. package/src/resources/plugin.ts +3 -0
  702. package/src/resources/provider-key.ts +327 -0
  703. package/src/resources/reference.ts +41 -85
  704. package/src/resources/render.ts +72 -38
  705. package/src/resources/routine.ts +152 -15
  706. package/src/resources/run/agent-exec.ts +95 -44
  707. package/src/resources/run/create.ts +27 -24
  708. package/src/resources/run/engines.ts +57 -0
  709. package/src/resources/run/environment.ts +43 -0
  710. package/src/resources/run/epilogue.ts +18 -17
  711. package/src/resources/run/files.ts +433 -0
  712. package/src/resources/run/header.ts +18 -18
  713. package/src/resources/run/prepare.ts +67 -74
  714. package/src/resources/run/references.ts +6 -5
  715. package/src/resources/run/resolve.ts +1 -1
  716. package/src/resources/run/resume.ts +28 -9
  717. package/src/resources/run/stream.ts +110 -9
  718. package/src/resources/run/workspace.ts +37 -47
  719. package/src/resources/run-approve.ts +2 -14
  720. package/src/resources/run-control.ts +4 -5
  721. package/src/resources/run-format.ts +3 -4
  722. package/src/resources/run-logs.ts +17 -6
  723. package/src/resources/run-scores.ts +14 -4
  724. package/src/resources/run-to-eval-case.ts +2 -2
  725. package/src/resources/runs.ts +5 -5
  726. package/src/resources/search.ts +1 -2
  727. package/src/resources/service-account.ts +4 -1
  728. package/src/resources/session.ts +10 -7
  729. package/src/resources/skill.ts +7 -8
  730. package/src/resources/stream/answer.ts +3 -19
  731. package/src/resources/stream/composer.ts +170 -0
  732. package/src/resources/stream/ink.tsx +74 -10
  733. package/src/resources/stream/render-plaintext.ts +22 -4
  734. package/src/resources/stream/tty.ts +1 -1
  735. package/src/resources/tag.ts +7 -9
  736. package/src/resources/usage.ts +19 -15
  737. package/src/resources/validate.ts +1 -10
  738. package/src/resources/version.ts +117 -15
  739. package/src/resources/views/agent.ts +60 -0
  740. package/src/resources/views/environment.ts +41 -0
  741. package/src/resources/views/index.ts +82 -0
  742. package/src/resources/views/organization.ts +29 -0
  743. package/src/resources/views/routine.ts +39 -0
  744. package/src/resources/views/run.ts +46 -0
  745. package/src/resources/views/session.ts +91 -0
  746. package/src/resources/views/skill.ts +49 -0
  747. package/src/resources/views/view.ts +188 -0
  748. package/src/resources/views/words.ts +191 -0
  749. package/src/runtime.ts +51 -2
  750. package/errors/exit-codes.d.ts +0 -10
  751. package/errors/exit-codes.d.ts.map +0 -1
  752. package/errors/exit-codes.js +0 -15
  753. package/errors/exit-codes.js.map +0 -1
  754. package/resources/run/attachments.d.ts +0 -24
  755. package/resources/run/attachments.d.ts.map +0 -1
  756. package/resources/run/attachments.js +0 -237
  757. package/resources/run/attachments.js.map +0 -1
  758. package/src/errors/exit-codes.ts +0 -17
  759. package/src/resources/run/attachments.ts +0 -300
  760. package/src/types/marked-terminal.d.ts +0 -31
@@ -1,7 +1,7 @@
1
1
  // `stigmer auth login|logout|whoami` — manage Stigmer Cloud authentication.
2
2
  //
3
- // login is interactive (browser PKCE) and human-only; logout and whoami honor
4
- // the standard mutating-output flags. login and whoami both end in the SDK's
3
+ // login is interactive (browser PKCE); all three honor the standard
4
+ // mutating-output flags, login's result printed once the browser returns. login and whoami both end in the SDK's
5
5
  // ensureMyIdentityAccount (login.ts, whoami.ts): the first-sign-in flow the
6
6
  // console runs, so the CLI provisions an account exactly as the console does.
7
7
 
@@ -19,13 +19,15 @@ export function registerAuth(program: Command): void {
19
19
  .command("auth")
20
20
  .description("manage authentication with Stigmer Cloud");
21
21
 
22
- auth
22
+ const login = auth
23
23
  .command("login")
24
24
  .description("log in to Stigmer Cloud via browser (PKCE OAuth)")
25
- .action(async () => {
25
+ .action(async (options: OutputFlags) => {
26
+ const format = resultFormat(options);
26
27
  const { runLogin } = await import("./login.js");
27
- renderResult(await runLogin(), "human");
28
+ renderResult(await runLogin(), format);
28
29
  });
30
+ addResultFlags(login);
29
31
 
30
32
  const logout = auth
31
33
  .command("logout")
@@ -104,7 +104,7 @@ export async function runWhoami(): Promise<CommandResult> {
104
104
  * The context organization as the backend names it now: its live slug and
105
105
  * id when the caller can see it, else the slug `context set` stored, else
106
106
  * the value as configured. The config catches up with what the backend
107
- * answers: a context an older CLI wrote by slug is rewritten to the id (with
107
+ * answers: a context stored by slug is rewritten to the id (with
108
108
  * the slug beside it), and a stored slug the organization was renamed from
109
109
  * is replaced, so `config context show` shows it too. Printing never fails
110
110
  * the command: any failure of the lookup falls back to what is stored.
@@ -6,13 +6,13 @@ import { addContextCommands } from "./context.js";
6
6
  import { addKvCommands } from "./kv.js";
7
7
 
8
8
  export function registerConfig(program: Command): void {
9
- const config = program.command("config").description("Manage CLI configuration");
9
+ const config = program.command("config").description("manage CLI configuration");
10
10
 
11
11
  addKvCommands(config);
12
12
 
13
- const backend = config.command("backend").description("Manage backend configuration (local vs cloud)");
13
+ const backend = config.command("backend").description("manage backend configuration (local vs cloud)");
14
14
  addBackendCommands(backend);
15
15
 
16
- const context = config.command("context").description("Manage the active CLI context (organization)");
16
+ const context = config.command("context").description("manage the active CLI context (organization)");
17
17
  addContextCommands(context);
18
18
  }
@@ -1,35 +1,39 @@
1
1
  // `stigmer config get|set|list|path` — generic key/value access to the config
2
- // file. get/list/path print plain values to stdout (pipe-friendly); set emits a
3
- // structured result.
2
+ // file. get/list/path print plain values to stdout (pipe-friendly), or with
3
+ // `-o json` one JSON document; set emits a structured result.
4
4
 
5
5
  import type { Command } from "commander";
6
6
  import { configKeyNames, configPath, getConfigValue, load, save, setConfigValue } from "../../config/index.js";
7
- import { CommandResult, type OutputFlags, renderResult } from "../../output/index.js";
8
- import { addResultFlags, resultFormat } from "../shared.js";
7
+ import { CommandResult, type OutputFlags, renderResult, renderValue } from "../../output/index.js";
8
+ import { addResultFlags, addValueFlags, resultFormat } from "../shared.js";
9
9
 
10
10
  export function addKvCommands(config: Command): void {
11
- config
11
+ const path = config
12
12
  .command("path")
13
13
  .description("print the config file path")
14
- .action(() => {
15
- process.stdout.write(configPath() + "\n");
14
+ .action((options: OutputFlags) => {
15
+ renderValue(configPath(), { path: configPath() }, resultFormat(options));
16
16
  });
17
+ addValueFlags(path);
17
18
 
18
- config
19
+ const get = config
19
20
  .command("get <key>")
20
21
  .description("print a single config value")
21
- .action((key: string) => {
22
- process.stdout.write(getConfigValue(load(), key) + "\n");
22
+ .action((key: string, options: OutputFlags) => {
23
+ const value = getConfigValue(load(), key);
24
+ renderValue(value, { key, value }, resultFormat(options));
23
25
  });
26
+ addValueFlags(get);
24
27
 
25
- config
28
+ const list = config
26
29
  .command("list")
27
30
  .description("list all config values")
28
- .action(() => {
31
+ .action((options: OutputFlags) => {
29
32
  const cfg = load();
30
- const lines = configKeyNames().map((key) => `${key}=${getConfigValue(cfg, key)}`);
31
- process.stdout.write(lines.join("\n") + "\n");
33
+ const values = configKeyNames().map((key) => [key, getConfigValue(cfg, key)] as const);
34
+ renderValue(values.map(([key, value]) => `${key}=${value}`).join("\n"), Object.fromEntries(values), resultFormat(options));
32
35
  });
36
+ addValueFlags(list);
33
37
 
34
38
  const set = config
35
39
  .command("set <key> <value>")
@@ -15,11 +15,13 @@ import {
15
15
  resolveOrganization,
16
16
  } from "../config/index.js";
17
17
  import { UsageError } from "../errors/index.js";
18
+ import { renderValue } from "../output/command-result.js";
19
+ import type { OutputFlags } from "../output/format.js";
18
20
  import { shouldColorize } from "../output/style.js";
19
- import { globalOrg } from "./shared.js";
21
+ import { addValueFlags, globalOrg, resultFormat } from "./shared.js";
20
22
  import { omitsOrganization, requireOrganization } from "../client/single-org.js";
21
23
 
22
- interface ConnectFlags {
24
+ interface ConnectFlags extends OutputFlags {
23
25
  server?: string;
24
26
  timeout?: string;
25
27
  dryRun?: boolean;
@@ -32,7 +34,7 @@ export function registerConnect(program: Command): void {
32
34
  .command("connect")
33
35
  .description("connect to external services and discover capabilities");
34
36
 
35
- connect
37
+ const plugin = connect
36
38
  .command("plugin <plugin>")
37
39
  .description("list the tools one of a plugin's MCP servers offers, signing in first when it needs one")
38
40
  .option("--server <name>", "the MCP server, by its name in the plugin (needed when the plugin carries several)")
@@ -48,6 +50,7 @@ export function registerConnect(program: Command): void {
48
50
  .action((reference: string, options: ConnectFlags, command: Command) =>
49
51
  runConnect(reference, options, command),
50
52
  );
53
+ addValueFlags(plugin);
51
54
  }
52
55
 
53
56
  async function runConnect(
@@ -56,6 +59,7 @@ async function runConnect(
56
59
  command: Command,
57
60
  ): Promise<void> {
58
61
  const timeoutMs = parseTimeout(options.timeout);
62
+ const format = resultFormat(options);
59
63
  const [{ connectBackend }, { connectPlugin }, { renderConnectResult }] =
60
64
  await Promise.all([
61
65
  import("../backend.js"),
@@ -89,6 +93,10 @@ async function runConnect(
89
93
  interactive: process.stderr.isTTY === true,
90
94
  });
91
95
 
96
+ if (format === "json") {
97
+ renderValue("", connectResultData(result), format);
98
+ return;
99
+ }
92
100
  const colorize = shouldColorize(process.stdout);
93
101
  const { organizationLabel } = await import("../client/organizations.js");
94
102
  const pluginOrg = result.plugin.metadata?.org ?? "";
@@ -102,6 +110,16 @@ async function runConnect(
102
110
  );
103
111
  }
104
112
 
113
+ // `-o json`: the plugin, the server and the tools it lists.
114
+ function connectResultData(result: import("../resources/connect/connect.js").ConnectResult): unknown {
115
+ return {
116
+ plugin: { org: result.plugin.metadata?.org ?? "", slug: result.plugin.metadata?.slug ?? "", id: result.plugin.metadata?.id ?? "" },
117
+ server: result.server.name,
118
+ dryRun: result.dryRun,
119
+ tools: result.tools.map((tool) => ({ name: tool.name, description: tool.description, destructive: tool.destructive })),
120
+ };
121
+ }
122
+
105
123
  // Parse --timeout seconds into milliseconds.
106
124
  function parseTimeout(raw: string | undefined): number {
107
125
  if (raw === undefined || raw === "") return DEFAULT_TIMEOUT_SECONDS * 1000;
@@ -1,19 +1,28 @@
1
1
  // `stigmer download <type> <ref>` — download what a resource holds as files.
2
- // A run (`run_`, or `aex_` from before the rename) gives back the artifacts
3
- // its agent made; an eval (`<ref>[@<digest|tag>]`) gives back the evals/
4
- // folder one of its versions was pushed as, unzipped into a new or empty
5
- // directory. Heavy modules are lazy-imported inside the action so `--help`
6
- // stays fast.
2
+ // A run (`run_`) gives back its outputs,
3
+ // the files its agent saved in .stigmer/outputs/, each written at its place
4
+ // in that folder; a session gives back what all its turns saved, newest per
5
+ // path; a File gives back its bytes under its filename; an eval
6
+ // (`<ref>[@<digest|tag>]`) gives back the evals/ folder one of its versions
7
+ // was pushed as, unzipped into a new or empty directory.
8
+ //
9
+ // Runs are the one pre-gate alias, as for `list` and `get`: they are not a
10
+ // registered type. Every other type resolves through the registry, is gated
11
+ // on the verb matrix's Download promise, and dispatches through
12
+ // DOWNLOAD_HANDLERS, so the types `list types --verb download` prints are
13
+ // exactly the ones that download. Heavy modules are lazy-imported inside the
14
+ // action so `--help` stays fast.
7
15
  import type { Command } from "commander";
8
- import { ApiResourceKind } from "@stigmer/apis/ai/stigmer/commons/apiresource/apiresourcekind/api_resource_kind_pb";
9
16
  import { ensureAuthenticated, resolveOrganization } from "../config/index.js";
10
- import { UsageError } from "../errors/index.js";
11
- import { type OutputFlags, renderResult } from "../output/index.js";
12
- import { defaultRegistry } from "../registry/index.js";
17
+ import { CliExitError, ExitCode, UsageError } from "../errors/index.js";
18
+ import { type OutputFlags, renderResult, supportedFormats } from "../output/index.js";
19
+ import { defaultRegistry, Verb } from "../registry/index.js";
20
+ import { setActionResourceType } from "../runtime.js";
21
+ import type { DownloadOutcome } from "../resources/download.js";
13
22
  import { addResultFlags, globalOrg, resultFormat } from "./shared.js";
14
23
 
15
24
  interface DownloadFlags extends OutputFlags {
16
- artifact?: string;
25
+ path?: string;
17
26
  outputDir?: string;
18
27
  all?: boolean;
19
28
  }
@@ -22,61 +31,66 @@ export function registerDownload(program: Command): void {
22
31
  const download = program
23
32
  .command("download <type> <ref>")
24
33
  .description(
25
- "download a run's artifacts, or an eval's folder at a version (eval <ref>[@<digest|tag>])",
34
+ "download a run's or a session's outputs, a file, or an eval's folder at a version (eval <ref>[@<digest|tag>])",
26
35
  )
27
- .option("--artifact <name>", "runs: specific artifact to download (by name)")
28
36
  .option(
29
- "-o, --output-dir <dir>",
30
- "output directory (runs: default '.'; evals: a new or empty directory, default ./<slug>)",
37
+ "--path <output-path>",
38
+ "runs and sessions: the one output to download, by its path in .stigmer/outputs/ (a bare filename matches too)",
31
39
  )
32
- .option("--all", "runs: download all artifacts (default)", true)
40
+ .option(
41
+ "--output-dir <dir>",
42
+ "output directory (runs, sessions and files: default '.'; evals: a new or empty directory, default ./<slug>)",
43
+ )
44
+ .option("--all", "runs and sessions: download all outputs (default)", true)
33
45
  .action((type: string, ref: string, options: DownloadFlags, command: Command) =>
34
- isDownloadEvalType(type) ? runDownloadEval(ref, options, command) : runDownload(type, ref, options),
46
+ runDownload(type, ref, options, command),
35
47
  );
36
48
  addResultFlags(download);
37
49
  }
38
50
 
39
- function isDownloadEvalType(type: string): boolean {
40
- return defaultRegistry().getByAlias(type)?.kind === ApiResourceKind.eval;
41
- }
51
+ async function runDownload(type: string, ref: string, options: DownloadFlags, command: Command): Promise<void> {
52
+ refuseDirectoryAsFormat(options, type, ref);
53
+ const { isRunAlias } = await import("../resources/runs.js");
54
+ if (isRunAlias(type)) {
55
+ await runDownloadRun(ref, options);
56
+ return;
57
+ }
42
58
 
43
- /**
44
- * `stigmer download eval <ref>[@<digest|tag>]`: the version the reference
45
- * names (the current one without a suffix), checked against its digest and
46
- * unzipped into a new or empty directory.
47
- */
48
- async function runDownloadEval(input: string, options: DownloadFlags, command: Command): Promise<void> {
49
- const format = resultFormat(options);
50
- const [{ connectBackend }, { idPrefixesFor, parseReference }, evalModule] = await Promise.all([
51
- import("../backend.js"),
52
- import("../resources/reference.js"),
53
- import("../resources/eval.js"),
54
- ]);
55
- const { ref, version } = evalModule.splitEvalVersion(input);
59
+ // A type downloads when the verb matrix promises it and a handler serves
60
+ // it; the registry's conformance suite holds the two equal, so one
61
+ // refusal answers both.
62
+ const info = defaultRegistry().getByAlias(type);
63
+ const { DOWNLOAD_HANDLERS } = await import("../resources/download.js");
64
+ const handler = info?.supportedVerbs.has(Verb.Download) === true ? DOWNLOAD_HANDLERS.get(info.kind) : undefined;
65
+ if (info === undefined || handler === undefined) {
66
+ throw new UsageError(`download not supported for type: ${type}\n\nThe types that download: ${downloadTypes()}`);
67
+ }
68
+ if (handler.answers === "files") refuseResultFlags(options, `a ${info.displayName.toLowerCase()}'s`);
69
+ // A missing reference is answered with the list of its type (errors/classify.ts).
70
+ if (info.supportedVerbs.has(Verb.List)) setActionResourceType(info.singular);
71
+
72
+ const { connectBackend } = await import("../backend.js");
56
73
  const client = connectBackend();
57
74
  ensureAuthenticated(client.config);
58
- const org = resolveOrganization(client.config, globalOrg(command));
59
- const parsed = parseReference(ref, org, idPrefixesFor(ApiResourceKind.eval));
60
- const outcome = await evalModule.downloadEval(client.stigmer, parsed, version, options.outputDir);
61
- renderResult(evalModule.renderEvalDownload(outcome), format);
62
- }
75
+ const request = {
76
+ ref,
77
+ org: resolveOrganization(client.config, globalOrg(command)),
78
+ outputPath: options.path ?? "",
79
+ outputDir: options.outputDir,
80
+ };
63
81
 
64
- function isDownloadRunType(type: string): boolean {
65
- const normalized = type.trim().toLowerCase();
66
- return normalized === "run" || normalized === "runs";
82
+ if (handler.answers === "result") {
83
+ renderResult(await handler.download(client.stigmer, request), resultFormat(options));
84
+ return;
85
+ }
86
+ printOutcome(await handler.download(client.stigmer, request, stderrSink), handler.noun, `${info.singular}: ${ref}`);
67
87
  }
68
88
 
69
- async function runDownload(type: string, id: string, options: DownloadFlags): Promise<void> {
70
- if (!isDownloadRunType(type)) {
71
- throw new UsageError(`download not supported for type: ${type}\n\nThe types that download: run, eval`);
72
- }
73
- // The result flags shape an eval download's answer; a run's download
74
- // prints its files as it writes them, so a flag it would ignore is refused.
75
- if (options.json === true || options.quiet === true) {
76
- throw new UsageError("--json and --quiet apply to `download eval`; a run's download prints the files it writes");
77
- }
89
+ async function runDownloadRun(id: string, options: DownloadFlags): Promise<void> {
90
+ setActionResourceType("run");
91
+ refuseResultFlags(options, "a run's");
78
92
 
79
- const [{ connectBackend }, { isRunId }, { downloadRunArtifacts }] = await Promise.all([
93
+ const [{ connectBackend }, { isRunId }, { downloadRunOutputs }] = await Promise.all([
80
94
  import("../backend.js"),
81
95
  import("../resources/reference.js"),
82
96
  import("../resources/download.js"),
@@ -89,25 +103,55 @@ async function runDownload(type: string, id: string, options: DownloadFlags): Pr
89
103
  const client = connectBackend();
90
104
  ensureAuthenticated(client.config);
91
105
 
92
- const sink = (line: string): void => {
93
- process.stderr.write(`${line}\n`);
94
- };
95
- const outcome = await downloadRunArtifacts(
106
+ const outcome = await downloadRunOutputs(
96
107
  client.stigmer,
97
108
  id,
98
- { artifactName: options.artifact ?? "", outputDir: options.outputDir ?? "." },
99
- sink,
109
+ { outputPath: options.path ?? "", outputDir: options.outputDir ?? "." },
110
+ stderrSink,
100
111
  );
112
+ printOutcome(outcome, "output", `run: ${id}`);
113
+ }
114
+
115
+ // `-o` is the output format on every command; `download -o ./out`, the
116
+ // directory under its old short flag, is refused with the flag it meant.
117
+ function refuseDirectoryAsFormat(options: DownloadFlags, type: string, ref: string): void {
118
+ const output = options.output;
119
+ if (output === undefined || supportedFormats("mutating").includes(output.toLowerCase() as never)) return;
120
+ throw new UsageError(
121
+ `-o is the output format (table or json); the directory is --output-dir:\n stigmer download ${type} ${ref} --output-dir ${output}`,
122
+ );
123
+ }
124
+
125
+ // The result flags shape an eval download's answer; a download that prints
126
+ // its files as it writes them would ignore one, so it is refused.
127
+ function refuseResultFlags(options: DownloadFlags, whose: string): void {
128
+ if (options.json === true || options.quiet === true || options.output !== undefined) {
129
+ throw new UsageError(`-o, --json and --quiet apply to \`download eval\`; ${whose} download prints the files it writes`);
130
+ }
131
+ }
132
+
133
+ // The types that download, from the registry: runs, then every registered
134
+ // type whose verb matrix row promises Download.
135
+ function downloadTypes(): string {
136
+ return ["run", ...defaultRegistry().typesForVerb(Verb.Download).map((info) => info.singular)].join(", ");
137
+ }
101
138
 
102
- if (outcome.noArtifacts) {
103
- process.stdout.write(`\nNo artifacts found for run: ${id}\n\n`);
104
- process.stdout.write("Tip: Artifacts are files created by the agent during a run. Not all agents produce artifacts.\n\n");
139
+ function stderrSink(line: string): void {
140
+ process.stderr.write(`${line}\n`);
141
+ }
142
+
143
+ function printOutcome(outcome: DownloadOutcome, noun: string, subject: string): void {
144
+ if (outcome.noOutputs) {
145
+ process.stdout.write(`\nNo outputs found for ${subject}\n\n`);
146
+ process.stdout.write("Tip: outputs are the files an agent saves in .stigmer/outputs/. Not every run saves one.\n\n");
105
147
  return;
106
148
  }
107
149
 
108
150
  if (outcome.downloaded === outcome.total) {
109
- process.stdout.write(`\nDownloaded ${outcome.downloaded} artifact(s) successfully\n`);
110
- } else {
111
- process.stdout.write(`\nDownloaded ${outcome.downloaded} of ${outcome.total} artifacts\n`);
151
+ process.stdout.write(`\nDownloaded ${outcome.downloaded} ${noun}(s) successfully\n`);
152
+ return;
112
153
  }
154
+ // A partial download still writes what it could, but a script branching
155
+ // on `$?` must not read it as done.
156
+ throw new CliExitError(`downloaded ${outcome.downloaded} of ${outcome.total} ${noun}s`, ExitCode.General);
113
157
  }
@@ -23,20 +23,14 @@
23
23
  import type { Command } from "commander";
24
24
  import { ensureAuthenticated, resolveOrganization } from "../config/index.js";
25
25
  import type { EvalRunFlags } from "../resources/eval-run/options.js";
26
- import { globalOrg } from "./shared.js";
26
+ import { engineChoice } from "../resources/run/engines.js";
27
+ import { ExitCode } from "@stigmer/client/exit-codes";
28
+ import { usageExitCode } from "../errors/command-line.js";
29
+ import type { OutputFlags } from "../output/format.js";
30
+ import { addResultFlags, globalOrg, resultFormat } from "./shared.js";
27
31
 
28
- /** `eval run`'s help after the options: the model and tools a try runs with, and the exit codes. */
32
+ /** `eval run`'s help after the options: the model and tools a try runs with, and the exit codes (its examples are help.ts's). */
29
33
  const EVAL_HELP = `
30
- Examples:
31
- stigmer eval run --plugin refund-policy
32
- the plugin's own cases on the built-in assistant, with and without it
33
- stigmer eval run --agent support-agent
34
- the cases of every plugin the agent attaches, on the agent
35
- stigmer eval run --agent support-agent --eval support-agent-evals
36
- the cases of an Eval pushed with stigmer push eval, on the agent
37
- stigmer eval run --agent support-agent --plugin refund-policy
38
- the plugin's cases on the agent, with and without the plugin
39
-
40
34
  On an agent, without --model, each case runs on the agent as it runs: its
41
35
  own engine, model and settings. A model named with --model runs without the
42
36
  agent's own tier and thinking settings, as any conversation that names a
@@ -62,7 +56,7 @@ export function registerEval(program: Command): void {
62
56
  .command("eval")
63
57
  .description("run test cases on an agent or a plugin, with and without a plugin, and score them");
64
58
 
65
- evalGroup
59
+ const run = evalGroup
66
60
  .command("run")
67
61
  .description("run test cases on an agent, or a plugin's own cases on the built-in assistant, and score them")
68
62
  .option(
@@ -88,7 +82,7 @@ export function registerEval(program: Command): void {
88
82
  .option("--runs <n>", "tries per case, arm and model, 1 to 50 (default: each case's runs, else 3)")
89
83
  .option(
90
84
  "--model <harness/model>",
91
- "an engine and model to run on, as native/claude-sonnet-4-6 or cursor/gpt-5 (repeatable, up to 6)",
85
+ `a harness and model to run on: stigmer/<model> for ${engineChoice("stigmer")} or claude/<model> for ${engineChoice("claude")}, as stigmer/claude-sonnet-4-6 (repeatable, up to 6)`,
92
86
  collect,
93
87
  )
94
88
  .option("--ablation <mode>", "with --plugin: with-without also runs each case without the plugin; none runs one arm")
@@ -105,15 +99,20 @@ export function registerEval(program: Command): void {
105
99
  .option("--allow-real-servers", "also start the plugins' real MCP servers that no mock answers")
106
100
  .option("--no-scaffold", "skip each case's scaffold script, listing such a case as not run")
107
101
  .option("--scaffold", "accepted for Claude Code's command lines; a scaffold always runs, in the try's own sandbox")
102
+ .option("-o, --output <format>", "output format: table (progress and the scores) or json (the result document)")
108
103
  .option("--json [path]", "print the result document, or write it to a path ending in .json; no progress or table")
109
104
  .option("--no-wait", "start the eval run, print its id, and return")
110
105
  .addHelpText("after", EVAL_HELP)
111
106
  .action((options: EvalRunFlags, command: Command) => runEvalRunCommand(options, command));
107
+ // An invalid option exits 1 on this command (the plugin-eval table, where 2 is a partial run).
108
+ usageExitCode(run, ExitCode.General);
112
109
 
113
- evalGroup
114
- .command("cancel <eval-run-id>")
115
- .description("cancel a running eval run; the tries that finished keep their results")
116
- .action((id: string) => runCancel(id));
110
+ addResultFlags(
111
+ evalGroup
112
+ .command("cancel <eval-run-id>")
113
+ .description("cancel a running eval run; the tries that finished keep their results")
114
+ .action((id: string, options: OutputFlags) => runCancel(id, options)),
115
+ );
117
116
  }
118
117
 
119
118
  async function runEvalRunCommand(flags: EvalRunFlags, command: Command): Promise<void> {
@@ -137,12 +136,14 @@ async function runEvalRunCommand(flags: EvalRunFlags, command: Command): Promise
137
136
  }
138
137
  }
139
138
 
140
- async function runCancel(id: string): Promise<void> {
141
- const [{ cancelEvalRun }, { connectBackend }] = await Promise.all([
139
+ async function runCancel(id: string, options: OutputFlags): Promise<void> {
140
+ const format = resultFormat(options);
141
+ const [{ cancelEvalRun }, { connectBackend }, { renderResult }] = await Promise.all([
142
142
  import("../resources/eval-run/run.js"),
143
143
  import("../backend.js"),
144
+ import("../output/command-result.js"),
144
145
  ]);
145
146
  const client = connectBackend();
146
147
  ensureAuthenticated(client.config);
147
- await cancelEvalRun(client.stigmer, id, { stderr: process.stderr });
148
+ renderResult(await cancelEvalRun(client.stigmer, id), format);
148
149
  }
@@ -0,0 +1,80 @@
1
+ // `stigmer file upload <path>…` — upload files on disk as Files and print
2
+ // the id each one is named by from then on.
3
+ //
4
+ // Uploading is the one act on a File that no registry verb names: get, list,
5
+ // delete and download ride the generic verbs (`stigmer get file <id>`,
6
+ // `stigmer list files`), so this group holds only the upload, the `stigmer
7
+ // routine` shape. `push` is not the word: it publishes a version under a
8
+ // digest and a tag, and a File has neither.
9
+ //
10
+ // Thin handler: resolve credentials, the organization (a conversation's own
11
+ // when `--session` names one) and the target, delegate to resources/file,
12
+ // render the result. Heavy modules are lazy-imported so `--help` stays fast.
13
+
14
+ import type { Command } from "commander";
15
+ import { ensureAuthenticated, resolveOrganization } from "../config/index.js";
16
+ import { UsageError } from "../errors/index.js";
17
+ import type { OutputFlags } from "../output/index.js";
18
+ import { addResultFlags, globalOrg, resultFormat } from "./shared.js";
19
+
20
+ interface UploadFlags extends OutputFlags {
21
+ session?: string;
22
+ }
23
+
24
+ export function registerFile(program: Command): void {
25
+ const file = program.command("file").description("upload files to name in conversations and routines");
26
+
27
+ const upload = file
28
+ .command("upload <paths...>")
29
+ .description("upload files as Files and print the id each is named by (a folder is refused)")
30
+ .option(
31
+ "--session <id>",
32
+ "give the files to this conversation: its Files from the start, found by its agent under .stigmer/uploads/; omitted, they are your own, kept for reuse",
33
+ )
34
+ .action((paths: string[], options: UploadFlags, command: Command) => runUpload(paths, options, command));
35
+ addResultFlags(upload);
36
+ }
37
+
38
+ async function runUpload(paths: string[], options: UploadFlags, command: Command): Promise<void> {
39
+ const format = resultFormat(options);
40
+
41
+ const [{ connectBackend }, { isSessionId }, { renderUploadedFiles, uploadFiles }, { renderResult }, { requireOrganization }] =
42
+ await Promise.all([
43
+ import("../backend.js"),
44
+ import("../resources/reference.js"),
45
+ import("../resources/file.js"),
46
+ import("../output/command-result.js"),
47
+ import("../client/single-org.js"),
48
+ ]);
49
+
50
+ const sessionId = options.session ?? "";
51
+ if (options.session !== undefined && !isSessionId(sessionId)) {
52
+ throw new UsageError(`invalid session ID: ${sessionId}\n\nA conversation is named by its ID (e.g., ses_01abc123)`);
53
+ }
54
+
55
+ const client = connectBackend();
56
+ ensureAuthenticated(client.config);
57
+
58
+ let org: string;
59
+ // Read before any byte moves: a conversation that cannot be read fails
60
+ // the command with nothing uploaded, and its etag guards the update that
61
+ // gives it the Files.
62
+ const session = sessionId === "" ? undefined : await client.stigmer.session.get(sessionId);
63
+ if (session !== undefined) {
64
+ // A conversation names its own organization, and its Files live there
65
+ // whatever the context organization is.
66
+ org = session.metadata?.org ?? "";
67
+ } else {
68
+ org = resolveOrganization(client.config, globalOrg(command));
69
+ await requireOrganization(client.stigmer, org, [
70
+ "stigmer file upload <path> --org <org>",
71
+ "stigmer config context set --org <org>",
72
+ ]);
73
+ }
74
+
75
+ const progress = (line: string): void => {
76
+ if (format !== "json" && format !== "quiet") process.stderr.write(`${line}\n`);
77
+ };
78
+ const uploaded = await uploadFiles(client.stigmer, paths, { org, session }, progress);
79
+ renderResult(renderUploadedFiles(uploaded, sessionId), format);
80
+ }