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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (760) hide show
  1. package/README.md +5 -4
  2. package/auth/auth0.js +1 -1
  3. package/auth/auth0.js.map +1 -1
  4. package/auth/token.d.ts +26 -4
  5. package/auth/token.d.ts.map +1 -1
  6. package/auth/token.js +120 -24
  7. package/auth/token.js.map +1 -1
  8. package/client/client.d.ts.map +1 -1
  9. package/client/client.js +21 -8
  10. package/client/client.js.map +1 -1
  11. package/command-tree.d.ts +63 -0
  12. package/command-tree.d.ts.map +1 -0
  13. package/command-tree.js +128 -0
  14. package/command-tree.js.map +1 -0
  15. package/commands/access-history/index.d.ts.map +1 -1
  16. package/commands/access-history/index.js +13 -1
  17. package/commands/access-history/index.js.map +1 -1
  18. package/commands/agent-exec-flags.d.ts +2 -0
  19. package/commands/agent-exec-flags.d.ts.map +1 -1
  20. package/commands/agent-exec-flags.js +9 -5
  21. package/commands/agent-exec-flags.js.map +1 -1
  22. package/commands/apikey/duration.d.ts.map +1 -1
  23. package/commands/apikey/duration.js +1 -2
  24. package/commands/apikey/duration.js.map +1 -1
  25. package/commands/apikey/index.d.ts.map +1 -1
  26. package/commands/apikey/index.js +3 -4
  27. package/commands/apikey/index.js.map +1 -1
  28. package/commands/apply.d.ts.map +1 -1
  29. package/commands/apply.js +2 -32
  30. package/commands/apply.js.map +1 -1
  31. package/commands/auth/index.d.ts.map +1 -1
  32. package/commands/auth/index.js +7 -5
  33. package/commands/auth/index.js.map +1 -1
  34. package/commands/auth/whoami.js +1 -1
  35. package/commands/config/index.js +3 -3
  36. package/commands/config/kv.d.ts.map +1 -1
  37. package/commands/config/kv.js +18 -14
  38. package/commands/config/kv.js.map +1 -1
  39. package/commands/connect.d.ts.map +1 -1
  40. package/commands/connect.js +18 -2
  41. package/commands/connect.js.map +1 -1
  42. package/commands/download.d.ts.map +1 -1
  43. package/commands/download.js +81 -54
  44. package/commands/download.js.map +1 -1
  45. package/commands/eval.d.ts.map +1 -1
  46. package/commands/eval.js +17 -19
  47. package/commands/eval.js.map +1 -1
  48. package/commands/file.d.ts +3 -0
  49. package/commands/file.d.ts.map +1 -0
  50. package/commands/file.js +64 -0
  51. package/commands/file.js.map +1 -0
  52. package/commands/get.d.ts.map +1 -1
  53. package/commands/get.js +20 -13
  54. package/commands/get.js.map +1 -1
  55. package/commands/help.d.ts +15 -0
  56. package/commands/help.d.ts.map +1 -0
  57. package/commands/help.js +175 -0
  58. package/commands/help.js.map +1 -0
  59. package/commands/internal-daemon.d.ts.map +1 -1
  60. package/commands/internal-daemon.js +9 -2
  61. package/commands/internal-daemon.js.map +1 -1
  62. package/commands/list.d.ts.map +1 -1
  63. package/commands/list.js +22 -1
  64. package/commands/list.js.map +1 -1
  65. package/commands/logs.js +1 -1
  66. package/commands/logs.js.map +1 -1
  67. package/commands/mcp-server.d.ts +16 -6
  68. package/commands/mcp-server.d.ts.map +1 -1
  69. package/commands/mcp-server.js +51 -26
  70. package/commands/mcp-server.js.map +1 -1
  71. package/commands/provider-key/index.d.ts +3 -0
  72. package/commands/provider-key/index.d.ts.map +1 -0
  73. package/commands/provider-key/index.js +156 -0
  74. package/commands/provider-key/index.js.map +1 -0
  75. package/commands/push.js +8 -8
  76. package/commands/push.js.map +1 -1
  77. package/commands/resume.d.ts.map +1 -1
  78. package/commands/resume.js +17 -11
  79. package/commands/resume.js.map +1 -1
  80. package/commands/routine.d.ts.map +1 -1
  81. package/commands/routine.js +42 -3
  82. package/commands/routine.js.map +1 -1
  83. package/commands/run.d.ts.map +1 -1
  84. package/commands/run.js +34 -15
  85. package/commands/run.js.map +1 -1
  86. package/commands/runs/approve.d.ts.map +1 -1
  87. package/commands/runs/approve.js +10 -2
  88. package/commands/runs/approve.js.map +1 -1
  89. package/commands/runs/control.d.ts.map +1 -1
  90. package/commands/runs/control.js +24 -16
  91. package/commands/runs/control.js.map +1 -1
  92. package/commands/runs/index.d.ts.map +1 -1
  93. package/commands/runs/index.js +1 -2
  94. package/commands/runs/index.js.map +1 -1
  95. package/commands/runs/logs.d.ts.map +1 -1
  96. package/commands/runs/logs.js +7 -4
  97. package/commands/runs/logs.js.map +1 -1
  98. package/commands/runs/to-eval-case.d.ts.map +1 -1
  99. package/commands/runs/to-eval-case.js +13 -4
  100. package/commands/runs/to-eval-case.js.map +1 -1
  101. package/commands/runs/trace.js +1 -1
  102. package/commands/runs/trace.js.map +1 -1
  103. package/commands/search.js +2 -3
  104. package/commands/search.js.map +1 -1
  105. package/commands/service-account/index.d.ts.map +1 -1
  106. package/commands/service-account/index.js +4 -2
  107. package/commands/service-account/index.js.map +1 -1
  108. package/commands/session-help.d.ts +5 -0
  109. package/commands/session-help.d.ts.map +1 -0
  110. package/commands/session-help.js +38 -0
  111. package/commands/session-help.js.map +1 -0
  112. package/commands/setup.js +5 -5
  113. package/commands/setup.js.map +1 -1
  114. package/commands/shared.d.ts +10 -2
  115. package/commands/shared.d.ts.map +1 -1
  116. package/commands/shared.js +30 -3
  117. package/commands/shared.js.map +1 -1
  118. package/commands/tag.d.ts.map +1 -1
  119. package/commands/tag.js +11 -6
  120. package/commands/tag.js.map +1 -1
  121. package/commands/up.d.ts.map +1 -1
  122. package/commands/up.js +51 -21
  123. package/commands/up.js.map +1 -1
  124. package/commands/validate.js +2 -2
  125. package/commands/validate.js.map +1 -1
  126. package/commands/version.d.ts.map +1 -1
  127. package/commands/version.js +8 -4
  128. package/commands/version.js.map +1 -1
  129. package/config/config.d.ts +5 -22
  130. package/config/config.d.ts.map +1 -1
  131. package/config/config.js +56 -47
  132. package/config/config.js.map +1 -1
  133. package/config/index.d.ts +2 -2
  134. package/config/index.d.ts.map +1 -1
  135. package/config/index.js +1 -1
  136. package/config/index.js.map +1 -1
  137. package/config/keys.js +4 -4
  138. package/config/keys.js.map +1 -1
  139. package/config/paths.js +2 -2
  140. package/config/paths.js.map +1 -1
  141. package/config/resolve.d.ts +12 -2
  142. package/config/resolve.d.ts.map +1 -1
  143. package/config/resolve.js +18 -8
  144. package/config/resolve.js.map +1 -1
  145. package/errors/classify.d.ts +20 -0
  146. package/errors/classify.d.ts.map +1 -1
  147. package/errors/classify.js +97 -21
  148. package/errors/classify.js.map +1 -1
  149. package/errors/command-line.d.ts +14 -0
  150. package/errors/command-line.d.ts.map +1 -0
  151. package/errors/command-line.js +90 -0
  152. package/errors/command-line.js.map +1 -0
  153. package/errors/handle.js +2 -2
  154. package/errors/handle.js.map +1 -1
  155. package/errors/index.d.ts +2 -2
  156. package/errors/index.d.ts.map +1 -1
  157. package/errors/index.js +12 -2
  158. package/errors/index.js.map +1 -1
  159. package/errors/usage-error.js +1 -1
  160. package/errors/usage-error.js.map +1 -1
  161. package/global-options.d.ts +35 -0
  162. package/global-options.d.ts.map +1 -0
  163. package/global-options.js +81 -0
  164. package/global-options.js.map +1 -0
  165. package/local/artifact.d.ts +1 -20
  166. package/local/artifact.d.ts.map +1 -1
  167. package/local/artifact.js +35 -117
  168. package/local/artifact.js.map +1 -1
  169. package/local/constants.d.ts +3 -9
  170. package/local/constants.d.ts.map +1 -1
  171. package/local/constants.js +3 -9
  172. package/local/constants.js.map +1 -1
  173. package/local/daemon/components.d.ts +18 -5
  174. package/local/daemon/components.d.ts.map +1 -1
  175. package/local/daemon/components.js +61 -23
  176. package/local/daemon/components.js.map +1 -1
  177. package/local/daemon/env.d.ts +1 -5
  178. package/local/daemon/env.d.ts.map +1 -1
  179. package/local/daemon/env.js +0 -2
  180. package/local/daemon/env.js.map +1 -1
  181. package/local/daemon/host.d.ts +5 -0
  182. package/local/daemon/host.d.ts.map +1 -1
  183. package/local/daemon/host.js +68 -21
  184. package/local/daemon/host.js.map +1 -1
  185. package/local/daemon/index.d.ts +2 -1
  186. package/local/daemon/index.d.ts.map +1 -1
  187. package/local/daemon/index.js +2 -1
  188. package/local/daemon/index.js.map +1 -1
  189. package/local/daemon/launch.d.ts +58 -9
  190. package/local/daemon/launch.d.ts.map +1 -1
  191. package/local/daemon/launch.js +210 -64
  192. package/local/daemon/launch.js.map +1 -1
  193. package/local/daemon/process.d.ts +11 -7
  194. package/local/daemon/process.d.ts.map +1 -1
  195. package/local/daemon/process.js +74 -38
  196. package/local/daemon/process.js.map +1 -1
  197. package/local/daemon/signals.d.ts +3 -0
  198. package/local/daemon/signals.d.ts.map +1 -0
  199. package/local/daemon/signals.js +19 -0
  200. package/local/daemon/signals.js.map +1 -0
  201. package/local/daemon/supervisor.d.ts +9 -2
  202. package/local/daemon/supervisor.d.ts.map +1 -1
  203. package/local/daemon/supervisor.js +81 -22
  204. package/local/daemon/supervisor.js.map +1 -1
  205. package/local/daemon/types.d.ts +6 -1
  206. package/local/daemon/types.d.ts.map +1 -1
  207. package/local/daemon/types.js +2 -3
  208. package/local/daemon/types.js.map +1 -1
  209. package/local/llm-config.d.ts +4 -2
  210. package/local/llm-config.d.ts.map +1 -1
  211. package/local/llm-config.js +15 -9
  212. package/local/llm-config.js.map +1 -1
  213. package/local/logs/view.d.ts.map +1 -1
  214. package/local/logs/view.js +5 -6
  215. package/local/logs/view.js.map +1 -1
  216. package/local/net/tcp.d.ts +8 -6
  217. package/local/net/tcp.d.ts.map +1 -1
  218. package/local/net/tcp.js +13 -8
  219. package/local/net/tcp.js.map +1 -1
  220. package/local/paths.d.ts +1 -1
  221. package/local/paths.d.ts.map +1 -1
  222. package/local/paths.js +2 -3
  223. package/local/paths.js.map +1 -1
  224. package/local/provider-reach.d.ts +18 -0
  225. package/local/provider-reach.d.ts.map +1 -0
  226. package/local/provider-reach.js +109 -0
  227. package/local/provider-reach.js.map +1 -0
  228. package/local/reset.d.ts.map +1 -1
  229. package/local/reset.js +1 -2
  230. package/local/reset.js.map +1 -1
  231. package/local/runtime/index.d.ts.map +1 -1
  232. package/local/runtime/index.js +1 -2
  233. package/local/runtime/index.js.map +1 -1
  234. package/local/runtime/node.js +1 -1
  235. package/local/runtime/runner.js +2 -2
  236. package/local/runtime/runner.js.map +1 -1
  237. package/local/runtime/runtimes-install.js +1 -1
  238. package/local/runtime/server.d.ts.map +1 -1
  239. package/local/runtime/server.js +2 -4
  240. package/local/runtime/server.js.map +1 -1
  241. package/local/runtime/which.js +1 -1
  242. package/local/runtime/which.js.map +1 -1
  243. package/local/setup/wizard.d.ts +1 -1
  244. package/local/setup/wizard.d.ts.map +1 -1
  245. package/local/setup/wizard.js +7 -5
  246. package/local/setup/wizard.js.map +1 -1
  247. package/local/state/health-state.d.ts +6 -0
  248. package/local/state/health-state.d.ts.map +1 -1
  249. package/local/state/health-state.js +6 -2
  250. package/local/state/health-state.js.map +1 -1
  251. package/local/state/lock.d.ts +3 -2
  252. package/local/state/lock.d.ts.map +1 -1
  253. package/local/state/lock.js +26 -28
  254. package/local/state/lock.js.map +1 -1
  255. package/local/state/log-rotation.d.ts.map +1 -1
  256. package/local/state/log-rotation.js +2 -3
  257. package/local/state/log-rotation.js.map +1 -1
  258. package/local/state/pidfile.d.ts +24 -1
  259. package/local/state/pidfile.d.ts.map +1 -1
  260. package/local/state/pidfile.js +54 -6
  261. package/local/state/pidfile.js.map +1 -1
  262. package/local/state/proc.d.ts +31 -0
  263. package/local/state/proc.d.ts.map +1 -1
  264. package/local/state/proc.js +98 -1
  265. package/local/state/proc.js.map +1 -1
  266. package/local/state/startup-config.d.ts +2 -2
  267. package/local/status.d.ts +2 -4
  268. package/local/status.d.ts.map +1 -1
  269. package/local/status.js +26 -41
  270. package/local/status.js.map +1 -1
  271. package/local/temporal/download.d.ts +9 -5
  272. package/local/temporal/download.d.ts.map +1 -1
  273. package/local/temporal/download.js +29 -8
  274. package/local/temporal/download.js.map +1 -1
  275. package/local/temporal/index.d.ts +1 -1
  276. package/local/temporal/index.d.ts.map +1 -1
  277. package/local/temporal/index.js +1 -1
  278. package/local/temporal/index.js.map +1 -1
  279. package/local/temporal/manager.d.ts +31 -5
  280. package/local/temporal/manager.d.ts.map +1 -1
  281. package/local/temporal/manager.js +74 -35
  282. package/local/temporal/manager.js.map +1 -1
  283. package/local/temporal/supervisor.js +1 -1
  284. package/local/temporal/supervisor.js.map +1 -1
  285. package/local/webconsole/index.d.ts +5 -2
  286. package/local/webconsole/index.d.ts.map +1 -1
  287. package/local/webconsole/index.js +8 -6
  288. package/local/webconsole/index.js.map +1 -1
  289. package/marketplace/github.js +1 -1
  290. package/marketplace/github.js.map +1 -1
  291. package/marketplace/official.js +1 -1
  292. package/marketplace/official.js.map +1 -1
  293. package/output/command-result.d.ts +6 -0
  294. package/output/command-result.d.ts.map +1 -1
  295. package/output/command-result.js +13 -2
  296. package/output/command-result.js.map +1 -1
  297. package/output/confirm.d.ts.map +1 -1
  298. package/output/confirm.js +2 -3
  299. package/output/confirm.js.map +1 -1
  300. package/output/format.d.ts.map +1 -1
  301. package/output/format.js +5 -6
  302. package/output/format.js.map +1 -1
  303. package/output/index.d.ts +2 -2
  304. package/output/index.d.ts.map +1 -1
  305. package/output/index.js +2 -2
  306. package/output/index.js.map +1 -1
  307. package/output/printable.d.ts +8 -0
  308. package/output/printable.d.ts.map +1 -0
  309. package/output/printable.js +24 -0
  310. package/output/printable.js.map +1 -0
  311. package/output/proto.d.ts.map +1 -1
  312. package/output/proto.js +3 -4
  313. package/output/proto.js.map +1 -1
  314. package/output/style.js +2 -2
  315. package/output/style.js.map +1 -1
  316. package/output/table.d.ts +20 -1
  317. package/output/table.d.ts.map +1 -1
  318. package/output/table.js +75 -17
  319. package/output/table.js.map +1 -1
  320. package/package.json +13 -10
  321. package/program.d.ts +0 -14
  322. package/program.d.ts.map +1 -1
  323. package/program.js +57 -119
  324. package/program.js.map +1 -1
  325. package/registry/aliases.d.ts.map +1 -1
  326. package/registry/aliases.js +0 -3
  327. package/registry/aliases.js.map +1 -1
  328. package/registry/index.d.ts +1 -1
  329. package/registry/index.d.ts.map +1 -1
  330. package/registry/index.js +1 -1
  331. package/registry/index.js.map +1 -1
  332. package/registry/metadata.d.ts +0 -15
  333. package/registry/metadata.d.ts.map +1 -1
  334. package/registry/metadata.js +16 -57
  335. package/registry/metadata.js.map +1 -1
  336. package/registry/registry.d.ts +1 -5
  337. package/registry/registry.d.ts.map +1 -1
  338. package/registry/registry.js +3 -11
  339. package/registry/registry.js.map +1 -1
  340. package/registry/verb-support.d.ts.map +1 -1
  341. package/registry/verb-support.js +28 -5
  342. package/registry/verb-support.js.map +1 -1
  343. package/resources/agent/quality.d.ts +10 -5
  344. package/resources/agent/quality.d.ts.map +1 -1
  345. package/resources/agent/quality.js +19 -9
  346. package/resources/agent/quality.js.map +1 -1
  347. package/resources/agent/resolve.js +3 -3
  348. package/resources/agent/resolve.js.map +1 -1
  349. package/resources/apply/apply.d.ts +4 -3
  350. package/resources/apply/apply.d.ts.map +1 -1
  351. package/resources/apply/apply.js +54 -41
  352. package/resources/apply/apply.js.map +1 -1
  353. package/resources/apply/handlers.d.ts.map +1 -1
  354. package/resources/apply/handlers.js +3 -4
  355. package/resources/apply/handlers.js.map +1 -1
  356. package/resources/channel.d.ts.map +1 -1
  357. package/resources/channel.js +3 -4
  358. package/resources/channel.js.map +1 -1
  359. package/resources/connect/connect.js +2 -2
  360. package/resources/connect/connect.js.map +1 -1
  361. package/resources/delete.d.ts.map +1 -1
  362. package/resources/delete.js +38 -4
  363. package/resources/delete.js.map +1 -1
  364. package/resources/documents.js +1 -1
  365. package/resources/documents.js.map +1 -1
  366. package/resources/download.d.ts +43 -3
  367. package/resources/download.d.ts.map +1 -1
  368. package/resources/download.js +169 -34
  369. package/resources/download.js.map +1 -1
  370. package/resources/eval-run/options.d.ts +3 -1
  371. package/resources/eval-run/options.d.ts.map +1 -1
  372. package/resources/eval-run/options.js +36 -18
  373. package/resources/eval-run/options.js.map +1 -1
  374. package/resources/eval-run/report.d.ts +4 -2
  375. package/resources/eval-run/report.d.ts.map +1 -1
  376. package/resources/eval-run/report.js +9 -7
  377. package/resources/eval-run/report.js.map +1 -1
  378. package/resources/eval-run/run.d.ts +2 -1
  379. package/resources/eval-run/run.d.ts.map +1 -1
  380. package/resources/eval-run/run.js +13 -7
  381. package/resources/eval-run/run.js.map +1 -1
  382. package/resources/file.d.ts +27 -0
  383. package/resources/file.d.ts.map +1 -0
  384. package/resources/file.js +82 -0
  385. package/resources/file.js.map +1 -0
  386. package/resources/get-bindings.d.ts.map +1 -1
  387. package/resources/get-bindings.js +18 -0
  388. package/resources/get-bindings.js.map +1 -1
  389. package/resources/git.d.ts +1 -1
  390. package/resources/git.js +1 -1
  391. package/resources/list.d.ts +21 -2
  392. package/resources/list.d.ts.map +1 -1
  393. package/resources/list.js +148 -31
  394. package/resources/list.js.map +1 -1
  395. package/resources/plugin.d.ts.map +1 -1
  396. package/resources/plugin.js +4 -0
  397. package/resources/plugin.js.map +1 -1
  398. package/resources/provider-key.d.ts +81 -0
  399. package/resources/provider-key.d.ts.map +1 -0
  400. package/resources/provider-key.js +261 -0
  401. package/resources/provider-key.js.map +1 -0
  402. package/resources/reference.d.ts +15 -21
  403. package/resources/reference.d.ts.map +1 -1
  404. package/resources/reference.js +42 -88
  405. package/resources/reference.js.map +1 -1
  406. package/resources/render.d.ts +31 -7
  407. package/resources/render.d.ts.map +1 -1
  408. package/resources/render.js +66 -38
  409. package/resources/render.js.map +1 -1
  410. package/resources/routine.d.ts +21 -5
  411. package/resources/routine.d.ts.map +1 -1
  412. package/resources/routine.js +104 -15
  413. package/resources/routine.js.map +1 -1
  414. package/resources/run/agent-exec.d.ts +12 -2
  415. package/resources/run/agent-exec.d.ts.map +1 -1
  416. package/resources/run/agent-exec.js +85 -38
  417. package/resources/run/agent-exec.js.map +1 -1
  418. package/resources/run/create.d.ts +16 -12
  419. package/resources/run/create.d.ts.map +1 -1
  420. package/resources/run/create.js +14 -15
  421. package/resources/run/create.js.map +1 -1
  422. package/resources/run/engines.d.ts +32 -0
  423. package/resources/run/engines.d.ts.map +1 -0
  424. package/resources/run/engines.js +39 -0
  425. package/resources/run/engines.js.map +1 -0
  426. package/resources/run/environment.d.ts +11 -0
  427. package/resources/run/environment.d.ts.map +1 -0
  428. package/resources/run/environment.js +30 -0
  429. package/resources/run/environment.js.map +1 -0
  430. package/resources/run/epilogue.d.ts +1 -1
  431. package/resources/run/epilogue.d.ts.map +1 -1
  432. package/resources/run/epilogue.js +18 -19
  433. package/resources/run/epilogue.js.map +1 -1
  434. package/resources/run/files.d.ts +104 -0
  435. package/resources/run/files.d.ts.map +1 -0
  436. package/resources/run/files.js +316 -0
  437. package/resources/run/files.js.map +1 -0
  438. package/resources/run/header.d.ts +11 -9
  439. package/resources/run/header.d.ts.map +1 -1
  440. package/resources/run/header.js +14 -14
  441. package/resources/run/header.js.map +1 -1
  442. package/resources/run/prepare.d.ts +31 -25
  443. package/resources/run/prepare.d.ts.map +1 -1
  444. package/resources/run/prepare.js +42 -51
  445. package/resources/run/prepare.js.map +1 -1
  446. package/resources/run/references.d.ts.map +1 -1
  447. package/resources/run/references.js +6 -5
  448. package/resources/run/references.js.map +1 -1
  449. package/resources/run/resolve.js +1 -1
  450. package/resources/run/resolve.js.map +1 -1
  451. package/resources/run/resume.d.ts +3 -1
  452. package/resources/run/resume.d.ts.map +1 -1
  453. package/resources/run/resume.js +25 -10
  454. package/resources/run/resume.js.map +1 -1
  455. package/resources/run/stream.d.ts +34 -2
  456. package/resources/run/stream.d.ts.map +1 -1
  457. package/resources/run/stream.js +92 -8
  458. package/resources/run/stream.js.map +1 -1
  459. package/resources/run/workspace.d.ts +9 -12
  460. package/resources/run/workspace.d.ts.map +1 -1
  461. package/resources/run/workspace.js +29 -36
  462. package/resources/run/workspace.js.map +1 -1
  463. package/resources/run-approve.d.ts.map +1 -1
  464. package/resources/run-approve.js +2 -11
  465. package/resources/run-approve.js.map +1 -1
  466. package/resources/run-control.d.ts +3 -3
  467. package/resources/run-control.d.ts.map +1 -1
  468. package/resources/run-control.js +4 -5
  469. package/resources/run-control.js.map +1 -1
  470. package/resources/run-format.d.ts +2 -2
  471. package/resources/run-format.d.ts.map +1 -1
  472. package/resources/run-format.js +3 -4
  473. package/resources/run-format.js.map +1 -1
  474. package/resources/run-logs.d.ts +2 -0
  475. package/resources/run-logs.d.ts.map +1 -1
  476. package/resources/run-logs.js +16 -6
  477. package/resources/run-logs.js.map +1 -1
  478. package/resources/run-scores.d.ts +6 -2
  479. package/resources/run-scores.d.ts.map +1 -1
  480. package/resources/run-scores.js +7 -4
  481. package/resources/run-scores.js.map +1 -1
  482. package/resources/run-to-eval-case.js +2 -2
  483. package/resources/run-to-eval-case.js.map +1 -1
  484. package/resources/runs.d.ts +3 -3
  485. package/resources/runs.d.ts.map +1 -1
  486. package/resources/runs.js +5 -5
  487. package/resources/runs.js.map +1 -1
  488. package/resources/search.d.ts.map +1 -1
  489. package/resources/search.js +1 -2
  490. package/resources/search.js.map +1 -1
  491. package/resources/service-account.d.ts +2 -0
  492. package/resources/service-account.d.ts.map +1 -1
  493. package/resources/service-account.js +3 -1
  494. package/resources/service-account.js.map +1 -1
  495. package/resources/session.d.ts +4 -3
  496. package/resources/session.d.ts.map +1 -1
  497. package/resources/session.js +10 -7
  498. package/resources/session.js.map +1 -1
  499. package/resources/skill.d.ts +1 -1
  500. package/resources/skill.d.ts.map +1 -1
  501. package/resources/skill.js +7 -8
  502. package/resources/skill.js.map +1 -1
  503. package/resources/stream/answer.d.ts +1 -2
  504. package/resources/stream/answer.d.ts.map +1 -1
  505. package/resources/stream/answer.js +3 -16
  506. package/resources/stream/answer.js.map +1 -1
  507. package/resources/stream/composer.d.ts +16 -0
  508. package/resources/stream/composer.d.ts.map +1 -0
  509. package/resources/stream/composer.js +171 -0
  510. package/resources/stream/composer.js.map +1 -0
  511. package/resources/stream/ink.d.ts +20 -4
  512. package/resources/stream/ink.d.ts.map +1 -1
  513. package/resources/stream/ink.js +34 -3
  514. package/resources/stream/ink.js.map +1 -1
  515. package/resources/stream/render-plaintext.d.ts +1 -0
  516. package/resources/stream/render-plaintext.d.ts.map +1 -1
  517. package/resources/stream/render-plaintext.js +21 -4
  518. package/resources/stream/render-plaintext.js.map +1 -1
  519. package/resources/stream/tty.js +1 -1
  520. package/resources/stream/tty.js.map +1 -1
  521. package/resources/tag.d.ts.map +1 -1
  522. package/resources/tag.js +7 -8
  523. package/resources/tag.js.map +1 -1
  524. package/resources/usage.d.ts +3 -2
  525. package/resources/usage.d.ts.map +1 -1
  526. package/resources/usage.js +19 -16
  527. package/resources/usage.js.map +1 -1
  528. package/resources/validate.d.ts.map +1 -1
  529. package/resources/validate.js +1 -12
  530. package/resources/validate.js.map +1 -1
  531. package/resources/version.d.ts +17 -3
  532. package/resources/version.d.ts.map +1 -1
  533. package/resources/version.js +105 -14
  534. package/resources/version.js.map +1 -1
  535. package/resources/views/agent.d.ts +3 -0
  536. package/resources/views/agent.d.ts.map +1 -0
  537. package/resources/views/agent.js +54 -0
  538. package/resources/views/agent.js.map +1 -0
  539. package/resources/views/environment.d.ts +3 -0
  540. package/resources/views/environment.d.ts.map +1 -0
  541. package/resources/views/environment.js +37 -0
  542. package/resources/views/environment.js.map +1 -0
  543. package/resources/views/index.d.ts +22 -0
  544. package/resources/views/index.d.ts.map +1 -0
  545. package/resources/views/index.js +70 -0
  546. package/resources/views/index.js.map +1 -0
  547. package/resources/views/organization.d.ts +3 -0
  548. package/resources/views/organization.d.ts.map +1 -0
  549. package/resources/views/organization.js +27 -0
  550. package/resources/views/organization.js.map +1 -0
  551. package/resources/views/routine.d.ts +3 -0
  552. package/resources/views/routine.d.ts.map +1 -0
  553. package/resources/views/routine.js +37 -0
  554. package/resources/views/routine.js.map +1 -0
  555. package/resources/views/run.d.ts +3 -0
  556. package/resources/views/run.d.ts.map +1 -0
  557. package/resources/views/run.js +45 -0
  558. package/resources/views/run.js.map +1 -0
  559. package/resources/views/session.d.ts +5 -0
  560. package/resources/views/session.d.ts.map +1 -0
  561. package/resources/views/session.js +85 -0
  562. package/resources/views/session.js.map +1 -0
  563. package/resources/views/skill.d.ts +5 -0
  564. package/resources/views/skill.d.ts.map +1 -0
  565. package/resources/views/skill.js +48 -0
  566. package/resources/views/skill.js.map +1 -0
  567. package/resources/views/view.d.ts +66 -0
  568. package/resources/views/view.d.ts.map +1 -0
  569. package/resources/views/view.js +130 -0
  570. package/resources/views/view.js.map +1 -0
  571. package/resources/views/words.d.ts +52 -0
  572. package/resources/views/words.d.ts.map +1 -0
  573. package/resources/views/words.js +190 -0
  574. package/resources/views/words.js.map +1 -0
  575. package/runtime.d.ts +22 -0
  576. package/runtime.d.ts.map +1 -1
  577. package/runtime.js +33 -2
  578. package/runtime.js.map +1 -1
  579. package/src/auth/auth0.ts +1 -1
  580. package/src/auth/token.ts +136 -26
  581. package/src/client/client.ts +23 -16
  582. package/src/command-tree.ts +152 -0
  583. package/src/commands/access-history/index.ts +15 -2
  584. package/src/commands/agent-exec-flags.ts +11 -5
  585. package/src/commands/apikey/duration.ts +1 -2
  586. package/src/commands/apikey/index.ts +3 -4
  587. package/src/commands/apply.ts +3 -22
  588. package/src/commands/auth/index.ts +7 -5
  589. package/src/commands/auth/whoami.ts +1 -1
  590. package/src/commands/config/index.ts +3 -3
  591. package/src/commands/config/kv.ts +18 -14
  592. package/src/commands/connect.ts +21 -3
  593. package/src/commands/download.ts +106 -62
  594. package/src/commands/eval.ts +22 -21
  595. package/src/commands/file.ts +80 -0
  596. package/src/commands/get.ts +19 -13
  597. package/src/commands/help.ts +182 -0
  598. package/src/commands/internal-daemon.ts +9 -2
  599. package/src/commands/list.ts +22 -1
  600. package/src/commands/logs.ts +1 -1
  601. package/src/commands/mcp-server.ts +57 -28
  602. package/src/commands/provider-key/index.ts +192 -0
  603. package/src/commands/push.ts +8 -8
  604. package/src/commands/resume.ts +20 -12
  605. package/src/commands/routine.ts +58 -5
  606. package/src/commands/run.ts +37 -17
  607. package/src/commands/runs/approve.ts +13 -4
  608. package/src/commands/runs/control.ts +50 -27
  609. package/src/commands/runs/index.ts +1 -2
  610. package/src/commands/runs/logs.ts +9 -5
  611. package/src/commands/runs/to-eval-case.ts +18 -6
  612. package/src/commands/runs/trace.ts +1 -1
  613. package/src/commands/search.ts +2 -3
  614. package/src/commands/service-account/index.ts +7 -2
  615. package/src/commands/session-help.ts +39 -0
  616. package/src/commands/setup.ts +5 -5
  617. package/src/commands/shared.ts +32 -3
  618. package/src/commands/tag.ts +13 -7
  619. package/src/commands/up.ts +55 -21
  620. package/src/commands/validate.ts +2 -2
  621. package/src/commands/version.ts +9 -4
  622. package/src/config/config.ts +66 -69
  623. package/src/config/index.ts +1 -2
  624. package/src/config/keys.ts +4 -4
  625. package/src/config/paths.ts +2 -2
  626. package/src/config/resolve.ts +20 -8
  627. package/src/errors/classify.ts +110 -21
  628. package/src/errors/command-line.ts +95 -0
  629. package/src/errors/handle.ts +2 -2
  630. package/src/errors/index.ts +12 -2
  631. package/src/errors/usage-error.ts +1 -1
  632. package/src/global-options.ts +100 -0
  633. package/src/local/artifact.ts +46 -140
  634. package/src/local/constants.ts +3 -9
  635. package/src/local/daemon/components.ts +78 -22
  636. package/src/local/daemon/env.ts +3 -8
  637. package/src/local/daemon/host.ts +64 -19
  638. package/src/local/daemon/index.ts +2 -1
  639. package/src/local/daemon/launch.ts +251 -72
  640. package/src/local/daemon/process.ts +78 -46
  641. package/src/local/daemon/signals.ts +19 -0
  642. package/src/local/daemon/supervisor.ts +84 -21
  643. package/src/local/daemon/types.ts +8 -4
  644. package/src/local/llm-config.ts +15 -9
  645. package/src/local/logs/view.ts +5 -6
  646. package/src/local/net/tcp.ts +18 -11
  647. package/src/local/paths.ts +2 -3
  648. package/src/local/provider-reach.ts +124 -0
  649. package/src/local/reset.ts +1 -2
  650. package/src/local/runtime/index.ts +1 -2
  651. package/src/local/runtime/node.ts +1 -1
  652. package/src/local/runtime/runner.ts +2 -2
  653. package/src/local/runtime/runtimes-install.ts +1 -1
  654. package/src/local/runtime/server.ts +2 -4
  655. package/src/local/runtime/which.ts +1 -1
  656. package/src/local/setup/wizard.ts +7 -5
  657. package/src/local/state/health-state.ts +10 -2
  658. package/src/local/state/lock.ts +26 -28
  659. package/src/local/state/log-rotation.ts +2 -3
  660. package/src/local/state/pidfile.ts +61 -6
  661. package/src/local/state/proc.ts +104 -1
  662. package/src/local/state/startup-config.ts +2 -2
  663. package/src/local/status.ts +30 -41
  664. package/src/local/temporal/download.ts +31 -9
  665. package/src/local/temporal/index.ts +1 -1
  666. package/src/local/temporal/manager.ts +94 -34
  667. package/src/local/temporal/supervisor.ts +1 -1
  668. package/src/local/webconsole/index.ts +8 -5
  669. package/src/marketplace/github.ts +1 -1
  670. package/src/marketplace/official.ts +1 -1
  671. package/src/output/command-result.ts +14 -2
  672. package/src/output/confirm.ts +2 -3
  673. package/src/output/format.ts +5 -6
  674. package/src/output/index.ts +8 -1
  675. package/src/output/printable.ts +26 -0
  676. package/src/output/proto.ts +3 -4
  677. package/src/output/style.ts +2 -2
  678. package/src/output/table.ts +118 -15
  679. package/src/program.ts +58 -128
  680. package/src/registry/aliases.ts +0 -3
  681. package/src/registry/index.ts +0 -1
  682. package/src/registry/metadata.ts +16 -64
  683. package/src/registry/registry.ts +3 -13
  684. package/src/registry/verb-support.ts +28 -5
  685. package/src/resources/agent/quality.ts +29 -8
  686. package/src/resources/agent/resolve.ts +3 -3
  687. package/src/resources/apply/apply.ts +58 -49
  688. package/src/resources/apply/handlers.ts +3 -4
  689. package/src/resources/channel.ts +3 -4
  690. package/src/resources/connect/connect.ts +2 -2
  691. package/src/resources/delete.ts +44 -4
  692. package/src/resources/documents.ts +1 -1
  693. package/src/resources/download.ts +239 -43
  694. package/src/resources/eval-run/options.ts +38 -17
  695. package/src/resources/eval-run/report.ts +11 -5
  696. package/src/resources/eval-run/run.ts +13 -9
  697. package/src/resources/file.ts +114 -0
  698. package/src/resources/get-bindings.ts +18 -0
  699. package/src/resources/git.ts +1 -1
  700. package/src/resources/list.ts +178 -34
  701. package/src/resources/plugin.ts +3 -0
  702. package/src/resources/provider-key.ts +327 -0
  703. package/src/resources/reference.ts +41 -85
  704. package/src/resources/render.ts +72 -38
  705. package/src/resources/routine.ts +152 -15
  706. package/src/resources/run/agent-exec.ts +95 -44
  707. package/src/resources/run/create.ts +27 -24
  708. package/src/resources/run/engines.ts +57 -0
  709. package/src/resources/run/environment.ts +43 -0
  710. package/src/resources/run/epilogue.ts +18 -17
  711. package/src/resources/run/files.ts +433 -0
  712. package/src/resources/run/header.ts +18 -18
  713. package/src/resources/run/prepare.ts +67 -74
  714. package/src/resources/run/references.ts +6 -5
  715. package/src/resources/run/resolve.ts +1 -1
  716. package/src/resources/run/resume.ts +28 -9
  717. package/src/resources/run/stream.ts +110 -9
  718. package/src/resources/run/workspace.ts +37 -47
  719. package/src/resources/run-approve.ts +2 -14
  720. package/src/resources/run-control.ts +4 -5
  721. package/src/resources/run-format.ts +3 -4
  722. package/src/resources/run-logs.ts +17 -6
  723. package/src/resources/run-scores.ts +14 -4
  724. package/src/resources/run-to-eval-case.ts +2 -2
  725. package/src/resources/runs.ts +5 -5
  726. package/src/resources/search.ts +1 -2
  727. package/src/resources/service-account.ts +4 -1
  728. package/src/resources/session.ts +10 -7
  729. package/src/resources/skill.ts +7 -8
  730. package/src/resources/stream/answer.ts +3 -19
  731. package/src/resources/stream/composer.ts +170 -0
  732. package/src/resources/stream/ink.tsx +74 -10
  733. package/src/resources/stream/render-plaintext.ts +22 -4
  734. package/src/resources/stream/tty.ts +1 -1
  735. package/src/resources/tag.ts +7 -9
  736. package/src/resources/usage.ts +19 -15
  737. package/src/resources/validate.ts +1 -10
  738. package/src/resources/version.ts +117 -15
  739. package/src/resources/views/agent.ts +60 -0
  740. package/src/resources/views/environment.ts +41 -0
  741. package/src/resources/views/index.ts +82 -0
  742. package/src/resources/views/organization.ts +29 -0
  743. package/src/resources/views/routine.ts +39 -0
  744. package/src/resources/views/run.ts +46 -0
  745. package/src/resources/views/session.ts +91 -0
  746. package/src/resources/views/skill.ts +49 -0
  747. package/src/resources/views/view.ts +188 -0
  748. package/src/resources/views/words.ts +191 -0
  749. package/src/runtime.ts +51 -2
  750. package/errors/exit-codes.d.ts +0 -10
  751. package/errors/exit-codes.d.ts.map +0 -1
  752. package/errors/exit-codes.js +0 -15
  753. package/errors/exit-codes.js.map +0 -1
  754. package/resources/run/attachments.d.ts +0 -24
  755. package/resources/run/attachments.d.ts.map +0 -1
  756. package/resources/run/attachments.js +0 -237
  757. package/resources/run/attachments.js.map +0 -1
  758. package/src/errors/exit-codes.ts +0 -17
  759. package/src/resources/run/attachments.ts +0 -300
  760. package/src/types/marked-terminal.d.ts +0 -31
@@ -0,0 +1,114 @@
1
+ // `stigmer file upload`: put files on disk into Stigmer as Files, named by
2
+ // the ids the uploads mint, so a later run (`run --file-id`), a routine or
3
+ // the console can name them without sending the bytes again.
4
+ //
5
+ // Trade-offs:
6
+ // - Every path is checked before any byte moves: a missing path or a folder
7
+ // fails the command with nothing uploaded. A folder is refused rather
8
+ // than walked, because a folder only means something inside a
9
+ // conversation (`run --attach` keeps its tree there); outside one it
10
+ // would scatter its files into flat, unrelated Files.
11
+ // - The uploads share `run --attach`'s pool: a few at a time, streamed from
12
+ // disk, and all-or-nothing, so a failed batch deletes the Files it had
13
+ // uploaded and the same command can simply be run again.
14
+ // - Without `--session` the Files are the person's own, kept for reuse;
15
+ // with it they are that conversation's from the start, uploaded in the
16
+ // conversation's own organization and given to it: appended to its
17
+ // resources, each placed by its filename (the server makes a name the
18
+ // conversation already holds unique), so the agent finds them under
19
+ // .stigmer/uploads/ on its next turn. A File only uploaded into a
20
+ // conversation is never mounted.
21
+
22
+ import { statSync } from "node:fs";
23
+ import { basename, resolve } from "node:path";
24
+ import { create } from "@bufbuild/protobuf";
25
+ import {
26
+ FileResourceSchema,
27
+ SessionResourceSchema,
28
+ } from "@stigmer/apis/ai/stigmer/agentic/session/v1/resource_pb";
29
+ import type { Session } from "@stigmer/apis/ai/stigmer/agentic/session/v1/api_pb";
30
+ import type { Stigmer } from "@stigmer/client";
31
+ import { UsageError } from "../errors/index.js";
32
+ import { CommandResult } from "../output/index.js";
33
+ import { giveFilesToSession, type ProgressSink, uploadAll } from "./run/files.js";
34
+ import { formatBytes } from "./skill.js";
35
+
36
+ /** One uploaded File, as the command reports it. */
37
+ export interface UploadedFile {
38
+ readonly id: string;
39
+ readonly filename: string;
40
+ readonly sizeBytes: number;
41
+ }
42
+
43
+ /** Where the Files go: an organization, and a conversation when one is named. */
44
+ export interface FileUploadTarget {
45
+ readonly org: string;
46
+ /**
47
+ * The conversation the Files are given to, as read before the upload (its
48
+ * etag guards the update); omitted keeps them the person's own.
49
+ */
50
+ readonly session?: Session;
51
+ }
52
+
53
+ /**
54
+ * Upload each path as a File, in the order given. Refuses a missing path or
55
+ * a folder before uploading anything.
56
+ */
57
+ export async function uploadFiles(
58
+ client: Stigmer,
59
+ paths: readonly string[],
60
+ target: FileUploadTarget,
61
+ progress?: ProgressSink,
62
+ ): Promise<UploadedFile[]> {
63
+ const planned = paths.map((path) => {
64
+ const size = fileSize(path);
65
+ return { path: resolve(path), filename: basename(path), size };
66
+ });
67
+ const session = target.session;
68
+ for (const file of planned) progress?.(`Uploading ${file.filename} (${formatBytes(file.size)})...`);
69
+ const ids = await uploadAll(client, planned, { org: target.org, sessionId: session?.metadata?.id ?? "" }, progress);
70
+ if (session !== undefined) {
71
+ const resources = ids.map((fileId) =>
72
+ create(SessionResourceSchema, {
73
+ resource: { case: "file", value: create(FileResourceSchema, { fileId }) },
74
+ }),
75
+ );
76
+ await giveFilesToSession(client, session, resources, ids, ids.length === 1 ? "the file" : "the files", progress);
77
+ }
78
+ return planned.map((file, i) => ({ id: ids[i], filename: file.filename, sizeBytes: file.size }));
79
+ }
80
+
81
+ /** The uploaded Files, each name beside the id that names it from now on. */
82
+ export function renderUploadedFiles(files: readonly UploadedFile[], sessionId: string): CommandResult {
83
+ const result = CommandResult.success(
84
+ files.length === 1 ? "Uploaded 1 file" : `Uploaded ${files.length} files`,
85
+ );
86
+ const section = result.addSection("Files");
87
+ for (const file of files) section.field(file.filename, file.id);
88
+ if (sessionId === "") {
89
+ result.hint("Name one in a new conversation with: stigmer run <agent> --file-id <id>");
90
+ }
91
+ return result.withData({
92
+ files: files.map((file) => ({ id: file.id, filename: file.filename, size_bytes: file.sizeBytes })),
93
+ });
94
+ }
95
+
96
+ function fileSize(path: string): number {
97
+ let stats;
98
+ try {
99
+ stats = statSync(path);
100
+ } catch (err) {
101
+ const e = err as NodeJS.ErrnoException;
102
+ if (e.code === "ENOENT") throw new UsageError(`file not found: ${path}`);
103
+ throw new UsageError(`cannot read "${path}": ${e.message}`);
104
+ }
105
+ if (stats.isDirectory()) {
106
+ throw new UsageError(
107
+ `"${path}" is a folder; attach a folder to a conversation with stigmer run --attach`,
108
+ );
109
+ }
110
+ if (!stats.isFile()) {
111
+ throw new UsageError(`cannot upload "${path}": not a file`);
112
+ }
113
+ return stats.size;
114
+ }
@@ -7,12 +7,15 @@ import type { DescMessage, Message } from "@bufbuild/protobuf";
7
7
  import { AgentSchema } from "@stigmer/apis/ai/stigmer/agentic/agent/v1/api_pb";
8
8
  import { ChannelSchema } from "@stigmer/apis/ai/stigmer/agentic/channel/v1/api_pb";
9
9
  import { ChannelAppSchema } from "@stigmer/apis/ai/stigmer/agentic/channelapp/v1/api_pb";
10
+ import { EnvironmentSchema } from "@stigmer/apis/ai/stigmer/agentic/environment/v1/api_pb";
11
+ import { FileSchema } from "@stigmer/apis/ai/stigmer/agentic/file/v1/api_pb";
10
12
  import { PluginSchema } from "@stigmer/apis/ai/stigmer/agentic/plugin/v1/api_pb";
11
13
  import { RoutineSchema } from "@stigmer/apis/ai/stigmer/agentic/routine/v1/api_pb";
12
14
  import { EvalSchema } from "@stigmer/apis/ai/stigmer/agentic/eval/v1/api_pb";
13
15
  import { EvalRunSchema } from "@stigmer/apis/ai/stigmer/agentic/evalrun/v1/api_pb";
14
16
  import { ScoringRuleSchema } from "@stigmer/apis/ai/stigmer/agentic/scoringrule/v1/api_pb";
15
17
  import { ScoreSchema } from "@stigmer/apis/ai/stigmer/agentic/score/v1/api_pb";
18
+ import { SessionSchema } from "@stigmer/apis/ai/stigmer/agentic/session/v1/api_pb";
16
19
  import { SkillSchema } from "@stigmer/apis/ai/stigmer/agentic/skill/v1/api_pb";
17
20
  import { VaultSchema } from "@stigmer/apis/ai/stigmer/agentic/vault/v1/api_pb";
18
21
  import { ApiResourceKind } from "@stigmer/apis/ai/stigmer/commons/apiresource/apiresourcekind/api_resource_kind_pb";
@@ -63,6 +66,10 @@ export const GET_BINDINGS: ReadonlyMap<ApiResourceKind, Getter> = new Map([
63
66
  ApiResourceKind.routine,
64
67
  refGetter(ApiResourceKind.routine, RoutineSchema, (c) => c.routine),
65
68
  ],
69
+ [
70
+ ApiResourceKind.environment,
71
+ refGetter(ApiResourceKind.environment, EnvironmentSchema, (c) => c.environment),
72
+ ],
66
73
  [
67
74
  ApiResourceKind.skill,
68
75
  refGetter(ApiResourceKind.skill, SkillSchema, (c) => c.skill),
@@ -91,6 +98,17 @@ export const GET_BINDINGS: ReadonlyMap<ApiResourceKind, Getter> = new Map([
91
98
  ApiResourceKind.eval_run,
92
99
  idOnlyGetter(EvalRunSchema, (c) => c.evalrun, "Eval runs"),
93
100
  ],
101
+ // A session is a conversation, named by the id `run` and `list sessions`
102
+ // print (stigmer/stigmer#2502).
103
+ [
104
+ ApiResourceKind.session,
105
+ idOnlyGetter(SessionSchema, (c) => c.session, "Sessions"),
106
+ ],
107
+ // A File has an id and no slug: it is named by the id its upload minted.
108
+ [
109
+ ApiResourceKind.file,
110
+ idOnlyGetter(FileSchema, (c) => c.file, "Files"),
111
+ ],
94
112
  ]);
95
113
 
96
114
  export function getterFor(kind: ApiResourceKind): Getter | undefined {
@@ -49,7 +49,7 @@ export function getGitBranchName(dir: string): string | undefined {
49
49
  /**
50
50
  * Clone `gitUrl` into `destDir`, checking out `gitRef` if given. Tries a shallow
51
51
  * `--branch` clone first (fast for tags/branches), falling back to a full clone
52
- * plus checkout when the ref is a commit SHA. Mirrors Go's cloneRepository.
52
+ * plus checkout when the ref is a commit SHA.
53
53
  */
54
54
  export function cloneRepository(gitUrl: string, gitRef: string, destDir: string): void {
55
55
  const args = ["clone", "--depth", "1"];
@@ -16,10 +16,21 @@
16
16
  // Rows carry organizations by id. The human table names each by slug, one
17
17
  // lookup per distinct organization in the listing; json and yaml stay the
18
18
  // wire as-is.
19
+ //
20
+ // Each table names its free-text columns (`shrink`): on a narrow terminal
21
+ // those give up width and end in "…", while ids, slugs and `org/slug` names,
22
+ // which a person copies into the next command, keep every character. Free
23
+ // text is folded onto one line here, piped or not, since a line break in a
24
+ // cell breaks the row for a script too.
19
25
 
26
+ import { printableCell } from "../output/printable.js";
20
27
  import { create, type DescMessage, type Message } from "@bufbuild/protobuf";
21
28
  import { ChannelSchema } from "@stigmer/apis/ai/stigmer/agentic/channel/v1/api_pb";
22
29
  import { ListChannelsRequestSchema } from "@stigmer/apis/ai/stigmer/agentic/channel/v1/io_pb";
30
+ import { EnvironmentSchema } from "@stigmer/apis/ai/stigmer/agentic/environment/v1/api_pb";
31
+ import { FileSchema } from "@stigmer/apis/ai/stigmer/agentic/file/v1/api_pb";
32
+ import { ListFilesRequestSchema } from "@stigmer/apis/ai/stigmer/agentic/file/v1/io_pb";
33
+ import { ListEnvironmentsRequestSchema } from "@stigmer/apis/ai/stigmer/agentic/environment/v1/io_pb";
23
34
  import { ChannelAppSchema } from "@stigmer/apis/ai/stigmer/agentic/channelapp/v1/api_pb";
24
35
  import { ListChannelAppsInputSchema } from "@stigmer/apis/ai/stigmer/agentic/channelapp/v1/io_pb";
25
36
  import { RoutineSchema } from "@stigmer/apis/ai/stigmer/agentic/routine/v1/api_pb";
@@ -57,6 +68,7 @@ import {
57
68
  } from "./render.js";
58
69
  import { organizationLabels } from "../client/organizations.js";
59
70
  import { requireOrganization } from "../client/single-org.js";
71
+ import { formatBytes } from "./skill.js";
60
72
 
61
73
  // One fetched page of a listing: what to render (entries + schema) and how
62
74
  // (table). Rendering and --limit truncation happen centrally in
@@ -67,15 +79,32 @@ interface ListPage {
67
79
  readonly table: TableShape;
68
80
  }
69
81
 
82
+ /**
83
+ * What narrows a listing beyond its organization. Every handler takes the
84
+ * same shape, so the dispatcher never special-cases a kind: a handler reads
85
+ * the filters its list request carries, and the command layer refuses a
86
+ * filter for a kind that has none (`--session` names a conversation, and
87
+ * only Files belong to one).
88
+ */
89
+ export interface ListFilters {
90
+ /**
91
+ * The --label filter: the server answers only resources carrying every
92
+ * pair, each matched exactly; empty filters nothing.
93
+ */
94
+ readonly labels: Record<string, string>;
95
+ /** The --session filter: one conversation's Files; "" filters nothing. */
96
+ readonly sessionId: string;
97
+ }
98
+
99
+ const NO_FILTERS: ListFilters = { labels: {}, sessionId: "" };
100
+
70
101
  // The handler walks pages up to `limit` (0: every page), so the
71
102
  // dispatcher's slice is a no-op it keeps as the one place the flag binds.
72
- // `labels` is the --label filter: the server answers only resources
73
- // carrying every pair, each matched exactly; empty filters nothing.
74
103
  type ListFn = (
75
104
  client: Stigmer,
76
105
  org: string,
77
106
  limit: number,
78
- labels: Record<string, string>,
107
+ filters: ListFilters,
79
108
  ) => Promise<ListPage>;
80
109
 
81
110
  // The list handlers. Every kind declaring List in the verb matrix must
@@ -86,7 +115,7 @@ export const LIST_HANDLERS: ReadonlyMap<ApiResourceKind, ListFn> = new Map<
86
115
  >([
87
116
  [
88
117
  ApiResourceKind.organization,
89
- async (client, _org, limit, labels) => {
118
+ async (client, _org, limit, { labels }) => {
90
119
  // listMine is caller-scoped: the organizations the caller belongs to.
91
120
  const entries = await readCursorPages(limit, (pageSize, pageToken) =>
92
121
  client.organization.listMine(create(ListMyOrganizationsInputSchema, { pageSize, pageToken, labels })),
@@ -100,7 +129,7 @@ export const LIST_HANDLERS: ReadonlyMap<ApiResourceKind, ListFn> = new Map<
100
129
  ],
101
130
  [
102
131
  ApiResourceKind.api_key,
103
- async (client, _org, limit, labels) => {
132
+ async (client, _org, limit, { labels }) => {
104
133
  // list is caller-scoped: the keys that speak for the caller.
105
134
  const entries = await readCursorPages(limit, (pageSize, pageToken) =>
106
135
  client.apiKey.list(create(ListApiKeysInputSchema, { pageSize, pageToken, labels })),
@@ -114,7 +143,7 @@ export const LIST_HANDLERS: ReadonlyMap<ApiResourceKind, ListFn> = new Map<
114
143
  ],
115
144
  [
116
145
  ApiResourceKind.channel,
117
- async (client, org, limit, labels) => {
146
+ async (client, org, limit, { labels }) => {
118
147
  const entries = await readCursorPages(limit, (pageSize, pageToken) =>
119
148
  client.channel.list(create(ListChannelsRequestSchema, { org, pageSize, pageToken, labels })),
120
149
  );
@@ -127,7 +156,7 @@ export const LIST_HANDLERS: ReadonlyMap<ApiResourceKind, ListFn> = new Map<
127
156
  ],
128
157
  [
129
158
  ApiResourceKind.channel_app,
130
- async (client, org, limit, labels) => {
159
+ async (client, org, limit, { labels }) => {
131
160
  // `channelapp` (not `channelApp`) is a recorded SDK codegen naming quirk.
132
161
  const entries = await readCursorPages(limit, (pageSize, pageToken) =>
133
162
  client.channelapp.list(create(ListChannelAppsInputSchema, { org, pageSize, pageToken, labels })),
@@ -141,7 +170,7 @@ export const LIST_HANDLERS: ReadonlyMap<ApiResourceKind, ListFn> = new Map<
141
170
  ],
142
171
  [
143
172
  ApiResourceKind.routine,
144
- async (client, org, limit, labels) => {
173
+ async (client, org, limit, { labels }) => {
145
174
  // ListRoutinesRequest requires an org (min_len 1): a server that holds
146
175
  // one fills it, and on one that holds several an unset context is
147
176
  // refused with actionable copy instead of the server's raw validation
@@ -160,9 +189,27 @@ export const LIST_HANDLERS: ReadonlyMap<ApiResourceKind, ListFn> = new Map<
160
189
  };
161
190
  },
162
191
  ],
192
+ [
193
+ ApiResourceKind.environment,
194
+ async (client, org, limit, { labels }) => {
195
+ // ListEnvironmentsRequest requires an org (min_len 1), as routines' does.
196
+ await requireOrganization(client, org, [
197
+ "stigmer list environments --org <org>",
198
+ "stigmer config context set --org <org>",
199
+ ]);
200
+ const entries = await readCursorPages(limit, (pageSize, pageToken) =>
201
+ client.environment.list(create(ListEnvironmentsRequestSchema, { org, pageSize, pageToken, labels })),
202
+ );
203
+ return {
204
+ schema: EnvironmentSchema,
205
+ entries,
206
+ table: ENVIRONMENT_TABLE,
207
+ };
208
+ },
209
+ ],
163
210
  [
164
211
  ApiResourceKind.vault,
165
- async (client, org, limit, labels) => {
212
+ async (client, org, limit, { labels }) => {
166
213
  // Vaults are never search-indexed (a person's own vault names their
167
214
  // keys), so the dedicated list answers: the caller's own vault and the
168
215
  // shared vaults they may see. The request requires an org.
@@ -182,7 +229,7 @@ export const LIST_HANDLERS: ReadonlyMap<ApiResourceKind, ListFn> = new Map<
182
229
  ],
183
230
  [
184
231
  ApiResourceKind.session,
185
- async (client, _org, limit, labels) => {
232
+ async (client, _org, limit, { labels }) => {
186
233
  // The session list is caller-scoped like organization and api_key
187
234
  // above. Promoted from a bespoke pre-gate route in commands/list.ts by
188
235
  // stigmer/stigmer#469 (it had shipped working-but-unadvertised).
@@ -198,7 +245,7 @@ export const LIST_HANDLERS: ReadonlyMap<ApiResourceKind, ListFn> = new Map<
198
245
  ],
199
246
  [
200
247
  ApiResourceKind.agent,
201
- async (client, org, limit, labels) => {
248
+ async (client, org, limit, { labels }) => {
202
249
  await requireOrganization(client, org, [
203
250
  "stigmer list agents --org <org>",
204
251
  "stigmer config context set --org <org>",
@@ -211,7 +258,7 @@ export const LIST_HANDLERS: ReadonlyMap<ApiResourceKind, ListFn> = new Map<
211
258
  ],
212
259
  [
213
260
  ApiResourceKind.skill,
214
- async (client, org, limit, labels) => {
261
+ async (client, org, limit, { labels }) => {
215
262
  await requireOrganization(client, org, [
216
263
  "stigmer list skills --org <org>",
217
264
  "stigmer config context set --org <org>",
@@ -224,7 +271,7 @@ export const LIST_HANDLERS: ReadonlyMap<ApiResourceKind, ListFn> = new Map<
224
271
  ],
225
272
  [
226
273
  ApiResourceKind.plugin,
227
- async (client, org, limit, labels) => {
274
+ async (client, org, limit, { labels }) => {
228
275
  await requireOrganization(client, org, [
229
276
  "stigmer list plugins --org <org>",
230
277
  "stigmer config context set --org <org>",
@@ -235,9 +282,35 @@ export const LIST_HANDLERS: ReadonlyMap<ApiResourceKind, ListFn> = new Map<
235
282
  return { schema: PluginSchema, entries, table: libraryTable("plugins") };
236
283
  },
237
284
  ],
285
+ [
286
+ ApiResourceKind.file,
287
+ async (client, org, limit, { labels, sessionId }) => {
288
+ if (sessionId !== "") {
289
+ // A conversation names its own organization, so its Files are
290
+ // listed there whatever the context organization is.
291
+ const session = await client.session.get(sessionId);
292
+ const sessionOrg = session.metadata?.org ?? "";
293
+ const entries = await readCursorPages(limit, (pageSize, pageToken) =>
294
+ client.file.list(create(ListFilesRequestSchema, { org: sessionOrg, sessionId, pageSize, pageToken, labels })),
295
+ );
296
+ return { schema: FileSchema, entries, table: SESSION_FILE_TABLE };
297
+ }
298
+ // Without a conversation, the Files kept for reuse: uploaded through
299
+ // the API, the CLI or the console's Library and never given to a
300
+ // conversation. A conversation's uploads and outputs live with it.
301
+ await requireOrganization(client, org, [
302
+ "stigmer list files --org <org>",
303
+ "stigmer config context set --org <org>",
304
+ ]);
305
+ const entries = await readCursorPages(limit, (pageSize, pageToken) =>
306
+ client.file.list(create(ListFilesRequestSchema, { org, withoutSession: true, pageSize, pageToken, labels })),
307
+ );
308
+ return { schema: FileSchema, entries, table: FILE_TABLE };
309
+ },
310
+ ],
238
311
  [
239
312
  ApiResourceKind.eval,
240
- async (client, org, limit, labels) => {
313
+ async (client, org, limit, { labels }) => {
241
314
  await requireOrganization(client, org, [
242
315
  "stigmer list evals --org <org>",
243
316
  "stigmer config context set --org <org>",
@@ -256,9 +329,9 @@ export async function listResources(
256
329
  org: string,
257
330
  limit: number,
258
331
  format: OutputFormat,
259
- labels: Record<string, string> = {},
332
+ filters: Partial<ListFilters> = {},
260
333
  ): Promise<string> {
261
- const page = await fetchListPage(client, kind, org, limit, labels);
334
+ const page = await fetchListPage(client, kind, org, limit, { ...NO_FILTERS, ...filters });
262
335
  // The single point where --limit binds the output (0: every entry). The
263
336
  // handler already walked at most `limit` entries, so this is a no-op;
264
337
  // binding it here rather than per-handler is what keeps the flag honest
@@ -278,27 +351,28 @@ async function fetchListPage(
278
351
  kind: ApiResourceKind,
279
352
  org: string,
280
353
  limit: number,
281
- labels: Record<string, string>,
354
+ filters: ListFilters,
282
355
  ): Promise<ListPage> {
283
356
  const handler = LIST_HANDLERS.get(kind);
284
357
  if (handler === undefined) {
285
358
  throw new UsageError("list is not implemented for this resource type");
286
359
  }
287
- return handler(client, org, limit, labels);
360
+ return handler(client, org, limit, filters);
288
361
  }
289
362
 
290
363
  // Agents, skills and plugins: what a person browses a library by. The
291
364
  // description is the spec's, as search shows it.
292
- function libraryTable(resourceName: string): TableShape {
365
+ export function libraryTable(resourceName: string): TableShape {
293
366
  return {
294
367
  resourceName,
295
368
  headers: ["NAME", "DESCRIPTION", "VISIBILITY", "CREATED"],
369
+ shrink: ["DESCRIPTION"],
296
370
  orgs: (json) => [str(obj(json, "metadata"), "org")],
297
371
  row: (json, orgLabel) => {
298
372
  const metadata = obj(json, "metadata");
299
373
  return [
300
374
  `${orgLabel(str(metadata, "org"))}/${str(metadata, "slug")}`,
301
- truncate(str(obj(json, "spec"), "description"), 50),
375
+ oneLine(str(obj(json, "spec"), "description")),
302
376
  str(metadata, "visibility"),
303
377
  date(str(obj(obj(obj(json, "status"), "audit"), "spec_audit"), "created_at")),
304
378
  ];
@@ -326,14 +400,52 @@ const EVAL_TABLE: TableShape = {
326
400
  },
327
401
  };
328
402
 
403
+ // A File is named by its id, so the id leads, and its NAME (the filename
404
+ // the upload carried) is the free text that shrinks. TYPE is the media type
405
+ // the upload recorded, SIZE its bytes in a human unit.
406
+ const FILE_TABLE: TableShape = {
407
+ resourceName: "files",
408
+ headers: ["ID", "NAME", "TYPE", "SIZE", "VISIBILITY", "CREATED"],
409
+ shrink: ["NAME"],
410
+ row: (json) => fileRow(json),
411
+ };
412
+
413
+ // One conversation's Files: what was given to it and what its turns saved.
414
+ // OUTPUT is where a turn saved the File under its outputs folder, empty for
415
+ // one given to the conversation.
416
+ const SESSION_FILE_TABLE: TableShape = {
417
+ resourceName: "files",
418
+ headers: ["ID", "NAME", "OUTPUT", "TYPE", "SIZE", "VISIBILITY", "CREATED"],
419
+ shrink: ["NAME"],
420
+ row: (json) => {
421
+ const [id, name, ...rest] = fileRow(json);
422
+ return [id, name, str(obj(json, "status"), "output_path") || "-", ...rest];
423
+ },
424
+ };
425
+
426
+ function fileRow(json: JsonObject): string[] {
427
+ const metadata = obj(json, "metadata");
428
+ const spec = obj(json, "spec");
429
+ const status = obj(json, "status");
430
+ return [
431
+ str(metadata, "id"),
432
+ oneLine(str(spec, "filename")),
433
+ str(spec, "mime_type") || "-",
434
+ formatBytes(Number(str(status, "size_bytes") || "0")),
435
+ str(metadata, "visibility"),
436
+ date(str(obj(obj(status, "audit"), "spec_audit"), "created_at")),
437
+ ];
438
+ }
439
+
329
440
  // The `stigmer search` table: SearchService results.
330
441
  export const SEARCH_TABLE: TableShape = {
331
442
  resourceName: "resources",
332
443
  headers: ["NAME", "DESCRIPTION", "VISIBILITY", "CREATED"],
444
+ shrink: ["DESCRIPTION"],
333
445
  orgs: (json) => [str(json, "org")],
334
446
  row: (json, orgLabel) => [
335
447
  qualifiedName(json, orgLabel),
336
- truncate(str(json, "description"), 50),
448
+ oneLine(str(json, "description")),
337
449
  str(json, "visibility"),
338
450
  date(str(json, "created_at")),
339
451
  ],
@@ -345,15 +457,16 @@ export const SEARCH_TABLE: TableShape = {
345
457
  // STATE is whether the session works (running) or waits for input (idle),
346
458
  // which the server computes from the session's events on every read
347
459
  // (SessionStatus.state); a server that predates it sends none, shown "-".
348
- const SESSION_TABLE: TableShape = {
460
+ export const SESSION_TABLE: TableShape = {
349
461
  resourceName: "sessions",
350
462
  headers: ["SESSION ID", "STATE", "AGENT", "SUBJECT", "CREATED"],
463
+ shrink: ["SUBJECT"],
351
464
  orgs: (json) => [str(obj(obj(json, "spec"), "agent_ref"), "org")],
352
465
  row: (json, orgLabel) => [
353
466
  str(obj(json, "metadata"), "id"),
354
467
  str(obj(json, "status"), "state") || "-",
355
468
  sessionAgent(json, orgLabel),
356
- truncate(str(obj(json, "spec"), "subject") || "-", 50),
469
+ oneLine(str(obj(json, "spec"), "subject")) || "-",
357
470
  date(str(obj(json, "metadata"), "created_at")),
358
471
  ],
359
472
  };
@@ -467,18 +580,47 @@ const ROUTINE_TABLE: TableShape = {
467
580
  },
468
581
  };
469
582
 
583
+ /** How many entries a protojson list field holds. */
584
+ function count(json: JsonObject, key: string): number {
585
+ const value = json[key];
586
+ return Array.isArray(value) ? value.length : 0;
587
+ }
588
+
589
+ // NETWORK is the enum's JSON name (`limited`, `unrestricted`); HOSTS and
590
+ // PACKAGES are counts, the lists themselves are `get`'s.
591
+ const ENVIRONMENT_TABLE: TableShape = {
592
+ resourceName: "environments",
593
+ headers: ["ID", "SLUG", "NETWORK", "HOSTS", "PACKAGES"],
594
+ row: (json) => {
595
+ const metadata = obj(json, "metadata");
596
+ const spec = obj(json, "spec");
597
+ const networking = obj(spec, "networking");
598
+ const packages = obj(spec, "packages");
599
+ const installed = ["apt", "cargo", "gem", "go", "npm", "pip"].reduce((sum, manager) => sum + count(packages, manager), 0);
600
+ return [
601
+ str(metadata, "id"),
602
+ str(metadata, "slug"),
603
+ str(networking, "type") === "limited" ? "limited" : "unrestricted",
604
+ String(count(networking, "allowed_hosts")),
605
+ String(installed),
606
+ ];
607
+ },
608
+ };
609
+
470
610
  // Entry names only: a vault read never carries a value, and the table shows
471
- // how many secrets and logins a vault holds, not what they are.
611
+ // how many secrets and logins a vault holds, not what they are. NAME is the
612
+ // vault's display name; its SLUG is what a command takes.
472
613
  const VAULT_TABLE: TableShape = {
473
614
  resourceName: "vaults",
474
615
  headers: ["ID", "SLUG", "NAME", "OWNER", "SECRETS", "LOGINS"],
616
+ shrink: ["NAME"],
475
617
  row: (json) => {
476
618
  const metadata = obj(json, "metadata");
477
619
  const spec = obj(json, "spec");
478
620
  return [
479
621
  str(metadata, "id"),
480
622
  str(metadata, "slug"),
481
- str(metadata, "name"),
623
+ oneLine(str(metadata, "name")),
482
624
  str(spec, "person") !== "" ? "you" : "organization",
483
625
  String(Object.keys(obj(spec, "secrets")).length),
484
626
  String(Object.keys(obj(spec, "connections")).length),
@@ -510,25 +652,29 @@ function providerOf(spec: JsonObject): string {
510
652
  return PROVIDER_KEYS.find((key) => key in spec) ?? "-";
511
653
  }
512
654
 
513
- const ORG_TABLE: TableShape = {
655
+ // An organization's NAME is its display name; the SLUG and ID name it in a command.
656
+ export const ORG_TABLE: TableShape = {
514
657
  resourceName: "organizations",
515
658
  headers: ["NAME", "SLUG", "ID"],
659
+ shrink: ["NAME"],
516
660
  row: (json) => {
517
661
  const metadata = obj(json, "metadata");
518
- return [str(metadata, "name"), str(metadata, "slug"), str(metadata, "id")];
662
+ return [oneLine(str(metadata, "name")), str(metadata, "slug"), str(metadata, "id")];
519
663
  },
520
664
  };
521
665
 
666
+ // A key's NAME is a note its maker wrote; the key is named by its ID.
522
667
  const APIKEY_TABLE: TableShape = {
523
668
  resourceName: "API keys",
524
669
  headers: ["ID", "NAME", "FINGERPRINT", "EXPIRES"],
670
+ shrink: ["NAME"],
525
671
  row: (json) => {
526
672
  const metadata = obj(json, "metadata");
527
673
  const spec = obj(json, "spec");
528
674
  const fingerprint = str(spec, "fingerprint");
529
675
  return [
530
676
  str(metadata, "id"),
531
- str(metadata, "name") || "-",
677
+ oneLine(str(metadata, "name")) || "-",
532
678
  fingerprint === "" ? "" : `***${fingerprint}`,
533
679
  apiKeyExpiry(spec),
534
680
  ];
@@ -541,12 +687,10 @@ function apiKeyExpiry(spec: JsonObject): string {
541
687
  return expiresAt === "" ? "Never" : date(expiresAt);
542
688
  }
543
689
 
544
- function truncate(text: string, max: number): string {
545
- const normalized = text.replace(/\s+/g, " ").trim();
546
- return normalized.length > max
547
- ? `${normalized.slice(0, max - 1)}…`
548
- : normalized;
549
- }
690
+ // Free text as one table cell: every run of whitespace or control
691
+ // characters, a line break included, becomes one space (output/printable.ts).
692
+ // The table cuts it to the terminal, not this.
693
+ const oneLine = printableCell;
550
694
 
551
695
  function date(timestamp: string): string {
552
696
  return timestamp === "" ? "-" : timestamp.slice(0, 10);
@@ -465,6 +465,8 @@ export function renderPushOutcome(
465
465
  // Only the kinds the plugin holds are named, as the console's
466
466
  // `summariseInstall` names them: most catalogue plugins carry tools
467
467
  // alone, and "0 skills, 1 MCP server, 0 agents" reads as three facts.
468
+ // Hooks are named without a count, as there; the Installed block counts
469
+ // them per event.
468
470
  const named = (
469
471
  [
470
472
  [skills.length, "skill"],
@@ -474,6 +476,7 @@ export function renderPushOutcome(
474
476
  )
475
477
  .filter(([n]) => n > 0)
476
478
  .map(([n, noun]) => count(n, noun));
479
+ if ((status?.hooks?.groups.length ?? 0) > 0) named.push("hooks");
477
480
  const summary = named.length === 0 ? "nothing installed" : named.join(", ");
478
481
  const headline = `Installed plugin '${pluginName(plugin)}' (${summary})`;
479
482
  const result =