@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
package/src/auth/token.ts CHANGED
@@ -1,13 +1,29 @@
1
1
  // Auth0 token operations: exchange an authorization code for tokens, refresh an
2
- // expired access token, and expose a token provider that refreshes silently.
2
+ // expired access token, and expose token providers that refresh silently.
3
+ //
4
+ // Two providers share one refresh path (freshCloudToken), so they cannot drift:
5
+ // - createRefreshingTokenProvider serves a short-lived command. It reads the
6
+ // ACTIVE backend from the config the command loaded, and concurrent calls
7
+ // (a command's Promise.all of RPCs) share one refresh.
8
+ // - createBackendTokenSource serves a long-running process (`stigmer
9
+ // mcp-server`). Its server dials one fixed address, so the source is pinned
10
+ // to the backend it started with and never follows `config backend use`
11
+ // elsewhere; it re-reads the file once per token lifetime so it sees a
12
+ // refresh or a login another command wrote.
13
+ //
14
+ // A refresh is persisted by patching only that entry's token fields into the
15
+ // file as it is on disk now, never by saving a config loaded earlier, so it
16
+ // cannot undo a `backend use` or a login another command saved meanwhile.
3
17
 
4
- import type { TokenProvider } from "@stigmer/client";
18
+ import { createTokenCache, type TokenCache, type TokenProvider } from "@stigmer/client";
5
19
  import {
6
20
  type Config,
7
21
  type NamedBackendConfig,
8
22
  activeBackend,
23
+ load,
9
24
  save,
10
25
  } from "../config/index.js";
26
+ import { DEFAULT_CLOUD_ENDPOINT } from "../config/resolve.js";
11
27
  import { CliExitError, ExitCode } from "../errors/index.js";
12
28
  import { CLIENT_ID, callbackUrl, TOKEN_URL } from "./auth0.js";
13
29
 
@@ -24,6 +40,12 @@ export interface TokenSet {
24
40
  // races the token going stale.
25
41
  const EXPIRY_SKEW_MS = 60_000;
26
42
 
43
+ // How long a long-running source keeps a token stored with no usable expiry (a
44
+ // pasted token) before reading the file again, so a later `stigmer auth login`
45
+ // is picked up without a restart. Shorter reads the disk more often; longer
46
+ // picks up a new sign-in later.
47
+ const NO_EXPIRY_REREAD_MS = 5 * 60_000;
48
+
27
49
  interface Auth0TokenResponse {
28
50
  access_token?: string;
29
51
  refresh_token?: string;
@@ -68,58 +90,146 @@ export async function refreshAccessToken(
68
90
  * expired server-side); local returns null (no auth).
69
91
  * 3. A cloud backend's non-expired access token is returned as-is.
70
92
  * 4. An expired token with a refresh token is refreshed; the new token,
71
- * rotated refresh token, and expiry are persisted INTO THE ENTRY, then
72
- * returned.
93
+ * rotated refresh token, and expiry are set INTO THE ENTRY and patched
94
+ * into that entry on disk, then returned. Calls made while a refresh is
95
+ * in flight share it, so a burst of RPCs makes one refresh request.
73
96
  * 5. Otherwise the (possibly stale) token or null is returned, letting the
74
97
  * server reject it so the error maps to a clear "please log in" exit.
75
98
  *
76
99
  * Closes over `config` so a refresh updates the same object the rest of the
77
- * command sees, and writes it through to disk.
100
+ * command sees.
78
101
  */
79
102
  export function createRefreshingTokenProvider(config: Config): TokenProvider {
103
+ let inFlight:
104
+ | { readonly entry: NamedBackendConfig; readonly token: Promise<string | null> }
105
+ | undefined;
80
106
  return async (): Promise<string | null> => {
81
107
  const envKey = process.env.STIGMER_API_KEY;
82
108
  if (envKey !== undefined && envKey !== "") return envKey;
83
109
 
84
- const { entry } = activeBackend(config);
110
+ const { name, entry } = activeBackend(config);
85
111
  if (entry === undefined) return null;
86
112
  if (entry.type === "selfhost") return entry.api_key ?? null;
87
113
 
88
- if (entry.token === undefined || entry.token === "") {
89
- return entry.refresh_token
90
- ? refreshAndPersist(config, entry, entry.refresh_token)
91
- : null;
114
+ if (inFlight?.entry !== entry) {
115
+ const endpoint = cloudEndpoint(entry);
116
+ const token = freshCloudToken(entry, (next) =>
117
+ persistRefreshedTokens(name, endpoint, next),
118
+ ).then((fresh) => fresh?.accessToken ?? null);
119
+ inFlight = { entry, token };
120
+ const settled = (): void => {
121
+ if (inFlight?.token === token) inFlight = undefined;
122
+ };
123
+ token.then(settled, settled);
92
124
  }
93
- if (!isExpired(entry.token_expiry)) return entry.token;
94
- if (entry.refresh_token === undefined || entry.refresh_token === "")
95
- return entry.token;
96
- return refreshAndPersist(config, entry, entry.refresh_token);
125
+ return inFlight.token;
97
126
  };
98
127
  }
99
128
 
100
- async function refreshAndPersist(
101
- config: Config,
129
+ /**
130
+ * The token source for a long-running process whose server dials one fixed
131
+ * address: the cloud backend `backendName` at `endpoint`, as they were when
132
+ * it started. Built on the SDK's token cache, so a token is kept until a
133
+ * minute before it expires, concurrent calls share one fetch, and a failed
134
+ * fetch is not kept. Each fetch:
135
+ * 1. reads the config file as it is now, so it sees a refresh, a rotated
136
+ * refresh token or a login another command saved;
137
+ * 2. answers null (no credential, never another backend's) when the entry
138
+ * is gone, is no longer a cloud backend, or now points elsewhere;
139
+ * 3. otherwise refreshes the token when it is expired, persisting it as the
140
+ * short-lived provider does;
141
+ * 4. keeps a token with no usable expiry for {@link NO_EXPIRY_REREAD_MS}.
142
+ * A dead sign-in (the refresh refused) answers the stale token with its past
143
+ * expiry, so the next call reads the file again and a `stigmer auth login` in
144
+ * another terminal takes effect on it.
145
+ *
146
+ * `STIGMER_API_KEY` is not consulted: a given key is used instead of this
147
+ * source, never through it.
148
+ */
149
+ export function createBackendTokenSource(backendName: string, endpoint: string): TokenCache {
150
+ return createTokenCache(async () => {
151
+ const entry = load().backends?.[backendName];
152
+ if (entry === undefined || entry.type !== "cloud" || cloudEndpoint(entry) !== endpoint) {
153
+ return null;
154
+ }
155
+ const fresh = await freshCloudToken(entry, (next) =>
156
+ persistRefreshedTokens(backendName, endpoint, next),
157
+ );
158
+ if (fresh === null) return null;
159
+ const expiresAtMs = Date.parse(fresh.expiresAt ?? "");
160
+ return {
161
+ accessToken: fresh.accessToken,
162
+ expiresAt: Number.isNaN(expiresAtMs) ? Date.now() + NO_EXPIRY_REREAD_MS : expiresAtMs,
163
+ };
164
+ });
165
+ }
166
+
167
+ /** The address a cloud entry is dialed at: its own, else Stigmer Cloud's. */
168
+ function cloudEndpoint(entry: NamedBackendConfig): string {
169
+ return entry.endpoint !== undefined && entry.endpoint !== ""
170
+ ? entry.endpoint
171
+ : DEFAULT_CLOUD_ENDPOINT;
172
+ }
173
+
174
+ /** A cloud entry's access token and its stored expiry, if any. */
175
+ interface CloudToken {
176
+ readonly accessToken: string;
177
+ readonly expiresAt: string | undefined;
178
+ }
179
+
180
+ /**
181
+ * The cloud entry's access token, refreshed first when it is missing or
182
+ * expired and a refresh token is stored. A refresh sets the new token set into
183
+ * `entry` and hands it to `persist`. A refused refresh (a revoked or expired
184
+ * sign-in) answers the current token, if any: the server rejects it and the
185
+ * person is told to sign in again.
186
+ */
187
+ async function freshCloudToken(
102
188
  entry: NamedBackendConfig,
103
- refreshToken: string,
104
- ): Promise<string | null> {
189
+ persist: (next: TokenSet) => void,
190
+ ): Promise<CloudToken | null> {
191
+ const current =
192
+ entry.token === undefined || entry.token === ""
193
+ ? null
194
+ : { accessToken: entry.token, expiresAt: entry.token_expiry };
195
+ if (current !== null && !isExpired(entry.token_expiry)) return current;
196
+ if (entry.refresh_token === undefined || entry.refresh_token === "") return current;
197
+
105
198
  let next: TokenSet;
106
199
  try {
107
- next = await refreshAccessToken(refreshToken);
200
+ next = await refreshAccessToken(entry.refresh_token);
108
201
  } catch {
109
- // Refresh failed (revoked/expired refresh token). Fall back to the current
110
- // token if any; the server will reject it and the user is prompted to log in.
111
- return entry.token ?? null;
202
+ return current;
112
203
  }
204
+ applyTokenSet(entry, next);
205
+ persist(next);
206
+ return { accessToken: next.accessToken, expiresAt: next.expiresAt };
207
+ }
208
+
209
+ /**
210
+ * Write a refreshed token set into the file as it is on disk now, patching
211
+ * only the token fields of `backendName`, and only while that entry is still
212
+ * the cloud backend at `endpoint`: a backend removed or re-pointed meanwhile
213
+ * is left as the person left it.
214
+ */
215
+ function persistRefreshedTokens(backendName: string, endpoint: string, next: TokenSet): void {
216
+ const config = load();
217
+ const entry = config.backends?.[backendName];
218
+ if (entry === undefined || entry.type !== "cloud" || cloudEndpoint(entry) !== endpoint) return;
219
+ applyTokenSet(entry, next);
220
+ save(config);
221
+ }
222
+
223
+ function applyTokenSet(entry: NamedBackendConfig, next: TokenSet): void {
113
224
  entry.token = next.accessToken;
114
225
  if (next.refreshToken !== undefined) entry.refresh_token = next.refreshToken;
115
226
  entry.token_expiry = next.expiresAt;
116
- save(config);
117
- return next.accessToken;
118
227
  }
119
228
 
120
229
  function isExpired(expiresAt: string | undefined): boolean {
121
- // Legacy tokens persisted without an expiry are assumed valid; the server is
122
- // the ultimate authority and a 401 triggers re-login.
230
+ // A token stored without an expiry (a pasted token or key carries none) is
231
+ // assumed valid; the server is the ultimate authority and a 401 triggers
232
+ // re-login.
123
233
  if (expiresAt === undefined || expiresAt === "") return false;
124
234
  const expiryMs = Date.parse(expiresAt);
125
235
  if (Number.isNaN(expiryMs)) return false;
@@ -1,6 +1,6 @@
1
1
  // Backend client façade.
2
2
  //
3
- // Builds a single transport (via the SDK's createNodeTransport + the Go-parity
3
+ // Builds a single transport (via the SDK's createNodeTransport +
4
4
  // normalizeEndpoint) and exposes:
5
5
  // - `stigmer`: the high-level typed client, used by read verbs.
6
6
  // - `transport` + `controller(service)`: the raw Connect layer, so write
@@ -17,7 +17,9 @@
17
17
  //
18
18
  // This module holds no business logic: backend selection, token precedence, and
19
19
  // endpoint shape are delegated to the config layer; org resolution and verb
20
- // dispatch live with the commands and the registry.
20
+ // dispatch live with the commands and the registry. It records the address
21
+ // it dials, and where that came from, in runtime.ts, so an error names the
22
+ // address actually tried (errors/classify.ts).
21
23
 
22
24
  import type { DescService } from "@bufbuild/protobuf";
23
25
  import { type Client, createClient, type Transport } from "@connectrpc/connect";
@@ -32,10 +34,11 @@ import { createNodeTransport, normalizeEndpoint } from "@stigmer/client/node";
32
34
  import {
33
35
  type Config,
34
36
  load,
35
- resolveEndpoint,
37
+ resolveServerAddress,
36
38
  resolveToken,
37
39
  } from "../config/index.js";
38
- import { CliExitError, ExitCode } from "../errors/index.js";
40
+ import { cannotConnect, CliExitError, ExitCode } from "../errors/index.js";
41
+ import { type ServerAddress, setServerAddress } from "../runtime.js";
39
42
 
40
43
  /** The composed backend client returned by {@link createBackendClient}. */
41
44
  export interface BackendClient {
@@ -82,7 +85,9 @@ export function createBackendClient(
82
85
  options: BackendClientOptions = {},
83
86
  ): BackendClient {
84
87
  const config = options.config ?? load();
85
- const baseUrl = normalizeEndpoint(resolveEndpoint(config));
88
+ const address = resolveServerAddress(config);
89
+ setServerAddress(address);
90
+ const baseUrl = normalizeEndpoint(address.address);
86
91
 
87
92
  // Dynamic provider: re-reads env/config on every request so a token refreshed
88
93
  // mid-session is picked up. STIGMER_API_KEY > config token precedence lives in
@@ -118,7 +123,7 @@ export function createBackendClient(
118
123
  return createClient(service, transport);
119
124
  },
120
125
  async connect(timeoutMs = DEFAULT_CONNECT_TIMEOUT_MS) {
121
- await withTimeout(probeServerInfo(), timeoutMs);
126
+ await withTimeout(probeServerInfo(), timeoutMs, address);
122
127
  },
123
128
  serverInfo: probeServerInfo,
124
129
  async isResourceAvailable(kind) {
@@ -132,22 +137,24 @@ export function createBackendClient(
132
137
 
133
138
  // Soft timeout: races the RPC against a timer. It cannot cancel the underlying
134
139
  // request, but the CLI exits immediately after, so the dangling call is moot.
140
+ // A server that does not answer in time could not be reached: the timeout
141
+ // says so in the same words, with the address and how long it waited.
135
142
  async function withTimeout<T>(
136
143
  promise: Promise<T>,
137
144
  timeoutMs: number,
145
+ address: ServerAddress,
138
146
  ): Promise<T> {
139
147
  let timer: NodeJS.Timeout | undefined;
140
148
  const timeout = new Promise<never>((_, reject) => {
141
- timer = setTimeout(
142
- () =>
143
- reject(
144
- new CliExitError(
145
- "Timed out connecting to the Stigmer server",
146
- ExitCode.Connection,
147
- ),
148
- ),
149
- timeoutMs,
150
- );
149
+ timer = setTimeout(() => {
150
+ const failure = cannotConnect(address);
151
+ reject(
152
+ new CliExitError(failure.message, ExitCode.Connection, [
153
+ `It did not answer within ${timeoutMs / 1000} seconds.`,
154
+ ...failure.hints,
155
+ ]),
156
+ );
157
+ }, timeoutMs);
151
158
  });
152
159
  try {
153
160
  return await Promise.race([promise, timeout]);
@@ -0,0 +1,152 @@
1
+ // Reads the commander command tree the CLI builds (buildProgram): which
2
+ // commands a person sees, where each sits, what arguments and options it
3
+ // takes. One walker serves every reader of the tree, the docs generator
4
+ // (scripts/gen-cli-docs.ts) and the tests that hold rules over every
5
+ // command, so a rule and the reference pages can never disagree about which
6
+ // commands exist.
7
+ //
8
+ // Commander (v15) exposes neither a command's hidden flag, nor whether a
9
+ // command has an action of its own, nor, before v11, its positional
10
+ // arguments publicly; the three readers below (`isHidden`, `hasOwnAction`,
11
+ // `registeredArguments`) are the only places that reach past its public
12
+ // surface.
13
+
14
+ import type { Command } from "commander";
15
+
16
+ /**
17
+ * Whether a command is hidden from help and the docs. Commander has no
18
+ * public getter; the internal `_hidden` flag (set via
19
+ * `.command(name, { hidden: true })`) is the only signal.
20
+ */
21
+ export function isHidden(cmd: Command): boolean {
22
+ return (cmd as unknown as { _hidden?: boolean })._hidden === true;
23
+ }
24
+
25
+ /**
26
+ * Whether a command runs an action of its own (`stigmer up`), rather than only
27
+ * dispatching to its subcommands (`stigmer config`). Commander keeps the
28
+ * handler in the internal `_actionHandler`, null until `.action()` is called.
29
+ */
30
+ export function hasOwnAction(cmd: Command): boolean {
31
+ const handler = (cmd as unknown as { _actionHandler?: unknown })._actionHandler;
32
+ return handler !== undefined && handler !== null;
33
+ }
34
+
35
+ /** A positional argument as commander registers it. */
36
+ export interface RegisteredArgument {
37
+ name(): string;
38
+ required: boolean;
39
+ variadic: boolean;
40
+ }
41
+
42
+ /**
43
+ * A command's positional arguments. They were renamed from `_args` to
44
+ * `registeredArguments` in commander v11; the public field is read first.
45
+ */
46
+ export function registeredArguments(cmd: Command): RegisteredArgument[] {
47
+ const c = cmd as unknown as { registeredArguments?: RegisteredArgument[]; _args?: RegisteredArgument[] };
48
+ return c.registeredArguments ?? c._args ?? [];
49
+ }
50
+
51
+ /** A command's full path from the root, as typed: `stigmer agent versions`. */
52
+ export function commandPath(cmd: Command): string {
53
+ const parts: string[] = [];
54
+ let current: Command | null = cmd;
55
+ while (current) {
56
+ parts.unshift(current.name());
57
+ current = current.parent;
58
+ }
59
+ return parts.join(" ");
60
+ }
61
+
62
+ /** The root's commands a person sees, in registration order: neither hidden nor commander's own `help`. */
63
+ export function documentedCommands(program: Command): Command[] {
64
+ return program.commands.filter((cmd) => !isHidden(cmd) && cmd.name() !== "help");
65
+ }
66
+
67
+ /** A command's subcommands a person sees, by name. */
68
+ export function visibleSubcommands(cmd: Command): Command[] {
69
+ return cmd.commands
70
+ .filter((sub) => !isHidden(sub) && sub.name() !== "help")
71
+ .sort((a, b) => a.name().localeCompare(b.name()));
72
+ }
73
+
74
+ /**
75
+ * Every command a person runs: each visible command with no visible
76
+ * subcommands of its own, depth first, by path. A group (`stigmer agent`)
77
+ * that only dispatches is not one; its leaves are.
78
+ */
79
+ export function leafCommands(program: Command): Command[] {
80
+ const leaves: Command[] = [];
81
+ const visit = (cmd: Command): void => {
82
+ const subs = visibleSubcommands(cmd);
83
+ if (subs.length === 0) leaves.push(cmd);
84
+ for (const sub of subs) visit(sub);
85
+ };
86
+ for (const cmd of documentedCommands(program)) visit(cmd);
87
+ return leaves.sort((a, b) => commandPath(a).localeCompare(commandPath(b)));
88
+ }
89
+
90
+ /** Whether a command takes the long option `long` (`--output`) itself, not through its parent. */
91
+ export function takesOption(cmd: Command, long: string): boolean {
92
+ return cmd.options.some((option) => option.long === long);
93
+ }
94
+
95
+ /**
96
+ * Every command a person can run, depth first, by path: each leaf, and each
97
+ * group with an action of its own (`stigmer up` runs, and `stigmer up
98
+ * server` is its leaf). A rule over what a command takes walks these, so a
99
+ * runnable group is held like a leaf.
100
+ */
101
+ export function runnableCommands(program: Command): Command[] {
102
+ const runnable: Command[] = [];
103
+ const visit = (cmd: Command): void => {
104
+ const subs = visibleSubcommands(cmd);
105
+ if (subs.length === 0 || hasOwnAction(cmd)) runnable.push(cmd);
106
+ for (const sub of subs) visit(sub);
107
+ };
108
+ for (const cmd of documentedCommands(program)) visit(cmd);
109
+ return runnable.sort((a, b) => commandPath(a).localeCompare(commandPath(b)));
110
+ }
111
+
112
+ /** Every command in the tree, the root, hidden ones and commander's own `help` included, depth first. */
113
+ export function everyCommand(program: Command): Command[] {
114
+ const all: Command[] = [];
115
+ const visit = (cmd: Command): void => {
116
+ all.push(cmd);
117
+ for (const sub of cmd.commands) visit(sub);
118
+ };
119
+ visit(program);
120
+ return all;
121
+ }
122
+
123
+ /** A command's short example for its help: the line to type, and what it does in a few words. */
124
+ export interface HelpExample {
125
+ /** What the line does, lowercase, no closing period: "get an agent by slug". */
126
+ readonly say: string;
127
+ /** The line as a person types it, starting with `stigmer`. */
128
+ readonly run: string;
129
+ }
130
+
131
+ const EXAMPLES = new WeakMap<Command, readonly HelpExample[]>();
132
+
133
+ /** Declare a command's examples, printed under "Examples:" after its options. */
134
+ export function examples(cmd: Command, list: readonly HelpExample[]): Command {
135
+ EXAMPLES.set(cmd, list);
136
+ return cmd.addHelpText("after", formatExamples(list));
137
+ }
138
+
139
+ /** A command's declared examples; none when it declares none. */
140
+ export function helpExamples(cmd: Command): readonly HelpExample[] {
141
+ return EXAMPLES.get(cmd) ?? [];
142
+ }
143
+
144
+ /** The examples as help prints them: each line, then what it does beneath it. */
145
+ export function formatExamples(list: readonly HelpExample[]): string {
146
+ return ["", "Examples:", ...list.flatMap((example) => [` ${example.run}`, ` ${example.say}`])].join("\n");
147
+ }
148
+
149
+ /** The help group a top-level command sits in, without the heading's colon; "" when it names none. */
150
+ export function helpGroupOf(cmd: Command): string {
151
+ return cmd.helpGroup().replace(/:$/, "");
152
+ }
@@ -30,7 +30,7 @@ interface ListFlags extends OutputFlags {
30
30
  limit?: string;
31
31
  }
32
32
 
33
- interface ExportFlags {
33
+ interface ExportFlags extends OutputFlags {
34
34
  after?: string;
35
35
  }
36
36
 
@@ -76,11 +76,12 @@ export function registerAccessHistory(program: Command): void {
76
76
  });
77
77
  addReadFlags(listCmd);
78
78
 
79
- group
79
+ const exportCmd = group
80
80
  .command("export")
81
81
  .description("write the organization's access history as JSON Lines, oldest first, to stdout")
82
82
  .option("--after <sequence>", "start after this entry: the last sequence you already hold")
83
83
  .action(async (options: ExportFlags, command: Command) => {
84
+ refuseTableExport(options);
84
85
  const resources = await import("../../resources/access-history.js");
85
86
  const after = resources.parseAfterSequence(options.after);
86
87
  const session = await openSession(command);
@@ -96,6 +97,18 @@ export function registerAccessHistory(program: Command): void {
96
97
  },
97
98
  );
98
99
  });
100
+ exportCmd
101
+ .option("-o, --output <format>", "output format: json or ndjson (both JSON Lines, the only form an export takes)")
102
+ .option("--json", "shorthand for --output json");
103
+ }
104
+
105
+ // An export is JSON Lines in every form: `-o json` and `-o ndjson` name it,
106
+ // and any other value is refused naming those two.
107
+ function refuseTableExport(options: ExportFlags): void {
108
+ const output = options.output?.toLowerCase();
109
+ if (output !== undefined && output !== "json" && output !== "ndjson") {
110
+ throw new UsageError(`--output ${options.output} is not supported by stigmer access-history export (supported: json, ndjson)`);
111
+ }
99
112
  }
100
113
 
101
114
  function parseLimit(raw: string | undefined): number {
@@ -1,8 +1,8 @@
1
- // The run flag set `run` registers (Go's registerAgentExecFlags),
2
- // kept as its own module so a new run flag has one home and any future
1
+ // The run flag set `run` registers, kept as its own module so a new run flag has one home and any future
3
2
  // command that starts a run picks the whole set up unchanged.
4
3
 
5
4
  import type { Command } from "commander";
5
+ import { ENGINE_WORD_LIST, engineChoice } from "../resources/run/engines.js";
6
6
  import type { AgentExecFlags, HarnessFlag, RunMode, ServiceTierFlag, ThinkingFlag } from "../resources/run/prepare.js";
7
7
 
8
8
  /** Commander collector for repeatable string options. */
@@ -12,6 +12,7 @@ export const collect = (value: string, previous: string[]): string[] => [...prev
12
12
  export interface AgentExecOptions {
13
13
  message?: string;
14
14
  attach: string[];
15
+ fileId: string[];
15
16
  approveDefault?: string;
16
17
  verbose?: boolean;
17
18
  detach?: boolean;
@@ -22,6 +23,7 @@ export interface AgentExecOptions {
22
23
  /** False when `--no-my-vault` was given. */
23
24
  myVault: boolean;
24
25
  plugin: string[];
26
+ environment?: string;
25
27
  model?: string;
26
28
  autoApprove?: boolean;
27
29
  mode?: string;
@@ -34,7 +36,8 @@ export interface AgentExecOptions {
34
36
  export function addAgentExecFlags(command: Command): Command {
35
37
  return command
36
38
  .option("-m, --message <text>", "initial message/prompt for the run")
37
- .option("--attach <path>", "file or directory to attach as input (repeatable)", collect, [])
39
+ .option("--attach <path>", "a file sent with the message (at most 20), or a folder whose files the conversation keeps under .stigmer/uploads/; a file inside a --workspace folder is pointed to where it is (repeatable)", collect, [])
40
+ .option("--file-id <id>", "a File already uploaded (stigmer file upload, or the console's Library) sent with the message, counted with --attach toward its 20 (repeatable)", collect, [])
38
41
  .option("--approve-default <action>", "answer every tool call that asks, in headless mode: allow, deny, or allow-all (allow it and every waiting call of its kind for the rest of the turn); unset denies each one")
39
42
  .option("-v, --verbose", "show run IDs and phase transitions")
40
43
  .option("--detach", "start the run and return immediately without streaming")
@@ -44,12 +47,13 @@ export function addAgentExecFlags(command: Command): Command {
44
47
  .option("--vault <ref>", "a shared vault the conversation uses, by id, org/slug or slug, after your My vault, in the order given (repeatable)", collect, [])
45
48
  .option("--no-my-vault", "leave your own My vault out of the conversation: it uses only the vaults named with --vault")
46
49
  .option("--plugin <ref>", "a plugin the conversation uses, by id, org/slug or slug: its skills, agents, MCP servers and hooks join the agent's, or the assistant's with no agent (repeatable)", collect, [])
47
- .option("--model <model>", "LLM model to use (e.g. claude-sonnet-4-6); with no --harness it runs on native, so pass --harness cursor for a Cursor model; unset, the agent's default model for the engine applies")
50
+ .option("--environment <ref>", "the environment the conversation's sandbox runs in, by id, org/slug or slug: its packages and network access, in place of the agent's or the organization's default")
51
+ .option("--model <model>", `LLM model to use (e.g. claude-sonnet-4-6); with no --harness it runs on ${engineChoice("stigmer")}, so pass --harness claude for a model on ${engineChoice("claude")}; unset, the agent's default model for the harness applies`)
48
52
  .option("--auto-approve", "automatically approve all tool executions")
49
53
  .option("--mode <mode>", 'interaction mode: "agent" (default) or "plan" (read-only)')
50
54
  .option("--service-tier <tier>", 'model service tier: "standard" or "fast" (the model, from --model or the agent\'s defaults, must have a fast tier; billed at fast rates); unset keeps the agent\'s default')
51
55
  .option("--thinking <mode>", 'extended reasoning: "disabled" or "enabled" (the model, from --model or the agent\'s defaults, must be thinking-capable; billed at base rates, uses more output tokens); unset keeps the agent\'s default')
52
- .option("--harness <harness>", 'execution harness for the new session: "native" or "cursor"; unset, the agent\'s engine, else your account default, else native');
56
+ .option("--harness <harness>", `the harness for the new session: ${ENGINE_WORD_LIST}; unset, the agent's harness, else your account default, else ${engineChoice("stigmer")}`);
53
57
  }
54
58
 
55
59
  /** Map parsed commander options onto the shared {@link AgentExecFlags} shape. */
@@ -57,6 +61,7 @@ export function toAgentExecFlags(options: AgentExecOptions): AgentExecFlags {
57
61
  return {
58
62
  message: options.message ?? "",
59
63
  attach: options.attach,
64
+ fileIds: options.fileId,
60
65
  approveDefault: options.approveDefault ?? "",
61
66
  verbose: options.verbose === true,
62
67
  detach: options.detach === true,
@@ -66,6 +71,7 @@ export function toAgentExecFlags(options: AgentExecOptions): AgentExecFlags {
66
71
  vault: options.vault,
67
72
  myVault: options.myVault,
68
73
  plugin: options.plugin,
74
+ environment: options.environment ?? "",
69
75
  model: options.model ?? "",
70
76
  autoApprove: options.autoApprove === true,
71
77
  mode: (options.mode ?? "") as RunMode,
@@ -1,6 +1,5 @@
1
1
  // Parse human expiration durations like "30d", "6h", "1y" into milliseconds.
2
- // Ported from the Go CLI's ParseExpirationDuration; invalid input is a usage
3
- // error (exit 2). Units: m (minutes), h (hours), d (days), y (years).
2
+ // Invalid input is a usage error (exit 2). Units: m (minutes), h (hours), d (days), y (years).
4
3
 
5
4
  import { UsageError } from "../../errors/index.js";
6
5
 
@@ -174,10 +174,9 @@ async function runFingerprint(
174
174
  rawKey: string,
175
175
  options: OutputFlags,
176
176
  ): Promise<void> {
177
- // Base64URL without padding — the server's storage encoding (the Java
178
- // ApiKeyHasher and the TS keymaterial module agree). This was once hex,
179
- // which meant the computed hash could never match a stored key_hash and
180
- // the lookup below always answered NotFound.
177
+ // Base64URL without padding — the server's storage encoding (its
178
+ // keymaterial module): a hash in any other encoding never matches a stored
179
+ // key_hash, and the lookup below would answer NotFound.
181
180
  const hash = createHash("sha256").update(rawKey).digest("base64url");
182
181
 
183
182
  const { connectBackend } = await import("../../backend.js");
@@ -7,15 +7,11 @@
7
7
  // two verbs are one code path
8
8
  //
9
9
  // A bare `stigmer apply` in a directory that is neither prints what the
10
- // command can do. A `stigmer.yaml` there is the retired Project format, and
11
- // the guidance says so: a folder of resources that belong together is a
12
- // plugin.
10
+ // command can do.
13
11
  //
14
12
  // Resources marshal strictly from YAML to full protos and apply through the raw
15
13
  // command controllers (preserving metadata.id so updates aren't misrouted as
16
14
  // creates). Heavy modules are lazy-imported so `--help` stays fast.
17
- import { existsSync } from "node:fs";
18
- import { join } from "node:path";
19
15
  import type { Command } from "commander";
20
16
  import { ensureAuthenticated, resolveOrganization } from "../config/index.js";
21
17
  import {
@@ -26,12 +22,6 @@ import {
26
22
  } from "../output/index.js";
27
23
  import { addResultFlags, globalOrg, resultFormat } from "./shared.js";
28
24
 
29
- /**
30
- * The manifest file the retired Project format kept at a directory's root.
31
- * Read only to recognise an old repository and say what happened to it.
32
- */
33
- const RETIRED_PROJECT_FILE = "stigmer.yaml";
34
-
35
25
  interface ApplyFlags extends OutputFlags {
36
26
  file?: string;
37
27
  dryRun?: boolean;
@@ -55,8 +45,7 @@ async function runApply(options: ApplyFlags, command: Command): Promise<void> {
55
45
 
56
46
  // A plugin manifest at the given directory's root selects the plugin
57
47
  // track before any YAML scan: a repository holding both is applied as a
58
- // plugin, and its `ai.stigmer/*.yaml` documents are the plugin's, not
59
- // loose resources.
48
+ // plugin, and its YAML documents are the plugin's, not loose resources.
60
49
  const target =
61
50
  options.file !== undefined && options.file !== ""
62
51
  ? options.file
@@ -169,8 +158,7 @@ async function runFileApply(
169
158
  }
170
159
 
171
160
  // What a bare `stigmer apply` says when the target holds no plugin manifest:
172
- // the two things the command does, and, when a `stigmer.yaml` sits there,
173
- // what that file was and where its resources go now.
161
+ // the things the command does.
174
162
  function buildGuidance(target: string): CommandResult {
175
163
  const result = CommandResult.warning(`No plugin manifest in ${target}`);
176
164
  result
@@ -179,13 +167,6 @@ function buildGuidance(target: string): CommandResult {
179
167
  .item("stigmer apply -f <dir> apply every YAML file in a directory")
180
168
  .item("stigmer push skill <dir> publish a skill folder")
181
169
  .item("stigmer push plugin <dir> install a folder of resources as one plugin");
182
- if (existsSync(join(target, RETIRED_PROJECT_FILE))) {
183
- result
184
- .addSection(`About the ${RETIRED_PROJECT_FILE} here`)
185
- .item(
186
- "It is the Project format, which Stigmer no longer has. A folder of resources that belong together is a plugin: run `stigmer push plugin <dir>`, or apply each resource file with `stigmer apply -f`.",
187
- );
188
- }
189
170
  return result;
190
171
  }
191
172