@grok/agent-sdk 0.2.27 → 0.2.29

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 (1332) hide show
  1. package/AGENTS.md +42 -37
  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 +1 -1
  98. package/dist/channels/pagerduty/pagerduty-channel.d.ts.map +1 -1
  99. package/dist/channels/pagerduty/pagerduty-channel.js +2 -1
  100. package/dist/channels/pagerduty/pagerduty-webhook.d.ts.map +1 -1
  101. package/dist/channels/pagerduty/pagerduty-webhook.js +20 -11
  102. package/dist/channels/pagerduty/payload.d.ts.map +1 -1
  103. package/dist/channels/pagerduty/payload.js +2 -3
  104. package/dist/channels/pagerduty/replay.d.ts +1 -1
  105. package/dist/channels/pagerduty/replay.d.ts.map +1 -1
  106. package/dist/channels/pagerduty/replay.js +8 -5
  107. package/dist/channels/pagerduty/self-user.d.ts.map +1 -1
  108. package/dist/channels/pagerduty/self-user.js +8 -9
  109. package/dist/channels/runs/runs-channel.d.ts.map +1 -1
  110. package/dist/channels/runs/runs-channel.js +8 -2
  111. package/dist/channels/runs/types.d.ts +2 -2
  112. package/dist/channels/runs/types.d.ts.map +1 -1
  113. package/dist/channels/slack/agentic-delivery.d.ts +20 -1
  114. package/dist/channels/slack/agentic-delivery.d.ts.map +1 -1
  115. package/dist/channels/slack/agentic-delivery.js +77 -12
  116. package/dist/channels/slack/agentic-signals.d.ts +2 -0
  117. package/dist/channels/slack/agentic-signals.d.ts.map +1 -1
  118. package/dist/channels/slack/agentic-signals.js +24 -7
  119. package/dist/channels/slack/api.d.ts +1 -1
  120. package/dist/channels/slack/api.d.ts.map +1 -1
  121. package/dist/channels/slack/api.js +12 -13
  122. package/dist/channels/slack/approvals.d.ts.map +1 -1
  123. package/dist/channels/slack/approvals.js +5 -4
  124. package/dist/channels/slack/attachments.d.ts.map +1 -1
  125. package/dist/channels/slack/attachments.js +34 -9
  126. package/dist/channels/slack/auth.d.ts.map +1 -1
  127. package/dist/channels/slack/auth.js +3 -1
  128. package/dist/channels/slack/bot-mentions.d.ts.map +1 -1
  129. package/dist/channels/slack/bot-mentions.js +2 -4
  130. package/dist/channels/slack/cli-project.d.ts.map +1 -1
  131. package/dist/channels/slack/cli-project.js +7 -10
  132. package/dist/channels/slack/constants.d.ts +7 -0
  133. package/dist/channels/slack/constants.d.ts.map +1 -1
  134. package/dist/channels/slack/constants.js +7 -0
  135. package/dist/channels/slack/defaults.d.ts +12 -0
  136. package/dist/channels/slack/defaults.d.ts.map +1 -1
  137. package/dist/channels/slack/defaults.js +10 -2
  138. package/dist/channels/slack/dispatch.d.ts +7 -1
  139. package/dist/channels/slack/dispatch.d.ts.map +1 -1
  140. package/dist/channels/slack/dispatch.js +88 -13
  141. package/dist/channels/slack/doctor.d.ts.map +1 -1
  142. package/dist/channels/slack/doctor.js +11 -11
  143. package/dist/channels/slack/inbound.d.ts +7 -0
  144. package/dist/channels/slack/inbound.d.ts.map +1 -1
  145. package/dist/channels/slack/inbound.js +25 -4
  146. package/dist/channels/slack/index.d.ts +2 -2
  147. package/dist/channels/slack/index.d.ts.map +1 -1
  148. package/dist/channels/slack/index.js +2 -2
  149. package/dist/channels/slack/init.d.ts +2 -0
  150. package/dist/channels/slack/init.d.ts.map +1 -1
  151. package/dist/channels/slack/init.js +10 -2
  152. package/dist/channels/slack/interactive.d.ts +6 -1
  153. package/dist/channels/slack/interactive.d.ts.map +1 -1
  154. package/dist/channels/slack/interactive.js +15 -25
  155. package/dist/channels/slack/manifest.d.ts.map +1 -1
  156. package/dist/channels/slack/manifest.js +15 -12
  157. package/dist/channels/slack/message-body.d.ts.map +1 -1
  158. package/dist/channels/slack/message-body.js +2 -4
  159. package/dist/channels/slack/nudge-carrier.d.ts.map +1 -1
  160. package/dist/channels/slack/nudge-carrier.js +27 -1
  161. package/dist/channels/slack/nudge-store.d.ts.map +1 -1
  162. package/dist/channels/slack/nudge-store.js +8 -3
  163. package/dist/channels/slack/placeholder.d.ts +3 -0
  164. package/dist/channels/slack/placeholder.d.ts.map +1 -1
  165. package/dist/channels/slack/placeholder.js +6 -5
  166. package/dist/channels/slack/recording-sink.d.ts.map +1 -1
  167. package/dist/channels/slack/recording-sink.js +4 -3
  168. package/dist/channels/slack/sender-name.d.ts.map +1 -1
  169. package/dist/channels/slack/sender-name.js +2 -3
  170. package/dist/channels/slack/slack-channel.d.ts +1 -3
  171. package/dist/channels/slack/slack-channel.d.ts.map +1 -1
  172. package/dist/channels/slack/slack-channel.js +63 -86
  173. package/dist/channels/slack/thread-context.d.ts.map +1 -1
  174. package/dist/channels/slack/thread-context.js +4 -9
  175. package/dist/channels/slack/tool-cards.d.ts.map +1 -1
  176. package/dist/channels/slack/tool-cards.js +4 -0
  177. package/dist/channels/slack/types.d.ts +19 -4
  178. package/dist/channels/slack/types.d.ts.map +1 -1
  179. package/dist/channels/slack/upload.d.ts +2 -0
  180. package/dist/channels/slack/upload.d.ts.map +1 -1
  181. package/dist/channels/slack/upload.js +49 -12
  182. package/dist/channels/slack/user-info.d.ts.map +1 -1
  183. package/dist/channels/slack/user-info.js +3 -6
  184. package/dist/channels.d.ts +11 -11
  185. package/dist/channels.d.ts.map +1 -1
  186. package/dist/channels.js +57 -30
  187. package/dist/connections.d.ts +1 -1
  188. package/dist/connections.js +1 -1
  189. package/dist/docs/404.html +4 -4
  190. package/dist/docs/architecture.svg +1 -1
  191. package/dist/docs/assets/{app.wA5xBBcd.js → app.DMrZKFjI.js} +4 -4
  192. package/dist/docs/assets/building-with-agents.md.Bf1yH2tG.js +9 -0
  193. package/dist/docs/assets/building-with-agents.md.Bf1yH2tG.lean.js +1 -0
  194. package/dist/docs/assets/changelog.md.DrLFQUlu.js +1 -0
  195. package/dist/docs/assets/changelog.md.DrLFQUlu.lean.js +1 -0
  196. package/dist/docs/assets/chunks/@localSearchIndexroot.Dpd_wxVU.js +1 -0
  197. package/dist/docs/assets/chunks/{VPLocalSearchBox.C29HLCVL.js → VPLocalSearchBox.DQvuw1KA.js} +1 -1
  198. package/dist/docs/assets/chunks/{arc.BOaoYWmh.js → arc.ahOG-Qza.js} +1 -1
  199. package/dist/docs/assets/chunks/{architectureDiagram-Q4EWVU46.MfG0itQh.js → architectureDiagram-Q4EWVU46.BcgfYNO_.js} +1 -1
  200. package/dist/docs/assets/chunks/{baseUniq.CUeJciCF.js → baseUniq.DeIYZrWh.js} +1 -1
  201. package/dist/docs/assets/chunks/{blockDiagram-DXYQGD6D.BrXMZRtK.js → blockDiagram-DXYQGD6D.HjJ2goMX.js} +1 -1
  202. package/dist/docs/assets/chunks/{c4Diagram-AHTNJAMY.DfkDHeB9.js → c4Diagram-AHTNJAMY.C1QTb9GM.js} +1 -1
  203. package/dist/docs/assets/chunks/channel._fZX_hvU.js +1 -0
  204. package/dist/docs/assets/chunks/{chunk-4BX2VUAB.xKz8CiXK.js → chunk-4BX2VUAB.UuZiDiVp.js} +1 -1
  205. package/dist/docs/assets/chunks/{chunk-4TB4RGXK.kkfBh4zk.js → chunk-4TB4RGXK.5A3YmkhI.js} +1 -1
  206. package/dist/docs/assets/chunks/{chunk-55IACEB6.BClJGb94.js → chunk-55IACEB6.B4uf1yYV.js} +1 -1
  207. package/dist/docs/assets/chunks/{chunk-EDXVE4YY.P9BpQ9L3.js → chunk-EDXVE4YY.CoXBce8t.js} +1 -1
  208. package/dist/docs/assets/chunks/{chunk-FMBD7UC4.R4iYi58S.js → chunk-FMBD7UC4.DnC5NO4e.js} +1 -1
  209. package/dist/docs/assets/chunks/{chunk-OYMX7WX6.Cpn8L1dw.js → chunk-OYMX7WX6.CzfHCeIi.js} +1 -1
  210. package/dist/docs/assets/chunks/{chunk-QZHKN3VN.BLftECqU.js → chunk-QZHKN3VN.C6tcwkVd.js} +1 -1
  211. package/dist/docs/assets/chunks/{chunk-YZCP3GAM.BWDV1AYt.js → chunk-YZCP3GAM._oboyZ1A.js} +1 -1
  212. package/dist/docs/assets/chunks/classDiagram-6PBFFD2Q.eClS1Q0E.js +1 -0
  213. package/dist/docs/assets/chunks/classDiagram-v2-HSJHXN6E.eClS1Q0E.js +1 -0
  214. package/dist/docs/assets/chunks/clone.W1Phdw9P.js +1 -0
  215. package/dist/docs/assets/chunks/{cose-bilkent-S5V4N54A.DGpAcJ55.js → cose-bilkent-S5V4N54A.BfPVKeId.js} +1 -1
  216. package/dist/docs/assets/chunks/{dagre-KV5264BT.BBXxGEaD.js → dagre-KV5264BT.CLMLc0lD.js} +1 -1
  217. package/dist/docs/assets/chunks/{diagram-5BDNPKRD.EKqOwmK2.js → diagram-5BDNPKRD.C7OF7UfH.js} +1 -1
  218. package/dist/docs/assets/chunks/{diagram-G4DWMVQ6.CB8pdkoZ.js → diagram-G4DWMVQ6.Dpao0Bl1.js} +1 -1
  219. package/dist/docs/assets/chunks/{diagram-MMDJMWI5.aHh4WGg9.js → diagram-MMDJMWI5.DLnM9eLp.js} +1 -1
  220. package/dist/docs/assets/chunks/{diagram-TYMM5635.YIsbRH20.js → diagram-TYMM5635.BcpVgA_M.js} +1 -1
  221. package/dist/docs/assets/chunks/{erDiagram-SMLLAGMA.B3bTCW_e.js → erDiagram-SMLLAGMA.CsL5JuCV.js} +1 -1
  222. package/dist/docs/assets/chunks/{flowDiagram-DWJPFMVM.M81hXIXZ.js → flowDiagram-DWJPFMVM.MFihq9AF.js} +1 -1
  223. package/dist/docs/assets/chunks/{ganttDiagram-T4ZO3ILL.BKg7WY--.js → ganttDiagram-T4ZO3ILL.CJeLodyG.js} +1 -1
  224. package/dist/docs/assets/chunks/{gitGraphDiagram-UUTBAWPF.CLEMZgO3.js → gitGraphDiagram-UUTBAWPF.1HhlE45Z.js} +1 -1
  225. package/dist/docs/assets/chunks/{graph.DS38W_Q-.js → graph.BS02KkWA.js} +1 -1
  226. package/dist/docs/assets/chunks/{infoDiagram-42DDH7IO.BTiWTi82.js → infoDiagram-42DDH7IO.fp5gvytQ.js} +1 -1
  227. package/dist/docs/assets/chunks/{ishikawaDiagram-UXIWVN3A.DcqY_KQL.js → ishikawaDiagram-UXIWVN3A.C6Wk1V4I.js} +1 -1
  228. package/dist/docs/assets/chunks/{journeyDiagram-VCZTEJTY.0lQNZ40U.js → journeyDiagram-VCZTEJTY.qJt4uJ_H.js} +1 -1
  229. package/dist/docs/assets/chunks/{kanban-definition-6JOO6SKY.L5sKlf7X.js → kanban-definition-6JOO6SKY.z2tG9kly.js} +1 -1
  230. package/dist/docs/assets/chunks/{layout.7u4gFhQa.js → layout.BPCkdejr.js} +1 -1
  231. package/dist/docs/assets/chunks/{linear.D5v33SOb.js → linear.CL3TC3u7.js} +1 -1
  232. package/dist/docs/assets/chunks/{min.Dc9uCxf9.js → min.SPrSp704.js} +1 -1
  233. package/dist/docs/assets/chunks/{mindmap-definition-QFDTVHPH.B56nGoB_.js → mindmap-definition-QFDTVHPH.DgrQRFZW.js} +1 -1
  234. package/dist/docs/assets/chunks/{pieDiagram-DEJITSTG.Cba8e8lS.js → pieDiagram-DEJITSTG.Ba7yxiW2.js} +1 -1
  235. package/dist/docs/assets/chunks/{quadrantDiagram-34T5L4WZ.2YjBycHF.js → quadrantDiagram-34T5L4WZ.Bvskad4p.js} +1 -1
  236. package/dist/docs/assets/chunks/{requirementDiagram-MS252O5E.D4P5RqVI.js → requirementDiagram-MS252O5E.Ce70ugV9.js} +1 -1
  237. package/dist/docs/assets/chunks/{sankeyDiagram-XADWPNL6.C0Hn8NUm.js → sankeyDiagram-XADWPNL6.BJ5OEULO.js} +1 -1
  238. package/dist/docs/assets/chunks/{sequenceDiagram-FGHM5R23.BZm7EaoT.js → sequenceDiagram-FGHM5R23.C8a1hDs6.js} +1 -1
  239. package/dist/docs/assets/chunks/{stateDiagram-FHFEXIEX.DcR4f3X2.js → stateDiagram-FHFEXIEX.D2D8A5CK.js} +1 -1
  240. package/dist/docs/assets/chunks/stateDiagram-v2-QKLJ7IA2.77yf4kRr.js +1 -0
  241. package/dist/docs/assets/chunks/{theme.DvfKzyXq.js → theme.DRciHmS1.js} +2 -2
  242. package/dist/docs/assets/chunks/{timeline-definition-GMOUNBTQ.CgDh96vg.js → timeline-definition-GMOUNBTQ.C4ePrY8-.js} +1 -1
  243. package/dist/docs/assets/chunks/{vennDiagram-DHZGUBPP.B4fagbC8.js → vennDiagram-DHZGUBPP.Dzso6dEA.js} +1 -1
  244. package/dist/docs/assets/chunks/{wardley-RL74JXVD.Ck68omim.js → wardley-RL74JXVD.djgXR0ar.js} +1 -1
  245. package/dist/docs/assets/chunks/{wardleyDiagram-NUSXRM2D.DBUg0bvz.js → wardleyDiagram-NUSXRM2D.Bf2ICxjh.js} +1 -1
  246. package/dist/docs/assets/chunks/{xychartDiagram-5P7HB3ND.DnKSGQE1.js → xychartDiagram-5P7HB3ND.DEH4BcVJ.js} +1 -1
  247. package/dist/docs/assets/deployment.md.KW0Ni_rY.js +31 -0
  248. package/dist/docs/assets/deployment.md.KW0Ni_rY.lean.js +1 -0
  249. package/dist/docs/assets/{evals.md.CHR34K1Y.js → evals.md.DiljU__Z.js} +10 -10
  250. package/dist/docs/assets/{guides_agent-to-agent.md.CwL5cwuE.js → guides_agent-to-agent.md.D1D5f6Jc.js} +7 -7
  251. package/dist/docs/assets/guides_agent-to-agent.md.D1D5f6Jc.lean.js +1 -0
  252. package/dist/docs/assets/{guides_bitbucket.md.CKUayYtD.js → guides_bitbucket.md.DkjkBRU8.js} +3 -3
  253. package/dist/docs/assets/guides_cloud-agents.md.Ceyjv0ul.js +9 -0
  254. package/dist/docs/assets/guides_cloud-agents.md.Ceyjv0ul.lean.js +1 -0
  255. package/dist/docs/assets/{guides_convert-automation.md.DMEX9nF-.js → guides_convert-automation.md.BjraCvok.js} +11 -11
  256. package/dist/docs/assets/guides_convert-automation.md.BjraCvok.lean.js +1 -0
  257. package/dist/docs/assets/{guides_github.md.TuNiZAOQ.js → guides_github.md.CgN5sNbW.js} +14 -14
  258. package/dist/docs/assets/{guides_github.md.TuNiZAOQ.lean.js → guides_github.md.CgN5sNbW.lean.js} +1 -1
  259. package/dist/docs/assets/{guides_gitlab.md.CtNI4fSH.js → guides_gitlab.md.DCE0p7_w.js} +3 -3
  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.CEqLgjj9.js} +12 -12
  265. package/dist/docs/assets/{guides_jev.md.D7XH4JH3.lean.js → guides_jev.md.CEqLgjj9.lean.js} +1 -1
  266. package/dist/docs/assets/{guides_mcp-oauth.md.Cxq2TxBB.js → guides_mcp-oauth.md.DrGY92u4.js} +8 -8
  267. package/dist/docs/assets/{guides_mcp-oauth.md.Cxq2TxBB.lean.js → guides_mcp-oauth.md.DrGY92u4.lean.js} +1 -1
  268. package/dist/docs/assets/guides_migrate.md.RS9Eu-Xh.js +8 -0
  269. package/dist/docs/assets/guides_migrate.md.RS9Eu-Xh.lean.js +1 -0
  270. package/dist/docs/assets/guides_opentelemetry.md.CoZ1kNyd.js +28 -0
  271. package/dist/docs/assets/guides_opentelemetry.md.CoZ1kNyd.lean.js +1 -0
  272. package/dist/docs/assets/{guides_pagerduty.md.BHXMcMtx.js → guides_pagerduty.md.mnKXe9U0.js} +10 -10
  273. package/dist/docs/assets/{guides_slack.md.ClIyi7FI.js → guides_slack.md.BwXHURvY.js} +21 -8
  274. package/dist/docs/assets/{guides_slack.md.ClIyi7FI.lean.js → guides_slack.md.BwXHURvY.lean.js} +1 -1
  275. package/dist/docs/assets/{guides_webhooks.md.Cpdc3BDX.js → guides_webhooks.md.BJk63ZTs.js} +9 -5
  276. package/dist/docs/assets/{guides_webhooks.md.Cpdc3BDX.lean.js → guides_webhooks.md.BJk63ZTs.lean.js} +1 -1
  277. package/dist/docs/assets/{hillclimbing.md.Dxvd-0gT.js → hillclimbing.md.By61f3uq.js} +2 -2
  278. package/dist/docs/assets/index.md.CAruw_rp.js +26 -0
  279. package/dist/docs/assets/index.md.CAruw_rp.lean.js +1 -0
  280. package/dist/docs/assets/{quickstart.md.D8JDfkKO.js → quickstart.md.CljDaJBi.js} +12 -12
  281. package/dist/docs/assets/quickstart.md.CljDaJBi.lean.js +1 -0
  282. package/dist/docs/assets/reference_access.md.CEtibb4i.js +1 -0
  283. package/dist/docs/assets/reference_access.md.CEtibb4i.lean.js +1 -0
  284. package/dist/docs/assets/{reference_agent-config.md.CZrbHOfT.js → reference_agent-config.md.Ck29qYNj.js} +10 -8
  285. package/dist/docs/assets/{reference_agent-config.md.CZrbHOfT.lean.js → reference_agent-config.md.Ck29qYNj.lean.js} +1 -1
  286. package/dist/docs/assets/{reference_artifacts.md.DLV9MZES.js → reference_artifacts.md.C-hKR2hp.js} +2 -2
  287. package/dist/docs/assets/reference_channels.md.DsJfGSBJ.js +22 -0
  288. package/dist/docs/assets/{reference_channels.md.CNNIS6K7.lean.js → reference_channels.md.DsJfGSBJ.lean.js} +1 -1
  289. package/dist/docs/assets/reference_cli.md.BkdLRbXg.js +99 -0
  290. package/dist/docs/assets/reference_cli.md.BkdLRbXg.lean.js +1 -0
  291. package/dist/docs/assets/{reference_connections.md.BJE2Zllp.js → reference_connections.md.BoAotr7_.js} +7 -7
  292. package/dist/docs/assets/{reference_evals.md.Ccwp4x3o.js → reference_evals.md.2BXeMiO2.js} +31 -11
  293. package/dist/docs/assets/{reference_evals.md.Ccwp4x3o.lean.js → reference_evals.md.2BXeMiO2.lean.js} +1 -1
  294. package/dist/docs/assets/{reference_extensions.md.DKxTuCIw.js → reference_extensions.md.DI5X5x8p.js} +10 -10
  295. package/dist/docs/assets/{reference_extensions.md.DKxTuCIw.lean.js → reference_extensions.md.DI5X5x8p.lean.js} +1 -1
  296. package/dist/docs/assets/{reference_hooks.md.CROr0QgC.js → reference_hooks.md.B-bwJuiG.js} +5 -5
  297. package/dist/docs/assets/{reference_http-api.md.Dji-DD_Z.js → reference_http-api.md._RWELr3d.js} +1 -1
  298. package/dist/docs/assets/{reference_instructions.md.BYMVxAkw.js → reference_instructions.md.yL2hXLnl.js} +1 -1
  299. package/dist/docs/assets/reference_limits.md.BCCnvt3o.js +8 -0
  300. package/dist/docs/assets/reference_limits.md.BCCnvt3o.lean.js +1 -0
  301. package/dist/docs/assets/reference_memory.md.Dd7cyV9V.js +4 -0
  302. package/dist/docs/assets/reference_playground.md.CQiJk9CM.js +1 -0
  303. package/dist/docs/assets/{reference_project-layout.md.mFcS8yDD.js → reference_project-layout.md.BamcPDUn.js} +4 -4
  304. package/dist/docs/assets/{reference_prompt.md.DqPh71XN.js → reference_prompt.md.BMjm1Jp3.js} +2 -2
  305. package/dist/docs/assets/{reference_schedules.md.BqWnJES4.js → reference_schedules.md.RC47aFm4.js} +4 -4
  306. package/dist/docs/assets/{reference_sessions.md.Bi6lHttM.js → reference_sessions.md.C7KFhWXV.js} +1 -1
  307. package/dist/docs/assets/{reference_skills.md.Ckddg6KX.js → reference_skills.md.Dej2zQxi.js} +2 -2
  308. package/dist/docs/assets/{reference_skills.md.Ckddg6KX.lean.js → reference_skills.md.Dej2zQxi.lean.js} +1 -1
  309. package/dist/docs/assets/{reference_subagents.md.ChNGh6HK.js → reference_subagents.md.CAhvW4yS.js} +1 -1
  310. package/dist/docs/assets/{reference_tools.md.Bo0UfT0a.js → reference_tools.md.DQr7Fnhu.js} +10 -10
  311. package/dist/docs/assets/{reference_tools.md.Bo0UfT0a.lean.js → reference_tools.md.DQr7Fnhu.lean.js} +1 -1
  312. package/dist/docs/assets/{style.B9o0luvp.css → style.DK0YX1WL.css} +1 -1
  313. package/dist/docs/assets/{templates_agentic-owners.md.CTEnR0jp.js → templates_agentic-owners.md.Dh2nDSqg.js} +4 -4
  314. package/dist/docs/assets/templates_security-reviewer.md.DnwXdnB5.js +3 -0
  315. package/dist/docs/assets/templates_thermo-quality-review.md.MJIdHkzE.js +3 -0
  316. package/dist/docs/assets/{templates_thermo-quality-review.md.B77UyTrX.lean.js → templates_thermo-quality-review.md.MJIdHkzE.lean.js} +1 -1
  317. package/dist/docs/assets/templates_thermo-review.md.DfN1OFOl.js +3 -0
  318. package/dist/docs/assets/{templates_thermo-review.md.DRJ7mC5U.lean.js → templates_thermo-review.md.DfN1OFOl.lean.js} +1 -1
  319. package/dist/docs/assets/{templates_triage.md.CNN6b0JZ.js → templates_triage.md.BYWMloV4.js} +4 -4
  320. package/dist/docs/assets/troubleshooting.md.CGOdNVAL.js +1 -0
  321. package/dist/docs/building-with-agents.html +46 -46
  322. package/dist/docs/building-with-agents.md +20 -20
  323. package/dist/docs/changelog.html +39 -39
  324. package/dist/docs/changelog.md +57 -11
  325. package/dist/docs/deployment.html +54 -54
  326. package/dist/docs/deployment.md +115 -53
  327. package/dist/docs/evals.html +48 -48
  328. package/dist/docs/evals.md +15 -13
  329. package/dist/docs/guides/agent-to-agent.html +45 -45
  330. package/dist/docs/guides/agent-to-agent.md +7 -7
  331. package/dist/docs/guides/bitbucket.html +41 -41
  332. package/dist/docs/guides/bitbucket.md +5 -5
  333. package/dist/docs/guides/cloud-agents.html +41 -41
  334. package/dist/docs/guides/cloud-agents.md +3 -3
  335. package/dist/docs/guides/convert-automation.html +49 -49
  336. package/dist/docs/guides/convert-automation.md +16 -15
  337. package/dist/docs/guides/github.html +50 -50
  338. package/dist/docs/guides/github.md +17 -17
  339. package/dist/docs/guides/gitlab.html +41 -41
  340. package/dist/docs/guides/gitlab.md +5 -5
  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 +41 -41
  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 +15 -10
  347. package/dist/docs/guides/mcp-oauth.html +45 -45
  348. package/dist/docs/guides/mcp-oauth.md +10 -11
  349. package/dist/docs/guides/migrate.html +43 -42
  350. package/dist/docs/guides/migrate.md +36 -29
  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 +87 -17
  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 +4 -4
  362. package/dist/docs/index.html +56 -57
  363. package/dist/docs/index.md +31 -31
  364. package/dist/docs/llms-full.txt +1333 -1417
  365. package/dist/docs/llms.txt +13 -14
  366. package/dist/docs/package/skills/create-agent/SKILL.md +178 -0
  367. package/dist/docs/package/skills/evals/SKILL.md +145 -0
  368. package/dist/docs/package/skills/github/SKILL.md +133 -0
  369. package/dist/docs/package/skills/hillclimb/SKILL.md +63 -0
  370. package/dist/docs/package/skills/mcp-auth/SKILL.md +60 -0
  371. package/dist/docs/package/skills/migrate-v2/SKILL.md +394 -0
  372. package/dist/docs/package/skills/setup-slack/SKILL.md +136 -0
  373. package/dist/docs/quickstart.html +50 -50
  374. package/dist/docs/quickstart.md +25 -21
  375. package/dist/docs/reference/access.html +60 -0
  376. package/dist/docs/reference/access.md +22 -0
  377. package/dist/docs/reference/agent-config.html +46 -44
  378. package/dist/docs/reference/agent-config.md +54 -12
  379. package/dist/docs/reference/artifacts.html +39 -39
  380. package/dist/docs/reference/artifacts.md +2 -2
  381. package/dist/docs/reference/channels.html +39 -39
  382. package/dist/docs/reference/channels.md +29 -9
  383. package/dist/docs/reference/cli.html +96 -100
  384. package/dist/docs/reference/cli.md +363 -366
  385. package/dist/docs/reference/connections.html +44 -44
  386. package/dist/docs/reference/connections.md +10 -10
  387. package/dist/docs/reference/evals.html +68 -48
  388. package/dist/docs/reference/evals.md +48 -13
  389. package/dist/docs/reference/extensions.html +47 -47
  390. package/dist/docs/reference/extensions.md +12 -12
  391. package/dist/docs/reference/hooks.html +42 -42
  392. package/dist/docs/reference/hooks.md +11 -11
  393. package/dist/docs/reference/http-api.html +39 -39
  394. package/dist/docs/reference/http-api.md +1 -1
  395. package/dist/docs/reference/instructions.html +39 -39
  396. package/dist/docs/reference/instructions.md +1 -1
  397. package/dist/docs/reference/limits.html +67 -0
  398. package/dist/docs/reference/limits.md +37 -0
  399. package/dist/docs/reference/memory.html +40 -40
  400. package/dist/docs/reference/memory.md +7 -7
  401. package/dist/docs/reference/playground.html +38 -38
  402. package/dist/docs/reference/playground.md +1 -1
  403. package/dist/docs/reference/project-layout.html +41 -41
  404. package/dist/docs/reference/project-layout.md +6 -6
  405. package/dist/docs/reference/prompt.html +39 -39
  406. package/dist/docs/reference/prompt.md +2 -2
  407. package/dist/docs/reference/schedules.html +42 -42
  408. package/dist/docs/reference/schedules.md +4 -4
  409. package/dist/docs/reference/sessions.html +39 -39
  410. package/dist/docs/reference/sessions.md +3 -3
  411. package/dist/docs/reference/skills.html +39 -39
  412. package/dist/docs/reference/skills.md +2 -2
  413. package/dist/docs/reference/subagents.html +39 -39
  414. package/dist/docs/reference/subagents.md +1 -1
  415. package/dist/docs/reference/tools.html +47 -47
  416. package/dist/docs/reference/tools.md +31 -21
  417. package/dist/docs/templates/agentic-owners.html +41 -41
  418. package/dist/docs/templates/agentic-owners.md +7 -7
  419. package/dist/docs/templates/security-reviewer.html +39 -39
  420. package/dist/docs/templates/security-reviewer.md +6 -6
  421. package/dist/docs/templates/thermo-quality-review.html +40 -40
  422. package/dist/docs/templates/thermo-quality-review.md +7 -7
  423. package/dist/docs/templates/thermo-review.html +40 -40
  424. package/dist/docs/templates/thermo-review.md +7 -7
  425. package/dist/docs/templates/triage.html +41 -41
  426. package/dist/docs/templates/triage.md +9 -9
  427. package/dist/docs/troubleshooting.html +38 -38
  428. package/dist/docs/troubleshooting.md +26 -24
  429. package/dist/evals/assertions.d.ts.map +1 -1
  430. package/dist/evals/assertions.js +2 -2
  431. package/dist/evals/expect.d.ts.map +1 -1
  432. package/dist/evals/expect.js +9 -1
  433. package/dist/evals/judge.js +2 -2
  434. package/dist/evals/loaders.d.ts +3 -3
  435. package/dist/evals/loaders.d.ts.map +1 -1
  436. package/dist/evals/loaders.js +6 -3
  437. package/dist/evals/matchers.d.ts +1 -1
  438. package/dist/evals/matchers.d.ts.map +1 -1
  439. package/dist/evals/matchers.js +40 -6
  440. package/dist/evals/reporters.d.ts +2 -2
  441. package/dist/evals/reporters.js +2 -2
  442. package/dist/evals/results.d.ts +1 -1
  443. package/dist/evals/results.js +1 -1
  444. package/dist/evals.d.ts +3 -3
  445. package/dist/evals.js +1 -1
  446. package/dist/executors.d.ts +1 -1
  447. package/dist/executors.d.ts.map +1 -1
  448. package/dist/executors.js +2 -2
  449. package/dist/extensions/cursor-cloud-agents/extension.d.ts +1 -1
  450. package/dist/extensions/cursor-cloud-agents/extension.js +1 -1
  451. package/dist/extensions/cursor-cloud-agents/lib/backend.d.ts.map +1 -1
  452. package/dist/extensions/cursor-cloud-agents/lib/backend.js +13 -2
  453. package/dist/extensions/cursor-cloud-agents/reminders/cloud-agent-stop-watch.js +3 -3
  454. package/dist/extensions/improve/extension.d.ts +1 -1
  455. package/dist/extensions/improve/extension.js +1 -1
  456. package/dist/extensions/jev/extension.d.ts +13 -3
  457. package/dist/extensions/jev/extension.d.ts.map +1 -1
  458. package/dist/extensions/jev/extension.js +5 -1
  459. package/dist/extensions/jev/lib/evaluate.d.ts +33 -6
  460. package/dist/extensions/jev/lib/evaluate.d.ts.map +1 -1
  461. package/dist/extensions/jev/lib/evaluate.js +44 -11
  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 +577 -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 +282 -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 +359 -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 +439 -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 +3 -1
  588. package/dist/internal/cli-migrate.d.ts.map +1 -1
  589. package/dist/internal/cli-migrate.js +43 -15
  590. package/dist/internal/cli-pagerduty.d.ts +1 -1
  591. package/dist/internal/cli-pagerduty.js +1 -1
  592. package/dist/internal/cli-skills.d.ts +30 -2
  593. package/dist/internal/cli-skills.d.ts.map +1 -1
  594. package/dist/internal/cli-skills.js +63 -3
  595. package/dist/internal/cli-slack-context.d.ts +91 -0
  596. package/dist/internal/cli-slack-context.d.ts.map +1 -0
  597. package/dist/internal/cli-slack-context.js +112 -0
  598. package/dist/internal/cli-slack-manual.d.ts +2 -0
  599. package/dist/internal/cli-slack-manual.d.ts.map +1 -1
  600. package/dist/internal/cli-slack-manual.js +12 -0
  601. package/dist/internal/cli-slack.d.ts +1 -49
  602. package/dist/internal/cli-slack.d.ts.map +1 -1
  603. package/dist/internal/cli-slack.js +27 -147
  604. package/dist/internal/cloud-merge.d.ts +2 -4
  605. package/dist/internal/cloud-merge.d.ts.map +1 -1
  606. package/dist/internal/cloud-merge.js +2 -7
  607. package/dist/internal/continuation-channel.d.ts.map +1 -1
  608. package/dist/internal/continuation-channel.js +10 -22
  609. package/dist/internal/continuation-identity.d.ts +33 -12
  610. package/dist/internal/continuation-identity.d.ts.map +1 -1
  611. package/dist/internal/continuation-identity.js +161 -43
  612. package/dist/internal/continuation-registration.d.ts +26 -0
  613. package/dist/internal/continuation-registration.d.ts.map +1 -0
  614. package/dist/internal/continuation-registration.js +35 -0
  615. package/dist/internal/conversation-mirror.d.ts.map +1 -1
  616. package/dist/internal/conversation-mirror.js +23 -14
  617. package/dist/internal/convert-automation/convert-workflow.d.ts.map +1 -1
  618. package/dist/internal/convert-automation/convert-workflow.js +28 -22
  619. package/dist/internal/convert-automation/types.d.ts +1 -1
  620. package/dist/internal/convert-automation/types.js +1 -1
  621. package/dist/internal/cursor/account-mcp.js +1 -1
  622. package/dist/internal/cursor/backend-client.d.ts.map +1 -1
  623. package/dist/internal/cursor/backend-client.js +6 -8
  624. package/dist/internal/cursor/bound-secret-file.d.ts.map +1 -1
  625. package/dist/internal/cursor/bound-secret-file.js +2 -1
  626. package/dist/internal/cursor/credentials.d.ts +4 -17
  627. package/dist/internal/cursor/credentials.d.ts.map +1 -1
  628. package/dist/internal/cursor/credentials.js +11 -27
  629. package/dist/internal/cursor/session-token.d.ts.map +1 -1
  630. package/dist/internal/cursor/session-token.js +3 -4
  631. package/dist/internal/cursor/store-api-client.d.ts.map +1 -1
  632. package/dist/internal/cursor/store-api-client.js +3 -2
  633. package/dist/internal/cursor-agent-template.d.ts +1 -1
  634. package/dist/internal/cursor-agent-template.d.ts.map +1 -1
  635. package/dist/internal/cursor-agent-template.js +2 -2
  636. package/dist/internal/cursor-deployment-relay.d.ts.map +1 -1
  637. package/dist/internal/cursor-deployment-relay.js +24 -2
  638. package/dist/internal/cursor-event-relay.d.ts.map +1 -1
  639. package/dist/internal/cursor-event-relay.js +26 -2
  640. package/dist/internal/cursor-relay-core.d.ts.map +1 -1
  641. package/dist/internal/cursor-relay-core.js +22 -3
  642. package/dist/internal/deploy-client.d.ts +104 -94
  643. package/dist/internal/deploy-client.d.ts.map +1 -1
  644. package/dist/internal/deploy-client.js +143 -178
  645. package/dist/internal/deploy-manifest.d.ts +2 -2
  646. package/dist/internal/deploy-manifest.d.ts.map +1 -1
  647. package/dist/internal/deploy-manifest.js +6 -6
  648. package/dist/internal/describe-error.d.ts +4 -0
  649. package/dist/internal/describe-error.d.ts.map +1 -1
  650. package/dist/internal/describe-error.js +20 -0
  651. package/dist/internal/discovery/agent-config.d.ts +1 -5
  652. package/dist/internal/discovery/agent-config.d.ts.map +1 -1
  653. package/dist/internal/discovery/agent-config.js +5 -11
  654. package/dist/internal/discovery/agent.d.ts.map +1 -1
  655. package/dist/internal/discovery/agent.js +24 -30
  656. package/dist/internal/discovery/channels.d.ts.map +1 -1
  657. package/dist/internal/discovery/channels.js +2 -0
  658. package/dist/internal/discovery/connections.d.ts.map +1 -1
  659. package/dist/internal/discovery/connections.js +6 -4
  660. package/dist/internal/discovery/context.d.ts.map +1 -1
  661. package/dist/internal/discovery/context.js +6 -1
  662. package/dist/internal/discovery/extension-overlay.d.ts +1 -1
  663. package/dist/internal/discovery/extension-overlay.d.ts.map +1 -1
  664. package/dist/internal/discovery/extension-overlay.js +1 -0
  665. package/dist/internal/discovery/extensions.d.ts.map +1 -1
  666. package/dist/internal/discovery/extensions.js +12 -5
  667. package/dist/internal/discovery/fs.d.ts.map +1 -1
  668. package/dist/internal/discovery/fs.js +2 -1
  669. package/dist/internal/discovery/hooks.d.ts.map +1 -1
  670. package/dist/internal/discovery/hooks.js +1 -0
  671. package/dist/internal/discovery/info.d.ts.map +1 -1
  672. package/dist/internal/discovery/info.js +0 -3
  673. package/dist/internal/discovery/instructions.d.ts.map +1 -1
  674. package/dist/internal/discovery/instructions.js +4 -1
  675. package/dist/internal/discovery/instrumentation.js +1 -1
  676. package/dist/internal/discovery/modules.d.ts.map +1 -1
  677. package/dist/internal/discovery/modules.js +4 -1
  678. package/dist/internal/discovery/project.js +1 -1
  679. package/dist/internal/discovery/reminders.d.ts.map +1 -1
  680. package/dist/internal/discovery/reminders.js +1 -0
  681. package/dist/internal/discovery/runtime.d.ts +0 -16
  682. package/dist/internal/discovery/runtime.d.ts.map +1 -1
  683. package/dist/internal/discovery/runtime.js +2 -47
  684. package/dist/internal/discovery/schedules.d.ts.map +1 -1
  685. package/dist/internal/discovery/schedules.js +1 -0
  686. package/dist/internal/discovery/services.d.ts.map +1 -1
  687. package/dist/internal/discovery/services.js +3 -1
  688. package/dist/internal/discovery/skills.d.ts.map +1 -1
  689. package/dist/internal/discovery/skills.js +1 -0
  690. package/dist/internal/discovery/tools.d.ts +1 -1
  691. package/dist/internal/discovery/tools.d.ts.map +1 -1
  692. package/dist/internal/discovery/tools.js +3 -1
  693. package/dist/internal/discovery.d.ts +1 -1
  694. package/dist/internal/discovery.d.ts.map +1 -1
  695. package/dist/internal/discovery.js +1 -1
  696. package/dist/internal/distribution.d.ts +9 -14
  697. package/dist/internal/distribution.d.ts.map +1 -1
  698. package/dist/internal/distribution.js +54 -18
  699. package/dist/internal/docs-site.d.ts.map +1 -1
  700. package/dist/internal/docs-site.js +15 -2
  701. package/dist/internal/dry-run.d.ts +32 -0
  702. package/dist/internal/dry-run.d.ts.map +1 -0
  703. package/dist/internal/dry-run.js +62 -0
  704. package/dist/internal/duration.d.ts.map +1 -1
  705. package/dist/internal/duration.js +1 -0
  706. package/dist/internal/estimate-cost.d.ts.map +1 -1
  707. package/dist/internal/estimate-cost.js +12 -5
  708. package/dist/internal/eval-run-store.d.ts.map +1 -1
  709. package/dist/internal/eval-run-store.js +6 -5
  710. package/dist/internal/eval-runner.d.ts +0 -2
  711. package/dist/internal/eval-runner.d.ts.map +1 -1
  712. package/dist/internal/eval-runner.js +3 -3
  713. package/dist/internal/evals-client.d.ts.map +1 -1
  714. package/dist/internal/evals-client.js +60 -15
  715. package/dist/internal/event-log.d.ts.map +1 -1
  716. package/dist/internal/event-log.js +3 -11
  717. package/dist/internal/event-mapper.d.ts.map +1 -1
  718. package/dist/internal/event-mapper.js +33 -15
  719. package/dist/internal/expected-delivery-failure.d.ts.map +1 -1
  720. package/dist/internal/expected-delivery-failure.js +5 -4
  721. package/dist/internal/fetch-text.d.ts +8 -0
  722. package/dist/internal/fetch-text.d.ts.map +1 -0
  723. package/dist/internal/fetch-text.js +32 -0
  724. package/dist/internal/filesystem/errors.d.ts.map +1 -1
  725. package/dist/internal/filesystem/errors.js +8 -0
  726. package/dist/internal/filesystem/scratch.js +1 -4
  727. package/dist/internal/filesystem/sdk-schemas.d.ts +19 -19
  728. package/dist/internal/filesystem/sdk-schemas.d.ts.map +1 -1
  729. package/dist/internal/filesystem/sdk-schemas.js +15 -21
  730. package/dist/internal/filesystem/tools.d.ts +15 -4
  731. package/dist/internal/filesystem/tools.d.ts.map +1 -1
  732. package/dist/internal/filesystem/tools.js +33 -47
  733. package/dist/internal/filesystem/walk.d.ts.map +1 -1
  734. package/dist/internal/filesystem/walk.js +4 -0
  735. package/dist/internal/framework-file-storage.d.ts.map +1 -1
  736. package/dist/internal/framework-file-storage.js +2 -1
  737. package/dist/internal/frontmatter.d.ts.map +1 -1
  738. package/dist/internal/frontmatter.js +5 -1
  739. package/dist/internal/github-fanout.js +2 -1
  740. package/dist/internal/guest-network.d.ts.map +1 -1
  741. package/dist/internal/guest-network.js +6 -0
  742. package/dist/internal/handleAgentServeTrigger.d.ts +8 -0
  743. package/dist/internal/handleAgentServeTrigger.d.ts.map +1 -1
  744. package/dist/internal/handleAgentServeTrigger.js +27 -1
  745. package/dist/internal/host-kv.d.ts.map +1 -1
  746. package/dist/internal/host-kv.js +4 -2
  747. package/dist/internal/host-otel.d.ts.map +1 -1
  748. package/dist/internal/host-otel.js +2 -8
  749. package/dist/internal/host-platforms.d.ts.map +1 -1
  750. package/dist/internal/host-platforms.js +17 -10
  751. package/dist/internal/hosted-catch-protocol.d.ts.map +1 -1
  752. package/dist/internal/hosted-catch-protocol.js +26 -9
  753. package/dist/internal/hosted-catch.d.ts +13 -10
  754. package/dist/internal/hosted-catch.d.ts.map +1 -1
  755. package/dist/internal/hosted-catch.js +23 -11
  756. package/dist/internal/hosted-delivery-protocol.d.ts +1 -1
  757. package/dist/internal/hosted-delivery-protocol.d.ts.map +1 -1
  758. package/dist/internal/hosted-delivery-protocol.js +75 -45
  759. package/dist/internal/hosted-delivery.d.ts +1 -2
  760. package/dist/internal/hosted-delivery.d.ts.map +1 -1
  761. package/dist/internal/hosted-delivery.js +27 -32
  762. package/dist/internal/hosted-execution-diag.d.ts.map +1 -1
  763. package/dist/internal/hosted-execution-diag.js +11 -13
  764. package/dist/internal/hosted-execution-flush.js +1 -1
  765. package/dist/internal/hosted-execution-latency.d.ts.map +1 -1
  766. package/dist/internal/hosted-execution-latency.js +12 -1
  767. package/dist/internal/hosted-hints.d.ts +16 -0
  768. package/dist/internal/hosted-hints.d.ts.map +1 -0
  769. package/dist/internal/hosted-hints.js +23 -0
  770. package/dist/internal/hosted-managed-automation.d.ts.map +1 -1
  771. package/dist/internal/hosted-managed-automation.js +1 -0
  772. package/dist/internal/hosted-session-fixture.d.ts +26 -0
  773. package/dist/internal/hosted-session-fixture.d.ts.map +1 -0
  774. package/dist/internal/hosted-session-fixture.js +34 -0
  775. package/dist/internal/hosted-session-view.d.ts +48 -0
  776. package/dist/internal/hosted-session-view.d.ts.map +1 -0
  777. package/dist/internal/hosted-session-view.js +305 -0
  778. package/dist/internal/http-channel.d.ts.map +1 -1
  779. package/dist/internal/http-channel.js +8 -5
  780. package/dist/internal/http-control-plane-session.d.ts.map +1 -1
  781. package/dist/internal/http-control-plane-session.js +8 -9
  782. package/dist/internal/init-interview.js +2 -2
  783. package/dist/internal/init-project.d.ts +14 -16
  784. package/dist/internal/init-project.d.ts.map +1 -1
  785. package/dist/internal/init-project.js +63 -27
  786. package/dist/internal/init-scaffold.d.ts +2 -1
  787. package/dist/internal/init-scaffold.d.ts.map +1 -1
  788. package/dist/internal/init-scaffold.js +22 -9
  789. package/dist/internal/inline-stdio-define-stub.d.ts +1 -1
  790. package/dist/internal/inline-stdio-define-stub.d.ts.map +1 -1
  791. package/dist/internal/inline-stdio-define-stub.js +1 -1
  792. package/dist/internal/inline-stdio-mcp.d.ts.map +1 -1
  793. package/dist/internal/inline-stdio-mcp.js +31 -8
  794. package/dist/internal/install-cursor-skills.d.ts +22 -15
  795. package/dist/internal/install-cursor-skills.d.ts.map +1 -1
  796. package/dist/internal/install-cursor-skills.js +66 -31
  797. package/dist/internal/interview/agent-questions.d.ts.map +1 -1
  798. package/dist/internal/interview/agent-questions.js +4 -1
  799. package/dist/internal/interview/question.d.ts +1 -1
  800. package/dist/internal/interview/question.js +1 -1
  801. package/dist/internal/json-schema.d.ts +3 -2
  802. package/dist/internal/json-schema.d.ts.map +1 -1
  803. package/dist/internal/json-schema.js +83 -3
  804. package/dist/internal/json-value.d.ts +20 -0
  805. package/dist/internal/json-value.d.ts.map +1 -0
  806. package/dist/internal/json-value.js +56 -0
  807. package/dist/internal/logs-client.d.ts +4 -25
  808. package/dist/internal/logs-client.d.ts.map +1 -1
  809. package/dist/internal/logs-client.js +17 -174
  810. package/dist/internal/mcp-endpoint.d.ts +1 -1
  811. package/dist/internal/mcp-endpoint.js +2 -1
  812. package/dist/internal/mcp-host.d.ts.map +1 -1
  813. package/dist/internal/mcp-host.js +22 -9
  814. package/dist/internal/mcp-oauth.d.ts +2 -2
  815. package/dist/internal/mcp-oauth.d.ts.map +1 -1
  816. package/dist/internal/mcp-oauth.js +61 -8
  817. package/dist/internal/named-webhook-secret.d.ts +12 -0
  818. package/dist/internal/named-webhook-secret.d.ts.map +1 -1
  819. package/dist/internal/named-webhook-secret.js +18 -0
  820. package/dist/internal/otel/bind-telemetry.d.ts +26 -0
  821. package/dist/internal/otel/bind-telemetry.d.ts.map +1 -0
  822. package/dist/internal/otel/bind-telemetry.js +36 -0
  823. package/dist/internal/otel/collector.d.ts.map +1 -1
  824. package/dist/internal/otel/collector.js +94 -42
  825. package/dist/internal/otel/config.d.ts.map +1 -1
  826. package/dist/internal/otel/config.js +4 -3
  827. package/dist/internal/otel/conversation-span-processor.d.ts.map +1 -1
  828. package/dist/internal/otel/conversation-span-processor.js +5 -2
  829. package/dist/internal/otel/customer.d.ts +1 -5
  830. package/dist/internal/otel/customer.d.ts.map +1 -1
  831. package/dist/internal/otel/customer.js +35 -13
  832. package/dist/internal/otel/http.d.ts +1 -1
  833. package/dist/internal/otel/http.d.ts.map +1 -1
  834. package/dist/internal/otel/http.js +5 -3
  835. package/dist/internal/otel/propagation.d.ts +3 -2
  836. package/dist/internal/otel/propagation.d.ts.map +1 -1
  837. package/dist/internal/otel/propagation.js +3 -2
  838. package/dist/internal/otel/reserved-attributes.d.ts +8 -0
  839. package/dist/internal/otel/reserved-attributes.d.ts.map +1 -0
  840. package/dist/internal/otel/reserved-attributes.js +24 -0
  841. package/dist/internal/otel/runtime.d.ts.map +1 -1
  842. package/dist/internal/otel/runtime.js +9 -2
  843. package/dist/internal/otel/session-telemetry.d.ts +22 -0
  844. package/dist/internal/otel/session-telemetry.d.ts.map +1 -0
  845. package/dist/internal/otel/session-telemetry.js +30 -0
  846. package/dist/internal/otel/telemetry-attributes.d.ts +7 -0
  847. package/dist/internal/otel/telemetry-attributes.d.ts.map +1 -0
  848. package/dist/internal/otel/telemetry-attributes.js +35 -0
  849. package/dist/internal/otel/telemetry-processor.d.ts +7 -0
  850. package/dist/internal/otel/telemetry-processor.d.ts.map +1 -0
  851. package/dist/internal/otel/telemetry-processor.js +47 -0
  852. package/dist/internal/otel/tool-error-class.d.ts.map +1 -1
  853. package/dist/internal/otel/tool-error-class.js +4 -0
  854. package/dist/internal/package-inline-stdio.d.ts.map +1 -1
  855. package/dist/internal/package-inline-stdio.js +2 -2
  856. package/dist/internal/peer-connections.js +1 -1
  857. package/dist/internal/persistent-stage-log-mirror.js +2 -5
  858. package/dist/internal/platform-timers.d.ts.map +1 -1
  859. package/dist/internal/platform-timers.js +32 -1
  860. package/dist/internal/playground/toolchain.d.ts.map +1 -1
  861. package/dist/internal/playground/toolchain.js +16 -3
  862. package/dist/internal/playground-proxy.d.ts +6 -27
  863. package/dist/internal/playground-proxy.d.ts.map +1 -1
  864. package/dist/internal/playground-proxy.js +25 -83
  865. package/dist/internal/private-file.d.ts +2 -0
  866. package/dist/internal/private-file.d.ts.map +1 -0
  867. package/dist/internal/private-file.js +8 -0
  868. package/dist/internal/reminder-control-plane-protocol.d.ts.map +1 -1
  869. package/dist/internal/reminder-control-plane-protocol.js +4 -2
  870. package/dist/internal/reminder-runner.d.ts.map +1 -1
  871. package/dist/internal/reminder-runner.js +12 -25
  872. package/dist/internal/reminder-schedule.js +1 -1
  873. package/dist/internal/reminder-store.d.ts.map +1 -1
  874. package/dist/internal/reminder-store.js +16 -21
  875. package/dist/internal/request-headers.d.ts +2 -2
  876. package/dist/internal/request-headers.d.ts.map +1 -1
  877. package/dist/internal/request-headers.js +1 -1
  878. package/dist/internal/resolve-prod-target.d.ts +9 -65
  879. package/dist/internal/resolve-prod-target.d.ts.map +1 -1
  880. package/dist/internal/resolve-prod-target.js +20 -187
  881. package/dist/internal/resolved-connections.js +1 -1
  882. package/dist/internal/{factory-resource-channel.d.ts → resource-channel.d.ts} +10 -10
  883. package/dist/internal/resource-channel.d.ts.map +1 -0
  884. package/dist/internal/{factory-resource-channel.js → resource-channel.js} +9 -7
  885. package/dist/internal/run-client.d.ts.map +1 -1
  886. package/dist/internal/run-client.js +4 -1
  887. package/dist/internal/sdk-runner.d.ts +2 -2
  888. package/dist/internal/sdk-runner.d.ts.map +1 -1
  889. package/dist/internal/sdk-runner.js +19 -16
  890. package/dist/internal/sdk-subagent-inherit-support.d.ts.map +1 -1
  891. package/dist/internal/sdk-subagent-inherit-support.js +3 -2
  892. package/dist/internal/serve-restart.d.ts +3 -0
  893. package/dist/internal/serve-restart.d.ts.map +1 -1
  894. package/dist/internal/serve-restart.js +8 -4
  895. package/dist/internal/server.d.ts +5 -1
  896. package/dist/internal/server.d.ts.map +1 -1
  897. package/dist/internal/server.js +71 -64
  898. package/dist/internal/session-cost.d.ts +4 -4
  899. package/dist/internal/session-cost.d.ts.map +1 -1
  900. package/dist/internal/session-cost.js +5 -5
  901. package/dist/internal/session-engine.d.ts +22 -8
  902. package/dist/internal/session-engine.d.ts.map +1 -1
  903. package/dist/internal/session-engine.js +170 -75
  904. package/dist/internal/session-links.js +2 -1
  905. package/dist/internal/session-live-publisher.d.ts +0 -7
  906. package/dist/internal/session-live-publisher.d.ts.map +1 -1
  907. package/dist/internal/session-live-publisher.js +20 -7
  908. package/dist/internal/session-run-log.d.ts.map +1 -1
  909. package/dist/internal/session-run-log.js +19 -5
  910. package/dist/internal/session-store.d.ts.map +1 -1
  911. package/dist/internal/session-store.js +17 -3
  912. package/dist/internal/sessions-client.d.ts +2 -0
  913. package/dist/internal/sessions-client.d.ts.map +1 -1
  914. package/dist/internal/sessions-client.js +44 -10
  915. package/dist/internal/shallow-clone.d.ts +258 -0
  916. package/dist/internal/shallow-clone.d.ts.map +1 -0
  917. package/dist/internal/shallow-clone.js +644 -0
  918. package/dist/internal/slack-bot-scopes.d.ts +3 -0
  919. package/dist/internal/slack-bot-scopes.d.ts.map +1 -0
  920. package/dist/internal/slack-bot-scopes.js +2 -0
  921. package/dist/internal/slack-manifest-opt-in.d.ts +26 -0
  922. package/dist/internal/slack-manifest-opt-in.d.ts.map +1 -0
  923. package/dist/internal/slack-manifest-opt-in.js +63 -0
  924. package/dist/internal/slack-provision-client.d.ts +8 -24
  925. package/dist/internal/slack-provision-client.d.ts.map +1 -1
  926. package/dist/internal/slack-provision-client.js +21 -20
  927. package/dist/internal/slack-thread-key.d.ts +8 -3
  928. package/dist/internal/slack-thread-key.d.ts.map +1 -1
  929. package/dist/internal/slack-thread-key.js +6 -6
  930. package/dist/internal/sqlite-experimental-warning.js +1 -1
  931. package/dist/internal/start-log-store.d.ts.map +1 -1
  932. package/dist/internal/start-log-store.js +2 -5
  933. package/dist/internal/storage-coordinator.d.ts.map +1 -1
  934. package/dist/internal/storage-coordinator.js +49 -20
  935. package/dist/internal/stored-eval-run.d.ts +17 -0
  936. package/dist/internal/stored-eval-run.d.ts.map +1 -0
  937. package/dist/internal/stored-eval-run.js +305 -0
  938. package/dist/internal/stream-progress.d.ts.map +1 -1
  939. package/dist/internal/stream-progress.js +1 -1
  940. package/dist/internal/tcp-address.d.ts +4 -0
  941. package/dist/internal/tcp-address.d.ts.map +1 -0
  942. package/dist/internal/tcp-address.js +8 -0
  943. package/dist/internal/terminal-style.js +2 -2
  944. package/dist/internal/testing/pagerduty-continuation-fixtures.d.ts +1 -1
  945. package/dist/internal/testing/pagerduty-continuation-fixtures.js +1 -1
  946. package/dist/internal/testing/scm-continuation-fixtures.d.ts +1 -1
  947. package/dist/internal/testing/scm-continuation-fixtures.js +1 -1
  948. package/dist/internal/testing/slack-continuation-fixtures.d.ts +12 -6
  949. package/dist/internal/testing/slack-continuation-fixtures.d.ts.map +1 -1
  950. package/dist/internal/testing/slack-continuation-fixtures.js +74 -3
  951. package/dist/internal/tool-call-retry.d.ts +35 -7
  952. package/dist/internal/tool-call-retry.d.ts.map +1 -1
  953. package/dist/internal/tool-call-retry.js +108 -108
  954. package/dist/internal/tool-catalog.d.ts.map +1 -1
  955. package/dist/internal/tool-catalog.js +7 -2
  956. package/dist/internal/tool-policy.d.ts +20 -7
  957. package/dist/internal/tool-policy.d.ts.map +1 -1
  958. package/dist/internal/tool-policy.js +39 -11
  959. package/dist/internal/tool-result.d.ts +0 -5
  960. package/dist/internal/tool-result.d.ts.map +1 -1
  961. package/dist/internal/tool-result.js +26 -6
  962. package/dist/internal/trajectory.d.ts.map +1 -1
  963. package/dist/internal/trajectory.js +5 -1
  964. package/dist/internal/turn-outbox.d.ts.map +1 -1
  965. package/dist/internal/turn-outbox.js +1 -0
  966. package/dist/internal/update-check.d.ts +2 -0
  967. package/dist/internal/update-check.d.ts.map +1 -1
  968. package/dist/internal/update-check.js +4 -0
  969. package/dist/internal/workspace.d.ts +3 -4
  970. package/dist/internal/workspace.d.ts.map +1 -1
  971. package/dist/internal/workspace.js +5 -5
  972. package/dist/kv/memory-kv.d.ts +1 -1
  973. package/dist/kv/memory-kv.js +1 -1
  974. package/dist/kv.d.ts +9 -2
  975. package/dist/kv.d.ts.map +1 -1
  976. package/dist/kv.js +10 -2
  977. package/dist/memory.d.ts +1 -1
  978. package/dist/memory.js +1 -1
  979. package/dist/otel-public.d.ts +2 -1
  980. package/dist/otel-public.d.ts.map +1 -1
  981. package/dist/otel-public.js +2 -1
  982. package/dist/otel.d.ts.map +1 -1
  983. package/dist/otel.js +6 -2
  984. package/dist/playground/assets/cursor-icons-16-QUmxS7q3.woff2 +0 -0
  985. package/dist/playground/assets/index-Cl9zvmmf.js +62 -0
  986. package/dist/playground/assets/index-F8b5WvWi.css +1 -0
  987. package/dist/playground/index.html +2 -2
  988. package/dist/prompt.d.ts +1 -1
  989. package/dist/prompt.js +1 -1
  990. package/dist/public-deprecated.d.ts +11 -12
  991. package/dist/public-deprecated.d.ts.map +1 -1
  992. package/dist/public-deprecated.js +8 -9
  993. package/dist/reminders.d.ts +2 -2
  994. package/dist/reminders.js +2 -2
  995. package/dist/schedules.d.ts +1 -1
  996. package/dist/schedules.js +1 -1
  997. package/dist/scm.d.ts +2 -0
  998. package/dist/scm.d.ts.map +1 -0
  999. package/dist/scm.js +1 -0
  1000. package/dist/skills.d.ts +1 -1
  1001. package/dist/skills.js +1 -1
  1002. package/dist/storage-backends/cursor-hosted.d.ts.map +1 -1
  1003. package/dist/storage-backends/cursor-hosted.js +5 -3
  1004. package/dist/storage-backends/file-kv.d.ts +3 -2
  1005. package/dist/storage-backends/file-kv.d.ts.map +1 -1
  1006. package/dist/storage-backends/file-kv.js +20 -8
  1007. package/dist/storage.d.ts +2 -3
  1008. package/dist/storage.d.ts.map +1 -1
  1009. package/dist/storage.js +9 -5
  1010. package/dist/telemetry.d.ts +12 -0
  1011. package/dist/telemetry.d.ts.map +1 -0
  1012. package/dist/telemetry.js +11 -0
  1013. package/dist/tools.d.ts +1 -1
  1014. package/dist/tools.d.ts.map +1 -1
  1015. package/dist/tools.js +2 -1
  1016. package/dist/types.d.ts +59 -46
  1017. package/dist/types.d.ts.map +1 -1
  1018. package/dist/types.js +4 -4
  1019. package/docs/README.md +33 -33
  1020. package/docs/building-with-agents.md +16 -16
  1021. package/docs/changelog.md +58 -12
  1022. package/docs/deployment.md +116 -54
  1023. package/docs/evals.md +14 -12
  1024. package/docs/guides/agent-to-agent.md +8 -8
  1025. package/docs/guides/bitbucket.md +5 -5
  1026. package/docs/guides/cloud-agents.md +4 -4
  1027. package/docs/guides/convert-automation.md +17 -16
  1028. package/docs/guides/github.md +16 -16
  1029. package/docs/guides/gitlab.md +5 -5
  1030. package/docs/guides/hooks.md +3 -3
  1031. package/docs/guides/improve.md +2 -2
  1032. package/docs/guides/jev.md +15 -10
  1033. package/docs/guides/mcp-oauth.md +9 -10
  1034. package/docs/guides/migrate.md +35 -28
  1035. package/docs/guides/opentelemetry.md +61 -130
  1036. package/docs/guides/pagerduty.md +18 -18
  1037. package/docs/guides/slack.md +85 -15
  1038. package/docs/guides/webhooks.md +61 -3
  1039. package/docs/hillclimbing.md +2 -2
  1040. package/docs/quickstart.md +26 -22
  1041. package/docs/reference/access.md +27 -0
  1042. package/docs/reference/agent-config.md +54 -12
  1043. package/docs/reference/artifacts.md +2 -2
  1044. package/docs/reference/channels.md +29 -9
  1045. package/docs/reference/cli.md +364 -367
  1046. package/docs/reference/connections.md +9 -9
  1047. package/docs/reference/evals.md +48 -13
  1048. package/docs/reference/extensions.md +12 -12
  1049. package/docs/reference/hooks.md +11 -11
  1050. package/docs/reference/http-api.md +1 -1
  1051. package/docs/reference/instructions.md +1 -1
  1052. package/docs/reference/limits.md +42 -0
  1053. package/docs/reference/memory.md +7 -7
  1054. package/docs/reference/playground.md +1 -1
  1055. package/docs/reference/project-layout.md +6 -6
  1056. package/docs/reference/prompt.md +2 -2
  1057. package/docs/reference/schedules.md +4 -4
  1058. package/docs/reference/sessions.md +3 -3
  1059. package/docs/reference/skills.md +2 -2
  1060. package/docs/reference/subagents.md +1 -1
  1061. package/docs/reference/tools.md +31 -21
  1062. package/docs/templates/agentic-owners.md +7 -7
  1063. package/docs/templates/security-reviewer.md +6 -6
  1064. package/docs/templates/thermo-quality-review.md +7 -7
  1065. package/docs/templates/thermo-review.md +7 -7
  1066. package/docs/templates/triage.md +9 -9
  1067. package/docs/troubleshooting.md +26 -24
  1068. package/package.json +52 -99
  1069. package/scripts/install-cursor-skills.mjs +2 -2
  1070. package/skills/cli/SKILL.md +125 -0
  1071. package/skills/create-agent/SKILL.md +29 -26
  1072. package/skills/debug/SKILL.md +6 -6
  1073. package/skills/deploy/SKILL.md +47 -44
  1074. package/skills/evals/SKILL.md +13 -13
  1075. package/skills/framework-map/SKILL.md +9 -8
  1076. package/skills/github/SKILL.md +10 -10
  1077. package/skills/hillclimb/SKILL.md +6 -6
  1078. package/skills/mcp-auth/SKILL.md +3 -3
  1079. package/skills/migrate-v2/SKILL.md +67 -70
  1080. package/skills/otel/SKILL.md +36 -6
  1081. package/skills/setup-slack/SKILL.md +11 -11
  1082. package/templates/agentic-owners/README.md +6 -6
  1083. package/templates/agentic-owners/bot/agent.ts +1 -1
  1084. package/templates/agentic-owners/bot/channels/github.ts +1 -1
  1085. package/templates/agentic-owners/bot/lib/github.ts +2 -2
  1086. package/templates/agentic-owners/bot/lib/owners/parse.ts +1 -1
  1087. package/templates/agentic-owners/bot/lib/owners/policyMode.ts +6 -2
  1088. package/templates/agentic-owners/bot/lib/review.ts +7 -3
  1089. package/templates/agentic-owners/bot/tools/record_review.ts +3 -3
  1090. package/templates/agentic-owners/evals/evals.config.ts +1 -1
  1091. package/templates/agentic-owners/evals/owners.eval.ts +1 -1
  1092. package/templates/agentic-owners/package.json +3 -3
  1093. package/templates/agents-md/README.md +5 -5
  1094. package/templates/agents-md/bot/agent.ts +1 -1
  1095. package/templates/agents-md/bot/channels/github.ts +1 -1
  1096. package/templates/agents-md/bot/channels/queue.ts +5 -3
  1097. package/templates/agents-md/bot/channels/slack.ts +1 -1
  1098. package/templates/agents-md/bot/lib/collect.ts +1 -1
  1099. package/templates/agents-md/bot/schedules/weekly.ts +6 -6
  1100. package/templates/agents-md/bot/tools/apply_agents.ts +2 -2
  1101. package/templates/agents-md/evals/agents.eval.ts +1 -1
  1102. package/templates/agents-md/evals/evals.config.ts +1 -1
  1103. package/templates/agents-md/package.json +3 -3
  1104. package/templates/code-wiki/README.md +4 -4
  1105. package/templates/code-wiki/bot/agent.ts +1 -1
  1106. package/templates/code-wiki/bot/channels/github.ts +3 -3
  1107. package/templates/code-wiki/bot/tools/apply_wiki.ts +3 -3
  1108. package/templates/code-wiki/evals/evals.config.ts +1 -1
  1109. package/templates/code-wiki/evals/wiki.eval.ts +1 -1
  1110. package/templates/code-wiki/package.json +3 -3
  1111. package/templates/demo/README.md +4 -4
  1112. package/templates/demo/bot/agent.ts +1 -1
  1113. package/templates/demo/bot/channels/github.ts +7 -3
  1114. package/templates/demo/bot/channels/queue.ts +5 -5
  1115. package/templates/demo/bot/lib/collect.ts +2 -2
  1116. package/templates/demo/bot/tools/record_demo.ts +2 -2
  1117. package/templates/demo/evals/demo.eval.ts +1 -1
  1118. package/templates/demo/evals/evals.config.ts +1 -1
  1119. package/templates/demo/package.json +3 -3
  1120. package/templates/pr-autofixer/bot/agent.ts +1 -1
  1121. package/templates/pr-autofixer/bot/channels/drive.ts +1 -1
  1122. package/templates/pr-autofixer/bot/channels/github.ts +3 -3
  1123. package/templates/pr-autofixer/bot/channels/slack.ts +1 -1
  1124. package/templates/pr-autofixer/bot/hooks/bind-agent.ts +1 -1
  1125. package/templates/pr-autofixer/bot/lib/affinity.ts +1 -1
  1126. package/templates/pr-autofixer/bot/lib/drive.ts +2 -2
  1127. package/templates/pr-autofixer/bot/lib/merge-watch.ts +4 -4
  1128. package/templates/pr-autofixer/bot/lib/pr-state.ts +1 -1
  1129. package/templates/pr-autofixer/bot/lib/start-drive.ts +2 -2
  1130. package/templates/pr-autofixer/bot/lib/webhook-buffer.ts +1 -1
  1131. package/templates/pr-autofixer/bot/lib/webhook-routing.ts +1 -1
  1132. package/templates/pr-autofixer/bot/tools/drive_pr.ts +1 -1
  1133. package/templates/pr-autofixer/evals/coordinator.eval.ts +1 -1
  1134. package/templates/pr-autofixer/evals/evals.config.ts +1 -1
  1135. package/templates/pr-autofixer/package.json +3 -3
  1136. package/templates/security-help/.gitignore +4 -0
  1137. package/templates/security-help/README.md +6 -6
  1138. package/templates/security-help/bot/agent.ts +1 -1
  1139. package/templates/security-help/bot/channels/github.ts +1 -1
  1140. package/templates/security-help/bot/channels/slack.ts +1 -1
  1141. package/templates/security-help/bot/lib/pr-first-pass.ts +3 -3
  1142. package/templates/security-help/evals/evals.config.ts +1 -1
  1143. package/templates/security-help/evals/security-help.eval.ts +1 -1
  1144. package/templates/security-help/package.json +2 -2
  1145. package/templates/security-reviewer/README.md +4 -4
  1146. package/templates/security-reviewer/bot/agent.ts +1 -1
  1147. package/templates/security-reviewer/bot/channels/github.ts +2 -2
  1148. package/templates/security-reviewer/bot/tools/post_findings.ts +2 -2
  1149. package/templates/security-reviewer/evals/evals.config.ts +1 -1
  1150. package/templates/security-reviewer/evals/review.eval.ts +1 -1
  1151. package/templates/security-reviewer/package.json +3 -3
  1152. package/templates/thermo-quality-review/README.md +5 -5
  1153. package/templates/thermo-quality-review/bot/agent.ts +1 -1
  1154. package/templates/thermo-quality-review/bot/channels/github.ts +2 -2
  1155. package/templates/thermo-quality-review/bot/tools/post_findings.ts +2 -2
  1156. package/templates/thermo-quality-review/evals/evals.config.ts +1 -1
  1157. package/templates/thermo-quality-review/evals/review.eval.ts +1 -1
  1158. package/templates/thermo-quality-review/package.json +3 -3
  1159. package/templates/thermo-review/README.md +5 -5
  1160. package/templates/thermo-review/bot/agent.ts +1 -1
  1161. package/templates/thermo-review/bot/channels/github.ts +2 -2
  1162. package/templates/thermo-review/bot/tools/post_findings.ts +2 -2
  1163. package/templates/thermo-review/evals/evals.config.ts +1 -1
  1164. package/templates/thermo-review/evals/review.eval.ts +1 -1
  1165. package/templates/thermo-review/package.json +3 -3
  1166. package/templates/triage/README.md +5 -5
  1167. package/templates/triage/bot/agent.ts +1 -1
  1168. package/templates/triage/bot/channels/queue.ts +5 -5
  1169. package/templates/triage/bot/channels/webhook.ts +5 -5
  1170. package/templates/triage/bot/hooks/memory.ts +1 -1
  1171. package/templates/triage/bot/lib/actuate.ts +2 -2
  1172. package/templates/triage/bot/tools/record_triage.ts +1 -1
  1173. package/templates/triage/evals/evals.config.ts +1 -1
  1174. package/templates/triage/evals/triage.eval.ts +1 -1
  1175. package/templates/triage/overlays/jira/README.md +4 -4
  1176. package/templates/triage/overlays/jira/bot/mcp-connections/tracker.ts +1 -1
  1177. package/templates/triage/overlays/linear/README.md +4 -4
  1178. package/templates/triage/overlays/linear/bot/mcp-connections/tracker.ts +1 -1
  1179. package/templates/triage/package.json +3 -3
  1180. package/dist/bin/agent-sdk.js +0 -2
  1181. package/dist/docs/assets/building-with-agents.md.FZXrY8Nk.js +0 -9
  1182. package/dist/docs/assets/building-with-agents.md.FZXrY8Nk.lean.js +0 -1
  1183. package/dist/docs/assets/changelog.md.BvHRIiMH.js +0 -1
  1184. package/dist/docs/assets/changelog.md.BvHRIiMH.lean.js +0 -1
  1185. package/dist/docs/assets/chunks/@localSearchIndexroot.BoDEJQWv.js +0 -1
  1186. package/dist/docs/assets/chunks/channel.D2BTz0L-.js +0 -1
  1187. package/dist/docs/assets/chunks/classDiagram-6PBFFD2Q.DqByliAC.js +0 -1
  1188. package/dist/docs/assets/chunks/classDiagram-v2-HSJHXN6E.DqByliAC.js +0 -1
  1189. package/dist/docs/assets/chunks/clone.CldT1lbQ.js +0 -1
  1190. package/dist/docs/assets/chunks/stateDiagram-v2-QKLJ7IA2.Bb4oMe0P.js +0 -1
  1191. package/dist/docs/assets/deployment.md.3MMWuPeV.js +0 -31
  1192. package/dist/docs/assets/deployment.md.3MMWuPeV.lean.js +0 -1
  1193. package/dist/docs/assets/guides_agent-to-agent.md.CwL5cwuE.lean.js +0 -1
  1194. package/dist/docs/assets/guides_cloud-agents.md.BzbzcOyj.js +0 -9
  1195. package/dist/docs/assets/guides_cloud-agents.md.BzbzcOyj.lean.js +0 -1
  1196. package/dist/docs/assets/guides_convert-automation.md.DMEX9nF-.lean.js +0 -1
  1197. package/dist/docs/assets/guides_export-grokbot.md.qo5bxi4h.js +0 -55
  1198. package/dist/docs/assets/guides_export-grokbot.md.qo5bxi4h.lean.js +0 -1
  1199. package/dist/docs/assets/guides_grokbot-agents.md.BwAykJ7U.js +0 -15
  1200. package/dist/docs/assets/guides_grokbot-agents.md.BwAykJ7U.lean.js +0 -1
  1201. package/dist/docs/assets/guides_migrate.md.CQlGaBKX.js +0 -7
  1202. package/dist/docs/assets/guides_migrate.md.CQlGaBKX.lean.js +0 -1
  1203. package/dist/docs/assets/guides_opentelemetry.md.D4wO7_8v.js +0 -37
  1204. package/dist/docs/assets/guides_opentelemetry.md.D4wO7_8v.lean.js +0 -1
  1205. package/dist/docs/assets/index.md.CAnsLl8D.js +0 -27
  1206. package/dist/docs/assets/index.md.CAnsLl8D.lean.js +0 -1
  1207. package/dist/docs/assets/quickstart.md.D8JDfkKO.lean.js +0 -1
  1208. package/dist/docs/assets/reference_channels.md.CNNIS6K7.js +0 -22
  1209. package/dist/docs/assets/reference_cli.md.1o_TqKdt.js +0 -103
  1210. package/dist/docs/assets/reference_cli.md.1o_TqKdt.lean.js +0 -1
  1211. package/dist/docs/assets/reference_memory.md.BwyJXYZe.js +0 -4
  1212. package/dist/docs/assets/reference_playground.md.q4MI-0td.js +0 -1
  1213. package/dist/docs/assets/templates_grokbot-agents.md.DgpPEs7B.js +0 -5
  1214. package/dist/docs/assets/templates_grokbot-agents.md.DgpPEs7B.lean.js +0 -1
  1215. package/dist/docs/assets/templates_security-reviewer.md.Gh6EF9Us.js +0 -3
  1216. package/dist/docs/assets/templates_thermo-quality-review.md.B77UyTrX.js +0 -3
  1217. package/dist/docs/assets/templates_thermo-review.md.DRJ7mC5U.js +0 -3
  1218. package/dist/docs/assets/troubleshooting.md.DFnoTDlQ.js +0 -1
  1219. package/dist/docs/guides/export-grokbot.html +0 -114
  1220. package/dist/docs/guides/export-grokbot.md +0 -239
  1221. package/dist/docs/guides/grokbot-agents.html +0 -74
  1222. package/dist/docs/guides/grokbot-agents.md +0 -135
  1223. package/dist/docs/templates/grokbot-agents.html +0 -64
  1224. package/dist/docs/templates/grokbot-agents.md +0 -55
  1225. package/dist/extensions/cursor-grokbot-agents/extension.d.ts +0 -77
  1226. package/dist/extensions/cursor-grokbot-agents/extension.d.ts.map +0 -1
  1227. package/dist/extensions/cursor-grokbot-agents/extension.js +0 -70
  1228. package/dist/extensions/cursor-grokbot-agents/lib/agents.d.ts +0 -11
  1229. package/dist/extensions/cursor-grokbot-agents/lib/agents.d.ts.map +0 -1
  1230. package/dist/extensions/cursor-grokbot-agents/lib/agents.js +0 -31
  1231. package/dist/extensions/cursor-grokbot-agents/lib/backend.d.ts +0 -56
  1232. package/dist/extensions/cursor-grokbot-agents/lib/backend.d.ts.map +0 -1
  1233. package/dist/extensions/cursor-grokbot-agents/lib/backend.js +0 -138
  1234. package/dist/extensions/cursor-grokbot-agents/lib/contacts.d.ts +0 -28
  1235. package/dist/extensions/cursor-grokbot-agents/lib/contacts.d.ts.map +0 -1
  1236. package/dist/extensions/cursor-grokbot-agents/lib/contacts.js +0 -46
  1237. package/dist/extensions/cursor-grokbot-agents/lib/conversation.d.ts +0 -53
  1238. package/dist/extensions/cursor-grokbot-agents/lib/conversation.d.ts.map +0 -1
  1239. package/dist/extensions/cursor-grokbot-agents/lib/conversation.js +0 -186
  1240. package/dist/extensions/cursor-grokbot-agents/lib/inputs.d.ts +0 -4
  1241. package/dist/extensions/cursor-grokbot-agents/lib/inputs.d.ts.map +0 -1
  1242. package/dist/extensions/cursor-grokbot-agents/lib/inputs.js +0 -15
  1243. package/dist/extensions/cursor-grokbot-agents/lib/lock.d.ts +0 -12
  1244. package/dist/extensions/cursor-grokbot-agents/lib/lock.d.ts.map +0 -1
  1245. package/dist/extensions/cursor-grokbot-agents/lib/lock.js +0 -24
  1246. package/dist/extensions/cursor-grokbot-agents/skills/consult.md +0 -40
  1247. package/dist/extensions/cursor-grokbot-agents/tools/ask.d.ts +0 -4
  1248. package/dist/extensions/cursor-grokbot-agents/tools/ask.d.ts.map +0 -1
  1249. package/dist/extensions/cursor-grokbot-agents/tools/ask.js +0 -26
  1250. package/dist/extensions/cursor-grokbot-agents/tools/check.d.ts +0 -4
  1251. package/dist/extensions/cursor-grokbot-agents/tools/check.d.ts.map +0 -1
  1252. package/dist/extensions/cursor-grokbot-agents/tools/check.js +0 -21
  1253. package/dist/extensions/cursor-grokbot-agents/tools/interrupt.d.ts +0 -4
  1254. package/dist/extensions/cursor-grokbot-agents/tools/interrupt.d.ts.map +0 -1
  1255. package/dist/extensions/cursor-grokbot-agents/tools/interrupt.js +0 -13
  1256. package/dist/extensions/cursor-grokbot-agents/tools/list.d.ts +0 -4
  1257. package/dist/extensions/cursor-grokbot-agents/tools/list.d.ts.map +0 -1
  1258. package/dist/extensions/cursor-grokbot-agents/tools/list.js +0 -22
  1259. package/dist/internal/cli-init-grokbot.d.ts +0 -29
  1260. package/dist/internal/cli-init-grokbot.d.ts.map +0 -1
  1261. package/dist/internal/cli-init-grokbot.js +0 -181
  1262. package/dist/internal/convert-grokbot/answers.d.ts +0 -127
  1263. package/dist/internal/convert-grokbot/answers.d.ts.map +0 -1
  1264. package/dist/internal/convert-grokbot/answers.js +0 -445
  1265. package/dist/internal/convert-grokbot/bot.d.ts +0 -50
  1266. package/dist/internal/convert-grokbot/bot.d.ts.map +0 -1
  1267. package/dist/internal/convert-grokbot/bot.js +0 -72
  1268. package/dist/internal/convert-grokbot/checks.d.ts +0 -26
  1269. package/dist/internal/convert-grokbot/checks.d.ts.map +0 -1
  1270. package/dist/internal/convert-grokbot/checks.js +0 -170
  1271. package/dist/internal/convert-grokbot/convert.d.ts +0 -60
  1272. package/dist/internal/convert-grokbot/convert.d.ts.map +0 -1
  1273. package/dist/internal/convert-grokbot/convert.js +0 -470
  1274. package/dist/internal/convert-grokbot/handoff.d.ts +0 -44
  1275. package/dist/internal/convert-grokbot/handoff.d.ts.map +0 -1
  1276. package/dist/internal/convert-grokbot/handoff.js +0 -160
  1277. package/dist/internal/convert-grokbot/recipe.d.ts +0 -61
  1278. package/dist/internal/convert-grokbot/recipe.d.ts.map +0 -1
  1279. package/dist/internal/convert-grokbot/recipe.js +0 -94
  1280. package/dist/internal/convert-grokbot/routine.d.ts +0 -51
  1281. package/dist/internal/convert-grokbot/routine.d.ts.map +0 -1
  1282. package/dist/internal/convert-grokbot/routine.js +0 -128
  1283. package/dist/internal/convert-grokbot/slack.d.ts +0 -28
  1284. package/dist/internal/convert-grokbot/slack.d.ts.map +0 -1
  1285. package/dist/internal/convert-grokbot/slack.js +0 -50
  1286. package/dist/internal/factory-resource-channel.d.ts.map +0 -1
  1287. package/dist/internal/legacy-command-guard.d.ts +0 -24
  1288. package/dist/internal/legacy-command-guard.d.ts.map +0 -1
  1289. package/dist/internal/legacy-command-guard.js +0 -47
  1290. package/dist/internal/runtime-dispatch-runner.d.ts +0 -25
  1291. package/dist/internal/runtime-dispatch-runner.d.ts.map +0 -1
  1292. package/dist/internal/runtime-dispatch-runner.js +0 -35
  1293. package/dist/internal/testing/factory-resource-fixtures.d.ts +0 -64
  1294. package/dist/internal/testing/factory-resource-fixtures.d.ts.map +0 -1
  1295. package/dist/internal/testing/factory-resource-fixtures.js +0 -55
  1296. package/dist/playground/assets/cursor-icons-16-DfKNljMZ.woff2 +0 -0
  1297. package/dist/playground/assets/index-B3_YohwW.js +0 -62
  1298. package/dist/playground/assets/index-Cn3-adsJ.css +0 -1
  1299. package/docs/guides/export-grokbot.md +0 -244
  1300. package/docs/guides/grokbot-agents.md +0 -140
  1301. package/docs/templates/grokbot-agents.md +0 -60
  1302. package/schemas/grokbot-answers.schema.json +0 -354
  1303. package/templates/grokbot-agents/README.md +0 -27
  1304. package/templates/grokbot-agents/bot/agent.ts +0 -6
  1305. package/templates/grokbot-agents/bot/extensions/grokbot.ts +0 -5
  1306. package/templates/grokbot-agents/bot/instructions.md +0 -7
  1307. package/templates/grokbot-agents/evals/evals.config.ts +0 -5
  1308. package/templates/grokbot-agents/evals/grokbot-agents.eval.ts +0 -18
  1309. package/templates/grokbot-agents/init.json +0 -18
  1310. package/templates/grokbot-agents/package.json +0 -17
  1311. package/templates/grokbot-agents/tsconfig.json +0 -12
  1312. /package/dist/docs/assets/{evals.md.CHR34K1Y.lean.js → evals.md.DiljU__Z.lean.js} +0 -0
  1313. /package/dist/docs/assets/{guides_bitbucket.md.CKUayYtD.lean.js → guides_bitbucket.md.DkjkBRU8.lean.js} +0 -0
  1314. /package/dist/docs/assets/{guides_gitlab.md.CtNI4fSH.lean.js → guides_gitlab.md.DCE0p7_w.lean.js} +0 -0
  1315. /package/dist/docs/assets/{guides_pagerduty.md.BHXMcMtx.lean.js → guides_pagerduty.md.mnKXe9U0.lean.js} +0 -0
  1316. /package/dist/docs/assets/{hillclimbing.md.Dxvd-0gT.lean.js → hillclimbing.md.By61f3uq.lean.js} +0 -0
  1317. /package/dist/docs/assets/{reference_artifacts.md.DLV9MZES.lean.js → reference_artifacts.md.C-hKR2hp.lean.js} +0 -0
  1318. /package/dist/docs/assets/{reference_connections.md.BJE2Zllp.lean.js → reference_connections.md.BoAotr7_.lean.js} +0 -0
  1319. /package/dist/docs/assets/{reference_hooks.md.CROr0QgC.lean.js → reference_hooks.md.B-bwJuiG.lean.js} +0 -0
  1320. /package/dist/docs/assets/{reference_http-api.md.Dji-DD_Z.lean.js → reference_http-api.md._RWELr3d.lean.js} +0 -0
  1321. /package/dist/docs/assets/{reference_instructions.md.BYMVxAkw.lean.js → reference_instructions.md.yL2hXLnl.lean.js} +0 -0
  1322. /package/dist/docs/assets/{reference_memory.md.BwyJXYZe.lean.js → reference_memory.md.Dd7cyV9V.lean.js} +0 -0
  1323. /package/dist/docs/assets/{reference_playground.md.q4MI-0td.lean.js → reference_playground.md.CQiJk9CM.lean.js} +0 -0
  1324. /package/dist/docs/assets/{reference_project-layout.md.mFcS8yDD.lean.js → reference_project-layout.md.BamcPDUn.lean.js} +0 -0
  1325. /package/dist/docs/assets/{reference_prompt.md.DqPh71XN.lean.js → reference_prompt.md.BMjm1Jp3.lean.js} +0 -0
  1326. /package/dist/docs/assets/{reference_schedules.md.BqWnJES4.lean.js → reference_schedules.md.RC47aFm4.lean.js} +0 -0
  1327. /package/dist/docs/assets/{reference_sessions.md.Bi6lHttM.lean.js → reference_sessions.md.C7KFhWXV.lean.js} +0 -0
  1328. /package/dist/docs/assets/{reference_subagents.md.ChNGh6HK.lean.js → reference_subagents.md.CAhvW4yS.lean.js} +0 -0
  1329. /package/dist/docs/assets/{templates_agentic-owners.md.CTEnR0jp.lean.js → templates_agentic-owners.md.Dh2nDSqg.lean.js} +0 -0
  1330. /package/dist/docs/assets/{templates_security-reviewer.md.Gh6EF9Us.lean.js → templates_security-reviewer.md.DnwXdnB5.lean.js} +0 -0
  1331. /package/dist/docs/assets/{templates_triage.md.CNN6b0JZ.lean.js → templates_triage.md.BYWMloV4.lean.js} +0 -0
  1332. /package/dist/docs/assets/{troubleshooting.md.DFnoTDlQ.lean.js → troubleshooting.md.CGOdNVAL.lean.js} +0 -0
@@ -3,59 +3,59 @@
3
3
  <head>
4
4
  <meta charset="utf-8">
5
5
  <meta name="viewport" content="width=device-width,initial-scale=1">
6
- <title>Build a PR reviewer | Bot Development Kit (BDK)</title>
7
- <meta name="description" content="Create a BDK bot or agent that reviews pull requests by complexity, approves safe changes, and handles GitHub webhook events.">
6
+ <title>Build a PR reviewer | Agent SDK</title>
7
+ <meta name="description" content="Create an Agent SDK bot or agent that reviews pull requests by complexity, approves safe changes, and handles GitHub webhook events.">
8
8
  <meta name="generator" content="VitePress v1.6.4">
9
- <link rel="preload stylesheet" href="/docs/assets/style.B9o0luvp.css" as="style">
9
+ <link rel="preload stylesheet" href="/docs/assets/style.DK0YX1WL.css" as="style">
10
10
  <link rel="preload stylesheet" href="/docs/vp-icons.css" as="style">
11
11
 
12
- <script type="module" src="/docs/assets/app.wA5xBBcd.js"></script>
12
+ <script type="module" src="/docs/assets/app.DMrZKFjI.js"></script>
13
13
  <link rel="preload" href="/docs/assets/inter-roman-latin.Di8DUHzh.woff2" as="font" type="font/woff2" crossorigin="">
14
14
  <link rel="modulepreload" href="/docs/assets/chunks/framework.BNw1pucY.js">
15
- <link rel="modulepreload" href="/docs/assets/chunks/theme.DvfKzyXq.js">
15
+ <link rel="modulepreload" href="/docs/assets/chunks/theme.DRciHmS1.js">
16
16
  <link rel="modulepreload" href="/docs/assets/chunks/katex.DkKDou_j.js">
17
- <link rel="modulepreload" href="/docs/assets/chunks/dagre-KV5264BT.BBXxGEaD.js">
18
- <link rel="modulepreload" href="/docs/assets/chunks/cose-bilkent-S5V4N54A.DGpAcJ55.js">
19
- <link rel="modulepreload" href="/docs/assets/chunks/c4Diagram-AHTNJAMY.DfkDHeB9.js">
20
- <link rel="modulepreload" href="/docs/assets/chunks/flowDiagram-DWJPFMVM.M81hXIXZ.js">
21
- <link rel="modulepreload" href="/docs/assets/chunks/erDiagram-SMLLAGMA.B3bTCW_e.js">
22
- <link rel="modulepreload" href="/docs/assets/chunks/gitGraphDiagram-UUTBAWPF.CLEMZgO3.js">
23
- <link rel="modulepreload" href="/docs/assets/chunks/ganttDiagram-T4ZO3ILL.BKg7WY--.js">
24
- <link rel="modulepreload" href="/docs/assets/chunks/infoDiagram-42DDH7IO.BTiWTi82.js">
25
- <link rel="modulepreload" href="/docs/assets/chunks/pieDiagram-DEJITSTG.Cba8e8lS.js">
26
- <link rel="modulepreload" href="/docs/assets/chunks/quadrantDiagram-34T5L4WZ.2YjBycHF.js">
27
- <link rel="modulepreload" href="/docs/assets/chunks/xychartDiagram-5P7HB3ND.DnKSGQE1.js">
28
- <link rel="modulepreload" href="/docs/assets/chunks/requirementDiagram-MS252O5E.D4P5RqVI.js">
29
- <link rel="modulepreload" href="/docs/assets/chunks/sequenceDiagram-FGHM5R23.BZm7EaoT.js">
30
- <link rel="modulepreload" href="/docs/assets/chunks/classDiagram-6PBFFD2Q.DqByliAC.js">
31
- <link rel="modulepreload" href="/docs/assets/chunks/classDiagram-v2-HSJHXN6E.DqByliAC.js">
32
- <link rel="modulepreload" href="/docs/assets/chunks/stateDiagram-FHFEXIEX.DcR4f3X2.js">
33
- <link rel="modulepreload" href="/docs/assets/chunks/stateDiagram-v2-QKLJ7IA2.Bb4oMe0P.js">
34
- <link rel="modulepreload" href="/docs/assets/chunks/journeyDiagram-VCZTEJTY.0lQNZ40U.js">
35
- <link rel="modulepreload" href="/docs/assets/chunks/timeline-definition-GMOUNBTQ.CgDh96vg.js">
36
- <link rel="modulepreload" href="/docs/assets/chunks/mindmap-definition-QFDTVHPH.B56nGoB_.js">
37
- <link rel="modulepreload" href="/docs/assets/chunks/kanban-definition-6JOO6SKY.L5sKlf7X.js">
38
- <link rel="modulepreload" href="/docs/assets/chunks/sankeyDiagram-XADWPNL6.C0Hn8NUm.js">
39
- <link rel="modulepreload" href="/docs/assets/chunks/diagram-TYMM5635.YIsbRH20.js">
40
- <link rel="modulepreload" href="/docs/assets/chunks/diagram-MMDJMWI5.aHh4WGg9.js">
41
- <link rel="modulepreload" href="/docs/assets/chunks/blockDiagram-DXYQGD6D.BrXMZRtK.js">
42
- <link rel="modulepreload" href="/docs/assets/chunks/diagram-5BDNPKRD.EKqOwmK2.js">
43
- <link rel="modulepreload" href="/docs/assets/chunks/architectureDiagram-Q4EWVU46.MfG0itQh.js">
44
- <link rel="modulepreload" href="/docs/assets/chunks/ishikawaDiagram-UXIWVN3A.DcqY_KQL.js">
45
- <link rel="modulepreload" href="/docs/assets/chunks/vennDiagram-DHZGUBPP.B4fagbC8.js">
46
- <link rel="modulepreload" href="/docs/assets/chunks/diagram-G4DWMVQ6.CB8pdkoZ.js">
47
- <link rel="modulepreload" href="/docs/assets/chunks/wardleyDiagram-NUSXRM2D.DBUg0bvz.js">
17
+ <link rel="modulepreload" href="/docs/assets/chunks/dagre-KV5264BT.CLMLc0lD.js">
18
+ <link rel="modulepreload" href="/docs/assets/chunks/cose-bilkent-S5V4N54A.BfPVKeId.js">
19
+ <link rel="modulepreload" href="/docs/assets/chunks/c4Diagram-AHTNJAMY.C1QTb9GM.js">
20
+ <link rel="modulepreload" href="/docs/assets/chunks/flowDiagram-DWJPFMVM.MFihq9AF.js">
21
+ <link rel="modulepreload" href="/docs/assets/chunks/erDiagram-SMLLAGMA.CsL5JuCV.js">
22
+ <link rel="modulepreload" href="/docs/assets/chunks/gitGraphDiagram-UUTBAWPF.1HhlE45Z.js">
23
+ <link rel="modulepreload" href="/docs/assets/chunks/ganttDiagram-T4ZO3ILL.CJeLodyG.js">
24
+ <link rel="modulepreload" href="/docs/assets/chunks/infoDiagram-42DDH7IO.fp5gvytQ.js">
25
+ <link rel="modulepreload" href="/docs/assets/chunks/pieDiagram-DEJITSTG.Ba7yxiW2.js">
26
+ <link rel="modulepreload" href="/docs/assets/chunks/quadrantDiagram-34T5L4WZ.Bvskad4p.js">
27
+ <link rel="modulepreload" href="/docs/assets/chunks/xychartDiagram-5P7HB3ND.DEH4BcVJ.js">
28
+ <link rel="modulepreload" href="/docs/assets/chunks/requirementDiagram-MS252O5E.Ce70ugV9.js">
29
+ <link rel="modulepreload" href="/docs/assets/chunks/sequenceDiagram-FGHM5R23.C8a1hDs6.js">
30
+ <link rel="modulepreload" href="/docs/assets/chunks/classDiagram-6PBFFD2Q.eClS1Q0E.js">
31
+ <link rel="modulepreload" href="/docs/assets/chunks/classDiagram-v2-HSJHXN6E.eClS1Q0E.js">
32
+ <link rel="modulepreload" href="/docs/assets/chunks/stateDiagram-FHFEXIEX.D2D8A5CK.js">
33
+ <link rel="modulepreload" href="/docs/assets/chunks/stateDiagram-v2-QKLJ7IA2.77yf4kRr.js">
34
+ <link rel="modulepreload" href="/docs/assets/chunks/journeyDiagram-VCZTEJTY.qJt4uJ_H.js">
35
+ <link rel="modulepreload" href="/docs/assets/chunks/timeline-definition-GMOUNBTQ.C4ePrY8-.js">
36
+ <link rel="modulepreload" href="/docs/assets/chunks/mindmap-definition-QFDTVHPH.DgrQRFZW.js">
37
+ <link rel="modulepreload" href="/docs/assets/chunks/kanban-definition-6JOO6SKY.z2tG9kly.js">
38
+ <link rel="modulepreload" href="/docs/assets/chunks/sankeyDiagram-XADWPNL6.BJ5OEULO.js">
39
+ <link rel="modulepreload" href="/docs/assets/chunks/diagram-TYMM5635.BcpVgA_M.js">
40
+ <link rel="modulepreload" href="/docs/assets/chunks/diagram-MMDJMWI5.DLnM9eLp.js">
41
+ <link rel="modulepreload" href="/docs/assets/chunks/blockDiagram-DXYQGD6D.HjJ2goMX.js">
42
+ <link rel="modulepreload" href="/docs/assets/chunks/diagram-5BDNPKRD.C7OF7UfH.js">
43
+ <link rel="modulepreload" href="/docs/assets/chunks/architectureDiagram-Q4EWVU46.BcgfYNO_.js">
44
+ <link rel="modulepreload" href="/docs/assets/chunks/ishikawaDiagram-UXIWVN3A.C6Wk1V4I.js">
45
+ <link rel="modulepreload" href="/docs/assets/chunks/vennDiagram-DHZGUBPP.Dzso6dEA.js">
46
+ <link rel="modulepreload" href="/docs/assets/chunks/diagram-G4DWMVQ6.Dpao0Bl1.js">
47
+ <link rel="modulepreload" href="/docs/assets/chunks/wardleyDiagram-NUSXRM2D.Bf2ICxjh.js">
48
48
  <link rel="modulepreload" href="/docs/assets/chunks/virtual_mermaid-config.DDnGl6nM.js">
49
- <link rel="modulepreload" href="/docs/assets/quickstart.md.D8JDfkKO.lean.js">
49
+ <link rel="modulepreload" href="/docs/assets/quickstart.md.CljDaJBi.lean.js">
50
50
  <script id="check-dark-mode">(()=>{const e=localStorage.getItem("vitepress-theme-appearance")||"auto",a=window.matchMedia("(prefers-color-scheme: dark)").matches;(!e||e==="auto"?a:e==="dark")&&document.documentElement.classList.add("dark")})();</script>
51
51
  <script id="check-mac-os">document.documentElement.classList.toggle("mac",/Mac|iPhone|iPod|iPad/i.test(navigator.platform));</script>
52
52
  <link rel="alternate" type="text/plain" href="/docs/llms.txt">
53
53
  <link rel="alternate" type="text/markdown" href="/docs/quickstart.md">
54
54
  </head>
55
55
  <body>
56
- <div id="app"><div class="Layout" data-v-738a160a><!--[--><!--]--><!--[--><span tabindex="-1" data-v-a98c2453></span><a href="#VPContent" class="VPSkipLink visually-hidden" data-v-a98c2453>Skip to content</a><!--]--><!----><header class="VPNav" data-v-738a160a data-v-76ad4059><div class="VPNavBar" data-v-76ad4059 data-v-6fc2afcb><div class="wrapper" data-v-6fc2afcb><div class="container" data-v-6fc2afcb><div class="title" data-v-6fc2afcb><div class="VPNavBarTitle has-sidebar" data-v-6fc2afcb data-v-9e6caa3f><a class="title" href="/docs/" data-v-9e6caa3f><!--[--><!--]--><!----><span data-v-9e6caa3f>Bot Development Kit (BDK)</span><!--[--><!--[--><!--[--><!--[--><span class="bdk-version" title="BDK 0.2.27 (@cursor/bdk package)" data-v-d89e5038>0.2.27</span><!--]--><!--]--><!--]--><!--]--></a></div></div><div class="content" data-v-6fc2afcb><div class="content-body" data-v-6fc2afcb><!--[--><!--]--><div class="VPNavBarSearch search" data-v-6fc2afcb><!--[--><!----><div id="local-search"><button type="button" class="DocSearch DocSearch-Button" aria-label="Search"><span class="DocSearch-Button-Container"><span class="vp-icon DocSearch-Search-Icon"></span><span class="DocSearch-Button-Placeholder">Search</span></span><span class="DocSearch-Button-Keys"><kbd class="DocSearch-Button-Key"></kbd><kbd class="DocSearch-Button-Key">K</kbd></span></button></div><!--]--></div><nav aria-labelledby="main-nav-aria-label" class="VPNavBarMenu menu" data-v-6fc2afcb data-v-78f72f99><span id="main-nav-aria-label" class="visually-hidden" data-v-78f72f99> Main Navigation </span><!--[--><!--[--><a class="VPLink link VPNavBarMenuLink active" href="/docs/quickstart.html" tabindex="0" data-v-78f72f99 data-v-a7790978><!--[--><span data-v-a7790978>Quickstart</span><!--]--></a><!--]--><!--[--><a class="VPLink link VPNavBarMenuLink" href="/docs/guides/mcp-oauth.html" tabindex="0" data-v-78f72f99 data-v-a7790978><!--[--><span data-v-a7790978>Guides</span><!--]--></a><!--]--><!--[--><a class="VPLink link VPNavBarMenuLink" href="/docs/guides/github.html" tabindex="0" data-v-78f72f99 data-v-a7790978><!--[--><span data-v-a7790978>Integrations</span><!--]--></a><!--]--><!--[--><a class="VPLink link VPNavBarMenuLink" href="/docs/templates/security-reviewer.html" tabindex="0" data-v-78f72f99 data-v-a7790978><!--[--><span data-v-a7790978>Templates</span><!--]--></a><!--]--><!--[--><a class="VPLink link VPNavBarMenuLink" href="/docs/reference/project-layout.html" tabindex="0" data-v-78f72f99 data-v-a7790978><!--[--><span data-v-a7790978>Reference</span><!--]--></a><!--]--><!--]--></nav><!----><div class="VPNavBarAppearance appearance" data-v-6fc2afcb data-v-bf7c3d0f><button class="VPSwitch VPSwitchAppearance" type="button" role="switch" title aria-checked="false" data-v-bf7c3d0f data-v-e9e166e4 data-v-74f7b0ff><span class="check" data-v-74f7b0ff><span class="icon" data-v-74f7b0ff><!--[--><span class="vpi-sun sun" data-v-e9e166e4></span><span class="vpi-moon moon" data-v-e9e166e4></span><!--]--></span></span></button></div><!----><div class="VPFlyout VPNavBarExtra extra" data-v-6fc2afcb data-v-799c9281 data-v-070c9767><button type="button" class="button" aria-haspopup="true" aria-expanded="false" aria-label="extra navigation" data-v-070c9767><span class="vpi-more-horizontal icon" data-v-070c9767></span></button><div class="menu" data-v-070c9767><div class="VPMenu" data-v-070c9767 data-v-c05d27ee><!----><!--[--><!--[--><!----><div class="group" data-v-799c9281><div class="item appearance" data-v-799c9281><p class="label" data-v-799c9281>Appearance</p><div class="appearance-action" data-v-799c9281><button class="VPSwitch VPSwitchAppearance" type="button" role="switch" title aria-checked="false" data-v-799c9281 data-v-e9e166e4 data-v-74f7b0ff><span class="check" data-v-74f7b0ff><span class="icon" data-v-74f7b0ff><!--[--><span class="vpi-sun sun" data-v-e9e166e4></span><span class="vpi-moon moon" data-v-e9e166e4></span><!--]--></span></span></button></div></div></div><!----><!--]--><!--]--></div></div></div><!--[--><!--]--><button type="button" class="VPNavBarHamburger hamburger" aria-label="mobile navigation" aria-expanded="false" aria-controls="VPNavScreen" data-v-6fc2afcb data-v-2caaf84e><span class="container" data-v-2caaf84e><span class="top" data-v-2caaf84e></span><span class="middle" data-v-2caaf84e></span><span class="bottom" data-v-2caaf84e></span></span></button></div></div></div></div><div class="divider" data-v-6fc2afcb><div class="divider-line" data-v-6fc2afcb></div></div></div><!----></header><div class="VPLocalNav has-sidebar empty" data-v-738a160a data-v-e0cbfd80><div class="container" data-v-e0cbfd80><button class="menu" aria-expanded="false" aria-controls="VPSidebarNav" data-v-e0cbfd80><span class="vpi-align-left menu-icon" data-v-e0cbfd80></span><span class="menu-text" data-v-e0cbfd80>Menu</span></button><div class="VPLocalNavOutlineDropdown" style="--vp-vh:0px;" data-v-e0cbfd80 data-v-36e0b8e9><button data-v-36e0b8e9>Return to top</button><!----></div></div></div><aside class="VPSidebar" data-v-738a160a data-v-2859715e><div class="curtain" data-v-2859715e></div><nav class="nav" id="VPSidebarNav" aria-labelledby="sidebar-aria-label" tabindex="-1" data-v-2859715e><span class="visually-hidden" id="sidebar-aria-label" data-v-2859715e> Sidebar Navigation </span><!--[--><!--]--><!--[--><div class="no-transition group" data-v-8ed949fd><section class="VPSidebarItem level-0 has-active" data-v-8ed949fd data-v-84325fb7><div class="item" role="button" tabindex="0" data-v-84325fb7><div class="indicator" data-v-84325fb7></div><h2 class="text" data-v-84325fb7>Getting started</h2><!----></div><div class="items" data-v-84325fb7><!--[--><div class="VPSidebarItem level-1 is-link" data-v-84325fb7><div class="item" data-v-84325fb7><div class="indicator" data-v-84325fb7></div><a class="VPLink link link" href="/docs/" data-v-84325fb7><!--[--><p class="text" data-v-84325fb7>Overview</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-84325fb7><div class="item" data-v-84325fb7><div class="indicator" data-v-84325fb7></div><a class="VPLink link link" href="/docs/changelog.html" data-v-84325fb7><!--[--><p class="text" data-v-84325fb7>Changelog</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-84325fb7><div class="item" data-v-84325fb7><div class="indicator" data-v-84325fb7></div><a class="VPLink link link" href="/docs/quickstart.html" data-v-84325fb7><!--[--><p class="text" data-v-84325fb7>Building your first agent</p><!--]--></a><!----></div><!----></div><!--]--></div></section></div><div class="no-transition group" data-v-8ed949fd><section class="VPSidebarItem level-0 collapsible" data-v-8ed949fd data-v-84325fb7><div class="item" role="button" tabindex="0" data-v-84325fb7><div class="indicator" data-v-84325fb7></div><h2 class="text" data-v-84325fb7>Integrations</h2><div class="caret" role="button" aria-label="toggle section" tabindex="0" data-v-84325fb7><span class="vpi-chevron-right caret-icon" data-v-84325fb7></span></div></div><div class="items" data-v-84325fb7><!--[--><div class="VPSidebarItem level-1 is-link" data-v-84325fb7><div class="item" data-v-84325fb7><div class="indicator" data-v-84325fb7></div><a class="VPLink link link" href="/docs/guides/github.html" data-v-84325fb7><!--[--><p class="text" data-v-84325fb7>GitHub</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-84325fb7><div class="item" data-v-84325fb7><div class="indicator" data-v-84325fb7></div><a class="VPLink link link" href="/docs/guides/slack.html" data-v-84325fb7><!--[--><p class="text" data-v-84325fb7>Slack</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-84325fb7><div class="item" data-v-84325fb7><div class="indicator" data-v-84325fb7></div><a class="VPLink link link" href="/docs/guides/webhooks.html" data-v-84325fb7><!--[--><p class="text" data-v-84325fb7>Webhooks</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-84325fb7><div class="item" data-v-84325fb7><div class="indicator" data-v-84325fb7></div><a class="VPLink link link" href="/docs/guides/convert-automation.html" data-v-84325fb7><!--[--><p class="text" data-v-84325fb7>Cursor Automations</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-84325fb7><div class="item" data-v-84325fb7><div class="indicator" data-v-84325fb7></div><a class="VPLink link link" href="/docs/guides/opentelemetry.html" data-v-84325fb7><!--[--><p class="text" data-v-84325fb7>OpenTelemetry</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-84325fb7><div class="item" data-v-84325fb7><div class="indicator" data-v-84325fb7></div><a class="VPLink link link" href="/docs/guides/gitlab.html" data-v-84325fb7><!--[--><p class="text" data-v-84325fb7>GitLab</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-84325fb7><div class="item" data-v-84325fb7><div class="indicator" data-v-84325fb7></div><a class="VPLink link link" href="/docs/guides/bitbucket.html" data-v-84325fb7><!--[--><p class="text" data-v-84325fb7>Bitbucket</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-84325fb7><div class="item" data-v-84325fb7><div class="indicator" data-v-84325fb7></div><a class="VPLink link link" href="/docs/guides/pagerduty.html" data-v-84325fb7><!--[--><p class="text" data-v-84325fb7>PagerDuty</p><!--]--></a><!----></div><!----></div><!--]--></div></section></div><div class="no-transition group" data-v-8ed949fd><section class="VPSidebarItem level-0 collapsible" data-v-8ed949fd data-v-84325fb7><div class="item" role="button" tabindex="0" data-v-84325fb7><div class="indicator" data-v-84325fb7></div><h2 class="text" data-v-84325fb7>Extensions</h2><div class="caret" role="button" aria-label="toggle section" tabindex="0" data-v-84325fb7><span class="vpi-chevron-right caret-icon" data-v-84325fb7></span></div></div><div class="items" data-v-84325fb7><!--[--><div class="VPSidebarItem level-1 is-link" data-v-84325fb7><div class="item" data-v-84325fb7><div class="indicator" data-v-84325fb7></div><a class="VPLink link link" href="/docs/reference/extensions.html" data-v-84325fb7><!--[--><p class="text" data-v-84325fb7>Overview</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-84325fb7><div class="item" data-v-84325fb7><div class="indicator" data-v-84325fb7></div><a class="VPLink link link" href="/docs/guides/cloud-agents.html" data-v-84325fb7><!--[--><p class="text" data-v-84325fb7>Cloud agents</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-84325fb7><div class="item" data-v-84325fb7><div class="indicator" data-v-84325fb7></div><a class="VPLink link link" href="/docs/guides/grokbot-agents.html" data-v-84325fb7><!--[--><p class="text" data-v-84325fb7>Grok Bot agents</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-84325fb7><div class="item" data-v-84325fb7><div class="indicator" data-v-84325fb7></div><a class="VPLink link link" href="/docs/guides/improve.html" data-v-84325fb7><!--[--><p class="text" data-v-84325fb7>Self-improvement</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-84325fb7><div class="item" data-v-84325fb7><div class="indicator" data-v-84325fb7></div><a class="VPLink link link" href="/docs/guides/jev.html" data-v-84325fb7><!--[--><p class="text" data-v-84325fb7>Jev</p><!--]--></a><!----></div><!----></div><!--]--></div></section></div><div class="no-transition group" data-v-8ed949fd><section class="VPSidebarItem level-0 collapsible" data-v-8ed949fd data-v-84325fb7><div class="item" role="button" tabindex="0" data-v-84325fb7><div class="indicator" data-v-84325fb7></div><h2 class="text" data-v-84325fb7>Guides</h2><div class="caret" role="button" aria-label="toggle section" tabindex="0" data-v-84325fb7><span class="vpi-chevron-right caret-icon" data-v-84325fb7></span></div></div><div class="items" data-v-84325fb7><!--[--><div class="VPSidebarItem level-1 is-link" data-v-84325fb7><div class="item" data-v-84325fb7><div class="indicator" data-v-84325fb7></div><a class="VPLink link link" href="/docs/guides/mcp-oauth.html" data-v-84325fb7><!--[--><p class="text" data-v-84325fb7>MCP</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-84325fb7><div class="item" data-v-84325fb7><div class="indicator" data-v-84325fb7></div><a class="VPLink link link" href="/docs/guides/hooks.html" data-v-84325fb7><!--[--><p class="text" data-v-84325fb7>Hooks</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-84325fb7><div class="item" data-v-84325fb7><div class="indicator" data-v-84325fb7></div><a class="VPLink link link" href="/docs/guides/agent-to-agent.html" data-v-84325fb7><!--[--><p class="text" data-v-84325fb7>Peer agents</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-84325fb7><div class="item" data-v-84325fb7><div class="indicator" data-v-84325fb7></div><a class="VPLink link link" href="/docs/deployment.html" data-v-84325fb7><!--[--><p class="text" data-v-84325fb7>Deployment</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-84325fb7><div class="item" data-v-84325fb7><div class="indicator" data-v-84325fb7></div><a class="VPLink link link" href="/docs/guides/export-grokbot.html" data-v-84325fb7><!--[--><p class="text" data-v-84325fb7>Export a Grok Bot</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-84325fb7><div class="item" data-v-84325fb7><div class="indicator" data-v-84325fb7></div><a class="VPLink link link" href="/docs/guides/migrate.html" data-v-84325fb7><!--[--><p class="text" data-v-84325fb7>Early-alpha migration</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-84325fb7><div class="item" data-v-84325fb7><div class="indicator" data-v-84325fb7></div><a class="VPLink link link" href="/docs/evals.html" data-v-84325fb7><!--[--><p class="text" data-v-84325fb7>Evals</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-84325fb7><div class="item" data-v-84325fb7><div class="indicator" data-v-84325fb7></div><a class="VPLink link link" href="/docs/hillclimbing.html" data-v-84325fb7><!--[--><p class="text" data-v-84325fb7>Hillclimbing</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-84325fb7><div class="item" data-v-84325fb7><div class="indicator" data-v-84325fb7></div><a class="VPLink link link" href="/docs/building-with-agents.html" data-v-84325fb7><!--[--><p class="text" data-v-84325fb7>Build with a coding agent</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-84325fb7><div class="item" data-v-84325fb7><div class="indicator" data-v-84325fb7></div><a class="VPLink link link" href="/docs/troubleshooting.html" data-v-84325fb7><!--[--><p class="text" data-v-84325fb7>Troubleshooting</p><!--]--></a><!----></div><!----></div><!--]--></div></section></div><div class="no-transition group" data-v-8ed949fd><section class="VPSidebarItem level-0 collapsible" data-v-8ed949fd data-v-84325fb7><div class="item" role="button" tabindex="0" data-v-84325fb7><div class="indicator" data-v-84325fb7></div><h2 class="text" data-v-84325fb7>Templates</h2><div class="caret" role="button" aria-label="toggle section" tabindex="0" data-v-84325fb7><span class="vpi-chevron-right caret-icon" data-v-84325fb7></span></div></div><div class="items" data-v-84325fb7><!--[--><div class="VPSidebarItem level-1 is-link" data-v-84325fb7><div class="item" data-v-84325fb7><div class="indicator" data-v-84325fb7></div><a class="VPLink link link" href="/docs/templates/grokbot-agents.html" data-v-84325fb7><!--[--><p class="text" data-v-84325fb7>Grok Bot agents</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-84325fb7><div class="item" data-v-84325fb7><div class="indicator" data-v-84325fb7></div><a class="VPLink link link" href="/docs/templates/security-reviewer.html" data-v-84325fb7><!--[--><p class="text" data-v-84325fb7>Security reviewer</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-84325fb7><div class="item" data-v-84325fb7><div class="indicator" data-v-84325fb7></div><a class="VPLink link link" href="/docs/templates/thermo-review.html" data-v-84325fb7><!--[--><p class="text" data-v-84325fb7>Thermo review</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-84325fb7><div class="item" data-v-84325fb7><div class="indicator" data-v-84325fb7></div><a class="VPLink link link" href="/docs/templates/thermo-quality-review.html" data-v-84325fb7><!--[--><p class="text" data-v-84325fb7>Thermo quality review</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-84325fb7><div class="item" data-v-84325fb7><div class="indicator" data-v-84325fb7></div><a class="VPLink link link" href="/docs/templates/agentic-owners.html" data-v-84325fb7><!--[--><p class="text" data-v-84325fb7>Agentic Approver</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-84325fb7><div class="item" data-v-84325fb7><div class="indicator" data-v-84325fb7></div><a class="VPLink link link" href="/docs/templates/triage.html" data-v-84325fb7><!--[--><p class="text" data-v-84325fb7>Triage agent</p><!--]--></a><!----></div><!----></div><!--]--></div></section></div><div class="no-transition group" data-v-8ed949fd><section class="VPSidebarItem level-0 collapsible" data-v-8ed949fd data-v-84325fb7><div class="item" role="button" tabindex="0" data-v-84325fb7><div class="indicator" data-v-84325fb7></div><h2 class="text" data-v-84325fb7>Reference</h2><div class="caret" role="button" aria-label="toggle section" tabindex="0" data-v-84325fb7><span class="vpi-chevron-right caret-icon" data-v-84325fb7></span></div></div><div class="items" data-v-84325fb7><!--[--><div class="VPSidebarItem level-1 is-link" data-v-84325fb7><div class="item" data-v-84325fb7><div class="indicator" data-v-84325fb7></div><a class="VPLink link link" href="/docs/reference/project-layout.html" data-v-84325fb7><!--[--><p class="text" data-v-84325fb7>Project layout</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-84325fb7><div class="item" data-v-84325fb7><div class="indicator" data-v-84325fb7></div><a class="VPLink link link" href="/docs/reference/agent-config.html" data-v-84325fb7><!--[--><p class="text" data-v-84325fb7>Agent config</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-84325fb7><div class="item" data-v-84325fb7><div class="indicator" data-v-84325fb7></div><a class="VPLink link link" href="/docs/reference/instructions.html" data-v-84325fb7><!--[--><p class="text" data-v-84325fb7>Instructions</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-84325fb7><div class="item" data-v-84325fb7><div class="indicator" data-v-84325fb7></div><a class="VPLink link link" href="/docs/reference/tools.html" data-v-84325fb7><!--[--><p class="text" data-v-84325fb7>Tools</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-84325fb7><div class="item" data-v-84325fb7><div class="indicator" data-v-84325fb7></div><a class="VPLink link link" href="/docs/reference/prompt.html" data-v-84325fb7><!--[--><p class="text" data-v-84325fb7>prompt</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-84325fb7><div class="item" data-v-84325fb7><div class="indicator" data-v-84325fb7></div><a class="VPLink link link" href="/docs/reference/skills.html" data-v-84325fb7><!--[--><p class="text" data-v-84325fb7>Skills</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-84325fb7><div class="item" data-v-84325fb7><div class="indicator" data-v-84325fb7></div><a class="VPLink link link" href="/docs/reference/connections.html" data-v-84325fb7><!--[--><p class="text" data-v-84325fb7>MCP Connections</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-84325fb7><div class="item" data-v-84325fb7><div class="indicator" data-v-84325fb7></div><a class="VPLink link link" href="/docs/reference/subagents.html" data-v-84325fb7><!--[--><p class="text" data-v-84325fb7>Subagents</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-84325fb7><div class="item" data-v-84325fb7><div class="indicator" data-v-84325fb7></div><a class="VPLink link link" href="/docs/reference/channels.html" data-v-84325fb7><!--[--><p class="text" data-v-84325fb7>Channels</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-84325fb7><div class="item" data-v-84325fb7><div class="indicator" data-v-84325fb7></div><a class="VPLink link link" href="/docs/reference/schedules.html" data-v-84325fb7><!--[--><p class="text" data-v-84325fb7>Schedules & reminders</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-84325fb7><div class="item" data-v-84325fb7><div class="indicator" data-v-84325fb7></div><a class="VPLink link link" href="/docs/reference/hooks.html" data-v-84325fb7><!--[--><p class="text" data-v-84325fb7>Hooks</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-84325fb7><div class="item" data-v-84325fb7><div class="indicator" data-v-84325fb7></div><a class="VPLink link link" href="/docs/reference/memory.html" data-v-84325fb7><!--[--><p class="text" data-v-84325fb7>Memory</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-84325fb7><div class="item" data-v-84325fb7><div class="indicator" data-v-84325fb7></div><a class="VPLink link link" href="/docs/reference/evals.html" data-v-84325fb7><!--[--><p class="text" data-v-84325fb7>Evals</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-84325fb7><div class="item" data-v-84325fb7><div class="indicator" data-v-84325fb7></div><a class="VPLink link link" href="/docs/reference/artifacts.html" data-v-84325fb7><!--[--><p class="text" data-v-84325fb7>Artifacts</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-84325fb7><div class="item" data-v-84325fb7><div class="indicator" data-v-84325fb7></div><a class="VPLink link link" href="/docs/reference/sessions.html" data-v-84325fb7><!--[--><p class="text" data-v-84325fb7>Sessions & streaming</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-84325fb7><div class="item" data-v-84325fb7><div class="indicator" data-v-84325fb7></div><a class="VPLink link link" href="/docs/reference/playground.html" data-v-84325fb7><!--[--><p class="text" data-v-84325fb7>Playground</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-84325fb7><div class="item" data-v-84325fb7><div class="indicator" data-v-84325fb7></div><a class="VPLink link link" href="/docs/reference/cli.html" data-v-84325fb7><!--[--><p class="text" data-v-84325fb7>CLI</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-84325fb7><div class="item" data-v-84325fb7><div class="indicator" data-v-84325fb7></div><a class="VPLink link link" href="/docs/reference/http-api.html" data-v-84325fb7><!--[--><p class="text" data-v-84325fb7>HTTP API</p><!--]--></a><!----></div><!----></div><!--]--></div></section></div><!--]--><!--[--><!--]--></nav></aside><div class="VPContent has-sidebar" id="VPContent" data-v-738a160a data-v-9f462cdf><div class="VPDoc has-sidebar has-aside" data-v-9f462cdf data-v-995f90b4><!--[--><!--]--><div class="container" data-v-995f90b4><div class="aside" data-v-995f90b4><div class="aside-curtain" data-v-995f90b4></div><div class="aside-container" data-v-995f90b4><div class="aside-content" data-v-995f90b4><div class="VPDocAside" data-v-995f90b4 data-v-10889960><!--[--><!--]--><!--[--><!--]--><nav aria-labelledby="doc-outline-aria-label" class="VPDocAsideOutline" data-v-10889960 data-v-afb61a88><div class="content" data-v-afb61a88><div class="outline-marker" data-v-afb61a88></div><div aria-level="2" class="outline-title" id="doc-outline-aria-label" role="heading" data-v-afb61a88>On this page</div><ul class="VPDocOutlineItem root" data-v-afb61a88 data-v-0587367d><!--[--><!--]--></ul></div></nav><!--[--><!--]--><div class="spacer" data-v-10889960></div><!--[--><!--]--><!----><!--[--><!--]--><!--[--><!--]--></div></div></div></div><div class="content" data-v-995f90b4><div class="content-container" data-v-995f90b4><!--[--><!--]--><main class="main" data-v-995f90b4><div style="position:relative;" class="vp-doc _docs_quickstart" data-v-995f90b4><div><h1 id="build-a-pr-reviewer-with-bdk" tabindex="-1">Build a PR reviewer with BDK <a class="header-anchor" href="#build-a-pr-reviewer-with-bdk" aria-label="Permalink to &quot;Build a PR reviewer with BDK&quot;">​</a></h1><p>Build a PR reviewer with the Bot Development Kit (BDK). It classifies changes as <code>trivial</code>, <code>moderate</code>, or <code>large</code>, then approves safe changes or requests human review.</p><h2 id="prerequisites" tabindex="-1">Prerequisites <a class="header-anchor" href="#prerequisites" aria-label="Permalink to &quot;Prerequisites&quot;">​</a></h2><ul><li><p>Node 22.13 or newer.</p></li><li><p>The <code>@cursor/bdk</code> package:</p></li></ul><div class="language-text vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">text</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span>npm install -g @cursor/bdk</span></span></code></pre></div><ul><li>A Cursor credential for model turns. Sign in once:</li></ul><div class="language-text vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">text</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span>bdk login</span></span></code></pre></div><h2 id="create-and-run-the-project" tabindex="-1">Create and run the project <a class="header-anchor" href="#create-and-run-the-project" aria-label="Permalink to &quot;Create and run the project&quot;">​</a></h2><p>The preferred BDK workflow uses <code>bdk init</code> and <code>bdk dev</code>.</p><div class="language-text vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">text</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span>bdk init ./pr-reviewer</span></span>
56
+ <div id="app"><div class="Layout" data-v-738a160a><!--[--><!--]--><!--[--><span tabindex="-1" data-v-a98c2453></span><a href="#VPContent" class="VPSkipLink visually-hidden" data-v-a98c2453>Skip to content</a><!--]--><!----><header class="VPNav" data-v-738a160a data-v-76ad4059><div class="VPNavBar" data-v-76ad4059 data-v-6fc2afcb><div class="wrapper" data-v-6fc2afcb><div class="container" data-v-6fc2afcb><div class="title" data-v-6fc2afcb><div class="VPNavBarTitle has-sidebar" data-v-6fc2afcb data-v-9e6caa3f><a class="title" href="/docs/" data-v-9e6caa3f><!--[--><!--]--><!----><span data-v-9e6caa3f>Agent SDK</span><!--[--><!--[--><!--[--><!--[--><span class="bdk-version" title="Agent SDK 0.2.29 (@grok/agent-sdk package)" data-v-a03aeddf>0.2.29</span><!--]--><!--]--><!--]--><!--]--></a></div></div><div class="content" data-v-6fc2afcb><div class="content-body" data-v-6fc2afcb><!--[--><!--]--><div class="VPNavBarSearch search" data-v-6fc2afcb><!--[--><!----><div id="local-search"><button type="button" class="DocSearch DocSearch-Button" aria-label="Search"><span class="DocSearch-Button-Container"><span class="vp-icon DocSearch-Search-Icon"></span><span class="DocSearch-Button-Placeholder">Search</span></span><span class="DocSearch-Button-Keys"><kbd class="DocSearch-Button-Key"></kbd><kbd class="DocSearch-Button-Key">K</kbd></span></button></div><!--]--></div><nav aria-labelledby="main-nav-aria-label" class="VPNavBarMenu menu" data-v-6fc2afcb data-v-78f72f99><span id="main-nav-aria-label" class="visually-hidden" data-v-78f72f99> Main Navigation </span><!--[--><!--[--><a class="VPLink link VPNavBarMenuLink active" href="/docs/quickstart.html" tabindex="0" data-v-78f72f99 data-v-a7790978><!--[--><span data-v-a7790978>Quickstart</span><!--]--></a><!--]--><!--[--><a class="VPLink link VPNavBarMenuLink" href="/docs/guides/mcp-oauth.html" tabindex="0" data-v-78f72f99 data-v-a7790978><!--[--><span data-v-a7790978>Guides</span><!--]--></a><!--]--><!--[--><a class="VPLink link VPNavBarMenuLink" href="/docs/guides/github.html" tabindex="0" data-v-78f72f99 data-v-a7790978><!--[--><span data-v-a7790978>Integrations</span><!--]--></a><!--]--><!--[--><a class="VPLink link VPNavBarMenuLink" href="/docs/templates/security-reviewer.html" tabindex="0" data-v-78f72f99 data-v-a7790978><!--[--><span data-v-a7790978>Templates</span><!--]--></a><!--]--><!--[--><a class="VPLink link VPNavBarMenuLink" href="/docs/reference/project-layout.html" tabindex="0" data-v-78f72f99 data-v-a7790978><!--[--><span data-v-a7790978>Reference</span><!--]--></a><!--]--><!--]--></nav><!----><div class="VPNavBarAppearance appearance" data-v-6fc2afcb data-v-bf7c3d0f><button class="VPSwitch VPSwitchAppearance" type="button" role="switch" title aria-checked="false" data-v-bf7c3d0f data-v-e9e166e4 data-v-74f7b0ff><span class="check" data-v-74f7b0ff><span class="icon" data-v-74f7b0ff><!--[--><span class="vpi-sun sun" data-v-e9e166e4></span><span class="vpi-moon moon" data-v-e9e166e4></span><!--]--></span></span></button></div><!----><div class="VPFlyout VPNavBarExtra extra" data-v-6fc2afcb data-v-799c9281 data-v-070c9767><button type="button" class="button" aria-haspopup="true" aria-expanded="false" aria-label="extra navigation" data-v-070c9767><span class="vpi-more-horizontal icon" data-v-070c9767></span></button><div class="menu" data-v-070c9767><div class="VPMenu" data-v-070c9767 data-v-c05d27ee><!----><!--[--><!--[--><!----><div class="group" data-v-799c9281><div class="item appearance" data-v-799c9281><p class="label" data-v-799c9281>Appearance</p><div class="appearance-action" data-v-799c9281><button class="VPSwitch VPSwitchAppearance" type="button" role="switch" title aria-checked="false" data-v-799c9281 data-v-e9e166e4 data-v-74f7b0ff><span class="check" data-v-74f7b0ff><span class="icon" data-v-74f7b0ff><!--[--><span class="vpi-sun sun" data-v-e9e166e4></span><span class="vpi-moon moon" data-v-e9e166e4></span><!--]--></span></span></button></div></div></div><!----><!--]--><!--]--></div></div></div><!--[--><!--]--><button type="button" class="VPNavBarHamburger hamburger" aria-label="mobile navigation" aria-expanded="false" aria-controls="VPNavScreen" data-v-6fc2afcb data-v-2caaf84e><span class="container" data-v-2caaf84e><span class="top" data-v-2caaf84e></span><span class="middle" data-v-2caaf84e></span><span class="bottom" data-v-2caaf84e></span></span></button></div></div></div></div><div class="divider" data-v-6fc2afcb><div class="divider-line" data-v-6fc2afcb></div></div></div><!----></header><div class="VPLocalNav has-sidebar empty" data-v-738a160a data-v-e0cbfd80><div class="container" data-v-e0cbfd80><button class="menu" aria-expanded="false" aria-controls="VPSidebarNav" data-v-e0cbfd80><span class="vpi-align-left menu-icon" data-v-e0cbfd80></span><span class="menu-text" data-v-e0cbfd80>Menu</span></button><div class="VPLocalNavOutlineDropdown" style="--vp-vh:0px;" data-v-e0cbfd80 data-v-36e0b8e9><button data-v-36e0b8e9>Return to top</button><!----></div></div></div><aside class="VPSidebar" data-v-738a160a data-v-2859715e><div class="curtain" data-v-2859715e></div><nav class="nav" id="VPSidebarNav" aria-labelledby="sidebar-aria-label" tabindex="-1" data-v-2859715e><span class="visually-hidden" id="sidebar-aria-label" data-v-2859715e> Sidebar Navigation </span><!--[--><!--]--><!--[--><div class="no-transition group" data-v-8ed949fd><section class="VPSidebarItem level-0 has-active" data-v-8ed949fd data-v-84325fb7><div class="item" role="button" tabindex="0" data-v-84325fb7><div class="indicator" data-v-84325fb7></div><h2 class="text" data-v-84325fb7>Getting started</h2><!----></div><div class="items" data-v-84325fb7><!--[--><div class="VPSidebarItem level-1 is-link" data-v-84325fb7><div class="item" data-v-84325fb7><div class="indicator" data-v-84325fb7></div><a class="VPLink link link" href="/docs/" data-v-84325fb7><!--[--><p class="text" data-v-84325fb7>Overview</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-84325fb7><div class="item" data-v-84325fb7><div class="indicator" data-v-84325fb7></div><a class="VPLink link link" href="/docs/changelog.html" data-v-84325fb7><!--[--><p class="text" data-v-84325fb7>Changelog</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-84325fb7><div class="item" data-v-84325fb7><div class="indicator" data-v-84325fb7></div><a class="VPLink link link" href="/docs/quickstart.html" data-v-84325fb7><!--[--><p class="text" data-v-84325fb7>Building your first agent</p><!--]--></a><!----></div><!----></div><!--]--></div></section></div><div class="no-transition group" data-v-8ed949fd><section class="VPSidebarItem level-0 collapsible" data-v-8ed949fd data-v-84325fb7><div class="item" role="button" tabindex="0" data-v-84325fb7><div class="indicator" data-v-84325fb7></div><h2 class="text" data-v-84325fb7>Integrations</h2><div class="caret" role="button" aria-label="toggle section" tabindex="0" data-v-84325fb7><span class="vpi-chevron-right caret-icon" data-v-84325fb7></span></div></div><div class="items" data-v-84325fb7><!--[--><div class="VPSidebarItem level-1 is-link" data-v-84325fb7><div class="item" data-v-84325fb7><div class="indicator" data-v-84325fb7></div><a class="VPLink link link" href="/docs/guides/github.html" data-v-84325fb7><!--[--><p class="text" data-v-84325fb7>GitHub</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-84325fb7><div class="item" data-v-84325fb7><div class="indicator" data-v-84325fb7></div><a class="VPLink link link" href="/docs/guides/slack.html" data-v-84325fb7><!--[--><p class="text" data-v-84325fb7>Slack</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-84325fb7><div class="item" data-v-84325fb7><div class="indicator" data-v-84325fb7></div><a class="VPLink link link" href="/docs/guides/webhooks.html" data-v-84325fb7><!--[--><p class="text" data-v-84325fb7>Webhooks</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-84325fb7><div class="item" data-v-84325fb7><div class="indicator" data-v-84325fb7></div><a class="VPLink link link" href="/docs/guides/convert-automation.html" data-v-84325fb7><!--[--><p class="text" data-v-84325fb7>Cursor Automations</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-84325fb7><div class="item" data-v-84325fb7><div class="indicator" data-v-84325fb7></div><a class="VPLink link link" href="/docs/guides/opentelemetry.html" data-v-84325fb7><!--[--><p class="text" data-v-84325fb7>OpenTelemetry</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-84325fb7><div class="item" data-v-84325fb7><div class="indicator" data-v-84325fb7></div><a class="VPLink link link" href="/docs/guides/gitlab.html" data-v-84325fb7><!--[--><p class="text" data-v-84325fb7>GitLab</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-84325fb7><div class="item" data-v-84325fb7><div class="indicator" data-v-84325fb7></div><a class="VPLink link link" href="/docs/guides/bitbucket.html" data-v-84325fb7><!--[--><p class="text" data-v-84325fb7>Bitbucket</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-84325fb7><div class="item" data-v-84325fb7><div class="indicator" data-v-84325fb7></div><a class="VPLink link link" href="/docs/guides/pagerduty.html" data-v-84325fb7><!--[--><p class="text" data-v-84325fb7>PagerDuty</p><!--]--></a><!----></div><!----></div><!--]--></div></section></div><div class="no-transition group" data-v-8ed949fd><section class="VPSidebarItem level-0 collapsible" data-v-8ed949fd data-v-84325fb7><div class="item" role="button" tabindex="0" data-v-84325fb7><div class="indicator" data-v-84325fb7></div><h2 class="text" data-v-84325fb7>Extensions</h2><div class="caret" role="button" aria-label="toggle section" tabindex="0" data-v-84325fb7><span class="vpi-chevron-right caret-icon" data-v-84325fb7></span></div></div><div class="items" data-v-84325fb7><!--[--><div class="VPSidebarItem level-1 is-link" data-v-84325fb7><div class="item" data-v-84325fb7><div class="indicator" data-v-84325fb7></div><a class="VPLink link link" href="/docs/reference/extensions.html" data-v-84325fb7><!--[--><p class="text" data-v-84325fb7>Overview</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-84325fb7><div class="item" data-v-84325fb7><div class="indicator" data-v-84325fb7></div><a class="VPLink link link" href="/docs/guides/cloud-agents.html" data-v-84325fb7><!--[--><p class="text" data-v-84325fb7>Cloud agents</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-84325fb7><div class="item" data-v-84325fb7><div class="indicator" data-v-84325fb7></div><a class="VPLink link link" href="/docs/guides/improve.html" data-v-84325fb7><!--[--><p class="text" data-v-84325fb7>Self-improvement</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-84325fb7><div class="item" data-v-84325fb7><div class="indicator" data-v-84325fb7></div><a class="VPLink link link" href="/docs/guides/jev.html" data-v-84325fb7><!--[--><p class="text" data-v-84325fb7>Jev</p><!--]--></a><!----></div><!----></div><!--]--></div></section></div><div class="no-transition group" data-v-8ed949fd><section class="VPSidebarItem level-0 collapsible" data-v-8ed949fd data-v-84325fb7><div class="item" role="button" tabindex="0" data-v-84325fb7><div class="indicator" data-v-84325fb7></div><h2 class="text" data-v-84325fb7>Guides</h2><div class="caret" role="button" aria-label="toggle section" tabindex="0" data-v-84325fb7><span class="vpi-chevron-right caret-icon" data-v-84325fb7></span></div></div><div class="items" data-v-84325fb7><!--[--><div class="VPSidebarItem level-1 is-link" data-v-84325fb7><div class="item" data-v-84325fb7><div class="indicator" data-v-84325fb7></div><a class="VPLink link link" href="/docs/guides/mcp-oauth.html" data-v-84325fb7><!--[--><p class="text" data-v-84325fb7>MCP</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-84325fb7><div class="item" data-v-84325fb7><div class="indicator" data-v-84325fb7></div><a class="VPLink link link" href="/docs/guides/hooks.html" data-v-84325fb7><!--[--><p class="text" data-v-84325fb7>Hooks</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-84325fb7><div class="item" data-v-84325fb7><div class="indicator" data-v-84325fb7></div><a class="VPLink link link" href="/docs/guides/agent-to-agent.html" data-v-84325fb7><!--[--><p class="text" data-v-84325fb7>Peer agents</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-84325fb7><div class="item" data-v-84325fb7><div class="indicator" data-v-84325fb7></div><a class="VPLink link link" href="/docs/deployment.html" data-v-84325fb7><!--[--><p class="text" data-v-84325fb7>Deployment</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-84325fb7><div class="item" data-v-84325fb7><div class="indicator" data-v-84325fb7></div><a class="VPLink link link" href="/docs/guides/migrate.html" data-v-84325fb7><!--[--><p class="text" data-v-84325fb7>Early-alpha migration</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-84325fb7><div class="item" data-v-84325fb7><div class="indicator" data-v-84325fb7></div><a class="VPLink link link" href="/docs/evals.html" data-v-84325fb7><!--[--><p class="text" data-v-84325fb7>Evals</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-84325fb7><div class="item" data-v-84325fb7><div class="indicator" data-v-84325fb7></div><a class="VPLink link link" href="/docs/hillclimbing.html" data-v-84325fb7><!--[--><p class="text" data-v-84325fb7>Hillclimbing</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-84325fb7><div class="item" data-v-84325fb7><div class="indicator" data-v-84325fb7></div><a class="VPLink link link" href="/docs/building-with-agents.html" data-v-84325fb7><!--[--><p class="text" data-v-84325fb7>Build with a coding agent</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-84325fb7><div class="item" data-v-84325fb7><div class="indicator" data-v-84325fb7></div><a class="VPLink link link" href="/docs/troubleshooting.html" data-v-84325fb7><!--[--><p class="text" data-v-84325fb7>Troubleshooting</p><!--]--></a><!----></div><!----></div><!--]--></div></section></div><div class="no-transition group" data-v-8ed949fd><section class="VPSidebarItem level-0 collapsible" data-v-8ed949fd data-v-84325fb7><div class="item" role="button" tabindex="0" data-v-84325fb7><div class="indicator" data-v-84325fb7></div><h2 class="text" data-v-84325fb7>Templates</h2><div class="caret" role="button" aria-label="toggle section" tabindex="0" data-v-84325fb7><span class="vpi-chevron-right caret-icon" data-v-84325fb7></span></div></div><div class="items" data-v-84325fb7><!--[--><div class="VPSidebarItem level-1 is-link" data-v-84325fb7><div class="item" data-v-84325fb7><div class="indicator" data-v-84325fb7></div><a class="VPLink link link" href="/docs/templates/security-reviewer.html" data-v-84325fb7><!--[--><p class="text" data-v-84325fb7>Security reviewer</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-84325fb7><div class="item" data-v-84325fb7><div class="indicator" data-v-84325fb7></div><a class="VPLink link link" href="/docs/templates/thermo-review.html" data-v-84325fb7><!--[--><p class="text" data-v-84325fb7>Thermo review</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-84325fb7><div class="item" data-v-84325fb7><div class="indicator" data-v-84325fb7></div><a class="VPLink link link" href="/docs/templates/thermo-quality-review.html" data-v-84325fb7><!--[--><p class="text" data-v-84325fb7>Thermo quality review</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-84325fb7><div class="item" data-v-84325fb7><div class="indicator" data-v-84325fb7></div><a class="VPLink link link" href="/docs/templates/agentic-owners.html" data-v-84325fb7><!--[--><p class="text" data-v-84325fb7>Agentic Approver</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-84325fb7><div class="item" data-v-84325fb7><div class="indicator" data-v-84325fb7></div><a class="VPLink link link" href="/docs/templates/triage.html" data-v-84325fb7><!--[--><p class="text" data-v-84325fb7>Triage agent</p><!--]--></a><!----></div><!----></div><!--]--></div></section></div><div class="no-transition group" data-v-8ed949fd><section class="VPSidebarItem level-0 collapsible" data-v-8ed949fd data-v-84325fb7><div class="item" role="button" tabindex="0" data-v-84325fb7><div class="indicator" data-v-84325fb7></div><h2 class="text" data-v-84325fb7>Reference</h2><div class="caret" role="button" aria-label="toggle section" tabindex="0" data-v-84325fb7><span class="vpi-chevron-right caret-icon" data-v-84325fb7></span></div></div><div class="items" data-v-84325fb7><!--[--><div class="VPSidebarItem level-1 is-link" data-v-84325fb7><div class="item" data-v-84325fb7><div class="indicator" data-v-84325fb7></div><a class="VPLink link link" href="/docs/reference/project-layout.html" data-v-84325fb7><!--[--><p class="text" data-v-84325fb7>Project layout</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-84325fb7><div class="item" data-v-84325fb7><div class="indicator" data-v-84325fb7></div><a class="VPLink link link" href="/docs/reference/agent-config.html" data-v-84325fb7><!--[--><p class="text" data-v-84325fb7>Agent config</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-84325fb7><div class="item" data-v-84325fb7><div class="indicator" data-v-84325fb7></div><a class="VPLink link link" href="/docs/reference/instructions.html" data-v-84325fb7><!--[--><p class="text" data-v-84325fb7>Instructions</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-84325fb7><div class="item" data-v-84325fb7><div class="indicator" data-v-84325fb7></div><a class="VPLink link link" href="/docs/reference/tools.html" data-v-84325fb7><!--[--><p class="text" data-v-84325fb7>Tools</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-84325fb7><div class="item" data-v-84325fb7><div class="indicator" data-v-84325fb7></div><a class="VPLink link link" href="/docs/reference/prompt.html" data-v-84325fb7><!--[--><p class="text" data-v-84325fb7>prompt</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-84325fb7><div class="item" data-v-84325fb7><div class="indicator" data-v-84325fb7></div><a class="VPLink link link" href="/docs/reference/skills.html" data-v-84325fb7><!--[--><p class="text" data-v-84325fb7>Skills</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-84325fb7><div class="item" data-v-84325fb7><div class="indicator" data-v-84325fb7></div><a class="VPLink link link" href="/docs/reference/connections.html" data-v-84325fb7><!--[--><p class="text" data-v-84325fb7>MCP Connections</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-84325fb7><div class="item" data-v-84325fb7><div class="indicator" data-v-84325fb7></div><a class="VPLink link link" href="/docs/reference/subagents.html" data-v-84325fb7><!--[--><p class="text" data-v-84325fb7>Subagents</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-84325fb7><div class="item" data-v-84325fb7><div class="indicator" data-v-84325fb7></div><a class="VPLink link link" href="/docs/reference/channels.html" data-v-84325fb7><!--[--><p class="text" data-v-84325fb7>Channels</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-84325fb7><div class="item" data-v-84325fb7><div class="indicator" data-v-84325fb7></div><a class="VPLink link link" href="/docs/reference/schedules.html" data-v-84325fb7><!--[--><p class="text" data-v-84325fb7>Schedules & reminders</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-84325fb7><div class="item" data-v-84325fb7><div class="indicator" data-v-84325fb7></div><a class="VPLink link link" href="/docs/reference/hooks.html" data-v-84325fb7><!--[--><p class="text" data-v-84325fb7>Hooks</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-84325fb7><div class="item" data-v-84325fb7><div class="indicator" data-v-84325fb7></div><a class="VPLink link link" href="/docs/reference/memory.html" data-v-84325fb7><!--[--><p class="text" data-v-84325fb7>Memory</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-84325fb7><div class="item" data-v-84325fb7><div class="indicator" data-v-84325fb7></div><a class="VPLink link link" href="/docs/reference/evals.html" data-v-84325fb7><!--[--><p class="text" data-v-84325fb7>Evals</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-84325fb7><div class="item" data-v-84325fb7><div class="indicator" data-v-84325fb7></div><a class="VPLink link link" href="/docs/reference/artifacts.html" data-v-84325fb7><!--[--><p class="text" data-v-84325fb7>Artifacts</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-84325fb7><div class="item" data-v-84325fb7><div class="indicator" data-v-84325fb7></div><a class="VPLink link link" href="/docs/reference/sessions.html" data-v-84325fb7><!--[--><p class="text" data-v-84325fb7>Sessions & streaming</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-84325fb7><div class="item" data-v-84325fb7><div class="indicator" data-v-84325fb7></div><a class="VPLink link link" href="/docs/reference/playground.html" data-v-84325fb7><!--[--><p class="text" data-v-84325fb7>Playground</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-84325fb7><div class="item" data-v-84325fb7><div class="indicator" data-v-84325fb7></div><a class="VPLink link link" href="/docs/reference/cli.html" data-v-84325fb7><!--[--><p class="text" data-v-84325fb7>CLI</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-84325fb7><div class="item" data-v-84325fb7><div class="indicator" data-v-84325fb7></div><a class="VPLink link link" href="/docs/reference/http-api.html" data-v-84325fb7><!--[--><p class="text" data-v-84325fb7>HTTP API</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-84325fb7><div class="item" data-v-84325fb7><div class="indicator" data-v-84325fb7></div><a class="VPLink link link" href="/docs/reference/access.html" data-v-84325fb7><!--[--><p class="text" data-v-84325fb7>Access</p><!--]--></a><!----></div><!----></div><!--]--></div></section></div><!--]--><!--[--><!--]--></nav></aside><div class="VPContent has-sidebar" id="VPContent" data-v-738a160a data-v-9f462cdf><div class="VPDoc has-sidebar has-aside" data-v-9f462cdf data-v-995f90b4><!--[--><!--]--><div class="container" data-v-995f90b4><div class="aside" data-v-995f90b4><div class="aside-curtain" data-v-995f90b4></div><div class="aside-container" data-v-995f90b4><div class="aside-content" data-v-995f90b4><div class="VPDocAside" data-v-995f90b4 data-v-10889960><!--[--><!--]--><!--[--><!--]--><nav aria-labelledby="doc-outline-aria-label" class="VPDocAsideOutline" data-v-10889960 data-v-afb61a88><div class="content" data-v-afb61a88><div class="outline-marker" data-v-afb61a88></div><div aria-level="2" class="outline-title" id="doc-outline-aria-label" role="heading" data-v-afb61a88>On this page</div><ul class="VPDocOutlineItem root" data-v-afb61a88 data-v-0587367d><!--[--><!--]--></ul></div></nav><!--[--><!--]--><div class="spacer" data-v-10889960></div><!--[--><!--]--><!----><!--[--><!--]--><!--[--><!--]--></div></div></div></div><div class="content" data-v-995f90b4><div class="content-container" data-v-995f90b4><!--[--><!--]--><main class="main" data-v-995f90b4><div style="position:relative;" class="vp-doc _docs_quickstart" data-v-995f90b4><div><h1 id="build-a-pr-reviewer-with-agent-sdk" tabindex="-1">Build a PR reviewer with Agent SDK <a class="header-anchor" href="#build-a-pr-reviewer-with-agent-sdk" aria-label="Permalink to &quot;Build a PR reviewer with Agent SDK&quot;">​</a></h1><p>Build a PR reviewer with the Agent SDK. It classifies changes as <code>trivial</code>, <code>moderate</code>, or <code>large</code>, then approves safe changes or requests human review.</p><h2 id="prerequisites" tabindex="-1">Prerequisites <a class="header-anchor" href="#prerequisites" aria-label="Permalink to &quot;Prerequisites&quot;">​</a></h2><ul><li><p>Node 22.13 or newer.</p></li><li><p>The <code>@grok/agent-sdk</code> package:</p></li></ul><div class="language-text vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">text</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span>npm install -g @grok/agent-sdk</span></span></code></pre></div><ul><li>A Cursor credential for model turns. Sign in once:</li></ul><div class="language-text vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">text</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span>agent-sdk login</span></span></code></pre></div><h2 id="create-and-run-the-project" tabindex="-1">Create and run the project <a class="header-anchor" href="#create-and-run-the-project" aria-label="Permalink to &quot;Create and run the project&quot;">​</a></h2><p>The preferred Agent SDK workflow uses <code>agent-sdk init</code> and <code>agent-sdk dev</code>.</p><div class="language-text vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">text</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span>agent-sdk init ./pr-reviewer</span></span>
57
57
  <span class="line"><span>cd pr-reviewer</span></span>
58
- <span class="line"><span>bdk dev</span></span></code></pre></div><p>Keep <code>bdk dev</code> running. In a second terminal, run:</p><div class="language-text vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">text</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span>bdk run --dir . --message &quot;Introduce yourself in one sentence.&quot;</span></span></code></pre></div><p>Confirm the agent replies.</p><h2 id="add-review-instructions" tabindex="-1">Add review instructions <a class="header-anchor" href="#add-review-instructions" aria-label="Permalink to &quot;Add review instructions&quot;">​</a></h2><p>Replace <code>bot/instructions.md</code>:</p><div class="language-md vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">md</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#005CC5;--shiki-light-font-weight:bold;--shiki-dark:#79B8FF;--shiki-dark-font-weight:bold;"># PR reviewer</span></span>
58
+ <span class="line"><span>agent-sdk dev</span></span></code></pre></div><p>Keep <code>agent-sdk dev</code> running. In a second terminal, run:</p><div class="language-text vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">text</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span>agent-sdk run --dir . --message &quot;Introduce yourself in one sentence.&quot;</span></span></code></pre></div><p>Confirm the agent replies.</p><h2 id="add-review-instructions" tabindex="-1">Add review instructions <a class="header-anchor" href="#add-review-instructions" aria-label="Permalink to &quot;Add review instructions&quot;">​</a></h2><p>Replace <code>bot/instructions.md</code>:</p><div class="language-md vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">md</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#005CC5;--shiki-light-font-weight:bold;--shiki-dark:#79B8FF;--shiki-dark-font-weight:bold;"># PR reviewer</span></span>
59
59
  <span class="line"></span>
60
60
  <span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">You review GitHub pull requests. Be specific and brief.</span></span>
61
61
  <span class="line"></span>
@@ -75,7 +75,7 @@
75
75
  <span class="line"><span style="--shiki-light:#E36209;--shiki-dark:#FFAB70;">3.</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> Never approve a draft. Point out anything surprising, even when you</span></span>
76
76
  <span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> approve.</span></span>
77
77
  <span class="line"></span>
78
- <span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">End with one sentence: the verdict and why.</span></span></code></pre></div><h2 id="add-the-inspect-tool" tabindex="-1">Add the inspect tool <a class="header-anchor" href="#add-the-inspect-tool" aria-label="Permalink to &quot;Add the inspect tool&quot;">​</a></h2><p>Create <code>bot/tools/inspect_pr.ts</code>:</p><div class="language-ts vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">ts</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">import</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> { defineTool } </span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">from</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> &quot;@cursor/bdk/tools&quot;</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">;</span></span>
78
+ <span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">End with one sentence: the verdict and why.</span></span></code></pre></div><h2 id="add-the-inspect-tool" tabindex="-1">Add the inspect tool <a class="header-anchor" href="#add-the-inspect-tool" aria-label="Permalink to &quot;Add the inspect tool&quot;">​</a></h2><p>Create <code>bot/tools/inspect_pr.ts</code>:</p><div class="language-ts vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">ts</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">import</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> { defineTool } </span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">from</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> &quot;@grok/agent-sdk/tools&quot;</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">;</span></span>
79
79
  <span class="line"><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">import</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> { z } </span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">from</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> &quot;zod&quot;</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">;</span></span>
80
80
  <span class="line"></span>
81
81
  <span class="line"><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">export</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> type</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;"> Complexity</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> =</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> &quot;trivial&quot;</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> |</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> &quot;moderate&quot;</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> |</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> &quot;large&quot;</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">;</span></span>
@@ -153,9 +153,9 @@
153
153
  <span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> })),</span></span>
154
154
  <span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> };</span></span>
155
155
  <span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> },</span></span>
156
- <span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">});</span></span></code></pre></div><h2 id="verify-complexity-classification" tabindex="-1">Verify complexity classification <a class="header-anchor" href="#verify-complexity-classification" aria-label="Permalink to &quot;Verify complexity classification&quot;">​</a></h2><p>Run <code>inspect_pr</code> against a small pull request:</p><div class="language-text vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">text</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span>bdk call inspect_pr --dir . \</span></span>
157
- <span class="line"><span> --input &#39;{&quot;prUrl&quot;:&quot;https://github.com/facebook/react/pull/35623&quot;}&#39;</span></span></code></pre></div><p>Confirm the result contains <code>&quot;complexity&quot;: &quot;trivial&quot;</code>.</p><p>Run it against a large pull request:</p><div class="language-text vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">text</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span>bdk call inspect_pr --dir . \</span></span>
158
- <span class="line"><span> --input &#39;{&quot;prUrl&quot;:&quot;https://github.com/facebook/react/pull/25229&quot;}&#39;</span></span></code></pre></div><p>Confirm the result contains <code>&quot;complexity&quot;: &quot;large&quot;</code> and no <code>patch</code> fields.</p><h2 id="add-the-review-tool" tabindex="-1">Add the review tool <a class="header-anchor" href="#add-the-review-tool" aria-label="Permalink to &quot;Add the review tool&quot;">​</a></h2><p>Create <code>bot/tools/submit_review.ts</code> to post each verdict:</p><div class="language-ts vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">ts</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">import</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> { defineTool } </span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">from</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> &quot;@cursor/bdk/tools&quot;</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">;</span></span>
156
+ <span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">});</span></span></code></pre></div><h2 id="verify-complexity-classification" tabindex="-1">Verify complexity classification <a class="header-anchor" href="#verify-complexity-classification" aria-label="Permalink to &quot;Verify complexity classification&quot;">​</a></h2><p>Run <code>inspect_pr</code> against a small pull request:</p><div class="language-text vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">text</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span>agent-sdk tool call inspect_pr --dir . \</span></span>
157
+ <span class="line"><span> --input &#39;{&quot;prUrl&quot;:&quot;https://github.com/facebook/react/pull/35623&quot;}&#39;</span></span></code></pre></div><p>Confirm the result contains <code>&quot;complexity&quot;: &quot;trivial&quot;</code>.</p><p>Run it against a large pull request:</p><div class="language-text vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">text</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span>agent-sdk tool call inspect_pr --dir . \</span></span>
158
+ <span class="line"><span> --input &#39;{&quot;prUrl&quot;:&quot;https://github.com/facebook/react/pull/25229&quot;}&#39;</span></span></code></pre></div><p>Confirm the result contains <code>&quot;complexity&quot;: &quot;large&quot;</code> and no <code>patch</code> fields.</p><h2 id="add-the-review-tool" tabindex="-1">Add the review tool <a class="header-anchor" href="#add-the-review-tool" aria-label="Permalink to &quot;Add the review tool&quot;">​</a></h2><p>Create <code>bot/tools/submit_review.ts</code> to post each verdict:</p><div class="language-ts vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">ts</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">import</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> { defineTool } </span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">from</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> &quot;@grok/agent-sdk/tools&quot;</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">;</span></span>
159
159
  <span class="line"><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">import</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> { z } </span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">from</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> &quot;zod&quot;</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">;</span></span>
160
160
  <span class="line"></span>
161
161
  <span class="line"><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">export</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> default</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;"> defineTool</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">({</span></span>
@@ -196,16 +196,16 @@
196
196
  <span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> });</span></span>
197
197
  <span class="line"><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> return</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> { posted: </span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">true</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">, </span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">...</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">review };</span></span>
198
198
  <span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> },</span></span>
199
- <span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">});</span></span></code></pre></div><p>Use a GitHub credential with write access and a pull request you didn&#39;t author.</p><h2 id="review-a-pull-request" tabindex="-1">Review a pull request <a class="header-anchor" href="#review-a-pull-request" aria-label="Permalink to &quot;Review a pull request&quot;">​</a></h2><p>Review an open pull request:</p><div class="language-text vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">text</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span>bdk run --dir . \</span></span>
199
+ <span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">});</span></span></code></pre></div><p>Use a GitHub credential with write access and a pull request you didn&#39;t author.</p><h2 id="review-a-pull-request" tabindex="-1">Review a pull request <a class="header-anchor" href="#review-a-pull-request" aria-label="Permalink to &quot;Review a pull request&quot;">​</a></h2><p>Review an open pull request:</p><div class="language-text vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">text</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span>agent-sdk run --dir . \</span></span>
200
200
  <span class="line"><span> --message &quot;Review https://github.com/acme/checkout/pull/42&quot;</span></span></code></pre></div><p>Confirm <code>inspect_pr</code> runs before <code>submit_review</code>, then verify the review on GitHub.</p><h2 id="trigger-reviews-from-github" tabindex="-1">Trigger reviews from GitHub <a class="header-anchor" href="#trigger-reviews-from-github" aria-label="Permalink to &quot;Trigger reviews from GitHub&quot;">​</a></h2><p>Create <code>bot/channels/github.ts</code>:</p><div class="language-ts vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">ts</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">import</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> {</span></span>
201
201
  <span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> defaultGitHubAuth,</span></span>
202
202
  <span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> githubChannel,</span></span>
203
- <span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">} </span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">from</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> &quot;@cursor/bdk/channels/github&quot;</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">;</span></span>
203
+ <span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">} </span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">from</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> &quot;@grok/agent-sdk/channels/github&quot;</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">;</span></span>
204
204
  <span class="line"></span>
205
205
  <span class="line"><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">const</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;"> REVIEW_ACTIONS</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> =</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> new</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;"> Set</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">([</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">&quot;opened&quot;</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">, </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">&quot;reopened&quot;</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">, </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">&quot;ready_for_review&quot;</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">]);</span></span>
206
206
  <span class="line"></span>
207
207
  <span class="line"><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">export</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> default</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;"> githubChannel</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">({</span></span>
208
- <span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> botName: </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">&quot;bdk-pr-reviewer&quot;</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">,</span></span>
208
+ <span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> botName: </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">&quot;agent-sdk-pr-reviewer&quot;</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">,</span></span>
209
209
  <span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> cursorAccount: { repos: [</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">&quot;acme/checkout&quot;</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">] },</span></span>
210
210
  <span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;"> onPullRequest</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">: (</span><span style="--shiki-light:#E36209;--shiki-dark:#FFAB70;">ctx</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">, </span><span style="--shiki-light:#E36209;--shiki-dark:#FFAB70;">pr</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">) </span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">=&gt;</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> {</span></span>
211
211
  <span class="line"><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> if</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> (</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">!</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">REVIEW_ACTIONS</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">.</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">has</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">(pr.action) </span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">||</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> pr.draft) {</span></span>
@@ -220,10 +220,10 @@
220
220
  <span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> ],</span></span>
221
221
  <span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> };</span></span>
222
222
  <span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> },</span></span>
223
- <span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">});</span></span></code></pre></div><p>Channel-turn <code>context</code> is a <code>readonly string[]</code>, so wrap each context block in an array. The <code>context</code> label under <code>progress.commitStatus</code> is a separate string option.</p><p>Keep <code>bdk dev</code> running. In a second terminal, replay an open pull request. Pull access is enough; repo admin isn&#39;t required:</p><div class="language-text vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">text</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span>bdk github replay https://github.com/acme/checkout/pull/42 \</span></span>
224
- <span class="line"><span> --dir . --action opened</span></span></code></pre></div><p>Open the playground and confirm <code>Review acme/checkout#42</code> contains the trigger, both tool calls, and the verdict.</p><h2 id="run-options" tabindex="-1">Run options <a class="header-anchor" href="#run-options" aria-label="Permalink to &quot;Run options&quot;">​</a></h2><ol><li><strong>CLI message</strong></li></ol><div class="language-text vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">text</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span> bdk run --dir . --message &quot;Review https://github.com/acme/checkout/pull/42&quot;</span></span></code></pre></div><ol start="2"><li><strong>Local replay</strong></li></ol><div class="language-text vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">text</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span> bdk github replay https://github.com/acme/checkout/pull/42 \</span></span>
225
- <span class="line"><span> --dir . --action opened</span></span></code></pre></div><h2 id="where-to-go-next" tabindex="-1">Where to go next <a class="header-anchor" href="#where-to-go-next" aria-label="Permalink to &quot;Where to go next&quot;">​</a></h2><ul><li><a href="./evals.html">Evals</a>: freeze these two PRs as regression checks so prompt changes can&#39;t flip a verdict</li><li><a href="./reference/tools.html">Tools</a>: more on typed tools, dry-run effects, and direct calls</li><li><a href="./guides/github.html">GitHub</a>: fixtures, forwarding, and pulling events from Cursor</li><li><a href="./building-with-agents.html">Building agents with agents</a>: have a coding agent extend the project for you</li></ul></div></div></main><footer class="VPDocFooter" data-v-995f90b4 data-v-8edf72db><!--[--><!--]--><!----><nav class="prev-next" aria-labelledby="doc-footer-aria-label" data-v-8edf72db><span class="visually-hidden" id="doc-footer-aria-label" data-v-8edf72db>Pager</span><div class="pager" data-v-8edf72db><a class="VPLink link pager-link prev" href="/docs/changelog.html" data-v-8edf72db><!--[--><span class="desc" data-v-8edf72db>Previous page</span><span class="title" data-v-8edf72db>Changelog</span><!--]--></a></div><div class="pager" data-v-8edf72db><a class="VPLink link pager-link next" href="/docs/guides/github.html" data-v-8edf72db><!--[--><span class="desc" data-v-8edf72db>Next page</span><span class="title" data-v-8edf72db>GitHub</span><!--]--></a></div></nav></footer><!--[--><!--]--></div></div></div><!--[--><!--]--></div></div><!----><!--[--><!--]--></div></div>
226
- <script>window.__VP_HASH_MAP__=JSON.parse("{\"building-with-agents.md\":\"FZXrY8Nk\",\"changelog.md\":\"BvHRIiMH\",\"deployment.md\":\"3MMWuPeV\",\"evals.md\":\"CHR34K1Y\",\"guides_agent-to-agent.md\":\"CwL5cwuE\",\"guides_bitbucket.md\":\"CKUayYtD\",\"guides_cloud-agents.md\":\"BzbzcOyj\",\"guides_convert-automation.md\":\"DMEX9nF-\",\"guides_export-grokbot.md\":\"qo5bxi4h\",\"guides_github.md\":\"TuNiZAOQ\",\"guides_gitlab.md\":\"CtNI4fSH\",\"guides_grokbot-agents.md\":\"BwAykJ7U\",\"guides_hooks.md\":\"B2XfGX50\",\"guides_improve.md\":\"CZKVt1cT\",\"guides_jev.md\":\"D7XH4JH3\",\"guides_mcp-oauth.md\":\"Cxq2TxBB\",\"guides_migrate.md\":\"CQlGaBKX\",\"guides_opentelemetry.md\":\"D4wO7_8v\",\"guides_pagerduty.md\":\"BHXMcMtx\",\"guides_slack.md\":\"ClIyi7FI\",\"guides_webhooks.md\":\"Cpdc3BDX\",\"hillclimbing.md\":\"Dxvd-0gT\",\"index.md\":\"CAnsLl8D\",\"quickstart.md\":\"D8JDfkKO\",\"reference_agent-config.md\":\"CZrbHOfT\",\"reference_artifacts.md\":\"DLV9MZES\",\"reference_channels.md\":\"CNNIS6K7\",\"reference_cli.md\":\"1o_TqKdt\",\"reference_connections.md\":\"BJE2Zllp\",\"reference_evals.md\":\"Ccwp4x3o\",\"reference_extensions.md\":\"DKxTuCIw\",\"reference_hooks.md\":\"CROr0QgC\",\"reference_http-api.md\":\"Dji-DD_Z\",\"reference_instructions.md\":\"BYMVxAkw\",\"reference_memory.md\":\"BwyJXYZe\",\"reference_playground.md\":\"q4MI-0td\",\"reference_project-layout.md\":\"mFcS8yDD\",\"reference_prompt.md\":\"DqPh71XN\",\"reference_schedules.md\":\"BqWnJES4\",\"reference_sessions.md\":\"Bi6lHttM\",\"reference_skills.md\":\"Ckddg6KX\",\"reference_subagents.md\":\"ChNGh6HK\",\"reference_tools.md\":\"Bo0UfT0a\",\"templates_agentic-owners.md\":\"CTEnR0jp\",\"templates_grokbot-agents.md\":\"DgpPEs7B\",\"templates_security-reviewer.md\":\"Gh6EF9Us\",\"templates_thermo-quality-review.md\":\"B77UyTrX\",\"templates_thermo-review.md\":\"DRJ7mC5U\",\"templates_triage.md\":\"CNN6b0JZ\",\"troubleshooting.md\":\"DFnoTDlQ\"}");window.__VP_SITE_DATA__=JSON.parse("{\"lang\":\"en-US\",\"dir\":\"ltr\",\"title\":\"Bot Development Kit (BDK)\",\"description\":\"Build and serve bots and agents from versioned Markdown and TypeScript.\",\"base\":\"/docs/\",\"head\":[],\"router\":{\"prefetchLinks\":true},\"appearance\":true,\"themeConfig\":{\"sdkVersion\":\"0.2.27\",\"nav\":[{\"text\":\"Quickstart\",\"link\":\"/quickstart\"},{\"text\":\"Guides\",\"link\":\"/guides/mcp-oauth\"},{\"text\":\"Integrations\",\"link\":\"/guides/github\"},{\"text\":\"Templates\",\"link\":\"/templates/security-reviewer\"},{\"text\":\"Reference\",\"link\":\"/reference/project-layout\"}],\"search\":{\"provider\":\"local\"},\"outline\":{\"level\":[2,3]},\"sidebar\":[{\"text\":\"Getting started\",\"items\":[{\"text\":\"Overview\",\"link\":\"/\"},{\"text\":\"Changelog\",\"link\":\"/changelog\"},{\"text\":\"Building your first agent\",\"link\":\"/quickstart\"}]},{\"text\":\"Integrations\",\"collapsed\":false,\"items\":[{\"text\":\"GitHub\",\"link\":\"/guides/github\"},{\"text\":\"Slack\",\"link\":\"/guides/slack\"},{\"text\":\"Webhooks\",\"link\":\"/guides/webhooks\"},{\"text\":\"Cursor Automations\",\"link\":\"/guides/convert-automation\"},{\"text\":\"OpenTelemetry\",\"link\":\"/guides/opentelemetry\"},{\"text\":\"GitLab\",\"link\":\"/guides/gitlab\"},{\"text\":\"Bitbucket\",\"link\":\"/guides/bitbucket\"},{\"text\":\"PagerDuty\",\"link\":\"/guides/pagerduty\"}]},{\"text\":\"Extensions\",\"collapsed\":false,\"items\":[{\"text\":\"Overview\",\"link\":\"/reference/extensions\"},{\"text\":\"Cloud agents\",\"link\":\"/guides/cloud-agents\"},{\"text\":\"Grok Bot agents\",\"link\":\"/guides/grokbot-agents\"},{\"text\":\"Self-improvement\",\"link\":\"/guides/improve\"},{\"text\":\"Jev\",\"link\":\"/guides/jev\"}]},{\"text\":\"Guides\",\"collapsed\":false,\"items\":[{\"text\":\"MCP\",\"link\":\"/guides/mcp-oauth\"},{\"text\":\"Hooks\",\"link\":\"/guides/hooks\"},{\"text\":\"Peer agents\",\"link\":\"/guides/agent-to-agent\"},{\"text\":\"Deployment\",\"link\":\"/deployment\"},{\"text\":\"Export a Grok Bot\",\"link\":\"/guides/export-grokbot\"},{\"text\":\"Early-alpha migration\",\"link\":\"/guides/migrate\"},{\"text\":\"Evals\",\"link\":\"/evals\"},{\"text\":\"Hillclimbing\",\"link\":\"/hillclimbing\"},{\"text\":\"Build with a coding agent\",\"link\":\"/building-with-agents\"},{\"text\":\"Troubleshooting\",\"link\":\"/troubleshooting\"}]},{\"text\":\"Templates\",\"collapsed\":false,\"items\":[{\"text\":\"Grok Bot agents\",\"link\":\"/templates/grokbot-agents\"},{\"text\":\"Security reviewer\",\"link\":\"/templates/security-reviewer\"},{\"text\":\"Thermo review\",\"link\":\"/templates/thermo-review\"},{\"text\":\"Thermo quality review\",\"link\":\"/templates/thermo-quality-review\"},{\"text\":\"Agentic Approver\",\"link\":\"/templates/agentic-owners\"},{\"text\":\"Triage agent\",\"link\":\"/templates/triage\"}]},{\"text\":\"Reference\",\"collapsed\":false,\"items\":[{\"text\":\"Project layout\",\"link\":\"/reference/project-layout\"},{\"text\":\"Agent config\",\"link\":\"/reference/agent-config\"},{\"text\":\"Instructions\",\"link\":\"/reference/instructions\"},{\"text\":\"Tools\",\"link\":\"/reference/tools\"},{\"text\":\"prompt\",\"link\":\"/reference/prompt\"},{\"text\":\"Skills\",\"link\":\"/reference/skills\"},{\"text\":\"MCP Connections\",\"link\":\"/reference/connections\"},{\"text\":\"Subagents\",\"link\":\"/reference/subagents\"},{\"text\":\"Channels\",\"link\":\"/reference/channels\"},{\"text\":\"Schedules & reminders\",\"link\":\"/reference/schedules\"},{\"text\":\"Hooks\",\"link\":\"/reference/hooks\"},{\"text\":\"Memory\",\"link\":\"/reference/memory\"},{\"text\":\"Evals\",\"link\":\"/reference/evals\"},{\"text\":\"Artifacts\",\"link\":\"/reference/artifacts\"},{\"text\":\"Sessions & streaming\",\"link\":\"/reference/sessions\"},{\"text\":\"Playground\",\"link\":\"/reference/playground\"},{\"text\":\"CLI\",\"link\":\"/reference/cli\"},{\"text\":\"HTTP API\",\"link\":\"/reference/http-api\"}]}]},\"locales\":{},\"scrollOffset\":134,\"cleanUrls\":false}");</script>
223
+ <span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">});</span></span></code></pre></div><p>Channel-turn <code>context</code> is a <code>readonly string[]</code>, so wrap each context block in an array. The <code>context</code> label under <code>progress.commitStatus</code> is a separate string option.</p><p>Keep <code>agent-sdk dev</code> running. In a second terminal, replay an open pull request. Pull access is enough; repo admin isn&#39;t required:</p><div class="language-text vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">text</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span>agent-sdk github replay https://github.com/acme/checkout/pull/42 \</span></span>
224
+ <span class="line"><span> --dir . --action opened</span></span></code></pre></div><p>Open the playground and confirm <code>Review acme/checkout#42</code> contains the trigger, both tool calls, and the verdict.</p><h2 id="run-options" tabindex="-1">Run options <a class="header-anchor" href="#run-options" aria-label="Permalink to &quot;Run options&quot;">​</a></h2><ol><li><strong>CLI message</strong></li></ol><div class="language-text vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">text</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span> agent-sdk run --dir . --message &quot;Review https://github.com/acme/checkout/pull/42&quot;</span></span></code></pre></div><ol start="2"><li><strong>Local replay</strong></li></ol><div class="language-text vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">text</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span> agent-sdk github replay https://github.com/acme/checkout/pull/42 \</span></span>
225
+ <span class="line"><span> --dir . --action opened</span></span></code></pre></div><h2 id="deploy-the-reviewer" tabindex="-1">Deploy the reviewer <a class="header-anchor" href="#deploy-the-reviewer" aria-label="Permalink to &quot;Deploy the reviewer&quot;">​</a></h2><p>Follow <a href="./deployment.html">Deployment</a> and run <code>agent-sdk deploy</code>. After the command reports the runtime is running, open <a href="https://cursor.com/dashboard/deployed-agents" target="_blank" rel="noreferrer">Deployed Agents</a> to see the reviewer and manage it.</p><h2 id="where-to-go-next" tabindex="-1">Where to go next <a class="header-anchor" href="#where-to-go-next" aria-label="Permalink to &quot;Where to go next&quot;">​</a></h2><ul><li><a href="./evals.html">Evals</a>: freeze these two PRs as regression checks so prompt changes can&#39;t flip a verdict</li><li><a href="./reference/tools.html">Tools</a>: more on typed tools, dry-run effects, and direct calls</li><li><a href="./guides/github.html">GitHub</a>: fixtures, forwarding, and pulling events from Cursor</li><li><a href="./building-with-agents.html">Building agents with agents</a>: have a coding agent extend the project for you</li></ul></div></div></main><footer class="VPDocFooter" data-v-995f90b4 data-v-8edf72db><!--[--><!--]--><!----><nav class="prev-next" aria-labelledby="doc-footer-aria-label" data-v-8edf72db><span class="visually-hidden" id="doc-footer-aria-label" data-v-8edf72db>Pager</span><div class="pager" data-v-8edf72db><a class="VPLink link pager-link prev" href="/docs/changelog.html" data-v-8edf72db><!--[--><span class="desc" data-v-8edf72db>Previous page</span><span class="title" data-v-8edf72db>Changelog</span><!--]--></a></div><div class="pager" data-v-8edf72db><a class="VPLink link pager-link next" href="/docs/guides/github.html" data-v-8edf72db><!--[--><span class="desc" data-v-8edf72db>Next page</span><span class="title" data-v-8edf72db>GitHub</span><!--]--></a></div></nav></footer><!--[--><!--]--></div></div></div><!--[--><!--]--></div></div><!----><!--[--><!--]--></div></div>
226
+ <script>window.__VP_HASH_MAP__=JSON.parse("{\"building-with-agents.md\":\"Bf1yH2tG\",\"changelog.md\":\"DrLFQUlu\",\"deployment.md\":\"KW0Ni_rY\",\"evals.md\":\"DiljU__Z\",\"guides_agent-to-agent.md\":\"D1D5f6Jc\",\"guides_bitbucket.md\":\"DkjkBRU8\",\"guides_cloud-agents.md\":\"Ceyjv0ul\",\"guides_convert-automation.md\":\"BjraCvok\",\"guides_github.md\":\"CgN5sNbW\",\"guides_gitlab.md\":\"DCE0p7_w\",\"guides_hooks.md\":\"BjeEiM7s\",\"guides_improve.md\":\"BFYtrtLE\",\"guides_jev.md\":\"CEqLgjj9\",\"guides_mcp-oauth.md\":\"DrGY92u4\",\"guides_migrate.md\":\"RS9Eu-Xh\",\"guides_opentelemetry.md\":\"CoZ1kNyd\",\"guides_pagerduty.md\":\"mnKXe9U0\",\"guides_slack.md\":\"BwXHURvY\",\"guides_webhooks.md\":\"BJk63ZTs\",\"hillclimbing.md\":\"By61f3uq\",\"index.md\":\"CAruw_rp\",\"quickstart.md\":\"CljDaJBi\",\"reference_access.md\":\"CEtibb4i\",\"reference_agent-config.md\":\"Ck29qYNj\",\"reference_artifacts.md\":\"C-hKR2hp\",\"reference_channels.md\":\"DsJfGSBJ\",\"reference_cli.md\":\"BkdLRbXg\",\"reference_connections.md\":\"BoAotr7_\",\"reference_evals.md\":\"2BXeMiO2\",\"reference_extensions.md\":\"DI5X5x8p\",\"reference_hooks.md\":\"B-bwJuiG\",\"reference_http-api.md\":\"_RWELr3d\",\"reference_instructions.md\":\"yL2hXLnl\",\"reference_limits.md\":\"BCCnvt3o\",\"reference_memory.md\":\"Dd7cyV9V\",\"reference_playground.md\":\"CQiJk9CM\",\"reference_project-layout.md\":\"BamcPDUn\",\"reference_prompt.md\":\"BMjm1Jp3\",\"reference_schedules.md\":\"RC47aFm4\",\"reference_sessions.md\":\"C7KFhWXV\",\"reference_skills.md\":\"Dej2zQxi\",\"reference_subagents.md\":\"CAhvW4yS\",\"reference_tools.md\":\"DQr7Fnhu\",\"templates_agentic-owners.md\":\"Dh2nDSqg\",\"templates_security-reviewer.md\":\"DnwXdnB5\",\"templates_thermo-quality-review.md\":\"MJIdHkzE\",\"templates_thermo-review.md\":\"DfN1OFOl\",\"templates_triage.md\":\"BYWMloV4\",\"troubleshooting.md\":\"CGOdNVAL\"}");window.__VP_SITE_DATA__=JSON.parse("{\"lang\":\"en-US\",\"dir\":\"ltr\",\"title\":\"Agent SDK\",\"description\":\"Build and serve bots and agents from versioned Markdown and TypeScript.\",\"base\":\"/docs/\",\"head\":[],\"router\":{\"prefetchLinks\":true},\"appearance\":true,\"themeConfig\":{\"sdkVersion\":\"0.2.29\",\"nav\":[{\"text\":\"Quickstart\",\"link\":\"/quickstart\"},{\"text\":\"Guides\",\"link\":\"/guides/mcp-oauth\"},{\"text\":\"Integrations\",\"link\":\"/guides/github\"},{\"text\":\"Templates\",\"link\":\"/templates/security-reviewer\"},{\"text\":\"Reference\",\"link\":\"/reference/project-layout\"}],\"search\":{\"provider\":\"local\"},\"outline\":{\"level\":[2,3]},\"sidebar\":[{\"text\":\"Getting started\",\"items\":[{\"text\":\"Overview\",\"link\":\"/\"},{\"text\":\"Changelog\",\"link\":\"/changelog\"},{\"text\":\"Building your first agent\",\"link\":\"/quickstart\"}]},{\"text\":\"Integrations\",\"collapsed\":false,\"items\":[{\"text\":\"GitHub\",\"link\":\"/guides/github\"},{\"text\":\"Slack\",\"link\":\"/guides/slack\"},{\"text\":\"Webhooks\",\"link\":\"/guides/webhooks\"},{\"text\":\"Cursor Automations\",\"link\":\"/guides/convert-automation\"},{\"text\":\"OpenTelemetry\",\"link\":\"/guides/opentelemetry\"},{\"text\":\"GitLab\",\"link\":\"/guides/gitlab\"},{\"text\":\"Bitbucket\",\"link\":\"/guides/bitbucket\"},{\"text\":\"PagerDuty\",\"link\":\"/guides/pagerduty\"}]},{\"text\":\"Extensions\",\"collapsed\":false,\"items\":[{\"text\":\"Overview\",\"link\":\"/reference/extensions\"},{\"text\":\"Cloud agents\",\"link\":\"/guides/cloud-agents\"},{\"text\":\"Self-improvement\",\"link\":\"/guides/improve\"},{\"text\":\"Jev\",\"link\":\"/guides/jev\"}]},{\"text\":\"Guides\",\"collapsed\":false,\"items\":[{\"text\":\"MCP\",\"link\":\"/guides/mcp-oauth\"},{\"text\":\"Hooks\",\"link\":\"/guides/hooks\"},{\"text\":\"Peer agents\",\"link\":\"/guides/agent-to-agent\"},{\"text\":\"Deployment\",\"link\":\"/deployment\"},{\"text\":\"Early-alpha migration\",\"link\":\"/guides/migrate\"},{\"text\":\"Evals\",\"link\":\"/evals\"},{\"text\":\"Hillclimbing\",\"link\":\"/hillclimbing\"},{\"text\":\"Build with a coding agent\",\"link\":\"/building-with-agents\"},{\"text\":\"Troubleshooting\",\"link\":\"/troubleshooting\"}]},{\"text\":\"Templates\",\"collapsed\":false,\"items\":[{\"text\":\"Security reviewer\",\"link\":\"/templates/security-reviewer\"},{\"text\":\"Thermo review\",\"link\":\"/templates/thermo-review\"},{\"text\":\"Thermo quality review\",\"link\":\"/templates/thermo-quality-review\"},{\"text\":\"Agentic Approver\",\"link\":\"/templates/agentic-owners\"},{\"text\":\"Triage agent\",\"link\":\"/templates/triage\"}]},{\"text\":\"Reference\",\"collapsed\":false,\"items\":[{\"text\":\"Project layout\",\"link\":\"/reference/project-layout\"},{\"text\":\"Agent config\",\"link\":\"/reference/agent-config\"},{\"text\":\"Instructions\",\"link\":\"/reference/instructions\"},{\"text\":\"Tools\",\"link\":\"/reference/tools\"},{\"text\":\"prompt\",\"link\":\"/reference/prompt\"},{\"text\":\"Skills\",\"link\":\"/reference/skills\"},{\"text\":\"MCP Connections\",\"link\":\"/reference/connections\"},{\"text\":\"Subagents\",\"link\":\"/reference/subagents\"},{\"text\":\"Channels\",\"link\":\"/reference/channels\"},{\"text\":\"Schedules & reminders\",\"link\":\"/reference/schedules\"},{\"text\":\"Hooks\",\"link\":\"/reference/hooks\"},{\"text\":\"Memory\",\"link\":\"/reference/memory\"},{\"text\":\"Evals\",\"link\":\"/reference/evals\"},{\"text\":\"Artifacts\",\"link\":\"/reference/artifacts\"},{\"text\":\"Sessions & streaming\",\"link\":\"/reference/sessions\"},{\"text\":\"Playground\",\"link\":\"/reference/playground\"},{\"text\":\"CLI\",\"link\":\"/reference/cli\"},{\"text\":\"HTTP API\",\"link\":\"/reference/http-api\"},{\"text\":\"Access\",\"link\":\"/reference/access\"}]}]},\"locales\":{},\"scrollOffset\":134,\"cleanUrls\":false}");</script>
227
227
 
228
228
  </body>
229
229
  </html>