@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
@@ -1,145 +0,0 @@
1
- ---
2
- name: bdk-evals
3
- description: >-
4
- Author and run defineEval cases. Use when writing, fixing, seeding,
5
- or hillclimbing evals. Ask whether to generate samples or take
6
- uploaded data. Materialize API-backed fixtures first.
7
- ---
8
-
9
- # Agent SDK evals
10
-
11
- Fixed input, model turn, gates on the trajectory. Files live at
12
- project-root `evals/**/*.eval.ts`. `bot/evals/` is ignored.
13
- Guide: `docs/evals.md`.
14
-
15
- Observing production: hooks. Tool logic without a model:
16
- `agent-sdk tool call <tool> --input '{...}'`.
17
-
18
- ```bash
19
- agent-sdk eval --dir . --list
20
- agent-sdk eval --dir . --json
21
- agent-sdk eval --dir . weather/nyc
22
- agent-sdk eval --dir . --tag smoke
23
- ```
24
-
25
- | Form | Case id |
26
- | --- | --- |
27
- | `evals/weather.eval.ts` + `test` | `weather` |
28
- | `evals/weather/nyc.eval.ts` + `test` | `weather/nyc` |
29
- | `evals/weather.eval.ts` + `{ id: "nyc" }` | `weather/nyc` |
30
- | `evals/sql.eval.ts` exporting an array of `defineEval` calls | `sql/0000`, `sql/0001`, ... |
31
-
32
- `eval` boots an ephemeral server and a temp state root. `--url`
33
- points at a running agent. Model turns need a Cursor credential
34
- (`CURSOR_API_KEY`, then `CURSOR_API_KEY_FILE`, then
35
- `CURSOR_SERVICE_ACCOUNT_KEY`, then `agent-sdk login`); `--list` does
36
- not. Node 22.13+, never Bun.
37
-
38
- ## Seeding
39
-
40
- Creating or expanding cases: `AskQuestion` first.
41
-
42
- | Question | Options |
43
- | --- | --- |
44
- | **How should we get eval samples?** | Generate test eval samples for me `(recommended)` · I will add / upload the data manually |
45
-
46
- 1. **Manual.** They provide files or paste. Show the shape below.
47
- Do not invent cases. Then `eval --list` and wire gates.
48
- API-backed pointers (PR URLs, SHAs, gold labels): materialize
49
- under `fixtures/` first.
50
- 2. **Generated.** Ask count (`3` recommended). Append to an
51
- existing `cases` array when it fits. Never overwrite or weaken
52
- a datapoint. Create `evals/evals.config.ts` if missing
53
- (`maxConcurrency: 20`; cap 200).
54
-
55
- ## API
56
-
57
- ```ts
58
- import { defineEval, includes, satisfies } from "@grok/agent-sdk/evals";
59
-
60
- export default defineEval({
61
- tags: ["smoke", "weather"],
62
- cases: [
63
- {
64
- id: "nyc",
65
- description: "NYC temperature.",
66
- async test(t) {
67
- await t.send("What's the temperature in NYC?");
68
- t.succeeded();
69
- t.calledTool("get_weather");
70
- t.notCalledTool("save_weather_note");
71
- t.check(t.reply, includes(/°|[FC]/));
72
- },
73
- },
74
- ],
75
- });
76
- ```
77
-
78
- ```ts
79
- import { defineEvalConfig } from "@grok/agent-sdk/evals";
80
-
81
- export default defineEvalConfig({
82
- maxConcurrency: 20,
83
- });
84
- ```
85
-
86
- Either `test(t)` or `cases`, not both. `t.send` waits for the turn to
87
- settle (complete or fail) and returns it; `turn.calledTool(...)`
88
- reads only that turn, `t.*` reads the whole run. First-send options:
89
- `workspaceFiles`, `workspaceDir`.
90
-
91
- Gates: `t.succeeded()`,
92
- `calledTool(name, { input, output, status, count })` / `notCalledTool`,
93
- `toolOrder`, `maxToolCalls`, `taggedArtifact`, `event` / `notEvent`,
94
- `t.check(value, includes | equals | matches | similarity | satisfies)`.
95
- Records: `t.metric`, `t.log`, `t.score` (soft 0-1).
96
-
97
- Severity is on the handle: default gate; `.soft()` tracked;
98
- `.atLeast(0.8)` soft with a bar (verdict `scored`, exit 1 only under
99
- `--strict`); `.gate(0.8)` hard. `t.judge.factuality`, `summarizes`,
100
- `closedQA`, and `sql` are soft by default and need a judge model
101
- (`judge` in `evals.config.ts`, on the eval or case, or per-call
102
- `{ model }`).
103
-
104
- ## Side effects
105
-
106
- Eval sessions run real tools. Guard actuation with
107
- `ctx.session.purpose === "eval"` in the tool or hook
108
- and return a shaped result so `calledTool` can still assert the
109
- decision.
110
-
111
- ## What to gate
112
-
113
- Decisions and shape, not prose.
114
-
115
- 1. `t.succeeded()` first
116
- 2. Intended tool + the tempting wrong one
117
- 3. A shape regex or `satisfies` on parsed fields
118
- 4. If formatting keeps failing, tighten instructions. Do not move
119
- rendering into a host tool.
120
-
121
- Anti-patterns: exact phrasing; more than ~5 gates (split); live
122
- drifting inputs (pin them).
123
-
124
- | Surface | Fixture |
125
- | --- | --- |
126
- | Chat | One frozen prompt |
127
- | Tool-heavy | `agent-sdk tool call` first, then the prompt |
128
- | GitHub | `github replay … --dry-run --fixtures-dir fixtures/github` |
129
- | Host-prep PR review | A team-owned PR; gate findings shape, not counts |
130
- | Workspace | `workspaceFiles` in `t.send` |
131
- | Dataset | `loadJson` / `loadJsonl` / `loadYaml` from `@grok/agent-sdk/evals/loaders`, paths from the project root |
132
-
133
- ## Debug and CI
134
-
135
- A failed local run leaves `evals/<case-id>.json` (assertions, inputs,
136
- tool I/O, final text, logs) under `evals/<stamp>/` in the project state
137
- directory (the CLI prints the path); read it before editing the eval.
138
- `--state-root <path>` keeps the raw session events too.
139
-
140
- CI: `agent-sdk eval --dir . --json --no-stream --junit reports/evals.xml`.
141
- Exit `1` on a failed gate, `2` when nothing matched, `--strict` to fail
142
- on `scored`.
143
-
144
- Every kept hillclimb change lands an eval that would have failed
145
- before it. Never weaken a gate to pass a round.
@@ -1,133 +0,0 @@
1
- ---
2
- name: bdk-github
3
- description: >-
4
- Build and test GitHub-driven Agent SDK agents: githubChannel hooks
5
- (auth turn vs host task), cursorAccount / --cursor-events, and
6
- local test tiers (fixtures, replay, forward). Use when wiring
7
- GitHub events or debugging delivery.
8
- ---
9
-
10
- # GitHub channels in the Agent SDK
11
-
12
- Author `bot/channels/github.ts`. Production wakes:
13
- `cursorAccount` + `serve --cursor-events`. No public webhook URL.
14
- Use the HTTP route for fixtures, replay, and hosts that already
15
- terminate GitHub webhooks.
16
-
17
- Guide: `docs/guides/github.md`.
18
-
19
- ```ts
20
- import { defaultGitHubAuth, githubChannel } from "@grok/agent-sdk/channels/github";
21
-
22
- export default githubChannel({
23
- botName: "my-agent",
24
- cursorAccount: { repos: ["owner/repo"] }, // permissions?: "read" | "pr-write" | "contents-write"
25
-
26
- onPullRequest: (ctx, pr) => {
27
- if (pr.action !== "opened") {
28
- return null;
29
- }
30
- return { auth: defaultGitHubAuth(ctx) };
31
- },
32
- onCheckSuite: (ctx, suite) => {
33
- if (suite.conclusion !== "failure") {
34
- return null;
35
- }
36
- return { task: () => triage(ctx) };
37
- },
38
- });
39
- ```
40
-
41
- Hooks: `onPullRequest`, `onComment`, `onIssue`, `onCheckSuite`,
42
- `onCheckRun`, `onWorkflowRun`, `onStatus`, plus `onEvent` and
43
- `onStart`/`onStop`.
44
-
45
- | Return | Meaning |
46
- | ---------- | -------------------------------------------------------------------------------- |
47
- | `{ auth }` | Model turn. Session shows in the playground. `workspaceFiles` can be a function. |
48
- | `{ task }` | Host work. No chat session. Use when the work can outlive a webhook timeout. |
49
- | `null` | Skip |
50
-
51
- To keep repo scope in deploy config, use `cursorAccount: true`
52
- and pass `--repo owner/name` at serve / `--cursor-events-repo`
53
- at deploy. Repos must share one GitHub owner.
54
-
55
- ## Event sources
56
-
57
- | Source | When |
58
- | ------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
59
- | `cursorAccount` + `serve --cursor-events` | Preferred. Signed-in host (`agent-sdk login`, `CURSOR_API_KEY`, or `CURSOR_SERVICE_ACCOUNT_KEY`). Repos from the channel and from repeatable `--repo owner/name`. Cap 20, one GitHub owner |
60
- | HTTP `POST /<slug>/v1/channels/github` with a webhook secret | `allowAll()` + `X-Hub-Signature-256` |
61
- | HTTP, no secret | Loopback only. `serve --dev` also admits unsigned loopback (fixtures / forward) |
62
-
63
- `permissions`: `"read"` inspect; `"pr-write"` (default) comments /
64
- PR writes; `"contents-write"` push or merge-box checks.
65
- `progress.commitStatus` needs check-write; see the GitHub guide.
66
- Set `checks: true` when channel code posts its own Checks API
67
- runs through `ctx.github.createCheck`. The flag grants access.
68
- It does not post a check.
69
-
70
- Without `cursorAccount`, outbound calls prefer App installation
71
- tokens (`GITHUB_APP_ID` + `GITHUB_APP_PRIVATE_KEY`). Local tests
72
- can use `GITHUB_TOKEN` / `gh auth login`.
73
-
74
- ## Credentials
75
-
76
- Name secrets; never read them. Each `credentials` field
77
- (`webhookSecret`, `token`, `installationToken`, `appId`,
78
- `privateKey`) takes `{ secretName: "NAME" }`: the env var locally,
79
- the deployment secret of that name on Cursor hosting. The platform
80
- verifies `X-Hub-Signature-256` against the named secret before any
81
- compute starts and `deploy` warns when a named secret is unset.
82
-
83
- ```ts
84
- credentials: {
85
- webhookSecret: { secretName: "GITHUB_WEBHOOK_SECRET" },
86
- appId: { secretName: "GITHUB_APP_ID" },
87
- privateKey: { secretName: "GITHUB_APP_PRIVATE_KEY" },
88
- },
89
- ```
90
-
91
- A literal or `() => process.env.X` getter fails `agent-sdk validate` on
92
- architecture v2 (the default) with `requires a named secret`; the
93
- message quotes the `{ secretName }` to use. Omit a field to keep its
94
- default name; a numeric `appId` is allowed. Only `architecture: "v1"`
95
- still accepts getters, and `validate` warns there.
96
-
97
- The Cursor stream is metadata, not full webhook bodies. Re-read
98
- the PR from GitHub.
99
-
100
- ## Test locally
101
-
102
- 1. **Fixtures** (offline, `--dev`, no signature):
103
-
104
- ```bash
105
- curl -s -X POST http://127.0.0.1:3000/<slug>/v1/channels/github \
106
- -H 'content-type: application/json' \
107
- -H 'x-github-event: pull_request' \
108
- -d @fixtures/github/pull_request.synchronize.json
109
- ```
110
-
111
- 2. **Replay** (hillclimb tier; pull access is enough):
112
-
113
- ```bash
114
- agent-sdk github replay owner/repo#123 --dir <project>
115
- agent-sdk github replay owner/repo#123 --dir <project> --events '*' --dry-run --fixtures-dir fixtures/github
116
- ```
117
-
118
- 3. **Forward** (live; repo admin). One forwarder per repo. Blank
119
- `GITHUB_TOKEN`/`GH_TOKEN` or every delivery 401s:
120
-
121
- ```bash
122
- agent-sdk github doctor --install
123
- GITHUB_TOKEN= GH_TOKEN= agent-sdk github forward --dir <project>
124
- ```
125
-
126
- 4. **Cursor pull** (same as production):
127
-
128
- ```bash
129
- agent-sdk serve --dir <project> --cursor-events --repo owner/repo
130
- ```
131
-
132
- Volume, debounce, and `progress.commitStatus` / `progress.banner`
133
- live in `docs/guides/github.md`. Do not preinstall them.
@@ -1,63 +0,0 @@
1
- ---
2
- name: bdk-hillclimb
3
- description: >-
4
- Improve one existing Agent SDK agent: pin fixtures, measure, change
5
- one lever, remeasure, lock the win with an eval. Use when an agent
6
- already runs and needs better results.
7
- ---
8
-
9
- # Agent SDK hillclimb
10
-
11
- Measure → change one lever → remeasure. One failure mode per round.
12
-
13
- Siblings: `skills/evals/SKILL.md`, `skills/github/SKILL.md`,
14
- `skills/debug/SKILL.md`.
15
-
16
- ## Preconditions
17
-
18
- From the user or the invoking message:
19
-
20
- 1. **Target.** Path or slug
21
- 2. **Fixtures.** Fixed inputs
22
- 3. **Success.** What better means this round
23
- 4. **Freeze line.** What must not change
24
-
25
- Ask before editing if any are missing. A moving fixture is noise.
26
-
27
- | Surface | Pin it |
28
- | --- | --- |
29
- | GitHub | `agent-sdk github replay <pr> --dir <project>` (`--dry-run --out fixtures/github`) |
30
- | One tool | `agent-sdk tool call <tool> --dir <project> --input '{...}'` |
31
- | Chat | `agent-sdk run --dir <project> --message "<fixture>"` |
32
-
33
- ## Loop
34
-
35
- 1. **Serve.** `agent-sdk serve --dir <project> --mode single --dev`
36
- Playground: `http://127.0.0.1:3000/playground`.
37
- 2. **Hit it.** Same path a user would. Record status, wall time,
38
- `sessionId`, output, and `action.result` counts by `toolName`.
39
- 3. **Name the failure.** Score correctness, efficiency, harness
40
- fit. One dominant failure this round.
41
- 4. **Change one lever.** Smallest first. Delete the code or prompt
42
- that caused it. Then instructions / skills, evidence shape,
43
- host prep (`workspaceFiles`, channel `callTool`) for wandering
44
- and latency (not formatting or judgment), remove or gate
45
- wandering tools, framework only if the agent cannot express
46
- the fix. Hypothesis: *If we X, metric Y should move because Z.*
47
- 5. **Remeasure.** Same fixtures. Keep only if the target metric
48
- improves and the freeze line holds.
49
- 6. **Lock.** A kept change gets an eval that would have failed
50
- before it (`skills/evals/SKILL.md`). Never weaken a gate to
51
- pass a round.
52
-
53
- ```markdown
54
- ### Hillclimb round N. `<slug>`
55
- - Fixture(s): …
56
- - Hypothesis: …
57
- - Change: …
58
- - Before → after: tools …; wall …; quality …
59
- - Verdict: keep | revert | narrow
60
- - Next failure mode:
61
- ```
62
-
63
- Do not deploy or post real GitHub reviews unless asked.
@@ -1,60 +0,0 @@
1
- ---
2
- name: bdk-mcp-auth
3
- description: >-
4
- Authorize host MCP OAuth for defineConnection({ url, oauth: true }):
5
- agent-sdk mcp oauth, local tokens, advertiseTools, egress, and the hosted
6
- cursorAccount path. Use when wiring or debugging MCP auth.
7
- ---
8
-
9
- # Host MCP OAuth
10
-
11
- Guide: `docs/guides/mcp-oauth.md`.
12
-
13
- | Need | Use |
14
- | --- | --- |
15
- | Connector already in the Cursor dashboard | `defineConnection({ cursorAccount: true })` or `servers: "*"` / `servers: […]` |
16
- | Remote URL that speaks OAuth; host holds tokens | `defineConnection({ url, oauth: true })` + this skill |
17
- | Static bearer / API key | `headers` / env on `{ url }` |
18
-
19
- `advertiseTools: true` puts named tools on local turns. Host tools
20
- can still call `ctx.host.mcp`.
21
-
22
- ## Checklist
23
-
24
- 1. **Declare the connection.** `bot/mcp-connections/<name>.ts`
25
- with `url` + `oauth: true`. Use `bot/host-connections/` when
26
- the model must not see it.
27
- 2. **Allow egress** on hosted non-bootstrap hosts:
28
- `hosting.egressDomains`.
29
- 3. **Authorize.** Local: `agent-sdk mcp oauth <name>`, or finish
30
- Connect in the playground so the current process can retry.
31
- Tokens stay on this machine. Hosted: use a
32
- `cursorAccount: true` connection and connect the server from
33
- **Deployed Agents** in the dashboard; its tokens stay on the
34
- Cursor backend.
35
-
36
- ```ts
37
- // bot/mcp-connections/inventory.ts
38
- export default defineConnection({
39
- url: "https://mcp.example.com/inventory",
40
- oauth: true,
41
- });
42
- ```
43
-
44
- ```bash
45
- agent-sdk mcp oauth <connection>
46
- ```
47
-
48
- Browser callback: `http://127.0.0.1:8787/callback`. Tokens live in
49
- the CLI config directory (`mcp-auth.json` or
50
- `$AGENT_SERVE_CONFIG_DIR`). URL change drops the old entry; re-run.
51
-
52
- | Symptom | Fix |
53
- | --- | --- |
54
- | `must be defineConnection({ url, oauth: true })` | Wrong name or missing `oauth: true` |
55
- | `Unknown MCP connection` | Filename must match the CLI arg |
56
- | Callback hang | Free port 8787; finish the browser flow here |
57
- | Hosted 401 | Local tokens don't reach the deployment. Switch to `cursorAccount: true`; connect from **Deployed Agents** |
58
- | Model invents `mcp_auth` / IDE MCP | `advertiseTools: true` on local turns |
59
-
60
- No raw tokens in git.