@grok/agent-sdk 0.2.27 → 0.2.28

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 (1291) hide show
  1. package/AGENTS.md +19 -14
  2. package/CHANGELOG.md +1 -1
  3. package/README.md +15 -17
  4. package/dist/agent-v2-hosting.d.ts +13 -0
  5. package/dist/agent-v2-hosting.d.ts.map +1 -0
  6. package/dist/agent-v2-hosting.js +8 -0
  7. package/dist/artifacts.d.ts +1 -1
  8. package/dist/artifacts.js +1 -1
  9. package/dist/bin/agent-serve.d.ts +3 -15
  10. package/dist/bin/agent-serve.d.ts.map +1 -1
  11. package/dist/bin/agent-serve.js +30 -1628
  12. package/dist/channels/bitbucket/api.d.ts.map +1 -1
  13. package/dist/channels/bitbucket/api.js +3 -3
  14. package/dist/channels/bitbucket/binding.d.ts.map +1 -1
  15. package/dist/channels/bitbucket/binding.js +5 -5
  16. package/dist/channels/bitbucket/bitbucket-channel.d.ts.map +1 -1
  17. package/dist/channels/bitbucket/bitbucket-channel.js +1 -0
  18. package/dist/channels/bitbucket/bitbucket-webhook.d.ts.map +1 -1
  19. package/dist/channels/bitbucket/bitbucket-webhook.js +9 -6
  20. package/dist/channels/bitbucket/checks.d.ts.map +1 -1
  21. package/dist/channels/bitbucket/checks.js +4 -0
  22. package/dist/channels/bitbucket/events.d.ts.map +1 -1
  23. package/dist/channels/bitbucket/index.d.ts +1 -1
  24. package/dist/channels/bitbucket/index.js +1 -1
  25. package/dist/channels/bitbucket/replay.d.ts.map +1 -1
  26. package/dist/channels/bitbucket/replay.js +4 -3
  27. package/dist/channels/change-monitors/change-monitors-channel.d.ts.map +1 -1
  28. package/dist/channels/change-monitors/change-monitors-channel.js +15 -2
  29. package/dist/channels/change-monitors/claim.d.ts +5 -0
  30. package/dist/channels/change-monitors/claim.d.ts.map +1 -0
  31. package/dist/channels/change-monitors/claim.js +6 -0
  32. package/dist/channels/change-monitors/index.d.ts +1 -0
  33. package/dist/channels/change-monitors/index.d.ts.map +1 -1
  34. package/dist/channels/change-monitors/index.js +1 -0
  35. package/dist/channels/change-monitors/types.d.ts.map +1 -1
  36. package/dist/channels/deployments/deployments-channel.d.ts +1 -1
  37. package/dist/channels/deployments/deployments-channel.js +1 -1
  38. package/dist/channels/deployments/index.d.ts +1 -1
  39. package/dist/channels/deployments/index.js +1 -1
  40. package/dist/channels/deployments/types.d.ts.map +1 -1
  41. package/dist/channels/github/api.d.ts +11 -0
  42. package/dist/channels/github/api.d.ts.map +1 -1
  43. package/dist/channels/github/api.js +29 -4
  44. package/dist/channels/github/binding.d.ts +5 -3
  45. package/dist/channels/github/binding.d.ts.map +1 -1
  46. package/dist/channels/github/binding.js +16 -9
  47. package/dist/channels/github/github-channel.d.ts +7 -2
  48. package/dist/channels/github/github-channel.d.ts.map +1 -1
  49. package/dist/channels/github/github-channel.js +20 -11
  50. package/dist/channels/github/index.d.ts +1 -1
  51. package/dist/channels/github/index.js +1 -1
  52. package/dist/channels/github/progress.d.ts.map +1 -1
  53. package/dist/channels/github/progress.js +4 -0
  54. package/dist/channels/github/state.d.ts +2 -2
  55. package/dist/channels/github/state.d.ts.map +1 -1
  56. package/dist/channels/github/types.d.ts +7 -7
  57. package/dist/channels/github/types.d.ts.map +1 -1
  58. package/dist/channels/gitlab/api.d.ts +2 -2
  59. package/dist/channels/gitlab/api.d.ts.map +1 -1
  60. package/dist/channels/gitlab/api.js +25 -14
  61. package/dist/channels/gitlab/binding.d.ts.map +1 -1
  62. package/dist/channels/gitlab/binding.js +2 -3
  63. package/dist/channels/gitlab/checks.d.ts.map +1 -1
  64. package/dist/channels/gitlab/checks.js +4 -0
  65. package/dist/channels/gitlab/events.d.ts.map +1 -1
  66. package/dist/channels/gitlab/gitlab-channel.d.ts.map +1 -1
  67. package/dist/channels/gitlab/gitlab-channel.js +4 -7
  68. package/dist/channels/gitlab/gitlab-webhook.d.ts.map +1 -1
  69. package/dist/channels/gitlab/gitlab-webhook.js +11 -8
  70. package/dist/channels/gitlab/index.d.ts +1 -1
  71. package/dist/channels/gitlab/index.js +1 -1
  72. package/dist/channels/gitlab/replay.d.ts.map +1 -1
  73. package/dist/channels/gitlab/replay.js +2 -0
  74. package/dist/channels/gitlab/types.d.ts.map +1 -1
  75. package/dist/channels/issues/claim.d.ts +5 -0
  76. package/dist/channels/issues/claim.d.ts.map +1 -0
  77. package/dist/channels/issues/claim.js +6 -0
  78. package/dist/channels/issues/index.d.ts +1 -0
  79. package/dist/channels/issues/index.d.ts.map +1 -1
  80. package/dist/channels/issues/index.js +1 -0
  81. package/dist/channels/issues/issues-channel.d.ts.map +1 -1
  82. package/dist/channels/issues/issues-channel.js +16 -3
  83. package/dist/channels/issues/types.d.ts +2 -2
  84. package/dist/channels/issues/types.d.ts.map +1 -1
  85. package/dist/channels/origin/api.d.ts.map +1 -1
  86. package/dist/channels/origin/api.js +3 -3
  87. package/dist/channels/origin/index.d.ts +1 -1
  88. package/dist/channels/origin/index.js +1 -1
  89. package/dist/channels/origin/origin-channel.d.ts.map +1 -1
  90. package/dist/channels/origin/origin-channel.js +6 -6
  91. package/dist/channels/origin/origin-webhook.d.ts.map +1 -1
  92. package/dist/channels/origin/origin-webhook.js +2 -5
  93. package/dist/channels/pagerduty/api.d.ts.map +1 -1
  94. package/dist/channels/pagerduty/api.js +2 -1
  95. package/dist/channels/pagerduty/index.d.ts +1 -1
  96. package/dist/channels/pagerduty/index.js +1 -1
  97. package/dist/channels/pagerduty/pagerduty-channel.d.ts.map +1 -1
  98. package/dist/channels/pagerduty/pagerduty-channel.js +1 -0
  99. package/dist/channels/pagerduty/pagerduty-webhook.d.ts.map +1 -1
  100. package/dist/channels/pagerduty/pagerduty-webhook.js +20 -11
  101. package/dist/channels/pagerduty/payload.d.ts.map +1 -1
  102. package/dist/channels/pagerduty/payload.js +2 -3
  103. package/dist/channels/pagerduty/replay.d.ts.map +1 -1
  104. package/dist/channels/pagerduty/replay.js +4 -1
  105. package/dist/channels/pagerduty/self-user.d.ts.map +1 -1
  106. package/dist/channels/pagerduty/self-user.js +8 -9
  107. package/dist/channels/runs/runs-channel.d.ts.map +1 -1
  108. package/dist/channels/runs/runs-channel.js +8 -2
  109. package/dist/channels/runs/types.d.ts +2 -2
  110. package/dist/channels/runs/types.d.ts.map +1 -1
  111. package/dist/channels/slack/agentic-delivery.d.ts +20 -1
  112. package/dist/channels/slack/agentic-delivery.d.ts.map +1 -1
  113. package/dist/channels/slack/agentic-delivery.js +77 -12
  114. package/dist/channels/slack/agentic-signals.d.ts +2 -0
  115. package/dist/channels/slack/agentic-signals.d.ts.map +1 -1
  116. package/dist/channels/slack/agentic-signals.js +24 -7
  117. package/dist/channels/slack/api.d.ts +1 -1
  118. package/dist/channels/slack/api.d.ts.map +1 -1
  119. package/dist/channels/slack/api.js +12 -13
  120. package/dist/channels/slack/approvals.d.ts.map +1 -1
  121. package/dist/channels/slack/approvals.js +5 -4
  122. package/dist/channels/slack/attachments.d.ts.map +1 -1
  123. package/dist/channels/slack/attachments.js +34 -9
  124. package/dist/channels/slack/auth.d.ts.map +1 -1
  125. package/dist/channels/slack/auth.js +3 -1
  126. package/dist/channels/slack/bot-mentions.d.ts.map +1 -1
  127. package/dist/channels/slack/bot-mentions.js +2 -4
  128. package/dist/channels/slack/cli-project.d.ts.map +1 -1
  129. package/dist/channels/slack/cli-project.js +7 -10
  130. package/dist/channels/slack/constants.d.ts +7 -0
  131. package/dist/channels/slack/constants.d.ts.map +1 -1
  132. package/dist/channels/slack/constants.js +7 -0
  133. package/dist/channels/slack/defaults.d.ts +12 -0
  134. package/dist/channels/slack/defaults.d.ts.map +1 -1
  135. package/dist/channels/slack/defaults.js +10 -2
  136. package/dist/channels/slack/dispatch.d.ts +7 -1
  137. package/dist/channels/slack/dispatch.d.ts.map +1 -1
  138. package/dist/channels/slack/dispatch.js +88 -13
  139. package/dist/channels/slack/doctor.d.ts.map +1 -1
  140. package/dist/channels/slack/doctor.js +11 -11
  141. package/dist/channels/slack/inbound.d.ts +7 -0
  142. package/dist/channels/slack/inbound.d.ts.map +1 -1
  143. package/dist/channels/slack/inbound.js +25 -4
  144. package/dist/channels/slack/index.d.ts +2 -2
  145. package/dist/channels/slack/index.d.ts.map +1 -1
  146. package/dist/channels/slack/index.js +2 -2
  147. package/dist/channels/slack/init.d.ts +2 -0
  148. package/dist/channels/slack/init.d.ts.map +1 -1
  149. package/dist/channels/slack/init.js +10 -2
  150. package/dist/channels/slack/interactive.d.ts +6 -1
  151. package/dist/channels/slack/interactive.d.ts.map +1 -1
  152. package/dist/channels/slack/interactive.js +15 -25
  153. package/dist/channels/slack/manifest.d.ts.map +1 -1
  154. package/dist/channels/slack/manifest.js +15 -12
  155. package/dist/channels/slack/message-body.d.ts.map +1 -1
  156. package/dist/channels/slack/message-body.js +2 -4
  157. package/dist/channels/slack/nudge-carrier.d.ts.map +1 -1
  158. package/dist/channels/slack/nudge-carrier.js +27 -1
  159. package/dist/channels/slack/nudge-store.d.ts.map +1 -1
  160. package/dist/channels/slack/nudge-store.js +8 -3
  161. package/dist/channels/slack/placeholder.d.ts +3 -0
  162. package/dist/channels/slack/placeholder.d.ts.map +1 -1
  163. package/dist/channels/slack/placeholder.js +6 -5
  164. package/dist/channels/slack/recording-sink.d.ts.map +1 -1
  165. package/dist/channels/slack/recording-sink.js +4 -3
  166. package/dist/channels/slack/sender-name.d.ts.map +1 -1
  167. package/dist/channels/slack/sender-name.js +2 -3
  168. package/dist/channels/slack/slack-channel.d.ts +1 -3
  169. package/dist/channels/slack/slack-channel.d.ts.map +1 -1
  170. package/dist/channels/slack/slack-channel.js +63 -86
  171. package/dist/channels/slack/thread-context.d.ts.map +1 -1
  172. package/dist/channels/slack/thread-context.js +4 -9
  173. package/dist/channels/slack/tool-cards.d.ts.map +1 -1
  174. package/dist/channels/slack/tool-cards.js +4 -0
  175. package/dist/channels/slack/types.d.ts +19 -4
  176. package/dist/channels/slack/types.d.ts.map +1 -1
  177. package/dist/channels/slack/upload.d.ts +2 -0
  178. package/dist/channels/slack/upload.d.ts.map +1 -1
  179. package/dist/channels/slack/upload.js +49 -12
  180. package/dist/channels/slack/user-info.d.ts.map +1 -1
  181. package/dist/channels/slack/user-info.js +3 -6
  182. package/dist/channels.d.ts +11 -11
  183. package/dist/channels.d.ts.map +1 -1
  184. package/dist/channels.js +57 -30
  185. package/dist/connections.d.ts +1 -1
  186. package/dist/connections.js +1 -1
  187. package/dist/docs/404.html +4 -4
  188. package/dist/docs/architecture.svg +1 -1
  189. package/dist/docs/assets/{app.wA5xBBcd.js → app.DF9vlcdn.js} +4 -4
  190. package/dist/docs/assets/building-with-agents.md.Bf1yH2tG.js +9 -0
  191. package/dist/docs/assets/building-with-agents.md.Bf1yH2tG.lean.js +1 -0
  192. package/dist/docs/assets/changelog.md.fZ-NNFeJ.js +1 -0
  193. package/dist/docs/assets/changelog.md.fZ-NNFeJ.lean.js +1 -0
  194. package/dist/docs/assets/chunks/@localSearchIndexroot.mfzjiOsL.js +1 -0
  195. package/dist/docs/assets/chunks/{VPLocalSearchBox.C29HLCVL.js → VPLocalSearchBox.D8OuwKO0.js} +1 -1
  196. package/dist/docs/assets/chunks/{arc.BOaoYWmh.js → arc.DCq_TCYV.js} +1 -1
  197. package/dist/docs/assets/chunks/{architectureDiagram-Q4EWVU46.MfG0itQh.js → architectureDiagram-Q4EWVU46.PWRNTPbk.js} +1 -1
  198. package/dist/docs/assets/chunks/{baseUniq.CUeJciCF.js → baseUniq.BeRPvRUL.js} +1 -1
  199. package/dist/docs/assets/chunks/{blockDiagram-DXYQGD6D.BrXMZRtK.js → blockDiagram-DXYQGD6D.BuRmZVSo.js} +1 -1
  200. package/dist/docs/assets/chunks/{c4Diagram-AHTNJAMY.DfkDHeB9.js → c4Diagram-AHTNJAMY.7DKSMwuv.js} +1 -1
  201. package/dist/docs/assets/chunks/channel.goFR5lbe.js +1 -0
  202. package/dist/docs/assets/chunks/{chunk-4BX2VUAB.xKz8CiXK.js → chunk-4BX2VUAB.7VrO9-9i.js} +1 -1
  203. package/dist/docs/assets/chunks/{chunk-4TB4RGXK.kkfBh4zk.js → chunk-4TB4RGXK.CHystNE2.js} +1 -1
  204. package/dist/docs/assets/chunks/{chunk-55IACEB6.BClJGb94.js → chunk-55IACEB6.Nuh9TbTq.js} +1 -1
  205. package/dist/docs/assets/chunks/{chunk-EDXVE4YY.P9BpQ9L3.js → chunk-EDXVE4YY.CA0EKugm.js} +1 -1
  206. package/dist/docs/assets/chunks/{chunk-FMBD7UC4.R4iYi58S.js → chunk-FMBD7UC4.F9_mp7U8.js} +1 -1
  207. package/dist/docs/assets/chunks/{chunk-OYMX7WX6.Cpn8L1dw.js → chunk-OYMX7WX6.CEU4QfE1.js} +1 -1
  208. package/dist/docs/assets/chunks/{chunk-QZHKN3VN.BLftECqU.js → chunk-QZHKN3VN.B8h_x9_i.js} +1 -1
  209. package/dist/docs/assets/chunks/{chunk-YZCP3GAM.BWDV1AYt.js → chunk-YZCP3GAM.Btfb-rKg.js} +1 -1
  210. package/dist/docs/assets/chunks/classDiagram-6PBFFD2Q.B2yLtFja.js +1 -0
  211. package/dist/docs/assets/chunks/classDiagram-v2-HSJHXN6E.B2yLtFja.js +1 -0
  212. package/dist/docs/assets/chunks/clone.CztV97Wu.js +1 -0
  213. package/dist/docs/assets/chunks/{cose-bilkent-S5V4N54A.DGpAcJ55.js → cose-bilkent-S5V4N54A.DKvc96Wa.js} +1 -1
  214. package/dist/docs/assets/chunks/{dagre-KV5264BT.BBXxGEaD.js → dagre-KV5264BT.CMo0cy1b.js} +1 -1
  215. package/dist/docs/assets/chunks/{diagram-5BDNPKRD.EKqOwmK2.js → diagram-5BDNPKRD.DDgMOQhB.js} +1 -1
  216. package/dist/docs/assets/chunks/{diagram-G4DWMVQ6.CB8pdkoZ.js → diagram-G4DWMVQ6.BdJnoIsU.js} +1 -1
  217. package/dist/docs/assets/chunks/{diagram-MMDJMWI5.aHh4WGg9.js → diagram-MMDJMWI5.oSvhAZaL.js} +1 -1
  218. package/dist/docs/assets/chunks/{diagram-TYMM5635.YIsbRH20.js → diagram-TYMM5635.C9zZLIE-.js} +1 -1
  219. package/dist/docs/assets/chunks/{erDiagram-SMLLAGMA.B3bTCW_e.js → erDiagram-SMLLAGMA.BNhVyccy.js} +1 -1
  220. package/dist/docs/assets/chunks/{flowDiagram-DWJPFMVM.M81hXIXZ.js → flowDiagram-DWJPFMVM.BEFLLBiU.js} +1 -1
  221. package/dist/docs/assets/chunks/{ganttDiagram-T4ZO3ILL.BKg7WY--.js → ganttDiagram-T4ZO3ILL.BdUzXBgY.js} +1 -1
  222. package/dist/docs/assets/chunks/{gitGraphDiagram-UUTBAWPF.CLEMZgO3.js → gitGraphDiagram-UUTBAWPF.Rd3LlOIJ.js} +1 -1
  223. package/dist/docs/assets/chunks/{graph.DS38W_Q-.js → graph.DnJC1GpG.js} +1 -1
  224. package/dist/docs/assets/chunks/{infoDiagram-42DDH7IO.BTiWTi82.js → infoDiagram-42DDH7IO.xv0xntDJ.js} +1 -1
  225. package/dist/docs/assets/chunks/{ishikawaDiagram-UXIWVN3A.DcqY_KQL.js → ishikawaDiagram-UXIWVN3A.BaGIlviU.js} +1 -1
  226. package/dist/docs/assets/chunks/{journeyDiagram-VCZTEJTY.0lQNZ40U.js → journeyDiagram-VCZTEJTY.Cof_h0fp.js} +1 -1
  227. package/dist/docs/assets/chunks/{kanban-definition-6JOO6SKY.L5sKlf7X.js → kanban-definition-6JOO6SKY.C5GozFuU.js} +1 -1
  228. package/dist/docs/assets/chunks/{layout.7u4gFhQa.js → layout.zc9UShLc.js} +1 -1
  229. package/dist/docs/assets/chunks/{linear.D5v33SOb.js → linear.BoqrFVcJ.js} +1 -1
  230. package/dist/docs/assets/chunks/{min.Dc9uCxf9.js → min.DwIfr8hG.js} +1 -1
  231. package/dist/docs/assets/chunks/{mindmap-definition-QFDTVHPH.B56nGoB_.js → mindmap-definition-QFDTVHPH.Dkq2yTtp.js} +1 -1
  232. package/dist/docs/assets/chunks/{pieDiagram-DEJITSTG.Cba8e8lS.js → pieDiagram-DEJITSTG.B4CpTmHK.js} +1 -1
  233. package/dist/docs/assets/chunks/{quadrantDiagram-34T5L4WZ.2YjBycHF.js → quadrantDiagram-34T5L4WZ.BqXnFC9C.js} +1 -1
  234. package/dist/docs/assets/chunks/{requirementDiagram-MS252O5E.D4P5RqVI.js → requirementDiagram-MS252O5E.DhIN2z-E.js} +1 -1
  235. package/dist/docs/assets/chunks/{sankeyDiagram-XADWPNL6.C0Hn8NUm.js → sankeyDiagram-XADWPNL6.BhxUAmg2.js} +1 -1
  236. package/dist/docs/assets/chunks/{sequenceDiagram-FGHM5R23.BZm7EaoT.js → sequenceDiagram-FGHM5R23.BqgU7HU-.js} +1 -1
  237. package/dist/docs/assets/chunks/{stateDiagram-FHFEXIEX.DcR4f3X2.js → stateDiagram-FHFEXIEX.B1BCO18N.js} +1 -1
  238. package/dist/docs/assets/chunks/stateDiagram-v2-QKLJ7IA2.CZlVHdDZ.js +1 -0
  239. package/dist/docs/assets/chunks/{theme.DvfKzyXq.js → theme.oV7rddEz.js} +2 -2
  240. package/dist/docs/assets/chunks/{timeline-definition-GMOUNBTQ.CgDh96vg.js → timeline-definition-GMOUNBTQ.oRI8UwMC.js} +1 -1
  241. package/dist/docs/assets/chunks/{vennDiagram-DHZGUBPP.B4fagbC8.js → vennDiagram-DHZGUBPP.DmuWrIxN.js} +1 -1
  242. package/dist/docs/assets/chunks/{wardley-RL74JXVD.Ck68omim.js → wardley-RL74JXVD.CEBjM5ov.js} +1 -1
  243. package/dist/docs/assets/chunks/{wardleyDiagram-NUSXRM2D.DBUg0bvz.js → wardleyDiagram-NUSXRM2D.m5zsCOF9.js} +1 -1
  244. package/dist/docs/assets/chunks/{xychartDiagram-5P7HB3ND.DnKSGQE1.js → xychartDiagram-5P7HB3ND.cPN-587n.js} +1 -1
  245. package/dist/docs/assets/deployment.md.DDmjAVbg.js +31 -0
  246. package/dist/docs/assets/deployment.md.DDmjAVbg.lean.js +1 -0
  247. package/dist/docs/assets/{evals.md.CHR34K1Y.js → evals.md.OjKb7tNA.js} +9 -9
  248. package/dist/docs/assets/{guides_agent-to-agent.md.CwL5cwuE.js → guides_agent-to-agent.md.D1D5f6Jc.js} +7 -7
  249. package/dist/docs/assets/guides_agent-to-agent.md.D1D5f6Jc.lean.js +1 -0
  250. package/dist/docs/assets/{guides_bitbucket.md.CKUayYtD.js → guides_bitbucket.md.DkjkBRU8.js} +3 -3
  251. package/dist/docs/assets/guides_cloud-agents.md.Ceyjv0ul.js +9 -0
  252. package/dist/docs/assets/guides_cloud-agents.md.Ceyjv0ul.lean.js +1 -0
  253. package/dist/docs/assets/{guides_convert-automation.md.DMEX9nF-.js → guides_convert-automation.md.BjraCvok.js} +11 -11
  254. package/dist/docs/assets/guides_convert-automation.md.BjraCvok.lean.js +1 -0
  255. package/dist/docs/assets/{guides_github.md.TuNiZAOQ.js → guides_github.md.CgN5sNbW.js} +14 -14
  256. package/dist/docs/assets/{guides_github.md.TuNiZAOQ.lean.js → guides_github.md.CgN5sNbW.lean.js} +1 -1
  257. package/dist/docs/assets/{guides_gitlab.md.CtNI4fSH.js → guides_gitlab.md.DCE0p7_w.js} +3 -3
  258. package/dist/docs/assets/guides_grokbot-agents.md.D0PpM_Gf.js +15 -0
  259. package/dist/docs/assets/{guides_grokbot-agents.md.BwAykJ7U.lean.js → guides_grokbot-agents.md.D0PpM_Gf.lean.js} +1 -1
  260. package/dist/docs/assets/{guides_hooks.md.B2XfGX50.js → guides_hooks.md.BjeEiM7s.js} +4 -4
  261. package/dist/docs/assets/{guides_hooks.md.B2XfGX50.lean.js → guides_hooks.md.BjeEiM7s.lean.js} +1 -1
  262. package/dist/docs/assets/{guides_improve.md.CZKVt1cT.js → guides_improve.md.BFYtrtLE.js} +4 -4
  263. package/dist/docs/assets/{guides_improve.md.CZKVt1cT.lean.js → guides_improve.md.BFYtrtLE.lean.js} +1 -1
  264. package/dist/docs/assets/{guides_jev.md.D7XH4JH3.js → guides_jev.md.Ccw4pedT.js} +10 -10
  265. package/dist/docs/assets/{guides_mcp-oauth.md.Cxq2TxBB.js → guides_mcp-oauth.md.ekpWOZCC.js} +8 -8
  266. package/dist/docs/assets/{guides_mcp-oauth.md.Cxq2TxBB.lean.js → guides_mcp-oauth.md.ekpWOZCC.lean.js} +1 -1
  267. package/dist/docs/assets/guides_migrate.md.RS9Eu-Xh.js +8 -0
  268. package/dist/docs/assets/guides_migrate.md.RS9Eu-Xh.lean.js +1 -0
  269. package/dist/docs/assets/guides_opentelemetry.md.CoZ1kNyd.js +28 -0
  270. package/dist/docs/assets/guides_opentelemetry.md.CoZ1kNyd.lean.js +1 -0
  271. package/dist/docs/assets/{guides_pagerduty.md.BHXMcMtx.js → guides_pagerduty.md.mnKXe9U0.js} +10 -10
  272. package/dist/docs/assets/{guides_slack.md.ClIyi7FI.js → guides_slack.md.BqiGSYGX.js} +21 -8
  273. package/dist/docs/assets/{guides_slack.md.ClIyi7FI.lean.js → guides_slack.md.BqiGSYGX.lean.js} +1 -1
  274. package/dist/docs/assets/{guides_webhooks.md.Cpdc3BDX.js → guides_webhooks.md.BJk63ZTs.js} +9 -5
  275. package/dist/docs/assets/{guides_webhooks.md.Cpdc3BDX.lean.js → guides_webhooks.md.BJk63ZTs.lean.js} +1 -1
  276. package/dist/docs/assets/{hillclimbing.md.Dxvd-0gT.js → hillclimbing.md.By61f3uq.js} +2 -2
  277. package/dist/docs/assets/index.md.CVRjO09Y.js +27 -0
  278. package/dist/docs/assets/index.md.CVRjO09Y.lean.js +1 -0
  279. package/dist/docs/assets/{quickstart.md.D8JDfkKO.js → quickstart.md.DaLk4ZIF.js} +10 -10
  280. package/dist/docs/assets/quickstart.md.DaLk4ZIF.lean.js +1 -0
  281. package/dist/docs/assets/reference_access.md.CExlH_mR.js +1 -0
  282. package/dist/docs/assets/reference_access.md.CExlH_mR.lean.js +1 -0
  283. package/dist/docs/assets/{reference_agent-config.md.CZrbHOfT.js → reference_agent-config.md.11E_xe--.js} +10 -8
  284. package/dist/docs/assets/{reference_agent-config.md.CZrbHOfT.lean.js → reference_agent-config.md.11E_xe--.lean.js} +1 -1
  285. package/dist/docs/assets/{reference_artifacts.md.DLV9MZES.js → reference_artifacts.md.C-hKR2hp.js} +2 -2
  286. package/dist/docs/assets/reference_channels.md.DsJfGSBJ.js +22 -0
  287. package/dist/docs/assets/{reference_channels.md.CNNIS6K7.lean.js → reference_channels.md.DsJfGSBJ.lean.js} +1 -1
  288. package/dist/docs/assets/reference_cli.md.DQ3dCgmk.js +99 -0
  289. package/dist/docs/assets/reference_cli.md.DQ3dCgmk.lean.js +1 -0
  290. package/dist/docs/assets/{reference_connections.md.BJE2Zllp.js → reference_connections.md.BoAotr7_.js} +7 -7
  291. package/dist/docs/assets/{reference_evals.md.Ccwp4x3o.js → reference_evals.md.DYKjGFi-.js} +11 -11
  292. package/dist/docs/assets/{reference_extensions.md.DKxTuCIw.js → reference_extensions.md.pEVj72Xo.js} +9 -9
  293. package/dist/docs/assets/{reference_extensions.md.DKxTuCIw.lean.js → reference_extensions.md.pEVj72Xo.lean.js} +1 -1
  294. package/dist/docs/assets/{reference_hooks.md.CROr0QgC.js → reference_hooks.md.B-bwJuiG.js} +5 -5
  295. package/dist/docs/assets/{reference_http-api.md.Dji-DD_Z.js → reference_http-api.md._RWELr3d.js} +1 -1
  296. package/dist/docs/assets/{reference_instructions.md.BYMVxAkw.js → reference_instructions.md.yL2hXLnl.js} +1 -1
  297. package/dist/docs/assets/reference_limits.md.Da1HegjB.js +8 -0
  298. package/dist/docs/assets/reference_limits.md.Da1HegjB.lean.js +1 -0
  299. package/dist/docs/assets/reference_memory.md.Dd7cyV9V.js +4 -0
  300. package/dist/docs/assets/reference_playground.md.CQiJk9CM.js +1 -0
  301. package/dist/docs/assets/{reference_project-layout.md.mFcS8yDD.js → reference_project-layout.md.BamcPDUn.js} +4 -4
  302. package/dist/docs/assets/{reference_prompt.md.DqPh71XN.js → reference_prompt.md.BMjm1Jp3.js} +2 -2
  303. package/dist/docs/assets/{reference_schedules.md.BqWnJES4.js → reference_schedules.md.RC47aFm4.js} +4 -4
  304. package/dist/docs/assets/{reference_sessions.md.Bi6lHttM.js → reference_sessions.md.C7KFhWXV.js} +1 -1
  305. package/dist/docs/assets/{reference_skills.md.Ckddg6KX.js → reference_skills.md.Dej2zQxi.js} +2 -2
  306. package/dist/docs/assets/{reference_skills.md.Ckddg6KX.lean.js → reference_skills.md.Dej2zQxi.lean.js} +1 -1
  307. package/dist/docs/assets/{reference_subagents.md.ChNGh6HK.js → reference_subagents.md.CAhvW4yS.js} +1 -1
  308. package/dist/docs/assets/{reference_tools.md.Bo0UfT0a.js → reference_tools.md.DQr7Fnhu.js} +10 -10
  309. package/dist/docs/assets/{reference_tools.md.Bo0UfT0a.lean.js → reference_tools.md.DQr7Fnhu.lean.js} +1 -1
  310. package/dist/docs/assets/{style.B9o0luvp.css → style.DK0YX1WL.css} +1 -1
  311. package/dist/docs/assets/{templates_agentic-owners.md.CTEnR0jp.js → templates_agentic-owners.md.Dh2nDSqg.js} +4 -4
  312. package/dist/docs/assets/templates_security-reviewer.md.DnwXdnB5.js +3 -0
  313. package/dist/docs/assets/templates_thermo-quality-review.md.MJIdHkzE.js +3 -0
  314. package/dist/docs/assets/{templates_thermo-quality-review.md.B77UyTrX.lean.js → templates_thermo-quality-review.md.MJIdHkzE.lean.js} +1 -1
  315. package/dist/docs/assets/templates_thermo-review.md.DfN1OFOl.js +3 -0
  316. package/dist/docs/assets/{templates_thermo-review.md.DRJ7mC5U.lean.js → templates_thermo-review.md.DfN1OFOl.lean.js} +1 -1
  317. package/dist/docs/assets/{templates_triage.md.CNN6b0JZ.js → templates_triage.md.BYWMloV4.js} +4 -4
  318. package/dist/docs/assets/troubleshooting.md.AGJ3jDzj.js +1 -0
  319. package/dist/docs/building-with-agents.html +46 -46
  320. package/dist/docs/building-with-agents.md +15 -15
  321. package/dist/docs/changelog.html +39 -39
  322. package/dist/docs/changelog.md +47 -11
  323. package/dist/docs/deployment.html +52 -52
  324. package/dist/docs/deployment.md +110 -48
  325. package/dist/docs/evals.html +47 -47
  326. package/dist/docs/evals.md +11 -11
  327. package/dist/docs/guides/agent-to-agent.html +45 -45
  328. package/dist/docs/guides/agent-to-agent.md +7 -7
  329. package/dist/docs/guides/bitbucket.html +41 -41
  330. package/dist/docs/guides/bitbucket.md +5 -5
  331. package/dist/docs/guides/cloud-agents.html +41 -41
  332. package/dist/docs/guides/cloud-agents.md +3 -3
  333. package/dist/docs/guides/convert-automation.html +49 -49
  334. package/dist/docs/guides/convert-automation.md +16 -15
  335. package/dist/docs/guides/github.html +50 -50
  336. package/dist/docs/guides/github.md +16 -16
  337. package/dist/docs/guides/gitlab.html +41 -41
  338. package/dist/docs/guides/gitlab.md +5 -5
  339. package/dist/docs/guides/grokbot-agents.html +40 -40
  340. package/dist/docs/guides/grokbot-agents.md +8 -14
  341. package/dist/docs/guides/hooks.html +40 -40
  342. package/dist/docs/guides/hooks.md +3 -3
  343. package/dist/docs/guides/improve.html +40 -40
  344. package/dist/docs/guides/improve.md +2 -2
  345. package/dist/docs/guides/jev.html +48 -48
  346. package/dist/docs/guides/jev.md +10 -10
  347. package/dist/docs/guides/mcp-oauth.html +45 -45
  348. package/dist/docs/guides/mcp-oauth.md +8 -8
  349. package/dist/docs/guides/migrate.html +43 -42
  350. package/dist/docs/guides/migrate.md +34 -27
  351. package/dist/docs/guides/opentelemetry.html +50 -59
  352. package/dist/docs/guides/opentelemetry.md +61 -130
  353. package/dist/docs/guides/pagerduty.html +48 -48
  354. package/dist/docs/guides/pagerduty.md +18 -18
  355. package/dist/docs/guides/slack.html +58 -45
  356. package/dist/docs/guides/slack.md +82 -11
  357. package/dist/docs/guides/webhooks.html +46 -42
  358. package/dist/docs/guides/webhooks.md +61 -3
  359. package/dist/docs/hashmap.json +1 -1
  360. package/dist/docs/hillclimbing.html +39 -39
  361. package/dist/docs/hillclimbing.md +2 -2
  362. package/dist/docs/index.html +42 -42
  363. package/dist/docs/index.md +14 -15
  364. package/dist/docs/llms-full.txt +1238 -1243
  365. package/dist/docs/llms.txt +13 -13
  366. package/dist/docs/quickstart.html +48 -48
  367. package/dist/docs/quickstart.md +20 -20
  368. package/dist/docs/reference/access.html +60 -0
  369. package/dist/docs/reference/access.md +22 -0
  370. package/dist/docs/reference/agent-config.html +46 -44
  371. package/dist/docs/reference/agent-config.md +54 -12
  372. package/dist/docs/reference/artifacts.html +39 -39
  373. package/dist/docs/reference/artifacts.md +2 -2
  374. package/dist/docs/reference/channels.html +39 -39
  375. package/dist/docs/reference/channels.md +29 -9
  376. package/dist/docs/reference/cli.html +96 -100
  377. package/dist/docs/reference/cli.md +363 -366
  378. package/dist/docs/reference/connections.html +44 -44
  379. package/dist/docs/reference/connections.md +9 -9
  380. package/dist/docs/reference/evals.html +48 -48
  381. package/dist/docs/reference/evals.md +13 -13
  382. package/dist/docs/reference/extensions.html +46 -46
  383. package/dist/docs/reference/extensions.md +10 -10
  384. package/dist/docs/reference/hooks.html +42 -42
  385. package/dist/docs/reference/hooks.md +11 -11
  386. package/dist/docs/reference/http-api.html +39 -39
  387. package/dist/docs/reference/http-api.md +1 -1
  388. package/dist/docs/reference/instructions.html +39 -39
  389. package/dist/docs/reference/instructions.md +1 -1
  390. package/dist/docs/reference/limits.html +67 -0
  391. package/dist/docs/reference/limits.md +37 -0
  392. package/dist/docs/reference/memory.html +40 -40
  393. package/dist/docs/reference/memory.md +7 -7
  394. package/dist/docs/reference/playground.html +38 -38
  395. package/dist/docs/reference/playground.md +1 -1
  396. package/dist/docs/reference/project-layout.html +41 -41
  397. package/dist/docs/reference/project-layout.md +6 -6
  398. package/dist/docs/reference/prompt.html +39 -39
  399. package/dist/docs/reference/prompt.md +2 -2
  400. package/dist/docs/reference/schedules.html +42 -42
  401. package/dist/docs/reference/schedules.md +4 -4
  402. package/dist/docs/reference/sessions.html +39 -39
  403. package/dist/docs/reference/sessions.md +3 -3
  404. package/dist/docs/reference/skills.html +39 -39
  405. package/dist/docs/reference/skills.md +2 -2
  406. package/dist/docs/reference/subagents.html +39 -39
  407. package/dist/docs/reference/subagents.md +1 -1
  408. package/dist/docs/reference/tools.html +47 -47
  409. package/dist/docs/reference/tools.md +31 -21
  410. package/dist/docs/templates/agentic-owners.html +41 -41
  411. package/dist/docs/templates/agentic-owners.md +7 -7
  412. package/dist/docs/templates/security-reviewer.html +39 -39
  413. package/dist/docs/templates/security-reviewer.md +6 -6
  414. package/dist/docs/templates/thermo-quality-review.html +40 -40
  415. package/dist/docs/templates/thermo-quality-review.md +7 -7
  416. package/dist/docs/templates/thermo-review.html +40 -40
  417. package/dist/docs/templates/thermo-review.md +7 -7
  418. package/dist/docs/templates/triage.html +41 -41
  419. package/dist/docs/templates/triage.md +9 -9
  420. package/dist/docs/troubleshooting.html +38 -38
  421. package/dist/docs/troubleshooting.md +24 -22
  422. package/dist/evals/assertions.d.ts.map +1 -1
  423. package/dist/evals/assertions.js +2 -2
  424. package/dist/evals/expect.d.ts.map +1 -1
  425. package/dist/evals/expect.js +9 -1
  426. package/dist/evals/judge.js +2 -2
  427. package/dist/evals/loaders.d.ts +3 -3
  428. package/dist/evals/loaders.d.ts.map +1 -1
  429. package/dist/evals/loaders.js +6 -3
  430. package/dist/evals/matchers.d.ts +1 -1
  431. package/dist/evals/matchers.d.ts.map +1 -1
  432. package/dist/evals/matchers.js +40 -6
  433. package/dist/evals/reporters.d.ts +2 -2
  434. package/dist/evals/reporters.js +2 -2
  435. package/dist/evals/results.d.ts +1 -1
  436. package/dist/evals/results.js +1 -1
  437. package/dist/evals.d.ts +1 -1
  438. package/dist/evals.js +1 -1
  439. package/dist/executors.d.ts +1 -1
  440. package/dist/executors.d.ts.map +1 -1
  441. package/dist/executors.js +2 -2
  442. package/dist/extensions/cursor-cloud-agents/extension.d.ts +1 -1
  443. package/dist/extensions/cursor-cloud-agents/extension.js +1 -1
  444. package/dist/extensions/cursor-cloud-agents/lib/backend.d.ts.map +1 -1
  445. package/dist/extensions/cursor-cloud-agents/lib/backend.js +13 -2
  446. package/dist/extensions/cursor-cloud-agents/reminders/cloud-agent-stop-watch.js +3 -3
  447. package/dist/extensions/cursor-grokbot-agents/extension.d.ts +7 -13
  448. package/dist/extensions/cursor-grokbot-agents/extension.d.ts.map +1 -1
  449. package/dist/extensions/cursor-grokbot-agents/extension.js +7 -13
  450. package/dist/extensions/cursor-grokbot-agents/lib/backend.d.ts +6 -6
  451. package/dist/extensions/cursor-grokbot-agents/lib/backend.d.ts.map +1 -1
  452. package/dist/extensions/cursor-grokbot-agents/lib/backend.js +8 -7
  453. package/dist/extensions/cursor-grokbot-agents/lib/conversation.d.ts +6 -6
  454. package/dist/extensions/cursor-grokbot-agents/lib/conversation.js +6 -6
  455. package/dist/extensions/improve/extension.d.ts +1 -1
  456. package/dist/extensions/improve/extension.js +1 -1
  457. package/dist/extensions/jev/extension.d.ts +1 -1
  458. package/dist/extensions/jev/extension.js +1 -1
  459. package/dist/extensions/jev/lib/evaluate.d.ts +2 -2
  460. package/dist/extensions/jev/lib/evaluate.d.ts.map +1 -1
  461. package/dist/extensions/jev/lib/evaluate.js +26 -7
  462. package/dist/extensions/jev/skills/gated-write.md +1 -1
  463. package/dist/extensions/slack-communication/extension.d.ts +1 -1
  464. package/dist/extensions/slack-communication/extension.js +1 -1
  465. package/dist/extensions/slack-communication/skills/slack-voice.js +1 -1
  466. package/dist/extensions/slack-communication/tools/post-file.d.ts.map +1 -1
  467. package/dist/extensions/slack-communication/tools/post-file.js +45 -2
  468. package/dist/extensions.d.ts +2 -2
  469. package/dist/extensions.d.ts.map +1 -1
  470. package/dist/extensions.js +7 -3
  471. package/dist/files-backends/cursor-hosted.d.ts.map +1 -1
  472. package/dist/files-backends/cursor-hosted.js +5 -0
  473. package/dist/files-backends/local-fs.d.ts.map +1 -1
  474. package/dist/files-backends/local-fs.js +4 -3
  475. package/dist/filesystem.d.ts +24 -54
  476. package/dist/filesystem.d.ts.map +1 -1
  477. package/dist/filesystem.js +172 -104
  478. package/dist/hooks.d.ts +1 -1
  479. package/dist/hooks.js +1 -1
  480. package/dist/index.d.ts +11 -4
  481. package/dist/index.d.ts.map +1 -1
  482. package/dist/index.js +10 -3
  483. package/dist/internal/advertise-tools.d.ts +3 -3
  484. package/dist/internal/advertise-tools.d.ts.map +1 -1
  485. package/dist/internal/advertise-tools.js +9 -5
  486. package/dist/internal/artifacts-store.d.ts.map +1 -1
  487. package/dist/internal/artifacts-store.js +15 -6
  488. package/dist/internal/as-of.d.ts.map +1 -1
  489. package/dist/internal/as-of.js +4 -3
  490. package/dist/internal/authored-alias-hooks.d.ts +1 -20
  491. package/dist/internal/authored-alias-hooks.d.ts.map +1 -1
  492. package/dist/internal/authored-alias-hooks.js +54 -7
  493. package/dist/internal/authored-loaders.d.ts +2 -2
  494. package/dist/internal/authored-loaders.d.ts.map +1 -1
  495. package/dist/internal/authored-loaders.js +38 -13
  496. package/dist/internal/brand.d.ts.map +1 -1
  497. package/dist/internal/brand.js +25 -2
  498. package/dist/internal/builtin-tools/artifacts.d.ts.map +1 -1
  499. package/dist/internal/builtin-tools/artifacts.js +19 -3
  500. package/dist/internal/channel-dispatch.d.ts.map +1 -1
  501. package/dist/internal/channel-dispatch.js +1 -1
  502. package/dist/internal/channel-state.d.ts.map +1 -1
  503. package/dist/internal/channel-state.js +13 -8
  504. package/dist/internal/chat-client.d.ts.map +1 -1
  505. package/dist/internal/chat-client.js +14 -5
  506. package/dist/internal/cli/command.d.ts +134 -0
  507. package/dist/internal/cli/command.d.ts.map +1 -0
  508. package/dist/internal/cli/command.js +54 -0
  509. package/dist/internal/cli/commands/channels.d.ts +26 -0
  510. package/dist/internal/cli/commands/channels.d.ts.map +1 -0
  511. package/dist/internal/cli/commands/channels.js +524 -0
  512. package/dist/internal/cli/commands/develop.d.ts +15 -0
  513. package/dist/internal/cli/commands/develop.d.ts.map +1 -0
  514. package/dist/internal/cli/commands/develop.js +568 -0
  515. package/dist/internal/cli/commands/hosted.d.ts +22 -0
  516. package/dist/internal/cli/commands/hosted.d.ts.map +1 -0
  517. package/dist/internal/cli/commands/hosted.js +407 -0
  518. package/dist/internal/cli/commands/index.d.ts +4 -0
  519. package/dist/internal/cli/commands/index.d.ts.map +1 -0
  520. package/dist/internal/cli/commands/index.js +84 -0
  521. package/dist/internal/cli/commands/mcp.d.ts +6 -0
  522. package/dist/internal/cli/commands/mcp.d.ts.map +1 -0
  523. package/dist/internal/cli/commands/mcp.js +89 -0
  524. package/dist/internal/cli/commands/project.d.ts +5 -0
  525. package/dist/internal/cli/commands/project.d.ts.map +1 -0
  526. package/dist/internal/cli/commands/project.js +136 -0
  527. package/dist/internal/cli/commands/scaffold.d.ts +12 -0
  528. package/dist/internal/cli/commands/scaffold.d.ts.map +1 -0
  529. package/dist/internal/cli/commands/scaffold.js +279 -0
  530. package/dist/internal/cli/commands/serve.d.ts +11 -0
  531. package/dist/internal/cli/commands/serve.d.ts.map +1 -0
  532. package/dist/internal/cli/commands/serve.js +370 -0
  533. package/dist/internal/cli/commands/session.d.ts +7 -0
  534. package/dist/internal/cli/commands/session.d.ts.map +1 -0
  535. package/dist/internal/cli/commands/session.js +354 -0
  536. package/dist/internal/cli/dispatch.d.ts +46 -0
  537. package/dist/internal/cli/dispatch.d.ts.map +1 -0
  538. package/dist/internal/cli/dispatch.js +385 -0
  539. package/dist/internal/cli/errors.d.ts +51 -0
  540. package/dist/internal/cli/errors.d.ts.map +1 -0
  541. package/dist/internal/cli/errors.js +142 -0
  542. package/dist/internal/cli/flags.d.ts +186 -0
  543. package/dist/internal/cli/flags.d.ts.map +1 -0
  544. package/dist/internal/cli/flags.js +167 -0
  545. package/dist/internal/cli/help-command.d.ts +7 -0
  546. package/dist/internal/cli/help-command.d.ts.map +1 -0
  547. package/dist/internal/cli/help-command.js +60 -0
  548. package/dist/internal/cli/help.d.ts +63 -0
  549. package/dist/internal/cli/help.d.ts.map +1 -0
  550. package/dist/internal/cli/help.js +203 -0
  551. package/dist/internal/cli/io.d.ts +11 -0
  552. package/dist/internal/cli/io.d.ts.map +1 -0
  553. package/dist/internal/cli/io.js +33 -0
  554. package/dist/internal/cli/output.d.ts +54 -0
  555. package/dist/internal/cli/output.d.ts.map +1 -0
  556. package/dist/internal/cli/output.js +132 -0
  557. package/dist/internal/cli/value-kinds.d.ts +20 -0
  558. package/dist/internal/cli/value-kinds.d.ts.map +1 -0
  559. package/dist/internal/cli/value-kinds.js +70 -0
  560. package/dist/internal/cli-ax.d.ts +35 -20
  561. package/dist/internal/cli-ax.d.ts.map +1 -1
  562. package/dist/internal/cli-ax.js +436 -365
  563. package/dist/internal/cli-convert-automation.d.ts +3 -1
  564. package/dist/internal/cli-convert-automation.d.ts.map +1 -1
  565. package/dist/internal/cli-convert-automation.js +52 -20
  566. package/dist/internal/cli-cursor.js +5 -1
  567. package/dist/internal/cli-deploy.d.ts +23 -9
  568. package/dist/internal/cli-deploy.d.ts.map +1 -1
  569. package/dist/internal/cli-deploy.js +234 -508
  570. package/dist/internal/cli-docs.d.ts +1 -1
  571. package/dist/internal/cli-docs.js +3 -2
  572. package/dist/internal/cli-github.js +1 -0
  573. package/dist/internal/cli-images.d.ts.map +1 -1
  574. package/dist/internal/cli-images.js +44 -14
  575. package/dist/internal/cli-invocation.d.ts +22 -0
  576. package/dist/internal/cli-invocation.d.ts.map +1 -0
  577. package/dist/internal/cli-invocation.js +86 -0
  578. package/dist/internal/cli-manifest.d.ts +4 -1
  579. package/dist/internal/cli-manifest.d.ts.map +1 -1
  580. package/dist/internal/cli-manifest.js +16 -4
  581. package/dist/internal/cli-mcp-oauth.d.ts +7 -11
  582. package/dist/internal/cli-mcp-oauth.d.ts.map +1 -1
  583. package/dist/internal/cli-mcp-oauth.js +24 -104
  584. package/dist/internal/cli-mcp.d.ts +17 -28
  585. package/dist/internal/cli-mcp.d.ts.map +1 -1
  586. package/dist/internal/cli-mcp.js +64 -304
  587. package/dist/internal/cli-migrate.d.ts +2 -0
  588. package/dist/internal/cli-migrate.d.ts.map +1 -1
  589. package/dist/internal/cli-migrate.js +42 -14
  590. package/dist/internal/cli-skills.d.ts +30 -2
  591. package/dist/internal/cli-skills.d.ts.map +1 -1
  592. package/dist/internal/cli-skills.js +63 -3
  593. package/dist/internal/cli-slack-context.d.ts +91 -0
  594. package/dist/internal/cli-slack-context.d.ts.map +1 -0
  595. package/dist/internal/cli-slack-context.js +112 -0
  596. package/dist/internal/cli-slack-manual.d.ts +2 -0
  597. package/dist/internal/cli-slack-manual.d.ts.map +1 -1
  598. package/dist/internal/cli-slack-manual.js +12 -0
  599. package/dist/internal/cli-slack.d.ts +1 -49
  600. package/dist/internal/cli-slack.d.ts.map +1 -1
  601. package/dist/internal/cli-slack.js +27 -147
  602. package/dist/internal/cloud-merge.d.ts +2 -4
  603. package/dist/internal/cloud-merge.d.ts.map +1 -1
  604. package/dist/internal/cloud-merge.js +2 -7
  605. package/dist/internal/continuation-channel.d.ts.map +1 -1
  606. package/dist/internal/continuation-channel.js +10 -22
  607. package/dist/internal/continuation-identity.d.ts +33 -12
  608. package/dist/internal/continuation-identity.d.ts.map +1 -1
  609. package/dist/internal/continuation-identity.js +161 -43
  610. package/dist/internal/continuation-registration.d.ts +26 -0
  611. package/dist/internal/continuation-registration.d.ts.map +1 -0
  612. package/dist/internal/continuation-registration.js +35 -0
  613. package/dist/internal/conversation-mirror.d.ts.map +1 -1
  614. package/dist/internal/conversation-mirror.js +23 -14
  615. package/dist/internal/convert-automation/convert-workflow.d.ts.map +1 -1
  616. package/dist/internal/convert-automation/convert-workflow.js +28 -22
  617. package/dist/internal/convert-automation/types.d.ts +1 -1
  618. package/dist/internal/convert-automation/types.js +1 -1
  619. package/dist/internal/cursor/account-mcp.js +1 -1
  620. package/dist/internal/cursor/backend-client.d.ts.map +1 -1
  621. package/dist/internal/cursor/backend-client.js +6 -8
  622. package/dist/internal/cursor/bound-secret-file.d.ts.map +1 -1
  623. package/dist/internal/cursor/bound-secret-file.js +2 -1
  624. package/dist/internal/cursor/credentials.d.ts +4 -17
  625. package/dist/internal/cursor/credentials.d.ts.map +1 -1
  626. package/dist/internal/cursor/credentials.js +11 -27
  627. package/dist/internal/cursor/session-token.d.ts.map +1 -1
  628. package/dist/internal/cursor/session-token.js +3 -4
  629. package/dist/internal/cursor/store-api-client.d.ts.map +1 -1
  630. package/dist/internal/cursor/store-api-client.js +3 -2
  631. package/dist/internal/cursor-agent-template.d.ts +1 -1
  632. package/dist/internal/cursor-agent-template.d.ts.map +1 -1
  633. package/dist/internal/cursor-agent-template.js +2 -2
  634. package/dist/internal/cursor-deployment-relay.d.ts.map +1 -1
  635. package/dist/internal/cursor-deployment-relay.js +24 -2
  636. package/dist/internal/cursor-event-relay.d.ts.map +1 -1
  637. package/dist/internal/cursor-event-relay.js +26 -2
  638. package/dist/internal/cursor-relay-core.d.ts.map +1 -1
  639. package/dist/internal/cursor-relay-core.js +22 -3
  640. package/dist/internal/deploy-client.d.ts +102 -92
  641. package/dist/internal/deploy-client.d.ts.map +1 -1
  642. package/dist/internal/deploy-client.js +143 -178
  643. package/dist/internal/deploy-manifest.d.ts +2 -2
  644. package/dist/internal/deploy-manifest.d.ts.map +1 -1
  645. package/dist/internal/deploy-manifest.js +6 -6
  646. package/dist/internal/describe-error.d.ts +4 -0
  647. package/dist/internal/describe-error.d.ts.map +1 -1
  648. package/dist/internal/describe-error.js +20 -0
  649. package/dist/internal/discovery/agent-config.d.ts +1 -5
  650. package/dist/internal/discovery/agent-config.d.ts.map +1 -1
  651. package/dist/internal/discovery/agent-config.js +5 -11
  652. package/dist/internal/discovery/agent.d.ts.map +1 -1
  653. package/dist/internal/discovery/agent.js +24 -30
  654. package/dist/internal/discovery/channels.d.ts.map +1 -1
  655. package/dist/internal/discovery/channels.js +2 -0
  656. package/dist/internal/discovery/connections.d.ts.map +1 -1
  657. package/dist/internal/discovery/connections.js +6 -4
  658. package/dist/internal/discovery/context.d.ts.map +1 -1
  659. package/dist/internal/discovery/context.js +6 -1
  660. package/dist/internal/discovery/extension-overlay.d.ts +1 -1
  661. package/dist/internal/discovery/extension-overlay.d.ts.map +1 -1
  662. package/dist/internal/discovery/extension-overlay.js +1 -0
  663. package/dist/internal/discovery/extensions.d.ts.map +1 -1
  664. package/dist/internal/discovery/extensions.js +12 -5
  665. package/dist/internal/discovery/fs.d.ts.map +1 -1
  666. package/dist/internal/discovery/fs.js +2 -1
  667. package/dist/internal/discovery/hooks.d.ts.map +1 -1
  668. package/dist/internal/discovery/hooks.js +1 -0
  669. package/dist/internal/discovery/info.d.ts.map +1 -1
  670. package/dist/internal/discovery/info.js +0 -3
  671. package/dist/internal/discovery/instructions.d.ts.map +1 -1
  672. package/dist/internal/discovery/instructions.js +4 -1
  673. package/dist/internal/discovery/instrumentation.js +1 -1
  674. package/dist/internal/discovery/modules.d.ts.map +1 -1
  675. package/dist/internal/discovery/modules.js +4 -1
  676. package/dist/internal/discovery/project.js +1 -1
  677. package/dist/internal/discovery/reminders.d.ts.map +1 -1
  678. package/dist/internal/discovery/reminders.js +1 -0
  679. package/dist/internal/discovery/runtime.d.ts +0 -16
  680. package/dist/internal/discovery/runtime.d.ts.map +1 -1
  681. package/dist/internal/discovery/runtime.js +2 -47
  682. package/dist/internal/discovery/schedules.d.ts.map +1 -1
  683. package/dist/internal/discovery/schedules.js +1 -0
  684. package/dist/internal/discovery/services.d.ts.map +1 -1
  685. package/dist/internal/discovery/services.js +3 -1
  686. package/dist/internal/discovery/skills.d.ts.map +1 -1
  687. package/dist/internal/discovery/skills.js +1 -0
  688. package/dist/internal/discovery/tools.d.ts +1 -1
  689. package/dist/internal/discovery/tools.d.ts.map +1 -1
  690. package/dist/internal/discovery/tools.js +3 -1
  691. package/dist/internal/discovery.d.ts +1 -1
  692. package/dist/internal/discovery.d.ts.map +1 -1
  693. package/dist/internal/discovery.js +1 -1
  694. package/dist/internal/distribution.d.ts +9 -14
  695. package/dist/internal/distribution.d.ts.map +1 -1
  696. package/dist/internal/distribution.js +54 -18
  697. package/dist/internal/docs-site.d.ts.map +1 -1
  698. package/dist/internal/docs-site.js +15 -2
  699. package/dist/internal/dry-run.d.ts +32 -0
  700. package/dist/internal/dry-run.d.ts.map +1 -0
  701. package/dist/internal/dry-run.js +62 -0
  702. package/dist/internal/duration.d.ts.map +1 -1
  703. package/dist/internal/duration.js +1 -0
  704. package/dist/internal/estimate-cost.d.ts.map +1 -1
  705. package/dist/internal/estimate-cost.js +12 -5
  706. package/dist/internal/eval-run-store.d.ts.map +1 -1
  707. package/dist/internal/eval-run-store.js +6 -5
  708. package/dist/internal/eval-runner.d.ts +0 -2
  709. package/dist/internal/eval-runner.d.ts.map +1 -1
  710. package/dist/internal/eval-runner.js +3 -3
  711. package/dist/internal/evals-client.d.ts.map +1 -1
  712. package/dist/internal/evals-client.js +60 -15
  713. package/dist/internal/event-log.d.ts.map +1 -1
  714. package/dist/internal/event-log.js +3 -11
  715. package/dist/internal/event-mapper.d.ts.map +1 -1
  716. package/dist/internal/event-mapper.js +33 -15
  717. package/dist/internal/expected-delivery-failure.d.ts.map +1 -1
  718. package/dist/internal/expected-delivery-failure.js +5 -4
  719. package/dist/internal/fetch-text.d.ts +8 -0
  720. package/dist/internal/fetch-text.d.ts.map +1 -0
  721. package/dist/internal/fetch-text.js +32 -0
  722. package/dist/internal/filesystem/errors.d.ts.map +1 -1
  723. package/dist/internal/filesystem/errors.js +8 -0
  724. package/dist/internal/filesystem/scratch.js +1 -4
  725. package/dist/internal/filesystem/sdk-schemas.d.ts +19 -19
  726. package/dist/internal/filesystem/sdk-schemas.d.ts.map +1 -1
  727. package/dist/internal/filesystem/sdk-schemas.js +15 -21
  728. package/dist/internal/filesystem/tools.d.ts +15 -4
  729. package/dist/internal/filesystem/tools.d.ts.map +1 -1
  730. package/dist/internal/filesystem/tools.js +33 -47
  731. package/dist/internal/filesystem/walk.d.ts.map +1 -1
  732. package/dist/internal/filesystem/walk.js +4 -0
  733. package/dist/internal/framework-file-storage.d.ts.map +1 -1
  734. package/dist/internal/framework-file-storage.js +2 -1
  735. package/dist/internal/frontmatter.d.ts.map +1 -1
  736. package/dist/internal/frontmatter.js +5 -1
  737. package/dist/internal/github-fanout.js +2 -1
  738. package/dist/internal/guest-network.d.ts.map +1 -1
  739. package/dist/internal/guest-network.js +6 -0
  740. package/dist/internal/handleAgentServeTrigger.d.ts +8 -0
  741. package/dist/internal/handleAgentServeTrigger.d.ts.map +1 -1
  742. package/dist/internal/handleAgentServeTrigger.js +27 -1
  743. package/dist/internal/host-kv.d.ts.map +1 -1
  744. package/dist/internal/host-kv.js +4 -2
  745. package/dist/internal/host-otel.d.ts.map +1 -1
  746. package/dist/internal/host-otel.js +2 -8
  747. package/dist/internal/host-platforms.d.ts.map +1 -1
  748. package/dist/internal/host-platforms.js +17 -10
  749. package/dist/internal/hosted-catch-protocol.d.ts.map +1 -1
  750. package/dist/internal/hosted-catch-protocol.js +26 -9
  751. package/dist/internal/hosted-catch.d.ts +13 -10
  752. package/dist/internal/hosted-catch.d.ts.map +1 -1
  753. package/dist/internal/hosted-catch.js +23 -11
  754. package/dist/internal/hosted-delivery-protocol.d.ts +1 -1
  755. package/dist/internal/hosted-delivery-protocol.d.ts.map +1 -1
  756. package/dist/internal/hosted-delivery-protocol.js +75 -45
  757. package/dist/internal/hosted-delivery.d.ts +1 -2
  758. package/dist/internal/hosted-delivery.d.ts.map +1 -1
  759. package/dist/internal/hosted-delivery.js +27 -32
  760. package/dist/internal/hosted-execution-diag.d.ts.map +1 -1
  761. package/dist/internal/hosted-execution-diag.js +11 -13
  762. package/dist/internal/hosted-execution-flush.js +1 -1
  763. package/dist/internal/hosted-execution-latency.d.ts.map +1 -1
  764. package/dist/internal/hosted-execution-latency.js +12 -1
  765. package/dist/internal/hosted-hints.d.ts +16 -0
  766. package/dist/internal/hosted-hints.d.ts.map +1 -0
  767. package/dist/internal/hosted-hints.js +23 -0
  768. package/dist/internal/hosted-managed-automation.d.ts.map +1 -1
  769. package/dist/internal/hosted-managed-automation.js +1 -0
  770. package/dist/internal/hosted-session-fixture.d.ts +26 -0
  771. package/dist/internal/hosted-session-fixture.d.ts.map +1 -0
  772. package/dist/internal/hosted-session-fixture.js +34 -0
  773. package/dist/internal/hosted-session-view.d.ts +48 -0
  774. package/dist/internal/hosted-session-view.d.ts.map +1 -0
  775. package/dist/internal/hosted-session-view.js +305 -0
  776. package/dist/internal/http-channel.d.ts.map +1 -1
  777. package/dist/internal/http-channel.js +8 -5
  778. package/dist/internal/http-control-plane-session.d.ts.map +1 -1
  779. package/dist/internal/http-control-plane-session.js +8 -9
  780. package/dist/internal/init-interview.js +2 -2
  781. package/dist/internal/init-project.d.ts +7 -13
  782. package/dist/internal/init-project.d.ts.map +1 -1
  783. package/dist/internal/init-project.js +10 -20
  784. package/dist/internal/init-scaffold.js +2 -2
  785. package/dist/internal/inline-stdio-define-stub.d.ts +1 -1
  786. package/dist/internal/inline-stdio-define-stub.d.ts.map +1 -1
  787. package/dist/internal/inline-stdio-define-stub.js +1 -1
  788. package/dist/internal/inline-stdio-mcp.d.ts.map +1 -1
  789. package/dist/internal/inline-stdio-mcp.js +31 -8
  790. package/dist/internal/install-cursor-skills.d.ts +22 -15
  791. package/dist/internal/install-cursor-skills.d.ts.map +1 -1
  792. package/dist/internal/install-cursor-skills.js +66 -31
  793. package/dist/internal/interview/agent-questions.d.ts.map +1 -1
  794. package/dist/internal/interview/agent-questions.js +4 -1
  795. package/dist/internal/interview/question.d.ts +1 -1
  796. package/dist/internal/interview/question.js +1 -1
  797. package/dist/internal/json-schema.d.ts +3 -2
  798. package/dist/internal/json-schema.d.ts.map +1 -1
  799. package/dist/internal/json-schema.js +83 -3
  800. package/dist/internal/json-value.d.ts +20 -0
  801. package/dist/internal/json-value.d.ts.map +1 -0
  802. package/dist/internal/json-value.js +56 -0
  803. package/dist/internal/logs-client.d.ts +4 -25
  804. package/dist/internal/logs-client.d.ts.map +1 -1
  805. package/dist/internal/logs-client.js +17 -174
  806. package/dist/internal/mcp-endpoint.d.ts +1 -1
  807. package/dist/internal/mcp-endpoint.js +2 -1
  808. package/dist/internal/mcp-host.d.ts.map +1 -1
  809. package/dist/internal/mcp-host.js +22 -9
  810. package/dist/internal/mcp-oauth.d.ts +2 -2
  811. package/dist/internal/mcp-oauth.d.ts.map +1 -1
  812. package/dist/internal/mcp-oauth.js +61 -8
  813. package/dist/internal/named-webhook-secret.d.ts +12 -0
  814. package/dist/internal/named-webhook-secret.d.ts.map +1 -1
  815. package/dist/internal/named-webhook-secret.js +18 -0
  816. package/dist/internal/otel/bind-telemetry.d.ts +26 -0
  817. package/dist/internal/otel/bind-telemetry.d.ts.map +1 -0
  818. package/dist/internal/otel/bind-telemetry.js +36 -0
  819. package/dist/internal/otel/collector.d.ts.map +1 -1
  820. package/dist/internal/otel/collector.js +94 -42
  821. package/dist/internal/otel/config.d.ts.map +1 -1
  822. package/dist/internal/otel/config.js +4 -3
  823. package/dist/internal/otel/conversation-span-processor.d.ts.map +1 -1
  824. package/dist/internal/otel/conversation-span-processor.js +5 -2
  825. package/dist/internal/otel/customer.d.ts +1 -5
  826. package/dist/internal/otel/customer.d.ts.map +1 -1
  827. package/dist/internal/otel/customer.js +35 -13
  828. package/dist/internal/otel/http.d.ts +1 -1
  829. package/dist/internal/otel/http.d.ts.map +1 -1
  830. package/dist/internal/otel/http.js +5 -3
  831. package/dist/internal/otel/propagation.d.ts +3 -2
  832. package/dist/internal/otel/propagation.d.ts.map +1 -1
  833. package/dist/internal/otel/propagation.js +3 -2
  834. package/dist/internal/otel/reserved-attributes.d.ts +8 -0
  835. package/dist/internal/otel/reserved-attributes.d.ts.map +1 -0
  836. package/dist/internal/otel/reserved-attributes.js +24 -0
  837. package/dist/internal/otel/runtime.d.ts.map +1 -1
  838. package/dist/internal/otel/runtime.js +9 -2
  839. package/dist/internal/otel/session-telemetry.d.ts +22 -0
  840. package/dist/internal/otel/session-telemetry.d.ts.map +1 -0
  841. package/dist/internal/otel/session-telemetry.js +30 -0
  842. package/dist/internal/otel/telemetry-attributes.d.ts +7 -0
  843. package/dist/internal/otel/telemetry-attributes.d.ts.map +1 -0
  844. package/dist/internal/otel/telemetry-attributes.js +35 -0
  845. package/dist/internal/otel/telemetry-processor.d.ts +7 -0
  846. package/dist/internal/otel/telemetry-processor.d.ts.map +1 -0
  847. package/dist/internal/otel/telemetry-processor.js +47 -0
  848. package/dist/internal/otel/tool-error-class.d.ts.map +1 -1
  849. package/dist/internal/otel/tool-error-class.js +4 -0
  850. package/dist/internal/package-inline-stdio.d.ts.map +1 -1
  851. package/dist/internal/package-inline-stdio.js +2 -2
  852. package/dist/internal/persistent-stage-log-mirror.js +2 -5
  853. package/dist/internal/platform-timers.d.ts.map +1 -1
  854. package/dist/internal/platform-timers.js +32 -1
  855. package/dist/internal/playground/toolchain.d.ts.map +1 -1
  856. package/dist/internal/playground/toolchain.js +16 -3
  857. package/dist/internal/playground-proxy.d.ts +6 -27
  858. package/dist/internal/playground-proxy.d.ts.map +1 -1
  859. package/dist/internal/playground-proxy.js +25 -83
  860. package/dist/internal/private-file.d.ts +2 -0
  861. package/dist/internal/private-file.d.ts.map +1 -0
  862. package/dist/internal/private-file.js +8 -0
  863. package/dist/internal/reminder-control-plane-protocol.d.ts.map +1 -1
  864. package/dist/internal/reminder-control-plane-protocol.js +4 -2
  865. package/dist/internal/reminder-runner.d.ts.map +1 -1
  866. package/dist/internal/reminder-runner.js +12 -25
  867. package/dist/internal/reminder-schedule.js +1 -1
  868. package/dist/internal/reminder-store.d.ts.map +1 -1
  869. package/dist/internal/reminder-store.js +16 -21
  870. package/dist/internal/request-headers.d.ts +2 -2
  871. package/dist/internal/request-headers.d.ts.map +1 -1
  872. package/dist/internal/request-headers.js +1 -1
  873. package/dist/internal/resolve-prod-target.d.ts +9 -65
  874. package/dist/internal/resolve-prod-target.d.ts.map +1 -1
  875. package/dist/internal/resolve-prod-target.js +20 -187
  876. package/dist/internal/resolved-connections.js +1 -1
  877. package/dist/internal/{factory-resource-channel.d.ts → resource-channel.d.ts} +10 -10
  878. package/dist/internal/resource-channel.d.ts.map +1 -0
  879. package/dist/internal/{factory-resource-channel.js → resource-channel.js} +9 -7
  880. package/dist/internal/run-client.d.ts.map +1 -1
  881. package/dist/internal/run-client.js +4 -1
  882. package/dist/internal/sdk-runner.d.ts +2 -2
  883. package/dist/internal/sdk-runner.d.ts.map +1 -1
  884. package/dist/internal/sdk-runner.js +19 -16
  885. package/dist/internal/sdk-subagent-inherit-support.d.ts.map +1 -1
  886. package/dist/internal/sdk-subagent-inherit-support.js +3 -2
  887. package/dist/internal/serve-restart.d.ts +3 -0
  888. package/dist/internal/serve-restart.d.ts.map +1 -1
  889. package/dist/internal/serve-restart.js +8 -4
  890. package/dist/internal/server.d.ts +4 -0
  891. package/dist/internal/server.d.ts.map +1 -1
  892. package/dist/internal/server.js +71 -64
  893. package/dist/internal/session-cost.d.ts +4 -4
  894. package/dist/internal/session-cost.d.ts.map +1 -1
  895. package/dist/internal/session-cost.js +5 -5
  896. package/dist/internal/session-engine.d.ts +22 -8
  897. package/dist/internal/session-engine.d.ts.map +1 -1
  898. package/dist/internal/session-engine.js +170 -75
  899. package/dist/internal/session-links.js +2 -1
  900. package/dist/internal/session-live-publisher.d.ts +0 -7
  901. package/dist/internal/session-live-publisher.d.ts.map +1 -1
  902. package/dist/internal/session-live-publisher.js +20 -7
  903. package/dist/internal/session-run-log.d.ts.map +1 -1
  904. package/dist/internal/session-run-log.js +19 -5
  905. package/dist/internal/session-store.d.ts.map +1 -1
  906. package/dist/internal/session-store.js +17 -3
  907. package/dist/internal/sessions-client.d.ts +2 -0
  908. package/dist/internal/sessions-client.d.ts.map +1 -1
  909. package/dist/internal/sessions-client.js +44 -10
  910. package/dist/internal/shallow-clone.d.ts +258 -0
  911. package/dist/internal/shallow-clone.d.ts.map +1 -0
  912. package/dist/internal/shallow-clone.js +644 -0
  913. package/dist/internal/slack-bot-scopes.d.ts +3 -0
  914. package/dist/internal/slack-bot-scopes.d.ts.map +1 -0
  915. package/dist/internal/slack-bot-scopes.js +2 -0
  916. package/dist/internal/slack-manifest-opt-in.d.ts +26 -0
  917. package/dist/internal/slack-manifest-opt-in.d.ts.map +1 -0
  918. package/dist/internal/slack-manifest-opt-in.js +63 -0
  919. package/dist/internal/slack-provision-client.d.ts +8 -24
  920. package/dist/internal/slack-provision-client.d.ts.map +1 -1
  921. package/dist/internal/slack-provision-client.js +21 -20
  922. package/dist/internal/slack-thread-key.d.ts +8 -3
  923. package/dist/internal/slack-thread-key.d.ts.map +1 -1
  924. package/dist/internal/slack-thread-key.js +6 -6
  925. package/dist/internal/sqlite-experimental-warning.js +1 -1
  926. package/dist/internal/start-log-store.d.ts.map +1 -1
  927. package/dist/internal/start-log-store.js +2 -5
  928. package/dist/internal/storage-coordinator.d.ts.map +1 -1
  929. package/dist/internal/storage-coordinator.js +49 -20
  930. package/dist/internal/stored-eval-run.d.ts +17 -0
  931. package/dist/internal/stored-eval-run.d.ts.map +1 -0
  932. package/dist/internal/stored-eval-run.js +305 -0
  933. package/dist/internal/stream-progress.d.ts.map +1 -1
  934. package/dist/internal/stream-progress.js +1 -1
  935. package/dist/internal/tcp-address.d.ts +4 -0
  936. package/dist/internal/tcp-address.d.ts.map +1 -0
  937. package/dist/internal/tcp-address.js +8 -0
  938. package/dist/internal/terminal-style.js +2 -2
  939. package/dist/internal/testing/pagerduty-continuation-fixtures.d.ts +1 -1
  940. package/dist/internal/testing/pagerduty-continuation-fixtures.js +1 -1
  941. package/dist/internal/testing/scm-continuation-fixtures.d.ts +1 -1
  942. package/dist/internal/testing/scm-continuation-fixtures.js +1 -1
  943. package/dist/internal/testing/slack-continuation-fixtures.d.ts +12 -6
  944. package/dist/internal/testing/slack-continuation-fixtures.d.ts.map +1 -1
  945. package/dist/internal/testing/slack-continuation-fixtures.js +74 -3
  946. package/dist/internal/tool-call-retry.d.ts +35 -7
  947. package/dist/internal/tool-call-retry.d.ts.map +1 -1
  948. package/dist/internal/tool-call-retry.js +108 -108
  949. package/dist/internal/tool-catalog.d.ts.map +1 -1
  950. package/dist/internal/tool-catalog.js +7 -2
  951. package/dist/internal/tool-policy.d.ts +20 -7
  952. package/dist/internal/tool-policy.d.ts.map +1 -1
  953. package/dist/internal/tool-policy.js +39 -11
  954. package/dist/internal/tool-result.d.ts +0 -5
  955. package/dist/internal/tool-result.d.ts.map +1 -1
  956. package/dist/internal/tool-result.js +26 -6
  957. package/dist/internal/trajectory.d.ts.map +1 -1
  958. package/dist/internal/trajectory.js +5 -1
  959. package/dist/internal/turn-outbox.d.ts.map +1 -1
  960. package/dist/internal/turn-outbox.js +1 -0
  961. package/dist/internal/update-check.d.ts +2 -0
  962. package/dist/internal/update-check.d.ts.map +1 -1
  963. package/dist/internal/update-check.js +4 -0
  964. package/dist/internal/workspace.d.ts +3 -4
  965. package/dist/internal/workspace.d.ts.map +1 -1
  966. package/dist/internal/workspace.js +5 -5
  967. package/dist/kv/memory-kv.d.ts +1 -1
  968. package/dist/kv/memory-kv.js +1 -1
  969. package/dist/kv.d.ts +9 -2
  970. package/dist/kv.d.ts.map +1 -1
  971. package/dist/kv.js +10 -2
  972. package/dist/memory.d.ts +1 -1
  973. package/dist/memory.js +1 -1
  974. package/dist/otel-public.d.ts +2 -1
  975. package/dist/otel-public.d.ts.map +1 -1
  976. package/dist/otel-public.js +2 -1
  977. package/dist/otel.d.ts.map +1 -1
  978. package/dist/otel.js +6 -2
  979. package/dist/playground/assets/cursor-icons-16-QUmxS7q3.woff2 +0 -0
  980. package/dist/playground/assets/index-BMpVzZzC.css +1 -0
  981. package/dist/playground/assets/index-_3zz3yh8.js +62 -0
  982. package/dist/playground/index.html +2 -2
  983. package/dist/prompt.d.ts +1 -1
  984. package/dist/prompt.js +1 -1
  985. package/dist/public-deprecated.d.ts +11 -12
  986. package/dist/public-deprecated.d.ts.map +1 -1
  987. package/dist/public-deprecated.js +8 -9
  988. package/dist/reminders.d.ts +2 -2
  989. package/dist/reminders.js +2 -2
  990. package/dist/schedules.d.ts +1 -1
  991. package/dist/schedules.js +1 -1
  992. package/dist/scm.d.ts +2 -0
  993. package/dist/scm.d.ts.map +1 -0
  994. package/dist/scm.js +1 -0
  995. package/dist/skills.d.ts +1 -1
  996. package/dist/skills.js +1 -1
  997. package/dist/storage-backends/cursor-hosted.d.ts.map +1 -1
  998. package/dist/storage-backends/cursor-hosted.js +5 -3
  999. package/dist/storage-backends/file-kv.d.ts +3 -2
  1000. package/dist/storage-backends/file-kv.d.ts.map +1 -1
  1001. package/dist/storage-backends/file-kv.js +20 -8
  1002. package/dist/storage.d.ts +2 -3
  1003. package/dist/storage.d.ts.map +1 -1
  1004. package/dist/storage.js +9 -5
  1005. package/dist/telemetry.d.ts +12 -0
  1006. package/dist/telemetry.d.ts.map +1 -0
  1007. package/dist/telemetry.js +11 -0
  1008. package/dist/tools.d.ts +1 -1
  1009. package/dist/tools.d.ts.map +1 -1
  1010. package/dist/tools.js +2 -1
  1011. package/dist/types.d.ts +54 -41
  1012. package/dist/types.d.ts.map +1 -1
  1013. package/dist/types.js +4 -4
  1014. package/docs/README.md +16 -17
  1015. package/docs/building-with-agents.md +16 -16
  1016. package/docs/changelog.md +48 -12
  1017. package/docs/deployment.md +111 -49
  1018. package/docs/evals.md +11 -11
  1019. package/docs/guides/agent-to-agent.md +8 -8
  1020. package/docs/guides/bitbucket.md +5 -5
  1021. package/docs/guides/cloud-agents.md +4 -4
  1022. package/docs/guides/convert-automation.md +17 -16
  1023. package/docs/guides/github.md +16 -16
  1024. package/docs/guides/gitlab.md +5 -5
  1025. package/docs/guides/grokbot-agents.md +8 -14
  1026. package/docs/guides/hooks.md +3 -3
  1027. package/docs/guides/improve.md +2 -2
  1028. package/docs/guides/jev.md +10 -10
  1029. package/docs/guides/mcp-oauth.md +8 -8
  1030. package/docs/guides/migrate.md +35 -28
  1031. package/docs/guides/opentelemetry.md +61 -130
  1032. package/docs/guides/pagerduty.md +18 -18
  1033. package/docs/guides/slack.md +82 -11
  1034. package/docs/guides/webhooks.md +61 -3
  1035. package/docs/hillclimbing.md +2 -2
  1036. package/docs/quickstart.md +21 -21
  1037. package/docs/reference/access.md +27 -0
  1038. package/docs/reference/agent-config.md +54 -12
  1039. package/docs/reference/artifacts.md +2 -2
  1040. package/docs/reference/channels.md +29 -9
  1041. package/docs/reference/cli.md +364 -367
  1042. package/docs/reference/connections.md +9 -9
  1043. package/docs/reference/evals.md +13 -13
  1044. package/docs/reference/extensions.md +10 -10
  1045. package/docs/reference/hooks.md +11 -11
  1046. package/docs/reference/http-api.md +1 -1
  1047. package/docs/reference/instructions.md +1 -1
  1048. package/docs/reference/limits.md +42 -0
  1049. package/docs/reference/memory.md +7 -7
  1050. package/docs/reference/playground.md +1 -1
  1051. package/docs/reference/project-layout.md +6 -6
  1052. package/docs/reference/prompt.md +2 -2
  1053. package/docs/reference/schedules.md +4 -4
  1054. package/docs/reference/sessions.md +3 -3
  1055. package/docs/reference/skills.md +2 -2
  1056. package/docs/reference/subagents.md +1 -1
  1057. package/docs/reference/tools.md +31 -21
  1058. package/docs/templates/agentic-owners.md +7 -7
  1059. package/docs/templates/security-reviewer.md +6 -6
  1060. package/docs/templates/thermo-quality-review.md +7 -7
  1061. package/docs/templates/thermo-review.md +7 -7
  1062. package/docs/templates/triage.md +9 -9
  1063. package/docs/troubleshooting.md +24 -22
  1064. package/package.json +51 -92
  1065. package/scripts/install-cursor-skills.mjs +2 -2
  1066. package/skills/cli/SKILL.md +125 -0
  1067. package/skills/create-agent/SKILL.md +11 -9
  1068. package/skills/debug/SKILL.md +3 -3
  1069. package/skills/deploy/SKILL.md +46 -43
  1070. package/skills/evals/SKILL.md +7 -7
  1071. package/skills/framework-map/SKILL.md +8 -7
  1072. package/skills/github/SKILL.md +4 -4
  1073. package/skills/hillclimb/SKILL.md +3 -3
  1074. package/skills/migrate-v2/SKILL.md +50 -53
  1075. package/skills/otel/SKILL.md +36 -6
  1076. package/skills/setup-slack/SKILL.md +3 -3
  1077. package/templates/agentic-owners/README.md +1 -1
  1078. package/templates/agentic-owners/bot/agent.ts +1 -1
  1079. package/templates/agentic-owners/bot/channels/github.ts +1 -1
  1080. package/templates/agentic-owners/bot/lib/github.ts +2 -2
  1081. package/templates/agentic-owners/bot/lib/owners/parse.ts +1 -1
  1082. package/templates/agentic-owners/bot/lib/owners/policyMode.ts +6 -2
  1083. package/templates/agentic-owners/bot/lib/review.ts +7 -3
  1084. package/templates/agentic-owners/bot/tools/record_review.ts +2 -2
  1085. package/templates/agentic-owners/evals/evals.config.ts +1 -1
  1086. package/templates/agentic-owners/evals/owners.eval.ts +1 -1
  1087. package/templates/agentic-owners/package.json +2 -2
  1088. package/templates/agents-md/README.md +1 -1
  1089. package/templates/agents-md/bot/agent.ts +1 -1
  1090. package/templates/agents-md/bot/channels/github.ts +1 -1
  1091. package/templates/agents-md/bot/channels/queue.ts +5 -3
  1092. package/templates/agents-md/bot/channels/slack.ts +1 -1
  1093. package/templates/agents-md/bot/lib/collect.ts +1 -1
  1094. package/templates/agents-md/bot/schedules/weekly.ts +6 -6
  1095. package/templates/agents-md/bot/tools/apply_agents.ts +2 -2
  1096. package/templates/agents-md/evals/agents.eval.ts +1 -1
  1097. package/templates/agents-md/evals/evals.config.ts +1 -1
  1098. package/templates/agents-md/package.json +2 -2
  1099. package/templates/code-wiki/README.md +1 -1
  1100. package/templates/code-wiki/bot/agent.ts +1 -1
  1101. package/templates/code-wiki/bot/channels/github.ts +3 -3
  1102. package/templates/code-wiki/bot/tools/apply_wiki.ts +3 -3
  1103. package/templates/code-wiki/evals/evals.config.ts +1 -1
  1104. package/templates/code-wiki/evals/wiki.eval.ts +1 -1
  1105. package/templates/code-wiki/package.json +2 -2
  1106. package/templates/demo/README.md +1 -1
  1107. package/templates/demo/bot/agent.ts +1 -1
  1108. package/templates/demo/bot/channels/github.ts +7 -3
  1109. package/templates/demo/bot/channels/queue.ts +5 -5
  1110. package/templates/demo/bot/lib/collect.ts +2 -2
  1111. package/templates/demo/bot/tools/record_demo.ts +2 -2
  1112. package/templates/demo/evals/demo.eval.ts +1 -1
  1113. package/templates/demo/evals/evals.config.ts +1 -1
  1114. package/templates/demo/package.json +2 -2
  1115. package/templates/pr-autofixer/bot/agent.ts +1 -1
  1116. package/templates/pr-autofixer/bot/channels/drive.ts +1 -1
  1117. package/templates/pr-autofixer/bot/channels/github.ts +3 -3
  1118. package/templates/pr-autofixer/bot/channels/slack.ts +1 -1
  1119. package/templates/pr-autofixer/bot/hooks/bind-agent.ts +1 -1
  1120. package/templates/pr-autofixer/bot/lib/affinity.ts +1 -1
  1121. package/templates/pr-autofixer/bot/lib/drive.ts +2 -2
  1122. package/templates/pr-autofixer/bot/lib/merge-watch.ts +4 -4
  1123. package/templates/pr-autofixer/bot/lib/pr-state.ts +1 -1
  1124. package/templates/pr-autofixer/bot/lib/start-drive.ts +2 -2
  1125. package/templates/pr-autofixer/bot/lib/webhook-buffer.ts +1 -1
  1126. package/templates/pr-autofixer/bot/lib/webhook-routing.ts +1 -1
  1127. package/templates/pr-autofixer/bot/tools/drive_pr.ts +1 -1
  1128. package/templates/pr-autofixer/evals/coordinator.eval.ts +1 -1
  1129. package/templates/pr-autofixer/evals/evals.config.ts +1 -1
  1130. package/templates/pr-autofixer/package.json +2 -2
  1131. package/templates/security-help/.gitignore +4 -0
  1132. package/templates/security-help/README.md +1 -1
  1133. package/templates/security-help/bot/agent.ts +1 -1
  1134. package/templates/security-help/bot/channels/github.ts +1 -1
  1135. package/templates/security-help/bot/channels/slack.ts +1 -1
  1136. package/templates/security-help/bot/lib/pr-first-pass.ts +3 -3
  1137. package/templates/security-help/evals/evals.config.ts +1 -1
  1138. package/templates/security-help/evals/security-help.eval.ts +1 -1
  1139. package/templates/security-help/package.json +1 -1
  1140. package/templates/security-reviewer/README.md +1 -1
  1141. package/templates/security-reviewer/bot/agent.ts +1 -1
  1142. package/templates/security-reviewer/bot/channels/github.ts +2 -2
  1143. package/templates/security-reviewer/bot/tools/post_findings.ts +2 -2
  1144. package/templates/security-reviewer/evals/evals.config.ts +1 -1
  1145. package/templates/security-reviewer/evals/review.eval.ts +1 -1
  1146. package/templates/security-reviewer/package.json +2 -2
  1147. package/templates/thermo-quality-review/README.md +1 -1
  1148. package/templates/thermo-quality-review/bot/agent.ts +1 -1
  1149. package/templates/thermo-quality-review/bot/channels/github.ts +2 -2
  1150. package/templates/thermo-quality-review/bot/tools/post_findings.ts +2 -2
  1151. package/templates/thermo-quality-review/evals/evals.config.ts +1 -1
  1152. package/templates/thermo-quality-review/evals/review.eval.ts +1 -1
  1153. package/templates/thermo-quality-review/package.json +2 -2
  1154. package/templates/thermo-review/README.md +1 -1
  1155. package/templates/thermo-review/bot/agent.ts +1 -1
  1156. package/templates/thermo-review/bot/channels/github.ts +2 -2
  1157. package/templates/thermo-review/bot/tools/post_findings.ts +2 -2
  1158. package/templates/thermo-review/evals/evals.config.ts +1 -1
  1159. package/templates/thermo-review/evals/review.eval.ts +1 -1
  1160. package/templates/thermo-review/package.json +2 -2
  1161. package/templates/triage/README.md +2 -2
  1162. package/templates/triage/bot/agent.ts +1 -1
  1163. package/templates/triage/bot/channels/queue.ts +5 -5
  1164. package/templates/triage/bot/channels/webhook.ts +5 -5
  1165. package/templates/triage/bot/hooks/memory.ts +1 -1
  1166. package/templates/triage/bot/lib/actuate.ts +2 -2
  1167. package/templates/triage/bot/tools/record_triage.ts +1 -1
  1168. package/templates/triage/evals/evals.config.ts +1 -1
  1169. package/templates/triage/evals/triage.eval.ts +1 -1
  1170. package/templates/triage/overlays/jira/README.md +1 -1
  1171. package/templates/triage/overlays/jira/bot/mcp-connections/tracker.ts +1 -1
  1172. package/templates/triage/overlays/linear/README.md +1 -1
  1173. package/templates/triage/overlays/linear/bot/mcp-connections/tracker.ts +1 -1
  1174. package/templates/triage/package.json +2 -2
  1175. package/dist/bin/agent-sdk.js +0 -2
  1176. package/dist/docs/assets/building-with-agents.md.FZXrY8Nk.js +0 -9
  1177. package/dist/docs/assets/building-with-agents.md.FZXrY8Nk.lean.js +0 -1
  1178. package/dist/docs/assets/changelog.md.BvHRIiMH.js +0 -1
  1179. package/dist/docs/assets/changelog.md.BvHRIiMH.lean.js +0 -1
  1180. package/dist/docs/assets/chunks/@localSearchIndexroot.BoDEJQWv.js +0 -1
  1181. package/dist/docs/assets/chunks/channel.D2BTz0L-.js +0 -1
  1182. package/dist/docs/assets/chunks/classDiagram-6PBFFD2Q.DqByliAC.js +0 -1
  1183. package/dist/docs/assets/chunks/classDiagram-v2-HSJHXN6E.DqByliAC.js +0 -1
  1184. package/dist/docs/assets/chunks/clone.CldT1lbQ.js +0 -1
  1185. package/dist/docs/assets/chunks/stateDiagram-v2-QKLJ7IA2.Bb4oMe0P.js +0 -1
  1186. package/dist/docs/assets/deployment.md.3MMWuPeV.js +0 -31
  1187. package/dist/docs/assets/deployment.md.3MMWuPeV.lean.js +0 -1
  1188. package/dist/docs/assets/guides_agent-to-agent.md.CwL5cwuE.lean.js +0 -1
  1189. package/dist/docs/assets/guides_cloud-agents.md.BzbzcOyj.js +0 -9
  1190. package/dist/docs/assets/guides_cloud-agents.md.BzbzcOyj.lean.js +0 -1
  1191. package/dist/docs/assets/guides_convert-automation.md.DMEX9nF-.lean.js +0 -1
  1192. package/dist/docs/assets/guides_export-grokbot.md.qo5bxi4h.js +0 -55
  1193. package/dist/docs/assets/guides_export-grokbot.md.qo5bxi4h.lean.js +0 -1
  1194. package/dist/docs/assets/guides_grokbot-agents.md.BwAykJ7U.js +0 -15
  1195. package/dist/docs/assets/guides_migrate.md.CQlGaBKX.js +0 -7
  1196. package/dist/docs/assets/guides_migrate.md.CQlGaBKX.lean.js +0 -1
  1197. package/dist/docs/assets/guides_opentelemetry.md.D4wO7_8v.js +0 -37
  1198. package/dist/docs/assets/guides_opentelemetry.md.D4wO7_8v.lean.js +0 -1
  1199. package/dist/docs/assets/index.md.CAnsLl8D.js +0 -27
  1200. package/dist/docs/assets/index.md.CAnsLl8D.lean.js +0 -1
  1201. package/dist/docs/assets/quickstart.md.D8JDfkKO.lean.js +0 -1
  1202. package/dist/docs/assets/reference_channels.md.CNNIS6K7.js +0 -22
  1203. package/dist/docs/assets/reference_cli.md.1o_TqKdt.js +0 -103
  1204. package/dist/docs/assets/reference_cli.md.1o_TqKdt.lean.js +0 -1
  1205. package/dist/docs/assets/reference_memory.md.BwyJXYZe.js +0 -4
  1206. package/dist/docs/assets/reference_playground.md.q4MI-0td.js +0 -1
  1207. package/dist/docs/assets/templates_grokbot-agents.md.DgpPEs7B.js +0 -5
  1208. package/dist/docs/assets/templates_grokbot-agents.md.DgpPEs7B.lean.js +0 -1
  1209. package/dist/docs/assets/templates_security-reviewer.md.Gh6EF9Us.js +0 -3
  1210. package/dist/docs/assets/templates_thermo-quality-review.md.B77UyTrX.js +0 -3
  1211. package/dist/docs/assets/templates_thermo-review.md.DRJ7mC5U.js +0 -3
  1212. package/dist/docs/assets/troubleshooting.md.DFnoTDlQ.js +0 -1
  1213. package/dist/docs/guides/export-grokbot.html +0 -114
  1214. package/dist/docs/guides/export-grokbot.md +0 -239
  1215. package/dist/docs/templates/grokbot-agents.html +0 -64
  1216. package/dist/docs/templates/grokbot-agents.md +0 -55
  1217. package/dist/internal/cli-init-grokbot.d.ts +0 -29
  1218. package/dist/internal/cli-init-grokbot.d.ts.map +0 -1
  1219. package/dist/internal/cli-init-grokbot.js +0 -181
  1220. package/dist/internal/convert-grokbot/answers.d.ts +0 -127
  1221. package/dist/internal/convert-grokbot/answers.d.ts.map +0 -1
  1222. package/dist/internal/convert-grokbot/answers.js +0 -445
  1223. package/dist/internal/convert-grokbot/bot.d.ts +0 -50
  1224. package/dist/internal/convert-grokbot/bot.d.ts.map +0 -1
  1225. package/dist/internal/convert-grokbot/bot.js +0 -72
  1226. package/dist/internal/convert-grokbot/checks.d.ts +0 -26
  1227. package/dist/internal/convert-grokbot/checks.d.ts.map +0 -1
  1228. package/dist/internal/convert-grokbot/checks.js +0 -170
  1229. package/dist/internal/convert-grokbot/convert.d.ts +0 -60
  1230. package/dist/internal/convert-grokbot/convert.d.ts.map +0 -1
  1231. package/dist/internal/convert-grokbot/convert.js +0 -470
  1232. package/dist/internal/convert-grokbot/handoff.d.ts +0 -44
  1233. package/dist/internal/convert-grokbot/handoff.d.ts.map +0 -1
  1234. package/dist/internal/convert-grokbot/handoff.js +0 -160
  1235. package/dist/internal/convert-grokbot/recipe.d.ts +0 -61
  1236. package/dist/internal/convert-grokbot/recipe.d.ts.map +0 -1
  1237. package/dist/internal/convert-grokbot/recipe.js +0 -94
  1238. package/dist/internal/convert-grokbot/routine.d.ts +0 -51
  1239. package/dist/internal/convert-grokbot/routine.d.ts.map +0 -1
  1240. package/dist/internal/convert-grokbot/routine.js +0 -128
  1241. package/dist/internal/convert-grokbot/slack.d.ts +0 -28
  1242. package/dist/internal/convert-grokbot/slack.d.ts.map +0 -1
  1243. package/dist/internal/convert-grokbot/slack.js +0 -50
  1244. package/dist/internal/factory-resource-channel.d.ts.map +0 -1
  1245. package/dist/internal/legacy-command-guard.d.ts +0 -24
  1246. package/dist/internal/legacy-command-guard.d.ts.map +0 -1
  1247. package/dist/internal/legacy-command-guard.js +0 -47
  1248. package/dist/internal/runtime-dispatch-runner.d.ts +0 -25
  1249. package/dist/internal/runtime-dispatch-runner.d.ts.map +0 -1
  1250. package/dist/internal/runtime-dispatch-runner.js +0 -35
  1251. package/dist/internal/testing/factory-resource-fixtures.d.ts +0 -64
  1252. package/dist/internal/testing/factory-resource-fixtures.d.ts.map +0 -1
  1253. package/dist/internal/testing/factory-resource-fixtures.js +0 -55
  1254. package/dist/playground/assets/cursor-icons-16-DfKNljMZ.woff2 +0 -0
  1255. package/dist/playground/assets/index-B3_YohwW.js +0 -62
  1256. package/dist/playground/assets/index-Cn3-adsJ.css +0 -1
  1257. package/docs/guides/export-grokbot.md +0 -244
  1258. package/docs/templates/grokbot-agents.md +0 -60
  1259. package/schemas/grokbot-answers.schema.json +0 -354
  1260. package/templates/grokbot-agents/README.md +0 -27
  1261. package/templates/grokbot-agents/bot/agent.ts +0 -6
  1262. package/templates/grokbot-agents/bot/extensions/grokbot.ts +0 -5
  1263. package/templates/grokbot-agents/bot/instructions.md +0 -7
  1264. package/templates/grokbot-agents/evals/evals.config.ts +0 -5
  1265. package/templates/grokbot-agents/evals/grokbot-agents.eval.ts +0 -18
  1266. package/templates/grokbot-agents/init.json +0 -18
  1267. package/templates/grokbot-agents/package.json +0 -17
  1268. package/templates/grokbot-agents/tsconfig.json +0 -12
  1269. /package/dist/docs/assets/{evals.md.CHR34K1Y.lean.js → evals.md.OjKb7tNA.lean.js} +0 -0
  1270. /package/dist/docs/assets/{guides_bitbucket.md.CKUayYtD.lean.js → guides_bitbucket.md.DkjkBRU8.lean.js} +0 -0
  1271. /package/dist/docs/assets/{guides_gitlab.md.CtNI4fSH.lean.js → guides_gitlab.md.DCE0p7_w.lean.js} +0 -0
  1272. /package/dist/docs/assets/{guides_jev.md.D7XH4JH3.lean.js → guides_jev.md.Ccw4pedT.lean.js} +0 -0
  1273. /package/dist/docs/assets/{guides_pagerduty.md.BHXMcMtx.lean.js → guides_pagerduty.md.mnKXe9U0.lean.js} +0 -0
  1274. /package/dist/docs/assets/{hillclimbing.md.Dxvd-0gT.lean.js → hillclimbing.md.By61f3uq.lean.js} +0 -0
  1275. /package/dist/docs/assets/{reference_artifacts.md.DLV9MZES.lean.js → reference_artifacts.md.C-hKR2hp.lean.js} +0 -0
  1276. /package/dist/docs/assets/{reference_connections.md.BJE2Zllp.lean.js → reference_connections.md.BoAotr7_.lean.js} +0 -0
  1277. /package/dist/docs/assets/{reference_evals.md.Ccwp4x3o.lean.js → reference_evals.md.DYKjGFi-.lean.js} +0 -0
  1278. /package/dist/docs/assets/{reference_hooks.md.CROr0QgC.lean.js → reference_hooks.md.B-bwJuiG.lean.js} +0 -0
  1279. /package/dist/docs/assets/{reference_http-api.md.Dji-DD_Z.lean.js → reference_http-api.md._RWELr3d.lean.js} +0 -0
  1280. /package/dist/docs/assets/{reference_instructions.md.BYMVxAkw.lean.js → reference_instructions.md.yL2hXLnl.lean.js} +0 -0
  1281. /package/dist/docs/assets/{reference_memory.md.BwyJXYZe.lean.js → reference_memory.md.Dd7cyV9V.lean.js} +0 -0
  1282. /package/dist/docs/assets/{reference_playground.md.q4MI-0td.lean.js → reference_playground.md.CQiJk9CM.lean.js} +0 -0
  1283. /package/dist/docs/assets/{reference_project-layout.md.mFcS8yDD.lean.js → reference_project-layout.md.BamcPDUn.lean.js} +0 -0
  1284. /package/dist/docs/assets/{reference_prompt.md.DqPh71XN.lean.js → reference_prompt.md.BMjm1Jp3.lean.js} +0 -0
  1285. /package/dist/docs/assets/{reference_schedules.md.BqWnJES4.lean.js → reference_schedules.md.RC47aFm4.lean.js} +0 -0
  1286. /package/dist/docs/assets/{reference_sessions.md.Bi6lHttM.lean.js → reference_sessions.md.C7KFhWXV.lean.js} +0 -0
  1287. /package/dist/docs/assets/{reference_subagents.md.ChNGh6HK.lean.js → reference_subagents.md.CAhvW4yS.lean.js} +0 -0
  1288. /package/dist/docs/assets/{templates_agentic-owners.md.CTEnR0jp.lean.js → templates_agentic-owners.md.Dh2nDSqg.lean.js} +0 -0
  1289. /package/dist/docs/assets/{templates_security-reviewer.md.Gh6EF9Us.lean.js → templates_security-reviewer.md.DnwXdnB5.lean.js} +0 -0
  1290. /package/dist/docs/assets/{templates_triage.md.CNN6b0JZ.lean.js → templates_triage.md.BYWMloV4.lean.js} +0 -0
  1291. /package/dist/docs/assets/{troubleshooting.md.DFnoTDlQ.lean.js → troubleshooting.md.AGJ3jDzj.lean.js} +0 -0
@@ -12,26 +12,33 @@ import { Artifacts, JUnit } from "../evals/reporters.js";
12
12
  import { serve } from "../index.js";
13
13
  import { lookupSessionContinuation, runChat } from "./chat-client.js";
14
14
  import { ensureCursorLogin } from "./cli-cursor.js";
15
- import { resolveDeployAuth } from "./cli-deploy.js";
15
+ import { apiError, resolveDeployAuth } from "./cli-deploy.js";
16
16
  import { resolveApiKey } from "./cursor/credentials.js";
17
17
  import { DeployApiError, } from "./deploy-client.js";
18
+ import { CliError, CliUsageError, errorCodeForStatus } from "./cli/errors.js";
19
+ import { DEFAULT_LIST_LIMIT, nextPageHint, pageLocally, printJson, printListJson, projectFields, } from "./cli/output.js";
18
20
  import { CLI_COMMAND_NAME, PACKAGE_NAME } from "./distribution.js";
21
+ import { dryRunActive, stopIfDryRun } from "./dry-run.js";
22
+ import { isValidDuration, parseDuration } from "./duration.js";
19
23
  import { discoverEvals, filterDiscoveredEvals, runDiscoveredEvals, } from "./eval-runner.js";
20
24
  import { cancelRemoteEvalRun, getRemoteEvalRun, listRemoteEvalRuns, listRemoteEvals, pollRemoteEvalRun, RemoteEvalError, snapshotToEvalRunResults, startRemoteEvalRun, } from "./evals-client.js";
21
25
  import { runTemplateInit } from "./init-interview.js";
22
26
  import { checkInitTarget, formatInitNextSteps, formatInitScaffoldSummary, initNextCommands, initProject, installScaffoldDependencies, linkCliOntoPath, printInitGuide, resolveTemplate, } from "./init-project.js";
23
27
  import { offerInstallCursorSkills } from "./install-cursor-skills.js";
24
- import { deploymentArchitecture, v2HostedVerifyHint } from "./legacy-command-guard.js";
28
+ import { prodNotSupportedMessage, v2HostedVerifyHint } from "./hosted-hints.js";
29
+ import { createHostedProdLogReader, readHostedSessionView } from "./hosted-session-view.js";
25
30
  import { followHostedLogs, runLogsTail, sanitizeCustomerError } from "./logs-client.js";
26
31
  import { mapPool } from "./map-pool.js";
27
32
  import { openBrowser } from "./open-browser.js";
28
33
  import { startPlaygroundProxy } from "./playground-proxy.js";
29
- import { resolveProdPlaygroundUrl, resolveProdSlug, resolveProdTarget, } from "./resolve-prod-target.js";
34
+ import { prodPlaygroundUrl, resolveProdSlug, trimNonEmpty } from "./resolve-prod-target.js";
30
35
  import { runSession } from "./run-client.js";
36
+ import { sleep } from "./sleep.js";
31
37
  import { buildSessionCostReport, formatSessionCostText, formatSessionsCostText, } from "./session-cost.js";
32
- import { fetchSessionCost, fetchSessionEvents, formatSessionsTable, listSessionsWithSource, resolvePreviousSessionId, } from "./sessions-client.js";
38
+ import { fetchSessionCost, fetchSessionEvents, formatHostedSessionsTable, formatSessionsTable, listSessionsWithSource, resolvePreviousSessionId, } from "./sessions-client.js";
33
39
  import { createStreamProgress } from "./stream-progress.js";
34
40
  import { buildTrajectory, formatTrajectoryText, loadTrajectoryFromEventsFile, } from "./trajectory.js";
41
+ import { isRecord } from "./is-record.js";
35
42
  function shouldStreamProgress(options) {
36
43
  if (options.stream === false) {
37
44
  return false;
@@ -39,22 +46,27 @@ function shouldStreamProgress(options) {
39
46
  if (options.stream === true) {
40
47
  return true;
41
48
  }
42
- return process.stderr.isTTY === true;
49
+ return process.stderr.isTTY;
43
50
  }
44
- function die(message) {
45
- process.stderr.write(`${message}\n`);
46
- process.exit(1);
51
+ /** A usage problem: the dispatcher prints it (text or JSON) and exits 2. */
52
+ function usage(message) {
53
+ throw new CliUsageError(message);
54
+ }
55
+ /** Usage error for a local command that got `--prod`. */
56
+ function rejectProd(command) {
57
+ process.stderr.write(`${prodNotSupportedMessage(command)}\n`);
58
+ return 2;
47
59
  }
48
60
  function pickAgentUrl(handle, slug) {
49
61
  if (handle.agents.length === 0) {
50
- die("No agents discovered.");
62
+ throw new CliError("No agents discovered.", { code: "not_found" });
51
63
  }
52
64
  if (slug !== undefined && slug !== "") {
53
65
  const match = handle.agents.find((a) => a.slug === slug);
54
66
  if (match === undefined) {
55
- die(`Unknown agent slug "${slug}". Available: ${handle.agents
67
+ throw new CliError(`Unknown agent slug "${slug}". Available: ${handle.agents
56
68
  .map((a) => a.slug || "(root)")
57
- .join(", ")}`);
69
+ .join(", ")}`, { code: "not_found" });
58
70
  }
59
71
  return match.url;
60
72
  }
@@ -89,24 +101,11 @@ async function startEphemeral(options, evals = false) {
89
101
  },
90
102
  };
91
103
  }
104
+ /** A running server (`--url`) or an ephemeral local one. */
92
105
  export async function resolveTarget(options) {
93
- if (options.prod === true && options.url !== undefined) {
94
- die("--prod and --url are mutually exclusive");
95
- }
96
106
  if (options.url !== undefined) {
97
107
  return { agentUrl: options.url.replace(/\/$/, "") };
98
108
  }
99
- if (options.prod === true) {
100
- const prod = await resolveProdTarget({
101
- dir: options.dir,
102
- cwd: options.cwd,
103
- slug: options.slug,
104
- team: options.team,
105
- apiKey: options.apiKey,
106
- fetchImpl: options.fetchImpl,
107
- });
108
- return { agentUrl: prod.agentUrl, headers: prod.headers };
109
- }
110
109
  return startEphemeral(options);
111
110
  }
112
111
  export async function cmdInit(options) {
@@ -141,7 +140,7 @@ export async function cmdInit(options) {
141
140
  const interview = await runTemplateInit({
142
141
  templateDir,
143
142
  vars: options.vars,
144
- interactive: options.json !== true && process.stdin.isTTY === true && process.stdout.isTTY === true,
143
+ interactive: options.json !== true && process.stdin.isTTY && process.stdout.isTTY,
145
144
  });
146
145
  if (!interview.ok) {
147
146
  process.stderr.write(`${interview.error}\n`);
@@ -157,7 +156,21 @@ export async function cmdInit(options) {
157
156
  templateName,
158
157
  answers,
159
158
  initSpec,
159
+ dryRun: options.dryRun,
160
160
  });
161
+ if (options.dryRun === true) {
162
+ if (options.json === true) {
163
+ process.stdout.write(`${JSON.stringify({ dryRun: true, directory: result.rootDir, files: result.files }, null, 2)}\n`);
164
+ }
165
+ else {
166
+ process.stdout.write(`Dry run: would scaffold ${result.rootDir}, then run npm install.\n` +
167
+ result.files
168
+ .map((file) => ` ${file.action === "create" ? "create" : "keep "} ${file.path}\n`)
169
+ .join("") +
170
+ "Nothing was written.\n");
171
+ }
172
+ return 0;
173
+ }
161
174
  let signedIn = (await resolveApiKey()) !== undefined;
162
175
  // Machine-readable path: install deps (piped), never block on browser login.
163
176
  if (options.json) {
@@ -241,11 +254,14 @@ export async function cmdInit(options) {
241
254
  * session. When the id is omitted, picks the most recently updated
242
255
  * followable session from `/v1/sessions` (same as `chat --resume`).
243
256
  * Looks up the continuation token via `/v1/sessions` when
244
- * `--continuation-token` is omitted. Same flags as `chat` (`--prod`,
245
- * `--message`, `--json`, …). `--session` is accepted as a redundant
246
- * alias for the positional id.
257
+ * `--continuation-token` is omitted. Same flags as `chat` (`--message`,
258
+ * `--json`, …). `--session` is accepted as a redundant alias for the
259
+ * positional id.
247
260
  */
248
261
  export async function cmdResume(sessionId, options) {
262
+ if (options.prod === true) {
263
+ return rejectProd("resume");
264
+ }
249
265
  const resolved = trimNonEmpty(sessionId) ?? trimNonEmpty(options.sessionId);
250
266
  if (resolved !== undefined) {
251
267
  return cmdChat({
@@ -260,23 +276,19 @@ export async function cmdResume(sessionId, options) {
260
276
  resume: true,
261
277
  });
262
278
  }
263
- function trimNonEmpty(value) {
264
- if (value === undefined) {
265
- return undefined;
266
- }
267
- const trimmed = value.trim();
268
- return trimmed === "" ? undefined : trimmed;
269
- }
270
279
  /**
271
- * `chat` — talk to a running (or `--prod` hosted) agent. With `--json`,
272
- * prints a trajectory instead of the interactive UI.
280
+ * `chat` — talk to a running agent. With `--json`, prints a trajectory
281
+ * instead of the interactive UI.
273
282
  */
274
283
  export async function cmdChat(options) {
284
+ if (options.prod === true) {
285
+ return rejectProd("chat");
286
+ }
275
287
  const message = options.messages?.[0];
276
288
  // chat never starts an ephemeral server — default to local serve URL.
277
289
  const target = await resolveTarget({
278
290
  ...options,
279
- url: options.prod === true ? undefined : (options.url ?? "http://127.0.0.1:3000"),
291
+ url: options.url ?? "http://127.0.0.1:3000",
280
292
  });
281
293
  let sessionId = trimNonEmpty(options.sessionId);
282
294
  // `--resume` without an id → most recently updated followable session.
@@ -287,7 +299,6 @@ export async function cmdChat(options) {
287
299
  baseUrl: target.agentUrl,
288
300
  auth: {
289
301
  bearerToken: options.bearerToken,
290
- headers: target.headers,
291
302
  },
292
303
  fetchImpl: options.fetchImpl,
293
304
  });
@@ -316,7 +327,6 @@ export async function cmdChat(options) {
316
327
  sessionId,
317
328
  auth: {
318
329
  bearerToken: options.bearerToken,
319
- headers: target.headers,
320
330
  },
321
331
  });
322
332
  }
@@ -331,7 +341,6 @@ export async function cmdChat(options) {
331
341
  sessionId,
332
342
  continuationToken,
333
343
  bearerToken: options.bearerToken,
334
- headers: target.headers,
335
344
  });
336
345
  if (options.text) {
337
346
  process.stdout.write(formatTrajectoryText(result.trajectory));
@@ -353,7 +362,6 @@ export async function cmdChat(options) {
353
362
  sessionId,
354
363
  continuationToken: options.continuationToken,
355
364
  bearerToken: options.bearerToken,
356
- headers: target.headers,
357
365
  noColor: options.noColor,
358
366
  });
359
367
  return 0;
@@ -366,18 +374,12 @@ export async function cmdChat(options) {
366
374
  /** Covers the server's billed lookup plus its catalog retry; `run` reports no cost past it. */
367
375
  const RUN_SESSION_COST_TIMEOUT_MS = 15_000;
368
376
  export async function cmdRun(options) {
369
- // Only a v2-shaped request tries the control plane; every v1 `run --prod`
370
- // form (multi-turn, continuation token, local session id, --url) keeps its
371
- // engine-alias path untouched.
372
- if (options.prod === true && hostedSessionRejection(options) === undefined) {
373
- const started = await cmdHostedSession(options);
374
- if (started !== "fallback") {
375
- return started;
376
- }
377
+ if (options.prod === true) {
378
+ return cmdHostedSession(options);
377
379
  }
378
380
  const messages = options.messages ?? [];
379
381
  if (messages.length === 0) {
380
- die("Provide --message (repeatable) or --messages-file");
382
+ usage("Provide --message (repeatable) or --messages-file");
381
383
  }
382
384
  const stream = shouldStreamProgress(options);
383
385
  const progress = stream ? createStreamProgress() : undefined;
@@ -392,20 +394,17 @@ export async function cmdRun(options) {
392
394
  sessionId: options.sessionId,
393
395
  continuationToken: options.continuationToken,
394
396
  bearerToken: options.bearerToken,
395
- headers: target.headers,
396
397
  timeoutMs: options.timeoutMs,
397
398
  onEvent: progress === undefined ? undefined : (e) => progress.onEvent(e),
398
399
  });
399
- if (options.prod !== true) {
400
- const cost = await fetchSessionCost({
401
- baseUrl: target.agentUrl,
402
- sessionId: result.sessionId,
403
- auth: { bearerToken: options.bearerToken, headers: target.headers },
404
- signal: AbortSignal.timeout(RUN_SESSION_COST_TIMEOUT_MS),
405
- });
406
- if (cost !== undefined) {
407
- result.trajectory.totalCostUsd = cost.costUsd;
408
- }
400
+ const cost = await fetchSessionCost({
401
+ baseUrl: target.agentUrl,
402
+ sessionId: result.sessionId,
403
+ auth: { bearerToken: options.bearerToken },
404
+ signal: AbortSignal.timeout(RUN_SESSION_COST_TIMEOUT_MS),
405
+ });
406
+ if (cost !== undefined) {
407
+ result.trajectory.totalCostUsd = cost.costUsd;
409
408
  }
410
409
  let eventsPath;
411
410
  const writeEvents = options.events !== false;
@@ -421,37 +420,18 @@ export async function cmdRun(options) {
421
420
  }
422
421
  await writeFile(eventsPath, `${result.events.map((e) => JSON.stringify(e)).join("\n")}\n`, "utf8");
423
422
  }
424
- const playgroundUrl = options.prod === true
425
- ? null
426
- : options.url !== undefined
427
- ? `${target.agentUrl.replace(/\/$/, "")}/playground?sessionId=${encodeURIComponent(result.sessionId)}`
428
- : null;
429
- const playgroundHint = options.prod === true
430
- ? [
431
- CLI_COMMAND_NAME,
432
- "playground",
433
- "--prod",
434
- ...(options.slug !== undefined && options.slug.trim() !== ""
435
- ? ["--slug", options.slug.trim()]
436
- : []),
437
- ...(options.team !== undefined && options.team.trim() !== ""
438
- ? ["--team", options.team.trim()]
439
- : []),
440
- "--session",
441
- result.sessionId,
442
- ].join(" ")
423
+ const playgroundUrl = options.url !== undefined
424
+ ? `${target.agentUrl.replace(/\/$/, "")}/playground?sessionId=${encodeURIComponent(result.sessionId)}`
443
425
  : null;
444
- if (options.text) {
426
+ if (options.json !== true) {
445
427
  process.stdout.write(formatTrajectoryText(result.trajectory));
428
+ process.stderr.write(`\nsession: ${result.sessionId}\n`);
446
429
  if (eventsPath !== undefined) {
447
- process.stderr.write(`\ntrace: ${eventsPath}\n`);
430
+ process.stderr.write(`trace: ${eventsPath}\n`);
448
431
  }
449
432
  if (playgroundUrl !== null) {
450
433
  process.stderr.write(`playground: ${playgroundUrl}\n`);
451
434
  }
452
- else if (playgroundHint !== null) {
453
- process.stderr.write(`playground: ${playgroundHint}\n`);
454
- }
455
435
  }
456
436
  else {
457
437
  console.log(JSON.stringify({
@@ -460,14 +440,11 @@ export async function cmdRun(options) {
460
440
  continuationToken: result.continuationToken ?? null,
461
441
  trace: eventsPath ?? null,
462
442
  playgroundUrl,
463
- playgroundHint,
464
- visualize: playgroundHint !== null
465
- ? `Run ${playgroundHint}`
466
- : playgroundUrl !== null
467
- ? `Open ${playgroundUrl}`
468
- : eventsPath !== undefined
469
- ? `${CLI_COMMAND_NAME} trajectory --events ${eventsPath}`
470
- : null,
443
+ visualize: playgroundUrl !== null
444
+ ? `Open ${playgroundUrl}`
445
+ : eventsPath !== undefined
446
+ ? `${CLI_COMMAND_NAME} session get --file ${eventsPath}`
447
+ : null,
471
448
  trajectory: result.trajectory,
472
449
  }, null, 2));
473
450
  }
@@ -481,13 +458,6 @@ export async function cmdRun(options) {
481
458
  }
482
459
  }
483
460
  const HOSTED_SESSION_ID_RE = /^ses_[a-f0-9]{24}$/;
484
- /**
485
- * Hosted v2 session start: POST the agentsdk control plane, which hands the
486
- * wake to Temporal (no resident engine, no `/engine/*` alias). `--session
487
- * ses_…` resumes that exact session; there is no continuation token on
488
- * this path. A 404 means the slug is not a v2 control-plane deployment, so
489
- * `run --prod` falls back to the v1 engine alias.
490
- */
491
461
  /** Why these options cannot be a hosted v2 session start, if they cannot. */
492
462
  function hostedSessionRejection(options) {
493
463
  if (options.url !== undefined) {
@@ -506,10 +476,16 @@ function hostedSessionRejection(options) {
506
476
  }
507
477
  return undefined;
508
478
  }
479
+ /**
480
+ * Hosted v2 session start: POST the agentsdk control plane, which hands the
481
+ * wake to Temporal (no resident engine). `--session ses_…` resumes that
482
+ * exact session; there is no continuation token on this path.
483
+ */
509
484
  async function cmdHostedSession(options) {
510
485
  const rejection = hostedSessionRejection(options);
511
486
  if (rejection !== undefined) {
512
- die(rejection);
487
+ process.stderr.write(`${rejection}\n`);
488
+ return 2;
513
489
  }
514
490
  const messages = options.messages ?? [];
515
491
  const sessionId = trimNonEmpty(options.sessionId);
@@ -522,46 +498,101 @@ async function cmdHostedSession(options) {
522
498
  return auth;
523
499
  }
524
500
  const slug = resolveProdSlug(options);
501
+ let accepted;
525
502
  try {
526
- const accepted = await auth.client.startSession({
503
+ accepted = await auth.client.startSession({
527
504
  teamId: auth.teamId,
528
505
  slug,
529
506
  message: messages[0].trim(),
530
507
  sessionId,
531
- dryRun: options.dryRun,
508
+ dryRun: options.readOnly,
532
509
  asOf: options.asOf,
533
510
  componentKey: trimNonEmpty(options.componentKey),
534
511
  });
535
- console.log(JSON.stringify(accepted, null, 2));
536
- if (accepted.sessionId === undefined) {
537
- process.stderr.write(`${v2HostedVerifyHint(slug)}\n`);
538
- }
539
- return 0;
540
512
  }
541
513
  catch (error) {
542
- if (error instanceof DeployApiError && error.status === 404) {
543
- return "fallback";
514
+ throw apiError(error);
515
+ }
516
+ const sessionIdNow = options.wait === true && accepted.sessionId === undefined
517
+ ? await waitForHostedSession(auth, slug, accepted.deliveryId, options.timeoutMs)
518
+ : accepted.sessionId;
519
+ const result = { ...accepted, sessionId: sessionIdNow };
520
+ if (options.json === true) {
521
+ console.log(JSON.stringify(result, null, 2));
522
+ }
523
+ else {
524
+ process.stdout.write([
525
+ `accepted: delivery ${result.deliveryId}`,
526
+ ` session: ${result.sessionId ?? "(allocated later)"}`,
527
+ ` mode: ${result.sessionMode}${result.dryRun === true ? " (read-only)" : ""}`,
528
+ "",
529
+ ].join("\n"));
530
+ }
531
+ if (result.sessionId === undefined) {
532
+ process.stderr.write(`${v2HostedVerifyHint(slug)}\n`);
533
+ }
534
+ else {
535
+ process.stderr.write(`Read it: \`${CLI_COMMAND_NAME} session get ${result.sessionId} --prod --slug ${slug}\`\n`);
536
+ }
537
+ return 0;
538
+ }
539
+ const HOSTED_SESSION_WAIT_DEFAULT_MS = 120_000;
540
+ const HOSTED_SESSION_POLL_MS = 1_000;
541
+ /**
542
+ * Poll a session start's delivery until it names a session. Skipped and
543
+ * failed deliveries never get one, so they fail at once; a slow one ends
544
+ * `pending` (exit 3) with the delivery id to poll again.
545
+ */
546
+ async function waitForHostedSession(auth, slug, deliveryId, timeoutMs = HOSTED_SESSION_WAIT_DEFAULT_MS) {
547
+ const deadline = Date.now() + timeoutMs;
548
+ for (;;) {
549
+ let delivery;
550
+ try {
551
+ delivery = await auth.client.getAgentkitSessionDelivery({
552
+ teamId: auth.teamId,
553
+ slug,
554
+ deliveryId,
555
+ });
544
556
  }
545
- process.stderr.write(`${error instanceof Error ? error.message : String(error)}\n`);
546
- return 1;
557
+ catch (error) {
558
+ throw apiError(error);
559
+ }
560
+ if (delivery.status === "allocated") {
561
+ return delivery.sessionId;
562
+ }
563
+ if (delivery.status === "skipped" || delivery.status === "failed") {
564
+ throw new CliError(`Delivery ${deliveryId} was ${delivery.status}; it reached no session.`);
565
+ }
566
+ if (Date.now() + HOSTED_SESSION_POLL_MS > deadline) {
567
+ throw new CliError(`Delivery ${deliveryId} has no session yet.`, {
568
+ code: "pending",
569
+ hint: `Run the same command again with a longer --timeout-ms, or list the deployment's sessions with \`${CLI_COMMAND_NAME} session list --prod\`.`,
570
+ details: { deliveryId },
571
+ });
572
+ }
573
+ await sleep(HOSTED_SESSION_POLL_MS);
547
574
  }
548
575
  }
549
576
  /**
550
- * Shared deterministic-route fetch (`call`, `skill`): engine headers,
577
+ * Shared deterministic-route fetch (`call`, `skill`):
551
578
  * bearer auth, and JSON. The payload is `undefined` when the body does
552
579
  * not decode; callers print `invalid_response` and fail.
553
580
  */
554
581
  async function fetchAgentJson(target, path, args = {}) {
555
582
  const headers = {};
556
- if (target.headers !== undefined) {
557
- Object.assign(headers, target.headers);
558
- }
559
583
  if (args.body !== undefined) {
560
584
  headers["content-type"] = "application/json";
561
585
  }
562
586
  if (args.bearerToken !== undefined) {
563
587
  headers.authorization = `Bearer ${args.bearerToken}`;
564
588
  }
589
+ if (dryRunActive()) {
590
+ stopIfDryRun({
591
+ method: args.method ?? "GET",
592
+ path: `${target.agentUrl}${path}`,
593
+ body: args.body === undefined ? undefined : JSON.parse(args.body),
594
+ });
595
+ }
565
596
  const response = await fetch(`${target.agentUrl}${path}`, {
566
597
  method: args.method,
567
598
  headers,
@@ -570,17 +601,39 @@ async function fetchAgentJson(target, path, args = {}) {
570
601
  const payload = await response.json().catch(() => undefined);
571
602
  return { response, payload };
572
603
  }
573
- function printInvalidResponse() {
574
- console.log(JSON.stringify({ ok: false, error: "invalid_response" }, null, 2));
604
+ /** The `message` or `errorMessage` of an agent server's JSON error body. */
605
+ function agentErrorMessage(payload) {
606
+ if (payload === null || typeof payload !== "object") {
607
+ return undefined;
608
+ }
609
+ const { message, errorMessage } = payload;
610
+ if (typeof errorMessage === "string" && errorMessage !== "") {
611
+ return errorMessage;
612
+ }
613
+ return typeof message === "string" && message !== "" ? message : undefined;
614
+ }
615
+ /** A tool result as text: a string as is, anything else as pretty JSON. */
616
+ function formatResultText(result) {
617
+ const text = typeof result === "string" ? result : JSON.stringify(result ?? null, null, 2);
618
+ return text.endsWith("\n") ? text : `${text}\n`;
619
+ }
620
+ /** The agent server answered with a body that is not JSON. */
621
+ function invalidResponse(path, status) {
622
+ return new CliError(`The agent server returned a non-JSON response to ${path} (HTTP ${status}).`, {
623
+ code: "unavailable",
624
+ });
575
625
  }
576
626
  /**
577
627
  * `agent-sdk call <tool>` — deterministic tool invocation over
578
628
  * `POST /v1/tools/:toolName` (ephemeral local server unless --url).
579
629
  */
580
630
  export async function cmdCall(options) {
631
+ if (options.prod === true) {
632
+ return rejectProd("call");
633
+ }
581
634
  const toolName = options.toolName;
582
635
  if (toolName === undefined || toolName === "") {
583
- die(`Provide a tool name: ${CLI_COMMAND_NAME} call <tool> [--input '{...}']`);
636
+ usage(`Provide a tool name: ${CLI_COMMAND_NAME} tool call <tool> [--input '{...}']`);
584
637
  }
585
638
  let input = {};
586
639
  if (options.toolInput !== undefined) {
@@ -588,7 +641,7 @@ export async function cmdCall(options) {
588
641
  input = JSON.parse(options.toolInput);
589
642
  }
590
643
  catch (error) {
591
- die(`--input must be valid JSON: ${error instanceof Error ? error.message : String(error)}`);
644
+ usage(`--input must be valid JSON: ${error instanceof Error ? error.message : String(error)}`);
592
645
  }
593
646
  }
594
647
  let target;
@@ -596,6 +649,10 @@ export async function cmdCall(options) {
596
649
  target = await resolveTarget(options);
597
650
  }
598
651
  catch (error) {
652
+ // A typed error (such as `not_found` from discovery) keeps its exit code.
653
+ if (error instanceof CliError) {
654
+ throw error;
655
+ }
599
656
  process.stderr.write(`${sanitizeCustomerError(error instanceof Error ? error.message : String(error))}\n`);
600
657
  return 1;
601
658
  }
@@ -610,15 +667,23 @@ export async function cmdCall(options) {
610
667
  bearerToken: options.bearerToken,
611
668
  });
612
669
  if (payload === undefined) {
613
- printInvalidResponse();
614
- return 1;
670
+ throw invalidResponse(`/v1/tools/${toolName}`, response.status);
615
671
  }
616
- console.log(JSON.stringify(payload, null, 2));
617
672
  const ok = response.ok &&
618
673
  typeof payload === "object" &&
619
674
  payload !== null &&
620
675
  payload.ok === true;
621
- return ok ? 0 : 1;
676
+ if (options.json === true) {
677
+ console.log(JSON.stringify(payload, null, 2));
678
+ return ok ? 0 : 1;
679
+ }
680
+ if (!ok) {
681
+ throw new CliError(agentErrorMessage(payload) ?? `Tool ${toolName} failed.`, {
682
+ code: response.ok ? "failed" : errorCodeForStatus(response.status),
683
+ });
684
+ }
685
+ process.stdout.write(formatResultText(payload.result));
686
+ return 0;
622
687
  }
623
688
  finally {
624
689
  if (target.close !== undefined) {
@@ -632,28 +697,35 @@ export async function cmdCall(options) {
632
697
  * `--text` prints the rendered SKILL.md instead of JSON.
633
698
  */
634
699
  export async function cmdSkill(skillName, options) {
700
+ if (options.prod === true) {
701
+ return rejectProd("skill");
702
+ }
635
703
  if (skillName === undefined || skillName === "") {
636
- process.stderr.write(`Usage: ${CLI_COMMAND_NAME} skill <name> [--dir <path> | --url <baseUrl> | --prod]\n`);
704
+ process.stderr.write(`Usage: ${CLI_COMMAND_NAME} skill <name> [--dir <path> | --url <baseUrl>]\n`);
637
705
  return 2;
638
706
  }
639
707
  const target = await resolveTarget(options);
640
708
  try {
641
709
  const { response, payload } = await fetchAgentJson(target, `/v1/skills/${encodeURIComponent(skillName)}`, { bearerToken: options.bearerToken });
710
+ const path = `/v1/skills/${skillName}`;
642
711
  if (payload === undefined) {
643
- printInvalidResponse();
644
- return 1;
712
+ throw invalidResponse(path, response.status);
645
713
  }
646
- if (options.text === true && response.ok) {
647
- const skillMd = payload.skillMd;
648
- if (typeof skillMd !== "string") {
649
- printInvalidResponse();
650
- return 1;
651
- }
652
- process.stdout.write(skillMd.endsWith("\n") ? skillMd : `${skillMd}\n`);
653
- return 0;
714
+ if (options.json === true) {
715
+ console.log(JSON.stringify(payload, null, 2));
716
+ return response.ok ? 0 : 1;
717
+ }
718
+ if (!response.ok) {
719
+ throw new CliError(agentErrorMessage(payload) ?? `GET ${path} returned HTTP ${response.status}`, {
720
+ code: errorCodeForStatus(response.status),
721
+ });
654
722
  }
655
- console.log(JSON.stringify(payload, null, 2));
656
- return response.ok ? 0 : 1;
723
+ const skillMd = isRecord(payload) ? payload.skillMd : undefined;
724
+ if (typeof skillMd !== "string") {
725
+ throw invalidResponse(path, response.status);
726
+ }
727
+ process.stdout.write(skillMd.endsWith("\n") ? skillMd : `${skillMd}\n`);
728
+ return 0;
657
729
  }
658
730
  finally {
659
731
  if (target.close !== undefined) {
@@ -663,14 +735,14 @@ export async function cmdSkill(skillName, options) {
663
735
  }
664
736
  export async function cmdTrajectory(options) {
665
737
  if (typeof options.events !== "string") {
666
- die(`trajectory requires --events <file.ndjson> (write one with: ${CLI_COMMAND_NAME} run --events …)`);
738
+ usage(`trajectory requires --events <file.ndjson> (write one with: ${CLI_COMMAND_NAME} run --events …)`);
667
739
  }
668
740
  const trajectory = await loadTrajectoryFromEventsFile(resolve(options.events));
669
- if (options.text) {
670
- process.stdout.write(formatTrajectoryText(trajectory));
741
+ if (options.json === true) {
742
+ console.log(JSON.stringify(trajectory, null, 2));
671
743
  }
672
744
  else {
673
- console.log(JSON.stringify(trajectory, null, 2));
745
+ process.stdout.write(formatTrajectoryText(trajectory));
674
746
  }
675
747
  return trajectory.ok ? 0 : 1;
676
748
  }
@@ -722,7 +794,7 @@ export async function cmdEval(options) {
722
794
  return 2;
723
795
  }
724
796
  if (options.noWait === true) {
725
- process.stderr.write(`--out needs the finished results; drop --no-wait, or poll later with ${CLI_COMMAND_NAME} eval status <evalId> --out <path>\n`);
797
+ process.stderr.write(`--out needs the finished results; drop --no-wait, or poll later with ${CLI_COMMAND_NAME} eval get <evalId> --out <path>\n`);
726
798
  return 2;
727
799
  }
728
800
  }
@@ -743,7 +815,6 @@ export async function cmdEval(options) {
743
815
  baseUrl: target.agentUrl,
744
816
  auth: {
745
817
  bearerToken: options.bearerToken,
746
- headers: target.headers,
747
818
  },
748
819
  fetchImpl: options.fetchImpl,
749
820
  filterIds,
@@ -794,7 +865,6 @@ export async function cmdEval(options) {
794
865
  reporters: buildCliEvalReporters(options, artifactsDir),
795
866
  target: { baseUrl: target.agentUrl, mode: "local" },
796
867
  bearerToken: options.bearerToken,
797
- headers: target.headers,
798
868
  verbose: Boolean(options.verbose) || stream,
799
869
  onEvent: progress === undefined ? undefined : (e) => progress.onEvent(e),
800
870
  });
@@ -818,7 +888,6 @@ export async function cmdEval(options) {
818
888
  verbose: Boolean(options.verbose),
819
889
  auth: {
820
890
  bearerToken: options.bearerToken,
821
- headers: target.headers,
822
891
  },
823
892
  fetchImpl: options.fetchImpl,
824
893
  });
@@ -834,7 +903,6 @@ export async function cmdEval(options) {
834
903
  verbose: Boolean(options.verbose) || stream,
835
904
  auth: {
836
905
  bearerToken: options.bearerToken,
837
- headers: target.headers,
838
906
  },
839
907
  fetchImpl: options.fetchImpl,
840
908
  });
@@ -845,7 +913,6 @@ export async function cmdEval(options) {
845
913
  runId: started.runId,
846
914
  auth: {
847
915
  bearerToken: options.bearerToken,
848
- headers: target.headers,
849
916
  },
850
917
  fetchImpl: options.fetchImpl,
851
918
  onSnapshot: progress === undefined ? undefined : progress.onSnapshot,
@@ -896,7 +963,7 @@ function printEvalIdBanner(started, options, agentUrl) {
896
963
  const durable = started.config.durableRuns === true ? " (persisted)" : "";
897
964
  process.stderr.write(`Eval ID: ${started.runId}${durable} — ${started.summary.total} case(s)\n`);
898
965
  process.stderr.write(`Cancel: ${CLI_COMMAND_NAME} eval cancel ${started.runId}${statusFlags}\n`);
899
- process.stderr.write(`Status: ${CLI_COMMAND_NAME} eval status ${started.runId}${statusFlags}\n`);
966
+ process.stderr.write(`Status: ${CLI_COMMAND_NAME} eval get ${started.runId}${statusFlags}\n`);
900
967
  if (playgroundUrl !== undefined) {
901
968
  process.stderr.write(`Playground: ${playgroundUrl}\n`);
902
969
  }
@@ -923,7 +990,7 @@ function printEvalAccepted(started, options, agentUrl) {
923
990
  const durable = started.config.durableRuns === true ? " (persisted)" : "";
924
991
  process.stdout.write(`Eval ID: ${started.runId}${durable} — ${started.summary.total} case(s)\n`);
925
992
  process.stdout.write(`Cancel: ${CLI_COMMAND_NAME} eval cancel ${started.runId}${statusFlags}\n`);
926
- process.stdout.write(`Status: ${CLI_COMMAND_NAME} eval status ${started.runId}${statusFlags}\n`);
993
+ process.stdout.write(`Status: ${CLI_COMMAND_NAME} eval get ${started.runId}${statusFlags}\n`);
927
994
  if (playgroundUrl !== undefined) {
928
995
  process.stdout.write(`Playground: ${playgroundUrl}\n`);
929
996
  }
@@ -977,7 +1044,6 @@ export async function cmdEvalCancel(runId, options) {
977
1044
  runId,
978
1045
  auth: {
979
1046
  bearerToken: options.bearerToken,
980
- headers: target.headers,
981
1047
  },
982
1048
  fetchImpl: options.fetchImpl,
983
1049
  });
@@ -1029,7 +1095,6 @@ export async function cmdEvalStatus(runId, options) {
1029
1095
  }
1030
1096
  const auth = {
1031
1097
  bearerToken: options.bearerToken,
1032
- headers: target.headers,
1033
1098
  };
1034
1099
  try {
1035
1100
  if (runId === undefined || runId === "") {
@@ -1038,19 +1103,30 @@ export async function cmdEvalStatus(runId, options) {
1038
1103
  auth,
1039
1104
  fetchImpl: options.fetchImpl,
1040
1105
  });
1106
+ // The runs route returns every run at once, so page here.
1107
+ const page = pageLocally(runs, listOptionsOf(options));
1041
1108
  if (options.json) {
1042
- process.stdout.write(`${JSON.stringify({ runs, activeRunId }, null, 2)}\n`);
1109
+ printJson({
1110
+ items: projectFields(page.items, options.fields),
1111
+ nextPageToken: page.nextPageToken,
1112
+ activeRunId,
1113
+ });
1043
1114
  }
1044
1115
  else if (runs.length === 0) {
1045
1116
  process.stdout.write("No eval runs on this agent.\n");
1046
1117
  }
1118
+ else if (page.items.length === 0) {
1119
+ // Past the last page the agent can still have runs.
1120
+ process.stdout.write("No more eval runs.\n");
1121
+ }
1047
1122
  else {
1048
1123
  if (activeRunId !== undefined) {
1049
1124
  process.stdout.write(`active: ${activeRunId}\n`);
1050
1125
  }
1051
- for (const run of runs) {
1126
+ for (const run of page.items) {
1052
1127
  process.stdout.write(`${formatEvalRunSummaryLine(run)}\n`);
1053
1128
  }
1129
+ writeNextPageHint(page.nextPageToken);
1054
1130
  }
1055
1131
  return 0;
1056
1132
  }
@@ -1062,7 +1138,7 @@ export async function cmdEvalStatus(runId, options) {
1062
1138
  });
1063
1139
  const outPath = await writeJsonOutFile(options.out, snap);
1064
1140
  if (options.json) {
1065
- process.stdout.write(`${JSON.stringify(snap, null, 2)}\n`);
1141
+ printJson(snap, { fields: options.fields });
1066
1142
  if (outPath !== undefined) {
1067
1143
  process.stderr.write(`results: ${outPath}\n`);
1068
1144
  }
@@ -1093,8 +1169,7 @@ export async function cmdEvalStatus(runId, options) {
1093
1169
  return failed ? 1 : 0;
1094
1170
  }
1095
1171
  catch (error) {
1096
- process.stderr.write(`${sanitizeCustomerError(error instanceof Error ? error.message : String(error))}\n`);
1097
- return 1;
1172
+ throw sessionReadError(error);
1098
1173
  }
1099
1174
  finally {
1100
1175
  if (target.close !== undefined) {
@@ -1316,9 +1391,10 @@ export function formatEvalAssertionLine(assertion) {
1316
1391
  return `${mark} ${assertion.name}${soft ? " [soft]" : ""}${suffix}`;
1317
1392
  }
1318
1393
  /**
1319
- * `logs` — follow deploy progress (`--prod`) then runtime agent logs.
1320
- * Local / `--url` tails `/v1/logs` only. On architecture v2, `--prod` tails
1321
- * the output of the deployment's recent sessions, or one with `--session`.
1394
+ * `logs` — tail runtime logs. Local / `--url` tails `/v1/logs`. `--prod`
1395
+ * prints the hosted v2 deployment's persistent process output and session
1396
+ * tails. A session id also prints that session's process output and tool
1397
+ * names.
1322
1398
  */
1323
1399
  export async function cmdLogs(options) {
1324
1400
  if (options.prod === true && options.url !== undefined) {
@@ -1327,7 +1403,7 @@ export async function cmdLogs(options) {
1327
1403
  }
1328
1404
  const sessionId = trimNonEmpty(options.sessionId);
1329
1405
  if (sessionId !== undefined && options.prod !== true) {
1330
- process.stderr.write("A session id needs --prod on an architecture v2 deployment\n");
1406
+ process.stderr.write("A session id needs --prod\n");
1331
1407
  return 2;
1332
1408
  }
1333
1409
  const controller = new AbortController();
@@ -1351,58 +1427,22 @@ export async function cmdLogs(options) {
1351
1427
  if (typeof auth === "number") {
1352
1428
  return auth;
1353
1429
  }
1354
- const architecture = await deploymentArchitecture({
1355
- client: auth.client,
1356
- teamId: auth.teamId,
1430
+ await followHostedLogs({
1357
1431
  slug,
1358
- });
1359
- if (architecture === "v2") {
1360
- await followHostedLogs({
1432
+ read: createHostedProdLogReader({
1433
+ client: auth.client,
1434
+ teamId: auth.teamId,
1361
1435
  slug,
1362
- read: (signal) => auth.client.getAgentkitDeploymentLogs({ teamId: auth.teamId, slug, sessionId, signal }),
1363
- scoped: sessionId !== undefined,
1364
- once: options.once === true,
1365
- json: options.json === true,
1366
- signal: controller.signal,
1367
- });
1368
- return 0;
1369
- }
1370
- if (sessionId !== undefined) {
1371
- process.stderr.write(`A session id needs an architecture v2 deployment; "${slug}" is v1\n`);
1372
- return 2;
1373
- }
1374
- await runLogsTail({
1375
- prod: true,
1376
- dir: options.dir,
1377
- cwd: options.cwd,
1378
- slug,
1379
- team: options.team,
1380
- apiKey: options.apiKey,
1381
- bearerToken: options.bearerToken,
1382
- once: options.once,
1383
- json: options.json,
1384
- fetchImpl: options.fetchImpl,
1436
+ sessionId,
1437
+ }),
1438
+ scoped: sessionId !== undefined,
1439
+ once: options.once === true,
1440
+ json: options.json === true,
1385
1441
  signal: controller.signal,
1386
- getDeployment: () => auth.client.getDeployment({ teamId: auth.teamId, slug }),
1387
- resolveRuntime: async () => {
1388
- const target = await resolveProdTarget({
1389
- dir: options.dir,
1390
- cwd: options.cwd,
1391
- slug,
1392
- team: options.team,
1393
- apiKey: options.apiKey,
1394
- fetchImpl: options.fetchImpl,
1395
- err: () => { },
1396
- skipLegacyArchitectureCheck: true,
1397
- });
1398
- return { agentUrl: target.agentUrl, headers: target.headers };
1399
- },
1400
1442
  });
1401
1443
  return 0;
1402
1444
  }
1403
1445
  await runLogsTail({
1404
- dir: options.dir,
1405
- cwd: options.cwd,
1406
1446
  url: options.url ?? "http://127.0.0.1:3000",
1407
1447
  bearerToken: options.bearerToken,
1408
1448
  once: options.once,
@@ -1425,86 +1465,125 @@ export async function cmdLogs(options) {
1425
1465
  process.off("SIGTERM", onSignal);
1426
1466
  }
1427
1467
  }
1428
- /** Resolve local / `--url` / `--prod` agent base URL + request headers. */
1429
- async function resolveSessionTarget(options) {
1430
- if (options.prod === true && options.url !== undefined) {
1431
- process.stderr.write("--prod and --url are mutually exclusive\n");
1432
- return 2;
1433
- }
1434
- if (options.prod === true) {
1435
- try {
1436
- const target = await resolveProdTarget({
1437
- dir: options.dir,
1438
- cwd: options.cwd,
1439
- slug: options.slug,
1440
- team: options.team,
1441
- apiKey: options.apiKey,
1442
- fetchImpl: options.fetchImpl,
1443
- });
1444
- return { agentUrl: target.agentUrl, headers: target.headers };
1445
- }
1446
- catch (error) {
1447
- process.stderr.write(`${sanitizeCustomerError(error instanceof Error ? error.message : String(error))}\n`);
1448
- return 1;
1449
- }
1450
- }
1468
+ /** The running server a session command reads: `--url`, else local `serve`. */
1469
+ function resolveSessionTarget(options) {
1451
1470
  return {
1452
1471
  agentUrl: (options.url ?? "http://127.0.0.1:3000").replace(/\/$/, ""),
1453
1472
  };
1454
1473
  }
1455
1474
  /**
1456
- * `sessions` — list sessions on a running (or `--prod` hosted) agent.
1475
+ * `sessions` — list sessions on a running agent or a `--prod` hosted v2
1476
+ * deployment.
1457
1477
  */
1458
1478
  export async function cmdSessions(options) {
1459
- const target = await resolveSessionTarget(options);
1460
- if (typeof target === "number") {
1461
- return target;
1479
+ const sinceMs = options.since === undefined ? undefined : parseSessionsSince(options.since, Date.now());
1480
+ if (options.since !== undefined && sinceMs === undefined) {
1481
+ process.stderr.write(`Invalid --since ${JSON.stringify(options.since)}: expected a duration like 24h or an ISO-8601 date or instant\n`);
1482
+ return 2;
1462
1483
  }
1484
+ if (options.prod === true && options.url !== undefined) {
1485
+ process.stderr.write("--prod and --url are mutually exclusive\n");
1486
+ return 2;
1487
+ }
1488
+ if (options.prod === true) {
1489
+ return listHostedSessions(options, sinceMs);
1490
+ }
1491
+ const target = resolveSessionTarget(options);
1492
+ let listed;
1463
1493
  try {
1464
- const listed = await listSessionsWithSource({
1494
+ listed = await listSessionsWithSource({
1465
1495
  baseUrl: target.agentUrl,
1466
1496
  auth: {
1467
1497
  bearerToken: options.bearerToken,
1468
- headers: target.headers,
1469
1498
  },
1470
1499
  fetchImpl: options.fetchImpl,
1471
1500
  });
1472
- if (options.json === true) {
1473
- const payload = listed.source === undefined
1474
- ? { sessions: listed.sessions }
1475
- : { sessions: listed.sessions, source: listed.source };
1476
- process.stdout.write(`${JSON.stringify(payload, null, 2)}\n`);
1477
- return 0;
1478
- }
1479
- process.stdout.write(formatSessionsTable(listed.sessions, { source: listed.source }));
1480
- return 0;
1481
1501
  }
1482
1502
  catch (error) {
1483
- process.stderr.write(`${sanitizeCustomerError(error instanceof Error ? error.message : String(error))}\n`);
1484
- return 1;
1503
+ throw sessionReadError(error);
1504
+ }
1505
+ const sessions = sinceMs === undefined
1506
+ ? listed.sessions
1507
+ : listed.sessions.filter((s) => Date.parse(s.updatedAt) >= sinceMs);
1508
+ // A local server returns every session at once, so page here.
1509
+ const page = pageLocally(sessions, listOptionsOf(options));
1510
+ if (options.json === true) {
1511
+ printJson({
1512
+ items: projectFields(page.items, options.fields),
1513
+ nextPageToken: page.nextPageToken,
1514
+ source: listed.source,
1515
+ });
1516
+ return 0;
1485
1517
  }
1518
+ if (page.items.length === 0 && sessions.length > 0) {
1519
+ // Past the last page the agent can still have sessions.
1520
+ process.stdout.write("No more sessions.\n");
1521
+ return 0;
1522
+ }
1523
+ process.stdout.write(formatSessionsTable(page.items, { source: listed.source }));
1524
+ writeNextPageHint(page.nextPageToken);
1525
+ return 0;
1526
+ }
1527
+ function listOptionsOf(options) {
1528
+ return { limit: options.limit ?? DEFAULT_LIST_LIMIT, pageToken: options.pageToken };
1486
1529
  }
1487
- export const HOSTED_RUNS_LAG_NOTE = "Turn running; runs may lag behind events.";
1488
- function formatHostedSessionRuns(sessionId, runs, events) {
1489
- const lines = [`Session ${sessionId}`, `Hosted executions: ${runs.executions.length}`];
1490
- for (const run of runs.executions) {
1491
- const failure = run.error?.message ?? run.message ?? "";
1492
- lines.push("", `${run.executionId} ${run.turnStatus} ${run.durationMs}ms ${run.writtenAt} ${failure}`.trimEnd(), ...run.logs.map((log) => ` ${log.line}`));
1493
- }
1494
- const latestType = events?.events.at(-1)?.type;
1495
- if (events !== undefined && events.events.length > 0) {
1496
- const latest = latestType === undefined ? "" : ` (latest ${latestType})`;
1497
- lines.push("", `Events: ${events.events.length}${latest}`);
1498
- }
1499
- const turnRunning = runs.executions.at(-1)?.turnStatus === "running" ||
1500
- (runs.executions.length === 0 && events?.execution?.turnStatus === "running");
1501
- if (turnRunning && (events?.events.length ?? 0) > 0) {
1502
- lines.push(HOSTED_RUNS_LAG_NOTE);
1503
- }
1504
- return `${lines.join("\n")}\n`;
1530
+ function writeNextPageHint(nextPageToken) {
1531
+ const hint = nextPageHint(nextPageToken);
1532
+ if (hint !== undefined) {
1533
+ process.stderr.write(hint);
1534
+ }
1535
+ }
1536
+ /** A failed read: API errors keep their status; others are sanitized. */
1537
+ function sessionReadError(error) {
1538
+ if (error instanceof DeployApiError) {
1539
+ return apiError(error);
1540
+ }
1541
+ if (error instanceof RemoteEvalError || error instanceof CliError) {
1542
+ return error;
1543
+ }
1544
+ return new CliError(sanitizeCustomerError(error instanceof Error ? error.message : String(error)), { code: "unavailable", cause: error });
1545
+ }
1546
+ function parseSessionsSince(raw, nowMs) {
1547
+ const trimmed = raw.trim();
1548
+ if (/^\d+(?:\.\d+)?\s*[a-z]+$/i.test(trimmed)) {
1549
+ return isValidDuration(trimmed) ? nowMs - parseDuration(trimmed) : undefined;
1550
+ }
1551
+ if (!/^\d{4}-\d{2}-\d{2}/.test(trimmed)) {
1552
+ return undefined;
1553
+ }
1554
+ const instant = Date.parse(trimmed);
1555
+ return Number.isNaN(instant) ? undefined : instant;
1556
+ }
1557
+ /** The hosted session cursor as an opaque `--page-token`. */
1558
+ function encodeSessionCursor(cursor) {
1559
+ return Buffer.from(JSON.stringify([cursor.lastActivityAt, cursor.id])).toString("base64url");
1560
+ }
1561
+ function decodeSessionCursor(token) {
1562
+ if (token === undefined) {
1563
+ return null;
1564
+ }
1565
+ try {
1566
+ const decoded = JSON.parse(Buffer.from(token, "base64url").toString("utf8"));
1567
+ if (Array.isArray(decoded) &&
1568
+ decoded.length === 2 &&
1569
+ typeof decoded[0] === "string" &&
1570
+ typeof decoded[1] === "string") {
1571
+ return { lastActivityAt: decoded[0], id: decoded[1] };
1572
+ }
1573
+ }
1574
+ catch {
1575
+ // Fall through to the usage error.
1576
+ }
1577
+ throw new CliUsageError(`--page-token ${JSON.stringify(token)} is not a sessions page token`);
1505
1578
  }
1506
- /** Read the v2 runs surface; only its 404 falls through to the v1 engine. */
1507
- async function readHostedSessionRuns(sessionId, options) {
1579
+ /**
1580
+ * Up to `--limit` of the hosted deployment's sessions, most recently active
1581
+ * first, following cursors as needed. With --since, the list stops at the
1582
+ * cutoff and has no next page after it.
1583
+ */
1584
+ async function listHostedSessions(options, sinceMs) {
1585
+ // Check the token before any network call.
1586
+ decodeSessionCursor(options.pageToken);
1508
1587
  const auth = await resolveDeployAuth({
1509
1588
  team: options.team,
1510
1589
  apiKey: options.apiKey,
@@ -1513,40 +1592,51 @@ async function readHostedSessionRuns(sessionId, options) {
1513
1592
  if (typeof auth === "number") {
1514
1593
  return auth;
1515
1594
  }
1595
+ const slug = resolveProdSlug(options);
1596
+ const limit = options.limit ?? DEFAULT_LIST_LIMIT;
1597
+ const sessions = [];
1598
+ let nextPageToken = null;
1516
1599
  try {
1517
- const slug = resolveProdSlug(options);
1518
- const runs = await auth.client.getAgentkitSessionRuns({
1519
- teamId: auth.teamId,
1520
- slug,
1521
- sessionId,
1522
- });
1523
- if (options.rawEvents === true || trimNonEmpty(options.out) !== undefined) {
1524
- process.stderr.write("--events and --out need an engine trajectory.\n");
1525
- return 2;
1526
- }
1527
- const latest = runs.executions.at(-1);
1528
- const events = runs.executions.length === 0 || latest?.turnStatus === "running"
1529
- ? await auth.client
1530
- .getAgentkitSessionEvents({
1600
+ // Ask only for what is still missing, so every page is used whole and
1601
+ // its cursor is a valid next-page token.
1602
+ for (let cursor = decodeSessionCursor(options.pageToken);;) {
1603
+ const page = await auth.client.listAgentkitSessions({
1531
1604
  teamId: auth.teamId,
1532
1605
  slug,
1533
- sessionId,
1534
- afterEventIndex: -1,
1535
- })
1536
- .catch(() => undefined)
1537
- : undefined;
1538
- process.stdout.write(options.json === true
1539
- ? `${JSON.stringify({ sessionId, ...runs }, null, 2)}\n`
1540
- : formatHostedSessionRuns(sessionId, runs, events));
1541
- return 0;
1606
+ limit: limit - sessions.length,
1607
+ cursor,
1608
+ });
1609
+ const inWindow = sinceMs === undefined
1610
+ ? page.sessions
1611
+ : page.sessions.filter((s) => Date.parse(s.lastActivityAt) >= sinceMs);
1612
+ sessions.push(...inWindow);
1613
+ if (page.nextCursor === null || inWindow.length < page.sessions.length) {
1614
+ break;
1615
+ }
1616
+ // Without --since one request is one page. With it, keep reading
1617
+ // back until the cutoff or --limit.
1618
+ if (sinceMs === undefined || sessions.length >= limit || page.sessions.length === 0) {
1619
+ nextPageToken = encodeSessionCursor(page.nextCursor);
1620
+ break;
1621
+ }
1622
+ cursor = page.nextCursor;
1623
+ }
1542
1624
  }
1543
1625
  catch (error) {
1544
- if (error instanceof DeployApiError && error.status === 404) {
1545
- return "v1";
1546
- }
1547
- process.stderr.write(`${sanitizeCustomerError(error instanceof Error ? error.message : String(error))}\n`);
1548
- return 1;
1626
+ throw sessionReadError(error);
1549
1627
  }
1628
+ if (options.json === true) {
1629
+ printListJson({ items: sessions, nextPageToken }, { fields: options.fields });
1630
+ return 0;
1631
+ }
1632
+ if (sessions.length === 0 && options.pageToken !== undefined) {
1633
+ // Past the last page the deployment can still have sessions.
1634
+ process.stdout.write("No more sessions.\n");
1635
+ return 0;
1636
+ }
1637
+ process.stdout.write(formatHostedSessionsTable(sessions));
1638
+ writeNextPageHint(nextPageToken);
1639
+ return 0;
1550
1640
  }
1551
1641
  /**
1552
1642
  * `session <id>` — view a full session (trajectory text by default).
@@ -1558,71 +1648,67 @@ async function readHostedSessionRuns(sessionId, options) {
1558
1648
  export async function cmdSession(sessionId, options) {
1559
1649
  if (options.prod === true && (options.messages?.length ?? 0) > 0) {
1560
1650
  // `session --prod [ses_…] --message` is the same hosted start as
1561
- // `run --prod`, with the positional id as the session to resume. Unlike
1562
- // `run`, a 404 is an error here: this form is explicitly v2.
1563
- const started = await cmdHostedSession({
1651
+ // `run --prod`, with the positional id as the session to resume.
1652
+ return cmdHostedSession({
1564
1653
  ...options,
1565
1654
  sessionId: trimNonEmpty(sessionId) ?? options.sessionId,
1566
1655
  });
1567
- if (started === "fallback") {
1568
- process.stderr.write(`Hosted session start returned 404 for slug ${resolveProdSlug(options)}: deploy a running AgentSDK v2 agent, or use \`${CLI_COMMAND_NAME} run --prod\` (falls back to the v1 engine).\n`);
1569
- return 1;
1570
- }
1571
- return started;
1572
1656
  }
1573
1657
  if (sessionId === undefined || sessionId.trim() === "") {
1574
- process.stderr.write(`Usage: ${CLI_COMMAND_NAME} session <ses_> [--url | --prod] [--slug <slug>] [--json | --text | --events] [--out <file.ndjson>]\n` +
1575
- ` or: ${CLI_COMMAND_NAME} session --prod [<sessionId>] --slug <slug> --message "…" [--dry-run] [--as-of <instant>]\n`);
1658
+ process.stderr.write(`Usage: ${CLI_COMMAND_NAME} session get <ses_> [--url | --prod] [--slug <slug>] [--view trajectory|events|cost] [--json] [--trace <file.ndjson>]\n` +
1659
+ ` or: ${CLI_COMMAND_NAME} session create --slug <slug> --message "…" [--session <ses_>] [--wait]\n`);
1576
1660
  return 2;
1577
1661
  }
1578
1662
  if (options.rawEvents === true && options.json === true) {
1579
- process.stderr.write("--events and --json are mutually exclusive\n");
1663
+ process.stderr.write("--view events and --json are mutually exclusive\n");
1580
1664
  return 2;
1581
1665
  }
1582
- if (options.prod === true && options.url === undefined) {
1583
- const hosted = await readHostedSessionRuns(sessionId, options);
1584
- if (hosted !== "v1") {
1585
- return hosted;
1586
- }
1666
+ if (options.prod === true && options.url !== undefined) {
1667
+ process.stderr.write("--prod and --url are mutually exclusive\n");
1668
+ return 2;
1587
1669
  }
1588
- const target = await resolveSessionTarget(options);
1589
- if (typeof target === "number") {
1590
- return target;
1670
+ if (options.prod === true) {
1671
+ return readHostedSessionView(sessionId, options);
1591
1672
  }
1673
+ const target = resolveSessionTarget(options);
1674
+ let events;
1592
1675
  try {
1593
- const events = await fetchSessionEvents({
1676
+ events = await fetchSessionEvents({
1594
1677
  baseUrl: target.agentUrl,
1595
1678
  sessionId,
1596
1679
  auth: {
1597
1680
  bearerToken: options.bearerToken,
1598
- headers: target.headers,
1599
1681
  },
1600
1682
  fetchImpl: options.fetchImpl,
1601
1683
  });
1602
- const outPath = trimNonEmpty(options.out);
1603
- if (outPath !== undefined) {
1604
- const targetPath = resolve(outPath);
1605
- await mkdir(dirname(targetPath), { recursive: true });
1606
- await writeFile(targetPath, `${events.map((e) => JSON.stringify(e)).join("\n")}\n`, "utf8");
1607
- process.stdout.write(`trace: ${targetPath} (${events.length} events)\n`);
1608
- return 0;
1609
- }
1610
- if (options.rawEvents === true) {
1611
- process.stdout.write(`${JSON.stringify({ sessionId, events }, null, 2)}\n`);
1612
- return 0;
1613
- }
1614
- const trajectory = buildTrajectory(events);
1684
+ }
1685
+ catch (error) {
1686
+ throw sessionReadError(error);
1687
+ }
1688
+ const outPath = trimNonEmpty(options.out);
1689
+ if (outPath !== undefined) {
1690
+ const targetPath = resolve(outPath);
1691
+ await mkdir(dirname(targetPath), { recursive: true });
1692
+ await writeFile(targetPath, `${events.map((e) => JSON.stringify(e)).join("\n")}\n`, "utf8");
1615
1693
  if (options.json === true) {
1616
- process.stdout.write(`${JSON.stringify(trajectory, null, 2)}\n`);
1617
- return 0;
1694
+ printJson({ trace: targetPath, events: events.length });
1695
+ }
1696
+ else {
1697
+ process.stdout.write(`trace: ${targetPath} (${events.length} events)\n`);
1618
1698
  }
1619
- process.stdout.write(formatTrajectoryText(trajectory));
1620
1699
  return 0;
1621
1700
  }
1622
- catch (error) {
1623
- process.stderr.write(`${sanitizeCustomerError(error instanceof Error ? error.message : String(error))}\n`);
1624
- return 1;
1701
+ if (options.rawEvents === true) {
1702
+ process.stdout.write(`${JSON.stringify({ sessionId, events }, null, 2)}\n`);
1703
+ return 0;
1704
+ }
1705
+ const trajectory = buildTrajectory(events);
1706
+ if (options.json === true) {
1707
+ printJson(trajectory, { fields: options.fields });
1708
+ return 0;
1625
1709
  }
1710
+ process.stdout.write(formatTrajectoryText(trajectory));
1711
+ return 0;
1626
1712
  }
1627
1713
  /** Sessions fetched concurrently when `cost` aggregates every session. */
1628
1714
  const COST_FETCH_CONCURRENCY = 4;
@@ -1637,13 +1723,12 @@ const COST_FETCH_CONCURRENCY = 4;
1637
1723
  * text is the default.
1638
1724
  */
1639
1725
  export async function cmdCost(sessionId, options) {
1640
- const target = await resolveSessionTarget(options);
1641
- if (typeof target === "number") {
1642
- return target;
1726
+ if (options.prod === true) {
1727
+ return rejectProd("cost");
1643
1728
  }
1729
+ const target = resolveSessionTarget(options);
1644
1730
  const auth = {
1645
1731
  bearerToken: options.bearerToken,
1646
- headers: target.headers,
1647
1732
  };
1648
1733
  try {
1649
1734
  const resolved = trimNonEmpty(sessionId);
@@ -1709,11 +1794,10 @@ export async function cmdCost(sessionId, options) {
1709
1794
  }
1710
1795
  }
1711
1796
  /**
1712
- * `playground` — open the local web UI, v1 hosted alias, or v2 portal UI.
1797
+ * `playground` — open the local web UI or the hosted v2 portal UI.
1713
1798
  *
1714
- * `--prod` opens the stable v1 alias or the v2 portal URL. `--bearer-token`
1715
- * (and other injected headers) on local targets still run a loopback reverse
1716
- * proxy — Ctrl-C stops that proxy.
1799
+ * `--prod` opens the portal URL. `--bearer-token` on local targets runs a
1800
+ * loopback reverse proxy — Ctrl-C stops that proxy.
1717
1801
  */
1718
1802
  export async function cmdPlayground(options) {
1719
1803
  if (options.prod === true && options.url !== undefined) {
@@ -1723,36 +1807,24 @@ export async function cmdPlayground(options) {
1723
1807
  const sessionId = options.sessionId !== undefined && options.sessionId.trim() !== ""
1724
1808
  ? options.sessionId.trim()
1725
1809
  : undefined;
1726
- // Hosted v1 opens the alias playground; v2 opens the portal-hosted shell.
1810
+ // Hosted opens the portal-hosted shell.
1727
1811
  if (options.prod === true) {
1728
- let resolved;
1812
+ let playgroundUrl;
1729
1813
  try {
1730
- resolved = await resolveProdPlaygroundUrl({
1731
- dir: options.dir,
1732
- cwd: options.cwd,
1733
- slug: options.slug,
1734
- team: options.team,
1735
- apiKey: options.apiKey,
1736
- fetchImpl: options.fetchImpl,
1737
- sessionId,
1738
- });
1814
+ playgroundUrl = prodPlaygroundUrl(resolveProdSlug(options), sessionId);
1739
1815
  }
1740
1816
  catch (error) {
1741
- process.stderr.write(`${sanitizeCustomerError(error instanceof Error ? error.message : String(error))}\n`);
1817
+ process.stderr.write(`${error instanceof Error ? error.message : String(error)}\n`);
1742
1818
  return 1;
1743
1819
  }
1744
- process.stdout.write(`${resolved.playgroundUrl}\n`);
1820
+ process.stdout.write(`${playgroundUrl}\n`);
1745
1821
  if (options.print !== true) {
1746
- openBrowser(resolved.playgroundUrl);
1822
+ openBrowser(playgroundUrl);
1747
1823
  }
1748
1824
  return 0;
1749
1825
  }
1750
- const target = await resolveSessionTarget(options);
1751
- if (typeof target === "number") {
1752
- return target;
1753
- }
1754
- const needsProxy = (target.headers !== undefined && Object.keys(target.headers).length > 0) ||
1755
- (options.bearerToken !== undefined && options.bearerToken.trim() !== "");
1826
+ const target = resolveSessionTarget(options);
1827
+ const needsProxy = options.bearerToken !== undefined && options.bearerToken.trim() !== "";
1756
1828
  if (!needsProxy) {
1757
1829
  const base = `${target.agentUrl.replace(/\/$/, "")}/playground`;
1758
1830
  const playgroundUrl = sessionId === undefined ? base : `${base}?sessionId=${encodeURIComponent(sessionId)}`;
@@ -1766,7 +1838,6 @@ export async function cmdPlayground(options) {
1766
1838
  try {
1767
1839
  proxy = await startPlaygroundProxy({
1768
1840
  upstreamUrl: target.agentUrl,
1769
- headers: target.headers,
1770
1841
  bearerToken: options.bearerToken,
1771
1842
  });
1772
1843
  }
@@ -1786,7 +1857,7 @@ async function runPlaygroundProxySession(args) {
1786
1857
  const playgroundUrl = proxy.playgroundUrl(args.sessionId);
1787
1858
  process.stdout.write(`${playgroundUrl}\n`);
1788
1859
  process.stderr.write(`Playground proxy on loopback (Ctrl-C to stop).\n`);
1789
- if (args.print !== true) {
1860
+ if (!args.print) {
1790
1861
  openBrowser(playgroundUrl);
1791
1862
  }
1792
1863
  const controller = new AbortController();