@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,81 @@
1
+ import { type JsonValue } from "@bufbuild/protobuf";
2
+ import { type ProviderKey } from "@stigmer/apis/ai/stigmer/billing/providerkey/v1/api_pb";
3
+ import { type ProviderReadiness } from "@stigmer/apis/ai/stigmer/platform/v1/model_readiness_pb";
4
+ import { type DeploymentMode, type Stigmer } from "@stigmer/client";
5
+ import { CommandResult } from "../output/index.js";
6
+ /** The clients these helpers call: the provider key client and the platform's readiness. */
7
+ export type ProviderKeyClient = Pick<Stigmer, "providerkey" | "platform">;
8
+ /** The providers a key is saved for, as the contract names them (io.proto). */
9
+ export declare const PROVIDERS: readonly ["anthropic", "openai"];
10
+ export type Provider = (typeof PROVIDERS)[number];
11
+ /** The fix `set` and `delete` name on an open-source server. */
12
+ export declare const LOCAL_KEYS_FIX = "On your own machine the runner's keys come from `stigmer setup` (Anthropic) and OPENAI_API_KEY in the shell you start Stigmer from (OpenAI), then `stigmer down && stigmer up`.";
13
+ /** The provider a person typed, by the contract's own names. */
14
+ export declare function parseProvider(value: string): Provider;
15
+ /** A provider's name as a person reads it: Anthropic, OpenAI. */
16
+ export declare function providerDisplayName(provider: string): string;
17
+ /**
18
+ * The base URL `--base-url` names, checked as far as the client can: an
19
+ * https URL. Whether it resolves to a public address is the server's to say.
20
+ */
21
+ export declare function parseBaseUrl(value: string | undefined): string;
22
+ /**
23
+ * Refuses a key write on a server that keeps no provider keys: open source
24
+ * and Stigmer Enterprise hand runs to runners that hold their own keys.
25
+ */
26
+ export declare function refuseKeyWritesOff(mode: DeploymentMode): void;
27
+ /** Whether the key list could be read, and why not when it could not. */
28
+ export type KeyDetails = "read" | "not-served" | "not-permitted";
29
+ /** One provider's standing for the organization, with its key when the list was read. */
30
+ export interface ProviderStanding {
31
+ readonly readiness: ProviderReadiness;
32
+ readonly key: ProviderKey | undefined;
33
+ }
34
+ export interface ProviderListing {
35
+ readonly standings: readonly ProviderStanding[];
36
+ readonly keyDetails: KeyDetails;
37
+ }
38
+ /**
39
+ * Every provider's standing for the organization in the server's order,
40
+ * joined with the organization's keys when the server serves the key list
41
+ * and the caller may read it.
42
+ */
43
+ export declare function listProviders(client: ProviderKeyClient, org: string): Promise<ProviderListing>;
44
+ /** Where a provider stands, in words. */
45
+ export declare function standingWords(readiness: ProviderReadiness): string;
46
+ /** The list's table headers: the key's columns only when the key list was read. */
47
+ export declare function providerTableHeaders(listing: ProviderListing): string[];
48
+ /** The list's table: one row per provider, in the server's order. */
49
+ export declare function providerTableRows(listing: ProviderListing): string[][];
50
+ /**
51
+ * The list as data: each provider's readiness in protojson (snake_case,
52
+ * defaults omitted) and, when the key list was read and the provider has a
53
+ * key, that key under `key`.
54
+ */
55
+ export declare function providerListJson(listing: ProviderListing): JsonValue[];
56
+ /** The streams reading a key touches, injectable for tests. */
57
+ export interface KeyIo {
58
+ readonly stdinIsTty: boolean;
59
+ readonly readStdin: () => Promise<string>;
60
+ readonly promptHidden: (question: string) => Promise<string>;
61
+ }
62
+ /**
63
+ * Refuses a key given on the command line, as an argument or a flag: it
64
+ * would stay in the shell's history and show in the process list.
65
+ */
66
+ export declare function refuseKeyOnCommandLine(provider: Provider): never;
67
+ /**
68
+ * The key, read from stdin under `--key-stdin`, otherwise from a hidden
69
+ * prompt on a terminal. Off a terminal without `--key-stdin` there is no
70
+ * one to type it, so the command says how to pipe it in.
71
+ */
72
+ export declare function readProviderKey(provider: Provider, keyStdin: boolean, io: KeyIo): Promise<string>;
73
+ /** Save the organization's key for `provider`, and say whether the provider confirmed it. */
74
+ export declare function setProviderKey(client: ProviderKeyClient, org: string, provider: Provider, apiKey: string, baseUrl: string): Promise<CommandResult>;
75
+ /** What a save says, by the check the server made with the provider. */
76
+ export declare function savedResult(provider: Provider, saved: ProviderKey): CommandResult;
77
+ /** The question `delete` asks on a terminal before it removes a key. */
78
+ export declare function deletePrompt(provider: Provider, orgLabel: string): string;
79
+ /** Remove the organization's key for `provider`. */
80
+ export declare function deleteProviderKey(client: ProviderKeyClient, org: string, provider: Provider): Promise<CommandResult>;
81
+ //# sourceMappingURL=provider-key.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"provider-key.d.ts","sourceRoot":"","sources":["../src/resources/provider-key.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,261 @@
1
+ // `stigmer provider-key` dispatch: which model providers serve an
2
+ // organization, and on Stigmer Cloud the organization's own provider keys,
3
+ // saved, listed and removed.
4
+ //
5
+ // Two answers are joined. The platform's model readiness says, on every
6
+ // edition, where each provider stands for the organization (its own key, its
7
+ // parent's, the runners', or nothing), in the server's provider order. The
8
+ // provider key list, served by Stigmer Cloud only, adds each key's details:
9
+ // its last four characters, the endpoint it is used against, whether the
10
+ // provider confirmed it when it was saved, who saved it and when, and when a
11
+ // call last used it. A server that does not serve the key list (open source
12
+ // answers Unimplemented), or a caller who may not read it, still gets every
13
+ // provider's standing; the key columns are left out.
14
+ //
15
+ // A key is a secret: it reaches this module already read (the command layer
16
+ // reads it from a hidden prompt or from stdin, never from an argument or an
17
+ // environment variable), is sent once, and is never printed. What comes back
18
+ // is the saved key without its secret.
19
+ //
20
+ // Saving and removing are Stigmer Cloud's: on any other edition the runners
21
+ // hold their own keys, so those commands are refused with the fix for that
22
+ // edition before anything is read or sent.
23
+ import { create } from "@bufbuild/protobuf";
24
+ import { timestampDate } from "@bufbuild/protobuf/wkt";
25
+ import { ProviderKeyCheck, ProviderKeySchema, } from "@stigmer/apis/ai/stigmer/billing/providerkey/v1/api_pb";
26
+ import { DeleteProviderKeyInputSchema, ListProviderKeysInputSchema, SetProviderKeyInputSchema, } from "@stigmer/apis/ai/stigmer/billing/providerkey/v1/io_pb";
27
+ import { ProviderAvailability, ProviderReadinessSchema, } from "@stigmer/apis/ai/stigmer/platform/v1/model_readiness_pb";
28
+ import { isPermissionDenied, isUnimplemented } from "@stigmer/client";
29
+ import { CliExitError } from "../errors/cli-exit-error.js";
30
+ import { ExitCode } from "@stigmer/client/exit-codes";
31
+ import { UsageError } from "../errors/usage-error.js";
32
+ import { CommandResult, protoToJsonValue } from "../output/index.js";
33
+ import { readCursorPages } from "./cursor-pages.js";
34
+ /** The providers a key is saved for, as the contract names them (io.proto). */
35
+ export const PROVIDERS = ["anthropic", "openai"];
36
+ const DISPLAY_NAMES = new Map([
37
+ ["anthropic", "Anthropic"],
38
+ ["openai", "OpenAI"],
39
+ ]);
40
+ /** The fix `set` and `delete` name on an open-source server. */
41
+ export const LOCAL_KEYS_FIX = "On your own machine the runner's keys come from `stigmer setup` (Anthropic) and OPENAI_API_KEY in the shell you start Stigmer from (OpenAI), then `stigmer down && stigmer up`.";
42
+ /** The provider a person typed, by the contract's own names. */
43
+ export function parseProvider(value) {
44
+ const wanted = value.trim().toLowerCase();
45
+ const found = PROVIDERS.find((provider) => provider === wanted);
46
+ if (found !== undefined)
47
+ return found;
48
+ throw new UsageError(`unknown provider "${value}"\n\nUse anthropic or openai.`);
49
+ }
50
+ /** A provider's name as a person reads it: Anthropic, OpenAI. */
51
+ export function providerDisplayName(provider) {
52
+ return DISPLAY_NAMES.get(provider) ?? provider;
53
+ }
54
+ /**
55
+ * The base URL `--base-url` names, checked as far as the client can: an
56
+ * https URL. Whether it resolves to a public address is the server's to say.
57
+ */
58
+ export function parseBaseUrl(value) {
59
+ const baseUrl = (value ?? "").trim();
60
+ if (baseUrl === "")
61
+ return "";
62
+ const url = URL.canParse(baseUrl) ? new URL(baseUrl) : undefined;
63
+ if (url === undefined || url.protocol !== "https:") {
64
+ throw new UsageError(`--base-url must be an https URL, not "${baseUrl}"\n\nFor example: --base-url https://gateway.example.com/openai/v1`);
65
+ }
66
+ return baseUrl;
67
+ }
68
+ /**
69
+ * Refuses a key write on a server that keeps no provider keys: open source
70
+ * and Stigmer Enterprise hand runs to runners that hold their own keys.
71
+ */
72
+ export function refuseKeyWritesOff(mode) {
73
+ if (mode === "cloud")
74
+ return;
75
+ const fix = mode === "local"
76
+ ? LOCAL_KEYS_FIX
77
+ : "This server's runners use the keys whoever runs them gives them.";
78
+ throw new CliExitError("this server keeps no provider keys: they are saved on Stigmer Cloud", ExitCode.Usage, [
79
+ fix,
80
+ ]);
81
+ }
82
+ /**
83
+ * Every provider's standing for the organization in the server's order,
84
+ * joined with the organization's keys when the server serves the key list
85
+ * and the caller may read it.
86
+ */
87
+ export async function listProviders(client, org) {
88
+ const [readiness, keys] = await Promise.all([
89
+ client.platform.getModelReadiness(org),
90
+ readKeys(client, org),
91
+ ]);
92
+ const byProvider = new Map((Array.isArray(keys) ? keys : []).map((key) => [key.provider, key]));
93
+ return {
94
+ standings: readiness.providers.map((provider) => ({
95
+ readiness: provider,
96
+ key: byProvider.get(provider.provider),
97
+ })),
98
+ keyDetails: Array.isArray(keys) ? "read" : keys,
99
+ };
100
+ }
101
+ async function readKeys(client, org) {
102
+ try {
103
+ return await readCursorPages(0, (pageSize, pageToken) => client.providerkey.list(create(ListProviderKeysInputSchema, { org, pageSize, pageToken })));
104
+ }
105
+ catch (err) {
106
+ if (isUnimplemented(err))
107
+ return "not-served";
108
+ if (isPermissionDenied(err))
109
+ return "not-permitted";
110
+ throw err;
111
+ }
112
+ }
113
+ /** Where a provider stands, in words. */
114
+ export function standingWords(readiness) {
115
+ switch (readiness.availability) {
116
+ case ProviderAvailability.served_by_organization:
117
+ return "connected";
118
+ case ProviderAvailability.served_by_parent_organization:
119
+ return readiness.parentOrg === "" ? "through the parent organization" : `through ${readiness.parentOrg}`;
120
+ case ProviderAvailability.served_by_runners:
121
+ return "set on this machine";
122
+ case ProviderAvailability.missing_from_organization:
123
+ case ProviderAvailability.missing_from_runners:
124
+ return "not connected";
125
+ case ProviderAvailability.availability_unknown:
126
+ return "not known: set where the runner runs";
127
+ default:
128
+ return "not known";
129
+ }
130
+ }
131
+ const STANDING_HEADERS = ["PROVIDER", "STATE"];
132
+ const KEY_HEADERS = ["KEY", "ENDPOINT", "CHECK", "SAVED BY", "SAVED", "LAST USED"];
133
+ /** The list's table headers: the key's columns only when the key list was read. */
134
+ export function providerTableHeaders(listing) {
135
+ return listing.keyDetails === "read" ? [...STANDING_HEADERS, ...KEY_HEADERS] : [...STANDING_HEADERS];
136
+ }
137
+ /** The list's table: one row per provider, in the server's order. */
138
+ export function providerTableRows(listing) {
139
+ return listing.standings.map(({ readiness, key }) => {
140
+ const standing = [providerDisplayName(readiness.provider), standingWords(readiness)];
141
+ if (listing.keyDetails !== "read")
142
+ return standing;
143
+ if (key === undefined)
144
+ return [...standing, ...KEY_HEADERS.map(() => "-")];
145
+ return [
146
+ ...standing,
147
+ key.keyHint === "" ? "-" : `…${key.keyHint}`,
148
+ endpointHost(key.baseUrl),
149
+ checkWords(key.check),
150
+ key.createdBy || "-",
151
+ dayOf(key.updatedAt ?? key.createdAt) ?? "-",
152
+ dayOf(key.lastUsedAt) ?? "never",
153
+ ];
154
+ });
155
+ }
156
+ /**
157
+ * The list as data: each provider's readiness in protojson (snake_case,
158
+ * defaults omitted) and, when the key list was read and the provider has a
159
+ * key, that key under `key`.
160
+ */
161
+ export function providerListJson(listing) {
162
+ return listing.standings.map(({ readiness, key }) => {
163
+ const row = protoToJsonValue(ProviderReadinessSchema, readiness);
164
+ return key === undefined ? row : { ...row, key: protoToJsonValue(ProviderKeySchema, key) };
165
+ });
166
+ }
167
+ /**
168
+ * Refuses a key given on the command line, as an argument or a flag: it
169
+ * would stay in the shell's history and show in the process list.
170
+ */
171
+ export function refuseKeyOnCommandLine(provider) {
172
+ throw new UsageError("a provider key is never taken on the command line: it would stay in your shell history and show in the process list\n\n" +
173
+ `Type it at the hidden prompt: stigmer provider-key set ${provider}\n` +
174
+ `Or pipe it in: stigmer provider-key set ${provider} --key-stdin`);
175
+ }
176
+ /**
177
+ * The key, read from stdin under `--key-stdin`, otherwise from a hidden
178
+ * prompt on a terminal. Off a terminal without `--key-stdin` there is no
179
+ * one to type it, so the command says how to pipe it in.
180
+ */
181
+ export async function readProviderKey(provider, keyStdin, io) {
182
+ const name = providerDisplayName(provider);
183
+ let raw;
184
+ if (keyStdin) {
185
+ raw = await io.readStdin();
186
+ }
187
+ else if (io.stdinIsTty) {
188
+ raw = await io.promptHidden(`${name} key`);
189
+ }
190
+ else {
191
+ throw new UsageError(`no terminal to type the ${name} key at\n\nPipe it in: stigmer provider-key set ${provider} --key-stdin`);
192
+ }
193
+ const key = raw.trim();
194
+ if (key === "")
195
+ throw new UsageError(`no ${name} key given`);
196
+ return key;
197
+ }
198
+ /** Save the organization's key for `provider`, and say whether the provider confirmed it. */
199
+ export async function setProviderKey(client, org, provider, apiKey, baseUrl) {
200
+ const saved = await client.providerkey.set(create(SetProviderKeyInputSchema, { org, provider, apiKey, baseUrl }));
201
+ return savedResult(provider, saved);
202
+ }
203
+ /** What a save says, by the check the server made with the provider. */
204
+ export function savedResult(provider, saved) {
205
+ const name = providerDisplayName(provider);
206
+ let result;
207
+ switch (saved.check) {
208
+ case ProviderKeyCheck.checked:
209
+ result = CommandResult.success(`Saved; checked with ${name}`);
210
+ break;
211
+ case ProviderKeyCheck.unchecked:
212
+ result = CommandResult.warning(`Saved, not checked: ${name} did not answer`);
213
+ result.hint(`The first run that needs ${name} says whether the key works.`);
214
+ break;
215
+ default:
216
+ result = CommandResult.success("Saved");
217
+ }
218
+ const section = result.addSection();
219
+ section.field("Provider", name);
220
+ if (saved.keyHint !== "")
221
+ section.field("Key", `…${saved.keyHint}`);
222
+ if (saved.baseUrl !== "")
223
+ section.field("Endpoint", saved.baseUrl);
224
+ return result.withData(protoToJsonValue(ProviderKeySchema, saved));
225
+ }
226
+ /** The question `delete` asks on a terminal before it removes a key. */
227
+ export function deletePrompt(provider, orgLabel) {
228
+ const name = providerDisplayName(provider);
229
+ const serves = orgLabel === "" ? "this organization" : orgLabel;
230
+ return `Remove the ${name} key? Runs that need ${name} are refused until a key serves ${serves} again. [y/N]`;
231
+ }
232
+ /** Remove the organization's key for `provider`. */
233
+ export async function deleteProviderKey(client, org, provider) {
234
+ const removed = await client.providerkey.delete(create(DeleteProviderKeyInputSchema, { org, provider }));
235
+ const name = providerDisplayName(provider);
236
+ const result = CommandResult.success(`Removed the ${name} key`);
237
+ if (removed.keyHint !== "")
238
+ result.addSection().field("Key", `…${removed.keyHint}`);
239
+ result.hint(`Save another with: stigmer provider-key set ${provider}`);
240
+ return result.withData(protoToJsonValue(ProviderKeySchema, removed));
241
+ }
242
+ function checkWords(check) {
243
+ switch (check) {
244
+ case ProviderKeyCheck.checked:
245
+ return "checked";
246
+ case ProviderKeyCheck.unchecked:
247
+ return "not checked";
248
+ default:
249
+ return "-";
250
+ }
251
+ }
252
+ /** The endpoint's host, or "-" for the provider's own API. */
253
+ function endpointHost(baseUrl) {
254
+ if (baseUrl === "")
255
+ return "-";
256
+ return URL.canParse(baseUrl) ? new URL(baseUrl).host : baseUrl;
257
+ }
258
+ function dayOf(at) {
259
+ return at === undefined ? undefined : timestampDate(at).toISOString().slice(0, 10);
260
+ }
261
+ //# sourceMappingURL=provider-key.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"provider-key.js","sourceRoot":"","sources":["../src/resources/provider-key.ts"],"names":[],"mappings":"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"}
@@ -7,38 +7,32 @@ export type ParsedReference = {
7
7
  readonly org: string;
8
8
  readonly slug: string;
9
9
  };
10
- export declare function parseReference(ref: string, defaultOrg: string, idPrefixes: string | readonly string[]): ParsedReference;
10
+ export declare function parseReference(ref: string, defaultOrg: string, idPrefix: string): ParsedReference;
11
11
  /**
12
- * Every prefix a kind's ids may carry (from the proto kind_meta mirror): its
13
- * id_prefix, then its retired ones. Empty for a kind the mirror lacks.
12
+ * The prefix a kind's ids carry (from the proto kind_meta mirror); "" for a
13
+ * kind the mirror lacks.
14
14
  */
15
- export declare function idPrefixesFor(kind: ApiResourceKind): readonly string[];
16
- /** True if `ref` carries the agent ID prefix (`agt_…`/`agt-…`). */
15
+ export declare function idPrefixOf(kind: ApiResourceKind): string;
16
+ /** True if `ref` carries the agent ID prefix (`agt_…`). */
17
17
  export declare function isAgentId(ref: string): boolean;
18
- /** True if `ref` carries the session ID prefix (`ses_…`/`ses-…`). */
18
+ /** True if `ref` carries the session ID prefix (`ses_…`). */
19
19
  export declare function isSessionId(ref: string): boolean;
20
- /** True if `ref` carries a routine ID prefix (`rtn_…`, or `sch_…` from while the kind was Schedule; either separator). */
20
+ /** True if `ref` carries the routine ID prefix (`rtn_…`). */
21
21
  export declare function isRoutineId(ref: string): boolean;
22
- /**
23
- * True if `ref` is a run ID: `run_…`, or `aex_…` (either separator) for a run
24
- * minted before the run kind's prefix changed. Case-sensitive, so "RUN_" is
25
- * not one.
26
- */
22
+ /** True if `ref` is a run ID (`run_…`). Case-sensitive, so "RUN_" is not one. */
27
23
  export declare function isRunId(ref: string): boolean;
28
24
  /**
29
- * True if `ref` starts with ANY known resource-ID prefix (length-agnostic).
30
- * Mirrors Go's reference.HasResourceIDPrefix: use it to detect *intent* (the
31
- * user typed something ID-shaped), then {@link validateResourceId} to enforce
32
- * completeness.
25
+ * True if `ref` starts with ANY known resource-ID prefix (length-agnostic):
26
+ * use it to detect *intent* (the user typed something ID-shaped), then
27
+ * {@link validateResourceId} to enforce completeness.
33
28
  */
34
29
  export declare function hasResourceIdPrefix(ref: string): boolean;
35
30
  /**
36
31
  * Validate that `ref` is a syntactically complete resource ID. Returns null
37
- * when valid, or a user-facing error message otherwise. Mirrors Go's
38
- * reference.ValidateResourceID/ResourceIDKind: a known prefix followed by a
39
- * 26-char ULID body, or a bare UUID (legacy). A matched prefix with the wrong
40
- * body length is reported as "incomplete" so callers can guide the user to
41
- * paste the full ID.
32
+ * when valid, or a user-facing error message otherwise: a known prefix and
33
+ * "_" followed by a 26-char ULID body. A matched prefix with the wrong body
34
+ * length is reported as "incomplete" so callers can guide the user to paste
35
+ * the full ID.
42
36
  */
43
37
  export declare function validateResourceId(ref: string): string | null;
44
38
  //# sourceMappingURL=reference.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"reference.d.ts","sourceRoot":"","sources":["../src/resources/reference.ts"],"names":[],"mappings":"AAkBA,OAAO,EAAE,eAAe,EAAE,MAAM,mFAAmF,CAAC;AAGpH,MAAM,MAAM,eAAe,GACvB;IAAE,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC;IAAC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;CAAE,GAC5C;IAAE,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAE1E,wBAAgB,cAAc,CAC5B,GAAG,EAAE,MAAM,EACX,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,GACrC,eAAe,CAcjB;AAOD;;;GAGG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,eAAe,GAAG,SAAS,MAAM,EAAE,CAItE;AAoCD,mEAAmE;AACnE,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAE9C;AAED,qEAAqE;AACrE,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAEhD;AAED,0HAA0H;AAC1H,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAEhD;AAED;;;;GAIG;AACH,wBAAgB,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAE5C;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAGxD;AAED;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAe7D"}
1
+ {"version":3,"file":"reference.d.ts","sourceRoot":"","sources":["../src/resources/reference.ts"],"names":[],"mappings":"AAgBA,OAAO,EAAE,eAAe,EAAE,MAAM,mFAAmF,CAAC;AAGpH,MAAM,MAAM,eAAe,GACvB;IAAE,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC;IAAC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;CAAE,GAC5C;IAAE,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAE1E,wBAAgB,cAAc,CAC5B,GAAG,EAAE,MAAM,EACX,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,GACf,eAAe,CAajB;AAOD;;;GAGG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,eAAe,GAAG,MAAM,CAExD;AAyBD,2DAA2D;AAC3D,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAE9C;AAED,6DAA6D;AAC7D,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAEhD;AAED,6DAA6D;AAC7D,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAEhD;AAED,iFAAiF;AACjF,wBAAgB,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAE5C;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAExD;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAW7D"}
@@ -1,152 +1,106 @@
1
1
  // Parse a user-supplied resource reference into either an ID lookup or an
2
- // org/slug lookup, mirroring the Go CLI's parseOrgSlug + ID detection.
2
+ // org/slug lookup.
3
3
  //
4
4
  // "agt_abc123" -> by ID
5
5
  // "my-org/my-agent" -> by org/slug (explicit org)
6
6
  // "my-agent" -> by org/slug (org from --org/context)
7
7
  //
8
- // The kind's id prefixes disambiguate a bare token: "org" resolves "org_x" as
9
- // an ID but "acme" as a slug. A kind's retired prefixes count too (a run
10
- // minted as "aex_…" before the run kind's prefix became "run"): ids are never
11
- // rewritten, so a stored id keeps the prefix it was minted with.
8
+ // The kind's id prefix disambiguates a bare token: "org" resolves "org_x" as
9
+ // an ID but "acme" as a slug.
12
10
  //
13
11
  // The lower half of this module adds the *strict* classification the run/resume
14
- // resolvers need (Go's pkg/reference): prefix-by-kind detection and full ID
15
- // validation (prefix + 26-char ULID, or UUID). This is deliberately distinct
16
- // from parseReference's lenient `${prefix}_` test — `run my-agent` must not
12
+ // resolvers need: prefix-by-kind detection and full ID validation (prefix, "_"
13
+ // and a 26-char ULID, the only id shape the server mints). This is deliberately
14
+ // distinct from parseReference's lenient `${prefix}_` test — `run my-agent` must not
17
15
  // treat a slug that merely starts with a known prefix as an ID.
18
16
  import { ApiResourceKind } from "@stigmer/apis/ai/stigmer/commons/apiresource/apiresourcekind/api_resource_kind_pb";
19
17
  import { KIND_META } from "../registry/index.js";
20
- export function parseReference(ref, defaultOrg, idPrefixes) {
18
+ export function parseReference(ref, defaultOrg, idPrefix) {
21
19
  const trimmed = ref.trim();
22
20
  const slash = trimmed.indexOf("/");
23
21
  if (slash > 0) {
24
22
  return { kind: "ref", org: trimmed.slice(0, slash), slug: trimmed.slice(slash + 1) };
25
23
  }
26
- const prefixes = typeof idPrefixes === "string" ? [idPrefixes] : idPrefixes;
27
- if (prefixes.some((prefix) => prefix !== "" && trimmed.startsWith(`${prefix}_`))) {
24
+ if (idPrefix !== "" && trimmed.startsWith(`${idPrefix}_`)) {
28
25
  return { kind: "id", id: trimmed };
29
26
  }
30
27
  return { kind: "ref", org: defaultOrg, slug: trimmed };
31
28
  }
32
- // Crockford base-32 ULID body length. Mirrors Go's reference.ulidLength: the
33
- // resolver only checks the length (not the alphabet), so a 26-char body after a
34
- // known prefix is accepted as a complete ID.
29
+ // Crockford base-32 ULID body length. The resolver checks only the length (not
30
+ // the alphabet), so a 26-char body after a known prefix is accepted as a
31
+ // complete ID; the server judges the rest.
35
32
  const ULID_LENGTH = 26;
36
33
  /**
37
- * Every prefix a kind's ids may carry (from the proto kind_meta mirror): its
38
- * id_prefix, then its retired ones. Empty for a kind the mirror lacks.
34
+ * The prefix a kind's ids carry (from the proto kind_meta mirror); "" for a
35
+ * kind the mirror lacks.
39
36
  */
40
- export function idPrefixesFor(kind) {
41
- const meta = KIND_META.get(kind);
42
- if (meta === undefined)
43
- return [];
44
- return [meta.idPrefix, ...(meta.retiredIdPrefixes ?? [])].filter((prefix) => prefix !== "");
37
+ export function idPrefixOf(kind) {
38
+ return KIND_META.get(kind)?.idPrefix ?? "";
45
39
  }
46
- // Every known resource-ID prefix, current and retired, deduped. Built once
47
- // from the kind_meta mirror so there is a single source of truth shared with
48
- // the rest of the CLI (the registry) rather than a hand-rolled prefix list.
40
+ // Every known resource-ID prefix, deduped. Built once from the kind_meta
41
+ // mirror so there is a single source of truth shared with the rest of the CLI
42
+ // (the registry) rather than a hand-rolled prefix list.
49
43
  const ALL_ID_PREFIXES = (() => {
50
44
  const set = new Set();
51
45
  for (const kind of KIND_META.keys()) {
52
- for (const prefix of idPrefixesFor(kind))
46
+ const prefix = idPrefixOf(kind);
47
+ if (prefix !== "")
53
48
  set.add(prefix);
54
49
  }
55
50
  return [...set];
56
51
  })();
57
- // The legacy "-" separator (Go's reference package) predates the run kind's
58
- // "run" prefix: no id was ever minted "run-…", and "run-" is how an agent slug
59
- // such as "run-nightly-report" starts, so that prefix takes "_" only.
60
- const UNDERSCORE_ONLY_PREFIXES = new Set(["run"]);
61
- /** The separators an id may carry after `prefix`: "_" canonical, "-" legacy. */
62
- function separatorsFor(prefix) {
63
- return UNDERSCORE_ONLY_PREFIXES.has(prefix) ? ["_"] : ["_", "-"];
64
- }
65
- // Mirrors Go's reference.isResourceIDWithKind: a kind prefix followed by a
66
- // separator {@link separatorsFor} allows it. Case-sensitive.
52
+ // A kind prefix followed by "_". Case-sensitive, so "RUN_" is not a run id.
67
53
  function hasKindPrefix(ref, prefix) {
68
54
  if (prefix === "")
69
55
  return false;
70
- const trimmed = ref.trim();
71
- return separatorsFor(prefix).some((sep) => trimmed.startsWith(`${prefix}${sep}`));
56
+ return ref.trim().startsWith(`${prefix}_`);
72
57
  }
73
- /** True if `ref` carries one of `kind`'s id prefixes, current or retired. */
58
+ /** True if `ref` carries `kind`'s id prefix. */
74
59
  function hasPrefixOf(ref, kind) {
75
- return idPrefixesFor(kind).some((prefix) => hasKindPrefix(ref, prefix));
60
+ return hasKindPrefix(ref, idPrefixOf(kind));
76
61
  }
77
- /** True if `ref` carries the agent ID prefix (`agt_…`/`agt-…`). */
62
+ /** True if `ref` carries the agent ID prefix (`agt_…`). */
78
63
  export function isAgentId(ref) {
79
64
  return hasPrefixOf(ref, ApiResourceKind.agent);
80
65
  }
81
- /** True if `ref` carries the session ID prefix (`ses_…`/`ses-…`). */
66
+ /** True if `ref` carries the session ID prefix (`ses_…`). */
82
67
  export function isSessionId(ref) {
83
68
  return hasPrefixOf(ref, ApiResourceKind.session);
84
69
  }
85
- /** True if `ref` carries a routine ID prefix (`rtn_…`, or `sch_…` from while the kind was Schedule; either separator). */
70
+ /** True if `ref` carries the routine ID prefix (`rtn_…`). */
86
71
  export function isRoutineId(ref) {
87
72
  return hasPrefixOf(ref, ApiResourceKind.routine);
88
73
  }
89
- /**
90
- * True if `ref` is a run ID: `run_…`, or `aex_…` (either separator) for a run
91
- * minted before the run kind's prefix changed. Case-sensitive, so "RUN_" is
92
- * not one.
93
- */
74
+ /** True if `ref` is a run ID (`run_…`). Case-sensitive, so "RUN_" is not one. */
94
75
  export function isRunId(ref) {
95
76
  return hasPrefixOf(ref, ApiResourceKind.run);
96
77
  }
97
78
  /**
98
- * True if `ref` starts with ANY known resource-ID prefix (length-agnostic).
99
- * Mirrors Go's reference.HasResourceIDPrefix: use it to detect *intent* (the
100
- * user typed something ID-shaped), then {@link validateResourceId} to enforce
101
- * completeness.
79
+ * True if `ref` starts with ANY known resource-ID prefix (length-agnostic):
80
+ * use it to detect *intent* (the user typed something ID-shaped), then
81
+ * {@link validateResourceId} to enforce completeness.
102
82
  */
103
83
  export function hasResourceIdPrefix(ref) {
104
- if (ALL_ID_PREFIXES.some((prefix) => hasKindPrefix(ref, prefix)))
105
- return true;
106
- return isUuid(ref.trim());
84
+ return ALL_ID_PREFIXES.some((prefix) => hasKindPrefix(ref, prefix));
107
85
  }
108
86
  /**
109
87
  * Validate that `ref` is a syntactically complete resource ID. Returns null
110
- * when valid, or a user-facing error message otherwise. Mirrors Go's
111
- * reference.ValidateResourceID/ResourceIDKind: a known prefix followed by a
112
- * 26-char ULID body, or a bare UUID (legacy). A matched prefix with the wrong
113
- * body length is reported as "incomplete" so callers can guide the user to
114
- * paste the full ID.
88
+ * when valid, or a user-facing error message otherwise: a known prefix and
89
+ * "_" followed by a 26-char ULID body. A matched prefix with the wrong body
90
+ * length is reported as "incomplete" so callers can guide the user to paste
91
+ * the full ID.
115
92
  */
116
93
  export function validateResourceId(ref) {
117
94
  const trimmed = ref.trim();
118
95
  for (const prefix of ALL_ID_PREFIXES) {
119
- for (const sep of separatorsFor(prefix)) {
120
- const pfx = `${prefix}${sep}`;
121
- if (!trimmed.startsWith(pfx))
122
- continue;
123
- const body = trimmed.slice(pfx.length);
124
- if (body.length !== ULID_LENGTH) {
125
- return "incomplete resource ID: expected 26-character ULID after prefix";
126
- }
127
- return null;
96
+ const pfx = `${prefix}_`;
97
+ if (!trimmed.startsWith(pfx))
98
+ continue;
99
+ if (trimmed.length - pfx.length !== ULID_LENGTH) {
100
+ return "incomplete resource ID: expected 26-character ULID after prefix";
128
101
  }
129
- }
130
- if (isUuid(trimmed))
131
102
  return null;
132
- return "not a recognized resource ID";
133
- }
134
- // Mirrors Go's reference.isUUID: 8-4-4-4-12 hex with hyphens at fixed offsets.
135
- function isUuid(value) {
136
- if (value.length !== 36)
137
- return false;
138
- if (value[8] !== "-" || value[13] !== "-" || value[18] !== "-" || value[23] !== "-") {
139
- return false;
140
103
  }
141
- for (let i = 0; i < value.length; i++) {
142
- if (i === 8 || i === 13 || i === 18 || i === 23)
143
- continue;
144
- if (!isHexDigit(value[i]))
145
- return false;
146
- }
147
- return true;
148
- }
149
- function isHexDigit(c) {
150
- return (c >= "0" && c <= "9") || (c >= "a" && c <= "f") || (c >= "A" && c <= "F");
104
+ return "not a recognized resource ID";
151
105
  }
152
106
  //# sourceMappingURL=reference.js.map