@grok/agent-sdk 0.2.29 → 0.3.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (396) hide show
  1. package/dist/channels/slack/cli-project.js +1 -1
  2. package/dist/docs/404.html +2 -2
  3. package/dist/docs/assets/{app.DMrZKFjI.js → app.BzTUBOAD.js} +4 -4
  4. package/dist/docs/assets/building-with-agents.md.BqJ7AAjG.js +6 -0
  5. package/dist/docs/assets/{building-with-agents.md.Bf1yH2tG.lean.js → building-with-agents.md.BqJ7AAjG.lean.js} +1 -1
  6. package/dist/docs/assets/changelog.md.BWhC6DET.js +1 -0
  7. package/dist/docs/assets/changelog.md.BWhC6DET.lean.js +1 -0
  8. package/dist/docs/assets/chunks/@localSearchIndexroot.CWxwVoCG.js +1 -0
  9. package/dist/docs/assets/chunks/{VPLocalSearchBox.DQvuw1KA.js → VPLocalSearchBox.DsnRlUT5.js} +1 -1
  10. package/dist/docs/assets/chunks/{arc.ahOG-Qza.js → arc.DH8GOhiv.js} +1 -1
  11. package/dist/docs/assets/chunks/{architectureDiagram-Q4EWVU46.BcgfYNO_.js → architectureDiagram-Q4EWVU46.9m9ObyuE.js} +1 -1
  12. package/dist/docs/assets/chunks/{baseUniq.DeIYZrWh.js → baseUniq.BXHpx1lE.js} +1 -1
  13. package/dist/docs/assets/chunks/{blockDiagram-DXYQGD6D.HjJ2goMX.js → blockDiagram-DXYQGD6D.xY3EX59q.js} +1 -1
  14. package/dist/docs/assets/chunks/{c4Diagram-AHTNJAMY.C1QTb9GM.js → c4Diagram-AHTNJAMY.DnqgMVgc.js} +1 -1
  15. package/dist/docs/assets/chunks/channel.Cctv0f7X.js +1 -0
  16. package/dist/docs/assets/chunks/{chunk-4BX2VUAB.UuZiDiVp.js → chunk-4BX2VUAB.BjFxK2A3.js} +1 -1
  17. package/dist/docs/assets/chunks/{chunk-4TB4RGXK.5A3YmkhI.js → chunk-4TB4RGXK.BujS_Spt.js} +1 -1
  18. package/dist/docs/assets/chunks/{chunk-55IACEB6.B4uf1yYV.js → chunk-55IACEB6.YbTjhdaM.js} +1 -1
  19. package/dist/docs/assets/chunks/{chunk-EDXVE4YY.CoXBce8t.js → chunk-EDXVE4YY.DnQ8t4GC.js} +1 -1
  20. package/dist/docs/assets/chunks/{chunk-FMBD7UC4.DnC5NO4e.js → chunk-FMBD7UC4.B67AwAmj.js} +1 -1
  21. package/dist/docs/assets/chunks/{chunk-OYMX7WX6.CzfHCeIi.js → chunk-OYMX7WX6.DrZIAFOm.js} +1 -1
  22. package/dist/docs/assets/chunks/{chunk-QZHKN3VN.C6tcwkVd.js → chunk-QZHKN3VN.BLmmydkn.js} +1 -1
  23. package/dist/docs/assets/chunks/{chunk-YZCP3GAM._oboyZ1A.js → chunk-YZCP3GAM.DaoOfw0O.js} +1 -1
  24. package/dist/docs/assets/chunks/classDiagram-6PBFFD2Q.DU5sqchW.js +1 -0
  25. package/dist/docs/assets/chunks/classDiagram-v2-HSJHXN6E.DU5sqchW.js +1 -0
  26. package/dist/docs/assets/chunks/clone.B9rdNt6j.js +1 -0
  27. package/dist/docs/assets/chunks/{cose-bilkent-S5V4N54A.BfPVKeId.js → cose-bilkent-S5V4N54A.DMQuNhM5.js} +1 -1
  28. package/dist/docs/assets/chunks/{dagre-KV5264BT.CLMLc0lD.js → dagre-KV5264BT.CZoGVuUf.js} +1 -1
  29. package/dist/docs/assets/chunks/{diagram-5BDNPKRD.C7OF7UfH.js → diagram-5BDNPKRD.CLt9uOyL.js} +1 -1
  30. package/dist/docs/assets/chunks/{diagram-G4DWMVQ6.Dpao0Bl1.js → diagram-G4DWMVQ6.DpczEm1G.js} +1 -1
  31. package/dist/docs/assets/chunks/{diagram-MMDJMWI5.DLnM9eLp.js → diagram-MMDJMWI5.D4r13DvJ.js} +1 -1
  32. package/dist/docs/assets/chunks/{diagram-TYMM5635.BcpVgA_M.js → diagram-TYMM5635.CYU9eGFu.js} +1 -1
  33. package/dist/docs/assets/chunks/{erDiagram-SMLLAGMA.CsL5JuCV.js → erDiagram-SMLLAGMA.QA9naWEw.js} +1 -1
  34. package/dist/docs/assets/chunks/{flowDiagram-DWJPFMVM.MFihq9AF.js → flowDiagram-DWJPFMVM.BbNoVZYd.js} +1 -1
  35. package/dist/docs/assets/chunks/{ganttDiagram-T4ZO3ILL.CJeLodyG.js → ganttDiagram-T4ZO3ILL.IHjDoG7r.js} +1 -1
  36. package/dist/docs/assets/chunks/{gitGraphDiagram-UUTBAWPF.1HhlE45Z.js → gitGraphDiagram-UUTBAWPF.B21VMdf5.js} +1 -1
  37. package/dist/docs/assets/chunks/{graph.BS02KkWA.js → graph.DgJ4L-8V.js} +1 -1
  38. package/dist/docs/assets/chunks/{infoDiagram-42DDH7IO.fp5gvytQ.js → infoDiagram-42DDH7IO.CQjrcthc.js} +1 -1
  39. package/dist/docs/assets/chunks/{ishikawaDiagram-UXIWVN3A.C6Wk1V4I.js → ishikawaDiagram-UXIWVN3A.D4tPGtVo.js} +1 -1
  40. package/dist/docs/assets/chunks/{journeyDiagram-VCZTEJTY.qJt4uJ_H.js → journeyDiagram-VCZTEJTY.BD3WaNbQ.js} +1 -1
  41. package/dist/docs/assets/chunks/{kanban-definition-6JOO6SKY.z2tG9kly.js → kanban-definition-6JOO6SKY.Ca0o4Tqz.js} +1 -1
  42. package/dist/docs/assets/chunks/{layout.BPCkdejr.js → layout.DXXqX4MQ.js} +1 -1
  43. package/dist/docs/assets/chunks/{linear.CL3TC3u7.js → linear.5c61gNw4.js} +1 -1
  44. package/dist/docs/assets/chunks/{min.SPrSp704.js → min.B1-NAjHX.js} +1 -1
  45. package/dist/docs/assets/chunks/{mindmap-definition-QFDTVHPH.DgrQRFZW.js → mindmap-definition-QFDTVHPH.BELznv3-.js} +1 -1
  46. package/dist/docs/assets/chunks/{pieDiagram-DEJITSTG.Ba7yxiW2.js → pieDiagram-DEJITSTG.qPzO1mq5.js} +1 -1
  47. package/dist/docs/assets/chunks/{quadrantDiagram-34T5L4WZ.Bvskad4p.js → quadrantDiagram-34T5L4WZ.CxIvzbjX.js} +1 -1
  48. package/dist/docs/assets/chunks/{requirementDiagram-MS252O5E.Ce70ugV9.js → requirementDiagram-MS252O5E.CqA0iJx8.js} +1 -1
  49. package/dist/docs/assets/chunks/{sankeyDiagram-XADWPNL6.BJ5OEULO.js → sankeyDiagram-XADWPNL6.XRTutBnb.js} +1 -1
  50. package/dist/docs/assets/chunks/{sequenceDiagram-FGHM5R23.C8a1hDs6.js → sequenceDiagram-FGHM5R23.E--7bRLQ.js} +1 -1
  51. package/dist/docs/assets/chunks/{stateDiagram-FHFEXIEX.D2D8A5CK.js → stateDiagram-FHFEXIEX.C4vGu8zq.js} +1 -1
  52. package/dist/docs/assets/chunks/stateDiagram-v2-QKLJ7IA2.ECMu2BdJ.js +1 -0
  53. package/dist/docs/assets/chunks/{theme.DRciHmS1.js → theme.DMj_7q3B.js} +2 -2
  54. package/dist/docs/assets/chunks/{timeline-definition-GMOUNBTQ.C4ePrY8-.js → timeline-definition-GMOUNBTQ.C7LgNVAL.js} +1 -1
  55. package/dist/docs/assets/chunks/{vennDiagram-DHZGUBPP.Dzso6dEA.js → vennDiagram-DHZGUBPP.HUwoZcy_.js} +1 -1
  56. package/dist/docs/assets/chunks/{wardley-RL74JXVD.djgXR0ar.js → wardley-RL74JXVD.BxFEFYZS.js} +1 -1
  57. package/dist/docs/assets/chunks/{wardleyDiagram-NUSXRM2D.Bf2ICxjh.js → wardleyDiagram-NUSXRM2D.B2pSo5rB.js} +1 -1
  58. package/dist/docs/assets/chunks/{xychartDiagram-5P7HB3ND.DEH4BcVJ.js → xychartDiagram-5P7HB3ND.NQhMiOOL.js} +1 -1
  59. package/dist/docs/assets/deployment.md.BtqJrHhp.js +31 -0
  60. package/dist/docs/assets/{deployment.md.KW0Ni_rY.lean.js → deployment.md.BtqJrHhp.lean.js} +1 -1
  61. package/dist/docs/assets/evals.md.Dne6VRmZ.js +49 -0
  62. package/dist/docs/assets/evals.md.Dne6VRmZ.lean.js +1 -0
  63. package/dist/docs/assets/{guides_agent-to-agent.md.D1D5f6Jc.js → guides_agent-to-agent.md.BcmSqL2z.js} +8 -8
  64. package/dist/docs/assets/guides_agent-to-agent.md.BcmSqL2z.lean.js +1 -0
  65. package/dist/docs/assets/{guides_bitbucket.md.DkjkBRU8.js → guides_bitbucket.md.BiA6ZMFW.js} +27 -27
  66. package/dist/docs/assets/{guides_bitbucket.md.DkjkBRU8.lean.js → guides_bitbucket.md.BiA6ZMFW.lean.js} +1 -1
  67. package/dist/docs/assets/guides_cloud-agents.md.CiXAW6on.js +9 -0
  68. package/dist/docs/assets/{guides_cloud-agents.md.Ceyjv0ul.lean.js → guides_cloud-agents.md.CiXAW6on.lean.js} +1 -1
  69. package/dist/docs/assets/guides_convert-automation.md.BvTxsJ8J.js +26 -0
  70. package/dist/docs/assets/{guides_convert-automation.md.BjraCvok.lean.js → guides_convert-automation.md.BvTxsJ8J.lean.js} +1 -1
  71. package/dist/docs/assets/{guides_github.md.CgN5sNbW.js → guides_github.md.6jiEH7dg.js} +11 -19
  72. package/dist/docs/assets/{guides_github.md.CgN5sNbW.lean.js → guides_github.md.6jiEH7dg.lean.js} +1 -1
  73. package/dist/docs/assets/{guides_gitlab.md.DCE0p7_w.js → guides_gitlab.md.DcKusOcU.js} +63 -73
  74. package/dist/docs/assets/{guides_gitlab.md.DCE0p7_w.lean.js → guides_gitlab.md.DcKusOcU.lean.js} +1 -1
  75. package/dist/docs/assets/guides_improve.md.o3WOGR7n.js +16 -0
  76. package/dist/docs/assets/{guides_improve.md.BFYtrtLE.lean.js → guides_improve.md.o3WOGR7n.lean.js} +1 -1
  77. package/dist/docs/assets/{guides_jev.md.CEqLgjj9.js → guides_jev.md.DGCzkMUN.js} +20 -60
  78. package/dist/docs/assets/{guides_jev.md.CEqLgjj9.lean.js → guides_jev.md.DGCzkMUN.lean.js} +1 -1
  79. package/dist/docs/assets/{guides_mcp-oauth.md.DrGY92u4.js → guides_mcp-oauth.md.C-Sx_IPa.js} +3 -5
  80. package/dist/docs/assets/{guides_mcp-oauth.md.DrGY92u4.lean.js → guides_mcp-oauth.md.C-Sx_IPa.lean.js} +1 -1
  81. package/dist/docs/assets/guides_migrate.md.BbhHYeCr.js +3 -0
  82. package/dist/docs/assets/{guides_migrate.md.RS9Eu-Xh.lean.js → guides_migrate.md.BbhHYeCr.lean.js} +1 -1
  83. package/dist/docs/assets/guides_opentelemetry.md.BRSktBHt.js +26 -0
  84. package/dist/docs/assets/guides_opentelemetry.md.BRSktBHt.lean.js +1 -0
  85. package/dist/docs/assets/guides_pagerduty.md.pMXUkZZc.js +61 -0
  86. package/dist/docs/assets/guides_pagerduty.md.pMXUkZZc.lean.js +1 -0
  87. package/dist/docs/assets/guides_slack.md.BgIGG9ur.js +82 -0
  88. package/dist/docs/assets/{guides_slack.md.BwXHURvY.lean.js → guides_slack.md.BgIGG9ur.lean.js} +1 -1
  89. package/dist/docs/assets/{guides_webhooks.md.BJk63ZTs.js → guides_webhooks.md.B5DXt2v1.js} +7 -7
  90. package/dist/docs/assets/{guides_webhooks.md.BJk63ZTs.lean.js → guides_webhooks.md.B5DXt2v1.lean.js} +1 -1
  91. package/dist/docs/assets/hillclimbing.md.3TkdF79A.js +5 -0
  92. package/dist/docs/assets/hillclimbing.md.3TkdF79A.lean.js +1 -0
  93. package/dist/docs/assets/index.md.DRfaoRCZ.js +20 -0
  94. package/dist/docs/assets/{index.md.CAruw_rp.lean.js → index.md.DRfaoRCZ.lean.js} +1 -1
  95. package/dist/docs/assets/quickstart.md.r-oE8nkX.js +113 -0
  96. package/dist/docs/assets/{quickstart.md.CljDaJBi.lean.js → quickstart.md.r-oE8nkX.lean.js} +1 -1
  97. package/dist/docs/assets/reference_access.md.C5lblfUC.js +1 -0
  98. package/dist/docs/assets/reference_access.md.C5lblfUC.lean.js +1 -0
  99. package/dist/docs/assets/reference_agent-config.md.C0Tp_Fk9.js +27 -0
  100. package/dist/docs/assets/{reference_agent-config.md.Ck29qYNj.lean.js → reference_agent-config.md.C0Tp_Fk9.lean.js} +1 -1
  101. package/dist/docs/assets/reference_artifacts.md.BJpAI7h9.js +17 -0
  102. package/dist/docs/assets/{reference_artifacts.md.C-hKR2hp.lean.js → reference_artifacts.md.BJpAI7h9.lean.js} +1 -1
  103. package/dist/docs/assets/reference_channels.md.CPWOpdsC.js +21 -0
  104. package/dist/docs/assets/{reference_channels.md.DsJfGSBJ.lean.js → reference_channels.md.CPWOpdsC.lean.js} +1 -1
  105. package/dist/docs/assets/reference_cli.md.B8GdpaRj.js +83 -0
  106. package/dist/docs/assets/reference_cli.md.B8GdpaRj.lean.js +1 -0
  107. package/dist/docs/assets/reference_connections.md.DoY4vrDH.js +54 -0
  108. package/dist/docs/assets/{reference_connections.md.BoAotr7_.lean.js → reference_connections.md.DoY4vrDH.lean.js} +1 -1
  109. package/dist/docs/assets/reference_evals.md.DgfUtfIc.js +69 -0
  110. package/dist/docs/assets/{reference_evals.md.2BXeMiO2.lean.js → reference_evals.md.DgfUtfIc.lean.js} +1 -1
  111. package/dist/docs/assets/{reference_extensions.md.DI5X5x8p.js → reference_extensions.md.DHbW6eOf.js} +6 -8
  112. package/dist/docs/assets/{reference_extensions.md.DI5X5x8p.lean.js → reference_extensions.md.DHbW6eOf.lean.js} +1 -1
  113. package/dist/docs/assets/reference_hooks.md.CSWmOwMM.js +39 -0
  114. package/dist/docs/assets/reference_hooks.md.CSWmOwMM.lean.js +1 -0
  115. package/dist/docs/assets/reference_http-api.md.C7Cb0r2J.js +7 -0
  116. package/dist/docs/assets/{reference_http-api.md._RWELr3d.lean.js → reference_http-api.md.C7Cb0r2J.lean.js} +1 -1
  117. package/dist/docs/assets/reference_instructions.md.CV6Qq0UX.js +14 -0
  118. package/dist/docs/assets/reference_instructions.md.CV6Qq0UX.lean.js +1 -0
  119. package/dist/docs/assets/reference_limits.md.CbdtFr4T.js +8 -0
  120. package/dist/docs/assets/reference_limits.md.CbdtFr4T.lean.js +1 -0
  121. package/dist/docs/assets/reference_memory.md.CdoJISM-.js +3 -0
  122. package/dist/docs/assets/{reference_memory.md.Dd7cyV9V.lean.js → reference_memory.md.CdoJISM-.lean.js} +1 -1
  123. package/dist/docs/assets/reference_playground.md.DIUsRAcy.js +1 -0
  124. package/dist/docs/assets/{reference_playground.md.CQiJk9CM.lean.js → reference_playground.md.DIUsRAcy.lean.js} +1 -1
  125. package/dist/docs/assets/reference_project-layout.md.9DiKoE16.js +26 -0
  126. package/dist/docs/assets/reference_project-layout.md.9DiKoE16.lean.js +1 -0
  127. package/dist/docs/assets/reference_schedules.md.RhQ9ZLo1.js +45 -0
  128. package/dist/docs/assets/{reference_schedules.md.RC47aFm4.lean.js → reference_schedules.md.RhQ9ZLo1.lean.js} +1 -1
  129. package/dist/docs/assets/reference_sessions.md.NXVQt9mP.js +22 -0
  130. package/dist/docs/assets/{reference_sessions.md.C7KFhWXV.lean.js → reference_sessions.md.NXVQt9mP.lean.js} +1 -1
  131. package/dist/docs/assets/{reference_skills.md.Dej2zQxi.js → reference_skills.md.DzCPNPkG.js} +4 -4
  132. package/dist/docs/assets/{reference_skills.md.Dej2zQxi.lean.js → reference_skills.md.DzCPNPkG.lean.js} +1 -1
  133. package/dist/docs/assets/reference_subagents.md.Dvpq2sUu.js +10 -0
  134. package/dist/docs/assets/{reference_subagents.md.CAhvW4yS.lean.js → reference_subagents.md.Dvpq2sUu.lean.js} +1 -1
  135. package/dist/docs/assets/reference_tools.md.B2OaR1Nb.js +62 -0
  136. package/dist/docs/assets/{reference_tools.md.DQr7Fnhu.lean.js → reference_tools.md.B2OaR1Nb.lean.js} +1 -1
  137. package/dist/docs/assets/templates_agentic-owners.md.B6ZmKAzT.js +13 -0
  138. package/dist/docs/assets/{templates_agentic-owners.md.Dh2nDSqg.lean.js → templates_agentic-owners.md.B6ZmKAzT.lean.js} +1 -1
  139. package/dist/docs/assets/templates_reviews.md.dr9Xv_KM.js +10 -0
  140. package/dist/docs/assets/templates_reviews.md.dr9Xv_KM.lean.js +1 -0
  141. package/dist/docs/assets/troubleshooting.md.DfKKvW1R.js +3 -0
  142. package/dist/docs/assets/{troubleshooting.md.CGOdNVAL.lean.js → troubleshooting.md.DfKKvW1R.lean.js} +1 -1
  143. package/dist/docs/building-with-agents.html +41 -44
  144. package/dist/docs/building-with-agents.md +11 -104
  145. package/dist/docs/changelog.html +37 -37
  146. package/dist/docs/changelog.md +5 -155
  147. package/dist/docs/deployment.html +54 -54
  148. package/dist/docs/deployment.md +83 -262
  149. package/dist/docs/evals.html +52 -71
  150. package/dist/docs/evals.md +33 -129
  151. package/dist/docs/guides/agent-to-agent.html +43 -43
  152. package/dist/docs/guides/agent-to-agent.md +27 -64
  153. package/dist/docs/guides/bitbucket.html +62 -62
  154. package/dist/docs/guides/bitbucket.md +73 -134
  155. package/dist/docs/guides/cloud-agents.html +37 -37
  156. package/dist/docs/guides/cloud-agents.md +23 -53
  157. package/dist/docs/guides/convert-automation.html +39 -56
  158. package/dist/docs/guides/convert-automation.md +31 -115
  159. package/dist/docs/guides/github.html +46 -54
  160. package/dist/docs/guides/github.md +49 -131
  161. package/dist/docs/guides/gitlab.html +98 -108
  162. package/dist/docs/guides/gitlab.md +104 -184
  163. package/dist/docs/guides/improve.html +38 -43
  164. package/dist/docs/guides/improve.md +24 -90
  165. package/dist/docs/guides/jev.html +55 -95
  166. package/dist/docs/guides/jev.md +53 -160
  167. package/dist/docs/guides/mcp-oauth.html +38 -40
  168. package/dist/docs/guides/mcp-oauth.md +33 -67
  169. package/dist/docs/guides/migrate.html +38 -43
  170. package/dist/docs/guides/migrate.md +56 -130
  171. package/dist/docs/guides/opentelemetry.html +41 -43
  172. package/dist/docs/guides/opentelemetry.md +32 -27
  173. package/dist/docs/guides/pagerduty.html +50 -49
  174. package/dist/docs/guides/pagerduty.md +65 -199
  175. package/dist/docs/guides/slack.html +51 -57
  176. package/dist/docs/guides/slack.md +76 -204
  177. package/dist/docs/guides/webhooks.html +42 -42
  178. package/dist/docs/guides/webhooks.md +64 -146
  179. package/dist/docs/hashmap.json +1 -1
  180. package/dist/docs/hillclimbing.html +40 -42
  181. package/dist/docs/hillclimbing.md +40 -102
  182. package/dist/docs/index.html +55 -61
  183. package/dist/docs/index.md +49 -83
  184. package/dist/docs/llms-full.txt +2262 -5721
  185. package/dist/docs/llms.txt +9 -14
  186. package/dist/docs/quickstart.html +95 -152
  187. package/dist/docs/quickstart.md +91 -180
  188. package/dist/docs/reference/access.html +36 -36
  189. package/dist/docs/reference/access.md +7 -12
  190. package/dist/docs/reference/agent-config.html +43 -56
  191. package/dist/docs/reference/agent-config.md +91 -174
  192. package/dist/docs/reference/artifacts.html +38 -39
  193. package/dist/docs/reference/artifacts.md +38 -62
  194. package/dist/docs/reference/channels.html +38 -39
  195. package/dist/docs/reference/channels.md +102 -151
  196. package/dist/docs/reference/cli.html +68 -84
  197. package/dist/docs/reference/cli.md +232 -697
  198. package/dist/docs/reference/connections.html +45 -57
  199. package/dist/docs/reference/connections.md +83 -164
  200. package/dist/docs/reference/evals.html +47 -54
  201. package/dist/docs/reference/evals.md +75 -141
  202. package/dist/docs/reference/extensions.html +41 -43
  203. package/dist/docs/reference/extensions.md +37 -70
  204. package/dist/docs/reference/hooks.html +40 -52
  205. package/dist/docs/reference/hooks.md +62 -133
  206. package/dist/docs/reference/http-api.html +38 -42
  207. package/dist/docs/reference/http-api.md +66 -118
  208. package/dist/docs/reference/instructions.html +39 -39
  209. package/dist/docs/reference/instructions.md +19 -29
  210. package/dist/docs/reference/limits.html +38 -38
  211. package/dist/docs/reference/limits.md +9 -21
  212. package/dist/docs/reference/memory.html +37 -38
  213. package/dist/docs/reference/memory.md +38 -75
  214. package/dist/docs/reference/playground.html +36 -36
  215. package/dist/docs/reference/playground.md +14 -22
  216. package/dist/docs/reference/project-layout.html +49 -48
  217. package/dist/docs/reference/project-layout.md +38 -84
  218. package/dist/docs/reference/schedules.html +46 -48
  219. package/dist/docs/reference/schedules.md +59 -90
  220. package/dist/docs/reference/sessions.html +37 -37
  221. package/dist/docs/reference/sessions.md +66 -113
  222. package/dist/docs/reference/skills.html +39 -39
  223. package/dist/docs/reference/skills.md +11 -31
  224. package/dist/docs/reference/subagents.html +37 -37
  225. package/dist/docs/reference/subagents.md +17 -31
  226. package/dist/docs/reference/tools.html +47 -64
  227. package/dist/docs/reference/tools.md +48 -130
  228. package/dist/docs/templates/agentic-owners.html +38 -38
  229. package/dist/docs/templates/agentic-owners.md +50 -74
  230. package/dist/docs/templates/reviews.html +69 -0
  231. package/dist/docs/templates/reviews.md +71 -0
  232. package/dist/docs/troubleshooting.html +38 -36
  233. package/dist/docs/troubleshooting.md +48 -101
  234. package/dist/internal/cli-deploy.js +1 -1
  235. package/dist/internal/cli-docs.js +1 -1
  236. package/dist/internal/cli-images.js +1 -1
  237. package/dist/internal/cli-skills.js +1 -1
  238. package/dist/internal/cursor/credentials.js +1 -1
  239. package/dist/internal/deploy-manifest.d.ts +1 -0
  240. package/dist/internal/deploy-manifest.d.ts.map +1 -1
  241. package/dist/internal/deploy-manifest.js +0 -1
  242. package/dist/internal/discovery/agent-config.d.ts +2 -6
  243. package/dist/internal/discovery/agent-config.d.ts.map +1 -1
  244. package/dist/internal/discovery/agent-config.js +8 -25
  245. package/dist/internal/discovery/agent.d.ts.map +1 -1
  246. package/dist/internal/discovery/agent.js +2 -3
  247. package/dist/internal/discovery/project.d.ts.map +1 -1
  248. package/dist/internal/discovery/project.js +15 -0
  249. package/dist/internal/init-project.d.ts.map +1 -1
  250. package/dist/internal/init-project.js +7 -5
  251. package/dist/internal/reminder-runner.js +1 -1
  252. package/dist/internal/session-engine.js +1 -1
  253. package/dist/internal/shallow-clone.js +1 -1
  254. package/dist/playground/assets/index-D6mVn9og.js +62 -0
  255. package/dist/playground/assets/index-DlALM6gr.css +1 -0
  256. package/dist/playground/index.html +2 -2
  257. package/dist/types.d.ts +4 -17
  258. package/dist/types.d.ts.map +1 -1
  259. package/docs/README.md +49 -83
  260. package/docs/building-with-agents.md +11 -104
  261. package/docs/changelog.md +6 -156
  262. package/docs/deployment.md +83 -262
  263. package/docs/evals.md +34 -130
  264. package/docs/guides/agent-to-agent.md +27 -64
  265. package/docs/guides/bitbucket.md +73 -134
  266. package/docs/guides/cloud-agents.md +23 -53
  267. package/docs/guides/convert-automation.md +31 -115
  268. package/docs/guides/github.md +49 -131
  269. package/docs/guides/gitlab.md +104 -184
  270. package/docs/guides/improve.md +24 -90
  271. package/docs/guides/jev.md +53 -160
  272. package/docs/guides/mcp-oauth.md +33 -67
  273. package/docs/guides/migrate.md +56 -130
  274. package/docs/guides/opentelemetry.md +37 -27
  275. package/docs/guides/pagerduty.md +68 -200
  276. package/docs/guides/slack.md +76 -204
  277. package/docs/guides/webhooks.md +64 -146
  278. package/docs/hillclimbing.md +41 -103
  279. package/docs/quickstart.md +91 -180
  280. package/docs/reference/access.md +7 -12
  281. package/docs/reference/agent-config.md +91 -174
  282. package/docs/reference/artifacts.md +38 -62
  283. package/docs/reference/channels.md +102 -151
  284. package/docs/reference/cli.md +232 -697
  285. package/docs/reference/connections.md +83 -164
  286. package/docs/reference/evals.md +75 -141
  287. package/docs/reference/extensions.md +37 -70
  288. package/docs/reference/hooks.md +61 -132
  289. package/docs/reference/http-api.md +66 -118
  290. package/docs/reference/instructions.md +20 -30
  291. package/docs/reference/limits.md +10 -22
  292. package/docs/reference/memory.md +38 -75
  293. package/docs/reference/playground.md +14 -22
  294. package/docs/reference/project-layout.md +38 -84
  295. package/docs/reference/schedules.md +59 -90
  296. package/docs/reference/sessions.md +66 -113
  297. package/docs/reference/skills.md +12 -32
  298. package/docs/reference/subagents.md +17 -31
  299. package/docs/reference/tools.md +48 -130
  300. package/docs/templates/agentic-owners.md +50 -74
  301. package/docs/templates/reviews.md +76 -0
  302. package/docs/troubleshooting.md +48 -101
  303. package/package.json +2 -2
  304. package/skills/deploy/SKILL.md +1 -1
  305. package/skills/migrate-v2/SKILL.md +0 -1
  306. package/dist/docs/assets/building-with-agents.md.Bf1yH2tG.js +0 -9
  307. package/dist/docs/assets/changelog.md.DrLFQUlu.js +0 -1
  308. package/dist/docs/assets/changelog.md.DrLFQUlu.lean.js +0 -1
  309. package/dist/docs/assets/chunks/@localSearchIndexroot.Dpd_wxVU.js +0 -1
  310. package/dist/docs/assets/chunks/channel._fZX_hvU.js +0 -1
  311. package/dist/docs/assets/chunks/classDiagram-6PBFFD2Q.eClS1Q0E.js +0 -1
  312. package/dist/docs/assets/chunks/classDiagram-v2-HSJHXN6E.eClS1Q0E.js +0 -1
  313. package/dist/docs/assets/chunks/clone.W1Phdw9P.js +0 -1
  314. package/dist/docs/assets/chunks/stateDiagram-v2-QKLJ7IA2.77yf4kRr.js +0 -1
  315. package/dist/docs/assets/deployment.md.KW0Ni_rY.js +0 -31
  316. package/dist/docs/assets/evals.md.DiljU__Z.js +0 -68
  317. package/dist/docs/assets/evals.md.DiljU__Z.lean.js +0 -1
  318. package/dist/docs/assets/guides_agent-to-agent.md.D1D5f6Jc.lean.js +0 -1
  319. package/dist/docs/assets/guides_cloud-agents.md.Ceyjv0ul.js +0 -9
  320. package/dist/docs/assets/guides_convert-automation.md.BjraCvok.js +0 -43
  321. package/dist/docs/assets/guides_hooks.md.BjeEiM7s.js +0 -54
  322. package/dist/docs/assets/guides_hooks.md.BjeEiM7s.lean.js +0 -1
  323. package/dist/docs/assets/guides_improve.md.BFYtrtLE.js +0 -21
  324. package/dist/docs/assets/guides_migrate.md.RS9Eu-Xh.js +0 -8
  325. package/dist/docs/assets/guides_opentelemetry.md.CoZ1kNyd.js +0 -28
  326. package/dist/docs/assets/guides_opentelemetry.md.CoZ1kNyd.lean.js +0 -1
  327. package/dist/docs/assets/guides_pagerduty.md.mnKXe9U0.js +0 -60
  328. package/dist/docs/assets/guides_pagerduty.md.mnKXe9U0.lean.js +0 -1
  329. package/dist/docs/assets/guides_slack.md.BwXHURvY.js +0 -88
  330. package/dist/docs/assets/hillclimbing.md.By61f3uq.js +0 -7
  331. package/dist/docs/assets/hillclimbing.md.By61f3uq.lean.js +0 -1
  332. package/dist/docs/assets/index.md.CAruw_rp.js +0 -26
  333. package/dist/docs/assets/quickstart.md.CljDaJBi.js +0 -170
  334. package/dist/docs/assets/reference_access.md.CEtibb4i.js +0 -1
  335. package/dist/docs/assets/reference_access.md.CEtibb4i.lean.js +0 -1
  336. package/dist/docs/assets/reference_agent-config.md.Ck29qYNj.js +0 -40
  337. package/dist/docs/assets/reference_artifacts.md.C-hKR2hp.js +0 -18
  338. package/dist/docs/assets/reference_channels.md.DsJfGSBJ.js +0 -22
  339. package/dist/docs/assets/reference_cli.md.BkdLRbXg.js +0 -99
  340. package/dist/docs/assets/reference_cli.md.BkdLRbXg.lean.js +0 -1
  341. package/dist/docs/assets/reference_connections.md.BoAotr7_.js +0 -66
  342. package/dist/docs/assets/reference_evals.md.2BXeMiO2.js +0 -76
  343. package/dist/docs/assets/reference_hooks.md.B-bwJuiG.js +0 -51
  344. package/dist/docs/assets/reference_hooks.md.B-bwJuiG.lean.js +0 -1
  345. package/dist/docs/assets/reference_http-api.md._RWELr3d.js +0 -11
  346. package/dist/docs/assets/reference_instructions.md.yL2hXLnl.js +0 -14
  347. package/dist/docs/assets/reference_instructions.md.yL2hXLnl.lean.js +0 -1
  348. package/dist/docs/assets/reference_limits.md.BCCnvt3o.js +0 -8
  349. package/dist/docs/assets/reference_limits.md.BCCnvt3o.lean.js +0 -1
  350. package/dist/docs/assets/reference_memory.md.Dd7cyV9V.js +0 -4
  351. package/dist/docs/assets/reference_playground.md.CQiJk9CM.js +0 -1
  352. package/dist/docs/assets/reference_project-layout.md.BamcPDUn.js +0 -25
  353. package/dist/docs/assets/reference_project-layout.md.BamcPDUn.lean.js +0 -1
  354. package/dist/docs/assets/reference_prompt.md.BMjm1Jp3.js +0 -9
  355. package/dist/docs/assets/reference_prompt.md.BMjm1Jp3.lean.js +0 -1
  356. package/dist/docs/assets/reference_schedules.md.RC47aFm4.js +0 -47
  357. package/dist/docs/assets/reference_sessions.md.C7KFhWXV.js +0 -22
  358. package/dist/docs/assets/reference_subagents.md.CAhvW4yS.js +0 -10
  359. package/dist/docs/assets/reference_tools.md.DQr7Fnhu.js +0 -79
  360. package/dist/docs/assets/templates_agentic-owners.md.Dh2nDSqg.js +0 -13
  361. package/dist/docs/assets/templates_security-reviewer.md.DnwXdnB5.js +0 -3
  362. package/dist/docs/assets/templates_security-reviewer.md.DnwXdnB5.lean.js +0 -1
  363. package/dist/docs/assets/templates_thermo-quality-review.md.MJIdHkzE.js +0 -3
  364. package/dist/docs/assets/templates_thermo-quality-review.md.MJIdHkzE.lean.js +0 -1
  365. package/dist/docs/assets/templates_thermo-review.md.DfN1OFOl.js +0 -3
  366. package/dist/docs/assets/templates_thermo-review.md.DfN1OFOl.lean.js +0 -1
  367. package/dist/docs/assets/templates_triage.md.BYWMloV4.js +0 -9
  368. package/dist/docs/assets/templates_triage.md.BYWMloV4.lean.js +0 -1
  369. package/dist/docs/assets/troubleshooting.md.CGOdNVAL.js +0 -1
  370. package/dist/docs/guides/hooks.html +0 -113
  371. package/dist/docs/guides/hooks.md +0 -116
  372. package/dist/docs/package/skills/create-agent/SKILL.md +0 -178
  373. package/dist/docs/package/skills/evals/SKILL.md +0 -145
  374. package/dist/docs/package/skills/github/SKILL.md +0 -133
  375. package/dist/docs/package/skills/hillclimb/SKILL.md +0 -63
  376. package/dist/docs/package/skills/mcp-auth/SKILL.md +0 -60
  377. package/dist/docs/package/skills/migrate-v2/SKILL.md +0 -394
  378. package/dist/docs/package/skills/setup-slack/SKILL.md +0 -136
  379. package/dist/docs/reference/prompt.html +0 -68
  380. package/dist/docs/reference/prompt.md +0 -47
  381. package/dist/docs/templates/security-reviewer.html +0 -62
  382. package/dist/docs/templates/security-reviewer.md +0 -81
  383. package/dist/docs/templates/thermo-quality-review.html +0 -62
  384. package/dist/docs/templates/thermo-quality-review.md +0 -75
  385. package/dist/docs/templates/thermo-review.html +0 -62
  386. package/dist/docs/templates/thermo-review.md +0 -75
  387. package/dist/docs/templates/triage.html +0 -68
  388. package/dist/docs/templates/triage.md +0 -101
  389. package/dist/playground/assets/index-Cl9zvmmf.js +0 -62
  390. package/dist/playground/assets/index-F8b5WvWi.css +0 -1
  391. package/docs/guides/hooks.md +0 -121
  392. package/docs/reference/prompt.md +0 -52
  393. package/docs/templates/security-reviewer.md +0 -86
  394. package/docs/templates/thermo-quality-review.md +0 -80
  395. package/docs/templates/thermo-review.md +0 -80
  396. package/docs/templates/triage.md +0 -106
@@ -5,32 +5,64 @@ description: "Review pull requests, answer comments, and triage pushes on Bitbuc
5
5
 
6
6
  # Bitbucket agents
7
7
 
8
- A Bitbucket agent wakes from a verified repository event, reads the
9
- current pull-request or commit state, and writes the result back to
10
- Bitbucket. `bitbucketChannel()` gives the same hooks and normalized
11
- payloads on Bitbucket Cloud and Data Center.
8
+ A Bitbucket agent wakes on pull request, comment, and push events from
9
+ Bitbucket Cloud or Data Center, then writes its results back to the
10
+ repository. Declare `onPullRequest`, `onPullRequestComment`, or `onPush`
11
+ on `bitbucketChannel()` for each event that should wake it.
12
+
13
+ ## Connect a repository
14
+
15
+ Name the repository hook secret and list the repositories that may wake
16
+ the agent.
17
+
18
+ ```ts
19
+ // bot/channels/bitbucket.ts
20
+ import { bitbucketChannel } from "@grok/agent-sdk/channels/bitbucket";
21
+
22
+ export default bitbucketChannel({
23
+ repos: ["acme/widgets"],
24
+ webhookSecret: { secretName: "BITBUCKET_WEBHOOK_SECRET" },
25
+ });
26
+ ```
27
+
28
+ Add a repository webhook for
29
+ `https://<your-host>/<slug>/v1/channels/bitbucket` with the same secret.
30
+ On Cursor hosting, a delivery with the wrong secret gets a `401` and
31
+ never reaches your agent. For Data Center, set the REST base and the API token:
32
+
33
+ ```ts
34
+ export default bitbucketChannel({
35
+ repos: ["PLATFORM/api"],
36
+ webhookSecret: { secretName: "BITBUCKET_WEBHOOK_SECRET" },
37
+ token: () => process.env.BITBUCKET_TOKEN ?? "",
38
+ apiBaseUrl: "https://bitbucket.example.com/rest/api/1.0",
39
+ });
40
+ ```
41
+
42
+ For Bitbucket Cloud, omit `apiBaseUrl`. To set the secrets on a deployment, see
43
+ [Add egress and secrets](../deployment.md#add-egress-and-secrets).
44
+
45
+ For Bitbucket Cloud on Cursor hosting, you can skip the repository
46
+ webhook. Set `cursorAccount: { repos: ["acme/widgets"] }`, and events and
47
+ `ctx.bitbucket` calls go through your signed-in Cursor account.
12
48
 
13
49
  ## Review a pull request
14
50
 
15
- Creating a pull request, or pushing new commits to a Data Center pull
16
- request, starts a review. The hook reads the current diff through the
17
- repository-bound API, the model returns a verdict, and the completed
18
- answer appears as a comment on the pull request.
51
+ When someone opens a pull request, or pushes new commits to a Data Center
52
+ pull request, the agent reads the diff and posts its review as a comment
53
+ on the pull request.
19
54
 
20
55
  ```ts
21
56
  // bot/channels/bitbucket.ts
22
57
  import {
23
58
  bitbucketChannel,
24
- bitbucketChannelStateForEvent,
25
59
  defaultBitbucketAuth,
26
60
  } from "@grok/agent-sdk/channels/bitbucket";
27
- import {
28
- postPullRequestComment,
29
- setPushTriageStatus,
30
- } from "../lib/bitbucket.js";
61
+ import { postPullRequestComment } from "../lib/bitbucket.js";
31
62
 
32
63
  export default bitbucketChannel({
33
64
  repos: ["acme/widgets"],
65
+ webhookSecret: { secretName: "BITBUCKET_WEBHOOK_SECRET" },
34
66
  onPullRequest: async (ctx, pullRequest) => {
35
67
  if (pullRequest.draft) {
36
68
  return null;
@@ -66,28 +98,25 @@ export default bitbucketChannel({
66
98
  ) {
67
99
  return;
68
100
  }
69
- await postPullRequestComment(
70
- channel.state,
71
- pullRequestId,
72
- event.data.text
73
- );
101
+ await postPullRequestComment(channel.state, pullRequestId, event.data.text);
74
102
  },
75
103
  },
76
104
  });
77
105
  ```
78
106
 
79
- `postPullRequestComment` is a small wrapper around the normalized
80
- Bitbucket API. Configure it with the same token and API base described
81
- under [Connect](#connect). It takes the repository and PR ID from the
82
- verified event state, so the model never chooses where its review is
83
- posted.
107
+ `postPullRequestComment` is a small helper you write in
108
+ `bot/lib/bitbucket.ts` that posts a comment through the Bitbucket API
109
+ with `BITBUCKET_TOKEN`. It uses the repository and pull request from the
110
+ session state, so the model never picks where the review goes.
111
+
112
+ Each hook returns `{ auth }`, `{ task }`, or `null`, as
113
+ [handler results](../reference/channels.md#handler-results) describes.
114
+ All events on the same pull request go to the same session, so the agent
115
+ sees the whole conversation.
84
116
 
85
117
  ## Answer a pull-request comment
86
118
 
87
- Mentioning `@cursor-reviewer` in a PR comment resumes that pull
88
- request's conversation, and the first example's reply sink posts the
89
- answer back to the same PR. The author guard ignores comments written
90
- by the agent, preventing each reply from starting another turn.
119
+ Skip the agent's own comments, and answer a comment that mentions the agent:
91
120
 
92
121
  ```ts
93
122
  const AGENT_USERNAME = "cursor-reviewer";
@@ -106,17 +135,19 @@ onPullRequestComment: (ctx, comment) => {
106
135
  },
107
136
  ```
108
137
 
109
- Add this property to the same `bitbucketChannel()` declaration as the
110
- review handler.
138
+ Add this property to the same `bitbucketChannel()` as the review handler.
111
139
 
112
140
  ## Triage a push to `main`
113
141
 
114
- A push to `main` immediately adds a running `cursor/push-triage` build
115
- status to the new commit. The webhook is acknowledged while the model
116
- investigates, then the status reports whether that triage turn
117
- completed.
142
+ Mark the new commit as in progress, then start the triage turn:
118
143
 
119
144
  ```ts
145
+ import {
146
+ bitbucketChannelStateForEvent,
147
+ defaultBitbucketAuth,
148
+ } from "@grok/agent-sdk/channels/bitbucket";
149
+ import { setPushTriageStatus } from "../lib/bitbucket.js";
150
+
120
151
  onPush: (ctx, push) => {
121
152
  const change = push.changes.find(
122
153
  candidate =>
@@ -154,8 +185,7 @@ onPush: (ctx, push) => {
154
185
  },
155
186
  ```
156
187
 
157
- Extend the `events` map so the turn's terminal event concludes the
158
- status through the same provider wrapper:
188
+ When the turn ends, update that same status:
159
189
 
160
190
  ```ts
161
191
  async "message.completed"(event, channel, ctx) {
@@ -191,108 +221,17 @@ async "turn.failed"(_event, channel, ctx) {
191
221
  },
192
222
  ```
193
223
 
194
- This status reports the triage run, not the health of the pushed commit
195
- itself.
196
-
197
- ## Events
198
-
199
- Use `onPullRequest`, `onPullRequestComment`, or `onPush` for the events
200
- shown above. Each hook returns one of three decisions:
201
-
202
- | Return | What happens |
203
- | --- | --- |
204
- | `{ auth }` | Start a model turn as the Bitbucket event sender |
205
- | `{ task }` | Acknowledge the webhook, then run host code that may also call `send` |
206
- | `null` | Skip the event |
207
-
208
- The [Channels reference](../reference/channels.md) covers the remaining
209
- hook and session behavior.
210
-
211
- ## Pull-request affinity
212
-
213
- Every pull-request event and comment for the same repository and PR ID
214
- resumes one agent session. A new PR, later commits, and a mention in the
215
- discussion therefore share the same conversation across both Bitbucket
216
- dialects.
217
-
218
- ## Call Bitbucket through `ctx.bitbucket`
219
-
220
- Each hook receives an API client already bound to the repository and
221
- dialect from the verified delivery. Use `ctx.bitbucket.api` for
222
- pull-request reads and comments, `setBuildStatus()` for one status
223
- update, or `createCheck()` when a status changes throughout longer
224
- work.
225
-
226
- The repository does not come from model output. Keep API calls on this
227
- bound client so the event decides where reads and writes go.
228
-
229
- ## Connect
230
-
231
- On Cursor-managed hosting, use the signed-in Cursor account and list
232
- the repositories that may wake the agent:
233
-
234
- ```ts
235
- export default bitbucketChannel({
236
- cursorAccount: {
237
- repos: ["acme/widgets"],
238
- },
239
- });
240
- ```
241
-
242
- `cursorAccount` covers event delivery and API calls made through
243
- `ctx.bitbucket` inside hooks. The `postPullRequestComment` and
244
- `setPushTriageStatus` wrappers are separate REST clients, so configure
245
- their Bitbucket API credential too.
224
+ This status reports the triage run, not the health of the pushed commit.
246
225
 
247
- For direct webhooks, configure the repository hook secret, API token,
248
- and allowed repositories. Data Center also needs its REST API base:
226
+ ## Test with replay
249
227
 
250
- ```ts
251
- export default bitbucketChannel({
252
- repos: ["PLATFORM/api"],
253
- webhookSecret: { secretName: "BITBUCKET_WEBHOOK_SECRET" },
254
- token: () => process.env.BITBUCKET_TOKEN ?? "",
255
- apiBaseUrl: "https://bitbucket.example.com/rest/api/1.0",
256
- });
257
- ```
258
-
259
- Without `webhookSecret`, the direct production route stays
260
- loopback-only. Setting it admits deliveries signed with the matching
261
- repository-hook secret; `token` authorizes the API reads and writes in
262
- the examples.
263
-
264
- Name the secret rather than reading it. Locally the channel reads that
265
- environment variable, and on Cursor hosting the platform verifies
266
- `X-Hub-Signature` with the deployment secret of that name at ingestion,
267
- so an unsigned or mis-signed delivery gets a `401` before any compute
268
- starts. `architecture: "v2"` requires the named form and `agent-sdk validate`
269
- rejects a literal or `() => process.env.X` getter there; set the value
270
- with `agent-sdk secret set <slug> BITBUCKET_WEBHOOK_SECRET`.
271
-
272
- Register the repository webhook at
273
- `https://<your-host>/<slug>/v1/channels/bitbucket` with the same secret.
274
- For Bitbucket Cloud, omit `apiBaseUrl`.
275
-
276
- ## Test locally
277
-
278
- Replay lets you exercise the same hooks with a pull request you can
279
- read before registering a live repository webhook.
228
+ Replay a pull request you can read against your local agent, or save the
229
+ payloads as fixtures. For Data Center, pass the full pull request URL.
230
+ [`bitbucket replay`](../reference/cli.md#replay-other-webhooks) lists
231
+ every flag.
280
232
 
281
233
  ```text
282
234
  agent-sdk dev
283
- agent-sdk bitbucket replay \
284
- https://bitbucket.example.com/projects/PLATFORM/repos/api/pull-requests/42 \
285
- --events '*'
235
+ agent-sdk bitbucket replay acme/widgets#42 --events '*'
236
+ agent-sdk bitbucket replay acme/widgets#42 --events '*' --dry-run --fixtures-dir fixtures/bitbucket
286
237
  ```
287
-
288
- Use `--dry-run --out fixtures/bitbucket` to save the payloads instead of
289
- posting them. `BITBUCKET_TOKEN` needs read access to the pull request.
290
-
291
- ## Related
292
-
293
- - [Channels reference](../reference/channels.md): channel hooks,
294
- dispatch decisions, and session behavior
295
- - [Webhooks and custom channels](./webhooks.md): direct webhook auth
296
- and reply delivery
297
- - [Evals](../evals.md): turn saved Bitbucket payloads into regression
298
- fixtures
@@ -5,11 +5,9 @@ description: "Let an Agent SDK agent hand coding work to Cursor cloud agents and
5
5
 
6
6
  # Cloud agents
7
7
 
8
- The `cursor-cloud-agents` extension adds repository delegation to an
9
- existing Agent SDK conversation. Cloud agents work on repository checkouts
10
- and push branches and pull requests; your agent can hand off a task,
11
- keep talking while it runs, inspect the result, and steer or stop the
12
- same branch.
8
+ The `cursor-cloud-agents` extension lets an Agent SDK agent hand coding work to
9
+ Cursor cloud agents. A cloud agent works in a repository checkout and pushes
10
+ branches and pull requests while your agent keeps talking to the person.
13
11
 
14
12
  ## Mount it
15
13
 
@@ -26,61 +24,33 @@ export default cursorCloudAgents({
26
24
  ```
27
25
 
28
26
  Launches run under the host's signed-in account (`agent-sdk login`,
29
- `CURSOR_API_KEY`, or `CURSOR_SERVICE_ACCOUNT_KEY`) and spend its
30
- cloud-agent budget. Name the repositories the agent may target in
31
- `cloud.repos`.
27
+ `CURSOR_API_KEY`, or `CURSOR_SERVICE_ACCOUNT_KEY`) and spend its cloud-agent
28
+ budget.
32
29
 
33
30
  ## What the agent can do
34
31
 
35
- With the extension mounted, the agent can hand off coding work and stay
36
- in the conversation while it happens:
32
+ With the extension mounted, the agent can launch a cloud agent on a repository
33
+ or pull request, check its status, read its conversation and edits, steer or
34
+ stop it, and list the agents it launched. A bundled skill teaches the model when
35
+ to delegate and how to write a brief a cloud agent can act on alone.
37
36
 
38
- - **Hand off a task.** Launch a cloud agent on one of your repositories,
39
- or on a pull request, with a self-contained brief. It gets back an
40
- agent id and a URL to share.
41
- - **Check on it.** See whether the agent is still running, what it
42
- produced, and which branches or pull requests it pushed.
43
- - **Read what was done.** Pull the agent's full conversation into the
44
- workspace, quote its final report, or trace the exact edits before
45
- summarizing for a person.
46
- - **Steer or stop.** Send a follow-up to an agent it launched; it queues
47
- behind the current run, or interrupts it on request. Cancel a run that
48
- went sideways.
49
- - **Keep track.** List the agents launched in this conversation, or
50
- everything it has launched before.
51
-
52
- A skill teaches the model when to delegate, how to write a brief a cloud
53
- agent can act on alone, and how to follow up. Everything the extension
54
- launches stays bound to whoever launched it: an agent started by another
55
- user, or outside the extension, is out of reach. That separation is only
56
- as fine as your host's auth; a shared bearer token or `--allow-anonymous`
57
- makes every caller one principal, so use
58
- [authored auth](../reference/channels.md#auth-policies) when callers need
59
- their own.
37
+ Each caller can only see and steer the cloud agents they launched. If every
38
+ caller uses the same bearer token, the extension treats them all as one person.
39
+ Use [authored auth](../reference/channels.md#auth-policies) to keep callers
40
+ apart.
60
41
 
61
42
  ## Configure it
62
43
 
63
-
64
- | Option | What it controls |
65
- | --------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
66
- | `cloud` | Launch defaults for repositories, environment, and pull request behavior. |
67
- | `cloud.repos` | The repositories the agent may hand work to, with a default branch or pull request for each. Without it, launches run with no repository and the model can't name one, so secrets in `cloud.envVars` never reach a repository you didn't list. |
68
- | `cloud.teamMcpServers` | The team MCP servers, by name, that launched agents may use (up to 50 names, matched case-insensitively; every team server with a listed name is kept). Every other team server is left out. Personal servers and `cloud.mcpServers` aren't filtered. Omit it to give agents every team server the launching account can use. |
69
- | `model` | The model launched agents run. Omit it to use the account default. |
70
- | `apiKey` | A Cursor API key to launch with instead of the host's own. |
71
-
72
-
73
-
44
+ | Option | What it controls |
45
+ | --- | --- |
46
+ | `cloud` | Launch defaults for repositories, environment, and pull request behavior. |
47
+ | `cloud.repos` | The repositories the agent may hand work to, each with a default branch or pull request. Without it, launches run with no repository, so secrets in `cloud.envVars` never reach a repository you didn't list. |
48
+ | `cloud.teamMcpServers` | Up to 50 team MCP server names that launched agents may use, matched case-insensitively. Omit it to allow every team server the account can use. Personal servers and `cloud.mcpServers` aren't filtered. |
49
+ | `model` | The model launched agents run. Omit it to use the account default. |
50
+ | `apiKey` | A Cursor API key to launch with instead of the host's own. |
74
51
 
75
52
  ## Adjust it
76
53
 
77
- To take a capability away, such as sending follow-ups, mount as a
78
- directory and disable that tool; see
79
- [overlays](../reference/extensions.md#adjust-a-mounted-extension).
80
-
81
- ## What's next
82
-
83
- Continue with these pages:
84
-
85
- - [Extensions](../reference/extensions.md): how mounts, namespaces, and
86
- overrides work
54
+ To remove a capability such as sending follow-ups, mount the extension as a
55
+ directory and disable that tool. See
56
+ [Adjust a mounted extension](../reference/extensions.md#adjust-a-mounted-extension).
@@ -5,21 +5,15 @@ description: "Turn a dashboard Automation into an Agent SDK project, then reconn
5
5
 
6
6
  # Convert a Cursor Automation
7
7
 
8
- Convert a dashboard Automation when you want to edit its behavior as
9
- code, test it locally, or deploy it as an Agent SDK project. If you only
10
- need to change the prompt or trigger, the dashboard remains the shorter
11
- path.
12
-
13
- `init --from automation:…` carries over what it can prove from the exported
14
- configuration and prints a checklist for everything that still needs
15
- your judgment.
8
+ Convert a dashboard Automation when you want to edit its behavior as code, test
9
+ it locally, or deploy it as an Agent SDK project. To change only the prompt or
10
+ the trigger, stay in the dashboard.
16
11
 
17
12
  ## Convert and run locally
18
13
 
19
- The command creates a project named after the Automation, installs its
20
- dependencies, and prints the generated files along with warnings and
21
- setup steps. Once `dev` starts, you can exercise the converted agent in
22
- the playground before reconnecting any live trigger.
14
+ `init --from automation:<url>` creates a project with the Automation's prompt,
15
+ model, and any schedules, channels, and account connections it can represent.
16
+ It prints warnings and setup steps for the rest.
23
17
 
24
18
  ```text
25
19
  agent-sdk login
@@ -27,22 +21,18 @@ agent-sdk init --from \
27
21
  automation:https://cursor.com/automations/0a1b2c3d-0000-1111-2222-333344445555
28
22
 
29
23
  cd nightly-triage
30
- agent-sdk validate
31
24
  agent-sdk dev
32
25
  ```
33
26
 
34
- The project includes the Automation's prompt and model plus any
35
- schedules, channels, and account connections the converter could
36
- represent directly. The
37
- [CLI reference](../reference/cli.md#convert-automation) covers custom
38
- output directories, JSON output, and command failures.
27
+ Try the agent in the playground before you reconnect a live trigger. The
28
+ [CLI reference](../reference/cli.md#convert-automation) covers the other
29
+ options.
39
30
 
40
31
  ## Reconnect account-backed actions
41
32
 
42
- For an HTTP or SSE MCP server, the converter writes a name-based
43
- connection instead of copying its URL or credentials. After you connect
44
- the same server under MCP in Cursor and sign in the local host, the
45
- converted agent can use that server's tools through your account.
33
+ For an HTTP or SSE MCP server, the converter writes a connection by name,
34
+ without its URL or credentials. Connect the same server under MCP in Cursor,
35
+ sign in on the local host, and the agent uses its tools through your account.
46
36
 
47
37
  ```ts
48
38
  // bot/mcp-connections/linear.ts
@@ -54,55 +44,21 @@ export default defineConnection({
54
44
  });
55
45
  ```
56
46
 
57
- The summary adds a `Verify:` step when an original dashboard action
58
- does not map to one generated tool. Treat that step as a behavior test:
59
- run the converted agent with a representative input and confirm the
60
- same external write happens before you consider the action restored.
61
-
62
47
  ## Bring a Slack trigger online
63
48
 
64
- After you create the dedicated Slack app, mentions wake the converted
65
- agent and its answers land in the same thread. A channel watch also
66
- wakes on allowed posts, but only after you subscribe the app with
67
- `--channel-posts`.
49
+ Once you create the [Slack app](./slack.md), the agent answers mentions in the
50
+ same thread. For a channel watch, also subscribe the app to channel posts:
68
51
 
69
52
  ```text
70
53
  agent-sdk slack create --dir . --channel-posts
71
54
  ```
72
55
 
73
- The converter preserves the watch allowlist. If a warning says Cursor
74
- previously filtered messages by text, add that decision to the
75
- generated channel before inviting the bot:
76
-
77
- ```ts
78
- export default slackChannel({
79
- envPrefix: "NIGHTLY_TRIAGE",
80
- engagement: {
81
- channelPosts: { allow: ["C123"] },
82
- },
83
- onChannelPost: async (_ctx, message) => {
84
- if (!message.markdown.includes("deploy")) {
85
- return null;
86
- }
87
- // `{}` starts a model turn as the sender.
88
- return {};
89
- },
90
- });
91
- ```
92
-
93
- For mention-only Automations, run `agent-sdk slack create --dir .`
94
- without `--channel-posts`. The [Slack guide](./slack.md) covers the
95
- reply experience and app setup.
56
+ The converter keeps the watch allowlist. If a warning says the Automation also
57
+ filtered messages by text, add that check to the channel's `onChannelPost` hook.
96
58
 
97
59
  ## Bring a GitHub trigger online
98
60
 
99
- The generated GitHub channel keeps mechanical filters such as PR
100
- actions, branches, issue actions, repositories, and simple user
101
- allowlists. Conditions that depend on dashboard-only context stay
102
- fail-closed, so the corresponding hook returns `null` until you replace
103
- them.
104
-
105
- For example, a converted CI trigger can wake only when the suite fails:
61
+ The generated GitHub channel keeps simple filters such as PR actions, branches, and repositories, and a hook whose condition depended on dashboard-only context returns `null` until you replace it. This converted CI trigger wakes only when the suite fails:
106
62
 
107
63
  ```ts
108
64
  import {
@@ -117,70 +73,30 @@ export default githubChannel({
117
73
  if (suite.conclusion !== "failure") {
118
74
  return null;
119
75
  }
120
- // `auth` starts a model turn running as the sender.
121
76
  return { auth: defaultGitHubAuth(ctx) };
122
77
  },
123
78
  });
124
79
  ```
125
80
 
126
- Replay a PR with a failing check before connecting live delivery:
81
+ Replay a failing PR before you connect live delivery:
127
82
 
128
83
  ```text
129
- agent-sdk github replay acme/api#42 \
130
- --dir . \
131
- --events '*' \
132
- --conclusion failure
84
+ agent-sdk github replay acme/api#42 --dir . --events '*' --conclusion failure
133
85
  ```
134
86
 
135
- Cursor-account delivery carries PR and comment events. Push, issue, and
136
- CI triggers need real GitHub webhook delivery through a GitHub App or
137
- `github forward`. The [GitHub guide](./github.md) covers both paths.
138
-
139
- ## Treat warnings as the migration checklist
140
-
141
- A successful conversion means the project was generated, not that
142
- every source behavior survived. Read the warnings and setup steps before
143
- turning on a live trigger:
144
-
145
- - A setup step names something you must connect or configure.
146
-
147
- - A `Verify:` step names an external action whose behavior needs a test.
148
-
149
- - A fail-closed hook intentionally starts no turns until you restore its
150
- filter.
151
-
152
- - A `.todo.md` file is ignored by the framework and marks a connection
153
- you must replace.
154
-
155
- Keep the source Automation enabled while you work through this list, so
156
- you still have its behavior as a reference.
157
-
158
- ## Know the conversion boundary
159
-
160
- The converter can reproduce configuration that has a direct home in an
161
- Agent SDK project: instructions, the selected model, cron schedules,
162
- mechanical GitHub filters, Slack mentions and watch allowlists, and
163
- named Cursor-account MCP connections.
87
+ Cursor-account delivery carries PR and comment events. Push, issue, and CI
88
+ triggers need webhook delivery through a GitHub App or `github forward`, as the
89
+ [GitHub guide](./github.md) explains.
164
90
 
165
- It cannot infer policy that lived behind the dashboard. Bespoke trigger
166
- conditions, provider webhook registration and auth, credentials,
167
- unsupported trigger semantics, and built-in action behavior remain
168
- warnings, comments, or TODO files for you to resolve. Credentials are
169
- never exported. Automation memory does not carry over. See
170
- [RA-893](https://linear.app/xai-linear/issue/RA-893).
91
+ ## Work through the checklist
171
92
 
172
- Cursor-managed Automations do not convert because their behavior lives
173
- entirely in managed configuration.
93
+ The converter doesn't carry every behavior over. Before you turn on a live
94
+ trigger, go through the warnings and setup steps it prints:
174
95
 
175
- ## Related
96
+ - A setup step names something you have to connect or configure.
97
+ - A `Verify:` step names a dashboard action with no matching tool. Run the agent
98
+ and confirm the same external write happens.
99
+ - A `.todo.md` file marks a connection you have to replace.
100
+ - Credentials, webhook registration, and Automation memory never carry over.
176
101
 
177
- - [CLI reference](../reference/cli.md#convert-automation): arguments,
178
- JSON output, and failures
179
- - [MCP connections](../reference/connections.md): Cursor-account
180
- connectors and hosted authorization
181
- - [GitHub](./github.md): event delivery, hook filters, and replay
182
- - [Slack](./slack.md): mentions, channel watches, and reply modes
183
- - [Webhooks](./webhooks.md): auth and filtering for generated provider
184
- routes
185
- - [Deployment](../deployment.md): deploy the reviewed project, then
186
- disable the source Automation before enabling the same live triggers
102
+ Keep the source Automation enabled while you work, and when you [deploy](../deployment.md), disable it before you turn on the same live triggers. The converter doesn't support Cursor-managed Automations.