@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
@@ -10,147 +10,94 @@ Start with three checks:
10
10
  1. Run `agent-sdk validate --dir .`.
11
11
  2. Confirm the expected agent and connections in
12
12
  `agent-sdk info --dir . --json`.
13
- 3. Reproduce once, then inspect the serve log or session trace.
13
+ 3. Reproduce the problem once, then read the serve log or the
14
+ [session trace](#read-the-session-trace).
14
15
 
15
- Match the visible symptom below.
16
-
17
- ## Serve or the playground will not work
18
-
19
- | What you see | What to do |
20
- | --- | --- |
21
- | `serve` exits before listening | Fix the errors from `agent-sdk validate --dir .`, then start it again. |
22
- | Playground is blank or says there are no agents | Start `agent-sdk serve`; built playground assets have no agent data without the server. |
23
- | Agent-file edits do not appear | Open the URL printed by `serve --dev`, then press Enter in its TTY to reload after file changes. |
24
- | Sessions exist but the list is empty | The list is scoped to the authenticated principal. Use the same identity that created the session; a `?sessionId=` deep link does not bypass authorization. |
25
- | The preferred port is busy | Use the next port printed by the CLI, pass `--port <number>`, or pass `--port 0` for any free port. |
26
-
27
- ## A model turn fails
16
+ ## Serve or the playground won't work
28
17
 
29
18
  | What you see | What to do |
30
19
  | --- | --- |
31
- | File reads and greps fail repeatedly with `NGHTTP2_FRAME_SIZE_ERROR` | Run the agent under Node 22.13 or newer, never Bun. |
32
- | `Semantic search has been removed. Use Grep.` | Delete `search` from a custom `fs`, drop `SearchQuery` and `SearchResult`, and remove `SemanticSearch` or `semSearch` from `tools` and `bot/tools/`. See [Migrate off semantic search](./reference/agent-config.md#migrate-off-semantic-search). |
33
- | The turn immediately reports a missing API key | Set `CURSOR_API_KEY`, `CURSOR_API_KEY_FILE`, or `CURSOR_SERVICE_ACCOUNT_KEY`, or run `agent-sdk login`. |
34
- | Login succeeds but the model host rejects the key | Point login and model traffic at the same API host; check `CURSOR_API_BASE_URL` and `CURSOR_BACKEND_URL`. |
35
- | The first turn reports `[resource_exhausted]` | Treat it as a capacity-shaped error. For a GitHub wake, also check the connected GitHub credential and any GitHub `429` rate limit before assuming the model quota is exhausted. |
20
+ | The playground is blank or lists no agents | Start `agent-sdk serve`, because the playground gets its agents from the server. |
21
+ | Agent-file edits don't appear | Open the URL that `serve --dev` prints, and press Enter in its terminal to reload. |
22
+ | Sessions exist but the list is empty | The list shows only your own sessions, so use the identity that created them. |
36
23
 
37
- ## A turn behaves unexpectedly
24
+ ## A turn fails or misbehaves
38
25
 
39
26
  | What you see | What to do |
40
27
  | --- | --- |
41
- | Replies quote an ancestor `AGENTS.md` or unrelated repository rules | Inspect `local.cwd` in `/v1/info`. Set `defineAgent({ local: { cwd } })` or the session workspace explicitly instead of inheriting the parent checkout. |
42
- | The model lists IDE meta-tools but never calls named MCP tools | Set `advertiseTools: true` on the local model-visible connection and confirm it under `connections` in `/v1/info`. |
43
- | Server tools, skills, or seed files are absent | Check the discovered project in `/v1/info`; follow the capability warning from `validate`. |
44
- | `validate` and `run` pass but CI type-checking fails | Run the project type check. Tool results must be JSON-shaped; prefer object literals or `type` aliases over `interface` return types. |
28
+ | Reads and greps keep failing with `NGHTTP2_FRAME_SIZE_ERROR` | Run the agent under Node 22.13 or newer, never Bun. |
29
+ | `Semantic search has been removed. Use Grep.` | Delete `search` from a custom `fs`, drop `SearchQuery` and `SearchResult`, and remove `SemanticSearch` or `semSearch` from `tools` and `bot/tools/`. |
30
+ | The turn reports a missing API key | Set `CURSOR_API_KEY`, `CURSOR_API_KEY_FILE`, or `CURSOR_SERVICE_ACCOUNT_KEY`, or run `agent-sdk login`. |
31
+ | Login works but the model host rejects the key | Point `CURSOR_API_BASE_URL` and `CURSOR_BACKEND_URL` at the same API host. |
32
+ | The first turn reports `[resource_exhausted]` | The model is usually out of capacity. If a GitHub event started the turn, check for a GitHub `429` rate-limit response first. |
33
+ | Replies quote an ancestor `AGENTS.md` or unrelated repository rules | Set `defineAgent({ local: { cwd } })` so the agent doesn't inherit the parent checkout. `/v1/info` shows the current `local.cwd`. |
34
+ | The model lists IDE meta-tools but never calls named MCP tools | Set `advertiseTools: true` on the local connection. |
35
+ | Server tools, skills, or seed files are missing | Check the discovered project in `/v1/info`, and follow the warning from `validate`. |
36
+ | `validate` and `run` pass but CI type-checking fails | Return JSON-shaped tool results, such as object literals or `type` aliases, instead of `interface` types. |
45
37
 
46
38
  ## HTTP returns 401, 403, or 409
47
39
 
48
40
  | What you see | What to do |
49
41
  | --- | --- |
50
- | `401` outside local development | Send the configured bearer token, alias token, or channel credential. Default custom routes admit direct loopback only. |
51
- | `403` on a stream or follow-up | Use the same authenticated principal that created the session. |
52
- | A custom channel route fails through a tunnel or LAN | Protect the shared host with `--bearer-token` or authored channel auth. Use `--allow-anonymous` only behind a proxy that authenticates every caller. |
53
- | `409` on a follow-up | Refresh the rotating `continuationToken` and confirm the target is a chat session; task sessions do not accept follow-ups. |
54
- | `409 session_busy` from `call --session` | Wait for the turn, omit `--session`, or mark a read-only tool with `effect: "read"` so it can run concurrently. |
55
- | A custom route fails schema type-checking | Add the required Zod `querySchema` for `GET`, or `bodySchema` for `POST`, `PUT`, and `PATCH`. See [Channels](./reference/channels.md). |
42
+ | `401` outside local development | Send the bearer token, alias token, or channel credential. Default custom routes accept only direct loopback calls. |
43
+ | `403` on a stream or follow-up | Use the identity that created the session. |
44
+ | A custom route fails through a tunnel or LAN | Protect the host with `--bearer-token` or channel auth. Use `--allow-anonymous` only behind a proxy that authenticates every caller. |
45
+ | `409` on a follow-up | Refresh the rotating `continuationToken`. Task sessions don't accept follow-ups. |
46
+ | `409 session_busy` from `call --session` | Wait for the turn, omit `--session`, or mark a read-only tool `effect: "read"` so it can run alongside the turn. |
56
47
 
57
48
  ## A hosted deployment fails or looks stale
58
49
 
59
50
  | What you see | What to do |
60
51
  | --- | --- |
61
- | `validate` or `deploy` reports `architecture "v2" requires a named secret` | A `githubChannel` credential or a GitLab or Bitbucket `webhookSecret` is a literal or a getter. Replace it with the quoted `{ secretName: "NAME" }` and set the value with `agent-sdk secret set <slug> NAME`. See [Other hosts](./guides/github.md#other-hosts). |
62
- | Local changes do not appear after deploy | `deploy` reads a pushed Git ref, not the working tree. Commit and push the intended ref, then deploy it again. |
63
- | The deployment never becomes running | Run `agent-sdk deployment get <slug>`, then act on the reported build or startup error. |
64
- | A secret or egress change has no effect | Confirm the name with `secret list`, verify the `hosting` block exists on the pushed ref, and follow the CLI or [Deployed Agents](https://cursor.com/dashboard/deployed-agents) prompt to redeploy. |
65
- | `agent-sdk deploy` blocked by team egress policy | Add the named hosts to the team egress list, or remove them from `hosting.egressDomains`, then run `agent-sdk deploy` again. The bot that is running now keeps its last deployed policy. |
66
- | Cursor events stopped after redeploy | Each redeploy replaces the watched repositories. Pass every `--cursor-events-repo` value again; without the flag, the deployment watches only its GitHub source repository. |
67
- | `session create` prints a `deliveryId` but no `sessionId` | Expected without `--wait`: the session is created when the turn starts. Pass `--wait`, or find it with `agent-sdk logs --prod --once --slug <slug>`, then follow [Verify a hosted turn](./deployment.md#verify-a-hosted-turn). |
68
- | `session get <sessionId> --prod` shows a `running` run with no logs | Runs lag behind events, and a high-effort turn can take several minutes. Rerun the command; a growing event count means the turn is still working. |
69
- | A [Deployed Agents](https://cursor.com/dashboard/deployed-agents) link to a single session doesn't open | Check the session with `agent-sdk session get <sessionId> --prod --slug <slug>`. |
70
- | `chat`, `tool call`, `skill`, `session get --view cost`, or `mcp` with `--prod` exits with a usage error | Hosted deployments take `--prod` only on `session list`, `session get`, and `logs`; `session create` is always hosted. See [Verify a hosted turn](./deployment.md#verify-a-hosted-turn). |
71
- | `session create --session <sessionId>` reports the session belongs to another channel | `--session` continues only sessions that `session create` started. Reach Slack, SCM, and custom-route sessions through their own channel. |
72
- | A custom route returns `202` with no body | Expected on managed hosting. The handler runs after the response, so deliver results from the channel. See [Route responses](./reference/channels.md#route-responses). |
73
- | External HTTP rejects the alias token | Update the caller with the current token. If the token is lost or exposed, run `agent-sdk deployment rotate-token <slug>` and replace it everywhere. |
74
- | `deploy`, a hosted session, or an eval run says it is not available with Privacy Mode (Legacy) | Switch to Privacy Mode, or ask a team admin if your team enforces this setting. A refused session does not store the message. See [Privacy Mode](./deployment.md#privacy-mode). |
75
- | `deploy` says persistent deployments are limited to 1 per team | Another deployment of the team already sets `persistent: true`. Remove the setting from one agent, or delete that deployment. |
76
- | A schedule does not fire on the hosted deployment | Make sure the deployment is running and its release has the schedule. Deploy again with `@grok/agent-sdk` 0.2.14 or newer. |
77
- | A request to a custom route gets `429` | The deployment received more requests than its limit. Wait for the time in `Retry-After`, then send the request again. |
78
-
79
- See [Deployment](./deployment.md) for source, credential, and
80
- redeployment boundaries.
52
+ | `validate` or `deploy` reports `architecture "v2" requires a named secret` | Replace the literal or getter with a [named secret](./deployment.md#add-egress-and-secrets), and set its value with `agent-sdk secret set <slug> NAME`. |
53
+ | Local changes don't appear after deploy | `deploy` builds the pushed ref, so commit and push your changes, then deploy again. |
54
+ | The deployment never reaches `running` | Run `agent-sdk deployment get <slug>`, and fix the error it reports. |
55
+ | A secret or egress change has no effect | Confirm the name with `secret list`, check that the `hosting` block is on the pushed ref, and redeploy. |
56
+ | A hosted schedule doesn't fire | Check that the deployment is running and that the schedule is in `bot/schedules/` on the deployed ref. |
57
+ | A custom route returns `429` | Wait for the time in `Retry-After`, then send it again. |
81
58
 
82
59
  ## GitHub deliveries fail
83
60
 
84
61
  | What you see | What to do |
85
62
  | --- | --- |
86
- | `github forward` returns 401 on every delivery after creating the hook | Clear `GITHUB_TOKEN` and `GH_TOKEN` for that command so the forwarder uses the `gh` CLI login: `GITHUB_TOKEN= GH_TOKEN= agent-sdk github forward ...`. |
87
- | `Hook already exists` | Run one forwarder for the repository and stop the stale process. |
88
- | Direct webhook deliveries are rejected outside `--dev` | Configure the same `GITHUB_WEBHOOK_SECRET` on the signer and server. Cursor event pull needs no public webhook or webhook secret. |
89
- | You cannot create a forwarder | Use `agent-sdk github replay <pr-url>`; it needs pull access instead of repository administration. |
63
+ | `github forward` gets `401` on every delivery | Clear the token variables so the forwarder uses your `gh` login, as in `GITHUB_TOKEN= GH_TOKEN= agent-sdk github forward`. |
64
+ | `Hook already exists` | Stop the stale forwarder. GitHub allows one per repository. |
65
+ | Direct webhooks are rejected outside `--dev` | Set the same `GITHUB_WEBHOOK_SECRET` on the signer and the server. |
66
+ | You can't create a forwarder | Use `agent-sdk github replay <pr-url>`, which needs only pull access. |
90
67
 
91
- The [GitHub guide](./guides/github.md) covers event pull, replay, and
92
- direct webhooks.
93
-
94
- ## Slack does not respond
68
+ ## Slack doesn't respond
95
69
 
96
70
  | What you see | What to do |
97
71
  | --- | --- |
98
- | Logs say `channel idle ... missing credentials` | Run `agent-sdk slack create --dir <agent>`, then check the generated prefix with `agent-sdk slack doctor`. Use `slack init --manual` only for an app you own. |
99
- | `slack create` is waiting for workspace approval | Keep the CLI running, open the **Request approval** link it prints, and select **Retry** in the [Deployed Agents](https://cursor.com/dashboard/deployed-agents) **Add Slack** wizard after an admin approves. See [Slack](./guides/slack.md#connect). |
100
- | The bot ignores ordinary channel posts | Configure `engagement.channelPosts`, create the app with `--channel-posts`, and invite it to every allowed channel. |
101
-
102
- See the [Slack guide](./guides/slack.md) for app setup and engagement
103
- choices.
72
+ | Logs say `channel idle ... missing credentials` | Run `agent-sdk slack create --dir <agent>`, then check the prefix with `agent-sdk slack doctor`. |
73
+ | `slack create` waits for workspace approval | Keep the CLI running and open the **Request approval** link it prints. After an admin approves, select **Retry** in the [Deployed Agents](https://cursor.com/dashboard/deployed-agents) **Add Slack** wizard. |
74
+ | The bot ignores ordinary channel posts | Configure `engagement.channelPosts`, create the app with `--channel-posts`, and invite it to each allowed channel. |
104
75
 
105
76
  ## MCP authorization fails
106
77
 
107
78
  | What you see | What to do |
108
79
  | --- | --- |
109
- | `must be defineConnection({ url, oauth: true })` | Add `oauth: true` to the named URL connection or correct the connection filename passed to `mcp oauth`. |
110
- | Local auth works but hosted calls return unauthorized | Locally stored OAuth tokens don't reach a deployment. Use a `cursorAccount: true` connection and connect the server from [Deployed Agents](https://cursor.com/dashboard/deployed-agents). See [Host MCP OAuth](./guides/mcp-oauth.md#use-an-oauth-server-from-a-hosted-agent). |
111
- | The model invents `mcp_auth` instead of calling the server | Set `advertiseTools: true` for named local tools, or expose a host-side wrapper through `ctx.host.mcp`. |
112
-
113
- See [Host MCP OAuth](./guides/mcp-oauth.md) for the credential lifecycle.
80
+ | `must be defineConnection({ url, oauth: true })` | Add `oauth: true` to the connection, or fix the filename you passed to `mcp oauth`. |
81
+ | Local auth works but hosted calls return unauthorized | Your local OAuth tokens don't reach a deployment. Use a `cursorAccount: true` connection, as described in [Host MCP OAuth](./guides/mcp-oauth.md#use-an-oauth-server-from-a-hosted-agent). |
82
+ | The model invents `mcp_auth` instead of calling the server | Set `advertiseTools: true` for named local tools, or expose a wrapper through `ctx.host.mcp`. |
114
83
 
115
84
  ## Schedules or reminders stall
116
85
 
117
86
  | What you see | What to do |
118
87
  | --- | --- |
119
- | A schedule or reminder never fires under `--dev` | Trigger it through the matching `/v1/dev/schedules/<id>` or `/v1/dev/reminders/<id>` route; development mode does not auto-fire. |
120
- | A reminder is disarmed with `handler_lost_on_restart` | Recreate handler-form reminders after restart, or use a prompt-form reminder. |
121
- | The same schedule fires on several self-hosted processes | Enable schedules on one serving process per project and pass `--no-schedules` to the others. |
122
-
123
- ## A credential was exposed
124
-
125
- | What you see | What to do |
126
- | --- | --- |
127
- | A secret value appears in a command, transcript, or shell history | Rotate it at the provider, set it again through hidden input or stdin, and test the feature. |
128
- | An alias token appears outside its secure destination | Run `agent-sdk deployment rotate-token <slug>`, store the new value outside transcripts, and update every caller. |
129
- | Someone printed a secret to verify it | Rotate it. Confirm only the name with `agent-sdk secret list <slug>`, then redeploy and exercise the feature. |
88
+ | A schedule or reminder never fires under `--dev` | `--dev` doesn't fire them on its own, so trigger one through its `/v1/dev/schedules/<id>` or `/v1/dev/reminders/<id>` route. |
89
+ | A reminder is disarmed with `handler_lost_on_restart` | Recreate handler-form reminders after a restart, or use a prompt-form reminder. |
90
+ | One schedule fires on several self-hosted processes | Pass `--no-schedules` to every serving process but one. |
130
91
 
131
92
  ## Read the session trace
132
93
 
133
- Start with `actions.requested` and `action.result`. Count calls by tool
134
- name, pair every request with its result, and separate host preparation
135
- from tools chosen by the model.
136
-
137
- `turn.failed` with `turn interrupted` usually means a follow-up or stop
138
- ended the turn deliberately. Other failures should have an error event
139
- near the tool or model boundary that produced them.
140
-
141
- Use the trace path printed by `agent-sdk run`:
142
-
143
- ```text
94
+ ```bash
95
+ agent-sdk session list --prod --slug <slug>
96
+ agent-sdk session get <sessionId> --prod --slug <slug> --view events
144
97
  agent-sdk session get --file <trace-path>
145
98
  ```
146
99
 
147
- The playground's **Open trace** control renders the same trajectory.
148
- When the agent runs but makes poor decisions, move from diagnosis to a
149
- measured [hillclimb](./hillclimbing.md).
150
-
151
- ## Related
152
-
153
- - [Deployment](./deployment.md): hosted and self-hosted boundaries
154
- - [Sessions](./reference/sessions.md): session ownership and event
155
- vocabulary
156
- - [CLI reference](./reference/cli.md): command flags and exit behavior
100
+ Find a hosted session with `session list`, then print its events with
101
+ `--view events`. For a local run, pass the trace path from `agent-sdk run`
102
+ to `--file`. Pair each `actions.requested` event with its `action.result`
103
+ to find the call that failed.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@grok/agent-sdk",
3
- "version": "0.2.29",
3
+ "version": "0.3.0",
4
4
  "description": "Build, test, and deploy agents as code on Cursor's agent harness.",
5
5
  "license": "SEE LICENSE IN LICENSE.md",
6
6
  "repository": {
@@ -351,7 +351,7 @@
351
351
  "rehype-highlight": "^7.0.2",
352
352
  "remark-gfm": "^4.0.1",
353
353
  "typescript": "npm:@typescript/typescript6@^6.0.2",
354
- "vite": "8.3.1",
354
+ "vite": "8.3.4",
355
355
  "vitepress": "1.6.4",
356
356
  "vitepress-plugin-mermaid": "^2.0.17",
357
357
  "vitest": "5.0.3",
@@ -39,7 +39,7 @@ the value. Do not run `agent-sdk login`.
39
39
  On Linux and macOS, run every Agent SDK command through this wrapper:
40
40
 
41
41
  ```bash
42
- BDK_VERSION="0.2.29"
42
+ BDK_VERSION="0.3.0"
43
43
  BDK_PACKAGE="@grok/agent-sdk"
44
44
  case "$BDK_VERSION" in
45
45
  __BDK_V*)
@@ -72,7 +72,6 @@ ends. That model changes code in three places:
72
72
  | `ctx.host.kv`, `ctx.host.files`, artifacts | Supported, in platform-selected storage |
73
73
  | Reminders with `prompt` or a named `handler` | Supported |
74
74
  | Secrets and `hosting.egressDomains` | Supported. Same-slug deploys copy v1 secrets. |
75
- | `persistent: true` and `hosting.image` | Supported, one persistent deployment per team |
76
75
  | Local `agent-sdk dev`, `run`, `eval`, and the playground | Supported |
77
76
  | `defineStorage` in `agent/storage.ts` | Not supported. Delete the file. |
78
77
  | Reminders with inline `run` or a function `until` | Not supported. Use a named handler. |
@@ -1,9 +0,0 @@
1
- import{_ as t,c as a,o as n,a3 as i}from"./chunks/framework.BNw1pucY.js";const u=JSON.parse('{"title":"Build with a coding agent","description":"Delegate Agent SDK creation, capability work, verification, and measured improvement to a coding agent.","frontmatter":{"title":"Build with a coding agent","description":"Delegate Agent SDK creation, capability work, verification, and measured improvement to a coding agent."},"headers":[],"relativePath":"building-with-agents.md","filePath":"building-with-agents.md"}'),s={name:"building-with-agents.md"};function o(r,e,l,c,d,p){return n(),a("div",null,[...e[0]||(e[0]=[i(`<h1 id="build-with-a-coding-agent" tabindex="-1">Build with a coding agent <a class="header-anchor" href="#build-with-a-coding-agent" aria-label="Permalink to &quot;Build with a coding agent&quot;">​</a></h1><p>Agent SDK projects live in files and expose structured CLI commands. A coding agent can create the project, exercise its tools, run a real turn, and inspect the result. You approve the plan and side effects while the coding agent owns the edit-and-test loop.</p><p>This page covers a coding agent working inside a checkout. To let a running agent propose changes to its own source, use the separate <a href="./guides/improve.html">self-improvement extension</a>.</p><h2 id="create-an-agent-from-a-goal" tabindex="-1">Create an agent from a goal <a class="header-anchor" href="#create-an-agent-from-a-goal" aria-label="Permalink to &quot;Create an agent from a goal&quot;">​</a></h2><p>Give the coding agent a purpose and the surfaces people will use. The <code>create-agent</code> skill asks only for missing decisions, shows a file plan, then scaffolds and verifies a small first version.</p><blockquote><p>Use the Agent SDK create-agent skill to build a PR triage agent reachable through GitHub. It should summarize failed checks, post one review comment per pull request, and include one smoke eval.</p></blockquote><p>Ask it to read <a href="./../skills/create-agent/SKILL.html"><code>skills/create-agent/SKILL.md</code></a>. The first version should stay narrow: instructions, one or two tools, the chosen channels or connections, and a smoke eval.</p><h2 id="add-one-capability" tabindex="-1">Add one capability <a class="header-anchor" href="#add-one-capability" aria-label="Permalink to &quot;Add one capability&quot;">​</a></h2><p>For an existing project, name the user-visible outcome and point the coding agent at the matching procedure. It should inspect the current agent first, make the smallest change, then exercise the new path.</p><p>Examples:</p><blockquote><p>Add Slack mentions and DMs to this agent. Follow the setup-slack skill, keep replies in the source thread, and verify one local mention.</p></blockquote><blockquote><p>Connect the private inventory MCP server with host OAuth. Keep its write tools behind a narrow server-tool wrapper.</p></blockquote><blockquote><p>Add a GitHub ready-for-review trigger and replay PR 42 before posting anything live.</p></blockquote><p>The companion skills live under <code>skills/</code>: <a href="./../skills/setup-slack/SKILL.html">Slack</a>, <a href="./../skills/mcp-auth/SKILL.html">MCP OAuth</a>, and <a href="./../skills/github/SKILL.html">GitHub</a>. Use the capability guide for the reader experience and the skill for the coding procedure.</p><h2 id="verify-tools-before-tuning-the-prompt" tabindex="-1">Verify tools before tuning the prompt <a class="header-anchor" href="#verify-tools-before-tuning-the-prompt" aria-label="Permalink to &quot;Verify tools before tuning the prompt&quot;">​</a></h2><p>Start with discovery, then call deterministic server tools without a model turn. If a tool returns the wrong evidence, fix the tool before changing instructions.</p><div class="language-text vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">text</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span>agent-sdk validate --dir .</span></span>
2
- <span class="line"><span>agent-sdk info --dir . --json</span></span>
3
- <span class="line"><span></span></span>
4
- <span class="line"><span>agent-sdk tool call inspect_pr --dir . \\</span></span>
5
- <span class="line"><span> --input &#39;{&quot;prUrl&quot;:&quot;https://github.com/acme/checkout/pull/42&quot;}&#39;</span></span></code></pre></div><p><code>validate</code> confirms the discovered project shape. <code>info</code> shows what the serve host will mount. <code>tool call</code> runs the authored tool with schema validation and exposes its real output.</p><h2 id="verify-one-end-to-end-turn" tabindex="-1">Verify one end-to-end turn <a class="header-anchor" href="#verify-one-end-to-end-turn" aria-label="Permalink to &quot;Verify one end-to-end turn&quot;">​</a></h2><p>Once deterministic inputs are correct, send the same request a user will. The coding agent should check the final answer and tool trajectory before declaring the capability complete.</p><div class="language-text vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">text</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span>agent-sdk run --dir . \\</span></span>
6
- <span class="line"><span> --message &quot;Is https://github.com/acme/checkout/pull/42 ready to approve?&quot;</span></span></code></pre></div><p><code>run</code> prints the saved trace path. Use that exact path instead of constructing one from the session ID:</p><div class="language-text vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">text</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span>agent-sdk session get --file &lt;trace-path-printed-by-run&gt;</span></span>
7
- <span class="line"><span>agent-sdk eval --dir . --tag smoke</span></span></code></pre></div><p>Finish with the project&#39;s TypeScript check. Agent SDK executes TypeScript through type stripping, so a successful turn does not prove the project type-checks.</p><h2 id="hand-off-credential-dependent-checks" tabindex="-1">Hand off credential-dependent checks <a class="header-anchor" href="#hand-off-credential-dependent-checks" aria-label="Permalink to &quot;Hand off credential-dependent checks&quot;">​</a></h2><p>Project discovery, <code>info</code>, server-tool calls, and serve bring-up do not need a model credential. Model turns and evals resolve <code>CURSOR_API_KEY</code>, <code>CURSOR_API_KEY_FILE</code>, <code>CURSOR_SERVICE_ACCOUNT_KEY</code>, then <code>agent-sdk login</code>.</p><p>When the coding environment has none, it should complete every key-free check and hand you the exact remaining commands:</p><div class="language-text vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">text</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span>agent-sdk run --dir . --message &quot;&lt;fixture prompt&gt;&quot;</span></span>
8
- <span class="line"><span>agent-sdk serve --dir . --dev</span></span>
9
- <span class="line"><span>agent-sdk eval --dir . --tag smoke</span></span></code></pre></div><p>Missing access is a handoff boundary, not a reason to skip verification or invent a substitute result.</p><h2 id="improve-a-working-agent" tabindex="-1">Improve a working agent <a class="header-anchor" href="#improve-a-working-agent" aria-label="Permalink to &quot;Improve a working agent&quot;">​</a></h2><p>After one smoke turn passes, give the coding agent fixed fixtures, one success criterion, and the behavior that must not change. The hillclimb skill measures the current run, changes one lever, remeasures, and adds an eval for every kept improvement.</p><blockquote><p>Hillclimb the PR triage agent on these two saved PRs. Reduce repeated reads without losing either gold finding. Keep the review JSON shape and all existing evals unchanged.</p></blockquote><p>Ask it to read <a href="./../skills/hillclimb/SKILL.html"><code>skills/hillclimb/SKILL.md</code></a>. Keep creation and improvement separate: a smoke turn proves the surface works; a measured climb proves it works better on fixed inputs.</p><h2 id="related" tabindex="-1">Related <a class="header-anchor" href="#related" aria-label="Permalink to &quot;Related&quot;">​</a></h2><ul><li><a href="./guides/migrate.html">Early-alpha migration</a>: hand an architecture v1 migration to <code>agent-sdk migrate</code> or the bundled coding-agent skill</li><li><a href="./quickstart.html">Quickstart</a>: build the first agent manually</li><li><a href="./evals.html">Evals</a>: protect behavior with regression cases</li><li><a href="./hillclimbing.html">Hillclimbing</a>: run one measured improvement round</li><li><a href="./guides/improve.html">Self-improvement</a>: let a running agent propose a source change through a pull request</li><li><a href="./reference/cli.html">CLI reference</a>: command contracts and flags</li></ul>`,35)])])}const g=t(s,[["render",o]]);export{u as __pageData,g as default};
@@ -1 +0,0 @@
1
- import{_ as a,c as o,o as t,a3 as i}from"./chunks/framework.BNw1pucY.js";const g=JSON.parse('{"title":"Changelog","description":"Changes for each release of @grok/agent-sdk","frontmatter":{"title":"Changelog","description":"Changes for each release of @grok/agent-sdk"},"headers":[],"relativePath":"changelog.md","filePath":"changelog.md"}'),n={name:"changelog.md"};function c(s,e,d,l,r,h){return t(),o("div",null,[...e[0]||(e[0]=[i('<h1 id="changelog" tabindex="-1">Changelog <a class="header-anchor" href="#changelog" aria-label="Permalink to &quot;Changelog&quot;">​</a></h1><h2 id="_0-2-29-2026-10-23" tabindex="-1">0.2.29 (2026-10-23) <a class="header-anchor" href="#_0-2-29-2026-10-23" aria-label="Permalink to &quot;0.2.29 (2026-10-23)&quot;">​</a></h2><h3 id="breaking-changes" tabindex="-1">Breaking changes <a class="header-anchor" href="#breaking-changes" aria-label="Permalink to &quot;Breaking changes&quot;">​</a></h3><ul><li><code>@grok/agent-sdk/extensions/cursor-grokbot-agents</code> is removed. Remove that import. The package has no replacement.</li></ul><h3 id="behavior-changes" tabindex="-1">Behavior changes <a class="header-anchor" href="#behavior-changes" aria-label="Permalink to &quot;Behavior changes&quot;">​</a></h3><ul><li>Rename commands and errors to agent-sdk</li></ul><h2 id="_0-2-28-2026-10-21" tabindex="-1">0.2.28 (2026-10-21) <a class="header-anchor" href="#_0-2-28-2026-10-21" aria-label="Permalink to &quot;0.2.28 (2026-10-21)&quot;">​</a></h2><h3 id="breaking-changes-1" tabindex="-1">Breaking changes <a class="header-anchor" href="#breaking-changes-1" aria-label="Permalink to &quot;Breaking changes&quot;">​</a></h3><ul><li>Semantic search is removed. Use Grep. Read <a href="./reference/agent-config.html#migrate-off-semantic-search">Migrate off semantic search</a>.</li><li><code>CATCH_DELIVERY_ID_HEADER</code> left <code>@grok/agent-sdk/channels</code>. Remove that import. The npm package has no replacement.</li><li><code>attachRelayMcp</code> was not a published export. Remove that import. The npm package has no replacement.</li><li><code>CursorBackendClient</code> was not a published export. Remove that import. Clone a pull request with <code>@grok/agent-sdk/scm</code>.</li><li><code>postRelaySlackMessage</code> was not a published export. Remove that import. The npm package has no replacement.</li></ul><h3 id="behavior-changes-1" tabindex="-1">Behavior changes <a class="header-anchor" href="#behavior-changes-1" aria-label="Permalink to &quot;Behavior changes&quot;">​</a></h3><ul><li>With deploy caps on, <code>agent-sdk deploy</code> stops at 20 deployments or 100 deploys in 24 hours. Read <a href="./reference/limits.html">Limits</a>.</li><li><code>agent-sdk deploy</code> refuses <code>persistent: true</code>. A running persistent deployment keeps serving.</li><li>A direct file-tool call respects <code>tools</code>. A path outside the workspace fails.</li><li>With <code>local.sandbox</code> on, file tools refuse a path outside the session workspace.</li><li><code>@grok/agent-sdk</code> depends on <code>@modelcontextprotocol/sdk</code> 1.32.1.</li><li>An MCP server that redirects to a different host or port fails.</li><li><code>agent-sdk init</code> and the templates depend on zod 4.</li></ul><h3 id="new" tabindex="-1">New <a class="header-anchor" href="#new" aria-label="Permalink to &quot;New&quot;">​</a></h3><ul><li><code>claimIssue</code> is newly public on <code>@grok/agent-sdk/channels/issues</code>.</li><li><code>claimCheckpoint</code> is newly public on <code>@grok/agent-sdk/channels/change-monitors</code>.</li><li><code>@grok/agent-sdk/scm</code> is newly public.</li><li><code>agent-sdk sessions --prod</code> lists sessions on a Cursor-managed deployment.</li><li>Set <code>botScopes</code> in <code>slack-manifest.json</code>, then run <code>agent-sdk slack create</code> again.</li><li>Slack <code>post-file</code> accepts <code>alt_txt</code> and <code>initial_comment</code>.</li><li>Send <code>X-BDK-Session-Key</code> to keep one hosted session for that key.</li><li>A pull request on <code>&lt;tenant&gt;.ghe.com</code> keeps its own session.</li><li><code>agent-sdk logs --prod</code> prints process output and a <code>tool &lt;name&gt;</code> line. <code>agent-sdk session --prod --events</code> prints the events.</li></ul><h3 id="fixes" tabindex="-1">Fixes <a class="header-anchor" href="#fixes" aria-label="Permalink to &quot;Fixes&quot;">​</a></h3><ul><li>A failed Slack file upload is reported on that thread.</li></ul><h2 id="_0-2-27-2026-10-16" tabindex="-1">0.2.27 (2026-10-16) <a class="header-anchor" href="#_0-2-27-2026-10-16" aria-label="Permalink to &quot;0.2.27 (2026-10-16)&quot;">​</a></h2><h3 id="breaking-changes-2" tabindex="-1">Breaking changes <a class="header-anchor" href="#breaking-changes-2" aria-label="Permalink to &quot;Breaking changes&quot;">​</a></h3><ul><li>Each <code>handle.agents</code> entry is <code>{ slug, url, info }</code>. It no longer has <code>project</code>. Read <code>info</code> instead.</li></ul><h3 id="behavior-changes-2" tabindex="-1">Behavior changes <a class="header-anchor" href="#behavior-changes-2" aria-label="Permalink to &quot;Behavior changes&quot;">​</a></h3><ul><li><code>@grok/agent-sdk</code> requires <code>@cursor/sdk</code> 1.0.38.</li><li>In project info, a function <code>needsApproval</code> is <code>&quot;dynamic&quot;</code> instead of <code>true</code>.</li><li>Project info has <code>schemaVersion: 1</code> and <code>architecture</code>. Diagnostic paths are relative to the project directory.</li><li><code>handle.project</code> is deprecated. Use <code>handle.agents</code>.</li><li><code>loadAgentProject</code>, <code>loadAgentProjects</code>, and <code>projectInfo</code> are deprecated. Use <code>loadProject</code>.</li><li><code>root</code> on <code>defineAgent</code> is deprecated. Use <code>fs</code>. Setting both is an error.</li></ul><h3 id="new-1" tabindex="-1">New <a class="header-anchor" href="#new-1" aria-label="Permalink to &quot;New&quot;">​</a></h3><ul><li><code>loadProject(dir)</code> loads a project without serving it. Its <code>info</code> matches <code>GET /v1/info</code>. Pass <code>{ strict: true }</code> to fail on warnings.</li><li><code>serve</code> accepts a directory or a <code>Project</code> from <code>loadProject</code>.</li><li><code>defineAgent({ fs })</code> mounts your filesystem at <code>/</code>. Agent SDK mounts <code>/tmp</code> and <code>/agent/skills</code> over it.</li><li>With <code>fs</code>, the agent&#39;s skills are read-only at <code>/agent/skills/&lt;name&gt;/SKILL.md</code>. Set <code>skills: false</code> to keep your own <code>/agent/skills</code>.</li><li>Listing a directory includes the files of mounts nested under it.</li></ul><h3 id="fixes-1" tabindex="-1">Fixes <a class="header-anchor" href="#fixes-1" aria-label="Permalink to &quot;Fixes&quot;">​</a></h3><ul><li>A local agent can use a model variant that needs Max Mode, such as Grok 4.7 with a 500k context window.</li><li>A session that has been idle for 10 minutes releases its memory. Its next turn resumes the conversation.</li></ul><h2 id="_0-2-26-2026-10-16" tabindex="-1">0.2.26 (2026-10-16) <a class="header-anchor" href="#_0-2-26-2026-10-16" aria-label="Permalink to &quot;0.2.26 (2026-10-16)&quot;">​</a></h2><h3 id="breaking-changes-3" tabindex="-1">Breaking changes <a class="header-anchor" href="#breaking-changes-3" aria-label="Permalink to &quot;Breaking changes&quot;">​</a></h3><ul><li><code>serve({ otel })</code> is removed. Delete <code>bot/otel.ts</code>, <code>agent/otel.ts</code>, and <code>bot/instrumentation.ts</code>. Set <code>OTEL_*</code> variables. Read <a href="./guides/opentelemetry.html#migrating-from-serve-otel">Migrating from serve({ otel })</a>.</li></ul><h3 id="behavior-changes-3" tabindex="-1">Behavior changes <a class="header-anchor" href="#behavior-changes-3" aria-label="Permalink to &quot;Behavior changes&quot;">​</a></h3><ul><li><code>ctx.host.otel</code> is deprecated. It still runs for this release. The first call emits one deprecation warning. Set <code>OTEL_*</code> variables. Record with <code>metrics.getMeter</code> and <code>trace.getTracer</code> from <code>@opentelemetry/api</code>.</li><li>A span started during a turn or a tool gets <code>cursor.conversation.id</code> from the active context when the span does not set it. A metric does not. Call <code>currentConversationId</code> from <code>@grok/agent-sdk/otel</code> and set the attribute yourself. See <a href="./guides/opentelemetry.html#what-you-can-record">OpenTelemetry</a>.</li><li>A turn waits for MCP OAuth only when a person can connect. That is a playground or HTTP chat turn, or a Slack message on a channel that shows Connect. <code>toolApprovals: true</code> shows Connect, and so does <code>buildToolApprovalEvents</code> in <code>events</code>. A schedule, a reminder, a webhook, an eval, or a Slack channel without Connect does not wait. A required connection fails with <code>Reconnect &lt;connection&gt;</code>. An optional connection is skipped.</li><li>A turn never waits to authorize an <code>optional</code> connection, also in the playground.</li><li>A turn that waits for MCP OAuth stops after 10 minutes with <code>Reconnect &lt;connection&gt;</code>. <code>interrupt()</code> also stops the wait.</li><li><code>agent-sdk deploy</code> rejects a source host other than GitHub, gitlab.com, or Origin.</li><li>A new scaffold imports <code>zod/v4</code>. A zod 3 schema and a zod 4 schema both still parse.</li><li><code>agent-sdk deploy</code> with no terminal lists a connector that needs sign-in as pending.</li></ul><h3 id="new-2" tabindex="-1">New <a class="header-anchor" href="#new-2" aria-label="Permalink to &quot;New&quot;">​</a></h3><ul><li><code>agent-sdk deploy</code> deploys a bot from a gitlab.com repository.</li><li>When you omit <code>--cursor-events-repo</code>, a GitLab deploy watches that project. A nested group is part of the path.</li><li>When that deploy cannot watch the project, the deploy still finishes. The CLI says the deployment is not watching the project.</li><li>An agentic Slack reply can set <code>cards: { display: &quot;plan&quot; }</code>. Slack shows the <code>post-card</code> steps from that turn as one checklist.</li><li>A <code>title</code> names that checklist. A title has at most 256 characters.</li><li>With no <code>cards</code> option, Slack keeps one card for each step.</li><li><code>send()</code> returns a delivery id. Set <code>deliveryId</code> to choose it. <code>nudge.delivered</code> and <code>message.received</code> include that id.</li></ul><h3 id="fixes-2" tabindex="-1">Fixes <a class="header-anchor" href="#fixes-2" aria-label="Permalink to &quot;Fixes&quot;">​</a></h3><ul><li>Public helper signatures use portable types. A webhook body is a <code>string</code> or a <code>Uint8Array</code>. An environment map is <code>Record&lt;string, string | undefined&gt;</code>.</li><li><code>HostFilesApi.read</code> takes a <code>HostFileTextEncoding</code>. A <code>Buffer</code> and <code>process.env</code> still type-check.</li><li>OpenTelemetry ends each tool span when that tool finishes.</li><li>With no OpenTelemetry endpoint, the process holds at most 2048 spans and 2048 log records.</li><li>A follow-up after a redeploy resumes the same agent. A changed workspace path does not start a new conversation.</li><li>In a Slack Connect channel, sender checks use the workspace where the app is installed.</li><li>A <code>cursorAccount</code> GitHub GraphQL call includes the repository.</li><li>A Slack bot with a lapsed MCP connection replies with a reconnect message.</li></ul><h2 id="_0-2-25-2026-10-14" tabindex="-1">0.2.25 (2026-10-14) <a class="header-anchor" href="#_0-2-25-2026-10-14" aria-label="Permalink to &quot;0.2.25 (2026-10-14)&quot;">​</a></h2><h3 id="new-3" tabindex="-1">New <a class="header-anchor" href="#new-3" aria-label="Permalink to &quot;New&quot;">​</a></h3><ul><li><code>agent-sdk validate --json</code> writes one JSON object. Each diagnostic has a code.</li></ul><h3 id="fixes-3" tabindex="-1">Fixes <a class="header-anchor" href="#fixes-3" aria-label="Permalink to &quot;Fixes&quot;">​</a></h3><ul><li>OpenTelemetry metrics follow <code>OTEL_EXPORTER_OTLP_METRICS_TEMPORALITY_PREFERENCE</code>. The default stays delta.</li><li><code>ctx.host.github.getOctokit()</code> tries again after a failed lookup. A later call can succeed after a GitHub token becomes available.</li></ul><h2 id="_0-2-24-2026-10-13" tabindex="-1">0.2.24 (2026-10-13) <a class="header-anchor" href="#_0-2-24-2026-10-13" aria-label="Permalink to &quot;0.2.24 (2026-10-13)&quot;">​</a></h2><h3 id="breaking-changes-4" tabindex="-1">Breaking changes <a class="header-anchor" href="#breaking-changes-4" aria-label="Permalink to &quot;Breaking changes&quot;">​</a></h3><ul><li>Install <code>zod</code> in the project. The peer range is <code>^3.25.0</code> or <code>^4.0.0</code>. A new scaffold imports <code>zod/v3</code>.</li></ul><h3 id="behavior-changes-4" tabindex="-1">Behavior changes <a class="header-anchor" href="#behavior-changes-4" aria-label="Permalink to &quot;Behavior changes&quot;">​</a></h3><ul><li><code>setContinuationToken(null)</code> releases the continuation key. The next delivery starts a new session.</li><li>Model fallback continues when a blocked model sends progress updates and no assistant text. Those updates are <code>user-message-appended</code>, <code>step-started</code>, and <code>step-completed</code>.</li><li>Read a secret inside a handler, a tool, or a callback. A <code>process.env</code> read while the module is still loading returns an empty value on a Cursor-managed deploy.</li><li>In the Agentic Approver template, a <code>paths</code> glob is relative to the policy directory.</li><li>The package depends on <code>tsx</code> 4.23.15.</li></ul><h3 id="new-4" tabindex="-1">New <a class="header-anchor" href="#new-4" aria-label="Permalink to &quot;New&quot;">​</a></h3><ul><li><code>hmacSignatureAuth</code> takes an optional <code>separator</code>. One header can then carry several HMAC signatures. PagerDuty uses a comma.</li><li><code>cursorCloudAgents</code> accepts <code>cloud.teamMcpServers</code>. The launch uses the team MCP servers you name.</li></ul><h3 id="fixes-4" tabindex="-1">Fixes <a class="header-anchor" href="#fixes-4" aria-label="Permalink to &quot;Fixes&quot;">​</a></h3><ul><li>On Cursor-managed hosting, OpenTelemetry reads the endpoint, the headers, and the resource after secrets load. You can remove a workaround that reads <code>OTEL_EXPORTER_OTLP_HEADERS</code> again.</li></ul><h2 id="_0-2-23-2026-10-09" tabindex="-1">0.2.23 (2026-10-09) <a class="header-anchor" href="#_0-2-23-2026-10-09" aria-label="Permalink to &quot;0.2.23 (2026-10-09)&quot;">​</a></h2><h3 id="behavior-changes-5" tabindex="-1">Behavior changes <a class="header-anchor" href="#behavior-changes-5" aria-label="Permalink to &quot;Behavior changes&quot;">​</a></h3><ul><li><code>agent-sdk migrate</code> rewrites a URL-secret MCP peer to <code>defineConnection({ agent })</code> in the migration pull request.</li><li><code>agent-sdk migrate</code> prints a checklist after the migration. It says when there is nothing to migrate.</li><li><code>agent-sdk slack create --prod</code> says the deployment redeploys by itself.</li><li><code>agent-sdk deploy</code> on a folder of several agents prints one command per agent. You run each command to deploy that agent.</li></ul><h3 id="new-5" tabindex="-1">New <a class="header-anchor" href="#new-5" aria-label="Permalink to &quot;New&quot;">​</a></h3><ul><li>A Slack app can opt in to the <code>chat:write.customize</code> scope. A post can then set its username and its icon. An app that leaves the scope off keeps its current scopes.</li></ul>',52)])])}const p=a(n,[["render",c]]);export{g as __pageData,p as default};
@@ -1 +0,0 @@
1
- import{_ as a,c as o,o as t,a3 as i}from"./chunks/framework.BNw1pucY.js";const g=JSON.parse('{"title":"Changelog","description":"Changes for each release of @grok/agent-sdk","frontmatter":{"title":"Changelog","description":"Changes for each release of @grok/agent-sdk"},"headers":[],"relativePath":"changelog.md","filePath":"changelog.md"}'),n={name:"changelog.md"};function c(s,e,d,l,r,h){return t(),o("div",null,[...e[0]||(e[0]=[i("",52)])])}const p=a(n,[["render",c]]);export{g as __pageData,p as default};