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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (760) hide show
  1. package/README.md +5 -4
  2. package/auth/auth0.js +1 -1
  3. package/auth/auth0.js.map +1 -1
  4. package/auth/token.d.ts +26 -4
  5. package/auth/token.d.ts.map +1 -1
  6. package/auth/token.js +120 -24
  7. package/auth/token.js.map +1 -1
  8. package/client/client.d.ts.map +1 -1
  9. package/client/client.js +21 -8
  10. package/client/client.js.map +1 -1
  11. package/command-tree.d.ts +63 -0
  12. package/command-tree.d.ts.map +1 -0
  13. package/command-tree.js +128 -0
  14. package/command-tree.js.map +1 -0
  15. package/commands/access-history/index.d.ts.map +1 -1
  16. package/commands/access-history/index.js +13 -1
  17. package/commands/access-history/index.js.map +1 -1
  18. package/commands/agent-exec-flags.d.ts +2 -0
  19. package/commands/agent-exec-flags.d.ts.map +1 -1
  20. package/commands/agent-exec-flags.js +9 -5
  21. package/commands/agent-exec-flags.js.map +1 -1
  22. package/commands/apikey/duration.d.ts.map +1 -1
  23. package/commands/apikey/duration.js +1 -2
  24. package/commands/apikey/duration.js.map +1 -1
  25. package/commands/apikey/index.d.ts.map +1 -1
  26. package/commands/apikey/index.js +3 -4
  27. package/commands/apikey/index.js.map +1 -1
  28. package/commands/apply.d.ts.map +1 -1
  29. package/commands/apply.js +2 -32
  30. package/commands/apply.js.map +1 -1
  31. package/commands/auth/index.d.ts.map +1 -1
  32. package/commands/auth/index.js +7 -5
  33. package/commands/auth/index.js.map +1 -1
  34. package/commands/auth/whoami.js +1 -1
  35. package/commands/config/index.js +3 -3
  36. package/commands/config/kv.d.ts.map +1 -1
  37. package/commands/config/kv.js +18 -14
  38. package/commands/config/kv.js.map +1 -1
  39. package/commands/connect.d.ts.map +1 -1
  40. package/commands/connect.js +18 -2
  41. package/commands/connect.js.map +1 -1
  42. package/commands/download.d.ts.map +1 -1
  43. package/commands/download.js +81 -54
  44. package/commands/download.js.map +1 -1
  45. package/commands/eval.d.ts.map +1 -1
  46. package/commands/eval.js +17 -19
  47. package/commands/eval.js.map +1 -1
  48. package/commands/file.d.ts +3 -0
  49. package/commands/file.d.ts.map +1 -0
  50. package/commands/file.js +64 -0
  51. package/commands/file.js.map +1 -0
  52. package/commands/get.d.ts.map +1 -1
  53. package/commands/get.js +20 -13
  54. package/commands/get.js.map +1 -1
  55. package/commands/help.d.ts +15 -0
  56. package/commands/help.d.ts.map +1 -0
  57. package/commands/help.js +175 -0
  58. package/commands/help.js.map +1 -0
  59. package/commands/internal-daemon.d.ts.map +1 -1
  60. package/commands/internal-daemon.js +9 -2
  61. package/commands/internal-daemon.js.map +1 -1
  62. package/commands/list.d.ts.map +1 -1
  63. package/commands/list.js +22 -1
  64. package/commands/list.js.map +1 -1
  65. package/commands/logs.js +1 -1
  66. package/commands/logs.js.map +1 -1
  67. package/commands/mcp-server.d.ts +16 -6
  68. package/commands/mcp-server.d.ts.map +1 -1
  69. package/commands/mcp-server.js +51 -26
  70. package/commands/mcp-server.js.map +1 -1
  71. package/commands/provider-key/index.d.ts +3 -0
  72. package/commands/provider-key/index.d.ts.map +1 -0
  73. package/commands/provider-key/index.js +156 -0
  74. package/commands/provider-key/index.js.map +1 -0
  75. package/commands/push.js +8 -8
  76. package/commands/push.js.map +1 -1
  77. package/commands/resume.d.ts.map +1 -1
  78. package/commands/resume.js +17 -11
  79. package/commands/resume.js.map +1 -1
  80. package/commands/routine.d.ts.map +1 -1
  81. package/commands/routine.js +42 -3
  82. package/commands/routine.js.map +1 -1
  83. package/commands/run.d.ts.map +1 -1
  84. package/commands/run.js +34 -15
  85. package/commands/run.js.map +1 -1
  86. package/commands/runs/approve.d.ts.map +1 -1
  87. package/commands/runs/approve.js +10 -2
  88. package/commands/runs/approve.js.map +1 -1
  89. package/commands/runs/control.d.ts.map +1 -1
  90. package/commands/runs/control.js +24 -16
  91. package/commands/runs/control.js.map +1 -1
  92. package/commands/runs/index.d.ts.map +1 -1
  93. package/commands/runs/index.js +1 -2
  94. package/commands/runs/index.js.map +1 -1
  95. package/commands/runs/logs.d.ts.map +1 -1
  96. package/commands/runs/logs.js +7 -4
  97. package/commands/runs/logs.js.map +1 -1
  98. package/commands/runs/to-eval-case.d.ts.map +1 -1
  99. package/commands/runs/to-eval-case.js +13 -4
  100. package/commands/runs/to-eval-case.js.map +1 -1
  101. package/commands/runs/trace.js +1 -1
  102. package/commands/runs/trace.js.map +1 -1
  103. package/commands/search.js +2 -3
  104. package/commands/search.js.map +1 -1
  105. package/commands/service-account/index.d.ts.map +1 -1
  106. package/commands/service-account/index.js +4 -2
  107. package/commands/service-account/index.js.map +1 -1
  108. package/commands/session-help.d.ts +5 -0
  109. package/commands/session-help.d.ts.map +1 -0
  110. package/commands/session-help.js +38 -0
  111. package/commands/session-help.js.map +1 -0
  112. package/commands/setup.js +5 -5
  113. package/commands/setup.js.map +1 -1
  114. package/commands/shared.d.ts +10 -2
  115. package/commands/shared.d.ts.map +1 -1
  116. package/commands/shared.js +30 -3
  117. package/commands/shared.js.map +1 -1
  118. package/commands/tag.d.ts.map +1 -1
  119. package/commands/tag.js +11 -6
  120. package/commands/tag.js.map +1 -1
  121. package/commands/up.d.ts.map +1 -1
  122. package/commands/up.js +51 -21
  123. package/commands/up.js.map +1 -1
  124. package/commands/validate.js +2 -2
  125. package/commands/validate.js.map +1 -1
  126. package/commands/version.d.ts.map +1 -1
  127. package/commands/version.js +8 -4
  128. package/commands/version.js.map +1 -1
  129. package/config/config.d.ts +5 -22
  130. package/config/config.d.ts.map +1 -1
  131. package/config/config.js +56 -47
  132. package/config/config.js.map +1 -1
  133. package/config/index.d.ts +2 -2
  134. package/config/index.d.ts.map +1 -1
  135. package/config/index.js +1 -1
  136. package/config/index.js.map +1 -1
  137. package/config/keys.js +4 -4
  138. package/config/keys.js.map +1 -1
  139. package/config/paths.js +2 -2
  140. package/config/paths.js.map +1 -1
  141. package/config/resolve.d.ts +12 -2
  142. package/config/resolve.d.ts.map +1 -1
  143. package/config/resolve.js +18 -8
  144. package/config/resolve.js.map +1 -1
  145. package/errors/classify.d.ts +20 -0
  146. package/errors/classify.d.ts.map +1 -1
  147. package/errors/classify.js +97 -21
  148. package/errors/classify.js.map +1 -1
  149. package/errors/command-line.d.ts +14 -0
  150. package/errors/command-line.d.ts.map +1 -0
  151. package/errors/command-line.js +90 -0
  152. package/errors/command-line.js.map +1 -0
  153. package/errors/handle.js +2 -2
  154. package/errors/handle.js.map +1 -1
  155. package/errors/index.d.ts +2 -2
  156. package/errors/index.d.ts.map +1 -1
  157. package/errors/index.js +12 -2
  158. package/errors/index.js.map +1 -1
  159. package/errors/usage-error.js +1 -1
  160. package/errors/usage-error.js.map +1 -1
  161. package/global-options.d.ts +35 -0
  162. package/global-options.d.ts.map +1 -0
  163. package/global-options.js +81 -0
  164. package/global-options.js.map +1 -0
  165. package/local/artifact.d.ts +1 -20
  166. package/local/artifact.d.ts.map +1 -1
  167. package/local/artifact.js +35 -117
  168. package/local/artifact.js.map +1 -1
  169. package/local/constants.d.ts +3 -9
  170. package/local/constants.d.ts.map +1 -1
  171. package/local/constants.js +3 -9
  172. package/local/constants.js.map +1 -1
  173. package/local/daemon/components.d.ts +18 -5
  174. package/local/daemon/components.d.ts.map +1 -1
  175. package/local/daemon/components.js +61 -23
  176. package/local/daemon/components.js.map +1 -1
  177. package/local/daemon/env.d.ts +1 -5
  178. package/local/daemon/env.d.ts.map +1 -1
  179. package/local/daemon/env.js +0 -2
  180. package/local/daemon/env.js.map +1 -1
  181. package/local/daemon/host.d.ts +5 -0
  182. package/local/daemon/host.d.ts.map +1 -1
  183. package/local/daemon/host.js +68 -21
  184. package/local/daemon/host.js.map +1 -1
  185. package/local/daemon/index.d.ts +2 -1
  186. package/local/daemon/index.d.ts.map +1 -1
  187. package/local/daemon/index.js +2 -1
  188. package/local/daemon/index.js.map +1 -1
  189. package/local/daemon/launch.d.ts +58 -9
  190. package/local/daemon/launch.d.ts.map +1 -1
  191. package/local/daemon/launch.js +210 -64
  192. package/local/daemon/launch.js.map +1 -1
  193. package/local/daemon/process.d.ts +11 -7
  194. package/local/daemon/process.d.ts.map +1 -1
  195. package/local/daemon/process.js +74 -38
  196. package/local/daemon/process.js.map +1 -1
  197. package/local/daemon/signals.d.ts +3 -0
  198. package/local/daemon/signals.d.ts.map +1 -0
  199. package/local/daemon/signals.js +19 -0
  200. package/local/daemon/signals.js.map +1 -0
  201. package/local/daemon/supervisor.d.ts +9 -2
  202. package/local/daemon/supervisor.d.ts.map +1 -1
  203. package/local/daemon/supervisor.js +81 -22
  204. package/local/daemon/supervisor.js.map +1 -1
  205. package/local/daemon/types.d.ts +6 -1
  206. package/local/daemon/types.d.ts.map +1 -1
  207. package/local/daemon/types.js +2 -3
  208. package/local/daemon/types.js.map +1 -1
  209. package/local/llm-config.d.ts +4 -2
  210. package/local/llm-config.d.ts.map +1 -1
  211. package/local/llm-config.js +15 -9
  212. package/local/llm-config.js.map +1 -1
  213. package/local/logs/view.d.ts.map +1 -1
  214. package/local/logs/view.js +5 -6
  215. package/local/logs/view.js.map +1 -1
  216. package/local/net/tcp.d.ts +8 -6
  217. package/local/net/tcp.d.ts.map +1 -1
  218. package/local/net/tcp.js +13 -8
  219. package/local/net/tcp.js.map +1 -1
  220. package/local/paths.d.ts +1 -1
  221. package/local/paths.d.ts.map +1 -1
  222. package/local/paths.js +2 -3
  223. package/local/paths.js.map +1 -1
  224. package/local/provider-reach.d.ts +18 -0
  225. package/local/provider-reach.d.ts.map +1 -0
  226. package/local/provider-reach.js +109 -0
  227. package/local/provider-reach.js.map +1 -0
  228. package/local/reset.d.ts.map +1 -1
  229. package/local/reset.js +1 -2
  230. package/local/reset.js.map +1 -1
  231. package/local/runtime/index.d.ts.map +1 -1
  232. package/local/runtime/index.js +1 -2
  233. package/local/runtime/index.js.map +1 -1
  234. package/local/runtime/node.js +1 -1
  235. package/local/runtime/runner.js +2 -2
  236. package/local/runtime/runner.js.map +1 -1
  237. package/local/runtime/runtimes-install.js +1 -1
  238. package/local/runtime/server.d.ts.map +1 -1
  239. package/local/runtime/server.js +2 -4
  240. package/local/runtime/server.js.map +1 -1
  241. package/local/runtime/which.js +1 -1
  242. package/local/runtime/which.js.map +1 -1
  243. package/local/setup/wizard.d.ts +1 -1
  244. package/local/setup/wizard.d.ts.map +1 -1
  245. package/local/setup/wizard.js +7 -5
  246. package/local/setup/wizard.js.map +1 -1
  247. package/local/state/health-state.d.ts +6 -0
  248. package/local/state/health-state.d.ts.map +1 -1
  249. package/local/state/health-state.js +6 -2
  250. package/local/state/health-state.js.map +1 -1
  251. package/local/state/lock.d.ts +3 -2
  252. package/local/state/lock.d.ts.map +1 -1
  253. package/local/state/lock.js +26 -28
  254. package/local/state/lock.js.map +1 -1
  255. package/local/state/log-rotation.d.ts.map +1 -1
  256. package/local/state/log-rotation.js +2 -3
  257. package/local/state/log-rotation.js.map +1 -1
  258. package/local/state/pidfile.d.ts +24 -1
  259. package/local/state/pidfile.d.ts.map +1 -1
  260. package/local/state/pidfile.js +54 -6
  261. package/local/state/pidfile.js.map +1 -1
  262. package/local/state/proc.d.ts +31 -0
  263. package/local/state/proc.d.ts.map +1 -1
  264. package/local/state/proc.js +98 -1
  265. package/local/state/proc.js.map +1 -1
  266. package/local/state/startup-config.d.ts +2 -2
  267. package/local/status.d.ts +2 -4
  268. package/local/status.d.ts.map +1 -1
  269. package/local/status.js +26 -41
  270. package/local/status.js.map +1 -1
  271. package/local/temporal/download.d.ts +9 -5
  272. package/local/temporal/download.d.ts.map +1 -1
  273. package/local/temporal/download.js +29 -8
  274. package/local/temporal/download.js.map +1 -1
  275. package/local/temporal/index.d.ts +1 -1
  276. package/local/temporal/index.d.ts.map +1 -1
  277. package/local/temporal/index.js +1 -1
  278. package/local/temporal/index.js.map +1 -1
  279. package/local/temporal/manager.d.ts +31 -5
  280. package/local/temporal/manager.d.ts.map +1 -1
  281. package/local/temporal/manager.js +74 -35
  282. package/local/temporal/manager.js.map +1 -1
  283. package/local/temporal/supervisor.js +1 -1
  284. package/local/temporal/supervisor.js.map +1 -1
  285. package/local/webconsole/index.d.ts +5 -2
  286. package/local/webconsole/index.d.ts.map +1 -1
  287. package/local/webconsole/index.js +8 -6
  288. package/local/webconsole/index.js.map +1 -1
  289. package/marketplace/github.js +1 -1
  290. package/marketplace/github.js.map +1 -1
  291. package/marketplace/official.js +1 -1
  292. package/marketplace/official.js.map +1 -1
  293. package/output/command-result.d.ts +6 -0
  294. package/output/command-result.d.ts.map +1 -1
  295. package/output/command-result.js +13 -2
  296. package/output/command-result.js.map +1 -1
  297. package/output/confirm.d.ts.map +1 -1
  298. package/output/confirm.js +2 -3
  299. package/output/confirm.js.map +1 -1
  300. package/output/format.d.ts.map +1 -1
  301. package/output/format.js +5 -6
  302. package/output/format.js.map +1 -1
  303. package/output/index.d.ts +2 -2
  304. package/output/index.d.ts.map +1 -1
  305. package/output/index.js +2 -2
  306. package/output/index.js.map +1 -1
  307. package/output/printable.d.ts +8 -0
  308. package/output/printable.d.ts.map +1 -0
  309. package/output/printable.js +24 -0
  310. package/output/printable.js.map +1 -0
  311. package/output/proto.d.ts.map +1 -1
  312. package/output/proto.js +3 -4
  313. package/output/proto.js.map +1 -1
  314. package/output/style.js +2 -2
  315. package/output/style.js.map +1 -1
  316. package/output/table.d.ts +20 -1
  317. package/output/table.d.ts.map +1 -1
  318. package/output/table.js +75 -17
  319. package/output/table.js.map +1 -1
  320. package/package.json +13 -10
  321. package/program.d.ts +0 -14
  322. package/program.d.ts.map +1 -1
  323. package/program.js +57 -119
  324. package/program.js.map +1 -1
  325. package/registry/aliases.d.ts.map +1 -1
  326. package/registry/aliases.js +0 -3
  327. package/registry/aliases.js.map +1 -1
  328. package/registry/index.d.ts +1 -1
  329. package/registry/index.d.ts.map +1 -1
  330. package/registry/index.js +1 -1
  331. package/registry/index.js.map +1 -1
  332. package/registry/metadata.d.ts +0 -15
  333. package/registry/metadata.d.ts.map +1 -1
  334. package/registry/metadata.js +16 -57
  335. package/registry/metadata.js.map +1 -1
  336. package/registry/registry.d.ts +1 -5
  337. package/registry/registry.d.ts.map +1 -1
  338. package/registry/registry.js +3 -11
  339. package/registry/registry.js.map +1 -1
  340. package/registry/verb-support.d.ts.map +1 -1
  341. package/registry/verb-support.js +28 -5
  342. package/registry/verb-support.js.map +1 -1
  343. package/resources/agent/quality.d.ts +10 -5
  344. package/resources/agent/quality.d.ts.map +1 -1
  345. package/resources/agent/quality.js +19 -9
  346. package/resources/agent/quality.js.map +1 -1
  347. package/resources/agent/resolve.js +3 -3
  348. package/resources/agent/resolve.js.map +1 -1
  349. package/resources/apply/apply.d.ts +4 -3
  350. package/resources/apply/apply.d.ts.map +1 -1
  351. package/resources/apply/apply.js +54 -41
  352. package/resources/apply/apply.js.map +1 -1
  353. package/resources/apply/handlers.d.ts.map +1 -1
  354. package/resources/apply/handlers.js +3 -4
  355. package/resources/apply/handlers.js.map +1 -1
  356. package/resources/channel.d.ts.map +1 -1
  357. package/resources/channel.js +3 -4
  358. package/resources/channel.js.map +1 -1
  359. package/resources/connect/connect.js +2 -2
  360. package/resources/connect/connect.js.map +1 -1
  361. package/resources/delete.d.ts.map +1 -1
  362. package/resources/delete.js +38 -4
  363. package/resources/delete.js.map +1 -1
  364. package/resources/documents.js +1 -1
  365. package/resources/documents.js.map +1 -1
  366. package/resources/download.d.ts +43 -3
  367. package/resources/download.d.ts.map +1 -1
  368. package/resources/download.js +169 -34
  369. package/resources/download.js.map +1 -1
  370. package/resources/eval-run/options.d.ts +3 -1
  371. package/resources/eval-run/options.d.ts.map +1 -1
  372. package/resources/eval-run/options.js +36 -18
  373. package/resources/eval-run/options.js.map +1 -1
  374. package/resources/eval-run/report.d.ts +4 -2
  375. package/resources/eval-run/report.d.ts.map +1 -1
  376. package/resources/eval-run/report.js +9 -7
  377. package/resources/eval-run/report.js.map +1 -1
  378. package/resources/eval-run/run.d.ts +2 -1
  379. package/resources/eval-run/run.d.ts.map +1 -1
  380. package/resources/eval-run/run.js +13 -7
  381. package/resources/eval-run/run.js.map +1 -1
  382. package/resources/file.d.ts +27 -0
  383. package/resources/file.d.ts.map +1 -0
  384. package/resources/file.js +82 -0
  385. package/resources/file.js.map +1 -0
  386. package/resources/get-bindings.d.ts.map +1 -1
  387. package/resources/get-bindings.js +18 -0
  388. package/resources/get-bindings.js.map +1 -1
  389. package/resources/git.d.ts +1 -1
  390. package/resources/git.js +1 -1
  391. package/resources/list.d.ts +21 -2
  392. package/resources/list.d.ts.map +1 -1
  393. package/resources/list.js +148 -31
  394. package/resources/list.js.map +1 -1
  395. package/resources/plugin.d.ts.map +1 -1
  396. package/resources/plugin.js +4 -0
  397. package/resources/plugin.js.map +1 -1
  398. package/resources/provider-key.d.ts +81 -0
  399. package/resources/provider-key.d.ts.map +1 -0
  400. package/resources/provider-key.js +261 -0
  401. package/resources/provider-key.js.map +1 -0
  402. package/resources/reference.d.ts +15 -21
  403. package/resources/reference.d.ts.map +1 -1
  404. package/resources/reference.js +42 -88
  405. package/resources/reference.js.map +1 -1
  406. package/resources/render.d.ts +31 -7
  407. package/resources/render.d.ts.map +1 -1
  408. package/resources/render.js +66 -38
  409. package/resources/render.js.map +1 -1
  410. package/resources/routine.d.ts +21 -5
  411. package/resources/routine.d.ts.map +1 -1
  412. package/resources/routine.js +104 -15
  413. package/resources/routine.js.map +1 -1
  414. package/resources/run/agent-exec.d.ts +12 -2
  415. package/resources/run/agent-exec.d.ts.map +1 -1
  416. package/resources/run/agent-exec.js +85 -38
  417. package/resources/run/agent-exec.js.map +1 -1
  418. package/resources/run/create.d.ts +16 -12
  419. package/resources/run/create.d.ts.map +1 -1
  420. package/resources/run/create.js +14 -15
  421. package/resources/run/create.js.map +1 -1
  422. package/resources/run/engines.d.ts +32 -0
  423. package/resources/run/engines.d.ts.map +1 -0
  424. package/resources/run/engines.js +39 -0
  425. package/resources/run/engines.js.map +1 -0
  426. package/resources/run/environment.d.ts +11 -0
  427. package/resources/run/environment.d.ts.map +1 -0
  428. package/resources/run/environment.js +30 -0
  429. package/resources/run/environment.js.map +1 -0
  430. package/resources/run/epilogue.d.ts +1 -1
  431. package/resources/run/epilogue.d.ts.map +1 -1
  432. package/resources/run/epilogue.js +18 -19
  433. package/resources/run/epilogue.js.map +1 -1
  434. package/resources/run/files.d.ts +104 -0
  435. package/resources/run/files.d.ts.map +1 -0
  436. package/resources/run/files.js +316 -0
  437. package/resources/run/files.js.map +1 -0
  438. package/resources/run/header.d.ts +11 -9
  439. package/resources/run/header.d.ts.map +1 -1
  440. package/resources/run/header.js +14 -14
  441. package/resources/run/header.js.map +1 -1
  442. package/resources/run/prepare.d.ts +31 -25
  443. package/resources/run/prepare.d.ts.map +1 -1
  444. package/resources/run/prepare.js +42 -51
  445. package/resources/run/prepare.js.map +1 -1
  446. package/resources/run/references.d.ts.map +1 -1
  447. package/resources/run/references.js +6 -5
  448. package/resources/run/references.js.map +1 -1
  449. package/resources/run/resolve.js +1 -1
  450. package/resources/run/resolve.js.map +1 -1
  451. package/resources/run/resume.d.ts +3 -1
  452. package/resources/run/resume.d.ts.map +1 -1
  453. package/resources/run/resume.js +25 -10
  454. package/resources/run/resume.js.map +1 -1
  455. package/resources/run/stream.d.ts +34 -2
  456. package/resources/run/stream.d.ts.map +1 -1
  457. package/resources/run/stream.js +92 -8
  458. package/resources/run/stream.js.map +1 -1
  459. package/resources/run/workspace.d.ts +9 -12
  460. package/resources/run/workspace.d.ts.map +1 -1
  461. package/resources/run/workspace.js +29 -36
  462. package/resources/run/workspace.js.map +1 -1
  463. package/resources/run-approve.d.ts.map +1 -1
  464. package/resources/run-approve.js +2 -11
  465. package/resources/run-approve.js.map +1 -1
  466. package/resources/run-control.d.ts +3 -3
  467. package/resources/run-control.d.ts.map +1 -1
  468. package/resources/run-control.js +4 -5
  469. package/resources/run-control.js.map +1 -1
  470. package/resources/run-format.d.ts +2 -2
  471. package/resources/run-format.d.ts.map +1 -1
  472. package/resources/run-format.js +3 -4
  473. package/resources/run-format.js.map +1 -1
  474. package/resources/run-logs.d.ts +2 -0
  475. package/resources/run-logs.d.ts.map +1 -1
  476. package/resources/run-logs.js +16 -6
  477. package/resources/run-logs.js.map +1 -1
  478. package/resources/run-scores.d.ts +6 -2
  479. package/resources/run-scores.d.ts.map +1 -1
  480. package/resources/run-scores.js +7 -4
  481. package/resources/run-scores.js.map +1 -1
  482. package/resources/run-to-eval-case.js +2 -2
  483. package/resources/run-to-eval-case.js.map +1 -1
  484. package/resources/runs.d.ts +3 -3
  485. package/resources/runs.d.ts.map +1 -1
  486. package/resources/runs.js +5 -5
  487. package/resources/runs.js.map +1 -1
  488. package/resources/search.d.ts.map +1 -1
  489. package/resources/search.js +1 -2
  490. package/resources/search.js.map +1 -1
  491. package/resources/service-account.d.ts +2 -0
  492. package/resources/service-account.d.ts.map +1 -1
  493. package/resources/service-account.js +3 -1
  494. package/resources/service-account.js.map +1 -1
  495. package/resources/session.d.ts +4 -3
  496. package/resources/session.d.ts.map +1 -1
  497. package/resources/session.js +10 -7
  498. package/resources/session.js.map +1 -1
  499. package/resources/skill.d.ts +1 -1
  500. package/resources/skill.d.ts.map +1 -1
  501. package/resources/skill.js +7 -8
  502. package/resources/skill.js.map +1 -1
  503. package/resources/stream/answer.d.ts +1 -2
  504. package/resources/stream/answer.d.ts.map +1 -1
  505. package/resources/stream/answer.js +3 -16
  506. package/resources/stream/answer.js.map +1 -1
  507. package/resources/stream/composer.d.ts +16 -0
  508. package/resources/stream/composer.d.ts.map +1 -0
  509. package/resources/stream/composer.js +171 -0
  510. package/resources/stream/composer.js.map +1 -0
  511. package/resources/stream/ink.d.ts +20 -4
  512. package/resources/stream/ink.d.ts.map +1 -1
  513. package/resources/stream/ink.js +34 -3
  514. package/resources/stream/ink.js.map +1 -1
  515. package/resources/stream/render-plaintext.d.ts +1 -0
  516. package/resources/stream/render-plaintext.d.ts.map +1 -1
  517. package/resources/stream/render-plaintext.js +21 -4
  518. package/resources/stream/render-plaintext.js.map +1 -1
  519. package/resources/stream/tty.js +1 -1
  520. package/resources/stream/tty.js.map +1 -1
  521. package/resources/tag.d.ts.map +1 -1
  522. package/resources/tag.js +7 -8
  523. package/resources/tag.js.map +1 -1
  524. package/resources/usage.d.ts +3 -2
  525. package/resources/usage.d.ts.map +1 -1
  526. package/resources/usage.js +19 -16
  527. package/resources/usage.js.map +1 -1
  528. package/resources/validate.d.ts.map +1 -1
  529. package/resources/validate.js +1 -12
  530. package/resources/validate.js.map +1 -1
  531. package/resources/version.d.ts +17 -3
  532. package/resources/version.d.ts.map +1 -1
  533. package/resources/version.js +105 -14
  534. package/resources/version.js.map +1 -1
  535. package/resources/views/agent.d.ts +3 -0
  536. package/resources/views/agent.d.ts.map +1 -0
  537. package/resources/views/agent.js +54 -0
  538. package/resources/views/agent.js.map +1 -0
  539. package/resources/views/environment.d.ts +3 -0
  540. package/resources/views/environment.d.ts.map +1 -0
  541. package/resources/views/environment.js +37 -0
  542. package/resources/views/environment.js.map +1 -0
  543. package/resources/views/index.d.ts +22 -0
  544. package/resources/views/index.d.ts.map +1 -0
  545. package/resources/views/index.js +70 -0
  546. package/resources/views/index.js.map +1 -0
  547. package/resources/views/organization.d.ts +3 -0
  548. package/resources/views/organization.d.ts.map +1 -0
  549. package/resources/views/organization.js +27 -0
  550. package/resources/views/organization.js.map +1 -0
  551. package/resources/views/routine.d.ts +3 -0
  552. package/resources/views/routine.d.ts.map +1 -0
  553. package/resources/views/routine.js +37 -0
  554. package/resources/views/routine.js.map +1 -0
  555. package/resources/views/run.d.ts +3 -0
  556. package/resources/views/run.d.ts.map +1 -0
  557. package/resources/views/run.js +45 -0
  558. package/resources/views/run.js.map +1 -0
  559. package/resources/views/session.d.ts +5 -0
  560. package/resources/views/session.d.ts.map +1 -0
  561. package/resources/views/session.js +85 -0
  562. package/resources/views/session.js.map +1 -0
  563. package/resources/views/skill.d.ts +5 -0
  564. package/resources/views/skill.d.ts.map +1 -0
  565. package/resources/views/skill.js +48 -0
  566. package/resources/views/skill.js.map +1 -0
  567. package/resources/views/view.d.ts +66 -0
  568. package/resources/views/view.d.ts.map +1 -0
  569. package/resources/views/view.js +130 -0
  570. package/resources/views/view.js.map +1 -0
  571. package/resources/views/words.d.ts +52 -0
  572. package/resources/views/words.d.ts.map +1 -0
  573. package/resources/views/words.js +190 -0
  574. package/resources/views/words.js.map +1 -0
  575. package/runtime.d.ts +22 -0
  576. package/runtime.d.ts.map +1 -1
  577. package/runtime.js +33 -2
  578. package/runtime.js.map +1 -1
  579. package/src/auth/auth0.ts +1 -1
  580. package/src/auth/token.ts +136 -26
  581. package/src/client/client.ts +23 -16
  582. package/src/command-tree.ts +152 -0
  583. package/src/commands/access-history/index.ts +15 -2
  584. package/src/commands/agent-exec-flags.ts +11 -5
  585. package/src/commands/apikey/duration.ts +1 -2
  586. package/src/commands/apikey/index.ts +3 -4
  587. package/src/commands/apply.ts +3 -22
  588. package/src/commands/auth/index.ts +7 -5
  589. package/src/commands/auth/whoami.ts +1 -1
  590. package/src/commands/config/index.ts +3 -3
  591. package/src/commands/config/kv.ts +18 -14
  592. package/src/commands/connect.ts +21 -3
  593. package/src/commands/download.ts +106 -62
  594. package/src/commands/eval.ts +22 -21
  595. package/src/commands/file.ts +80 -0
  596. package/src/commands/get.ts +19 -13
  597. package/src/commands/help.ts +182 -0
  598. package/src/commands/internal-daemon.ts +9 -2
  599. package/src/commands/list.ts +22 -1
  600. package/src/commands/logs.ts +1 -1
  601. package/src/commands/mcp-server.ts +57 -28
  602. package/src/commands/provider-key/index.ts +192 -0
  603. package/src/commands/push.ts +8 -8
  604. package/src/commands/resume.ts +20 -12
  605. package/src/commands/routine.ts +58 -5
  606. package/src/commands/run.ts +37 -17
  607. package/src/commands/runs/approve.ts +13 -4
  608. package/src/commands/runs/control.ts +50 -27
  609. package/src/commands/runs/index.ts +1 -2
  610. package/src/commands/runs/logs.ts +9 -5
  611. package/src/commands/runs/to-eval-case.ts +18 -6
  612. package/src/commands/runs/trace.ts +1 -1
  613. package/src/commands/search.ts +2 -3
  614. package/src/commands/service-account/index.ts +7 -2
  615. package/src/commands/session-help.ts +39 -0
  616. package/src/commands/setup.ts +5 -5
  617. package/src/commands/shared.ts +32 -3
  618. package/src/commands/tag.ts +13 -7
  619. package/src/commands/up.ts +55 -21
  620. package/src/commands/validate.ts +2 -2
  621. package/src/commands/version.ts +9 -4
  622. package/src/config/config.ts +66 -69
  623. package/src/config/index.ts +1 -2
  624. package/src/config/keys.ts +4 -4
  625. package/src/config/paths.ts +2 -2
  626. package/src/config/resolve.ts +20 -8
  627. package/src/errors/classify.ts +110 -21
  628. package/src/errors/command-line.ts +95 -0
  629. package/src/errors/handle.ts +2 -2
  630. package/src/errors/index.ts +12 -2
  631. package/src/errors/usage-error.ts +1 -1
  632. package/src/global-options.ts +100 -0
  633. package/src/local/artifact.ts +46 -140
  634. package/src/local/constants.ts +3 -9
  635. package/src/local/daemon/components.ts +78 -22
  636. package/src/local/daemon/env.ts +3 -8
  637. package/src/local/daemon/host.ts +64 -19
  638. package/src/local/daemon/index.ts +2 -1
  639. package/src/local/daemon/launch.ts +251 -72
  640. package/src/local/daemon/process.ts +78 -46
  641. package/src/local/daemon/signals.ts +19 -0
  642. package/src/local/daemon/supervisor.ts +84 -21
  643. package/src/local/daemon/types.ts +8 -4
  644. package/src/local/llm-config.ts +15 -9
  645. package/src/local/logs/view.ts +5 -6
  646. package/src/local/net/tcp.ts +18 -11
  647. package/src/local/paths.ts +2 -3
  648. package/src/local/provider-reach.ts +124 -0
  649. package/src/local/reset.ts +1 -2
  650. package/src/local/runtime/index.ts +1 -2
  651. package/src/local/runtime/node.ts +1 -1
  652. package/src/local/runtime/runner.ts +2 -2
  653. package/src/local/runtime/runtimes-install.ts +1 -1
  654. package/src/local/runtime/server.ts +2 -4
  655. package/src/local/runtime/which.ts +1 -1
  656. package/src/local/setup/wizard.ts +7 -5
  657. package/src/local/state/health-state.ts +10 -2
  658. package/src/local/state/lock.ts +26 -28
  659. package/src/local/state/log-rotation.ts +2 -3
  660. package/src/local/state/pidfile.ts +61 -6
  661. package/src/local/state/proc.ts +104 -1
  662. package/src/local/state/startup-config.ts +2 -2
  663. package/src/local/status.ts +30 -41
  664. package/src/local/temporal/download.ts +31 -9
  665. package/src/local/temporal/index.ts +1 -1
  666. package/src/local/temporal/manager.ts +94 -34
  667. package/src/local/temporal/supervisor.ts +1 -1
  668. package/src/local/webconsole/index.ts +8 -5
  669. package/src/marketplace/github.ts +1 -1
  670. package/src/marketplace/official.ts +1 -1
  671. package/src/output/command-result.ts +14 -2
  672. package/src/output/confirm.ts +2 -3
  673. package/src/output/format.ts +5 -6
  674. package/src/output/index.ts +8 -1
  675. package/src/output/printable.ts +26 -0
  676. package/src/output/proto.ts +3 -4
  677. package/src/output/style.ts +2 -2
  678. package/src/output/table.ts +118 -15
  679. package/src/program.ts +58 -128
  680. package/src/registry/aliases.ts +0 -3
  681. package/src/registry/index.ts +0 -1
  682. package/src/registry/metadata.ts +16 -64
  683. package/src/registry/registry.ts +3 -13
  684. package/src/registry/verb-support.ts +28 -5
  685. package/src/resources/agent/quality.ts +29 -8
  686. package/src/resources/agent/resolve.ts +3 -3
  687. package/src/resources/apply/apply.ts +58 -49
  688. package/src/resources/apply/handlers.ts +3 -4
  689. package/src/resources/channel.ts +3 -4
  690. package/src/resources/connect/connect.ts +2 -2
  691. package/src/resources/delete.ts +44 -4
  692. package/src/resources/documents.ts +1 -1
  693. package/src/resources/download.ts +239 -43
  694. package/src/resources/eval-run/options.ts +38 -17
  695. package/src/resources/eval-run/report.ts +11 -5
  696. package/src/resources/eval-run/run.ts +13 -9
  697. package/src/resources/file.ts +114 -0
  698. package/src/resources/get-bindings.ts +18 -0
  699. package/src/resources/git.ts +1 -1
  700. package/src/resources/list.ts +178 -34
  701. package/src/resources/plugin.ts +3 -0
  702. package/src/resources/provider-key.ts +327 -0
  703. package/src/resources/reference.ts +41 -85
  704. package/src/resources/render.ts +72 -38
  705. package/src/resources/routine.ts +152 -15
  706. package/src/resources/run/agent-exec.ts +95 -44
  707. package/src/resources/run/create.ts +27 -24
  708. package/src/resources/run/engines.ts +57 -0
  709. package/src/resources/run/environment.ts +43 -0
  710. package/src/resources/run/epilogue.ts +18 -17
  711. package/src/resources/run/files.ts +433 -0
  712. package/src/resources/run/header.ts +18 -18
  713. package/src/resources/run/prepare.ts +67 -74
  714. package/src/resources/run/references.ts +6 -5
  715. package/src/resources/run/resolve.ts +1 -1
  716. package/src/resources/run/resume.ts +28 -9
  717. package/src/resources/run/stream.ts +110 -9
  718. package/src/resources/run/workspace.ts +37 -47
  719. package/src/resources/run-approve.ts +2 -14
  720. package/src/resources/run-control.ts +4 -5
  721. package/src/resources/run-format.ts +3 -4
  722. package/src/resources/run-logs.ts +17 -6
  723. package/src/resources/run-scores.ts +14 -4
  724. package/src/resources/run-to-eval-case.ts +2 -2
  725. package/src/resources/runs.ts +5 -5
  726. package/src/resources/search.ts +1 -2
  727. package/src/resources/service-account.ts +4 -1
  728. package/src/resources/session.ts +10 -7
  729. package/src/resources/skill.ts +7 -8
  730. package/src/resources/stream/answer.ts +3 -19
  731. package/src/resources/stream/composer.ts +170 -0
  732. package/src/resources/stream/ink.tsx +74 -10
  733. package/src/resources/stream/render-plaintext.ts +22 -4
  734. package/src/resources/stream/tty.ts +1 -1
  735. package/src/resources/tag.ts +7 -9
  736. package/src/resources/usage.ts +19 -15
  737. package/src/resources/validate.ts +1 -10
  738. package/src/resources/version.ts +117 -15
  739. package/src/resources/views/agent.ts +60 -0
  740. package/src/resources/views/environment.ts +41 -0
  741. package/src/resources/views/index.ts +82 -0
  742. package/src/resources/views/organization.ts +29 -0
  743. package/src/resources/views/routine.ts +39 -0
  744. package/src/resources/views/run.ts +46 -0
  745. package/src/resources/views/session.ts +91 -0
  746. package/src/resources/views/skill.ts +49 -0
  747. package/src/resources/views/view.ts +188 -0
  748. package/src/resources/views/words.ts +191 -0
  749. package/src/runtime.ts +51 -2
  750. package/errors/exit-codes.d.ts +0 -10
  751. package/errors/exit-codes.d.ts.map +0 -1
  752. package/errors/exit-codes.js +0 -15
  753. package/errors/exit-codes.js.map +0 -1
  754. package/resources/run/attachments.d.ts +0 -24
  755. package/resources/run/attachments.d.ts.map +0 -1
  756. package/resources/run/attachments.js +0 -237
  757. package/resources/run/attachments.js.map +0 -1
  758. package/src/errors/exit-codes.ts +0 -17
  759. package/src/resources/run/attachments.ts +0 -300
  760. package/src/types/marked-terminal.d.ts +0 -31
@@ -1,7 +1,6 @@
1
1
  // Classifies any thrown value into a CliError: an exit code, a user-facing
2
- // message, and optional remediation hints. Mirrors the Go CLI's
3
- // clierr.Classify, including walking the error chain so wrapped RPC errors
4
- // still map to the right exit code.
2
+ // message, and optional remediation hints. It walks the error chain so
3
+ // wrapped RPC errors still map to the right exit code.
5
4
  //
6
5
  // A refusal that carries a reason the CLI knows gets its own copy. Today
7
6
  // there are two:
@@ -15,10 +14,21 @@
15
14
  // is printed as is, with `stigmer usage hours` as the place to see the
16
15
  // standing. A child organization's refusal names no plan (its parent
17
16
  // manages it) and gets no hint: the hours are its parent's to read.
17
+ //
18
+ // Every other kind ends with what to do, in the CLI's own commands (the
19
+ // terminal kit words its failures the same way: headline, cause, next;
20
+ // sdk/ink/src/errors.ts). A server that cannot be reached is named by the
21
+ // address the backend client dialled, read from the record the client
22
+ // left in runtime.ts when it was made, never resolved again here; the next
23
+ // step follows where that address came from. A code path that made no
24
+ // client names no address. A missing resource points at the list of its
25
+ // type when the command recorded one, and a refused request at the running
26
+ // command's help.
18
27
  import { Code, ConnectError } from "@connectrpc/connect";
19
28
  import { getErrorReason, StigmerError } from "@stigmer/client";
20
29
  import { CliExitError } from "./cli-exit-error.js";
21
- import { ExitCode } from "./exit-codes.js";
30
+ import { ExitCode } from "@stigmer/client/exit-codes";
31
+ import { actionCommandPath, actionResourceType, dialedServerAddress, } from "../runtime.js";
22
32
  // Guards against pathological/circular `cause` chains.
23
33
  const MAX_CHAIN_DEPTH = 20;
24
34
  // The server's reason for refusing a key created before sign-in was turned
@@ -34,8 +44,7 @@ export function classify(err) {
34
44
  }
35
45
  // Local cancellation (Ctrl-C / AbortController) is a clean outcome, not a
36
46
  // failure — exit 0 silently. A *remote* Canceled status is a genuine failure
37
- // and falls through to classifyConnectCode (exit 1). This is the one place
38
- // the TS CLI deliberately improves on the Go CLI, which exits 1 for both.
47
+ // and falls through to classifyConnectCode (exit 1).
39
48
  if (isLocalAbort(err)) {
40
49
  return { exitCode: ExitCode.Success, message: "", cause: toError(err) };
41
50
  }
@@ -76,9 +85,8 @@ export function classify(err) {
76
85
  }
77
86
  return { exitCode: ExitCode.General, message: messageOf(err), cause: toError(err) };
78
87
  }
79
- // Walks the cause chain for the first SDK StigmerError or raw ConnectError.
80
- // status.FromError in Go only checks the outermost error; this mirrors the Go
81
- // CLI's extractGRPCStatus which walks Unwrap to handle wrapped RPC errors.
88
+ // Walks the cause chain for the first SDK StigmerError or raw ConnectError, so
89
+ // a wrapped RPC error still classifies by its status.
82
90
  function extractCoded(err) {
83
91
  let depth = 0;
84
92
  for (let current = err; current != null && depth < MAX_CHAIN_DEPTH; current = causeOf(current), depth++) {
@@ -91,6 +99,27 @@ function extractCoded(err) {
91
99
  }
92
100
  return undefined;
93
101
  }
102
+ // The network's own refusals, by the code Node gives them or the words its
103
+ // fetch and HTTP/2 client use: no connection, no address, a reset or a hang-up.
104
+ const TRANSPORT_FAILURE = /\b(ECONNREFUSED|ENOTFOUND|EAI_AGAIN|ETIMEDOUT|ECONNRESET|EHOSTUNREACH|ENETUNREACH|EPIPE|UND_ERR_\w+)\b|fetch failed|socket hang up|other side closed|NGHTTP2_\w+/;
105
+ /**
106
+ * Whether an Unavailable is the transport's (the request never reached a
107
+ * server) rather than a server's answer: its message, or an error in its
108
+ * cause chain, names a network failure.
109
+ */
110
+ export function isTransportFailure(message, cause) {
111
+ if (TRANSPORT_FAILURE.test(message))
112
+ return true;
113
+ let depth = 0;
114
+ for (let current = cause; current != null && depth < MAX_CHAIN_DEPTH; current = causeOf(current), depth++) {
115
+ const errno = current.code;
116
+ if (typeof errno === "string" && TRANSPORT_FAILURE.test(errno))
117
+ return true;
118
+ if (current instanceof Error && TRANSPORT_FAILURE.test(current.message))
119
+ return true;
120
+ }
121
+ return false;
122
+ }
94
123
  function isLocalAbort(err) {
95
124
  let depth = 0;
96
125
  for (let current = err; current != null && depth < MAX_CHAIN_DEPTH; current = causeOf(current), depth++) {
@@ -103,13 +132,12 @@ function isLocalAbort(err) {
103
132
  function classifyConnectCode(code, message, cause) {
104
133
  switch (code) {
105
134
  case Code.Unavailable:
106
- return {
107
- exitCode: ExitCode.Connection,
108
- code,
109
- cause,
110
- message: "Cannot connect to the Stigmer server",
111
- hints: ["Make sure the Stigmer server is running and reachable."],
112
- };
135
+ // A request that never reached the server names the address it was
136
+ // sent to; one the server answered with Unavailable keeps its words.
137
+ if (isTransportFailure(message, cause)) {
138
+ return { exitCode: ExitCode.Connection, code, cause, ...cannotConnect(dialedServerAddress()) };
139
+ }
140
+ return { exitCode: ExitCode.Connection, code, cause, message, hints: ["The server could not take the request just now. Try again in a moment."] };
113
141
  case Code.DeadlineExceeded:
114
142
  return {
115
143
  exitCode: ExitCode.Connection,
@@ -127,13 +155,13 @@ function classifyConnectCode(code, message, cause) {
127
155
  hints: ["Too many requests. Wait a moment and try again."],
128
156
  };
129
157
  case Code.NotFound:
130
- return { exitCode: ExitCode.NotFound, code, cause, message };
158
+ return { exitCode: ExitCode.NotFound, code, cause, message, hints: [notFoundHint()] };
131
159
  case Code.InvalidArgument:
132
- return { exitCode: ExitCode.Usage, code, cause, message };
160
+ return { exitCode: ExitCode.Usage, code, cause, message, hints: [helpHint()] };
133
161
  case Code.FailedPrecondition:
134
- return { exitCode: ExitCode.Usage, code, cause, message: `Precondition failed: ${message}` };
162
+ return { exitCode: ExitCode.Usage, code, cause, message: `Precondition failed: ${message}`, hints: [helpHint()] };
135
163
  case Code.AlreadyExists:
136
- return { exitCode: ExitCode.Usage, code, cause, message: `Already exists: ${message}` };
164
+ return { exitCode: ExitCode.Usage, code, cause, message: `Already exists: ${message}`, hints: [helpHint()] };
137
165
  case Code.Unauthenticated:
138
166
  return {
139
167
  exitCode: ExitCode.Auth,
@@ -170,16 +198,64 @@ function classifyConnectCode(code, message, cause) {
170
198
  hints: ["The operation was interrupted. You can safely retry."],
171
199
  };
172
200
  case Code.Canceled:
173
- return { exitCode: ExitCode.General, code, cause, message: "Operation cancelled" };
201
+ return {
202
+ exitCode: ExitCode.General,
203
+ code,
204
+ cause,
205
+ message: "Operation cancelled",
206
+ hints: ["The server cancelled the request. Try again."],
207
+ };
174
208
  default:
175
209
  return {
176
210
  exitCode: ExitCode.General,
177
211
  code,
178
212
  cause,
179
213
  message: `${codeName(code)}: ${message}`,
214
+ hints: ["Run with --debug for more details."],
215
+ };
216
+ }
217
+ }
218
+ /**
219
+ * The words for a server that could not be reached at `address`, with the
220
+ * next step its source calls for: start the local daemon, check the named
221
+ * backend, or look at the override. With no address (no client was made)
222
+ * it names none. The connect timeout (client/client.ts) words itself with
223
+ * this too, so both failures read alike.
224
+ */
225
+ export function cannotConnect(address) {
226
+ // The next step for a named backend, and for a failure that names no
227
+ // address: the status command prints the active backend and its endpoint.
228
+ const checkBackend = "Check the backend: stigmer config backend status";
229
+ if (address === undefined) {
230
+ return { message: "Could not reach the Stigmer server", hints: [checkBackend] };
231
+ }
232
+ switch (address.source) {
233
+ case "environment":
234
+ return {
235
+ message: `Could not reach the Stigmer server at ${address.address} (set by STIGMER_SERVER_ADDRESS)`,
236
+ hints: ["Start the server it names, or unset STIGMER_SERVER_ADDRESS to use the active backend."],
180
237
  };
238
+ case "local":
239
+ return { message: `Could not reach the Stigmer server at ${address.address}`, hints: ["Start it: stigmer up"] };
240
+ case "cloud":
241
+ case "selfhost":
242
+ return { message: `Could not reach the Stigmer server at ${address.address}`, hints: [checkBackend] };
181
243
  }
182
244
  }
245
+ // A missing resource: the list of its type when the running command
246
+ // recorded one (get, delete and download do), else the two things a
247
+ // reference is made of.
248
+ function notFoundHint() {
249
+ const type = actionResourceType();
250
+ return type === "" ? "Check the reference and the organization (--org)." : `Check the reference: stigmer list ${type}`;
251
+ }
252
+ // A refused request: the running command's help, worded as a command-line
253
+ // refusal words it (errors/command-line.ts); the root's before any command
254
+ // ran.
255
+ function helpHint() {
256
+ const path = actionCommandPath();
257
+ return `Run \`${path === "" ? "stigmer" : path} --help\` for usage.`;
258
+ }
183
259
  function causeOf(value) {
184
260
  return value !== null && typeof value === "object"
185
261
  ? value.cause
@@ -1 +1 @@
1
- {"version":3,"file":"classify.js","sourceRoot":"","sources":["../src/errors/classify.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"classify.js","sourceRoot":"","sources":["../src/errors/classify.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,14 @@
1
+ import type { Command, CommanderError } from "commander";
2
+ import { CliExitError } from "./cli-exit-error.js";
3
+ /** A refusal of the command line itself, carrying Commander's code (`commander.unknownOption`). */
4
+ export declare class CommandLineError extends CliExitError {
5
+ readonly code: string;
6
+ constructor(message: string, exitCode: number, code: string, hints?: readonly string[]);
7
+ }
8
+ /** Declare the code a usage error on `cmd` exits with, in place of 2 (module header). */
9
+ export declare function usageExitCode(cmd: Command, code: number): Command;
10
+ /** Give every command in the tree its own exit callback and silence Commander's error output. */
11
+ export declare function installCommandLineErrors(program: Command): void;
12
+ /** The CLI's error for a Commander refusal on `cmd` (module header). */
13
+ export declare function commandLineErrorOf(cmd: Command, error: CommanderError): CommandLineError;
14
+ //# sourceMappingURL=command-line.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"command-line.d.ts","sourceRoot":"","sources":["../src/errors/command-line.ts"],"names":[],"mappings":"AAwBA,OAAO,KAAK,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAGzD,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAEnD,mGAAmG;AACnG,qBAAa,gBAAiB,SAAQ,YAAY;IAChD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;gBAEV,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,SAAS,MAAM,EAAE;CAKvF;AAID,yFAAyF;AACzF,wBAAgB,aAAa,CAAC,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAGjE;AAED,iGAAiG;AACjG,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAO/D;AAED,wEAAwE;AACxE,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,OAAO,EAAE,KAAK,EAAE,cAAc,GAAG,gBAAgB,CAOxF"}
@@ -0,0 +1,90 @@
1
+ // Commander's own refusals (an unknown option, a missing or extra argument,
2
+ // a group run without its subcommand) worded and exited like every other
3
+ // usage error: `Error: ...` on stderr, the command's help named on the next
4
+ // line, exit 2, through the one exit point (handle.ts).
5
+ //
6
+ // Commander reports through `_exit`, which calls a command's exit callback
7
+ // with no command attached, so each command gets a callback of its own, a
8
+ // closure over it, and the hint names the command the error happened on.
9
+ // Commander's own error output is silenced, so the error prints once.
10
+ //
11
+ // An unknown option is named without what follows it (a value written after
12
+ // '=', or a short option's attached value), and extra arguments are counted,
13
+ // never listed (a newer Commander lists them): a key pasted onto the wrong
14
+ // option, or after the arguments, does not reach a terminal's log. An unknown
15
+ // command and a value an option's own parser refuses are still echoed, as
16
+ // Commander words them.
17
+ //
18
+ // A usage error exits 2, except on a command that declares its own code for
19
+ // one (`usageExitCode`): `eval run` keeps the plugin-eval table, where 2 is a
20
+ // partial run and an invalid option is 1.
21
+ //
22
+ // Help and version (exit code 0) leave quietly with 0; a group run without
23
+ // its subcommand has printed its help to stderr and exits 2.
24
+ import { ExitCode } from "@stigmer/client/exit-codes";
25
+ import { commandPath, everyCommand, registeredArguments } from "../command-tree.js";
26
+ import { CliExitError } from "./cli-exit-error.js";
27
+ /** A refusal of the command line itself, carrying Commander's code (`commander.unknownOption`). */
28
+ export class CommandLineError extends CliExitError {
29
+ code;
30
+ constructor(message, exitCode, code, hints) {
31
+ super(message, exitCode, hints);
32
+ this.name = "CommandLineError";
33
+ this.code = code;
34
+ }
35
+ }
36
+ const USAGE_EXIT = new WeakMap();
37
+ /** Declare the code a usage error on `cmd` exits with, in place of 2 (module header). */
38
+ export function usageExitCode(cmd, code) {
39
+ USAGE_EXIT.set(cmd, code);
40
+ return cmd;
41
+ }
42
+ /** Give every command in the tree its own exit callback and silence Commander's error output. */
43
+ export function installCommandLineErrors(program) {
44
+ for (const cmd of everyCommand(program)) {
45
+ cmd.exitOverride((error) => {
46
+ throw commandLineErrorOf(cmd, error);
47
+ });
48
+ cmd.configureOutput({ outputError: () => undefined });
49
+ }
50
+ }
51
+ /** The CLI's error for a Commander refusal on `cmd` (module header). */
52
+ export function commandLineErrorOf(cmd, error) {
53
+ if (error.exitCode === 0)
54
+ return new CommandLineError("", ExitCode.Success, error.code);
55
+ // A group run without its subcommand: its help is already on stderr.
56
+ const exitCode = USAGE_EXIT.get(cmd) ?? ExitCode.Usage;
57
+ if (error.code === "commander.help")
58
+ return new CommandLineError("", exitCode, error.code);
59
+ const hint = `Run \`${commandPath(cmd)} --help\` for usage.`;
60
+ return new CommandLineError(wording(cmd, error), exitCode, error.code, [hint]);
61
+ }
62
+ function wording(cmd, error) {
63
+ if (error.code === "commander.excessArguments")
64
+ return excessArguments(cmd, error.message);
65
+ const message = error.message.replace(/^error: /, "");
66
+ if (error.code === "commander.unknownOption")
67
+ return unknownOption(message);
68
+ return message
69
+ .split("\n")
70
+ .map((line) => line.trim())
71
+ .filter((line) => line !== "")
72
+ .join(" ");
73
+ }
74
+ // Commander echoes an unknown option as typed, so `--name=VALUE` would print
75
+ // the value, newlines and all; the answer names the option alone, with
76
+ // Commander's suggestion when its last line is one (an option's name only).
77
+ function unknownOption(message) {
78
+ const name = /^unknown option '(--[A-Za-z0-9-]+|-[A-Za-z0-9])/.exec(message)?.[1];
79
+ if (name === undefined)
80
+ return "unknown option";
81
+ const suggestion = /\n(\(Did you mean --?[A-Za-z0-9-]+\?\))$/.exec(message)?.[1];
82
+ return suggestion === undefined ? `unknown option '${name}'` : `unknown option '${name}' ${suggestion}`;
83
+ }
84
+ function excessArguments(cmd, message) {
85
+ const expected = registeredArguments(cmd).length;
86
+ const got = /got (\d+)/.exec(message)?.[1];
87
+ const takes = expected === 0 ? "takes no arguments" : `takes ${expected} argument${expected === 1 ? "" : "s"}`;
88
+ return got === undefined ? `${commandPath(cmd)} ${takes}` : `${commandPath(cmd)} ${takes}, got ${got}`;
89
+ }
90
+ //# sourceMappingURL=command-line.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"command-line.js","sourceRoot":"","sources":["../src/errors/command-line.ts"],"names":[],"mappings":"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"}
package/errors/handle.js CHANGED
@@ -1,8 +1,8 @@
1
1
  // The single exit point for command-level errors: classify, print to stderr,
2
- // and exit with the mapped code. Mirrors the Go CLI's clierr.Handle.
2
+ // and exit with the mapped code.
3
3
  import { isDebug } from "../runtime.js";
4
4
  import { classify, codeName } from "./classify.js";
5
- import { ExitCode } from "./exit-codes.js";
5
+ import { ExitCode } from "@stigmer/client/exit-codes";
6
6
  /**
7
7
  * Render a CliError for stderr. In debug mode it appends the raw error chain
8
8
  * and numeric gRPC code. Returns "" when there is nothing to print (a clean
@@ -1 +1 @@
1
- {"version":3,"file":"handle.js","sourceRoot":"","sources":["../src/errors/handle.ts"],"names":[],"mappings":"AAAA,6EAA6E;AAC7E,qEAAqE;AAErE,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AACxC,OAAO,EAAiB,QAAQ,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAClE,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAE3C;;;;GAIG;AACH,MAAM,UAAU,WAAW,CAAC,KAAe,EAAE,SAAkB;IAC7D,MAAM,KAAK,GAAa,EAAE,CAAC;IAE3B,IAAI,KAAK,CAAC,OAAO,KAAK,EAAE,EAAE,CAAC;QACzB,KAAK,CAAC,IAAI,CAAC,UAAU,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;IACxC,CAAC;IAED,IAAI,KAAK,CAAC,KAAK,KAAK,SAAS,IAAI,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACxD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,KAAK,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC;IAC7B,CAAC;IAED,IAAI,SAAS,IAAI,KAAK,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;QAC3C,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,KAAK,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;QAC5B,IAAI,KAAK,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;YAC7B,KAAK,CAAC,IAAI,CAAC,cAAc,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,KAAK,CAAC,IAAI,GAAG,CAAC,CAAC;QACnE,CAAC;QACD,KAAK,CAAC,IAAI,CAAC,cAAc,KAAK,CAAC,KAAK,CAAC,KAAK,IAAI,KAAK,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;IACvE,CAAC;IAED,OAAO,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;AACzD,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,MAAM,CAAC,KAAc;IACnC,MAAM,UAAU,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;IACnC,IAAI,UAAU,KAAK,IAAI,EAAE,CAAC;QACxB,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;IACjC,CAAC;IAED,MAAM,QAAQ,GAAG,WAAW,CAAC,UAAU,EAAE,OAAO,EAAE,CAAC,CAAC;IACpD,IAAI,QAAQ,KAAK,EAAE,EAAE,CAAC;QACpB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IACjC,CAAC;IACD,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;AACpC,CAAC"}
1
+ {"version":3,"file":"handle.js","sourceRoot":"","sources":["../src/errors/handle.ts"],"names":[],"mappings":"AAAA,6EAA6E;AAC7E,iCAAiC;AAEjC,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AACxC,OAAO,EAAiB,QAAQ,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAClE,OAAO,EAAE,QAAQ,EAAE,MAAM,4BAA4B,CAAC;AAEtD;;;;GAIG;AACH,MAAM,UAAU,WAAW,CAAC,KAAe,EAAE,SAAkB;IAC7D,MAAM,KAAK,GAAa,EAAE,CAAC;IAE3B,IAAI,KAAK,CAAC,OAAO,KAAK,EAAE,EAAE,CAAC;QACzB,KAAK,CAAC,IAAI,CAAC,UAAU,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;IACxC,CAAC;IAED,IAAI,KAAK,CAAC,KAAK,KAAK,SAAS,IAAI,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACxD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,KAAK,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC;IAC7B,CAAC;IAED,IAAI,SAAS,IAAI,KAAK,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;QAC3C,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,KAAK,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;QAC5B,IAAI,KAAK,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;YAC7B,KAAK,CAAC,IAAI,CAAC,cAAc,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,KAAK,CAAC,IAAI,GAAG,CAAC,CAAC;QACnE,CAAC;QACD,KAAK,CAAC,IAAI,CAAC,cAAc,KAAK,CAAC,KAAK,CAAC,KAAK,IAAI,KAAK,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;IACvE,CAAC;IAED,OAAO,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;AACzD,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,MAAM,CAAC,KAAc;IACnC,MAAM,UAAU,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;IACnC,IAAI,UAAU,KAAK,IAAI,EAAE,CAAC;QACxB,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;IACjC,CAAC;IAED,MAAM,QAAQ,GAAG,WAAW,CAAC,UAAU,EAAE,OAAO,EAAE,CAAC,CAAC;IACpD,IAAI,QAAQ,KAAK,EAAE,EAAE,CAAC;QACpB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IACjC,CAAC;IACD,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;AACpC,CAAC"}
package/errors/index.d.ts CHANGED
@@ -1,5 +1,5 @@
1
- export { ExitCode } from "./exit-codes.js";
2
- export { type CliError, classify, codeName } from "./classify.js";
1
+ export { ExitCode } from "@stigmer/client/exit-codes";
2
+ export { cannotConnect, type CliError, classify, codeName, type ConnectFailure } from "./classify.js";
3
3
  export { CliExitError } from "./cli-exit-error.js";
4
4
  export { formatError, handle } from "./handle.js";
5
5
  export { UsageError } from "./usage-error.js";
@@ -1 +1 @@
1
- {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/errors/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAC3C,OAAO,EAAE,KAAK,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAClE,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC"}
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/errors/index.ts"],"names":[],"mappings":"AAYA,OAAO,EAAE,QAAQ,EAAE,MAAM,4BAA4B,CAAC;AACtD,OAAO,EAAE,aAAa,EAAE,KAAK,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,KAAK,cAAc,EAAE,MAAM,eAAe,CAAC;AACtG,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC"}
package/errors/index.js CHANGED
@@ -1,6 +1,16 @@
1
1
  // Public surface of the CLI error-handling module.
2
- export { ExitCode } from "./exit-codes.js";
3
- export { classify, codeName } from "./classify.js";
2
+ //
3
+ // Exit codes come from @stigmer/client/exit-codes, the table the terminal kit's
4
+ // stigmer-ink reads too, so scripts and CI branch on `$?` the same way for
5
+ // both. classify() maps gRPC/Connect status codes onto them. One command
6
+ // departs: `eval run` exits with Claude Code's plugin-eval codes (2 is its
7
+ // partial run, 130 an interrupt, and a refused start is 1), keeping only 3
8
+ // and 4 from this table (resources/eval-run/report.ts). A run (`run`,
9
+ // `resume`) exits by its newest turn's phase through the client's
10
+ // `exitCodeOf`: 0 completed; 1 failed, cancelled or stopped; 130 left while
11
+ // it works (resources/run/stream.ts).
12
+ export { ExitCode } from "@stigmer/client/exit-codes";
13
+ export { cannotConnect, classify, codeName } from "./classify.js";
4
14
  export { CliExitError } from "./cli-exit-error.js";
5
15
  export { formatError, handle } from "./handle.js";
6
16
  export { UsageError } from "./usage-error.js";
@@ -1 +1 @@
1
- {"version":3,"file":"index.js","sourceRoot":"","sources":["../src/errors/index.ts"],"names":[],"mappings":"AAAA,mDAAmD;AAEnD,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAC3C,OAAO,EAAiB,QAAQ,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAClE,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC"}
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../src/errors/index.ts"],"names":[],"mappings":"AAAA,mDAAmD;AACnD,EAAE;AACF,gFAAgF;AAChF,2EAA2E;AAC3E,yEAAyE;AACzE,2EAA2E;AAC3E,2EAA2E;AAC3E,sEAAsE;AACtE,kEAAkE;AAClE,4EAA4E;AAC5E,sCAAsC;AAEtC,OAAO,EAAE,QAAQ,EAAE,MAAM,4BAA4B,CAAC;AACtD,OAAO,EAAE,aAAa,EAAiB,QAAQ,EAAE,QAAQ,EAAuB,MAAM,eAAe,CAAC;AACtG,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC"}
@@ -3,7 +3,7 @@
3
3
  // same code the server's InvalidArgument produces, so scripts see a consistent
4
4
  // "usage" exit regardless of where validation happened.
5
5
  import { CliExitError } from "./cli-exit-error.js";
6
- import { ExitCode } from "./exit-codes.js";
6
+ import { ExitCode } from "@stigmer/client/exit-codes";
7
7
  export class UsageError extends CliExitError {
8
8
  constructor(message) {
9
9
  super(message, ExitCode.Usage);
@@ -1 +1 @@
1
- {"version":3,"file":"usage-error.js","sourceRoot":"","sources":["../src/errors/usage-error.ts"],"names":[],"mappings":"AAAA,0EAA0E;AAC1E,+EAA+E;AAC/E,+EAA+E;AAC/E,wDAAwD;AAExD,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAE3C,MAAM,OAAO,UAAW,SAAQ,YAAY;IAC1C,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,EAAE,QAAQ,CAAC,KAAK,CAAC,CAAC;QAC/B,IAAI,CAAC,IAAI,GAAG,YAAY,CAAC;IAC3B,CAAC;CACF"}
1
+ {"version":3,"file":"usage-error.js","sourceRoot":"","sources":["../src/errors/usage-error.ts"],"names":[],"mappings":"AAAA,0EAA0E;AAC1E,+EAA+E;AAC/E,+EAA+E;AAC/E,wDAAwD;AAExD,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,QAAQ,EAAE,MAAM,4BAA4B,CAAC;AAEtD,MAAM,OAAO,UAAW,SAAQ,YAAY;IAC1C,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,EAAE,QAAQ,CAAC,KAAK,CAAC,CAAC;QAC/B,IAAI,CAAC,IAAI,GAAG,YAAY,CAAC;IAC3B,CAAC;CACF"}
@@ -0,0 +1,35 @@
1
+ import { type Command, type HelpConfiguration } from "commander";
2
+ /** A global option that may also follow the command. */
3
+ interface TrailingGlobal {
4
+ readonly flags: string;
5
+ readonly long: string;
6
+ readonly short?: string;
7
+ readonly description: string;
8
+ }
9
+ /** The global options that may be written after the command too, as the root declares them. */
10
+ export declare const TRAILING_GLOBALS: readonly TrailingGlobal[];
11
+ /** Declare the trailing globals on the root, in help's order. */
12
+ export declare function addGlobalOptions(program: Command): Command;
13
+ /** Give every runnable command hidden copies of the trailing globals it does not declare itself. */
14
+ export declare function acceptGlobalsAfterCommand(program: Command): void;
15
+ /** The global options as the command that runs sees them: its own trailing copy first, then the root's. */
16
+ export interface GlobalOptions {
17
+ readonly debug: boolean;
18
+ readonly standalone: boolean;
19
+ /** The Stigmer API key, read from the root alone (module header). */
20
+ readonly apiKey: string;
21
+ }
22
+ /** An option's value on `cmd` or, when unset there, on the nearest command above it that has one. */
23
+ export declare function nearestOption(cmd: Command, key: string): unknown;
24
+ /** Read the global options for the action command `action` under `root`. */
25
+ export declare function readGlobalOptions(root: Command, action: Command): GlobalOptions;
26
+ /**
27
+ * The help every command shows: the globals once per page, and each
28
+ * subcommand listed by its name alone, as gh and kubectl list theirs; its
29
+ * arguments and options are on its own help's usage line. (Commander's own
30
+ * term would print "[options]" for every command, since each holds the
31
+ * hidden global copies, and its arguments widen the list past 80 columns.)
32
+ */
33
+ export declare const helpConfiguration: HelpConfiguration;
34
+ export {};
35
+ //# sourceMappingURL=global-options.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"global-options.d.ts","sourceRoot":"","sources":["src/global-options.ts"],"names":[],"mappings":"AAuBA,OAAO,EAAE,KAAK,OAAO,EAAE,KAAK,iBAAiB,EAAU,MAAM,WAAW,CAAC;AAGzE,wDAAwD;AACxD,UAAU,cAAc;IACtB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B;AAED,+FAA+F;AAC/F,eAAO,MAAM,gBAAgB,EAAE,SAAS,cAAc,EAIrD,CAAC;AAEF,iEAAiE;AACjE,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAG1D;AAED,oGAAoG;AACpG,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAShE;AAED,2GAA2G;AAC3G,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;IAC7B,qEAAqE;IACrE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED,qGAAqG;AACrG,wBAAgB,aAAa,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAMhE;AAED,4EAA4E;AAC5E,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,GAAG,aAAa,CAO/E;AAED;;;;;;GAMG;AACH,eAAO,MAAM,iBAAiB,EAAE,iBAM/B,CAAC"}
@@ -0,0 +1,81 @@
1
+ // The global options a person may write before or after the command:
2
+ // `stigmer --org acme run reviewer` and `stigmer run reviewer --org acme`
3
+ // read alike, as gh and kubectl take theirs.
4
+ //
5
+ // The root keeps positional options (`enablePositionalOptions`), because they
6
+ // are what keeps `stigmer setup --api-key` (the Anthropic key) from being read
7
+ // as the global Stigmer key. So the root's options do not reach a command's
8
+ // own arguments; instead each runnable command gets hidden copies of the ones
9
+ // that may follow it, and every reader takes the nearest command's value
10
+ // (`nearestOption`): the one written after the command wins over the one
11
+ // before it. Commander's own `optsWithGlobals` lets the root win, so it is
12
+ // not used for these.
13
+ //
14
+ // - `--org`, `-d/--debug` and `--standalone` follow any command that does not
15
+ // declare the name itself (`config context set --org` keeps its own
16
+ // meaning).
17
+ // - `--api-key` stays before the command: two commands give the name another
18
+ // meaning (`setup`, `mcp-server`), and a key belongs in the environment
19
+ // (`STIGMER_API_KEY`), not in a shell's history.
20
+ //
21
+ // The copies are hidden, so help shows the globals once, in its "Global
22
+ // Options" section, and the docs generator leaves them out of each page.
23
+ import { Option } from "commander";
24
+ import { runnableCommands } from "./command-tree.js";
25
+ /** The global options that may be written after the command too, as the root declares them. */
26
+ export const TRAILING_GLOBALS = [
27
+ { flags: "-d, --debug", long: "--debug", short: "-d", description: "enable debug output" },
28
+ { flags: "--standalone", long: "--standalone", description: "ignore the config file; use flags and environment only" },
29
+ { flags: "--org <slug>", long: "--org", description: "organization, on servers that hold several" },
30
+ ];
31
+ /** Declare the trailing globals on the root, in help's order. */
32
+ export function addGlobalOptions(program) {
33
+ for (const global of TRAILING_GLOBALS)
34
+ program.option(global.flags, global.description);
35
+ return program.option("--api-key <key>", "API key for authentication (before the command)");
36
+ }
37
+ /** Give every runnable command hidden copies of the trailing globals it does not declare itself. */
38
+ export function acceptGlobalsAfterCommand(program) {
39
+ for (const cmd of runnableCommands(program)) {
40
+ for (const global of TRAILING_GLOBALS) {
41
+ if (cmd.options.some((option) => option.long === global.long))
42
+ continue;
43
+ const shortTaken = global.short !== undefined && cmd.options.some((option) => option.short === global.short);
44
+ const flags = shortTaken || global.short === undefined ? global.flags.replace(/^-\w, /, "") : global.flags;
45
+ cmd.addOption(new Option(flags, global.description).hideHelp());
46
+ }
47
+ }
48
+ }
49
+ /** An option's value on `cmd` or, when unset there, on the nearest command above it that has one. */
50
+ export function nearestOption(cmd, key) {
51
+ for (let current = cmd; current !== null; current = current.parent) {
52
+ const value = current.opts()[key];
53
+ if (value !== undefined)
54
+ return value;
55
+ }
56
+ return undefined;
57
+ }
58
+ /** Read the global options for the action command `action` under `root`. */
59
+ export function readGlobalOptions(root, action) {
60
+ const apiKey = root.opts().apiKey;
61
+ return {
62
+ debug: Boolean(nearestOption(action, "debug")),
63
+ standalone: Boolean(nearestOption(action, "standalone")),
64
+ apiKey: typeof apiKey === "string" ? apiKey : "",
65
+ };
66
+ }
67
+ /**
68
+ * The help every command shows: the globals once per page, and each
69
+ * subcommand listed by its name alone, as gh and kubectl list theirs; its
70
+ * arguments and options are on its own help's usage line. (Commander's own
71
+ * term would print "[options]" for every command, since each holds the
72
+ * hidden global copies, and its arguments widen the list past 80 columns.)
73
+ */
74
+ export const helpConfiguration = {
75
+ showGlobalOptions: true,
76
+ subcommandTerm: (cmd) => {
77
+ const alias = cmd.aliases()[0];
78
+ return alias === undefined ? cmd.name() : `${cmd.name()}|${alias}`;
79
+ },
80
+ };
81
+ //# sourceMappingURL=global-options.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"global-options.js","sourceRoot":"","sources":["src/global-options.ts"],"names":[],"mappings":"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"}
@@ -1,3 +1,4 @@
1
+ export { DOWNLOAD_ATTEMPTS, DOWNLOAD_RETRY_BASE_DELAY_MS, extractTarEntry, parseShasum, sha256Hex } from "@stigmer/artifact-fetch";
1
2
  /** Release OS token, matching the `<os>` segment of our release asset names. */
2
3
  export declare function mapReleaseOs(platform: NodeJS.Platform): string;
3
4
  /** Release arch token, matching the `<arch>` segment of our release asset names. */
@@ -44,10 +45,6 @@ export type TarballInstall = {
44
45
  source: "network";
45
46
  cache: CacheMiss;
46
47
  };
47
- /** Attempts per download before a transient failure is reported. */
48
- export declare const DOWNLOAD_ATTEMPTS = 4;
49
- /** The wait before the second attempt; it doubles before each later one (1 s, 2 s, 4 s). */
50
- export declare const DOWNLOAD_RETRY_BASE_DELAY_MS = 1000;
51
48
  /**
52
49
  * Install the named entry of a `.tar.gz` at `binPath` with executable
53
50
  * permissions: from the cache directory when it holds a copy that matches its
@@ -58,20 +55,4 @@ export declare const DOWNLOAD_RETRY_BASE_DELAY_MS = 1000;
58
55
  * extraction failure, and with the path when the cache cannot be read or written.
59
56
  */
60
57
  export declare function fetchTarballBinary(src: TarballBinarySource): Promise<TarballInstall>;
61
- /** Lowercase hex sha256 of `bytes`. */
62
- export declare function sha256Hex(bytes: Uint8Array): string;
63
- /**
64
- * The sha256 a `shasum`/`sha256sum`-format file records for `filename`, lowercase
65
- * hex, or "" when the file has no entry for it. Each line is "<hex> <filename>";
66
- * `sha256sum -b` writes the filename with a leading "*" (binary mode), which is
67
- * not part of the name. A release-wide file lists every asset, so the match is
68
- * by filename, never by position.
69
- */
70
- export declare function parseShasum(content: string, filename: string): string;
71
- /**
72
- * Extract a single regular-file entry whose basename matches `name` from an
73
- * (uncompressed) tar buffer. Minimal POSIX/ustar reader: 512-byte header blocks,
74
- * octal size at offset 124, type flag at 156, data padded to 512 bytes.
75
- */
76
- export declare function extractTarEntry(buf: Uint8Array, name: string): Uint8Array | null;
77
58
  //# sourceMappingURL=artifact.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"artifact.d.ts","sourceRoot":"","sources":["../src/local/artifact.ts"],"names":[],"mappings":"AAkCA,gFAAgF;AAChF,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,CAAC,QAAQ,GAAG,MAAM,CAS9D;AAED,oFAAoF;AACpF,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CASnD;AAED,MAAM,WAAW,mBAAmB;IAClC,oCAAoC;IACpC,GAAG,EAAE,MAAM,CAAC;IACZ;;;;;;OAMG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,yDAAyD;IACzD,SAAS,EAAE,MAAM,CAAC;IAClB,kEAAkE;IAClE,OAAO,EAAE,MAAM,CAAC;IAChB,kFAAkF;IAClF,KAAK,EAAE,MAAM,CAAC;IACd;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,iDAAiD;IACjD,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;IACzB,2DAA2D;IAC3D,KAAK,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CACvC;AAED;;;;GAIG;AACH,MAAM,MAAM,SAAS,GAAG,QAAQ,GAAG,QAAQ,GAAG,UAAU,CAAC;AAEzD,4CAA4C;AAC5C,MAAM,MAAM,cAAc,GAAG;IAAE,MAAM,EAAE,OAAO,CAAA;CAAE,GAAG;IAAE,MAAM,EAAE,SAAS,CAAC;IAAC,KAAK,EAAE,SAAS,CAAA;CAAE,CAAC;AAE3F,oEAAoE;AACpE,eAAO,MAAM,iBAAiB,IAAI,CAAC;AAEnC,4FAA4F;AAC5F,eAAO,MAAM,4BAA4B,OAAQ,CAAC;AAElD;;;;;;;;GAQG;AACH,wBAAsB,kBAAkB,CAAC,GAAG,EAAE,mBAAmB,GAAG,OAAO,CAAC,cAAc,CAAC,CAsC1F;AAqED,uCAAuC;AACvC,wBAAgB,SAAS,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,CAEnD;AAmED;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAOrE;AASD;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI,CAoBhF"}
1
+ {"version":3,"file":"artifact.d.ts","sourceRoot":"","sources":["../src/local/artifact.ts"],"names":[],"mappings":"AAuCA,OAAO,EAAE,iBAAiB,EAAE,4BAA4B,EAAE,eAAe,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AAEnI,gFAAgF;AAChF,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,CAAC,QAAQ,GAAG,MAAM,CAS9D;AAED,oFAAoF;AACpF,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CASnD;AAED,MAAM,WAAW,mBAAmB;IAClC,oCAAoC;IACpC,GAAG,EAAE,MAAM,CAAC;IACZ;;;;;;OAMG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,yDAAyD;IACzD,SAAS,EAAE,MAAM,CAAC;IAClB,kEAAkE;IAClE,OAAO,EAAE,MAAM,CAAC;IAChB,kFAAkF;IAClF,KAAK,EAAE,MAAM,CAAC;IACd;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,iDAAiD;IACjD,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;IACzB,2DAA2D;IAC3D,KAAK,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CACvC;AAED;;;;GAIG;AACH,MAAM,MAAM,SAAS,GAAG,QAAQ,GAAG,QAAQ,GAAG,UAAU,CAAC;AAEzD,4CAA4C;AAC5C,MAAM,MAAM,cAAc,GAAG;IAAE,MAAM,EAAE,OAAO,CAAA;CAAE,GAAG;IAAE,MAAM,EAAE,SAAS,CAAC;IAAC,KAAK,EAAE,SAAS,CAAA;CAAE,CAAC;AAE3F;;;;;;;;GAQG;AACH,wBAAsB,kBAAkB,CAAC,GAAG,EAAE,mBAAmB,GAAG,OAAO,CAAC,cAAc,CAAC,CAsC1F"}