@grok/agent-sdk 0.2.28 → 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 (528) hide show
  1. package/AGENTS.md +29 -29
  2. package/dist/bin/agent-serve.d.ts +2 -2
  3. package/dist/bin/agent-serve.js +3 -3
  4. package/dist/channels/pagerduty/api.js +1 -1
  5. package/dist/channels/pagerduty/pagerduty-channel.d.ts +1 -1
  6. package/dist/channels/pagerduty/pagerduty-channel.d.ts.map +1 -1
  7. package/dist/channels/pagerduty/pagerduty-channel.js +1 -1
  8. package/dist/channels/pagerduty/replay.d.ts +1 -1
  9. package/dist/channels/pagerduty/replay.js +4 -4
  10. package/dist/channels/slack/cli-project.js +1 -1
  11. package/dist/docs/404.html +2 -2
  12. package/dist/docs/assets/{app.DF9vlcdn.js → app.BzTUBOAD.js} +4 -4
  13. package/dist/docs/assets/building-with-agents.md.BqJ7AAjG.js +6 -0
  14. package/dist/docs/assets/{building-with-agents.md.Bf1yH2tG.lean.js → building-with-agents.md.BqJ7AAjG.lean.js} +1 -1
  15. package/dist/docs/assets/changelog.md.BWhC6DET.js +1 -0
  16. package/dist/docs/assets/changelog.md.BWhC6DET.lean.js +1 -0
  17. package/dist/docs/assets/chunks/@localSearchIndexroot.CWxwVoCG.js +1 -0
  18. package/dist/docs/assets/chunks/{VPLocalSearchBox.D8OuwKO0.js → VPLocalSearchBox.DsnRlUT5.js} +1 -1
  19. package/dist/docs/assets/chunks/{arc.DCq_TCYV.js → arc.DH8GOhiv.js} +1 -1
  20. package/dist/docs/assets/chunks/{architectureDiagram-Q4EWVU46.PWRNTPbk.js → architectureDiagram-Q4EWVU46.9m9ObyuE.js} +1 -1
  21. package/dist/docs/assets/chunks/{baseUniq.BeRPvRUL.js → baseUniq.BXHpx1lE.js} +1 -1
  22. package/dist/docs/assets/chunks/{blockDiagram-DXYQGD6D.BuRmZVSo.js → blockDiagram-DXYQGD6D.xY3EX59q.js} +1 -1
  23. package/dist/docs/assets/chunks/{c4Diagram-AHTNJAMY.7DKSMwuv.js → c4Diagram-AHTNJAMY.DnqgMVgc.js} +1 -1
  24. package/dist/docs/assets/chunks/channel.Cctv0f7X.js +1 -0
  25. package/dist/docs/assets/chunks/{chunk-4BX2VUAB.7VrO9-9i.js → chunk-4BX2VUAB.BjFxK2A3.js} +1 -1
  26. package/dist/docs/assets/chunks/{chunk-4TB4RGXK.CHystNE2.js → chunk-4TB4RGXK.BujS_Spt.js} +1 -1
  27. package/dist/docs/assets/chunks/{chunk-55IACEB6.Nuh9TbTq.js → chunk-55IACEB6.YbTjhdaM.js} +1 -1
  28. package/dist/docs/assets/chunks/{chunk-EDXVE4YY.CA0EKugm.js → chunk-EDXVE4YY.DnQ8t4GC.js} +1 -1
  29. package/dist/docs/assets/chunks/{chunk-FMBD7UC4.F9_mp7U8.js → chunk-FMBD7UC4.B67AwAmj.js} +1 -1
  30. package/dist/docs/assets/chunks/{chunk-OYMX7WX6.CEU4QfE1.js → chunk-OYMX7WX6.DrZIAFOm.js} +1 -1
  31. package/dist/docs/assets/chunks/{chunk-QZHKN3VN.B8h_x9_i.js → chunk-QZHKN3VN.BLmmydkn.js} +1 -1
  32. package/dist/docs/assets/chunks/{chunk-YZCP3GAM.Btfb-rKg.js → chunk-YZCP3GAM.DaoOfw0O.js} +1 -1
  33. package/dist/docs/assets/chunks/classDiagram-6PBFFD2Q.DU5sqchW.js +1 -0
  34. package/dist/docs/assets/chunks/classDiagram-v2-HSJHXN6E.DU5sqchW.js +1 -0
  35. package/dist/docs/assets/chunks/clone.B9rdNt6j.js +1 -0
  36. package/dist/docs/assets/chunks/{cose-bilkent-S5V4N54A.DKvc96Wa.js → cose-bilkent-S5V4N54A.DMQuNhM5.js} +1 -1
  37. package/dist/docs/assets/chunks/{dagre-KV5264BT.CMo0cy1b.js → dagre-KV5264BT.CZoGVuUf.js} +1 -1
  38. package/dist/docs/assets/chunks/{diagram-5BDNPKRD.DDgMOQhB.js → diagram-5BDNPKRD.CLt9uOyL.js} +1 -1
  39. package/dist/docs/assets/chunks/{diagram-G4DWMVQ6.BdJnoIsU.js → diagram-G4DWMVQ6.DpczEm1G.js} +1 -1
  40. package/dist/docs/assets/chunks/{diagram-MMDJMWI5.oSvhAZaL.js → diagram-MMDJMWI5.D4r13DvJ.js} +1 -1
  41. package/dist/docs/assets/chunks/{diagram-TYMM5635.C9zZLIE-.js → diagram-TYMM5635.CYU9eGFu.js} +1 -1
  42. package/dist/docs/assets/chunks/{erDiagram-SMLLAGMA.BNhVyccy.js → erDiagram-SMLLAGMA.QA9naWEw.js} +1 -1
  43. package/dist/docs/assets/chunks/{flowDiagram-DWJPFMVM.BEFLLBiU.js → flowDiagram-DWJPFMVM.BbNoVZYd.js} +1 -1
  44. package/dist/docs/assets/chunks/{ganttDiagram-T4ZO3ILL.BdUzXBgY.js → ganttDiagram-T4ZO3ILL.IHjDoG7r.js} +1 -1
  45. package/dist/docs/assets/chunks/{gitGraphDiagram-UUTBAWPF.Rd3LlOIJ.js → gitGraphDiagram-UUTBAWPF.B21VMdf5.js} +1 -1
  46. package/dist/docs/assets/chunks/{graph.DnJC1GpG.js → graph.DgJ4L-8V.js} +1 -1
  47. package/dist/docs/assets/chunks/{infoDiagram-42DDH7IO.xv0xntDJ.js → infoDiagram-42DDH7IO.CQjrcthc.js} +1 -1
  48. package/dist/docs/assets/chunks/{ishikawaDiagram-UXIWVN3A.BaGIlviU.js → ishikawaDiagram-UXIWVN3A.D4tPGtVo.js} +1 -1
  49. package/dist/docs/assets/chunks/{journeyDiagram-VCZTEJTY.Cof_h0fp.js → journeyDiagram-VCZTEJTY.BD3WaNbQ.js} +1 -1
  50. package/dist/docs/assets/chunks/{kanban-definition-6JOO6SKY.C5GozFuU.js → kanban-definition-6JOO6SKY.Ca0o4Tqz.js} +1 -1
  51. package/dist/docs/assets/chunks/{layout.zc9UShLc.js → layout.DXXqX4MQ.js} +1 -1
  52. package/dist/docs/assets/chunks/{linear.BoqrFVcJ.js → linear.5c61gNw4.js} +1 -1
  53. package/dist/docs/assets/chunks/{min.DwIfr8hG.js → min.B1-NAjHX.js} +1 -1
  54. package/dist/docs/assets/chunks/{mindmap-definition-QFDTVHPH.Dkq2yTtp.js → mindmap-definition-QFDTVHPH.BELznv3-.js} +1 -1
  55. package/dist/docs/assets/chunks/{pieDiagram-DEJITSTG.B4CpTmHK.js → pieDiagram-DEJITSTG.qPzO1mq5.js} +1 -1
  56. package/dist/docs/assets/chunks/{quadrantDiagram-34T5L4WZ.BqXnFC9C.js → quadrantDiagram-34T5L4WZ.CxIvzbjX.js} +1 -1
  57. package/dist/docs/assets/chunks/{requirementDiagram-MS252O5E.DhIN2z-E.js → requirementDiagram-MS252O5E.CqA0iJx8.js} +1 -1
  58. package/dist/docs/assets/chunks/{sankeyDiagram-XADWPNL6.BhxUAmg2.js → sankeyDiagram-XADWPNL6.XRTutBnb.js} +1 -1
  59. package/dist/docs/assets/chunks/{sequenceDiagram-FGHM5R23.BqgU7HU-.js → sequenceDiagram-FGHM5R23.E--7bRLQ.js} +1 -1
  60. package/dist/docs/assets/chunks/{stateDiagram-FHFEXIEX.B1BCO18N.js → stateDiagram-FHFEXIEX.C4vGu8zq.js} +1 -1
  61. package/dist/docs/assets/chunks/stateDiagram-v2-QKLJ7IA2.ECMu2BdJ.js +1 -0
  62. package/dist/docs/assets/chunks/{theme.oV7rddEz.js → theme.DMj_7q3B.js} +2 -2
  63. package/dist/docs/assets/chunks/{timeline-definition-GMOUNBTQ.oRI8UwMC.js → timeline-definition-GMOUNBTQ.C7LgNVAL.js} +1 -1
  64. package/dist/docs/assets/chunks/{vennDiagram-DHZGUBPP.DmuWrIxN.js → vennDiagram-DHZGUBPP.HUwoZcy_.js} +1 -1
  65. package/dist/docs/assets/chunks/{wardley-RL74JXVD.CEBjM5ov.js → wardley-RL74JXVD.BxFEFYZS.js} +1 -1
  66. package/dist/docs/assets/chunks/{wardleyDiagram-NUSXRM2D.m5zsCOF9.js → wardleyDiagram-NUSXRM2D.B2pSo5rB.js} +1 -1
  67. package/dist/docs/assets/chunks/{xychartDiagram-5P7HB3ND.cPN-587n.js → xychartDiagram-5P7HB3ND.NQhMiOOL.js} +1 -1
  68. package/dist/docs/assets/deployment.md.BtqJrHhp.js +31 -0
  69. package/dist/docs/assets/{deployment.md.DDmjAVbg.lean.js → deployment.md.BtqJrHhp.lean.js} +1 -1
  70. package/dist/docs/assets/evals.md.Dne6VRmZ.js +49 -0
  71. package/dist/docs/assets/evals.md.Dne6VRmZ.lean.js +1 -0
  72. package/dist/docs/assets/{guides_agent-to-agent.md.D1D5f6Jc.js → guides_agent-to-agent.md.BcmSqL2z.js} +8 -8
  73. package/dist/docs/assets/guides_agent-to-agent.md.BcmSqL2z.lean.js +1 -0
  74. package/dist/docs/assets/{guides_bitbucket.md.DkjkBRU8.js → guides_bitbucket.md.BiA6ZMFW.js} +27 -27
  75. package/dist/docs/assets/{guides_bitbucket.md.DkjkBRU8.lean.js → guides_bitbucket.md.BiA6ZMFW.lean.js} +1 -1
  76. package/dist/docs/assets/guides_cloud-agents.md.CiXAW6on.js +9 -0
  77. package/dist/docs/assets/{guides_cloud-agents.md.Ceyjv0ul.lean.js → guides_cloud-agents.md.CiXAW6on.lean.js} +1 -1
  78. package/dist/docs/assets/guides_convert-automation.md.BvTxsJ8J.js +26 -0
  79. package/dist/docs/assets/{guides_convert-automation.md.BjraCvok.lean.js → guides_convert-automation.md.BvTxsJ8J.lean.js} +1 -1
  80. package/dist/docs/assets/{guides_github.md.CgN5sNbW.js → guides_github.md.6jiEH7dg.js} +11 -19
  81. package/dist/docs/assets/{guides_github.md.CgN5sNbW.lean.js → guides_github.md.6jiEH7dg.lean.js} +1 -1
  82. package/dist/docs/assets/{guides_gitlab.md.DCE0p7_w.js → guides_gitlab.md.DcKusOcU.js} +63 -73
  83. package/dist/docs/assets/{guides_gitlab.md.DCE0p7_w.lean.js → guides_gitlab.md.DcKusOcU.lean.js} +1 -1
  84. package/dist/docs/assets/guides_improve.md.o3WOGR7n.js +16 -0
  85. package/dist/docs/assets/{guides_improve.md.BFYtrtLE.lean.js → guides_improve.md.o3WOGR7n.lean.js} +1 -1
  86. package/dist/docs/assets/{guides_jev.md.Ccw4pedT.js → guides_jev.md.DGCzkMUN.js} +20 -60
  87. package/dist/docs/assets/{guides_jev.md.Ccw4pedT.lean.js → guides_jev.md.DGCzkMUN.lean.js} +1 -1
  88. package/dist/docs/assets/{guides_mcp-oauth.md.ekpWOZCC.js → guides_mcp-oauth.md.C-Sx_IPa.js} +3 -5
  89. package/dist/docs/assets/{guides_mcp-oauth.md.ekpWOZCC.lean.js → guides_mcp-oauth.md.C-Sx_IPa.lean.js} +1 -1
  90. package/dist/docs/assets/guides_migrate.md.BbhHYeCr.js +3 -0
  91. package/dist/docs/assets/{guides_migrate.md.RS9Eu-Xh.lean.js → guides_migrate.md.BbhHYeCr.lean.js} +1 -1
  92. package/dist/docs/assets/guides_opentelemetry.md.BRSktBHt.js +26 -0
  93. package/dist/docs/assets/guides_opentelemetry.md.BRSktBHt.lean.js +1 -0
  94. package/dist/docs/assets/guides_pagerduty.md.pMXUkZZc.js +61 -0
  95. package/dist/docs/assets/guides_pagerduty.md.pMXUkZZc.lean.js +1 -0
  96. package/dist/docs/assets/guides_slack.md.BgIGG9ur.js +82 -0
  97. package/dist/docs/assets/{guides_slack.md.BqiGSYGX.lean.js → guides_slack.md.BgIGG9ur.lean.js} +1 -1
  98. package/dist/docs/assets/{guides_webhooks.md.BJk63ZTs.js → guides_webhooks.md.B5DXt2v1.js} +7 -7
  99. package/dist/docs/assets/{guides_webhooks.md.BJk63ZTs.lean.js → guides_webhooks.md.B5DXt2v1.lean.js} +1 -1
  100. package/dist/docs/assets/hillclimbing.md.3TkdF79A.js +5 -0
  101. package/dist/docs/assets/hillclimbing.md.3TkdF79A.lean.js +1 -0
  102. package/dist/docs/assets/index.md.DRfaoRCZ.js +20 -0
  103. package/dist/docs/assets/index.md.DRfaoRCZ.lean.js +1 -0
  104. package/dist/docs/assets/quickstart.md.r-oE8nkX.js +113 -0
  105. package/dist/docs/assets/{quickstart.md.DaLk4ZIF.lean.js → quickstart.md.r-oE8nkX.lean.js} +1 -1
  106. package/dist/docs/assets/reference_access.md.C5lblfUC.js +1 -0
  107. package/dist/docs/assets/{reference_access.md.CExlH_mR.lean.js → reference_access.md.C5lblfUC.lean.js} +1 -1
  108. package/dist/docs/assets/reference_agent-config.md.C0Tp_Fk9.js +27 -0
  109. package/dist/docs/assets/{reference_agent-config.md.11E_xe--.lean.js → reference_agent-config.md.C0Tp_Fk9.lean.js} +1 -1
  110. package/dist/docs/assets/reference_artifacts.md.BJpAI7h9.js +17 -0
  111. package/dist/docs/assets/{reference_artifacts.md.C-hKR2hp.lean.js → reference_artifacts.md.BJpAI7h9.lean.js} +1 -1
  112. package/dist/docs/assets/reference_channels.md.CPWOpdsC.js +21 -0
  113. package/dist/docs/assets/{reference_channels.md.DsJfGSBJ.lean.js → reference_channels.md.CPWOpdsC.lean.js} +1 -1
  114. package/dist/docs/assets/reference_cli.md.B8GdpaRj.js +83 -0
  115. package/dist/docs/assets/reference_cli.md.B8GdpaRj.lean.js +1 -0
  116. package/dist/docs/assets/reference_connections.md.DoY4vrDH.js +54 -0
  117. package/dist/docs/assets/{reference_connections.md.BoAotr7_.lean.js → reference_connections.md.DoY4vrDH.lean.js} +1 -1
  118. package/dist/docs/assets/reference_evals.md.DgfUtfIc.js +69 -0
  119. package/dist/docs/assets/{reference_evals.md.DYKjGFi-.lean.js → reference_evals.md.DgfUtfIc.lean.js} +1 -1
  120. package/dist/docs/assets/{reference_extensions.md.pEVj72Xo.js → reference_extensions.md.DHbW6eOf.js} +6 -8
  121. package/dist/docs/assets/{reference_extensions.md.pEVj72Xo.lean.js → reference_extensions.md.DHbW6eOf.lean.js} +1 -1
  122. package/dist/docs/assets/reference_hooks.md.CSWmOwMM.js +39 -0
  123. package/dist/docs/assets/reference_hooks.md.CSWmOwMM.lean.js +1 -0
  124. package/dist/docs/assets/reference_http-api.md.C7Cb0r2J.js +7 -0
  125. package/dist/docs/assets/{reference_http-api.md._RWELr3d.lean.js → reference_http-api.md.C7Cb0r2J.lean.js} +1 -1
  126. package/dist/docs/assets/reference_instructions.md.CV6Qq0UX.js +14 -0
  127. package/dist/docs/assets/reference_instructions.md.CV6Qq0UX.lean.js +1 -0
  128. package/dist/docs/assets/reference_limits.md.CbdtFr4T.js +8 -0
  129. package/dist/docs/assets/reference_limits.md.CbdtFr4T.lean.js +1 -0
  130. package/dist/docs/assets/reference_memory.md.CdoJISM-.js +3 -0
  131. package/dist/docs/assets/{reference_memory.md.Dd7cyV9V.lean.js → reference_memory.md.CdoJISM-.lean.js} +1 -1
  132. package/dist/docs/assets/reference_playground.md.DIUsRAcy.js +1 -0
  133. package/dist/docs/assets/{reference_playground.md.CQiJk9CM.lean.js → reference_playground.md.DIUsRAcy.lean.js} +1 -1
  134. package/dist/docs/assets/reference_project-layout.md.9DiKoE16.js +26 -0
  135. package/dist/docs/assets/reference_project-layout.md.9DiKoE16.lean.js +1 -0
  136. package/dist/docs/assets/reference_schedules.md.RhQ9ZLo1.js +45 -0
  137. package/dist/docs/assets/{reference_schedules.md.RC47aFm4.lean.js → reference_schedules.md.RhQ9ZLo1.lean.js} +1 -1
  138. package/dist/docs/assets/reference_sessions.md.NXVQt9mP.js +22 -0
  139. package/dist/docs/assets/{reference_sessions.md.C7KFhWXV.lean.js → reference_sessions.md.NXVQt9mP.lean.js} +1 -1
  140. package/dist/docs/assets/{reference_skills.md.Dej2zQxi.js → reference_skills.md.DzCPNPkG.js} +4 -4
  141. package/dist/docs/assets/{reference_skills.md.Dej2zQxi.lean.js → reference_skills.md.DzCPNPkG.lean.js} +1 -1
  142. package/dist/docs/assets/reference_subagents.md.Dvpq2sUu.js +10 -0
  143. package/dist/docs/assets/{reference_subagents.md.CAhvW4yS.lean.js → reference_subagents.md.Dvpq2sUu.lean.js} +1 -1
  144. package/dist/docs/assets/reference_tools.md.B2OaR1Nb.js +62 -0
  145. package/dist/docs/assets/{reference_tools.md.DQr7Fnhu.lean.js → reference_tools.md.B2OaR1Nb.lean.js} +1 -1
  146. package/dist/docs/assets/templates_agentic-owners.md.B6ZmKAzT.js +13 -0
  147. package/dist/docs/assets/{templates_agentic-owners.md.Dh2nDSqg.lean.js → templates_agentic-owners.md.B6ZmKAzT.lean.js} +1 -1
  148. package/dist/docs/assets/templates_reviews.md.dr9Xv_KM.js +10 -0
  149. package/dist/docs/assets/templates_reviews.md.dr9Xv_KM.lean.js +1 -0
  150. package/dist/docs/assets/troubleshooting.md.DfKKvW1R.js +3 -0
  151. package/dist/docs/assets/{troubleshooting.md.AGJ3jDzj.lean.js → troubleshooting.md.DfKKvW1R.lean.js} +1 -1
  152. package/dist/docs/building-with-agents.html +41 -44
  153. package/dist/docs/building-with-agents.md +11 -104
  154. package/dist/docs/changelog.html +37 -37
  155. package/dist/docs/changelog.md +5 -145
  156. package/dist/docs/deployment.html +54 -54
  157. package/dist/docs/deployment.md +86 -265
  158. package/dist/docs/evals.html +52 -71
  159. package/dist/docs/evals.md +33 -127
  160. package/dist/docs/guides/agent-to-agent.html +43 -43
  161. package/dist/docs/guides/agent-to-agent.md +27 -64
  162. package/dist/docs/guides/bitbucket.html +62 -62
  163. package/dist/docs/guides/bitbucket.md +73 -134
  164. package/dist/docs/guides/cloud-agents.html +37 -37
  165. package/dist/docs/guides/cloud-agents.md +23 -53
  166. package/dist/docs/guides/convert-automation.html +39 -56
  167. package/dist/docs/guides/convert-automation.md +31 -115
  168. package/dist/docs/guides/github.html +46 -54
  169. package/dist/docs/guides/github.md +49 -131
  170. package/dist/docs/guides/gitlab.html +98 -108
  171. package/dist/docs/guides/gitlab.md +104 -184
  172. package/dist/docs/guides/improve.html +38 -43
  173. package/dist/docs/guides/improve.md +24 -90
  174. package/dist/docs/guides/jev.html +55 -95
  175. package/dist/docs/guides/jev.md +57 -159
  176. package/dist/docs/guides/mcp-oauth.html +38 -40
  177. package/dist/docs/guides/mcp-oauth.md +34 -69
  178. package/dist/docs/guides/migrate.html +38 -43
  179. package/dist/docs/guides/migrate.md +56 -130
  180. package/dist/docs/guides/opentelemetry.html +41 -43
  181. package/dist/docs/guides/opentelemetry.md +32 -27
  182. package/dist/docs/guides/pagerduty.html +50 -49
  183. package/dist/docs/guides/pagerduty.md +65 -199
  184. package/dist/docs/guides/slack.html +51 -57
  185. package/dist/docs/guides/slack.md +76 -205
  186. package/dist/docs/guides/webhooks.html +42 -42
  187. package/dist/docs/guides/webhooks.md +64 -146
  188. package/dist/docs/hashmap.json +1 -1
  189. package/dist/docs/hillclimbing.html +40 -42
  190. package/dist/docs/hillclimbing.md +40 -102
  191. package/dist/docs/index.html +55 -62
  192. package/dist/docs/index.md +49 -82
  193. package/dist/docs/llms-full.txt +2292 -5830
  194. package/dist/docs/llms.txt +9 -15
  195. package/dist/docs/quickstart.html +96 -153
  196. package/dist/docs/quickstart.md +93 -178
  197. package/dist/docs/reference/access.html +36 -36
  198. package/dist/docs/reference/access.md +7 -12
  199. package/dist/docs/reference/agent-config.html +43 -56
  200. package/dist/docs/reference/agent-config.md +93 -176
  201. package/dist/docs/reference/artifacts.html +38 -39
  202. package/dist/docs/reference/artifacts.md +38 -62
  203. package/dist/docs/reference/channels.html +38 -39
  204. package/dist/docs/reference/channels.md +102 -151
  205. package/dist/docs/reference/cli.html +68 -84
  206. package/dist/docs/reference/cli.md +233 -698
  207. package/dist/docs/reference/connections.html +45 -57
  208. package/dist/docs/reference/connections.md +83 -164
  209. package/dist/docs/reference/evals.html +66 -53
  210. package/dist/docs/reference/evals.md +97 -128
  211. package/dist/docs/reference/extensions.html +41 -43
  212. package/dist/docs/reference/extensions.md +37 -70
  213. package/dist/docs/reference/hooks.html +40 -52
  214. package/dist/docs/reference/hooks.md +62 -133
  215. package/dist/docs/reference/http-api.html +38 -42
  216. package/dist/docs/reference/http-api.md +66 -118
  217. package/dist/docs/reference/instructions.html +39 -39
  218. package/dist/docs/reference/instructions.md +19 -29
  219. package/dist/docs/reference/limits.html +38 -38
  220. package/dist/docs/reference/limits.md +9 -21
  221. package/dist/docs/reference/memory.html +37 -38
  222. package/dist/docs/reference/memory.md +38 -75
  223. package/dist/docs/reference/playground.html +36 -36
  224. package/dist/docs/reference/playground.md +14 -22
  225. package/dist/docs/reference/project-layout.html +49 -48
  226. package/dist/docs/reference/project-layout.md +38 -84
  227. package/dist/docs/reference/schedules.html +46 -48
  228. package/dist/docs/reference/schedules.md +59 -90
  229. package/dist/docs/reference/sessions.html +37 -37
  230. package/dist/docs/reference/sessions.md +66 -113
  231. package/dist/docs/reference/skills.html +39 -39
  232. package/dist/docs/reference/skills.md +11 -31
  233. package/dist/docs/reference/subagents.html +37 -37
  234. package/dist/docs/reference/subagents.md +17 -31
  235. package/dist/docs/reference/tools.html +47 -64
  236. package/dist/docs/reference/tools.md +48 -130
  237. package/dist/docs/templates/agentic-owners.html +38 -38
  238. package/dist/docs/templates/agentic-owners.md +50 -74
  239. package/dist/docs/templates/reviews.html +69 -0
  240. package/dist/docs/templates/reviews.md +71 -0
  241. package/dist/docs/troubleshooting.html +38 -36
  242. package/dist/docs/troubleshooting.md +48 -101
  243. package/dist/evals.d.ts +2 -2
  244. package/dist/extensions/jev/extension.d.ts +12 -2
  245. package/dist/extensions/jev/extension.d.ts.map +1 -1
  246. package/dist/extensions/jev/extension.js +4 -0
  247. package/dist/extensions/jev/lib/evaluate.d.ts +31 -4
  248. package/dist/extensions/jev/lib/evaluate.d.ts.map +1 -1
  249. package/dist/extensions/jev/lib/evaluate.js +18 -4
  250. package/dist/internal/cli/command.d.ts +1 -1
  251. package/dist/internal/cli/command.js +1 -1
  252. package/dist/internal/cli/commands/channels.js +6 -6
  253. package/dist/internal/cli/commands/develop.d.ts.map +1 -1
  254. package/dist/internal/cli/commands/develop.js +23 -14
  255. package/dist/internal/cli/commands/hosted.js +4 -4
  256. package/dist/internal/cli/commands/index.d.ts +1 -1
  257. package/dist/internal/cli/commands/index.d.ts.map +1 -1
  258. package/dist/internal/cli/commands/index.js +1 -1
  259. package/dist/internal/cli/commands/mcp.js +1 -1
  260. package/dist/internal/cli/commands/project.js +4 -4
  261. package/dist/internal/cli/commands/scaffold.d.ts.map +1 -1
  262. package/dist/internal/cli/commands/scaffold.js +9 -6
  263. package/dist/internal/cli/commands/serve.d.ts +1 -1
  264. package/dist/internal/cli/commands/serve.js +5 -5
  265. package/dist/internal/cli/commands/session.d.ts.map +1 -1
  266. package/dist/internal/cli/commands/session.js +12 -7
  267. package/dist/internal/cli/dispatch.d.ts +3 -3
  268. package/dist/internal/cli/dispatch.js +3 -3
  269. package/dist/internal/cli/errors.d.ts +1 -1
  270. package/dist/internal/cli/errors.d.ts.map +1 -1
  271. package/dist/internal/cli/errors.js +1 -1
  272. package/dist/internal/cli/flags.d.ts +2 -2
  273. package/dist/internal/cli/flags.d.ts.map +1 -1
  274. package/dist/internal/cli/flags.js +2 -2
  275. package/dist/internal/cli/help-command.d.ts +1 -1
  276. package/dist/internal/cli/help-command.js +2 -2
  277. package/dist/internal/cli/help.d.ts +7 -7
  278. package/dist/internal/cli/help.d.ts.map +1 -1
  279. package/dist/internal/cli/help.js +8 -8
  280. package/dist/internal/cli-ax.d.ts.map +1 -1
  281. package/dist/internal/cli-ax.js +3 -0
  282. package/dist/internal/cli-convert-automation.d.ts +1 -1
  283. package/dist/internal/cli-convert-automation.js +1 -1
  284. package/dist/internal/cli-deploy.js +1 -1
  285. package/dist/internal/cli-docs.js +1 -1
  286. package/dist/internal/cli-images.js +1 -1
  287. package/dist/internal/cli-migrate.d.ts +1 -1
  288. package/dist/internal/cli-migrate.js +1 -1
  289. package/dist/internal/cli-pagerduty.d.ts +1 -1
  290. package/dist/internal/cli-pagerduty.js +1 -1
  291. package/dist/internal/cli-skills.js +1 -1
  292. package/dist/internal/convert-automation/types.d.ts +1 -1
  293. package/dist/internal/convert-automation/types.js +1 -1
  294. package/dist/internal/cursor/credentials.js +1 -1
  295. package/dist/internal/deploy-client.d.ts +2 -2
  296. package/dist/internal/deploy-client.d.ts.map +1 -1
  297. package/dist/internal/deploy-manifest.d.ts +1 -0
  298. package/dist/internal/deploy-manifest.d.ts.map +1 -1
  299. package/dist/internal/deploy-manifest.js +0 -1
  300. package/dist/internal/discovery/agent-config.d.ts +2 -6
  301. package/dist/internal/discovery/agent-config.d.ts.map +1 -1
  302. package/dist/internal/discovery/agent-config.js +8 -25
  303. package/dist/internal/discovery/agent.d.ts.map +1 -1
  304. package/dist/internal/discovery/agent.js +2 -3
  305. package/dist/internal/discovery/project.d.ts.map +1 -1
  306. package/dist/internal/discovery/project.js +15 -0
  307. package/dist/internal/init-project.d.ts +7 -3
  308. package/dist/internal/init-project.d.ts.map +1 -1
  309. package/dist/internal/init-project.js +60 -12
  310. package/dist/internal/init-scaffold.d.ts +2 -1
  311. package/dist/internal/init-scaffold.d.ts.map +1 -1
  312. package/dist/internal/init-scaffold.js +20 -7
  313. package/dist/internal/peer-connections.js +1 -1
  314. package/dist/internal/reminder-runner.js +1 -1
  315. package/dist/internal/server.d.ts +1 -1
  316. package/dist/internal/session-cost.d.ts +4 -4
  317. package/dist/internal/session-cost.d.ts.map +1 -1
  318. package/dist/internal/session-cost.js +4 -4
  319. package/dist/internal/session-engine.d.ts +1 -1
  320. package/dist/internal/session-engine.js +2 -2
  321. package/dist/internal/shallow-clone.js +1 -1
  322. package/dist/playground/assets/index-D6mVn9og.js +62 -0
  323. package/dist/playground/assets/index-DlALM6gr.css +1 -0
  324. package/dist/playground/index.html +2 -2
  325. package/dist/types.d.ts +9 -22
  326. package/dist/types.d.ts.map +1 -1
  327. package/docs/README.md +49 -82
  328. package/docs/building-with-agents.md +11 -104
  329. package/docs/changelog.md +6 -146
  330. package/docs/deployment.md +86 -265
  331. package/docs/evals.md +34 -128
  332. package/docs/guides/agent-to-agent.md +27 -64
  333. package/docs/guides/bitbucket.md +73 -134
  334. package/docs/guides/cloud-agents.md +23 -53
  335. package/docs/guides/convert-automation.md +31 -115
  336. package/docs/guides/github.md +49 -131
  337. package/docs/guides/gitlab.md +104 -184
  338. package/docs/guides/improve.md +24 -90
  339. package/docs/guides/jev.md +57 -159
  340. package/docs/guides/mcp-oauth.md +34 -69
  341. package/docs/guides/migrate.md +56 -130
  342. package/docs/guides/opentelemetry.md +37 -27
  343. package/docs/guides/pagerduty.md +68 -200
  344. package/docs/guides/slack.md +76 -205
  345. package/docs/guides/webhooks.md +64 -146
  346. package/docs/hillclimbing.md +41 -103
  347. package/docs/quickstart.md +93 -178
  348. package/docs/reference/access.md +7 -12
  349. package/docs/reference/agent-config.md +93 -176
  350. package/docs/reference/artifacts.md +38 -62
  351. package/docs/reference/channels.md +102 -151
  352. package/docs/reference/cli.md +233 -698
  353. package/docs/reference/connections.md +83 -164
  354. package/docs/reference/evals.md +97 -128
  355. package/docs/reference/extensions.md +37 -70
  356. package/docs/reference/hooks.md +61 -132
  357. package/docs/reference/http-api.md +66 -118
  358. package/docs/reference/instructions.md +20 -30
  359. package/docs/reference/limits.md +10 -22
  360. package/docs/reference/memory.md +38 -75
  361. package/docs/reference/playground.md +14 -22
  362. package/docs/reference/project-layout.md +38 -84
  363. package/docs/reference/schedules.md +59 -90
  364. package/docs/reference/sessions.md +66 -113
  365. package/docs/reference/skills.md +12 -32
  366. package/docs/reference/subagents.md +17 -31
  367. package/docs/reference/tools.md +48 -130
  368. package/docs/templates/agentic-owners.md +50 -74
  369. package/docs/templates/reviews.md +76 -0
  370. package/docs/troubleshooting.md +48 -101
  371. package/package.json +3 -9
  372. package/skills/cli/SKILL.md +15 -15
  373. package/skills/create-agent/SKILL.md +20 -19
  374. package/skills/debug/SKILL.md +4 -4
  375. package/skills/deploy/SKILL.md +2 -2
  376. package/skills/evals/SKILL.md +8 -8
  377. package/skills/framework-map/SKILL.md +3 -3
  378. package/skills/github/SKILL.md +7 -7
  379. package/skills/hillclimb/SKILL.md +4 -4
  380. package/skills/mcp-auth/SKILL.md +3 -3
  381. package/skills/migrate-v2/SKILL.md +40 -41
  382. package/skills/otel/SKILL.md +2 -2
  383. package/skills/setup-slack/SKILL.md +8 -8
  384. package/templates/agentic-owners/README.md +5 -5
  385. package/templates/agentic-owners/bot/tools/record_review.ts +1 -1
  386. package/templates/agentic-owners/package.json +1 -1
  387. package/templates/agents-md/README.md +4 -4
  388. package/templates/agents-md/package.json +1 -1
  389. package/templates/code-wiki/README.md +3 -3
  390. package/templates/code-wiki/package.json +1 -1
  391. package/templates/demo/README.md +3 -3
  392. package/templates/demo/package.json +1 -1
  393. package/templates/pr-autofixer/package.json +1 -1
  394. package/templates/security-help/README.md +5 -5
  395. package/templates/security-help/package.json +1 -1
  396. package/templates/security-reviewer/README.md +3 -3
  397. package/templates/security-reviewer/package.json +1 -1
  398. package/templates/thermo-quality-review/README.md +4 -4
  399. package/templates/thermo-quality-review/package.json +1 -1
  400. package/templates/thermo-review/README.md +4 -4
  401. package/templates/thermo-review/package.json +1 -1
  402. package/templates/triage/README.md +3 -3
  403. package/templates/triage/overlays/jira/README.md +3 -3
  404. package/templates/triage/overlays/linear/README.md +3 -3
  405. package/templates/triage/package.json +1 -1
  406. package/dist/docs/assets/building-with-agents.md.Bf1yH2tG.js +0 -9
  407. package/dist/docs/assets/changelog.md.fZ-NNFeJ.js +0 -1
  408. package/dist/docs/assets/changelog.md.fZ-NNFeJ.lean.js +0 -1
  409. package/dist/docs/assets/chunks/@localSearchIndexroot.mfzjiOsL.js +0 -1
  410. package/dist/docs/assets/chunks/channel.goFR5lbe.js +0 -1
  411. package/dist/docs/assets/chunks/classDiagram-6PBFFD2Q.B2yLtFja.js +0 -1
  412. package/dist/docs/assets/chunks/classDiagram-v2-HSJHXN6E.B2yLtFja.js +0 -1
  413. package/dist/docs/assets/chunks/clone.CztV97Wu.js +0 -1
  414. package/dist/docs/assets/chunks/stateDiagram-v2-QKLJ7IA2.CZlVHdDZ.js +0 -1
  415. package/dist/docs/assets/deployment.md.DDmjAVbg.js +0 -31
  416. package/dist/docs/assets/evals.md.OjKb7tNA.js +0 -68
  417. package/dist/docs/assets/evals.md.OjKb7tNA.lean.js +0 -1
  418. package/dist/docs/assets/guides_agent-to-agent.md.D1D5f6Jc.lean.js +0 -1
  419. package/dist/docs/assets/guides_cloud-agents.md.Ceyjv0ul.js +0 -9
  420. package/dist/docs/assets/guides_convert-automation.md.BjraCvok.js +0 -43
  421. package/dist/docs/assets/guides_grokbot-agents.md.D0PpM_Gf.js +0 -15
  422. package/dist/docs/assets/guides_grokbot-agents.md.D0PpM_Gf.lean.js +0 -1
  423. package/dist/docs/assets/guides_hooks.md.BjeEiM7s.js +0 -54
  424. package/dist/docs/assets/guides_hooks.md.BjeEiM7s.lean.js +0 -1
  425. package/dist/docs/assets/guides_improve.md.BFYtrtLE.js +0 -21
  426. package/dist/docs/assets/guides_migrate.md.RS9Eu-Xh.js +0 -8
  427. package/dist/docs/assets/guides_opentelemetry.md.CoZ1kNyd.js +0 -28
  428. package/dist/docs/assets/guides_opentelemetry.md.CoZ1kNyd.lean.js +0 -1
  429. package/dist/docs/assets/guides_pagerduty.md.mnKXe9U0.js +0 -60
  430. package/dist/docs/assets/guides_pagerduty.md.mnKXe9U0.lean.js +0 -1
  431. package/dist/docs/assets/guides_slack.md.BqiGSYGX.js +0 -88
  432. package/dist/docs/assets/hillclimbing.md.By61f3uq.js +0 -7
  433. package/dist/docs/assets/hillclimbing.md.By61f3uq.lean.js +0 -1
  434. package/dist/docs/assets/index.md.CVRjO09Y.js +0 -27
  435. package/dist/docs/assets/index.md.CVRjO09Y.lean.js +0 -1
  436. package/dist/docs/assets/quickstart.md.DaLk4ZIF.js +0 -170
  437. package/dist/docs/assets/reference_access.md.CExlH_mR.js +0 -1
  438. package/dist/docs/assets/reference_agent-config.md.11E_xe--.js +0 -40
  439. package/dist/docs/assets/reference_artifacts.md.C-hKR2hp.js +0 -18
  440. package/dist/docs/assets/reference_channels.md.DsJfGSBJ.js +0 -22
  441. package/dist/docs/assets/reference_cli.md.DQ3dCgmk.js +0 -99
  442. package/dist/docs/assets/reference_cli.md.DQ3dCgmk.lean.js +0 -1
  443. package/dist/docs/assets/reference_connections.md.BoAotr7_.js +0 -66
  444. package/dist/docs/assets/reference_evals.md.DYKjGFi-.js +0 -56
  445. package/dist/docs/assets/reference_hooks.md.B-bwJuiG.js +0 -51
  446. package/dist/docs/assets/reference_hooks.md.B-bwJuiG.lean.js +0 -1
  447. package/dist/docs/assets/reference_http-api.md._RWELr3d.js +0 -11
  448. package/dist/docs/assets/reference_instructions.md.yL2hXLnl.js +0 -14
  449. package/dist/docs/assets/reference_instructions.md.yL2hXLnl.lean.js +0 -1
  450. package/dist/docs/assets/reference_limits.md.Da1HegjB.js +0 -8
  451. package/dist/docs/assets/reference_limits.md.Da1HegjB.lean.js +0 -1
  452. package/dist/docs/assets/reference_memory.md.Dd7cyV9V.js +0 -4
  453. package/dist/docs/assets/reference_playground.md.CQiJk9CM.js +0 -1
  454. package/dist/docs/assets/reference_project-layout.md.BamcPDUn.js +0 -25
  455. package/dist/docs/assets/reference_project-layout.md.BamcPDUn.lean.js +0 -1
  456. package/dist/docs/assets/reference_prompt.md.BMjm1Jp3.js +0 -9
  457. package/dist/docs/assets/reference_prompt.md.BMjm1Jp3.lean.js +0 -1
  458. package/dist/docs/assets/reference_schedules.md.RC47aFm4.js +0 -47
  459. package/dist/docs/assets/reference_sessions.md.C7KFhWXV.js +0 -22
  460. package/dist/docs/assets/reference_subagents.md.CAhvW4yS.js +0 -10
  461. package/dist/docs/assets/reference_tools.md.DQr7Fnhu.js +0 -79
  462. package/dist/docs/assets/templates_agentic-owners.md.Dh2nDSqg.js +0 -13
  463. package/dist/docs/assets/templates_security-reviewer.md.DnwXdnB5.js +0 -3
  464. package/dist/docs/assets/templates_security-reviewer.md.DnwXdnB5.lean.js +0 -1
  465. package/dist/docs/assets/templates_thermo-quality-review.md.MJIdHkzE.js +0 -3
  466. package/dist/docs/assets/templates_thermo-quality-review.md.MJIdHkzE.lean.js +0 -1
  467. package/dist/docs/assets/templates_thermo-review.md.DfN1OFOl.js +0 -3
  468. package/dist/docs/assets/templates_thermo-review.md.DfN1OFOl.lean.js +0 -1
  469. package/dist/docs/assets/templates_triage.md.BYWMloV4.js +0 -9
  470. package/dist/docs/assets/templates_triage.md.BYWMloV4.lean.js +0 -1
  471. package/dist/docs/assets/troubleshooting.md.AGJ3jDzj.js +0 -1
  472. package/dist/docs/guides/grokbot-agents.html +0 -74
  473. package/dist/docs/guides/grokbot-agents.md +0 -129
  474. package/dist/docs/guides/hooks.html +0 -113
  475. package/dist/docs/guides/hooks.md +0 -116
  476. package/dist/docs/reference/prompt.html +0 -68
  477. package/dist/docs/reference/prompt.md +0 -47
  478. package/dist/docs/templates/security-reviewer.html +0 -62
  479. package/dist/docs/templates/security-reviewer.md +0 -81
  480. package/dist/docs/templates/thermo-quality-review.html +0 -62
  481. package/dist/docs/templates/thermo-quality-review.md +0 -75
  482. package/dist/docs/templates/thermo-review.html +0 -62
  483. package/dist/docs/templates/thermo-review.md +0 -75
  484. package/dist/docs/templates/triage.html +0 -68
  485. package/dist/docs/templates/triage.md +0 -101
  486. package/dist/extensions/cursor-grokbot-agents/extension.d.ts +0 -71
  487. package/dist/extensions/cursor-grokbot-agents/extension.d.ts.map +0 -1
  488. package/dist/extensions/cursor-grokbot-agents/extension.js +0 -64
  489. package/dist/extensions/cursor-grokbot-agents/lib/agents.d.ts +0 -11
  490. package/dist/extensions/cursor-grokbot-agents/lib/agents.d.ts.map +0 -1
  491. package/dist/extensions/cursor-grokbot-agents/lib/agents.js +0 -31
  492. package/dist/extensions/cursor-grokbot-agents/lib/backend.d.ts +0 -56
  493. package/dist/extensions/cursor-grokbot-agents/lib/backend.d.ts.map +0 -1
  494. package/dist/extensions/cursor-grokbot-agents/lib/backend.js +0 -139
  495. package/dist/extensions/cursor-grokbot-agents/lib/contacts.d.ts +0 -28
  496. package/dist/extensions/cursor-grokbot-agents/lib/contacts.d.ts.map +0 -1
  497. package/dist/extensions/cursor-grokbot-agents/lib/contacts.js +0 -46
  498. package/dist/extensions/cursor-grokbot-agents/lib/conversation.d.ts +0 -53
  499. package/dist/extensions/cursor-grokbot-agents/lib/conversation.d.ts.map +0 -1
  500. package/dist/extensions/cursor-grokbot-agents/lib/conversation.js +0 -186
  501. package/dist/extensions/cursor-grokbot-agents/lib/inputs.d.ts +0 -4
  502. package/dist/extensions/cursor-grokbot-agents/lib/inputs.d.ts.map +0 -1
  503. package/dist/extensions/cursor-grokbot-agents/lib/inputs.js +0 -15
  504. package/dist/extensions/cursor-grokbot-agents/lib/lock.d.ts +0 -12
  505. package/dist/extensions/cursor-grokbot-agents/lib/lock.d.ts.map +0 -1
  506. package/dist/extensions/cursor-grokbot-agents/lib/lock.js +0 -24
  507. package/dist/extensions/cursor-grokbot-agents/skills/consult.md +0 -40
  508. package/dist/extensions/cursor-grokbot-agents/tools/ask.d.ts +0 -4
  509. package/dist/extensions/cursor-grokbot-agents/tools/ask.d.ts.map +0 -1
  510. package/dist/extensions/cursor-grokbot-agents/tools/ask.js +0 -26
  511. package/dist/extensions/cursor-grokbot-agents/tools/check.d.ts +0 -4
  512. package/dist/extensions/cursor-grokbot-agents/tools/check.d.ts.map +0 -1
  513. package/dist/extensions/cursor-grokbot-agents/tools/check.js +0 -21
  514. package/dist/extensions/cursor-grokbot-agents/tools/interrupt.d.ts +0 -4
  515. package/dist/extensions/cursor-grokbot-agents/tools/interrupt.d.ts.map +0 -1
  516. package/dist/extensions/cursor-grokbot-agents/tools/interrupt.js +0 -13
  517. package/dist/extensions/cursor-grokbot-agents/tools/list.d.ts +0 -4
  518. package/dist/extensions/cursor-grokbot-agents/tools/list.d.ts.map +0 -1
  519. package/dist/extensions/cursor-grokbot-agents/tools/list.js +0 -22
  520. package/dist/playground/assets/index-BMpVzZzC.css +0 -1
  521. package/dist/playground/assets/index-_3zz3yh8.js +0 -62
  522. package/docs/guides/grokbot-agents.md +0 -134
  523. package/docs/guides/hooks.md +0 -121
  524. package/docs/reference/prompt.md +0 -52
  525. package/docs/templates/security-reviewer.md +0 -86
  526. package/docs/templates/thermo-quality-review.md +0 -80
  527. package/docs/templates/thermo-review.md +0 -80
  528. package/docs/templates/triage.md +0 -106
@@ -5,18 +5,14 @@ description: "Let an agent propose a change to its own source through a branch a
5
5
 
6
6
  # Self-improvement
7
7
 
8
- The `improve` extension teaches an agent how to turn "change how you
9
- work" into a source change. The agent prepares a brief, a Cursor cloud
10
- agent edits a checkout and opens a pull request, and the running agent
11
- reports the verified PR for human review.
12
-
13
- Durable behavior does not change until that source is merged and
14
- deployed.
8
+ The `improve` extension lets an agent turn "change how you work" into a change
9
+ to its own source. The agent writes a brief, a Cursor cloud agent edits a
10
+ checkout and opens a pull request, and the agent reports the pull request.
15
11
 
16
12
  ## Mount it
17
13
 
18
- Mount Cloud agents with the agent's own repository allowlisted, then
19
- mount `improve` with the source directory.
14
+ Mount [Cloud agents](./cloud-agents.md) with the agent's own repository in
15
+ `cloud.repos`, then mount `improve` with its source directory.
20
16
 
21
17
  ```ts
22
18
  // bot/extensions/cloud.ts
@@ -24,12 +20,7 @@ import cursorCloudAgents from "@grok/agent-sdk/extensions/cursor-cloud-agents";
24
20
 
25
21
  export default cursorCloudAgents({
26
22
  cloud: {
27
- repos: [
28
- {
29
- url: "https://github.com/acme/agents",
30
- startingRef: "main",
31
- },
32
- ],
23
+ repos: [{ url: "https://github.com/acme/agents", startingRef: "main" }],
33
24
  autoCreatePR: true,
34
25
  },
35
26
  });
@@ -46,89 +37,32 @@ export default improve({
46
37
  });
47
38
  ```
48
39
 
49
- Mounted as `improve`, the extension contributes the
50
- `improve__yourself` skill. It does not contribute a tool that can bypass
51
- the normal repository workflow.
52
-
53
- ## Ask for one behavioral change
54
-
55
- State the change, how to tell it worked, and what behavior must stay
56
- fixed. The agent maps the request to instructions, a skill, a tool,
57
- channel configuration, or the model setting before preparing the coding
58
- brief.
59
-
60
- > Improve yourself: stop opening incident replies with a summary.
61
- > Start with the decision, keep the existing evidence bullets, and
62
- > preserve every current eval.
63
-
64
- The success criterion and freeze line keep the cloud agent from turning
65
- a narrow behavior request into an unrelated refactor.
40
+ `improve` adds the `improve__yourself` skill and no tools.
66
41
 
67
- ## Follow the source change
42
+ ## Ask for one change
68
43
 
69
- The agent launches one cloud agent on the configured repository and
70
- ref. It reports the complete cloud-agent ID
71
- and URL immediately, then checks the same run instead of launching
72
- another agent for follow-up work.
44
+ Say what to change, how to tell it worked, and what must not change.
73
45
 
74
- When the cloud agent opens a pull request, the running agent reads the
75
- result and the PR before reporting what changed and which checks passed.
76
- The pull request, not the delegation transcript, is the durable
77
- deliverable.
46
+ > Improve yourself. Stop opening incident replies with a summary. Start with
47
+ > the decision, keep the existing evidence bullets, and preserve every current
48
+ > eval.
78
49
 
79
- Use the [Cloud agents guide](./cloud-agents.md) for launch, status,
80
- transcript, steering, and cancellation behavior.
50
+ The agent launches one cloud agent and reports its URL. When the pull request
51
+ opens, the agent tells you what changed and which checks passed.
81
52
 
82
53
  ## Review, merge, then deploy
83
54
 
84
- The workflow stops at a pull request. A human reviews the diff and
85
- decides whether to merge it; a separate deployment action decides when
86
- the new behavior becomes live.
87
-
88
- This separation gives each boundary a real control:
89
-
90
- - Repository permissions limit who can push the branch.
91
- - Branch protection and review policy govern the merge.
92
- - Deployment authorization governs the running agent.
93
-
94
- After deployment, repeat the original request or regression eval to
95
- confirm the behavior changed without crossing the freeze line.
55
+ The agent can open a pull request, but it can't merge or deploy. Someone on your
56
+ team reviews and merges it, and the change goes live on your next deploy.
57
+ Afterward, repeat the original request to confirm the change.
96
58
 
97
59
  ## Configure it
98
60
 
99
61
  - `repo` is the source repository URL.
100
- - `path` is the agent's repository-relative directory.
101
- - `ref` is the deployed branch or ref that new branches and pull
102
- requests target; it defaults to `main`.
103
- - `notes` adds tree-specific guidance to every coding brief, such as a
104
- required test command or PR convention.
105
- - `deploy` tells the skill who deploys a merged change and when it
106
- becomes live.
107
-
108
- `notes` and `deploy` insert prose into the contributed skill. They do
109
- not run checks, merge a branch, or trigger a deployment.
110
-
111
- Validation checks the URL and path shape. It does not prove the source
112
- exists, matches the current deployment, or appears in the Cloud agents
113
- repository allowlist, so keep those values aligned yourself.
114
-
115
- ## What the extension enforces
116
-
117
- `improve__yourself` is model guidance for locating the change, writing a
118
- brief, following repository rules, opening a PR, and reporting it. Rules
119
- such as "never merge" are instructions, not framework-enforced
120
- permissions.
121
-
122
- Use repository and deployment controls for hard enforcement. The
123
- extension provides a repeatable path through those controls; it does not
124
- replace them.
125
-
126
- ## What's next
127
-
128
- - [Cloud agents](./cloud-agents.md): delegation and steering
129
- - [Build with a coding agent](../building-with-agents.md): have an
130
- external coding agent edit the project directly
131
- - [Extensions](../reference/extensions.md): namespaces and overlays
132
- - [Deployment](../deployment.md): make a merged source change live
133
- - [Evals](../evals.md): protect the requested behavior before and after
134
- the change
62
+ - `path` is the agent's directory in that repository.
63
+ - `ref` is the branch new pull requests target, `main` by default.
64
+ - `notes` adds guidance to every brief, such as a required test command.
65
+ - `deploy` tells the skill who deploys a merged change and when.
66
+
67
+ Validation checks only the shape of `repo` and `path`, so make sure they match
68
+ the deployed agent and `cloud.repos`.
@@ -5,13 +5,17 @@ description: "Use typed Jev decisions to filter findings, route pull requests, a
5
5
 
6
6
  # Use Jev in review tools
7
7
 
8
- Use Jev when a review workflow needs a typed decision instead of prose.
9
- A review agent can filter speculative findings, classify pull request
10
- risk, choose a reviewer, or decide whether a merge needs a documentation
11
- follow-up. Jev returns a choice, score, or probability; your TypeScript
12
- decides what happens next.
8
+ > [!WARNING]
9
+ > Experimental. `@grok/agent-sdk/extensions/jev` is experimental. Its
10
+ > exports and behavior can change in any release, without a deprecation
11
+ > period.
13
12
 
14
- Set `TYPESAFE_API_KEY`. The default model is `jev-latest`.
13
+ Use Jev when a review workflow needs a typed decision instead of prose. Jev
14
+ returns a choice, a score, or a probability, and your TypeScript decides what
15
+ happens next.
16
+
17
+ Set `TYPESAFE_API_KEY`, then mount the extension. The default model is
18
+ `jev-latest`.
15
19
 
16
20
  ```ts
17
21
  // bot/extensions/jev.ts
@@ -20,21 +24,17 @@ import jev from "@grok/agent-sdk/extensions/jev";
20
24
  export default jev();
21
25
  ```
22
26
 
23
- On Cursor-managed hosting, this mount adds `api.typesafe.ai` to the
24
- deployment's egress allowlist and `TYPESAFE_API_KEY` to the secrets it
25
- expects, so `agent-sdk deploy` warns until you set the key. A project that
26
- imports `decide` or `evaluate` without mounting the extension has to
27
- list `api.typesafe.ai` in `hosting.egressDomains` itself; see
28
- [Add egress and secrets](../deployment.md#add-egress-and-secrets).
27
+ On Cursor hosting, the mount adds `api.typesafe.ai` to egress and
28
+ `TYPESAFE_API_KEY` to the expected secrets. Without the mount,
29
+ [add `api.typesafe.ai`](../deployment.md#add-egress-and-secrets) to
30
+ `hosting.egressDomains` yourself.
29
31
 
30
32
  ## Start only the review turns you need
31
33
 
32
- Call Jev from a channel hook before a model turn starts. When a pull
33
- request opens or becomes ready for review, this hook sends its title,
34
- body, labels, and filenames to Jev to decide whether the change needs
35
- security review. A result that clears the threshold starts the review
36
- turn; otherwise, the hook returns `null`, so the agent doesn't run or
37
- post to GitHub.
34
+ Call Jev from a channel hook before a model turn starts. This hook asks Jev
35
+ whether a new pull request needs security review, based on its title, body, and
36
+ file names. Below the threshold, the hook returns `null`, so the agent doesn't
37
+ run or post anything.
38
38
 
39
39
  ```ts
40
40
  // bot/channels/github.ts
@@ -45,7 +45,6 @@ import {
45
45
  import { above, decide } from "@grok/agent-sdk/extensions/jev";
46
46
 
47
47
  export default githubChannel({
48
- botName: "security-reviewer",
49
48
  cursorAccount: { repos: ["acme/checkout"] },
50
49
  onPullRequest: async (ctx, pr) => {
51
50
  if (pr.action !== "opened" && pr.action !== "ready_for_review") {
@@ -53,30 +52,21 @@ export default githubChannel({
53
52
  }
54
53
 
55
54
  const octokit = await ctx.github.getOctokit();
56
- const [{ data }, files] = await Promise.all([
57
- octokit.rest.pulls.get({
58
- owner: ctx.repository.owner,
59
- repo: ctx.repository.name,
60
- pull_number: pr.number,
61
- }),
62
- octokit.paginate(octokit.rest.pulls.listFiles, {
63
- owner: ctx.repository.owner,
64
- repo: ctx.repository.name,
65
- pull_number: pr.number,
66
- }),
67
- ]);
55
+ const files = await octokit.paginate(octokit.rest.pulls.listFiles, {
56
+ owner: ctx.repository.owner,
57
+ repo: ctx.repository.name,
58
+ pull_number: pr.number,
59
+ });
68
60
  const answers = await decide({
69
61
  state: {
70
- title: data.title,
71
- body: data.body,
72
- labels: data.labels.map(label => label.name),
62
+ title: pr.title,
63
+ body: pr.body,
73
64
  files: files.map(file => file.filename),
74
65
  },
75
66
  questions: {
76
67
  review: {
77
68
  type: "boolean",
78
- instructions:
79
- "Does this change need security review? Answer yes for auth, permissions, secrets, request parsing, or external inputs.",
69
+ instructions: "Does this change touch auth, permissions, secrets, or external input?",
80
70
  },
81
71
  },
82
72
  });
@@ -84,20 +74,15 @@ export default githubChannel({
84
74
  if (!above(answers.review, 0.8)) {
85
75
  return null;
86
76
  }
87
- // `auth` starts a model turn running as the pull request sender.
88
77
  return { auth: defaultGitHubAuth(ctx) };
89
78
  },
90
79
  });
91
80
  ```
92
81
 
93
- Jev receives only the pull request metadata shown here, not the diff.
94
-
95
82
  ## Filter findings before you post them
96
83
 
97
- Let the chat model draft a finding, then ask Jev whether the finding is
98
- a real bug in the new code. Below your threshold, the tool returns and
99
- the author never sees the draft. Above it, the finding becomes a review
100
- comment.
84
+ Let the model draft a finding, then ask Jev whether it's a real bug in the new
85
+ code. The tool posts only the drafts that clear your threshold.
101
86
 
102
87
  ```ts
103
88
  // bot/tools/post_finding.ts
@@ -107,14 +92,12 @@ import { defineTool } from "@grok/agent-sdk/tools";
107
92
  import { z } from "zod";
108
93
 
109
94
  export default defineTool({
110
- description:
111
- "Post one security finding on this session's pull request. Call once. Hold when it is not a real bug.",
95
+ description: "Post one security finding on this session's pull request.",
112
96
  inputSchema: z.object({
113
- title: z.string(),
114
- summary: z.string().describe("What the pull request changes."),
115
- draft: z.string().describe("The finding to post, one or two sentences."),
97
+ summary: z.string(),
98
+ draft: z.string().describe("The finding, in one or two sentences."),
116
99
  }),
117
- async execute({ title, summary, draft }, ctx) {
100
+ async execute({ summary, draft }, ctx) {
118
101
  if (ctx.session.purpose === "eval") {
119
102
  return { posted: false, reason: "eval" };
120
103
  }
@@ -125,12 +108,11 @@ export default defineTool({
125
108
  }
126
109
 
127
110
  const answers = await decide({
128
- state: { title, summary, draft },
111
+ state: { summary, draft },
129
112
  questions: {
130
113
  real: {
131
114
  type: "boolean",
132
- instructions:
133
- "Is the draft an exploitable bug in the new code, not a style note or a hypothetical?",
115
+ instructions: "Is the draft an exploitable bug in the new code?",
134
116
  },
135
117
  },
136
118
  });
@@ -147,19 +129,14 @@ export default defineTool({
147
129
  event: "COMMENT",
148
130
  body: draft,
149
131
  });
150
- return {
151
- posted: true,
152
- pr: `${ref.owner}/${ref.repo}#${ref.number}`,
153
- };
132
+ return { posted: true };
154
133
  },
155
134
  });
156
135
  ```
157
136
 
158
137
  ## Approve changes by risk tier
159
138
 
160
- You can use the same pattern for Agentic Owners. Ask Jev to put the
161
- pull request in a closed set of risk tiers. Approve only a confident
162
- `very-low` or `low`; send everything else to a person.
139
+ Ask Jev for one risk tier. Approve only a confident `very-low` or `low`.
163
140
 
164
141
  ```ts
165
142
  import { decide, needsHuman } from "@grok/agent-sdk/extensions/jev";
@@ -187,117 +164,38 @@ if (needsHuman(answers.risk) || tier === "medium" || tier === "high") {
187
164
  return { verdict: "approve", tier };
188
165
  ```
189
166
 
190
- Your GitHub tool resolves the pull request from `ctx.session` and posts
191
- that verdict. The model does not choose the repository, pull request, or
192
- approval event.
193
-
194
- ## Open documentation follow-ups selectively
195
-
196
- After a pull request merges, a code-wiki agent can ask whether the
197
- change introduced a durable fact that belongs in the docs. A low
198
- probability skips the follow-up, while a high probability opens a
199
- documentation pull request.
200
-
201
- ```ts
202
- import { above, decide } from "@grok/agent-sdk/extensions/jev";
203
- import { openDocsPullRequest } from "../lib/wiki";
204
-
205
- const answers = await decide({
206
- state: { title, summary },
207
- questions: {
208
- updateDocs: {
209
- type: "boolean",
210
- instructions:
211
- "Does this merge change a durable contract that the project docs should explain?",
212
- },
213
- },
214
- });
215
-
216
- if (!above(answers.updateDocs, 0.8)) {
217
- return { action: "skip" };
218
- }
219
- return openDocsPullRequest({ title, summary });
220
- ```
167
+ Your tool resolves the pull request from the session and posts that verdict, as the [Agentic Owners template](../templates/agentic-owners.md) does.
221
168
 
222
169
  ## Write tools with Jev
223
170
 
224
- Call `decide` from a channel hook, server tool, or router when you want
225
- the answer map directly. Use `evaluate` when you want `{ answers }`.
226
-
227
- Use a boolean for a yes-or-no gate, a choice for a closed set such as
228
- risk tiers or owners, and a score for an ordered rubric. `above` returns
229
- `true` when a boolean probability or score meets the threshold.
230
- `needsHuman` returns `true` when a boolean probability or the selected
231
- choice's probability falls below the confidence threshold.
171
+ Call `decide` to get the answer map, or `evaluate` to get `{ answers }`. Use a
172
+ boolean for a yes-or-no gate, a choice for a closed set such as risk tiers, and
173
+ a score for an ordered rubric. `above` returns `true` when a probability or
174
+ score meets your threshold. `needsHuman` returns `true` when the answer's
175
+ confidence falls below `0.7` by default. Calibrate both on pull requests you've
176
+ already labeled.
232
177
 
233
- Keep the questions atomic and combine them in TypeScript. For example,
234
- ask separately whether a finding is real, whether its impact is
235
- user-visible, and whether the changed line is new. Your code owns the
236
- rule that decides whether all three are enough to post.
178
+ Ask Jev one question per call, and write the rule that combines the answers in
179
+ your own code.
237
180
 
238
181
  ## Let the agent ask Jev
239
182
 
240
- Mounting the extension adds a read-only harness tool named
241
- `<namespace>__evaluate`. With the `bot/extensions/jev.ts` mount shown
242
- earlier, the model sees `jev__evaluate`.
243
-
244
- The tool accepts one state and a list of boolean, choice, or score
245
- questions. It returns `{ answers }` and never posts, approves, or opens
246
- a pull request. Use it when the agent needs the result during the turn.
247
- Use `decide` inside a project tool when the answer and the write belong
248
- in one operation.
249
-
250
- ## Skills included with the extension
251
-
252
- The extension adds two skills by default:
253
-
254
- - `jev__questions` teaches the model how to structure atomic questions,
255
- choose a question type, and read the answers.
256
-
257
- - `jev__gated-write` teaches the model to put `decide` and the write in
258
- one server tool, hold on low confidence, and skip writes during evals.
259
-
260
- The model sees each skill's description and loads the full procedure
261
- when it applies.
183
+ The mount also gives the model a read-only tool named `<namespace>__evaluate`,
184
+ which is `jev__evaluate` with the mount shown earlier. The model can call it
185
+ during a turn, and it never posts or approves anything. When the answer and the
186
+ write belong together, call `decide` inside a project tool instead.
262
187
 
263
188
  ## Choose what to mount
264
189
 
265
- Both contribution groups are on by default. Turn off the harness tool
266
- when Jev should only run inside tools you wrote. Turn off the skills
267
- when your agent already has its own Jev instructions.
190
+ Mounting Jev also adds two skills. `jev__questions` teaches the model to write
191
+ atomic questions and read the answers, and `jev__gated-write` teaches it to put
192
+ `decide` and the write in one server tool. Set `harnessTools: false` to keep Jev
193
+ inside your own tools, or `skills: false` if your agent has its own Jev
194
+ instructions.
268
195
 
269
196
  ```ts
270
- // bot/extensions/jev.ts
271
- import jev from "@grok/agent-sdk/extensions/jev";
272
-
273
- export default jev({
274
- harnessTools: false,
275
- skills: true,
276
- });
197
+ export default jev({ harnessTools: false, skills: true });
277
198
  ```
278
199
 
279
- `harnessTools: false` removes `jev__evaluate` from discovery.
280
- `skills: false` removes both Jev skills. These switches do not remove
281
- the exported helpers, so project tools can still import `decide`,
282
- `above`, and `needsHuman`.
283
-
284
- ## Practices
285
-
286
- - Pass the pull request title, a short summary, and the draft finding.
287
- Don't send the checkout.
288
-
289
- - Calibrate `above` and `needsHuman` on pull requests you have already
290
- labeled. `needsHuman` defaults to `0.7`.
291
-
292
- ## Related
293
-
294
- - [Agentic owners](../templates/agentic-owners.md): a risk tier, then
295
- the host approves or asks for reviewers
296
- - [Security reviewer](../templates/security-reviewer.md): a finding, or
297
- no comment
298
- - [Thermo review](../templates/thermo-review.md): bugs and breakage,
299
- posted the same way
300
- - [Code wiki](../reference/cli.md#init): documentation
301
- follow-ups after a merge
302
- - [Evals](../evals.md): checks on the full turn
303
- - [GitHub agents](./github.md): how the review gets onto the pull request
200
+ Neither switch removes the exported helpers, so project tools can still import
201
+ `decide`, `above`, and `needsHuman`.
@@ -5,16 +5,12 @@ description: "Authorize a private MCP server locally, constrain its tools, and c
5
5
 
6
6
  # Connect a private MCP server with OAuth
7
7
 
8
- Host MCP OAuth lets an Agent SDK process authorize a remote MCP server
9
- without putting tokens in the agent's source or workspace. Use it when
10
- the server speaks OAuth and its credentials should belong to the serve
11
- host instead of a person's Cursor account.
8
+ Host MCP OAuth lets the machine running your agent authorize a remote
9
+ MCP server without putting tokens in your source or workspace.
12
10
 
13
11
  ## Use a private MCP tool locally
14
12
 
15
- Declare the remote server, authorize it once in the browser, and start
16
- the agent. The next local turn can call the server's named tools with
17
- the credentials stored on that host.
13
+ Declare the server and authorize it once in the browser.
18
14
 
19
15
  ```ts
20
16
  // bot/mcp-connections/inventory.ts
@@ -27,47 +23,37 @@ export default defineConnection({
27
23
  });
28
24
  ```
29
25
 
30
- ```text
26
+ ```bash
31
27
  agent-sdk mcp oauth inventory
32
- agent-sdk run --dir . \
33
- --message "Which east-coast warehouse has SKU-142 in stock?"
34
28
  ```
35
29
 
36
- The filename is the connection name used by the CLI and
37
- `ctx.host.mcp`. Changing the server URL invalidates its saved
38
- authorization, so run `mcp oauth` again after moving the endpoint.
30
+ The filename is the connection name. If you change the server URL, run
31
+ `mcp oauth` again.
39
32
 
40
33
  ## Connect on first use
41
34
 
42
- You can also let the first unauthenticated call ask for authorization.
43
- The turn parks and the playground shows **Connect**. Finish the browser
44
- flow, return to the playground, and confirm **Connected**; the same call
45
- retries and the turn continues without restarting the agent.
46
-
47
- ```text
48
- agent-sdk serve --dir . --dev
49
- ```
50
-
51
- Connect authorizes the process that is running now.
35
+ Without a prior `mcp oauth`, the first call to the server pauses the
36
+ turn, and the playground shows **Connect**. Finish the browser flow,
37
+ and the call retries in the running process.
52
38
 
53
39
  A turn waits for Connect only when a person can click it:
54
40
 
55
41
  - A playground or HTTP chat turn.
56
- - A Slack message, when the channel shows Connect. `slackChannel({ toolApprovals: true })` shows
57
- Connect, and so does `buildToolApprovalEvents` in `events`.
42
+ - A Slack message, when the channel shows Connect through
43
+ `slackChannel({ toolApprovals: true })` or `buildToolApprovalEvents`
44
+ in `events`.
58
45
 
59
- The wait stops after 10 minutes, or when the turn is interrupted. Other
60
- turns do not wait. These are schedules, reminders, webhooks, evals, and
61
- Slack channels without Connect. A required connection fails the call with
62
- `Reconnect <connection>`. An `optional` connection is skipped, also in the
63
- playground. Authorize those connections ahead of time with `mcp oauth`.
46
+ The wait stops after 10 minutes or when the turn is interrupted.
47
+ Schedules, reminders, webhooks, evals, and Slack channels without
48
+ Connect don't wait. A required connection fails the call with
49
+ `Reconnect <connection>`, and an `optional` one is skipped, even in the
50
+ playground. Authorize those ahead of time with `mcp oauth`.
64
51
 
65
52
  ## Keep privileged tools behind a wrapper
66
53
 
67
- Put a connection under `bot/host-connections/` when the model should
68
- not receive the MCP server's tools directly. A server tool can expose
69
- one constrained operation while `ctx.host.mcp` keeps the broader server
70
- on the host.
54
+ The model never sees a connection under `bot/host-connections/`. A
55
+ server tool reaches it through `ctx.host.mcp` and exposes one narrow
56
+ operation.
71
57
 
72
58
  ```ts
73
59
  // bot/host-connections/inventory.ts
@@ -105,49 +91,28 @@ export default defineTool({
105
91
  });
106
92
  ```
107
93
 
108
- The model sees `get_stock`, not the unrestricted inventory server.
109
- Use this shape when code should own an allowlist or another side-effect
110
- gate.
111
-
112
94
  ## Use an OAuth server from a hosted agent
113
95
 
114
- Tokens from `mcp oauth` stay in the CLI config directory of the machine
115
- that authorized them, so a hosted deployment doesn't receive them. For a
116
- Cursor-managed agent, add the server under MCP in the Cursor dashboard,
96
+ Tokens from `mcp oauth` stay on the machine that authorized them. For a
97
+ Cursor-hosted agent, add the server under MCP in the Cursor dashboard,
117
98
  reach it through a
118
99
  [`cursorAccount: true` connection](../reference/connections.md#cursor-account-mcp-connection),
119
- and connect it from **Deployed Agents** in the
120
- [dashboard](https://cursor.com/dashboard).
121
-
122
- Anyone able to use that agent can reach the MCP capabilities you
123
- expose, so narrow the connection's `servers` list and keep privileged
124
- operations behind a host-side wrapper.
100
+ and connect it from [Deployed Agents](https://cursor.com/dashboard/deployed-agents).
101
+ Anyone who can use the agent can use that connection, so narrow its
102
+ `servers` list.
125
103
 
126
104
  ## Choose where credentials live
127
105
 
128
- Use the credential shape that matches who should own access:
129
-
130
- - Choose `cursorAccount: true` for connectors already authorized under
131
- MCP in the Cursor dashboard. Their tokens stay on the Cursor backend.
132
-
133
- - Choose `url` with `oauth: true` when the machine running `agent-sdk serve`
134
- should hold OAuth credentials.
135
-
136
- - Choose `url` with static `headers` when the server uses an API key or
137
- bearer token instead of OAuth.
106
+ | Connection | Credentials live in | Use it when |
107
+ | --- | --- | --- |
108
+ | `cursorAccount: true` | Cursor's backend | You connected the server in the Cursor dashboard |
109
+ | `url` with `oauth: true` | The serve host | The serve host should own access |
110
+ | `url` with `headers` | Your secrets | The server takes an API key or bearer token |
138
111
 
139
- Host OAuth and per-session `auth` are different identity models and
140
- cannot be combined on one connection. Use per-session auth when each
141
- caller needs a different downstream identity.
112
+ Host OAuth can't share a connection with per-session `auth`, which
113
+ gives each caller its own downstream identity.
142
114
 
143
115
  ## Related
144
116
 
145
- - [`skills/mcp-auth/SKILL.md`](../../skills/mcp-auth/SKILL.md): the
146
- companion setup procedure for coding agents
147
- - [MCP connections](../reference/connections.md): transports, account
148
- connectors, per-session auth, and tool filtering
149
- - [CLI reference](../reference/cli.md#mcp-oauth): OAuth command flags
150
- and browser callback behavior
151
- - [Deployment](../deployment.md): hosted egress and secrets
152
- - [Troubleshooting](../troubleshooting.md): authorization symptoms and
153
- remedies
117
+ - Follow the `bdk-mcp-auth` skill, then run `agent-sdk mcp oauth <connection>`.
118
+ - [MCP connections](../reference/connections.md)