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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (760) hide show
  1. package/README.md +5 -4
  2. package/auth/auth0.js +1 -1
  3. package/auth/auth0.js.map +1 -1
  4. package/auth/token.d.ts +26 -4
  5. package/auth/token.d.ts.map +1 -1
  6. package/auth/token.js +120 -24
  7. package/auth/token.js.map +1 -1
  8. package/client/client.d.ts.map +1 -1
  9. package/client/client.js +21 -8
  10. package/client/client.js.map +1 -1
  11. package/command-tree.d.ts +63 -0
  12. package/command-tree.d.ts.map +1 -0
  13. package/command-tree.js +128 -0
  14. package/command-tree.js.map +1 -0
  15. package/commands/access-history/index.d.ts.map +1 -1
  16. package/commands/access-history/index.js +13 -1
  17. package/commands/access-history/index.js.map +1 -1
  18. package/commands/agent-exec-flags.d.ts +2 -0
  19. package/commands/agent-exec-flags.d.ts.map +1 -1
  20. package/commands/agent-exec-flags.js +9 -5
  21. package/commands/agent-exec-flags.js.map +1 -1
  22. package/commands/apikey/duration.d.ts.map +1 -1
  23. package/commands/apikey/duration.js +1 -2
  24. package/commands/apikey/duration.js.map +1 -1
  25. package/commands/apikey/index.d.ts.map +1 -1
  26. package/commands/apikey/index.js +3 -4
  27. package/commands/apikey/index.js.map +1 -1
  28. package/commands/apply.d.ts.map +1 -1
  29. package/commands/apply.js +2 -32
  30. package/commands/apply.js.map +1 -1
  31. package/commands/auth/index.d.ts.map +1 -1
  32. package/commands/auth/index.js +7 -5
  33. package/commands/auth/index.js.map +1 -1
  34. package/commands/auth/whoami.js +1 -1
  35. package/commands/config/index.js +3 -3
  36. package/commands/config/kv.d.ts.map +1 -1
  37. package/commands/config/kv.js +18 -14
  38. package/commands/config/kv.js.map +1 -1
  39. package/commands/connect.d.ts.map +1 -1
  40. package/commands/connect.js +18 -2
  41. package/commands/connect.js.map +1 -1
  42. package/commands/download.d.ts.map +1 -1
  43. package/commands/download.js +81 -54
  44. package/commands/download.js.map +1 -1
  45. package/commands/eval.d.ts.map +1 -1
  46. package/commands/eval.js +17 -19
  47. package/commands/eval.js.map +1 -1
  48. package/commands/file.d.ts +3 -0
  49. package/commands/file.d.ts.map +1 -0
  50. package/commands/file.js +64 -0
  51. package/commands/file.js.map +1 -0
  52. package/commands/get.d.ts.map +1 -1
  53. package/commands/get.js +20 -13
  54. package/commands/get.js.map +1 -1
  55. package/commands/help.d.ts +15 -0
  56. package/commands/help.d.ts.map +1 -0
  57. package/commands/help.js +175 -0
  58. package/commands/help.js.map +1 -0
  59. package/commands/internal-daemon.d.ts.map +1 -1
  60. package/commands/internal-daemon.js +9 -2
  61. package/commands/internal-daemon.js.map +1 -1
  62. package/commands/list.d.ts.map +1 -1
  63. package/commands/list.js +22 -1
  64. package/commands/list.js.map +1 -1
  65. package/commands/logs.js +1 -1
  66. package/commands/logs.js.map +1 -1
  67. package/commands/mcp-server.d.ts +16 -6
  68. package/commands/mcp-server.d.ts.map +1 -1
  69. package/commands/mcp-server.js +51 -26
  70. package/commands/mcp-server.js.map +1 -1
  71. package/commands/provider-key/index.d.ts +3 -0
  72. package/commands/provider-key/index.d.ts.map +1 -0
  73. package/commands/provider-key/index.js +156 -0
  74. package/commands/provider-key/index.js.map +1 -0
  75. package/commands/push.js +8 -8
  76. package/commands/push.js.map +1 -1
  77. package/commands/resume.d.ts.map +1 -1
  78. package/commands/resume.js +17 -11
  79. package/commands/resume.js.map +1 -1
  80. package/commands/routine.d.ts.map +1 -1
  81. package/commands/routine.js +42 -3
  82. package/commands/routine.js.map +1 -1
  83. package/commands/run.d.ts.map +1 -1
  84. package/commands/run.js +34 -15
  85. package/commands/run.js.map +1 -1
  86. package/commands/runs/approve.d.ts.map +1 -1
  87. package/commands/runs/approve.js +10 -2
  88. package/commands/runs/approve.js.map +1 -1
  89. package/commands/runs/control.d.ts.map +1 -1
  90. package/commands/runs/control.js +24 -16
  91. package/commands/runs/control.js.map +1 -1
  92. package/commands/runs/index.d.ts.map +1 -1
  93. package/commands/runs/index.js +1 -2
  94. package/commands/runs/index.js.map +1 -1
  95. package/commands/runs/logs.d.ts.map +1 -1
  96. package/commands/runs/logs.js +7 -4
  97. package/commands/runs/logs.js.map +1 -1
  98. package/commands/runs/to-eval-case.d.ts.map +1 -1
  99. package/commands/runs/to-eval-case.js +13 -4
  100. package/commands/runs/to-eval-case.js.map +1 -1
  101. package/commands/runs/trace.js +1 -1
  102. package/commands/runs/trace.js.map +1 -1
  103. package/commands/search.js +2 -3
  104. package/commands/search.js.map +1 -1
  105. package/commands/service-account/index.d.ts.map +1 -1
  106. package/commands/service-account/index.js +4 -2
  107. package/commands/service-account/index.js.map +1 -1
  108. package/commands/session-help.d.ts +5 -0
  109. package/commands/session-help.d.ts.map +1 -0
  110. package/commands/session-help.js +38 -0
  111. package/commands/session-help.js.map +1 -0
  112. package/commands/setup.js +5 -5
  113. package/commands/setup.js.map +1 -1
  114. package/commands/shared.d.ts +10 -2
  115. package/commands/shared.d.ts.map +1 -1
  116. package/commands/shared.js +30 -3
  117. package/commands/shared.js.map +1 -1
  118. package/commands/tag.d.ts.map +1 -1
  119. package/commands/tag.js +11 -6
  120. package/commands/tag.js.map +1 -1
  121. package/commands/up.d.ts.map +1 -1
  122. package/commands/up.js +51 -21
  123. package/commands/up.js.map +1 -1
  124. package/commands/validate.js +2 -2
  125. package/commands/validate.js.map +1 -1
  126. package/commands/version.d.ts.map +1 -1
  127. package/commands/version.js +8 -4
  128. package/commands/version.js.map +1 -1
  129. package/config/config.d.ts +5 -22
  130. package/config/config.d.ts.map +1 -1
  131. package/config/config.js +56 -47
  132. package/config/config.js.map +1 -1
  133. package/config/index.d.ts +2 -2
  134. package/config/index.d.ts.map +1 -1
  135. package/config/index.js +1 -1
  136. package/config/index.js.map +1 -1
  137. package/config/keys.js +4 -4
  138. package/config/keys.js.map +1 -1
  139. package/config/paths.js +2 -2
  140. package/config/paths.js.map +1 -1
  141. package/config/resolve.d.ts +12 -2
  142. package/config/resolve.d.ts.map +1 -1
  143. package/config/resolve.js +18 -8
  144. package/config/resolve.js.map +1 -1
  145. package/errors/classify.d.ts +20 -0
  146. package/errors/classify.d.ts.map +1 -1
  147. package/errors/classify.js +97 -21
  148. package/errors/classify.js.map +1 -1
  149. package/errors/command-line.d.ts +14 -0
  150. package/errors/command-line.d.ts.map +1 -0
  151. package/errors/command-line.js +90 -0
  152. package/errors/command-line.js.map +1 -0
  153. package/errors/handle.js +2 -2
  154. package/errors/handle.js.map +1 -1
  155. package/errors/index.d.ts +2 -2
  156. package/errors/index.d.ts.map +1 -1
  157. package/errors/index.js +12 -2
  158. package/errors/index.js.map +1 -1
  159. package/errors/usage-error.js +1 -1
  160. package/errors/usage-error.js.map +1 -1
  161. package/global-options.d.ts +35 -0
  162. package/global-options.d.ts.map +1 -0
  163. package/global-options.js +81 -0
  164. package/global-options.js.map +1 -0
  165. package/local/artifact.d.ts +1 -20
  166. package/local/artifact.d.ts.map +1 -1
  167. package/local/artifact.js +35 -117
  168. package/local/artifact.js.map +1 -1
  169. package/local/constants.d.ts +3 -9
  170. package/local/constants.d.ts.map +1 -1
  171. package/local/constants.js +3 -9
  172. package/local/constants.js.map +1 -1
  173. package/local/daemon/components.d.ts +18 -5
  174. package/local/daemon/components.d.ts.map +1 -1
  175. package/local/daemon/components.js +61 -23
  176. package/local/daemon/components.js.map +1 -1
  177. package/local/daemon/env.d.ts +1 -5
  178. package/local/daemon/env.d.ts.map +1 -1
  179. package/local/daemon/env.js +0 -2
  180. package/local/daemon/env.js.map +1 -1
  181. package/local/daemon/host.d.ts +5 -0
  182. package/local/daemon/host.d.ts.map +1 -1
  183. package/local/daemon/host.js +68 -21
  184. package/local/daemon/host.js.map +1 -1
  185. package/local/daemon/index.d.ts +2 -1
  186. package/local/daemon/index.d.ts.map +1 -1
  187. package/local/daemon/index.js +2 -1
  188. package/local/daemon/index.js.map +1 -1
  189. package/local/daemon/launch.d.ts +58 -9
  190. package/local/daemon/launch.d.ts.map +1 -1
  191. package/local/daemon/launch.js +210 -64
  192. package/local/daemon/launch.js.map +1 -1
  193. package/local/daemon/process.d.ts +11 -7
  194. package/local/daemon/process.d.ts.map +1 -1
  195. package/local/daemon/process.js +74 -38
  196. package/local/daemon/process.js.map +1 -1
  197. package/local/daemon/signals.d.ts +3 -0
  198. package/local/daemon/signals.d.ts.map +1 -0
  199. package/local/daemon/signals.js +19 -0
  200. package/local/daemon/signals.js.map +1 -0
  201. package/local/daemon/supervisor.d.ts +9 -2
  202. package/local/daemon/supervisor.d.ts.map +1 -1
  203. package/local/daemon/supervisor.js +81 -22
  204. package/local/daemon/supervisor.js.map +1 -1
  205. package/local/daemon/types.d.ts +6 -1
  206. package/local/daemon/types.d.ts.map +1 -1
  207. package/local/daemon/types.js +2 -3
  208. package/local/daemon/types.js.map +1 -1
  209. package/local/llm-config.d.ts +4 -2
  210. package/local/llm-config.d.ts.map +1 -1
  211. package/local/llm-config.js +15 -9
  212. package/local/llm-config.js.map +1 -1
  213. package/local/logs/view.d.ts.map +1 -1
  214. package/local/logs/view.js +5 -6
  215. package/local/logs/view.js.map +1 -1
  216. package/local/net/tcp.d.ts +8 -6
  217. package/local/net/tcp.d.ts.map +1 -1
  218. package/local/net/tcp.js +13 -8
  219. package/local/net/tcp.js.map +1 -1
  220. package/local/paths.d.ts +1 -1
  221. package/local/paths.d.ts.map +1 -1
  222. package/local/paths.js +2 -3
  223. package/local/paths.js.map +1 -1
  224. package/local/provider-reach.d.ts +18 -0
  225. package/local/provider-reach.d.ts.map +1 -0
  226. package/local/provider-reach.js +109 -0
  227. package/local/provider-reach.js.map +1 -0
  228. package/local/reset.d.ts.map +1 -1
  229. package/local/reset.js +1 -2
  230. package/local/reset.js.map +1 -1
  231. package/local/runtime/index.d.ts.map +1 -1
  232. package/local/runtime/index.js +1 -2
  233. package/local/runtime/index.js.map +1 -1
  234. package/local/runtime/node.js +1 -1
  235. package/local/runtime/runner.js +2 -2
  236. package/local/runtime/runner.js.map +1 -1
  237. package/local/runtime/runtimes-install.js +1 -1
  238. package/local/runtime/server.d.ts.map +1 -1
  239. package/local/runtime/server.js +2 -4
  240. package/local/runtime/server.js.map +1 -1
  241. package/local/runtime/which.js +1 -1
  242. package/local/runtime/which.js.map +1 -1
  243. package/local/setup/wizard.d.ts +1 -1
  244. package/local/setup/wizard.d.ts.map +1 -1
  245. package/local/setup/wizard.js +7 -5
  246. package/local/setup/wizard.js.map +1 -1
  247. package/local/state/health-state.d.ts +6 -0
  248. package/local/state/health-state.d.ts.map +1 -1
  249. package/local/state/health-state.js +6 -2
  250. package/local/state/health-state.js.map +1 -1
  251. package/local/state/lock.d.ts +3 -2
  252. package/local/state/lock.d.ts.map +1 -1
  253. package/local/state/lock.js +26 -28
  254. package/local/state/lock.js.map +1 -1
  255. package/local/state/log-rotation.d.ts.map +1 -1
  256. package/local/state/log-rotation.js +2 -3
  257. package/local/state/log-rotation.js.map +1 -1
  258. package/local/state/pidfile.d.ts +24 -1
  259. package/local/state/pidfile.d.ts.map +1 -1
  260. package/local/state/pidfile.js +54 -6
  261. package/local/state/pidfile.js.map +1 -1
  262. package/local/state/proc.d.ts +31 -0
  263. package/local/state/proc.d.ts.map +1 -1
  264. package/local/state/proc.js +98 -1
  265. package/local/state/proc.js.map +1 -1
  266. package/local/state/startup-config.d.ts +2 -2
  267. package/local/status.d.ts +2 -4
  268. package/local/status.d.ts.map +1 -1
  269. package/local/status.js +26 -41
  270. package/local/status.js.map +1 -1
  271. package/local/temporal/download.d.ts +9 -5
  272. package/local/temporal/download.d.ts.map +1 -1
  273. package/local/temporal/download.js +29 -8
  274. package/local/temporal/download.js.map +1 -1
  275. package/local/temporal/index.d.ts +1 -1
  276. package/local/temporal/index.d.ts.map +1 -1
  277. package/local/temporal/index.js +1 -1
  278. package/local/temporal/index.js.map +1 -1
  279. package/local/temporal/manager.d.ts +31 -5
  280. package/local/temporal/manager.d.ts.map +1 -1
  281. package/local/temporal/manager.js +74 -35
  282. package/local/temporal/manager.js.map +1 -1
  283. package/local/temporal/supervisor.js +1 -1
  284. package/local/temporal/supervisor.js.map +1 -1
  285. package/local/webconsole/index.d.ts +5 -2
  286. package/local/webconsole/index.d.ts.map +1 -1
  287. package/local/webconsole/index.js +8 -6
  288. package/local/webconsole/index.js.map +1 -1
  289. package/marketplace/github.js +1 -1
  290. package/marketplace/github.js.map +1 -1
  291. package/marketplace/official.js +1 -1
  292. package/marketplace/official.js.map +1 -1
  293. package/output/command-result.d.ts +6 -0
  294. package/output/command-result.d.ts.map +1 -1
  295. package/output/command-result.js +13 -2
  296. package/output/command-result.js.map +1 -1
  297. package/output/confirm.d.ts.map +1 -1
  298. package/output/confirm.js +2 -3
  299. package/output/confirm.js.map +1 -1
  300. package/output/format.d.ts.map +1 -1
  301. package/output/format.js +5 -6
  302. package/output/format.js.map +1 -1
  303. package/output/index.d.ts +2 -2
  304. package/output/index.d.ts.map +1 -1
  305. package/output/index.js +2 -2
  306. package/output/index.js.map +1 -1
  307. package/output/printable.d.ts +8 -0
  308. package/output/printable.d.ts.map +1 -0
  309. package/output/printable.js +24 -0
  310. package/output/printable.js.map +1 -0
  311. package/output/proto.d.ts.map +1 -1
  312. package/output/proto.js +3 -4
  313. package/output/proto.js.map +1 -1
  314. package/output/style.js +2 -2
  315. package/output/style.js.map +1 -1
  316. package/output/table.d.ts +20 -1
  317. package/output/table.d.ts.map +1 -1
  318. package/output/table.js +75 -17
  319. package/output/table.js.map +1 -1
  320. package/package.json +13 -10
  321. package/program.d.ts +0 -14
  322. package/program.d.ts.map +1 -1
  323. package/program.js +57 -119
  324. package/program.js.map +1 -1
  325. package/registry/aliases.d.ts.map +1 -1
  326. package/registry/aliases.js +0 -3
  327. package/registry/aliases.js.map +1 -1
  328. package/registry/index.d.ts +1 -1
  329. package/registry/index.d.ts.map +1 -1
  330. package/registry/index.js +1 -1
  331. package/registry/index.js.map +1 -1
  332. package/registry/metadata.d.ts +0 -15
  333. package/registry/metadata.d.ts.map +1 -1
  334. package/registry/metadata.js +16 -57
  335. package/registry/metadata.js.map +1 -1
  336. package/registry/registry.d.ts +1 -5
  337. package/registry/registry.d.ts.map +1 -1
  338. package/registry/registry.js +3 -11
  339. package/registry/registry.js.map +1 -1
  340. package/registry/verb-support.d.ts.map +1 -1
  341. package/registry/verb-support.js +28 -5
  342. package/registry/verb-support.js.map +1 -1
  343. package/resources/agent/quality.d.ts +10 -5
  344. package/resources/agent/quality.d.ts.map +1 -1
  345. package/resources/agent/quality.js +19 -9
  346. package/resources/agent/quality.js.map +1 -1
  347. package/resources/agent/resolve.js +3 -3
  348. package/resources/agent/resolve.js.map +1 -1
  349. package/resources/apply/apply.d.ts +4 -3
  350. package/resources/apply/apply.d.ts.map +1 -1
  351. package/resources/apply/apply.js +54 -41
  352. package/resources/apply/apply.js.map +1 -1
  353. package/resources/apply/handlers.d.ts.map +1 -1
  354. package/resources/apply/handlers.js +3 -4
  355. package/resources/apply/handlers.js.map +1 -1
  356. package/resources/channel.d.ts.map +1 -1
  357. package/resources/channel.js +3 -4
  358. package/resources/channel.js.map +1 -1
  359. package/resources/connect/connect.js +2 -2
  360. package/resources/connect/connect.js.map +1 -1
  361. package/resources/delete.d.ts.map +1 -1
  362. package/resources/delete.js +38 -4
  363. package/resources/delete.js.map +1 -1
  364. package/resources/documents.js +1 -1
  365. package/resources/documents.js.map +1 -1
  366. package/resources/download.d.ts +43 -3
  367. package/resources/download.d.ts.map +1 -1
  368. package/resources/download.js +169 -34
  369. package/resources/download.js.map +1 -1
  370. package/resources/eval-run/options.d.ts +3 -1
  371. package/resources/eval-run/options.d.ts.map +1 -1
  372. package/resources/eval-run/options.js +36 -18
  373. package/resources/eval-run/options.js.map +1 -1
  374. package/resources/eval-run/report.d.ts +4 -2
  375. package/resources/eval-run/report.d.ts.map +1 -1
  376. package/resources/eval-run/report.js +9 -7
  377. package/resources/eval-run/report.js.map +1 -1
  378. package/resources/eval-run/run.d.ts +2 -1
  379. package/resources/eval-run/run.d.ts.map +1 -1
  380. package/resources/eval-run/run.js +13 -7
  381. package/resources/eval-run/run.js.map +1 -1
  382. package/resources/file.d.ts +27 -0
  383. package/resources/file.d.ts.map +1 -0
  384. package/resources/file.js +82 -0
  385. package/resources/file.js.map +1 -0
  386. package/resources/get-bindings.d.ts.map +1 -1
  387. package/resources/get-bindings.js +18 -0
  388. package/resources/get-bindings.js.map +1 -1
  389. package/resources/git.d.ts +1 -1
  390. package/resources/git.js +1 -1
  391. package/resources/list.d.ts +21 -2
  392. package/resources/list.d.ts.map +1 -1
  393. package/resources/list.js +148 -31
  394. package/resources/list.js.map +1 -1
  395. package/resources/plugin.d.ts.map +1 -1
  396. package/resources/plugin.js +4 -0
  397. package/resources/plugin.js.map +1 -1
  398. package/resources/provider-key.d.ts +81 -0
  399. package/resources/provider-key.d.ts.map +1 -0
  400. package/resources/provider-key.js +261 -0
  401. package/resources/provider-key.js.map +1 -0
  402. package/resources/reference.d.ts +15 -21
  403. package/resources/reference.d.ts.map +1 -1
  404. package/resources/reference.js +42 -88
  405. package/resources/reference.js.map +1 -1
  406. package/resources/render.d.ts +31 -7
  407. package/resources/render.d.ts.map +1 -1
  408. package/resources/render.js +66 -38
  409. package/resources/render.js.map +1 -1
  410. package/resources/routine.d.ts +21 -5
  411. package/resources/routine.d.ts.map +1 -1
  412. package/resources/routine.js +104 -15
  413. package/resources/routine.js.map +1 -1
  414. package/resources/run/agent-exec.d.ts +12 -2
  415. package/resources/run/agent-exec.d.ts.map +1 -1
  416. package/resources/run/agent-exec.js +85 -38
  417. package/resources/run/agent-exec.js.map +1 -1
  418. package/resources/run/create.d.ts +16 -12
  419. package/resources/run/create.d.ts.map +1 -1
  420. package/resources/run/create.js +14 -15
  421. package/resources/run/create.js.map +1 -1
  422. package/resources/run/engines.d.ts +32 -0
  423. package/resources/run/engines.d.ts.map +1 -0
  424. package/resources/run/engines.js +39 -0
  425. package/resources/run/engines.js.map +1 -0
  426. package/resources/run/environment.d.ts +11 -0
  427. package/resources/run/environment.d.ts.map +1 -0
  428. package/resources/run/environment.js +30 -0
  429. package/resources/run/environment.js.map +1 -0
  430. package/resources/run/epilogue.d.ts +1 -1
  431. package/resources/run/epilogue.d.ts.map +1 -1
  432. package/resources/run/epilogue.js +18 -19
  433. package/resources/run/epilogue.js.map +1 -1
  434. package/resources/run/files.d.ts +104 -0
  435. package/resources/run/files.d.ts.map +1 -0
  436. package/resources/run/files.js +316 -0
  437. package/resources/run/files.js.map +1 -0
  438. package/resources/run/header.d.ts +11 -9
  439. package/resources/run/header.d.ts.map +1 -1
  440. package/resources/run/header.js +14 -14
  441. package/resources/run/header.js.map +1 -1
  442. package/resources/run/prepare.d.ts +31 -25
  443. package/resources/run/prepare.d.ts.map +1 -1
  444. package/resources/run/prepare.js +42 -51
  445. package/resources/run/prepare.js.map +1 -1
  446. package/resources/run/references.d.ts.map +1 -1
  447. package/resources/run/references.js +6 -5
  448. package/resources/run/references.js.map +1 -1
  449. package/resources/run/resolve.js +1 -1
  450. package/resources/run/resolve.js.map +1 -1
  451. package/resources/run/resume.d.ts +3 -1
  452. package/resources/run/resume.d.ts.map +1 -1
  453. package/resources/run/resume.js +25 -10
  454. package/resources/run/resume.js.map +1 -1
  455. package/resources/run/stream.d.ts +34 -2
  456. package/resources/run/stream.d.ts.map +1 -1
  457. package/resources/run/stream.js +92 -8
  458. package/resources/run/stream.js.map +1 -1
  459. package/resources/run/workspace.d.ts +9 -12
  460. package/resources/run/workspace.d.ts.map +1 -1
  461. package/resources/run/workspace.js +29 -36
  462. package/resources/run/workspace.js.map +1 -1
  463. package/resources/run-approve.d.ts.map +1 -1
  464. package/resources/run-approve.js +2 -11
  465. package/resources/run-approve.js.map +1 -1
  466. package/resources/run-control.d.ts +3 -3
  467. package/resources/run-control.d.ts.map +1 -1
  468. package/resources/run-control.js +4 -5
  469. package/resources/run-control.js.map +1 -1
  470. package/resources/run-format.d.ts +2 -2
  471. package/resources/run-format.d.ts.map +1 -1
  472. package/resources/run-format.js +3 -4
  473. package/resources/run-format.js.map +1 -1
  474. package/resources/run-logs.d.ts +2 -0
  475. package/resources/run-logs.d.ts.map +1 -1
  476. package/resources/run-logs.js +16 -6
  477. package/resources/run-logs.js.map +1 -1
  478. package/resources/run-scores.d.ts +6 -2
  479. package/resources/run-scores.d.ts.map +1 -1
  480. package/resources/run-scores.js +7 -4
  481. package/resources/run-scores.js.map +1 -1
  482. package/resources/run-to-eval-case.js +2 -2
  483. package/resources/run-to-eval-case.js.map +1 -1
  484. package/resources/runs.d.ts +3 -3
  485. package/resources/runs.d.ts.map +1 -1
  486. package/resources/runs.js +5 -5
  487. package/resources/runs.js.map +1 -1
  488. package/resources/search.d.ts.map +1 -1
  489. package/resources/search.js +1 -2
  490. package/resources/search.js.map +1 -1
  491. package/resources/service-account.d.ts +2 -0
  492. package/resources/service-account.d.ts.map +1 -1
  493. package/resources/service-account.js +3 -1
  494. package/resources/service-account.js.map +1 -1
  495. package/resources/session.d.ts +4 -3
  496. package/resources/session.d.ts.map +1 -1
  497. package/resources/session.js +10 -7
  498. package/resources/session.js.map +1 -1
  499. package/resources/skill.d.ts +1 -1
  500. package/resources/skill.d.ts.map +1 -1
  501. package/resources/skill.js +7 -8
  502. package/resources/skill.js.map +1 -1
  503. package/resources/stream/answer.d.ts +1 -2
  504. package/resources/stream/answer.d.ts.map +1 -1
  505. package/resources/stream/answer.js +3 -16
  506. package/resources/stream/answer.js.map +1 -1
  507. package/resources/stream/composer.d.ts +16 -0
  508. package/resources/stream/composer.d.ts.map +1 -0
  509. package/resources/stream/composer.js +171 -0
  510. package/resources/stream/composer.js.map +1 -0
  511. package/resources/stream/ink.d.ts +20 -4
  512. package/resources/stream/ink.d.ts.map +1 -1
  513. package/resources/stream/ink.js +34 -3
  514. package/resources/stream/ink.js.map +1 -1
  515. package/resources/stream/render-plaintext.d.ts +1 -0
  516. package/resources/stream/render-plaintext.d.ts.map +1 -1
  517. package/resources/stream/render-plaintext.js +21 -4
  518. package/resources/stream/render-plaintext.js.map +1 -1
  519. package/resources/stream/tty.js +1 -1
  520. package/resources/stream/tty.js.map +1 -1
  521. package/resources/tag.d.ts.map +1 -1
  522. package/resources/tag.js +7 -8
  523. package/resources/tag.js.map +1 -1
  524. package/resources/usage.d.ts +3 -2
  525. package/resources/usage.d.ts.map +1 -1
  526. package/resources/usage.js +19 -16
  527. package/resources/usage.js.map +1 -1
  528. package/resources/validate.d.ts.map +1 -1
  529. package/resources/validate.js +1 -12
  530. package/resources/validate.js.map +1 -1
  531. package/resources/version.d.ts +17 -3
  532. package/resources/version.d.ts.map +1 -1
  533. package/resources/version.js +105 -14
  534. package/resources/version.js.map +1 -1
  535. package/resources/views/agent.d.ts +3 -0
  536. package/resources/views/agent.d.ts.map +1 -0
  537. package/resources/views/agent.js +54 -0
  538. package/resources/views/agent.js.map +1 -0
  539. package/resources/views/environment.d.ts +3 -0
  540. package/resources/views/environment.d.ts.map +1 -0
  541. package/resources/views/environment.js +37 -0
  542. package/resources/views/environment.js.map +1 -0
  543. package/resources/views/index.d.ts +22 -0
  544. package/resources/views/index.d.ts.map +1 -0
  545. package/resources/views/index.js +70 -0
  546. package/resources/views/index.js.map +1 -0
  547. package/resources/views/organization.d.ts +3 -0
  548. package/resources/views/organization.d.ts.map +1 -0
  549. package/resources/views/organization.js +27 -0
  550. package/resources/views/organization.js.map +1 -0
  551. package/resources/views/routine.d.ts +3 -0
  552. package/resources/views/routine.d.ts.map +1 -0
  553. package/resources/views/routine.js +37 -0
  554. package/resources/views/routine.js.map +1 -0
  555. package/resources/views/run.d.ts +3 -0
  556. package/resources/views/run.d.ts.map +1 -0
  557. package/resources/views/run.js +45 -0
  558. package/resources/views/run.js.map +1 -0
  559. package/resources/views/session.d.ts +5 -0
  560. package/resources/views/session.d.ts.map +1 -0
  561. package/resources/views/session.js +85 -0
  562. package/resources/views/session.js.map +1 -0
  563. package/resources/views/skill.d.ts +5 -0
  564. package/resources/views/skill.d.ts.map +1 -0
  565. package/resources/views/skill.js +48 -0
  566. package/resources/views/skill.js.map +1 -0
  567. package/resources/views/view.d.ts +66 -0
  568. package/resources/views/view.d.ts.map +1 -0
  569. package/resources/views/view.js +130 -0
  570. package/resources/views/view.js.map +1 -0
  571. package/resources/views/words.d.ts +52 -0
  572. package/resources/views/words.d.ts.map +1 -0
  573. package/resources/views/words.js +190 -0
  574. package/resources/views/words.js.map +1 -0
  575. package/runtime.d.ts +22 -0
  576. package/runtime.d.ts.map +1 -1
  577. package/runtime.js +33 -2
  578. package/runtime.js.map +1 -1
  579. package/src/auth/auth0.ts +1 -1
  580. package/src/auth/token.ts +136 -26
  581. package/src/client/client.ts +23 -16
  582. package/src/command-tree.ts +152 -0
  583. package/src/commands/access-history/index.ts +15 -2
  584. package/src/commands/agent-exec-flags.ts +11 -5
  585. package/src/commands/apikey/duration.ts +1 -2
  586. package/src/commands/apikey/index.ts +3 -4
  587. package/src/commands/apply.ts +3 -22
  588. package/src/commands/auth/index.ts +7 -5
  589. package/src/commands/auth/whoami.ts +1 -1
  590. package/src/commands/config/index.ts +3 -3
  591. package/src/commands/config/kv.ts +18 -14
  592. package/src/commands/connect.ts +21 -3
  593. package/src/commands/download.ts +106 -62
  594. package/src/commands/eval.ts +22 -21
  595. package/src/commands/file.ts +80 -0
  596. package/src/commands/get.ts +19 -13
  597. package/src/commands/help.ts +182 -0
  598. package/src/commands/internal-daemon.ts +9 -2
  599. package/src/commands/list.ts +22 -1
  600. package/src/commands/logs.ts +1 -1
  601. package/src/commands/mcp-server.ts +57 -28
  602. package/src/commands/provider-key/index.ts +192 -0
  603. package/src/commands/push.ts +8 -8
  604. package/src/commands/resume.ts +20 -12
  605. package/src/commands/routine.ts +58 -5
  606. package/src/commands/run.ts +37 -17
  607. package/src/commands/runs/approve.ts +13 -4
  608. package/src/commands/runs/control.ts +50 -27
  609. package/src/commands/runs/index.ts +1 -2
  610. package/src/commands/runs/logs.ts +9 -5
  611. package/src/commands/runs/to-eval-case.ts +18 -6
  612. package/src/commands/runs/trace.ts +1 -1
  613. package/src/commands/search.ts +2 -3
  614. package/src/commands/service-account/index.ts +7 -2
  615. package/src/commands/session-help.ts +39 -0
  616. package/src/commands/setup.ts +5 -5
  617. package/src/commands/shared.ts +32 -3
  618. package/src/commands/tag.ts +13 -7
  619. package/src/commands/up.ts +55 -21
  620. package/src/commands/validate.ts +2 -2
  621. package/src/commands/version.ts +9 -4
  622. package/src/config/config.ts +66 -69
  623. package/src/config/index.ts +1 -2
  624. package/src/config/keys.ts +4 -4
  625. package/src/config/paths.ts +2 -2
  626. package/src/config/resolve.ts +20 -8
  627. package/src/errors/classify.ts +110 -21
  628. package/src/errors/command-line.ts +95 -0
  629. package/src/errors/handle.ts +2 -2
  630. package/src/errors/index.ts +12 -2
  631. package/src/errors/usage-error.ts +1 -1
  632. package/src/global-options.ts +100 -0
  633. package/src/local/artifact.ts +46 -140
  634. package/src/local/constants.ts +3 -9
  635. package/src/local/daemon/components.ts +78 -22
  636. package/src/local/daemon/env.ts +3 -8
  637. package/src/local/daemon/host.ts +64 -19
  638. package/src/local/daemon/index.ts +2 -1
  639. package/src/local/daemon/launch.ts +251 -72
  640. package/src/local/daemon/process.ts +78 -46
  641. package/src/local/daemon/signals.ts +19 -0
  642. package/src/local/daemon/supervisor.ts +84 -21
  643. package/src/local/daemon/types.ts +8 -4
  644. package/src/local/llm-config.ts +15 -9
  645. package/src/local/logs/view.ts +5 -6
  646. package/src/local/net/tcp.ts +18 -11
  647. package/src/local/paths.ts +2 -3
  648. package/src/local/provider-reach.ts +124 -0
  649. package/src/local/reset.ts +1 -2
  650. package/src/local/runtime/index.ts +1 -2
  651. package/src/local/runtime/node.ts +1 -1
  652. package/src/local/runtime/runner.ts +2 -2
  653. package/src/local/runtime/runtimes-install.ts +1 -1
  654. package/src/local/runtime/server.ts +2 -4
  655. package/src/local/runtime/which.ts +1 -1
  656. package/src/local/setup/wizard.ts +7 -5
  657. package/src/local/state/health-state.ts +10 -2
  658. package/src/local/state/lock.ts +26 -28
  659. package/src/local/state/log-rotation.ts +2 -3
  660. package/src/local/state/pidfile.ts +61 -6
  661. package/src/local/state/proc.ts +104 -1
  662. package/src/local/state/startup-config.ts +2 -2
  663. package/src/local/status.ts +30 -41
  664. package/src/local/temporal/download.ts +31 -9
  665. package/src/local/temporal/index.ts +1 -1
  666. package/src/local/temporal/manager.ts +94 -34
  667. package/src/local/temporal/supervisor.ts +1 -1
  668. package/src/local/webconsole/index.ts +8 -5
  669. package/src/marketplace/github.ts +1 -1
  670. package/src/marketplace/official.ts +1 -1
  671. package/src/output/command-result.ts +14 -2
  672. package/src/output/confirm.ts +2 -3
  673. package/src/output/format.ts +5 -6
  674. package/src/output/index.ts +8 -1
  675. package/src/output/printable.ts +26 -0
  676. package/src/output/proto.ts +3 -4
  677. package/src/output/style.ts +2 -2
  678. package/src/output/table.ts +118 -15
  679. package/src/program.ts +58 -128
  680. package/src/registry/aliases.ts +0 -3
  681. package/src/registry/index.ts +0 -1
  682. package/src/registry/metadata.ts +16 -64
  683. package/src/registry/registry.ts +3 -13
  684. package/src/registry/verb-support.ts +28 -5
  685. package/src/resources/agent/quality.ts +29 -8
  686. package/src/resources/agent/resolve.ts +3 -3
  687. package/src/resources/apply/apply.ts +58 -49
  688. package/src/resources/apply/handlers.ts +3 -4
  689. package/src/resources/channel.ts +3 -4
  690. package/src/resources/connect/connect.ts +2 -2
  691. package/src/resources/delete.ts +44 -4
  692. package/src/resources/documents.ts +1 -1
  693. package/src/resources/download.ts +239 -43
  694. package/src/resources/eval-run/options.ts +38 -17
  695. package/src/resources/eval-run/report.ts +11 -5
  696. package/src/resources/eval-run/run.ts +13 -9
  697. package/src/resources/file.ts +114 -0
  698. package/src/resources/get-bindings.ts +18 -0
  699. package/src/resources/git.ts +1 -1
  700. package/src/resources/list.ts +178 -34
  701. package/src/resources/plugin.ts +3 -0
  702. package/src/resources/provider-key.ts +327 -0
  703. package/src/resources/reference.ts +41 -85
  704. package/src/resources/render.ts +72 -38
  705. package/src/resources/routine.ts +152 -15
  706. package/src/resources/run/agent-exec.ts +95 -44
  707. package/src/resources/run/create.ts +27 -24
  708. package/src/resources/run/engines.ts +57 -0
  709. package/src/resources/run/environment.ts +43 -0
  710. package/src/resources/run/epilogue.ts +18 -17
  711. package/src/resources/run/files.ts +433 -0
  712. package/src/resources/run/header.ts +18 -18
  713. package/src/resources/run/prepare.ts +67 -74
  714. package/src/resources/run/references.ts +6 -5
  715. package/src/resources/run/resolve.ts +1 -1
  716. package/src/resources/run/resume.ts +28 -9
  717. package/src/resources/run/stream.ts +110 -9
  718. package/src/resources/run/workspace.ts +37 -47
  719. package/src/resources/run-approve.ts +2 -14
  720. package/src/resources/run-control.ts +4 -5
  721. package/src/resources/run-format.ts +3 -4
  722. package/src/resources/run-logs.ts +17 -6
  723. package/src/resources/run-scores.ts +14 -4
  724. package/src/resources/run-to-eval-case.ts +2 -2
  725. package/src/resources/runs.ts +5 -5
  726. package/src/resources/search.ts +1 -2
  727. package/src/resources/service-account.ts +4 -1
  728. package/src/resources/session.ts +10 -7
  729. package/src/resources/skill.ts +7 -8
  730. package/src/resources/stream/answer.ts +3 -19
  731. package/src/resources/stream/composer.ts +170 -0
  732. package/src/resources/stream/ink.tsx +74 -10
  733. package/src/resources/stream/render-plaintext.ts +22 -4
  734. package/src/resources/stream/tty.ts +1 -1
  735. package/src/resources/tag.ts +7 -9
  736. package/src/resources/usage.ts +19 -15
  737. package/src/resources/validate.ts +1 -10
  738. package/src/resources/version.ts +117 -15
  739. package/src/resources/views/agent.ts +60 -0
  740. package/src/resources/views/environment.ts +41 -0
  741. package/src/resources/views/index.ts +82 -0
  742. package/src/resources/views/organization.ts +29 -0
  743. package/src/resources/views/routine.ts +39 -0
  744. package/src/resources/views/run.ts +46 -0
  745. package/src/resources/views/session.ts +91 -0
  746. package/src/resources/views/skill.ts +49 -0
  747. package/src/resources/views/view.ts +188 -0
  748. package/src/resources/views/words.ts +191 -0
  749. package/src/runtime.ts +51 -2
  750. package/errors/exit-codes.d.ts +0 -10
  751. package/errors/exit-codes.d.ts.map +0 -1
  752. package/errors/exit-codes.js +0 -15
  753. package/errors/exit-codes.js.map +0 -1
  754. package/resources/run/attachments.d.ts +0 -24
  755. package/resources/run/attachments.d.ts.map +0 -1
  756. package/resources/run/attachments.js +0 -237
  757. package/resources/run/attachments.js.map +0 -1
  758. package/src/errors/exit-codes.ts +0 -17
  759. package/src/resources/run/attachments.ts +0 -300
  760. package/src/types/marked-terminal.d.ts +0 -31
@@ -0,0 +1,433 @@
1
+ // What `--attach` and `--file-id` give a run: each path is a file the
2
+ // message carries, a folder the conversation holds, or a mention of a file
3
+ // already in a local workspace; each id names a File already uploaded
4
+ // (`stigmer file upload`, the console's Library), which the message carries
5
+ // without sending its bytes again.
6
+ //
7
+ // A file outside every local workspace is uploaded as a File and named in the
8
+ // run's file_ids: the model sees it with the message (an image as an image,
9
+ // anything else as a document) and the agent finds it under .stigmer/uploads/.
10
+ // A folder is uploaded file by file and joins the conversation's resources,
11
+ // each File's mount_path keeping its place under the folder's name, so the
12
+ // tree arrives as it was without a message block per file. A path inside a
13
+ // local workspace root is a workspace_file_refs mention: the agent reads it
14
+ // where it is, and nothing is uploaded.
15
+ //
16
+ // Trade-offs:
17
+ // - Planning and uploading are two steps. planFiles only reads the
18
+ // disk, so a missing path, an empty folder or a count over the limits fails
19
+ // before any byte moves; stageFiles uploads once the run's target is
20
+ // known. A File named by id counts toward the message's limit with the
21
+ // files the message uploads, and is never deleted here: it is the
22
+ // person's, and the server gives the conversation its own copy.
23
+ // - Into an existing conversation a File is uploaded with its session id and
24
+ // is the conversation's at once. A new conversation does not exist until
25
+ // its first run does, so each File is uploaded as the person's own and the
26
+ // server copies it into the conversation when the run names it. The
27
+ // originals are then deleted (deleteFiles), the conversation's copies
28
+ // keeping the bytes; they are deleted as well when the run is never
29
+ // created, since nothing names them.
30
+ // - Files stream from disk (uploadFileFromPath), so a large file is never
31
+ // read into memory, and a few upload at a time. When one fails, the Files
32
+ // already uploaded are deleted before the error surfaces.
33
+ // - Inside a folder, hidden entries (and their subtrees) and symbolic links
34
+ // are skipped: a folder's dotfiles are usually tool state or credentials,
35
+ // and a link can reach outside the folder.
36
+ // - Two folders with one name (`--attach a/data --attach b/data`), or a
37
+ // folder named like one the conversation already holds, would claim the
38
+ // same mount paths, so the later one is renamed data-2 and the rename is
39
+ // reported.
40
+
41
+ import { readdirSync, realpathSync, type Stats, statSync } from "node:fs";
42
+ import { basename, join, relative, resolve, sep } from "node:path";
43
+ import { create } from "@bufbuild/protobuf";
44
+ import type { Session } from "@stigmer/apis/ai/stigmer/agentic/session/v1/api_pb";
45
+ import {
46
+ FileResourceSchema,
47
+ type SessionResource,
48
+ SessionResourceSchema,
49
+ } from "@stigmer/apis/ai/stigmer/agentic/session/v1/resource_pb";
50
+ import type { Stigmer } from "@stigmer/client";
51
+ import { uploadFileFromPath } from "@stigmer/client/node";
52
+ import { UsageError } from "../../errors/index.js";
53
+
54
+ /** A sink for human progress and warning lines. */
55
+ export type ProgressSink = (line: string) => void;
56
+
57
+ /** The most Files one message carries (RunSpec.file_ids). */
58
+ export const MAX_MESSAGE_FILES = 20;
59
+
60
+ /** The most Files a conversation holds (SessionSpec.resources). */
61
+ export const MAX_CONVERSATION_FILES = 500;
62
+
63
+ const UPLOAD_CONCURRENCY = 4;
64
+
65
+ /** A file on disk to upload. */
66
+ export interface LocalFile {
67
+ /** Absolute path. */
68
+ readonly path: string;
69
+ readonly size: number;
70
+ }
71
+
72
+ /** A file inside an attached folder, by its slash-separated path under the folder. */
73
+ export interface FolderFile extends LocalFile {
74
+ readonly relativePath: string;
75
+ }
76
+
77
+ /** An attached folder and every file it gives. */
78
+ export interface AttachedFolder {
79
+ /** The folder's own name: the first segment of each of its Files' mount paths. */
80
+ readonly name: string;
81
+ readonly files: readonly FolderFile[];
82
+ }
83
+
84
+ /** What `--attach` and `--file-id` resolved to, before anything is uploaded. */
85
+ export interface FilePlan {
86
+ /** Files the message carries, in the order given. */
87
+ readonly messageFiles: readonly LocalFile[];
88
+ /** Files already uploaded that the message names, by id, in the order given. */
89
+ readonly fileIds: readonly string[];
90
+ /** Folders the conversation holds, in the order given. */
91
+ readonly folders: readonly AttachedFolder[];
92
+ /** Workspace-relative paths of files already in a local workspace. */
93
+ readonly workspaceFileRefs: readonly string[];
94
+ }
95
+
96
+ /** A plan that attaches nothing. */
97
+ export const NO_FILES: FilePlan = { messageFiles: [], fileIds: [], folders: [], workspaceFileRefs: [] };
98
+
99
+ /**
100
+ * Resolve `--attach` paths against the local workspace roots without
101
+ * uploading anything. The first root a path falls inside makes it a
102
+ * workspace-relative mention; any other file is carried by the message; a
103
+ * folder is walked for the files it gives. `fileIds` are the `--file-id`
104
+ * Files the message also carries.
105
+ */
106
+ export function planFiles(
107
+ paths: readonly string[],
108
+ workspaceRoots: readonly string[],
109
+ progress?: ProgressSink,
110
+ fileIds: readonly string[] = [],
111
+ ): FilePlan {
112
+ for (const id of fileIds) {
113
+ if (!/^file_[^\s/]+$/.test(id)) {
114
+ throw new UsageError(`--file-id takes a File's id (file_…), not "${id}"; to send a file on disk, use --attach`);
115
+ }
116
+ }
117
+ const messageFiles: LocalFile[] = [];
118
+ const folders: AttachedFolder[] = [];
119
+ const workspaceFileRefs: string[] = [];
120
+ const budget = { remaining: MAX_CONVERSATION_FILES };
121
+
122
+ for (const path of paths) {
123
+ const rel = matchWorkspaceRoot(path, workspaceRoots);
124
+ if (rel !== null) {
125
+ progress?.(`Referencing workspace file: ${rel}`);
126
+ workspaceFileRefs.push(rel);
127
+ continue;
128
+ }
129
+ const abs = resolve(path);
130
+ const stat = statPath(path);
131
+ if (stat.isDirectory()) {
132
+ folders.push(readFolder(abs, budget, progress));
133
+ } else if (stat.isFile()) {
134
+ messageFiles.push({ path: abs, size: stat.size });
135
+ } else {
136
+ throw new UsageError(`cannot attach "${path}": not a file or a folder`);
137
+ }
138
+ }
139
+
140
+ if (messageFiles.length > MAX_MESSAGE_FILES) {
141
+ throw new UsageError(
142
+ `--attach names ${messageFiles.length} files; a message carries at most ${MAX_MESSAGE_FILES} (attach a folder to give more)`,
143
+ );
144
+ }
145
+ if (messageFiles.length + fileIds.length > MAX_MESSAGE_FILES) {
146
+ throw new UsageError(
147
+ `--attach and --file-id name ${messageFiles.length + fileIds.length} files; a message carries at most ${MAX_MESSAGE_FILES}`,
148
+ );
149
+ }
150
+ const total = messageFiles.length + folders.reduce((n, folder) => n + folder.files.length, 0);
151
+ if (total > MAX_CONVERSATION_FILES) {
152
+ throw new UsageError(`--attach gives ${total} files; a conversation holds at most ${MAX_CONVERSATION_FILES}`);
153
+ }
154
+ return { messageFiles, fileIds: [...fileIds], folders, workspaceFileRefs };
155
+ }
156
+
157
+ /** Where the attached Files go: the run's organization, and its conversation when it exists. */
158
+ export interface StageTarget {
159
+ readonly org: string;
160
+ /** The existing conversation the run continues; omitted for a new one. */
161
+ readonly sessionId?: string;
162
+ }
163
+
164
+ /** The uploaded Files, ready for the run that names them. */
165
+ export interface StagedFiles {
166
+ /** The Files the message carries, uploaded then named, for RunSpec.file_ids. */
167
+ readonly fileIds: readonly string[];
168
+ /**
169
+ * The folders' Files as resources for a new conversation's session_spec.
170
+ * Empty for an existing conversation, whose resources already hold them.
171
+ */
172
+ readonly resources: readonly SessionResource[];
173
+ /** The person's own Files uploaded for a new conversation: delete them once the run exists. */
174
+ readonly originals: readonly string[];
175
+ }
176
+
177
+ /** A file on disk to upload, and the name its File takes. */
178
+ export interface UploadJob {
179
+ readonly path: string;
180
+ readonly filename: string;
181
+ }
182
+
183
+ /**
184
+ * Upload what the plan attaches. Into an existing conversation, the Files are
185
+ * the conversation's and the folders' Files join its resources through a
186
+ * masked update that keeps every resource it holds. For a new one, the Files
187
+ * are the person's own, returned as originals for the caller to delete once
188
+ * the run exists.
189
+ */
190
+ export async function stageFiles(
191
+ client: Stigmer,
192
+ plan: FilePlan,
193
+ target: StageTarget,
194
+ progress?: ProgressSink,
195
+ ): Promise<StagedFiles> {
196
+ if (plan.messageFiles.length === 0 && plan.folders.length === 0) {
197
+ return { fileIds: plan.fileIds, resources: [], originals: [] };
198
+ }
199
+ const sessionId = target.sessionId ?? "";
200
+ const session = sessionId === "" ? undefined : await client.session.get(sessionId);
201
+
202
+ const taken = new Set(session === undefined ? [] : heldTopLevelNames(session));
203
+ const jobs: UploadJob[] = plan.messageFiles.map((file) => ({ path: file.path, filename: basename(file.path) }));
204
+ for (const file of plan.messageFiles) {
205
+ progress?.(`Uploading ${basename(file.path)} (${formatFileSize(file.size)})...`);
206
+ }
207
+ const mountPaths: string[] = [];
208
+ for (const folder of plan.folders) {
209
+ const name = uniquifyName(folder.name, taken);
210
+ taken.add(name);
211
+ if (name !== folder.name) {
212
+ progress?.(
213
+ `Attaching second '${folder.name}/' as '${name}/' (a folder named '${folder.name}' is already attached)`,
214
+ );
215
+ }
216
+ const size = folder.files.reduce((n, file) => n + file.size, 0);
217
+ progress?.(`Uploading folder ${name}/ (${folder.files.length} files, ${formatFileSize(size)})...`);
218
+ for (const file of folder.files) {
219
+ jobs.push({ path: file.path, filename: basename(file.path) });
220
+ mountPaths.push(`${name}/${file.relativePath}`);
221
+ }
222
+ }
223
+
224
+ const ids = await uploadAll(client, jobs, { org: target.org, sessionId }, progress);
225
+ const fileIds = [...ids.slice(0, plan.messageFiles.length), ...plan.fileIds];
226
+ const resources = ids.slice(plan.messageFiles.length).map((fileId, i) =>
227
+ create(SessionResourceSchema, {
228
+ resource: { case: "file", value: create(FileResourceSchema, { fileId, mountPath: mountPaths[i] }) },
229
+ }),
230
+ );
231
+
232
+ if (session === undefined) return { fileIds, resources, originals: ids };
233
+ if (resources.length > 0) {
234
+ await giveFilesToSession(client, session, resources, ids, "the attached folders", progress);
235
+ }
236
+ return { fileIds, resources: [], originals: [] };
237
+ }
238
+
239
+ /**
240
+ * Give Files already uploaded into a conversation to that conversation: a
241
+ * masked update that appends them to its resources and keeps every
242
+ * resource it holds, under the etag `session` was read at. A File the
243
+ * resources do not name is never mounted for the agent, so uploading into
244
+ * a conversation is not enough by itself. On a refused update the Files
245
+ * are deleted, so none is left as the conversation's without being given
246
+ * to it.
247
+ */
248
+ export async function giveFilesToSession(
249
+ client: Stigmer,
250
+ session: Session,
251
+ resources: readonly SessionResource[],
252
+ uploaded: readonly string[],
253
+ what: string,
254
+ progress?: ProgressSink,
255
+ ): Promise<void> {
256
+ try {
257
+ await client.session.update(
258
+ {
259
+ metadata: { id: session.metadata?.id ?? "", etag: session.metadata?.etag ?? "" },
260
+ spec: { resources: [...(session.spec?.resources ?? []), ...resources] },
261
+ },
262
+ ["spec.resources"],
263
+ );
264
+ } catch (err) {
265
+ await deleteFiles(client, uploaded, progress);
266
+ throw new UsageError(`failed to add ${what} to the conversation: ${errorMessage(err)}`);
267
+ }
268
+ }
269
+
270
+ /**
271
+ * Delete Files the run no longer needs, reporting each one that could not be
272
+ * deleted rather than failing: the run already holds what it needs.
273
+ */
274
+ export async function deleteFiles(
275
+ client: Stigmer,
276
+ ids: readonly string[],
277
+ warn?: ProgressSink,
278
+ ): Promise<void> {
279
+ await Promise.all(
280
+ ids.map(async (id) => {
281
+ try {
282
+ await client.file.delete(id);
283
+ } catch (err) {
284
+ warn?.(`Could not delete the uploaded File ${id}: ${errorMessage(err)}`);
285
+ }
286
+ }),
287
+ );
288
+ }
289
+
290
+ /**
291
+ * Upload every job a few at a time, keeping the jobs' order in the ids. On
292
+ * the first failure no new upload starts; once the ones in flight settle,
293
+ * every File uploaded is deleted and the failure surfaces, so a failed
294
+ * batch leaves nothing behind. An empty `sessionId` uploads the person's
295
+ * own Files.
296
+ */
297
+ export async function uploadAll(
298
+ client: Stigmer,
299
+ jobs: readonly UploadJob[],
300
+ target: { readonly org: string; readonly sessionId: string },
301
+ progress?: ProgressSink,
302
+ ): Promise<string[]> {
303
+ const ids = jobs.map(() => "");
304
+ let next = 0;
305
+ let failure: UsageError | undefined;
306
+ const worker = async (): Promise<void> => {
307
+ while (failure === undefined && next < jobs.length) {
308
+ const index = next++;
309
+ const job = jobs[index];
310
+ try {
311
+ const file = await uploadFileFromPath(client.file, { ...target, path: job.path, filename: job.filename });
312
+ ids[index] = file.metadata?.id ?? "";
313
+ } catch (err) {
314
+ failure ??= new UsageError(`failed to upload "${job.path}": ${errorMessage(err)}`);
315
+ }
316
+ }
317
+ };
318
+ await Promise.all(Array.from({ length: Math.min(UPLOAD_CONCURRENCY, jobs.length) }, worker));
319
+ if (failure !== undefined) {
320
+ await deleteFiles(
321
+ client,
322
+ ids.filter((id) => id !== ""),
323
+ progress,
324
+ );
325
+ throw failure;
326
+ }
327
+ return ids;
328
+ }
329
+
330
+ // The first path segment of every File the conversation holds: the names a
331
+ // newly attached folder must not take.
332
+ function heldTopLevelNames(session: Session): string[] {
333
+ const names: string[] = [];
334
+ for (const resource of session.spec?.resources ?? []) {
335
+ if (resource.resource.case !== "file") continue;
336
+ const mountPath = resource.resource.value.mountPath;
337
+ if (mountPath !== "") names.push(mountPath.split("/")[0]);
338
+ }
339
+ return names;
340
+ }
341
+
342
+ // Returns the workspace-relative path if `path` is inside any root (first
343
+ // match wins), else null. Both sides are resolved through realpath so a
344
+ // symbolic link cannot pass a file outside the root off as inside it.
345
+ function matchWorkspaceRoot(path: string, roots: readonly string[]): string | null {
346
+ for (const root of roots) {
347
+ let evalFile: string;
348
+ let evalRoot: string;
349
+ try {
350
+ evalFile = realpathSync(resolve(path));
351
+ evalRoot = realpathSync(root);
352
+ } catch {
353
+ continue; // an unresolvable path is outside this root
354
+ }
355
+ if (evalFile === evalRoot || evalFile.startsWith(evalRoot + sep)) {
356
+ return relative(evalRoot, evalFile).split(sep).join("/");
357
+ }
358
+ }
359
+ return null;
360
+ }
361
+
362
+ function statPath(path: string): Stats {
363
+ try {
364
+ return statSync(path);
365
+ } catch (err) {
366
+ const e = err as NodeJS.ErrnoException;
367
+ if (e.code === "ENOENT") throw new UsageError(`file not found: ${path}`);
368
+ throw new UsageError(`cannot read "${path}": ${e.message}`);
369
+ }
370
+ }
371
+
372
+ // Every regular file under the folder, hidden entries and symbolic links
373
+ // skipped. Stops as soon as the files found exceed the conversation's limit,
374
+ // so attaching a large tree by mistake fails fast instead of walking it all.
375
+ function readFolder(
376
+ abs: string,
377
+ budget: { remaining: number },
378
+ progress?: ProgressSink,
379
+ ): AttachedFolder {
380
+ const files: FolderFile[] = [];
381
+ const walk = (current: string, prefix: string): void => {
382
+ for (const entry of readdirSync(current, { withFileTypes: true })) {
383
+ if (entry.name.startsWith(".")) continue;
384
+ const rel = prefix === "" ? entry.name : `${prefix}/${entry.name}`;
385
+ const full = join(current, entry.name);
386
+ if (entry.isSymbolicLink()) {
387
+ progress?.(`Skipping symlink: ${full}`);
388
+ } else if (entry.isDirectory()) {
389
+ walk(full, rel);
390
+ } else if (entry.isFile()) {
391
+ budget.remaining -= 1;
392
+ if (budget.remaining < 0) {
393
+ throw new UsageError(
394
+ `--attach gives more than ${MAX_CONVERSATION_FILES} files; a conversation holds at most ${MAX_CONVERSATION_FILES}`,
395
+ );
396
+ }
397
+ files.push({ path: full, size: statSync(full).size, relativePath: rel });
398
+ }
399
+ }
400
+ };
401
+ walk(abs, "");
402
+ if (files.length === 0) {
403
+ throw new UsageError(`folder "${abs}" has no files to send`);
404
+ }
405
+ const name = basename(abs);
406
+ return { name: name === "" ? "folder" : name, files };
407
+ }
408
+
409
+ // Returns `name` unchanged when free, otherwise the first free `name-2`,
410
+ // `name-3`, ... variant. Extension-blind: a folder name has no extension
411
+ // ("reports.2024" becomes "reports.2024-2").
412
+ function uniquifyName(name: string, taken: ReadonlySet<string>): string {
413
+ if (!taken.has(name)) return name;
414
+ for (let n = 2; ; n++) {
415
+ const candidate = `${name}-${n}`;
416
+ if (!taken.has(candidate)) return candidate;
417
+ }
418
+ }
419
+
420
+ // Human-readable byte size: 1024-based, one decimal.
421
+ function formatFileSize(bytes: number): string {
422
+ const KB = 1024;
423
+ const MB = KB * 1024;
424
+ const GB = MB * 1024;
425
+ if (bytes >= GB) return `${(bytes / GB).toFixed(1)} GB`;
426
+ if (bytes >= MB) return `${(bytes / MB).toFixed(1)} MB`;
427
+ if (bytes >= KB) return `${(bytes / KB).toFixed(1)} KB`;
428
+ return `${bytes} B`;
429
+ }
430
+
431
+ function errorMessage(err: unknown): string {
432
+ return err instanceof Error ? err.message : String(err);
433
+ }
@@ -1,16 +1,14 @@
1
- // The session header shown before a headless stream starts (Go's
2
- // renderSessionHeader / sessionHeaderInfo in run_display_header.go).
1
+ // The session header shown before a headless stream starts.
3
2
  //
4
- // Deliberate divergence (clean over chrome): Go renders a lipgloss bordered
5
- // panel with a side-by-side "recent sessions" column. That panel is TTY
6
- // eye-candy; the interactive path here is owned by Ink's SessionView, which
3
+ // Clean over chrome: the interactive path is owned by Ink's SessionView, which
7
4
  // draws its own header. The only consumers of THIS header are the headless
8
5
  // (--json / non-TTY plaintext) paths, where the output target is stderr — a
9
6
  // bordered panel there would be noise. So we emit a compact, aligned key/value
10
- // block carrying the same fields (Agent, Session, Model, Mode, Workspaces).
7
+ // block of the fields (Agent, Session, Model, Mode, Workspaces).
11
8
 
12
- import type { WorkspaceEntry } from "@stigmer/apis/ai/stigmer/agentic/session/v1/workspace_pb";
9
+ import type { SessionResource } from "@stigmer/apis/ai/stigmer/agentic/session/v1/resource_pb";
13
10
  import { shouldColorize, styler } from "../../output/style.js";
11
+ import { ENGINES } from "./engines.js";
14
12
  import type { HarnessFlag, RunMode } from "./prepare.js";
15
13
 
16
14
  export interface SessionHeaderInfo {
@@ -21,10 +19,10 @@ export interface SessionHeaderInfo {
21
19
  readonly model: string;
22
20
  readonly mode: RunMode;
23
21
  /**
24
- * Resolved harness for the session. Surfaced only when it is "cursor":
25
- * a harness switch changes the toolset, conversation-state model, and
26
- * billing tier, and it may come from the account preference rather than
27
- * a flag — a cursor session must never start silently (the CLI
22
+ * Resolved harness for the session. Surfaced for every engine but Stigmer,
23
+ * the default: an engine changes the toolset, conversation-state model,
24
+ * and billing, and it may come from the account preference rather than a
25
+ * flag — a Claude session must never start silently (the CLI
28
26
  * counterpart of the web composer's harness selector).
29
27
  */
30
28
  readonly harness?: HarnessFlag;
@@ -35,8 +33,7 @@ export interface SessionHeaderInfo {
35
33
  const LABEL_WIDTH = 12;
36
34
 
37
35
  /**
38
- * Write the session header to `out` (stderr). Empty fields are omitted, exactly
39
- * like Go's formatMetadataSection. A header with no populated fields prints
36
+ * Write the session header to `out` (stderr). Empty fields are omitted. A header with no populated fields prints
40
37
  * nothing.
41
38
  */
42
39
  export function renderSessionHeader(out: { write(chunk: string): unknown; isTTY?: boolean }, info: SessionHeaderInfo): void {
@@ -47,8 +44,8 @@ export function renderSessionHeader(out: { write(chunk: string): unknown; isTTY?
47
44
  if (info.sessionId !== "") lines.push(row(s, "Session", info.sessionId));
48
45
  if ((info.subject ?? "") !== "") lines.push(row(s, "Subject", info.subject ?? ""));
49
46
  if (info.model !== "") lines.push(row(s, "Model", info.model));
50
- // Only "cursor" is surfaced; native/"" is the default and stays implicit.
51
- if (info.harness === "cursor") lines.push(row(s, "Harness", "Cursor"));
47
+ // Every engine but Stigmer is surfaced; stigmer/"" is the default and stays implicit.
48
+ if (info.harness !== undefined && info.harness !== "" && info.harness !== "stigmer") lines.push(row(s, "Harness", ENGINES[info.harness].label));
52
49
  // Only "plan" is surfaced; "agent"/"" is the default and stays implicit.
53
50
  if (info.mode === "plan") lines.push(row(s, "Mode", "Plan (read-only)"));
54
51
  if (info.workspaces.length > 0) {
@@ -66,7 +63,10 @@ function row(s: ReturnType<typeof styler>, label: string, value: string): string
66
63
  return `${s.dim(padded)}${value}`;
67
64
  }
68
65
 
69
- /** Displayable names from workspace entries (Go's workspaceNames). */
70
- export function workspaceNames(entries: readonly WorkspaceEntry[]): string[] {
71
- return entries.map((e) => e.name);
66
+ /**
67
+ * The names of the conversation's repositories and folders. Files carry no name: they sit under .stigmer/uploads/,
68
+ * not in the workspace this row lists.
69
+ */
70
+ export function workspaceNames(resources: readonly SessionResource[]): string[] {
71
+ return resources.filter((r) => r.resource.case !== "file").map((r) => r.name);
72
72
  }