@grok/agent-sdk 0.2.28 → 0.2.29

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 (339) hide show
  1. package/AGENTS.md +29 -29
  2. package/dist/bin/agent-serve.d.ts +2 -2
  3. package/dist/bin/agent-serve.js +3 -3
  4. package/dist/channels/pagerduty/api.js +1 -1
  5. package/dist/channels/pagerduty/pagerduty-channel.d.ts +1 -1
  6. package/dist/channels/pagerduty/pagerduty-channel.d.ts.map +1 -1
  7. package/dist/channels/pagerduty/pagerduty-channel.js +1 -1
  8. package/dist/channels/pagerduty/replay.d.ts +1 -1
  9. package/dist/channels/pagerduty/replay.js +4 -4
  10. package/dist/docs/404.html +2 -2
  11. package/dist/docs/assets/{app.DF9vlcdn.js → app.DMrZKFjI.js} +4 -4
  12. package/dist/docs/assets/changelog.md.DrLFQUlu.js +1 -0
  13. package/dist/docs/assets/changelog.md.DrLFQUlu.lean.js +1 -0
  14. package/dist/docs/assets/chunks/@localSearchIndexroot.Dpd_wxVU.js +1 -0
  15. package/dist/docs/assets/chunks/{VPLocalSearchBox.D8OuwKO0.js → VPLocalSearchBox.DQvuw1KA.js} +1 -1
  16. package/dist/docs/assets/chunks/{arc.DCq_TCYV.js → arc.ahOG-Qza.js} +1 -1
  17. package/dist/docs/assets/chunks/{architectureDiagram-Q4EWVU46.PWRNTPbk.js → architectureDiagram-Q4EWVU46.BcgfYNO_.js} +1 -1
  18. package/dist/docs/assets/chunks/{baseUniq.BeRPvRUL.js → baseUniq.DeIYZrWh.js} +1 -1
  19. package/dist/docs/assets/chunks/{blockDiagram-DXYQGD6D.BuRmZVSo.js → blockDiagram-DXYQGD6D.HjJ2goMX.js} +1 -1
  20. package/dist/docs/assets/chunks/{c4Diagram-AHTNJAMY.7DKSMwuv.js → c4Diagram-AHTNJAMY.C1QTb9GM.js} +1 -1
  21. package/dist/docs/assets/chunks/channel._fZX_hvU.js +1 -0
  22. package/dist/docs/assets/chunks/{chunk-4BX2VUAB.7VrO9-9i.js → chunk-4BX2VUAB.UuZiDiVp.js} +1 -1
  23. package/dist/docs/assets/chunks/{chunk-4TB4RGXK.CHystNE2.js → chunk-4TB4RGXK.5A3YmkhI.js} +1 -1
  24. package/dist/docs/assets/chunks/{chunk-55IACEB6.Nuh9TbTq.js → chunk-55IACEB6.B4uf1yYV.js} +1 -1
  25. package/dist/docs/assets/chunks/{chunk-EDXVE4YY.CA0EKugm.js → chunk-EDXVE4YY.CoXBce8t.js} +1 -1
  26. package/dist/docs/assets/chunks/{chunk-FMBD7UC4.F9_mp7U8.js → chunk-FMBD7UC4.DnC5NO4e.js} +1 -1
  27. package/dist/docs/assets/chunks/{chunk-OYMX7WX6.CEU4QfE1.js → chunk-OYMX7WX6.CzfHCeIi.js} +1 -1
  28. package/dist/docs/assets/chunks/{chunk-QZHKN3VN.B8h_x9_i.js → chunk-QZHKN3VN.C6tcwkVd.js} +1 -1
  29. package/dist/docs/assets/chunks/{chunk-YZCP3GAM.Btfb-rKg.js → chunk-YZCP3GAM._oboyZ1A.js} +1 -1
  30. package/dist/docs/assets/chunks/classDiagram-6PBFFD2Q.eClS1Q0E.js +1 -0
  31. package/dist/docs/assets/chunks/classDiagram-v2-HSJHXN6E.eClS1Q0E.js +1 -0
  32. package/dist/docs/assets/chunks/clone.W1Phdw9P.js +1 -0
  33. package/dist/docs/assets/chunks/{cose-bilkent-S5V4N54A.DKvc96Wa.js → cose-bilkent-S5V4N54A.BfPVKeId.js} +1 -1
  34. package/dist/docs/assets/chunks/{dagre-KV5264BT.CMo0cy1b.js → dagre-KV5264BT.CLMLc0lD.js} +1 -1
  35. package/dist/docs/assets/chunks/{diagram-5BDNPKRD.DDgMOQhB.js → diagram-5BDNPKRD.C7OF7UfH.js} +1 -1
  36. package/dist/docs/assets/chunks/{diagram-G4DWMVQ6.BdJnoIsU.js → diagram-G4DWMVQ6.Dpao0Bl1.js} +1 -1
  37. package/dist/docs/assets/chunks/{diagram-MMDJMWI5.oSvhAZaL.js → diagram-MMDJMWI5.DLnM9eLp.js} +1 -1
  38. package/dist/docs/assets/chunks/{diagram-TYMM5635.C9zZLIE-.js → diagram-TYMM5635.BcpVgA_M.js} +1 -1
  39. package/dist/docs/assets/chunks/{erDiagram-SMLLAGMA.BNhVyccy.js → erDiagram-SMLLAGMA.CsL5JuCV.js} +1 -1
  40. package/dist/docs/assets/chunks/{flowDiagram-DWJPFMVM.BEFLLBiU.js → flowDiagram-DWJPFMVM.MFihq9AF.js} +1 -1
  41. package/dist/docs/assets/chunks/{ganttDiagram-T4ZO3ILL.BdUzXBgY.js → ganttDiagram-T4ZO3ILL.CJeLodyG.js} +1 -1
  42. package/dist/docs/assets/chunks/{gitGraphDiagram-UUTBAWPF.Rd3LlOIJ.js → gitGraphDiagram-UUTBAWPF.1HhlE45Z.js} +1 -1
  43. package/dist/docs/assets/chunks/{graph.DnJC1GpG.js → graph.BS02KkWA.js} +1 -1
  44. package/dist/docs/assets/chunks/{infoDiagram-42DDH7IO.xv0xntDJ.js → infoDiagram-42DDH7IO.fp5gvytQ.js} +1 -1
  45. package/dist/docs/assets/chunks/{ishikawaDiagram-UXIWVN3A.BaGIlviU.js → ishikawaDiagram-UXIWVN3A.C6Wk1V4I.js} +1 -1
  46. package/dist/docs/assets/chunks/{journeyDiagram-VCZTEJTY.Cof_h0fp.js → journeyDiagram-VCZTEJTY.qJt4uJ_H.js} +1 -1
  47. package/dist/docs/assets/chunks/{kanban-definition-6JOO6SKY.C5GozFuU.js → kanban-definition-6JOO6SKY.z2tG9kly.js} +1 -1
  48. package/dist/docs/assets/chunks/{layout.zc9UShLc.js → layout.BPCkdejr.js} +1 -1
  49. package/dist/docs/assets/chunks/{linear.BoqrFVcJ.js → linear.CL3TC3u7.js} +1 -1
  50. package/dist/docs/assets/chunks/{min.DwIfr8hG.js → min.SPrSp704.js} +1 -1
  51. package/dist/docs/assets/chunks/{mindmap-definition-QFDTVHPH.Dkq2yTtp.js → mindmap-definition-QFDTVHPH.DgrQRFZW.js} +1 -1
  52. package/dist/docs/assets/chunks/{pieDiagram-DEJITSTG.B4CpTmHK.js → pieDiagram-DEJITSTG.Ba7yxiW2.js} +1 -1
  53. package/dist/docs/assets/chunks/{quadrantDiagram-34T5L4WZ.BqXnFC9C.js → quadrantDiagram-34T5L4WZ.Bvskad4p.js} +1 -1
  54. package/dist/docs/assets/chunks/{requirementDiagram-MS252O5E.DhIN2z-E.js → requirementDiagram-MS252O5E.Ce70ugV9.js} +1 -1
  55. package/dist/docs/assets/chunks/{sankeyDiagram-XADWPNL6.BhxUAmg2.js → sankeyDiagram-XADWPNL6.BJ5OEULO.js} +1 -1
  56. package/dist/docs/assets/chunks/{sequenceDiagram-FGHM5R23.BqgU7HU-.js → sequenceDiagram-FGHM5R23.C8a1hDs6.js} +1 -1
  57. package/dist/docs/assets/chunks/{stateDiagram-FHFEXIEX.B1BCO18N.js → stateDiagram-FHFEXIEX.D2D8A5CK.js} +1 -1
  58. package/dist/docs/assets/chunks/stateDiagram-v2-QKLJ7IA2.77yf4kRr.js +1 -0
  59. package/dist/docs/assets/chunks/{theme.oV7rddEz.js → theme.DRciHmS1.js} +2 -2
  60. package/dist/docs/assets/chunks/{timeline-definition-GMOUNBTQ.oRI8UwMC.js → timeline-definition-GMOUNBTQ.C4ePrY8-.js} +1 -1
  61. package/dist/docs/assets/chunks/{vennDiagram-DHZGUBPP.DmuWrIxN.js → vennDiagram-DHZGUBPP.Dzso6dEA.js} +1 -1
  62. package/dist/docs/assets/chunks/{wardley-RL74JXVD.CEBjM5ov.js → wardley-RL74JXVD.djgXR0ar.js} +1 -1
  63. package/dist/docs/assets/chunks/{wardleyDiagram-NUSXRM2D.m5zsCOF9.js → wardleyDiagram-NUSXRM2D.Bf2ICxjh.js} +1 -1
  64. package/dist/docs/assets/chunks/{xychartDiagram-5P7HB3ND.cPN-587n.js → xychartDiagram-5P7HB3ND.DEH4BcVJ.js} +1 -1
  65. package/dist/docs/assets/{deployment.md.DDmjAVbg.js → deployment.md.KW0Ni_rY.js} +5 -5
  66. package/dist/docs/assets/{evals.md.OjKb7tNA.js → evals.md.DiljU__Z.js} +1 -1
  67. package/dist/docs/assets/{guides_jev.md.Ccw4pedT.js → guides_jev.md.CEqLgjj9.js} +2 -2
  68. package/dist/docs/assets/{guides_jev.md.Ccw4pedT.lean.js → guides_jev.md.CEqLgjj9.lean.js} +1 -1
  69. package/dist/docs/assets/{guides_mcp-oauth.md.ekpWOZCC.js → guides_mcp-oauth.md.DrGY92u4.js} +1 -1
  70. package/dist/docs/assets/{guides_slack.md.BqiGSYGX.js → guides_slack.md.BwXHURvY.js} +1 -1
  71. package/dist/docs/assets/index.md.CAruw_rp.js +26 -0
  72. package/dist/docs/assets/{index.md.CVRjO09Y.lean.js → index.md.CAruw_rp.lean.js} +1 -1
  73. package/dist/docs/assets/{quickstart.md.DaLk4ZIF.js → quickstart.md.CljDaJBi.js} +3 -3
  74. package/dist/docs/assets/{quickstart.md.DaLk4ZIF.lean.js → quickstart.md.CljDaJBi.lean.js} +1 -1
  75. package/dist/docs/assets/reference_access.md.CEtibb4i.js +1 -0
  76. package/dist/docs/assets/reference_access.md.CEtibb4i.lean.js +1 -0
  77. package/dist/docs/assets/{reference_agent-config.md.11E_xe--.js → reference_agent-config.md.Ck29qYNj.js} +1 -1
  78. package/dist/docs/assets/{reference_cli.md.DQ3dCgmk.js → reference_cli.md.BkdLRbXg.js} +5 -5
  79. package/dist/docs/assets/{reference_evals.md.DYKjGFi-.js → reference_evals.md.2BXeMiO2.js} +23 -3
  80. package/dist/docs/assets/{reference_evals.md.DYKjGFi-.lean.js → reference_evals.md.2BXeMiO2.lean.js} +1 -1
  81. package/dist/docs/assets/{reference_extensions.md.pEVj72Xo.js → reference_extensions.md.DI5X5x8p.js} +1 -1
  82. package/dist/docs/assets/{reference_limits.md.Da1HegjB.js → reference_limits.md.BCCnvt3o.js} +2 -2
  83. package/dist/docs/assets/{reference_limits.md.Da1HegjB.lean.js → reference_limits.md.BCCnvt3o.lean.js} +1 -1
  84. package/dist/docs/assets/troubleshooting.md.CGOdNVAL.js +1 -0
  85. package/dist/docs/building-with-agents.html +35 -35
  86. package/dist/docs/building-with-agents.md +5 -5
  87. package/dist/docs/changelog.html +36 -36
  88. package/dist/docs/changelog.md +10 -0
  89. package/dist/docs/deployment.html +41 -41
  90. package/dist/docs/deployment.md +8 -8
  91. package/dist/docs/evals.html +37 -37
  92. package/dist/docs/evals.md +4 -2
  93. package/dist/docs/guides/agent-to-agent.html +35 -35
  94. package/dist/docs/guides/bitbucket.html +35 -35
  95. package/dist/docs/guides/cloud-agents.html +36 -36
  96. package/dist/docs/guides/convert-automation.html +35 -35
  97. package/dist/docs/guides/github.html +35 -35
  98. package/dist/docs/guides/github.md +1 -1
  99. package/dist/docs/guides/gitlab.html +35 -35
  100. package/dist/docs/guides/hooks.html +35 -35
  101. package/dist/docs/guides/improve.html +36 -36
  102. package/dist/docs/guides/jev.html +36 -36
  103. package/dist/docs/guides/jev.md +5 -0
  104. package/dist/docs/guides/mcp-oauth.html +37 -37
  105. package/dist/docs/guides/mcp-oauth.md +2 -3
  106. package/dist/docs/guides/migrate.html +35 -35
  107. package/dist/docs/guides/migrate.md +2 -2
  108. package/dist/docs/guides/opentelemetry.html +35 -35
  109. package/dist/docs/guides/pagerduty.html +35 -35
  110. package/dist/docs/guides/slack.html +37 -37
  111. package/dist/docs/guides/slack.md +5 -6
  112. package/dist/docs/guides/webhooks.html +35 -35
  113. package/dist/docs/hashmap.json +1 -1
  114. package/dist/docs/hillclimbing.html +35 -35
  115. package/dist/docs/hillclimbing.md +2 -2
  116. package/dist/docs/index.html +51 -52
  117. package/dist/docs/index.md +17 -16
  118. package/dist/docs/llms-full.txt +120 -199
  119. package/dist/docs/llms.txt +0 -1
  120. package/dist/docs/package/skills/create-agent/SKILL.md +178 -0
  121. package/dist/docs/package/skills/evals/SKILL.md +145 -0
  122. package/dist/docs/package/skills/github/SKILL.md +133 -0
  123. package/dist/docs/package/skills/hillclimb/SKILL.md +63 -0
  124. package/dist/docs/package/skills/mcp-auth/SKILL.md +60 -0
  125. package/dist/docs/package/skills/migrate-v2/SKILL.md +394 -0
  126. package/dist/docs/package/skills/setup-slack/SKILL.md +136 -0
  127. package/dist/docs/quickstart.html +38 -38
  128. package/dist/docs/quickstart.md +5 -1
  129. package/dist/docs/reference/access.html +36 -36
  130. package/dist/docs/reference/access.md +3 -3
  131. package/dist/docs/reference/agent-config.html +37 -37
  132. package/dist/docs/reference/agent-config.md +1 -1
  133. package/dist/docs/reference/artifacts.html +35 -35
  134. package/dist/docs/reference/channels.html +35 -35
  135. package/dist/docs/reference/cli.html +41 -41
  136. package/dist/docs/reference/cli.md +6 -6
  137. package/dist/docs/reference/connections.html +35 -35
  138. package/dist/docs/reference/connections.md +1 -1
  139. package/dist/docs/reference/evals.html +57 -37
  140. package/dist/docs/reference/evals.md +35 -0
  141. package/dist/docs/reference/extensions.html +37 -37
  142. package/dist/docs/reference/extensions.md +2 -2
  143. package/dist/docs/reference/hooks.html +35 -35
  144. package/dist/docs/reference/http-api.html +35 -35
  145. package/dist/docs/reference/instructions.html +35 -35
  146. package/dist/docs/reference/limits.html +37 -37
  147. package/dist/docs/reference/limits.md +2 -2
  148. package/dist/docs/reference/memory.html +35 -35
  149. package/dist/docs/reference/playground.html +35 -35
  150. package/dist/docs/reference/project-layout.html +35 -35
  151. package/dist/docs/reference/prompt.html +35 -35
  152. package/dist/docs/reference/schedules.html +35 -35
  153. package/dist/docs/reference/sessions.html +35 -35
  154. package/dist/docs/reference/skills.html +35 -35
  155. package/dist/docs/reference/subagents.html +35 -35
  156. package/dist/docs/reference/tools.html +35 -35
  157. package/dist/docs/templates/agentic-owners.html +35 -35
  158. package/dist/docs/templates/security-reviewer.html +35 -35
  159. package/dist/docs/templates/thermo-quality-review.html +35 -35
  160. package/dist/docs/templates/thermo-review.html +35 -35
  161. package/dist/docs/templates/triage.html +35 -35
  162. package/dist/docs/troubleshooting.html +36 -36
  163. package/dist/docs/troubleshooting.md +4 -4
  164. package/dist/evals.d.ts +2 -2
  165. package/dist/extensions/jev/extension.d.ts +12 -2
  166. package/dist/extensions/jev/extension.d.ts.map +1 -1
  167. package/dist/extensions/jev/extension.js +4 -0
  168. package/dist/extensions/jev/lib/evaluate.d.ts +31 -4
  169. package/dist/extensions/jev/lib/evaluate.d.ts.map +1 -1
  170. package/dist/extensions/jev/lib/evaluate.js +18 -4
  171. package/dist/internal/cli/command.d.ts +1 -1
  172. package/dist/internal/cli/command.js +1 -1
  173. package/dist/internal/cli/commands/channels.js +6 -6
  174. package/dist/internal/cli/commands/develop.d.ts.map +1 -1
  175. package/dist/internal/cli/commands/develop.js +23 -14
  176. package/dist/internal/cli/commands/hosted.js +4 -4
  177. package/dist/internal/cli/commands/index.d.ts +1 -1
  178. package/dist/internal/cli/commands/index.d.ts.map +1 -1
  179. package/dist/internal/cli/commands/index.js +1 -1
  180. package/dist/internal/cli/commands/mcp.js +1 -1
  181. package/dist/internal/cli/commands/project.js +4 -4
  182. package/dist/internal/cli/commands/scaffold.d.ts.map +1 -1
  183. package/dist/internal/cli/commands/scaffold.js +9 -6
  184. package/dist/internal/cli/commands/serve.d.ts +1 -1
  185. package/dist/internal/cli/commands/serve.js +5 -5
  186. package/dist/internal/cli/commands/session.d.ts.map +1 -1
  187. package/dist/internal/cli/commands/session.js +12 -7
  188. package/dist/internal/cli/dispatch.d.ts +3 -3
  189. package/dist/internal/cli/dispatch.js +3 -3
  190. package/dist/internal/cli/errors.d.ts +1 -1
  191. package/dist/internal/cli/errors.d.ts.map +1 -1
  192. package/dist/internal/cli/errors.js +1 -1
  193. package/dist/internal/cli/flags.d.ts +2 -2
  194. package/dist/internal/cli/flags.d.ts.map +1 -1
  195. package/dist/internal/cli/flags.js +2 -2
  196. package/dist/internal/cli/help-command.d.ts +1 -1
  197. package/dist/internal/cli/help-command.js +2 -2
  198. package/dist/internal/cli/help.d.ts +7 -7
  199. package/dist/internal/cli/help.d.ts.map +1 -1
  200. package/dist/internal/cli/help.js +8 -8
  201. package/dist/internal/cli-ax.d.ts.map +1 -1
  202. package/dist/internal/cli-ax.js +3 -0
  203. package/dist/internal/cli-convert-automation.d.ts +1 -1
  204. package/dist/internal/cli-convert-automation.js +1 -1
  205. package/dist/internal/cli-migrate.d.ts +1 -1
  206. package/dist/internal/cli-migrate.js +1 -1
  207. package/dist/internal/cli-pagerduty.d.ts +1 -1
  208. package/dist/internal/cli-pagerduty.js +1 -1
  209. package/dist/internal/convert-automation/types.d.ts +1 -1
  210. package/dist/internal/convert-automation/types.js +1 -1
  211. package/dist/internal/deploy-client.d.ts +2 -2
  212. package/dist/internal/deploy-client.d.ts.map +1 -1
  213. package/dist/internal/init-project.d.ts +7 -3
  214. package/dist/internal/init-project.d.ts.map +1 -1
  215. package/dist/internal/init-project.js +53 -7
  216. package/dist/internal/init-scaffold.d.ts +2 -1
  217. package/dist/internal/init-scaffold.d.ts.map +1 -1
  218. package/dist/internal/init-scaffold.js +20 -7
  219. package/dist/internal/peer-connections.js +1 -1
  220. package/dist/internal/server.d.ts +1 -1
  221. package/dist/internal/session-cost.d.ts +4 -4
  222. package/dist/internal/session-cost.d.ts.map +1 -1
  223. package/dist/internal/session-cost.js +4 -4
  224. package/dist/internal/session-engine.d.ts +1 -1
  225. package/dist/internal/session-engine.js +1 -1
  226. package/dist/playground/assets/{index-_3zz3yh8.js → index-Cl9zvmmf.js} +40 -40
  227. package/dist/playground/assets/index-F8b5WvWi.css +1 -0
  228. package/dist/playground/index.html +2 -2
  229. package/dist/types.d.ts +5 -5
  230. package/docs/README.md +17 -16
  231. package/docs/changelog.md +10 -0
  232. package/docs/deployment.md +8 -8
  233. package/docs/evals.md +3 -1
  234. package/docs/guides/jev.md +5 -0
  235. package/docs/guides/mcp-oauth.md +1 -2
  236. package/docs/guides/slack.md +3 -4
  237. package/docs/quickstart.md +5 -1
  238. package/docs/reference/access.md +3 -3
  239. package/docs/reference/agent-config.md +1 -1
  240. package/docs/reference/cli.md +6 -6
  241. package/docs/reference/evals.md +35 -0
  242. package/docs/reference/extensions.md +2 -2
  243. package/docs/reference/limits.md +2 -2
  244. package/docs/troubleshooting.md +4 -4
  245. package/package.json +2 -8
  246. package/skills/cli/SKILL.md +15 -15
  247. package/skills/create-agent/SKILL.md +20 -19
  248. package/skills/debug/SKILL.md +4 -4
  249. package/skills/deploy/SKILL.md +2 -2
  250. package/skills/evals/SKILL.md +8 -8
  251. package/skills/framework-map/SKILL.md +3 -3
  252. package/skills/github/SKILL.md +7 -7
  253. package/skills/hillclimb/SKILL.md +4 -4
  254. package/skills/mcp-auth/SKILL.md +3 -3
  255. package/skills/migrate-v2/SKILL.md +40 -40
  256. package/skills/otel/SKILL.md +2 -2
  257. package/skills/setup-slack/SKILL.md +8 -8
  258. package/templates/agentic-owners/README.md +5 -5
  259. package/templates/agentic-owners/bot/tools/record_review.ts +1 -1
  260. package/templates/agentic-owners/package.json +1 -1
  261. package/templates/agents-md/README.md +4 -4
  262. package/templates/agents-md/package.json +1 -1
  263. package/templates/code-wiki/README.md +3 -3
  264. package/templates/code-wiki/package.json +1 -1
  265. package/templates/demo/README.md +3 -3
  266. package/templates/demo/package.json +1 -1
  267. package/templates/pr-autofixer/package.json +1 -1
  268. package/templates/security-help/README.md +5 -5
  269. package/templates/security-help/package.json +1 -1
  270. package/templates/security-reviewer/README.md +3 -3
  271. package/templates/security-reviewer/package.json +1 -1
  272. package/templates/thermo-quality-review/README.md +4 -4
  273. package/templates/thermo-quality-review/package.json +1 -1
  274. package/templates/thermo-review/README.md +4 -4
  275. package/templates/thermo-review/package.json +1 -1
  276. package/templates/triage/README.md +3 -3
  277. package/templates/triage/overlays/jira/README.md +3 -3
  278. package/templates/triage/overlays/linear/README.md +3 -3
  279. package/templates/triage/package.json +1 -1
  280. package/dist/docs/assets/changelog.md.fZ-NNFeJ.js +0 -1
  281. package/dist/docs/assets/changelog.md.fZ-NNFeJ.lean.js +0 -1
  282. package/dist/docs/assets/chunks/@localSearchIndexroot.mfzjiOsL.js +0 -1
  283. package/dist/docs/assets/chunks/channel.goFR5lbe.js +0 -1
  284. package/dist/docs/assets/chunks/classDiagram-6PBFFD2Q.B2yLtFja.js +0 -1
  285. package/dist/docs/assets/chunks/classDiagram-v2-HSJHXN6E.B2yLtFja.js +0 -1
  286. package/dist/docs/assets/chunks/clone.CztV97Wu.js +0 -1
  287. package/dist/docs/assets/chunks/stateDiagram-v2-QKLJ7IA2.CZlVHdDZ.js +0 -1
  288. package/dist/docs/assets/guides_grokbot-agents.md.D0PpM_Gf.js +0 -15
  289. package/dist/docs/assets/guides_grokbot-agents.md.D0PpM_Gf.lean.js +0 -1
  290. package/dist/docs/assets/index.md.CVRjO09Y.js +0 -27
  291. package/dist/docs/assets/reference_access.md.CExlH_mR.js +0 -1
  292. package/dist/docs/assets/reference_access.md.CExlH_mR.lean.js +0 -1
  293. package/dist/docs/assets/troubleshooting.md.AGJ3jDzj.js +0 -1
  294. package/dist/docs/guides/grokbot-agents.html +0 -74
  295. package/dist/docs/guides/grokbot-agents.md +0 -129
  296. package/dist/extensions/cursor-grokbot-agents/extension.d.ts +0 -71
  297. package/dist/extensions/cursor-grokbot-agents/extension.d.ts.map +0 -1
  298. package/dist/extensions/cursor-grokbot-agents/extension.js +0 -64
  299. package/dist/extensions/cursor-grokbot-agents/lib/agents.d.ts +0 -11
  300. package/dist/extensions/cursor-grokbot-agents/lib/agents.d.ts.map +0 -1
  301. package/dist/extensions/cursor-grokbot-agents/lib/agents.js +0 -31
  302. package/dist/extensions/cursor-grokbot-agents/lib/backend.d.ts +0 -56
  303. package/dist/extensions/cursor-grokbot-agents/lib/backend.d.ts.map +0 -1
  304. package/dist/extensions/cursor-grokbot-agents/lib/backend.js +0 -139
  305. package/dist/extensions/cursor-grokbot-agents/lib/contacts.d.ts +0 -28
  306. package/dist/extensions/cursor-grokbot-agents/lib/contacts.d.ts.map +0 -1
  307. package/dist/extensions/cursor-grokbot-agents/lib/contacts.js +0 -46
  308. package/dist/extensions/cursor-grokbot-agents/lib/conversation.d.ts +0 -53
  309. package/dist/extensions/cursor-grokbot-agents/lib/conversation.d.ts.map +0 -1
  310. package/dist/extensions/cursor-grokbot-agents/lib/conversation.js +0 -186
  311. package/dist/extensions/cursor-grokbot-agents/lib/inputs.d.ts +0 -4
  312. package/dist/extensions/cursor-grokbot-agents/lib/inputs.d.ts.map +0 -1
  313. package/dist/extensions/cursor-grokbot-agents/lib/inputs.js +0 -15
  314. package/dist/extensions/cursor-grokbot-agents/lib/lock.d.ts +0 -12
  315. package/dist/extensions/cursor-grokbot-agents/lib/lock.d.ts.map +0 -1
  316. package/dist/extensions/cursor-grokbot-agents/lib/lock.js +0 -24
  317. package/dist/extensions/cursor-grokbot-agents/skills/consult.md +0 -40
  318. package/dist/extensions/cursor-grokbot-agents/tools/ask.d.ts +0 -4
  319. package/dist/extensions/cursor-grokbot-agents/tools/ask.d.ts.map +0 -1
  320. package/dist/extensions/cursor-grokbot-agents/tools/ask.js +0 -26
  321. package/dist/extensions/cursor-grokbot-agents/tools/check.d.ts +0 -4
  322. package/dist/extensions/cursor-grokbot-agents/tools/check.d.ts.map +0 -1
  323. package/dist/extensions/cursor-grokbot-agents/tools/check.js +0 -21
  324. package/dist/extensions/cursor-grokbot-agents/tools/interrupt.d.ts +0 -4
  325. package/dist/extensions/cursor-grokbot-agents/tools/interrupt.d.ts.map +0 -1
  326. package/dist/extensions/cursor-grokbot-agents/tools/interrupt.js +0 -13
  327. package/dist/extensions/cursor-grokbot-agents/tools/list.d.ts +0 -4
  328. package/dist/extensions/cursor-grokbot-agents/tools/list.d.ts.map +0 -1
  329. package/dist/extensions/cursor-grokbot-agents/tools/list.js +0 -22
  330. package/dist/playground/assets/index-BMpVzZzC.css +0 -1
  331. package/docs/guides/grokbot-agents.md +0 -134
  332. /package/dist/docs/assets/{deployment.md.DDmjAVbg.lean.js → deployment.md.KW0Ni_rY.lean.js} +0 -0
  333. /package/dist/docs/assets/{evals.md.OjKb7tNA.lean.js → evals.md.DiljU__Z.lean.js} +0 -0
  334. /package/dist/docs/assets/{guides_mcp-oauth.md.ekpWOZCC.lean.js → guides_mcp-oauth.md.DrGY92u4.lean.js} +0 -0
  335. /package/dist/docs/assets/{guides_slack.md.BqiGSYGX.lean.js → guides_slack.md.BwXHURvY.lean.js} +0 -0
  336. /package/dist/docs/assets/{reference_agent-config.md.11E_xe--.lean.js → reference_agent-config.md.Ck29qYNj.lean.js} +0 -0
  337. /package/dist/docs/assets/{reference_cli.md.DQ3dCgmk.lean.js → reference_cli.md.BkdLRbXg.lean.js} +0 -0
  338. /package/dist/docs/assets/{reference_extensions.md.pEVj72Xo.lean.js → reference_extensions.md.DI5X5x8p.lean.js} +0 -0
  339. /package/dist/docs/assets/{troubleshooting.md.AGJ3jDzj.lean.js → troubleshooting.md.CGOdNVAL.lean.js} +0 -0
@@ -28,7 +28,7 @@ then scaffolds and verifies a small first version.
28
28
  > review comment per pull request, and include one smoke eval.
29
29
 
30
30
  Ask it to read
31
- [`skills/create-agent/SKILL.md`](https://github.com/cursor/cursor/blob/main/packages/agent-serve/skills/create-agent/SKILL.md). The
31
+ [`skills/create-agent/SKILL.md`](/docs/package/skills/create-agent/SKILL.md). The
32
32
  first version should stay narrow: instructions, one or two tools, the
33
33
  chosen channels or connections, and a smoke eval.
34
34
 
@@ -49,9 +49,9 @@ Examples:
49
49
  > Add a GitHub ready-for-review trigger and replay PR 42 before posting
50
50
  > anything live.
51
51
 
52
- The companion skills live under `skills/`: [Slack](https://github.com/cursor/cursor/blob/main/packages/agent-serve/skills/setup-slack/SKILL.md),
53
- [MCP OAuth](https://github.com/cursor/cursor/blob/main/packages/agent-serve/skills/mcp-auth/SKILL.md), and
54
- [GitHub](https://github.com/cursor/cursor/blob/main/packages/agent-serve/skills/github/SKILL.md). Use the capability guide for the
52
+ The companion skills live under `skills/`: [Slack](/docs/package/skills/setup-slack/SKILL.md),
53
+ [MCP OAuth](/docs/package/skills/mcp-auth/SKILL.md), and
54
+ [GitHub](/docs/package/skills/github/SKILL.md). Use the capability guide for the
55
55
  reader experience and the skill for the coding procedure.
56
56
 
57
57
  ## Verify tools before tuning the prompt
@@ -126,7 +126,7 @@ and adds an eval for every kept improvement.
126
126
  > and all existing evals unchanged.
127
127
 
128
128
  Ask it to read
129
- [`skills/hillclimb/SKILL.md`](https://github.com/cursor/cursor/blob/main/packages/agent-serve/skills/hillclimb/SKILL.md). Keep
129
+ [`skills/hillclimb/SKILL.md`](/docs/package/skills/hillclimb/SKILL.md). Keep
130
130
  creation and improvement separate: a smoke turn proves the surface
131
131
  works; a measured climb proves it works better on fixed inputs.
132
132
 
@@ -147,6 +147,16 @@ Source: /docs/changelog.md
147
147
 
148
148
  # Changelog
149
149
 
150
+ ## 0.2.29 (2026-10-23)
151
+
152
+ ### Breaking changes
153
+
154
+ - `@grok/agent-sdk/extensions/cursor-grokbot-agents` is removed. Remove that import. The package has no replacement.
155
+
156
+ ### Behavior changes
157
+
158
+ - Rename commands and errors to agent-sdk
159
+
150
160
  ## 0.2.28 (2026-10-21)
151
161
 
152
162
  ### Breaking changes
@@ -331,7 +341,7 @@ agent-sdk deploy
331
341
  ```
332
342
 
333
343
  The deploy command waits until the runtime is running and prints the stable
334
- deployment URL.
344
+ deployment URL. Open [Deployed Agents](https://cursor.com/dashboard/deployed-agents) to see the agent and manage it.
335
345
 
336
346
  `deploy` reads from Git; it does not upload your working tree. Inside a
337
347
  checkout, it infers the HTTPS origin, current ref, agent path, and slug.
@@ -505,8 +515,8 @@ stubbed.
505
515
 
506
516
  You can also find the session in the deployment's recent output, which
507
517
  prints a `==> ses_... (http) <==` header for each session, or open the
508
- deployment from **Deployed Agents** in the
509
- [dashboard](https://cursor.com/dashboard) and select **Sessions**:
518
+ deployment in
519
+ [Deployed Agents](https://cursor.com/dashboard/deployed-agents) and select **Sessions**:
510
520
 
511
521
  ```bash
512
522
  agent-sdk logs --prod --once --slug weather-agent
@@ -520,7 +530,7 @@ agent-sdk session get ses_... --prod --slug weather-agent
520
530
 
521
531
  The command lists each hosted run with its status and log lines. When the
522
532
  deployment stored process output, a `Process output:` section prints that
523
- output. `agent-sdk logs --prod` prints the same process output the dashboard shows
533
+ output. `agent-sdk logs --prod` prints the same process output that [Deployed Agents](https://cursor.com/dashboard/deployed-agents) shows
524
534
  for a persistent deployment, under `==> process-output <==`. Pass the session
525
535
  ID to also print that session's process output under `Session process output:`
526
536
  and a `tool <name>` line for each tool call. While the turn is still working, the session command reports how
@@ -540,7 +550,7 @@ name is `toolName`.
540
550
 
541
551
  To continue the same conversation, pass `--session ses_...` to
542
552
  `session create`. `agent-sdk session get ses_... --prod --slug weather-agent --web`
543
- opens the session in the dashboard playground. Hosted deployments don't
553
+ opens the session in the [Deployed Agents](https://cursor.com/dashboard/deployed-agents) playground. Hosted deployments don't
544
554
  support `agent-sdk chat`, `tool call`, `--view cost`, or `mcp`; use
545
555
  `session create`, `logs --prod`, `session list --prod`, and
546
556
  `session get --prod` instead.
@@ -619,14 +629,14 @@ state root keeps sessions across restarts.
619
629
 
620
630
  ```text
621
631
  export CURSOR_API_KEY="<cursor-api-key>"
622
- export BDK_BEARER_TOKEN="$(openssl rand -hex 32)"
632
+ export AGENT_SDK_BEARER_TOKEN="$(openssl rand -hex 32)"
623
633
 
624
634
  agent-sdk serve \
625
635
  --dir /srv/agents \
626
636
  --host 127.0.0.1 \
627
637
  --port 3000 \
628
- --state-root /var/lib/bdk \
629
- --bearer-token "$BDK_BEARER_TOKEN"
638
+ --state-root /var/lib/agent-sdk \
639
+ --bearer-token "$AGENT_SDK_BEARER_TOKEN"
630
640
  ```
631
641
 
632
642
  Before exposing the host:
@@ -715,7 +725,9 @@ export default defineEval({
715
725
  ```
716
726
 
717
727
  Evals live in the project-root `evals/` directory, beside `bot/`.
718
- Add the required concurrency config once:
728
+ Blank `agent-sdk init` writes `evals/smoke.eval.ts`, which uses the scaffolded
729
+ `echo` tool and asserts `t.succeeded()` and `t.calledTool("echo")`.
730
+ It also writes this concurrency config:
719
731
 
720
732
  ```ts
721
733
  // evals/evals.config.ts
@@ -910,7 +922,7 @@ moves the freeze line instead of proving the change.
910
922
 
911
923
  - [Evals reference](/docs/reference/evals.md): complete authoring and runner
912
924
  contracts
913
- - [`skills/evals/SKILL.md`](https://github.com/cursor/cursor/blob/main/packages/agent-serve/skills/evals/SKILL.md): author and seed
925
+ - [`skills/evals/SKILL.md`](/docs/package/skills/evals/SKILL.md): author and seed
914
926
  cases with a coding agent
915
927
  - [Hillclimbing](/docs/hillclimbing.md): measure a change and lock the win
916
928
  - [Sessions](/docs/reference/sessions.md): events available to trajectory
@@ -2028,7 +2040,7 @@ env fallback. `architecture: "v1"` still accepts literals and
2028
2040
  - [Webhooks and custom channels](/docs/guides/webhooks.md): the HTTP mechanism
2029
2041
  under this pack
2030
2042
  - [Evals](/docs/evals.md): turn replay snapshots into regression fixtures
2031
- - [`skills/github/SKILL.md`](https://github.com/cursor/cursor/blob/main/packages/agent-serve/skills/github/SKILL.md): the companion
2043
+ - [`skills/github/SKILL.md`](/docs/package/skills/github/SKILL.md): the companion
2032
2044
  skill for coding agents
2033
2045
 
2034
2046
  ---
@@ -2337,140 +2349,6 @@ posting them. `GITLAB_TOKEN` needs read access to the merge request.
2337
2349
 
2338
2350
  ---
2339
2351
 
2340
- Source: /docs/guides/grokbot-agents.md
2341
-
2342
- # Grok Bot agents
2343
-
2344
- The `cursor-grokbot-agents` extension lets an Agent SDK agent consult
2345
- the Grok Bot agents on its serve host's Cursor account. The bot keeps
2346
- its existing conversation, memory, and tools, while your agent carries
2347
- the delivered reply back into the current conversation.
2348
-
2349
- Use this extension on the local runtime. It consults another Grok Bot
2350
- agent and brings that reply back into this conversation.
2351
-
2352
- ## Mount it
2353
-
2354
- List the bots your agent may contact. Descriptions teach the model when
2355
- to choose one bot over another.
2356
-
2357
- ```ts
2358
- // bot/extensions/grokbot.ts
2359
- import cursorGrokBotAgents from "@grok/agent-sdk/extensions/cursor-grokbot-agents";
2360
-
2361
- export default cursorGrokBotAgents({
2362
- agents: [
2363
- {
2364
- name: "Plan Keeper",
2365
- description: "Decides whether outdoor plans should move.",
2366
- },
2367
- {
2368
- name: "Chief of Staff",
2369
- description: "Routes work and tracks priorities.",
2370
- },
2371
- ],
2372
- });
2373
- ```
2374
-
2375
- Mounted as `grokbot`, the extension contributes `grokbot__ask`,
2376
- `grokbot__check`, `grokbot__interrupt`, and `grokbot__list`, plus
2377
- guidance for consulting them.
2378
-
2379
- ## Ask a named bot
2380
-
2381
- When someone says, "Ask Plan Keeper whether we should move the picnic,"
2382
- your agent prepares one self-contained message, sends it, and waits for
2383
- the bot's delivered reply. That reply appears in the current
2384
- conversation as the consultation result.
2385
-
2386
- The message must include who is asking, the relevant facts, and the
2387
- shape of the answer. The Grok Bot does not see the current Agent SDK
2388
- conversation.
2389
-
2390
- > Avery is deciding whether to move Saturday's picnic. The forecast is
2391
- > 70% rain from 1-4pm. Recommend keep or move, give one reason, and name
2392
- > the best alternate time.
2393
-
2394
- When exactly one bot is configured, the model may omit its name.
2395
-
2396
- ## Keep waiting for a long reply
2397
-
2398
- If the bot is still working when `ask` reaches its wait limit, the tool
2399
- returns `status: "running"` and any reply received so far. Your agent
2400
- calls `check` for the same bot and reports the final answer when it
2401
- arrives.
2402
-
2403
- `check` advances this caller's read position, so it returns only replies
2404
- not already consumed. Check when the answer is needed instead of
2405
- polling in a tight loop.
2406
-
2407
- Earlier unread replies can arrive alongside the current result. Keep
2408
- their order and pass them on when they still matter.
2409
-
2410
- ## Interrupt a bot turn
2411
-
2412
- Use `interrupt` when the bot is pursuing the wrong task or the person
2413
- changes direction. The active turn stops, but the host account's
2414
- conversation with that bot remains, so a later `ask` continues with its
2415
- existing memory.
2416
-
2417
- > Stop Plan Keeper's current turn. Then ask it to compare indoor venues
2418
- > instead of changing the time.
2419
-
2420
- `check` and `interrupt` act on the bot conversation directly, so expose
2421
- this extension only to callers who may read or stop those
2422
- conversations.
2423
-
2424
- ## Configure it
2425
-
2426
- `agents` is a name allowlist, not an existence check. A name outside the
2427
- list is refused, but a misspelled configured name may create a new empty
2428
- bot on first use. If a result says `created: true`, tell the person and
2429
- check the name before sending more work.
2430
-
2431
- With no `agents` list, any name is allowed. Prefer an explicit list for
2432
- a shared agent. `list` returns configured
2433
- bots and bots this caller already contacted; it does not enumerate the
2434
- whole account.
2435
-
2436
- Calls use the serve host credential: `CURSOR_API_KEY`,
2437
- `CURSOR_API_KEY_FILE`, `CURSOR_SERVICE_ACCOUNT_KEY`, or
2438
- `agent-sdk login`. Use `apiKey` only when the extension should run under
2439
- a different account.
2440
-
2441
- `pollIntervalMs` changes how often a waiting tool reads for new bot
2442
- output. Keep the default unless the service needs a different balance
2443
- between response latency and request volume.
2444
-
2445
- ## Account and caller boundaries
2446
-
2447
- Every tool reaches the serve host account's existing Grok Bot
2448
- conversation. Authenticated Agent SDK callers have separate contact
2449
- lists and read positions, but they do not get separate Grok Bot accounts
2450
- or isolated bot memory.
2451
-
2452
- A shared bearer token or anonymous host also collapses callers into one
2453
- Agent SDK principal. Use per-caller auth when contact history and read
2454
- positions must remain separate.
2455
-
2456
- If `ask` finds the bot busy with an earlier message, it sends nothing.
2457
- For a bot this caller already contacted, use `check` or `interrupt`.
2458
- On first contact, wait for the existing turn in the Grok Bot app to
2459
- finish, then ask again.
2460
-
2461
- ## Adjust it
2462
-
2463
- To remove a capability such as `interrupt`, mount the extension as a
2464
- directory and disable that tool. See
2465
- [Adjust a mounted extension](/docs/reference/extensions.md#adjust-a-mounted-extension).
2466
-
2467
- ## What's next
2468
-
2469
- - [Extensions](/docs/reference/extensions.md): namespaces, trust, and
2470
- overlays
2471
-
2472
- ---
2473
-
2474
2352
  Source: /docs/guides/hooks.md
2475
2353
 
2476
2354
  # Hooks
@@ -2730,6 +2608,11 @@ Source: /docs/guides/jev.md
2730
2608
 
2731
2609
  # Use Jev in review tools
2732
2610
 
2611
+ > [!WARNING]
2612
+ > **Experimental.** `@grok/agent-sdk/extensions/jev` is experimental. Its
2613
+ > exports and behavior can change in any release, without a deprecation
2614
+ > period.
2615
+
2733
2616
  Use Jev when a review workflow needs a typed decision instead of prose.
2734
2617
  A review agent can filter speculative findings, classify pull request
2735
2618
  risk, choose a reviewer, or decide whether a merge needs a documentation
@@ -3144,8 +3027,7 @@ that authorized them, so a hosted deployment doesn't receive them. For a
3144
3027
  Cursor-managed agent, add the server under MCP in the Cursor dashboard,
3145
3028
  reach it through a
3146
3029
  [`cursorAccount: true` connection](/docs/reference/connections.md#cursor-account-mcp-connection),
3147
- and connect it from **Deployed Agents** in the
3148
- [dashboard](https://cursor.com/dashboard).
3030
+ and connect it from [Deployed Agents](https://cursor.com/dashboard/deployed-agents).
3149
3031
 
3150
3032
  Anyone able to use that agent can reach the MCP capabilities you
3151
3033
  expose, so narrow the connection's `servers` list and keep privileged
@@ -3170,7 +3052,7 @@ caller needs a different downstream identity.
3170
3052
 
3171
3053
  ## Related
3172
3054
 
3173
- - [`skills/mcp-auth/SKILL.md`](https://github.com/cursor/cursor/blob/main/packages/agent-serve/skills/mcp-auth/SKILL.md): the
3055
+ - [`skills/mcp-auth/SKILL.md`](/docs/package/skills/mcp-auth/SKILL.md): the
3174
3056
  companion setup procedure for coding agents
3175
3057
  - [MCP connections](/docs/reference/connections.md): transports, account
3176
3058
  connectors, per-session auth, and tool filtering
@@ -3251,7 +3133,7 @@ exit status.
3251
3133
 
3252
3134
  You can instead ask a coding agent working in the project checkout to follow
3253
3135
  the bundled
3254
- [`bdk-migrate-v2` skill](https://github.com/cursor/cursor/blob/main/packages/agent-serve/skills/migrate-v2/SKILL.md). The skill owns the
3136
+ [`bdk-migrate-v2` skill](/docs/package/skills/migrate-v2/SKILL.md). The skill owns the
3255
3137
  code changes, capability checks, local verification, and deployment handoff.
3256
3138
 
3257
3139
  > Follow the `bdk-migrate-v2` skill for this project. Open one pull request
@@ -3350,7 +3232,7 @@ peer connections, and secrets, then verify a hosted turn. The
3350
3232
 
3351
3233
  - [CLI reference](/docs/reference/cli.md#migrate): migration flags, output, and
3352
3234
  exit status
3353
- - [`bdk-migrate-v2` skill](https://github.com/cursor/cursor/blob/main/packages/agent-serve/skills/migrate-v2/SKILL.md): the coding
3235
+ - [`bdk-migrate-v2` skill](/docs/package/skills/migrate-v2/SKILL.md): the coding
3354
3236
  procedure and complete capability matrix
3355
3237
  - [Peer agents](/docs/guides/agent-to-agent.md): how a deployed caller reaches another
3356
3238
  agent by slug
@@ -4127,12 +4009,11 @@ agent-sdk slack doctor --prefix TRIAGE
4127
4009
  After you sign in, `slack create` opens **Add Slack to this agent** in
4128
4010
  the browser and writes the resulting tokens to `.env.local` without
4129
4011
  printing them. You can open the same wizard from **Integrations** on
4130
- [Deployed Agents](https://cursor.com/dashboard).
4012
+ [Deployed Agents](https://cursor.com/dashboard/deployed-agents).
4131
4013
 
4132
4014
  If Slack requires workspace-admin approval, keep `slack create` running and
4133
- open the **Request approval** link printed by the CLI. Installing from the
4134
- dashboard doesn't send that request for you. After an admin approves it,
4135
- return to the dashboard's **Add Slack** wizard and select **Retry**.
4015
+ open the **Request approval** link printed by the CLI. Installing from
4016
+ [Deployed Agents](https://cursor.com/dashboard/deployed-agents) doesn't send that request for you. After an admin approves it, return to the **Add Slack** wizard there and select **Retry**.
4136
4017
 
4137
4018
  ### Choose the bot scopes
4138
4019
 
@@ -4189,7 +4070,7 @@ the agent's app, and `botScopes` does not change them.
4189
4070
 
4190
4071
  If you already own the Slack app, initialize it with
4191
4072
  `agent-sdk slack init --manual --dir . --name "Triage"` and follow the
4192
- [Slack setup skill](https://github.com/cursor/cursor/blob/main/packages/agent-serve/skills/setup-slack/SKILL.md) for installation
4073
+ [Slack setup skill](/docs/package/skills/setup-slack/SKILL.md) for installation
4193
4074
  and tokens.
4194
4075
 
4195
4076
  ## Test locally
@@ -4217,7 +4098,7 @@ agent-sdk serve --dir . --dev
4217
4098
 
4218
4099
  - [CLI reference](/docs/reference/cli.md#slack): `slack create`,
4219
4100
  `doctor`, `init --manual`
4220
- - [`skills/setup-slack/SKILL.md`](https://github.com/cursor/cursor/blob/main/packages/agent-serve/skills/setup-slack/SKILL.md):
4101
+ - [`skills/setup-slack/SKILL.md`](/docs/package/skills/setup-slack/SKILL.md):
4221
4102
  the companion skill for coding agents
4222
4103
  - [Webhooks and custom channels](/docs/guides/webhooks.md): host prep on mention
4223
4104
  and DM handlers
@@ -4547,7 +4428,7 @@ comparisons. Keep the inputs fixed, name one failure, change one lever,
4547
4428
  and retain the change only when the same run gets better without
4548
4429
  crossing the freeze line.
4549
4430
 
4550
- The companion [`hillclimb` skill](https://github.com/cursor/cursor/blob/main/packages/agent-serve/skills/hillclimb/SKILL.md) can run
4431
+ The companion [`hillclimb` skill](/docs/package/skills/hillclimb/SKILL.md) can run
4551
4432
  this loop with you.
4552
4433
 
4553
4434
  ## Correct a wrong tool choice
@@ -4656,7 +4537,7 @@ change leave your working memory.
4656
4537
  ## Run the loop with a coding agent
4657
4538
 
4658
4539
  Ask the coding agent to read
4659
- [`skills/hillclimb/SKILL.md`](https://github.com/cursor/cursor/blob/main/packages/agent-serve/skills/hillclimb/SKILL.md), then give
4540
+ [`skills/hillclimb/SKILL.md`](/docs/package/skills/hillclimb/SKILL.md), then give
4660
4541
  it the target, fixtures, success criterion, and freeze line. It will
4661
4542
  measure the current run, propose one change, remeasure, and ask before
4662
4543
  starting another round.
@@ -4689,6 +4570,8 @@ An Agent SDK project is a folder of Markdown and TypeScript. Combine determinist
4689
4570
  code with model judgment, then make the bot or agent available in source
4690
4571
  control, Slack, issue trackers, and Cursor.
4691
4572
 
4573
+ After you deploy an agent, open [Deployed Agents](https://cursor.com/dashboard/deployed-agents) to see it and manage it.
4574
+
4692
4575
  ## Why use it
4693
4576
 
4694
4577
  - **Bots and agents live in your repo.** Instructions, tools, and evals are
@@ -4739,29 +4622,28 @@ Open the project in Cursor. Agent SDK projects use `bot/`.
4739
4622
 
4740
4623
  ```text
4741
4624
  my-bot/
4625
+ ├── .gitignore
4626
+ ├── AGENTS.md
4742
4627
  ├── package.json
4628
+ ├── tsconfig.json
4743
4629
  ├── bot/
4744
4630
  │ ├── agent.ts # model and local harness config
4745
4631
  │ ├── instructions.md # the system prompt
4746
4632
  │ ├── tools/
4747
- │ │ └── approve_pr.ts # one typed tool per file
4748
- │ ├── skills/
4749
- │ │ └── pr-review/
4750
- │ │ └── SKILL.md # procedures the model loads on demand
4751
- │ ├── mcp-connections/
4752
- │ │ └── linear.ts # tools from an MCP server
4753
- │ ├── host-connections/
4754
- │ │ └── inventory.ts # host-only MCP tools
4755
- │ ├── subagents/
4756
- │ │ └── verifier/
4757
- │ │ ├── agent.ts
4758
- │ │ └── instructions.md
4633
+ │ │ └── echo.ts # demo tool
4634
+ │ ├── hooks/
4635
+ │ │ └── memory.ts # shared memory journal
4759
4636
  │ ├── channels/
4760
- │ │ └── github.ts # wake on pull requests, CI, and comments
4761
- │ └── hooks/
4762
- │ └── audit.ts # observe session events
4637
+ │ ├── lib/ # shared code, never discovered
4638
+ │ ├── mcp-connections/
4639
+ │ ├── sandbox/
4640
+ │ │ └── workspace/
4641
+ │ ├── schedules/
4642
+ │ ├── skills/
4643
+ │ └── subagents/
4763
4644
  └── evals/
4764
- └── readiness.eval.ts # regression checks
4645
+ ├── evals.config.ts
4646
+ └── smoke.eval.ts
4765
4647
  ```
4766
4648
 
4767
4649
  Describe your bot or agent in Cursor, or edit the files yourself.
@@ -5045,7 +4927,7 @@ import {
5045
4927
  const REVIEW_ACTIONS = new Set(["opened", "reopened", "ready_for_review"]);
5046
4928
 
5047
4929
  export default githubChannel({
5048
- botName: "bdk-pr-reviewer",
4930
+ botName: "agent-sdk-pr-reviewer",
5049
4931
  cursorAccount: { repos: ["acme/checkout"] },
5050
4932
  onPullRequest: (ctx, pr) => {
5051
4933
  if (!REVIEW_ACTIONS.has(pr.action) || pr.draft) {
@@ -5090,6 +4972,10 @@ trigger, both tool calls, and the verdict.
5090
4972
  --dir . --action opened
5091
4973
  ```
5092
4974
 
4975
+ ## Deploy the reviewer
4976
+
4977
+ Follow [Deployment](/docs/deployment.md) and run `agent-sdk deploy`. After the command reports the runtime is running, open [Deployed Agents](https://cursor.com/dashboard/deployed-agents) to see the reviewer and manage it.
4978
+
5093
4979
  ## Where to go next
5094
4980
 
5095
4981
  - [Evals](/docs/evals.md): freeze these two PRs as regression checks so
@@ -5109,11 +4995,11 @@ Source: /docs/reference/access.md
5109
4995
 
5110
4996
  These rules apply only when access checks are on for the team.
5111
4997
 
5112
- A deployed bot has three access levels. The dashboard shows Viewer, Editor,
4998
+ A deployed bot has three access levels. [Deployed Agents](https://cursor.com/dashboard/deployed-agents) shows Viewer, Editor,
5113
4999
  and Owner. The API returns `viewer`, `deployer`, and `admin`. `admin` is
5114
5000
  Owner. A write also accepts `owner` for that role, and `editor` for Editor.
5115
- The response value for Owner becomes `owner` in a later change, after the
5116
- dashboard that reads `owner` is live.
5001
+ The response value for Owner becomes `owner` in a later change, after
5002
+ [Deployed Agents](https://cursor.com/dashboard/deployed-agents) shows `owner`.
5117
5003
 
5118
5004
  | Dashboard | API value | What it allows |
5119
5005
  | --- | --- | --- |
@@ -5208,7 +5094,7 @@ agents whose turns read untrusted input (webhook payloads, PR diffs,
5208
5094
  inbound chat). The boundary is in the tools, not in the prompt, so it
5209
5095
  holds when an injected prompt tells the model to ignore its instructions.
5210
5096
 
5211
- BDK runs the file tools (`read`, `edit`, `delete`, `grep`, `glob`, `ls`)
5097
+ Agent SDK runs the file tools (`read`, `edit`, `delete`, `grep`, `glob`, `ls`)
5212
5098
  in the serve process, outside the sandbox. With `local.sandbox` on, these
5213
5099
  tools refuse a path outside the session workspace, after symlinks, with
5214
5100
  `Path is outside the workspace`. The read tools can also read the
@@ -5943,7 +5829,7 @@ digits, `_`, or `-`. The reserved slugs are `v1`, `playground`, and `docs`.
5943
5829
 
5944
5830
  ```text
5945
5831
  agent-sdk dev
5946
- agent-sdk dev ./bdk-pr-reviewer --port 3000
5832
+ agent-sdk dev ./agent-sdk-pr-reviewer --port 3000
5947
5833
  ```
5948
5834
 
5949
5835
  It accepts every `serve` option. Pass at most one positional path, and don't
@@ -6081,7 +5967,7 @@ agent-sdk session get --file <file.ndjson> [--json]
6081
5967
  | `--view cost` | Print per-turn token usage and estimated cost from a running server. `--prod` doesn't support it. |
6082
5968
  | `--trace <file.ndjson>` | Write the raw NDJSON trace instead of printing it. Not available with `--prod`. |
6083
5969
  | `--file <file.ndjson>` | Read a saved trace (for example from `run --trace`) instead of a server, and print its trajectory. |
6084
- | `--web` | Open the session in the playground, or the dashboard playground with `--prod`. `--print` prints the URL only. A running target with credentials that a browser can't send starts a loopback proxy and stays open until Ctrl-C. |
5970
+ | `--web` | Open the session in the playground, or the [Deployed Agents](https://cursor.com/dashboard/deployed-agents) playground with `--prod`. `--print` prints the URL only. A running target with credentials that a browser can't send starts a loopback proxy and stays open until Ctrl-C. |
6085
5971
 
6086
5972
  Use [`chat --session`](#chat) to continue a conversational session on a
6087
5973
  local or running server.
@@ -6135,7 +6021,7 @@ exits; `--json` emits newline-delimited JSON events. With `--prod`, it follows
6135
6021
  the output of the hosted deployment's most recent sessions on every channel
6136
6022
  and prints a `==> <sessionId> (<channel>) <==` header each time the output
6137
6023
  switches sessions. A persistent deployment also prints a `==> process-output <==`
6138
- block. That block is the process log the dashboard shows for the deployment.
6024
+ block. That block is the process log that [Deployed Agents](https://cursor.com/dashboard/deployed-agents) shows for the deployment.
6139
6025
  Pass a session ID, as an argument or with `--session`, to follow only that
6140
6026
  session; a session ID requires `--prod`. The session view starts with
6141
6027
  `Process output:` for the deployment process log and `Session process output:`
@@ -6458,8 +6344,8 @@ agent-sdk deployment get <slug> [--team <id>] [--json [--fields <a,b.c>]] [--web
6458
6344
  ```
6459
6345
 
6460
6346
  Text output includes status, release, watched repositories, routes, secret
6461
- names, and the latest error. `--web` opens the deployment's page in the
6462
- dashboard. A deployment still on architecture v1 shows its status with
6347
+ names, and the latest error. `--web` opens the deployment's page in
6348
+ [Deployed Agents](https://cursor.com/dashboard/deployed-agents). A deployment still on architecture v1 shows its status with
6463
6349
  `architecture: v1` and the [`migrate`](#migrate) steps; `deployment stop` and
6464
6350
  `deployment delete` also still accept it.
6465
6351
 
@@ -6675,7 +6561,7 @@ agent-sdk slack doctor [--dir <path>]
6675
6561
  | Subcommand | Contract |
6676
6562
  | --- | --- |
6677
6563
  | `setup` | Print the setup choices without changing files. |
6678
- | `create` | Open the signed-in Cursor dashboard wizard, write the resulting token pair to `.env.local`, and run `doctor`. The development app is the default; `--env prod` selects production. A second create overwrites the live app manifest. |
6564
+ | `create` | Open the signed-in [Deployed Agents](https://cursor.com/dashboard/deployed-agents) wizard, write the resulting token pair to `.env.local`, and run `doctor`. The development app is the default; `--env prod` selects production. A second create overwrites the live app manifest. |
6679
6565
  | `destroy` | Delete the provisioned app. Existing local token entries remain but stop working. |
6680
6566
  | `icon` | Set an HTTPS or local PNG, JPG, or GIF icon of at most 512 KB. |
6681
6567
  | `init --manual` | Write the channel, manifests, Slack CLI project, and setup files for a manually managed app. |
@@ -6948,7 +6834,7 @@ agent-sdk mcp oauth inventory # browser PKCE → local mcp-auth.json
6948
6834
  ```
6949
6835
 
6950
6836
  Full walkthrough: [Host MCP OAuth](/docs/guides/mcp-oauth.md). Companion
6951
- skill: [`skills/mcp-auth/SKILL.md`](https://github.com/cursor/cursor/blob/main/packages/agent-serve/skills/mcp-auth/SKILL.md).
6837
+ skill: [`skills/mcp-auth/SKILL.md`](/docs/package/skills/mcp-auth/SKILL.md).
6952
6838
 
6953
6839
  ## Per-session auth
6954
6840
 
@@ -7451,6 +7337,41 @@ ID filters match an exact ID and its descendants. Repeated IDs use OR;
7451
7337
  repeated tags use OR. When both are present, a case must match both
7452
7338
  groups.
7453
7339
 
7340
+ ## Suite summary cases
7341
+
7342
+ Tag a case with `summary` when that case aggregates the other cases in
7343
+ the same file. `EVAL_SUMMARY_TAG` is that string. Selecting the
7344
+ aggregator by id, or with `--tag summary`, also runs every other case
7345
+ from that file. A selection that includes no `summary` case stays as
7346
+ you wrote it. `--list` shows the same set a run would execute.
7347
+
7348
+ ```ts
7349
+ import { defineEval, EVAL_SUMMARY_TAG } from "@grok/agent-sdk/evals";
7350
+
7351
+ export default defineEval({
7352
+ cases: [
7353
+ {
7354
+ id: "checkout",
7355
+ async test(t) {
7356
+ await t.send("Review checkout PR 42.");
7357
+ t.succeeded();
7358
+ },
7359
+ },
7360
+ {
7361
+ id: "overall",
7362
+ tags: [EVAL_SUMMARY_TAG],
7363
+ async test(t) {
7364
+ await t.send("Summarize the checkout review.");
7365
+ t.succeeded();
7366
+ },
7367
+ },
7368
+ ],
7369
+ });
7370
+ ```
7371
+
7372
+ When that file is `evals/prs.eval.ts`, `agent-sdk eval --dir . prs/overall`
7373
+ runs `prs/checkout` and `prs/overall`.
7374
+
7454
7375
  ## Inspect run artifacts
7455
7376
 
7456
7377
  Default run artifacts go under `evals/<stamp>/` in the project state
@@ -7688,8 +7609,8 @@ namespace-neutral because the consumer chooses the final prefix.
7688
7609
 
7689
7610
  - [Cloud agents](/docs/guides/cloud-agents.md): delegate repository work
7690
7611
  through an extension
7691
- - [Grok Bot agents](/docs/guides/grokbot-agents.md): consult named bots
7692
- - [Jev](/docs/guides/jev.md): typed answers, then gated writes
7612
+ - [Jev](/docs/guides/jev.md) (experimental): typed answers, then gated
7613
+ writes
7693
7614
  - [Self-improvement](/docs/guides/improve.md): propose source changes
7694
7615
  through pull requests
7695
7616
  - [Project layout](/docs/reference/project-layout.md): contribution slots
@@ -8210,7 +8131,7 @@ When the switch is on, these are the default values. Cursor can set a different
8210
8131
 
8211
8132
  ## When a deploy reaches a limit
8212
8133
 
8213
- `agent-sdk deploy` and the dashboard show the `error` sentence. The HTTP API returns this body:
8134
+ `agent-sdk deploy` and [Deployed Agents](https://cursor.com/dashboard/deployed-agents) show the `error` sentence. The HTTP API returns this body:
8214
8135
 
8215
8136
  ```json
8216
8137
  {
@@ -8228,7 +8149,7 @@ When the switch is on, these are the default values. Cursor can set a different
8228
8149
  - If Cursor pauses deploys for your team, every deploy answers `403`, a redeploy too. Contact Cursor support to resume deploys.
8229
8150
  - A deploy that waits on another deploy for the same team can answer `503` with `Retry-After: 2`. Retry that request.
8230
8151
 
8231
- The Deployed Agents dashboard shows `Deployments (N/max)` only when Cursor has turned the caps on for the team and the team has a deployment cap. Otherwise the heading is `Deployments`.
8152
+ [Deployed Agents](https://cursor.com/dashboard/deployed-agents) shows `Deployments (N/max)` only when Cursor has turned the caps on for the team and the team has a deployment cap. Otherwise the heading is `Deployments`.
8232
8153
 
8233
8154
  ## Raise a limit
8234
8155
 
@@ -9977,12 +9898,12 @@ Match the visible symptom below.
9977
9898
  | `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](/docs/guides/github.md#other-hosts). |
9978
9899
  | 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. |
9979
9900
  | The deployment never becomes running | Run `agent-sdk deployment get <slug>`, then act on the reported build or startup error. |
9980
- | 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 dashboard prompt to redeploy. |
9901
+ | 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. |
9981
9902
  | `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. |
9982
9903
  | 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. |
9983
9904
  | `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](/docs/deployment.md#verify-a-hosted-turn). |
9984
9905
  | `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. |
9985
- | A dashboard link to a single session doesn't open | Check the session with `agent-sdk session get <sessionId> --prod --slug <slug>`. |
9906
+ | 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>`. |
9986
9907
  | `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](/docs/deployment.md#verify-a-hosted-turn). |
9987
9908
  | `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. |
9988
9909
  | 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](/docs/reference/channels.md#route-responses). |
@@ -10012,7 +9933,7 @@ direct webhooks.
10012
9933
  | What you see | What to do |
10013
9934
  | --- | --- |
10014
9935
  | 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. |
10015
- | `slack create` is waiting for workspace approval | Keep the CLI running, open the **Request approval** link it prints, and select **Retry** in the dashboard's **Add Slack** wizard after an admin approves. See [Slack](/docs/guides/slack.md#connect). |
9936
+ | `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](/docs/guides/slack.md#connect). |
10016
9937
  | The bot ignores ordinary channel posts | Configure `engagement.channelPosts`, create the app with `--channel-posts`, and invite it to every allowed channel. |
10017
9938
 
10018
9939
  See the [Slack guide](/docs/guides/slack.md) for app setup and engagement
@@ -10023,7 +9944,7 @@ choices.
10023
9944
  | What you see | What to do |
10024
9945
  | --- | --- |
10025
9946
  | `must be defineConnection({ url, oauth: true })` | Add `oauth: true` to the named URL connection or correct the connection filename passed to `mcp oauth`. |
10026
- | 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** in the dashboard. See [Host MCP OAuth](/docs/guides/mcp-oauth.md#use-an-oauth-server-from-a-hosted-agent). |
9947
+ | 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](/docs/guides/mcp-oauth.md#use-an-oauth-server-from-a-hosted-agent). |
10027
9948
  | 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`. |
10028
9949
 
10029
9950
  See [Host MCP OAuth](/docs/guides/mcp-oauth.md) for the credential lifecycle.
@@ -32,7 +32,6 @@
32
32
  - [Convert a Cursor Automation](/docs/guides/convert-automation.md): Turn a dashboard Automation into an Agent SDK project, then reconnect its actions and triggers.
33
33
  - [GitHub](/docs/guides/github.md): Let your agent read pull requests and CI, then write back reviews, comments, and checks.
34
34
  - [GitLab](/docs/guides/gitlab.md): Review merge requests, answer notes, and triage failed pipelines on GitLab.com or self-managed GitLab.
35
- - [Cursor Grok Bot agents](/docs/guides/grokbot-agents.md): Mount an extension that lets your agent consult named Grok Bot agents, wait for long replies, and interrupt work.
36
35
  - [Hooks](/docs/guides/hooks.md): Observe session events for metrics, alerts, and other side effects without changing the turn.
37
36
  - [Self-improvement](/docs/guides/improve.md): Let an agent propose a change to its own source through a branch and pull request, with review and deployment kept separate.
38
37
  - [Jev](/docs/guides/jev.md): Use typed Jev decisions to filter findings, route pull requests, and gate review actions.