@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
@@ -5,7 +5,7 @@
5
5
  "description": "Keeps AGENTS.md current from last week's merged PRs and Slack.",
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",
@@ -16,14 +16,14 @@ npx @grok/agent-sdk init ./code-wiki --template code-wiki
16
16
  Connect GitHub in Cursor for those repos. Then sign the host in:
17
17
 
18
18
  ```text
19
- bdk login
20
- bdk dev
19
+ agent-sdk login
20
+ agent-sdk dev
21
21
  ```
22
22
 
23
23
  Events and API calls use your Cursor GitHub connection. Replay a merged PR:
24
24
 
25
25
  ```text
26
- bdk github replay https://github.com/owner/repo/pull/1 --dir . --action closed
26
+ agent-sdk github replay https://github.com/owner/repo/pull/1 --dir . --action closed
27
27
  ```
28
28
 
29
29
  ## Files
@@ -5,7 +5,7 @@
5
5
  "description": "Keeps an in-repo wiki current after pull requests merge.",
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",
@@ -15,8 +15,8 @@ npx @grok/agent-sdk init ./my-demo --template demo
15
15
  Connect GitHub in Cursor for those repos. Then sign the host in:
16
16
 
17
17
  ```text
18
- bdk login
19
- bdk dev
18
+ agent-sdk login
19
+ agent-sdk dev
20
20
  ```
21
21
 
22
22
  In the playground, run `/queue/pr` with a PR URL or `owner/repo#N` from
@@ -28,7 +28,7 @@ with `read` and `grep` only.
28
28
  POST /<slug>/v1/channels/queue/pr
29
29
  ```
30
30
 
31
- `bdk eval` skips the GitHub comment.
31
+ `agent-sdk eval` skips the GitHub comment.
32
32
 
33
33
  ## Files to edit
34
34
 
@@ -5,7 +5,7 @@
5
5
  "description": "Records a walkthrough for a GitHub pull request.",
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",
@@ -5,7 +5,7 @@
5
5
  "description": "PR autofixer: attach a pull request to a Cursor cloud agent and keep it moving toward merge.",
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",
@@ -13,12 +13,12 @@ npx @grok/agent-sdk init ./security-help --template security-help
13
13
  ## Run
14
14
 
15
15
  ```text
16
- bdk login
17
- bdk slack create --name "Security Help" --channel-posts
16
+ agent-sdk login
17
+ agent-sdk slack create --name "Security Help" --channel-posts
18
18
  ```
19
19
 
20
20
  The Slack app uses `SECURITY_HELP_SLACK_BOT_TOKEN` and
21
- `SECURITY_HELP_SLACK_APP_TOKEN`. `bdk slack create` writes both values
21
+ `SECURITY_HELP_SLACK_APP_TOKEN`. `agent-sdk slack create` writes both values
22
22
  to `.env.local`.
23
23
 
24
24
  To watch channel posts, add channel names or IDs to `watch` in
@@ -27,7 +27,7 @@ To watch channel posts, add channel names or IDs to `watch` in
27
27
  this configuration.
28
28
 
29
29
  ```bash
30
- bdk dev
30
+ agent-sdk dev
31
31
  ```
32
32
 
33
33
  Slack is a dedicated bot (`@Security Help`). Mentions, DMs, and channel
@@ -43,4 +43,4 @@ one in the playground.
43
43
  - `bot/skills/`: how to look at a PR, a leak, or an access ask
44
44
  - `bot/instructions.md`: routing
45
45
 
46
- `bdk eval` runs three smoke turns and writes nothing to Slack or GitHub.
46
+ `agent-sdk eval` runs three smoke turns and writes nothing to Slack or GitHub.
@@ -5,7 +5,7 @@
5
5
  "description": "Answers security questions in Slack and takes a first look at a pull request.",
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"
@@ -16,14 +16,14 @@ share one owner.
16
16
  Connect GitHub in Cursor for those repos. Then sign the host in:
17
17
 
18
18
  ```text
19
- bdk login
20
- bdk dev
19
+ agent-sdk login
20
+ agent-sdk dev
21
21
  ```
22
22
 
23
23
  Events and API calls use your Cursor GitHub connection. Replay a PR:
24
24
 
25
25
  ```text
26
- bdk github replay https://github.com/owner/repo/pull/1 --dir .
26
+ agent-sdk github replay https://github.com/owner/repo/pull/1 --dir .
27
27
  ```
28
28
 
29
29
  ## Files
@@ -5,7 +5,7 @@
5
5
  "description": "Reviews pull requests for exploitable security bugs.",
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",
@@ -10,8 +10,8 @@ npx @grok/agent-sdk init ./thermo-quality-review --template thermo-quality-revie
10
10
 
11
11
  ```text
12
12
  cd thermo-quality-review
13
- bdk login
14
- bdk deploy --cursor-events-repo acme/api
13
+ agent-sdk login
14
+ agent-sdk deploy --cursor-events-repo acme/api
15
15
  ```
16
16
 
17
17
  The deployment watches that repo through your team's Cursor GitHub
@@ -20,13 +20,13 @@ connection. Open a PR to get a review.
20
20
  ## Run locally
21
21
 
22
22
  ```text
23
- bdk dev --cursor-events --repo acme/api
23
+ agent-sdk dev --cursor-events --repo acme/api
24
24
  ```
25
25
 
26
26
  Or replay a PR without pushing:
27
27
 
28
28
  ```text
29
- bdk github replay https://github.com/acme/api/pull/12 --dir .
29
+ agent-sdk github replay https://github.com/acme/api/pull/12 --dir .
30
30
  ```
31
31
 
32
32
  ## Files
@@ -5,7 +5,7 @@
5
5
  "description": "Reviews pull requests for structural code quality.",
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",
@@ -10,8 +10,8 @@ npx @grok/agent-sdk init ./thermo-review --template thermo-review
10
10
 
11
11
  ```text
12
12
  cd thermo-review
13
- bdk login
14
- bdk deploy --cursor-events-repo acme/api
13
+ agent-sdk login
14
+ agent-sdk deploy --cursor-events-repo acme/api
15
15
  ```
16
16
 
17
17
  The deployment watches that repo through your team's Cursor GitHub
@@ -20,13 +20,13 @@ connection. Open a PR to get a review.
20
20
  ## Run locally
21
21
 
22
22
  ```text
23
- bdk dev --cursor-events --repo acme/api
23
+ agent-sdk dev --cursor-events --repo acme/api
24
24
  ```
25
25
 
26
26
  Or replay a PR without pushing:
27
27
 
28
28
  ```text
29
- bdk github replay https://github.com/acme/api/pull/12 --dir .
29
+ agent-sdk github replay https://github.com/acme/api/pull/12 --dir .
30
30
  ```
31
31
 
32
32
  ## Files
@@ -5,7 +5,7 @@
5
5
  "description": "Reviews pull requests for bugs and breakage.",
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",
@@ -14,8 +14,8 @@ npx @grok/agent-sdk init ./my-triage-agent --template triage-jira
14
14
  Connect the tracker in Cursor.
15
15
 
16
16
  ```text
17
- bdk login
18
- bdk dev
17
+ agent-sdk login
18
+ agent-sdk dev
19
19
  ```
20
20
 
21
21
  In the playground, paste an issue identifier or run `/queue/issue`.
@@ -35,7 +35,7 @@ POST /<slug>/v1/channels/webhook
35
35
  Set `LINEAR_WEBHOOK_SECRET` or `JIRA_WEBHOOK_SECRET` to the signing
36
36
  secret from the tracker. The identifier is the continuation key.
37
37
  Questions and feedback get comments. A duplicate match gets a comment
38
- on both issues. `bdk eval` classifies and skips tracker writes.
38
+ on both issues. `agent-sdk eval` classifies and skips tracker writes.
39
39
 
40
40
  ## Files to edit
41
41
 
@@ -9,8 +9,8 @@ npx @grok/agent-sdk init ./my-triage-agent --template triage-jira
9
9
  Connect Jira in Cursor, then:
10
10
 
11
11
  ```text
12
- bdk login
13
- bdk dev
12
+ agent-sdk login
13
+ agent-sdk dev
14
14
  ```
15
15
 
16
16
  Paste an issue identifier in the playground. To receive Jira
@@ -18,4 +18,4 @@ Paste an issue identifier in the playground. To receive Jira
18
18
  point the webhook at `POST /<slug>/v1/channels/webhook`.
19
19
 
20
20
  Edit `bot/skills/triage-rubric.md` for your severity ladder.
21
- `bdk eval` skips Jira writes.
21
+ `agent-sdk eval` skips Jira writes.
@@ -9,8 +9,8 @@ npx @grok/agent-sdk init ./my-triage-agent --template triage-linear
9
9
  Connect Linear in Cursor, then:
10
10
 
11
11
  ```text
12
- bdk login
13
- bdk dev
12
+ agent-sdk login
13
+ agent-sdk dev
14
14
  ```
15
15
 
16
16
  Paste an issue identifier in the playground. To receive Linear Issue
@@ -18,4 +18,4 @@ create webhooks, self-host, set `LINEAR_WEBHOOK_SECRET`, and point the
18
18
  webhook at `POST /<slug>/v1/channels/webhook`.
19
19
 
20
20
  Edit `bot/skills/triage-rubric.md` for your severity ladder.
21
- `bdk eval` skips Linear writes.
21
+ `agent-sdk eval` skips Linear writes.
@@ -5,7 +5,7 @@
5
5
  "description": "Comments on existing Linear or Jira issues.",
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",
@@ -1 +0,0 @@
1
- import{_ as o,c as a,o as t,a3 as i}from"./chunks/framework.BNw1pucY.js";const p=JSON.parse('{"title":"Changelog","description":"Changes for each release of @grok/agent-sdk","frontmatter":{"title":"Changelog","description":"Changes for each release of @grok/agent-sdk"},"headers":[],"relativePath":"changelog.md","filePath":"changelog.md"}'),c={name:"changelog.md"};function n(s,e,d,l,r,h){return t(),a("div",null,[...e[0]||(e[0]=[i('<h1 id="changelog" tabindex="-1">Changelog <a class="header-anchor" href="#changelog" aria-label="Permalink to &quot;Changelog&quot;">​</a></h1><h2 id="_0-2-28-2026-10-21" tabindex="-1">0.2.28 (2026-10-21) <a class="header-anchor" href="#_0-2-28-2026-10-21" aria-label="Permalink to &quot;0.2.28 (2026-10-21)&quot;">​</a></h2><h3 id="breaking-changes" tabindex="-1">Breaking changes <a class="header-anchor" href="#breaking-changes" aria-label="Permalink to &quot;Breaking changes&quot;">​</a></h3><ul><li>Semantic search is removed. Use Grep. Read <a href="./reference/agent-config.html#migrate-off-semantic-search">Migrate off semantic search</a>.</li><li><code>CATCH_DELIVERY_ID_HEADER</code> left <code>@grok/agent-sdk/channels</code>. Remove that import. The npm package has no replacement.</li><li><code>attachRelayMcp</code> was not a published export. Remove that import. The npm package has no replacement.</li><li><code>CursorBackendClient</code> was not a published export. Remove that import. Clone a pull request with <code>@grok/agent-sdk/scm</code>.</li><li><code>postRelaySlackMessage</code> was not a published export. Remove that import. The npm package has no replacement.</li></ul><h3 id="behavior-changes" tabindex="-1">Behavior changes <a class="header-anchor" href="#behavior-changes" aria-label="Permalink to &quot;Behavior changes&quot;">​</a></h3><ul><li>With deploy caps on, <code>agent-sdk deploy</code> stops at 20 deployments or 100 deploys in 24 hours. Read <a href="./reference/limits.html">Limits</a>.</li><li><code>agent-sdk deploy</code> refuses <code>persistent: true</code>. A running persistent deployment keeps serving.</li><li>A direct file-tool call respects <code>tools</code>. A path outside the workspace fails.</li><li>With <code>local.sandbox</code> on, file tools refuse a path outside the session workspace.</li><li><code>@grok/agent-sdk</code> depends on <code>@modelcontextprotocol/sdk</code> 1.32.1.</li><li>An MCP server that redirects to a different host or port fails.</li><li><code>agent-sdk init</code> and the templates depend on zod 4.</li></ul><h3 id="new" tabindex="-1">New <a class="header-anchor" href="#new" aria-label="Permalink to &quot;New&quot;">​</a></h3><ul><li><code>claimIssue</code> is newly public on <code>@grok/agent-sdk/channels/issues</code>.</li><li><code>claimCheckpoint</code> is newly public on <code>@grok/agent-sdk/channels/change-monitors</code>.</li><li><code>@grok/agent-sdk/scm</code> is newly public.</li><li><code>agent-sdk sessions --prod</code> lists sessions on a Cursor-managed deployment.</li><li>Set <code>botScopes</code> in <code>slack-manifest.json</code>, then run <code>agent-sdk slack create</code> again.</li><li>Slack <code>post-file</code> accepts <code>alt_txt</code> and <code>initial_comment</code>.</li><li>Send <code>X-BDK-Session-Key</code> to keep one hosted session for that key.</li><li>A pull request on <code>&lt;tenant&gt;.ghe.com</code> keeps its own session.</li><li><code>agent-sdk logs --prod</code> prints process output and a <code>tool &lt;name&gt;</code> line. <code>agent-sdk session --prod --events</code> prints the events.</li></ul><h3 id="fixes" tabindex="-1">Fixes <a class="header-anchor" href="#fixes" aria-label="Permalink to &quot;Fixes&quot;">​</a></h3><ul><li>A failed Slack file upload is reported on that thread.</li></ul><h2 id="_0-2-27-2026-10-16" tabindex="-1">0.2.27 (2026-10-16) <a class="header-anchor" href="#_0-2-27-2026-10-16" aria-label="Permalink to &quot;0.2.27 (2026-10-16)&quot;">​</a></h2><h3 id="breaking-changes-1" tabindex="-1">Breaking changes <a class="header-anchor" href="#breaking-changes-1" aria-label="Permalink to &quot;Breaking changes&quot;">​</a></h3><ul><li>Each <code>handle.agents</code> entry is <code>{ slug, url, info }</code>. It no longer has <code>project</code>. Read <code>info</code> instead.</li></ul><h3 id="behavior-changes-1" tabindex="-1">Behavior changes <a class="header-anchor" href="#behavior-changes-1" aria-label="Permalink to &quot;Behavior changes&quot;">​</a></h3><ul><li><code>@grok/agent-sdk</code> requires <code>@cursor/sdk</code> 1.0.38.</li><li>In project info, a function <code>needsApproval</code> is <code>&quot;dynamic&quot;</code> instead of <code>true</code>.</li><li>Project info has <code>schemaVersion: 1</code> and <code>architecture</code>. Diagnostic paths are relative to the project directory.</li><li><code>handle.project</code> is deprecated. Use <code>handle.agents</code>.</li><li><code>loadAgentProject</code>, <code>loadAgentProjects</code>, and <code>projectInfo</code> are deprecated. Use <code>loadProject</code>.</li><li><code>root</code> on <code>defineAgent</code> is deprecated. Use <code>fs</code>. Setting both is an error.</li></ul><h3 id="new-1" tabindex="-1">New <a class="header-anchor" href="#new-1" aria-label="Permalink to &quot;New&quot;">​</a></h3><ul><li><code>loadProject(dir)</code> loads a project without serving it. Its <code>info</code> matches <code>GET /v1/info</code>. Pass <code>{ strict: true }</code> to fail on warnings.</li><li><code>serve</code> accepts a directory or a <code>Project</code> from <code>loadProject</code>.</li><li><code>defineAgent({ fs })</code> mounts your filesystem at <code>/</code>. Agent SDK mounts <code>/tmp</code> and <code>/agent/skills</code> over it.</li><li>With <code>fs</code>, the agent&#39;s skills are read-only at <code>/agent/skills/&lt;name&gt;/SKILL.md</code>. Set <code>skills: false</code> to keep your own <code>/agent/skills</code>.</li><li>Listing a directory includes the files of mounts nested under it.</li></ul><h3 id="fixes-1" tabindex="-1">Fixes <a class="header-anchor" href="#fixes-1" aria-label="Permalink to &quot;Fixes&quot;">​</a></h3><ul><li>A local agent can use a model variant that needs Max Mode, such as Grok 4.7 with a 500k context window.</li><li>A session that has been idle for 10 minutes releases its memory. Its next turn resumes the conversation.</li></ul><h2 id="_0-2-26-2026-10-16" tabindex="-1">0.2.26 (2026-10-16) <a class="header-anchor" href="#_0-2-26-2026-10-16" aria-label="Permalink to &quot;0.2.26 (2026-10-16)&quot;">​</a></h2><h3 id="breaking-changes-2" tabindex="-1">Breaking changes <a class="header-anchor" href="#breaking-changes-2" aria-label="Permalink to &quot;Breaking changes&quot;">​</a></h3><ul><li><code>serve({ otel })</code> is removed. Delete <code>bot/otel.ts</code>, <code>agent/otel.ts</code>, and <code>bot/instrumentation.ts</code>. Set <code>OTEL_*</code> variables. Read <a href="./guides/opentelemetry.html#migrating-from-serve-otel">Migrating from serve({ otel })</a>.</li></ul><h3 id="behavior-changes-2" tabindex="-1">Behavior changes <a class="header-anchor" href="#behavior-changes-2" aria-label="Permalink to &quot;Behavior changes&quot;">​</a></h3><ul><li><code>ctx.host.otel</code> is deprecated. It still runs for this release. The first call emits one deprecation warning. Set <code>OTEL_*</code> variables. Record with <code>metrics.getMeter</code> and <code>trace.getTracer</code> from <code>@opentelemetry/api</code>.</li><li>A span started during a turn or a tool gets <code>cursor.conversation.id</code> from the active context when the span does not set it. A metric does not. Call <code>currentConversationId</code> from <code>@grok/agent-sdk/otel</code> and set the attribute yourself. See <a href="./guides/opentelemetry.html#what-you-can-record">OpenTelemetry</a>.</li><li>A turn waits for MCP OAuth only when a person can connect. That is a playground or HTTP chat turn, or a Slack message on a channel that shows Connect. <code>toolApprovals: true</code> shows Connect, and so does <code>buildToolApprovalEvents</code> in <code>events</code>. A schedule, a reminder, a webhook, an eval, or a Slack channel without Connect does not wait. A required connection fails with <code>Reconnect &lt;connection&gt;</code>. An optional connection is skipped.</li><li>A turn never waits to authorize an <code>optional</code> connection, also in the playground.</li><li>A turn that waits for MCP OAuth stops after 10 minutes with <code>Reconnect &lt;connection&gt;</code>. <code>interrupt()</code> also stops the wait.</li><li><code>agent-sdk deploy</code> rejects a source host other than GitHub, gitlab.com, or Origin.</li><li>A new scaffold imports <code>zod/v4</code>. A zod 3 schema and a zod 4 schema both still parse.</li><li><code>agent-sdk deploy</code> with no terminal lists a connector that needs sign-in as pending.</li></ul><h3 id="new-2" tabindex="-1">New <a class="header-anchor" href="#new-2" aria-label="Permalink to &quot;New&quot;">​</a></h3><ul><li><code>agent-sdk deploy</code> deploys a bot from a gitlab.com repository.</li><li>When you omit <code>--cursor-events-repo</code>, a GitLab deploy watches that project. A nested group is part of the path.</li><li>When that deploy cannot watch the project, the deploy still finishes. The CLI says the deployment is not watching the project.</li><li>An agentic Slack reply can set <code>cards: { display: &quot;plan&quot; }</code>. Slack shows the <code>post-card</code> steps from that turn as one checklist.</li><li>A <code>title</code> names that checklist. A title has at most 256 characters.</li><li>With no <code>cards</code> option, Slack keeps one card for each step.</li><li><code>send()</code> returns a delivery id. Set <code>deliveryId</code> to choose it. <code>nudge.delivered</code> and <code>message.received</code> include that id.</li></ul><h3 id="fixes-2" tabindex="-1">Fixes <a class="header-anchor" href="#fixes-2" aria-label="Permalink to &quot;Fixes&quot;">​</a></h3><ul><li>Public helper signatures use portable types. A webhook body is a <code>string</code> or a <code>Uint8Array</code>. An environment map is <code>Record&lt;string, string | undefined&gt;</code>.</li><li><code>HostFilesApi.read</code> takes a <code>HostFileTextEncoding</code>. A <code>Buffer</code> and <code>process.env</code> still type-check.</li><li>OpenTelemetry ends each tool span when that tool finishes.</li><li>With no OpenTelemetry endpoint, the process holds at most 2048 spans and 2048 log records.</li><li>A follow-up after a redeploy resumes the same agent. A changed workspace path does not start a new conversation.</li><li>In a Slack Connect channel, sender checks use the workspace where the app is installed.</li><li>A <code>cursorAccount</code> GitHub GraphQL call includes the repository.</li><li>A Slack bot with a lapsed MCP connection replies with a reconnect message.</li></ul><h2 id="_0-2-25-2026-10-14" tabindex="-1">0.2.25 (2026-10-14) <a class="header-anchor" href="#_0-2-25-2026-10-14" aria-label="Permalink to &quot;0.2.25 (2026-10-14)&quot;">​</a></h2><h3 id="new-3" tabindex="-1">New <a class="header-anchor" href="#new-3" aria-label="Permalink to &quot;New&quot;">​</a></h3><ul><li><code>agent-sdk validate --json</code> writes one JSON object. Each diagnostic has a code.</li></ul><h3 id="fixes-3" tabindex="-1">Fixes <a class="header-anchor" href="#fixes-3" aria-label="Permalink to &quot;Fixes&quot;">​</a></h3><ul><li>OpenTelemetry metrics follow <code>OTEL_EXPORTER_OTLP_METRICS_TEMPORALITY_PREFERENCE</code>. The default stays delta.</li><li><code>ctx.host.github.getOctokit()</code> tries again after a failed lookup. A later call can succeed after a GitHub token becomes available.</li></ul><h2 id="_0-2-24-2026-10-13" tabindex="-1">0.2.24 (2026-10-13) <a class="header-anchor" href="#_0-2-24-2026-10-13" aria-label="Permalink to &quot;0.2.24 (2026-10-13)&quot;">​</a></h2><h3 id="breaking-changes-3" tabindex="-1">Breaking changes <a class="header-anchor" href="#breaking-changes-3" aria-label="Permalink to &quot;Breaking changes&quot;">​</a></h3><ul><li>Install <code>zod</code> in the project. The peer range is <code>^3.25.0</code> or <code>^4.0.0</code>. A new scaffold imports <code>zod/v3</code>.</li></ul><h3 id="behavior-changes-3" tabindex="-1">Behavior changes <a class="header-anchor" href="#behavior-changes-3" aria-label="Permalink to &quot;Behavior changes&quot;">​</a></h3><ul><li><code>setContinuationToken(null)</code> releases the continuation key. The next delivery starts a new session.</li><li>Model fallback continues when a blocked model sends progress updates and no assistant text. Those updates are <code>user-message-appended</code>, <code>step-started</code>, and <code>step-completed</code>.</li><li>Read a secret inside a handler, a tool, or a callback. A <code>process.env</code> read while the module is still loading returns an empty value on a Cursor-managed deploy.</li><li>In the Agentic Approver template, a <code>paths</code> glob is relative to the policy directory.</li><li>The package depends on <code>tsx</code> 4.23.15.</li></ul><h3 id="new-4" tabindex="-1">New <a class="header-anchor" href="#new-4" aria-label="Permalink to &quot;New&quot;">​</a></h3><ul><li><code>hmacSignatureAuth</code> takes an optional <code>separator</code>. One header can then carry several HMAC signatures. PagerDuty uses a comma.</li><li><code>cursorCloudAgents</code> accepts <code>cloud.teamMcpServers</code>. The launch uses the team MCP servers you name.</li></ul><h3 id="fixes-4" tabindex="-1">Fixes <a class="header-anchor" href="#fixes-4" aria-label="Permalink to &quot;Fixes&quot;">​</a></h3><ul><li>On Cursor-managed hosting, OpenTelemetry reads the endpoint, the headers, and the resource after secrets load. You can remove a workaround that reads <code>OTEL_EXPORTER_OTLP_HEADERS</code> again.</li></ul><h2 id="_0-2-23-2026-10-09" tabindex="-1">0.2.23 (2026-10-09) <a class="header-anchor" href="#_0-2-23-2026-10-09" aria-label="Permalink to &quot;0.2.23 (2026-10-09)&quot;">​</a></h2><h3 id="behavior-changes-4" tabindex="-1">Behavior changes <a class="header-anchor" href="#behavior-changes-4" aria-label="Permalink to &quot;Behavior changes&quot;">​</a></h3><ul><li><code>agent-sdk migrate</code> rewrites a URL-secret MCP peer to <code>defineConnection({ agent })</code> in the migration pull request.</li><li><code>agent-sdk migrate</code> prints a checklist after the migration. It says when there is nothing to migrate.</li><li><code>agent-sdk slack create --prod</code> says the deployment redeploys by itself.</li><li><code>agent-sdk deploy</code> on a folder of several agents prints one command per agent. You run each command to deploy that agent.</li></ul><h3 id="new-5" tabindex="-1">New <a class="header-anchor" href="#new-5" aria-label="Permalink to &quot;New&quot;">​</a></h3><ul><li>A Slack app can opt in to the <code>chat:write.customize</code> scope. A post can then set its username and its icon. An app that leaves the scope off keeps its current scopes.</li></ul>',47)])])}const g=o(c,[["render",n]]);export{p as __pageData,g as default};
@@ -1 +0,0 @@
1
- import{_ as o,c as a,o as t,a3 as i}from"./chunks/framework.BNw1pucY.js";const p=JSON.parse('{"title":"Changelog","description":"Changes for each release of @grok/agent-sdk","frontmatter":{"title":"Changelog","description":"Changes for each release of @grok/agent-sdk"},"headers":[],"relativePath":"changelog.md","filePath":"changelog.md"}'),c={name:"changelog.md"};function n(s,e,d,l,r,h){return t(),a("div",null,[...e[0]||(e[0]=[i("",47)])])}const g=o(c,[["render",n]]);export{p as __pageData,g as default};