@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,121 +0,0 @@
1
- ---
2
- title: "Hooks"
3
- description: "Observe session events for metrics, alerts, and other side effects without changing the turn."
4
- ---
5
-
6
- # Hooks
7
-
8
- Hooks observe session events after they are recorded and run side effects such
9
- as updating metrics or sending alerts. They never change the turn, prompt, or
10
- reply. Author them under `bot/hooks/` with `defineHook` from
11
- `@grok/agent-sdk/hooks`.
12
-
13
- ## Meter token usage
14
-
15
- With [OpenTelemetry](./opentelemetry.md) configured, this hook adds a live
16
- turn's reported input and output tokens to your counters. Eval runs stay quiet,
17
- so the dashboard reflects live traffic instead of the test suite.
18
-
19
- ```ts
20
- // bot/hooks/usage.ts
21
- import { metrics } from "@opentelemetry/api";
22
- import { defineHook } from "@grok/agent-sdk/hooks";
23
-
24
- const meter = metrics.getMeter("acme");
25
- const inputTokens = meter.createCounter("acme.tokens.input");
26
- const outputTokens = meter.createCounter("acme.tokens.output");
27
-
28
- export default defineHook({
29
- events: {
30
- async "turn.completed"(event, ctx) {
31
- if (ctx.session.purpose === "eval") {
32
- return;
33
- }
34
- if (event.data.usage === undefined) {
35
- return;
36
- }
37
-
38
- inputTokens.add(event.data.usage.inputTokens);
39
- outputTokens.add(event.data.usage.outputTokens);
40
- },
41
- },
42
- });
43
- ```
44
-
45
- ## Alert on failure
46
-
47
- Set `PAGER_WEBHOOK_URL` to your pager's webhook. When a live turn fails, this
48
- hook posts the agent, session, and failure message there. Eval runs and
49
- interrupted turns stay quiet, so tests and preemptions do not page anyone.
50
-
51
- ```ts
52
- // bot/hooks/page-on-failure.ts
53
- import { defineHook } from "@grok/agent-sdk/hooks";
54
-
55
- export default defineHook({
56
- events: {
57
- async "turn.failed"(event, ctx) {
58
- if (ctx.session.purpose === "eval") {
59
- return;
60
- }
61
- if (event.data.message === "turn interrupted") {
62
- return;
63
- }
64
-
65
- const pagerUrl = process.env.PAGER_WEBHOOK_URL;
66
- if (pagerUrl === undefined) {
67
- return;
68
- }
69
-
70
- await fetch(pagerUrl, {
71
- method: "POST",
72
- headers: { "content-type": "application/json" },
73
- body: JSON.stringify({
74
- agent: ctx.agent.name,
75
- session: ctx.session.id,
76
- channel: ctx.channel.id,
77
- message: event.data.message,
78
- }),
79
- signal: AbortSignal.timeout(5_000),
80
- });
81
- },
82
- },
83
- });
84
- ```
85
-
86
- ## Events / when hooks run
87
-
88
- Use event names from the
89
- [session event vocabulary](../reference/sessions.md#stream-events). A hook
90
- receives each matching event after it is recorded, and the model does not wait
91
- for the handler.
92
-
93
- Within one session, handlers run one at a time. A slow handler delays later
94
- handlers for that session, but it does not delay the model or handlers for
95
- other sessions. Hooks also fire for evals, so check
96
- `ctx.session.purpose === "eval"` before metering or paging. A restart does not
97
- replay recorded events into hooks.
98
-
99
- ## When not to use a hook
100
-
101
- | Want | Use instead |
102
- | --- | --- |
103
- | Add context before the model | `instructions.md`, skills, or `workspaceFiles` |
104
- | Deliver to Slack or a PR | Channel [`events`](../reference/channels.md#events) or packs |
105
- | Gate behavior | [Evals](../evals.md) |
106
-
107
- To act on a turn's decision, have the model record it with an authored
108
- [tool](../reference/tools.md), then act on it from a `turn.completed` hook.
109
-
110
- [Cursor Agent hooks](https://cursor.com/docs/agent/hooks) in
111
- `.cursor/hooks.json` are a different product. They can observe, block, or
112
- modify the local agent loop.
113
-
114
- ## Related
115
-
116
- - [Hooks reference](../reference/hooks.md): payloads, context, and discovery
117
- - [Sessions: stream events](../reference/sessions.md#stream-events): event
118
- vocabulary and payload sequence
119
- - [OpenTelemetry](./opentelemetry.md): export traces and custom metrics
120
- - [Channels: events](../reference/channels.md#events): deliver replies back to
121
- Slack, source control, or another surface
@@ -1,52 +0,0 @@
1
- ---
2
- title: "Prompt strings"
3
- description: "Write indented multi-line strings without carrying source indentation into their values."
4
- ---
5
-
6
- # Prompt strings
7
-
8
- The `prompt` template tag keeps multi-line strings aligned with the
9
- surrounding TypeScript while returning dedented text. Use it for tool
10
- descriptions, reminder prompts, channel context, and errors. Import it
11
- from the package root or the dedicated entrypoint:
12
-
13
- ```ts
14
- import { prompt } from "@grok/agent-sdk";
15
- // or: import { prompt } from "@grok/agent-sdk/prompt";
16
- ```
17
-
18
- ## Dedented strings
19
-
20
- `prompt` returns one string. It removes the common leading whitespace
21
- and one newline immediately after the opening backtick.
22
-
23
- ```ts
24
- throw new Error(prompt`
25
- It is outside business hours (Mon-Fri 9am-5pm ET).
26
- Use request_author_approval, or pass approval=human_request.
27
- `);
28
- ```
29
-
30
- Blank lines inside the body are preserved. Relative indentation after the
31
- common prefix is preserved, so nested lists keep their shape.
32
-
33
- When interpolating multi-line values (for example a list of services), give
34
- those lines the same indent as the `prompt` body so dedent stays consistent.
35
-
36
- ## Line arrays
37
-
38
- `prompt.lines` applies the same rules and returns `string[]`, with one
39
- entry per line. Use it when an API accepts separate context lines:
40
-
41
- ```ts
42
- context: prompt.lines`
43
- Merged PR detected: ${pr.url} by ${author}.
44
-
45
- Call plan_deploy, then follow its nextStep.
46
- `
47
- ```
48
-
49
- ## Related
50
-
51
- - [Tools](./tools.md)
52
- - [Channels](./channels.md)
@@ -1,86 +0,0 @@
1
- ---
2
- title: "Review pull requests for exploitable bugs"
3
- description: "Scaffold the agent, pick repos, replay a PR, and deploy."
4
- ---
5
-
6
- # Review pull requests for exploitable bugs
7
-
8
- This agent reads a pull request diff and posts one review comment. It
9
- reports exploitable bugs: injection, authz bypass, secret leaks, SSRF,
10
- RCE. Style nits stay out.
11
-
12
- This template is one model turn: read the diff, then post one comment.
13
-
14
- ## Scaffold
15
-
16
- ```text
17
- agent-sdk init ./security-reviewer --template security-reviewer \
18
- --var repos=acme/api
19
- ```
20
-
21
- `--var repos` must name a repository already connected in Cursor for
22
- your account. Separate multiple repositories with commas; they must
23
- share one owner. `init` writes the list to `bot/lib/repos.ts`.
24
-
25
- ## Connect GitHub through Cursor
26
-
27
- Connect GitHub in Cursor for those repositories (Settings or
28
- [cursor.com/dashboard](https://cursor.com/dashboard)). Sign the host in:
29
-
30
- ```text
31
- cd security-reviewer
32
- agent-sdk login
33
- ```
34
-
35
- `cursorAccount` pulls SCM events from Cursor and mints a short-lived,
36
- repo-scoped credential. `ctx.host.github` and child `gh` commands share
37
- it. See the [GitHub guide](../guides/github.md).
38
-
39
- ## First review
40
-
41
- ```text
42
- agent-sdk dev
43
- ```
44
-
45
- `dev` starts the Cursor event relay for the watched repos. To drive a
46
- known PR without waiting on a live push:
47
-
48
- ```text
49
- agent-sdk github replay https://github.com/acme/api/pull/12 --dir .
50
- ```
51
-
52
- `replay` needs pull access. Draft PRs and repos outside
53
- `bot/lib/repos.ts` are ignored. The channel writes `pr/diff.patch`
54
- after the wake is acknowledged, then starts a model turn. The model
55
- calls `post_findings` once.
56
-
57
- Chat replies stay in the playground. `post_findings` writes the GitHub
58
- comment.
59
-
60
- ## What to edit
61
-
62
- - `bot/lib/repos.ts`: watched repos
63
- - `bot/instructions.md`: what counts as a finding and the comment
64
- shape
65
- - `evals/review.eval.ts`: smoke cases
66
-
67
- ## Evals
68
-
69
- Use the two smoke cases, one XSS fixture and one docs-only change, as a
70
- local exercise:
71
-
72
- ```text
73
- agent-sdk eval
74
- ```
75
-
76
- Eval sessions skip the GitHub write.
77
-
78
- ## Deploy
79
-
80
- ```text
81
- agent-sdk deploy
82
- ```
83
-
84
- Run it from the agent's git checkout. The command infers repository,
85
- ref, path, and slug. The deployment uses the team's Cursor GitHub
86
- connection for the same watched repos.
@@ -1,80 +0,0 @@
1
- ---
2
- title: "Review pull requests for structural code quality"
3
- description: "Scaffold the agent, deploy it, and open a PR."
4
- ---
5
-
6
- # Review pull requests for structural code quality
7
-
8
- This agent reads a pull request diff and posts one review comment. It
9
- reports missing abstractions, deeply nested control flow, feature logic
10
- leaking into shared paths, and files pushed past 1,000 lines. Style nits
11
- and behavior disputes stay out.
12
-
13
- This template is one model turn: read the diff, then post one comment.
14
-
15
- ## Scaffold
16
-
17
- ```text
18
- agent-sdk init ./thermo-quality-review --template thermo-quality-review
19
- cd thermo-quality-review
20
- ```
21
-
22
- ## Deploy
23
-
24
- Sign in once, then deploy from a pushed checkout:
25
-
26
- ```text
27
- agent-sdk login
28
- agent-sdk deploy --cursor-events-repo acme/api
29
- ```
30
-
31
- Repeat `--cursor-events-repo` for each repo. Every repo must share one
32
- owner. The deployment watches those repos through your team's Cursor
33
- GitHub connection and reviews each opened PR. No webhook or local
34
- server.
35
-
36
- Change repos later without redeploying:
37
-
38
- ```text
39
- agent-sdk deployment update thermo-quality-review --event-repo acme/api --event-repo acme/web
40
- ```
41
-
42
- ## Try it locally
43
-
44
- Skip the deploy while you iterate. Start the relay for one repo:
45
-
46
- ```text
47
- agent-sdk dev --cursor-events --repo acme/api
48
- ```
49
-
50
- Open a PR, or replay a known one without pushing:
51
-
52
- ```text
53
- agent-sdk github replay https://github.com/acme/api/pull/12 --dir .
54
- ```
55
-
56
- `replay` needs pull access. Draft PRs are ignored. The channel writes
57
- `pr/diff.patch`, then starts a model turn. The model calls
58
- `post_findings` once. Chat replies stay in the playground.
59
- `post_findings` writes the GitHub comment.
60
-
61
- Connect GitHub in Cursor first (Settings or
62
- [cursor.com/dashboard](https://cursor.com/dashboard)) so the relay and
63
- API calls use your account. See the [GitHub guide](../guides/github.md).
64
-
65
- ## Evals
66
-
67
- Use the two smoke cases, one spaghetti-branch fixture and one clean fix,
68
- as a local exercise. They need no GitHub access.
69
-
70
- ```text
71
- agent-sdk eval
72
- ```
73
-
74
- Eval sessions skip the GitHub write.
75
-
76
- ## What to edit
77
-
78
- - `bot/instructions.md`: what counts as a finding and the comment
79
- shape
80
- - `evals/review.eval.ts`: smoke cases
@@ -1,80 +0,0 @@
1
- ---
2
- title: "Review pull requests for bugs and breakage"
3
- description: "Scaffold the agent, deploy it, and open a PR."
4
- ---
5
-
6
- # Review pull requests for bugs and breakage
7
-
8
- This agent reads a pull request diff and posts one review comment. It
9
- reports bugs, breaking side effects, developer workflow failures, and
10
- unintended feature exposure in added or modified code. Style nits stay
11
- out.
12
-
13
- This template is one model turn: read the diff, then post one comment.
14
-
15
- ## Scaffold
16
-
17
- ```text
18
- agent-sdk init ./thermo-review --template thermo-review
19
- cd thermo-review
20
- ```
21
-
22
- ## Deploy
23
-
24
- Sign in once, then deploy from a pushed checkout:
25
-
26
- ```text
27
- agent-sdk login
28
- agent-sdk deploy --cursor-events-repo acme/api
29
- ```
30
-
31
- Repeat `--cursor-events-repo` for each repo. Every repo must share one
32
- owner. The deployment watches those repos through your team's Cursor
33
- GitHub connection and reviews each opened PR. No webhook or local
34
- server.
35
-
36
- Change repos later without redeploying:
37
-
38
- ```text
39
- agent-sdk deployment update thermo-review --event-repo acme/api --event-repo acme/web
40
- ```
41
-
42
- ## Try it locally
43
-
44
- Skip the deploy while you iterate. Start the relay for one repo:
45
-
46
- ```text
47
- agent-sdk dev --cursor-events --repo acme/api
48
- ```
49
-
50
- Open a PR, or replay a known one without pushing:
51
-
52
- ```text
53
- agent-sdk github replay https://github.com/acme/api/pull/12 --dir .
54
- ```
55
-
56
- `replay` needs pull access. Draft PRs are ignored. The channel writes
57
- `pr/diff.patch`, then starts a model turn. The model calls
58
- `post_findings` once. Chat replies stay in the playground.
59
- `post_findings` writes the GitHub comment.
60
-
61
- Connect GitHub in Cursor first (Settings or
62
- [cursor.com/dashboard](https://cursor.com/dashboard)) so the relay and
63
- API calls use your account. See the [GitHub guide](../guides/github.md).
64
-
65
- ## Evals
66
-
67
- Use the two smoke cases, one auth-bypass fixture and one docs-only
68
- change, as a local exercise. They need no GitHub access.
69
-
70
- ```text
71
- agent-sdk eval
72
- ```
73
-
74
- Eval sessions skip the GitHub write.
75
-
76
- ## What to edit
77
-
78
- - `bot/instructions.md`: what counts as a finding and the comment
79
- shape
80
- - `evals/review.eval.ts`: smoke cases
@@ -1,106 +0,0 @@
1
- ---
2
- title: "Triage Linear or Jira issues in place"
3
- description: "Scaffold the agent, point it at an existing ticket, tune the rubric, run evals, and deploy."
4
- ---
5
-
6
- # Triage Linear or Jira issues in place
7
-
8
- This agent comments on tickets you already filed. It classifies the
9
- issue, writes a `Triage:` comment, sets bug priority, and links a
10
- duplicate when titles match.
11
-
12
- File the ticket however you already do. This template starts after the
13
- ticket exists.
14
-
15
- ## Scaffold
16
-
17
- ```text
18
- agent-sdk init ./triage-agent --template triage-linear
19
- agent-sdk init ./triage-agent --template triage-jira
20
- ```
21
-
22
- `agent-sdk init --template triage` selects `triage-linear`.
23
-
24
- Pick the tracker you use. The agent is the same. The overlay is the
25
- connection.
26
-
27
- `init` writes the project, installs dependencies, and puts `agent-sdk`
28
- on PATH.
29
-
30
- ## Log in
31
-
32
- Model turns and Cursor MCP use your Cursor account.
33
-
34
- ```text
35
- cd triage-agent
36
- agent-sdk login
37
- ```
38
-
39
- The command opens a browser if you have no stored credential.
40
-
41
- ## Connect the tracker
42
-
43
- In the Cursor dashboard, open MCP and connect Linear or Jira.
44
-
45
- The connection stays on the host. The model calls `record_triage`.
46
- Linear and Jira tools stay off the model's tool list.
47
-
48
- Linear or Jira MCP must be connected for comments, priority changes,
49
- and duplicate links; queueing an issue can still classify it through
50
- `record_triage` without that connection.
51
-
52
- ## First verdict
53
-
54
- ```text
55
- agent-sdk dev
56
- ```
57
-
58
- Open the playground. Run `/queue/issue` and paste an existing issue.
59
-
60
- You can also POST:
61
-
62
- ```bash
63
- curl -X POST http://127.0.0.1:3000/triage-agent/v1/channels/queue/issue \
64
- -H 'content-type: application/json' \
65
- -d '{
66
- "identifier": "ENG-142",
67
- "title": "CSV export returns 500",
68
- "description": "Export has returned 500 since this morning."
69
- }'
70
- ```
71
-
72
- For create webhooks, set `LINEAR_WEBHOOK_SECRET` or
73
- `JIRA_WEBHOOK_SECRET`. Point the provider at the deployed alias under
74
- `/v1/channels/webhook`. Signed events start or resume triage for that issue.
75
-
76
- `record_triage` comments on the issue that started the session, not
77
- whatever identifier the model copies out of the ticket body.
78
-
79
- ## Rubric
80
-
81
- Edit `bot/skills/triage-rubric.md` for kinds, tie-breakers, and what
82
- `urgent` means on your team. The next turn reads the file.
83
-
84
- `bot/instructions.md` is the procedure around the rubric: missing
85
- details, when to call `record_triage`, how to reply.
86
-
87
- ## Evals
88
-
89
- Use the three smoke cases, one per kind, as a local exercise after you
90
- change the rubric.
91
-
92
- ```text
93
- agent-sdk eval
94
- ```
95
-
96
- Eval sessions skip tracker writes.
97
-
98
- ## Deploy
99
-
100
- ```text
101
- agent-sdk deploy
102
- ```
103
-
104
- Run it from the agent's git checkout. It infers repository, ref, path,
105
- and slug, builds on Cursor-managed hosting, and prints the URL.
106
- `agent-sdk deployment list` shows status.