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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (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,25 +1,29 @@
1
1
  // The run prelude: validate flags and resolve every input the
2
- // create step needs. Ports the Go CLI's prepareAgentExec (run_agent_exec.go).
2
+ // create step needs.
3
3
  //
4
- // Order matters and mirrors Go: validate cheap flags first (mode, approve
5
- // default), then parse workspaces, then resolve the vaults and plugins the
6
- // conversation uses, then process attachments. A failure short-circuits before any
7
- // upload. A run carries no values of its own: its keys come from the vaults
8
- // its conversation uses (vaults.ts), which is why a vault named by id is
9
- // looked up here, before anything is uploaded.
4
+ // Order matters: validate cheap flags first (mode, approve
5
+ // default), then parse workspaces, then resolve the vaults, plugins and
6
+ // environment the conversation uses, then plan the files to send. Nothing is
7
+ // uploaded here: the attached files are read from disk and checked against
8
+ // the limits, and the create step uploads them once it knows the run's
9
+ // target (files.ts), so any failure here leaves nothing behind. A run
10
+ // carries no values of its own: its keys come from the vaults its
11
+ // conversation uses (vaults.ts), which is why a vault named by id is looked
12
+ // up here, before anything is uploaded.
10
13
 
11
14
  import type { AgentSpec } from "@stigmer/apis/ai/stigmer/agentic/agent/v1/spec_pb";
12
- import type { Attachment } from "@stigmer/apis/ai/stigmer/agentic/run/v1/spec_pb";
13
- import { Harness } from "@stigmer/apis/ai/stigmer/agentic/session/v1/enum_pb";
14
- import type { WorkspaceEntry } from "@stigmer/apis/ai/stigmer/agentic/session/v1/workspace_pb";
15
+ import type { Harness } from "@stigmer/apis/ai/stigmer/agentic/session/v1/enum_pb";
16
+ import type { SessionResource } from "@stigmer/apis/ai/stigmer/agentic/session/v1/resource_pb";
15
17
  import type { ApiResourceReference } from "@stigmer/apis/ai/stigmer/commons/apiresource/io_pb";
16
18
  import type { Stigmer } from "@stigmer/client";
17
19
  import { UsageError } from "../../errors/index.js";
18
20
  import { parseApproveDefault, type ApproveDefault } from "../stream/answer.js";
19
- import { type ProgressSink, processAttachments } from "./attachments.js";
21
+ import { type FilePlan, type ProgressSink, planFiles } from "./files.js";
22
+ import { resolveRunEnvironment } from "./environment.js";
20
23
  import { resolveRunPlugins } from "./plugins.js";
21
24
  import { resolveRunVaults } from "./vaults.js";
22
- import { localWorkspaceRoots, parseWorkspaceEntries } from "./workspace.js";
25
+ import { localWorkspaceRoots, parseWorkspaceResources } from "./workspace.js";
26
+ import { ENGINES, ENGINE_WORDS, ENGINE_WORD_LIST, engineWordOf, isEngineWord, type EngineWord } from "./engines.js";
23
27
 
24
28
  /** The interaction mode requested for the run; "" means the agent default. */
25
29
  export type RunMode = "" | "agent" | "plan";
@@ -40,16 +44,18 @@ export type ThinkingFlag = "" | "disabled" | "enabled";
40
44
  /**
41
45
  * The `--harness` flag's value space (oss#293): empty means unset — the
42
46
  * account preference may fill it (see {@link prepareAgentExec}), and when
43
- * nothing resolves the server defaults the session to native. Deliberately
44
- * only the two shipped engines, mirroring the proto validation on
45
- * `IdentityAccountPreferences.default_harness`.
47
+ * nothing resolves the server defaults the session to Stigmer. Exactly the
48
+ * engines the platform offers (`engines.ts`), mirroring the proto
49
+ * validation on `IdentityAccountPreferences.default_harness`.
46
50
  */
47
- export type HarnessFlag = "" | "native" | "cursor";
51
+ export type HarnessFlag = "" | EngineWord;
48
52
 
49
- /** Raw agent-execution flags as `run` parses them (Go's agentExecFlags). */
53
+ /** Raw agent-execution flags as `run` parses them. */
50
54
  export interface AgentExecFlags {
51
55
  readonly message: string;
52
56
  readonly attach: readonly string[];
57
+ /** The `--file-id` Files the message names, in the order given. */
58
+ readonly fileIds: readonly string[];
53
59
  readonly approveDefault: string;
54
60
  readonly verbose: boolean;
55
61
  readonly detach: boolean;
@@ -62,6 +68,8 @@ export interface AgentExecFlags {
62
68
  readonly myVault: boolean;
63
69
  /** The `--plugin` references, in the order given. */
64
70
  readonly plugin: readonly string[];
71
+ /** The `--environment` reference; "" when not given. */
72
+ readonly environment: string;
65
73
  readonly model: string;
66
74
  readonly autoApprove: boolean;
67
75
  readonly mode: RunMode;
@@ -71,20 +79,23 @@ export interface AgentExecFlags {
71
79
  }
72
80
 
73
81
  /**
74
- * The validated, resolved inputs ready for create + stream. Mirrors Go's
75
- * preparedAgentExec, minus the client/org which the command already owns.
82
+ * The validated, resolved inputs ready for create + stream, minus the
83
+ * client/org which the command already owns.
76
84
  */
77
85
  export interface PreparedRun {
78
86
  readonly approveDefault: ApproveDefault;
79
- readonly workspaceEntries: WorkspaceEntry[];
87
+ /** The new conversation's repositories and folders from `--workspace`. */
88
+ readonly resources: SessionResource[];
80
89
  /** The shared vaults the new conversation uses, in order. */
81
90
  readonly vaults: readonly ApiResourceReference[];
82
91
  /** Whether each turn uses its sender's own My vault first. */
83
92
  readonly includeMyVault: boolean;
84
93
  /** The plugins the new conversation uses, in order. */
85
94
  readonly plugins: readonly ApiResourceReference[];
86
- readonly attachments: Attachment[];
87
- readonly workspaceFileRefs: string[];
95
+ /** The Environment the new conversation names; undefined leaves its agent's or organization's default. */
96
+ readonly environment?: ApiResourceReference;
97
+ /** What `--attach` and `--file-id` resolved to, uploaded by the create step. */
98
+ readonly files: FilePlan;
88
99
  readonly message: string;
89
100
  readonly detach: boolean;
90
101
  readonly verbose: boolean;
@@ -95,11 +106,11 @@ export interface PreparedRun {
95
106
  readonly thinking: ThinkingFlag;
96
107
  /**
97
108
  * The RESOLVED harness for the new session: the explicit flag; else ""
98
- * when `--model` names a model alone (the server reads it on native);
109
+ * when `--model` names a model alone (the server reads it on Stigmer);
99
110
  * else the engine the agent names, else the account preference (when the
100
111
  * caller opted in), else "" — which stays off the wire so the server
101
- * default (native) applies. Also drives the header's
102
- * visibility row: a cursor session is never entered silently.
112
+ * default (the Stigmer harness) applies. Also drives the header's
113
+ * visibility row: a Claude session is never entered silently.
103
114
  */
104
115
  readonly harness: HarnessFlag;
105
116
  }
@@ -128,7 +139,7 @@ export interface PrepareAgentExecOptions {
128
139
  */
129
140
  readonly agentSpec?: AgentSpec;
130
141
  /**
131
- * The organization the run is created in: a `--vault` or `--plugin` named
142
+ * The organization the run is created in: a `--vault`, `--plugin` or `--environment` named
132
143
  * by slug alone is that organization's. Empty leaves the reference relative, which the
133
144
  * server resolves to the conversation's organization.
134
145
  */
@@ -136,8 +147,8 @@ export interface PrepareAgentExecOptions {
136
147
  }
137
148
 
138
149
  /**
139
- * Validate flags and resolve all run inputs. The `client` uploads
140
- * non-workspace attachments.
150
+ * Validate flags and resolve all run inputs. The `client` looks up the
151
+ * vaults, plugins, environment and account defaults; nothing is uploaded.
141
152
  */
142
153
  export async function prepareAgentExec(
143
154
  flags: AgentExecFlags,
@@ -154,10 +165,10 @@ export async function prepareAgentExec(
154
165
  // Layered seeds (oss#293): explicit flag > the agent's run defaults >
155
166
  // account preference (where the server serves identity accounts) >
156
167
  // platform default. Harness resolves first because the model
157
- // fill is harness-aware: a cursor session fills from default_cursor_model,
158
- // everything else from default_native_model. `run` always creates a NEW
159
- // session (threading lives in `resume`, which does not pass through
160
- // here), so neither fill can ever contradict an existing session's
168
+ // fill is harness-aware: a session fills from its engine's own default
169
+ // model (the Stigmer harness's when no engine resolves). `run` always
170
+ // creates a NEW session (threading lives in `resume`, which does not pass
171
+ // through here), so neither fill can ever contradict an existing session's
161
172
  // immutable harness. One whoAmI round trip serves both fills, and it is
162
173
  // skipped entirely when explicit flags leave nothing to fill.
163
174
  const agentHarness = harnessFlagOf(options?.agentSpec?.harness);
@@ -168,7 +179,7 @@ export async function prepareAgentExec(
168
179
  (flags.harness === "" || flags.harness === agentHarness) &&
169
180
  (options?.agentSpec?.runConfig?.modelName ?? "") !== "";
170
181
  // A --model with no --harness names no engine: the server starts the
171
- // conversation on native, the engine a model named alone is read on, so
182
+ // conversation on Stigmer, the engine a model named alone is read on, so
172
183
  // neither the agent's engine nor the account's is filled in under it.
173
184
  const modelNamesEngine = flags.model !== "" && flags.harness === "";
174
185
  const wantsHarnessFill =
@@ -187,13 +198,9 @@ export async function prepareAgentExec(
187
198
  : agentHarness !== ""
188
199
  ? agentHarness
189
200
  : accountDefaults.harness;
190
- const model = wantsModelFill
191
- ? harness === "cursor"
192
- ? accountDefaults.cursorModel
193
- : accountDefaults.nativeModel
194
- : flags.model;
201
+ const model = wantsModelFill ? accountDefaults.models[harness === "" ? "stigmer" : harness] : flags.model;
195
202
 
196
- const workspaceEntries = parseWorkspaceEntries(
203
+ const resources = parseWorkspaceResources(
197
204
  flags.workspace,
198
205
  flags.branch,
199
206
  flags.commit,
@@ -201,22 +208,18 @@ export async function prepareAgentExec(
201
208
 
202
209
  const vaults = await resolveRunVaults(client, flags.vault, options?.org ?? "");
203
210
  const plugins = await resolveRunPlugins(client, flags.plugin, options?.org ?? "");
211
+ const environment = await resolveRunEnvironment(client, flags.environment, options?.org ?? "");
204
212
 
205
- const { attachments, workspaceFileRefs } = await processAttachments(
206
- client.run,
207
- flags.attach,
208
- localWorkspaceRoots(workspaceEntries),
209
- progress,
210
- );
213
+ const files = planFiles(flags.attach, localWorkspaceRoots(resources), progress, flags.fileIds);
211
214
 
212
215
  return {
213
216
  approveDefault,
214
- workspaceEntries,
217
+ resources,
215
218
  vaults,
216
219
  includeMyVault: flags.myVault,
217
220
  plugins,
218
- attachments,
219
- workspaceFileRefs,
221
+ ...(environment === undefined ? {} : { environment }),
222
+ files,
220
223
  message: flags.message,
221
224
  detach: flags.detach,
222
225
  verbose: flags.verbose,
@@ -231,27 +234,19 @@ export async function prepareAgentExec(
231
234
 
232
235
  /** The engine an agent names as a flag value, "" when it names none. */
233
236
  function harnessFlagOf(harness: Harness | undefined): HarnessFlag {
234
- switch (harness) {
235
- case Harness.NATIVE:
236
- return "native";
237
- case Harness.CURSOR:
238
- return "cursor";
239
- default:
240
- return "";
241
- }
237
+ return engineWordOf(harness);
242
238
  }
243
239
 
244
240
  /** The account's execution defaults, "" for anything undeclared. */
245
241
  interface AccountExecutionDefaults {
246
242
  readonly harness: HarnessFlag;
247
- readonly nativeModel: string;
248
- readonly cursorModel: string;
243
+ /** Each engine's default model. */
244
+ readonly models: Readonly<Record<EngineWord, string>>;
249
245
  }
250
246
 
251
247
  const NO_ACCOUNT_DEFAULTS: AccountExecutionDefaults = {
252
248
  harness: "",
253
- nativeModel: "",
254
- cursorModel: "",
249
+ models: { stigmer: "", claude: "" },
255
250
  };
256
251
 
257
252
  /**
@@ -266,10 +261,10 @@ const NO_ACCOUNT_DEFAULTS: AccountExecutionDefaults = {
266
261
  * "no preferences yet". Provisioning belongs to `auth login` and `auth
267
262
  * whoami`, the commands whose purpose is the caller's identity.
268
263
  *
269
- * The persisted harness value is allowlist-guarded to the shipped engines
264
+ * The persisted harness value is allowlist-guarded to the offered engines
270
265
  * (the same guard the web launcher's useAccountExecutionDefaults applies):
271
266
  * a client must not trust stored data it did not write, so anything outside
272
- * native/cursor is treated as undeclared rather than stamped on the wire.
267
+ * them is treated as undeclared rather than stamped on the wire.
273
268
  */
274
269
  async function resolveAccountExecutionDefaults(
275
270
  client: Stigmer,
@@ -277,11 +272,10 @@ async function resolveAccountExecutionDefaults(
277
272
  try {
278
273
  const account = await client.identityAccount.whoAmI();
279
274
  const prefs = account.spec?.preferences;
280
- const declared = prefs?.defaultHarness;
275
+ const declared = prefs?.defaultHarness ?? "";
281
276
  return {
282
- harness: declared === "native" || declared === "cursor" ? declared : "",
283
- nativeModel: prefs?.defaultNativeModel ?? "",
284
- cursorModel: prefs?.defaultCursorModel ?? "",
277
+ harness: isEngineWord(declared) ? declared : "",
278
+ models: Object.fromEntries(ENGINE_WORDS.map((word) => [word, prefs?.[ENGINES[word].accountModel] ?? ""])) as Record<EngineWord, string>,
285
279
  };
286
280
  } catch {
287
281
  return NO_ACCOUNT_DEFAULTS;
@@ -290,7 +284,7 @@ async function resolveAccountExecutionDefaults(
290
284
 
291
285
  /**
292
286
  * Validate the `--mode` flag. Empty (unset) is valid and means "use default"
293
- * (agent). Mirrors Go's validateMode.
287
+ * (agent).
294
288
  */
295
289
  export function validateMode(mode: string): asserts mode is RunMode {
296
290
  if (mode !== "" && mode !== "agent" && mode !== "plan") {
@@ -333,18 +327,17 @@ export function validateThinking(mode: string): asserts mode is ThinkingFlag {
333
327
 
334
328
  /**
335
329
  * Validate the `--harness` flag. Empty means "use default": the account
336
- * preference when the caller opted in, else the platform default (native).
337
- * Only the shipped engines are accepted — other harness names that appear in
338
- * UI metadata (copilot, codex, ...) have no proto mapping yet, so rejecting
339
- * them here is honest, and this check catches spelling errors before a
340
- * network round trip.
330
+ * preference when the caller opted in, else the platform default (Stigmer).
331
+ * Only the offered engines are accepted (`engines.ts`): another name has no
332
+ * proto mapping, so rejecting it here is honest, and this check catches
333
+ * spelling errors before a network round trip.
341
334
  */
342
335
  export function validateHarness(
343
336
  harness: string,
344
337
  ): asserts harness is HarnessFlag {
345
- if (harness !== "" && harness !== "native" && harness !== "cursor") {
338
+ if (harness !== "" && !isEngineWord(harness)) {
346
339
  throw new UsageError(
347
- `invalid --harness value "${harness}": must be "native" or "cursor"`,
340
+ `invalid --harness value "${harness}": must be ${ENGINE_WORD_LIST}`,
348
341
  );
349
342
  }
350
343
  }
@@ -19,7 +19,7 @@ import {
19
19
  } from "@stigmer/apis/ai/stigmer/commons/apiresource/io_pb";
20
20
  import type { ApiResourceMetadata } from "@stigmer/apis/ai/stigmer/commons/apiresource/metadata_pb";
21
21
  import { UsageError } from "../../errors/index.js";
22
- import { idPrefixesFor, parseReference } from "../reference.js";
22
+ import { idPrefixOf, parseReference } from "../reference.js";
23
23
 
24
24
  /** One run flag naming resources of one kind. */
25
25
  export interface RunReferenceKind {
@@ -44,15 +44,16 @@ export async function resolveRunReferences(
44
44
  ): Promise<ApiResourceReference[]> {
45
45
  const resolved: ApiResourceReference[] = [];
46
46
  const seen = new Set<string>();
47
+ const aNoun = `${/^[aeiou]/.test(of.noun) ? "an" : "a"} ${of.noun}`;
47
48
  for (const raw of refs) {
48
49
  if (raw.trim() === "") {
49
- throw new UsageError(`invalid ${of.flag} value: empty; name a ${of.noun} by id, org/slug or slug`);
50
+ throw new UsageError(`invalid ${of.flag} value: empty; name ${aNoun} by id, org/slug or slug`);
50
51
  }
51
52
  const parts = raw.trim().split("/");
52
53
  if (parts.length > 2 || parts.some((part) => part === "")) {
53
- throw new UsageError(`invalid ${of.flag} value '${raw}': name a ${of.noun} by id, org/slug or slug`);
54
+ throw new UsageError(`invalid ${of.flag} value '${raw}': name ${aNoun} by id, org/slug or slug`);
54
55
  }
55
- const parsed = parseReference(raw, org, idPrefixesFor(of.kind));
56
+ const parsed = parseReference(raw, org, idPrefixOf(of.kind));
56
57
  let refOrg: string;
57
58
  let slug: string;
58
59
  if (parsed.kind === "id") {
@@ -61,7 +62,7 @@ export async function resolveRunReferences(
61
62
  slug = found.metadata?.slug ?? "";
62
63
  if (slug === "") {
63
64
  throw new UsageError(
64
- `${of.noun} '${raw}' has no slug: a conversation names a ${of.noun} by its organization and slug`,
65
+ `${of.noun} '${raw}' has no slug: a conversation names ${aNoun} by its organization and slug`,
65
66
  );
66
67
  }
67
68
  } else {
@@ -1,4 +1,4 @@
1
- // Reference resolution for the run path (Go's resolveAgent in run_resolve.go).
1
+ // Reference resolution for the run path.
2
2
  // A reference is an ID (agt_…), an explicit org/slug, or
3
3
  // a bare slug resolved against the context org. The strict ID *classification*
4
4
  // used by smart dispatch lives in resources/reference.ts; this module just turns
@@ -1,11 +1,13 @@
1
- // Re-opening an existing session (Go's openSession / resumeSession in
2
- // resume_session.go). Fetch the session + its runs, then either:
1
+ // Re-opening an existing session. Fetch the session + its runs, then either:
3
2
  // - re-attach when the latest run is still active: the headless driver
4
3
  // follows the session's log from its start, so the history is replayed
5
4
  // and the latest turn followed to its end, or
6
5
  // - replay the session's stored events when everything has finished.
7
6
  // The TTY path defers to Ink's SessionView, which loads history and offers a
8
- // follow-up composer for free.
7
+ // follow-up composer for free. Under `--until turn` it returns when the
8
+ // working turn ends, or, with none working, once the history has drawn.
9
+ // Either way the command exits by the newest turn's phase, as `run` does
10
+ // (stream.ts, `exitByTurn`).
9
11
 
10
12
  import type { Run } from "@stigmer/apis/ai/stigmer/agentic/run/v1/api_pb";
11
13
  import { RunPhase, InteractionMode } from "@stigmer/apis/ai/stigmer/agentic/run/v1/enum_pb";
@@ -16,11 +18,12 @@ import { NdjsonRenderer } from "../stream/render-ndjson.js";
16
18
  import { PlaintextRenderer } from "../stream/render-plaintext.js";
17
19
  import { isInkSupported } from "../stream/tty.js";
18
20
  import { renderSessionHeader, type SessionHeaderInfo, workspaceNames } from "./header.js";
21
+ import { localWorkspaceRoots } from "./workspace.js";
19
22
  import type { RunMode } from "./prepare.js";
20
- import { streamAgentRun, type RunOutputMode } from "./stream.js";
23
+ import { exitByTurn, newestRunId, streamAgentRun, type RunOutputMode, type RunUntil } from "./stream.js";
21
24
 
22
25
  // The backend's auto-create sentinel; suppressed in the header until the async
23
- // title activity replaces it (Go's session.PendingSubject / ResolvedSubject).
26
+ // title activity replaces it.
24
27
  const PENDING_SUBJECT = "Auto-created session";
25
28
 
26
29
  // Phases where the latest run is still producing output — re-attach live.
@@ -37,6 +40,8 @@ export interface OpenSessionDeps {
37
40
  /** Explicit --mode override; "" means infer from the latest run. */
38
41
  readonly mode: RunMode;
39
42
  readonly outputMode: RunOutputMode;
43
+ /** On a terminal: return when the person leaves (the default) or when the newest turn ends. */
44
+ readonly until?: RunUntil;
40
45
  }
41
46
 
42
47
  export async function openSession(deps: OpenSessionDeps): Promise<void> {
@@ -61,12 +66,12 @@ export async function openSession(deps: OpenSessionDeps): Promise<void> {
61
66
  subject: resolvedSubject(session.spec?.subject ?? ""),
62
67
  model: "",
63
68
  mode: effectiveMode,
64
- workspaces: workspaceNames(session.spec?.workspaceEntries ?? []),
69
+ workspaces: workspaceNames(session.spec?.resources ?? []),
65
70
  };
66
71
 
67
72
  if (ACTIVE_PHASES.has(phase)) {
68
73
  // Live re-attach reuses the exact run streaming stack.
69
- await streamAgentRun({
74
+ const newest = await streamAgentRun({
70
75
  client: stigmer,
71
76
  sessionId: deps.sessionId,
72
77
  runId: latest.metadata?.id ?? "",
@@ -75,11 +80,14 @@ export async function openSession(deps: OpenSessionDeps): Promise<void> {
75
80
  approveDefault: "",
76
81
  outputMode: deps.outputMode,
77
82
  header,
83
+ workspaceRoots: localWorkspaceRoots(session.spec?.resources ?? []),
84
+ until: deps.until ?? "exit",
78
85
  });
86
+ exitByTurn(newest);
79
87
  return;
80
88
  }
81
89
 
82
- await replaySession(deps, org, header);
90
+ await replaySession(deps, org, header, localWorkspaceRoots(session.spec?.resources ?? []), latest);
83
91
  }
84
92
 
85
93
  // Completed session: render the stored history. TTY → Ink (history + composer);
@@ -88,7 +96,10 @@ async function replaySession(
88
96
  deps: OpenSessionDeps,
89
97
  org: string,
90
98
  header: SessionHeaderInfo,
99
+ workspaceRoots: readonly string[],
100
+ latest: Run,
91
101
  ): Promise<void> {
102
+ const latestId = latest.metadata?.id ?? "";
92
103
  if (deps.outputMode === "inline" && isInkSupported(process.stdout)) {
93
104
  const { runInkSession } = await import("../stream/ink.js");
94
105
  await runInkSession({
@@ -96,7 +107,14 @@ async function replaySession(
96
107
  sessionId: deps.sessionId,
97
108
  org,
98
109
  mode: header.mode === "plan" ? "plan" : "agent",
110
+ workspaceRoots,
111
+ // The newest turn has ended: under --until turn, its end at load returns.
112
+ until: deps.until ?? "exit",
113
+ watchRunId: latestId,
99
114
  });
115
+ // Follow-ups may have been sent in the view: the newest turn decides.
116
+ const stigmer = deps.client.stigmer;
117
+ exitByTurn(await stigmer.run.get(await newestRunId(stigmer, deps.sessionId, latestId)));
100
118
  return;
101
119
  }
102
120
 
@@ -107,9 +125,10 @@ async function replaySession(
107
125
  ? new NdjsonRenderer({ data: process.stdout, status: process.stderr })
108
126
  : new PlaintextRenderer({ data: process.stdout, status: process.stderr });
109
127
  renderReplay(events, renderer);
128
+ exitByTurn(latest);
110
129
  }
111
130
 
112
- // Mirrors Go's resolveResumeMode: --mode wins; else infer "plan" from the last
131
+ // --mode wins; else infer "plan" from the last
113
132
  // run's InteractionMode; else default (agent).
114
133
  function resolveResumeMode(explicit: RunMode, latest: Run): RunMode {
115
134
  if (explicit !== "") return explicit;
@@ -9,9 +9,28 @@
9
9
  // headless paths share one driver (runHeadlessStream) over the SDK's
10
10
  // followSession, folded by SessionLog; asks are answered through the
11
11
  // session's confirmToolUse / grantPermission.
12
+ //
13
+ // How it ends (the CLI's rule, client-apps/AGENTS.md):
14
+ // - Off a terminal and with -o json the stream returns when the run's turn
15
+ // ends. On a terminal the view stays a conversation until the person
16
+ // leaves (`until: "exit"`), or returns when the run's turn ends
17
+ // (`until: "turn"`).
18
+ // - `downloadDir` saves each turn's outputs as that turn ends: in the view
19
+ // for every turn seen ending (and the run this command started, even when
20
+ // it ended before the view loaded), told as a note in the thread; headless,
21
+ // the one turn, once it ends.
22
+ // - The returned Run is the session's newest turn, the one the exit summary
23
+ // reports, and `exitByTurn` turns its phase into the exit code through the
24
+ // shared table (`exitCodeOf`): 0 completed; 1 failed, cancelled or
25
+ // stopped; 130 when the person left while it still works.
12
26
 
13
27
  import type { Run } from "@stigmer/apis/ai/stigmer/agentic/run/v1/api_pb";
14
- import { followSession, type Stigmer } from "@stigmer/client";
28
+ import { RunPhase } from "@stigmer/apis/ai/stigmer/agentic/run/v1/enum_pb";
29
+ import { followSession, turnPhaseOf, type Stigmer, type Turn } from "@stigmer/client";
30
+ import { exitCodeOf } from "@stigmer/client/node";
31
+ import { CliExitError, ExitCode } from "../../errors/index.js";
32
+ import { downloadRunOutputs, type ProgressSink } from "../download.js";
33
+ import { listRunsBySession } from "../session.js";
15
34
  import { runEpilogue } from "./epilogue.js";
16
35
  import { renderSessionHeader, type SessionHeaderInfo } from "./header.js";
17
36
  import type { RunMode } from "./prepare.js";
@@ -24,6 +43,9 @@ import { isInkSupported } from "../stream/tty.js";
24
43
  /** The user-selected output mode for a streaming command. */
25
44
  export type RunOutputMode = "inline" | "json";
26
45
 
46
+ /** When a terminal run returns: when the person leaves, or when its turn ends. */
47
+ export type RunUntil = "turn" | "exit";
48
+
27
49
  export interface StreamDeps {
28
50
  readonly client: Stigmer;
29
51
  readonly sessionId: string;
@@ -34,28 +56,75 @@ export interface StreamDeps {
34
56
  readonly approveDefault: ApproveDefault;
35
57
  readonly outputMode: RunOutputMode;
36
58
  readonly header: SessionHeaderInfo;
59
+ /** The session's local folders, which the Ink composer's `@` completes paths under. */
60
+ readonly workspaceRoots?: readonly string[];
61
+ /** Takes back the progress lines written before the run, so the Ink view starts clean. */
62
+ readonly clearProgress?: () => void;
63
+ /** On a terminal: return when the person leaves ("exit", the default) or when `runId`'s turn ends. */
64
+ readonly until?: RunUntil;
65
+ /** Where each turn's outputs are saved as it ends; "" or absent saves nothing. */
66
+ readonly downloadDir?: string;
67
+ /** Where headless download lines go (stderr on a terminal); none by default. */
68
+ readonly progress?: ProgressSink;
37
69
  }
38
70
 
39
71
  /**
40
72
  * Stream the run to its end, then run the epilogue. Returns the
41
- * authoritative final run (for artifact download).
73
+ * authoritative final run (for downloading its outputs).
42
74
  */
43
75
  export async function streamAgentRun(deps: StreamDeps): Promise<Run> {
44
76
  if (deps.outputMode === "json") {
45
77
  renderSessionHeader(process.stderr, deps.header);
46
78
  const result = await runHeadless(deps, new NdjsonRenderer({ data: process.stdout, status: process.stderr }));
47
- return runEpilogue(deps.client, deps.sessionId, deps.runId, result);
79
+ return downloadHeadless(deps, await runEpilogue(deps.client, deps.sessionId, deps.runId, result));
48
80
  }
49
81
 
50
82
  if (isInkSupported(process.stdout)) {
51
- await runInk(deps);
52
- // Ink owns the live view; the epilogue still prints the exit summary.
53
- return runEpilogue(deps.client, deps.sessionId, deps.runId, { phase: "", error: "", turn: undefined });
83
+ deps.clearProgress?.();
84
+ const { actionFailed } = await runInk(deps);
85
+ // Ink owns the live view; the epilogue still prints the exit summary, of
86
+ // the session's newest turn: the person may have sent follow-ups since
87
+ // the run this command started (stigmer#2781).
88
+ const runId = await newestRunId(deps.client, deps.sessionId, deps.runId);
89
+ const newest = await runEpilogue(deps.client, deps.sessionId, runId, { phase: "", error: "", turn: undefined });
90
+ // A save the view could not make fails the command, as a failed download off a terminal does.
91
+ if (actionFailed) throw new CliExitError("some turn's outputs were not saved (the session says which)", ExitCode.General);
92
+ return newest;
54
93
  }
55
94
 
56
95
  renderSessionHeader(process.stderr, deps.header);
57
96
  const result = await runHeadless(deps, new PlaintextRenderer({ data: process.stdout, status: process.stderr }));
58
- return runEpilogue(deps.client, deps.sessionId, deps.runId, result);
97
+ return downloadHeadless(deps, await runEpilogue(deps.client, deps.sessionId, deps.runId, result));
98
+ }
99
+
100
+ /**
101
+ * The exit code for how a run's turn ended, from the shared table: 0
102
+ * completed; 1 failed, cancelled or stopped; 130 still working (the person
103
+ * left first). A run whose phase is unknown exits 1.
104
+ */
105
+ export function turnExitCode(run: Run): ExitCode {
106
+ const phase = turnPhaseOf(run.status?.phase ?? RunPhase.RUN_PHASE_UNSPECIFIED);
107
+ return phase === undefined ? ExitCode.General : exitCodeOf({ phase });
108
+ }
109
+
110
+ /** Exit by the turn's code (`turnExitCode`): silently, since the summary already said how it ended. */
111
+ export function exitByTurn(run: Run): void {
112
+ const code = turnExitCode(run);
113
+ if (code !== ExitCode.Success) throw new CliExitError("", code);
114
+ }
115
+
116
+ // Off a terminal the stream returned at the turn's end: save its outputs now.
117
+ async function downloadHeadless(deps: StreamDeps, run: Run): Promise<Run> {
118
+ if ((deps.downloadDir ?? "") !== "") {
119
+ await saveTurnOutputs(deps.client, run.metadata?.id ?? "", deps.downloadDir ?? "", deps.progress);
120
+ }
121
+ return run;
122
+ }
123
+
124
+ /** Save one turn's outputs under `outputDir`, saying so through `say`; a turn that saved none says that. */
125
+ export async function saveTurnOutputs(client: Stigmer, runId: string, outputDir: string, say?: ProgressSink): Promise<void> {
126
+ const outcome = await downloadRunOutputs(client, runId, { outputPath: "", outputDir }, say);
127
+ if (outcome.noOutputs) say?.("No outputs saved in this turn.");
59
128
  }
60
129
 
61
130
  // Drive a headless renderer over the session's log, with Ctrl-C wired to stop
@@ -83,14 +152,46 @@ async function runHeadless(deps: StreamDeps, renderer: HeadlessRenderer): Promis
83
152
  }
84
153
  }
85
154
 
155
+ // The session's newest run, or `fallback` when the list cannot be read.
156
+ export async function newestRunId(client: Stigmer, sessionId: string, fallback: string): Promise<string> {
157
+ try {
158
+ const runs = await listRunsBySession(client, sessionId);
159
+ return runs[0]?.metadata?.id || fallback;
160
+ } catch {
161
+ return fallback;
162
+ }
163
+ }
164
+
86
165
  // Lazily import the Ink renderer so React/Ink load only on the interactive path
87
166
  // (non-streaming commands and --help never pay for them).
88
- async function runInk(deps: StreamDeps): Promise<void> {
167
+ async function runInk(deps: StreamDeps): Promise<import("../stream/ink.js").InkSessionOutcome> {
89
168
  const { runInkSession } = await import("../stream/ink.js");
90
- await runInkSession({
169
+ return runInkSession({
91
170
  client: deps.client,
92
171
  sessionId: deps.sessionId,
93
172
  org: deps.org,
94
173
  mode: deps.mode === "plan" ? "plan" : "agent",
174
+ workspaceRoots: deps.workspaceRoots,
175
+ until: deps.until ?? "exit",
176
+ watchRunId: deps.runId,
177
+ afterTurn: turnDownloader(deps.client, deps.downloadDir ?? "", deps.runId),
95
178
  });
96
179
  }
180
+
181
+ /**
182
+ * The view's per-turn action under `--download`: save each turn's outputs as
183
+ * it ends, the turns that had ended before the view loaded left alone, except
184
+ * the run this command started (it may end before the view loads). None
185
+ * without a directory.
186
+ */
187
+ export function turnDownloader(
188
+ client: Stigmer,
189
+ outputDir: string,
190
+ startedRunId: string,
191
+ ): ((turn: Turn, atLoad: boolean, say: ProgressSink) => Promise<void>) | undefined {
192
+ if (outputDir === "") return undefined;
193
+ return async (turn, atLoad, say) => {
194
+ if (atLoad && turn.runId !== startedRunId) return;
195
+ await saveTurnOutputs(client, turn.runId, outputDir, say);
196
+ };
197
+ }