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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (760) hide show
  1. package/README.md +5 -4
  2. package/auth/auth0.js +1 -1
  3. package/auth/auth0.js.map +1 -1
  4. package/auth/token.d.ts +26 -4
  5. package/auth/token.d.ts.map +1 -1
  6. package/auth/token.js +120 -24
  7. package/auth/token.js.map +1 -1
  8. package/client/client.d.ts.map +1 -1
  9. package/client/client.js +21 -8
  10. package/client/client.js.map +1 -1
  11. package/command-tree.d.ts +63 -0
  12. package/command-tree.d.ts.map +1 -0
  13. package/command-tree.js +128 -0
  14. package/command-tree.js.map +1 -0
  15. package/commands/access-history/index.d.ts.map +1 -1
  16. package/commands/access-history/index.js +13 -1
  17. package/commands/access-history/index.js.map +1 -1
  18. package/commands/agent-exec-flags.d.ts +2 -0
  19. package/commands/agent-exec-flags.d.ts.map +1 -1
  20. package/commands/agent-exec-flags.js +9 -5
  21. package/commands/agent-exec-flags.js.map +1 -1
  22. package/commands/apikey/duration.d.ts.map +1 -1
  23. package/commands/apikey/duration.js +1 -2
  24. package/commands/apikey/duration.js.map +1 -1
  25. package/commands/apikey/index.d.ts.map +1 -1
  26. package/commands/apikey/index.js +3 -4
  27. package/commands/apikey/index.js.map +1 -1
  28. package/commands/apply.d.ts.map +1 -1
  29. package/commands/apply.js +2 -32
  30. package/commands/apply.js.map +1 -1
  31. package/commands/auth/index.d.ts.map +1 -1
  32. package/commands/auth/index.js +7 -5
  33. package/commands/auth/index.js.map +1 -1
  34. package/commands/auth/whoami.js +1 -1
  35. package/commands/config/index.js +3 -3
  36. package/commands/config/kv.d.ts.map +1 -1
  37. package/commands/config/kv.js +18 -14
  38. package/commands/config/kv.js.map +1 -1
  39. package/commands/connect.d.ts.map +1 -1
  40. package/commands/connect.js +18 -2
  41. package/commands/connect.js.map +1 -1
  42. package/commands/download.d.ts.map +1 -1
  43. package/commands/download.js +81 -54
  44. package/commands/download.js.map +1 -1
  45. package/commands/eval.d.ts.map +1 -1
  46. package/commands/eval.js +17 -19
  47. package/commands/eval.js.map +1 -1
  48. package/commands/file.d.ts +3 -0
  49. package/commands/file.d.ts.map +1 -0
  50. package/commands/file.js +64 -0
  51. package/commands/file.js.map +1 -0
  52. package/commands/get.d.ts.map +1 -1
  53. package/commands/get.js +20 -13
  54. package/commands/get.js.map +1 -1
  55. package/commands/help.d.ts +15 -0
  56. package/commands/help.d.ts.map +1 -0
  57. package/commands/help.js +175 -0
  58. package/commands/help.js.map +1 -0
  59. package/commands/internal-daemon.d.ts.map +1 -1
  60. package/commands/internal-daemon.js +9 -2
  61. package/commands/internal-daemon.js.map +1 -1
  62. package/commands/list.d.ts.map +1 -1
  63. package/commands/list.js +22 -1
  64. package/commands/list.js.map +1 -1
  65. package/commands/logs.js +1 -1
  66. package/commands/logs.js.map +1 -1
  67. package/commands/mcp-server.d.ts +16 -6
  68. package/commands/mcp-server.d.ts.map +1 -1
  69. package/commands/mcp-server.js +51 -26
  70. package/commands/mcp-server.js.map +1 -1
  71. package/commands/provider-key/index.d.ts +3 -0
  72. package/commands/provider-key/index.d.ts.map +1 -0
  73. package/commands/provider-key/index.js +156 -0
  74. package/commands/provider-key/index.js.map +1 -0
  75. package/commands/push.js +8 -8
  76. package/commands/push.js.map +1 -1
  77. package/commands/resume.d.ts.map +1 -1
  78. package/commands/resume.js +17 -11
  79. package/commands/resume.js.map +1 -1
  80. package/commands/routine.d.ts.map +1 -1
  81. package/commands/routine.js +42 -3
  82. package/commands/routine.js.map +1 -1
  83. package/commands/run.d.ts.map +1 -1
  84. package/commands/run.js +34 -15
  85. package/commands/run.js.map +1 -1
  86. package/commands/runs/approve.d.ts.map +1 -1
  87. package/commands/runs/approve.js +10 -2
  88. package/commands/runs/approve.js.map +1 -1
  89. package/commands/runs/control.d.ts.map +1 -1
  90. package/commands/runs/control.js +24 -16
  91. package/commands/runs/control.js.map +1 -1
  92. package/commands/runs/index.d.ts.map +1 -1
  93. package/commands/runs/index.js +1 -2
  94. package/commands/runs/index.js.map +1 -1
  95. package/commands/runs/logs.d.ts.map +1 -1
  96. package/commands/runs/logs.js +7 -4
  97. package/commands/runs/logs.js.map +1 -1
  98. package/commands/runs/to-eval-case.d.ts.map +1 -1
  99. package/commands/runs/to-eval-case.js +13 -4
  100. package/commands/runs/to-eval-case.js.map +1 -1
  101. package/commands/runs/trace.js +1 -1
  102. package/commands/runs/trace.js.map +1 -1
  103. package/commands/search.js +2 -3
  104. package/commands/search.js.map +1 -1
  105. package/commands/service-account/index.d.ts.map +1 -1
  106. package/commands/service-account/index.js +4 -2
  107. package/commands/service-account/index.js.map +1 -1
  108. package/commands/session-help.d.ts +5 -0
  109. package/commands/session-help.d.ts.map +1 -0
  110. package/commands/session-help.js +38 -0
  111. package/commands/session-help.js.map +1 -0
  112. package/commands/setup.js +5 -5
  113. package/commands/setup.js.map +1 -1
  114. package/commands/shared.d.ts +10 -2
  115. package/commands/shared.d.ts.map +1 -1
  116. package/commands/shared.js +30 -3
  117. package/commands/shared.js.map +1 -1
  118. package/commands/tag.d.ts.map +1 -1
  119. package/commands/tag.js +11 -6
  120. package/commands/tag.js.map +1 -1
  121. package/commands/up.d.ts.map +1 -1
  122. package/commands/up.js +51 -21
  123. package/commands/up.js.map +1 -1
  124. package/commands/validate.js +2 -2
  125. package/commands/validate.js.map +1 -1
  126. package/commands/version.d.ts.map +1 -1
  127. package/commands/version.js +8 -4
  128. package/commands/version.js.map +1 -1
  129. package/config/config.d.ts +5 -22
  130. package/config/config.d.ts.map +1 -1
  131. package/config/config.js +56 -47
  132. package/config/config.js.map +1 -1
  133. package/config/index.d.ts +2 -2
  134. package/config/index.d.ts.map +1 -1
  135. package/config/index.js +1 -1
  136. package/config/index.js.map +1 -1
  137. package/config/keys.js +4 -4
  138. package/config/keys.js.map +1 -1
  139. package/config/paths.js +2 -2
  140. package/config/paths.js.map +1 -1
  141. package/config/resolve.d.ts +12 -2
  142. package/config/resolve.d.ts.map +1 -1
  143. package/config/resolve.js +18 -8
  144. package/config/resolve.js.map +1 -1
  145. package/errors/classify.d.ts +20 -0
  146. package/errors/classify.d.ts.map +1 -1
  147. package/errors/classify.js +97 -21
  148. package/errors/classify.js.map +1 -1
  149. package/errors/command-line.d.ts +14 -0
  150. package/errors/command-line.d.ts.map +1 -0
  151. package/errors/command-line.js +90 -0
  152. package/errors/command-line.js.map +1 -0
  153. package/errors/handle.js +2 -2
  154. package/errors/handle.js.map +1 -1
  155. package/errors/index.d.ts +2 -2
  156. package/errors/index.d.ts.map +1 -1
  157. package/errors/index.js +12 -2
  158. package/errors/index.js.map +1 -1
  159. package/errors/usage-error.js +1 -1
  160. package/errors/usage-error.js.map +1 -1
  161. package/global-options.d.ts +35 -0
  162. package/global-options.d.ts.map +1 -0
  163. package/global-options.js +81 -0
  164. package/global-options.js.map +1 -0
  165. package/local/artifact.d.ts +1 -20
  166. package/local/artifact.d.ts.map +1 -1
  167. package/local/artifact.js +35 -117
  168. package/local/artifact.js.map +1 -1
  169. package/local/constants.d.ts +3 -9
  170. package/local/constants.d.ts.map +1 -1
  171. package/local/constants.js +3 -9
  172. package/local/constants.js.map +1 -1
  173. package/local/daemon/components.d.ts +18 -5
  174. package/local/daemon/components.d.ts.map +1 -1
  175. package/local/daemon/components.js +61 -23
  176. package/local/daemon/components.js.map +1 -1
  177. package/local/daemon/env.d.ts +1 -5
  178. package/local/daemon/env.d.ts.map +1 -1
  179. package/local/daemon/env.js +0 -2
  180. package/local/daemon/env.js.map +1 -1
  181. package/local/daemon/host.d.ts +5 -0
  182. package/local/daemon/host.d.ts.map +1 -1
  183. package/local/daemon/host.js +68 -21
  184. package/local/daemon/host.js.map +1 -1
  185. package/local/daemon/index.d.ts +2 -1
  186. package/local/daemon/index.d.ts.map +1 -1
  187. package/local/daemon/index.js +2 -1
  188. package/local/daemon/index.js.map +1 -1
  189. package/local/daemon/launch.d.ts +58 -9
  190. package/local/daemon/launch.d.ts.map +1 -1
  191. package/local/daemon/launch.js +210 -64
  192. package/local/daemon/launch.js.map +1 -1
  193. package/local/daemon/process.d.ts +11 -7
  194. package/local/daemon/process.d.ts.map +1 -1
  195. package/local/daemon/process.js +74 -38
  196. package/local/daemon/process.js.map +1 -1
  197. package/local/daemon/signals.d.ts +3 -0
  198. package/local/daemon/signals.d.ts.map +1 -0
  199. package/local/daemon/signals.js +19 -0
  200. package/local/daemon/signals.js.map +1 -0
  201. package/local/daemon/supervisor.d.ts +9 -2
  202. package/local/daemon/supervisor.d.ts.map +1 -1
  203. package/local/daemon/supervisor.js +81 -22
  204. package/local/daemon/supervisor.js.map +1 -1
  205. package/local/daemon/types.d.ts +6 -1
  206. package/local/daemon/types.d.ts.map +1 -1
  207. package/local/daemon/types.js +2 -3
  208. package/local/daemon/types.js.map +1 -1
  209. package/local/llm-config.d.ts +4 -2
  210. package/local/llm-config.d.ts.map +1 -1
  211. package/local/llm-config.js +15 -9
  212. package/local/llm-config.js.map +1 -1
  213. package/local/logs/view.d.ts.map +1 -1
  214. package/local/logs/view.js +5 -6
  215. package/local/logs/view.js.map +1 -1
  216. package/local/net/tcp.d.ts +8 -6
  217. package/local/net/tcp.d.ts.map +1 -1
  218. package/local/net/tcp.js +13 -8
  219. package/local/net/tcp.js.map +1 -1
  220. package/local/paths.d.ts +1 -1
  221. package/local/paths.d.ts.map +1 -1
  222. package/local/paths.js +2 -3
  223. package/local/paths.js.map +1 -1
  224. package/local/provider-reach.d.ts +18 -0
  225. package/local/provider-reach.d.ts.map +1 -0
  226. package/local/provider-reach.js +109 -0
  227. package/local/provider-reach.js.map +1 -0
  228. package/local/reset.d.ts.map +1 -1
  229. package/local/reset.js +1 -2
  230. package/local/reset.js.map +1 -1
  231. package/local/runtime/index.d.ts.map +1 -1
  232. package/local/runtime/index.js +1 -2
  233. package/local/runtime/index.js.map +1 -1
  234. package/local/runtime/node.js +1 -1
  235. package/local/runtime/runner.js +2 -2
  236. package/local/runtime/runner.js.map +1 -1
  237. package/local/runtime/runtimes-install.js +1 -1
  238. package/local/runtime/server.d.ts.map +1 -1
  239. package/local/runtime/server.js +2 -4
  240. package/local/runtime/server.js.map +1 -1
  241. package/local/runtime/which.js +1 -1
  242. package/local/runtime/which.js.map +1 -1
  243. package/local/setup/wizard.d.ts +1 -1
  244. package/local/setup/wizard.d.ts.map +1 -1
  245. package/local/setup/wizard.js +7 -5
  246. package/local/setup/wizard.js.map +1 -1
  247. package/local/state/health-state.d.ts +6 -0
  248. package/local/state/health-state.d.ts.map +1 -1
  249. package/local/state/health-state.js +6 -2
  250. package/local/state/health-state.js.map +1 -1
  251. package/local/state/lock.d.ts +3 -2
  252. package/local/state/lock.d.ts.map +1 -1
  253. package/local/state/lock.js +26 -28
  254. package/local/state/lock.js.map +1 -1
  255. package/local/state/log-rotation.d.ts.map +1 -1
  256. package/local/state/log-rotation.js +2 -3
  257. package/local/state/log-rotation.js.map +1 -1
  258. package/local/state/pidfile.d.ts +24 -1
  259. package/local/state/pidfile.d.ts.map +1 -1
  260. package/local/state/pidfile.js +54 -6
  261. package/local/state/pidfile.js.map +1 -1
  262. package/local/state/proc.d.ts +31 -0
  263. package/local/state/proc.d.ts.map +1 -1
  264. package/local/state/proc.js +98 -1
  265. package/local/state/proc.js.map +1 -1
  266. package/local/state/startup-config.d.ts +2 -2
  267. package/local/status.d.ts +2 -4
  268. package/local/status.d.ts.map +1 -1
  269. package/local/status.js +26 -41
  270. package/local/status.js.map +1 -1
  271. package/local/temporal/download.d.ts +9 -5
  272. package/local/temporal/download.d.ts.map +1 -1
  273. package/local/temporal/download.js +29 -8
  274. package/local/temporal/download.js.map +1 -1
  275. package/local/temporal/index.d.ts +1 -1
  276. package/local/temporal/index.d.ts.map +1 -1
  277. package/local/temporal/index.js +1 -1
  278. package/local/temporal/index.js.map +1 -1
  279. package/local/temporal/manager.d.ts +31 -5
  280. package/local/temporal/manager.d.ts.map +1 -1
  281. package/local/temporal/manager.js +74 -35
  282. package/local/temporal/manager.js.map +1 -1
  283. package/local/temporal/supervisor.js +1 -1
  284. package/local/temporal/supervisor.js.map +1 -1
  285. package/local/webconsole/index.d.ts +5 -2
  286. package/local/webconsole/index.d.ts.map +1 -1
  287. package/local/webconsole/index.js +8 -6
  288. package/local/webconsole/index.js.map +1 -1
  289. package/marketplace/github.js +1 -1
  290. package/marketplace/github.js.map +1 -1
  291. package/marketplace/official.js +1 -1
  292. package/marketplace/official.js.map +1 -1
  293. package/output/command-result.d.ts +6 -0
  294. package/output/command-result.d.ts.map +1 -1
  295. package/output/command-result.js +13 -2
  296. package/output/command-result.js.map +1 -1
  297. package/output/confirm.d.ts.map +1 -1
  298. package/output/confirm.js +2 -3
  299. package/output/confirm.js.map +1 -1
  300. package/output/format.d.ts.map +1 -1
  301. package/output/format.js +5 -6
  302. package/output/format.js.map +1 -1
  303. package/output/index.d.ts +2 -2
  304. package/output/index.d.ts.map +1 -1
  305. package/output/index.js +2 -2
  306. package/output/index.js.map +1 -1
  307. package/output/printable.d.ts +8 -0
  308. package/output/printable.d.ts.map +1 -0
  309. package/output/printable.js +24 -0
  310. package/output/printable.js.map +1 -0
  311. package/output/proto.d.ts.map +1 -1
  312. package/output/proto.js +3 -4
  313. package/output/proto.js.map +1 -1
  314. package/output/style.js +2 -2
  315. package/output/style.js.map +1 -1
  316. package/output/table.d.ts +20 -1
  317. package/output/table.d.ts.map +1 -1
  318. package/output/table.js +75 -17
  319. package/output/table.js.map +1 -1
  320. package/package.json +13 -10
  321. package/program.d.ts +0 -14
  322. package/program.d.ts.map +1 -1
  323. package/program.js +57 -119
  324. package/program.js.map +1 -1
  325. package/registry/aliases.d.ts.map +1 -1
  326. package/registry/aliases.js +0 -3
  327. package/registry/aliases.js.map +1 -1
  328. package/registry/index.d.ts +1 -1
  329. package/registry/index.d.ts.map +1 -1
  330. package/registry/index.js +1 -1
  331. package/registry/index.js.map +1 -1
  332. package/registry/metadata.d.ts +0 -15
  333. package/registry/metadata.d.ts.map +1 -1
  334. package/registry/metadata.js +16 -57
  335. package/registry/metadata.js.map +1 -1
  336. package/registry/registry.d.ts +1 -5
  337. package/registry/registry.d.ts.map +1 -1
  338. package/registry/registry.js +3 -11
  339. package/registry/registry.js.map +1 -1
  340. package/registry/verb-support.d.ts.map +1 -1
  341. package/registry/verb-support.js +28 -5
  342. package/registry/verb-support.js.map +1 -1
  343. package/resources/agent/quality.d.ts +10 -5
  344. package/resources/agent/quality.d.ts.map +1 -1
  345. package/resources/agent/quality.js +19 -9
  346. package/resources/agent/quality.js.map +1 -1
  347. package/resources/agent/resolve.js +3 -3
  348. package/resources/agent/resolve.js.map +1 -1
  349. package/resources/apply/apply.d.ts +4 -3
  350. package/resources/apply/apply.d.ts.map +1 -1
  351. package/resources/apply/apply.js +54 -41
  352. package/resources/apply/apply.js.map +1 -1
  353. package/resources/apply/handlers.d.ts.map +1 -1
  354. package/resources/apply/handlers.js +3 -4
  355. package/resources/apply/handlers.js.map +1 -1
  356. package/resources/channel.d.ts.map +1 -1
  357. package/resources/channel.js +3 -4
  358. package/resources/channel.js.map +1 -1
  359. package/resources/connect/connect.js +2 -2
  360. package/resources/connect/connect.js.map +1 -1
  361. package/resources/delete.d.ts.map +1 -1
  362. package/resources/delete.js +38 -4
  363. package/resources/delete.js.map +1 -1
  364. package/resources/documents.js +1 -1
  365. package/resources/documents.js.map +1 -1
  366. package/resources/download.d.ts +43 -3
  367. package/resources/download.d.ts.map +1 -1
  368. package/resources/download.js +169 -34
  369. package/resources/download.js.map +1 -1
  370. package/resources/eval-run/options.d.ts +3 -1
  371. package/resources/eval-run/options.d.ts.map +1 -1
  372. package/resources/eval-run/options.js +36 -18
  373. package/resources/eval-run/options.js.map +1 -1
  374. package/resources/eval-run/report.d.ts +4 -2
  375. package/resources/eval-run/report.d.ts.map +1 -1
  376. package/resources/eval-run/report.js +9 -7
  377. package/resources/eval-run/report.js.map +1 -1
  378. package/resources/eval-run/run.d.ts +2 -1
  379. package/resources/eval-run/run.d.ts.map +1 -1
  380. package/resources/eval-run/run.js +13 -7
  381. package/resources/eval-run/run.js.map +1 -1
  382. package/resources/file.d.ts +27 -0
  383. package/resources/file.d.ts.map +1 -0
  384. package/resources/file.js +82 -0
  385. package/resources/file.js.map +1 -0
  386. package/resources/get-bindings.d.ts.map +1 -1
  387. package/resources/get-bindings.js +18 -0
  388. package/resources/get-bindings.js.map +1 -1
  389. package/resources/git.d.ts +1 -1
  390. package/resources/git.js +1 -1
  391. package/resources/list.d.ts +21 -2
  392. package/resources/list.d.ts.map +1 -1
  393. package/resources/list.js +148 -31
  394. package/resources/list.js.map +1 -1
  395. package/resources/plugin.d.ts.map +1 -1
  396. package/resources/plugin.js +4 -0
  397. package/resources/plugin.js.map +1 -1
  398. package/resources/provider-key.d.ts +81 -0
  399. package/resources/provider-key.d.ts.map +1 -0
  400. package/resources/provider-key.js +261 -0
  401. package/resources/provider-key.js.map +1 -0
  402. package/resources/reference.d.ts +15 -21
  403. package/resources/reference.d.ts.map +1 -1
  404. package/resources/reference.js +42 -88
  405. package/resources/reference.js.map +1 -1
  406. package/resources/render.d.ts +31 -7
  407. package/resources/render.d.ts.map +1 -1
  408. package/resources/render.js +66 -38
  409. package/resources/render.js.map +1 -1
  410. package/resources/routine.d.ts +21 -5
  411. package/resources/routine.d.ts.map +1 -1
  412. package/resources/routine.js +104 -15
  413. package/resources/routine.js.map +1 -1
  414. package/resources/run/agent-exec.d.ts +12 -2
  415. package/resources/run/agent-exec.d.ts.map +1 -1
  416. package/resources/run/agent-exec.js +85 -38
  417. package/resources/run/agent-exec.js.map +1 -1
  418. package/resources/run/create.d.ts +16 -12
  419. package/resources/run/create.d.ts.map +1 -1
  420. package/resources/run/create.js +14 -15
  421. package/resources/run/create.js.map +1 -1
  422. package/resources/run/engines.d.ts +32 -0
  423. package/resources/run/engines.d.ts.map +1 -0
  424. package/resources/run/engines.js +39 -0
  425. package/resources/run/engines.js.map +1 -0
  426. package/resources/run/environment.d.ts +11 -0
  427. package/resources/run/environment.d.ts.map +1 -0
  428. package/resources/run/environment.js +30 -0
  429. package/resources/run/environment.js.map +1 -0
  430. package/resources/run/epilogue.d.ts +1 -1
  431. package/resources/run/epilogue.d.ts.map +1 -1
  432. package/resources/run/epilogue.js +18 -19
  433. package/resources/run/epilogue.js.map +1 -1
  434. package/resources/run/files.d.ts +104 -0
  435. package/resources/run/files.d.ts.map +1 -0
  436. package/resources/run/files.js +316 -0
  437. package/resources/run/files.js.map +1 -0
  438. package/resources/run/header.d.ts +11 -9
  439. package/resources/run/header.d.ts.map +1 -1
  440. package/resources/run/header.js +14 -14
  441. package/resources/run/header.js.map +1 -1
  442. package/resources/run/prepare.d.ts +31 -25
  443. package/resources/run/prepare.d.ts.map +1 -1
  444. package/resources/run/prepare.js +42 -51
  445. package/resources/run/prepare.js.map +1 -1
  446. package/resources/run/references.d.ts.map +1 -1
  447. package/resources/run/references.js +6 -5
  448. package/resources/run/references.js.map +1 -1
  449. package/resources/run/resolve.js +1 -1
  450. package/resources/run/resolve.js.map +1 -1
  451. package/resources/run/resume.d.ts +3 -1
  452. package/resources/run/resume.d.ts.map +1 -1
  453. package/resources/run/resume.js +25 -10
  454. package/resources/run/resume.js.map +1 -1
  455. package/resources/run/stream.d.ts +34 -2
  456. package/resources/run/stream.d.ts.map +1 -1
  457. package/resources/run/stream.js +92 -8
  458. package/resources/run/stream.js.map +1 -1
  459. package/resources/run/workspace.d.ts +9 -12
  460. package/resources/run/workspace.d.ts.map +1 -1
  461. package/resources/run/workspace.js +29 -36
  462. package/resources/run/workspace.js.map +1 -1
  463. package/resources/run-approve.d.ts.map +1 -1
  464. package/resources/run-approve.js +2 -11
  465. package/resources/run-approve.js.map +1 -1
  466. package/resources/run-control.d.ts +3 -3
  467. package/resources/run-control.d.ts.map +1 -1
  468. package/resources/run-control.js +4 -5
  469. package/resources/run-control.js.map +1 -1
  470. package/resources/run-format.d.ts +2 -2
  471. package/resources/run-format.d.ts.map +1 -1
  472. package/resources/run-format.js +3 -4
  473. package/resources/run-format.js.map +1 -1
  474. package/resources/run-logs.d.ts +2 -0
  475. package/resources/run-logs.d.ts.map +1 -1
  476. package/resources/run-logs.js +16 -6
  477. package/resources/run-logs.js.map +1 -1
  478. package/resources/run-scores.d.ts +6 -2
  479. package/resources/run-scores.d.ts.map +1 -1
  480. package/resources/run-scores.js +7 -4
  481. package/resources/run-scores.js.map +1 -1
  482. package/resources/run-to-eval-case.js +2 -2
  483. package/resources/run-to-eval-case.js.map +1 -1
  484. package/resources/runs.d.ts +3 -3
  485. package/resources/runs.d.ts.map +1 -1
  486. package/resources/runs.js +5 -5
  487. package/resources/runs.js.map +1 -1
  488. package/resources/search.d.ts.map +1 -1
  489. package/resources/search.js +1 -2
  490. package/resources/search.js.map +1 -1
  491. package/resources/service-account.d.ts +2 -0
  492. package/resources/service-account.d.ts.map +1 -1
  493. package/resources/service-account.js +3 -1
  494. package/resources/service-account.js.map +1 -1
  495. package/resources/session.d.ts +4 -3
  496. package/resources/session.d.ts.map +1 -1
  497. package/resources/session.js +10 -7
  498. package/resources/session.js.map +1 -1
  499. package/resources/skill.d.ts +1 -1
  500. package/resources/skill.d.ts.map +1 -1
  501. package/resources/skill.js +7 -8
  502. package/resources/skill.js.map +1 -1
  503. package/resources/stream/answer.d.ts +1 -2
  504. package/resources/stream/answer.d.ts.map +1 -1
  505. package/resources/stream/answer.js +3 -16
  506. package/resources/stream/answer.js.map +1 -1
  507. package/resources/stream/composer.d.ts +16 -0
  508. package/resources/stream/composer.d.ts.map +1 -0
  509. package/resources/stream/composer.js +171 -0
  510. package/resources/stream/composer.js.map +1 -0
  511. package/resources/stream/ink.d.ts +20 -4
  512. package/resources/stream/ink.d.ts.map +1 -1
  513. package/resources/stream/ink.js +34 -3
  514. package/resources/stream/ink.js.map +1 -1
  515. package/resources/stream/render-plaintext.d.ts +1 -0
  516. package/resources/stream/render-plaintext.d.ts.map +1 -1
  517. package/resources/stream/render-plaintext.js +21 -4
  518. package/resources/stream/render-plaintext.js.map +1 -1
  519. package/resources/stream/tty.js +1 -1
  520. package/resources/stream/tty.js.map +1 -1
  521. package/resources/tag.d.ts.map +1 -1
  522. package/resources/tag.js +7 -8
  523. package/resources/tag.js.map +1 -1
  524. package/resources/usage.d.ts +3 -2
  525. package/resources/usage.d.ts.map +1 -1
  526. package/resources/usage.js +19 -16
  527. package/resources/usage.js.map +1 -1
  528. package/resources/validate.d.ts.map +1 -1
  529. package/resources/validate.js +1 -12
  530. package/resources/validate.js.map +1 -1
  531. package/resources/version.d.ts +17 -3
  532. package/resources/version.d.ts.map +1 -1
  533. package/resources/version.js +105 -14
  534. package/resources/version.js.map +1 -1
  535. package/resources/views/agent.d.ts +3 -0
  536. package/resources/views/agent.d.ts.map +1 -0
  537. package/resources/views/agent.js +54 -0
  538. package/resources/views/agent.js.map +1 -0
  539. package/resources/views/environment.d.ts +3 -0
  540. package/resources/views/environment.d.ts.map +1 -0
  541. package/resources/views/environment.js +37 -0
  542. package/resources/views/environment.js.map +1 -0
  543. package/resources/views/index.d.ts +22 -0
  544. package/resources/views/index.d.ts.map +1 -0
  545. package/resources/views/index.js +70 -0
  546. package/resources/views/index.js.map +1 -0
  547. package/resources/views/organization.d.ts +3 -0
  548. package/resources/views/organization.d.ts.map +1 -0
  549. package/resources/views/organization.js +27 -0
  550. package/resources/views/organization.js.map +1 -0
  551. package/resources/views/routine.d.ts +3 -0
  552. package/resources/views/routine.d.ts.map +1 -0
  553. package/resources/views/routine.js +37 -0
  554. package/resources/views/routine.js.map +1 -0
  555. package/resources/views/run.d.ts +3 -0
  556. package/resources/views/run.d.ts.map +1 -0
  557. package/resources/views/run.js +45 -0
  558. package/resources/views/run.js.map +1 -0
  559. package/resources/views/session.d.ts +5 -0
  560. package/resources/views/session.d.ts.map +1 -0
  561. package/resources/views/session.js +85 -0
  562. package/resources/views/session.js.map +1 -0
  563. package/resources/views/skill.d.ts +5 -0
  564. package/resources/views/skill.d.ts.map +1 -0
  565. package/resources/views/skill.js +48 -0
  566. package/resources/views/skill.js.map +1 -0
  567. package/resources/views/view.d.ts +66 -0
  568. package/resources/views/view.d.ts.map +1 -0
  569. package/resources/views/view.js +130 -0
  570. package/resources/views/view.js.map +1 -0
  571. package/resources/views/words.d.ts +52 -0
  572. package/resources/views/words.d.ts.map +1 -0
  573. package/resources/views/words.js +190 -0
  574. package/resources/views/words.js.map +1 -0
  575. package/runtime.d.ts +22 -0
  576. package/runtime.d.ts.map +1 -1
  577. package/runtime.js +33 -2
  578. package/runtime.js.map +1 -1
  579. package/src/auth/auth0.ts +1 -1
  580. package/src/auth/token.ts +136 -26
  581. package/src/client/client.ts +23 -16
  582. package/src/command-tree.ts +152 -0
  583. package/src/commands/access-history/index.ts +15 -2
  584. package/src/commands/agent-exec-flags.ts +11 -5
  585. package/src/commands/apikey/duration.ts +1 -2
  586. package/src/commands/apikey/index.ts +3 -4
  587. package/src/commands/apply.ts +3 -22
  588. package/src/commands/auth/index.ts +7 -5
  589. package/src/commands/auth/whoami.ts +1 -1
  590. package/src/commands/config/index.ts +3 -3
  591. package/src/commands/config/kv.ts +18 -14
  592. package/src/commands/connect.ts +21 -3
  593. package/src/commands/download.ts +106 -62
  594. package/src/commands/eval.ts +22 -21
  595. package/src/commands/file.ts +80 -0
  596. package/src/commands/get.ts +19 -13
  597. package/src/commands/help.ts +182 -0
  598. package/src/commands/internal-daemon.ts +9 -2
  599. package/src/commands/list.ts +22 -1
  600. package/src/commands/logs.ts +1 -1
  601. package/src/commands/mcp-server.ts +57 -28
  602. package/src/commands/provider-key/index.ts +192 -0
  603. package/src/commands/push.ts +8 -8
  604. package/src/commands/resume.ts +20 -12
  605. package/src/commands/routine.ts +58 -5
  606. package/src/commands/run.ts +37 -17
  607. package/src/commands/runs/approve.ts +13 -4
  608. package/src/commands/runs/control.ts +50 -27
  609. package/src/commands/runs/index.ts +1 -2
  610. package/src/commands/runs/logs.ts +9 -5
  611. package/src/commands/runs/to-eval-case.ts +18 -6
  612. package/src/commands/runs/trace.ts +1 -1
  613. package/src/commands/search.ts +2 -3
  614. package/src/commands/service-account/index.ts +7 -2
  615. package/src/commands/session-help.ts +39 -0
  616. package/src/commands/setup.ts +5 -5
  617. package/src/commands/shared.ts +32 -3
  618. package/src/commands/tag.ts +13 -7
  619. package/src/commands/up.ts +55 -21
  620. package/src/commands/validate.ts +2 -2
  621. package/src/commands/version.ts +9 -4
  622. package/src/config/config.ts +66 -69
  623. package/src/config/index.ts +1 -2
  624. package/src/config/keys.ts +4 -4
  625. package/src/config/paths.ts +2 -2
  626. package/src/config/resolve.ts +20 -8
  627. package/src/errors/classify.ts +110 -21
  628. package/src/errors/command-line.ts +95 -0
  629. package/src/errors/handle.ts +2 -2
  630. package/src/errors/index.ts +12 -2
  631. package/src/errors/usage-error.ts +1 -1
  632. package/src/global-options.ts +100 -0
  633. package/src/local/artifact.ts +46 -140
  634. package/src/local/constants.ts +3 -9
  635. package/src/local/daemon/components.ts +78 -22
  636. package/src/local/daemon/env.ts +3 -8
  637. package/src/local/daemon/host.ts +64 -19
  638. package/src/local/daemon/index.ts +2 -1
  639. package/src/local/daemon/launch.ts +251 -72
  640. package/src/local/daemon/process.ts +78 -46
  641. package/src/local/daemon/signals.ts +19 -0
  642. package/src/local/daemon/supervisor.ts +84 -21
  643. package/src/local/daemon/types.ts +8 -4
  644. package/src/local/llm-config.ts +15 -9
  645. package/src/local/logs/view.ts +5 -6
  646. package/src/local/net/tcp.ts +18 -11
  647. package/src/local/paths.ts +2 -3
  648. package/src/local/provider-reach.ts +124 -0
  649. package/src/local/reset.ts +1 -2
  650. package/src/local/runtime/index.ts +1 -2
  651. package/src/local/runtime/node.ts +1 -1
  652. package/src/local/runtime/runner.ts +2 -2
  653. package/src/local/runtime/runtimes-install.ts +1 -1
  654. package/src/local/runtime/server.ts +2 -4
  655. package/src/local/runtime/which.ts +1 -1
  656. package/src/local/setup/wizard.ts +7 -5
  657. package/src/local/state/health-state.ts +10 -2
  658. package/src/local/state/lock.ts +26 -28
  659. package/src/local/state/log-rotation.ts +2 -3
  660. package/src/local/state/pidfile.ts +61 -6
  661. package/src/local/state/proc.ts +104 -1
  662. package/src/local/state/startup-config.ts +2 -2
  663. package/src/local/status.ts +30 -41
  664. package/src/local/temporal/download.ts +31 -9
  665. package/src/local/temporal/index.ts +1 -1
  666. package/src/local/temporal/manager.ts +94 -34
  667. package/src/local/temporal/supervisor.ts +1 -1
  668. package/src/local/webconsole/index.ts +8 -5
  669. package/src/marketplace/github.ts +1 -1
  670. package/src/marketplace/official.ts +1 -1
  671. package/src/output/command-result.ts +14 -2
  672. package/src/output/confirm.ts +2 -3
  673. package/src/output/format.ts +5 -6
  674. package/src/output/index.ts +8 -1
  675. package/src/output/printable.ts +26 -0
  676. package/src/output/proto.ts +3 -4
  677. package/src/output/style.ts +2 -2
  678. package/src/output/table.ts +118 -15
  679. package/src/program.ts +58 -128
  680. package/src/registry/aliases.ts +0 -3
  681. package/src/registry/index.ts +0 -1
  682. package/src/registry/metadata.ts +16 -64
  683. package/src/registry/registry.ts +3 -13
  684. package/src/registry/verb-support.ts +28 -5
  685. package/src/resources/agent/quality.ts +29 -8
  686. package/src/resources/agent/resolve.ts +3 -3
  687. package/src/resources/apply/apply.ts +58 -49
  688. package/src/resources/apply/handlers.ts +3 -4
  689. package/src/resources/channel.ts +3 -4
  690. package/src/resources/connect/connect.ts +2 -2
  691. package/src/resources/delete.ts +44 -4
  692. package/src/resources/documents.ts +1 -1
  693. package/src/resources/download.ts +239 -43
  694. package/src/resources/eval-run/options.ts +38 -17
  695. package/src/resources/eval-run/report.ts +11 -5
  696. package/src/resources/eval-run/run.ts +13 -9
  697. package/src/resources/file.ts +114 -0
  698. package/src/resources/get-bindings.ts +18 -0
  699. package/src/resources/git.ts +1 -1
  700. package/src/resources/list.ts +178 -34
  701. package/src/resources/plugin.ts +3 -0
  702. package/src/resources/provider-key.ts +327 -0
  703. package/src/resources/reference.ts +41 -85
  704. package/src/resources/render.ts +72 -38
  705. package/src/resources/routine.ts +152 -15
  706. package/src/resources/run/agent-exec.ts +95 -44
  707. package/src/resources/run/create.ts +27 -24
  708. package/src/resources/run/engines.ts +57 -0
  709. package/src/resources/run/environment.ts +43 -0
  710. package/src/resources/run/epilogue.ts +18 -17
  711. package/src/resources/run/files.ts +433 -0
  712. package/src/resources/run/header.ts +18 -18
  713. package/src/resources/run/prepare.ts +67 -74
  714. package/src/resources/run/references.ts +6 -5
  715. package/src/resources/run/resolve.ts +1 -1
  716. package/src/resources/run/resume.ts +28 -9
  717. package/src/resources/run/stream.ts +110 -9
  718. package/src/resources/run/workspace.ts +37 -47
  719. package/src/resources/run-approve.ts +2 -14
  720. package/src/resources/run-control.ts +4 -5
  721. package/src/resources/run-format.ts +3 -4
  722. package/src/resources/run-logs.ts +17 -6
  723. package/src/resources/run-scores.ts +14 -4
  724. package/src/resources/run-to-eval-case.ts +2 -2
  725. package/src/resources/runs.ts +5 -5
  726. package/src/resources/search.ts +1 -2
  727. package/src/resources/service-account.ts +4 -1
  728. package/src/resources/session.ts +10 -7
  729. package/src/resources/skill.ts +7 -8
  730. package/src/resources/stream/answer.ts +3 -19
  731. package/src/resources/stream/composer.ts +170 -0
  732. package/src/resources/stream/ink.tsx +74 -10
  733. package/src/resources/stream/render-plaintext.ts +22 -4
  734. package/src/resources/stream/tty.ts +1 -1
  735. package/src/resources/tag.ts +7 -9
  736. package/src/resources/usage.ts +19 -15
  737. package/src/resources/validate.ts +1 -10
  738. package/src/resources/version.ts +117 -15
  739. package/src/resources/views/agent.ts +60 -0
  740. package/src/resources/views/environment.ts +41 -0
  741. package/src/resources/views/index.ts +82 -0
  742. package/src/resources/views/organization.ts +29 -0
  743. package/src/resources/views/routine.ts +39 -0
  744. package/src/resources/views/run.ts +46 -0
  745. package/src/resources/views/session.ts +91 -0
  746. package/src/resources/views/skill.ts +49 -0
  747. package/src/resources/views/view.ts +188 -0
  748. package/src/resources/views/words.ts +191 -0
  749. package/src/runtime.ts +51 -2
  750. package/errors/exit-codes.d.ts +0 -10
  751. package/errors/exit-codes.d.ts.map +0 -1
  752. package/errors/exit-codes.js +0 -15
  753. package/errors/exit-codes.js.map +0 -1
  754. package/resources/run/attachments.d.ts +0 -24
  755. package/resources/run/attachments.d.ts.map +0 -1
  756. package/resources/run/attachments.js +0 -237
  757. package/resources/run/attachments.js.map +0 -1
  758. package/src/errors/exit-codes.ts +0 -17
  759. package/src/resources/run/attachments.ts +0 -300
  760. package/src/types/marked-terminal.d.ts +0 -31
@@ -1,9 +1,16 @@
1
1
  // Version history (`get agent --version-history`) and single version
2
2
  // retrieval (`get agent --version <hashOrTag>`): every apply that changes an
3
3
  // agent records an immutable, hash-addressed version that can be tagged. The
4
- // history table mirrors Go's RunVersionsList layout and empty-history
5
- // guidance, which names the organization by slug where the caller can see it.
6
- // A version prints the agent as that version stored it.
4
+ // history is one table, and its empty-history guidance names the
5
+ // organization by slug where the caller can see it. A version prints the
6
+ // agent as that version stored it.
7
+ //
8
+ // The table prints a 12-character hash, so wherever the CLI takes a version
9
+ // hash (`tag`, `get --version`) it takes that short form too, as git takes
10
+ // an abbreviated commit: a unique prefix of at least 4 hex characters, any
11
+ // case, matched against the agent's whole history on the client. The
12
+ // server's contract stays the full lower-case hash, so no SDK learns to
13
+ // accept an ambiguous one.
7
14
 
8
15
  import { create } from "@bufbuild/protobuf";
9
16
  import { timestampDate } from "@bufbuild/protobuf/wkt";
@@ -14,10 +21,26 @@ import {
14
21
  } from "@stigmer/apis/ai/stigmer/agentic/agent/v1/version_pb";
15
22
  import type { Stigmer } from "@stigmer/client";
16
23
  import { organizationLabel } from "../client/organizations.js";
24
+ import { CliExitError, classify, ExitCode, UsageError } from "../errors/index.js";
17
25
 
18
- // Go caps the history view at 50 entries (RunVersionsList).
26
+ // The history view shows one page of at most 50 entries.
19
27
  const VERSION_HISTORY_PAGE_SIZE = 50;
20
28
 
29
+ // A prefix lookup reads every page at the largest size the server serves
30
+ // (a larger one reads as 100).
31
+ const VERSION_LOOKUP_PAGE_SIZE = 100;
32
+
33
+ /** How many leading hex characters of a version hash the CLI prints. */
34
+ export const SHORT_HASH_LENGTH = 12;
35
+
36
+ // The shortest prefix taken for a hash: git's floor for an abbreviated one.
37
+ const MIN_HASH_PREFIX_LENGTH = 4;
38
+
39
+ const FULL_HASH = /^[0-9a-f]{64}$/;
40
+ const HASH_PREFIX = new RegExp(`^[0-9a-f]{${MIN_HASH_PREFIX_LENGTH},63}$`);
41
+ // What `get --version` may read as a hash once the server finds no such tag.
42
+ const HASH_SHAPED = new RegExp(`^[0-9a-f]{${MIN_HASH_PREFIX_LENGTH},64}$`, "i");
43
+
21
44
  /** The columns the history table shows. */
22
45
  type VersionRow = Pick<AgentVersionEntry, "versionHash" | "tag" | "appliedAt" | "isCurrent" | "message">;
23
46
 
@@ -33,12 +56,95 @@ export async function renderAgentVersionHistory(client: Stigmer, org: string, sl
33
56
  }
34
57
 
35
58
  /**
36
- * The agent as a version (a hash, a tag, or "latest") stored it. An agent last
37
- * written before agents were versioned has no history yet; its next apply
38
- * records one.
59
+ * The agent as a version (a hash, a short hash, a tag, or "latest") stored
60
+ * it. The argument is asked for as written first, so a tag that looks like
61
+ * hex wins over a hash it happens to prefix, as a ref wins over a short hash
62
+ * in git; only a hash-shaped argument the server did not find is then read
63
+ * as a short hash. One that matches no version answers the server's own
64
+ * not-found.
39
65
  */
40
66
  export async function getAgentAtVersion(client: Stigmer, org: string, slug: string, hashOrTag: string): Promise<Agent> {
41
- return client.agent.getByReference({ org, slug, version: hashOrTag });
67
+ try {
68
+ return await client.agent.getByReference({ org, slug, version: hashOrTag });
69
+ } catch (err) {
70
+ if (!isNotFound(err) || !HASH_SHAPED.test(hashOrTag)) throw err;
71
+ let hash: string;
72
+ try {
73
+ hash = await resolveAgentVersionHash(client, org, slug, hashOrTag);
74
+ } catch (lookup) {
75
+ if (isNotFound(lookup)) throw err;
76
+ throw lookup;
77
+ }
78
+ if (hash === hashOrTag) throw err;
79
+ return client.agent.getByReference({ org, slug, version: hash });
80
+ }
81
+ }
82
+
83
+ /**
84
+ * The full hash of the agent's version `hashArg` names: a full hash in any
85
+ * case as it is, without a read, or a unique prefix of one, matched against
86
+ * every page of the history. No match is NotFound; several are a usage
87
+ * error listing each, since only more of the hash can say which.
88
+ */
89
+ export async function resolveAgentVersionHash(
90
+ client: Stigmer,
91
+ org: string,
92
+ slug: string,
93
+ hashArg: string,
94
+ ): Promise<string> {
95
+ const wanted = hashArg.trim().toLowerCase();
96
+ if (FULL_HASH.test(wanted)) return wanted;
97
+ const handle = org === "" ? slug : `${org}/${slug}`;
98
+ if (!HASH_PREFIX.test(wanted)) {
99
+ throw new UsageError(
100
+ `"${hashArg}" is not a version hash\n\n` +
101
+ `Give the full 64-character hash, or at least its first ${MIN_HASH_PREFIX_LENGTH} characters ` +
102
+ `as \`stigmer get agent ${handle} --version-history\` prints them`,
103
+ );
104
+ }
105
+ const matches = (await listAllVersions(client, org, slug)).filter((entry) => entry.versionHash.startsWith(wanted));
106
+ if (matches.length === 1) return matches[0]!.versionHash;
107
+ if (matches.length === 0) {
108
+ throw new CliExitError(`no version of ${handle} has a hash starting with ${wanted}`, ExitCode.NotFound, [
109
+ `List them with: stigmer get agent ${handle} --version-history`,
110
+ ]);
111
+ }
112
+ throw new UsageError(
113
+ [
114
+ `${wanted} matches ${matches.length} versions of ${handle}:`,
115
+ ...matches.map((entry) => ` ${shortVersionHash(entry.versionHash)} ${entry.tag === "" ? "-" : entry.tag}`),
116
+ "",
117
+ "Give more of the hash.",
118
+ ].join("\n"),
119
+ );
120
+ }
121
+
122
+ /** A version hash as the CLI prints it: its first SHORT_HASH_LENGTH characters. */
123
+ export function shortVersionHash(hash: string): string {
124
+ return hash.slice(0, SHORT_HASH_LENGTH);
125
+ }
126
+
127
+ // Every version of the agent, following the page token until it is empty:
128
+ // a page may be short, even empty, and still carry one. A token that comes
129
+ // back a second time ends the read, so a server that repeats one cannot
130
+ // hold the command forever.
131
+ async function listAllVersions(client: Stigmer, org: string, slug: string): Promise<AgentVersionEntry[]> {
132
+ const entries: AgentVersionEntry[] = [];
133
+ const tokensRead = new Set<string>();
134
+ let pageToken = "";
135
+ do {
136
+ tokensRead.add(pageToken);
137
+ const page = await client.agent.listVersions(
138
+ create(ListAgentVersionsInputSchema, { org, slug, pageSize: VERSION_LOOKUP_PAGE_SIZE, pageToken }),
139
+ );
140
+ entries.push(...page.entries);
141
+ pageToken = page.nextPageToken;
142
+ } while (pageToken !== "" && !tokensRead.has(pageToken));
143
+ return entries;
144
+ }
145
+
146
+ function isNotFound(err: unknown): boolean {
147
+ return classify(err)?.exitCode === ExitCode.NotFound;
42
148
  }
43
149
 
44
150
  async function emptyHistory(client: Stigmer, org: string, slug: string): Promise<string> {
@@ -52,7 +158,7 @@ async function emptyHistory(client: Stigmer, org: string, slug: string): Promise
52
158
  ].join("\n");
53
159
  }
54
160
 
55
- // --- Rendering (mirrors Go's displayVersionsTable) ---
161
+ // --- Rendering ---
56
162
 
57
163
  // The history is one page, newest first: a list says whether more follow,
58
164
  // not how many there are, so the header counts the page and adds "+" when
@@ -67,7 +173,7 @@ function renderVersionsTable(entries: readonly VersionRow[], olderFollow: boolea
67
173
  ];
68
174
 
69
175
  for (const entry of entries) {
70
- const hash = truncateHash(entry.versionHash);
176
+ const hash = shortVersionHash(entry.versionHash);
71
177
  const tag = entry.tag === "" ? "-" : entry.tag;
72
178
  const appliedAt = entry.appliedAt === undefined ? "-" : formatAppliedAt(entry.appliedAt);
73
179
  const current = entry.isCurrent ? "*" : "";
@@ -79,16 +185,12 @@ function renderVersionsTable(entries: readonly VersionRow[], olderFollow: boolea
79
185
  return `${lines.join("\n")}\n`;
80
186
  }
81
187
 
82
- function truncateHash(hash: string): string {
83
- return hash.length > 12 ? hash.slice(0, 12) : hash;
84
- }
85
-
86
188
  function truncateMessage(message: string): string {
87
189
  if (message === "") return "-";
88
190
  return message.length > 40 ? `${message.slice(0, 37)}...` : message;
89
191
  }
90
192
 
91
- // Matches Go's "2006-01-02 15:04" local-time layout.
193
+ // YYYY-MM-DD HH:mm, local time.
92
194
  function formatAppliedAt(timestamp: Parameters<typeof timestampDate>[0]): string {
93
195
  const date = timestampDate(timestamp);
94
196
  const pad2 = (n: number): string => String(n).padStart(2, "0");
@@ -0,0 +1,60 @@
1
+ // `get agent`: what an agent is made of, as a person reads it. Its
2
+ // description and when it last changed; the start of its instructions; the
3
+ // skills, MCP servers, tools, subagents and plugins it works with; the
4
+ // Environment its conversations run in and the values it declares; the
5
+ // settings a run starts from. Everything comes from the agent itself
6
+ // (apis/ai/stigmer/agentic/agent/v1/spec.proto); `-o yaml` prints it whole.
7
+
8
+ import type { JsonValue } from "@bufbuild/protobuf";
9
+ import { asObject, audited, instant, type JsonObject, obj, runSettingFields, str } from "../render.js";
10
+ import type { KindView } from "./view.js";
11
+ import { firstLines, objects, refLabel, refLabels, strings } from "./words.js";
12
+
13
+ export const agentView: KindView = {
14
+ sections: (json, ctx) => {
15
+ const metadata = obj(json, "metadata");
16
+ const spec = obj(json, "spec");
17
+ const { created, updated } = audited(json);
18
+ const instructions = firstLines(str(spec, "instructions"));
19
+ return [
20
+ { fields: [["Description", str(spec, "description")], ["Updated", instant(updated || created)]] },
21
+ { title: "Instructions", lines: instructions.lines, more: instructions.more },
22
+ { title: "Skills", lines: refLabels(spec.skill_refs, metadata, ctx) },
23
+ { title: "MCP servers", rows: objects(spec.mcp_servers).map((server) => [str(server, "name"), str(server, "url")]) },
24
+ {
25
+ title: "Tools",
26
+ fields: [
27
+ ["Allowed", strings(spec.tools).join(", ")],
28
+ ["Disallowed", strings(spec.disallowed_tools).join(", ")],
29
+ ],
30
+ },
31
+ { title: "Subagents", lines: refLabels(spec.subagents, metadata, ctx) },
32
+ { title: "Plugins", lines: refLabels(spec.plugins, metadata, ctx) },
33
+ {
34
+ title: "Environment",
35
+ fields: [
36
+ ["Sandbox", refLabel(obj(spec, "environment_ref"), metadata, ctx)],
37
+ ["Values", declaredValues(spec.env)],
38
+ ],
39
+ },
40
+ { title: "Run settings", fields: runSettingFields(spec, {}) },
41
+ ];
42
+ },
43
+ };
44
+
45
+ // The values an agent declares, by name, each marked secret or optional
46
+ // where it is ("GITHUB_TOKEN (secret), REGION (optional)"). A plain value's
47
+ // content is the agent's own setting, and `-o yaml` shows it.
48
+ function declaredValues(env: JsonValue | undefined): string {
49
+ const declarations: JsonObject = asObject(env);
50
+ return Object.keys(declarations)
51
+ .sort()
52
+ .map((name) => {
53
+ const declaration = asObject(declarations[name]);
54
+ const marks = [declaration.is_secret === true ? "secret" : "", declaration.optional === true ? "optional" : ""].filter(
55
+ (mark) => mark !== "",
56
+ );
57
+ return marks.length === 0 ? name : `${name} (${marks.join(", ")})`;
58
+ })
59
+ .join(", ");
60
+ }
@@ -0,0 +1,41 @@
1
+ // `get environment`: what a conversation's sandbox may reach and what it has
2
+ // installed. The network (unrestricted, or limited to its hosts, with the
3
+ // package registries and the agent's MCP servers reachable or not), the
4
+ // hosts a limited sandbox may reach, and the packages by manager
5
+ // (apis/ai/stigmer/agentic/environment/v1/spec.proto). `list environments`
6
+ // counts the hosts and packages; this is where they are listed.
7
+
8
+ import { obj, str } from "../render.js";
9
+ import type { Field, KindView } from "./view.js";
10
+ import { strings } from "./words.js";
11
+
12
+ // The managers in the order the proto declares them.
13
+ const MANAGERS = ["apt", "cargo", "gem", "go", "npm", "pip"] as const;
14
+
15
+ export const environmentView: KindView = {
16
+ sections: (json) => {
17
+ const spec = obj(json, "spec");
18
+ const networking = obj(spec, "networking");
19
+ const packages = obj(spec, "packages");
20
+ const limited = str(networking, "type") === "limited";
21
+ return [
22
+ {
23
+ fields: [
24
+ ["Description", str(spec, "description")],
25
+ ["Network", limited ? "limited to its hosts" : "unrestricted"],
26
+ ["Package registries", limited ? reachable(networking.allow_package_managers === true) : undefined],
27
+ ["MCP servers", limited ? reachable(networking.allow_mcp_servers === true) : undefined],
28
+ ],
29
+ },
30
+ { title: "Allowed hosts", lines: strings(networking.allowed_hosts) },
31
+ {
32
+ title: "Packages",
33
+ fields: MANAGERS.map((manager): Field => [manager, strings(packages[manager]).join(", ")]),
34
+ },
35
+ ];
36
+ },
37
+ };
38
+
39
+ function reachable(allowed: boolean): string {
40
+ return allowed ? "reachable" : "not reachable";
41
+ }
@@ -0,0 +1,82 @@
1
+ // The per-kind view registry for `get`, beside GET_BINDINGS: which kinds a
2
+ // person reads through a view designed for them, and which keep the generic
3
+ // field view (render.ts). A kind `get` serves is in exactly one of the two,
4
+ // which the registry sweep holds, so a new kind is a decision, not an
5
+ // accident. `renderGet` is the one door `get` prints through: json and yaml
6
+ // stay the whole resource as the server answered; the human view is the
7
+ // kind's own, drawn at the terminal's width (none when piped).
8
+ //
9
+ // `get`'s action imports this module lazily, as it does the rest of the
10
+ // resource layer, so `--help` never loads a view (CLI-08).
11
+
12
+ import type { DescMessage, Message } from "@bufbuild/protobuf";
13
+ import { ApiResourceKind } from "@stigmer/apis/ai/stigmer/commons/apiresource/apiresourcekind/api_resource_kind_pb";
14
+ import type { Stigmer } from "@stigmer/client";
15
+ import { type OutputFormat, protoToJsonValue, shouldColorize, styler, terminalWidth } from "../../output/index.js";
16
+ import { asObject, type RenderFieldsOptions, renderResource } from "../render.js";
17
+ import { agentView } from "./agent.js";
18
+ import { environmentView } from "./environment.js";
19
+ import { organizationView } from "./organization.js";
20
+ import { routineView } from "./routine.js";
21
+ import { runView } from "./run.js";
22
+ import { sessionView } from "./session.js";
23
+ import { skillView } from "./skill.js";
24
+ import { type KindView, renderView } from "./view.js";
25
+
26
+ /** The kinds a person reads through a view designed for them. */
27
+ export const VIEWS: ReadonlyMap<ApiResourceKind, KindView> = new Map([
28
+ [ApiResourceKind.agent, agentView],
29
+ [ApiResourceKind.skill, skillView],
30
+ [ApiResourceKind.session, sessionView],
31
+ [ApiResourceKind.run, runView],
32
+ [ApiResourceKind.organization, organizationView],
33
+ [ApiResourceKind.routine, routineView],
34
+ [ApiResourceKind.environment, environmentView],
35
+ ]);
36
+
37
+ /**
38
+ * The kinds `get` serves through the generic field view, each by decision:
39
+ * a configuration read mostly as YAML (vault, channel, channel app, plugin,
40
+ * eval, API key) or a record read by id from another command's output
41
+ * (score, scoring rule, eval run, file).
42
+ */
43
+ export const GENERIC_VIEW_KINDS: ReadonlySet<ApiResourceKind> = new Set([
44
+ ApiResourceKind.vault,
45
+ ApiResourceKind.channel,
46
+ ApiResourceKind.channel_app,
47
+ ApiResourceKind.plugin,
48
+ ApiResourceKind.eval,
49
+ ApiResourceKind.api_key,
50
+ ApiResourceKind.score,
51
+ ApiResourceKind.scoring_rule,
52
+ ApiResourceKind.eval_run,
53
+ ApiResourceKind.file,
54
+ ]);
55
+
56
+
57
+ /**
58
+ * What `get` prints for one resource of `kind`: the whole resource for json
59
+ * and yaml; otherwise the kind's designed view, after reading what it reads
60
+ * beside the resource, or the generic view for a kind without one.
61
+ */
62
+ export async function renderGet(
63
+ client: Stigmer,
64
+ kind: ApiResourceKind,
65
+ schema: DescMessage,
66
+ message: Message,
67
+ format: OutputFormat,
68
+ options: RenderFieldsOptions = {},
69
+ ): Promise<string> {
70
+ const view = VIEWS.get(kind);
71
+ if (view === undefined || format === "json" || format === "yaml") return renderResource(schema, message, format, options);
72
+ const json = asObject(protoToJsonValue(schema, message));
73
+ const related = view.related === undefined ? {} : await view.related(client, json);
74
+ return renderView(view, json, {
75
+ hideOrg: options.hideOrg === true,
76
+ orgLabel: options.orgLabel,
77
+ width: terminalWidth(),
78
+ style: styler(shouldColorize(process.stdout)),
79
+ now: Date.now(),
80
+ ...related,
81
+ });
82
+ }
@@ -0,0 +1,29 @@
1
+ // `get organization`: an organization by name and slug, its id, what it is
2
+ // for, the organization it is a child of (by the id it stores, since a view
3
+ // reads only its resource), and when it was made
4
+ // (apis/ai/stigmer/tenancy/organization/v1/spec.proto). An organization
5
+ // belongs to none, so its title names its slug alone on every server.
6
+
7
+ import { audited, instant, obj, str } from "../render.js";
8
+ import type { KindView } from "./view.js";
9
+
10
+ export const organizationView: KindView = {
11
+ title: (json) => {
12
+ const metadata = obj(json, "metadata");
13
+ return { name: str(metadata, "name") || str(metadata, "slug"), ref: str(metadata, "slug") };
14
+ },
15
+ sections: (json) => {
16
+ const metadata = obj(json, "metadata");
17
+ const spec = obj(json, "spec");
18
+ return [
19
+ {
20
+ fields: [
21
+ ["ID", str(metadata, "id")],
22
+ ["Description", str(spec, "description")],
23
+ ["Parent", str(spec, "parent_org")],
24
+ ["Created", instant(audited(json).created)],
25
+ ],
26
+ },
27
+ ];
28
+ },
29
+ };
@@ -0,0 +1,39 @@
1
+ // `get routine`: what a routine runs and when. The agent it starts, its
2
+ // schedule in words with the time zone it keeps, the owner's switch
3
+ // (enabled) apart from the platform's latch (paused, and why), when it runs
4
+ // next and when it last ran; then the message each run starts from
5
+ // (apis/ai/stigmer/agentic/routine/v1/spec.proto, status.proto). Enabled and
6
+ // paused stay two lines, as `list routines` keeps them two columns: they
7
+ // have two different remedies.
8
+
9
+ import { instant, obj, str } from "../render.js";
10
+ import type { KindView } from "./view.js";
11
+ import { firstLines, refLabel, scheduleWords, yesNo } from "./words.js";
12
+
13
+ export const routineView: KindView = {
14
+ sections: (json, ctx) => {
15
+ const metadata = obj(json, "metadata");
16
+ const spec = obj(json, "spec");
17
+ const status = obj(json, "status");
18
+ const invocation = obj(spec, "agent");
19
+ const pausedReason = str(status, "paused_reason");
20
+ const cron = typeof spec.cron === "string" ? spec.cron : undefined;
21
+ const lastRun = instant(str(status, "last_fire_at"));
22
+ const lastRunId = str(status, "last_run_id");
23
+ const message = firstLines(str(invocation, "message"));
24
+ return [
25
+ {
26
+ fields: [
27
+ ["Agent", refLabel(obj(invocation, "agent_ref"), metadata, ctx)],
28
+ ["Schedule", scheduleWords(cron, str(spec, "time_zone"))],
29
+ ["Enabled", yesNo(spec, "enabled")],
30
+ ["State", pausedReason === "" ? "active" : "paused"],
31
+ ["Paused because", pausedReason],
32
+ ["Next run", instant(str(status, "next_fire_at"))],
33
+ ["Last run", lastRun !== undefined && lastRunId !== "" ? `${lastRun} (${lastRunId})` : lastRun],
34
+ ],
35
+ },
36
+ { title: "Message", lines: message.lines, more: message.more },
37
+ ];
38
+ },
39
+ };
@@ -0,0 +1,46 @@
1
+ // `get run <id>`: one turn of a conversation. The summary gives the agent
2
+ // that ran it, the session it belongs to, how it went, when it started and
3
+ // how long it took; then the message it was asked, why it stopped when it
4
+ // did not complete (the error and the stop cause), the tokens it used (never
5
+ // a price, as the run's exit summary), and the settings it ran with,
6
+ // resolved, model first (apis/ai/stigmer/agentic/run/v1/api.proto, RunStatus).
7
+
8
+ import { instant, obj, runSettingFields, str } from "../render.js";
9
+ import { located, type KindView } from "./view.js";
10
+ import { firstLines, phaseWord, runSpan, tokenUsage } from "./words.js";
11
+
12
+ export const runView: KindView = {
13
+ title: (json, ctx) => {
14
+ const metadata = obj(json, "metadata");
15
+ return { name: str(metadata, "id"), ref: located(metadata, "", ctx) };
16
+ },
17
+ sections: (json, ctx) => {
18
+ const spec = obj(json, "spec");
19
+ const status = obj(json, "status");
20
+ const message = firstLines(str(spec, "message"));
21
+ const stopped = str(status, "phase") !== "RUN_COMPLETED";
22
+ return [
23
+ {
24
+ fields: [
25
+ ["Agent", str(status, "agent_id")],
26
+ ["Session", str(spec, "session_id")],
27
+ ["Status", phaseWord(json)],
28
+ ["Started", instant(str(status, "started_at"))],
29
+ ["Duration", runSpan(json, ctx.now)],
30
+ ],
31
+ },
32
+ { title: "Message", lines: message.lines, more: message.more },
33
+ {
34
+ title: "Why it stopped",
35
+ fields: stopped
36
+ ? [
37
+ ["Error", str(status, "error")],
38
+ ["Stop cause", str(status, "stop_cause").replaceAll("_", " ")],
39
+ ]
40
+ : [],
41
+ },
42
+ { title: "Usage", fields: [["Tokens", tokenUsage(json)]] },
43
+ { title: "Run settings", fields: runSettingFields(spec, status) },
44
+ ];
45
+ },
46
+ };
@@ -0,0 +1,91 @@
1
+ // `get session <id>`: a conversation as a person reads it. Its subject
2
+ // heads it; the summary gives its id, the agent it talks to, whether it is
3
+ // working, the Environment it runs in and which choice named it, and when it
4
+ // began; then its newest runs (turns), each with how it went, when it
5
+ // started and how long it took, and the engine it runs on. The runs are the one thing a view reads
6
+ // beyond its resource: `listRunsBySession` (resources/session.ts), newest
7
+ // first.
8
+
9
+ import { RunSchema } from "@stigmer/apis/ai/stigmer/agentic/run/v1/api_pb";
10
+ import { BUILT_IN_ASSISTANT_NAME } from "@stigmer/client";
11
+ import { protoToJsonValue } from "../../output/index.js";
12
+ import { asObject, audited, instant, type JsonObject, obj, runSettingFields, str } from "../render.js";
13
+ import { listRunsBySession } from "../session.js";
14
+ import { located, type KindView, type ViewContext } from "./view.js";
15
+ import { phaseWord, refLabel, runSpan } from "./words.js";
16
+
17
+ /** How many of a session's runs its view lists, the newest. */
18
+ export const SESSION_RUNS = 5;
19
+
20
+ export const sessionView: KindView = {
21
+ title: (json, ctx) => {
22
+ const metadata = obj(json, "metadata");
23
+ const name = str(obj(json, "spec"), "subject") || str(metadata, "name") || str(metadata, "id");
24
+ return { name, ref: located(metadata, str(metadata, "slug"), ctx) };
25
+ },
26
+ sections: (json, ctx) => {
27
+ const metadata = obj(json, "metadata");
28
+ const status = obj(json, "status");
29
+ const runs = ctx.runs ?? [];
30
+ return [
31
+ {
32
+ fields: [
33
+ ["ID", str(metadata, "id")],
34
+ ["Agent", agentOf(json, ctx)],
35
+ ["State", str(status, "state")],
36
+ ["Environment", environmentOf(status, metadata, ctx)],
37
+ ["Created", instant(audited(json).created)],
38
+ ],
39
+ },
40
+ {
41
+ title: "Runs",
42
+ rows: runs.slice(0, SESSION_RUNS).map((run) => runRow(run, ctx.now)),
43
+ more: runs.length > SESSION_RUNS ? "… and earlier runs" : undefined,
44
+ },
45
+ { title: "Run settings", fields: runSettingFields(obj(json, "spec"), {}) },
46
+ ];
47
+ },
48
+ related: async (client, json) => {
49
+ // One more than it shows, to know whether earlier runs exist: one request, however long the conversation.
50
+ const runs = await listRunsBySession(client, str(obj(json, "metadata"), "id"), SESSION_RUNS + 1);
51
+ return { runs: runs.map((run) => asObject(protoToJsonValue(RunSchema, run))) };
52
+ },
53
+ };
54
+
55
+ // The agent the session names, else the one it pinned by id, else the
56
+ // built-in assistant, as `list sessions` reads it.
57
+ function agentOf(json: JsonObject, ctx: ViewContext): string {
58
+ const named = refLabel(obj(obj(json, "spec"), "agent_ref"), obj(json, "metadata"), ctx);
59
+ return named || str(obj(json, "status"), "agent_id") || BUILT_IN_ASSISTANT_NAME;
60
+ }
61
+
62
+ function environmentOf(status: JsonObject, metadata: JsonObject, ctx: ViewContext): string {
63
+ const environment = refLabel(obj(status, "environment"), metadata, ctx);
64
+ const source = environmentSourceWords(str(status, "environment_source"));
65
+ return environment === "" || source === undefined ? environment : `${environment} (${source})`;
66
+ }
67
+
68
+ // Which choice named the session's Environment (SessionStatus.environment_source),
69
+ // in words; undefined when the session says none, or one this CLI does not know.
70
+ function environmentSourceWords(source: string): string | undefined {
71
+ switch (source) {
72
+ case "ENVIRONMENT_SOURCE_SESSION":
73
+ return "named for this conversation";
74
+ case "ENVIRONMENT_SOURCE_ROUTINE":
75
+ return "from its routine";
76
+ case "ENVIRONMENT_SOURCE_AGENT":
77
+ return "from its agent";
78
+ case "ENVIRONMENT_SOURCE_ORGANIZATION":
79
+ return "the organization's default";
80
+ }
81
+ return undefined;
82
+ }
83
+
84
+ function runRow(run: JsonObject, now: number): string[] {
85
+ return [
86
+ str(obj(run, "metadata"), "id"),
87
+ phaseWord(run),
88
+ instant(str(obj(run, "status"), "started_at")) ?? "not started",
89
+ runSpan(run, now) ?? "",
90
+ ];
91
+ }
@@ -0,0 +1,49 @@
1
+ // `get skill`: which version of a skill this is and where it came from, then
2
+ // the start of its SKILL.md. The tag and the version hash (by the short form
3
+ // the CLI prints for versions), the git remote, ref and commit it was pushed
4
+ // from, when it was; SKILL.md without its frontmatter, whose name and
5
+ // description the title and summary already show
6
+ // (apis/ai/stigmer/agentic/skill/v1/spec.proto, status.proto).
7
+
8
+ import { obj, str } from "../render.js";
9
+ import { shortVersionHash } from "../version.js";
10
+ import type { KindView } from "./view.js";
11
+ import { firstLines } from "./words.js";
12
+
13
+ export const skillView: KindView = {
14
+ sections: (json) => {
15
+ const spec = obj(json, "spec");
16
+ const status = obj(json, "status");
17
+ const git = obj(status, "git_provenance");
18
+ const body = firstLines(withoutFrontmatter(str(spec, "skill_md")));
19
+ return [
20
+ {
21
+ fields: [
22
+ ["Description", str(spec, "description")],
23
+ ["Tag", str(spec, "tag")],
24
+ ["Version", shortVersionHash(str(status, "version_hash"))],
25
+ ],
26
+ },
27
+ {
28
+ title: "Source",
29
+ fields: [
30
+ ["Remote", str(git, "remote_url")],
31
+ ["Ref", str(git, "ref")],
32
+ ["Commit", str(git, "commit")],
33
+ ["Folder", str(git, "subdir")],
34
+ ],
35
+ },
36
+ { title: "SKILL.md", lines: body.lines, more: body.more },
37
+ ];
38
+ },
39
+ };
40
+
41
+ /** SKILL.md from its first line after the YAML frontmatter (and the blank lines after it); as given when it has none. */
42
+ export function withoutFrontmatter(markdown: string): string {
43
+ const text = markdown.replace(/\r\n/g, "\n");
44
+ if (!text.startsWith("---\n")) return text;
45
+ const close = text.indexOf("\n---", 3);
46
+ if (close === -1) return text;
47
+ const after = text.indexOf("\n", close + 4);
48
+ return after === -1 ? "" : text.slice(after + 1).replace(/^\n+/, "");
49
+ }