@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
@@ -4,7 +4,7 @@
4
4
  // "usage" exit regardless of where validation happened.
5
5
 
6
6
  import { CliExitError } from "./cli-exit-error.js";
7
- import { ExitCode } from "./exit-codes.js";
7
+ import { ExitCode } from "@stigmer/client/exit-codes";
8
8
 
9
9
  export class UsageError extends CliExitError {
10
10
  constructor(message: string) {
@@ -0,0 +1,100 @@
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
+
24
+ import { type Command, type HelpConfiguration, Option } from "commander";
25
+ import { runnableCommands } from "./command-tree.js";
26
+
27
+ /** A global option that may also follow the command. */
28
+ interface TrailingGlobal {
29
+ readonly flags: string;
30
+ readonly long: string;
31
+ readonly short?: string;
32
+ readonly description: string;
33
+ }
34
+
35
+ /** The global options that may be written after the command too, as the root declares them. */
36
+ export const TRAILING_GLOBALS: readonly TrailingGlobal[] = [
37
+ { flags: "-d, --debug", long: "--debug", short: "-d", description: "enable debug output" },
38
+ { flags: "--standalone", long: "--standalone", description: "ignore the config file; use flags and environment only" },
39
+ { flags: "--org <slug>", long: "--org", description: "organization, on servers that hold several" },
40
+ ];
41
+
42
+ /** Declare the trailing globals on the root, in help's order. */
43
+ export function addGlobalOptions(program: Command): Command {
44
+ for (const global of TRAILING_GLOBALS) program.option(global.flags, global.description);
45
+ return program.option("--api-key <key>", "API key for authentication (before the command)");
46
+ }
47
+
48
+ /** Give every runnable command hidden copies of the trailing globals it does not declare itself. */
49
+ export function acceptGlobalsAfterCommand(program: Command): void {
50
+ for (const cmd of runnableCommands(program)) {
51
+ for (const global of TRAILING_GLOBALS) {
52
+ if (cmd.options.some((option) => option.long === global.long)) continue;
53
+ const shortTaken = global.short !== undefined && cmd.options.some((option) => option.short === global.short);
54
+ const flags = shortTaken || global.short === undefined ? global.flags.replace(/^-\w, /, "") : global.flags;
55
+ cmd.addOption(new Option(flags, global.description).hideHelp());
56
+ }
57
+ }
58
+ }
59
+
60
+ /** The global options as the command that runs sees them: its own trailing copy first, then the root's. */
61
+ export interface GlobalOptions {
62
+ readonly debug: boolean;
63
+ readonly standalone: boolean;
64
+ /** The Stigmer API key, read from the root alone (module header). */
65
+ readonly apiKey: string;
66
+ }
67
+
68
+ /** An option's value on `cmd` or, when unset there, on the nearest command above it that has one. */
69
+ export function nearestOption(cmd: Command, key: string): unknown {
70
+ for (let current: Command | null = cmd; current !== null; current = current.parent) {
71
+ const value: unknown = current.opts()[key];
72
+ if (value !== undefined) return value;
73
+ }
74
+ return undefined;
75
+ }
76
+
77
+ /** Read the global options for the action command `action` under `root`. */
78
+ export function readGlobalOptions(root: Command, action: Command): GlobalOptions {
79
+ const apiKey = root.opts().apiKey;
80
+ return {
81
+ debug: Boolean(nearestOption(action, "debug")),
82
+ standalone: Boolean(nearestOption(action, "standalone")),
83
+ apiKey: typeof apiKey === "string" ? apiKey : "",
84
+ };
85
+ }
86
+
87
+ /**
88
+ * The help every command shows: the globals once per page, and each
89
+ * subcommand listed by its name alone, as gh and kubectl list theirs; its
90
+ * arguments and options are on its own help's usage line. (Commander's own
91
+ * term would print "[options]" for every command, since each holds the
92
+ * hidden global copies, and its arguments widen the list past 80 columns.)
93
+ */
94
+ export const helpConfiguration: HelpConfiguration = {
95
+ showGlobalOptions: true,
96
+ subcommandTerm: (cmd) => {
97
+ const alias = cmd.aliases()[0];
98
+ return alias === undefined ? cmd.name() : `${cmd.name()}|${alias}`;
99
+ },
100
+ };
@@ -1,13 +1,10 @@
1
- // Shared primitives for acquiring a single executable from a GitHub-release
2
- // `.tar.gz`: release platform/arch mapping, a fetch + gunzip + minimal tar
3
- // reader, optional sha256 verification, and an executable write.
1
+ // Acquiring a single executable from a GitHub-release `.tar.gz`: release
2
+ // platform/arch mapping, the cache below, and the CLI's exit errors, over the
3
+ // download contract in `@stigmer/artifact-fetch` (the retry rules, the digest
4
+ // check, the tar reader), which the runner shares for the Claude engine.
4
5
  //
5
6
  // The Temporal CLI downloader (`temporal/download.ts`) builds on this, and any
6
- // future release-binary downloader should too, so the fetch/verify/extract
7
- // contract lives in exactly one place. (The `stigmer-server` Go binary was its
8
- // second consumer until the server became an npm artifact.) The tar reader is a
9
- // tiny POSIX/ustar implementation: no native `tar` dependency, which keeps the
10
- // base install lean.
7
+ // future release-binary downloader should too.
11
8
  //
12
9
  // Retrying a transient failure is part of the contract. A connection that resets
13
10
  // before or during the body, a 5xx or a 429 is tried again with a doubling wait,
@@ -24,13 +21,23 @@
24
21
  // default: a user's machine already keeps the binary it installed, so
25
22
  // `stigmer up` and the image staging pass none.
26
23
 
27
- import { createHash } from "node:crypto";
28
- import { chmodSync, existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
24
+ import { chmodSync, existsSync, mkdirSync, readFileSync, renameSync, rmSync, writeFileSync } from "node:fs";
29
25
  import { dirname, join } from "node:path";
30
- import { setTimeout as delay } from "node:timers/promises";
26
+ import {
27
+ ArtifactFetchError,
28
+ describeFailure,
29
+ extractTarEntry,
30
+ fetchWithRetry,
31
+ network,
32
+ parseShasum,
33
+ sha256Hex,
34
+ type Network,
35
+ } from "@stigmer/artifact-fetch";
31
36
  import { gunzipSync } from "fflate";
32
37
  import { CliExitError } from "../errors/cli-exit-error.js";
33
- import { ExitCode } from "../errors/exit-codes.js";
38
+ import { ExitCode } from "@stigmer/client/exit-codes";
39
+
40
+ export { DOWNLOAD_ATTEMPTS, DOWNLOAD_RETRY_BASE_DELAY_MS, extractTarEntry, parseShasum, sha256Hex } from "@stigmer/artifact-fetch";
34
41
 
35
42
  /** Release OS token, matching the `<os>` segment of our release asset names. */
36
43
  export function mapReleaseOs(platform: NodeJS.Platform): string {
@@ -96,12 +103,6 @@ export type CacheMiss = "unused" | "absent" | "mismatch";
96
103
  /** Where the installed binary came from. */
97
104
  export type TarballInstall = { source: "cache" } | { source: "network"; cache: CacheMiss };
98
105
 
99
- /** Attempts per download before a transient failure is reported. */
100
- export const DOWNLOAD_ATTEMPTS = 4;
101
-
102
- /** The wait before the second attempt; it doubles before each later one (1 s, 2 s, 4 s). */
103
- export const DOWNLOAD_RETRY_BASE_DELAY_MS = 1_000;
104
-
105
106
  /**
106
107
  * Install the named entry of a `.tar.gz` at `binPath` with executable
107
108
  * permissions: from the cache directory when it holds a copy that matches its
@@ -131,7 +132,7 @@ export async function fetchTarballBinary(src: TarballBinarySource): Promise<Tarb
131
132
  }
132
133
  }
133
134
 
134
- const net: Download = { doFetch: src.fetchImpl ?? fetch, sleep: src.sleep ?? delay };
135
+ const net = network({ fetchImpl: src.fetchImpl, sleep: src.sleep });
135
136
  const archive = await fetchBytes(net, src.url, src.label);
136
137
  let checksums: string | undefined;
137
138
  if (src.checksumUrl !== undefined) {
@@ -164,9 +165,15 @@ function compareDigest(
164
165
  return { matches: expected !== "" && expected === actual, expected, actual };
165
166
  }
166
167
 
167
- // Extract the entry from verified archive bytes and write it executable.
168
+ // Extract the entry from verified archive bytes and put it in place executable.
168
169
  // `origin` is where the bytes came from (the URL, or the cached file), so an
169
170
  // archive without the entry is reported against the copy that lacked it.
171
+ //
172
+ // The binary is written beside its destination and renamed over it, never
173
+ // written in place: an install may replace a binary that is running (Linux
174
+ // refuses to write one, ETXTBSY), and a crash mid-write must not leave a
175
+ // truncated binary that the next run takes for an installed one. The temp file
176
+ // is removed when either step fails.
170
177
  function installEntry(archive: Uint8Array, src: TarballBinarySource, origin: string): void {
171
178
  const tarBytes = gunzipSync(archive);
172
179
  const binary = extractTarEntry(tarBytes, src.entryName);
@@ -177,8 +184,15 @@ function installEntry(archive: Uint8Array, src: TarballBinarySource, origin: str
177
184
  }
178
185
 
179
186
  mkdirSync(dirname(src.binPath), { recursive: true });
180
- writeFileSync(src.binPath, binary, { mode: 0o755 });
181
- chmodSync(src.binPath, 0o755);
187
+ const staged = `${src.binPath}.${process.pid}.tmp`;
188
+ try {
189
+ writeFileSync(staged, binary, { mode: 0o755 });
190
+ chmodSync(staged, 0o755);
191
+ renameSync(staged, src.binPath);
192
+ } catch (err) {
193
+ rmSync(staged, { force: true });
194
+ throw err;
195
+ }
182
196
  }
183
197
 
184
198
  // A cached pair is named by the archive, which carries the version, so an entry
@@ -218,90 +232,21 @@ function writeCachedPair(paths: CachePaths, archive: Uint8Array, checksums: stri
218
232
  }
219
233
  }
220
234
 
221
- /** Lowercase hex sha256 of `bytes`. */
222
- export function sha256Hex(bytes: Uint8Array): string {
223
- return createHash("sha256").update(bytes).digest("hex");
224
- }
225
-
226
- // The network a download runs over: the fetch it calls and the wait between attempts.
227
- interface Download {
228
- doFetch: typeof fetch;
229
- sleep: (ms: number) => Promise<void>;
230
- }
231
-
232
- async function fetchBytes(net: Download, url: string, label: string): Promise<Uint8Array> {
233
- return fetchWithRetry(net, url, label, async (res) => new Uint8Array(await res.arrayBuffer()));
234
- }
235
-
236
- async function fetchText(net: Download, url: string, label: string): Promise<string> {
237
- return fetchWithRetry(net, url, label, (res) => res.text());
238
- }
239
-
240
- // One download, with its body read inside the attempt: a connection that drops
241
- // after the headers is as transient as one that never connects, and is retried
242
- // the same way. The error after the last attempt carries the last failure's
243
- // cause, which for Node's fetch is the socket error behind "fetch failed".
244
- async function fetchWithRetry<T>(
245
- net: Download,
246
- url: string,
247
- label: string,
248
- read: (res: Response) => Promise<T>,
249
- ): Promise<T> {
250
- let lastFailure = "";
251
- for (let attempt = 1; attempt <= DOWNLOAD_ATTEMPTS; attempt++) {
252
- if (attempt > 1) await net.sleep(DOWNLOAD_RETRY_BASE_DELAY_MS * 2 ** (attempt - 2));
253
-
254
- let res: Response;
255
- try {
256
- res = await net.doFetch(url);
257
- } catch (err) {
258
- lastFailure = describeFailure(err);
259
- continue;
260
- }
261
- if (!res.ok) {
262
- if (!isTransientStatus(res.status)) {
263
- throw new CliExitError(`failed to download ${label}: HTTP ${res.status} from ${url}`, ExitCode.General);
264
- }
265
- lastFailure = `HTTP ${res.status}`;
266
- continue;
267
- }
268
- try {
269
- return await read(res);
270
- } catch (err) {
271
- lastFailure = describeFailure(err);
272
- }
273
- }
274
- throw new CliExitError(
275
- `failed to download ${label} from ${url} after ${DOWNLOAD_ATTEMPTS} attempts: ${lastFailure}`,
276
- ExitCode.General,
277
- ["check the network connection, then run the command again"],
278
- );
235
+ async function fetchBytes(net: Network, url: string, label: string): Promise<Uint8Array> {
236
+ return asExitError(() => fetchWithRetry(net, url, label, async (res) => new Uint8Array(await res.arrayBuffer())));
279
237
  }
280
238
 
281
- // A server error or a rate limit may clear on its own; any other status will not.
282
- function isTransientStatus(status: number): boolean {
283
- return status >= 500 || status === 429;
239
+ async function fetchText(net: Network, url: string, label: string): Promise<string> {
240
+ return asExitError(() => fetchWithRetry(net, url, label, (res) => res.text()));
284
241
  }
285
242
 
286
- function describeFailure(err: unknown): string {
287
- if (!(err instanceof Error)) return String(err);
288
- return err.cause instanceof Error ? `${err.message}: ${err.cause.message}` : err.message;
289
- }
290
-
291
- /**
292
- * The sha256 a `shasum`/`sha256sum`-format file records for `filename`, lowercase
293
- * hex, or "" when the file has no entry for it. Each line is "<hex> <filename>";
294
- * `sha256sum -b` writes the filename with a leading "*" (binary mode), which is
295
- * not part of the name. A release-wide file lists every asset, so the match is
296
- * by filename, never by position.
297
- */
298
- export function parseShasum(content: string, filename: string): string {
299
- for (const line of content.split("\n")) {
300
- const [hex, name] = line.trim().split(/\s+/, 2);
301
- if (hex === undefined || name === undefined) continue;
302
- if (name.replace(/^\*/, "") === filename) return hex.toLowerCase();
243
+ // The library's failures, as the CLI's exit error with the same message and hints.
244
+ async function asExitError<T>(run: () => Promise<T>): Promise<T> {
245
+ try {
246
+ return await run();
247
+ } catch (err) {
248
+ throw err instanceof ArtifactFetchError ? new CliExitError(err.message, ExitCode.General, err.details.length > 0 ? err.details : undefined) : err;
303
249
  }
304
- return "";
305
250
  }
306
251
 
307
252
  // The archive's basename as the checksum file names it: the last path segment
@@ -310,42 +255,3 @@ function archiveBasename(url: string): string {
310
255
  const segments = new URL(url).pathname.split("/");
311
256
  return segments[segments.length - 1] ?? "";
312
257
  }
313
-
314
- /**
315
- * Extract a single regular-file entry whose basename matches `name` from an
316
- * (uncompressed) tar buffer. Minimal POSIX/ustar reader: 512-byte header blocks,
317
- * octal size at offset 124, type flag at 156, data padded to 512 bytes.
318
- */
319
- export function extractTarEntry(buf: Uint8Array, name: string): Uint8Array | null {
320
- let offset = 0;
321
- while (offset + 512 <= buf.length) {
322
- const header = buf.subarray(offset, offset + 512);
323
- const entryName = readCString(header, 0, 100);
324
- if (entryName === "") break; // zero block marks end of archive
325
-
326
- const size = Number.parseInt(readCString(header, 124, 12).trim() || "0", 8) || 0;
327
- const typeFlag = String.fromCharCode(header[156] ?? 0);
328
- const dataStart = offset + 512;
329
-
330
- const isRegularFile = typeFlag === "0" || typeFlag === "\0";
331
- if (isRegularFile && basename(entryName) === name) {
332
- return buf.subarray(dataStart, dataStart + size);
333
- }
334
-
335
- // Advance past this entry's data, rounded up to the 512-byte block size.
336
- offset = dataStart + Math.ceil(size / 512) * 512;
337
- }
338
- return null;
339
- }
340
-
341
- function readCString(block: Uint8Array, start: number, length: number): string {
342
- let end = start;
343
- const limit = start + length;
344
- while (end < limit && block[end] !== 0) end += 1;
345
- return Buffer.from(block.subarray(start, end)).toString("utf8");
346
- }
347
-
348
- function basename(path: string): string {
349
- const parts = path.split("/");
350
- return parts[parts.length - 1] ?? path;
351
- }
@@ -7,12 +7,11 @@
7
7
  // runner-poll can never drift.
8
8
 
9
9
  /**
10
- * Port `stigmer-server` listens on (gRPC). Matches the Go CLI's `DaemonPort`.
10
+ * Port `stigmer-server` listens on (gRPC).
11
11
  *
12
12
  * This is also the web console's origin: the server serves the
13
- * console's static export on this same unified port (lane 4), so the Go-era
14
- * WEB_CONSOLE_PORT (8234, a separate CLI-embedded listener) is retired —
15
- * one process, one origin, no CORS hop.
13
+ * console's static export on this same unified port (lane 4) — one
14
+ * process, one origin, no CORS hop.
16
15
  */
17
16
  export const SERVER_PORT = 7234;
18
17
 
@@ -29,11 +28,6 @@ export const TEMPORAL_NAMESPACE = "default";
29
28
  * The Temporal task queue the unified runner polls and the server dispatches
30
29
  * to. This is the single source of truth, pinned identically on both the
31
30
  * launched server and the runner so they can never diverge.
32
- *
33
- * Note: the Go CLI daemon still sets the runner to the stale
34
- * `agent_execution_runner` queue while the server dispatches to
35
- * `stigmer_runner` (the unified TS runner queue) — a latent hang. The TS CLI
36
- * uses the correct value; a Go follow-up tracks fixing the daemon env.
37
31
  */
38
32
  export const RUNNER_TASK_QUEUE = "stigmer_runner";
39
33
 
@@ -11,21 +11,39 @@ import { dirname, join } from "node:path";
11
11
  import { RUNNER_TASK_QUEUE, RUNNER_READY_MARKER, SERVER_PID_FILE, RUNNER_PID_FILE, SERVER_PORT, TEMPORAL_NAMESPACE } from "../constants.js";
12
12
  import { ARTIFACTS_SUBDIR } from "../paths.js";
13
13
  import { waitForTcp } from "../net/tcp.js";
14
+ import { type ProviderReach, providerReach, runnerProvidersValue } from "../provider-reach.js";
14
15
  import type { DaemonConfig } from "./env.js";
15
16
  import type { ComponentSpec, ReadinessGate } from "./types.js";
17
+ import { GRACEFUL_STOP_TIMEOUT_MS } from "./supervisor.js";
18
+
19
+ /**
20
+ * What the runner keeps of the supervisor's stop bound for its own exit
21
+ * after its worker drains (releasing the harnesses, closing the Temporal
22
+ * connection, flushing telemetry), so the drain ends before the kill.
23
+ */
24
+ const RUNNER_EXIT_MARGIN_MS = 2_000;
16
25
 
17
26
  /** How long the server has to open its gRPC port before startup aborts. */
18
27
  const SERVER_GATE_TIMEOUT_MS = 30_000;
19
28
 
29
+ /** The server's setting naming the providers its runners reach (the server's `boot/config.ts`). */
30
+ export const RUNNER_PROVIDERS_ENV = "STIGMER_RUNNER_PROVIDERS";
31
+
20
32
  /**
21
33
  * Environment for the `stigmer-server` child. Pins ports, Temporal coordinates,
22
34
  * the runner task queue, and the db/storage paths to the ~/.stigmer layout.
35
+ * `serverPort` is the port the server is told to listen on (default
36
+ * SERVER_PORT; a test passes a private one).
23
37
  */
24
- export function buildServerEnv(config: DaemonConfig, base: NodeJS.ProcessEnv = process.env): NodeJS.ProcessEnv {
38
+ export function buildServerEnv(
39
+ config: DaemonConfig,
40
+ base: NodeJS.ProcessEnv = process.env,
41
+ serverPort: number = SERVER_PORT,
42
+ ): NodeJS.ProcessEnv {
25
43
  const configDir = dirname(config.dataDir); // ~/.stigmer
26
44
  const env: NodeJS.ProcessEnv = {
27
45
  ...base,
28
- GRPC_PORT: String(SERVER_PORT),
46
+ GRPC_PORT: String(serverPort),
29
47
  TEMPORAL_HOST_PORT: config.temporalAddress,
30
48
  TEMPORAL_NAMESPACE,
31
49
  TEMPORAL_AGENT_EXECUTION_RUNNER_TASK_QUEUE: RUNNER_TASK_QUEUE,
@@ -43,24 +61,52 @@ export function buildServerEnv(config: DaemonConfig, base: NodeJS.ProcessEnv = p
43
61
  // from the session's stamped created_by, never from its own env.
44
62
  if (config.operatorEmail !== undefined) env.STIGMER_OPERATOR_EMAIL = config.operatorEmail;
45
63
  if (config.operatorName !== undefined) env.STIGMER_OPERATOR_NAME = config.operatorName;
64
+ // The providers the runner this daemon starts can reach, so the server
65
+ // refuses a run that needs one it lacks at create, instead of the run
66
+ // failing at its first model call (stigmer#1084). A value the operator
67
+ // exported wins, an empty one included (it declares "none"); with no
68
+ // runner here (`--server-only`) the server is told nothing and refuses
69
+ // nothing, since a runner elsewhere is not this daemon's to judge.
70
+ const reach = localRunnerReach(config, base);
71
+ if (reach !== undefined && base[RUNNER_PROVIDERS_ENV] === undefined) {
72
+ env[RUNNER_PROVIDERS_ENV] = runnerProvidersValue(reach);
73
+ }
46
74
  return env;
47
75
  }
48
76
 
77
+ /**
78
+ * The providers the runner this daemon starts reaches, judged by the
79
+ * runner's own rule over the very environment it is given, or undefined
80
+ * when the daemon starts no runner.
81
+ */
82
+ export function localRunnerReach(
83
+ config: DaemonConfig,
84
+ base: NodeJS.ProcessEnv = process.env,
85
+ ): readonly ProviderReach[] | undefined {
86
+ if (config.serverOnly || config.runner === undefined) return undefined;
87
+ return providerReach(buildRunnerEnv(config, base));
88
+ }
89
+
49
90
  /**
50
91
  * Environment for the unified runner child in static mode (STIGMER_RUNNER_MODE
51
92
  * left unset). The runner polls RUNNER_TASK_QUEUE — the corrected queue that the
52
- * server actually dispatches to.
93
+ * server actually dispatches to — and dials the server on `serverPort`
94
+ * (default SERVER_PORT).
53
95
  */
54
- export function buildRunnerEnv(config: DaemonConfig, base: NodeJS.ProcessEnv = process.env): NodeJS.ProcessEnv {
96
+ export function buildRunnerEnv(
97
+ config: DaemonConfig,
98
+ base: NodeJS.ProcessEnv = process.env,
99
+ serverPort: number = SERVER_PORT,
100
+ ): NodeJS.ProcessEnv {
55
101
  const env: NodeJS.ProcessEnv = {
56
102
  ...base,
57
103
  MODE: "local",
58
- STIGMER_BACKEND_ENDPOINT: `http://localhost:${SERVER_PORT}`,
104
+ STIGMER_BACKEND_ENDPOINT: `http://localhost:${serverPort}`,
59
105
  // The server's public address, from which the runner fills a declared
60
106
  // STIGMER_SERVER_ADDRESS for remote MCP servers too (stigmer/stigmer#1447).
61
107
  // On a local install it is the address the console and the CLI already
62
108
  // dial, the one the console page supplied before the platform owned it.
63
- STIGMER_MCP_PUBLIC_ENDPOINT: `http://localhost:${SERVER_PORT}`,
109
+ STIGMER_MCP_PUBLIC_ENDPOINT: `http://localhost:${serverPort}`,
64
110
  TEMPORAL_SERVICE_ADDRESS: config.temporalAddress,
65
111
  TEMPORAL_NAMESPACE,
66
112
  WORKSPACE_ROOT_DIR: join(config.dataDir, "workspace"),
@@ -71,13 +117,17 @@ export function buildRunnerEnv(config: DaemonConfig, base: NodeJS.ProcessEnv = p
71
117
  // serve URL.
72
118
  ARTIFACT_STORAGE_TYPE: "local",
73
119
  LOCAL_ARTIFACT_PATH: join(config.dataDir, ARTIFACTS_SUBDIR),
120
+ // The runner's drain grace (how long its shutdown lets a running turn
121
+ // reach a step boundary) is kept under this supervisor's stop bound, after
122
+ // which it is killed: a killed runner writes nothing, and its turn waits
123
+ // out the workflow's heartbeat timeout before it continues.
124
+ STIGMER_DRAIN_GRACE_MS: String(GRACEFUL_STOP_TIMEOUT_MS - RUNNER_EXIT_MARGIN_MS),
74
125
  };
75
- if (config.cursorApiKey !== undefined) env.CURSOR_API_KEY = config.cursorApiKey;
76
126
  // Explicit set (after the base spread) so the launcher-resolved key wins over any
77
127
  // stale inherited value — the delivery path for a `stigmer setup`-persisted key.
78
- // Anthropic only: it is the sole provider local execution supports. Other keys
79
- // (e.g. a shell-exported OPENAI_API_KEY for advanced per-agent gpt-* overrides)
80
- // still reach the runner through the base env spread above.
128
+ // The Anthropic key is the one `stigmer setup` saves. Every other way the
129
+ // runner reaches a provider (OPENAI_API_KEY, a gateway, a cloud backend)
130
+ // arrives through the base env spread above.
81
131
  if (config.anthropicApiKey !== undefined) env.ANTHROPIC_API_KEY = config.anthropicApiKey;
82
132
  if (config.activityRouting !== undefined) env.STIGMER_ACTIVITY_ROUTING = config.activityRouting;
83
133
  return env;
@@ -86,9 +136,14 @@ export function buildRunnerEnv(config: DaemonConfig, base: NodeJS.ProcessEnv = p
86
136
  /**
87
137
  * Build the ordered components: `stigmer-server` (critical, gated on its gRPC
88
138
  * port) always first; the runner second unless server-only. Order matters — the
89
- * runner talks to the server.
139
+ * runner talks to the server. Both children and the gate follow `serverPort`
140
+ * (default SERVER_PORT), so a daemon told a port tells its children the same.
90
141
  */
91
- export function buildComponents(config: DaemonConfig, base: NodeJS.ProcessEnv = process.env): ComponentSpec[] {
142
+ export function buildComponents(
143
+ config: DaemonConfig,
144
+ base: NodeJS.ProcessEnv = process.env,
145
+ serverPort: number = SERVER_PORT,
146
+ ): ComponentSpec[] {
92
147
  const components: ComponentSpec[] = [
93
148
  {
94
149
  name: "stigmer-server",
@@ -100,10 +155,10 @@ export function buildComponents(config: DaemonConfig, base: NodeJS.ProcessEnv =
100
155
  name: "stigmer-server",
101
156
  command: config.server.nodeBin,
102
157
  args: [config.server.entryPath],
103
- env: buildServerEnv(config, base),
158
+ env: buildServerEnv(config, base, serverPort),
104
159
  logFile: join(config.logDir, "stigmer-server.log"),
105
160
  }),
106
- gate: serverGate(),
161
+ gate: serverGate(serverPort),
107
162
  },
108
163
  ];
109
164
 
@@ -121,7 +176,7 @@ export function buildComponents(config: DaemonConfig, base: NodeJS.ProcessEnv =
121
176
  command: runner.nodeBin,
122
177
  args: [runner.entryPath],
123
178
  cwd: join(config.dataDir, "workspace"),
124
- env: buildRunnerEnv(config, base),
179
+ env: buildRunnerEnv(config, base, serverPort),
125
180
  logFile: join(config.logDir, "runner.log"),
126
181
  readinessMarker: RUNNER_READY_MARKER,
127
182
  }),
@@ -129,17 +184,18 @@ export function buildComponents(config: DaemonConfig, base: NodeJS.ProcessEnv =
129
184
  return components;
130
185
  }
131
186
 
132
- // The server is ready once its gRPC port accepts a connection; fail fast if it
133
- // exits first.
134
- function serverGate(): ReadinessGate {
187
+ // The server is ready once its gRPC port accepts a connection; fail fast, with
188
+ // how it ended, if it exits first. The error is recorded under the component's
189
+ // name, so it speaks of "the server".
190
+ function serverGate(port: number): ReadinessGate {
135
191
  return {
136
- description: `stigmer-server gRPC on port ${SERVER_PORT}`,
192
+ description: `stigmer-server gRPC on port ${port}`,
137
193
  wait: (handle) =>
138
194
  waitForTcp({
139
- port: SERVER_PORT,
195
+ port,
140
196
  timeoutMs: SERVER_GATE_TIMEOUT_MS,
141
- label: "stigmer-server gRPC",
142
- getExit: () => (handle.hasExited() ? { code: null, signal: null } : null),
197
+ label: "the server",
198
+ getExit: () => handle.exitInfo(),
143
199
  }),
144
200
  };
145
201
  }
@@ -18,7 +18,6 @@ export const DaemonEnvVar = {
18
18
  RunnerNodeBin: "STIGMER_RUNNER_NODE_BIN",
19
19
  RunnerEntry: "STIGMER_RUNNER_ENTRY",
20
20
  RunnerAppDir: "STIGMER_RUNNER_APP_DIR",
21
- CursorApiKey: "CURSOR_API_KEY",
22
21
  AnthropicApiKey: "ANTHROPIC_API_KEY",
23
22
  ActivityRouting: "STIGMER_ACTIVITY_ROUTING",
24
23
  OperatorEmail: "STIGMER_OPERATOR_EMAIL",
@@ -34,9 +33,7 @@ export interface RunnerLaunch {
34
33
 
35
34
  /**
36
35
  * Resolved server launch coordinates: a node binary + bundled entry — the
37
- * same launch shape as the runner. (Until the Go server retired this was
38
- * a discriminated union whose "binary" variant carried the Go rollback
39
- * executable.)
36
+ * same launch shape as the runner.
40
37
  */
41
38
  export interface ServerLaunch {
42
39
  nodeBin: string;
@@ -54,7 +51,6 @@ export interface DaemonConfig {
54
51
  noWeb: boolean;
55
52
  server: ServerLaunch;
56
53
  runner?: RunnerLaunch;
57
- cursorApiKey?: string;
58
54
  anthropicApiKey?: string;
59
55
  activityRouting?: string;
60
56
  operatorEmail?: string;
@@ -75,8 +71,8 @@ export interface DaemonEnvInputs {
75
71
  // written into the daemon env explicitly: unlike a shell-exported key, a key
76
72
  // persisted by `stigmer setup` exists only in the config file and would
77
73
  // otherwise never reach the runner. Anthropic is the only provider with a
78
- // persisted delivery path — other keys (OPENAI_API_KEY, CURSOR_API_KEY)
79
- // reach the runner solely via shell-env inheritance.
74
+ // persisted delivery path — other keys (e.g. OPENAI_API_KEY) reach the
75
+ // runner solely via shell-env inheritance.
80
76
  anthropicApiKey?: string;
81
77
  // Operator identity resolved by the launcher (env > config file), the same
82
78
  // persisted-delivery reasoning as the Anthropic key (oss#796). Consumed by
@@ -130,7 +126,6 @@ export function readDaemonConfig(env: NodeJS.ProcessEnv = process.env): DaemonCo
130
126
  noWeb: env[DaemonEnvVar.NoWeb] === "1",
131
127
  server: readServer(env),
132
128
  runner: serverOnly ? undefined : runner,
133
- cursorApiKey: nonEmpty(env[DaemonEnvVar.CursorApiKey]),
134
129
  anthropicApiKey: nonEmpty(env[DaemonEnvVar.AnthropicApiKey]),
135
130
  activityRouting: nonEmpty(env[DaemonEnvVar.ActivityRouting]),
136
131
  operatorEmail: nonEmpty(env[DaemonEnvVar.OperatorEmail]),