@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
@@ -9,13 +9,13 @@ description: >-
9
9
  # Create an Agent SDK agent
10
10
 
11
11
  1. **Interview.** Two `AskQuestion` rounds, then a plan gate.
12
- 2. **Scaffold.** `bdk init`, then shape the files.
12
+ 2. **Scaffold.** `agent-sdk init`, then shape the files.
13
13
  3. **Verify.** `validate` / `info` / `tool call`, then a model turn.
14
14
  4. **Channels.** Slack, GitHub, webhook, or schedule as chosen.
15
15
  5. **Hillclimb.** `skills/hillclimb/SKILL.md`.
16
16
 
17
17
  Read `skills/framework-map/SKILL.md` if you have not. CLI is
18
- `bdk`. Public docs:
18
+ `agent-sdk`. Public docs:
19
19
  `node_modules/@grok/agent-sdk/dist/docs/llms.txt` or `/docs/llms.txt`
20
20
  on a running host.
21
21
 
@@ -33,7 +33,7 @@ on a running host.
33
33
  - If `AskQuestion` is missing or the user skips, state defaults
34
34
  in one list and proceed.
35
35
 
36
- <!-- interview:start (generated from the bdk init questions; do not edit by hand) -->
36
+ <!-- interview:start (generated from the agent-sdk init questions; do not edit by hand) -->
37
37
  ### Round 1: identity
38
38
 
39
39
  | Question | Options | Guidance |
@@ -59,7 +59,7 @@ something". Write files only after approval.
59
59
 
60
60
  | Purpose | Shape |
61
61
  | --- | --- |
62
- | Slack chat | `slackChannel({ envPrefix })` + suggested prompts. `bdk slack create` mints the bot. Prefix: `skills/setup-slack/SKILL.md` |
62
+ | Slack chat | `slackChannel({ envPrefix })` + suggested prompts. `agent-sdk slack create` mints the bot. Prefix: `skills/setup-slack/SKILL.md` |
63
63
  | PR review with host prep | Channel `callTool` into a trimmed workspace `pr/` tree |
64
64
  | GitHub automation | `githubChannel()` hooks, replay fixtures |
65
65
  | Domain assistant | Server tools + one MCP connection + a skill |
@@ -105,7 +105,7 @@ Smells: prose builders in `.ts` (write `.md`); `bot/lib/` +
105
105
  ## Scaffold
106
106
 
107
107
  ```bash
108
- bdk init ./<slug>
108
+ agent-sdk init ./<slug>
109
109
  ```
110
110
 
111
111
  `init` writes the project, runs `npm install`, and may wait on
@@ -115,13 +115,14 @@ bdk init ./<slug>
115
115
  2. Real `instructions.md`. Replace `echo.ts`.
116
116
  3. Chosen `channels/`, `mcp-connections/`, `skills/`,
117
117
  `subagents/<id>/` (needs `description`), `schedules/`, `hooks/`.
118
- Slack: `bdk slack create --dir ./<slug> --name "<Name>"`,
118
+ Slack: `agent-sdk slack create --dir ./<slug> --name "<Name>"`,
119
119
  not a hand-written channel. Manual Slack app:
120
- `bdk slack init --manual` (Slack CLI, or paste at
120
+ `agent-sdk slack init --manual` (Slack CLI, or paste at
121
121
  api.slack.com).
122
- 4. `evals/evals.config.ts` with `maxConcurrency: 20` (required;
123
- cap 200) plus `evals/**/*.eval.ts`. Assert `t.succeeded()` +
124
- `t.calledTool(...)`. API: `skills/evals/SKILL.md`.
122
+ 4. Blank init writes `evals/evals.config.ts` (`maxConcurrency: 20`,
123
+ cap 200) and `evals/smoke.eval.ts`. The smoke case uses `echo`
124
+ and asserts `t.succeeded()` and `t.calledTool("echo")`. Replace
125
+ that case when you replace the tool. API: `skills/evals/SKILL.md`.
125
126
 
126
127
  Stay on deps the Agent SDK already ships (`zod`,
127
128
  `@modelcontextprotocol/sdk`, `tsx`).
@@ -129,25 +130,25 @@ Stay on deps the Agent SDK already ships (`zod`,
129
130
  ## Verify
130
131
 
131
132
  ```bash
132
- bdk validate --dir ./<slug>
133
- bdk info --dir ./<slug> --json
134
- bdk tool call <tool> --dir ./<slug> --input '{…}'
135
- bdk eval --dir ./<slug> --list
133
+ agent-sdk validate --dir ./<slug>
134
+ agent-sdk info --dir ./<slug> --json
135
+ agent-sdk tool call <tool> --dir ./<slug> --input '{…}'
136
+ agent-sdk eval --dir ./<slug> --list
136
137
  npx tsc --noEmit -p ./<slug>
137
138
  ```
138
139
 
139
140
  tsx does not typecheck. Tool `execute` must return JSON-shaped
140
141
  values: object literals or `type` aliases, not `interface` types.
141
142
 
142
- Model turns need a Cursor credential (`CURSOR_API_KEY`, then `CURSOR_API_KEY_FILE`, then `CURSOR_SERVICE_ACCOUNT_KEY`, then `bdk login`). Without one, finish the
143
+ Model turns need a Cursor credential (`CURSOR_API_KEY`, then `CURSOR_API_KEY_FILE`, then `CURSOR_SERVICE_ACCOUNT_KEY`, then `agent-sdk login`). Without one, finish the
143
144
  key-free checks, confirm `run` fails with only the API-key error,
144
145
  and hand these over:
145
146
 
146
147
  ```bash
147
- bdk run --dir ./<slug> --message "<fixture prompt>"
148
- bdk serve --dir ./<slug> --mode single --dev
148
+ agent-sdk run --dir ./<slug> --message "<fixture prompt>"
149
+ agent-sdk serve --dir ./<slug> --mode single --dev
149
150
  # http://127.0.0.1:3000/playground
150
- bdk eval --dir ./<slug>
151
+ agent-sdk eval --dir ./<slug>
151
152
  ```
152
153
 
153
154
  Serve only this agent's directory. Session files land in the
@@ -170,7 +171,7 @@ project state directory (`--state-root`). That is not harness cwd.
170
171
  Once a smoke turn passes, agree fixtures, success criteria, and a
171
172
  freeze line, then follow `skills/hillclimb/SKILL.md`. Seed from
172
173
  the smoke session under the project state directory. GitHub:
173
- snapshot `bdk github replay ... --dry-run --fixtures-dir fixtures/github`.
174
+ snapshot `agent-sdk github replay ... --dry-run --fixtures-dir fixtures/github`.
174
175
 
175
176
  Do not deploy or post to real Slack/GitHub beyond the smoke the
176
177
  user asked for. If the plan grows past ~10 files, cut scope.
@@ -8,10 +8,10 @@ description: >-
8
8
 
9
9
  # Debugging the Agent SDK locally
10
10
 
11
- Local `bdk serve`. Hosted start failures:
11
+ Local `agent-sdk serve`. Hosted start failures:
12
12
  `docs/troubleshooting.md` and `docs/deployment.md`.
13
13
 
14
- 1. **Validate.** `bdk validate --dir <project>`
14
+ 1. **Validate.** `agent-sdk validate --dir <project>`
15
15
  2. **Info.** `curl -s http://127.0.0.1:3000/<slug>/v1/info | jq .`
16
16
  3. **Trace.** Session events under the project state directory.
17
17
  Then match the table.
@@ -33,11 +33,11 @@ Local `bdk serve`. Hosted start failures:
33
33
  | `403` on stream | Wrong principal. Same auth as create; beyond loopback send `--bearer-token`. |
34
34
  | Works on loopback, blocked via tunnel | `localDevStrict()` rejects forwarded headers. Use `--bearer-token`. Never `--allow-anonymous` with account MCP. |
35
35
  | Slack `channel idle … missing credentials` | Expected. `slack doctor --prefix <PREFIX>`. |
36
- | Immediate API-key error | Model turns need a Cursor credential (`CURSOR_API_KEY`, then `CURSOR_API_KEY_FILE`, then `CURSOR_SERVICE_ACCOUNT_KEY`, then `bdk login`). |
36
+ | Immediate API-key error | Model turns need a Cursor credential (`CURSOR_API_KEY`, then `CURSOR_API_KEY_FILE`, then `CURSOR_SERVICE_ACCOUNT_KEY`, then `agent-sdk login`). |
37
37
  | `validate` clean, CI typecheck fails | tsx skipped types. JSON-shaped returns; `type` not `interface`. |
38
38
  | `validate`: `architecture "v2" requires a named secret` | Getter or literal SCM credential. Use the quoted `{ secretName: "NAME" }`; `secrets set <slug> NAME` after deploy. |
39
39
 
40
40
  Count `action.result` by `toolName` before blaming latency.
41
41
  `turn.failed` + `"turn interrupted"` is a follow-up or stop, not a
42
- crash. `bdk session get --file <file>` renders a saved
42
+ crash. `agent-sdk session get --file <file>` renders a saved
43
43
  trace.
@@ -34,12 +34,12 @@ Do not ask for values the checkout or existing deployment supplies.
34
34
  ## Use the attached service account
35
35
 
36
36
  Continue only when `CURSOR_SERVICE_ACCOUNT_KEY` is present. Never print
37
- the value. Do not run `bdk login`.
37
+ the value. Do not run `agent-sdk login`.
38
38
 
39
39
  On Linux and macOS, run every Agent SDK command through this wrapper:
40
40
 
41
41
  ```bash
42
- BDK_VERSION="0.2.28"
42
+ BDK_VERSION="0.2.29"
43
43
  BDK_PACKAGE="@grok/agent-sdk"
44
44
  case "$BDK_VERSION" in
45
45
  __BDK_V*)
@@ -13,13 +13,13 @@ project-root `evals/**/*.eval.ts`. `bot/evals/` is ignored.
13
13
  Guide: `docs/evals.md`.
14
14
 
15
15
  Observing production: hooks. Tool logic without a model:
16
- `bdk tool call <tool> --input '{...}'`.
16
+ `agent-sdk tool call <tool> --input '{...}'`.
17
17
 
18
18
  ```bash
19
- bdk eval --dir . --list
20
- bdk eval --dir . --json
21
- bdk eval --dir . weather/nyc
22
- bdk eval --dir . --tag smoke
19
+ agent-sdk eval --dir . --list
20
+ agent-sdk eval --dir . --json
21
+ agent-sdk eval --dir . weather/nyc
22
+ agent-sdk eval --dir . --tag smoke
23
23
  ```
24
24
 
25
25
  | Form | Case id |
@@ -32,7 +32,7 @@ bdk eval --dir . --tag smoke
32
32
  `eval` boots an ephemeral server and a temp state root. `--url`
33
33
  points at a running agent. Model turns need a Cursor credential
34
34
  (`CURSOR_API_KEY`, then `CURSOR_API_KEY_FILE`, then
35
- `CURSOR_SERVICE_ACCOUNT_KEY`, then `bdk login`); `--list` does
35
+ `CURSOR_SERVICE_ACCOUNT_KEY`, then `agent-sdk login`); `--list` does
36
36
  not. Node 22.13+, never Bun.
37
37
 
38
38
  ## Seeding
@@ -124,7 +124,7 @@ drifting inputs (pin them).
124
124
  | Surface | Fixture |
125
125
  | --- | --- |
126
126
  | Chat | One frozen prompt |
127
- | Tool-heavy | `bdk tool call` first, then the prompt |
127
+ | Tool-heavy | `agent-sdk tool call` first, then the prompt |
128
128
  | GitHub | `github replay … --dry-run --fixtures-dir fixtures/github` |
129
129
  | Host-prep PR review | A team-owned PR; gate findings shape, not counts |
130
130
  | Workspace | `workspaceFiles` in `t.send` |
@@ -137,7 +137,7 @@ tool I/O, final text, logs) under `evals/<stamp>/` in the project state
137
137
  directory (the CLI prints the path); read it before editing the eval.
138
138
  `--state-root <path>` keeps the raw session events too.
139
139
 
140
- CI: `bdk eval --dir . --json --no-stream --junit reports/evals.xml`.
140
+ CI: `agent-sdk eval --dir . --json --no-stream --junit reports/evals.xml`.
141
141
  Exit `1` on a failed gate, `2` when nothing matched, `--strict` to fail
142
142
  on `scored`.
143
143
 
@@ -13,8 +13,8 @@ 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 `bdk` (Node, never Bun). Follow the `bdk-cli` skill before you
17
- run a `bdk` command.
16
+ CLI is `agent-sdk` (Node, never Bun). Follow the `bdk-cli` skill before you
17
+ run an `agent-sdk` command.
18
18
 
19
19
  Public docs: `node_modules/@grok/agent-sdk/dist/docs/llms.txt` or
20
20
  `/docs/llms.txt` on a running host.
@@ -32,7 +32,7 @@ Public docs: `node_modules/@grok/agent-sdk/dist/docs/llms.txt` or
32
32
  5. **Attached MCP is nameless** until `advertiseTools: true`.
33
33
  6. **Model turns need a Cursor credential** (`CURSOR_API_KEY`, then
34
34
  `CURSOR_API_KEY_FILE`, then `CURSOR_SERVICE_ACCOUNT_KEY`, then
35
- `bdk login`). `validate`,
35
+ `agent-sdk login`). `validate`,
36
36
  `info`, `tool call`, and `serve` bring-up do not.
37
37
  7. **Memory is `ctx.host.kv`.** On Cursor hosting, a later event
38
38
  can run in a new process. Module `Map`s, globals, and local files
@@ -56,7 +56,7 @@ at deploy. Repos must share one GitHub owner.
56
56
 
57
57
  | Source | When |
58
58
  | ------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
59
- | `cursorAccount` + `serve --cursor-events` | Preferred. Signed-in host (`bdk login`, `CURSOR_API_KEY`, or `CURSOR_SERVICE_ACCOUNT_KEY`). Repos from the channel and from repeatable `--repo owner/name`. Cap 20, one GitHub owner |
59
+ | `cursorAccount` + `serve --cursor-events` | Preferred. Signed-in host (`agent-sdk login`, `CURSOR_API_KEY`, or `CURSOR_SERVICE_ACCOUNT_KEY`). Repos from the channel and from repeatable `--repo owner/name`. Cap 20, one GitHub owner |
60
60
  | HTTP `POST /<slug>/v1/channels/github` with a webhook secret | `allowAll()` + `X-Hub-Signature-256` |
61
61
  | HTTP, no secret | Loopback only. `serve --dev` also admits unsigned loopback (fixtures / forward) |
62
62
 
@@ -88,7 +88,7 @@ credentials: {
88
88
  },
89
89
  ```
90
90
 
91
- A literal or `() => process.env.X` getter fails `bdk validate` on
91
+ A literal or `() => process.env.X` getter fails `agent-sdk validate` on
92
92
  architecture v2 (the default) with `requires a named secret`; the
93
93
  message quotes the `{ secretName }` to use. Omit a field to keep its
94
94
  default name; a numeric `appId` is allowed. Only `architecture: "v1"`
@@ -111,22 +111,22 @@ curl -s -X POST http://127.0.0.1:3000/<slug>/v1/channels/github \
111
111
  2. **Replay** (hillclimb tier; pull access is enough):
112
112
 
113
113
  ```bash
114
- bdk github replay owner/repo#123 --dir <project>
115
- bdk github replay owner/repo#123 --dir <project> --events '*' --dry-run --fixtures-dir fixtures/github
114
+ agent-sdk github replay owner/repo#123 --dir <project>
115
+ agent-sdk github replay owner/repo#123 --dir <project> --events '*' --dry-run --fixtures-dir fixtures/github
116
116
  ```
117
117
 
118
118
  3. **Forward** (live; repo admin). One forwarder per repo. Blank
119
119
  `GITHUB_TOKEN`/`GH_TOKEN` or every delivery 401s:
120
120
 
121
121
  ```bash
122
- bdk github doctor --install
123
- GITHUB_TOKEN= GH_TOKEN= bdk github forward --dir <project>
122
+ agent-sdk github doctor --install
123
+ GITHUB_TOKEN= GH_TOKEN= agent-sdk github forward --dir <project>
124
124
  ```
125
125
 
126
126
  4. **Cursor pull** (same as production):
127
127
 
128
128
  ```bash
129
- bdk serve --dir <project> --cursor-events --repo owner/repo
129
+ agent-sdk serve --dir <project> --cursor-events --repo owner/repo
130
130
  ```
131
131
 
132
132
  Volume, debounce, and `progress.commitStatus` / `progress.banner`
@@ -26,13 +26,13 @@ Ask before editing if any are missing. A moving fixture is noise.
26
26
 
27
27
  | Surface | Pin it |
28
28
  | --- | --- |
29
- | GitHub | `bdk github replay <pr> --dir <project>` (`--dry-run --out fixtures/github`) |
30
- | One tool | `bdk tool call <tool> --dir <project> --input '{...}'` |
31
- | Chat | `bdk run --dir <project> --message "<fixture>"` |
29
+ | GitHub | `agent-sdk github replay <pr> --dir <project>` (`--dry-run --out fixtures/github`) |
30
+ | One tool | `agent-sdk tool call <tool> --dir <project> --input '{...}'` |
31
+ | Chat | `agent-sdk run --dir <project> --message "<fixture>"` |
32
32
 
33
33
  ## Loop
34
34
 
35
- 1. **Serve.** `bdk serve --dir <project> --mode single --dev`
35
+ 1. **Serve.** `agent-sdk serve --dir <project> --mode single --dev`
36
36
  Playground: `http://127.0.0.1:3000/playground`.
37
37
  2. **Hit it.** Same path a user would. Record status, wall time,
38
38
  `sessionId`, output, and `action.result` counts by `toolName`.
@@ -2,7 +2,7 @@
2
2
  name: bdk-mcp-auth
3
3
  description: >-
4
4
  Authorize host MCP OAuth for defineConnection({ url, oauth: true }):
5
- bdk mcp oauth, local tokens, advertiseTools, egress, and the hosted
5
+ agent-sdk mcp oauth, local tokens, advertiseTools, egress, and the hosted
6
6
  cursorAccount path. Use when wiring or debugging MCP auth.
7
7
  ---
8
8
 
@@ -26,7 +26,7 @@ can still call `ctx.host.mcp`.
26
26
  the model must not see it.
27
27
  2. **Allow egress** on hosted non-bootstrap hosts:
28
28
  `hosting.egressDomains`.
29
- 3. **Authorize.** Local: `bdk mcp oauth <name>`, or finish
29
+ 3. **Authorize.** Local: `agent-sdk mcp oauth <name>`, or finish
30
30
  Connect in the playground so the current process can retry.
31
31
  Tokens stay on this machine. Hosted: use a
32
32
  `cursorAccount: true` connection and connect the server from
@@ -42,7 +42,7 @@ export default defineConnection({
42
42
  ```
43
43
 
44
44
  ```bash
45
- bdk mcp oauth <connection>
45
+ agent-sdk mcp oauth <connection>
46
46
  ```
47
47
 
48
48
  Browser callback: `http://127.0.0.1:8787/callback`. Tokens live in
@@ -20,14 +20,14 @@ Migrate when any of these is true:
20
20
 
21
21
  - `package.json` depends on `@cursor/july`.
22
22
  - `agent/agent.ts` sets `architecture: "v1"`.
23
- - `bdk deployment get <slug>` for the hosted copy does not print
23
+ - `agent-sdk deployment get <slug>` for the hosted copy does not print
24
24
  `architecture: v2`.
25
25
 
26
26
  Stop when none is true. Your final message must start with
27
27
  `Nothing to migrate.` and must name the checks you ran. Open no pull
28
28
  request.
29
29
 
30
- `bdk migrate` checks `--dir` before it starts an agent. It starts an
30
+ `agent-sdk migrate` checks `--dir` before it starts an agent. It starts an
31
31
  agent when it finds any of these: an `@cursor/july` dependency or
32
32
  import, `architecture: "v1"`, `bot/storage.ts` or `agent/storage.ts`,
33
33
  `runtime: "grokbot"`, a literal or `() => process.env` SCM credential,
@@ -35,8 +35,8 @@ import, `architecture: "v1"`, `bot/storage.ts` or `agent/storage.ts`,
35
35
  `until`, or a `defineConnection` whose URL comes from a `*_MCP_URL`
36
36
  secret. When none of those is present it prints `Nothing to migrate.`
37
37
  and exits. When it cannot read a file, it starts the agent. It does
38
- not run `bdk deployment`. A hosted copy can still be on v1 after the
39
- source has moved. Check with `bdk deployment get <slug>`, and deploy when
38
+ not run `agent-sdk deployment`. A hosted copy can still be on v1 after the
39
+ source has moved. Check with `agent-sdk deployment get <slug>`, and deploy when
40
40
  that output does not show `architecture: v2`.
41
41
 
42
42
  ## Know what changes
@@ -73,12 +73,12 @@ ends. That model changes code in three places:
73
73
  | Reminders with `prompt` or a named `handler` | Supported |
74
74
  | Secrets and `hosting.egressDomains` | Supported. Same-slug deploys copy v1 secrets. |
75
75
  | `persistent: true` and `hosting.image` | Supported, one persistent deployment per team |
76
- | Local `bdk dev`, `run`, `eval`, and the playground | Supported |
76
+ | Local `agent-sdk dev`, `run`, `eval`, and the playground | Supported |
77
77
  | `defineStorage` in `agent/storage.ts` | Not supported. Delete the file. |
78
78
  | Reminders with inline `run` or a function `until` | Not supported. Use a named handler. |
79
79
  | Cron schedules in `agent/schedules/` on Cursor hosting | Supported with `@grok/agent-sdk` 0.2.14 or newer. Each fire runs in a new runtime and must finish in 26 minutes. |
80
80
  | Slack tool-approval buttons on Cursor hosting | Not supported yet |
81
- | `bdk mcp oauth --store` for host MCP OAuth | Not supported. Connect Cursor-account MCP servers from **Deployed Agents** in the dashboard. |
81
+ | `agent-sdk mcp oauth --store` for host MCP OAuth | Not supported. Connect Cursor-account MCP servers from **Deployed Agents** in the dashboard. |
82
82
  | Session, tool, and MCP APIs on the deployment URL | Not reachable |
83
83
  | Another Agent SDK agent reached through a deployment URL secret | Not supported. Declare `defineConnection({ agent: "<slug>" })`. Both agents must be team-owned and deployed on `@grok/agent-sdk` 0.2.18 or newer. |
84
84
  | `--prod` with `chat`, `tool call`, `skill`, `session get --view cost`, or `mcp` | Not supported. Use `session create`, `logs --prod`, `session list --prod`, `session get --prod`, and `session get --prod --web`. |
@@ -183,12 +183,12 @@ still loads.
183
183
  },
184
184
  ```
185
185
 
186
- `bdk validate` lists each field still in the old shape. While
186
+ `agent-sdk validate` lists each field still in the old shape. While
187
187
  `architecture: "v1"` is set the finding is a warning, so you can run
188
188
  it before step 2 to see the full list; after step 2 the same finding
189
189
  is an error and blocks `deploy`. Do not set the values: a same-slug
190
190
  deploy copies the v1 secrets, and a new slug takes
191
- `bdk secret set <new-slug> NAME` after the deploy.
191
+ `agent-sdk secret set <new-slug> NAME` after the deploy.
192
192
 
193
193
  7. **Move secret reads.** Replace module-scope `process.env.NAME` reads
194
194
  with reads inside the function that uses them. Give MCP connections a
@@ -250,9 +250,9 @@ still loads.
250
250
  on `defineAgent`, and from an extension `hosting` block that declares
251
251
  it. Leave every secret something else still reads.
252
252
 
253
- Do not change deployment secrets, and do not run `bdk secret delete`.
253
+ Do not change deployment secrets, and do not run `agent-sdk secret delete`.
254
254
  In the pull request body, list each secret this step stopped using,
255
- with the command `bdk secret delete <slug> NAME`, so the user can
255
+ with the command `agent-sdk secret delete <slug> NAME`, so the user can
256
256
  unset it after both agents are deployed.
257
257
 
258
258
  Both agents must be team-owned and deployed with `@grok/agent-sdk` 0.2.18
@@ -267,13 +267,13 @@ still loads.
267
267
  ## Verify locally
268
268
 
269
269
  Run the project's installed CLI. Prefix each command with `npx` when
270
- `bdk` is not on `PATH`.
270
+ `agent-sdk` is not on `PATH`.
271
271
 
272
272
  ```bash
273
- bdk validate --dir .
274
- bdk info --dir . --json
275
- bdk run --dir . --message "<a representative request>"
276
- bdk eval --dir .
273
+ agent-sdk validate --dir .
274
+ agent-sdk info --dir . --json
275
+ agent-sdk run --dir . --message "<a representative request>"
276
+ agent-sdk eval --dir .
277
277
  ```
278
278
 
279
279
  Fix every validation error, but never change `runtime` to pass
@@ -288,44 +288,44 @@ Run the project's own typecheck and tests.
288
288
  Describe each removed or changed behavior, each unsupported row the
289
289
  agent touched, and the deploy steps. For each peer URL you rewrote, name
290
290
  the slug and the connection file. List every secret name the rewrite
291
- left unused, and the `bdk secret delete <slug> NAME` command for it.
291
+ left unused, and the `agent-sdk secret delete <slug> NAME` command for it.
292
292
  Name each TODO whose slug you could not determine. Do not deploy from
293
293
  the pull request branch, and do not change deployment secrets.
294
294
 
295
295
  Copy this post-merge checklist into the pull request body. One
296
- `bdk deploy --dir <agent-folder>` per agent. Do not use `bdk deploy --all`.
297
- Then `bdk slack create --env prod --dir <agent-folder> [--team <team-id>]`
298
- for each agent that uses Slack. Then `bdk secret delete <slug> NAME` for
299
- each unused peer URL secret, and `bdk secret list <slug>` plus
300
- `bdk secret set <slug> NAME` when the slug is new. Do not tell the user
301
- to deploy again after Slack setup or after `bdk secret set`. The server
296
+ `agent-sdk deploy --dir <agent-folder>` per agent. Do not use `agent-sdk deploy --all`.
297
+ Then `agent-sdk slack create --env prod --dir <agent-folder> [--team <team-id>]`
298
+ for each agent that uses Slack. Then `agent-sdk secret delete <slug> NAME` for
299
+ each unused peer URL secret, and `agent-sdk secret list <slug>` plus
300
+ `agent-sdk secret set <slug> NAME` when the slug is new. Do not tell the user
301
+ to deploy again after Slack setup or after `agent-sdk secret set`. The server
302
302
  redeploys after Slack setup, and a secret is injected on the next
303
303
  request.
304
304
 
305
305
  ## Deploy after merge
306
306
 
307
- Deploy from a pushed ref. `bdk deploy` reads Git and never uploads the
307
+ Deploy from a pushed ref. `agent-sdk deploy` reads Git and never uploads the
308
308
  working tree.
309
309
 
310
310
  When the folder contains one agent:
311
311
 
312
312
  ```bash
313
- bdk login
314
- bdk validate --dir .
315
- bdk deploy --dir . --slug <existing-slug> \
313
+ agent-sdk login
314
+ agent-sdk validate --dir .
315
+ agent-sdk deploy --dir . --slug <existing-slug> \
316
316
  --cursor-events-repo <owner/repo>
317
317
  ```
318
318
 
319
319
  When the folder contains more than one agent, deploy each agent alone.
320
- Run the command one time for each agent folder. A `bdk deploy` on the
320
+ Run the command one time for each agent folder. A `agent-sdk deploy` on the
321
321
  parent folder prints those commands and does not deploy. Do not run
322
- `bdk deploy --all`. Repeat `bdk slack create --env prod` for each agent
322
+ `agent-sdk deploy --all`. Repeat `agent-sdk slack create --env prod` for each agent
323
323
  folder too.
324
324
  The app slug is the folder name, so that name must match the deployed
325
325
  slug.
326
326
 
327
327
  ```bash
328
- bdk deploy --dir <agent-folder> --slug <that-agent-slug> \
328
+ agent-sdk deploy --dir <agent-folder> --slug <that-agent-slug> \
329
329
  --cursor-events-repo <owner/repo>
330
330
  ```
331
331
 
@@ -337,17 +337,17 @@ deployment is running. The peer needs no matching file. After both
337
337
  deploys are running, unset each URL secret the pull request lists:
338
338
 
339
339
  ```bash
340
- bdk secret delete <slug> NAME
340
+ agent-sdk secret delete <slug> NAME
341
341
  ```
342
342
 
343
- Pass every `--cursor-events-repo` value the v1 deployment used. `bdk deploy`
343
+ Pass every `--cursor-events-repo` value the v1 deployment used. `agent-sdk deploy`
344
344
  has no `--allow-domain` flag. Add every egress domain that the v1
345
345
  deployment allowed to `hosting.egressDomains` in the agent config, and
346
346
  merge that change before you deploy. Print only those two fields,
347
347
  because the full output holds credentials:
348
348
 
349
349
  ```bash
350
- bdk deployment get <slug> --json --fields cursorEventRepos,egressAllowedDomains
350
+ agent-sdk deployment get <slug> --json --fields cursorEventRepos,egressAllowedDomains
351
351
  ```
352
352
 
353
353
  Choose a cutover before you deploy:
@@ -359,10 +359,10 @@ Choose a cutover before you deploy:
359
359
  below. If the command reports that same-slug replacement is
360
360
  unavailable, use a new slug.
361
361
  - **New slug.** v1 keeps serving while you test. Set secrets with
362
- `bdk secret set <new-slug> NAME`. Both deployments act on events from
362
+ `agent-sdk secret set <new-slug> NAME`. Both deployments act on events from
363
363
  the same repositories, so point the trial at a test repository with
364
364
  `--cursor-events-repo`. Then move senders over and run
365
- `bdk deployment delete <old-slug>`, which deletes v1's hosted data the same way.
365
+ `agent-sdk deployment delete <old-slug>`, which deletes v1's hosted data the same way.
366
366
 
367
367
  Prefer a new slug when the agent serves Slack, receives webhooks, or
368
368
  keeps data in `ctx.host.kv`.
@@ -372,22 +372,22 @@ After the deploy is running:
372
372
  - Store the alias token the deploy prints. Point every webhook sender
373
373
  and HTTP caller at the new alias URL.
374
374
  - For Slack, log in as a person. A team service-account key cannot
375
- create the app. Run `bdk slack create --env prod --dir <agent-folder>`
375
+ create the app. Run `agent-sdk slack create --env prod --dir <agent-folder>`
376
376
  once per agent (`--team <team-id>` selects the Cursor team that owns
377
377
  the deployment). The server redeploys by itself. Do not deploy again
378
378
  for Slack. The new app is a different bot. Uninstall the old Slack app
379
379
  and invite the new bot to the channels the old one joined. The copied
380
380
  v1 Slack secrets go unused.
381
381
  - For secrets, a same-slug deploy copies the v1 secrets. A new slug
382
- needs `bdk secret set <slug> NAME`. Check with
383
- `bdk secret list <slug> [--team <team-id>]`. `deploy` warns when a
382
+ needs `agent-sdk secret set <slug> NAME`. Check with
383
+ `agent-sdk secret list <slug> [--team <team-id>]`. `deploy` warns when a
384
384
  declared secret is unset. A secret is injected on the next request.
385
- Do not deploy again after `bdk secret set`.
385
+ Do not deploy again after `agent-sdk secret set`.
386
386
  - Reconnect Cursor-account MCP servers from **Deployed Agents** in the
387
387
  dashboard.
388
- - Start a turn with `bdk session create --slug <slug> --message "..." --wait`.
388
+ - Start a turn with `agent-sdk session create --slug <slug> --message "..." --wait`.
389
389
  It prints the `sessionId` once the delivery names it. Then read the turn
390
- with `bdk session get <ses_...> --prod --slug <slug>` until the latest run
390
+ with `agent-sdk session get <ses_...> --prod --slug <slug>` until the latest run
391
391
  finishes.
392
392
 
393
393
  The deploy skill (`skills/deploy/SKILL.md`) covers deploys with an attached
@@ -67,10 +67,10 @@ Read the guide section "Migrating from serve({ otel })".
67
67
 
68
68
  Hosted agents:
69
69
 
70
- - Put the same variables in `bdk secret set`, and add the collector
70
+ - Put the same variables in `agent-sdk secret set`, and add the collector
71
71
  host to `hosting.egressDomains`.
72
72
  - Header values are URL-encoded (`Authorization=Basic%20...`).
73
- - A new header or URL from `bdk secret set` applies on the next export.
73
+ - A new header or URL from `agent-sdk secret set` applies on the next export.
74
74
 
75
75
  Not supported yet: custom span processors, samplers, views, your own
76
76
  SDK, and library auto-instrumentation. A span that ends before the
@@ -8,7 +8,7 @@ description: >-
8
8
 
9
9
  # Setup Slack for the Agent SDK
10
10
 
11
- Dedicated Socket Mode bot. `bdk slack create` opens the
11
+ Dedicated Socket Mode bot. `agent-sdk slack create` opens the
12
12
  signed-in dashboard wizard. Tokens land in `.env.local` and as
13
13
  deployment secrets. Never print token values.
14
14
 
@@ -23,8 +23,8 @@ Guide: `docs/guides/slack.md`.
23
23
  ## 1. Wizard (default)
24
24
 
25
25
  ```bash
26
- bdk login
27
- bdk slack create --dir .
26
+ agent-sdk login
27
+ agent-sdk slack create --dir .
28
28
  ```
29
29
 
30
30
  Same Cursor account in the browser. **Add Slack to this agent**,
@@ -57,10 +57,10 @@ handler.
57
57
 
58
58
  A second `slack create` for the same agent and env overwrites the
59
59
  app (same Slack app id, new manifest and tokens).
60
- `bdk slack destroy` deletes it.
60
+ `agent-sdk slack destroy` deletes it.
61
61
 
62
62
  Local serve does not need a hosted engine. Next
63
- `bdk deploy` injects the stored secrets.
63
+ `agent-sdk deploy` injects the stored secrets.
64
64
 
65
65
  ## 2. Manual (`slack init --manual`)
66
66
 
@@ -69,7 +69,7 @@ Only when they own the app. Preferred: Slack CLI
69
69
  missing. Never `slack deploy`; Agent SDK serve owns Socket Mode.
70
70
 
71
71
  ```bash
72
- bdk slack init --manual --dir . --name "My Agent"
72
+ agent-sdk slack init --manual --dir . --name "My Agent"
73
73
  # --slack-team T0123ABCD when several workspaces are logged in
74
74
  # --no-install to scaffold only
75
75
  ```
@@ -100,8 +100,8 @@ Human gates, one at a time. Stop after each.
100
100
  ## 3. Doctor and smoke
101
101
 
102
102
  ```bash
103
- bdk slack doctor --prefix JENNY
104
- bdk serve --dir . --dev
103
+ agent-sdk slack doctor --prefix JENNY
104
+ agent-sdk serve --dir . --dev
105
105
  ```
106
106
 
107
107
  Green: `app_token`, `connections_open`, `bot_token`, `auth_test`.
@@ -18,14 +18,14 @@ repos: ["acme/api"],
18
18
  ```
19
19
 
20
20
  ```text
21
- bdk login
22
- bdk dev
21
+ agent-sdk login
22
+ agent-sdk dev
23
23
  ```
24
24
 
25
25
  That is enough: PR events stream through your Cursor account, no webhook
26
26
  or GitHub App setup. Open a PR (or replay one with
27
- `bdk github replay <pr-url>`, which also works with `repos` empty)
28
- and watch the review land. Deploy with `bdk deploy`.
27
+ `agent-sdk github replay <pr-url>`, which also works with `repos` empty)
28
+ and watch the review land. Deploy with `agent-sdk deploy`.
29
29
 
30
30
  ## Policies
31
31
 
@@ -75,4 +75,4 @@ notify winners unchanged, and they skip a `skip_teams` team or a
75
75
  - `bot/lib/owners/prompts/base-review.md`: the risk rubric
76
76
  - `.agentic-owners/policy.yml` in your repo: ownership rules
77
77
 
78
- `bdk eval` runs three smoke reviews and skips GitHub writes.
78
+ `agent-sdk eval` runs three smoke reviews and skips GitHub writes.
@@ -35,7 +35,7 @@ export default defineTool({
35
35
  return {
36
36
  status: "failed",
37
37
  message:
38
- "not a GitHub pull-request session — reviews start from the github channel (bdk github replay <pr-url> to test locally)",
38
+ "not a GitHub pull-request session — reviews start from the github channel (agent-sdk github replay <pr-url> to test locally)",
39
39
  };
40
40
  }
41
41
  // Wake froze the assessed head into the session workspace. A model-supplied
@@ -5,7 +5,7 @@
5
5
  "description": "Reviews pull requests against committed .agentic-owners policies: risk-tiers the diff, requests the owners as reviewers, approves what the policy allows.",
6
6
  "scripts": {
7
7
  "check": "tsc --noEmit",
8
- "dev": "bdk dev"
8
+ "dev": "agent-sdk dev"
9
9
  },
10
10
  "dependencies": {
11
11
  "@grok/agent-sdk": "latest",
@@ -19,13 +19,13 @@ the bot to each listed channel, including private ones. Then sign the
19
19
  host in:
20
20
 
21
21
  ```text
22
- bdk login
23
- bdk slack create --dir .
24
- bdk dev
22
+ agent-sdk login
23
+ agent-sdk slack create --dir .
24
+ agent-sdk dev
25
25
  ```
26
26
 
27
27
  The Slack app uses `AGENTS_MD_SLACK_BOT_TOKEN` and
28
- `AGENTS_MD_SLACK_APP_TOKEN`. `bdk slack create` writes both values to
28
+ `AGENTS_MD_SLACK_APP_TOKEN`. `agent-sdk slack create` writes both values to
29
29
  `.env.local`.
30
30
 
31
31
  Schedules do not fire under `dev`. Dispatch the weekly job: