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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (760) hide show
  1. package/README.md +5 -4
  2. package/auth/auth0.js +1 -1
  3. package/auth/auth0.js.map +1 -1
  4. package/auth/token.d.ts +26 -4
  5. package/auth/token.d.ts.map +1 -1
  6. package/auth/token.js +120 -24
  7. package/auth/token.js.map +1 -1
  8. package/client/client.d.ts.map +1 -1
  9. package/client/client.js +21 -8
  10. package/client/client.js.map +1 -1
  11. package/command-tree.d.ts +63 -0
  12. package/command-tree.d.ts.map +1 -0
  13. package/command-tree.js +128 -0
  14. package/command-tree.js.map +1 -0
  15. package/commands/access-history/index.d.ts.map +1 -1
  16. package/commands/access-history/index.js +13 -1
  17. package/commands/access-history/index.js.map +1 -1
  18. package/commands/agent-exec-flags.d.ts +2 -0
  19. package/commands/agent-exec-flags.d.ts.map +1 -1
  20. package/commands/agent-exec-flags.js +9 -5
  21. package/commands/agent-exec-flags.js.map +1 -1
  22. package/commands/apikey/duration.d.ts.map +1 -1
  23. package/commands/apikey/duration.js +1 -2
  24. package/commands/apikey/duration.js.map +1 -1
  25. package/commands/apikey/index.d.ts.map +1 -1
  26. package/commands/apikey/index.js +3 -4
  27. package/commands/apikey/index.js.map +1 -1
  28. package/commands/apply.d.ts.map +1 -1
  29. package/commands/apply.js +2 -32
  30. package/commands/apply.js.map +1 -1
  31. package/commands/auth/index.d.ts.map +1 -1
  32. package/commands/auth/index.js +7 -5
  33. package/commands/auth/index.js.map +1 -1
  34. package/commands/auth/whoami.js +1 -1
  35. package/commands/config/index.js +3 -3
  36. package/commands/config/kv.d.ts.map +1 -1
  37. package/commands/config/kv.js +18 -14
  38. package/commands/config/kv.js.map +1 -1
  39. package/commands/connect.d.ts.map +1 -1
  40. package/commands/connect.js +18 -2
  41. package/commands/connect.js.map +1 -1
  42. package/commands/download.d.ts.map +1 -1
  43. package/commands/download.js +81 -54
  44. package/commands/download.js.map +1 -1
  45. package/commands/eval.d.ts.map +1 -1
  46. package/commands/eval.js +17 -19
  47. package/commands/eval.js.map +1 -1
  48. package/commands/file.d.ts +3 -0
  49. package/commands/file.d.ts.map +1 -0
  50. package/commands/file.js +64 -0
  51. package/commands/file.js.map +1 -0
  52. package/commands/get.d.ts.map +1 -1
  53. package/commands/get.js +20 -13
  54. package/commands/get.js.map +1 -1
  55. package/commands/help.d.ts +15 -0
  56. package/commands/help.d.ts.map +1 -0
  57. package/commands/help.js +175 -0
  58. package/commands/help.js.map +1 -0
  59. package/commands/internal-daemon.d.ts.map +1 -1
  60. package/commands/internal-daemon.js +9 -2
  61. package/commands/internal-daemon.js.map +1 -1
  62. package/commands/list.d.ts.map +1 -1
  63. package/commands/list.js +22 -1
  64. package/commands/list.js.map +1 -1
  65. package/commands/logs.js +1 -1
  66. package/commands/logs.js.map +1 -1
  67. package/commands/mcp-server.d.ts +16 -6
  68. package/commands/mcp-server.d.ts.map +1 -1
  69. package/commands/mcp-server.js +51 -26
  70. package/commands/mcp-server.js.map +1 -1
  71. package/commands/provider-key/index.d.ts +3 -0
  72. package/commands/provider-key/index.d.ts.map +1 -0
  73. package/commands/provider-key/index.js +156 -0
  74. package/commands/provider-key/index.js.map +1 -0
  75. package/commands/push.js +8 -8
  76. package/commands/push.js.map +1 -1
  77. package/commands/resume.d.ts.map +1 -1
  78. package/commands/resume.js +17 -11
  79. package/commands/resume.js.map +1 -1
  80. package/commands/routine.d.ts.map +1 -1
  81. package/commands/routine.js +42 -3
  82. package/commands/routine.js.map +1 -1
  83. package/commands/run.d.ts.map +1 -1
  84. package/commands/run.js +34 -15
  85. package/commands/run.js.map +1 -1
  86. package/commands/runs/approve.d.ts.map +1 -1
  87. package/commands/runs/approve.js +10 -2
  88. package/commands/runs/approve.js.map +1 -1
  89. package/commands/runs/control.d.ts.map +1 -1
  90. package/commands/runs/control.js +24 -16
  91. package/commands/runs/control.js.map +1 -1
  92. package/commands/runs/index.d.ts.map +1 -1
  93. package/commands/runs/index.js +1 -2
  94. package/commands/runs/index.js.map +1 -1
  95. package/commands/runs/logs.d.ts.map +1 -1
  96. package/commands/runs/logs.js +7 -4
  97. package/commands/runs/logs.js.map +1 -1
  98. package/commands/runs/to-eval-case.d.ts.map +1 -1
  99. package/commands/runs/to-eval-case.js +13 -4
  100. package/commands/runs/to-eval-case.js.map +1 -1
  101. package/commands/runs/trace.js +1 -1
  102. package/commands/runs/trace.js.map +1 -1
  103. package/commands/search.js +2 -3
  104. package/commands/search.js.map +1 -1
  105. package/commands/service-account/index.d.ts.map +1 -1
  106. package/commands/service-account/index.js +4 -2
  107. package/commands/service-account/index.js.map +1 -1
  108. package/commands/session-help.d.ts +5 -0
  109. package/commands/session-help.d.ts.map +1 -0
  110. package/commands/session-help.js +38 -0
  111. package/commands/session-help.js.map +1 -0
  112. package/commands/setup.js +5 -5
  113. package/commands/setup.js.map +1 -1
  114. package/commands/shared.d.ts +10 -2
  115. package/commands/shared.d.ts.map +1 -1
  116. package/commands/shared.js +30 -3
  117. package/commands/shared.js.map +1 -1
  118. package/commands/tag.d.ts.map +1 -1
  119. package/commands/tag.js +11 -6
  120. package/commands/tag.js.map +1 -1
  121. package/commands/up.d.ts.map +1 -1
  122. package/commands/up.js +51 -21
  123. package/commands/up.js.map +1 -1
  124. package/commands/validate.js +2 -2
  125. package/commands/validate.js.map +1 -1
  126. package/commands/version.d.ts.map +1 -1
  127. package/commands/version.js +8 -4
  128. package/commands/version.js.map +1 -1
  129. package/config/config.d.ts +5 -22
  130. package/config/config.d.ts.map +1 -1
  131. package/config/config.js +56 -47
  132. package/config/config.js.map +1 -1
  133. package/config/index.d.ts +2 -2
  134. package/config/index.d.ts.map +1 -1
  135. package/config/index.js +1 -1
  136. package/config/index.js.map +1 -1
  137. package/config/keys.js +4 -4
  138. package/config/keys.js.map +1 -1
  139. package/config/paths.js +2 -2
  140. package/config/paths.js.map +1 -1
  141. package/config/resolve.d.ts +12 -2
  142. package/config/resolve.d.ts.map +1 -1
  143. package/config/resolve.js +18 -8
  144. package/config/resolve.js.map +1 -1
  145. package/errors/classify.d.ts +20 -0
  146. package/errors/classify.d.ts.map +1 -1
  147. package/errors/classify.js +97 -21
  148. package/errors/classify.js.map +1 -1
  149. package/errors/command-line.d.ts +14 -0
  150. package/errors/command-line.d.ts.map +1 -0
  151. package/errors/command-line.js +90 -0
  152. package/errors/command-line.js.map +1 -0
  153. package/errors/handle.js +2 -2
  154. package/errors/handle.js.map +1 -1
  155. package/errors/index.d.ts +2 -2
  156. package/errors/index.d.ts.map +1 -1
  157. package/errors/index.js +12 -2
  158. package/errors/index.js.map +1 -1
  159. package/errors/usage-error.js +1 -1
  160. package/errors/usage-error.js.map +1 -1
  161. package/global-options.d.ts +35 -0
  162. package/global-options.d.ts.map +1 -0
  163. package/global-options.js +81 -0
  164. package/global-options.js.map +1 -0
  165. package/local/artifact.d.ts +1 -20
  166. package/local/artifact.d.ts.map +1 -1
  167. package/local/artifact.js +35 -117
  168. package/local/artifact.js.map +1 -1
  169. package/local/constants.d.ts +3 -9
  170. package/local/constants.d.ts.map +1 -1
  171. package/local/constants.js +3 -9
  172. package/local/constants.js.map +1 -1
  173. package/local/daemon/components.d.ts +18 -5
  174. package/local/daemon/components.d.ts.map +1 -1
  175. package/local/daemon/components.js +61 -23
  176. package/local/daemon/components.js.map +1 -1
  177. package/local/daemon/env.d.ts +1 -5
  178. package/local/daemon/env.d.ts.map +1 -1
  179. package/local/daemon/env.js +0 -2
  180. package/local/daemon/env.js.map +1 -1
  181. package/local/daemon/host.d.ts +5 -0
  182. package/local/daemon/host.d.ts.map +1 -1
  183. package/local/daemon/host.js +68 -21
  184. package/local/daemon/host.js.map +1 -1
  185. package/local/daemon/index.d.ts +2 -1
  186. package/local/daemon/index.d.ts.map +1 -1
  187. package/local/daemon/index.js +2 -1
  188. package/local/daemon/index.js.map +1 -1
  189. package/local/daemon/launch.d.ts +58 -9
  190. package/local/daemon/launch.d.ts.map +1 -1
  191. package/local/daemon/launch.js +210 -64
  192. package/local/daemon/launch.js.map +1 -1
  193. package/local/daemon/process.d.ts +11 -7
  194. package/local/daemon/process.d.ts.map +1 -1
  195. package/local/daemon/process.js +74 -38
  196. package/local/daemon/process.js.map +1 -1
  197. package/local/daemon/signals.d.ts +3 -0
  198. package/local/daemon/signals.d.ts.map +1 -0
  199. package/local/daemon/signals.js +19 -0
  200. package/local/daemon/signals.js.map +1 -0
  201. package/local/daemon/supervisor.d.ts +9 -2
  202. package/local/daemon/supervisor.d.ts.map +1 -1
  203. package/local/daemon/supervisor.js +81 -22
  204. package/local/daemon/supervisor.js.map +1 -1
  205. package/local/daemon/types.d.ts +6 -1
  206. package/local/daemon/types.d.ts.map +1 -1
  207. package/local/daemon/types.js +2 -3
  208. package/local/daemon/types.js.map +1 -1
  209. package/local/llm-config.d.ts +4 -2
  210. package/local/llm-config.d.ts.map +1 -1
  211. package/local/llm-config.js +15 -9
  212. package/local/llm-config.js.map +1 -1
  213. package/local/logs/view.d.ts.map +1 -1
  214. package/local/logs/view.js +5 -6
  215. package/local/logs/view.js.map +1 -1
  216. package/local/net/tcp.d.ts +8 -6
  217. package/local/net/tcp.d.ts.map +1 -1
  218. package/local/net/tcp.js +13 -8
  219. package/local/net/tcp.js.map +1 -1
  220. package/local/paths.d.ts +1 -1
  221. package/local/paths.d.ts.map +1 -1
  222. package/local/paths.js +2 -3
  223. package/local/paths.js.map +1 -1
  224. package/local/provider-reach.d.ts +18 -0
  225. package/local/provider-reach.d.ts.map +1 -0
  226. package/local/provider-reach.js +109 -0
  227. package/local/provider-reach.js.map +1 -0
  228. package/local/reset.d.ts.map +1 -1
  229. package/local/reset.js +1 -2
  230. package/local/reset.js.map +1 -1
  231. package/local/runtime/index.d.ts.map +1 -1
  232. package/local/runtime/index.js +1 -2
  233. package/local/runtime/index.js.map +1 -1
  234. package/local/runtime/node.js +1 -1
  235. package/local/runtime/runner.js +2 -2
  236. package/local/runtime/runner.js.map +1 -1
  237. package/local/runtime/runtimes-install.js +1 -1
  238. package/local/runtime/server.d.ts.map +1 -1
  239. package/local/runtime/server.js +2 -4
  240. package/local/runtime/server.js.map +1 -1
  241. package/local/runtime/which.js +1 -1
  242. package/local/runtime/which.js.map +1 -1
  243. package/local/setup/wizard.d.ts +1 -1
  244. package/local/setup/wizard.d.ts.map +1 -1
  245. package/local/setup/wizard.js +7 -5
  246. package/local/setup/wizard.js.map +1 -1
  247. package/local/state/health-state.d.ts +6 -0
  248. package/local/state/health-state.d.ts.map +1 -1
  249. package/local/state/health-state.js +6 -2
  250. package/local/state/health-state.js.map +1 -1
  251. package/local/state/lock.d.ts +3 -2
  252. package/local/state/lock.d.ts.map +1 -1
  253. package/local/state/lock.js +26 -28
  254. package/local/state/lock.js.map +1 -1
  255. package/local/state/log-rotation.d.ts.map +1 -1
  256. package/local/state/log-rotation.js +2 -3
  257. package/local/state/log-rotation.js.map +1 -1
  258. package/local/state/pidfile.d.ts +24 -1
  259. package/local/state/pidfile.d.ts.map +1 -1
  260. package/local/state/pidfile.js +54 -6
  261. package/local/state/pidfile.js.map +1 -1
  262. package/local/state/proc.d.ts +31 -0
  263. package/local/state/proc.d.ts.map +1 -1
  264. package/local/state/proc.js +98 -1
  265. package/local/state/proc.js.map +1 -1
  266. package/local/state/startup-config.d.ts +2 -2
  267. package/local/status.d.ts +2 -4
  268. package/local/status.d.ts.map +1 -1
  269. package/local/status.js +26 -41
  270. package/local/status.js.map +1 -1
  271. package/local/temporal/download.d.ts +9 -5
  272. package/local/temporal/download.d.ts.map +1 -1
  273. package/local/temporal/download.js +29 -8
  274. package/local/temporal/download.js.map +1 -1
  275. package/local/temporal/index.d.ts +1 -1
  276. package/local/temporal/index.d.ts.map +1 -1
  277. package/local/temporal/index.js +1 -1
  278. package/local/temporal/index.js.map +1 -1
  279. package/local/temporal/manager.d.ts +31 -5
  280. package/local/temporal/manager.d.ts.map +1 -1
  281. package/local/temporal/manager.js +74 -35
  282. package/local/temporal/manager.js.map +1 -1
  283. package/local/temporal/supervisor.js +1 -1
  284. package/local/temporal/supervisor.js.map +1 -1
  285. package/local/webconsole/index.d.ts +5 -2
  286. package/local/webconsole/index.d.ts.map +1 -1
  287. package/local/webconsole/index.js +8 -6
  288. package/local/webconsole/index.js.map +1 -1
  289. package/marketplace/github.js +1 -1
  290. package/marketplace/github.js.map +1 -1
  291. package/marketplace/official.js +1 -1
  292. package/marketplace/official.js.map +1 -1
  293. package/output/command-result.d.ts +6 -0
  294. package/output/command-result.d.ts.map +1 -1
  295. package/output/command-result.js +13 -2
  296. package/output/command-result.js.map +1 -1
  297. package/output/confirm.d.ts.map +1 -1
  298. package/output/confirm.js +2 -3
  299. package/output/confirm.js.map +1 -1
  300. package/output/format.d.ts.map +1 -1
  301. package/output/format.js +5 -6
  302. package/output/format.js.map +1 -1
  303. package/output/index.d.ts +2 -2
  304. package/output/index.d.ts.map +1 -1
  305. package/output/index.js +2 -2
  306. package/output/index.js.map +1 -1
  307. package/output/printable.d.ts +8 -0
  308. package/output/printable.d.ts.map +1 -0
  309. package/output/printable.js +24 -0
  310. package/output/printable.js.map +1 -0
  311. package/output/proto.d.ts.map +1 -1
  312. package/output/proto.js +3 -4
  313. package/output/proto.js.map +1 -1
  314. package/output/style.js +2 -2
  315. package/output/style.js.map +1 -1
  316. package/output/table.d.ts +20 -1
  317. package/output/table.d.ts.map +1 -1
  318. package/output/table.js +75 -17
  319. package/output/table.js.map +1 -1
  320. package/package.json +13 -10
  321. package/program.d.ts +0 -14
  322. package/program.d.ts.map +1 -1
  323. package/program.js +57 -119
  324. package/program.js.map +1 -1
  325. package/registry/aliases.d.ts.map +1 -1
  326. package/registry/aliases.js +0 -3
  327. package/registry/aliases.js.map +1 -1
  328. package/registry/index.d.ts +1 -1
  329. package/registry/index.d.ts.map +1 -1
  330. package/registry/index.js +1 -1
  331. package/registry/index.js.map +1 -1
  332. package/registry/metadata.d.ts +0 -15
  333. package/registry/metadata.d.ts.map +1 -1
  334. package/registry/metadata.js +16 -57
  335. package/registry/metadata.js.map +1 -1
  336. package/registry/registry.d.ts +1 -5
  337. package/registry/registry.d.ts.map +1 -1
  338. package/registry/registry.js +3 -11
  339. package/registry/registry.js.map +1 -1
  340. package/registry/verb-support.d.ts.map +1 -1
  341. package/registry/verb-support.js +28 -5
  342. package/registry/verb-support.js.map +1 -1
  343. package/resources/agent/quality.d.ts +10 -5
  344. package/resources/agent/quality.d.ts.map +1 -1
  345. package/resources/agent/quality.js +19 -9
  346. package/resources/agent/quality.js.map +1 -1
  347. package/resources/agent/resolve.js +3 -3
  348. package/resources/agent/resolve.js.map +1 -1
  349. package/resources/apply/apply.d.ts +4 -3
  350. package/resources/apply/apply.d.ts.map +1 -1
  351. package/resources/apply/apply.js +54 -41
  352. package/resources/apply/apply.js.map +1 -1
  353. package/resources/apply/handlers.d.ts.map +1 -1
  354. package/resources/apply/handlers.js +3 -4
  355. package/resources/apply/handlers.js.map +1 -1
  356. package/resources/channel.d.ts.map +1 -1
  357. package/resources/channel.js +3 -4
  358. package/resources/channel.js.map +1 -1
  359. package/resources/connect/connect.js +2 -2
  360. package/resources/connect/connect.js.map +1 -1
  361. package/resources/delete.d.ts.map +1 -1
  362. package/resources/delete.js +38 -4
  363. package/resources/delete.js.map +1 -1
  364. package/resources/documents.js +1 -1
  365. package/resources/documents.js.map +1 -1
  366. package/resources/download.d.ts +43 -3
  367. package/resources/download.d.ts.map +1 -1
  368. package/resources/download.js +169 -34
  369. package/resources/download.js.map +1 -1
  370. package/resources/eval-run/options.d.ts +3 -1
  371. package/resources/eval-run/options.d.ts.map +1 -1
  372. package/resources/eval-run/options.js +36 -18
  373. package/resources/eval-run/options.js.map +1 -1
  374. package/resources/eval-run/report.d.ts +4 -2
  375. package/resources/eval-run/report.d.ts.map +1 -1
  376. package/resources/eval-run/report.js +9 -7
  377. package/resources/eval-run/report.js.map +1 -1
  378. package/resources/eval-run/run.d.ts +2 -1
  379. package/resources/eval-run/run.d.ts.map +1 -1
  380. package/resources/eval-run/run.js +13 -7
  381. package/resources/eval-run/run.js.map +1 -1
  382. package/resources/file.d.ts +27 -0
  383. package/resources/file.d.ts.map +1 -0
  384. package/resources/file.js +82 -0
  385. package/resources/file.js.map +1 -0
  386. package/resources/get-bindings.d.ts.map +1 -1
  387. package/resources/get-bindings.js +18 -0
  388. package/resources/get-bindings.js.map +1 -1
  389. package/resources/git.d.ts +1 -1
  390. package/resources/git.js +1 -1
  391. package/resources/list.d.ts +21 -2
  392. package/resources/list.d.ts.map +1 -1
  393. package/resources/list.js +148 -31
  394. package/resources/list.js.map +1 -1
  395. package/resources/plugin.d.ts.map +1 -1
  396. package/resources/plugin.js +4 -0
  397. package/resources/plugin.js.map +1 -1
  398. package/resources/provider-key.d.ts +81 -0
  399. package/resources/provider-key.d.ts.map +1 -0
  400. package/resources/provider-key.js +261 -0
  401. package/resources/provider-key.js.map +1 -0
  402. package/resources/reference.d.ts +15 -21
  403. package/resources/reference.d.ts.map +1 -1
  404. package/resources/reference.js +42 -88
  405. package/resources/reference.js.map +1 -1
  406. package/resources/render.d.ts +31 -7
  407. package/resources/render.d.ts.map +1 -1
  408. package/resources/render.js +66 -38
  409. package/resources/render.js.map +1 -1
  410. package/resources/routine.d.ts +21 -5
  411. package/resources/routine.d.ts.map +1 -1
  412. package/resources/routine.js +104 -15
  413. package/resources/routine.js.map +1 -1
  414. package/resources/run/agent-exec.d.ts +12 -2
  415. package/resources/run/agent-exec.d.ts.map +1 -1
  416. package/resources/run/agent-exec.js +85 -38
  417. package/resources/run/agent-exec.js.map +1 -1
  418. package/resources/run/create.d.ts +16 -12
  419. package/resources/run/create.d.ts.map +1 -1
  420. package/resources/run/create.js +14 -15
  421. package/resources/run/create.js.map +1 -1
  422. package/resources/run/engines.d.ts +32 -0
  423. package/resources/run/engines.d.ts.map +1 -0
  424. package/resources/run/engines.js +39 -0
  425. package/resources/run/engines.js.map +1 -0
  426. package/resources/run/environment.d.ts +11 -0
  427. package/resources/run/environment.d.ts.map +1 -0
  428. package/resources/run/environment.js +30 -0
  429. package/resources/run/environment.js.map +1 -0
  430. package/resources/run/epilogue.d.ts +1 -1
  431. package/resources/run/epilogue.d.ts.map +1 -1
  432. package/resources/run/epilogue.js +18 -19
  433. package/resources/run/epilogue.js.map +1 -1
  434. package/resources/run/files.d.ts +104 -0
  435. package/resources/run/files.d.ts.map +1 -0
  436. package/resources/run/files.js +316 -0
  437. package/resources/run/files.js.map +1 -0
  438. package/resources/run/header.d.ts +11 -9
  439. package/resources/run/header.d.ts.map +1 -1
  440. package/resources/run/header.js +14 -14
  441. package/resources/run/header.js.map +1 -1
  442. package/resources/run/prepare.d.ts +31 -25
  443. package/resources/run/prepare.d.ts.map +1 -1
  444. package/resources/run/prepare.js +42 -51
  445. package/resources/run/prepare.js.map +1 -1
  446. package/resources/run/references.d.ts.map +1 -1
  447. package/resources/run/references.js +6 -5
  448. package/resources/run/references.js.map +1 -1
  449. package/resources/run/resolve.js +1 -1
  450. package/resources/run/resolve.js.map +1 -1
  451. package/resources/run/resume.d.ts +3 -1
  452. package/resources/run/resume.d.ts.map +1 -1
  453. package/resources/run/resume.js +25 -10
  454. package/resources/run/resume.js.map +1 -1
  455. package/resources/run/stream.d.ts +34 -2
  456. package/resources/run/stream.d.ts.map +1 -1
  457. package/resources/run/stream.js +92 -8
  458. package/resources/run/stream.js.map +1 -1
  459. package/resources/run/workspace.d.ts +9 -12
  460. package/resources/run/workspace.d.ts.map +1 -1
  461. package/resources/run/workspace.js +29 -36
  462. package/resources/run/workspace.js.map +1 -1
  463. package/resources/run-approve.d.ts.map +1 -1
  464. package/resources/run-approve.js +2 -11
  465. package/resources/run-approve.js.map +1 -1
  466. package/resources/run-control.d.ts +3 -3
  467. package/resources/run-control.d.ts.map +1 -1
  468. package/resources/run-control.js +4 -5
  469. package/resources/run-control.js.map +1 -1
  470. package/resources/run-format.d.ts +2 -2
  471. package/resources/run-format.d.ts.map +1 -1
  472. package/resources/run-format.js +3 -4
  473. package/resources/run-format.js.map +1 -1
  474. package/resources/run-logs.d.ts +2 -0
  475. package/resources/run-logs.d.ts.map +1 -1
  476. package/resources/run-logs.js +16 -6
  477. package/resources/run-logs.js.map +1 -1
  478. package/resources/run-scores.d.ts +6 -2
  479. package/resources/run-scores.d.ts.map +1 -1
  480. package/resources/run-scores.js +7 -4
  481. package/resources/run-scores.js.map +1 -1
  482. package/resources/run-to-eval-case.js +2 -2
  483. package/resources/run-to-eval-case.js.map +1 -1
  484. package/resources/runs.d.ts +3 -3
  485. package/resources/runs.d.ts.map +1 -1
  486. package/resources/runs.js +5 -5
  487. package/resources/runs.js.map +1 -1
  488. package/resources/search.d.ts.map +1 -1
  489. package/resources/search.js +1 -2
  490. package/resources/search.js.map +1 -1
  491. package/resources/service-account.d.ts +2 -0
  492. package/resources/service-account.d.ts.map +1 -1
  493. package/resources/service-account.js +3 -1
  494. package/resources/service-account.js.map +1 -1
  495. package/resources/session.d.ts +4 -3
  496. package/resources/session.d.ts.map +1 -1
  497. package/resources/session.js +10 -7
  498. package/resources/session.js.map +1 -1
  499. package/resources/skill.d.ts +1 -1
  500. package/resources/skill.d.ts.map +1 -1
  501. package/resources/skill.js +7 -8
  502. package/resources/skill.js.map +1 -1
  503. package/resources/stream/answer.d.ts +1 -2
  504. package/resources/stream/answer.d.ts.map +1 -1
  505. package/resources/stream/answer.js +3 -16
  506. package/resources/stream/answer.js.map +1 -1
  507. package/resources/stream/composer.d.ts +16 -0
  508. package/resources/stream/composer.d.ts.map +1 -0
  509. package/resources/stream/composer.js +171 -0
  510. package/resources/stream/composer.js.map +1 -0
  511. package/resources/stream/ink.d.ts +20 -4
  512. package/resources/stream/ink.d.ts.map +1 -1
  513. package/resources/stream/ink.js +34 -3
  514. package/resources/stream/ink.js.map +1 -1
  515. package/resources/stream/render-plaintext.d.ts +1 -0
  516. package/resources/stream/render-plaintext.d.ts.map +1 -1
  517. package/resources/stream/render-plaintext.js +21 -4
  518. package/resources/stream/render-plaintext.js.map +1 -1
  519. package/resources/stream/tty.js +1 -1
  520. package/resources/stream/tty.js.map +1 -1
  521. package/resources/tag.d.ts.map +1 -1
  522. package/resources/tag.js +7 -8
  523. package/resources/tag.js.map +1 -1
  524. package/resources/usage.d.ts +3 -2
  525. package/resources/usage.d.ts.map +1 -1
  526. package/resources/usage.js +19 -16
  527. package/resources/usage.js.map +1 -1
  528. package/resources/validate.d.ts.map +1 -1
  529. package/resources/validate.js +1 -12
  530. package/resources/validate.js.map +1 -1
  531. package/resources/version.d.ts +17 -3
  532. package/resources/version.d.ts.map +1 -1
  533. package/resources/version.js +105 -14
  534. package/resources/version.js.map +1 -1
  535. package/resources/views/agent.d.ts +3 -0
  536. package/resources/views/agent.d.ts.map +1 -0
  537. package/resources/views/agent.js +54 -0
  538. package/resources/views/agent.js.map +1 -0
  539. package/resources/views/environment.d.ts +3 -0
  540. package/resources/views/environment.d.ts.map +1 -0
  541. package/resources/views/environment.js +37 -0
  542. package/resources/views/environment.js.map +1 -0
  543. package/resources/views/index.d.ts +22 -0
  544. package/resources/views/index.d.ts.map +1 -0
  545. package/resources/views/index.js +70 -0
  546. package/resources/views/index.js.map +1 -0
  547. package/resources/views/organization.d.ts +3 -0
  548. package/resources/views/organization.d.ts.map +1 -0
  549. package/resources/views/organization.js +27 -0
  550. package/resources/views/organization.js.map +1 -0
  551. package/resources/views/routine.d.ts +3 -0
  552. package/resources/views/routine.d.ts.map +1 -0
  553. package/resources/views/routine.js +37 -0
  554. package/resources/views/routine.js.map +1 -0
  555. package/resources/views/run.d.ts +3 -0
  556. package/resources/views/run.d.ts.map +1 -0
  557. package/resources/views/run.js +45 -0
  558. package/resources/views/run.js.map +1 -0
  559. package/resources/views/session.d.ts +5 -0
  560. package/resources/views/session.d.ts.map +1 -0
  561. package/resources/views/session.js +85 -0
  562. package/resources/views/session.js.map +1 -0
  563. package/resources/views/skill.d.ts +5 -0
  564. package/resources/views/skill.d.ts.map +1 -0
  565. package/resources/views/skill.js +48 -0
  566. package/resources/views/skill.js.map +1 -0
  567. package/resources/views/view.d.ts +66 -0
  568. package/resources/views/view.d.ts.map +1 -0
  569. package/resources/views/view.js +130 -0
  570. package/resources/views/view.js.map +1 -0
  571. package/resources/views/words.d.ts +52 -0
  572. package/resources/views/words.d.ts.map +1 -0
  573. package/resources/views/words.js +190 -0
  574. package/resources/views/words.js.map +1 -0
  575. package/runtime.d.ts +22 -0
  576. package/runtime.d.ts.map +1 -1
  577. package/runtime.js +33 -2
  578. package/runtime.js.map +1 -1
  579. package/src/auth/auth0.ts +1 -1
  580. package/src/auth/token.ts +136 -26
  581. package/src/client/client.ts +23 -16
  582. package/src/command-tree.ts +152 -0
  583. package/src/commands/access-history/index.ts +15 -2
  584. package/src/commands/agent-exec-flags.ts +11 -5
  585. package/src/commands/apikey/duration.ts +1 -2
  586. package/src/commands/apikey/index.ts +3 -4
  587. package/src/commands/apply.ts +3 -22
  588. package/src/commands/auth/index.ts +7 -5
  589. package/src/commands/auth/whoami.ts +1 -1
  590. package/src/commands/config/index.ts +3 -3
  591. package/src/commands/config/kv.ts +18 -14
  592. package/src/commands/connect.ts +21 -3
  593. package/src/commands/download.ts +106 -62
  594. package/src/commands/eval.ts +22 -21
  595. package/src/commands/file.ts +80 -0
  596. package/src/commands/get.ts +19 -13
  597. package/src/commands/help.ts +182 -0
  598. package/src/commands/internal-daemon.ts +9 -2
  599. package/src/commands/list.ts +22 -1
  600. package/src/commands/logs.ts +1 -1
  601. package/src/commands/mcp-server.ts +57 -28
  602. package/src/commands/provider-key/index.ts +192 -0
  603. package/src/commands/push.ts +8 -8
  604. package/src/commands/resume.ts +20 -12
  605. package/src/commands/routine.ts +58 -5
  606. package/src/commands/run.ts +37 -17
  607. package/src/commands/runs/approve.ts +13 -4
  608. package/src/commands/runs/control.ts +50 -27
  609. package/src/commands/runs/index.ts +1 -2
  610. package/src/commands/runs/logs.ts +9 -5
  611. package/src/commands/runs/to-eval-case.ts +18 -6
  612. package/src/commands/runs/trace.ts +1 -1
  613. package/src/commands/search.ts +2 -3
  614. package/src/commands/service-account/index.ts +7 -2
  615. package/src/commands/session-help.ts +39 -0
  616. package/src/commands/setup.ts +5 -5
  617. package/src/commands/shared.ts +32 -3
  618. package/src/commands/tag.ts +13 -7
  619. package/src/commands/up.ts +55 -21
  620. package/src/commands/validate.ts +2 -2
  621. package/src/commands/version.ts +9 -4
  622. package/src/config/config.ts +66 -69
  623. package/src/config/index.ts +1 -2
  624. package/src/config/keys.ts +4 -4
  625. package/src/config/paths.ts +2 -2
  626. package/src/config/resolve.ts +20 -8
  627. package/src/errors/classify.ts +110 -21
  628. package/src/errors/command-line.ts +95 -0
  629. package/src/errors/handle.ts +2 -2
  630. package/src/errors/index.ts +12 -2
  631. package/src/errors/usage-error.ts +1 -1
  632. package/src/global-options.ts +100 -0
  633. package/src/local/artifact.ts +46 -140
  634. package/src/local/constants.ts +3 -9
  635. package/src/local/daemon/components.ts +78 -22
  636. package/src/local/daemon/env.ts +3 -8
  637. package/src/local/daemon/host.ts +64 -19
  638. package/src/local/daemon/index.ts +2 -1
  639. package/src/local/daemon/launch.ts +251 -72
  640. package/src/local/daemon/process.ts +78 -46
  641. package/src/local/daemon/signals.ts +19 -0
  642. package/src/local/daemon/supervisor.ts +84 -21
  643. package/src/local/daemon/types.ts +8 -4
  644. package/src/local/llm-config.ts +15 -9
  645. package/src/local/logs/view.ts +5 -6
  646. package/src/local/net/tcp.ts +18 -11
  647. package/src/local/paths.ts +2 -3
  648. package/src/local/provider-reach.ts +124 -0
  649. package/src/local/reset.ts +1 -2
  650. package/src/local/runtime/index.ts +1 -2
  651. package/src/local/runtime/node.ts +1 -1
  652. package/src/local/runtime/runner.ts +2 -2
  653. package/src/local/runtime/runtimes-install.ts +1 -1
  654. package/src/local/runtime/server.ts +2 -4
  655. package/src/local/runtime/which.ts +1 -1
  656. package/src/local/setup/wizard.ts +7 -5
  657. package/src/local/state/health-state.ts +10 -2
  658. package/src/local/state/lock.ts +26 -28
  659. package/src/local/state/log-rotation.ts +2 -3
  660. package/src/local/state/pidfile.ts +61 -6
  661. package/src/local/state/proc.ts +104 -1
  662. package/src/local/state/startup-config.ts +2 -2
  663. package/src/local/status.ts +30 -41
  664. package/src/local/temporal/download.ts +31 -9
  665. package/src/local/temporal/index.ts +1 -1
  666. package/src/local/temporal/manager.ts +94 -34
  667. package/src/local/temporal/supervisor.ts +1 -1
  668. package/src/local/webconsole/index.ts +8 -5
  669. package/src/marketplace/github.ts +1 -1
  670. package/src/marketplace/official.ts +1 -1
  671. package/src/output/command-result.ts +14 -2
  672. package/src/output/confirm.ts +2 -3
  673. package/src/output/format.ts +5 -6
  674. package/src/output/index.ts +8 -1
  675. package/src/output/printable.ts +26 -0
  676. package/src/output/proto.ts +3 -4
  677. package/src/output/style.ts +2 -2
  678. package/src/output/table.ts +118 -15
  679. package/src/program.ts +58 -128
  680. package/src/registry/aliases.ts +0 -3
  681. package/src/registry/index.ts +0 -1
  682. package/src/registry/metadata.ts +16 -64
  683. package/src/registry/registry.ts +3 -13
  684. package/src/registry/verb-support.ts +28 -5
  685. package/src/resources/agent/quality.ts +29 -8
  686. package/src/resources/agent/resolve.ts +3 -3
  687. package/src/resources/apply/apply.ts +58 -49
  688. package/src/resources/apply/handlers.ts +3 -4
  689. package/src/resources/channel.ts +3 -4
  690. package/src/resources/connect/connect.ts +2 -2
  691. package/src/resources/delete.ts +44 -4
  692. package/src/resources/documents.ts +1 -1
  693. package/src/resources/download.ts +239 -43
  694. package/src/resources/eval-run/options.ts +38 -17
  695. package/src/resources/eval-run/report.ts +11 -5
  696. package/src/resources/eval-run/run.ts +13 -9
  697. package/src/resources/file.ts +114 -0
  698. package/src/resources/get-bindings.ts +18 -0
  699. package/src/resources/git.ts +1 -1
  700. package/src/resources/list.ts +178 -34
  701. package/src/resources/plugin.ts +3 -0
  702. package/src/resources/provider-key.ts +327 -0
  703. package/src/resources/reference.ts +41 -85
  704. package/src/resources/render.ts +72 -38
  705. package/src/resources/routine.ts +152 -15
  706. package/src/resources/run/agent-exec.ts +95 -44
  707. package/src/resources/run/create.ts +27 -24
  708. package/src/resources/run/engines.ts +57 -0
  709. package/src/resources/run/environment.ts +43 -0
  710. package/src/resources/run/epilogue.ts +18 -17
  711. package/src/resources/run/files.ts +433 -0
  712. package/src/resources/run/header.ts +18 -18
  713. package/src/resources/run/prepare.ts +67 -74
  714. package/src/resources/run/references.ts +6 -5
  715. package/src/resources/run/resolve.ts +1 -1
  716. package/src/resources/run/resume.ts +28 -9
  717. package/src/resources/run/stream.ts +110 -9
  718. package/src/resources/run/workspace.ts +37 -47
  719. package/src/resources/run-approve.ts +2 -14
  720. package/src/resources/run-control.ts +4 -5
  721. package/src/resources/run-format.ts +3 -4
  722. package/src/resources/run-logs.ts +17 -6
  723. package/src/resources/run-scores.ts +14 -4
  724. package/src/resources/run-to-eval-case.ts +2 -2
  725. package/src/resources/runs.ts +5 -5
  726. package/src/resources/search.ts +1 -2
  727. package/src/resources/service-account.ts +4 -1
  728. package/src/resources/session.ts +10 -7
  729. package/src/resources/skill.ts +7 -8
  730. package/src/resources/stream/answer.ts +3 -19
  731. package/src/resources/stream/composer.ts +170 -0
  732. package/src/resources/stream/ink.tsx +74 -10
  733. package/src/resources/stream/render-plaintext.ts +22 -4
  734. package/src/resources/stream/tty.ts +1 -1
  735. package/src/resources/tag.ts +7 -9
  736. package/src/resources/usage.ts +19 -15
  737. package/src/resources/validate.ts +1 -10
  738. package/src/resources/version.ts +117 -15
  739. package/src/resources/views/agent.ts +60 -0
  740. package/src/resources/views/environment.ts +41 -0
  741. package/src/resources/views/index.ts +82 -0
  742. package/src/resources/views/organization.ts +29 -0
  743. package/src/resources/views/routine.ts +39 -0
  744. package/src/resources/views/run.ts +46 -0
  745. package/src/resources/views/session.ts +91 -0
  746. package/src/resources/views/skill.ts +49 -0
  747. package/src/resources/views/view.ts +188 -0
  748. package/src/resources/views/words.ts +191 -0
  749. package/src/runtime.ts +51 -2
  750. package/errors/exit-codes.d.ts +0 -10
  751. package/errors/exit-codes.d.ts.map +0 -1
  752. package/errors/exit-codes.js +0 -15
  753. package/errors/exit-codes.js.map +0 -1
  754. package/resources/run/attachments.d.ts +0 -24
  755. package/resources/run/attachments.d.ts.map +0 -1
  756. package/resources/run/attachments.js +0 -237
  757. package/resources/run/attachments.js.map +0 -1
  758. package/src/errors/exit-codes.ts +0 -17
  759. package/src/resources/run/attachments.ts +0 -300
  760. package/src/types/marked-terminal.d.ts +0 -31
@@ -0,0 +1,188 @@
1
+ // The one renderer every designed `get` view draws through, and the shapes a
2
+ // view hands it.
3
+ //
4
+ // A view is a function of the resource's protojson: it names a title (the
5
+ // resource's name, then where it lives, dimmed) and returns sections, the
6
+ // first usually untitled (the summary block of aligned fields), the rest
7
+ // titled. The renderer, not the view, decides what shows: a field with no
8
+ // value, and a section with nothing in it, are left out, so a view lists
9
+ // what a kind can carry and the person sees what this resource does carry.
10
+ // On a terminal, text wraps at its width with each continuation under the
11
+ // text it continues; piped (no width), nothing is wrapped or cut. Monochrome
12
+ // by the CLI's law: the title and section headings bold, the location and
13
+ // closing notes dim, through the caller's styler. Everything a resource
14
+ // carries is text someone else wrote (instructions, SKILL.md, a run's error),
15
+ // so it is printed with its control characters removed (output/printable.ts).
16
+ //
17
+ // Precedent: `gh pr view` (a title line, fields, then titled sections).
18
+
19
+ import type { Stigmer } from "@stigmer/client";
20
+ import stringWidth from "string-width";
21
+ import type { Styler } from "../../output/index.js";
22
+ import { printable, printableCell } from "../../output/printable.js";
23
+ import { type JsonObject, obj, str } from "../render.js";
24
+
25
+ /** A summary line: its label and its value; no value, no line. */
26
+ export type Field = readonly [label: string, value: string | undefined];
27
+
28
+ /**
29
+ * One block of a view. Untitled, it is the summary under the title line.
30
+ * Its parts print in this order: aligned fields, aligned rows (columns two
31
+ * spaces apart), text lines, then a dim closing note.
32
+ */
33
+ export interface Section {
34
+ readonly title?: string;
35
+ readonly fields?: readonly Field[];
36
+ readonly rows?: readonly (readonly string[])[];
37
+ readonly lines?: readonly string[];
38
+ readonly more?: string;
39
+ }
40
+
41
+ /** The title line: the resource's name, then where it lives (dimmed; "" for none). */
42
+ export interface Title {
43
+ readonly name: string;
44
+ readonly ref: string;
45
+ }
46
+
47
+ /**
48
+ * What a view reads beside its resource. `hideOrg` and `orgLabel` are the
49
+ * generic view's (a server holding one organization never names it; where
50
+ * it is named, by its slug); `now` dates a span still running; `runs` is the
51
+ * session's run list, newest first, the one thing a view reads beyond the
52
+ * resource; `width` is the terminal's (undefined piped).
53
+ */
54
+ export interface ViewContext {
55
+ readonly hideOrg: boolean;
56
+ readonly orgLabel?: string;
57
+ readonly width?: number;
58
+ readonly style: Styler;
59
+ readonly now: number;
60
+ readonly runs?: readonly JsonObject[];
61
+ }
62
+
63
+ /** What a view's loader adds to its context. */
64
+ export type Related = Pick<ViewContext, "runs">;
65
+
66
+ /** A kind's designed view. */
67
+ export interface KindView {
68
+ readonly title?: (json: JsonObject, ctx: ViewContext) => Title;
69
+ readonly sections: (json: JsonObject, ctx: ViewContext) => readonly Section[];
70
+ readonly related?: (client: Stigmer, json: JsonObject) => Promise<Related>;
71
+ }
72
+
73
+ // Below this many columns a wrapped line would read worse than the terminal's
74
+ // own wrap, so text keeps at least this much room.
75
+ const MIN_ROOM = 20;
76
+
77
+ // The indent of everything under the title and the headings.
78
+ const INDENT = " ";
79
+
80
+ /** Draw `view` over `json`: blank line, title, then each section with content. */
81
+ export function renderView(view: KindView, json: JsonObject, ctx: ViewContext): string {
82
+ const title = (view.title ?? defaultTitle)(json, ctx);
83
+ const out: string[] = ["", titleLine(title, ctx.style)];
84
+ for (const section of view.sections(json, ctx)) {
85
+ const body = sectionBody(section, ctx);
86
+ if (body.length === 0) continue;
87
+ out.push("");
88
+ if (section.title !== undefined) out.push(ctx.style.bold(section.title));
89
+ out.push(...body);
90
+ }
91
+ return `${out.join("\n")}\n`;
92
+ }
93
+
94
+ /**
95
+ * A resource's name (else its slug, else its id), then where it lives:
96
+ * `org/slug`, the organization by its label, or the slug alone on a server
97
+ * that holds one organization.
98
+ */
99
+ export function defaultTitle(json: JsonObject, ctx: ViewContext): Title {
100
+ const metadata = obj(json, "metadata");
101
+ const slug = str(metadata, "slug");
102
+ const name = str(metadata, "name") || slug || str(metadata, "id");
103
+ return { name, ref: located(metadata, slug, ctx) };
104
+ }
105
+
106
+ /**
107
+ * `org/<tail>` for a resource of `metadata`'s organization; `tail` alone
108
+ * where the organization is not named (hidden, or none on the resource).
109
+ */
110
+ export function located(metadata: JsonObject, tail: string, ctx: ViewContext): string {
111
+ const own = str(metadata, "org");
112
+ const org = ctx.hideOrg || own === "" ? "" : (ctx.orgLabel ?? own);
113
+ return [org, tail].filter((part) => part !== "").join("/");
114
+ }
115
+
116
+ function titleLine(title: Title, style: Styler): string {
117
+ const name = style.bold(printable(title.name));
118
+ return title.ref === "" ? name : `${name} ${style.dim(printable(title.ref))}`;
119
+ }
120
+
121
+ function sectionBody(section: Section, ctx: ViewContext): string[] {
122
+ const body = [...fieldLines(section.fields ?? [], ctx.width), ...rowLines(section.rows ?? [], ctx.width)];
123
+ for (const line of section.lines ?? []) body.push(...textLine(line, ctx.width));
124
+ if (section.more !== undefined && body.length > 0) body.push(`${INDENT}${ctx.style.dim(section.more)}`);
125
+ return body;
126
+ }
127
+
128
+ function fieldLines(fields: readonly Field[], width: number | undefined): string[] {
129
+ const shown = fields.filter((field): field is readonly [string, string] => (field[1] ?? "") !== "");
130
+ const labelWidth = Math.max(0, ...shown.map(([label]) => stringWidth(label)));
131
+ return shown.flatMap(([label, value]) => {
132
+ const prefix = `${INDENT}${label}:${" ".repeat(labelWidth - stringWidth(label) + 2)}`;
133
+ return hang(prefix, printable(value).split("\n"), width);
134
+ });
135
+ }
136
+
137
+ function rowLines(written: readonly (readonly string[])[], width: number | undefined): string[] {
138
+ const rows = written.map((row) => row.map(printableCell));
139
+ const columns = Math.max(0, ...rows.map((row) => row.length));
140
+ const widths = Array.from({ length: columns }, (_, column) =>
141
+ Math.max(0, ...rows.map((row) => stringWidth(row[column] ?? ""))),
142
+ );
143
+ return rows.flatMap((row) => {
144
+ const last = row.length - 1;
145
+ const prefix = INDENT + row.slice(0, last).map((cell, column) => `${cell}${" ".repeat(widths[column] - stringWidth(cell) + 2)}`).join("");
146
+ return hang(prefix, [row[last] ?? ""], width);
147
+ });
148
+ }
149
+
150
+ // A text line keeps its own leading whitespace (an indented block) and list
151
+ // marker ("- ", "* " or "1. ", after any indent), and its continuations line
152
+ // up under its text.
153
+ function textLine(written: string, width: number | undefined): string[] {
154
+ const line = printable(written);
155
+ const lead = /^\s*(?:[-*]|\d+\.)\s+/.exec(line)?.[0] ?? line.slice(0, line.length - line.trimStart().length);
156
+ return hang(`${INDENT}${lead}`, [line.slice(lead.length)], width);
157
+ }
158
+
159
+ // The first piece after `prefix`, every other under it.
160
+ function hang(prefix: string, texts: readonly string[], width: number | undefined): string[] {
161
+ const indent = stringWidth(prefix);
162
+ const pieces = texts.flatMap((text) => wrapText(text, width === undefined ? undefined : Math.max(MIN_ROOM, width - indent)));
163
+ const under = " ".repeat(indent);
164
+ return pieces.map((piece, index) => `${index === 0 ? prefix : under}${piece}`.trimEnd());
165
+ }
166
+
167
+ /**
168
+ * `text` broken at spaces into pieces no wider than `room` columns; one
169
+ * word wider than the room keeps a piece of its own, whole, since cutting
170
+ * an address or an id would break what a person copies. With no room
171
+ * (piped), the text as it is.
172
+ */
173
+ export function wrapText(text: string, room: number | undefined): string[] {
174
+ if (room === undefined) return [text];
175
+ const pieces: string[] = [];
176
+ let current = "";
177
+ for (const word of text.split(" ")) {
178
+ const candidate = current === "" ? word : `${current} ${word}`;
179
+ if (current === "" || stringWidth(candidate) <= room) {
180
+ current = candidate;
181
+ } else {
182
+ pieces.push(current);
183
+ current = word;
184
+ }
185
+ }
186
+ pieces.push(current);
187
+ return pieces;
188
+ }
@@ -0,0 +1,191 @@
1
+ // The words the designed `get` views share: a reference as `org/slug`, an
2
+ // instant, a span of time, a run's status, a long text's first lines, a
3
+ // schedule. Each reads protojson (snake_case names, enums by name, int64 as
4
+ // strings, timestamps as RFC 3339) and answers "" or undefined for what the
5
+ // resource does not carry, so the renderer leaves that line out.
6
+
7
+ import type { JsonValue } from "@bufbuild/protobuf";
8
+ import { formatElapsed } from "@stigmer/client";
9
+ import { RunPhase, RunPhaseSchema } from "@stigmer/apis/ai/stigmer/agentic/run/v1/enum_pb";
10
+ import { formatTokenCount } from "../run-format.js";
11
+ import { formatAgentPhase, isTerminalAgentPhase } from "../runs.js";
12
+ import { type JsonObject, obj, str } from "../render.js";
13
+ import { shortVersionHash } from "../version.js";
14
+ import type { ViewContext } from "./view.js";
15
+
16
+ /** How many lines of a long text (instructions, SKILL.md, a message) a view shows. */
17
+ export const TEXT_LINES = 12;
18
+
19
+ /**
20
+ * A reference as a person names it: `org/slug`, the organization by the
21
+ * view's label where it is the resource's own and left out on a server that
22
+ * holds one; the id where the reference carries no slug; a pinned version
23
+ * after `@`, a hash by the short form `--version-history` prints.
24
+ */
25
+ export function refLabel(ref: JsonObject, metadata: JsonObject, ctx: ViewContext): string {
26
+ const slug = str(ref, "slug") || str(ref, "id");
27
+ if (slug === "") return "";
28
+ const org = str(ref, "org");
29
+ const own = org === str(metadata, "org") ? (ctx.orgLabel ?? org) : org;
30
+ const named = ctx.hideOrg || org === "" ? slug : `${own}/${slug}`;
31
+ const version = str(ref, "version");
32
+ if (version === "" || version === "latest") return named;
33
+ // Only a full version hash (64 lowercase hex characters) has a short form.
34
+ return `${named}@${/^[a-f0-9]{64}$/.test(version) ? shortVersionHash(version) : version}`;
35
+ }
36
+
37
+ /** Each reference of a protojson list field, labelled. */
38
+ export function refLabels(list: JsonValue | undefined, metadata: JsonObject, ctx: ViewContext): string[] {
39
+ return objects(list).map((ref) => refLabel(ref, metadata, ctx)).filter((label) => label !== "");
40
+ }
41
+
42
+ /** The objects of a protojson list field (none when absent). */
43
+ export function objects(list: JsonValue | undefined): JsonObject[] {
44
+ return Array.isArray(list) ? list.filter((item): item is JsonObject => typeof item === "object" && item !== null && !Array.isArray(item)) : [];
45
+ }
46
+
47
+ /** The strings of a protojson list field (none when absent). */
48
+ export function strings(list: JsonValue | undefined): string[] {
49
+ return Array.isArray(list) ? list.filter((item): item is string => typeof item === "string") : [];
50
+ }
51
+
52
+ /** A run's status word ("completed", "running", "awaiting-approval"), from its protojson phase. */
53
+ export function phaseWord(run: JsonObject): string {
54
+ return formatAgentPhase(phaseOf(run));
55
+ }
56
+
57
+ /** Whether a run has ended (completed, failed, cancelled or terminated). */
58
+ export function hasEnded(run: JsonObject): boolean {
59
+ return isTerminalAgentPhase(phaseOf(run));
60
+ }
61
+
62
+ // The phase protojson names ("RUN_FAILED"), found by its proto name in the
63
+ // enum's descriptor, since generated TypeScript names may drop a prefix.
64
+ function phaseOf(run: JsonObject): RunPhase {
65
+ const name = str(obj(run, "status"), "phase");
66
+ return RunPhaseSchema.values.find((value) => value.name === name)?.number ?? RunPhase.RUN_PHASE_UNSPECIFIED;
67
+ }
68
+
69
+ /**
70
+ * How long a run took ("1m 4s"), or has taken so far while it works ("3m 2s
71
+ * so far"); undefined before it starts, and for an ended run that recorded
72
+ * no end.
73
+ */
74
+ export function runSpan(run: JsonObject, now: number): string | undefined {
75
+ const status = obj(run, "status");
76
+ const start = Date.parse(str(status, "started_at"));
77
+ if (Number.isNaN(start)) return undefined;
78
+ const end = Date.parse(str(status, "completed_at"));
79
+ if (!Number.isNaN(end)) return formatElapsed(end - start);
80
+ return hasEnded(run) ? undefined : `${formatElapsed(now - start)} so far`;
81
+ }
82
+
83
+ /**
84
+ * A run's tokens as the epilogue counts them ("18.4k (12.0k in, 6.4k out)"),
85
+ * never a price; undefined when it counted none.
86
+ */
87
+ export function tokenUsage(run: JsonObject): string | undefined {
88
+ const usage = obj(obj(run, "status"), "streaming_usage");
89
+ const total = int64(usage, "total_tokens");
90
+ if (total <= 0n) return undefined;
91
+ return `${formatTokenCount(total)} (${formatTokenCount(int64(usage, "input_tokens"))} in, ${formatTokenCount(int64(usage, "output_tokens"))} out)`;
92
+ }
93
+
94
+ // An int64 protojson field (a string on the wire), 0 when absent or unreadable.
95
+ function int64(json: JsonObject, key: string): bigint {
96
+ const value = json[key];
97
+ if (typeof value !== "string" && typeof value !== "number") return 0n;
98
+ try {
99
+ return BigInt(value);
100
+ } catch {
101
+ return 0n;
102
+ }
103
+ }
104
+
105
+ /**
106
+ * The first `max` lines of a long text, and a note of how many more there
107
+ * are and how to read them; no lines for a text that is blank.
108
+ */
109
+ export function firstLines(text: string, max = TEXT_LINES): { lines: string[]; more?: string } {
110
+ const trimmed = text.replace(/\r\n/g, "\n").trimEnd();
111
+ if (trimmed === "") return { lines: [] };
112
+ const all = trimmed.split("\n");
113
+ if (all.length <= max) return { lines: all };
114
+ const rest = all.length - max;
115
+ return { lines: all.slice(0, max), more: `… ${rest} more ${rest === 1 ? "line" : "lines"}; -o yaml for all` };
116
+ }
117
+
118
+ /** "yes" or "no" for a protojson bool (absent is false). */
119
+ export function yesNo(json: JsonObject, key: string): string {
120
+ return json[key] === true ? "yes" : "no";
121
+ }
122
+
123
+ const WEEKDAYS = ["Sunday", "Monday", "Tuesday", "Wednesday", "Thursday", "Friday", "Saturday"] as const;
124
+
125
+
126
+ /**
127
+ * A routine's schedule in words, with the time zone it keeps ("every day at
128
+ * 09:00, Asia/Kolkata"): the shapes the console's schedule builder writes
129
+ * and the cron shorthands in words, any other cron as itself. No cron: it
130
+ * runs only when fired. The words of the console's `describeCadence`
131
+ * (sdk/react's routine/cadence.ts), which the CLI cannot import.
132
+ */
133
+ export function scheduleWords(cron: string | undefined, timeZone: string): string {
134
+ if (cron === undefined) return "only when fired";
135
+ const zone = timeZone === "" ? "UTC" : timeZone;
136
+ return `${cadence(cron.trim().replace(/\s+/g, " "))}, ${zone}`;
137
+ }
138
+
139
+ // A cron shorthand in words; undefined for any other cron. The words are
140
+ // chosen as the schedule is read, not held in a table built at import.
141
+ function shorthandWords(cron: string): string | undefined {
142
+ switch (cron) {
143
+ case "@hourly":
144
+ return "every hour, on the hour";
145
+ case "@daily":
146
+ return "every day at 00:00";
147
+ case "@weekly":
148
+ return "every Sunday at 00:00";
149
+ case "@monthly":
150
+ return "on day 1 of every month at 00:00";
151
+ case "@yearly":
152
+ return "every year on January 1 at 00:00";
153
+ }
154
+ return undefined;
155
+ }
156
+
157
+ function cadence(cron: string): string {
158
+ const shorthand = shorthandWords(cron);
159
+ if (shorthand !== undefined) return shorthand;
160
+ const custom = `cron "${cron}"`;
161
+ const fields = cron.split(" ");
162
+ if (fields.length !== 5) return custom;
163
+ const [m, h, d, month, w] = fields as [string, string, string, string, string];
164
+ const minute = upTo(m, 59);
165
+ if (month !== "*" || minute === undefined) return custom;
166
+ if (h === "*" && d === "*" && w === "*") return `every hour at minute ${minute}`;
167
+ const hour = upTo(h, 23);
168
+ if (hour === undefined) return custom;
169
+ const at = `at ${String(hour).padStart(2, "0")}:${String(minute).padStart(2, "0")}`;
170
+ if (d === "*" && w === "*") return `every day ${at}`;
171
+ const day = upTo(d, 31);
172
+ if (day !== undefined && day >= 1 && w === "*") return `on day ${day} of every month ${at}`;
173
+ const days = d === "*" ? weekdays(w) : undefined;
174
+ return days === undefined ? custom : `every ${days} ${at}`;
175
+ }
176
+
177
+ // A one- or two-digit field no greater than `max`; undefined for any other.
178
+ function upTo(field: string, max: number): number | undefined {
179
+ if (!/^\d{1,2}$/.test(field)) return undefined;
180
+ const value = Number(field);
181
+ return value <= max ? value : undefined;
182
+ }
183
+
184
+ // "1,3,5" as "Monday, Wednesday and Friday"; undefined for anything else.
185
+ function weekdays(field: string): string | undefined {
186
+ if (!/^[0-6](,[0-6])*$/.test(field)) return undefined;
187
+ const names = [...new Set(field.split(",").map(Number))].sort((a, b) => a - b).map((day) => WEEKDAYS[day]);
188
+ if (names.length === 7) return "day";
189
+ if (names.join() === WEEKDAYS.slice(1, 6).join()) return "weekday";
190
+ return names.length === 1 ? names[0] : `${names.slice(0, -1).join(", ")} and ${names[names.length - 1]}`;
191
+ }
package/src/runtime.ts CHANGED
@@ -1,10 +1,29 @@
1
1
  // Process-global CLI flags that cross-cutting modules (config, errors, logger)
2
2
  // read without threading them through every call. Set once by the root
3
- // preAction hook from the parsed global options. Mirrors the Go CLI's atomic
4
- // `standalone`/`debug` globals in internal/cli/config and clierr.
3
+ // preAction hook from the parsed global options and the command that runs.
4
+ //
5
+ // Two records are written later, by the command itself, so an error can
6
+ // name what was actually tried: the server address the backend client
7
+ // dials (and where that address came from), recorded when the client is
8
+ // made, and the resource type a get, delete or download resolved.
5
9
 
6
10
  let debug = false;
7
11
  let standalone = false;
12
+ let actionCommand = "";
13
+ let serverAddress: ServerAddress | undefined;
14
+ let resourceType = "";
15
+
16
+ /**
17
+ * Where the address the backend client dials came from: the active
18
+ * backend's kind, or the STIGMER_SERVER_ADDRESS override.
19
+ */
20
+ export type ServerAddressSource = "local" | "cloud" | "selfhost" | "environment";
21
+
22
+ /** The server address a backend client dials, as resolved, with its source. */
23
+ export interface ServerAddress {
24
+ readonly address: string;
25
+ readonly source: ServerAddressSource;
26
+ }
8
27
 
9
28
  export function setDebug(value: boolean): void {
10
29
  debug = value;
@@ -21,3 +40,33 @@ export function setStandalone(value: boolean): void {
21
40
  export function isStandalone(): boolean {
22
41
  return standalone;
23
42
  }
43
+
44
+ /** Record the path of the command that runs (`stigmer get`), for errors that name it. */
45
+ export function setActionCommand(path: string): void {
46
+ actionCommand = path;
47
+ }
48
+
49
+ /** The path of the command that runs; "" before an action starts. */
50
+ export function actionCommandPath(): string {
51
+ return actionCommand;
52
+ }
53
+
54
+ /** Record the address the backend client dials; undefined forgets it (tests). */
55
+ export function setServerAddress(value: ServerAddress | undefined): void {
56
+ serverAddress = value;
57
+ }
58
+
59
+ /** The address the backend client dials; undefined when no client was made. */
60
+ export function dialedServerAddress(): ServerAddress | undefined {
61
+ return serverAddress;
62
+ }
63
+
64
+ /** Record the resource type the running command resolved, as `stigmer list` spells it ("" forgets it). */
65
+ export function setActionResourceType(type: string): void {
66
+ resourceType = type;
67
+ }
68
+
69
+ /** The resource type the running command resolved; "" when none was. */
70
+ export function actionResourceType(): string {
71
+ return resourceType;
72
+ }
@@ -1,10 +0,0 @@
1
- export declare const ExitCode: {
2
- readonly Success: 0;
3
- readonly General: 1;
4
- readonly Usage: 2;
5
- readonly Connection: 3;
6
- readonly Auth: 4;
7
- readonly NotFound: 5;
8
- };
9
- export type ExitCode = (typeof ExitCode)[keyof typeof ExitCode];
10
- //# sourceMappingURL=exit-codes.d.ts.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"exit-codes.d.ts","sourceRoot":"","sources":["../src/errors/exit-codes.ts"],"names":[],"mappings":"AAOA,eAAO,MAAM,QAAQ;;;;;;;CAOX,CAAC;AAEX,MAAM,MAAM,QAAQ,GAAG,CAAC,OAAO,QAAQ,CAAC,CAAC,MAAM,OAAO,QAAQ,CAAC,CAAC"}
@@ -1,15 +0,0 @@
1
- // Exit codes returned by the CLI. The convention mirrors the Go CLI
2
- // (internal/cli/clierr/exit_codes.go) so scripts and CI can branch on `$?`
3
- // without parsing stderr. classify() maps gRPC/Connect status codes onto these.
4
- // One command departs: `eval run` exits with Claude Code's plugin-eval
5
- // codes (2 is its partial run, 130 an interrupt, and a refused start is 1),
6
- // keeping only 3 and 4 from this table (resources/eval-run/report.ts).
7
- export const ExitCode = {
8
- Success: 0,
9
- General: 1, // Internal, Aborted, remote Canceled, Unknown, non-gRPC errors
10
- Usage: 2, // InvalidArgument, FailedPrecondition, AlreadyExists
11
- Connection: 3, // Unavailable, DeadlineExceeded, ResourceExhausted
12
- Auth: 4, // Unauthenticated, PermissionDenied
13
- NotFound: 5, // NotFound
14
- };
15
- //# sourceMappingURL=exit-codes.js.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"exit-codes.js","sourceRoot":"","sources":["../src/errors/exit-codes.ts"],"names":[],"mappings":"AAAA,oEAAoE;AACpE,2EAA2E;AAC3E,gFAAgF;AAChF,uEAAuE;AACvE,4EAA4E;AAC5E,uEAAuE;AAEvE,MAAM,CAAC,MAAM,QAAQ,GAAG;IACtB,OAAO,EAAE,CAAC;IACV,OAAO,EAAE,CAAC,EAAE,+DAA+D;IAC3E,KAAK,EAAE,CAAC,EAAE,qDAAqD;IAC/D,UAAU,EAAE,CAAC,EAAE,mDAAmD;IAClE,IAAI,EAAE,CAAC,EAAE,oCAAoC;IAC7C,QAAQ,EAAE,CAAC,EAAE,WAAW;CAChB,CAAC"}
@@ -1,24 +0,0 @@
1
- import { type Attachment } from "@stigmer/apis/ai/stigmer/agentic/run/v1/spec_pb";
2
- import { type UploadAttachmentRequest, type UploadAttachmentResponse } from "@stigmer/apis/ai/stigmer/agentic/run/v1/io_pb";
3
- /** A sink for human progress/warning lines (attachments are not byte-parity output). */
4
- export type ProgressSink = (line: string) => void;
5
- /** The minimal UploadAttachment RPC surface, injectable for testing. */
6
- export interface AttachmentUploader {
7
- uploadAttachment(req: UploadAttachmentRequest): Promise<UploadAttachmentResponse>;
8
- }
9
- /**
10
- * The split result of processing `--attach` paths. Mirrors Go's
11
- * AttachmentResult: in-workspace files become relative references, everything
12
- * else becomes an uploaded Attachment.
13
- */
14
- export interface AttachmentResult {
15
- readonly attachments: Attachment[];
16
- readonly workspaceFileRefs: string[];
17
- }
18
- /**
19
- * Process `--attach` paths against the local workspace roots. The first root a
20
- * path falls inside wins and yields a workspace-relative reference; otherwise
21
- * the path is uploaded. Mirrors Go's AttachmentProcessor.ProcessFiles.
22
- */
23
- export declare function processAttachments(uploader: AttachmentUploader, paths: readonly string[], workspaceRoots: readonly string[], progress?: ProgressSink): Promise<AttachmentResult>;
24
- //# sourceMappingURL=attachments.d.ts.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"attachments.d.ts","sourceRoot":"","sources":["../../src/resources/run/attachments.ts"],"names":[],"mappings":"AAaA,OAAO,EAAE,KAAK,UAAU,EAAoB,MAAM,iDAAiD,CAAC;AACpG,OAAO,EACL,KAAK,uBAAuB,EAE5B,KAAK,wBAAwB,EAC9B,MAAM,+CAA+C,CAAC;AAMvD,wFAAwF;AACxF,MAAM,MAAM,YAAY,GAAG,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;AAElD,wEAAwE;AACxE,MAAM,WAAW,kBAAkB;IACjC,gBAAgB,CAAC,GAAG,EAAE,uBAAuB,GAAG,OAAO,CAAC,wBAAwB,CAAC,CAAC;CACnF;AAED;;;;GAIG;AACH,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,WAAW,EAAE,UAAU,EAAE,CAAC;IACnC,QAAQ,CAAC,iBAAiB,EAAE,MAAM,EAAE,CAAC;CACtC;AAED;;;;GAIG;AACH,wBAAsB,kBAAkB,CACtC,QAAQ,EAAE,kBAAkB,EAC5B,KAAK,EAAE,SAAS,MAAM,EAAE,EACxB,cAAc,EAAE,SAAS,MAAM,EAAE,EACjC,QAAQ,CAAC,EAAE,YAAY,GACtB,OAAO,CAAC,gBAAgB,CAAC,CAiB3B"}