@grok/agent-sdk 0.2.29 → 0.4.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 (451) hide show
  1. package/dist/channels/slack/cli-project.js +1 -1
  2. package/dist/channels/slack/slack-channel.d.ts.map +1 -1
  3. package/dist/channels/slack/slack-channel.js +27 -14
  4. package/dist/docs/404.html +2 -2
  5. package/dist/docs/assets/{app.DMrZKFjI.js → app.BSH__xV4.js} +4 -4
  6. package/dist/docs/assets/building-with-agents.md.Bo3ct-rf.js +6 -0
  7. package/dist/docs/assets/{building-with-agents.md.Bf1yH2tG.lean.js → building-with-agents.md.Bo3ct-rf.lean.js} +1 -1
  8. package/dist/docs/assets/changelog.md.b6H_ea44.js +1 -0
  9. package/dist/docs/assets/changelog.md.b6H_ea44.lean.js +1 -0
  10. package/dist/docs/assets/chunks/@localSearchIndexroot.CiRGcfZg.js +1 -0
  11. package/dist/docs/assets/chunks/{VPLocalSearchBox.DQvuw1KA.js → VPLocalSearchBox.Cadl7A0k.js} +1 -1
  12. package/dist/docs/assets/chunks/{arc.ahOG-Qza.js → arc.K7t9nNY6.js} +1 -1
  13. package/dist/docs/assets/chunks/{architectureDiagram-Q4EWVU46.BcgfYNO_.js → architectureDiagram-Q4EWVU46.SlHEknkX.js} +1 -1
  14. package/dist/docs/assets/chunks/{baseUniq.DeIYZrWh.js → baseUniq.DJLRMLkz.js} +1 -1
  15. package/dist/docs/assets/chunks/{blockDiagram-DXYQGD6D.HjJ2goMX.js → blockDiagram-DXYQGD6D.Bs6XxFpe.js} +1 -1
  16. package/dist/docs/assets/chunks/{c4Diagram-AHTNJAMY.C1QTb9GM.js → c4Diagram-AHTNJAMY.CyLg6Ovc.js} +1 -1
  17. package/dist/docs/assets/chunks/channel.CVTdqYx0.js +1 -0
  18. package/dist/docs/assets/chunks/{chunk-4BX2VUAB.UuZiDiVp.js → chunk-4BX2VUAB.DTQ4TinT.js} +1 -1
  19. package/dist/docs/assets/chunks/{chunk-4TB4RGXK.5A3YmkhI.js → chunk-4TB4RGXK.Es84IgcH.js} +1 -1
  20. package/dist/docs/assets/chunks/{chunk-55IACEB6.B4uf1yYV.js → chunk-55IACEB6.Clm3cGPQ.js} +1 -1
  21. package/dist/docs/assets/chunks/{chunk-EDXVE4YY.CoXBce8t.js → chunk-EDXVE4YY.DE4CRkS5.js} +1 -1
  22. package/dist/docs/assets/chunks/{chunk-FMBD7UC4.DnC5NO4e.js → chunk-FMBD7UC4.Bf8HCvqp.js} +1 -1
  23. package/dist/docs/assets/chunks/{chunk-OYMX7WX6.CzfHCeIi.js → chunk-OYMX7WX6.eub-7nSx.js} +1 -1
  24. package/dist/docs/assets/chunks/{chunk-QZHKN3VN.C6tcwkVd.js → chunk-QZHKN3VN.WyP9VAS_.js} +1 -1
  25. package/dist/docs/assets/chunks/{chunk-YZCP3GAM._oboyZ1A.js → chunk-YZCP3GAM.LO9ohhDE.js} +1 -1
  26. package/dist/docs/assets/chunks/classDiagram-6PBFFD2Q.CsJJyx6-.js +1 -0
  27. package/dist/docs/assets/chunks/classDiagram-v2-HSJHXN6E.CsJJyx6-.js +1 -0
  28. package/dist/docs/assets/chunks/clone.Dk8KvtOB.js +1 -0
  29. package/dist/docs/assets/chunks/{cose-bilkent-S5V4N54A.BfPVKeId.js → cose-bilkent-S5V4N54A.D5za6aH0.js} +1 -1
  30. package/dist/docs/assets/chunks/{dagre-KV5264BT.CLMLc0lD.js → dagre-KV5264BT.Dq1daUru.js} +1 -1
  31. package/dist/docs/assets/chunks/{diagram-5BDNPKRD.C7OF7UfH.js → diagram-5BDNPKRD.j1YL5BKS.js} +1 -1
  32. package/dist/docs/assets/chunks/{diagram-G4DWMVQ6.Dpao0Bl1.js → diagram-G4DWMVQ6.Bi1aLdhC.js} +1 -1
  33. package/dist/docs/assets/chunks/{diagram-MMDJMWI5.DLnM9eLp.js → diagram-MMDJMWI5.BOzMEkAr.js} +1 -1
  34. package/dist/docs/assets/chunks/{diagram-TYMM5635.BcpVgA_M.js → diagram-TYMM5635.Dx2FVhCr.js} +1 -1
  35. package/dist/docs/assets/chunks/{erDiagram-SMLLAGMA.CsL5JuCV.js → erDiagram-SMLLAGMA.DI4TNkye.js} +1 -1
  36. package/dist/docs/assets/chunks/{flowDiagram-DWJPFMVM.MFihq9AF.js → flowDiagram-DWJPFMVM.C58Z9uPK.js} +1 -1
  37. package/dist/docs/assets/chunks/{ganttDiagram-T4ZO3ILL.CJeLodyG.js → ganttDiagram-T4ZO3ILL.DXSpW809.js} +1 -1
  38. package/dist/docs/assets/chunks/{gitGraphDiagram-UUTBAWPF.1HhlE45Z.js → gitGraphDiagram-UUTBAWPF.B955oaFl.js} +1 -1
  39. package/dist/docs/assets/chunks/{graph.BS02KkWA.js → graph.BQXhKtxS.js} +1 -1
  40. package/dist/docs/assets/chunks/{infoDiagram-42DDH7IO.fp5gvytQ.js → infoDiagram-42DDH7IO.Dozj_-Gm.js} +1 -1
  41. package/dist/docs/assets/chunks/{ishikawaDiagram-UXIWVN3A.C6Wk1V4I.js → ishikawaDiagram-UXIWVN3A.D2140OzH.js} +1 -1
  42. package/dist/docs/assets/chunks/{journeyDiagram-VCZTEJTY.qJt4uJ_H.js → journeyDiagram-VCZTEJTY.DrqrMhCk.js} +1 -1
  43. package/dist/docs/assets/chunks/{kanban-definition-6JOO6SKY.z2tG9kly.js → kanban-definition-6JOO6SKY.Dv-LTrlw.js} +1 -1
  44. package/dist/docs/assets/chunks/{layout.BPCkdejr.js → layout.CGtHp49X.js} +1 -1
  45. package/dist/docs/assets/chunks/{linear.CL3TC3u7.js → linear.CHZLYB52.js} +1 -1
  46. package/dist/docs/assets/chunks/{min.SPrSp704.js → min.D4Vt3eIy.js} +1 -1
  47. package/dist/docs/assets/chunks/{mindmap-definition-QFDTVHPH.DgrQRFZW.js → mindmap-definition-QFDTVHPH.BBfpYTea.js} +1 -1
  48. package/dist/docs/assets/chunks/{pieDiagram-DEJITSTG.Ba7yxiW2.js → pieDiagram-DEJITSTG.BVYvElmY.js} +1 -1
  49. package/dist/docs/assets/chunks/{quadrantDiagram-34T5L4WZ.Bvskad4p.js → quadrantDiagram-34T5L4WZ.C6Gc2mdY.js} +1 -1
  50. package/dist/docs/assets/chunks/{requirementDiagram-MS252O5E.Ce70ugV9.js → requirementDiagram-MS252O5E.DWa8b4cn.js} +1 -1
  51. package/dist/docs/assets/chunks/{sankeyDiagram-XADWPNL6.BJ5OEULO.js → sankeyDiagram-XADWPNL6.Bi-g4ajv.js} +1 -1
  52. package/dist/docs/assets/chunks/{sequenceDiagram-FGHM5R23.C8a1hDs6.js → sequenceDiagram-FGHM5R23.DlU3vVN9.js} +1 -1
  53. package/dist/docs/assets/chunks/{stateDiagram-FHFEXIEX.D2D8A5CK.js → stateDiagram-FHFEXIEX.CeqJRqnU.js} +1 -1
  54. package/dist/docs/assets/chunks/stateDiagram-v2-QKLJ7IA2.DE0BnUZh.js +1 -0
  55. package/dist/docs/assets/chunks/{theme.DRciHmS1.js → theme.DGq7D4tt.js} +2 -2
  56. package/dist/docs/assets/chunks/{timeline-definition-GMOUNBTQ.C4ePrY8-.js → timeline-definition-GMOUNBTQ.Cqf2kjq9.js} +1 -1
  57. package/dist/docs/assets/chunks/{vennDiagram-DHZGUBPP.Dzso6dEA.js → vennDiagram-DHZGUBPP.BeOpE_lM.js} +1 -1
  58. package/dist/docs/assets/chunks/{wardley-RL74JXVD.djgXR0ar.js → wardley-RL74JXVD.FMQXA-6q.js} +1 -1
  59. package/dist/docs/assets/chunks/{wardleyDiagram-NUSXRM2D.Bf2ICxjh.js → wardleyDiagram-NUSXRM2D.BXS65dAC.js} +1 -1
  60. package/dist/docs/assets/chunks/{xychartDiagram-5P7HB3ND.DEH4BcVJ.js → xychartDiagram-5P7HB3ND.haEiSxqc.js} +1 -1
  61. package/dist/docs/assets/deployment.md.DJtuDVLh.js +31 -0
  62. package/dist/docs/assets/{deployment.md.KW0Ni_rY.lean.js → deployment.md.DJtuDVLh.lean.js} +1 -1
  63. package/dist/docs/assets/evals.md.Dne6VRmZ.js +49 -0
  64. package/dist/docs/assets/evals.md.Dne6VRmZ.lean.js +1 -0
  65. package/dist/docs/assets/{guides_agent-to-agent.md.D1D5f6Jc.js → guides_agent-to-agent.md.DcB3nhOz.js} +8 -8
  66. package/dist/docs/assets/guides_agent-to-agent.md.DcB3nhOz.lean.js +1 -0
  67. package/dist/docs/assets/{guides_bitbucket.md.DkjkBRU8.js → guides_bitbucket.md.BiA6ZMFW.js} +27 -27
  68. package/dist/docs/assets/{guides_bitbucket.md.DkjkBRU8.lean.js → guides_bitbucket.md.BiA6ZMFW.lean.js} +1 -1
  69. package/dist/docs/assets/guides_cloud-agents.md.CiXAW6on.js +9 -0
  70. package/dist/docs/assets/{guides_cloud-agents.md.Ceyjv0ul.lean.js → guides_cloud-agents.md.CiXAW6on.lean.js} +1 -1
  71. package/dist/docs/assets/guides_convert-automation.md.BvTxsJ8J.js +26 -0
  72. package/dist/docs/assets/{guides_convert-automation.md.BjraCvok.lean.js → guides_convert-automation.md.BvTxsJ8J.lean.js} +1 -1
  73. package/dist/docs/assets/{guides_github.md.CgN5sNbW.js → guides_github.md.CcuZ7keS.js} +11 -19
  74. package/dist/docs/assets/{guides_github.md.CgN5sNbW.lean.js → guides_github.md.CcuZ7keS.lean.js} +1 -1
  75. package/dist/docs/assets/{guides_gitlab.md.DCE0p7_w.js → guides_gitlab.md.DcKusOcU.js} +63 -73
  76. package/dist/docs/assets/{guides_gitlab.md.DCE0p7_w.lean.js → guides_gitlab.md.DcKusOcU.lean.js} +1 -1
  77. package/dist/docs/assets/guides_improve.md.o3WOGR7n.js +16 -0
  78. package/dist/docs/assets/{guides_improve.md.BFYtrtLE.lean.js → guides_improve.md.o3WOGR7n.lean.js} +1 -1
  79. package/dist/docs/assets/{guides_jev.md.CEqLgjj9.js → guides_jev.md.DGCzkMUN.js} +20 -60
  80. package/dist/docs/assets/{guides_jev.md.CEqLgjj9.lean.js → guides_jev.md.DGCzkMUN.lean.js} +1 -1
  81. package/dist/docs/assets/{guides_mcp-oauth.md.DrGY92u4.js → guides_mcp-oauth.md.GVPMKcYl.js} +3 -5
  82. package/dist/docs/assets/{guides_mcp-oauth.md.DrGY92u4.lean.js → guides_mcp-oauth.md.GVPMKcYl.lean.js} +1 -1
  83. package/dist/docs/assets/guides_migrate.md.B8CZxnnX.js +3 -0
  84. package/dist/docs/assets/{guides_migrate.md.RS9Eu-Xh.lean.js → guides_migrate.md.B8CZxnnX.lean.js} +1 -1
  85. package/dist/docs/assets/guides_opentelemetry.md.BRSktBHt.js +26 -0
  86. package/dist/docs/assets/guides_opentelemetry.md.BRSktBHt.lean.js +1 -0
  87. package/dist/docs/assets/guides_pagerduty.md.pMXUkZZc.js +61 -0
  88. package/dist/docs/assets/guides_pagerduty.md.pMXUkZZc.lean.js +1 -0
  89. package/dist/docs/assets/guides_slack.md.D7Rwyva4.js +82 -0
  90. package/dist/docs/assets/{guides_slack.md.BwXHURvY.lean.js → guides_slack.md.D7Rwyva4.lean.js} +1 -1
  91. package/dist/docs/assets/{guides_webhooks.md.BJk63ZTs.js → guides_webhooks.md.B5DXt2v1.js} +7 -7
  92. package/dist/docs/assets/{guides_webhooks.md.BJk63ZTs.lean.js → guides_webhooks.md.B5DXt2v1.lean.js} +1 -1
  93. package/dist/docs/assets/hillclimbing.md.M51bF-oT.js +5 -0
  94. package/dist/docs/assets/hillclimbing.md.M51bF-oT.lean.js +1 -0
  95. package/dist/docs/assets/index.md.DnJPj_B6.js +14 -0
  96. package/dist/docs/assets/index.md.DnJPj_B6.lean.js +1 -0
  97. package/dist/docs/assets/quickstart.md.r-oE8nkX.js +113 -0
  98. package/dist/docs/assets/{quickstart.md.CljDaJBi.lean.js → quickstart.md.r-oE8nkX.lean.js} +1 -1
  99. package/dist/docs/assets/reference_access.md.C5lblfUC.js +1 -0
  100. package/dist/docs/assets/reference_access.md.C5lblfUC.lean.js +1 -0
  101. package/dist/docs/assets/reference_agent-config.md.BSNp2uJ7.js +27 -0
  102. package/dist/docs/assets/{reference_agent-config.md.Ck29qYNj.lean.js → reference_agent-config.md.BSNp2uJ7.lean.js} +1 -1
  103. package/dist/docs/assets/reference_artifacts.md.BJpAI7h9.js +17 -0
  104. package/dist/docs/assets/{reference_artifacts.md.C-hKR2hp.lean.js → reference_artifacts.md.BJpAI7h9.lean.js} +1 -1
  105. package/dist/docs/assets/reference_channels.md.CPWOpdsC.js +21 -0
  106. package/dist/docs/assets/{reference_channels.md.DsJfGSBJ.lean.js → reference_channels.md.CPWOpdsC.lean.js} +1 -1
  107. package/dist/docs/assets/reference_cli.md.DHm6DmYk.js +83 -0
  108. package/dist/docs/assets/reference_cli.md.DHm6DmYk.lean.js +1 -0
  109. package/dist/docs/assets/reference_connections.md.DoY4vrDH.js +54 -0
  110. package/dist/docs/assets/{reference_connections.md.BoAotr7_.lean.js → reference_connections.md.DoY4vrDH.lean.js} +1 -1
  111. package/dist/docs/assets/reference_evals.md.DgfUtfIc.js +69 -0
  112. package/dist/docs/assets/{reference_evals.md.2BXeMiO2.lean.js → reference_evals.md.DgfUtfIc.lean.js} +1 -1
  113. package/dist/docs/assets/{reference_extensions.md.DI5X5x8p.js → reference_extensions.md.DHbW6eOf.js} +6 -8
  114. package/dist/docs/assets/{reference_extensions.md.DI5X5x8p.lean.js → reference_extensions.md.DHbW6eOf.lean.js} +1 -1
  115. package/dist/docs/assets/reference_hooks.md.vbIM394-.js +39 -0
  116. package/dist/docs/assets/reference_hooks.md.vbIM394-.lean.js +1 -0
  117. package/dist/docs/assets/reference_http-api.md.C7Cb0r2J.js +7 -0
  118. package/dist/docs/assets/{reference_http-api.md._RWELr3d.lean.js → reference_http-api.md.C7Cb0r2J.lean.js} +1 -1
  119. package/dist/docs/assets/reference_instructions.md.CV6Qq0UX.js +14 -0
  120. package/dist/docs/assets/reference_instructions.md.CV6Qq0UX.lean.js +1 -0
  121. package/dist/docs/assets/reference_limits.md.CbdtFr4T.js +8 -0
  122. package/dist/docs/assets/reference_limits.md.CbdtFr4T.lean.js +1 -0
  123. package/dist/docs/assets/reference_memory.md.CdoJISM-.js +3 -0
  124. package/dist/docs/assets/{reference_memory.md.Dd7cyV9V.lean.js → reference_memory.md.CdoJISM-.lean.js} +1 -1
  125. package/dist/docs/assets/reference_playground.md.DIUsRAcy.js +1 -0
  126. package/dist/docs/assets/{reference_playground.md.CQiJk9CM.lean.js → reference_playground.md.DIUsRAcy.lean.js} +1 -1
  127. package/dist/docs/assets/reference_project-layout.md.9DiKoE16.js +26 -0
  128. package/dist/docs/assets/reference_project-layout.md.9DiKoE16.lean.js +1 -0
  129. package/dist/docs/assets/reference_schedules.md.Dd8_d0WG.js +45 -0
  130. package/dist/docs/assets/{reference_schedules.md.RC47aFm4.lean.js → reference_schedules.md.Dd8_d0WG.lean.js} +1 -1
  131. package/dist/docs/assets/reference_sessions.md.NXVQt9mP.js +22 -0
  132. package/dist/docs/assets/{reference_sessions.md.C7KFhWXV.lean.js → reference_sessions.md.NXVQt9mP.lean.js} +1 -1
  133. package/dist/docs/assets/{reference_skills.md.Dej2zQxi.js → reference_skills.md.DzCPNPkG.js} +4 -4
  134. package/dist/docs/assets/{reference_skills.md.Dej2zQxi.lean.js → reference_skills.md.DzCPNPkG.lean.js} +1 -1
  135. package/dist/docs/assets/reference_subagents.md.Dvpq2sUu.js +10 -0
  136. package/dist/docs/assets/{reference_subagents.md.CAhvW4yS.lean.js → reference_subagents.md.Dvpq2sUu.lean.js} +1 -1
  137. package/dist/docs/assets/reference_tools.md.B2OaR1Nb.js +62 -0
  138. package/dist/docs/assets/{reference_tools.md.DQr7Fnhu.lean.js → reference_tools.md.B2OaR1Nb.lean.js} +1 -1
  139. package/dist/docs/assets/templates_agentic-owners.md.B6ZmKAzT.js +13 -0
  140. package/dist/docs/assets/{templates_agentic-owners.md.Dh2nDSqg.lean.js → templates_agentic-owners.md.B6ZmKAzT.lean.js} +1 -1
  141. package/dist/docs/assets/templates_reviews.md.dr9Xv_KM.js +10 -0
  142. package/dist/docs/assets/templates_reviews.md.dr9Xv_KM.lean.js +1 -0
  143. package/dist/docs/assets/troubleshooting.md.DfKKvW1R.js +3 -0
  144. package/dist/docs/assets/{troubleshooting.md.CGOdNVAL.lean.js → troubleshooting.md.DfKKvW1R.lean.js} +1 -1
  145. package/dist/docs/building-with-agents.html +41 -44
  146. package/dist/docs/building-with-agents.md +11 -104
  147. package/dist/docs/changelog.html +37 -37
  148. package/dist/docs/changelog.md +14 -145
  149. package/dist/docs/deployment.html +54 -54
  150. package/dist/docs/deployment.md +97 -270
  151. package/dist/docs/evals.html +52 -71
  152. package/dist/docs/evals.md +33 -129
  153. package/dist/docs/guides/agent-to-agent.html +43 -43
  154. package/dist/docs/guides/agent-to-agent.md +29 -64
  155. package/dist/docs/guides/bitbucket.html +62 -62
  156. package/dist/docs/guides/bitbucket.md +73 -134
  157. package/dist/docs/guides/cloud-agents.html +37 -37
  158. package/dist/docs/guides/cloud-agents.md +23 -53
  159. package/dist/docs/guides/convert-automation.html +39 -56
  160. package/dist/docs/guides/convert-automation.md +31 -115
  161. package/dist/docs/guides/github.html +46 -54
  162. package/dist/docs/guides/github.md +49 -131
  163. package/dist/docs/guides/gitlab.html +98 -108
  164. package/dist/docs/guides/gitlab.md +104 -184
  165. package/dist/docs/guides/improve.html +38 -43
  166. package/dist/docs/guides/improve.md +24 -90
  167. package/dist/docs/guides/jev.html +55 -95
  168. package/dist/docs/guides/jev.md +53 -160
  169. package/dist/docs/guides/mcp-oauth.html +38 -40
  170. package/dist/docs/guides/mcp-oauth.md +33 -67
  171. package/dist/docs/guides/migrate.html +38 -43
  172. package/dist/docs/guides/migrate.md +56 -130
  173. package/dist/docs/guides/opentelemetry.html +41 -43
  174. package/dist/docs/guides/opentelemetry.md +32 -27
  175. package/dist/docs/guides/pagerduty.html +50 -49
  176. package/dist/docs/guides/pagerduty.md +65 -199
  177. package/dist/docs/guides/slack.html +51 -57
  178. package/dist/docs/guides/slack.md +76 -204
  179. package/dist/docs/guides/webhooks.html +42 -42
  180. package/dist/docs/guides/webhooks.md +64 -146
  181. package/dist/docs/hashmap.json +1 -1
  182. package/dist/docs/hillclimbing.html +40 -42
  183. package/dist/docs/hillclimbing.md +40 -102
  184. package/dist/docs/index.html +49 -61
  185. package/dist/docs/index.md +42 -82
  186. package/dist/docs/llms-full.txt +2272 -5711
  187. package/dist/docs/llms.txt +9 -14
  188. package/dist/docs/quickstart.html +95 -152
  189. package/dist/docs/quickstart.md +91 -180
  190. package/dist/docs/reference/access.html +36 -36
  191. package/dist/docs/reference/access.md +7 -12
  192. package/dist/docs/reference/agent-config.html +45 -58
  193. package/dist/docs/reference/agent-config.md +92 -176
  194. package/dist/docs/reference/artifacts.html +38 -39
  195. package/dist/docs/reference/artifacts.md +38 -62
  196. package/dist/docs/reference/channels.html +38 -39
  197. package/dist/docs/reference/channels.md +102 -151
  198. package/dist/docs/reference/cli.html +68 -84
  199. package/dist/docs/reference/cli.md +232 -697
  200. package/dist/docs/reference/connections.html +45 -57
  201. package/dist/docs/reference/connections.md +83 -164
  202. package/dist/docs/reference/evals.html +47 -54
  203. package/dist/docs/reference/evals.md +75 -141
  204. package/dist/docs/reference/extensions.html +41 -43
  205. package/dist/docs/reference/extensions.md +37 -70
  206. package/dist/docs/reference/hooks.html +40 -52
  207. package/dist/docs/reference/hooks.md +62 -133
  208. package/dist/docs/reference/http-api.html +38 -42
  209. package/dist/docs/reference/http-api.md +66 -118
  210. package/dist/docs/reference/instructions.html +39 -39
  211. package/dist/docs/reference/instructions.md +19 -29
  212. package/dist/docs/reference/limits.html +38 -38
  213. package/dist/docs/reference/limits.md +9 -21
  214. package/dist/docs/reference/memory.html +37 -38
  215. package/dist/docs/reference/memory.md +38 -75
  216. package/dist/docs/reference/playground.html +36 -36
  217. package/dist/docs/reference/playground.md +14 -22
  218. package/dist/docs/reference/project-layout.html +49 -48
  219. package/dist/docs/reference/project-layout.md +38 -84
  220. package/dist/docs/reference/schedules.html +44 -46
  221. package/dist/docs/reference/schedules.md +59 -90
  222. package/dist/docs/reference/sessions.html +37 -37
  223. package/dist/docs/reference/sessions.md +66 -113
  224. package/dist/docs/reference/skills.html +39 -39
  225. package/dist/docs/reference/skills.md +11 -31
  226. package/dist/docs/reference/subagents.html +37 -37
  227. package/dist/docs/reference/subagents.md +17 -31
  228. package/dist/docs/reference/tools.html +47 -64
  229. package/dist/docs/reference/tools.md +48 -130
  230. package/dist/docs/templates/agentic-owners.html +38 -38
  231. package/dist/docs/templates/agentic-owners.md +50 -74
  232. package/dist/docs/templates/reviews.html +69 -0
  233. package/dist/docs/templates/reviews.md +71 -0
  234. package/dist/docs/troubleshooting.html +38 -36
  235. package/dist/docs/troubleshooting.md +48 -101
  236. package/dist/filesystem.d.ts +7 -320
  237. package/dist/filesystem.d.ts.map +1 -1
  238. package/dist/filesystem.js +10 -691
  239. package/dist/index.d.ts +1 -1
  240. package/dist/index.d.ts.map +1 -1
  241. package/dist/index.js +1 -1
  242. package/dist/internal/authored-alias-hooks.d.ts +6 -0
  243. package/dist/internal/authored-alias-hooks.d.ts.map +1 -1
  244. package/dist/internal/authored-alias-hooks.js +12 -0
  245. package/dist/internal/authored-loaders.js +10 -1
  246. package/dist/internal/cli/commands/scaffold.js +1 -1
  247. package/dist/internal/cli-deploy.js +1 -1
  248. package/dist/internal/cli-docs.js +1 -1
  249. package/dist/internal/cli-images.js +1 -1
  250. package/dist/internal/cli-skills.js +1 -1
  251. package/dist/internal/continuation-session-ids.d.ts +15 -0
  252. package/dist/internal/continuation-session-ids.d.ts.map +1 -0
  253. package/dist/internal/continuation-session-ids.js +43 -0
  254. package/dist/internal/cursor/credentials.js +1 -1
  255. package/dist/internal/deploy-manifest.d.ts +1 -0
  256. package/dist/internal/deploy-manifest.d.ts.map +1 -1
  257. package/dist/internal/deploy-manifest.js +0 -1
  258. package/dist/internal/discovery/agent-config.d.ts +2 -6
  259. package/dist/internal/discovery/agent-config.d.ts.map +1 -1
  260. package/dist/internal/discovery/agent-config.js +8 -25
  261. package/dist/internal/discovery/agent.d.ts.map +1 -1
  262. package/dist/internal/discovery/agent.js +2 -3
  263. package/dist/internal/discovery/project.d.ts.map +1 -1
  264. package/dist/internal/discovery/project.js +15 -0
  265. package/dist/internal/filesystem/walk.d.ts +1 -5
  266. package/dist/internal/filesystem/walk.d.ts.map +1 -1
  267. package/dist/internal/filesystem/walk.js +1 -9
  268. package/dist/internal/hosted-catch-protocol.d.ts +3 -3
  269. package/dist/internal/hosted-catch-protocol.js +3 -3
  270. package/dist/internal/hosted-fetch.d.ts +7 -0
  271. package/dist/internal/hosted-fetch.d.ts.map +1 -0
  272. package/dist/internal/hosted-fetch.js +26 -0
  273. package/dist/internal/init-project.d.ts.map +1 -1
  274. package/dist/internal/init-project.js +7 -5
  275. package/dist/internal/install-cursor-skills.d.ts +5 -6
  276. package/dist/internal/install-cursor-skills.d.ts.map +1 -1
  277. package/dist/internal/install-cursor-skills.js +19 -4
  278. package/dist/internal/mcp-endpoint.js +4 -4
  279. package/dist/internal/model-config.d.ts.map +1 -1
  280. package/dist/internal/model-config.js +11 -4
  281. package/dist/internal/platform-timers.d.ts +3 -7
  282. package/dist/internal/platform-timers.d.ts.map +1 -1
  283. package/dist/internal/platform-timers.js +10 -51
  284. package/dist/internal/reminder-runner.js +1 -1
  285. package/dist/internal/server.d.ts.map +1 -1
  286. package/dist/internal/server.js +6 -1
  287. package/dist/internal/session-engine.d.ts +3 -0
  288. package/dist/internal/session-engine.d.ts.map +1 -1
  289. package/dist/internal/session-engine.js +13 -4
  290. package/dist/internal/shallow-clone.js +1 -1
  291. package/dist/playground/assets/index-Bno25Cg0.css +1 -0
  292. package/dist/playground/assets/index-SGKsaznh.js +62 -0
  293. package/dist/playground/index.html +2 -2
  294. package/dist/types.d.ts +6 -17
  295. package/dist/types.d.ts.map +1 -1
  296. package/dist/types.js +2 -2
  297. package/docs/README.md +42 -82
  298. package/docs/building-with-agents.md +11 -104
  299. package/docs/changelog.md +15 -146
  300. package/docs/deployment.md +97 -270
  301. package/docs/evals.md +34 -130
  302. package/docs/guides/agent-to-agent.md +29 -64
  303. package/docs/guides/bitbucket.md +73 -134
  304. package/docs/guides/cloud-agents.md +23 -53
  305. package/docs/guides/convert-automation.md +31 -115
  306. package/docs/guides/github.md +49 -131
  307. package/docs/guides/gitlab.md +104 -184
  308. package/docs/guides/improve.md +24 -90
  309. package/docs/guides/jev.md +53 -160
  310. package/docs/guides/mcp-oauth.md +33 -67
  311. package/docs/guides/migrate.md +56 -130
  312. package/docs/guides/opentelemetry.md +37 -27
  313. package/docs/guides/pagerduty.md +68 -200
  314. package/docs/guides/slack.md +76 -204
  315. package/docs/guides/webhooks.md +64 -146
  316. package/docs/hillclimbing.md +41 -103
  317. package/docs/quickstart.md +91 -180
  318. package/docs/reference/access.md +7 -12
  319. package/docs/reference/agent-config.md +92 -176
  320. package/docs/reference/artifacts.md +38 -62
  321. package/docs/reference/channels.md +102 -151
  322. package/docs/reference/cli.md +232 -697
  323. package/docs/reference/connections.md +83 -164
  324. package/docs/reference/evals.md +75 -141
  325. package/docs/reference/extensions.md +37 -70
  326. package/docs/reference/hooks.md +61 -132
  327. package/docs/reference/http-api.md +66 -118
  328. package/docs/reference/instructions.md +20 -30
  329. package/docs/reference/limits.md +10 -22
  330. package/docs/reference/memory.md +38 -75
  331. package/docs/reference/playground.md +14 -22
  332. package/docs/reference/project-layout.md +38 -84
  333. package/docs/reference/schedules.md +59 -90
  334. package/docs/reference/sessions.md +66 -113
  335. package/docs/reference/skills.md +12 -32
  336. package/docs/reference/subagents.md +17 -31
  337. package/docs/reference/tools.md +48 -130
  338. package/docs/templates/agentic-owners.md +50 -74
  339. package/docs/templates/reviews.md +76 -0
  340. package/docs/troubleshooting.md +48 -101
  341. package/package.json +4 -4
  342. package/skills/cli/SKILL.md +1 -1
  343. package/skills/create-agent/SKILL.md +61 -7
  344. package/skills/debug/SKILL.md +1 -1
  345. package/skills/deploy/SKILL.md +3 -3
  346. package/skills/evals/SKILL.md +1 -1
  347. package/skills/framework-map/SKILL.md +2 -2
  348. package/skills/github/SKILL.md +1 -1
  349. package/skills/hillclimb/SKILL.md +1 -1
  350. package/skills/mcp-auth/SKILL.md +1 -1
  351. package/skills/migrate-v2/SKILL.md +2 -3
  352. package/skills/otel/SKILL.md +1 -1
  353. package/skills/setup-slack/SKILL.md +2 -2
  354. package/dist/docs/assets/building-with-agents.md.Bf1yH2tG.js +0 -9
  355. package/dist/docs/assets/changelog.md.DrLFQUlu.js +0 -1
  356. package/dist/docs/assets/changelog.md.DrLFQUlu.lean.js +0 -1
  357. package/dist/docs/assets/chunks/@localSearchIndexroot.Dpd_wxVU.js +0 -1
  358. package/dist/docs/assets/chunks/channel._fZX_hvU.js +0 -1
  359. package/dist/docs/assets/chunks/classDiagram-6PBFFD2Q.eClS1Q0E.js +0 -1
  360. package/dist/docs/assets/chunks/classDiagram-v2-HSJHXN6E.eClS1Q0E.js +0 -1
  361. package/dist/docs/assets/chunks/clone.W1Phdw9P.js +0 -1
  362. package/dist/docs/assets/chunks/stateDiagram-v2-QKLJ7IA2.77yf4kRr.js +0 -1
  363. package/dist/docs/assets/deployment.md.KW0Ni_rY.js +0 -31
  364. package/dist/docs/assets/evals.md.DiljU__Z.js +0 -68
  365. package/dist/docs/assets/evals.md.DiljU__Z.lean.js +0 -1
  366. package/dist/docs/assets/guides_agent-to-agent.md.D1D5f6Jc.lean.js +0 -1
  367. package/dist/docs/assets/guides_cloud-agents.md.Ceyjv0ul.js +0 -9
  368. package/dist/docs/assets/guides_convert-automation.md.BjraCvok.js +0 -43
  369. package/dist/docs/assets/guides_hooks.md.BjeEiM7s.js +0 -54
  370. package/dist/docs/assets/guides_hooks.md.BjeEiM7s.lean.js +0 -1
  371. package/dist/docs/assets/guides_improve.md.BFYtrtLE.js +0 -21
  372. package/dist/docs/assets/guides_migrate.md.RS9Eu-Xh.js +0 -8
  373. package/dist/docs/assets/guides_opentelemetry.md.CoZ1kNyd.js +0 -28
  374. package/dist/docs/assets/guides_opentelemetry.md.CoZ1kNyd.lean.js +0 -1
  375. package/dist/docs/assets/guides_pagerduty.md.mnKXe9U0.js +0 -60
  376. package/dist/docs/assets/guides_pagerduty.md.mnKXe9U0.lean.js +0 -1
  377. package/dist/docs/assets/guides_slack.md.BwXHURvY.js +0 -88
  378. package/dist/docs/assets/hillclimbing.md.By61f3uq.js +0 -7
  379. package/dist/docs/assets/hillclimbing.md.By61f3uq.lean.js +0 -1
  380. package/dist/docs/assets/index.md.CAruw_rp.js +0 -26
  381. package/dist/docs/assets/index.md.CAruw_rp.lean.js +0 -1
  382. package/dist/docs/assets/quickstart.md.CljDaJBi.js +0 -170
  383. package/dist/docs/assets/reference_access.md.CEtibb4i.js +0 -1
  384. package/dist/docs/assets/reference_access.md.CEtibb4i.lean.js +0 -1
  385. package/dist/docs/assets/reference_agent-config.md.Ck29qYNj.js +0 -40
  386. package/dist/docs/assets/reference_artifacts.md.C-hKR2hp.js +0 -18
  387. package/dist/docs/assets/reference_channels.md.DsJfGSBJ.js +0 -22
  388. package/dist/docs/assets/reference_cli.md.BkdLRbXg.js +0 -99
  389. package/dist/docs/assets/reference_cli.md.BkdLRbXg.lean.js +0 -1
  390. package/dist/docs/assets/reference_connections.md.BoAotr7_.js +0 -66
  391. package/dist/docs/assets/reference_evals.md.2BXeMiO2.js +0 -76
  392. package/dist/docs/assets/reference_hooks.md.B-bwJuiG.js +0 -51
  393. package/dist/docs/assets/reference_hooks.md.B-bwJuiG.lean.js +0 -1
  394. package/dist/docs/assets/reference_http-api.md._RWELr3d.js +0 -11
  395. package/dist/docs/assets/reference_instructions.md.yL2hXLnl.js +0 -14
  396. package/dist/docs/assets/reference_instructions.md.yL2hXLnl.lean.js +0 -1
  397. package/dist/docs/assets/reference_limits.md.BCCnvt3o.js +0 -8
  398. package/dist/docs/assets/reference_limits.md.BCCnvt3o.lean.js +0 -1
  399. package/dist/docs/assets/reference_memory.md.Dd7cyV9V.js +0 -4
  400. package/dist/docs/assets/reference_playground.md.CQiJk9CM.js +0 -1
  401. package/dist/docs/assets/reference_project-layout.md.BamcPDUn.js +0 -25
  402. package/dist/docs/assets/reference_project-layout.md.BamcPDUn.lean.js +0 -1
  403. package/dist/docs/assets/reference_prompt.md.BMjm1Jp3.js +0 -9
  404. package/dist/docs/assets/reference_prompt.md.BMjm1Jp3.lean.js +0 -1
  405. package/dist/docs/assets/reference_schedules.md.RC47aFm4.js +0 -47
  406. package/dist/docs/assets/reference_sessions.md.C7KFhWXV.js +0 -22
  407. package/dist/docs/assets/reference_subagents.md.CAhvW4yS.js +0 -10
  408. package/dist/docs/assets/reference_tools.md.DQr7Fnhu.js +0 -79
  409. package/dist/docs/assets/templates_agentic-owners.md.Dh2nDSqg.js +0 -13
  410. package/dist/docs/assets/templates_security-reviewer.md.DnwXdnB5.js +0 -3
  411. package/dist/docs/assets/templates_security-reviewer.md.DnwXdnB5.lean.js +0 -1
  412. package/dist/docs/assets/templates_thermo-quality-review.md.MJIdHkzE.js +0 -3
  413. package/dist/docs/assets/templates_thermo-quality-review.md.MJIdHkzE.lean.js +0 -1
  414. package/dist/docs/assets/templates_thermo-review.md.DfN1OFOl.js +0 -3
  415. package/dist/docs/assets/templates_thermo-review.md.DfN1OFOl.lean.js +0 -1
  416. package/dist/docs/assets/templates_triage.md.BYWMloV4.js +0 -9
  417. package/dist/docs/assets/templates_triage.md.BYWMloV4.lean.js +0 -1
  418. package/dist/docs/assets/troubleshooting.md.CGOdNVAL.js +0 -1
  419. package/dist/docs/guides/hooks.html +0 -113
  420. package/dist/docs/guides/hooks.md +0 -116
  421. package/dist/docs/package/skills/create-agent/SKILL.md +0 -178
  422. package/dist/docs/package/skills/evals/SKILL.md +0 -145
  423. package/dist/docs/package/skills/github/SKILL.md +0 -133
  424. package/dist/docs/package/skills/hillclimb/SKILL.md +0 -63
  425. package/dist/docs/package/skills/mcp-auth/SKILL.md +0 -60
  426. package/dist/docs/package/skills/migrate-v2/SKILL.md +0 -394
  427. package/dist/docs/package/skills/setup-slack/SKILL.md +0 -136
  428. package/dist/docs/reference/prompt.html +0 -68
  429. package/dist/docs/reference/prompt.md +0 -47
  430. package/dist/docs/templates/security-reviewer.html +0 -62
  431. package/dist/docs/templates/security-reviewer.md +0 -81
  432. package/dist/docs/templates/thermo-quality-review.html +0 -62
  433. package/dist/docs/templates/thermo-quality-review.md +0 -75
  434. package/dist/docs/templates/thermo-review.html +0 -62
  435. package/dist/docs/templates/thermo-review.md +0 -75
  436. package/dist/docs/templates/triage.html +0 -68
  437. package/dist/docs/templates/triage.md +0 -101
  438. package/dist/internal/filesystem/errors.d.ts +0 -64
  439. package/dist/internal/filesystem/errors.d.ts.map +0 -1
  440. package/dist/internal/filesystem/errors.js +0 -180
  441. package/dist/internal/filesystem/merge.d.ts +0 -34
  442. package/dist/internal/filesystem/merge.d.ts.map +0 -1
  443. package/dist/internal/filesystem/merge.js +0 -154
  444. package/dist/playground/assets/index-Cl9zvmmf.js +0 -62
  445. package/dist/playground/assets/index-F8b5WvWi.css +0 -1
  446. package/docs/guides/hooks.md +0 -121
  447. package/docs/reference/prompt.md +0 -52
  448. package/docs/templates/security-reviewer.md +0 -86
  449. package/docs/templates/thermo-quality-review.md +0 -80
  450. package/docs/templates/thermo-review.md +0 -80
  451. 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.4.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": {
@@ -281,7 +281,7 @@
281
281
  },
282
282
  "dependencies": {
283
283
  "@bazel/runfiles": "6.5.0",
284
- "@cursor/sdk": "1.0.38",
284
+ "@cursor/sdk": "1.1.0",
285
285
  "@modelcontextprotocol/sdk": "^1.32.1",
286
286
  "@octokit/auth-app": "^7.2.0",
287
287
  "@octokit/rest": "^21.1.1",
@@ -351,12 +351,12 @@
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",
358
358
  "yaml": "^2.4.2",
359
- "zod": "4.6.5",
359
+ "zod": "4.6.7",
360
360
  "zustand": "^5.0.9"
361
361
  },
362
362
  "scripts": {
@@ -1,5 +1,5 @@
1
1
  ---
2
- name: bdk-cli
2
+ name: agent-sdk-cli
3
3
  description: >-
4
4
  Guardrails for running the BDK CLI from an agent: --json output,
5
5
  exit codes, --fields and --limit, --dry-run before every change,
@@ -1,5 +1,5 @@
1
1
  ---
2
- name: bdk-create-agent
2
+ name: agent-sdk-create-agent
3
3
  description: >-
4
4
  Scaffold a new Agent SDK agent: short AskQuestion interview, then
5
5
  verify a turn and hand off to hillclimb. Use when creating a new
@@ -8,11 +8,14 @@ description: >-
8
8
 
9
9
  # Create an Agent SDK agent
10
10
 
11
- 1. **Interview.** Two `AskQuestion` rounds, then a plan gate.
12
- 2. **Scaffold.** `agent-sdk init`, then shape the files.
13
- 3. **Verify.** `validate` / `info` / `tool call`, then a model turn.
14
- 4. **Channels.** Slack, GitHub, webhook, or schedule as chosen.
15
- 5. **Hillclimb.** `skills/hillclimb/SKILL.md`.
11
+ 1. **Sign in.** `agent-sdk whoami`. Run `agent-sdk login` only
12
+ when it reports no credential.
13
+ 2. **Interview.** Two `AskQuestion` rounds, then a plan gate.
14
+ 3. **Scaffold.** `agent-sdk init`, then shape the files.
15
+ 4. **Verify.** `validate` / `info` / `tool call`, then a model turn.
16
+ 5. **Channels.** Slack, GitHub, webhook, or schedule as chosen.
17
+ 6. **Report.** What it does, how to test it, how to deploy it.
18
+ 7. **Hillclimb.** `skills/hillclimb/SKILL.md`.
16
19
 
17
20
  Read `skills/framework-map/SKILL.md` if you have not. CLI is
18
21
  `agent-sdk`. Public docs:
@@ -46,12 +49,16 @@ on a running host.
46
49
 
47
50
  | Question | Options | Guidance |
48
51
  | --- | --- | --- |
49
- | **Model** | `grok-4.5` + `effort=high`, `fast=true` · Other id | Params, not id suffixes: `{ id: "grok-4.5", params: [{ id: "effort", value: "high" }, { id: "fast", value: "true" }] }` |
52
+ | **Model** | `grok-4.7` + `reasoning_effort=high`, `fast=true` · Other id | Params, not id suffixes: `{ id: "grok-4.7", params: [{ id: "reasoning_effort", value: "high" }, { id: "fast", value: "true" }] }` |
50
53
  | **Channels** (multi) | playground + HTTP (always on) · Slack · GitHub · custom webhook · schedule | Slack: `skills/setup-slack/SKILL.md`. GitHub: `skills/github/SKILL.md`. No Discord/Teams pack; offer custom webhook. |
51
54
  | **MCP** (multi) | none · remote URL · local stdio · Cursor account connectors · Other | One file under `bot/mcp-connections/`. Account file is `account.ts`, never `cursor.ts`. Named local tools need `advertiseTools: true`. Privileged servers go in `bot/host-connections/`. |
52
55
  | **Capabilities** (multi) | server tools · agent tools · skills · subagents · hooks · sandbox seeds · evals (recommend) | Always recommend one smoke eval. |
53
56
  <!-- interview:end -->
54
57
 
58
+ Location: inside a git checkout, recommend a new folder outside
59
+ it. `init` runs `npm install`, which breaks a pnpm or yarn
60
+ workspace.
61
+
55
62
  Close with the plan and file tree, then "Scaffold it" / "Adjust
56
63
  something". Write files only after approval.
57
64
 
@@ -154,6 +161,18 @@ agent-sdk eval --dir ./<slug>
154
161
  Serve only this agent's directory. Session files land in the
155
162
  project state directory (`--state-root`). That is not harness cwd.
156
163
 
164
+ Finish gate. Before the report, these pass. Fix each error first:
165
+
166
+ ```bash
167
+ agent-sdk validate --dir ./<slug>
168
+ npx tsc --noEmit -p ./<slug>
169
+ agent-sdk run --dir ./<slug> --message "<realistic first message>"
170
+ ```
171
+
172
+ Show the reply word for word. Without a credential, `run` may fail
173
+ with only the API-key error. Then write the report anyway, and put
174
+ the hand-over commands above in "Test it locally".
175
+
157
176
  ## Channel setup
158
177
 
159
178
  - **Slack.** `skills/setup-slack/SKILL.md`
@@ -166,6 +185,41 @@ project state directory (`--state-root`). That is not harness cwd.
166
185
  - **Schedules.** Never auto-fire under `--dev`.
167
186
  `POST /v1/dev/schedules/<id>`.
168
187
 
188
+ ## Report
189
+
190
+ End with this report. Write it in ASD-STE100 Simplified Technical
191
+ English: short sentences, active voice, one instruction per step.
192
+ Fill in the real slug, env prefix, and commands.
193
+
194
+ ```markdown
195
+ ## What the agent does
196
+
197
+ - 3 to 5 short bullets.
198
+
199
+ ## Test it locally
200
+
201
+ Commands for `agent-sdk dev ./<slug>` (playground URL) and
202
+ `agent-sdk eval --dir ./<slug>`, and what the person sees.
203
+
204
+ ## Deploy it
205
+
206
+ 1. If the project is not in a git repository, create one and
207
+ add a remote.
208
+ 2. Commit the project and push it to a branch.
209
+ 3. Slack only: run `agent-sdk slack create --dir ./<slug> --env prod`.
210
+ 4. Run `agent-sdk validate --dir ./<slug>`, then
211
+ `agent-sdk deploy --dir ./<slug> --dry-run`.
212
+ 5. Run `agent-sdk deploy --dir ./<slug>` in your own terminal.
213
+ The first deploy prints an alias token one time. Save it in
214
+ a password manager.
215
+ 6. Run `agent-sdk session create --slug <slug> --message "<test>" --wait`.
216
+ 7. Manage the agent at https://cursor.com/dashboard/deployed-agents.
217
+ ```
218
+
219
+ Do not deploy, push, or create the prod Slack app unless the
220
+ person asks. Hand the first deploy to the person, so the alias
221
+ token stays out of your transcript.
222
+
169
223
  ## Hillclimb handoff
170
224
 
171
225
  Once a smoke turn passes, agree fixtures, success criteria, and a
@@ -1,5 +1,5 @@
1
1
  ---
2
- name: bdk-debug
2
+ name: agent-sdk-debug
3
3
  description: >-
4
4
  Diagnose a misbehaving local Agent SDK agent: blank playground,
5
5
  missing sessions, failed reads, webhook 401s, 403/409. Use when
@@ -1,5 +1,5 @@
1
1
  ---
2
- name: bdk-deploy
2
+ name: agent-sdk-deploy
3
3
  description: >-
4
4
  Deploy or redeploy an Agent SDK project to Cursor-managed hosting
5
5
  with an attached service account. Use when asked to deploy,
@@ -14,7 +14,7 @@ pushed Git ref to Cursor-managed hosting. Local files never upload.
14
14
  Use the package name and version embedded in the installed skill. Do not
15
15
  use a floating npm tag or a workspace build of the CLI.
16
16
 
17
- Follow the `bdk-cli` skill for `--json`, exit codes, `--fields`, and
17
+ Follow the `agent-sdk-cli` skill for `--json`, exit codes, `--fields`, and
18
18
  `--dry-run`.
19
19
 
20
20
  ## Gather the target
@@ -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.4.0"
43
43
  BDK_PACKAGE="@grok/agent-sdk"
44
44
  case "$BDK_VERSION" in
45
45
  __BDK_V*)
@@ -1,5 +1,5 @@
1
1
  ---
2
- name: bdk-evals
2
+ name: agent-sdk-evals
3
3
  description: >-
4
4
  Author and run defineEval cases. Use when writing, fixing, seeding,
5
5
  or hillclimbing evals. Ask whether to generate samples or take
@@ -1,5 +1,5 @@
1
1
  ---
2
- name: bdk-framework-map
2
+ name: agent-sdk-framework-map
3
3
  description: >-
4
4
  Orient on Agent SDK layout, local runtime, sessions, and
5
5
  invariants (Node not Bun, root evals/, typecheck after tsx,
@@ -13,7 +13,7 @@ description: >-
13
13
  over HTTP, Slack, and GitHub. Markdown is prose. TypeScript is typed
14
14
  behavior. Ground truth: package `README.md` and `AGENTS.md`.
15
15
 
16
- CLI is `agent-sdk` (Node, never Bun). Follow the `bdk-cli` skill before you
16
+ CLI is `agent-sdk` (Node, never Bun). Follow the `agent-sdk-cli` skill before you
17
17
  run an `agent-sdk` command.
18
18
 
19
19
  Public docs: `node_modules/@grok/agent-sdk/dist/docs/llms.txt` or
@@ -1,5 +1,5 @@
1
1
  ---
2
- name: bdk-github
2
+ name: agent-sdk-github
3
3
  description: >-
4
4
  Build and test GitHub-driven Agent SDK agents: githubChannel hooks
5
5
  (auth turn vs host task), cursorAccount / --cursor-events, and
@@ -1,5 +1,5 @@
1
1
  ---
2
- name: bdk-hillclimb
2
+ name: agent-sdk-hillclimb
3
3
  description: >-
4
4
  Improve one existing Agent SDK agent: pin fixtures, measure, change
5
5
  one lever, remeasure, lock the win with an eval. Use when an agent
@@ -1,5 +1,5 @@
1
1
  ---
2
- name: bdk-mcp-auth
2
+ name: agent-sdk-mcp-auth
3
3
  description: >-
4
4
  Authorize host MCP OAuth for defineConnection({ url, oauth: true }):
5
5
  agent-sdk mcp oauth, local tokens, advertiseTools, egress, and the hosted
@@ -1,5 +1,5 @@
1
1
  ---
2
- name: bdk-migrate-v2
2
+ name: agent-sdk-migrate-v2
3
3
  description: >-
4
4
  Migrate an Agent SDK project from hosted architecture v1 to v2: upgrade the
5
5
  package, remove v1-only code, and redeploy. Applies only to projects
@@ -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. |
@@ -107,7 +106,7 @@ still loads.
107
106
  Commit the lockfile the install writes, since deploys build from Git.
108
107
  Rewrite every `@cursor/july` import to `@grok/agent-sdk`; subpaths such as
109
108
  `/channels/slack`, `/evals`, and `/reminders` keep their names. Replace
110
- the legacy CLI command with `bdk` in scripts, CI jobs, and READMEs.
109
+ the legacy CLI command with `agent-sdk` in scripts, CI jobs, and READMEs.
111
110
 
112
111
  The new types are stricter. `ctx.session.continuationKey` is
113
112
  `string | null`, so guard with `typeof key === "string"`, not
@@ -1,5 +1,5 @@
1
1
  ---
2
- name: bdk-otel
2
+ name: agent-sdk-otel
3
3
  description: >-
4
4
  Wire OpenTelemetry export with OTEL_* environment variables.
5
5
  Use when adding a collector, headers, or metrics temporality.
@@ -1,5 +1,5 @@
1
1
  ---
2
- name: bdk-setup-slack
2
+ name: agent-sdk-setup-slack
3
3
  description: >-
4
4
  Wire Slack to an Agent SDK agent. Mint a dedicated Socket Mode app
5
5
  with slack create, then doctor and smoke. Use slack init --manual
@@ -35,7 +35,7 @@ approve Slack, pick the bot name. CLI writes
35
35
  Prefix is the directory basename in upper snake (`jenny` →
36
36
  `JENNY`, `pr-approver` → `PR_APPROVER` → `PR_APPROVER_SLACK_*`).
37
37
  `--prefix` / `--no-prefix` override. Dev and prod are separate
38
- apps; `--prod` is the prod app. `--name` / `--icon` /
38
+ apps; `--env prod` is the prod app. `--name` / `--icon` /
39
39
  `--channel-posts` / `--slack-team` prefill the wizard.
40
40
 
41
41
  If Slack needs workspace-admin approval, keep the CLI running.
@@ -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};