@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
@@ -0,0 +1,170 @@
1
+ // What `stigmer run` and `stigmer resume` add to the terminal kit's composer,
2
+ // through the kit's host hooks (ComposerExtensions), the way any host CLI
3
+ // would:
4
+ // - `/help`, `/mode plan|agent`, `/stop` and `/exit`;
5
+ // - `@` completing paths under the session's local folders, each sent as a
6
+ // workspace reference (the same workspace-relative path `--attach` sends
7
+ // for a file inside a folder), so the agent reads the file in place;
8
+ // - a prompt history per working directory, under the config directory,
9
+ // mode 0600 because a prompt can hold a secret, the last 500 kept.
10
+ //
11
+ // Trade-offs:
12
+ // - The `@` walk is bounded (depth, files read, names skipped such as
13
+ // `node_modules` and `.git`), so a large tree answers at once; a file past
14
+ // the bound is still reachable by `--attach`.
15
+ // - A history file that cannot be read or written is no history: the
16
+ // session goes on, as it would with none.
17
+ //
18
+ // Proven by __tests__/composer.test.ts.
19
+
20
+ import { createHash } from "node:crypto";
21
+ import { chmodSync, mkdirSync, readdirSync, readFileSync, statSync, writeFileSync } from "node:fs";
22
+ import { homedir } from "node:os";
23
+ import { dirname, join, relative, sep } from "node:path";
24
+ import type { CompletionItem, CompletionSource, ComposerExtensions, PromptHistory, SlashCommand } from "@stigmer/ink-ui";
25
+ import { configDir } from "../../config/paths.js";
26
+
27
+ /** The most entries a history file keeps. */
28
+ export const HISTORY_LIMIT = 500;
29
+ /** The most items the `@` menu offers. */
30
+ const COMPLETION_LIMIT = 20;
31
+ /** How deep, and how many entries, the `@` walk reads. */
32
+ const WALK_DEPTH = 6;
33
+ const WALK_ENTRIES = 5000;
34
+ /** Names the `@` walk does not enter. */
35
+ const SKIPPED = new Set([".git", "node_modules", ".venv", "dist", "build", ".next", "target", "__pycache__"]);
36
+
37
+ /** The session's commands: help, mode, stop and exit. */
38
+ export function cliCommands(): readonly SlashCommand[] {
39
+ const commands: SlashCommand[] = [
40
+ {
41
+ name: "help",
42
+ description: "List the commands and keys",
43
+ run: (_args, context) =>
44
+ context.note(
45
+ [
46
+ ...commands.map((command) => `/${command.name}${command.args ? ` ${command.args}` : ""} ${command.description}`),
47
+ "@<path> mention a file in the session's folder",
48
+ "Esc stops the agent · Ctrl+C twice leaves (the agent keeps working) · ↑ earlier messages · ? keys",
49
+ ].join("\n"),
50
+ ),
51
+ },
52
+ {
53
+ name: "mode",
54
+ description: "Switch to plan (read-only) or agent mode",
55
+ args: "plan|agent",
56
+ run: (args, context) => {
57
+ if (args === "plan" || args === "agent") context.setMode(args);
58
+ else context.note(`/mode takes plan or agent; this session is in ${context.mode} mode.`);
59
+ },
60
+ },
61
+ { name: "stop", description: "Stop the agent's turn", run: (_args, context) => context.stop() },
62
+ { name: "exit", description: "Leave; the agent keeps working", run: (_args, context) => context.leave() },
63
+ ];
64
+ return commands;
65
+ }
66
+
67
+ /** The `@` completions over files under `roots`, each a workspace reference. */
68
+ export function workspaceCompletion(roots: readonly string[]): CompletionSource {
69
+ return {
70
+ trigger: "@",
71
+ complete: (query) => {
72
+ const needle = query.toLowerCase();
73
+ const items: CompletionItem[] = [];
74
+ for (const root of roots) {
75
+ for (const path of walk(root)) {
76
+ if (!path.toLowerCase().includes(needle)) continue;
77
+ items.push({ label: path, insert: `@${path}`, attach: { workspaceFileRefs: [path] } });
78
+ if (items.length >= COMPLETION_LIMIT) return rank(items, needle);
79
+ }
80
+ }
81
+ return rank(items, needle);
82
+ },
83
+ };
84
+ }
85
+
86
+ /** Paths whose file name starts with the query first, then the shorter. */
87
+ function rank(items: readonly CompletionItem[], needle: string): readonly CompletionItem[] {
88
+ const named = (item: CompletionItem) => (item.label.split("/").at(-1)!.toLowerCase().startsWith(needle) ? 0 : 1);
89
+ return [...items].sort((a, b) => named(a) - named(b) || a.label.length - b.label.length || a.label.localeCompare(b.label));
90
+ }
91
+
92
+ /** The files under `root`, as `/`-separated paths relative to it, within the walk's bounds. */
93
+ function walk(root: string): string[] {
94
+ const files: string[] = [];
95
+ let read = 0;
96
+ const visit = (dir: string, depth: number): void => {
97
+ if (depth > WALK_DEPTH || read >= WALK_ENTRIES) return;
98
+ let entries;
99
+ try {
100
+ entries = readdirSync(dir, { withFileTypes: true });
101
+ } catch {
102
+ return;
103
+ }
104
+ entries.sort((a, b) => a.name.localeCompare(b.name));
105
+ for (const entry of entries) {
106
+ read += 1;
107
+ if (read > WALK_ENTRIES) return;
108
+ if (SKIPPED.has(entry.name)) continue;
109
+ const path = join(dir, entry.name);
110
+ if (entry.isDirectory()) visit(path, depth + 1);
111
+ else if (entry.isFile()) files.push(relative(root, path).split(sep).join("/"));
112
+ }
113
+ };
114
+ visit(root, 0);
115
+ return files;
116
+ }
117
+
118
+ /** The local folders of `roots` that exist on this machine as folders. */
119
+ export function presentRoots(roots: readonly string[]): readonly string[] {
120
+ return roots.filter((root) => {
121
+ try {
122
+ return statSync(root).isDirectory();
123
+ } catch {
124
+ return false;
125
+ }
126
+ });
127
+ }
128
+
129
+ /** Where the history of prompts typed in `cwd` lives. */
130
+ export function historyPath(cwd: string, home: string = homedir()): string {
131
+ const key = createHash("sha256").update(cwd).digest("hex").slice(0, 16);
132
+ return join(configDir(home), "history", `${key}.json`);
133
+ }
134
+
135
+ /** The prompt history of `cwd`, in a file only its owner reads (module header). */
136
+ export function fileHistory(cwd: string, home: string = homedir()): PromptHistory {
137
+ const path = historyPath(cwd, home);
138
+ const read = (): string[] => {
139
+ try {
140
+ const parsed: unknown = JSON.parse(readFileSync(path, "utf8"));
141
+ return Array.isArray(parsed) ? parsed.filter((entry): entry is string => typeof entry === "string") : [];
142
+ } catch {
143
+ return [];
144
+ }
145
+ };
146
+ return {
147
+ load: read,
148
+ append: (entry) => {
149
+ const entries = read();
150
+ if (entry.trim() === "" || entries.at(-1) === entry) return;
151
+ try {
152
+ mkdirSync(dirname(path), { recursive: true, mode: 0o700 });
153
+ writeFileSync(path, `${JSON.stringify([...entries, entry].slice(-HISTORY_LIMIT))}\n`, { mode: 0o600 });
154
+ chmodSync(path, 0o600);
155
+ } catch {
156
+ // No history this time; the session goes on.
157
+ }
158
+ },
159
+ };
160
+ }
161
+
162
+ /** The composer `stigmer run` and `stigmer resume` give the session view. */
163
+ export function cliComposer(roots: readonly string[], cwd: string = process.cwd()): ComposerExtensions {
164
+ const present = presentRoots(roots);
165
+ return {
166
+ commands: cliCommands(),
167
+ completions: present.length > 0 ? [workspaceCompletion(present)] : [],
168
+ history: fileHistory(cwd),
169
+ };
170
+ }
@@ -1,8 +1,6 @@
1
1
  // In-process Ink renderer for the interactive (TTY) stream path.
2
2
  //
3
- // Go spawns a separate `stigmer-ink` subprocess (sdk/ink/src/cli/stigmer-ink.tsx)
4
- // and pipes session config to it. Here the CLI *is* a TS process, so we render
5
- // Ink in-process and — crucially — reuse the CLI's already-authenticated client
3
+ // The CLI renders Ink in-process and — crucially — reuses its already-authenticated client
6
4
  // via InkStigmerProvider rather than letting SessionApp build its own. SessionView
7
5
  // (from @stigmer/ink-ui) owns the live conversation: history, streaming, approvals,
8
6
  // and a follow-up composer.
@@ -10,11 +8,26 @@
10
8
  // This module is only ever reached through a dynamic import() in the command
11
9
  // action, so React/Ink load lazily — non-streaming commands never pay
12
10
  // for them. Within this already-lazy module, ordinary JSX/imports are fine.
11
+ //
12
+ // The CLI is the kit's first host: it gives the composer its commands, `@`
13
+ // over the session's local folders and a history per directory (composer.ts),
14
+ // and the words for coming back after leaving. Ctrl+C is the view's key
15
+ // (clear a draft; twice on an empty composer, leave), so Ink does not exit on
16
+ // it; Shift+Enter starts a new line where the terminal reports it.
17
+ //
18
+ // How it ends is the host's mode (`until`, the kit's word, as `runInTerminal`
19
+ // reads it): "exit" keeps the conversation open until the person leaves;
20
+ // "turn" returns once the watched run's turn ends. Each turn's end is handed
21
+ // to `afterTurn` (the CLI saves the turn's outputs there), with a sink that
22
+ // writes a note in the thread while the view is up and to stderr once it has
23
+ // gone, so nothing is written under Ink's frame. Control returns only once
24
+ // every such action has finished, saying whether one failed.
13
25
 
14
26
  import React from "react";
15
27
  import { render } from "ink";
16
- import { InkStigmerProvider, SessionView, type InteractionMode } from "@stigmer/ink-ui";
17
- import type { DeploymentMode, Stigmer } from "@stigmer/client";
28
+ import { InkStigmerProvider, SessionView, type InteractionMode, type TurnEndContext } from "@stigmer/ink-ui";
29
+ import type { DeploymentMode, Stigmer, Turn } from "@stigmer/client";
30
+ import { cliComposer } from "./composer.js";
18
31
 
19
32
  export interface InkSessionOptions {
20
33
  /** The CLI's configured, refreshing-token client (backend.stigmer). */
@@ -26,22 +39,70 @@ export interface InkSessionOptions {
26
39
  readonly mode: InteractionMode;
27
40
  /** Feature-gating mode; "cloud" unless the CLI targets a local backend. */
28
41
  readonly deploymentMode?: DeploymentMode;
42
+ /** The session's local folders, which `@` completes paths under. */
43
+ readonly workspaceRoots?: readonly string[];
44
+ /** When control returns: "exit" (the default) when the person leaves; "turn" when `watchRunId`'s turn ends. */
45
+ readonly until?: "turn" | "exit";
46
+ /** The run whose turn's end returns control under `until: "turn"`. */
47
+ readonly watchRunId?: string;
48
+ /** What the host does when a turn ends; its lines go to `say` (module header). */
49
+ readonly afterTurn?: (turn: Turn, atLoad: boolean, say: (line: string) => void) => Promise<void>;
50
+ }
51
+
52
+ /** How the view ended for its host. */
53
+ export interface InkSessionOutcome {
54
+ /** Some turn's `afterTurn` threw: its outputs were not saved, as a note in the thread said. */
55
+ readonly actionFailed: boolean;
56
+ }
57
+
58
+ /** What the leave line says to come back to a session. */
59
+ export function comeBackHint(sessionId: string): string {
60
+ return `Come back with \`stigmer resume ${sessionId}\`.`;
29
61
  }
30
62
 
31
63
  /**
32
- * Render a live session in the terminal and resolve when the user exits (Ctrl+C
33
- * unmounts the app). This NEVER calls process.exit — the caller still runs its
64
+ * Render a live session in the terminal and resolve when the user leaves
65
+ * (Ctrl+C twice on an empty composer, or `/exit`), or under `until: "turn"`
66
+ * once the watched turn ends and its `afterTurn` has finished. This NEVER calls process.exit — the caller still runs its
34
67
  * epilogue (final Get + usage). Termination signals unmount the Ink tree so the
35
68
  * terminal is restored cleanly, but control returns here rather than killing
36
69
  * the host process.
37
70
  */
38
- export async function runInkSession(opts: InkSessionOptions): Promise<void> {
71
+ export async function runInkSession(opts: InkSessionOptions): Promise<InkSessionOutcome> {
72
+ const pending = new Set<Promise<void>>();
73
+ let mounted = true;
74
+ let actionFailed = false;
75
+ // Assigned before Ink can report a turn: render() returns before any effect runs.
76
+ let leave: (() => void) | undefined;
77
+
78
+ const onTurnEnd = (turn: Turn, context: TurnEndContext): void => {
79
+ const say = (line: string): void => {
80
+ if (mounted) context.note(line.trim());
81
+ else process.stderr.write(`${line}\n`);
82
+ };
83
+ const action = (opts.afterTurn?.(turn, context.atLoad, say) ?? Promise.resolve()).catch((error: unknown) => {
84
+ actionFailed = true;
85
+ say(`Could not save this turn's outputs: ${error instanceof Error ? error.message : String(error)}`);
86
+ });
87
+ pending.add(action);
88
+ void action.finally(() => pending.delete(action));
89
+ if (opts.until === "turn" && turn.runId === opts.watchRunId) void action.then(() => leave?.());
90
+ };
91
+
39
92
  const instance = render(
40
93
  <InkStigmerProvider client={opts.client} deploymentMode={opts.deploymentMode ?? "cloud"}>
41
- <SessionView sessionId={opts.sessionId} org={opts.org} mode={opts.mode} />
94
+ <SessionView
95
+ sessionId={opts.sessionId}
96
+ org={opts.org}
97
+ mode={opts.mode}
98
+ composer={cliComposer(opts.workspaceRoots ?? [])}
99
+ leaveHint={comeBackHint(opts.sessionId)}
100
+ onTurnEnd={onTurnEnd}
101
+ />
42
102
  </InkStigmerProvider>,
43
- { exitOnCtrlC: true },
103
+ { exitOnCtrlC: false, kittyKeyboard: { mode: "auto" } },
44
104
  );
105
+ leave = () => instance.unmount();
45
106
 
46
107
  const onSignal = (): void => instance.unmount();
47
108
  process.once("SIGINT", onSignal);
@@ -50,7 +111,10 @@ export async function runInkSession(opts: InkSessionOptions): Promise<void> {
50
111
  try {
51
112
  await instance.waitUntilExit();
52
113
  } finally {
114
+ mounted = false;
53
115
  process.removeListener("SIGINT", onSignal);
54
116
  process.removeListener("SIGTERM", onSignal);
55
117
  }
118
+ await Promise.all([...pending]);
119
+ return { actionFailed };
56
120
  }
@@ -3,13 +3,17 @@
3
3
  //
4
4
  // The agent's messages on its primary thread go to the data sink (stdout);
5
5
  // terse status lines go to the status sink (stderr): the person's message,
6
- // one line per tool use each time its state changes, a subagent's start and
7
- // end with its tool uses indented beneath, the platform's notes, a context
6
+ // one line per tool use each time its state changes, one line each time a
7
+ // command it started in the background changes state ("Background command
8
+ // `npm test` exited with code 1", from the fold's `background`, the fact the
9
+ // console reads), a subagent's start and
10
+ // end with its tool uses indented beneath (its task call's line, once the
11
+ // call returns, carries its span: "✓ task (1m 4s)"), the platform's notes, a context
8
12
  // compaction, the turn's errors, and how each ask was answered. No ANSI, no
9
13
  // frames. Each fold is compared with the last by reference, so a turn no event
10
14
  // touched is not walked again, and everything already written stays written.
11
15
 
12
- import { extractShellIntent, type SessionFold, type ToolUse, type Turn, type TurnItem } from "@stigmer/client";
16
+ import { backgroundEndingLine, extractShellIntent, formatElapsed, type SessionFold, type ToolUse, type Turn, type TurnItem } from "@stigmer/client";
13
17
  import { answerWord, type ApproveDefault, type AskAnswer } from "./answer.js";
14
18
  import type { HeadlessRenderer } from "./headless.js";
15
19
  import type { LineWriter } from "./render-ndjson.js";
@@ -28,6 +32,7 @@ export class PlaintextRenderer implements HeadlessRenderer {
28
32
  private readonly rendered = new Map<string, Turn>();
29
33
  private readonly written = new Set<string>();
30
34
  private readonly toolStates = new Map<string, string>();
35
+ private readonly backgroundStates = new Map<string, string>();
31
36
  private readonly threadStates = new Map<string, string>();
32
37
 
33
38
  constructor(private readonly opts: PlaintextRendererOptions) {}
@@ -86,7 +91,12 @@ export class PlaintextRenderer implements HeadlessRenderer {
86
91
  private renderTool(tool: ToolUse, indent: string): void {
87
92
  if (this.toolStates.get(tool.id) !== tool.state) {
88
93
  this.toolStates.set(tool.id, tool.state);
89
- this.opts.status.write(`${indent} ${toolLine(tool)}\n`);
94
+ this.opts.status.write(`${indent} ${toolLine(tool)}${tool.thread === undefined ? "" : threadSpan(tool)}\n`);
95
+ }
96
+ const background = tool.background;
97
+ if (background !== undefined && this.backgroundStates.get(tool.id) !== background.state) {
98
+ this.backgroundStates.set(tool.id, background.state);
99
+ this.opts.status.write(`${indent} ${backgroundEndingLine(tool)}\n`);
90
100
  }
91
101
  const thread = tool.thread;
92
102
  if (thread === undefined) return;
@@ -115,6 +125,14 @@ const THREAD_END: Record<NonNullable<ToolUse["thread"]>["state"], string> = {
115
125
  stopped: "⊘ Subagent stopped",
116
126
  };
117
127
 
128
+ // A subagent's span, " (1m 4s)", from its task call to the call's result;
129
+ // "" while the call is open or when the log stamps either end with no time.
130
+ function threadSpan(tool: ToolUse): string {
131
+ const start = Date.parse(tool.processedAt);
132
+ const end = tool.result === undefined ? Number.NaN : Date.parse(tool.result.processedAt);
133
+ return Number.isNaN(start) || Number.isNaN(end) ? "" : ` (${formatElapsed(end - start)})`;
134
+ }
135
+
118
136
  // One line for a tool use in its current state.
119
137
  function toolLine(tool: ToolUse): string {
120
138
  const label = toolLabel(tool);
@@ -2,7 +2,7 @@
2
2
  //
3
3
  // Deliberately free of any React/Ink imports so the command can decide whether
4
4
  // to take the interactive path *before* paying the dynamic-import cost of
5
- // ink.tsx. Mirrors Go's termctl.IsSupported.
5
+ // ink.tsx.
6
6
 
7
7
  /**
8
8
  * Whether the terminal can host the interactive Ink renderer: stdout must be a
@@ -4,13 +4,16 @@
4
4
  //
5
5
  // This is an id-shaped mutation, so it rides the high-level sub-clients
6
6
  // (resolve the resource by reference, then tagVersion) rather than a raw
7
- // controller.
7
+ // controller. The version is named by its hash or by a unique prefix of it,
8
+ // such as the short hash `get agent --version-history` prints; the CLI
9
+ // resolves the prefix to the full hash the server takes.
8
10
 
9
11
  import { create } from "@bufbuild/protobuf";
10
12
  import { TagAgentVersionInputSchema } from "@stigmer/apis/ai/stigmer/agentic/agent/v1/version_pb";
11
13
  import type { Stigmer } from "@stigmer/client";
12
14
  import { UsageError } from "../errors/index.js";
13
15
  import { CommandResult } from "../output/index.js";
16
+ import { resolveAgentVersionHash, shortVersionHash } from "./version.js";
14
17
 
15
18
  /** The resource types a tag can be assigned to, by the aliases the CLI accepts. */
16
19
  const TAGGABLE: ReadonlySet<string> = new Set(["agent"]);
@@ -30,9 +33,10 @@ export async function tagVersion(
30
33
  const [refOrg, slug] = parseOrgSlug(ref, org);
31
34
  const agent = await client.agent.getByReference({ org: refOrg, slug });
32
35
  const agentId = agent.metadata?.id ?? "";
33
- await client.agent.tagVersion(create(TagAgentVersionInputSchema, { agentId, versionHash: hash, tag }));
36
+ const versionHash = await resolveAgentVersionHash(client, refOrg, slug, hash);
37
+ await client.agent.tagVersion(create(TagAgentVersionInputSchema, { agentId, versionHash, tag }));
34
38
 
35
- return CommandResult.success(`Tagged version ${truncateHash(hash)} as '${tag}'`);
39
+ return CommandResult.success(`Tagged version ${shortVersionHash(versionHash)} as '${tag}'`);
36
40
  }
37
41
 
38
42
  // "org/slug" → [org, slug]; a bare token uses the resolved org context.
@@ -43,9 +47,3 @@ function parseOrgSlug(ref: string, defaultOrg: string): [string, string] {
43
47
  }
44
48
  return [defaultOrg, ref];
45
49
  }
46
-
47
- // The backend addresses versions by their full content hash; the CLI echoes a
48
- // 12-char prefix for readability, matching Go's truncateHash.
49
- function truncateHash(hash: string): string {
50
- return hash.length > 12 ? hash.slice(0, 12) : hash;
51
- }
@@ -4,8 +4,7 @@
4
4
  // of the report's tokens; no dollar figure appears. A served-by line says
5
5
  // whose provider credential served the tokens (the organization's own keys
6
6
  // or a connection the platform provides), and "estimated" marks numbers counted from a
7
- // run's own runner report rather than the deployment's meter. Mirrors the
8
- // retired Go CLI's usage_* renderers for layout and date formatting.
7
+ // run's own runner report rather than the deployment's meter.
9
8
  //
10
9
  // Two clocks, two words, two units. Every report shows WORKING time, the
11
10
  // seconds an agent worked (never waiting for a person), as a duration in
@@ -15,12 +14,12 @@
15
14
  // up, the rule the console's billing page and the invoice use; it is the
16
15
  // one place a price may appear, the plan's own price past its allowance.
17
16
  //
18
- // A deliberate divergence from the retired Go CLI, which serialized usage
19
- // reports with the standard library (encoding/json + yaml.v3) directly on the
20
- // proto messages, a *different* shape (lowerCamel keys, integer enums, numeric
21
- // int64) than the protojson used by every other command. We emit protojson
22
- // here for consistency with the rest of the CLI (string enums/int64,
23
- // snake_case keys).
17
+ // json and yaml are protojson, as every other command prints (string
18
+ // enums/int64, snake_case keys).
19
+ //
20
+ // The HARNESS column prints each harness's label (Stigmer, Claude Agent), and
21
+ // a word this build does not know as it came, so a newer server's harness
22
+ // still shows; machine output keeps the wire word.
24
23
 
25
24
  import { create } from "@bufbuild/protobuf";
26
25
  import { RunPhase } from "@stigmer/apis/ai/stigmer/agentic/run/v1/enum_pb";
@@ -48,8 +47,9 @@ import {
48
47
  } from "@stigmer/apis/ai/stigmer/billing/subscription/v1/io_pb";
49
48
  import type { Stigmer } from "@stigmer/client";
50
49
  import type { OutputFormat } from "../output/index.js";
51
- import { renderProtoJson, renderProtoYaml, renderTable } from "../output/index.js";
50
+ import { renderProtoJson, renderProtoYaml, renderTable, terminalWidth, type TerminalStream } from "../output/index.js";
52
51
  import { formatTokenCount } from "./run-format.js";
52
+ import { ENGINES, isEngineWord } from "./run/engines.js";
53
53
 
54
54
  export interface DateRange {
55
55
  readonly from: string;
@@ -267,6 +267,7 @@ export function renderOrgUsage(
267
267
  report: GetOrgUsageReportOutput,
268
268
  range: DateRange,
269
269
  format: OutputFormat,
270
+ stream: TerminalStream = process.stdout,
270
271
  ): string {
271
272
  if (format === "json") return renderProtoJson(GetOrgUsageReportOutputSchema, report);
272
273
  if (format === "yaml") return renderProtoYaml(GetOrgUsageReportOutputSchema, report);
@@ -299,12 +300,17 @@ export function renderOrgUsage(
299
300
  formatShare(a.totalTokens, totalTokens),
300
301
  formatWorkingTime(a.workingSeconds),
301
302
  ]);
302
- lines.push(renderTable(["AGENT", "RUNS", "TOKENS", "SHARE", "WORKING"], rows), "");
303
+ // An agent is named by its display name here, the free text that gives up width on a narrow terminal.
304
+ const table = renderTable(["AGENT", "RUNS", "TOKENS", "SHARE", "WORKING"], rows, {
305
+ width: terminalWidth(stream),
306
+ shrink: ["AGENT"],
307
+ });
308
+ lines.push(table, "");
303
309
  }
304
310
 
305
311
  if (report.harnessUsage.length > 0) {
306
312
  const rows = report.harnessUsage.map((h) => [
307
- h.harness,
313
+ isEngineWord(h.harness) ? ENGINES[h.harness].label : h.harness,
308
314
  String(h.runCount),
309
315
  formatTokenCount(h.totalTokens),
310
316
  formatShare(h.totalTokens, totalTokens),
@@ -338,7 +344,7 @@ function reportTokens(usage: UsageReportAggregate | undefined, models: readonly
338
344
  * shows only when more than one known source served tokens; a single known
339
345
  * source reads as its name, with any tokens whose server was not recorded
340
346
  * noted beside it. No known source (every run counted from its runner's own
341
- * report, or metered records older than the field) prints nothing, since
347
+ * report, or metered calls whose meter did not say) prints nothing, since
342
348
  * there is nothing to tell apart.
343
349
  */
344
350
  export function formatServedBy(usage: UsageReportAggregate | undefined): string {
@@ -368,8 +374,6 @@ function servedByLabel(source: ProviderKeySource): string {
368
374
  switch (source) {
369
375
  case ProviderKeySource.ORGANIZATION:
370
376
  return "your keys";
371
- case ProviderKeySource.PLATFORM:
372
- return "the platform's connection";
373
377
  case ProviderKeySource.UNSPECIFIED:
374
378
  return "not recorded";
375
379
  default: {
@@ -420,7 +424,7 @@ function formatInputDateRange(from: string, to: string): string {
420
424
  return `${from} to ${to}`;
421
425
  }
422
426
 
423
- // Matches Go's mapPhaseToString (snake_case phase labels for the usage table).
427
+ // Snake_case phase labels for the usage table.
424
428
  function mapPhaseToString(phase: RunPhase): string {
425
429
  switch (phase) {
426
430
  case RunPhase.RUN_PENDING:
@@ -1,14 +1,12 @@
1
1
  // Offline resource validation: parse a YAML document into its proto schema.
2
2
  //
3
3
  // protobuf-es `fromJson` performs structural validation — field types, required
4
- // shapes, and enum membership — without a server round-trip, mirroring the Go
5
- // CLI's local load-and-validate. The accepted kinds are the file-based verbs
4
+ // shapes, and enum membership — without a server round-trip. The accepted kinds are the file-based verbs
6
5
  // (apply/validate) that carry a YAML representation.
7
6
 
8
7
  import { type DescMessage, fromJson, type JsonValue } from "@bufbuild/protobuf";
9
8
  import { AgentSchema } from "@stigmer/apis/ai/stigmer/agentic/agent/v1/api_pb";
10
9
  import { ApiResourceKind } from "@stigmer/apis/ai/stigmer/commons/apiresource/apiresourcekind/api_resource_kind_pb";
11
- import { mcpServerWayForward, subagentsWayForward } from "@stigmer/client";
12
10
 
13
11
  // Exported for the verb/dispatch conformance suite (registry/registry.test.ts),
14
12
  // which holds this map and the matrix's Verb.Validate promises to strict
@@ -24,13 +22,6 @@ export function schemaForValidate(kind: ApiResourceKind): DescMessage | undefine
24
22
 
25
23
  /** Structurally validate a parsed YAML document against its proto schema. */
26
24
  export function validateDocument(schema: DescMessage, document: JsonValue): void {
27
- // A retired field is not a forward-compat one: the leniency below would
28
- // pass an agent listing mcp_server_usages or sub_agents that apply then
29
- // refuses, so each is refused here with the same way forward.
30
- const retired = mcpServerWayForward(document);
31
- if (retired !== undefined) throw new Error(`mcp_server_usages is no longer read. ${retired}`);
32
- const subagents = subagentsWayForward(document);
33
- if (subagents !== undefined) throw new Error(`sub_agents is no longer read. ${subagents}`);
34
25
  // ignoreUnknownFields mirrors the server's lenient unmarshal: forward-compat
35
26
  // fields a newer server adds should not fail a slightly older CLI.
36
27
  fromJson(schema, document, { ignoreUnknownFields: true });