@grok/agent-sdk 0.3.0 → 0.5.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (289) hide show
  1. package/dist/channels/match-ready/index.d.ts +4 -0
  2. package/dist/channels/match-ready/index.d.ts.map +1 -0
  3. package/dist/channels/match-ready/index.js +2 -0
  4. package/dist/channels/match-ready/match-ready-channel.d.ts +5 -0
  5. package/dist/channels/match-ready/match-ready-channel.d.ts.map +1 -0
  6. package/dist/channels/match-ready/match-ready-channel.js +42 -0
  7. package/dist/channels/match-ready/types.d.ts +25 -0
  8. package/dist/channels/match-ready/types.d.ts.map +1 -0
  9. package/dist/channels/match-ready/types.js +1 -0
  10. package/dist/channels/slack/slack-channel.d.ts.map +1 -1
  11. package/dist/channels/slack/slack-channel.js +27 -14
  12. package/dist/docs/404.html +2 -2
  13. package/dist/docs/assets/{app.BzTUBOAD.js → app.CYdjweqP.js} +4 -4
  14. package/dist/docs/assets/{building-with-agents.md.BqJ7AAjG.js → building-with-agents.md.Bo3ct-rf.js} +1 -1
  15. package/dist/docs/assets/changelog.md.BMrJ5WxW.js +1 -0
  16. package/dist/docs/assets/changelog.md.BMrJ5WxW.lean.js +1 -0
  17. package/dist/docs/assets/chunks/@localSearchIndexroot.dUaE1f8e.js +1 -0
  18. package/dist/docs/assets/chunks/{VPLocalSearchBox.DsnRlUT5.js → VPLocalSearchBox.CRATKS9J.js} +1 -1
  19. package/dist/docs/assets/chunks/{arc.DH8GOhiv.js → arc.BxM78ISR.js} +1 -1
  20. package/dist/docs/assets/chunks/{architectureDiagram-Q4EWVU46.9m9ObyuE.js → architectureDiagram-Q4EWVU46.Bi6MuKaU.js} +1 -1
  21. package/dist/docs/assets/chunks/{baseUniq.BXHpx1lE.js → baseUniq.L47qqpDG.js} +1 -1
  22. package/dist/docs/assets/chunks/{blockDiagram-DXYQGD6D.xY3EX59q.js → blockDiagram-DXYQGD6D.kHFF2FK5.js} +1 -1
  23. package/dist/docs/assets/chunks/{c4Diagram-AHTNJAMY.DnqgMVgc.js → c4Diagram-AHTNJAMY.BTW85ll3.js} +1 -1
  24. package/dist/docs/assets/chunks/channel.ljJtQtBi.js +1 -0
  25. package/dist/docs/assets/chunks/{chunk-4BX2VUAB.BjFxK2A3.js → chunk-4BX2VUAB.Bbh3_48g.js} +1 -1
  26. package/dist/docs/assets/chunks/{chunk-4TB4RGXK.BujS_Spt.js → chunk-4TB4RGXK.WeAmK3fK.js} +1 -1
  27. package/dist/docs/assets/chunks/{chunk-55IACEB6.YbTjhdaM.js → chunk-55IACEB6.DTdUiVHf.js} +1 -1
  28. package/dist/docs/assets/chunks/{chunk-EDXVE4YY.DnQ8t4GC.js → chunk-EDXVE4YY.n5XzANDz.js} +1 -1
  29. package/dist/docs/assets/chunks/{chunk-FMBD7UC4.B67AwAmj.js → chunk-FMBD7UC4.D51eewCb.js} +1 -1
  30. package/dist/docs/assets/chunks/{chunk-OYMX7WX6.DrZIAFOm.js → chunk-OYMX7WX6.BrY0U7ZV.js} +1 -1
  31. package/dist/docs/assets/chunks/{chunk-QZHKN3VN.BLmmydkn.js → chunk-QZHKN3VN.B0OA4aFV.js} +1 -1
  32. package/dist/docs/assets/chunks/{chunk-YZCP3GAM.DaoOfw0O.js → chunk-YZCP3GAM.Djt3Mjft.js} +1 -1
  33. package/dist/docs/assets/chunks/classDiagram-6PBFFD2Q.BZ3Uc-XU.js +1 -0
  34. package/dist/docs/assets/chunks/classDiagram-v2-HSJHXN6E.BZ3Uc-XU.js +1 -0
  35. package/dist/docs/assets/chunks/clone.BDtbEo69.js +1 -0
  36. package/dist/docs/assets/chunks/{cose-bilkent-S5V4N54A.DMQuNhM5.js → cose-bilkent-S5V4N54A.DiMcA6Q8.js} +1 -1
  37. package/dist/docs/assets/chunks/{dagre-KV5264BT.CZoGVuUf.js → dagre-KV5264BT.BGqI4vrS.js} +1 -1
  38. package/dist/docs/assets/chunks/{diagram-5BDNPKRD.CLt9uOyL.js → diagram-5BDNPKRD.bDqFuMoH.js} +1 -1
  39. package/dist/docs/assets/chunks/{diagram-G4DWMVQ6.DpczEm1G.js → diagram-G4DWMVQ6.Y0sxaXRU.js} +1 -1
  40. package/dist/docs/assets/chunks/{diagram-MMDJMWI5.D4r13DvJ.js → diagram-MMDJMWI5.Bg43b0yi.js} +1 -1
  41. package/dist/docs/assets/chunks/{diagram-TYMM5635.CYU9eGFu.js → diagram-TYMM5635.DCfVasEC.js} +1 -1
  42. package/dist/docs/assets/chunks/{erDiagram-SMLLAGMA.QA9naWEw.js → erDiagram-SMLLAGMA.C72GaD16.js} +1 -1
  43. package/dist/docs/assets/chunks/{flowDiagram-DWJPFMVM.BbNoVZYd.js → flowDiagram-DWJPFMVM.DxRQj7pP.js} +1 -1
  44. package/dist/docs/assets/chunks/{ganttDiagram-T4ZO3ILL.IHjDoG7r.js → ganttDiagram-T4ZO3ILL.DiLZy5Q4.js} +1 -1
  45. package/dist/docs/assets/chunks/{gitGraphDiagram-UUTBAWPF.B21VMdf5.js → gitGraphDiagram-UUTBAWPF.DL8XkRvh.js} +1 -1
  46. package/dist/docs/assets/chunks/{graph.DgJ4L-8V.js → graph.3Xub80xJ.js} +1 -1
  47. package/dist/docs/assets/chunks/{infoDiagram-42DDH7IO.CQjrcthc.js → infoDiagram-42DDH7IO.O3lGaspu.js} +1 -1
  48. package/dist/docs/assets/chunks/{ishikawaDiagram-UXIWVN3A.D4tPGtVo.js → ishikawaDiagram-UXIWVN3A.w-pCiQzn.js} +1 -1
  49. package/dist/docs/assets/chunks/{journeyDiagram-VCZTEJTY.BD3WaNbQ.js → journeyDiagram-VCZTEJTY.Cg_oBs9j.js} +1 -1
  50. package/dist/docs/assets/chunks/{kanban-definition-6JOO6SKY.Ca0o4Tqz.js → kanban-definition-6JOO6SKY.BpfMGPwn.js} +1 -1
  51. package/dist/docs/assets/chunks/{layout.DXXqX4MQ.js → layout.CtwXs__p.js} +1 -1
  52. package/dist/docs/assets/chunks/{linear.5c61gNw4.js → linear.NmCskOrP.js} +1 -1
  53. package/dist/docs/assets/chunks/{min.B1-NAjHX.js → min.DpQtsLKs.js} +1 -1
  54. package/dist/docs/assets/chunks/{mindmap-definition-QFDTVHPH.BELznv3-.js → mindmap-definition-QFDTVHPH.B-P-aKVp.js} +1 -1
  55. package/dist/docs/assets/chunks/{pieDiagram-DEJITSTG.qPzO1mq5.js → pieDiagram-DEJITSTG.BfjjqK7j.js} +1 -1
  56. package/dist/docs/assets/chunks/{quadrantDiagram-34T5L4WZ.CxIvzbjX.js → quadrantDiagram-34T5L4WZ.BTzHo53F.js} +1 -1
  57. package/dist/docs/assets/chunks/{requirementDiagram-MS252O5E.CqA0iJx8.js → requirementDiagram-MS252O5E.DIT2FIKr.js} +1 -1
  58. package/dist/docs/assets/chunks/{sankeyDiagram-XADWPNL6.XRTutBnb.js → sankeyDiagram-XADWPNL6.NK1wCsgt.js} +1 -1
  59. package/dist/docs/assets/chunks/{sequenceDiagram-FGHM5R23.E--7bRLQ.js → sequenceDiagram-FGHM5R23.D9oElkvo.js} +1 -1
  60. package/dist/docs/assets/chunks/{stateDiagram-FHFEXIEX.C4vGu8zq.js → stateDiagram-FHFEXIEX.IPksnixH.js} +1 -1
  61. package/dist/docs/assets/chunks/stateDiagram-v2-QKLJ7IA2.CbhzVsQE.js +1 -0
  62. package/dist/docs/assets/chunks/{theme.DMj_7q3B.js → theme.CgKu7tr3.js} +2 -2
  63. package/dist/docs/assets/chunks/{timeline-definition-GMOUNBTQ.C7LgNVAL.js → timeline-definition-GMOUNBTQ.CuAtJapY.js} +1 -1
  64. package/dist/docs/assets/chunks/{vennDiagram-DHZGUBPP.HUwoZcy_.js → vennDiagram-DHZGUBPP.B87nNW9E.js} +1 -1
  65. package/dist/docs/assets/chunks/wardley-RL74JXVD.BFIVMaoi.js +162 -0
  66. package/dist/docs/assets/chunks/{wardleyDiagram-NUSXRM2D.B2pSo5rB.js → wardleyDiagram-NUSXRM2D.BELjSq8w.js} +1 -1
  67. package/dist/docs/assets/chunks/{xychartDiagram-5P7HB3ND.NQhMiOOL.js → xychartDiagram-5P7HB3ND.5zN5ZGsz.js} +1 -1
  68. package/dist/docs/assets/{deployment.md.BtqJrHhp.js → deployment.md.DJtuDVLh.js} +3 -3
  69. package/dist/docs/assets/{deployment.md.BtqJrHhp.lean.js → deployment.md.DJtuDVLh.lean.js} +1 -1
  70. package/dist/docs/assets/{guides_agent-to-agent.md.BcmSqL2z.js → guides_agent-to-agent.md.DcB3nhOz.js} +1 -1
  71. package/dist/docs/assets/{guides_github.md.6jiEH7dg.js → guides_github.md.CcuZ7keS.js} +1 -1
  72. package/dist/docs/assets/{guides_mcp-oauth.md.C-Sx_IPa.js → guides_mcp-oauth.md.GVPMKcYl.js} +1 -1
  73. package/dist/docs/assets/{guides_migrate.md.BbhHYeCr.js → guides_migrate.md.B8CZxnnX.js} +1 -1
  74. package/dist/docs/assets/{guides_slack.md.BgIGG9ur.js → guides_slack.md.D7Rwyva4.js} +1 -1
  75. package/dist/docs/assets/{hillclimbing.md.3TkdF79A.js → hillclimbing.md.M51bF-oT.js} +1 -1
  76. package/dist/docs/assets/index.md.DnJPj_B6.js +14 -0
  77. package/dist/docs/assets/index.md.DnJPj_B6.lean.js +1 -0
  78. package/dist/docs/assets/{reference_agent-config.md.C0Tp_Fk9.js → reference_agent-config.md.Bbqf0lgS.js} +13 -5
  79. package/dist/docs/assets/{reference_agent-config.md.C0Tp_Fk9.lean.js → reference_agent-config.md.Bbqf0lgS.lean.js} +1 -1
  80. package/dist/docs/assets/{reference_cli.md.B8GdpaRj.js → reference_cli.md.DHm6DmYk.js} +2 -2
  81. package/dist/docs/assets/{reference_hooks.md.CSWmOwMM.js → reference_hooks.md.vbIM394-.js} +2 -2
  82. package/dist/docs/assets/{reference_hooks.md.CSWmOwMM.lean.js → reference_hooks.md.vbIM394-.lean.js} +1 -1
  83. package/dist/docs/assets/{reference_tools.md.B2OaR1Nb.js → reference_tools.md.BhqW6neF.js} +4 -2
  84. package/dist/docs/assets/{reference_tools.md.B2OaR1Nb.lean.js → reference_tools.md.BhqW6neF.lean.js} +1 -1
  85. package/dist/docs/building-with-agents.html +36 -36
  86. package/dist/docs/building-with-agents.md +3 -3
  87. package/dist/docs/changelog.html +36 -36
  88. package/dist/docs/changelog.md +44 -1
  89. package/dist/docs/deployment.html +37 -37
  90. package/dist/docs/deployment.md +22 -16
  91. package/dist/docs/evals.html +35 -35
  92. package/dist/docs/guides/agent-to-agent.html +37 -37
  93. package/dist/docs/guides/agent-to-agent.md +4 -2
  94. package/dist/docs/guides/bitbucket.html +35 -35
  95. package/dist/docs/guides/cloud-agents.html +35 -35
  96. package/dist/docs/guides/convert-automation.html +35 -35
  97. package/dist/docs/guides/github.html +37 -37
  98. package/dist/docs/guides/github.md +1 -1
  99. package/dist/docs/guides/gitlab.html +35 -35
  100. package/dist/docs/guides/improve.html +35 -35
  101. package/dist/docs/guides/jev.html +35 -35
  102. package/dist/docs/guides/mcp-oauth.html +37 -37
  103. package/dist/docs/guides/mcp-oauth.md +1 -1
  104. package/dist/docs/guides/migrate.html +37 -37
  105. package/dist/docs/guides/migrate.md +1 -1
  106. package/dist/docs/guides/opentelemetry.html +35 -35
  107. package/dist/docs/guides/pagerduty.html +35 -35
  108. package/dist/docs/guides/slack.html +37 -37
  109. package/dist/docs/guides/slack.md +1 -1
  110. package/dist/docs/guides/webhooks.html +35 -35
  111. package/dist/docs/hashmap.json +1 -1
  112. package/dist/docs/hillclimbing.html +36 -36
  113. package/dist/docs/hillclimbing.md +1 -1
  114. package/dist/docs/index.html +42 -48
  115. package/dist/docs/index.md +8 -14
  116. package/dist/docs/llms-full.txt +176 -54
  117. package/dist/docs/quickstart.html +35 -35
  118. package/dist/docs/reference/access.html +35 -35
  119. package/dist/docs/reference/agent-config.html +47 -39
  120. package/dist/docs/reference/agent-config.md +75 -10
  121. package/dist/docs/reference/artifacts.html +35 -35
  122. package/dist/docs/reference/channels.html +35 -35
  123. package/dist/docs/reference/cli.html +38 -38
  124. package/dist/docs/reference/cli.md +2 -2
  125. package/dist/docs/reference/connections.html +35 -35
  126. package/dist/docs/reference/evals.html +35 -35
  127. package/dist/docs/reference/extensions.html +35 -35
  128. package/dist/docs/reference/hooks.html +37 -37
  129. package/dist/docs/reference/hooks.md +1 -1
  130. package/dist/docs/reference/http-api.html +35 -35
  131. package/dist/docs/reference/instructions.html +35 -35
  132. package/dist/docs/reference/limits.html +35 -35
  133. package/dist/docs/reference/memory.html +35 -35
  134. package/dist/docs/reference/playground.html +35 -35
  135. package/dist/docs/reference/project-layout.html +35 -35
  136. package/dist/docs/reference/schedules.html +35 -35
  137. package/dist/docs/reference/sessions.html +35 -35
  138. package/dist/docs/reference/skills.html +35 -35
  139. package/dist/docs/reference/subagents.html +35 -35
  140. package/dist/docs/reference/tools.html +39 -37
  141. package/dist/docs/reference/tools.md +12 -0
  142. package/dist/docs/templates/agentic-owners.html +35 -35
  143. package/dist/docs/templates/reviews.html +35 -35
  144. package/dist/docs/troubleshooting.html +35 -35
  145. package/dist/filesystem.d.ts +12 -412
  146. package/dist/filesystem.d.ts.map +1 -1
  147. package/dist/filesystem.js +37 -980
  148. package/dist/index.d.ts +1 -3
  149. package/dist/index.d.ts.map +1 -1
  150. package/dist/index.js +1 -3
  151. package/dist/internal/authored-alias-hooks.d.ts +6 -0
  152. package/dist/internal/authored-alias-hooks.d.ts.map +1 -1
  153. package/dist/internal/authored-alias-hooks.js +12 -0
  154. package/dist/internal/authored-loaders.js +10 -1
  155. package/dist/internal/cli/commands/scaffold.js +1 -1
  156. package/dist/internal/continuation-channel.d.ts +3 -3
  157. package/dist/internal/continuation-channel.js +3 -3
  158. package/dist/internal/continuation-identity.d.ts +6 -5
  159. package/dist/internal/continuation-identity.d.ts.map +1 -1
  160. package/dist/internal/continuation-identity.js +17 -2
  161. package/dist/internal/continuation-session-ids.d.ts +15 -0
  162. package/dist/internal/continuation-session-ids.d.ts.map +1 -0
  163. package/dist/internal/continuation-session-ids.js +43 -0
  164. package/dist/internal/direct-file-tools.d.ts +21 -0
  165. package/dist/internal/direct-file-tools.d.ts.map +1 -0
  166. package/dist/internal/direct-file-tools.js +60 -0
  167. package/dist/internal/discovery/agent.d.ts.map +1 -1
  168. package/dist/internal/discovery/agent.js +71 -66
  169. package/dist/internal/filesystem/walk.d.ts +4 -56
  170. package/dist/internal/filesystem/walk.d.ts.map +1 -1
  171. package/dist/internal/filesystem/walk.js +4 -198
  172. package/dist/internal/hosted-catch-protocol.d.ts +3 -3
  173. package/dist/internal/hosted-catch-protocol.js +3 -3
  174. package/dist/internal/hosted-fetch.d.ts +7 -0
  175. package/dist/internal/hosted-fetch.d.ts.map +1 -0
  176. package/dist/internal/hosted-fetch.js +26 -0
  177. package/dist/internal/hosted-managed-automation.js +1 -1
  178. package/dist/internal/install-cursor-skills.d.ts +5 -6
  179. package/dist/internal/install-cursor-skills.d.ts.map +1 -1
  180. package/dist/internal/install-cursor-skills.js +19 -4
  181. package/dist/internal/mcp-endpoint.js +4 -4
  182. package/dist/internal/model-config.d.ts.map +1 -1
  183. package/dist/internal/model-config.js +11 -4
  184. package/dist/internal/otel/http.d.ts +2 -1
  185. package/dist/internal/otel/http.d.ts.map +1 -1
  186. package/dist/internal/otel/http.js +2 -3
  187. package/dist/internal/platform-timers.d.ts +3 -7
  188. package/dist/internal/platform-timers.d.ts.map +1 -1
  189. package/dist/internal/platform-timers.js +10 -51
  190. package/dist/internal/sdk-runner.d.ts.map +1 -1
  191. package/dist/internal/sdk-runner.js +22 -40
  192. package/dist/internal/server.d.ts.map +1 -1
  193. package/dist/internal/server.js +6 -1
  194. package/dist/internal/session-engine.d.ts +36 -19
  195. package/dist/internal/session-engine.d.ts.map +1 -1
  196. package/dist/internal/session-engine.js +182 -254
  197. package/dist/internal/tool-paths.d.ts +8 -0
  198. package/dist/internal/tool-paths.d.ts.map +1 -0
  199. package/dist/internal/tool-paths.js +12 -0
  200. package/dist/internal/workspace-tree.d.ts +27 -0
  201. package/dist/internal/workspace-tree.d.ts.map +1 -0
  202. package/dist/internal/workspace-tree.js +106 -0
  203. package/dist/playground/assets/index-D0-FHg1x.css +1 -0
  204. package/dist/playground/assets/index-D5SLKUy6.js +62 -0
  205. package/dist/playground/index.html +2 -2
  206. package/dist/types.d.ts +43 -23
  207. package/dist/types.d.ts.map +1 -1
  208. package/dist/types.js +2 -2
  209. package/docs/README.md +8 -14
  210. package/docs/building-with-agents.md +3 -3
  211. package/docs/changelog.md +44 -1
  212. package/docs/deployment.md +22 -16
  213. package/docs/guides/agent-to-agent.md +4 -2
  214. package/docs/guides/github.md +1 -1
  215. package/docs/guides/mcp-oauth.md +1 -1
  216. package/docs/guides/migrate.md +1 -1
  217. package/docs/guides/slack.md +1 -1
  218. package/docs/hillclimbing.md +1 -1
  219. package/docs/reference/agent-config.md +75 -10
  220. package/docs/reference/cli.md +2 -2
  221. package/docs/reference/hooks.md +1 -1
  222. package/docs/reference/tools.md +12 -0
  223. package/package.json +10 -15
  224. package/skills/cli/SKILL.md +1 -1
  225. package/skills/create-agent/SKILL.md +61 -7
  226. package/skills/debug/SKILL.md +1 -1
  227. package/skills/deploy/SKILL.md +3 -3
  228. package/skills/evals/SKILL.md +1 -1
  229. package/skills/framework-map/SKILL.md +2 -2
  230. package/skills/github/SKILL.md +1 -1
  231. package/skills/hillclimb/SKILL.md +1 -1
  232. package/skills/mcp-auth/SKILL.md +1 -1
  233. package/skills/migrate-v2/SKILL.md +2 -2
  234. package/skills/otel/SKILL.md +1 -1
  235. package/skills/setup-slack/SKILL.md +2 -2
  236. package/dist/docs/assets/changelog.md.BWhC6DET.js +0 -1
  237. package/dist/docs/assets/changelog.md.BWhC6DET.lean.js +0 -1
  238. package/dist/docs/assets/chunks/@localSearchIndexroot.CWxwVoCG.js +0 -1
  239. package/dist/docs/assets/chunks/channel.Cctv0f7X.js +0 -1
  240. package/dist/docs/assets/chunks/classDiagram-6PBFFD2Q.DU5sqchW.js +0 -1
  241. package/dist/docs/assets/chunks/classDiagram-v2-HSJHXN6E.DU5sqchW.js +0 -1
  242. package/dist/docs/assets/chunks/clone.B9rdNt6j.js +0 -1
  243. package/dist/docs/assets/chunks/stateDiagram-v2-QKLJ7IA2.ECMu2BdJ.js +0 -1
  244. package/dist/docs/assets/chunks/wardley-RL74JXVD.BxFEFYZS.js +0 -162
  245. package/dist/docs/assets/index.md.DRfaoRCZ.js +0 -20
  246. package/dist/docs/assets/index.md.DRfaoRCZ.lean.js +0 -1
  247. package/dist/executors.d.ts +0 -11
  248. package/dist/executors.d.ts.map +0 -1
  249. package/dist/executors.js +0 -21
  250. package/dist/internal/filesystem/errors.d.ts +0 -64
  251. package/dist/internal/filesystem/errors.d.ts.map +0 -1
  252. package/dist/internal/filesystem/errors.js +0 -180
  253. package/dist/internal/filesystem/format.d.ts +0 -28
  254. package/dist/internal/filesystem/format.d.ts.map +0 -1
  255. package/dist/internal/filesystem/format.js +0 -209
  256. package/dist/internal/filesystem/merge.d.ts +0 -34
  257. package/dist/internal/filesystem/merge.d.ts.map +0 -1
  258. package/dist/internal/filesystem/merge.js +0 -154
  259. package/dist/internal/filesystem/nearest.d.ts +0 -15
  260. package/dist/internal/filesystem/nearest.d.ts.map +0 -1
  261. package/dist/internal/filesystem/nearest.js +0 -90
  262. package/dist/internal/filesystem/scratch.d.ts +0 -60
  263. package/dist/internal/filesystem/scratch.d.ts.map +0 -1
  264. package/dist/internal/filesystem/scratch.js +0 -187
  265. package/dist/internal/filesystem/sdk-schemas.d.ts +0 -29
  266. package/dist/internal/filesystem/sdk-schemas.d.ts.map +0 -1
  267. package/dist/internal/filesystem/sdk-schemas.js +0 -148
  268. package/dist/internal/filesystem/subagent-inherit.d.ts +0 -39
  269. package/dist/internal/filesystem/subagent-inherit.d.ts.map +0 -1
  270. package/dist/internal/filesystem/subagent-inherit.js +0 -96
  271. package/dist/internal/filesystem/tools.d.ts +0 -59
  272. package/dist/internal/filesystem/tools.d.ts.map +0 -1
  273. package/dist/internal/filesystem/tools.js +0 -634
  274. package/dist/internal/otel/propagation.d.ts +0 -7
  275. package/dist/internal/otel/propagation.d.ts.map +0 -1
  276. package/dist/internal/otel/propagation.js +0 -15
  277. package/dist/internal/sdk-subagent-inherit-support.d.ts +0 -9
  278. package/dist/internal/sdk-subagent-inherit-support.d.ts.map +0 -1
  279. package/dist/internal/sdk-subagent-inherit-support.js +0 -90
  280. package/dist/playground/assets/index-D6mVn9og.js +0 -62
  281. package/dist/playground/assets/index-DlALM6gr.css +0 -1
  282. /package/dist/docs/assets/{building-with-agents.md.BqJ7AAjG.lean.js → building-with-agents.md.Bo3ct-rf.lean.js} +0 -0
  283. /package/dist/docs/assets/{guides_agent-to-agent.md.BcmSqL2z.lean.js → guides_agent-to-agent.md.DcB3nhOz.lean.js} +0 -0
  284. /package/dist/docs/assets/{guides_github.md.6jiEH7dg.lean.js → guides_github.md.CcuZ7keS.lean.js} +0 -0
  285. /package/dist/docs/assets/{guides_mcp-oauth.md.C-Sx_IPa.lean.js → guides_mcp-oauth.md.GVPMKcYl.lean.js} +0 -0
  286. /package/dist/docs/assets/{guides_migrate.md.BbhHYeCr.lean.js → guides_migrate.md.B8CZxnnX.lean.js} +0 -0
  287. /package/dist/docs/assets/{guides_slack.md.BgIGG9ur.lean.js → guides_slack.md.D7Rwyva4.lean.js} +0 -0
  288. /package/dist/docs/assets/{hillclimbing.md.3TkdF79A.lean.js → hillclimbing.md.M51bF-oT.lean.js} +0 -0
  289. /package/dist/docs/assets/{reference_cli.md.B8GdpaRj.lean.js → reference_cli.md.DHm6DmYk.lean.js} +0 -0
@@ -48,7 +48,7 @@ agent-sdk migrate --dir .
48
48
  To migrate a pushed source outside your checkout, pass `--repo`, `--ref`, and
49
49
  `--path`. The [CLI reference](../reference/cli.md#migrate) lists every flag.
50
50
 
51
- You can also ask a coding agent in your checkout to follow the bundled `bdk-migrate-v2` skill. If the project
51
+ You can also ask a coding agent in your checkout to follow the bundled `agent-sdk-migrate-v2` skill. If the project
52
52
  relies on a v1 capability that has no v2 path, the agent stops and names the
53
53
  blocker.
54
54
 
@@ -253,4 +253,4 @@ The person who runs `slack create` grants Cursor three user scopes on their own
253
253
  create and install the app, and `botScopes` doesn't change them.
254
254
 
255
255
  If you already own the Slack app, run `agent-sdk slack init --manual --dir . --name "Triage"` and
256
- follow the `bdk-setup-slack` skill for installation and tokens.
256
+ follow the `agent-sdk-setup-slack` skill for installation and tokens.
@@ -8,7 +8,7 @@ description: "Iteratively improve agent behavior with evals"
8
8
  Hillclimbing improves an agent one measured change at a time. Hold the inputs fixed, change one
9
9
  thing, and keep it only when the same run gets better without moving the behavior you froze.
10
10
 
11
- A coding agent in your checkout can run this loop by following the `bdk-hillclimb` skill.
11
+ A coding agent in your checkout can run this loop by following the `agent-sdk-hillclimb` skill.
12
12
 
13
13
  ## Run one measured round
14
14
 
@@ -14,9 +14,9 @@ import { defineAgent } from "@grok/agent-sdk";
14
14
 
15
15
  export default defineAgent({
16
16
  model: {
17
- id: "grok-4.5",
17
+ id: "grok-4.7",
18
18
  params: [
19
- { id: "effort", value: "high" },
19
+ { id: "reasoning_effort", value: "high" },
20
20
  { id: "fast", value: "true" },
21
21
  ],
22
22
  }, // optional; this is the default
@@ -27,7 +27,7 @@ export default defineAgent({
27
27
 
28
28
  | Field | Type | Meaning |
29
29
  | --- | --- | --- |
30
- | `model` | string or `{ id, params }` | Cursor model for turns. Defaults to `grok-4.5` with `effort=high` and `fast=true`. Subagents omit it to inherit. |
30
+ | `model` | string or `{ id, params }` | Cursor model for turns. Defaults to `grok-4.7` with `reasoning_effort=high` and `fast=true`. Subagents omit it to inherit. |
31
31
  | `name` | string | Display name. Defaults to the package or directory name. |
32
32
  | `description` | string | What the agent is for. Required on subagents, where the parent model reads it to decide when to delegate. |
33
33
  | `instructions` | string | Inline instructions for subagents and generated configs. Prefer `instructions.md`. |
@@ -37,15 +37,15 @@ export default defineAgent({
37
37
  | `builtinTools` | `{ reminders? }` | Opt-in tools that Agent SDK provides. See [Built-in tools](#built-in-tools). |
38
38
  | `tools` | `ToolName[]` | Allowlist of built-in tools. Omit it for the full standard toolset. See [Harness tools](#harness-tools). |
39
39
  | `fs` | `FileSystem` or `(ctx) => FileSystem` | Custom file tree for the session. `root` is the deprecated name. See [Custom filesystem](#custom-filesystem). |
40
+ | `workspace` | string | With `fs`, the folder inside the tree the agent works in, and where project rules load from. Defaults to `/`. For a sandboxed agent without shell, where its session workspace is mounted, `/workspace` by default. |
40
41
  | `skills` | `false` or `(ctx) => FileSystem` | Replaces the skills tree mounted at `/agent/skills`, or turns that mount off. |
41
42
 
42
43
  The `persistent` field was removed. Discovery rejects a config that still sets it, and the error is `persistent was removed. Delete it from defineAgent.`, so `validate`, `dev`, and `deploy` fail until you delete the field. A deployment that is already running keeps serving until you stop or delete it.
43
44
 
44
45
  ## Model
45
46
 
46
- Effort and speed are params, not id suffixes, so Agent SDK rejects an id like
47
- `grok-4.5-fast`. Use the object form shown above to set params, or a plain
48
- string when you don't need any:
47
+ Set effort and speed with params, not in the id. Use the object form shown above
48
+ to set params, or a plain string when you don't need any:
49
49
 
50
50
  ```ts
51
51
  model: "composer-2.5",
@@ -65,10 +65,34 @@ untrusted input, such as webhook payloads, PR diffs, or inbound chat. The
65
65
  sandbox limits the tools themselves, so an injected prompt can't talk the model
66
66
  past it.
67
67
 
68
- Agent SDK runs the file tools (`read`, `edit`, `delete`, `grep`, `glob`, `ls`)
69
- in the serve process, outside the sandbox. With `local.sandbox` on, they refuse
70
- a path outside the session workspace with `Path is outside the workspace`. With
71
- it off, they can reach any path the serve process can.
68
+ With `local.sandbox` on, shell commands run without network access, writes and
69
+ deletes outside the session workspace are refused, and a tool call that needs
70
+ approval, such as an external MCP call, fails closed. What the agent can read
71
+ depends on its `tools`:
72
+
73
+ - **With shell** (or with `tools` omitted, which includes it), the agent runs on
74
+ the host disk. Shell commands and the file tools (`read`, `grep`, `glob`,
75
+ `ls`) can read any file the serve process can, including credentials on the
76
+ host.
77
+ - **With file tools and no shell**, such as `tools: ["read", "grep"]`, the agent
78
+ runs on its session workspace as a tree, mounted at `/workspace`. Set
79
+ [`workspace`](#custom-filesystem) to mount it elsewhere. Every file tool sees
80
+ only the workspace and refuses a path outside it, including through a
81
+ symlink. Running on a tree also turns off what only the host disk provides:
82
+ Cursor hooks don't run, so a Slack follow-up waits for the turn to end
83
+ instead of reaching the running turn; `.cursor/mcp.json` from the workspace
84
+ or an enclosing checkout isn't loaded (connections in `bot/` still are); host
85
+ git status doesn't reach the model; and skills are at `/agent/skills`
86
+ instead of `.cursor/skills`. `AGENTS.md` and `.cursor/rules/` in the
87
+ workspace still load. Tools a tree can't run, such as `readLints`, are left
88
+ out with a warning.
89
+
90
+ To keep an agent's reads inside a tree you choose, give it
91
+ [`fs`](#custom-filesystem) instead.
92
+
93
+ A [direct tool call](./tools.md#call-a-tool-without-a-model-turn) on a
94
+ host-disk agent refuses a path outside the session workspace, after symlinks,
95
+ with `Path is outside the workspace`, whether or not `local.sandbox` is on.
72
96
 
73
97
  ### Local cwd
74
98
 
@@ -85,8 +109,49 @@ at a checkout only when the agent should inherit that tree.
85
109
 
86
110
  ## Custom filesystem
87
111
 
112
+ Set `fs` and the agent's file tools (Read, Write, StrReplace, LS, Grep, Glob,
113
+ Delete) and its subagents work on your tree instead of the host disk. Build it
114
+ with `tempFs`, `unionFs`, `overlayFs`, `readOnlyFs`, or your own `FileSystem`.
115
+
116
+ ```ts
117
+ import { defineAgent, readOnlyFs, tempFs, unionFs } from "@grok/agent-sdk";
118
+
119
+ export default defineAgent({
120
+ fs: unionFs({
121
+ "/repo": readOnlyFs(repoFs),
122
+ "/notes": tempFs({ "/todo.md": "- check the rollout" }),
123
+ }),
124
+ workspace: "/repo",
125
+ });
126
+ ```
127
+
88
128
  `fs` is mounted at `/`, and Agent SDK mounts `/tmp` and `/agent/skills` over it. Set `fs` or the deprecated `root`, not both. A tree that already has `/agent/skills` fails session start unless `skills` is `false`.
89
129
 
130
+ Each turn gets an empty `/tmp`, and large web results land there. Write anything
131
+ the next turn needs elsewhere in the tree. Subagents work on the same tree, so
132
+ their writes are visible to the agent right away, as subagents share the host
133
+ workspace without `fs`.
134
+
135
+ `workspace` is the folder the model works in. Relative paths resolve against
136
+ it, and LS, Grep, and Glob search it when a call names no path. It must be an
137
+ absolute path outside `/tmp`, and defaults to `/`.
138
+
139
+ As on the host, the workspace's `AGENTS.md` and `.cursor/rules/` load as
140
+ project rules. Don't make a checkout you don't trust, such as a pull request
141
+ under review, the workspace. Mount it beside the workspace instead, for example
142
+ at `/repo` with `workspace` left at `/`, where its rules don't load.
143
+
144
+ An `fs` agent has no shell, and listing `"shell"` in `tools` fails validation.
145
+ Tools a tree can't run, such as `readLints` or `computerUse`, are left out: an
146
+ omitted `tools` never includes them, and a `tools` list that names them gets a
147
+ warning. A `tools` list gets only the file tools it names. Omit `tools` to get
148
+ all of them. `fs` works on local turns only.
149
+
150
+ With `fs`, `local.sandbox` only affects approvals: a tool call that needs
151
+ approval, such as an external MCP call, fails closed, as it does without `fs`.
152
+ It changes nothing about file access, because the file tools already see only
153
+ the tree.
154
+
90
155
  ## Harness tools
91
156
 
92
157
  Use `tools` to limit which built-in Cursor tools the model can call.
@@ -316,7 +316,7 @@ agent-sdk migrate [--dir <path>] [--repo <https-url>] [--ref <git-ref>]
316
316
 
317
317
  `migrate` applies only to projects that deployed with `architecture: "v1"`
318
318
  during the early alpha. It starts a Cursor cloud agent on a pushed Git ref
319
- with the bundled `bdk-migrate-v2` skill, and the agent opens a pull request
319
+ with the bundled `agent-sdk-migrate-v2` skill, and the agent opens a pull request
320
320
  with the source changes. The command never deploys or changes secrets.
321
321
 
322
322
  With nothing to change, it prints `Nothing to migrate.` and exits `0`, and it exits `1` if the run ends without a pull request. `deploy` refuses a project that sets `architecture: "v1"` and points to `migrate`. See [Migrate an early-alpha project](../guides/migrate.md).
@@ -328,7 +328,7 @@ agent-sdk skills install [--dry-run] [--json]
328
328
  agent-sdk skills list [--json [--fields <a,b.c>]] [--limit <n>] [--page-token <token>]
329
329
  ```
330
330
 
331
- Package installation copies the bundled skills, `skills install` replaces the installed copies and removes stale ones, and `skills list` prints each skill's bundled and installed versions. The `bdk-cli` skill teaches agents to run `agent-sdk` safely.
331
+ Package installation copies the bundled skills, `skills install` replaces the installed copies and removes stale ones, and `skills list` prints each skill's bundled and installed versions. The `agent-sdk-cli` skill teaches agents to run `agent-sdk` safely.
332
332
 
333
333
  ### Inspect a project {#info}
334
334
 
@@ -71,7 +71,7 @@ Keys are event types from the [event vocabulary](./sessions.md#stream-events), o
71
71
  | --- | --- |
72
72
  | `message.received` | `{ text }` |
73
73
  | `turn.completed` | `{ result?, usage?, cost? }`. `usage` has `inputTokens`, `outputTokens`, `cacheReadTokens`, `cacheWriteTokens`, and optional `reasoningTokens`. `cost` has `totalUsd` and the `model` it was priced against |
74
- | `turn.failed` | `{ message, status? }`. `status` is `"error"` or `"cancelled"` when present |
74
+ | `turn.failed` | `{ message, status?, code? }`. `status` is `"error"` or `"cancelled"` when present. `code` is the runner's stable error code, such as a Cursor SDK `RunError.code`, when the failure supplied one |
75
75
  | `actions.requested` | `{ calls: [{ callId, toolName, args?, parentCallId? }], parentCallId? }`. One envelope per model step. `parentCallId` marks subagent work |
76
76
  | `actions.completed` | `{ results: [{ callId, toolName, output?, isError, stubbed?, parentCallId? }], parentCallId? }`. Emitted when every call in that batch has a result |
77
77
  | `action.result` | `{ callId, toolName, output?, isError, stubbed?, parentCallId? }`. Live per-call envelope. `stubbed` means a dry-run session answered a write without running it |
@@ -198,6 +198,18 @@ agent-sdk tool call inspect_pr --dir . \
198
198
  --input '{"prUrl":"https://github.com/acme/checkout/pull/42"}'
199
199
  ```
200
200
 
201
+ The built-in file tools run the same way: `Read`, `Write`, `StrReplace`,
202
+ `LS`, `Grep`, `Glob`, and `Delete`, on the agent's `fs` tree or on the
203
+ session workspace. Your `tools` allowlist applies, and the result is the
204
+ tool's own result, the same one a turn's tool-call event carries. A read
205
+ returns `{ "status": "success", "value": { "content": "…" } }`.
206
+
207
+ ```bash
208
+ curl -X POST http://127.0.0.1:3000/<slug>/v1/tools/Read \
209
+ -H 'content-type: application/json' \
210
+ -d '{"input":{"path":"README.md"},"sessionId":"<session>"}'
211
+ ```
212
+
201
213
  Programmatically, `callTool(toolName, input, options?)` is available on
202
214
  the serve handle, on channel route handlers and `onStart` args, and on
203
215
  schedule `run` handlers, so a channel can mix deterministic calls with
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@grok/agent-sdk",
3
- "version": "0.3.0",
3
+ "version": "0.5.0",
4
4
  "description": "Build, test, and deploy agents as code on Cursor's agent harness.",
5
5
  "license": "SEE LICENSE IN LICENSE.md",
6
6
  "repository": {
@@ -29,7 +29,6 @@
29
29
  "!dist/internal/tenant-mcp/**",
30
30
  "!dist/internal/tenant-slack/**",
31
31
  "!dist/internal/review-comments*",
32
- "!dist/filesystem-executors.*",
33
32
  "skills/**/*",
34
33
  "templates/**/*",
35
34
  "!templates/pr-autofixer/README.md",
@@ -51,13 +50,6 @@
51
50
  "import": "./dist/index.js",
52
51
  "default": "./dist/index.js"
53
52
  },
54
- "./executors": {
55
- "anysphere-source": "./src/filesystem-executors.ts",
56
- "bun": "./dist/executors.js",
57
- "types": "./dist/executors.d.ts",
58
- "import": "./dist/executors.js",
59
- "default": "./dist/executors.js"
60
- },
61
53
  "./internal/hosted": {
62
54
  "anysphere-source": "./src/internal/hosted/index.ts",
63
55
  "types": "./src/internal/hosted/index.ts",
@@ -122,6 +114,13 @@
122
114
  "import": "./dist/channels/runs/index.js",
123
115
  "default": "./dist/channels/runs/index.js"
124
116
  },
117
+ "./channels/match-ready": {
118
+ "anysphere-source": "./src/channels/match-ready/index.ts",
119
+ "bun": "./dist/channels/match-ready/index.js",
120
+ "types": "./dist/channels/match-ready/index.d.ts",
121
+ "import": "./dist/channels/match-ready/index.js",
122
+ "default": "./dist/channels/match-ready/index.js"
123
+ },
125
124
  "./channels/bitbucket": {
126
125
  "anysphere-source": "./src/channels/bitbucket/index.ts",
127
126
  "types": "./dist/channels/bitbucket/index.d.ts",
@@ -281,7 +280,7 @@
281
280
  },
282
281
  "dependencies": {
283
282
  "@bazel/runfiles": "6.5.0",
284
- "@cursor/sdk": "1.0.38",
283
+ "@cursor/sdk": "1.2.0",
285
284
  "@modelcontextprotocol/sdk": "^1.32.1",
286
285
  "@octokit/auth-app": "^7.2.0",
287
286
  "@octokit/rest": "^21.1.1",
@@ -319,11 +318,7 @@
319
318
  "zod": "^3.25.0 || ^4.0.0"
320
319
  },
321
320
  "devDependencies": {
322
- "@anysphere/agent-exec": "1.0.0",
323
321
  "@anysphere/agent-store-sync": "1.0.0",
324
- "@anysphere/context": "1.0.0",
325
- "@anysphere/cursor-sdk-shared": "1.0.0",
326
- "@anysphere/proto": "1.0.0",
327
322
  "@anysphere/ui": "1.0.0",
328
323
  "@braintree/sanitize-url": "7.1.2",
329
324
  "@microsoft/api-extractor": "7.59.4",
@@ -356,7 +351,7 @@
356
351
  "vitepress-plugin-mermaid": "^2.0.17",
357
352
  "vitest": "5.0.3",
358
353
  "yaml": "^2.4.2",
359
- "zod": "4.6.5",
354
+ "zod": "4.6.7",
360
355
  "zustand": "^5.0.9"
361
356
  },
362
357
  "scripts": {
@@ -1,5 +1,5 @@
1
1
  ---
2
- name: bdk-cli
2
+ name: agent-sdk-cli
3
3
  description: >-
4
4
  Guardrails for running the BDK CLI from an agent: --json output,
5
5
  exit codes, --fields and --limit, --dry-run before every change,
@@ -1,5 +1,5 @@
1
1
  ---
2
- name: bdk-create-agent
2
+ name: agent-sdk-create-agent
3
3
  description: >-
4
4
  Scaffold a new Agent SDK agent: short AskQuestion interview, then
5
5
  verify a turn and hand off to hillclimb. Use when creating a new
@@ -8,11 +8,14 @@ description: >-
8
8
 
9
9
  # Create an Agent SDK agent
10
10
 
11
- 1. **Interview.** Two `AskQuestion` rounds, then a plan gate.
12
- 2. **Scaffold.** `agent-sdk init`, then shape the files.
13
- 3. **Verify.** `validate` / `info` / `tool call`, then a model turn.
14
- 4. **Channels.** Slack, GitHub, webhook, or schedule as chosen.
15
- 5. **Hillclimb.** `skills/hillclimb/SKILL.md`.
11
+ 1. **Sign in.** `agent-sdk whoami`. Run `agent-sdk login` only
12
+ when it reports no credential.
13
+ 2. **Interview.** Two `AskQuestion` rounds, then a plan gate.
14
+ 3. **Scaffold.** `agent-sdk init`, then shape the files.
15
+ 4. **Verify.** `validate` / `info` / `tool call`, then a model turn.
16
+ 5. **Channels.** Slack, GitHub, webhook, or schedule as chosen.
17
+ 6. **Report.** What it does, how to test it, how to deploy it.
18
+ 7. **Hillclimb.** `skills/hillclimb/SKILL.md`.
16
19
 
17
20
  Read `skills/framework-map/SKILL.md` if you have not. CLI is
18
21
  `agent-sdk`. Public docs:
@@ -46,12 +49,16 @@ on a running host.
46
49
 
47
50
  | Question | Options | Guidance |
48
51
  | --- | --- | --- |
49
- | **Model** | `grok-4.5` + `effort=high`, `fast=true` · Other id | Params, not id suffixes: `{ id: "grok-4.5", params: [{ id: "effort", value: "high" }, { id: "fast", value: "true" }] }` |
52
+ | **Model** | `grok-4.7` + `reasoning_effort=high`, `fast=true` · Other id | Params, not id suffixes: `{ id: "grok-4.7", params: [{ id: "reasoning_effort", value: "high" }, { id: "fast", value: "true" }] }` |
50
53
  | **Channels** (multi) | playground + HTTP (always on) · Slack · GitHub · custom webhook · schedule | Slack: `skills/setup-slack/SKILL.md`. GitHub: `skills/github/SKILL.md`. No Discord/Teams pack; offer custom webhook. |
51
54
  | **MCP** (multi) | none · remote URL · local stdio · Cursor account connectors · Other | One file under `bot/mcp-connections/`. Account file is `account.ts`, never `cursor.ts`. Named local tools need `advertiseTools: true`. Privileged servers go in `bot/host-connections/`. |
52
55
  | **Capabilities** (multi) | server tools · agent tools · skills · subagents · hooks · sandbox seeds · evals (recommend) | Always recommend one smoke eval. |
53
56
  <!-- interview:end -->
54
57
 
58
+ Location: inside a git checkout, recommend a new folder outside
59
+ it. `init` runs `npm install`, which breaks a pnpm or yarn
60
+ workspace.
61
+
55
62
  Close with the plan and file tree, then "Scaffold it" / "Adjust
56
63
  something". Write files only after approval.
57
64
 
@@ -154,6 +161,18 @@ agent-sdk eval --dir ./<slug>
154
161
  Serve only this agent's directory. Session files land in the
155
162
  project state directory (`--state-root`). That is not harness cwd.
156
163
 
164
+ Finish gate. Before the report, these pass. Fix each error first:
165
+
166
+ ```bash
167
+ agent-sdk validate --dir ./<slug>
168
+ npx tsc --noEmit -p ./<slug>
169
+ agent-sdk run --dir ./<slug> --message "<realistic first message>"
170
+ ```
171
+
172
+ Show the reply word for word. Without a credential, `run` may fail
173
+ with only the API-key error. Then write the report anyway, and put
174
+ the hand-over commands above in "Test it locally".
175
+
157
176
  ## Channel setup
158
177
 
159
178
  - **Slack.** `skills/setup-slack/SKILL.md`
@@ -166,6 +185,41 @@ project state directory (`--state-root`). That is not harness cwd.
166
185
  - **Schedules.** Never auto-fire under `--dev`.
167
186
  `POST /v1/dev/schedules/<id>`.
168
187
 
188
+ ## Report
189
+
190
+ End with this report. Write it in ASD-STE100 Simplified Technical
191
+ English: short sentences, active voice, one instruction per step.
192
+ Fill in the real slug, env prefix, and commands.
193
+
194
+ ```markdown
195
+ ## What the agent does
196
+
197
+ - 3 to 5 short bullets.
198
+
199
+ ## Test it locally
200
+
201
+ Commands for `agent-sdk dev ./<slug>` (playground URL) and
202
+ `agent-sdk eval --dir ./<slug>`, and what the person sees.
203
+
204
+ ## Deploy it
205
+
206
+ 1. If the project is not in a git repository, create one and
207
+ add a remote.
208
+ 2. Commit the project and push it to a branch.
209
+ 3. Slack only: run `agent-sdk slack create --dir ./<slug> --env prod`.
210
+ 4. Run `agent-sdk validate --dir ./<slug>`, then
211
+ `agent-sdk deploy --dir ./<slug> --dry-run`.
212
+ 5. Run `agent-sdk deploy --dir ./<slug>` in your own terminal.
213
+ The first deploy prints an alias token one time. Save it in
214
+ a password manager.
215
+ 6. Run `agent-sdk session create --slug <slug> --message "<test>" --wait`.
216
+ 7. Manage the agent at https://cursor.com/dashboard/deployed-agents.
217
+ ```
218
+
219
+ Do not deploy, push, or create the prod Slack app unless the
220
+ person asks. Hand the first deploy to the person, so the alias
221
+ token stays out of your transcript.
222
+
169
223
  ## Hillclimb handoff
170
224
 
171
225
  Once a smoke turn passes, agree fixtures, success criteria, and a
@@ -1,5 +1,5 @@
1
1
  ---
2
- name: bdk-debug
2
+ name: agent-sdk-debug
3
3
  description: >-
4
4
  Diagnose a misbehaving local Agent SDK agent: blank playground,
5
5
  missing sessions, failed reads, webhook 401s, 403/409. Use when
@@ -1,5 +1,5 @@
1
1
  ---
2
- name: bdk-deploy
2
+ name: agent-sdk-deploy
3
3
  description: >-
4
4
  Deploy or redeploy an Agent SDK project to Cursor-managed hosting
5
5
  with an attached service account. Use when asked to deploy,
@@ -14,7 +14,7 @@ pushed Git ref to Cursor-managed hosting. Local files never upload.
14
14
  Use the package name and version embedded in the installed skill. Do not
15
15
  use a floating npm tag or a workspace build of the CLI.
16
16
 
17
- Follow the `bdk-cli` skill for `--json`, exit codes, `--fields`, and
17
+ Follow the `agent-sdk-cli` skill for `--json`, exit codes, `--fields`, and
18
18
  `--dry-run`.
19
19
 
20
20
  ## Gather the target
@@ -39,7 +39,7 @@ the value. Do not run `agent-sdk login`.
39
39
  On Linux and macOS, run every Agent SDK command through this wrapper:
40
40
 
41
41
  ```bash
42
- BDK_VERSION="0.3.0"
42
+ BDK_VERSION="0.5.0"
43
43
  BDK_PACKAGE="@grok/agent-sdk"
44
44
  case "$BDK_VERSION" in
45
45
  __BDK_V*)
@@ -1,5 +1,5 @@
1
1
  ---
2
- name: bdk-evals
2
+ name: agent-sdk-evals
3
3
  description: >-
4
4
  Author and run defineEval cases. Use when writing, fixing, seeding,
5
5
  or hillclimbing evals. Ask whether to generate samples or take
@@ -1,5 +1,5 @@
1
1
  ---
2
- name: bdk-framework-map
2
+ name: agent-sdk-framework-map
3
3
  description: >-
4
4
  Orient on Agent SDK layout, local runtime, sessions, and
5
5
  invariants (Node not Bun, root evals/, typecheck after tsx,
@@ -13,7 +13,7 @@ description: >-
13
13
  over HTTP, Slack, and GitHub. Markdown is prose. TypeScript is typed
14
14
  behavior. Ground truth: package `README.md` and `AGENTS.md`.
15
15
 
16
- CLI is `agent-sdk` (Node, never Bun). Follow the `bdk-cli` skill before you
16
+ CLI is `agent-sdk` (Node, never Bun). Follow the `agent-sdk-cli` skill before you
17
17
  run an `agent-sdk` command.
18
18
 
19
19
  Public docs: `node_modules/@grok/agent-sdk/dist/docs/llms.txt` or
@@ -1,5 +1,5 @@
1
1
  ---
2
- name: bdk-github
2
+ name: agent-sdk-github
3
3
  description: >-
4
4
  Build and test GitHub-driven Agent SDK agents: githubChannel hooks
5
5
  (auth turn vs host task), cursorAccount / --cursor-events, and
@@ -1,5 +1,5 @@
1
1
  ---
2
- name: bdk-hillclimb
2
+ name: agent-sdk-hillclimb
3
3
  description: >-
4
4
  Improve one existing Agent SDK agent: pin fixtures, measure, change
5
5
  one lever, remeasure, lock the win with an eval. Use when an agent
@@ -1,5 +1,5 @@
1
1
  ---
2
- name: bdk-mcp-auth
2
+ name: agent-sdk-mcp-auth
3
3
  description: >-
4
4
  Authorize host MCP OAuth for defineConnection({ url, oauth: true }):
5
5
  agent-sdk mcp oauth, local tokens, advertiseTools, egress, and the hosted
@@ -1,5 +1,5 @@
1
1
  ---
2
- name: bdk-migrate-v2
2
+ name: agent-sdk-migrate-v2
3
3
  description: >-
4
4
  Migrate an Agent SDK project from hosted architecture v1 to v2: upgrade the
5
5
  package, remove v1-only code, and redeploy. Applies only to projects
@@ -106,7 +106,7 @@ still loads.
106
106
  Commit the lockfile the install writes, since deploys build from Git.
107
107
  Rewrite every `@cursor/july` import to `@grok/agent-sdk`; subpaths such as
108
108
  `/channels/slack`, `/evals`, and `/reminders` keep their names. Replace
109
- the legacy CLI command with `bdk` in scripts, CI jobs, and READMEs.
109
+ the legacy CLI command with `agent-sdk` in scripts, CI jobs, and READMEs.
110
110
 
111
111
  The new types are stricter. `ctx.session.continuationKey` is
112
112
  `string | null`, so guard with `typeof key === "string"`, not
@@ -1,5 +1,5 @@
1
1
  ---
2
- name: bdk-otel
2
+ name: agent-sdk-otel
3
3
  description: >-
4
4
  Wire OpenTelemetry export with OTEL_* environment variables.
5
5
  Use when adding a collector, headers, or metrics temporality.
@@ -1,5 +1,5 @@
1
1
  ---
2
- name: bdk-setup-slack
2
+ name: agent-sdk-setup-slack
3
3
  description: >-
4
4
  Wire Slack to an Agent SDK agent. Mint a dedicated Socket Mode app
5
5
  with slack create, then doctor and smoke. Use slack init --manual
@@ -35,7 +35,7 @@ approve Slack, pick the bot name. CLI writes
35
35
  Prefix is the directory basename in upper snake (`jenny` →
36
36
  `JENNY`, `pr-approver` → `PR_APPROVER` → `PR_APPROVER_SLACK_*`).
37
37
  `--prefix` / `--no-prefix` override. Dev and prod are separate
38
- apps; `--prod` is the prod app. `--name` / `--icon` /
38
+ apps; `--env prod` is the prod app. `--name` / `--icon` /
39
39
  `--channel-posts` / `--slack-team` prefill the wizard.
40
40
 
41
41
  If Slack needs workspace-admin approval, keep the CLI running.
@@ -1 +0,0 @@
1
- import{_ as a,c as o,o as t,a3 as l}from"./chunks/framework.BNw1pucY.js";const _=JSON.parse('{"title":"Changelog","description":"Changelog for @grok/agent-sdk releases.","frontmatter":{"title":"Changelog","description":"Changelog for @grok/agent-sdk releases."},"headers":[],"relativePath":"changelog.md","filePath":"changelog.md"}'),n={name:"changelog.md"};function r(i,e,s,g,c,d){return t(),o("div",null,[...e[0]||(e[0]=[l('<h1 id="changelog" tabindex="-1">Changelog <a class="header-anchor" href="#changelog" aria-label="Permalink to &quot;Changelog&quot;">​</a></h1><h2 id="_0-3-0-2026-10-23" tabindex="-1">0.3.0 (2026-10-23) <a class="header-anchor" href="#_0-3-0-2026-10-23" aria-label="Permalink to &quot;0.3.0 (2026-10-23)&quot;">​</a></h2><ul><li>GA Release</li><li><code>persistent</code> option is removed from <code>defineAgent</code></li></ul><h2 id="_0-2-29-2026-10-23" tabindex="-1">0.2.29 (2026-10-23) <a class="header-anchor" href="#_0-2-29-2026-10-23" aria-label="Permalink to &quot;0.2.29 (2026-10-23)&quot;">​</a></h2><ul><li>Bug Fixes</li></ul>',5)])])}const u=a(n,[["render",r]]);export{_ as __pageData,u as default};
@@ -1 +0,0 @@
1
- import{_ as a,c as o,o as t,a3 as l}from"./chunks/framework.BNw1pucY.js";const _=JSON.parse('{"title":"Changelog","description":"Changelog for @grok/agent-sdk releases.","frontmatter":{"title":"Changelog","description":"Changelog for @grok/agent-sdk releases."},"headers":[],"relativePath":"changelog.md","filePath":"changelog.md"}'),n={name:"changelog.md"};function r(i,e,s,g,c,d){return t(),o("div",null,[...e[0]||(e[0]=[l("",5)])])}const u=a(n,[["render",r]]);export{_ as __pageData,u as default};