@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
@@ -0,0 +1,124 @@
1
+ // Which model providers the local runner reaches, and how, judged from the
2
+ // environment `stigmer up` builds for it: the CLI's copy of the runner's rule
3
+ // (backend/services/runner/src/shared/provider-reach.ts, whose header gives
4
+ // every arm and the runner code each one mirrors).
5
+ //
6
+ // The CLI depends on neither the runner nor the server, so it keeps this copy
7
+ // rather than importing the runner's; the runner's
8
+ // `shared/__tests__/provider-reach.test.ts` loads this file from source
9
+ // by path and holds the two equal over a matrix of environments. It imports
10
+ // nothing, so that test can load it without following any CLI import.
11
+ //
12
+ // Two places read it: the daemon, which hands the server the providers its
13
+ // runner reaches (STIGMER_RUNNER_PROVIDERS, so a run that needs a provider the
14
+ // laptop lacks is refused at create, stigmer#1084), and the faces that tell a
15
+ // person whether agents can run (`stigmer up`'s card, `stigmer status`).
16
+
17
+ /** The model providers a runner can reach, in the order they are reported. */
18
+ export const REACHABLE_PROVIDERS = ["anthropic", "openai"] as const;
19
+
20
+ export type ReachableProvider = (typeof REACHABLE_PROVIDERS)[number];
21
+
22
+ /** How a provider is reached: its own key, a gateway, a cloud backend, or a proxy. */
23
+ export type ProviderRoute = "key" | "gateway" | "vertex" | "bedrock" | "foundry" | "proxy";
24
+
25
+ export interface ProviderReach {
26
+ readonly provider: ReachableProvider;
27
+ readonly via: ProviderRoute;
28
+ }
29
+
30
+ /** The environment the rule reads; `process.env` and a launcher's built env both fit. */
31
+ export type ReachEnv = Readonly<Record<string, string | undefined>>;
32
+
33
+ const ANTHROPIC_BACKENDS = ["public", "vertex", "bedrock", "foundry"] as const;
34
+ type AnthropicBackend = (typeof ANTHROPIC_BACKENDS)[number];
35
+
36
+ /** The providers the runner with environment `env` reaches, in {@link REACHABLE_PROVIDERS} order. */
37
+ export function providerReach(env: ReachEnv): readonly ProviderReach[] {
38
+ if (filled(env.STIGMER_PROXY_ENDPOINT)) {
39
+ return REACHABLE_PROVIDERS.map((provider) => ({ provider, via: "proxy" }));
40
+ }
41
+
42
+ const anthropicBackend = backendOf(env.STIGMER_ANTHROPIC_BACKEND, ANTHROPIC_BACKENDS);
43
+ const openAiBackend = backendOf(env.STIGMER_OPENAI_BACKEND, ["public"] as const);
44
+ const baseUrl = baseUrlOf(env.ANTHROPIC_BASE_URL);
45
+ if (anthropicBackend === null || openAiBackend === null || baseUrl === null) return [];
46
+ if (!prerequisitesMet(anthropicBackend, env)) return [];
47
+
48
+ const reach: ProviderReach[] = [];
49
+ if (anthropicBackend !== "public") {
50
+ reach.push({ provider: "anthropic", via: anthropicBackend });
51
+ } else if (baseUrl !== "") {
52
+ reach.push({ provider: "anthropic", via: "gateway" });
53
+ } else if (filled(env.ANTHROPIC_API_KEY)) {
54
+ reach.push({ provider: "anthropic", via: "key" });
55
+ }
56
+ if (filled(env.OPENAI_API_KEY)) reach.push({ provider: "openai", via: "key" });
57
+ return reach;
58
+ }
59
+
60
+ /** The setting's value for a reach: the providers' names, comma-separated (`"anthropic,openai"`). */
61
+ export function runnerProvidersValue(reach: readonly ProviderReach[]): string {
62
+ return reach.map((entry) => entry.provider).join(",");
63
+ }
64
+
65
+ /** A reach for a person to read: `anthropic (vertex), openai (key)`, or `""` when it is empty. */
66
+ export function describeReach(reach: readonly ProviderReach[]): string {
67
+ return reach.map((entry) => `${entry.provider} (${entry.via})`).join(", ");
68
+ }
69
+
70
+ /** Non-blank after trimming. */
71
+ function filled(value: string | undefined): boolean {
72
+ return (value?.trim() ?? "") !== "";
73
+ }
74
+
75
+ /** A backend variable's value (unset or blank: `public`), or null when the runner refuses it. */
76
+ function backendOf<B extends string>(raw: string | undefined, supported: readonly B[]): B | null {
77
+ const value = raw?.trim().toLowerCase() ?? "";
78
+ if (value === "") return "public" as B;
79
+ return (supported as readonly string[]).includes(value) ? (value as B) : null;
80
+ }
81
+
82
+ /** `ANTHROPIC_BASE_URL` trimmed (`""` when unset or blank), or null when it is not an http(s) URL. */
83
+ function baseUrlOf(raw: string | undefined): string | null {
84
+ const value = raw?.trim() ?? "";
85
+ if (value === "") return "";
86
+ let url: URL | undefined;
87
+ try {
88
+ url = new URL(value);
89
+ } catch {
90
+ url = undefined;
91
+ }
92
+ if (url === undefined || (url.protocol !== "http:" && url.protocol !== "https:")) return null;
93
+ return value;
94
+ }
95
+
96
+ /** Whether a non-public backend's boot prerequisites hold (`check*Prerequisites` in the runner's `llm-backend.ts`). */
97
+ function prerequisitesMet(backend: AnthropicBackend, env: ReachEnv): boolean {
98
+ switch (backend) {
99
+ case "public":
100
+ return true;
101
+ case "vertex":
102
+ return filled(env.CLOUD_ML_REGION);
103
+ case "bedrock":
104
+ return filled(env.AWS_REGION) && modelMapValid(env.STIGMER_BEDROCK_MODEL_MAP);
105
+ case "foundry":
106
+ return (
107
+ filled(env.ANTHROPIC_FOUNDRY_RESOURCE) !== filled(env.ANTHROPIC_FOUNDRY_BASE_URL) &&
108
+ modelMapValid(env.STIGMER_FOUNDRY_DEPLOYMENT_MAP)
109
+ );
110
+ }
111
+ }
112
+
113
+ /** Whether an override map parses: comma-separated `canonical=target` pairs, blank entries skipped. */
114
+ function modelMapValid(raw: string | undefined): boolean {
115
+ const trimmed = raw?.trim();
116
+ if (!trimmed) return true;
117
+ for (const entry of trimmed.split(",")) {
118
+ const pair = entry.trim();
119
+ if (pair === "") continue;
120
+ const eq = pair.indexOf("=");
121
+ if (eq === -1 || pair.slice(0, eq).trim() === "" || pair.slice(eq + 1).trim() === "") return false;
122
+ }
123
+ return true;
124
+ }
@@ -2,8 +2,7 @@
2
2
  // next `up` starts from a clean slate. Configuration (config.yaml) is preserved
3
3
  // by default so users do not lose API keys; `includeConfig` removes it too.
4
4
  //
5
- // The set of removed paths is a faithful port of the Go CLI's reset, spanning
6
- // both roots of the `~/.stigmer` layout (the SQLite db + Temporal state under
5
+ // The set of removed paths spans both roots of the `~/.stigmer` layout (the SQLite db + Temporal state under
7
6
  // the config dir, and everything under the data dir).
8
7
 
9
8
  import { existsSync, rmSync } from "node:fs";
@@ -8,8 +8,7 @@ export {
8
8
  ensureRunner,
9
9
  resolveRunner,
10
10
  } from "./runner.js";
11
- // The TS server — the served implementation (the Go binary ladder that
12
- // backed rollback retired with the Go server).
11
+ // The server.
13
12
  export {
14
13
  type EnsureServerOptions,
15
14
  acquireServer,
@@ -32,7 +32,7 @@
32
32
 
33
33
  import { execFileSync } from "node:child_process";
34
34
  import { CliExitError } from "../../errors/cli-exit-error.js";
35
- import { ExitCode } from "../../errors/exit-codes.js";
35
+ import { ExitCode } from "@stigmer/client/exit-codes";
36
36
 
37
37
  // Exits 0 when the binary provides `node:sqlite`, 1 otherwise.
38
38
  //
@@ -22,7 +22,7 @@ import { homedir } from "node:os";
22
22
  import { dirname, join } from "node:path";
23
23
  import { fileURLToPath } from "node:url";
24
24
  import { CliExitError } from "../../errors/cli-exit-error.js";
25
- import { ExitCode } from "../../errors/exit-codes.js";
25
+ import { ExitCode } from "@stigmer/client/exit-codes";
26
26
  import { log } from "../../logger.js";
27
27
  import { VERSION } from "../../version.js";
28
28
  import { runtimesDir } from "../paths.js";
@@ -134,7 +134,7 @@ function resolveBuiltRunner(appDir: string, node: () => string): RunnerResolutio
134
134
  const entryPath = join(appDir, "dist", "main.js");
135
135
  if (!existsSync(entryPath)) {
136
136
  throw new CliExitError(`runner not built: ${entryPath} is missing`, ExitCode.General, [
137
- "Build it with: npm run build -w @stigmer/apis && npm run build -w @stigmer/runner",
137
+ "Build it with: make build-runner",
138
138
  "The runner must be compiled — it cannot run from source via tsx (Temporal",
139
139
  "workflow bundling fails on raw-.ts proto stubs).",
140
140
  ]);
@@ -9,7 +9,7 @@ import { existsSync, mkdirSync, writeFileSync } from "node:fs";
9
9
  import { join } from "node:path";
10
10
  import { isReleaseVersion } from "@stigmer/plugin-package/client";
11
11
  import { CliExitError } from "../../errors/cli-exit-error.js";
12
- import { ExitCode } from "../../errors/exit-codes.js";
12
+ import { ExitCode } from "@stigmer/client/exit-codes";
13
13
 
14
14
  /** The install implementation, injectable for tests. */
15
15
  export type NpmInstall = (installDir: string, spec: string) => void;
@@ -1,6 +1,4 @@
1
- // Resolution and on-demand acquisition of the stigmer server — the
2
- // TypeScript implementation (the Go binary ladder that backed rollback
3
- // retired with the Go server).
1
+ // Resolution and on-demand acquisition of the stigmer server.
4
2
  //
5
3
  // The server is launched exactly like the runner: a compiled `node main.js`,
6
4
  // never `tsx src/main.ts` (the workers bundle Temporal workflows on boot in
@@ -21,7 +19,7 @@ import { homedir } from "node:os";
21
19
  import { dirname, join } from "node:path";
22
20
  import { fileURLToPath } from "node:url";
23
21
  import { CliExitError } from "../../errors/cli-exit-error.js";
24
- import { ExitCode } from "../../errors/exit-codes.js";
22
+ import { ExitCode } from "@stigmer/client/exit-codes";
25
23
  import { log } from "../../logger.js";
26
24
  import { VERSION } from "../../version.js";
27
25
  import { runtimesDir } from "../paths.js";
@@ -1,4 +1,4 @@
1
- // Minimal PATH lookup, the Node analogue of Go's exec.LookPath.
1
+ // Minimal PATH lookup.
2
2
  //
3
3
  // Scans the PATH entries for an executable file. POSIX-focused (the local stack
4
4
  // targets macOS and Linux); on those platforms a name with no separator is
@@ -4,10 +4,12 @@
4
4
  // non-interactive flag path and the interactive prompt, so both produce
5
5
  // identical config and the rules are unit-testable in isolation.
6
6
  //
7
- // Local agent execution is Anthropic-only (the native runner only constructs
8
- // Anthropic clients and the registry's native entries are Anthropic models),
9
- // so the interactive flow is a single API-key prompt rather than a provider
10
- // menu, followed by the skippable operator-identity prompt (oss#796). There
7
+ // Setup saves the one key the Stigmer and Claude engines run the catalog's
8
+ // models on, Anthropic's, so the interactive flow is a single API-key prompt
9
+ // rather than a provider menu, followed by the skippable operator-identity
10
+ // prompt (oss#796). The runner reaches the other providers (OpenAI, and
11
+ // Anthropic through Vertex, Bedrock, Foundry or a gateway) by settings
12
+ // exported in the shell; local/provider-reach.ts says which it reaches. There
11
13
  // is no model concept here at all: the platform model registry owns the
12
14
  // execution default, and per-run overrides belong to `stigmer run --model`
13
15
  // (oss#314 removed the dead setup-level pin).
@@ -25,7 +27,7 @@ import { promptLine, promptSecret } from "./prompt.js";
25
27
  * The providers `stigmer setup` accepts. This is the single source of truth
26
28
  * for the CLI's local-provider surface — `setup --provider` validates against
27
29
  * it and a regression test pins it, because every entry here promises an
28
- * execution path the native runner must actually serve.
30
+ * execution path the Stigmer harness must actually serve.
29
31
  */
30
32
  export const PROVIDER_CHOICES = ["anthropic", "skip"] as const;
31
33
 
@@ -3,8 +3,7 @@
3
3
  //
4
4
  // It is the single consistent view of every managed component. The supervisor
5
5
  // is the only writer; status (and any other reader) only reads. JSON keys are
6
- // snake_case to match the file the Go daemon writes, so the format is stable
7
- // across the migration.
6
+ // snake_case, the file's stable format.
8
7
 
9
8
  import { readFileSync, renameSync, writeFileSync } from "node:fs";
10
9
 
@@ -17,6 +16,9 @@ export interface ComponentState {
17
16
  started_at: string;
18
17
  restart_count: number;
19
18
  last_error?: string;
19
+ /** The component's last stderr lines when it failed, oldest first: its own
20
+ * account of why, which `stigmer up` prints under the error. */
21
+ last_output?: string[];
20
22
  /** For components that announce readiness (the runner's "polling" marker):
21
23
  * true once observed. Absent for components without a readiness signal. */
22
24
  ready?: boolean;
@@ -39,6 +41,12 @@ export function writeHealthState(path: string, state: HealthState): void {
39
41
  renameSync(tmp, path);
40
42
  }
41
43
 
44
+ /** Where a reader of the snapshot points a person for a component's full log:
45
+ * one wording, so `stigmer status` and a failed `stigmer up` never differ. */
46
+ export function componentLogsHint(component: string): string {
47
+ return `View ${component} logs: stigmer logs --component ${component}`;
48
+ }
49
+
42
50
  /** Load the health state, or null if it is missing or unparseable. */
43
51
  export function loadHealthState(path: string): HealthState | null {
44
52
  let raw: string;
@@ -1,19 +1,21 @@
1
1
  // A single-instance file lock built on atomic O_EXCL file creation.
2
2
  //
3
3
  // Node has no portable `flock`, so the lock is a file whose existence is the
4
- // lock and whose contents are the owning PID. Creation uses the "wx" flag
4
+ // lock and whose contents are the owner's PID record (state/pidfile.ts): its
5
+ // PID, and when that process started. Creation uses the "wx" flag
5
6
  // (O_CREAT | O_EXCL), which is atomic on POSIX and Windows, so two racing
6
- // acquirers cannot both win. If the file already exists we read the owner PID:
7
- // a live peer means the lock is genuinely held; a dead owner means a stale
8
- // lock we may reclaim; an owner PID that is OUR OWN is held only if this
9
- // process is actually holding it (tracked in-process), otherwise it is a
10
- // leftover from a previous life of the PID (see isOtherLiveProcess) and stale.
11
- // This guards the Temporal dev server against double-start the way the Go
12
- // CLI's flock does, without a native dependency.
7
+ // acquirers cannot both win. If the file already exists the owner is judged as
8
+ // every PID reader judges a record, through recordedLiveProcess: a live peer
9
+ // that is still the process recorded holds the lock; anything else is stale
10
+ // and reclaimed. That covers a dead owner, our own PID from a previous life
11
+ // (we hold a lock only if it is tracked in-process), and a number the OS has
12
+ // since handed to another program, which would otherwise hold the lock until
13
+ // the file was deleted by hand (stigmer#2900). This guards the Temporal dev
14
+ // server against double-start without a native dependency.
13
15
 
14
- import { closeSync, mkdirSync, openSync, readFileSync, rmSync, writeFileSync } from "node:fs";
16
+ import { closeSync, mkdirSync, openSync, rmSync, writeFileSync } from "node:fs";
15
17
  import { dirname } from "node:path";
16
- import { isOtherLiveProcess } from "./proc.js";
18
+ import { pidRecordText, readPidFile, recordedLiveProcess } from "./pidfile.js";
17
19
 
18
20
  /** A held lock. Call release() exactly once when done. */
19
21
  export interface FileLock {
@@ -30,8 +32,9 @@ const heldInProcess = new Set<string>();
30
32
  /**
31
33
  * Try to acquire the lock at `path`. Returns a FileLock on success, or null if
32
34
  * the lock is held by a live process (this one included — a second acquire
33
- * while we hold it fails). A lock left behind by a dead process, or by a past
34
- * process that had our pid, is reclaimed automatically.
35
+ * while we hold it fails). A lock left behind by a dead process, by a past
36
+ * process that had our pid, or by a process whose number now belongs to
37
+ * another program is reclaimed automatically.
35
38
  */
36
39
  export function acquireLock(path: string): FileLock | null {
37
40
  mkdirSync(dirname(path), { recursive: true });
@@ -40,10 +43,11 @@ export function acquireLock(path: string): FileLock | null {
40
43
 
41
44
  if (tryCreate(path)) return makeLock(path);
42
45
 
43
- // The lock file exists. Reclaim it only if its owner is gone, or is our own
44
- // pid from a previous life (we just established we are not holding it).
45
- const owner = readOwner(path);
46
- if (owner !== null && isOtherLiveProcess(owner)) {
46
+ // The lock file exists. It is held only while it names another live
47
+ // process that is still the one recorded; recordedLiveProcess answers null
48
+ // for our own pid (we just established we are not holding it), a dead
49
+ // owner, an unreadable file, and a number now owned by another program.
50
+ if (recordedLiveProcess(path) !== null) {
47
51
  return null; // genuinely held by a live peer
48
52
  }
49
53
 
@@ -54,9 +58,13 @@ export function acquireLock(path: string): FileLock | null {
54
58
  }
55
59
 
56
60
  function tryCreate(path: string): boolean {
61
+ // Read before the create: the file is empty, and so unowned to a racing
62
+ // reader, from the open until the write, and reading the start time can
63
+ // spawn `ps`.
64
+ const record = pidRecordText(process.pid);
57
65
  try {
58
66
  const fd = openSync(path, "wx");
59
- writeFileSync(fd, `${process.pid}\n`, "utf8");
67
+ writeFileSync(fd, record, "utf8");
60
68
  closeSync(fd);
61
69
  return true;
62
70
  } catch (err) {
@@ -65,16 +73,6 @@ function tryCreate(path: string): boolean {
65
73
  }
66
74
  }
67
75
 
68
- function readOwner(path: string): number | null {
69
- try {
70
- const firstLine = readFileSync(path, "utf8").split("\n", 1)[0]?.trim() ?? "";
71
- const pid = Number.parseInt(firstLine, 10);
72
- return Number.isInteger(pid) && pid > 0 ? pid : null;
73
- } catch {
74
- return null;
75
- }
76
- }
77
-
78
76
  function makeLock(path: string): FileLock {
79
77
  heldInProcess.add(path);
80
78
  let released = false;
@@ -86,7 +84,7 @@ function makeLock(path: string): FileLock {
86
84
  heldInProcess.delete(path);
87
85
  // Only remove the file if we still own it, so we never delete a lock a
88
86
  // different process acquired after ours was (somehow) gone.
89
- if (readOwner(path) === process.pid) rmSync(path, { force: true });
87
+ if (readPidFile(path) === process.pid) rmSync(path, { force: true });
90
88
  },
91
89
  };
92
90
  }
@@ -2,8 +2,7 @@
2
2
  //
3
3
  // Each non-empty component log is renamed with a timestamp suffix so a fresh
4
4
  // run starts clean while the previous run's output is preserved for diagnosis.
5
- // Archived logs older than the retention window are then pruned. This mirrors
6
- // the Go CLI's `rotateLogsIfNeeded` + `cleanupOldLogs`.
5
+ // Archived logs older than the retention window are then pruned.
7
6
 
8
7
  import { mkdirSync, readdirSync, renameSync, rmSync, statSync } from "node:fs";
9
8
  import { join } from "node:path";
@@ -102,7 +101,7 @@ function isArchivedLog(name: string): boolean {
102
101
  return /\.(log|err)\..+$/.test(name);
103
102
  }
104
103
 
105
- // Matches the Go layout "2006-01-02-150405" (local time): YYYY-MM-DD-HHmmss.
104
+ // YYYY-MM-DD-HHmmss, local time.
106
105
  function timestampSuffix(date: Date): string {
107
106
  const p = (n: number, width = 2): string => String(n).padStart(width, "0");
108
107
  return (
@@ -4,14 +4,44 @@
4
4
  // each other across process boundaries. Some PID files written by other tools
5
5
  // (notably Temporal's) carry extra lines after the PID; readPidFile reads only
6
6
  // the first line so it tolerates both single-line and multi-line formats.
7
+ //
8
+ // A PID file can outlive its process, and the OS may then give the number to
9
+ // an unrelated program (stigmer#2750). So the writer adds a second line,
10
+ // `started=<token>`, the process's start time (state/proc.ts), and every
11
+ // reader about to signal or trust a recorded PID asks recordedLiveProcess,
12
+ // which answers with the PID only while the live process is still the one
13
+ // recorded. The Temporal start lock (state/lock.ts) is such a record too, and
14
+ // judges its owner the same way (stigmer#2900). The first line stays the bare
15
+ // PID every reader, an older CLI's included, expects.
7
16
 
8
17
  import { mkdirSync, readFileSync, rmSync, writeFileSync } from "node:fs";
9
- import { dirname } from "node:path";
18
+ import { basename, dirname } from "node:path";
19
+ import { log } from "../../logger.js";
20
+ import { isOtherLiveProcess, processStartTime } from "./proc.js";
21
+
22
+ const STARTED_KEY = "started=";
23
+
24
+ /** What a PID file records: the PID, and when that process started if known. */
25
+ export interface PidRecord {
26
+ pid: number;
27
+ /** The start-time token written beside the PID; null in a file without one. */
28
+ started: string | null;
29
+ }
30
+
31
+ /**
32
+ * The text of a PID record: the PID, then the process's start time as a
33
+ * second line when it can be read. Every writer is the process itself or its
34
+ * parent right after the spawn, so the time read is that process's.
35
+ */
36
+ export function pidRecordText(pid: number): string {
37
+ const started = processStartTime(pid);
38
+ return started === null ? `${pid}\n` : `${pid}\n${STARTED_KEY}${started}\n`;
39
+ }
10
40
 
11
- /** Write a PID file (creating its directory if needed). */
41
+ /** Write a PID file (creating its directory if needed) holding pidRecordText. */
12
42
  export function writePidFile(path: string, pid: number): void {
13
43
  mkdirSync(dirname(path), { recursive: true });
14
- writeFileSync(path, `${pid}\n`, "utf8");
44
+ writeFileSync(path, pidRecordText(pid), "utf8");
15
45
  }
16
46
 
17
47
  /**
@@ -20,15 +50,40 @@ export function writePidFile(path: string, pid: number): void {
20
50
  * catching exceptions.
21
51
  */
22
52
  export function readPidFile(path: string): number | null {
53
+ return readPidRecord(path)?.pid ?? null;
54
+ }
55
+
56
+ /** Read a PID file's PID and recorded start time; null like readPidFile. */
57
+ export function readPidRecord(path: string): PidRecord | null {
23
58
  let raw: string;
24
59
  try {
25
60
  raw = readFileSync(path, "utf8");
26
61
  } catch {
27
62
  return null;
28
63
  }
29
- const firstLine = raw.split("\n", 1)[0]?.trim() ?? "";
30
- const pid = Number.parseInt(firstLine, 10);
31
- return Number.isInteger(pid) && pid > 0 ? pid : null;
64
+ const lines = raw.split("\n");
65
+ const pid = Number.parseInt(lines[0]?.trim() ?? "", 10);
66
+ if (!Number.isInteger(pid) || pid <= 0) return null;
67
+ const startedLine = lines.slice(1).find((line) => line.startsWith(STARTED_KEY));
68
+ const started = startedLine === undefined ? null : startedLine.slice(STARTED_KEY.length).trim();
69
+ return { pid, started: started === "" ? null : started };
70
+ }
71
+
72
+ /**
73
+ * The recorded PID, only while it names a live process other than this one
74
+ * that is still the process recorded; null otherwise. A record whose start
75
+ * time no longer matches, or can no longer be read, names another program now:
76
+ * it is logged once here and the caller treats the file as stale, signalling
77
+ * nothing. A file with no start time, written by a CLI from before the line
78
+ * existed, is trusted on liveness alone, as it always was.
79
+ */
80
+ export function recordedLiveProcess(path: string): number | null {
81
+ const record = readPidRecord(path);
82
+ if (record === null || !isOtherLiveProcess(record.pid)) return null;
83
+ if (record.started === null) return record.pid;
84
+ if (processStartTime(record.pid) === record.started) return record.pid;
85
+ log.info(`${basename(path)} names another program now; leaving it alone`, { pid: record.pid });
86
+ return null;
32
87
  }
33
88
 
34
89
  /** Remove a PID file. Best-effort: a missing file is not an error. */
@@ -1,11 +1,19 @@
1
1
  // OS-level process queries used by supervision and status.
2
2
  //
3
3
  // Liveness is a signal-0 probe (no signal delivered, only permission/existence
4
- // checked) — the same mechanism the Go CLI uses. The port-based lookup is a
4
+ // checked). The port-based lookup is a
5
5
  // fallback for locating the daemon when its PID file is missing; it shells to
6
6
  // `lsof`, so it is POSIX-only and best-effort (returns null on any failure).
7
+ //
8
+ // A live PID is not yet an identity: once a process is gone the OS may hand
9
+ // its number to anything (stigmer#2750). processStartTime reads when a process
10
+ // started, which together with its PID names one process for the life of the
11
+ // machine; the PID files record it so a reader can tell the process it started
12
+ // from a stranger that inherited the number.
7
13
 
8
14
  import { execFileSync } from "node:child_process";
15
+ import { readFileSync } from "node:fs";
16
+ import { join } from "node:path";
9
17
 
10
18
  /** Report whether a process with the given PID currently exists. */
11
19
  export function isProcessAlive(pid: number): boolean {
@@ -80,3 +88,98 @@ export function findProcessByPort(port: number): number | null {
80
88
  const pid = Number.parseInt(firstLine.trim(), 10);
81
89
  return Number.isInteger(pid) && pid > 0 ? pid : null;
82
90
  }
91
+
92
+ /**
93
+ * The command line of a live process via `ps`, or null when it cannot be read.
94
+ * POSIX-only and best-effort, like findProcessByPort, whose answer it names.
95
+ */
96
+ export function processCommand(pid: number): string | null {
97
+ let output: string;
98
+ try {
99
+ output = execFileSync("ps", ["-o", "command=", "-p", String(pid)], {
100
+ encoding: "utf8",
101
+ stdio: ["ignore", "pipe", "ignore"],
102
+ });
103
+ } catch {
104
+ return null;
105
+ }
106
+ const command = output.trim();
107
+ return command === "" ? null : command;
108
+ }
109
+
110
+ /** Where the kernel publishes process metadata on Linux; null where it does not. */
111
+ const DEFAULT_PROC_ROOT: string | null = process.platform === "linux" ? "/proc" : null;
112
+
113
+ export interface ProcessStartOptions {
114
+ /**
115
+ * Root of a procfs tree to read `<pid>/stat` and `sys/kernel/random/boot_id`
116
+ * from. Defaults to `/proc` on Linux and to none elsewhere; tests point it at
117
+ * a fixture directory, or pass null to force the `ps` reader.
118
+ */
119
+ procRoot?: string | null;
120
+ }
121
+
122
+ /**
123
+ * When `pid` started, as an opaque token compared only for equality with a
124
+ * token read earlier for the same PID, or null when it cannot be read.
125
+ *
126
+ * Two readers, in order, the same shape as `temporal/inspect.ts` and for the
127
+ * same reason (a minimal container has no `ps`):
128
+ *
129
+ * - Linux: `<boot id>:<start ticks>`. Field 22 of `/proc/<pid>/stat` counts
130
+ * clock ticks since boot, so a machine that boots the same way every time (a
131
+ * CI image, a VM) can give a new process the old PID and the old tick; the
132
+ * boot id tells two boots apart. A procfs that hides the boot id (a sandbox)
133
+ * gives the ticks alone, a weaker token rather than none.
134
+ * - Elsewhere, or where `/proc` is unreadable: `ps -o lstart=`, the start
135
+ * second in wall-clock time. `ps` prints it in the caller's zone and locale,
136
+ * and the writer (the daemon) and a later reader (a CLI in another shell) may
137
+ * differ in both, so it is always read under `TZ=UTC LC_ALL=C`.
138
+ */
139
+ export function processStartTime(pid: number, options: ProcessStartOptions = {}): string | null {
140
+ if (!Number.isInteger(pid) || pid <= 0) return null;
141
+ const procRoot = options.procRoot === undefined ? DEFAULT_PROC_ROOT : options.procRoot;
142
+ if (procRoot !== null) {
143
+ const fromProc = procStartTime(procRoot, pid);
144
+ if (fromProc !== null) return fromProc;
145
+ }
146
+ return psStartTime(pid);
147
+ }
148
+
149
+ // The command name (field 2) sits in parentheses and may itself hold spaces
150
+ // and parentheses, so fields are counted after the LAST ")": the first one
151
+ // there is field 3 (state), which puts field 22 (starttime) at index 19.
152
+ function procStartTime(procRoot: string, pid: number): string | null {
153
+ let stat: string;
154
+ try {
155
+ stat = readFileSync(join(procRoot, String(pid), "stat"), "utf8");
156
+ } catch {
157
+ return null;
158
+ }
159
+ const close = stat.lastIndexOf(")");
160
+ if (close < 0) return null;
161
+ const ticks = stat.slice(close + 1).trim().split(/\s+/)[19];
162
+ if (ticks === undefined || !/^\d+$/.test(ticks)) return null;
163
+ let bootId = "";
164
+ try {
165
+ bootId = readFileSync(join(procRoot, "sys", "kernel", "random", "boot_id"), "utf8").trim();
166
+ } catch {
167
+ // Hidden boot id: the ticks alone.
168
+ }
169
+ return bootId === "" ? ticks : `${bootId}:${ticks}`;
170
+ }
171
+
172
+ function psStartTime(pid: number): string | null {
173
+ let output: string;
174
+ try {
175
+ output = execFileSync("ps", ["-o", "lstart=", "-p", String(pid)], {
176
+ encoding: "utf8",
177
+ env: { ...process.env, TZ: "UTC", LC_ALL: "C" },
178
+ stdio: ["ignore", "pipe", "ignore"],
179
+ });
180
+ } catch {
181
+ return null;
182
+ }
183
+ const started = output.trim().replace(/\s+/g, " ");
184
+ return started === "" ? null : started;
185
+ }
@@ -11,8 +11,8 @@ import { STARTUP_CONFIG_FILE } from "../constants.js";
11
11
 
12
12
  /**
13
13
  * The persisted launch snapshot. `loadStartupConfig` parses leniently (a cast,
14
- * not a validator), so files written by older CLIs with extra fields — e.g.
15
- * the removed llm_* trio — load without migration.
14
+ * not a validator), so a file carrying fields this CLI does not read — e.g.
15
+ * an llm_* trio — loads as it is.
16
16
  */
17
17
  export interface StartupConfig {
18
18
  data_dir: string;