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