@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
@@ -2,15 +2,19 @@
2
2
  //
3
3
  // It brings the local stack up in the canonical order (managed Temporal, then
4
4
  // the gated server, then the runner), records a health snapshot readers can
5
- // trust, runs the 10s health monitor, and on a shutdown signal tears everything
6
- // down in reverse. Temporal, the process host, the clock, and the shutdown
7
- // trigger are all injectable so the whole body can be driven in a test without
8
- // real signals or a real Temporal.
5
+ // trust, runs the 10s health monitor, and when a stop is requested tears down
6
+ // in reverse whatever has started. A stop is honoured from the first instant,
7
+ // startup included (stigmer#1175): the body looks at the request after every
8
+ // bounded startup step, the supervisor stops a child still behind its gate,
9
+ // and the stack is never reported started once a stop was asked for. A
10
+ // requested stop exits 0, wherever it landed. Temporal, the process host, the
11
+ // clock, and the stop request are all injectable so the whole body can be
12
+ // driven in a test without real signals or a real Temporal.
9
13
 
10
14
  import { mkdirSync } from "node:fs";
11
15
  import { dirname, join } from "node:path";
12
16
  import { type Logger, log as defaultLog } from "../../logger.js";
13
- import { DAEMON_PID_FILE, HEALTH_STATE_FILE } from "../constants.js";
17
+ import { DAEMON_PID_FILE, HEALTH_STATE_FILE, SERVER_PORT } from "../constants.js";
14
18
  import { type HealthState, writeHealthState } from "../state/health-state.js";
15
19
  import { removePidFile, writePidFile } from "../state/pidfile.js";
16
20
  import { TemporalManager } from "../temporal/manager.js";
@@ -47,24 +51,21 @@ export interface InternalDaemonDeps {
47
51
  clock?: Clock;
48
52
  temporal?: TemporalControl;
49
53
  log?: Logger;
50
- /** Resolves when shutdown is requested (real entry: SIGTERM/SIGINT). */
51
- waitForShutdown: () => Promise<void>;
54
+ /**
55
+ * Aborted when a stop is requested (real entry: SIGTERM/SIGINT, armed by
56
+ * `shutdownOnSignals` before anything starts).
57
+ */
58
+ shutdown: AbortSignal;
52
59
  /**
53
60
  * Invoked once the stack is up and the monitor is running, and awaited
54
- * before the daemon settles into waiting for shutdown. The foreground
55
- * launcher does its post-readiness work here (the startup record, the success card);
56
- * tests use it to observe "started".
61
+ * before the daemon settles into waiting for shutdown; never invoked once a
62
+ * stop has been requested. The foreground launcher does its post-readiness
63
+ * work here (the startup record, the success card); tests use it to observe
64
+ * "started".
57
65
  */
58
66
  onStarted?: () => void | Promise<void>;
59
- }
60
-
61
- /** Resolve on the first SIGTERM or SIGINT — the daemon's shutdown trigger. */
62
- export function waitForShutdownSignal(): Promise<void> {
63
- return new Promise((resolve) => {
64
- const onSignal = (): void => resolve();
65
- process.once("SIGTERM", onSignal);
66
- process.once("SIGINT", onSignal);
67
- });
67
+ /** The port the server listens on and is gated on (default SERVER_PORT); injectable for tests. */
68
+ serverPort?: number;
68
69
  }
69
70
 
70
71
  /** Run the daemon to completion. Returns the process exit code. */
@@ -73,6 +74,8 @@ export async function runInternalDaemon(deps: InternalDaemonDeps): Promise<numbe
73
74
  const host = deps.host ?? new NodeProcessHost();
74
75
  const clock = deps.clock ?? systemClock;
75
76
  const log = deps.log ?? defaultLog;
77
+ const { shutdown } = deps;
78
+ const serverPort = deps.serverPort ?? SERVER_PORT;
76
79
 
77
80
  mkdirSync(config.logDir, { recursive: true });
78
81
  mkdirSync(join(config.dataDir, "workspace"), { recursive: true });
@@ -87,6 +90,35 @@ export async function runInternalDaemon(deps: InternalDaemonDeps): Promise<numbe
87
90
  const persist = (): void => writeHealthState(healthPath, healthState);
88
91
 
89
92
  const temporal = deps.temporal ?? (config.temporalManaged ? buildTemporal(config, log) : null);
93
+ let temporalStarted = false;
94
+ let started: ProcessSupervisor | null = null;
95
+ let monitor: ReturnType<typeof setInterval> | null = null;
96
+
97
+ // The one teardown, in reverse start order, of whatever has started. After a
98
+ // failed start the daemon's record stays, for `up` to say why; after a
99
+ // requested stop nothing is left.
100
+ const stopStack = async (keepRecord: boolean): Promise<void> => {
101
+ if (monitor !== null) clearInterval(monitor);
102
+ if (started !== null) await started.shutdown();
103
+ if (temporal !== null && temporalStarted) {
104
+ temporal.stopSupervisor();
105
+ log.info("stopping managed Temporal");
106
+ await temporal.stop().catch((err) => log.warn("failed to stop managed Temporal cleanly", { error: String(err) }));
107
+ if (healthState.components.temporal !== undefined) healthState.components.temporal.state = "stopped";
108
+ }
109
+ persist();
110
+ if (keepRecord) return;
111
+ removePidFile(join(config.dataDir, DAEMON_PID_FILE));
112
+ removePidFile(healthPath);
113
+ log.info("daemon shutdown complete");
114
+ };
115
+ const stopRequested = async (): Promise<number> => {
116
+ log.info("stop requested during startup");
117
+ await stopStack(false);
118
+ return 0;
119
+ };
120
+
121
+ if (shutdown.aborted) return stopRequested();
90
122
 
91
123
  // --- Start managed Temporal first (the server and runner depend on it). ---
92
124
  if (temporal !== null) {
@@ -96,44 +128,52 @@ export async function runInternalDaemon(deps: InternalDaemonDeps): Promise<numbe
96
128
  await temporal.start();
97
129
  } catch (err) {
98
130
  healthState.components.temporal.state = "failed";
99
- healthState.components.temporal.last_error = String(err);
131
+ healthState.components.temporal.last_error = err instanceof Error ? err.message : String(err);
100
132
  persist();
101
133
  log.error("failed to start managed Temporal", { error: String(err) });
102
134
  return 1;
103
135
  }
136
+ temporalStarted = true;
104
137
  healthState.components.temporal.pid = temporal.getPid() ?? 0;
105
138
  healthState.components.temporal.state = "running";
106
139
  healthState.components.temporal.started_at = new Date(clock.now()).toISOString();
107
140
  temporal.startSupervisor();
108
141
  persist();
142
+ if (shutdown.aborted) return stopRequested();
109
143
  }
110
144
 
111
145
  // --- Start the server (gated) and runner via the supervisor. ---
112
- const supervisor = new ProcessSupervisor(buildComponents(config, deps.env ?? process.env), {
146
+ const supervisor = new ProcessSupervisor(buildComponents(config, deps.env ?? process.env, serverPort), {
113
147
  host,
114
148
  clock,
115
149
  healthState,
116
150
  persist,
117
151
  log,
152
+ serverPort,
118
153
  });
119
- const result = await supervisor.startAll();
154
+ started = supervisor;
155
+ const result = await supervisor.startAll(shutdown);
156
+ if (result.stopped === true) return stopRequested();
120
157
  if (!result.ok) {
121
- log.error("critical component failed to start", { component: result.failedCritical });
122
- if (temporal !== null) {
123
- temporal.stopSupervisor();
124
- await temporal.stop().catch(() => {});
125
- }
158
+ const failed = result.failedCritical === undefined ? undefined : healthState.components[result.failedCritical];
159
+ log.error("critical component failed to start", { component: result.failedCritical, error: failed?.last_error });
160
+ // A server that hangs without opening its port is still running: stop what
161
+ // started, in reverse, as a clean shutdown would, so a failed start leaves
162
+ // nothing behind holding the port.
163
+ await stopStack(true);
126
164
  return 1;
127
165
  }
128
166
 
129
167
  // Let processes settle, then catch anything that crashed immediately.
130
168
  await clock.sleep(SETTLE_DELAY_MS);
169
+ if (shutdown.aborted) return stopRequested();
131
170
  supervisor.settleCheck();
132
171
 
133
172
  // Web console: the SERVER serves it from its unified port; the
134
173
  // daemon probes and records what a browser would actually find. pid 0 is
135
174
  // truthful — there is no separate console process to supervise.
136
- const consoleAvailable = config.noWeb ? false : await isWebConsoleAvailable();
175
+ const consoleAvailable = config.noWeb ? false : await isWebConsoleAvailable(serverPort, shutdown);
176
+ if (shutdown.aborted) return stopRequested();
137
177
  healthState.components["web-console"] = {
138
178
  pid: 0,
139
179
  state: consoleAvailable ? "running" : "stopped",
@@ -145,7 +185,7 @@ export async function runInternalDaemon(deps: InternalDaemonDeps): Promise<numbe
145
185
  persist();
146
186
 
147
187
  // --- Health monitor: sync Temporal + drive one supervisor tick per interval. ---
148
- const monitor = setInterval(() => {
188
+ monitor = setInterval(() => {
149
189
  void (async () => {
150
190
  if (temporal !== null) await syncTemporal(temporal, healthState);
151
191
  await supervisor.tick();
@@ -156,27 +196,19 @@ export async function runInternalDaemon(deps: InternalDaemonDeps): Promise<numbe
156
196
  log.info("daemon started", { pid: process.pid });
157
197
  await deps.onStarted?.();
158
198
 
159
- // --- Wait for shutdown, then tear down in reverse order. ---
160
- await deps.waitForShutdown();
199
+ // --- Wait for the stop request, then tear down in reverse order. ---
200
+ await untilAborted(shutdown);
161
201
  log.info("received shutdown signal");
162
- clearInterval(monitor);
163
-
164
- await supervisor.shutdown();
165
-
166
- if (temporal !== null) {
167
- temporal.stopSupervisor();
168
- log.info("stopping managed Temporal");
169
- await temporal.stop().catch((err) => log.warn("failed to stop managed Temporal cleanly", { error: String(err) }));
170
- if (healthState.components.temporal !== undefined) healthState.components.temporal.state = "stopped";
171
- }
172
-
173
- persist();
174
- removePidFile(join(config.dataDir, DAEMON_PID_FILE));
175
- removePidFile(healthPath);
176
- log.info("daemon shutdown complete");
202
+ await stopStack(false);
177
203
  return 0;
178
204
  }
179
205
 
206
+ // Resolve once `signal` aborts, at once if it already has.
207
+ function untilAborted(signal: AbortSignal): Promise<void> {
208
+ if (signal.aborted) return Promise.resolve();
209
+ return new Promise((resolve) => signal.addEventListener("abort", () => resolve(), { once: true }));
210
+ }
211
+
180
212
  // Sync the Temporal component's health from its self-supervising manager.
181
213
  async function syncTemporal(temporal: TemporalControl, healthState: HealthState): Promise<void> {
182
214
  const state = healthState.components.temporal;
@@ -0,0 +1,19 @@
1
+ // The local stack's stop request: SIGTERM or SIGINT, turned into an
2
+ // AbortSignal the moment it is armed (the idiom of `runs logs` and
3
+ // `mcp-server`).
4
+ //
5
+ // It lives apart from the daemon body so `internal-daemon` can arm it as its
6
+ // first act, before it imports anything heavy: a SIGTERM that arrives before
7
+ // the handlers exist meets Node's default handler, which exits at once and
8
+ // orphans every child already started (stigmer#1175). It installs `once`
9
+ // handlers, so a second signal during the teardown still ends the process,
10
+ // the conventional "press Ctrl-C again to force".
11
+
12
+ /** Arm the stop request: aborted on the first SIGTERM or SIGINT from now on. */
13
+ export function shutdownOnSignals(): AbortSignal {
14
+ const controller = new AbortController();
15
+ const onSignal = (): void => controller.abort();
16
+ process.once("SIGTERM", onSignal);
17
+ process.once("SIGINT", onSignal);
18
+ return controller.signal;
19
+ }
@@ -2,14 +2,25 @@
2
2
  // restart with rapid-crash and max-restart guards, server health probing, and
3
3
  // reverse-order shutdown.
4
4
  //
5
+ // Every path that marks a component failed records why in the health snapshot:
6
+ // the error, and the child's last stderr lines, exited or still hanging. That
7
+ // record is what `stigmer status` shows and what a failed `stigmer up` prints
8
+ // (stigmer#1845), so a stopped-after-failure component keeps its "failed".
9
+ //
10
+ // A stop requested while the stack is still starting is honoured at once
11
+ // (stigmer#1175): `startAll` spawns nothing further and stops the child its
12
+ // readiness gate is waiting on, here, in the one class that owns the children,
13
+ // so no second flow ever stops a component while it is being started. Such a
14
+ // stop is not a failure, and records none.
15
+ //
5
16
  // Every side effect (spawning, time, the health probe) is injected, so this
6
- // whole policy is unit-testable without real processes or real waiting — the
7
- // property the Go daemon never had. process.ts wires this to the real host,
17
+ // whole policy is unit-testable without real processes or real waiting.
18
+ // process.ts wires this to the real host,
8
19
  // clock, Temporal, signals, and the 10s tick.
9
20
 
10
21
  import { SERVER_PORT } from "../constants.js";
11
22
  import { type Logger, log as defaultLog } from "../../logger.js";
12
- import { tcpConnects } from "../net/tcp.js";
23
+ import { describeExit, tcpConnects } from "../net/tcp.js";
13
24
  import type { ComponentState, HealthState } from "../state/health-state.js";
14
25
  import { removePidFile, writePidFile } from "../state/pidfile.js";
15
26
  import type { ChildHandle, Clock, ComponentSpec, ProcessHost } from "./types.js";
@@ -39,6 +50,8 @@ export interface StartResult {
39
50
  ok: boolean;
40
51
  /** Name of the critical component that failed, if any. */
41
52
  failedCritical?: string;
53
+ /** True when a requested stop ended the start; nothing is left half-started. */
54
+ stopped?: boolean;
42
55
  }
43
56
 
44
57
  interface Managed {
@@ -78,16 +91,19 @@ export class ProcessSupervisor {
78
91
  /**
79
92
  * Start all components in order. A critical component that fails to start or
80
93
  * gate aborts startup (returns failedCritical); a non-critical failure is
81
- * recorded and skipped.
94
+ * recorded and skipped. When `shutdown` aborts, nothing further is spawned,
95
+ * a child still behind its gate is stopped, and the result says `stopped`
96
+ * once that stop has finished; children already past their gate are left
97
+ * for `shutdown()`.
82
98
  */
83
- async startAll(): Promise<StartResult> {
99
+ async startAll(shutdown: AbortSignal = new AbortController().signal): Promise<StartResult> {
84
100
  for (const m of this.managed) {
101
+ if (shutdown.aborted) return this.stoppedWhileStarting();
85
102
  this.log.info("starting component", { component: m.spec.name });
86
103
  try {
87
104
  this.spawn(m);
88
105
  } catch (err) {
89
- m.state.state = "failed";
90
- m.state.last_error = String(err);
106
+ this.markFailed(m, errorMessage(err), null);
91
107
  this.log.error("failed to start component", { component: m.spec.name, error: String(err) });
92
108
  if (m.spec.critical) {
93
109
  this.persist();
@@ -97,27 +113,49 @@ export class ProcessSupervisor {
97
113
  }
98
114
 
99
115
  if (m.spec.gate !== undefined && m.handle !== null) {
116
+ // A stop during the gate stops the gated child; the gate then ends at
117
+ // its next look at the child's exit.
118
+ let stopping = null as Promise<void> | null; // set by the listener, so not narrowed
119
+ const onStop = (): void => {
120
+ this.log.info("stop requested, stopping component", { component: m.spec.name, pid: m.state.pid });
121
+ stopping = this.killAndWait(m);
122
+ };
123
+ shutdown.addEventListener("abort", onStop, { once: true });
124
+ if (shutdown.aborted) onStop(); // asked for during the spawn itself
100
125
  try {
101
126
  await m.spec.gate.wait(m.handle);
102
- this.log.info("component ready", { component: m.spec.name, gate: m.spec.gate.description });
127
+ if (!shutdown.aborted) this.log.info("component ready", { component: m.spec.name, gate: m.spec.gate.description });
103
128
  } catch (err) {
104
- m.state.state = "failed";
105
- m.state.last_error = `not ready: ${String(err)}`;
106
- this.persist();
107
- if (m.spec.critical) return { ok: false, failedCritical: m.spec.name };
129
+ if (!shutdown.aborted) {
130
+ this.markFailed(m, errorMessage(err), m.handle);
131
+ this.persist();
132
+ if (m.spec.critical) return { ok: false, failedCritical: m.spec.name };
133
+ }
134
+ } finally {
135
+ shutdown.removeEventListener("abort", onStop);
136
+ }
137
+ if (stopping !== null) {
138
+ await stopping;
139
+ removePidFile(m.spec.pidFile);
140
+ m.state.state = "stopped";
108
141
  }
109
142
  }
110
143
  }
144
+ if (shutdown.aborted) return this.stoppedWhileStarting();
111
145
  this.persist();
112
146
  return { ok: true };
113
147
  }
114
148
 
149
+ private stoppedWhileStarting(): StartResult {
150
+ this.persist();
151
+ return { ok: false, stopped: true };
152
+ }
153
+
115
154
  /** After a brief settle, mark any component that already crashed as failed. */
116
155
  settleCheck(): void {
117
156
  for (const m of this.managed) {
118
157
  if (m.handle !== null && m.handle.hasExited()) {
119
- m.state.state = "failed";
120
- m.state.last_error = "crashed during startup";
158
+ this.markFailed(m, `crashed during startup${exitSuffix(m.handle)}`, m.handle);
121
159
  this.log.error("component crashed during startup", { component: m.spec.name, pid: m.state.pid });
122
160
  }
123
161
  }
@@ -150,7 +188,8 @@ export class ProcessSupervisor {
150
188
  this.log.info("stopping component", { component: m.spec.name, pid: m.state.pid });
151
189
  await this.killAndWait(m);
152
190
  removePidFile(m.spec.pidFile);
153
- m.state.state = "stopped";
191
+ // A component stopped because its start failed stays "failed".
192
+ if (m.state.state !== "failed") m.state.state = "stopped";
154
193
  }
155
194
  this.persist();
156
195
  }
@@ -161,6 +200,7 @@ export class ProcessSupervisor {
161
200
  m.unhealthyCount = 0;
162
201
  m.state.state = "running";
163
202
  m.state.last_error = undefined;
203
+ m.state.last_output = undefined;
164
204
  this.log.info("component recovered — gRPC port responding again", { component: m.spec.name });
165
205
  }
166
206
  return;
@@ -180,14 +220,17 @@ export class ProcessSupervisor {
180
220
  private async tryRestart(m: Managed): Promise<void> {
181
221
  const startedAtMs = m.state.started_at !== "" ? Date.parse(m.state.started_at) : 0;
182
222
  if (startedAtMs > 0 && this.clock.now() - startedAtMs < RAPID_CRASH_WINDOW_MS) {
183
- m.state.state = "failed";
184
- m.state.last_error = "crashed immediately after start (likely a configuration or dependency error)";
223
+ const handle = m.handle;
224
+ this.markFailed(
225
+ m,
226
+ `crashed immediately after start${handle === null ? "" : exitSuffix(handle)} (likely a configuration or dependency error)`,
227
+ handle,
228
+ );
185
229
  this.log.error("component crashed too quickly, marking failed", { component: m.spec.name });
186
230
  return;
187
231
  }
188
232
  if (m.state.restart_count >= MAX_RESTARTS) {
189
- m.state.state = "failed";
190
- m.state.last_error = `exceeded max restarts (${MAX_RESTARTS})`;
233
+ this.markFailed(m, `exceeded max restarts (${MAX_RESTARTS})`, m.handle);
191
234
  this.log.error("component exceeded max restarts, marking failed", { component: m.spec.name });
192
235
  return;
193
236
  }
@@ -197,8 +240,7 @@ export class ProcessSupervisor {
197
240
  this.spawn(m);
198
241
  this.log.info("component restarted", { component: m.spec.name, restart_count: m.state.restart_count });
199
242
  } catch (err) {
200
- m.state.state = "failed";
201
- m.state.last_error = String(err);
243
+ this.markFailed(m, errorMessage(err), null);
202
244
  this.log.error("failed to restart component", { component: m.spec.name, error: String(err) });
203
245
  }
204
246
  }
@@ -222,11 +264,21 @@ export class ProcessSupervisor {
222
264
  m.state.state = "running";
223
265
  m.state.started_at = new Date(this.clock.now()).toISOString();
224
266
  m.state.last_error = undefined;
267
+ m.state.last_output = undefined;
225
268
  if (request.readinessMarker !== undefined) m.state.ready = false;
226
269
 
227
270
  writePidFile(m.spec.pidFile, handle.pid);
228
271
  }
229
272
 
273
+ // Mark a component failed with why: the error, and the last stderr lines of
274
+ // the child that failed (none when no child was spawned for this failure).
275
+ private markFailed(m: Managed, error: string, handle: ChildHandle | null): void {
276
+ m.state.state = "failed";
277
+ m.state.last_error = error;
278
+ const output = handle?.stderrTail() ?? [];
279
+ m.state.last_output = output.length > 0 ? [...output] : undefined;
280
+ }
281
+
230
282
  // SIGTERM, wait for graceful exit, then SIGKILL as a last resort.
231
283
  private async killAndWait(m: Managed): Promise<void> {
232
284
  if (m.handle === null || m.handle.hasExited()) return;
@@ -247,3 +299,14 @@ export class ProcessSupervisor {
247
299
  return result === timeout;
248
300
  }
249
301
  }
302
+
303
+ // An error's own message, so a recorded error never begins "Error:".
304
+ function errorMessage(err: unknown): string {
305
+ return err instanceof Error ? err.message : String(err);
306
+ }
307
+
308
+ // " (exited with code 1)" once the child's end is observed, else nothing.
309
+ function exitSuffix(handle: ChildHandle): string {
310
+ const exit = handle.exitInfo();
311
+ return exit === null ? "" : ` (${describeExit(exit)})`;
312
+ }
@@ -2,9 +2,8 @@
2
2
  //
3
3
  // The supervisor's restart/health policy is the part that must be exhaustively
4
4
  // testable, so every side effect it performs — spawning a process, reading the
5
- // clock — goes through an interface that tests can fake. The Go daemon's policy
6
- // is only reachable through a full integration run; this design makes it a pure
7
- // unit.
5
+ // clock — goes through an interface that tests can fake, which makes the
6
+ // policy a pure unit.
8
7
 
9
8
  /** How a child terminated. */
10
9
  export interface ExitInfo {
@@ -31,6 +30,11 @@ export interface ChildHandle {
31
30
  readonly pid: number;
32
31
  /** True once the child has terminated (and been observed). */
33
32
  hasExited(): boolean;
33
+ /** How the child terminated, once observed; null while it runs. */
34
+ exitInfo(): ExitInfo | null;
35
+ /** The child's last few complete stderr lines, oldest first: its last
36
+ * words, recorded beside a failure. */
37
+ stderrTail(): readonly string[];
34
38
  /** Register the exit callback (invoked once). */
35
39
  onExit(cb: (info: ExitInfo) => void): void;
36
40
  /** Register the readiness callback (invoked once if a marker was set). */
@@ -56,7 +60,7 @@ export interface Clock {
56
60
  /**
57
61
  * Declarative description of one managed component. `resolve` is called lazily
58
62
  * at (re)start time so binary resolution and env construction happen fresh on
59
- * every attempt — matching the Go daemon's per-start `startFn`.
63
+ * every attempt.
60
64
  */
61
65
  export interface ComponentSpec {
62
66
  name: string;
@@ -1,5 +1,5 @@
1
1
  // Typed view over the otherwise-opaque `backend.local` config section, scoped to
2
- // the LLM settings `setup` writes and `status` reads.
2
+ // the LLM settings `setup` writes and the launcher reads.
3
3
  //
4
4
  // The config module (config/config.ts) carries `backend.local` through verbatim
5
5
  // so the CLI never drops fields it does not model. This module adds a *typed
@@ -8,9 +8,13 @@
8
8
  // API-key autodetect). Writes merge into a shallow copy of `local`, preserving
9
9
  // every sibling key (temporal, execution, …).
10
10
  //
11
- // Local agent execution is Anthropic-only: the native runner constructs
12
- // Anthropic clients, and the platform model registry's native-harness entries
13
- // are all Anthropic models. Two invariants follow:
11
+ // These settings hold the one key `stigmer setup` saves, Anthropic's; they do
12
+ // not say which providers the local runner reaches. The runner also reaches
13
+ // OpenAI by a key in the shell, and Anthropic through a gateway or a cloud
14
+ // backend, none of which `setup` stores. What it reaches is judged by
15
+ // the runner's own rule over the environment the launcher builds
16
+ // (provider-reach.ts), which is what `stigmer status`, `stigmer up`'s card and
17
+ // the server's STIGMER_RUNNER_PROVIDERS read. Two invariants hold:
14
18
  //
15
19
  // 1. The model registry — not this config — owns the execution model, so
16
20
  // there is deliberately NO model field here. A config-level model pin
@@ -19,9 +23,9 @@
19
23
  // overrides belong to `stigmer run --model`. Stale `model` keys in
20
24
  // existing config files are silently ignored (verbatim carry-through)
21
25
  // and cleared by the next `setup` write.
22
- // 2. `provider` exists to route the right API key to the runner, not to
23
- // select an execution backend; "anthropic" is the only provider the local
24
- // stack can serve.
26
+ // 2. `provider` exists to route the saved API key to the runner, not to
27
+ // select an execution backend or to report what the runner reaches;
28
+ // "anthropic" is the only provider whose key `setup` saves.
25
29
 
26
30
  import type { Config } from "../config/config.js";
27
31
 
@@ -47,8 +51,10 @@ export function readLlm(config: Config): LlmSettings | undefined {
47
51
  }
48
52
 
49
53
  /**
50
- * Detect a provider from API keys present in the environment. Anthropic is the
51
- * only provider local execution supports, so only ANTHROPIC_API_KEY counts.
54
+ * Detect the saved-key provider from the environment: ANTHROPIC_API_KEY is the
55
+ * only key this config section routes, so it is the only one that counts here.
56
+ * Other providers' keys reach the runner by inheritance and are judged by the
57
+ * reach rule (provider-reach.ts), not by this.
52
58
  */
53
59
  export function detectProviderFromEnv(env: NodeJS.ProcessEnv = process.env): string {
54
60
  if (env.ANTHROPIC_API_KEY) return "anthropic";
@@ -1,12 +1,11 @@
1
1
  // Multi-component log viewing for `stigmer logs`: print a tail snapshot and,
2
2
  // optionally, follow appended lines live.
3
3
  //
4
- // Divergence from the Go CLI (documented, not drift): the Go `--all` view merges
5
- // components by parsing each line's timestamp. That parse is fragile across the
6
- // server's and runner's different log formats and silently misorders lines it
7
- // cannot parse. The TS view instead prefixes every line with its component name
8
- // (kubectl-style), which is robust without any format coupling and reads clearly
9
- // in both snapshot and follow modes.
4
+ // The view prefixes every line with its component name (kubectl-style) rather
5
+ // than merging components by each line's timestamp: the server's and runner's
6
+ // log formats differ, and a timestamp parse would silently misorder lines it
7
+ // cannot parse. The prefix needs no format coupling and reads clearly in both
8
+ // snapshot and follow modes.
10
9
 
11
10
  import { join } from "node:path";
12
11
  import { type FollowHandle, followFile, tailLines } from "./tail.js";
@@ -2,8 +2,9 @@
2
2
  // manager and the server gate.
3
3
  //
4
4
  // A single short-lived connection attempt tells us whether something is
5
- // listening; waitForTcp loops that probe until a deadline, failing fast (with a
6
- // log tail) if the process under watch exits first. This mirrors
5
+ // listening; waitForTcp loops that probe until a deadline, failing fast, with
6
+ // how it ended, if the process under watch exits first. Its output is the
7
+ // caller's to keep beside the error, as data (the daemon's health snapshot). This mirrors
7
8
  // `test/support/src/temporal.ts` so the CLI and the harnesses share
8
9
  // one readiness model.
9
10
 
@@ -27,6 +28,12 @@ export function tcpConnects(port: number, host = "127.0.0.1", timeoutMs = 200):
27
28
  });
28
29
  }
29
30
 
31
+ /** How a watched process ended. */
32
+ export interface ProcessExit {
33
+ code: number | null;
34
+ signal: NodeJS.Signals | null;
35
+ }
36
+
30
37
  export interface WaitForTcpOptions {
31
38
  port: number;
32
39
  host?: string;
@@ -36,30 +43,30 @@ export interface WaitForTcpOptions {
36
43
  pollMs?: number;
37
44
  /** If provided and it returns non-null, the watched process has exited — fail
38
45
  * immediately rather than waiting out the deadline. */
39
- getExit?: () => { code: number | null; signal: NodeJS.Signals | null } | null;
40
- /** Diagnostic log tail, appended to the failure message. */
41
- getLog?: () => string;
46
+ getExit?: () => ProcessExit | null;
42
47
  /** Human label for the thing being awaited (used in error text). */
43
48
  label?: string;
44
49
  }
45
50
 
46
51
  /** Poll a TCP port until it accepts a connection or the deadline passes. */
47
52
  export async function waitForTcp(options: WaitForTcpOptions): Promise<void> {
48
- const { port, host = "127.0.0.1", timeoutMs = 30_000, pollMs = 150, getExit, getLog, label = `port ${port}` } = options;
53
+ const { port, host = "127.0.0.1", timeoutMs = 30_000, pollMs = 150, getExit, label = `port ${port}` } = options;
49
54
  const deadline = Date.now() + timeoutMs;
50
55
 
51
56
  while (Date.now() < deadline) {
52
57
  const exit = getExit?.();
53
58
  if (exit != null) {
54
- throw new Error(`${label} exited before becoming ready (code=${exit.code}, signal=${exit.signal})${tail(getLog)}`);
59
+ throw new Error(`${label} ${describeExit(exit)} before it was ready`);
55
60
  }
56
61
  if (await tcpConnects(port, host)) return;
57
62
  await delay(pollMs);
58
63
  }
59
- throw new Error(`${label} did not become ready within ${timeoutMs}ms${tail(getLog)}`);
64
+ throw new Error(`${label} did not become ready within ${timeoutMs}ms`);
60
65
  }
61
66
 
62
- function tail(getLog?: () => string): string {
63
- const log = getLog?.();
64
- return log ? `\n--- log tail ---\n${log}` : "";
67
+ /** How a process ended, as a person would say it: "exited with code 1". */
68
+ export function describeExit(exit: ProcessExit): string {
69
+ if (exit.code !== null) return `exited with code ${exit.code}`;
70
+ if (exit.signal !== null) return `was stopped by ${exit.signal}`;
71
+ return "exited";
65
72
  }
@@ -1,7 +1,6 @@
1
1
  // Filesystem layout for the local stack, built on the CLI's config paths.
2
2
  //
3
- // The Go CLI deliberately splits state across two roots and the TS port
4
- // preserves it exactly:
3
+ // State is split across two roots:
5
4
  // - the *data dir* (~/.stigmer/data) holds daemon/server/runner PID + state +
6
5
  // logs + the runner workspace;
7
6
  // - the *config dir* (~/.stigmer) holds config.yaml, the SQLite db, and the
@@ -74,7 +73,7 @@ export function temporalDataDir(home: string = homedir()): string {
74
73
  }
75
74
 
76
75
  /** Temporal PID file (~/.stigmer/temporal.pid). Lives in the config dir, not
77
- * the data dir — matching the Go CLI's Temporal manager layout. */
76
+ * the data dir, beside the rest of Temporal's files. */
78
77
  export function temporalPidFile(home: string = homedir()): string {
79
78
  return join(configDir(home), "temporal.pid");
80
79
  }