@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
@@ -9,25 +9,32 @@
9
9
  // no-auth posture are fixed) and "cloud" (where `stigmer auth login` lands
10
10
  // by default).
11
11
  //
12
- // Legacy shape + migration: older files carried one `backend.cloud` slot
13
- // selected by `backend.type`. Loading migrates that shape in memory
14
- // (cloud section → `backends.cloud`, type → `current_backend`); the first
15
- // save writes the new shape — a one-time write migration. The
16
- // legacy `backend.type` is still WRITTEN (mirroring local vs non-local)
17
- // so older readers keep a coherent view, and the opaque `backend.local`
18
- // section (daemon/LLM/Temporal settings owned by other tools) is
19
- // preserved verbatim, exactly as before.
12
+ // The `backend.local` section (daemon/LLM/Temporal settings owned by the
13
+ // local-mode modules) is carried through verbatim, so a save never drops a key
14
+ // this module does not model.
15
+ //
16
+ // A save replaces the file in one step (a temporary file renamed over it), so a
17
+ // reader never sees it half-written. Many CLI processes write this file, and a
18
+ // long-running one (`stigmer mcp-server`) re-reads it while others save; a
19
+ // truncated file would parse as the default config and read as "no such
20
+ // backend". The temporary name carries the writer's pid so two processes never
21
+ // share one, and a config that is a symlink is written through its link.
20
22
 
21
- import { mkdirSync, readFileSync, writeFileSync } from "node:fs";
22
- import { dirname } from "node:path";
23
+ import {
24
+ mkdirSync,
25
+ readFileSync,
26
+ readlinkSync,
27
+ realpathSync,
28
+ renameSync,
29
+ rmSync,
30
+ writeFileSync,
31
+ } from "node:fs";
32
+ import { dirname, resolve } from "node:path";
23
33
  import { parse as parseYaml, stringify as stringifyYaml } from "yaml";
24
34
  import { UsageError } from "../errors/index.js";
25
35
  import { isStandalone } from "../runtime.js";
26
36
  import { configPath } from "./paths.js";
27
37
 
28
- /** The legacy binary switch, still written as a mirror for older readers. */
29
- export type BackendType = "local" | "cloud";
30
-
31
38
  /** The two named-backend families: Stigmer Cloud, or any OSS server. */
32
39
  export type NamedBackendType = "cloud" | "selfhost";
33
40
 
@@ -60,23 +67,10 @@ export interface NamedBackendConfig {
60
67
  api_key?: string;
61
68
  }
62
69
 
63
- /** Cloud backend connection — the LEGACY single-slot shape (older files). */
64
- export interface CloudBackendConfig {
65
- endpoint?: string;
66
- token?: string;
67
- org_id?: string;
68
- env_id?: string;
69
- refresh_token?: string;
70
- token_expiry?: string;
71
- }
72
-
73
70
  export interface BackendConfig {
74
- type: BackendType;
75
- /** Local daemon/LLM/Temporal settings — opaque to this CLI,
76
- * preserved verbatim across save so coexisting tools keep their config. */
71
+ /** Local daemon/LLM/Temporal settings — opaque to this module,
72
+ * preserved verbatim across save so the local-mode modules keep their config. */
77
73
  local?: unknown;
78
- /** Legacy cloud slot — read for migration, never written back. */
79
- cloud?: CloudBackendConfig;
80
74
  }
81
75
 
82
76
  export interface ContextConfig {
@@ -122,7 +116,7 @@ const SAVE_HEADER = `# Stigmer CLI Configuration
122
116
  /** The default config: the local backend, no daemon settings fabricated. */
123
117
  export function getDefault(): Config {
124
118
  return {
125
- backend: { type: "local" },
119
+ backend: {},
126
120
  backends: {},
127
121
  current_backend: LOCAL_BACKEND_NAME,
128
122
  };
@@ -131,7 +125,7 @@ export function getDefault(): Config {
131
125
  /**
132
126
  * Load the config from disk. In standalone mode the file is ignored and the
133
127
  * default is returned, isolating sidecar/automation invocations from ambient
134
- * user config (matches the Go CLI). A missing file also yields the default.
128
+ * user config. A missing file also yields the default.
135
129
  */
136
130
  export function load(path: string = configPath()): Config {
137
131
  if (isStandalone()) {
@@ -152,16 +146,40 @@ export function load(path: string = configPath()): Config {
152
146
 
153
147
  /**
154
148
  * Persist the config to disk (0600 file in a 0755 directory), with the
155
- * documentation header the file has always carried. Writes the NAMED shape
156
- * (the one-time migration): the legacy cloud slot is dropped — its content
157
- * lives in `backends.cloud` — and `backend.type` is written as the
158
- * local-vs-not mirror. A pristine local config (no named backends) writes
159
- * exactly the legacy bytes.
149
+ * documentation header, replacing the file in one step. A pristine local config
150
+ * (no named backends) writes no backend keys at all.
160
151
  */
161
152
  export function save(config: Config, path: string = configPath()): void {
162
153
  mkdirSync(dirname(path), { recursive: true, mode: 0o755 });
163
154
  const body = stringifyYaml(stripUndefined(serializable(config)));
164
- writeFileSync(path, SAVE_HEADER + body, { mode: 0o600 });
155
+ const target = writeTarget(path);
156
+ const temporary = `${target}.${process.pid}.tmp`;
157
+ try {
158
+ writeFileSync(temporary, SAVE_HEADER + body, { mode: 0o600 });
159
+ renameSync(temporary, target);
160
+ } catch (err) {
161
+ rmSync(temporary, { force: true });
162
+ throw err;
163
+ }
164
+ }
165
+
166
+ /**
167
+ * The file a save replaces: the config itself, or, when it is a symlink, the
168
+ * file the link points at, so the rename keeps the link instead of replacing
169
+ * it with a regular file. A link whose target does not exist yet is written
170
+ * where it points, as a plain write through the link would.
171
+ */
172
+ function writeTarget(path: string): string {
173
+ try {
174
+ return realpathSync(path);
175
+ } catch {
176
+ // Missing, or a link whose target is missing: read the link, if it is one.
177
+ }
178
+ try {
179
+ return resolve(dirname(path), readlinkSync(path));
180
+ } catch {
181
+ return path;
182
+ }
165
183
  }
166
184
 
167
185
  /** The active backend's name (normalize always stamps current_backend). */
@@ -203,31 +221,14 @@ function normalize(parsed: Partial<Config> | null): Config {
203
221
  return getDefault();
204
222
  }
205
223
 
206
- const legacy = parsed.backend;
207
- const backends = normalizeBackends(parsed.backends);
208
-
209
- // Migration: a legacy cloud slot becomes the reserved "cloud" entry —
210
- // unless a named shape already exists (then the named shape wins and the
211
- // stale legacy slot is ignored).
212
- if (Object.keys(backends).length === 0 && legacy?.cloud !== undefined) {
213
- backends[CLOUD_BACKEND_NAME] = { type: "cloud", ...legacy.cloud };
214
- }
215
-
216
- let current =
217
- typeof parsed.current_backend === "string" ? parsed.current_backend : "";
218
- if (current === "") {
219
- current =
220
- legacy?.type === "cloud" && backends[CLOUD_BACKEND_NAME] !== undefined
221
- ? CLOUD_BACKEND_NAME
222
- : LOCAL_BACKEND_NAME;
223
- }
224
+ const current =
225
+ typeof parsed.current_backend === "string" && parsed.current_backend !== ""
226
+ ? parsed.current_backend
227
+ : LOCAL_BACKEND_NAME;
224
228
 
225
229
  return {
226
- backend: {
227
- type: legacy?.type === "cloud" ? "cloud" : "local",
228
- local: legacy?.local,
229
- },
230
- backends,
230
+ backend: { local: parsed.backend?.local },
231
+ backends: normalizeBackends(parsed.backends),
231
232
  current_backend: current,
232
233
  context: parsed.context,
233
234
  marketplaces: normalizeMarketplaces(parsed.marketplaces),
@@ -266,20 +267,16 @@ function normalizeBackends(
266
267
  return backends;
267
268
  }
268
269
 
269
- /** The on-disk shape: named model + legacy mirror, minimal for defaults. */
270
- function serializable(config: Config): Config {
270
+ /** The on-disk shape, minimal for defaults. */
271
+ function serializable(config: Config): Partial<Config> {
271
272
  const backends = config.backends ?? {};
272
273
  const current = activeBackendName(config);
273
274
  const pristineLocal =
274
275
  Object.keys(backends).length === 0 && current === LOCAL_BACKEND_NAME;
275
276
  return {
276
- backend: {
277
- // The legacy mirror: local stays "local"; anything named is "cloud"
278
- // to older readers (which cannot represent selfhost anyway).
279
- type: current === LOCAL_BACKEND_NAME ? "local" : "cloud",
280
- local: config.backend.local,
281
- // The legacy cloud slot is never written back — migrated.
282
- },
277
+ ...(config.backend.local === undefined
278
+ ? {}
279
+ : { backend: { local: config.backend.local } }),
283
280
  ...(pristineLocal ? {} : { backends, current_backend: current }),
284
281
  context: config.context,
285
282
  marketplaces: config.marketplaces,
@@ -287,7 +284,7 @@ function serializable(config: Config): Config {
287
284
  }
288
285
 
289
286
  // Recursively drop undefined-valued keys so the serialized YAML omits empty
290
- // optionals (matching Go's yaml omitempty), while preserving the opaque local
287
+ // optionals, while preserving the opaque local
291
288
  // section untouched.
292
289
  function stripUndefined<T>(value: T): T {
293
290
  if (Array.isArray(value)) {
@@ -2,8 +2,6 @@
2
2
 
3
3
  export {
4
4
  type BackendConfig,
5
- type BackendType,
6
- type CloudBackendConfig,
7
5
  type Config,
8
6
  type ContextConfig,
9
7
  type MarketplaceEntryConfig,
@@ -27,6 +25,7 @@ export {
27
25
  resolveContextOrganization,
28
26
  resolveEndpoint,
29
27
  resolveOrganization,
28
+ resolveServerAddress,
30
29
  resolveToken,
31
30
  } from "./resolve.js";
32
31
  export { configDir, configPath, dataDir } from "./paths.js";
@@ -17,10 +17,10 @@ interface ConfigKey {
17
17
  set(config: Config, value: string): void;
18
18
  }
19
19
 
20
- // The backend.cloud.* keys predate named backends and remain the documented
21
- // kv surface for the reserved "cloud" entry; `current_backend` is the named
22
- // model's own key. `backend.type` stays the simple local/cloud switch
23
- // (named backends switch through `config backend use`).
20
+ // The backend.cloud.* keys are the kv surface for the reserved "cloud" entry;
21
+ // `current_backend` is the named model's own key. `backend.type` is the simple
22
+ // local/cloud switch over it (named backends switch through
23
+ // `config backend use`).
24
24
  const KEYS: Record<string, ConfigKey> = {
25
25
  "backend.type": {
26
26
  get: (config) =>
@@ -1,5 +1,5 @@
1
- // Filesystem locations for CLI configuration and local data. Mirrors the Go
2
- // CLI's config path helpers (~/.stigmer/...). Functions take the home dir as a
1
+ // Filesystem locations for CLI configuration and local data (~/.stigmer/...).
2
+ // Functions take the home dir as a
3
3
  // parameter (defaulting to os.homedir()) so tests can redirect them cleanly.
4
4
 
5
5
  import { homedir } from "node:os";
@@ -1,6 +1,6 @@
1
1
  // Effective-value resolution with env > config > default precedence. These are
2
2
  // the settings the backend client and read verbs depend on; centralizing the
3
- // precedence keeps every call site consistent (mirrors the Go CLI's Resolve*).
3
+ // precedence keeps every call site consistent.
4
4
  //
5
5
  // All resolvers read the ACTIVE named backend (config.ts): local is the
6
6
  // managed daemon (fixed endpoint, never requires auth), cloud entries carry
@@ -8,9 +8,11 @@
8
8
 
9
9
  import { CliExitError, ExitCode } from "../errors/index.js";
10
10
  import { SERVER_PORT } from "../local/constants.js";
11
+ import type { ServerAddress } from "../runtime.js";
11
12
  import { type Config, activeBackend } from "./config.js";
12
13
 
13
- const DEFAULT_CLOUD_ENDPOINT = "api.stigmer.ai:443";
14
+ /** Stigmer Cloud's API, where a cloud entry with no endpoint of its own points. */
15
+ export const DEFAULT_CLOUD_ENDPOINT = "api.stigmer.ai:443";
14
16
  const DEFAULT_LOCAL_ENDPOINT = "localhost:7234";
15
17
 
16
18
  /** Well-known URL for the Stigmer Cloud web console. */
@@ -27,19 +29,29 @@ export const DEFAULT_CLOUD_CONSOLE_URL = "https://app.stigmer.ai";
27
29
  * files, and guessing an address for a self-hosted server helps nobody.
28
30
  */
29
31
  export function resolveEndpoint(config: Config): string {
32
+ return resolveServerAddress(config).address;
33
+ }
34
+
35
+ /**
36
+ * The endpoint {@link resolveEndpoint} names, with where it came from: the
37
+ * override's name, or the active backend's kind. The backend client records
38
+ * it when made, so a failure names the address tried and the fix that fits
39
+ * its source.
40
+ */
41
+ export function resolveServerAddress(config: Config): ServerAddress {
30
42
  const override = process.env.STIGMER_SERVER_ADDRESS;
31
43
  if (override !== undefined && override !== "") {
32
- return override;
44
+ return { address: override, source: "environment" };
33
45
  }
34
46
  const { name, entry } = activeBackend(config);
35
47
  if (entry === undefined) {
36
- return DEFAULT_LOCAL_ENDPOINT;
48
+ return { address: DEFAULT_LOCAL_ENDPOINT, source: "local" };
37
49
  }
38
50
  if (entry.endpoint !== undefined && entry.endpoint !== "") {
39
- return entry.endpoint;
51
+ return { address: entry.endpoint, source: entry.type };
40
52
  }
41
53
  if (entry.type === "cloud") {
42
- return DEFAULT_CLOUD_ENDPOINT;
54
+ return { address: DEFAULT_CLOUD_ENDPOINT, source: "cloud" };
43
55
  }
44
56
  throw new CliExitError(
45
57
  `backend "${name}" has no endpoint configured`,
@@ -72,7 +84,7 @@ export function resolveToken(config: Config): string {
72
84
  /**
73
85
  * Resolve the active organization.
74
86
  * --org flag override > STIGMER_ORG env > context.org
75
- * > the active entry's org_id (legacy fallback)
87
+ * > the active entry's org_id (`config set backend.cloud.org_id`)
76
88
  */
77
89
  export function resolveOrganization(config: Config, flagOrg?: string): string {
78
90
  if (flagOrg !== undefined && flagOrg !== "") {
@@ -98,7 +110,7 @@ export function resolveOrganization(config: Config, flagOrg?: string): string {
98
110
  * 1. `STIGMER_CONSOLE_URL` (explicit override)
99
111
  * 2. local daemon → `http://localhost:{SERVER_PORT}` — the server's own
100
112
  * unified port serves the console (one origin for UI and
101
- * API; the Go-era separate 8234 listener is retired)
113
+ * API)
102
114
  * 3. selfhost → the entry's endpoint on the same one-origin rule
103
115
  * (https for :443, http otherwise)
104
116
  * 4. cloud → {@link DEFAULT_CLOUD_CONSOLE_URL}
@@ -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,11 +14,27 @@
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
 
19
28
  import { Code, ConnectError } from "@connectrpc/connect";
20
29
  import { getErrorReason, StigmerError } from "@stigmer/client";
21
30
  import { CliExitError } from "./cli-exit-error.js";
22
- import { ExitCode } from "./exit-codes.js";
31
+ import { ExitCode } from "@stigmer/client/exit-codes";
32
+ import {
33
+ actionCommandPath,
34
+ actionResourceType,
35
+ dialedServerAddress,
36
+ type ServerAddress,
37
+ } from "../runtime.js";
23
38
 
24
39
  /**
25
40
  * Structured result of classifying a raw error. `classify` produces these and
@@ -54,8 +69,7 @@ export function classify(err: unknown): CliError | null {
54
69
 
55
70
  // Local cancellation (Ctrl-C / AbortController) is a clean outcome, not a
56
71
  // failure — exit 0 silently. A *remote* Canceled status is a genuine failure
57
- // and falls through to classifyConnectCode (exit 1). This is the one place
58
- // the TS CLI deliberately improves on the Go CLI, which exits 1 for both.
72
+ // and falls through to classifyConnectCode (exit 1).
59
73
  if (isLocalAbort(err)) {
60
74
  return { exitCode: ExitCode.Success, message: "", cause: toError(err) };
61
75
  }
@@ -107,9 +121,8 @@ interface CodedError {
107
121
  readonly message: string;
108
122
  }
109
123
 
110
- // Walks the cause chain for the first SDK StigmerError or raw ConnectError.
111
- // status.FromError in Go only checks the outermost error; this mirrors the Go
112
- // CLI's extractGRPCStatus which walks Unwrap to handle wrapped RPC errors.
124
+ // Walks the cause chain for the first SDK StigmerError or raw ConnectError, so
125
+ // a wrapped RPC error still classifies by its status.
113
126
  function extractCoded(err: unknown): CodedError | undefined {
114
127
  let depth = 0;
115
128
  for (let current: unknown = err; current != null && depth < MAX_CHAIN_DEPTH; current = causeOf(current), depth++) {
@@ -123,6 +136,26 @@ function extractCoded(err: unknown): CodedError | undefined {
123
136
  return undefined;
124
137
  }
125
138
 
139
+ // The network's own refusals, by the code Node gives them or the words its
140
+ // fetch and HTTP/2 client use: no connection, no address, a reset or a hang-up.
141
+ 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+/;
142
+
143
+ /**
144
+ * Whether an Unavailable is the transport's (the request never reached a
145
+ * server) rather than a server's answer: its message, or an error in its
146
+ * cause chain, names a network failure.
147
+ */
148
+ export function isTransportFailure(message: string, cause: unknown): boolean {
149
+ if (TRANSPORT_FAILURE.test(message)) return true;
150
+ let depth = 0;
151
+ for (let current: unknown = cause; current != null && depth < MAX_CHAIN_DEPTH; current = causeOf(current), depth++) {
152
+ const errno = (current as { code?: unknown }).code;
153
+ if (typeof errno === "string" && TRANSPORT_FAILURE.test(errno)) return true;
154
+ if (current instanceof Error && TRANSPORT_FAILURE.test(current.message)) return true;
155
+ }
156
+ return false;
157
+ }
158
+
126
159
  function isLocalAbort(err: unknown): boolean {
127
160
  let depth = 0;
128
161
  for (let current: unknown = err; current != null && depth < MAX_CHAIN_DEPTH; current = causeOf(current), depth++) {
@@ -136,13 +169,12 @@ function isLocalAbort(err: unknown): boolean {
136
169
  function classifyConnectCode(code: number, message: string, cause: Error): CliError {
137
170
  switch (code) {
138
171
  case Code.Unavailable:
139
- return {
140
- exitCode: ExitCode.Connection,
141
- code,
142
- cause,
143
- message: "Cannot connect to the Stigmer server",
144
- hints: ["Make sure the Stigmer server is running and reachable."],
145
- };
172
+ // A request that never reached the server names the address it was
173
+ // sent to; one the server answered with Unavailable keeps its words.
174
+ if (isTransportFailure(message, cause)) {
175
+ return { exitCode: ExitCode.Connection, code, cause, ...cannotConnect(dialedServerAddress()) };
176
+ }
177
+ return { exitCode: ExitCode.Connection, code, cause, message, hints: ["The server could not take the request just now. Try again in a moment."] };
146
178
 
147
179
  case Code.DeadlineExceeded:
148
180
  return {
@@ -163,16 +195,16 @@ function classifyConnectCode(code: number, message: string, cause: Error): CliEr
163
195
  };
164
196
 
165
197
  case Code.NotFound:
166
- return { exitCode: ExitCode.NotFound, code, cause, message };
198
+ return { exitCode: ExitCode.NotFound, code, cause, message, hints: [notFoundHint()] };
167
199
 
168
200
  case Code.InvalidArgument:
169
- return { exitCode: ExitCode.Usage, code, cause, message };
201
+ return { exitCode: ExitCode.Usage, code, cause, message, hints: [helpHint()] };
170
202
 
171
203
  case Code.FailedPrecondition:
172
- return { exitCode: ExitCode.Usage, code, cause, message: `Precondition failed: ${message}` };
204
+ return { exitCode: ExitCode.Usage, code, cause, message: `Precondition failed: ${message}`, hints: [helpHint()] };
173
205
 
174
206
  case Code.AlreadyExists:
175
- return { exitCode: ExitCode.Usage, code, cause, message: `Already exists: ${message}` };
207
+ return { exitCode: ExitCode.Usage, code, cause, message: `Already exists: ${message}`, hints: [helpHint()] };
176
208
 
177
209
  case Code.Unauthenticated:
178
210
  return {
@@ -214,7 +246,13 @@ function classifyConnectCode(code: number, message: string, cause: Error): CliEr
214
246
  };
215
247
 
216
248
  case Code.Canceled:
217
- return { exitCode: ExitCode.General, code, cause, message: "Operation cancelled" };
249
+ return {
250
+ exitCode: ExitCode.General,
251
+ code,
252
+ cause,
253
+ message: "Operation cancelled",
254
+ hints: ["The server cancelled the request. Try again."],
255
+ };
218
256
 
219
257
  default:
220
258
  return {
@@ -222,10 +260,61 @@ function classifyConnectCode(code: number, message: string, cause: Error): CliEr
222
260
  code,
223
261
  cause,
224
262
  message: `${codeName(code)}: ${message}`,
263
+ hints: ["Run with --debug for more details."],
225
264
  };
226
265
  }
227
266
  }
228
267
 
268
+ /** What a failure to reach the server says: what was tried and what to do. */
269
+ export interface ConnectFailure {
270
+ readonly message: string;
271
+ readonly hints: readonly string[];
272
+ }
273
+
274
+ /**
275
+ * The words for a server that could not be reached at `address`, with the
276
+ * next step its source calls for: start the local daemon, check the named
277
+ * backend, or look at the override. With no address (no client was made)
278
+ * it names none. The connect timeout (client/client.ts) words itself with
279
+ * this too, so both failures read alike.
280
+ */
281
+ export function cannotConnect(address: ServerAddress | undefined): ConnectFailure {
282
+ // The next step for a named backend, and for a failure that names no
283
+ // address: the status command prints the active backend and its endpoint.
284
+ const checkBackend = "Check the backend: stigmer config backend status";
285
+ if (address === undefined) {
286
+ return { message: "Could not reach the Stigmer server", hints: [checkBackend] };
287
+ }
288
+ switch (address.source) {
289
+ case "environment":
290
+ return {
291
+ message: `Could not reach the Stigmer server at ${address.address} (set by STIGMER_SERVER_ADDRESS)`,
292
+ hints: ["Start the server it names, or unset STIGMER_SERVER_ADDRESS to use the active backend."],
293
+ };
294
+ case "local":
295
+ return { message: `Could not reach the Stigmer server at ${address.address}`, hints: ["Start it: stigmer up"] };
296
+ case "cloud":
297
+ case "selfhost":
298
+ return { message: `Could not reach the Stigmer server at ${address.address}`, hints: [checkBackend] };
299
+ }
300
+ }
301
+
302
+ // A missing resource: the list of its type when the running command
303
+ // recorded one (get, delete and download do), else the two things a
304
+ // reference is made of.
305
+ function notFoundHint(): string {
306
+ const type = actionResourceType();
307
+ return type === "" ? "Check the reference and the organization (--org)." : `Check the reference: stigmer list ${type}`;
308
+ }
309
+
310
+ // A refused request: the running command's help, worded as a command-line
311
+ // refusal words it (errors/command-line.ts); the root's before any command
312
+ // ran.
313
+ function helpHint(): string {
314
+ const path = actionCommandPath();
315
+ return `Run \`${path === "" ? "stigmer" : path} --help\` for usage.`;
316
+ }
317
+
229
318
  function causeOf(value: unknown): unknown {
230
319
  return value !== null && typeof value === "object"
231
320
  ? (value as { cause?: unknown }).cause
@@ -0,0 +1,95 @@
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
+
25
+ import type { Command, CommanderError } from "commander";
26
+ import { ExitCode } from "@stigmer/client/exit-codes";
27
+ import { commandPath, everyCommand, registeredArguments } from "../command-tree.js";
28
+ import { CliExitError } from "./cli-exit-error.js";
29
+
30
+ /** A refusal of the command line itself, carrying Commander's code (`commander.unknownOption`). */
31
+ export class CommandLineError extends CliExitError {
32
+ readonly code: string;
33
+
34
+ constructor(message: string, exitCode: number, code: string, hints?: readonly string[]) {
35
+ super(message, exitCode, hints);
36
+ this.name = "CommandLineError";
37
+ this.code = code;
38
+ }
39
+ }
40
+
41
+ const USAGE_EXIT = new WeakMap<Command, number>();
42
+
43
+ /** Declare the code a usage error on `cmd` exits with, in place of 2 (module header). */
44
+ export function usageExitCode(cmd: Command, code: number): Command {
45
+ USAGE_EXIT.set(cmd, code);
46
+ return cmd;
47
+ }
48
+
49
+ /** Give every command in the tree its own exit callback and silence Commander's error output. */
50
+ export function installCommandLineErrors(program: Command): void {
51
+ for (const cmd of everyCommand(program)) {
52
+ cmd.exitOverride((error) => {
53
+ throw commandLineErrorOf(cmd, error);
54
+ });
55
+ cmd.configureOutput({ outputError: () => undefined });
56
+ }
57
+ }
58
+
59
+ /** The CLI's error for a Commander refusal on `cmd` (module header). */
60
+ export function commandLineErrorOf(cmd: Command, error: CommanderError): CommandLineError {
61
+ if (error.exitCode === 0) return new CommandLineError("", ExitCode.Success, error.code);
62
+ // A group run without its subcommand: its help is already on stderr.
63
+ const exitCode = USAGE_EXIT.get(cmd) ?? ExitCode.Usage;
64
+ if (error.code === "commander.help") return new CommandLineError("", exitCode, error.code);
65
+ const hint = `Run \`${commandPath(cmd)} --help\` for usage.`;
66
+ return new CommandLineError(wording(cmd, error), exitCode, error.code, [hint]);
67
+ }
68
+
69
+ function wording(cmd: Command, error: CommanderError): string {
70
+ if (error.code === "commander.excessArguments") return excessArguments(cmd, error.message);
71
+ const message = error.message.replace(/^error: /, "");
72
+ if (error.code === "commander.unknownOption") return unknownOption(message);
73
+ return message
74
+ .split("\n")
75
+ .map((line) => line.trim())
76
+ .filter((line) => line !== "")
77
+ .join(" ");
78
+ }
79
+
80
+ // Commander echoes an unknown option as typed, so `--name=VALUE` would print
81
+ // the value, newlines and all; the answer names the option alone, with
82
+ // Commander's suggestion when its last line is one (an option's name only).
83
+ function unknownOption(message: string): string {
84
+ const name = /^unknown option '(--[A-Za-z0-9-]+|-[A-Za-z0-9])/.exec(message)?.[1];
85
+ if (name === undefined) return "unknown option";
86
+ const suggestion = /\n(\(Did you mean --?[A-Za-z0-9-]+\?\))$/.exec(message)?.[1];
87
+ return suggestion === undefined ? `unknown option '${name}'` : `unknown option '${name}' ${suggestion}`;
88
+ }
89
+
90
+ function excessArguments(cmd: Command, message: string): string {
91
+ const expected = registeredArguments(cmd).length;
92
+ const got = /got (\d+)/.exec(message)?.[1];
93
+ const takes = expected === 0 ? "takes no arguments" : `takes ${expected} argument${expected === 1 ? "" : "s"}`;
94
+ return got === undefined ? `${commandPath(cmd)} ${takes}` : `${commandPath(cmd)} ${takes}, got ${got}`;
95
+ }
@@ -1,9 +1,9 @@
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
 
4
4
  import { isDebug } from "../runtime.js";
5
5
  import { type CliError, classify, codeName } from "./classify.js";
6
- import { ExitCode } from "./exit-codes.js";
6
+ import { ExitCode } from "@stigmer/client/exit-codes";
7
7
 
8
8
  /**
9
9
  * Render a CliError for stderr. In debug mode it appends the raw error chain
@@ -1,7 +1,17 @@
1
1
  // Public surface of the CLI error-handling module.
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).
2
12
 
3
- export { ExitCode } from "./exit-codes.js";
4
- export { type CliError, classify, codeName } from "./classify.js";
13
+ export { ExitCode } from "@stigmer/client/exit-codes";
14
+ export { cannotConnect, type CliError, classify, codeName, type ConnectFailure } from "./classify.js";
5
15
  export { CliExitError } from "./cli-exit-error.js";
6
16
  export { formatError, handle } from "./handle.js";
7
17
  export { UsageError } from "./usage-error.js";