@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,31 +1,78 @@
1
- // Shared table renderer for list/collection views. Mirrors the column model of
2
- // the Go CLI's pkg/display table (dynamic widths, dash separator, 3-space gap).
1
+ // Shared table renderer for list/collection views: columns sized to their
2
+ // widest cell, a dash separator, a 3-space gap, and a fit to the terminal.
3
3
  //
4
- // This implements the non-adaptive path: columns size to their widest cell.
5
- // Terminal-width adaptation and ANSI-aware measurement can be layered on later
6
- // without changing the call sites.
4
+ // A table fits the terminal it is drawn on: when a row is wider than the
5
+ // terminal, the columns the caller names as free text (a description, a
6
+ // subject, a display name) lose width, widest first, down to a floor, and
7
+ // their cells end in "…". Ids and slugs are never named, so what a person
8
+ // copies into the next command is never cut. Piped output has no width and
9
+ // nothing is cut, so a script reads every cell whole. The width is the
10
+ // caller's to give (`terminalWidth` reads it from the stream it writes to),
11
+ // which keeps this renderer a pure function of its input.
12
+ //
13
+ // Widths are measured in terminal columns with `string-width`, so a wide
14
+ // character or an emoji counts as the two columns it fills, and a cut falls
15
+ // between graphemes, never inside a surrogate pair or a combined character.
16
+
17
+ import stringWidth from "string-width";
7
18
 
8
19
  const COLUMN_GAP = " ";
9
20
 
21
+ /** The narrowest a shrinking column becomes: enough to recognize a description or a name. */
22
+ export const SHRINK_FLOOR = 12;
23
+
24
+ const ELLIPSIS = "…";
25
+
26
+ // Grapheme boundaries, so a cut never splits what a person sees as one character.
27
+ const graphemes = new Intl.Segmenter(undefined, { granularity: "grapheme" });
28
+
29
+ /** How a table fits the terminal it is drawn on. */
30
+ export interface TableOptions {
31
+ /** The terminal's width in columns; undefined (piped output) cuts nothing. */
32
+ readonly width?: number;
33
+ /**
34
+ * The headers of the columns that may lose width when a row is too wide:
35
+ * free text only, never an id or a slug a person copies.
36
+ */
37
+ readonly shrink?: readonly string[];
38
+ }
39
+
40
+ /** The part of an output stream that says whether it is a terminal and how wide. */
41
+ export interface TerminalStream {
42
+ readonly isTTY?: boolean;
43
+ readonly columns?: number;
44
+ }
45
+
46
+ /** The width a table written to `stream` fits: the terminal's columns, or undefined when piped. */
47
+ export function terminalWidth(
48
+ stream: TerminalStream = process.stdout,
49
+ ): number | undefined {
50
+ if (stream.isTTY !== true) return undefined;
51
+ const columns = stream.columns;
52
+ return columns !== undefined && columns > 0 ? columns : undefined;
53
+ }
54
+
10
55
  /** Render a table from headers and rows. Returns "" when there are no rows. */
11
56
  export function renderTable(
12
57
  headers: readonly string[],
13
58
  rows: readonly (readonly string[])[],
59
+ options: TableOptions = {},
14
60
  ): string {
15
61
  if (rows.length === 0) return "";
16
62
 
17
- const widths = headers.map((header, column) => {
18
- let width = header.length;
19
- for (const row of rows) {
20
- const cell = row[column] ?? "";
21
- if (cell.length > width) width = cell.length;
22
- }
23
- return width;
24
- });
63
+ const natural = headers.map((header, column) =>
64
+ rows.reduce(
65
+ (widest, row) => Math.max(widest, stringWidth(row[column] ?? "")),
66
+ stringWidth(header),
67
+ ),
68
+ );
69
+ const widths = fitWidths(headers, natural, options);
25
70
 
26
71
  const renderRow = (cells: readonly string[]): string =>
27
72
  headers
28
- .map((_, column) => padRight(cells[column] ?? "", widths[column]))
73
+ .map((_, column) =>
74
+ padRight(cut(cells[column] ?? "", widths[column]), widths[column]),
75
+ )
29
76
  .join(COLUMN_GAP)
30
77
  .replace(/ +$/, "");
31
78
 
@@ -47,6 +94,62 @@ export function renderEmpty(resourceName: string, query?: string): string {
47
94
  return `\n${middle}\n\n`;
48
95
  }
49
96
 
97
+ // The column widths that fit `options.width`: while the row is too wide, the
98
+ // widest shrinkable column above its floor gives up one column (the leftmost
99
+ // of equals), so wide columns come down to their neighbours before any of
100
+ // them goes further. A column's floor is SHRINK_FLOOR or its header,
101
+ // whichever is wider, so a header is never cut. The cuts stop at the slack,
102
+ // the columns the shrinkable ones hold above their floors, so each cut has a
103
+ // column to take from; when the slack runs out first the row stays wider
104
+ // than the terminal and the terminal wraps it.
105
+ function fitWidths(
106
+ headers: readonly string[],
107
+ natural: readonly number[],
108
+ options: TableOptions,
109
+ ): number[] {
110
+ const widths = [...natural];
111
+ if (options.width === undefined) return widths;
112
+ const shrinkable = new Set(options.shrink);
113
+ const floors = headers.map((header, column) =>
114
+ shrinkable.has(header)
115
+ ? Math.max(SHRINK_FLOOR, stringWidth(header))
116
+ : natural[column],
117
+ );
118
+ const rowWidth =
119
+ widths.reduce((sum, columnWidth) => sum + columnWidth, 0) +
120
+ COLUMN_GAP.length * (widths.length - 1);
121
+ const slack = widths.reduce(
122
+ (sum, columnWidth, column) => sum + columnWidth - floors[column],
123
+ 0,
124
+ );
125
+ for (let cuts = Math.min(rowWidth - options.width, slack); cuts > 0; cuts--) {
126
+ const open = widths.flatMap((columnWidth, column) =>
127
+ columnWidth > floors[column] ? [column] : [],
128
+ );
129
+ const widest = open.reduce((best, column) =>
130
+ widths[column] > widths[best] ? column : best,
131
+ );
132
+ widths[widest] -= 1;
133
+ }
134
+ return widths;
135
+ }
136
+
137
+ // `text` cut to `width` columns: whole graphemes while they fit beside the
138
+ // ellipsis, then "…". Space before the ellipsis is dropped, so a cut at a
139
+ // word break reads "word…", not "word …".
140
+ function cut(text: string, width: number): string {
141
+ if (stringWidth(text) <= width) return text;
142
+ let kept = "";
143
+ let used = 0;
144
+ for (const { segment } of graphemes.segment(text)) {
145
+ const segmentWidth = stringWidth(segment);
146
+ if (used + segmentWidth > width - 1) break;
147
+ kept += segment;
148
+ used += segmentWidth;
149
+ }
150
+ return `${kept.trimEnd()}${ELLIPSIS}`;
151
+ }
152
+
50
153
  function padRight(text: string, width: number): string {
51
- return text + " ".repeat(Math.max(0, width - text.length));
154
+ return text + " ".repeat(Math.max(0, width - stringWidth(text)));
52
155
  }
package/src/program.ts CHANGED
@@ -1,5 +1,11 @@
1
- // Builds the root commander program: global flags, the preAction hook that
2
- // captures them into process-global runtime state, and command registration.
1
+ // Builds the root commander program: global flags (written before the
2
+ // command, or after it, global-options.ts), the preAction hook that captures
3
+ // them into process-global runtime state, command registration, and the
4
+ // command-line errors every command words alike (errors/command-line.ts).
5
+ // `--org`, `--debug` and `--standalone` may follow the command; `--api-key`
6
+ // only precedes it.
7
+ // Commands register in their help groups' order, and help.ts gives each its
8
+ // group and examples.
3
9
  //
4
10
  // Command modules are registered through small `register*` functions so the
5
11
  // entry path stays light; heavier commands lazy-load their implementation via
@@ -19,6 +25,7 @@ import { registerDelete } from "./commands/delete.js";
19
25
  import { registerDown } from "./commands/down.js";
20
26
  import { registerDownload } from "./commands/download.js";
21
27
  import { registerEval } from "./commands/eval.js";
28
+ import { registerFile } from "./commands/file.js";
22
29
  import { registerGet } from "./commands/get.js";
23
30
  import { registerInstall } from "./commands/install.js";
24
31
  import { registerInternalDaemon } from "./commands/internal-daemon.js";
@@ -27,6 +34,7 @@ import { registerLogs } from "./commands/logs.js";
27
34
  import { registerMarketplace } from "./commands/marketplace.js";
28
35
  import { registerMcp } from "./commands/mcp.js";
29
36
  import { registerMcpServer } from "./commands/mcp-server.js";
37
+ import { registerProviderKey } from "./commands/provider-key/index.js";
30
38
  import { registerPush } from "./commands/push.js";
31
39
  import { registerReset } from "./commands/reset.js";
32
40
  import { registerResume } from "./commands/resume.js";
@@ -44,166 +52,88 @@ import { registerUsage } from "./commands/usage.js";
44
52
  import { registerValidate } from "./commands/validate.js";
45
53
  import { registerVault } from "./commands/vault.js";
46
54
  import { registerVersion } from "./commands/version.js";
47
- import { setDebug, setStandalone } from "./runtime.js";
55
+ import { applyHelp } from "./commands/help.js";
56
+ import { setActionCommand, setDebug, setStandalone } from "./runtime.js";
57
+ import { commandPath } from "./command-tree.js";
58
+ import { installCommandLineErrors } from "./errors/command-line.js";
59
+ import { acceptGlobalsAfterCommand, addGlobalOptions, helpConfiguration, readGlobalOptions } from "./global-options.js";
48
60
  import { VERSION } from "./version.js";
49
61
 
50
- /**
51
- * Top-level commands the CLI once had and no longer does. Typing one is an
52
- * old habit, not a typo, so commander's unknown-command answer gains the one
53
- * line here naming what replaced it. The old word is not an alias: it does
54
- * nothing but fail with this pointer.
55
- */
56
- export const RETIRED_COMMANDS: ReadonlyMap<string, string> = new Map([
57
- ["execution", "`stigmer execution` is now `stigmer runs` (cancel, terminate, pause, resume, logs, trace, approve)."],
58
- // Met as `stigmer connect mcp-server`: `stigmer mcp-server` itself still
59
- // starts Stigmer's own MCP server, so only the connect subcommand is gone.
60
- [
61
- "mcp-server",
62
- "An agent lists its own MCP servers under `mcp_servers`, written by an organization's admins, or uses a plugin that carries one: `stigmer connect plugin <plugin>` lists a plugin's tools, and `stigmer mcp add <name> <url>` installs a one-off server as a plugin.",
63
- ],
64
- ["plugin", "`stigmer plugin eval <plugin>` is now `stigmer eval run --plugin <plugin>`; cancel with `stigmer eval cancel`."],
65
- [
66
- "share",
67
- "`stigmer share agent` is now `stigmer channel link`. To give people access to an agent, use Manage access in the console.",
68
- ],
69
- ]);
70
-
71
- /**
72
- * Subcommands the CLI once had and no longer does, by the group they were
73
- * in, answered as {@link RETIRED_COMMANDS} are: `agent` is still a group,
74
- * so its old `eval` meets commander's unknown-command answer there.
75
- */
76
- export const RETIRED_SUBCOMMANDS: ReadonlyMap<string, ReadonlyMap<string, string>> = new Map([
77
- [
78
- "agent",
79
- new Map([
80
- [
81
- "eval",
82
- "`stigmer agent eval <agent>` is now `stigmer eval run --agent <agent>` (`--plugin` there is now `--cases-from`); cancel with `stigmer eval cancel`.",
83
- ],
84
- ]),
85
- ],
86
- ]);
87
-
88
- /**
89
- * Options a command once had and no longer does, by the command's name: a
90
- * run and a connect carry no keys of their own, so a key is saved in a vault
91
- * and they read it there. As with {@link RETIRED_COMMANDS}, commander's
92
- * unknown-option answer on that command gains the one line here; the option
93
- * itself is gone, not hidden. Only the commands listed ever took these
94
- * options, so another command meeting the same word answers with commander's
95
- * error alone.
96
- */
97
- const RETIRED_RUN_OPTION_HINT =
98
- "A run no longer takes keys on the command line: save it with `stigmer vault set-secret NAME --mine`, then run.";
99
-
100
- const RETIRED_CONNECT_OPTION_HINT =
101
- "A connect no longer takes keys on the command line: save it with `stigmer vault set-secret NAME --mine`, then connect.";
102
-
103
- export const RETIRED_OPTIONS: ReadonlyMap<string, ReadonlyMap<string, string>> = new Map([
104
- [
105
- "run",
106
- new Map([
107
- ["--env", RETIRED_RUN_OPTION_HINT],
108
- ["--env-file", RETIRED_RUN_OPTION_HINT],
109
- ["--secret", RETIRED_RUN_OPTION_HINT],
110
- ["--secret-file", RETIRED_RUN_OPTION_HINT],
111
- ]),
112
- ],
113
- ["connect", new Map([["--env", RETIRED_CONNECT_OPTION_HINT]])],
114
- ]);
115
-
116
- // Append a retired command's or option's pointer to commander's unknown
117
- // command or option error. `command` is the top-level command the parse
118
- // dispatched to, if any: a retired subcommand is answered only in its
119
- // group. A retired option is answered with its name alone,
120
- // never the rest of commander's message: written as `--secret=KEY=VALUE`,
121
- // commander echoes the whole argument, and the value (which may hold quotes
122
- // or newlines) may be the key itself.
123
- function withRetiredHint(message: string, command: string | undefined): string {
124
- const unknownCommand = /^error: unknown command '([^']+)'/.exec(message);
125
- if (unknownCommand !== null) {
126
- const name = unknownCommand[1];
127
- const hint =
128
- (command === undefined ? undefined : RETIRED_SUBCOMMANDS.get(command)?.get(name)) ?? RETIRED_COMMANDS.get(name);
129
- return hint === undefined ? message : `${message}${hint}\n`;
130
- }
131
- const option = /^error: unknown option '(--[A-Za-z0-9-]+)(?=['=])/.exec(message);
132
- const hint = option === null || command === undefined ? undefined : RETIRED_OPTIONS.get(command)?.get(option[1]);
133
- if (option === null || hint === undefined) return message;
134
- return `error: unknown option '${option[1]}'\n${hint}\n`;
135
- }
136
-
137
62
  export function buildProgram(): Command {
138
63
  const program = new Command();
139
- // The top-level command this parse runs, so a retired option's pointer is
140
- // given only on the command that once took it.
141
- let dispatched: string | undefined;
142
64
 
143
65
  program
144
66
  .name("stigmer")
145
- .description("Stigmer command-line interface")
67
+ .description("Command-line interface for Stigmer, the open-source backend for the agents in your product")
146
68
  .version(VERSION, "--version", "print the CLI version")
147
- .option("-d, --debug", "enable debug output")
148
- .option("--standalone", "ignore the config file; use flags and environment only")
149
- .option("--org <slug>", "organization, on servers that hold several")
150
- .option("--api-key <key>", "API key for authentication")
151
69
  .enablePositionalOptions()
152
- .configureOutput({ outputError: (message, write) => write(withRetiredHint(message, dispatched)) });
153
-
154
- program.hook("preSubcommand", (_program, subcommand) => {
155
- dispatched = subcommand.name();
156
- });
70
+ .configureHelp(helpConfiguration);
71
+ addGlobalOptions(program);
157
72
 
158
- // Capture global flags into process-global state before any command runs.
159
- // Bridging --api-key to the env mirrors the Go CLI's PersistentPreRun so the
160
- // SDK auth interceptor and config layer pick it up uniformly.
161
- program.hook("preAction", () => {
162
- const globals = program.opts();
163
- setDebug(Boolean(globals.debug));
164
- setStandalone(Boolean(globals.standalone));
165
- if (typeof globals.apiKey === "string" && globals.apiKey !== "") {
73
+ // Capture global flags into process-global state before any command runs,
74
+ // reading the action command's own copy first (global-options.ts).
75
+ // Bridging --api-key to the env lets the SDK auth interceptor and config
76
+ // layer pick it up uniformly.
77
+ program.hook("preAction", (root, action) => {
78
+ const globals = readGlobalOptions(root, action);
79
+ setDebug(globals.debug);
80
+ setStandalone(globals.standalone);
81
+ setActionCommand(commandPath(action));
82
+ if (globals.apiKey !== "") {
166
83
  process.env.STIGMER_API_KEY = globals.apiKey;
167
84
  }
168
85
  });
169
86
 
170
- registerVersion(program);
171
- registerCompletion(program);
172
- registerConfig(program);
173
- registerAuth(program);
174
- registerApiKey(program);
175
- registerServiceAccount(program);
176
- registerAccessHistory(program);
87
+ // Run agents
88
+ registerRun(program);
89
+ registerResume(program);
90
+ registerRuns(program);
91
+ // Your library
177
92
  registerGet(program);
178
93
  registerList(program);
179
94
  registerSearch(program);
95
+ registerApply(program);
180
96
  registerValidate(program);
181
97
  registerDelete(program);
182
98
  registerTag(program);
183
- registerChannel(program);
99
+ registerAgent(program);
184
100
  registerRoutine(program);
101
+ registerChannel(program);
185
102
  registerVault(program);
186
- registerUsage(program);
103
+ registerFile(program);
104
+ registerConnect(program);
105
+ // Packages
187
106
  registerPush(program);
188
107
  registerInstall(program);
189
108
  registerMarketplace(program);
109
+ registerMcp(program);
190
110
  registerEval(program);
191
- registerAgent(program);
192
111
  registerDownload(program);
193
- registerApply(program);
194
- registerRun(program);
195
- registerResume(program);
196
- registerRuns(program);
197
- registerConnect(program);
198
- registerMcp(program);
199
- registerMcpServer(program);
112
+ // Local stack
200
113
  registerUp(program);
201
114
  registerDown(program);
202
115
  registerStatus(program);
203
116
  registerLogs(program);
204
117
  registerSetup(program);
205
118
  registerReset(program);
119
+ registerMcpServer(program);
120
+ // Account and access
121
+ registerAuth(program);
122
+ registerApiKey(program);
123
+ registerServiceAccount(program);
124
+ registerProviderKey(program);
125
+ registerAccessHistory(program);
126
+ registerUsage(program);
127
+ // Configuration
128
+ registerConfig(program);
129
+ registerCompletion(program);
130
+ registerVersion(program);
206
131
  registerInternalDaemon(program);
207
132
 
133
+ // After registration, so every command is reached.
134
+ acceptGlobalsAfterCommand(program);
135
+ applyHelp(program);
136
+ installCommandLineErrors(program);
137
+
208
138
  return program;
209
139
  }
@@ -1,9 +1,6 @@
1
1
  // Algorithmic alias generation. Aliases are *derived* from proto kind metadata
2
2
  // (name/display_name/id_prefix/proto enum name), never hardcoded, so a new
3
3
  // resource kind picks up its full set of accepted spellings automatically.
4
- // The algorithm was ported from the Go CLI's types.GenerateAliases; the Go CLI
5
- // was removed in the TypeScript migration (stigmer/stigmer#203), so this is the
6
- // only alias implementation.
7
4
 
8
5
  /**
9
6
  * Generate every accepted input form for a resource kind.
@@ -11,7 +11,6 @@ export {
11
11
  CLI_RELEVANT_KINDS,
12
12
  type KindMeta,
13
13
  KIND_META,
14
- RETIRED_KINDS,
15
14
  } from "./metadata.js";
16
15
  export {
17
16
  buildTypeInfo,
@@ -9,7 +9,6 @@
9
9
  // contract, so a row cannot drift from it unnoticed.
10
10
 
11
11
  import { ApiResourceKind } from "@stigmer/apis/ai/stigmer/commons/apiresource/apiresourcekind/api_resource_kind_pb";
12
- import { MCP_SERVER_WAY_FORWARD } from "@stigmer/client";
13
12
 
14
13
  export interface KindMeta {
15
14
  /** Proto kind_meta.name — also the YAML `kind` value (e.g. "ChannelApp"). */
@@ -18,12 +17,6 @@ export interface KindMeta {
18
17
  readonly displayName: string;
19
18
  /** Proto kind_meta.id_prefix (e.g. "chn"): what new ids are minted with. */
20
19
  readonly idPrefix: string;
21
- /**
22
- * Proto kind_meta.retired_id_prefixes: what this kind's ids were minted
23
- * with before. Ids are never rewritten, so a stored id may still carry one
24
- * (a run's `aex_…`); readers that tell a kind from an id read these too.
25
- */
26
- readonly retiredIdPrefixes?: readonly string[];
27
20
  }
28
21
 
29
22
  export const KIND_META: ReadonlyMap<ApiResourceKind, KindMeta> = new Map([
@@ -49,12 +42,7 @@ export const KIND_META: ReadonlyMap<ApiResourceKind, KindMeta> = new Map([
49
42
  ],
50
43
  [
51
44
  ApiResourceKind.federation_issuer,
52
- {
53
- name: "FederationIssuer",
54
- displayName: "Federation Issuer",
55
- idPrefix: "fis",
56
- retiredIdPrefixes: ["idp"],
57
- },
45
+ { name: "FederationIssuer", displayName: "Federation Issuer", idPrefix: "fis" },
58
46
  ],
59
47
  [
60
48
  ApiResourceKind.oauth_app,
@@ -66,12 +54,7 @@ export const KIND_META: ReadonlyMap<ApiResourceKind, KindMeta> = new Map([
66
54
  ],
67
55
  [
68
56
  ApiResourceKind.channel,
69
- {
70
- name: "Channel",
71
- displayName: "Channel",
72
- idPrefix: "chn",
73
- retiredIdPrefixes: ["ash", "ach"],
74
- },
57
+ { name: "Channel", displayName: "Channel", idPrefix: "chn" },
75
58
  ],
76
59
  [
77
60
  ApiResourceKind.channel_app,
@@ -79,15 +62,23 @@ export const KIND_META: ReadonlyMap<ApiResourceKind, KindMeta> = new Map([
79
62
  ],
80
63
  [
81
64
  ApiResourceKind.routine,
82
- { name: "Routine", displayName: "Routine", idPrefix: "rtn", retiredIdPrefixes: ["sch"] },
65
+ { name: "Routine", displayName: "Routine", idPrefix: "rtn" },
66
+ ],
67
+ [
68
+ ApiResourceKind.environment,
69
+ { name: "Environment", displayName: "Environment", idPrefix: "env" },
83
70
  ],
84
71
  [
85
72
  ApiResourceKind.session,
86
73
  { name: "Session", displayName: "Session", idPrefix: "ses" },
87
74
  ],
75
+ [
76
+ ApiResourceKind.file,
77
+ { name: "File", displayName: "File", idPrefix: "file" },
78
+ ],
88
79
  [
89
80
  ApiResourceKind.run,
90
- { name: "Run", displayName: "Run", idPrefix: "run", retiredIdPrefixes: ["aex"] },
81
+ { name: "Run", displayName: "Run", idPrefix: "run" },
91
82
  ],
92
83
  [
93
84
  ApiResourceKind.score,
@@ -95,7 +86,7 @@ export const KIND_META: ReadonlyMap<ApiResourceKind, KindMeta> = new Map([
95
86
  ],
96
87
  [
97
88
  ApiResourceKind.scoring_rule,
98
- { name: "ScoringRule", displayName: "Scoring Rule", idPrefix: "srl", retiredIdPrefixes: ["evl"] },
89
+ { name: "ScoringRule", displayName: "Scoring Rule", idPrefix: "srl" },
99
90
  ],
100
91
  [
101
92
  ApiResourceKind.eval,
@@ -108,8 +99,7 @@ export const KIND_META: ReadonlyMap<ApiResourceKind, KindMeta> = new Map([
108
99
  ]);
109
100
 
110
101
  // Kinds that are user-facing in the CLI and therefore registered as addressable
111
- // types. (Inherited from the Go CLI's `cliRelevantKinds`, removed in the
112
- // TypeScript migration — stigmer/stigmer#203.) Note: run is
102
+ // types. Note: run is
113
103
  // intentionally excluded — it is driven through its dedicated
114
104
  // RunQueryController RPCs as a command special-case, not the generic
115
105
  // verb dispatch, even though it carries kind metadata above and a verb-support
@@ -126,49 +116,11 @@ export const CLI_RELEVANT_KINDS: readonly ApiResourceKind[] = [
126
116
  ApiResourceKind.channel,
127
117
  ApiResourceKind.channel_app,
128
118
  ApiResourceKind.routine,
119
+ ApiResourceKind.environment,
129
120
  ApiResourceKind.session,
121
+ ApiResourceKind.file,
130
122
  ApiResourceKind.score,
131
123
  ApiResourceKind.scoring_rule,
132
124
  ApiResourceKind.eval,
133
125
  ApiResourceKind.eval_run,
134
126
  ];
135
-
136
- /**
137
- * YAML kinds the platform once served and no longer does. A manifest that
138
- * still carries one is an old file, not a typo, so the refusal it meets
139
- * says what happened and what to do instead of "unknown kind"; the
140
- * registry's `unknownKindError` reads this table before falling back to the
141
- * generic sentence. The key is the YAML `kind` value as the retired proto
142
- * declared it; the value is the sentence that follows the kind's name.
143
- */
144
- export const RETIRED_KINDS: ReadonlyMap<string, string> = new Map([
145
- [
146
- "AgentInstance",
147
- "is no longer a Stigmer resource. A conversation starts on the agent itself: run `stigmer run <org>/<agent>`, and delete this file.",
148
- ],
149
- [
150
- "WorkflowInstance",
151
- "is no longer a Stigmer resource. A run starts on an agent: save the keys it reads in your own vault (`stigmer vault set-secret <NAME> --mine`), run `stigmer run <org>/<agent>`, and delete this file.",
152
- ],
153
- [
154
- "Environment",
155
- "is no longer a Stigmer resource: logins and secrets live in vaults, which are never written as files. Save each key with `stigmer vault set-secret <NAME> --mine` (or `--vault <ref>` for a shared vault), and delete this file.",
156
- ],
157
- ["McpServer", `is no longer a Stigmer resource. ${MCP_SERVER_WAY_FORWARD}`],
158
- [
159
- "AgentShare",
160
- "is now a channel. Rewrite the file as `kind: Channel` and move `audience`, `allowed_origins` and `messages` from `spec` under `spec.web`. A file with no `metadata.name` edited the link named after its agent: give it `metadata.name: <the agent's slug>` so it still edits that link instead of creating another. Then apply it with `stigmer apply -f <file>`.",
161
- ],
162
- [
163
- "AgentChannel",
164
- "is now a channel. Rewrite the file as `kind: Channel`, keep `spec.slack` or `spec.whatsapp`, and move `app_ref` and `proactive_messaging_enabled` from `spec` into that type (`spec.slack.app_ref`, `spec.whatsapp.app_ref`, `spec.whatsapp.proactive_messaging_enabled`), then apply it with `stigmer apply -f <file>`.",
165
- ],
166
- [
167
- "Schedule",
168
- "is now a routine. Rewrite the file as `kind: Routine`, which is the whole change, then apply it with `stigmer apply -f <file>`.",
169
- ],
170
- [
171
- "Project",
172
- "is no longer a Stigmer resource. A folder of resources that belong together is a plugin: run `stigmer push plugin <dir>` to install it as one, or apply each resource file with `stigmer apply -f <file>`.",
173
- ],
174
- ]);
@@ -1,13 +1,12 @@
1
1
  // The type registry: the single source of truth that maps user-facing resource
2
2
  // identifiers (aliases, YAML kinds) to proto kinds and their supported verbs.
3
3
  // Built once from the declarative kind-metadata table with aliases derived
4
- // algorithmically. (Structure inherited from the Go CLI's types.Registry,
5
- // removed in the TypeScript migration — stigmer/stigmer#203.)
4
+ // algorithmically.
6
5
 
7
6
  import { ApiResourceKind } from "@stigmer/apis/ai/stigmer/commons/apiresource/apiresourcekind/api_resource_kind_pb";
8
7
  import { UsageError } from "../errors/index.js";
9
8
  import { generateAliases, normalizeAlias } from "./aliases.js";
10
- import { CLI_RELEVANT_KINDS, KIND_META, RETIRED_KINDS } from "./metadata.js";
9
+ import { CLI_RELEVANT_KINDS, KIND_META } from "./metadata.js";
11
10
  import { Verb } from "./verbs.js";
12
11
  import { verbsForKind } from "./verb-support.js";
13
12
 
@@ -21,8 +20,6 @@ export interface TypeInfo {
21
20
  readonly displayName: string;
22
21
  /** ID prefix new ids are minted with, e.g. "chapp". */
23
22
  readonly idPrefix: string;
24
- /** Every prefix this type's ids may carry: `idPrefix`, then any retired ones. */
25
- readonly idPrefixes: readonly string[];
26
23
  /** Canonical singular form (lowercase name), e.g. "channelapp". */
27
24
  readonly singular: string;
28
25
  /** Plural form for list commands, e.g. "channelapps". */
@@ -40,15 +37,9 @@ export function supportsVerb(info: TypeInfo, verb: Verb): boolean {
40
37
  /**
41
38
  * The one refusal for a YAML `kind` the registry does not know, shared by
42
39
  * every path that reads a kind from a file (`apply -f`, `validate -f`) so
43
- * the wording lives in one place. A kind the platform retired gets its own
44
- * sentence (RETIRED_KINDS): the file is old, not wrong, and the user
45
- * deserves the reason and the way. `where` names the file for the message.
40
+ * the wording lives in one place. `where` names the file for the message.
46
41
  */
47
42
  export function unknownKindError(yamlKind: string, where: string): UsageError {
48
- const retired = RETIRED_KINDS.get(yamlKind);
49
- if (retired !== undefined) {
50
- return new UsageError(`kind '${yamlKind}' in ${where} ${retired}`);
51
- }
52
43
  return new UsageError(`unknown resource kind '${yamlKind}' in ${where}`);
53
44
  }
54
45
 
@@ -82,7 +73,6 @@ export function buildTypeInfo(kind: ApiResourceKind): TypeInfo | undefined {
82
73
  name: meta.name,
83
74
  displayName: meta.displayName,
84
75
  idPrefix: meta.idPrefix,
85
- idPrefixes: [meta.idPrefix, ...(meta.retiredIdPrefixes ?? [])].filter((p) => p !== ""),
86
76
  singular,
87
77
  plural: singular.endsWith("s") ? singular : `${singular}s`,
88
78
  // ApiResourceKind[kind] reverse-maps to the proto enum value name (e.g.
@@ -88,17 +88,40 @@ export const VERB_SUPPORT: ReadonlyMap<
88
88
  // generic verbs cover the declarative path, and get/list surface the state
89
89
  // the dedicated `stigmer routine` commands act on — spec.enabled (the
90
90
  // owner's switch) versus status.paused_reason (the platform's failure
91
- // latch).
91
+ // latch). The kind's own acts are that group's subcommands, not verbs
92
+ // here: `routine fire` starts it now with an optional note, `routine
93
+ // fires` lists who started each run and how it went, and `routine resume`
94
+ // clears the platform's pause.
92
95
  [
93
96
  ApiResourceKind.routine,
94
97
  new Set<Verb>([Verb.Apply, Verb.Get, Verb.List, Verb.Delete]),
95
98
  ],
99
+ // An Environment is a manifest like an agent: applied, read, listed and
100
+ // deleted by the generic verbs (a delete is refused while an agent, a
101
+ // routine or the organization's default names it). It has no act of its
102
+ // own, so no `stigmer environment` group: its only other door is
103
+ // `run --environment`, which names one for a new conversation.
104
+ [
105
+ ApiResourceKind.environment,
106
+ new Set<Verb>([Verb.Apply, Verb.Get, Verb.List, Verb.Delete]),
107
+ ],
96
108
  // Session list is served by its dedicated query RPC (a LIST_HANDLERS
97
109
  // entry); stigmer/stigmer#469 promoted it into the matrix after it shipped
98
- // working-but-unadvertised through a pre-gate bypass. get/delete remain
99
- // deliberately unpromised until a real read/ops story exists
100
- // (stigmer/stigmer#354) — resume-style flows go through `stigmer session`.
101
- [ApiResourceKind.session, new Set<Verb>([Verb.Apply, Verb.List])],
110
+ // working-but-unadvertised through a pre-gate bypass. `get session <id>`
111
+ // reads one conversation by id, with its newest runs (stigmer/stigmer#2502).
112
+ // delete remains deliberately unpromised until a real ops story exists
113
+ // (stigmer/stigmer#354). `download session` writes what the
114
+ // conversation's turns saved in their outputs folder, newest per path.
115
+ [ApiResourceKind.session, new Set<Verb>([Verb.Apply, Verb.Get, Verb.List, Verb.Download])],
116
+ // A File is uploaded once and named by its id; its bytes never change, so
117
+ // there is nothing to apply. `list files` shows the Files kept for reuse
118
+ // (those of no conversation), and `list files --session <id>` one
119
+ // conversation's. Uploading is `stigmer file upload`, the one act no verb
120
+ // here names.
121
+ [
122
+ ApiResourceKind.file,
123
+ new Set<Verb>([Verb.Get, Verb.List, Verb.Delete, Verb.Download]),
124
+ ],
102
125
  // A score is written by a person rating a run in the console or by the
103
126
  // platform's checks, never as a manifest, and is read by id; a run's
104
127
  // scores are listed by `stigmer runs scores <run-id>`.