@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
@@ -1,21 +1,29 @@
1
- # BDK CLI
1
+ # Agent SDK CLI
2
2
 
3
- The Bot Development Kit (BDK) is published as `@cursor/bdk` with the `bdk`
3
+ The Agent SDK is published as `@grok/agent-sdk` with the `agent-sdk`
4
4
  CLI.
5
5
 
6
6
  ```text
7
- bdk <command>
7
+ agent-sdk <command>
8
8
  ```
9
9
 
10
- The command catalog below documents the `bdk` binary from
11
- `@cursor/bdk`. Run it with Node 22.13 or newer; Bun is not
10
+ The command catalog below documents the `agent-sdk` binary from
11
+ `@grok/agent-sdk`. Run it with Node 22.13 or newer; Bun is not
12
12
  supported. Commands exit nonzero when validation or a synchronous request fails;
13
13
  asynchronous commands can exit `0` once work is accepted. Project paths use the
14
- [BDK project layout](/docs/reference/project-layout.md).
14
+ [Agent SDK project layout](/docs/reference/project-layout.md).
15
15
 
16
- Install `@cursor/bdk` to obtain the binary. `bdk help`
17
- prints top-level help; the Slack, GitHub, GitLab, and Bitbucket command packs
18
- provide their own `help` subcommands.
16
+ Install `@grok/agent-sdk` to obtain the binary. Bare `agent-sdk` prints the command
17
+ index. `agent-sdk <command> --help` prints one command's help, `agent-sdk help --all`
18
+ prints every command, and `agent-sdk help <command> --json` prints one command's
19
+ arguments and flags as JSON.
20
+
21
+ The `bdk` command remains available.
22
+
23
+ Commands are named `agent-sdk <resource> <verb>`, such as `agent-sdk deployment list`,
24
+ except for a few workflow verbs (`init`, `dev`, `run`, `eval`, `deploy`, and
25
+ others). Older names, such as `agent-sdk deployments` or `agent-sdk secrets set`, still
26
+ run for now. Each one prints the new form on stderr.
19
27
 
20
28
  ## Command catalog
21
29
 
@@ -23,17 +31,16 @@ provide their own `help` subcommands.
23
31
 
24
32
  | Command | Contract |
25
33
  | --- | --- |
26
- | `help`, `--help`, `-h` | Print top-level help |
34
+ | `help`, `--help`, `-h` | Print the command index, or one command's help |
27
35
  | [`serve`](#serve) | Serve one or more agents over HTTP |
28
36
  | [`dev`](#dev) | Serve agents with local-development behavior |
29
- | [`docs`](#docs) | Serve the documentation bundled with `@cursor/bdk` |
30
- | [`init`](#init) | Scaffold a BDK project |
31
- | [`convert-automation`](#convert-automation) | Export a Cursor Automation into a project |
37
+ | [`docs`](#docs) | Serve the documentation bundled with `@grok/agent-sdk` |
38
+ | [`init`](#init) | Scaffold an Agent SDK project, or convert an Automation |
32
39
  | [`migrate`](#migrate) | Move an early-alpha project to architecture v2 through a pull request |
33
- | [`install-skills`](#install-skills) | Refresh the bundled coding-agent skills |
34
- | [`info`](#info) | Print the discovered project surface |
40
+ | [`skills list`](#skills-install) | List the bundled coding-agent skills and their installed versions |
41
+ | [`skills install`](#skills-install) | Refresh the bundled coding-agent skills |
42
+ | [`info`](#info) | Print the discovered project surface or its deployment manifest |
35
43
  | [`validate`](#validate) | Check project diagnostics and set the exit status |
36
- | [`manifest`](#manifest) | Print deployment metadata as JSON |
37
44
  | [`version`](#version) | Print the installed package version |
38
45
  | [`update`](#update) | Upgrade the installed CLI |
39
46
  | [`login`](#login-logout-whoami) | Sign the host in to Cursor |
@@ -44,50 +51,47 @@ provide their own `help` subcommands.
44
51
 
45
52
  | Command | Contract |
46
53
  | --- | --- |
47
- | [`chat`](#chat) | Talk to a running agent |
48
- | [`resume`](#resume) | Reattach chat to a previous session |
49
- | [`run`](#run) | Start or continue work on a local, running, or hosted agent |
50
- | [`call`](#call) | Call a server tool without a model turn |
51
- | [`skill`](#skill) | Read an authored skill without a model turn |
54
+ | [`chat`](#chat) | Talk to a running agent, or reattach a session |
55
+ | [`run`](#run) | Run turns on a local or running agent |
56
+ | [`tool call`](#tool-call) | Call a server tool without a model turn |
52
57
  | [`logs`](#logs) | Follow or dump agent logs |
53
- | [`sessions`](#sessions) | List sessions |
54
- | [`session`](#session) | Inspect a session or start a hosted session turn |
55
- | [`cost`](#cost) | Report token usage and estimated cost |
56
- | [`playground`](#playground) | Open an agent's playground |
57
- | [`trajectory`](#trajectory) | Summarize a saved event stream |
58
- | [`eval`](#eval) | List, run, inspect, or cancel evals |
58
+ | [`session list`](#session-list) | List sessions, or their costs |
59
+ | [`session get`](#session-get) | Inspect a session or a saved trace, or open it in the playground |
60
+ | [`session create`](#session-create) | Start or continue a hosted session |
61
+ | [`eval`](#eval) | Run evals, or list, get, and cancel remote eval batches |
59
62
 
60
63
  ### Managed hosting commands
61
64
 
62
65
  | Command | Contract |
63
66
  | --- | --- |
64
67
  | [`deploy`](#deploy) | Deploy one or more agents |
65
- | [`deployments`](#deployments) | List deployments |
66
- | [`deployment`](#deployment) | Inspect one deployment |
67
- | [`stop`](#stop) | Stop a deployment |
68
- | [`start`](#start) | Start a stopped deployment |
69
- | [`kill`](#kill) | Stop a deployment, cancel its runs, and lock deploys |
70
- | [`unlock-deploys`](#unlock-deploys) | Let a killed deployment deploy again |
71
- | [`cancel-runs`](#cancel-runs) | Cancel active runs and reminder wakes |
72
- | [`event-repos`](#event-repos) | Replace a deployment's event repositories |
73
- | [`upgrade`](#upgrade) | Move a deployment to a release |
74
- | [`rollback`](#rollback) | Move a deployment to an earlier release |
75
- | [`delete`](#delete) | Delete a deployment |
76
- | [`rotate-token`](#rotate-token) | Replace a deployment's alias token |
77
- | [`secrets`](#secrets) | Set, list, or remove deployment secrets |
78
- | [`images`](#images) | Push, list, or remove container images for persistent agents |
68
+ | [`deployment list`](#deployment-list) | List deployments |
69
+ | [`deployment get`](#deployment-get) | Inspect one deployment |
70
+ | [`deployment stop`](#deployment-stop) | Stop a deployment |
71
+ | [`deployment start`](#deployment-start) | Start a stopped deployment |
72
+ | [`deployment kill`](#deployment-kill) | Stop a deployment, cancel its runs, and lock deploys |
73
+ | [`deployment unlock`](#deployment-unlock) | Let a killed deployment deploy again |
74
+ | [`deployment cancel-runs`](#deployment-cancel-runs) | Cancel active runs and reminder wakes |
75
+ | [`deployment update`](#deployment-update) | Replace a deployment's event repositories |
76
+ | [`deployment upgrade`](#deployment-upgrade) | Move a deployment to a release |
77
+ | [`deployment rollback`](#deployment-rollback) | Move a deployment to an earlier release |
78
+ | [`deployment delete`](#deployment-delete) | Delete a deployment |
79
+ | [`deployment rotate-token`](#deployment-rotate-token) | Replace a deployment's alias token |
80
+ | [`secret`](#secret) | Set, list, or delete deployment secrets |
81
+ | [`image`](#image) | Push, list, or delete container images for persistent agents |
79
82
 
80
83
  ### Connection and channel commands
81
84
 
82
85
  | Command | Contract |
83
86
  | --- | --- |
84
- | [`mcp`](#mcp) | Proxy an agent's MCP endpoint over stdio |
87
+ | [`mcp serve`](#mcp) | Proxy an agent's MCP endpoint over stdio |
85
88
  | [`mcp install`](#mcp) | Add the agent to an MCP client config |
86
89
  | [`mcp oauth`](#mcp-oauth) | Authorize an MCP connection |
87
90
  | [`slack`](#slack) | Provision and check Slack channel apps |
88
91
  | [`github`](#github) | Forward, replay, and inspect GitHub webhooks |
89
92
  | [`gitlab`](#gitlab) | Replay and inspect GitLab webhooks |
90
93
  | [`bitbucket`](#bitbucket) | Replay and inspect Bitbucket webhooks |
94
+ | [`pagerduty`](#pagerduty) | Replay and inspect PagerDuty webhooks |
91
95
 
92
96
  ## Targets {#choose-a-target}
93
97
 
@@ -95,10 +99,10 @@ Commands that send requests support these targets:
95
99
 
96
100
  | Target | Selection | Commands |
97
101
  | --- | --- | --- |
98
- | Ephemeral local server | Omit `--url` and `--prod` | `run`, `call`, `skill`, `eval` |
99
- | Running server | Pass `--url <baseUrl>` | `chat`, `resume`, `run`, `call`, `skill`, `eval`, `logs`, `sessions`, `session`, `cost`, `playground`, `mcp` |
100
- | Default local server | Omit `--url` and `--prod`; uses `http://127.0.0.1:3000` | `chat`, `resume`, `logs`, `sessions`, `session`, `cost`, `playground` |
101
- | Hosted deployment | Pass `--prod` | `run`, `session`, `logs`, `playground` |
102
+ | Ephemeral local server | Omit `--url` and `--prod` | `run`, `tool call`, `eval` |
103
+ | Running server | Pass `--url <baseUrl>` | `chat`, `run`, `tool call`, `eval`, `logs`, `session list`, `session get`, `mcp serve` |
104
+ | Default local server | Omit `--url` and `--prod`; uses `http://127.0.0.1:3000` | `chat`, `logs`, `session list`, `session get` |
105
+ | Hosted deployment | Pass `--prod` | `session list`, `session get`, `logs`; `session create` is always hosted |
102
106
 
103
107
  An explicit `--url` must include the slug for a multi-agent server, such as
104
108
  `http://127.0.0.1:3000/pr-approver`. `--slug` never changes an explicit URL.
@@ -108,13 +112,13 @@ An explicit `--url` must include the slug for a multi-agent server, such as
108
112
  | --- | --- |
109
113
  | `--dir <path>` | Select the project root. The default is the current directory. |
110
114
  | `--url <baseUrl>` | Use a running agent instead of local project discovery. |
111
- | `--prod` | Use the hosted deployment. Only `run`, `session`, `logs`, and `playground` accept it; `chat`, `resume`, `call`, `skill`, `sessions`, `cost`, and `mcp` report that the deployment doesn't support the command, and `eval` rejects the flag. |
115
+ | `--prod` | Use the hosted deployment. `session list`, `session get`, and `logs` accept it; `chat`, `run`, `tool call`, `mcp serve`, and `eval` exit with a usage error. |
112
116
  | `--slug <slug>` | Select an agent from a multi-agent project or a hosted deployment. Under `--prod`, the default is the `--dir` basename. |
113
117
  | `--team <id>` | Select a Cursor team. The signed-in account's team is the default. |
114
118
  | `--api-key <key>` | Override the Cursor credential for commands that authenticate with Cursor. |
115
119
  | `--bearer-token <token>` | Authenticate to a running server with a bearer token. |
116
- | `--state-root <path>` | Select local state for `serve` and ephemeral `run`, `call`, `skill`, and `eval` targets. Running and `--prod` targets ignore it. |
117
- | `--json` | Request machine-readable output when the command supports it. `run` already defaults to JSON. |
120
+ | `--state-root <path>` | Select local state for `serve` and ephemeral `run`, `tool call`, and `eval` targets. Running and `--prod` targets ignore it. |
121
+ | `--json` | Print one JSON document on stdout, errors included (`{"error":{"code","message","hint"}}`). Without it, output is text, also when piped. `agent-sdk help` lists the exit codes. |
118
122
 
119
123
  ## Local servers
120
124
 
@@ -123,13 +127,12 @@ An explicit `--url` must include the slug for a multi-agent server, such as
123
127
  `serve` mounts every project discovered under `--dir`:
124
128
 
125
129
  ```text
126
- bdk serve [--dir <path>] [--port <n>] [--host <host>]
130
+ agent-sdk serve [--dir <path>] [--port <n>] [--host <host>]
127
131
  [--mode multi|single] [--dev] [--api-key <key>]
128
132
  [--state-root <path>]
129
133
  [--bearer-token <secret> | --allow-anonymous]
130
134
  [--allow-anonymous-cursor-github]
131
135
  [--allow-anonymous-cursor-account-mcp]
132
- [--allow-anonymous-grokbot]
133
136
  [--public-url <url>]
134
137
  [--peers-url <url>]
135
138
  [--no-schedules] [--no-playground] [--no-docs]
@@ -148,7 +151,6 @@ bdk serve [--dir <path>] [--port <n>] [--host <host>]
148
151
  | `--allow-anonymous` | Admit callers as one anonymous principal. Use it only behind a trusted network boundary. |
149
152
  | `--allow-anonymous-cursor-github` | Let anonymous callers use sessions with a Cursor account's repository-scoped GitHub credential. Requires an authenticating proxy. |
150
153
  | `--allow-anonymous-cursor-account-mcp` | Let anonymous callers use Cursor account MCP connections. Requires an authenticating proxy. |
151
- | `--allow-anonymous-grokbot` | Let anonymous callers drive hosted Grok Bot runtime agents. Requires an authenticating proxy. |
152
154
  | `--public-url <url>` | Set the externally reachable base URL that turns running off the serve host use for peer MCP and host bridges. It does not expose the server; configure the listener or proxy separately. Local-runtime peers use loopback. |
153
155
  | `--peers-url <url>` | Resolve declared peers for a single-agent serve through a hosting-provided peer service. Cursor-managed hosting sets this option automatically; a multi-agent serve rejects it. |
154
156
  | `--no-schedules` | Disable schedule firing outside dev mode. |
@@ -164,8 +166,8 @@ digits, `_`, or `-`. The reserved slugs are `v1`, `playground`, and `docs`.
164
166
  `dev` is `serve --dev` with an optional positional project path:
165
167
 
166
168
  ```text
167
- bdk dev
168
- bdk dev ./bdk-pr-reviewer --port 3000
169
+ agent-sdk dev
170
+ agent-sdk dev ./bdk-pr-reviewer --port 3000
169
171
  ```
170
172
 
171
173
  It accepts every `serve` option. Pass at most one positional path, and don't
@@ -174,7 +176,7 @@ combine it with a different `--dir`.
174
176
  ### Serve the docs {#docs}
175
177
 
176
178
  ```text
177
- bdk docs [--port <n>] [--host 127.0.0.1] [--print]
179
+ agent-sdk docs [--port <n>] [--host 127.0.0.1] [--print]
178
180
  ```
179
181
 
180
182
  `docs` serves the bundled documentation without an agent project. It uses an
@@ -188,7 +190,7 @@ prints the URL without opening a browser.
188
190
  `chat` connects to a running server and never starts an ephemeral one:
189
191
 
190
192
  ```text
191
- bdk chat [--url <baseUrl>] [--message <text>]
193
+ agent-sdk chat [--url <baseUrl>] [--message <text>]
192
194
  [--session <id> | --resume] [--continuation-token <token>]
193
195
  [--slug <slug>] [--json] [--text] [--no-color]
194
196
  ```
@@ -202,149 +204,153 @@ bdk chat [--url <baseUrl>] [--message <text>]
202
204
  | `--json --message <text>` | Send one turn and print `{ ok, sessionId, continuationToken, trajectory }`. |
203
205
  | `--json --text --message <text>` | Print a compact trajectory instead of JSON. |
204
206
 
205
- Use `--session <id>` to reattach a stored session. If you omit
206
- `--continuation-token`, the CLI looks it up from the target's session list.
207
- `--resume` selects the most recently updated session with a continuation
208
- token. An explicit session ID takes precedence.
209
-
210
- ### Resume a session {#resume}
211
-
212
- `resume` provides the same reattachment contract as `chat --session`:
213
-
214
- ```text
215
- bdk resume [sessionId] [--url <baseUrl>]
216
- [--message <text>] [--json] [--text]
217
- [--continuation-token <token>] [--slug <slug>]
218
- ```
219
-
220
- Omit the session ID to select the most recently updated followable session.
221
- The command replays the transcript before accepting follow-ups.
222
- `resume --json` requires `--message`.
207
+ Use `--session <id>` to reattach a stored session and replay its transcript.
208
+ If you omit `--continuation-token`, the CLI looks it up from the target's
209
+ session list. `--resume` selects the most recently updated session with a
210
+ continuation token. An explicit session ID takes precedence.
223
211
 
224
212
  ### Run turns {#run}
225
213
 
226
- `run` sends messages to an ephemeral, running, or `--prod` target:
214
+ `run` sends messages to an ephemeral local server or a running server:
227
215
 
228
216
  ```text
229
- bdk run [--dir <path>] [--message <text>]...
230
- [--messages-file <path>] [--url <baseUrl> | --prod]
217
+ agent-sdk run [--dir <path>] [--message <text>]...
218
+ [--messages-file <path>] [--url <baseUrl>]
231
219
  [--session <id>] [--continuation-token <token>]
232
- [--events <file> | --no-events] [--text]
233
- [--timeout-ms <n>] [--no-stream] [--slug <slug>] [--team <id>]
234
- [--dry-run] [--as-of <instant>] [--component <key>]
220
+ [--trace <file> | --no-trace] [--json]
221
+ [--timeout-ms <n>] [--no-stream] [--slug <slug>] [--dry-run]
235
222
  ```
236
223
 
237
224
  | Option | Contract |
238
225
  | --- | --- |
239
- | `--message <text>` | Send a user message. Repeat it for a multi-turn local or `--url` run. A `--prod` run takes exactly one message. |
226
+ | `--message <text>` | Send a user message. Repeat it for a multi-turn run. |
240
227
  | `--messages-file <path>` | Read a JSON array of strings. File messages run before repeated `--message` values. |
241
- | `--session <id>` | Continue a session. With `--prod`, pass a hosted `ses_...` ID from a session that `run --prod` or `session --prod` started; Slack, SCM, and custom-route sessions can't be continued this way. |
242
- | `--continuation-token <token>` | Continue the session selected by `--session` on a running server. `--prod` doesn't accept it. |
243
- | `--events <file>` | Write the raw NDJSON stream to this path. |
244
- | `--no-events` | Skip the NDJSON trace. |
245
- | `--text` | Print a compact trajectory instead of JSON. |
228
+ | `--session <id>` | Continue a session on the target. |
229
+ | `--continuation-token <token>` | Continue the session selected by `--session` on a running server. |
230
+ | `--trace <file>` | Write the raw NDJSON stream to this path. |
231
+ | `--no-trace` | Skip the NDJSON trace. |
232
+ | `--json` | Print the JSON result instead of the compact trajectory. |
246
233
  | `--timeout-ms <n>` | Stop waiting after a positive number of milliseconds. There is no default timeout. |
247
234
  | `--no-stream` | Hide live tool and reply progress on stderr. |
248
- | `--dry-run` | Start a `--prod` session that runs read tools and stubs write tools. |
249
- | `--as-of <instant>` | Freeze a `--prod` session's clock at an ISO-8601 instant with a timezone, such as `2026-08-31T12:00:00Z`. |
250
- | `--component <key>` | Wake a named component of a `--prod` deployment instead of its default. A continued session must belong to that component. |
235
+ | `--dry-run` | Send nothing. Print the request the run would send. A local run starts no server. |
251
236
 
252
- For local and running-server targets, JSON output contains `ok`, `sessionId`,
253
- `continuationToken`, `trace`, `playgroundUrl`, `playgroundHint`, `visualize`,
254
- and `trajectory`. The `trace` value gives the saved path when event output is
255
- enabled.
237
+ Text output is the compact trajectory, with the session ID and trace path on
238
+ stderr. `--json` output contains `ok`, `sessionId`, `continuationToken`,
239
+ `trace`, `playgroundUrl`, `visualize`, and `trajectory`. The `trace` value
240
+ gives the saved path when trace output is enabled.
256
241
 
257
- With `--prod`, `run` returns as soon as the deployment accepts the turn and
258
- exits `0` before the turn outcome is known. It prints `deliveryId`,
259
- `workflowId`, and `sessionMode`, plus `dryRun` and `asOf` when set. A fresh
260
- start has no `sessionId` yet; a continuation echoes the `--session` value.
261
- `--events`, `--no-events`, `--text`, `--timeout-ms`, and `--no-stream` have no
262
- effect. See [Verify a hosted turn](/docs/deployment.md#verify-a-hosted-turn) for
263
- finding and following the new session.
242
+ For the hosted deployment, use [`session create`](#session-create).
264
243
 
265
- ### Call a tool {#call}
244
+ ### Call a tool {#tool-call}
266
245
 
267
- `call` invokes a server tool without a model turn:
246
+ `tool call` invokes a server tool without a model turn:
268
247
 
269
248
  ```text
270
- bdk call <tool> [--input <json>]
249
+ agent-sdk tool call <tool> [--input <json>]
271
250
  [--dir <path> | --url <baseUrl>]
272
- [--session <id>] [--slug <slug>]
251
+ [--session <id>] [--slug <slug>] [--json]
273
252
  ```
274
253
 
275
254
  `--input` accepts JSON and defaults to `{}`. `--session` uses the session
276
255
  workspace and records the call on its event stream. The command prints the
277
- server's JSON response and succeeds only when the HTTP response succeeds with
278
- `ok: true`.
256
+ tool result (a string as is, anything else as JSON). `--json` prints the
257
+ server's full JSON response. The command succeeds only when the HTTP response
258
+ succeeds with `ok: true`.
279
259
 
280
- Hosted deployments don't support `call`. Start a model turn with `run --prod`
281
- and check it with [`session`](#session).
260
+ Hosted deployments don't support `tool call`. Start a model turn with
261
+ [`session create`](#session-create) and check it with
262
+ [`session get`](#session-get).
282
263
 
283
264
  See [Tools](/docs/reference/tools.md#call-a-tool-without-a-model-turn) for validation,
284
265
  busy-session behavior, and error codes.
285
266
 
286
- ### Read a skill {#skill}
287
-
288
- `skill` reads an authored skill without a model turn:
267
+ ### List sessions {#session-list}
289
268
 
290
269
  ```text
291
- bdk skill <name> [--dir <path> | --url <baseUrl>]
292
- [--slug <slug>] [--text]
293
- ```
294
-
295
- The default output is the server's JSON response. `--text` prints the rendered
296
- `SKILL.md` content.
297
-
298
- ### List sessions {#sessions}
299
-
300
- ```text
301
- bdk sessions [--url <baseUrl>]
302
- [--slug <slug>] [--bearer-token <token>] [--json]
270
+ agent-sdk session list [--url <baseUrl> | --prod] [--since <duration|instant>]
271
+ [--view sessions|cost] [--slug <slug>] [--team <id>]
272
+ [--bearer-token <token>] [--limit <n>] [--page-token <token>] [--json]
303
273
  ```
304
274
 
305
275
  Text output shows the session ID, channel, mode, turn count, running status,
306
- and update time. `--json` prints `{ sessions }`, including continuation
307
- tokens.
276
+ and update time. `--json` prints `{ items, nextPageToken }`, including
277
+ continuation tokens. `--limit` (default 20, at most 100) sets the page size,
278
+ and `--page-token` reads the next page.
279
+
280
+ With `--prod`, `session list` lists the hosted deployment's most recently
281
+ active sessions; `--since 24h` (or an ISO-8601 date or instant) reads back to
282
+ that cutoff, up to `--limit` sessions. Check one with
283
+ [`session get <sessionId> --prod`](#session-get).
308
284
 
309
- Hosted deployments don't support `sessions`. Find a hosted session ID in the
310
- [`logs --prod`](#logs) headers or the deployment's **Sessions** list in the
311
- dashboard, then check it with [`session <sessionId> --prod`](#session).
285
+ `--view cost` prints token usage per session and a total from a running
286
+ server. Turns saved before cost tracking appear as unpriced. `--json` prints
287
+ `{ sessions }`. `--prod` doesn't support this view.
312
288
 
313
- ### Inspect a session {#session}
289
+ ### Inspect a session {#session-get}
314
290
 
315
291
  ```text
316
- bdk session <sessionId> [--url <baseUrl> | --prod]
292
+ agent-sdk session get <sessionId> [--url <baseUrl> | --prod]
317
293
  [--slug <slug>] [--team <id>]
318
- [--json | --text | --events] [--out <file.ndjson>]
294
+ [--view trajectory|events|cost] [--json [--fields <a,b.c>]]
295
+ [--trace <file.ndjson>] [--web [--print]]
319
296
 
320
- bdk session --prod [<sessionId>] --slug <slug> --message <text>
321
- [--team <id>] [--dry-run] [--as-of <instant>] [--component <key>]
297
+ agent-sdk session get --file <file.ndjson> [--json]
322
298
  ```
323
299
 
324
300
  | Option | Contract |
325
301
  | --- | --- |
326
- | No output option | Print a compact trajectory. |
327
- | `--text` | Select the compact trajectory explicitly. |
302
+ | No option | Print a compact trajectory. |
328
303
  | `--json` | Print the trajectory object. |
329
- | `--events` | Print `{ sessionId, events }` with the raw event list. |
330
- | `--out <file.ndjson>` | Write the raw NDJSON trace instead of printing it. |
331
- | `--prod --message <text>` | Start a hosted session, or continue the supplied hosted session ID, with the same contract as [`run --prod`](#run). |
304
+ | `--view events` | Print `{ sessionId, events }` with the raw event list. With `--prod`, each tool call is an `actions.requested` or `action.result` event. The tool name is `toolName`. |
305
+ | `--view cost` | Print per-turn token usage and estimated cost from a running server. `--prod` doesn't support it. |
306
+ | `--trace <file.ndjson>` | Write the raw NDJSON trace instead of printing it. Not available with `--prod`. |
307
+ | `--file <file.ndjson>` | Read a saved trace (for example from `run --trace`) instead of a server, and print its trajectory. |
308
+ | `--web` | Open the session in the playground, or the dashboard playground with `--prod`. `--print` prints the URL only. A running target with credentials that a browser can't send starts a loopback proxy and stays open until Ctrl-C. |
332
309
 
333
- `--events` and `--json` are mutually exclusive. Use [`resume`](#resume) to
334
- continue a conversational session on a local or running server.
310
+ Use [`chat --session`](#chat) to continue a conversational session on a
311
+ local or running server.
335
312
 
336
313
  With `--prod`, the command prints the session's hosted executions: one line
337
314
  per run with its status, duration, and time, followed by that run's log
338
- lines. `--json` prints `{ sessionId, executions, startLog, ... }`. `--events`
339
- and `--out` aren't available. While a turn is running, text output also
340
- reports the event count and latest event type and prints
341
- `Turn running; runs may lag behind events.` A run can show `running` with no
342
- logs until the turn ends, so a growing event count is the progress signal.
315
+ lines. When the deployment stored process output, a `Process output:` section
316
+ prints that output next. `--json` prints `{ sessionId, executions, startLog, ... }`.
317
+ `startLog` is the process output, or `null` when none is stored.
318
+ `--view events` prints `{ sessionId, events }`. `--trace` isn't available.
319
+ While a turn is running, text output also reports the event count and latest
320
+ event type and prints `Turn running; runs may lag behind events.` A run can
321
+ show `running` with no logs until the turn ends, so a growing event count is
322
+ the progress signal.
323
+
324
+ ### Start a hosted session {#session-create}
325
+
326
+ ```text
327
+ agent-sdk session create --message <text> [--session <ses_...>]
328
+ [--slug <slug>] [--team <id>] [--wait [--timeout-ms <n>]]
329
+ [--read-only] [--as-of <instant>] [--component <key>] [--dry-run] [--json]
330
+ ```
331
+
332
+ | Option | Contract |
333
+ | --- | --- |
334
+ | `--message <text>` | The message to send. Exactly one. |
335
+ | `--session <ses_...>` | Continue a hosted session that `session create` started. Slack, SCM, and custom-route sessions can't be continued this way. |
336
+ | `--wait` | Poll the delivery until it names the session, then print it. Exit `3` (`pending`) when `--timeout-ms` (default 120000) passes first. A skipped or failed delivery exits `1`. |
337
+ | `--read-only` | Run read tools and stub write tools. |
338
+ | `--as-of <instant>` | Freeze the session's clock at an ISO-8601 instant with a timezone, such as `2026-08-31T12:00:00Z`. |
339
+ | `--component <key>` | Wake a named component instead of the deployment's default. A continued session must belong to that component. |
340
+ | `--dry-run` | Send nothing. Print the request it would send. |
341
+
342
+ Without `--wait`, the command returns as soon as the deployment accepts the
343
+ turn and exits `0` before the turn outcome is known. It prints the delivery
344
+ ID, the session ID when known, and the session mode. `--json` prints
345
+ `deliveryId`, `workflowId`, `sessionMode`, and `sessionId` when known, plus
346
+ `dryRun` and `asOf` when set. A fresh start has no `sessionId` until the turn
347
+ starts; a continuation echoes the `--session` value. See
348
+ [Verify a hosted turn](/docs/deployment.md#verify-a-hosted-turn).
343
349
 
344
350
  ### Follow logs {#logs}
345
351
 
346
352
  ```text
347
- bdk logs [sessionId] [--url <baseUrl> | --prod]
353
+ agent-sdk logs [sessionId] [--url <baseUrl> | --prod]
348
354
  [--session <sessionId>] [--slug <slug>] [--team <id>] [--once] [--json]
349
355
  ```
350
356
 
@@ -352,44 +358,15 @@ The command follows logs until Ctrl-C. `--once` prints the current buffer and
352
358
  exits; `--json` emits newline-delimited JSON events. With `--prod`, it follows
353
359
  the output of the hosted deployment's most recent sessions on every channel
354
360
  and prints a `==> <sessionId> (<channel>) <==` header each time the output
355
- switches sessions. Pass a session ID, as an argument or with `--session`, to
356
- follow only that session; a session ID requires `--prod`. Hosted log events
361
+ switches sessions. A persistent deployment also prints a `==> process-output <==`
362
+ block. That block is the process log the dashboard shows for the deployment.
363
+ Pass a session ID, as an argument or with `--session`, to follow only that
364
+ session; a session ID requires `--prod`. The session view starts with
365
+ `Process output:` for the deployment process log and `Session process output:`
366
+ for that session's own process output, and a `tool <name>` line for each tool
367
+ call. Hosted log events
357
368
  carry `sessionId` and `line` rather than `index` and `at`.
358
369
 
359
- ### Report costs {#cost}
360
-
361
- ```text
362
- bdk cost [sessionId] [--url <baseUrl>]
363
- [--slug <slug>] [--json]
364
- ```
365
-
366
- With a session ID, `cost` prints per-turn token usage and estimated cost.
367
- Without one, it prints one row per session and a total. Turns saved before
368
- cost tracking appear as unpriced. `--json` prints the underlying report or
369
- `{ sessions }` for an aggregate.
370
-
371
- ### Open the playground {#playground}
372
-
373
- ```text
374
- bdk playground [--url <baseUrl> | --prod] [--session <id>]
375
- [--slug <slug>] [--team <id>] [--bearer-token <token>] [--print]
376
- ```
377
-
378
- The command prints the playground URL and opens it unless `--print` is set.
379
- `--session` opens a deep link. A running target with credentials that a
380
- browser can't send starts a loopback proxy and stays open until Ctrl-C.
381
- With `--prod`, the URL opens the deployment's playground under **Deployed
382
- Agents** in the dashboard.
383
-
384
- ### Inspect a trajectory {#trajectory}
385
-
386
- ```text
387
- bdk trajectory --events <file.ndjson> [--text]
388
- ```
389
-
390
- The command converts an NDJSON stream into the trajectory JSON returned by
391
- `run`. `--text` prints the compact view.
392
-
393
370
  ## Evals
394
371
 
395
372
  ### Run evals {#eval}
@@ -397,7 +374,7 @@ The command converts an NDJSON stream into the trajectory JSON returned by
397
374
  `eval` discovers `evals/**/*.eval.{ts,js}` and runs selected cases:
398
375
 
399
376
  ```text
400
- bdk eval [--dir <path>] [evalId...]
377
+ agent-sdk eval [--dir <path>] [evalId...]
401
378
  [--list] [--tag <tag>]... [--json] [--verbose]
402
379
  [--timeout-ms <n>] [--strict] [--max-concurrency <n>]
403
380
  [--junit <path>] [--artifacts <dir> | --no-artifacts]
@@ -406,9 +383,10 @@ bdk eval [--dir <path>] [evalId...]
406
383
  ```
407
384
 
408
385
  Select an exact case such as `weather/nyc`, a file prefix such as `weather`,
409
- several IDs, or no IDs for every case. Repeat `--tag` for OR matching.
410
- Projects must provide `evals/evals.config.{ts,js}` with `maxConcurrency`
411
- between 1 and 200.
386
+ several IDs, or no IDs for every case. Repeat `--tag` for OR matching. To run
387
+ an eval whose ID is a subcommand word (`list`, `get`, `cancel`), put it after
388
+ `--`, as in `agent-sdk eval -- list`. Projects must provide
389
+ `evals/evals.config.{ts,js}` with `maxConcurrency` between 1 and 200.
412
390
 
413
391
  | Option | Contract |
414
392
  | --- | --- |
@@ -431,79 +409,50 @@ A running server prints its Eval ID when it accepts the batch.
431
409
  Use these commands to inspect or cancel it:
432
410
 
433
411
  ```text
434
- bdk eval status [evalId] --url <baseUrl>
435
- bdk eval cancel <evalId> --url <baseUrl>
412
+ agent-sdk eval list --url <baseUrl> [--limit <n>] [--page-token <token>]
413
+ agent-sdk eval get <evalId> --url <baseUrl> [--out <file.json>]
414
+ agent-sdk eval cancel <evalId> --url <baseUrl>
436
415
  ```
437
416
 
438
- `eval status` without an ID lists recent remote runs. `eval status --out`
439
- requires an ID. The `status` and `cancel` subcommands require `--url`.
417
+ `eval list` lists recent remote runs. `eval get` exits `3` (`pending`) while
418
+ the batch still runs. All three require `--url`.
440
419
 
441
420
  ## Projects
442
421
 
443
422
  ### Scaffold a project {#init}
444
423
 
445
424
  ```text
446
- bdk init [directory] [--template <name>] [--var id=value]... [--json]
447
- bdk init [directory] --from-grokbot <recipe.json>
448
- [--answers <file>] [--dry-run] [--json]
425
+ agent-sdk init [directory] [--template <name>] [--var id=value]... [--json] [--dry-run]
426
+ agent-sdk init [directory] --from automation:<url-or-uuid> [--dry-run] [--json]
449
427
  ```
450
428
 
451
429
  Without a directory, `init` prints the setup guide and changes no files. With
452
430
  a directory, it preserves existing scaffold files, adds missing files,
453
- installs dependencies, and tries to put `bdk` on `PATH`.
431
+ installs dependencies, and tries to put `agent-sdk` on `PATH`.
454
432
 
455
433
  | Option | Contract |
456
434
  | --- | --- |
457
- | `--template <name>` | Use a bundled template: `agentic-owners`, `agents-md`, `code-wiki`, `demo`, `grokbot-agents`, `security-help`, `security-reviewer`, `thermo-quality-review`, `thermo-review`, `triage-jira`, or `triage-linear`. `triage` selects `triage-linear`. |
435
+ | `--template <name>` | Use a bundled template: `agentic-owners`, `agents-md`, `code-wiki`, `demo`, `security-help`, `security-reviewer`, `thermo-quality-review`, `thermo-review`, `triage-jira`, or `triage-linear`. `triage` selects `triage-linear`. |
458
436
  | `--var id=value` | Answer a template question without a prompt. Repeat for multiple answers. |
459
437
  | `--json` | Skip interactive login and skill prompts, then print `{ ok, directory, template, created, skipped, installed, installError, cliOnPath, cliLinkError, next }`. `ok` reflects dependency installation. |
438
+ | `--dry-run` | List the files `init` would create. Write and install nothing. |
460
439
 
461
440
  On a TTY, templates with questions run their interview before writing files.
462
441
  `init` also offers to refresh the bundled coding-agent skills and starts login
463
442
  when the host has no Cursor credential.
464
443
 
465
- #### Export a Grok Bot recipe
466
-
467
- `--from-grokbot` reads a Grok Bot recipe and maps its profile, selected skills
468
- and routines, memory, channels, and connectors into a BDK project. The target
469
- directory defaults to the resolved `location` answer; a positional directory
470
- overrides it. A target previously created with `bdk init --template` is
471
- rejected; export into a fresh directory instead.
472
-
473
- | Option | Contract |
474
- | --- | --- |
475
- | `--from-grokbot <recipe.json>` | Read the recipe to export. |
476
- | `--answers <file>` | Read export decisions from a JSON object. Fields present in the file are not asked again. The published schema is `schemas/grokbot-answers.schema.json`. |
477
- | `--dry-run` | Print the planned files, defaults, exclusions, unmapped behavior, placeholders, secret names, warnings, and setup steps without writing files or installing dependencies. |
478
- | `--json` | Never prompt and print machine-readable output. Combine it with `--dry-run` for a machine-readable preview. |
479
-
480
- On a TTY, the command asks for missing decisions and offers recipe-derived
481
- defaults. Off a TTY, it never prompts, takes defaults where possible, and
482
- lists the fields it defaulted.
483
-
484
- `--dry-run --json` prints `{ ok, dryRun, directory, preview }`. The preview
485
- contains `version`, `name`, resolved `answers`, `defaulted`, `ignored`, `files`
486
- as `{ path, from }`, `excluded`, `unmapped` as `{ from, reason }`, `fillIns`,
487
- `secrets` as `{ names, reauth }`, `warnings`, and `setupSteps`. A write with
488
- `--json` also reports `files`, `installed`, and `installError`. A dependency
489
- install failure leaves `ok: true`, sets `installed: false`, reports
490
- `installError`, and exits `0`. Other errors print `{ ok: false, error }` and
491
- exit nonzero.
492
-
493
- `--answers` and `--dry-run` require `--from-grokbot`. This export mode does
494
- not accept `--template` or `--var`.
495
-
496
- See [Export a Grok Bot](/docs/guides/export-grokbot.md) for the preview-first
497
- workflow, mapping table, and post-export checklist.
444
+ `--from grokbot:<recipe.json>` and `--from-grokbot <recipe.json>` exit with
445
+ `Grok Bot import was removed.`
498
446
 
499
- ### Convert an Automation {#convert-automation}
447
+ #### Convert an Automation {#convert-automation}
500
448
 
501
449
  ```text
502
- bdk convert-automation <url-or-uuid> [--dir <path>] [--json]
450
+ agent-sdk init [directory] --from automation:<url-or-uuid> [--dry-run] [--json]
503
451
  ```
504
452
 
505
453
  The input can be a Cursor Automation dashboard URL or its UUID. The output
506
- directory defaults to `./<automation-name>`. Generated files don't overwrite
454
+ directory defaults to `./<automation-name>`; a positional directory overrides
455
+ it. Generated files don't overwrite
507
456
  existing paths, and missing scaffold files are added. The following
508
457
  `npm install` can update lockfiles and run lifecycle scripts from an existing
509
458
  `package.json`.
@@ -520,11 +469,11 @@ generated project and features that need manual review.
520
469
  ### Migrate an early-alpha project {#migrate}
521
470
 
522
471
  ```text
523
- bdk migrate [--dir <path>] [--repo <https-url>] [--ref <git-ref>]
472
+ agent-sdk migrate [--dir <path>] [--repo <https-url>] [--ref <git-ref>]
524
473
  [--path <agent-path>] [--no-wait] [--json] [--api-key <key>]
525
474
  ```
526
475
 
527
- `migrate` applies only to projects deployed on architecture v1 during the BDK
476
+ `migrate` applies only to projects deployed on architecture v1 during the Agent SDK
528
477
  early alpha. It reads a pushed Git ref, starts a Cursor cloud agent with the
529
478
  bundled `bdk-migrate-v2` skill, and opens a pull request with the source
530
479
  changes. The command waits for the pull request by default and never deploys
@@ -534,7 +483,7 @@ create the prod Slack app, unset peer URL secrets, and set secrets a new slug
534
483
  still needs.
535
484
 
536
485
  The command prints `Nothing to migrate.` and exits 0 only when `--dir` shows
537
- no migration work. That check looks for an `@cursor/july` dependency,
486
+ no migration work. That check looks for a legacy early-alpha package dependency,
538
487
  `architecture: "v1"`, `bot/storage.ts` or `agent/storage.ts`,
539
488
  `runtime: "grokbot"`, a literal SCM credential, a `/v1` continuation selector,
540
489
  an anonymous reminder, and a `*_MCP_URL` peer connection. When any of those is
@@ -543,7 +492,7 @@ does not read the hosted deployment.
543
492
 
544
493
  | Option | Contract |
545
494
  | --- | --- |
546
- | `--dir <path>` | Select the local BDK project. The default is the current directory. |
495
+ | `--dir <path>` | Select the local Agent SDK project. The default is the current directory. |
547
496
  | `--repo <https-url>` | Select the source repository. The CLI infers the current checkout's origin when possible. |
548
497
  | `--ref <git-ref>` | Select the pushed ref for the cloud agent. The CLI infers the current branch when possible. |
549
498
  | `--path <agent-path>` | Select the project path relative to the repository root. The CLI infers it from `--dir` when possible. |
@@ -553,27 +502,43 @@ does not read the hosted deployment.
553
502
 
554
503
  Credential resolution follows the normal order: `--api-key`,
555
504
  `CURSOR_API_KEY`, `CURSOR_API_KEY_FILE`, `CURSOR_SERVICE_ACCOUNT_KEY`, then
556
- the stored `bdk login` credential. See
505
+ the stored `agent-sdk login` credential. See
557
506
  [Migrate an early-alpha project](/docs/guides/migrate.md) for detection, pull
558
507
  request review, and deployment cutover.
559
508
 
560
- ### Install coding-agent skills {#install-skills}
509
+ ### Install and list coding-agent skills {#skills-install}
561
510
 
562
511
  ```text
563
- bdk install-skills [--print] [--json]
512
+ agent-sdk skills install [--dry-run] [--json]
564
513
  ```
565
514
 
566
- The command replaces the installed BDK skills with the package copy and
567
- removes stale bundled skills. `--print` previews the change. `--json` prints
515
+ The command replaces the installed Agent SDK skills with the package copy and
516
+ removes stale bundled skills. `--dry-run` previews the change. `--json` prints
568
517
  `{ ok, dryRun, directory, firstInstall, skills, removed }`.
569
518
 
570
519
  Package installation performs this copy.
571
- Run `bdk install-skills` when you need to refresh it.
520
+ Run `agent-sdk skills install` when you need to refresh it.
521
+
522
+ Each installed `SKILL.md` records the package release in `metadata.version`.
523
+
524
+ ```text
525
+ agent-sdk skills list [--json [--fields <a,b.c>]] [--limit <n>] [--page-token <token>]
526
+ ```
527
+
528
+ `skills list` prints each bundled skill and the version of its installed
529
+ copy. `--json` prints `{ items, nextPageToken }`. Each item has `name`,
530
+ `description`, `version`, `installedVersion`, and `path`. `installedVersion`
531
+ is `null` when the skill is not installed, and `"unknown"` when the installed
532
+ copy has no `metadata.version`. When `installedVersion` differs from
533
+ `version`, run `agent-sdk skills install`.
534
+
535
+ The `bdk-cli` skill holds the rules for agents that run `agent-sdk`: `--json`,
536
+ exit codes, `--fields`, `--dry-run`, `--yes`, secrets, and untrusted output.
572
537
 
573
538
  ### Inspect a project {#info}
574
539
 
575
540
  ```text
576
- bdk info [--dir <path>] [--json]
541
+ agent-sdk info [--dir <path>] [--view info|manifest] [--json [--fields <a,b.c>]]
577
542
  ```
578
543
 
579
544
  Text output lists the model, instructions, tools, skills, extensions,
@@ -581,10 +546,14 @@ connections, subagents, channels, schedules, hooks, hosting settings, and
581
546
  diagnostics. For one unslugged project, `--json` prints its project info
582
547
  object. For slugged or multi-agent discovery, it prints `{ agents }`.
583
548
 
549
+ `--view manifest` validates one project and prints a summary of its
550
+ deployment metadata without a network request. `--json` then prints the full
551
+ manifest JSON.
552
+
584
553
  ### Validate a project {#validate}
585
554
 
586
555
  ```text
587
- bdk validate [--dir <path>]
556
+ agent-sdk validate [--dir <path>]
588
557
  ```
589
558
 
590
559
  `validate` prints every discovered project's diagnostics and exits nonzero
@@ -598,24 +567,14 @@ quotes the `{ secretName: "NAME" }` form to use instead. A project that still
598
567
  sets `architecture: "v1"` gets the same finding as a warning, so run
599
568
  `validate` before removing the pin to list what the migration must rename.
600
569
 
601
- ### Print a deployment manifest {#manifest}
602
-
603
- ```text
604
- bdk manifest [--dir <path>] [--json]
605
- ```
606
-
607
- `manifest` validates one project and prints its deployment metadata without a
608
- network request. Default output is indented JSON; `--json` prints one compact
609
- line.
610
-
611
570
  ## Credentials and versions
612
571
 
613
572
  ### Manage credentials {#login-logout-whoami}
614
573
 
615
574
  ```text
616
- bdk login [--api-key <key>] [--key-name <name>]
617
- bdk whoami [--json]
618
- bdk logout
575
+ agent-sdk login [--api-key <key>] [--key-name <name>]
576
+ agent-sdk whoami [--json]
577
+ agent-sdk logout
619
578
  ```
620
579
 
621
580
  | Command | Contract |
@@ -627,9 +586,9 @@ bdk logout
627
586
  ### Print the version {#version}
628
587
 
629
588
  ```text
630
- bdk version [--json]
631
- bdk --version
632
- bdk -V
589
+ agent-sdk version [--json]
590
+ agent-sdk --version
591
+ agent-sdk -V
633
592
  ```
634
593
 
635
594
  Text output is the version number. `--json` prints
@@ -638,7 +597,7 @@ Text output is the version number. `--json` prints
638
597
  ### Update the CLI {#update}
639
598
 
640
599
  ```text
641
- bdk update
600
+ agent-sdk update
642
601
  ```
643
602
 
644
603
  `update` checks npm's `latest` tag and upgrades a recognized global or project
@@ -651,13 +610,23 @@ automatic warning.
651
610
 
652
611
  ## Managed hosting
653
612
 
613
+ Every command here that changes a deployment takes `--dry-run`. It runs the
614
+ reads (sign-in, team, and deployment checks), then stops at the first request
615
+ that would change state and prints that request, with secret values
616
+ redacted. Nothing is sent, and the command exits `0`.
617
+
618
+ `deployment kill`, `deployment cancel-runs`, `deployment delete`,
619
+ `deployment rotate-token`, `secret delete`, `image delete`, and
620
+ `slack destroy` cannot be undone. On a terminal they ask you to type the
621
+ slug or name. Without a terminal, as when an agent runs them, they exit `2`
622
+ unless you pass `--yes`.
623
+
654
624
  ### Deploy agents {#deploy}
655
625
 
656
626
  ```text
657
- bdk deploy [--dir <path>] [--slug <slug> | --all] [--team <id>]
627
+ agent-sdk deploy [--dir <path>] [--slug <slug> | --all] [--team <id>]
658
628
  [--repo <https-url>] [--ref <git-ref>] [--path <agent-path>]
659
- [--cursor-events-repo <repo>]...
660
- [--allow-domain <domain>]... [--no-wait] [--json]
629
+ [--cursor-events-repo <repo>]... [--no-wait] [--json]
661
630
  ```
662
631
 
663
632
  Managed hosting requires a team with agent hosting enabled. A team
@@ -672,7 +641,6 @@ service-account API key with agent access can deploy.
672
641
  | `--ref <git-ref>` | Set the source Git ref. The CLI infers the current branch when possible. |
673
642
  | `--path <agent-path>` | Set the project path relative to the repository root. |
674
643
  | `--cursor-events-repo <repo>` | Watch a repository's Cursor events. Write `owner/name` for GitHub and Origin, `gitlab.com/<group>/<project>` for GitLab (subgroups allowed), or `bitbucket.org/<workspace>/<repo>` for Bitbucket. Repeat the flag for each repository; the repositories you pass replace the previous list. Without the flag, the deployment watches its GitHub source repository. |
675
- | `--allow-domain <domain>` | Add an egress hostname. Repeat for multiple domains; values are combined with `hosting.egressDomains`. |
676
644
  | `--no-wait` | Return after the deployment request is accepted. |
677
645
  | `--json` | Print one object for one target or an array for multiple targets. |
678
646
 
@@ -687,131 +655,145 @@ if it reaches a failed state. A first deployment can return an alias token
687
655
  once. Store it as a secret and send it as `X-Agent-Alias-Token` when calling
688
656
  the stable alias URL.
689
657
 
690
- ### List deployments {#deployments}
658
+ When the team egress policy blocks a host, `deploy` exits nonzero and prints
659
+ `Error: agent-sdk deploy blocked.` The message names each blocked host, the team
660
+ egress mode, and two fixes: add the hosts to the team egress list, or remove
661
+ them from `hosting.egressDomains` and deploy again. The running bot does not
662
+ change.
663
+
664
+ An agent that sets `architecture: "v1"` does not deploy: `deploy` exits
665
+ nonzero and tells you to run [`migrate`](#migrate) first.
666
+
667
+ ### List deployments {#deployment-list}
691
668
 
692
669
  ```text
693
- bdk deployments [--team <id>] [--json]
670
+ agent-sdk deployment list [--team <id>] [--limit <n>] [--page-token <token>]
671
+ [--json [--fields <a,b.c>]]
694
672
  ```
695
673
 
696
- Text output shows slug, status, generation, kind, and update time. `--json`
697
- prints `{ deployments }`. An empty list succeeds.
674
+ Text output shows slug, status, and update time. `--json` prints
675
+ `{ items, nextPageToken }`. `--limit` (default 20, at most 100) sets the page
676
+ size, and `--page-token` reads the next page. An empty list succeeds.
698
677
 
699
- ### Inspect a deployment {#deployment}
678
+ ### Inspect a deployment {#deployment-get}
700
679
 
701
680
  ```text
702
- bdk deployment <slug> [--team <id>] [--json]
681
+ agent-sdk deployment get <slug> [--team <id>] [--json [--fields <a,b.c>]] [--web]
703
682
  ```
704
683
 
705
- Text output includes status, source, routes, secret names, egress domains, and
706
- the latest error. `--json` can include short-lived access headers, so handle
707
- its output as a credential.
684
+ Text output includes status, release, watched repositories, routes, secret
685
+ names, and the latest error. `--web` opens the deployment's page in the
686
+ dashboard. A deployment still on architecture v1 shows its status with
687
+ `architecture: v1` and the [`migrate`](#migrate) steps; `deployment stop` and
688
+ `deployment delete` also still accept it.
708
689
 
709
- ### Stop a deployment {#stop}
690
+ ### Stop a deployment {#deployment-stop}
710
691
 
711
692
  ```text
712
- bdk stop <slug> [--team <id>] [--no-wait] [--cancel-runs] [--json]
693
+ agent-sdk deployment stop <slug> [--team <id>] [--no-wait] [--cancel-runs] [--json]
713
694
  ```
714
695
 
715
696
  The command waits for `stopped` by default. `--no-wait` returns after the
716
697
  request is accepted. `--cancel-runs` also requests cancellation of active
717
698
  runs and reminder wakes.
718
699
 
719
- ### Start a deployment {#start}
700
+ ### Start a deployment {#deployment-start}
720
701
 
721
702
  ```text
722
- bdk start <slug> [--team <id>] [--json]
703
+ agent-sdk deployment start <slug> [--team <id>] [--json]
723
704
  ```
724
705
 
725
- `start` resumes a stopped deployment. It doesn't remove the deploy lock
726
- that [`kill`](#kill) sets.
706
+ `deployment start` resumes a stopped deployment. It doesn't remove the
707
+ deploy lock that [`deployment kill`](#deployment-kill) sets.
727
708
 
728
- ### Kill a deployment {#kill}
709
+ ### Kill a deployment {#deployment-kill}
729
710
 
730
711
  ```text
731
- bdk kill <slug> [--team <id>] [--json]
712
+ agent-sdk deployment kill <slug> [--team <id>] [--yes] [--dry-run] [--json]
732
713
  ```
733
714
 
734
- Use `kill` in an emergency. It locks deploys of the slug, stops the
735
- deployment, and requests cancellation of its active runs and reminder
715
+ Use `deployment kill` in an emergency. It locks deploys of the slug, stops
716
+ the deployment, and requests cancellation of its active runs and reminder
736
717
  wakes. To bring the deployment back, run
737
- [`unlock-deploys`](#unlock-deploys) and then [`start`](#start).
718
+ [`deployment unlock`](#deployment-unlock) and then
719
+ [`deployment start`](#deployment-start).
738
720
 
739
- ### Unlock deploys {#unlock-deploys}
721
+ ### Unlock deploys {#deployment-unlock}
740
722
 
741
723
  ```text
742
- bdk unlock-deploys <slug> [--team <id>] [--json]
724
+ agent-sdk deployment unlock <slug> [--team <id>] [--json]
743
725
  ```
744
726
 
745
- `unlock-deploys` removes the lock that `kill` sets, so `deploy`,
746
- `upgrade`, and `rollback` work for the slug again. It doesn't resume
747
- traffic; run `start` for that.
727
+ `deployment unlock` removes the lock that `deployment kill` sets, so
728
+ `deploy`, `deployment upgrade`, and `deployment rollback` work for the slug
729
+ again. It doesn't resume traffic; run `deployment start` for that.
748
730
 
749
- ### Cancel active runs {#cancel-runs}
731
+ ### Cancel active runs {#deployment-cancel-runs}
750
732
 
751
733
  ```text
752
- bdk cancel-runs <slug> [--team <id>] [--json]
734
+ agent-sdk deployment cancel-runs <slug> [--team <id>] [--yes] [--dry-run] [--json]
753
735
  ```
754
736
 
755
737
  The command requests cancellation for a deployment's active runs and reminder
756
738
  wakes. It exits nonzero if any cancellation request fails to start.
757
739
 
758
- ### Replace event repositories {#event-repos}
740
+ ### Replace event repositories {#deployment-update}
759
741
 
760
742
  ```text
761
- bdk event-repos <slug> [--repo <owner/name>]...
762
- [--team <id>] [--json]
743
+ agent-sdk deployment update <slug> (--event-repo <owner/name>... | --no-event-repos)
744
+ [--team <id>] [--dry-run] [--json]
763
745
  ```
764
746
 
765
747
  The supplied repositories replace the deployment's complete event repository
766
- list; they aren't merged with the previous list. Omit `--repo` to clear the
767
- list.
748
+ list; they aren't merged with the previous list. `--no-event-repos` clears
749
+ the list.
768
750
 
769
- ### Upgrade a deployment {#upgrade}
751
+ ### Upgrade a deployment {#deployment-upgrade}
770
752
 
771
753
  ```text
772
- bdk upgrade <slug> [--release <id-or-version>]
754
+ agent-sdk deployment upgrade <slug> [--release <id-or-version>]
773
755
  [--team <id>] [--json]
774
756
  ```
775
757
 
776
758
  `--release` accepts a release ID or version. Omit it to select the newest
777
759
  ready release. `--json` prints `{ releaseId }`.
778
760
 
779
- ### Roll back a deployment {#rollback}
761
+ ### Roll back a deployment {#deployment-rollback}
780
762
 
781
763
  ```text
782
- bdk rollback <slug> [--release <id-or-version>]
764
+ agent-sdk deployment rollback <slug> [--release <id-or-version>]
783
765
  [--team <id>] [--json]
784
766
  ```
785
767
 
786
- `rollback` moves the deployment to an earlier ready release without
768
+ `deployment rollback` moves the deployment to an earlier ready release without
787
769
  building a new one. Omit `--release` to select the release before the
788
770
  current one. `--json` prints `{ releaseId }`.
789
771
 
790
- ### Delete a deployment {#delete}
772
+ ### Delete a deployment {#deployment-delete}
791
773
 
792
774
  ```text
793
- bdk delete <slug> [--team <id>] [--no-wait] [--json]
775
+ agent-sdk deployment delete <slug> [--team <id>] [--no-wait] [--yes] [--dry-run] [--json]
794
776
  ```
795
777
 
796
- `delete` removes the deployment and frees its slug. It waits until the
778
+ `deployment delete` removes the deployment and frees its slug. It waits until the
797
779
  deployment is gone unless `--no-wait` is set.
798
780
 
799
- ### Rotate an alias token {#rotate-token}
781
+ ### Rotate an alias token {#deployment-rotate-token}
800
782
 
801
783
  ```text
802
- bdk rotate-token <slug> [--team <id>] [--json]
784
+ agent-sdk deployment rotate-token <slug> [--team <id>] [--yes] [--dry-run] [--json]
803
785
  ```
804
786
 
805
787
  The old token stops working immediately. The replacement appears once;
806
788
  `--json` prints `{ aliasToken }`.
807
789
 
808
- ### Manage deployment secrets {#secrets}
790
+ ### Manage deployment secrets {#secret}
809
791
 
810
792
  ```text
811
- bdk secrets set <slug> NAME [NAME2 ...]
793
+ agent-sdk secret set <slug> NAME [NAME2 ...]
812
794
  [--team <id>] [--from-argv] [--json]
813
- bdk secrets list <slug> [--team <id>] [--json]
814
- bdk secrets unset <slug> NAME [--team <id>] [--json]
795
+ agent-sdk secret list <slug> [--team <id>] [--limit <n>] [--page-token <token>] [--json]
796
+ agent-sdk secret delete <slug> NAME [--team <id>] [--yes] [--dry-run] [--json]
815
797
  ```
816
798
 
817
799
  Pass secret names to `set`. On a TTY, the CLI prompts for a hidden value and
@@ -820,7 +802,7 @@ whole value and one trailing newline is removed, so a PEM private key keeps
820
802
  its line breaks:
821
803
 
822
804
  ```bash
823
- bdk secrets set my-bot GITHUB_APP_PRIVATE_KEY < ./app.private-key.pem
805
+ agent-sdk secret set my-bot GITHUB_APP_PRIVATE_KEY < ./app.private-key.pem
824
806
  ```
825
807
 
826
808
  With several names, provide one line per name. `set` rejects `NAME=VALUE` on
@@ -832,15 +814,15 @@ characters. Names beginning with `CURSOR_` are reserved. Values contain at
832
814
  most 4096 bytes, and each deployment holds at most 32 secrets.
833
815
 
834
816
  `list` returns names and creation times, never values. JSON output is
835
- `{ secretNames }` for `set`, `{ secrets }` for `list`, and `{ removed }` for
836
- `unset`. Changes are available to subsequent hosted work.
817
+ `{ secretNames }` for `set`, `{ items, nextPageToken }` for `list`, and
818
+ `{ removed }` for `delete`. Changes are available to subsequent hosted work.
837
819
 
838
- ### Manage container images {#images}
820
+ ### Manage container images {#image}
839
821
 
840
822
  ```text
841
- bdk images push <local-image> --name <name> [--team <id>] [--json]
842
- bdk images list [--team <id>] [--json]
843
- bdk images rm <name> [--team <id>] [--json]
823
+ agent-sdk image push <local-image> --name <name> [--team <id>] [--json]
824
+ agent-sdk image list [--team <id>] [--limit <n>] [--page-token <token>] [--json]
825
+ agent-sdk image delete <name> [--team <id>] [--yes] [--dry-run] [--json]
844
826
  ```
845
827
 
846
828
  A persistent agent can run inside a container image that your team pushes
@@ -849,8 +831,8 @@ checks the local image first: the image must be `linux/amd64` and have
849
831
  `bash`, `git`, `node` 22.13 or newer, and `npm` on `PATH`. The command
850
832
  then compresses the image and uploads it under `--name`.
851
833
 
852
- `list` shows the team's images and how many the team can keep, and `rm`
853
- deletes one image. A deploy pins the image it uses, so after you push a
834
+ `list` shows the team's images and how many the team can keep (`--json`:
835
+ `{ items, nextPageToken, teamImageLimit }`), and `delete` deletes one image. A deploy pins the image it uses, so after you push a
854
836
  new image under the same name, deploy again to pick it up.
855
837
 
856
838
  ## MCP connections
@@ -858,24 +840,24 @@ new image under the same name, deploy again to pick it up.
858
840
  ### Connect an MCP client {#mcp}
859
841
 
860
842
  ```text
861
- bdk mcp --url <baseUrl> [--bearer-token <token>]
843
+ agent-sdk mcp serve --url <baseUrl> [--bearer-token <token>]
862
844
 
863
- bdk mcp install --url <baseUrl> [--bearer-token <token>]
864
- [--name <server-name>] [--print] [--json]
845
+ agent-sdk mcp install --url <baseUrl> [--bearer-token <token>]
846
+ [--name <server-name>] [--dry-run] [--json]
865
847
  ```
866
848
 
867
849
  | Command | Contract |
868
850
  | --- | --- |
869
- | `mcp` | Read newline-delimited JSON-RPC from stdin and proxy it to the selected agent's MCP endpoint. stdout is reserved for MCP messages. A target is required. |
870
- | `mcp install` | Add the selected agent to `~/.cursor/mcp.json`. `--name` sets the server name, `--print` previews the entry, and `--json` prints a machine-readable result. A `--url` entry with `--bearer-token` contains that token; handle printed and written copies as credentials. |
851
+ | `mcp serve` | Read newline-delimited JSON-RPC from stdin and proxy it to the selected agent's MCP endpoint. stdout is reserved for MCP messages. A target is required. |
852
+ | `mcp install` | Add the selected agent to `~/.cursor/mcp.json`. The entry runs `agent-sdk mcp`, which older CLI versions also understand. `--name` sets the server name, `--dry-run` previews the entry, and `--json` prints a machine-readable result. A `--url` entry with `--bearer-token` contains that token; handle printed and written copies as credentials. |
871
853
 
872
- Hosted deployments don't support `mcp` or `mcp install`; both report that the
873
- deployment doesn't support the command when you pass `--prod`.
854
+ Hosted deployments don't support `mcp serve` or `mcp install`; both exit with a
855
+ usage error when you pass `--prod`.
874
856
 
875
857
  ### Authorize MCP OAuth {#mcp-oauth}
876
858
 
877
859
  ```text
878
- bdk mcp oauth <connection> [--dir <path>]
860
+ agent-sdk mcp oauth <connection> [--dir <path>]
879
861
  [--slug <slug>] [--team <id>]
880
862
  ```
881
863
 
@@ -885,7 +867,7 @@ bdk mcp oauth <connection> [--dir <path>]
885
867
  | Connection | Result |
886
868
  | --- | --- |
887
869
  | `defineConnection({ url, oauth: true })` | Open a browser PKCE flow and save tokens in `mcp-auth.json` under the CLI config directory. |
888
- | `defineConnection({ cursorAccount: true })` | Authorize the hosted deployment's service account through Cursor. |
870
+ | `defineConnection({ cursorAccount: true })` | Exits nonzero and points at the cursor.com dashboard, where you authorize the deployment's connectors. |
889
871
 
890
872
  URL-connection tokens are bound to the resource URL; authorize again after
891
873
  changing it.
@@ -897,31 +879,31 @@ See [Host MCP OAuth](/docs/guides/mcp-oauth.md) for the full setup flow.
897
879
  ### Configure Slack {#slack}
898
880
 
899
881
  ```text
900
- bdk slack setup
901
- bdk slack create [--dir <path>] [--name <name>] [--prod]
882
+ agent-sdk slack setup
883
+ agent-sdk slack create [--dir <path>] [--name <name>] [--env prod]
902
884
  [--slack-team <id>] [--team <id>] [--icon <url-or-file>]
903
885
  [--prefix <prefix> | --no-prefix] [--channel-posts] [--json]
904
- bdk slack destroy [--dir <path>] [--prod]
886
+ agent-sdk slack destroy [--dir <path>] [--env prod] [--yes] [--dry-run]
905
887
  [--slack-team <id>] [--team <id>] [--json]
906
- bdk slack icon <url-or-file> [--dir <path>] [--prod]
888
+ agent-sdk slack icon <url-or-file> [--dir <path>] [--env prod]
907
889
  [--slack-team <id>] [--team <id>] [--json]
908
- bdk slack init --manual [--dir <path>] [--name <name>]
890
+ agent-sdk slack init --manual [--dir <path>] [--name <name>]
909
891
  [--prefix <prefix> | --no-prefix] [--channel-posts]
910
- [--install | --no-install] [--slack-team <id>] [--prod]
911
- bdk slack manifest [--dir <path>] [--name <name>]
912
- [--env dev|prod|both] [--channel-posts] [--print]
913
- bdk slack doctor [--dir <path>]
892
+ [--install | --no-install] [--slack-team <id>] [--env dev|prod]
893
+ agent-sdk slack manifest [--dir <path>] [--name <name>]
894
+ [--env dev|prod|both] [--channel-posts] [--dry-run]
895
+ agent-sdk slack doctor [--dir <path>]
914
896
  [--prefix <prefix> | --no-prefix] [--channel <id>]... [--json]
915
897
  ```
916
898
 
917
899
  | Subcommand | Contract |
918
900
  | --- | --- |
919
901
  | `setup` | Print the setup choices without changing files. |
920
- | `create` | Open the signed-in Cursor dashboard wizard, write the resulting token pair to `.env.local`, and run `doctor`. The development app is the default; `--prod` selects production. A second create overwrites the live app manifest. |
902
+ | `create` | Open the signed-in Cursor dashboard wizard, write the resulting token pair to `.env.local`, and run `doctor`. The development app is the default; `--env prod` selects production. A second create overwrites the live app manifest. |
921
903
  | `destroy` | Delete the provisioned app. Existing local token entries remain but stop working. |
922
904
  | `icon` | Set an HTTPS or local PNG, JPG, or GIF icon of at most 512 KB. |
923
905
  | `init --manual` | Write the channel, manifests, Slack CLI project, and setup files for a manually managed app. |
924
- | `manifest` | Generate Slack manifests. `--env` defaults to `both`; with `--print`, select one environment when you need one JSON document. |
906
+ | `manifest` | Generate Slack manifests. `--env` defaults to `both`; with `--dry-run`, select one environment when you need one JSON document. |
925
907
  | `doctor` | Check both tokens, Socket Mode connectivity, Slack authentication, and any repeatable `--channel` values. |
926
908
 
927
909
  The default token prefix is the project directory name normalized to upper
@@ -936,17 +918,17 @@ See [Slack](/docs/guides/slack.md) for app consent and manual setup.
936
918
  ### Test GitHub webhooks {#github}
937
919
 
938
920
  ```text
939
- bdk github forward [--dir <path>] [--slug <slug>] [--channel <id>]
921
+ agent-sdk github forward [--dir <path>] [--slug <slug>] [--channel <id>]
940
922
  [--repo owner/repo | --org <org>] [--events a,b,c]
941
923
  [--url <url>] [--host <host>] [--port <n>]
942
924
  [--secret <secret>] [--install]
943
- bdk github replay <pr-url-or-owner/repo#N>
925
+ agent-sdk github replay <pr-url-or-owner/repo#N>
944
926
  [--events a,b,c | '*'] [--action <action>] [--conclusion <result>]
945
927
  [--comment <body>] [--context <name>] [--dir <path>]
946
928
  [--slug <slug>] [--channel <id>] [--url <url>]
947
- [--secret <secret>] [--dry-run] [--out <dir>] [--json]
948
- bdk github events [--dir <path>] [--host <host>] [--port <n>] [--json]
949
- bdk github doctor [--install] [--json]
929
+ [--secret <secret>] [--dry-run] [--fixtures-dir <dir>] [--json]
930
+ agent-sdk github events [--dir <path>] [--host <host>] [--port <n>] [--json]
931
+ agent-sdk github doctor [--install] [--json]
950
932
  ```
951
933
 
952
934
  | Subcommand | Contract |
@@ -958,7 +940,7 @@ bdk github doctor [--install] [--json]
958
940
 
959
941
  Replay supports `pull_request`, `issue_comment`,
960
942
  `pull_request_review_comment`, `check_run`, `check_suite`, `workflow_run`, and
961
- `status`. `--dry-run` prints without posting. `--out` writes fixtures and
943
+ `status`. `--dry-run` prints without posting. `--fixtures-dir` writes fixtures and
962
944
  still posts unless combined with `--dry-run`.
963
945
 
964
946
  Forwarding requires repository admin access, or organization owner access for
@@ -970,14 +952,14 @@ See [GitHub](/docs/guides/github.md) for channel setup and live delivery.
970
952
  ### Test GitLab webhooks {#gitlab}
971
953
 
972
954
  ```text
973
- bdk gitlab replay <mr-url-or-group/project!N>
955
+ agent-sdk gitlab replay <mr-url-or-group/project!N>
974
956
  [--events a,b,c | '*'] [--action <action>]
975
957
  [--conclusion <status>] [--comment <body>]
976
958
  [--dir <path>] [--slug <slug>] [--channel <id>]
977
959
  [--url <url>] [--host <host>] [--port <n>]
978
- [--secret <secret>] [--dry-run] [--out <dir>] [--json]
979
- bdk gitlab events [--dir <path>] [--host <host>] [--port <n>] [--json]
980
- bdk gitlab forward [--dir <path>] [--host <host>] [--port <n>]
960
+ [--secret <secret>] [--dry-run] [--fixtures-dir <dir>] [--json]
961
+ agent-sdk gitlab events [--dir <path>] [--host <host>] [--port <n>] [--json]
962
+ agent-sdk gitlab forward [--dir <path>] [--host <host>] [--port <n>]
981
963
  ```
982
964
 
983
965
  | Subcommand | Contract |
@@ -988,7 +970,7 @@ bdk gitlab forward [--dir <path>] [--host <host>] [--port <n>]
988
970
 
989
971
  Replay supports `merge_request`, `note`, `pipeline`, and `push`. It requires
990
972
  `GITLAB_TOKEN` with project read access. `--secret` defaults to
991
- `GITLAB_WEBHOOK_SECRET`; `--dry-run` and `--out` follow the GitHub replay
973
+ `GITLAB_WEBHOOK_SECRET`; `--dry-run` and `--fixtures-dir` follow the GitHub replay
992
974
  contract.
993
975
 
994
976
  See [GitLab](/docs/guides/gitlab.md) for channel setup and self-managed hosts.
@@ -996,13 +978,13 @@ See [GitLab](/docs/guides/gitlab.md) for channel setup and self-managed hosts.
996
978
  ### Test Bitbucket webhooks {#bitbucket}
997
979
 
998
980
  ```text
999
- bdk bitbucket replay <pr-url-or-workspace/repo#N>
981
+ agent-sdk bitbucket replay <pr-url-or-workspace/repo#N>
1000
982
  [--events a,b,c | '*'] [--comment <body>]
1001
983
  [--dir <path>] [--slug <slug>] [--channel <id>]
1002
984
  [--url <url>] [--host <host>] [--port <n>]
1003
- [--secret <secret>] [--dry-run] [--out <dir>] [--json]
1004
- bdk bitbucket events [--dir <path>] [--host <host>] [--port <n>] [--json]
1005
- bdk bitbucket forward [--dir <path>] [--host <host>] [--port <n>]
985
+ [--secret <secret>] [--dry-run] [--fixtures-dir <dir>] [--json]
986
+ agent-sdk bitbucket events [--dir <path>] [--host <host>] [--port <n>] [--json]
987
+ agent-sdk bitbucket forward [--dir <path>] [--host <host>] [--port <n>]
1006
988
  ```
1007
989
 
1008
990
  | Subcommand | Contract |
@@ -1022,12 +1004,12 @@ See [Bitbucket](/docs/guides/bitbucket.md) for Cloud and Data Center setup.
1022
1004
  ### Test PagerDuty webhooks {#pagerduty}
1023
1005
 
1024
1006
  ```text
1025
- bdk pagerduty replay [incident-id]
1007
+ agent-sdk pagerduty replay [incident-id]
1026
1008
  [--events a,b,c | '*'] [--comment <body>]
1027
1009
  [--dir <path>] [--slug <slug>] [--channel <id>]
1028
1010
  [--url <url>] [--host <host>] [--port <n>]
1029
- [--secret <secret>] [--dry-run] [--out <dir>] [--json]
1030
- bdk pagerduty events [--dir <path>] [--host <host>] [--port <n>] [--json]
1011
+ [--secret <secret>] [--dry-run] [--fixtures-dir <dir>] [--json]
1012
+ agent-sdk pagerduty events [--dir <path>] [--host <host>] [--port <n>] [--json]
1031
1013
  ```
1032
1014
 
1033
1015
  | Subcommand | Contract |
@@ -1040,7 +1022,7 @@ Replay supports `incident.triggered`, `.acknowledged`, `.annotated`,
1040
1022
  (`resolved`). It needs no PagerDuty account. The incident id defaults to
1041
1023
  `PREPLAY1`, and `--comment` is the note body for `annotated`. `--secret`
1042
1024
  defaults to `PAGERDUTY_WEBHOOK_SECRET`, signing with its first line when it
1043
- lists several; without either the deliveries are unsigned, which `bdk dev`
1025
+ lists several; without either the deliveries are unsigned, which `agent-sdk dev`
1044
1026
  admits from loopback. `--dry-run` and `--out`
1045
1027
  follow the GitHub replay contract.
1046
1028
 
@@ -1057,7 +1039,7 @@ Credential resolution follows this order: `--api-key`, `CURSOR_API_KEY`,
1057
1039
  | `CURSOR_API_KEY_FILE` | Path to a Cursor credential file. |
1058
1040
  | `CURSOR_SERVICE_ACCOUNT_KEY` | Team service-account credential used after the API key and key-file sources. |
1059
1041
  | `CURSOR_API_BASE_URL` | Backend for login, account, deployment, and event commands. |
1060
- | `CURSOR_BACKEND_URL` | Backend for BDK turns. Set it with `CURSOR_API_BASE_URL` when using a non-default backend. |
1042
+ | `CURSOR_BACKEND_URL` | Backend for Agent SDK turns. Set it with `CURSOR_API_BASE_URL` when using a non-default backend. |
1061
1043
  | `AGENT_SERVE_CONFIG_DIR` | Override the CLI config directory for stored credentials and update state. |
1062
1044
  | `AGENT_SERVE_NO_UPDATE_CHECK`, `NO_UPDATE_NOTIFIER`, `CI` | Disable published-version checks when set to a non-empty value other than `0`. |
1063
1045
  | `GITHUB_WEBHOOK_SECRET` | Default signature secret for GitHub forwarding and replay. |
@@ -1073,18 +1055,33 @@ Credential resolution follows this order: `--api-key`, `CURSOR_API_KEY`,
1073
1055
 
1074
1056
  ## Exit status
1075
1057
 
1058
+ Every command uses one exit code table. `agent-sdk help` prints it, and
1059
+ `agent-sdk help --json` includes it as `exitCodes`.
1060
+
1061
+ | Code | Meaning |
1062
+ | --- | --- |
1063
+ | `0` | ok |
1064
+ | `1` | failed (also `aborted`, `invalid_argument`, `rate_limited`, `unavailable`) |
1065
+ | `2` | usage: bad command, flag, or argument |
1066
+ | `3` | pending: the work is still running |
1067
+ | `4` | `not_found` |
1068
+ | `5` | `unauthenticated` or `permission_denied` |
1069
+ | `6` | `conflict` or `failed_precondition` |
1070
+
1076
1071
  | Command | Nonzero contract |
1077
1072
  | --- | --- |
1078
- | No command | Print help and exit `1`. Explicit `help`, `--help`, and `-h` exit `0`. |
1073
+ | No command | Print the command index and exit `0`. An unknown command exits `2`. |
1079
1074
  | `run` | For local and running-server trajectories, exit `1` when the trajectory fails. |
1080
- | `call` | Exit `1` unless the response succeeds with `ok: true`. |
1081
- | `skill` | Exit `2` when the name is missing and `1` when the request fails. |
1082
- | `trajectory` | Exit `1` when the reconstructed trajectory failed. |
1075
+ | `tool call` | Exit `1` unless the response succeeds with `ok: true`. |
1076
+ | `session get --file` | Exit `1` when the reconstructed trajectory failed. |
1077
+ | `session create --wait` | Exit `3` when the delivery names no session before `--timeout-ms`, and `1` when it was skipped or failed. |
1083
1078
  | `eval` | Exit `1` for failed cases, or scored cases below threshold with `--strict`; exit `2` for invalid eval options or an execution with no matching cases. An empty `--list` succeeds. |
1084
- | `eval status` | Exit `3` while the batch runs, `1` when it failed or was cancelled, and `2` for invalid usage. |
1085
- | `chat`, `session` | Exit `2` for documented option conflicts or missing required input. |
1079
+ | `eval get` | Exit `3` while the batch runs, `1` when it failed or was cancelled, and `2` for invalid usage. |
1080
+ | `chat`, `session get` | Exit `2` for documented option conflicts or missing required input. |
1086
1081
  | `validate` | Exit `1` when any project diagnostic has error severity. |
1087
- | `convert-automation` | Exit `1` for invalid input, authentication, export, or file-write failure. Warnings and dependency-install failure don't change a successful conversion exit. |
1082
+ | Commands that cannot be undone | Exit `2` without `--yes` when there is no terminal to ask on. Exit `1` (`aborted`) when the typed confirmation does not match. |
1083
+ | Any command with `--dry-run` | Exit `0` after printing what it would do, unless a check before the first change fails. |
1084
+ | `init --from automation:…` | Exit `1` for invalid input, authentication, export, or file-write failure. Warnings and dependency-install failure don't change a successful conversion exit. |
1088
1085
  | `migrate` | Exit `0` when nothing needs a migration, after starting with `--no-wait`, or after the agent opens a pull request. Exit `1` for invalid input, authentication or agent failure, or a completed run without a pull request. |
1089
1086
  | Other commands | Exit nonzero when validation, authentication, a request, or the requested operation fails. |
1090
1087