@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,29 +1,42 @@
1
- // `download run`: stream a run's artifacts to disk via short-lived
2
- // presigned URLs. Partial-failure tolerant — a failed artifact is reported and
3
- // skipped, never aborting the batch (mirrors Go's downloadExecutionArtifacts).
1
+ // What `stigmer download <type> <ref>` writes, by kind. A run (the one
2
+ // pre-gate alias, as for `list` and `get`) and a session give back what
3
+ // their turns saved in the outputs folder, each File at its place in that
4
+ // folder, newest per path; a File gives back its bytes under its filename;
5
+ // an eval gives back one version of its evals/ folder. Downloads go through
6
+ // short-lived links minted per File and are partial-failure tolerant: a
7
+ // File that fails is reported and skipped, never aborting the batch. A
8
+ // File's output path is checked by the server when the runner registers it;
9
+ // it is checked again here, so a path that would land outside the chosen
10
+ // directory is refused whatever the server answered.
11
+ //
12
+ // DOWNLOAD_HANDLERS is the verb's dispatch map, beside LIST_HANDLERS and
13
+ // DELETE_HANDLERS, and the conformance test in registry/registry.test.ts
14
+ // holds it to the verb matrix's Download promises.
4
15
 
5
16
  import { createWriteStream, mkdirSync } from "node:fs";
6
- import { dirname, join } from "node:path";
17
+ import { dirname, isAbsolute, relative, resolve, sep } from "node:path";
7
18
  import { Readable } from "node:stream";
8
19
  import { pipeline } from "node:stream/promises";
9
20
  import type { ReadableStream as NodeReadableStream } from "node:stream/web";
10
- import { create } from "@bufbuild/protobuf";
11
- import type { RunArtifact } from "@stigmer/apis/ai/stigmer/agentic/run/v1/artifact_pb";
21
+ import type { File } from "@stigmer/apis/ai/stigmer/agentic/file/v1/api_pb";
12
22
  import { RunPhase } from "@stigmer/apis/ai/stigmer/agentic/run/v1/enum_pb";
13
- import { GetArtifactDownloadUrlRequestSchema } from "@stigmer/apis/ai/stigmer/agentic/run/v1/io_pb";
23
+ import { ApiResourceKind } from "@stigmer/apis/ai/stigmer/commons/apiresource/apiresourcekind/api_resource_kind_pb";
14
24
  import type { Stigmer } from "@stigmer/client";
15
- import { CliExitError, ExitCode } from "../errors/index.js";
25
+ import { CliExitError, ExitCode, UsageError } from "../errors/index.js";
26
+ import type { CommandResult } from "../output/index.js";
27
+ import { idPrefixOf, isSessionId, parseReference } from "./reference.js";
16
28
  import { formatBytes } from "./skill.js";
17
29
 
18
30
  export interface DownloadParams {
19
- readonly artifactName: string;
31
+ /** An output path (`reports/q3.md`) or a bare filename; empty takes every output. */
32
+ readonly outputPath: string;
20
33
  readonly outputDir: string;
21
34
  }
22
35
 
23
36
  export interface DownloadOutcome {
24
37
  readonly total: number;
25
38
  readonly downloaded: number;
26
- readonly noArtifacts: boolean;
39
+ readonly noOutputs: boolean;
27
40
  /** Set when the run is not yet terminal (a soft warning, not an error). */
28
41
  readonly incompletePhase?: string;
29
42
  }
@@ -38,7 +51,7 @@ const TERMINAL_PHASES: ReadonlySet<RunPhase> = new Set([
38
51
  RunPhase.RUN_TERMINATED,
39
52
  ]);
40
53
 
41
- export async function downloadRunArtifacts(
54
+ export async function downloadRunOutputs(
42
55
  client: Stigmer,
43
56
  runId: string,
44
57
  params: DownloadParams,
@@ -48,53 +61,146 @@ export async function downloadRunArtifacts(
48
61
  const phase = run.status?.phase ?? RunPhase.RUN_PHASE_UNSPECIFIED;
49
62
  const incompletePhase = TERMINAL_PHASES.has(phase) ? undefined : formatDownloadPhase(phase);
50
63
  if (incompletePhase !== undefined) {
51
- progress?.(`Run is still ${incompletePhase}. Artifacts may not be complete until the run finishes.`);
64
+ progress?.(`Run is still ${incompletePhase}. Its outputs may not be complete until the run finishes.`);
52
65
  }
53
66
 
54
- let artifacts = run.status?.artifacts ?? [];
55
- if (artifacts.length === 0) {
56
- return { total: 0, downloaded: 0, noArtifacts: true, incompletePhase };
57
- }
67
+ const files = await newestPerPlace(client.file.listAll({ org: run.metadata?.org ?? "", runId }));
68
+ const outcome = await writeOutputs(client, files, params, `stigmer get run ${runId}`, progress);
69
+ return { ...outcome, incompletePhase };
70
+ }
58
71
 
59
- if (params.artifactName !== "") {
60
- artifacts = artifacts.filter((a) => a.name === params.artifactName);
61
- if (artifacts.length === 0) {
62
- throw new CliExitError(
63
- `artifact not found: ${params.artifactName}\n\n` +
64
- `Use 'stigmer get run ${runId}' to see available artifacts`,
65
- ExitCode.General,
66
- );
72
+ /**
73
+ * `download session`: what every turn of the conversation saved in its
74
+ * outputs folder, one File per place, the newest turn's winning; the Files
75
+ * given to the conversation are its inputs and stay out. A conversation
76
+ * names its own organization, so its Files are listed there.
77
+ */
78
+ export async function downloadSessionOutputs(
79
+ client: Stigmer,
80
+ sessionId: string,
81
+ params: DownloadParams,
82
+ progress?: ProgressSink,
83
+ ): Promise<DownloadOutcome> {
84
+ const session = await client.session.get(sessionId);
85
+ if ((session.status?.state ?? "") === "running") {
86
+ progress?.("A turn is still running. Its outputs may not be complete until it finishes.");
87
+ }
88
+ const outputs = (async function* () {
89
+ for await (const file of client.file.listAll({ org: session.metadata?.org ?? "", sessionId })) {
90
+ if ((file.status?.runId ?? "") !== "") yield file;
67
91
  }
92
+ })();
93
+ const files = await newestPerPlace(outputs);
94
+ return writeOutputs(client, files, params, `stigmer list files --session ${sessionId}`, progress);
95
+ }
96
+
97
+ /** `download file`: one File's bytes, written under its filename. */
98
+ export async function downloadFile(
99
+ client: Stigmer,
100
+ fileId: string,
101
+ outputDir: string,
102
+ progress?: ProgressSink,
103
+ ): Promise<DownloadOutcome> {
104
+ const file = await client.file.get(fileId);
105
+ const name = file.spec?.filename ?? "";
106
+ mkdirSync(outputDir, { recursive: true });
107
+ try {
108
+ const written = await downloadSingle(client, file, name, outputDir, progress);
109
+ progress?.(` Downloaded ${name} (${formatBytes(written)})`);
110
+ return { total: 1, downloaded: 1, noOutputs: false };
111
+ } catch (err) {
112
+ progress?.(` Failed to download ${name}: ${(err as Error).message}`);
113
+ return { total: 1, downloaded: 0, noOutputs: false };
114
+ }
115
+ }
116
+
117
+ // Write each output at its place under the output directory, narrowed to
118
+ // the named one when `--path` names it. `listCommand` is the command
119
+ // that shows what could have been named.
120
+ async function writeOutputs(
121
+ client: Stigmer,
122
+ all: readonly File[],
123
+ params: DownloadParams,
124
+ listCommand: string,
125
+ progress?: ProgressSink,
126
+ ): Promise<DownloadOutcome> {
127
+ if (all.length === 0) {
128
+ return { total: 0, downloaded: 0, noOutputs: true };
129
+ }
130
+ const files =
131
+ params.outputPath === ""
132
+ ? all
133
+ : all.filter((f) => f.spec?.filename === params.outputPath || f.status?.outputPath === params.outputPath);
134
+ if (files.length === 0) {
135
+ throw new CliExitError(
136
+ `output not found: ${params.outputPath}\n\n` + `Use '${listCommand}' to see available outputs`,
137
+ ExitCode.General,
138
+ );
68
139
  }
69
140
 
70
141
  mkdirSync(params.outputDir, { recursive: true });
71
142
 
72
143
  let downloaded = 0;
73
- for (const artifact of artifacts) {
144
+ for (const file of files) {
145
+ const path = placeOf(file);
74
146
  try {
75
- const written = await downloadSingle(client, runId, artifact, params.outputDir, progress);
76
- progress?.(` Downloaded ${artifact.name} (${formatBytes(written)})`);
147
+ const written = await downloadSingle(client, file, path, params.outputDir, progress);
148
+ progress?.(` Downloaded ${path} (${formatBytes(written)})`);
77
149
  downloaded++;
78
150
  } catch (err) {
79
- progress?.(` Failed to download ${artifact.name}: ${(err as Error).message}`);
151
+ progress?.(` Failed to download ${path}: ${(err as Error).message}`);
80
152
  }
81
153
  }
82
154
 
83
- return { total: artifacts.length, downloaded, noArtifacts: false, incompletePhase };
155
+ return { total: files.length, downloaded, noOutputs: false };
156
+ }
157
+
158
+ /**
159
+ * One File per place in the outputs folder: the list answers newest first,
160
+ * so a path written twice keeps its newest File.
161
+ */
162
+ async function newestPerPlace(listed: AsyncIterable<File>): Promise<File[]> {
163
+ const byPlace = new Map<string, File>();
164
+ for await (const file of listed) {
165
+ const place = placeOf(file);
166
+ if (!byPlace.has(place)) byPlace.set(place, file);
167
+ }
168
+ return [...byPlace.values()];
169
+ }
170
+
171
+ /** Where a File sits in the outputs folder; its filename when it has no path. */
172
+ function placeOf(file: File): string {
173
+ const outputPath = file.status?.outputPath ?? "";
174
+ return outputPath !== "" ? outputPath : (file.spec?.filename ?? "");
175
+ }
176
+
177
+ /**
178
+ * `path` under `dir`. One check on where the path resolves refuses every
179
+ * shape that would not land strictly inside `dir`: empty or `.` (the
180
+ * directory itself), absolute, or climbing out through `..`.
181
+ */
182
+ function destinationOf(dir: string, path: string): string {
183
+ const root = resolve(dir);
184
+ const dest = resolve(root, path);
185
+ const rel = relative(root, dest);
186
+ if (rel === "" || rel === ".." || rel.startsWith(`..${sep}`) || isAbsolute(rel)) {
187
+ throw new Error(`refusing a path outside the output directory: ${path}`);
188
+ }
189
+ return dest;
84
190
  }
85
191
 
86
192
  async function downloadSingle(
87
193
  client: Stigmer,
88
- runId: string,
89
- artifact: RunArtifact,
194
+ file: File,
195
+ path: string,
90
196
  outputDir: string,
91
197
  progress?: ProgressSink,
92
198
  ): Promise<number> {
93
- const url = await resolveDownloadUrl(client, runId, artifact);
94
- const destPath = join(outputDir, artifact.name);
199
+ const destPath = destinationOf(outputDir, path);
200
+ const url = await resolveDownloadUrl(client, file);
95
201
  mkdirSync(dirname(destPath), { recursive: true });
96
202
 
97
- progress?.(` Downloading ${artifact.name} (${formatBytes(Number(artifact.sizeBytes))})...`);
203
+ progress?.(` Downloading ${path} (${formatBytes(Number(file.status?.sizeBytes ?? 0n))})...`);
98
204
 
99
205
  const response = await fetch(url);
100
206
  if (!response.ok || response.body === null) {
@@ -118,19 +224,17 @@ async function downloadSingle(
118
224
  }
119
225
 
120
226
  /**
121
- * Mint a fresh presigned URL on demand from the artifact's stable storage key.
122
- * There is deliberately no cached-URL fallback: a persisted URL would have
123
- * expired, so the refresh RPC is the single source of a working URL.
227
+ * Mint a fresh download link for the File. There is deliberately no cached
228
+ * link: a stored one would have expired, so the server is the single source
229
+ * of a working URL.
124
230
  */
125
- async function resolveDownloadUrl(client: Stigmer, runId: string, artifact: RunArtifact): Promise<string> {
126
- const response = await client.run.getArtifactDownloadUrl(
127
- create(GetArtifactDownloadUrlRequestSchema, { runId, storageKey: artifact.storageKey }),
128
- );
129
- if (response.downloadUrl !== "") return response.downloadUrl;
231
+ async function resolveDownloadUrl(client: Stigmer, file: File): Promise<string> {
232
+ const response = await client.file.getDownloadUrl(file.metadata?.id ?? "");
233
+ if (response.url !== "") return response.url;
130
234
  throw new Error("failed to get download URL");
131
235
  }
132
236
 
133
- // Human-readable non-terminal phase label (matches Go's formatPhaseForDownload).
237
+ // Human-readable non-terminal phase label.
134
238
  function formatDownloadPhase(phase: RunPhase): string {
135
239
  switch (phase) {
136
240
  case RunPhase.RUN_PENDING:
@@ -145,3 +249,95 @@ function formatDownloadPhase(phase: RunPhase): string {
145
249
  return "unknown";
146
250
  }
147
251
  }
252
+
253
+ /** What `stigmer download <type> <ref>` was asked for. */
254
+ export interface DownloadRequest {
255
+ /** The reference as typed: an id, or for an eval `<ref>[@<digest|tag>]`. */
256
+ readonly ref: string;
257
+ /** The resolved context organization, for a reference by slug. */
258
+ readonly org: string;
259
+ /** `--path`; "" takes every output. */
260
+ readonly outputPath: string;
261
+ /** `-o`; undefined lets the kind choose its default. */
262
+ readonly outputDir: string | undefined;
263
+ }
264
+
265
+ /**
266
+ * One kind's download. A kind answers in one of two ways, known before any
267
+ * call so the command layer can refuse a flag the answer would ignore:
268
+ * `result`, a summary the result flags (--json, --quiet) shape (an eval's
269
+ * folder); or `files`, each File printed as it is written and the count at
270
+ * the end (a session's outputs, a File).
271
+ */
272
+ export type DownloadHandler =
273
+ | {
274
+ readonly answers: "result";
275
+ download(client: Stigmer, request: DownloadRequest): Promise<CommandResult>;
276
+ }
277
+ | {
278
+ readonly answers: "files";
279
+ /** The word the closing count uses for what was written. */
280
+ readonly noun: string;
281
+ download(client: Stigmer, request: DownloadRequest, progress: ProgressSink): Promise<DownloadOutcome>;
282
+ };
283
+
284
+ // The download handlers. Every registered kind declaring Download in the
285
+ // verb matrix must appear here — the conformance test enforces it, so the
286
+ // two cannot drift. Runs are the pre-gate alias and download through
287
+ // downloadRunOutputs.
288
+ export const DOWNLOAD_HANDLERS: ReadonlyMap<ApiResourceKind, DownloadHandler> = new Map<
289
+ ApiResourceKind,
290
+ DownloadHandler
291
+ >([
292
+ [
293
+ ApiResourceKind.eval,
294
+ {
295
+ answers: "result",
296
+ async download(client, request) {
297
+ // Lazy: the eval module carries the archive tooling, which a run's
298
+ // own download (imported by `run`) never needs.
299
+ const evals = await import("./eval.js");
300
+ const { ref, version } = evals.splitEvalVersion(request.ref);
301
+ const parsed = parseReference(ref, request.org, idPrefixOf(ApiResourceKind.eval));
302
+ return evals.renderEvalDownload(await evals.downloadEval(client, parsed, version, request.outputDir));
303
+ },
304
+ },
305
+ ],
306
+ [
307
+ ApiResourceKind.session,
308
+ {
309
+ answers: "files",
310
+ noun: "output",
311
+ async download(client, request, progress) {
312
+ if (!isSessionId(request.ref)) {
313
+ throw new UsageError(
314
+ `invalid session ID: ${request.ref}\n\nA conversation is named by its ID (e.g., ses_01abc123)`,
315
+ );
316
+ }
317
+ return downloadSessionOutputs(
318
+ client,
319
+ request.ref,
320
+ { outputPath: request.outputPath, outputDir: request.outputDir ?? "." },
321
+ progress,
322
+ );
323
+ },
324
+ },
325
+ ],
326
+ [
327
+ ApiResourceKind.file,
328
+ {
329
+ answers: "files",
330
+ noun: "file",
331
+ async download(client, request, progress) {
332
+ if (request.outputPath !== "") {
333
+ throw new UsageError("--path picks among a run's or a session's outputs; a File is one file");
334
+ }
335
+ const parsed = parseReference(request.ref, request.org, idPrefixOf(ApiResourceKind.file));
336
+ if (parsed.kind !== "id") {
337
+ throw new UsageError(`a File is named by its ID (e.g., file_01abc123), not '${request.ref}'`);
338
+ }
339
+ return downloadFile(client, parsed.id, request.outputDir ?? ".", progress);
340
+ },
341
+ },
342
+ ],
343
+ ]);
@@ -20,9 +20,9 @@
20
20
  // Stigmer has the same idea (`--case`, `--tag`, `--runs`, `--ablation`,
21
21
  // `--threshold`, `--max-cost-usd`, `-j`, `--allow-tools`, `--judge-model`,
22
22
  // `--json`), so a command line moves between the two. Two differ.
23
- // `--model` names an engine and a model, `native/claude-sonnet-4-6` or
24
- // `cursor/gpt-5`, because Stigmer runs a model on one of its engines; a
25
- // bare model id is the native engine's. With no `--model` an eval run
23
+ // `--model` names an engine and a model, `stigmer/claude-sonnet-4-6` or
24
+ // `claude/claude-sonnet-5`, because Stigmer runs a model on one of its engines; a
25
+ // bare model id is the Stigmer harness's. With no `--model` an eval run
26
26
  // about an agent runs each case on the agent as it runs: its own engine,
27
27
  // model and settings. `--max-cost-usd` is required by the API, so the CLI
28
28
  // fills 5 when it is omitted and says so. `--mocks off` (and its older
@@ -40,9 +40,10 @@
40
40
 
41
41
  import { ALLOW_TOOL_PATTERN } from "@stigmer/client";
42
42
  import { EvalRunAblation } from "@stigmer/apis/ai/stigmer/agentic/evalrun/v1/spec_pb";
43
- import { Harness } from "@stigmer/apis/ai/stigmer/agentic/session/v1/enum_pb";
43
+ import { ENGINES, ENGINE_WORDS, engineChoice, isEngineWord } from "../run/engines.js";
44
44
  import type { EvalRunTargetInput } from "@stigmer/client";
45
45
  import { CliExitError } from "../../errors/index.js";
46
+ import { resolveFormat } from "../../output/format.js";
46
47
 
47
48
  /** The exit code of an invalid option, as the format has it. */
48
49
  export const INVALID_OPTION_EXIT = 1;
@@ -88,6 +89,8 @@ export interface EvalRunFlags {
88
89
  readonly scaffold?: boolean;
89
90
  /** `true` for bare `--json`, a path for `--json <path>`. */
90
91
  readonly json?: boolean | string;
92
+ /** `-o/--output`: `json` prints the result document as bare `--json` does; `table` is the progress and table. */
93
+ readonly output?: string;
91
94
  /** False under `--no-wait`. */
92
95
  readonly wait?: boolean;
93
96
  }
@@ -167,7 +170,7 @@ export function parseEvalTarget(raw: string): EvalTarget {
167
170
  const ref = at < 0 ? trimmed : trimmed.slice(0, at);
168
171
  const version = at < 0 ? "" : trimmed.slice(at + 1);
169
172
  if (ref === "" || ref.length > MAX_REFERENCE) {
170
- throw invalid("--eval names an Eval of the agent's organization, as in --eval support-agent-evals");
173
+ throw invalid("--eval names an Eval of the agent's organization, as in --eval variance-reporter-evals");
171
174
  }
172
175
  if (at >= 0 && (version === "" || version.length > MAX_NAME || /\s/.test(version))) {
173
176
  throw invalid(
@@ -223,14 +226,14 @@ function subjectOf(flags: EvalRunFlags): EvalRunSubjectTarget {
223
226
  if (flags.agent === undefined) {
224
227
  if (flags.plugin === undefined) {
225
228
  throw invalid(
226
- "name what to evaluate: --agent <agent>, --plugin <plugin>, or both, as in `stigmer eval run --agent support-agent --plugin refund-policy`",
229
+ "name what to evaluate: --agent <agent>, --plugin <plugin>, or both, as in `stigmer eval run --agent variance-reporter --plugin payroll`",
227
230
  );
228
231
  }
229
232
  if (casesFrom.length > 0) {
230
233
  throw invalid("--cases-from chooses whose cases run on an agent: --plugin alone runs that plugin's own cases");
231
234
  }
232
235
  if (evalFlags.length > 0) {
233
- throw invalid("--eval runs an Eval's cases on an agent: name one with --agent, as in `stigmer eval run --agent support-agent --eval support-agent-evals`");
236
+ throw invalid("--eval runs an Eval's cases on an agent: name one with --agent, as in `stigmer eval run --agent variance-reporter --eval variance-reporter-evals`");
234
237
  }
235
238
  return { kind: "plugin", plugin: parsePluginTarget(flags.plugin) };
236
239
  }
@@ -313,23 +316,23 @@ function sharedOptionsOf(flags: EvalRunFlags): Omit<EvalRunOptions, "subject" |
313
316
  realMcpServers,
314
317
  allowRealServers,
315
318
  skipScaffold: flags.scaffold === false,
316
- json: jsonTargetOf(flags.json),
319
+ json: jsonTargetOf(flags.json, flags.output),
317
320
  wait: flags.wait !== false,
318
321
  };
319
322
  }
320
323
 
321
- /** Reads `<harness>/<model>`; a bare model is the native engine's. */
324
+ /** Reads `<harness>/<model>`; a bare model is the Stigmer harness's. */
322
325
  export function parseTarget(raw: string): EvalRunTargetInput {
323
326
  const trimmed = raw.trim();
324
327
  const slash = trimmed.indexOf("/");
325
- const engine = slash < 0 ? "native" : trimmed.slice(0, slash).toLowerCase();
328
+ const engine = slash < 0 ? "stigmer" : trimmed.slice(0, slash).toLowerCase();
326
329
  const model = slash < 0 ? trimmed : trimmed.slice(slash + 1);
327
- const harness = engine === "native" ? Harness.NATIVE : engine === "cursor" ? Harness.CURSOR : undefined;
328
- if (harness === undefined) {
329
- throw invalid(`--model '${raw}' names no engine Stigmer runs: write native/<model> or cursor/<model>`);
330
+ if (!isEngineWord(engine)) {
331
+ throw invalid(`--model '${raw}' names no harness Stigmer runs: write ${ENGINE_WORDS.map((word) => `${word}/<model> for ${engineChoice(word)}`).join(", ")}`);
330
332
  }
333
+ const { harness } = ENGINES[engine];
331
334
  if (model === "" || model.length > 128 || /\s/.test(model)) {
332
- throw invalid(`--model '${raw}' names no model: write ${engine}/<model id>, as in native/claude-sonnet-4-6`);
335
+ throw invalid(`--model '${raw}' names no model: write ${engine}/<model id>, as in stigmer/claude-sonnet-4-6`);
333
336
  }
334
337
  return { harness, modelName: model === "default" ? "" : model };
335
338
  }
@@ -360,9 +363,27 @@ function ablationOf(flags: EvalRunFlags): EvalRunAblation {
360
363
  }
361
364
  }
362
365
 
363
- function jsonTargetOf(raw: boolean | string | undefined): JsonTarget {
364
- if (raw === undefined || raw === false) return { kind: "none" };
365
- if (raw === true) return { kind: "stdout" };
366
+ // `-o` resolved by the result class; a value it refuses is an invalid option,
367
+ // which on this command exits 1 like every other.
368
+ function formatOf(output: string | undefined): string {
369
+ try {
370
+ return resolveFormat({ output }, "mutating");
371
+ } catch (error) {
372
+ throw invalid(error instanceof Error ? error.message : String(error));
373
+ }
374
+ }
375
+
376
+ // `--json <path>` writes the document to a file; `--json` or `-o json`
377
+ // prints it; `-o` resolves through the result class, so a value it does not
378
+ // support is refused the way every command refuses it.
379
+ function jsonTargetOf(raw: boolean | string | undefined, output: string | undefined): JsonTarget {
380
+ const format = formatOf(output);
381
+ if (typeof raw === "string") return jsonFileOf(raw);
382
+ if (raw === true || format === "json") return { kind: "stdout" };
383
+ return { kind: "none" };
384
+ }
385
+
386
+ function jsonFileOf(raw: string): JsonTarget {
366
387
  if (!raw.endsWith(".json")) {
367
388
  throw invalid(`--json output path must end in .json, not '${raw}'`);
368
389
  }
@@ -55,7 +55,7 @@ import {
55
55
  type EvalRunCaseTarget,
56
56
  type EvalRunTry,
57
57
  } from "@stigmer/apis/ai/stigmer/agentic/evalrun/v1/status_pb";
58
- import { renderTable } from "../../output/index.js";
58
+ import { renderTable, terminalWidth, type TerminalStream } from "../../output/index.js";
59
59
 
60
60
  /** The exit codes of `eval run`, as Claude Code's `claude plugin eval` has them. */
61
61
  export const EvalExit = {
@@ -130,8 +130,10 @@ function finishedTriesOf(cases: readonly EvalRunCase[], scope: CaseScope): Finis
130
130
  * The table blocks, plugin by plugin in the eval run's order: one per
131
131
  * target a plugin's cases ran on, or one line of why none of them ran.
132
132
  * `subjectSlug` names an eval run's agent; unused on one about a plugin.
133
+ * The tables fit `stream`'s width, NOTES giving up width first.
133
134
  */
134
- export function renderEvalTables(evalRun: EvalRun, subjectSlug: string): string {
135
+ export function renderEvalTables(evalRun: EvalRun, subjectSlug: string, stream: TerminalStream = process.stdout): string {
136
+ const width = terminalWidth(stream);
135
137
  const agent = isAboutAgent(evalRun) ? headingOf(oneLine(subjectSlug), versionHashOf(evalRun)) : "";
136
138
  const oneArm = !isComparing(evalRun);
137
139
  const blocks: string[] = [];
@@ -141,7 +143,9 @@ export function renderEvalTables(evalRun: EvalRun, subjectSlug: string): string
141
143
  blocks.push(`${head}\n not run: ${oneLine(group.notRunReason)}\n`);
142
144
  continue;
143
145
  }
144
- blocks.push(...renderCaseBlocks(group.cases, evalRun.spec?.targets ?? [], oneArm, (target) => `${head} · ${target}`));
146
+ blocks.push(
147
+ ...renderCaseBlocks(group.cases, evalRun.spec?.targets ?? [], oneArm, (target) => `${head} · ${target}`, width),
148
+ );
145
149
  }
146
150
  return blocks.join("\n");
147
151
  }
@@ -156,6 +160,7 @@ function renderCaseBlocks(
156
160
  specTargets: readonly EvalRunTarget[],
157
161
  oneArm: boolean,
158
162
  heading: (target: string) => string,
163
+ width: number | undefined,
159
164
  ): string[] {
160
165
  const cases = allCases.filter((evalCase) => evalCase.notRunReason === "");
161
166
  const blocks: string[] = [];
@@ -169,7 +174,7 @@ function renderCaseBlocks(
169
174
  const headers = oneArm
170
175
  ? ["CASE", "SCORE", "PASS%", "PASS^k", "RUNS", "COST", "NOTES"]
171
176
  : ["CASE", "WITH", "W/OUT", "Δ", "PASS^k", "RUNS", "COST", "NOTES"];
172
- blocks.push(`${heading(label)}\n${renderTable(headers, rows)}`);
177
+ blocks.push(`${heading(label)}\n${renderTable(headers, rows, { width, shrink: ["NOTES"] })}`);
173
178
  }
174
179
  return blocks;
175
180
  }
@@ -198,8 +203,9 @@ export function renderEvalReport(
198
203
  readonly durationSeconds: number;
199
204
  readonly stillRunning: string;
200
205
  },
206
+ stream: TerminalStream = process.stdout,
201
207
  ): string {
202
- const tables = renderEvalTables(evalRun, opts.subjectSlug);
208
+ const tables = renderEvalTables(evalRun, opts.subjectSlug, stream);
203
209
  const lines: string[] = [];
204
210
  if (tables !== "") lines.push(tables);
205
211
  lines.push(renderSummaryLine(evalRun, opts.durationSeconds));
@@ -42,8 +42,9 @@ import {
42
42
  type Stigmer,
43
43
  } from "@stigmer/client";
44
44
  import { requireOrganization } from "../../client/single-org.js";
45
+ import { CommandResult } from "../../output/command-result.js";
45
46
  import { resolveAgent } from "../agent/resolve.js";
46
- import { idPrefixesFor, parseReference } from "../reference.js";
47
+ import { idPrefixOf, parseReference } from "../reference.js";
47
48
  import { asStartRefusal, runEval, type EvalIo } from "./follow.js";
48
49
  import type { EvalRunOptions, EvalTarget } from "./options.js";
49
50
  import { evalExitCode, oneLine, renderEvalReport, type EvalExit } from "./report.js";
@@ -121,12 +122,15 @@ export async function runEvalRun(client: Stigmer, org: string, options: EvalRunO
121
122
  }
122
123
 
123
124
  /** Cancels an eval run and says what happened. */
124
- export async function cancelEvalRun(client: Stigmer, id: string, io: Pick<EvalIo, "stderr">): Promise<void> {
125
+ export async function cancelEvalRun(client: Stigmer, id: string): Promise<CommandResult> {
125
126
  const cancelled = await client.evalrun.cancel(id);
126
- const status = cancelled.status;
127
- io.stderr.write(
128
- `Cancelled ${id}: tries in flight stop; ${status?.triesFinished ?? 0} of ${status?.triesTotal ?? 0} tries had finished.\n`,
129
- );
127
+ const finished = cancelled.status?.triesFinished ?? 0;
128
+ const total = cancelled.status?.triesTotal ?? 0;
129
+ return CommandResult.success(`Cancelled ${id}: tries in flight stop; ${finished} of ${total} tries had finished.`).withData({
130
+ evalRunId: id,
131
+ triesFinished: finished,
132
+ triesTotal: total,
133
+ });
130
134
  }
131
135
 
132
136
  async function resolveSubject(client: Stigmer, org: string, options: EvalRunOptions): Promise<ResolvedSubject> {
@@ -166,7 +170,7 @@ async function resolveSubject(client: Stigmer, org: string, options: EvalRunOpti
166
170
  }
167
171
 
168
172
  async function resolvePlugin(client: Stigmer, ref: string, org: string): Promise<Plugin> {
169
- const parsed = parseReference(ref, org, idPrefixesFor(ApiResourceKind.plugin));
173
+ const parsed = parseReference(ref, org, idPrefixOf(ApiResourceKind.plugin));
170
174
  if (parsed.kind === "id") {
171
175
  return client.plugin.get(parsed.id);
172
176
  }
@@ -176,7 +180,7 @@ async function resolvePlugin(client: Stigmer, ref: string, org: string): Promise
176
180
 
177
181
  /** A `--cases-from` reference as the create's case source: by id, or by slug in its organization. */
178
182
  function caseSourceOf(ref: string, agentOrg: string): EvalRunCaseSourceInput {
179
- const parsed = parseReference(ref, agentOrg, idPrefixesFor(ApiResourceKind.plugin));
183
+ const parsed = parseReference(ref, agentOrg, idPrefixOf(ApiResourceKind.plugin));
180
184
  return parsed.kind === "id"
181
185
  ? { plugin: { org: "", slug: "", id: parsed.id } }
182
186
  : { plugin: { org: parsed.org, slug: parsed.slug } };
@@ -184,7 +188,7 @@ function caseSourceOf(ref: string, agentOrg: string): EvalRunCaseSourceInput {
184
188
 
185
189
  /** An `--eval` reference as the create's case source: by id, or by slug in its organization, at its version. */
186
190
  function evalSourceOf(target: EvalTarget, agentOrg: string): EvalRunCaseSourceInput {
187
- const parsed = parseReference(target.ref, agentOrg, idPrefixesFor(ApiResourceKind.eval));
191
+ const parsed = parseReference(target.ref, agentOrg, idPrefixOf(ApiResourceKind.eval));
188
192
  const ref =
189
193
  parsed.kind === "id" ? { org: "", slug: "", id: parsed.id } : { org: parsed.org, slug: parsed.slug };
190
194
  return { eval: { ...ref, ...(target.version !== "" && { version: target.version }) } };