@grok/agent-sdk 0.3.0 → 0.4.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (227) hide show
  1. package/dist/channels/slack/slack-channel.d.ts.map +1 -1
  2. package/dist/channels/slack/slack-channel.js +27 -14
  3. package/dist/docs/404.html +2 -2
  4. package/dist/docs/assets/{app.BzTUBOAD.js → app.BSH__xV4.js} +4 -4
  5. package/dist/docs/assets/{building-with-agents.md.BqJ7AAjG.js → building-with-agents.md.Bo3ct-rf.js} +1 -1
  6. package/dist/docs/assets/changelog.md.b6H_ea44.js +1 -0
  7. package/dist/docs/assets/{changelog.md.BWhC6DET.lean.js → changelog.md.b6H_ea44.lean.js} +1 -1
  8. package/dist/docs/assets/chunks/@localSearchIndexroot.CiRGcfZg.js +1 -0
  9. package/dist/docs/assets/chunks/{VPLocalSearchBox.DsnRlUT5.js → VPLocalSearchBox.Cadl7A0k.js} +1 -1
  10. package/dist/docs/assets/chunks/{arc.DH8GOhiv.js → arc.K7t9nNY6.js} +1 -1
  11. package/dist/docs/assets/chunks/{architectureDiagram-Q4EWVU46.9m9ObyuE.js → architectureDiagram-Q4EWVU46.SlHEknkX.js} +1 -1
  12. package/dist/docs/assets/chunks/{baseUniq.BXHpx1lE.js → baseUniq.DJLRMLkz.js} +1 -1
  13. package/dist/docs/assets/chunks/{blockDiagram-DXYQGD6D.xY3EX59q.js → blockDiagram-DXYQGD6D.Bs6XxFpe.js} +1 -1
  14. package/dist/docs/assets/chunks/{c4Diagram-AHTNJAMY.DnqgMVgc.js → c4Diagram-AHTNJAMY.CyLg6Ovc.js} +1 -1
  15. package/dist/docs/assets/chunks/channel.CVTdqYx0.js +1 -0
  16. package/dist/docs/assets/chunks/{chunk-4BX2VUAB.BjFxK2A3.js → chunk-4BX2VUAB.DTQ4TinT.js} +1 -1
  17. package/dist/docs/assets/chunks/{chunk-4TB4RGXK.BujS_Spt.js → chunk-4TB4RGXK.Es84IgcH.js} +1 -1
  18. package/dist/docs/assets/chunks/{chunk-55IACEB6.YbTjhdaM.js → chunk-55IACEB6.Clm3cGPQ.js} +1 -1
  19. package/dist/docs/assets/chunks/{chunk-EDXVE4YY.DnQ8t4GC.js → chunk-EDXVE4YY.DE4CRkS5.js} +1 -1
  20. package/dist/docs/assets/chunks/{chunk-FMBD7UC4.B67AwAmj.js → chunk-FMBD7UC4.Bf8HCvqp.js} +1 -1
  21. package/dist/docs/assets/chunks/{chunk-OYMX7WX6.DrZIAFOm.js → chunk-OYMX7WX6.eub-7nSx.js} +1 -1
  22. package/dist/docs/assets/chunks/{chunk-QZHKN3VN.BLmmydkn.js → chunk-QZHKN3VN.WyP9VAS_.js} +1 -1
  23. package/dist/docs/assets/chunks/{chunk-YZCP3GAM.DaoOfw0O.js → chunk-YZCP3GAM.LO9ohhDE.js} +1 -1
  24. package/dist/docs/assets/chunks/classDiagram-6PBFFD2Q.CsJJyx6-.js +1 -0
  25. package/dist/docs/assets/chunks/classDiagram-v2-HSJHXN6E.CsJJyx6-.js +1 -0
  26. package/dist/docs/assets/chunks/clone.Dk8KvtOB.js +1 -0
  27. package/dist/docs/assets/chunks/{cose-bilkent-S5V4N54A.DMQuNhM5.js → cose-bilkent-S5V4N54A.D5za6aH0.js} +1 -1
  28. package/dist/docs/assets/chunks/{dagre-KV5264BT.CZoGVuUf.js → dagre-KV5264BT.Dq1daUru.js} +1 -1
  29. package/dist/docs/assets/chunks/{diagram-5BDNPKRD.CLt9uOyL.js → diagram-5BDNPKRD.j1YL5BKS.js} +1 -1
  30. package/dist/docs/assets/chunks/{diagram-G4DWMVQ6.DpczEm1G.js → diagram-G4DWMVQ6.Bi1aLdhC.js} +1 -1
  31. package/dist/docs/assets/chunks/{diagram-MMDJMWI5.D4r13DvJ.js → diagram-MMDJMWI5.BOzMEkAr.js} +1 -1
  32. package/dist/docs/assets/chunks/{diagram-TYMM5635.CYU9eGFu.js → diagram-TYMM5635.Dx2FVhCr.js} +1 -1
  33. package/dist/docs/assets/chunks/{erDiagram-SMLLAGMA.QA9naWEw.js → erDiagram-SMLLAGMA.DI4TNkye.js} +1 -1
  34. package/dist/docs/assets/chunks/{flowDiagram-DWJPFMVM.BbNoVZYd.js → flowDiagram-DWJPFMVM.C58Z9uPK.js} +1 -1
  35. package/dist/docs/assets/chunks/{ganttDiagram-T4ZO3ILL.IHjDoG7r.js → ganttDiagram-T4ZO3ILL.DXSpW809.js} +1 -1
  36. package/dist/docs/assets/chunks/{gitGraphDiagram-UUTBAWPF.B21VMdf5.js → gitGraphDiagram-UUTBAWPF.B955oaFl.js} +1 -1
  37. package/dist/docs/assets/chunks/{graph.DgJ4L-8V.js → graph.BQXhKtxS.js} +1 -1
  38. package/dist/docs/assets/chunks/{infoDiagram-42DDH7IO.CQjrcthc.js → infoDiagram-42DDH7IO.Dozj_-Gm.js} +1 -1
  39. package/dist/docs/assets/chunks/{ishikawaDiagram-UXIWVN3A.D4tPGtVo.js → ishikawaDiagram-UXIWVN3A.D2140OzH.js} +1 -1
  40. package/dist/docs/assets/chunks/{journeyDiagram-VCZTEJTY.BD3WaNbQ.js → journeyDiagram-VCZTEJTY.DrqrMhCk.js} +1 -1
  41. package/dist/docs/assets/chunks/{kanban-definition-6JOO6SKY.Ca0o4Tqz.js → kanban-definition-6JOO6SKY.Dv-LTrlw.js} +1 -1
  42. package/dist/docs/assets/chunks/{layout.DXXqX4MQ.js → layout.CGtHp49X.js} +1 -1
  43. package/dist/docs/assets/chunks/{linear.5c61gNw4.js → linear.CHZLYB52.js} +1 -1
  44. package/dist/docs/assets/chunks/{min.B1-NAjHX.js → min.D4Vt3eIy.js} +1 -1
  45. package/dist/docs/assets/chunks/{mindmap-definition-QFDTVHPH.BELznv3-.js → mindmap-definition-QFDTVHPH.BBfpYTea.js} +1 -1
  46. package/dist/docs/assets/chunks/{pieDiagram-DEJITSTG.qPzO1mq5.js → pieDiagram-DEJITSTG.BVYvElmY.js} +1 -1
  47. package/dist/docs/assets/chunks/{quadrantDiagram-34T5L4WZ.CxIvzbjX.js → quadrantDiagram-34T5L4WZ.C6Gc2mdY.js} +1 -1
  48. package/dist/docs/assets/chunks/{requirementDiagram-MS252O5E.CqA0iJx8.js → requirementDiagram-MS252O5E.DWa8b4cn.js} +1 -1
  49. package/dist/docs/assets/chunks/{sankeyDiagram-XADWPNL6.XRTutBnb.js → sankeyDiagram-XADWPNL6.Bi-g4ajv.js} +1 -1
  50. package/dist/docs/assets/chunks/{sequenceDiagram-FGHM5R23.E--7bRLQ.js → sequenceDiagram-FGHM5R23.DlU3vVN9.js} +1 -1
  51. package/dist/docs/assets/chunks/{stateDiagram-FHFEXIEX.C4vGu8zq.js → stateDiagram-FHFEXIEX.CeqJRqnU.js} +1 -1
  52. package/dist/docs/assets/chunks/stateDiagram-v2-QKLJ7IA2.DE0BnUZh.js +1 -0
  53. package/dist/docs/assets/chunks/{theme.DMj_7q3B.js → theme.DGq7D4tt.js} +2 -2
  54. package/dist/docs/assets/chunks/{timeline-definition-GMOUNBTQ.C7LgNVAL.js → timeline-definition-GMOUNBTQ.Cqf2kjq9.js} +1 -1
  55. package/dist/docs/assets/chunks/{vennDiagram-DHZGUBPP.HUwoZcy_.js → vennDiagram-DHZGUBPP.BeOpE_lM.js} +1 -1
  56. package/dist/docs/assets/chunks/{wardley-RL74JXVD.BxFEFYZS.js → wardley-RL74JXVD.FMQXA-6q.js} +1 -1
  57. package/dist/docs/assets/chunks/{wardleyDiagram-NUSXRM2D.B2pSo5rB.js → wardleyDiagram-NUSXRM2D.BXS65dAC.js} +1 -1
  58. package/dist/docs/assets/chunks/{xychartDiagram-5P7HB3ND.NQhMiOOL.js → xychartDiagram-5P7HB3ND.haEiSxqc.js} +1 -1
  59. package/dist/docs/assets/{deployment.md.BtqJrHhp.js → deployment.md.DJtuDVLh.js} +3 -3
  60. package/dist/docs/assets/{deployment.md.BtqJrHhp.lean.js → deployment.md.DJtuDVLh.lean.js} +1 -1
  61. package/dist/docs/assets/{guides_agent-to-agent.md.BcmSqL2z.js → guides_agent-to-agent.md.DcB3nhOz.js} +1 -1
  62. package/dist/docs/assets/{guides_github.md.6jiEH7dg.js → guides_github.md.CcuZ7keS.js} +1 -1
  63. package/dist/docs/assets/{guides_mcp-oauth.md.C-Sx_IPa.js → guides_mcp-oauth.md.GVPMKcYl.js} +1 -1
  64. package/dist/docs/assets/{guides_migrate.md.BbhHYeCr.js → guides_migrate.md.B8CZxnnX.js} +1 -1
  65. package/dist/docs/assets/{guides_slack.md.BgIGG9ur.js → guides_slack.md.D7Rwyva4.js} +1 -1
  66. package/dist/docs/assets/{hillclimbing.md.3TkdF79A.js → hillclimbing.md.M51bF-oT.js} +1 -1
  67. package/dist/docs/assets/index.md.DnJPj_B6.js +14 -0
  68. package/dist/docs/assets/index.md.DnJPj_B6.lean.js +1 -0
  69. package/dist/docs/assets/{reference_agent-config.md.C0Tp_Fk9.js → reference_agent-config.md.BSNp2uJ7.js} +3 -3
  70. package/dist/docs/assets/{reference_cli.md.B8GdpaRj.js → reference_cli.md.DHm6DmYk.js} +2 -2
  71. package/dist/docs/assets/{reference_hooks.md.CSWmOwMM.js → reference_hooks.md.vbIM394-.js} +2 -2
  72. package/dist/docs/assets/{reference_hooks.md.CSWmOwMM.lean.js → reference_hooks.md.vbIM394-.lean.js} +1 -1
  73. package/dist/docs/assets/{reference_schedules.md.RhQ9ZLo1.js → reference_schedules.md.Dd8_d0WG.js} +3 -3
  74. package/dist/docs/building-with-agents.html +36 -36
  75. package/dist/docs/building-with-agents.md +3 -3
  76. package/dist/docs/changelog.html +36 -36
  77. package/dist/docs/changelog.md +20 -1
  78. package/dist/docs/deployment.html +37 -37
  79. package/dist/docs/deployment.md +22 -16
  80. package/dist/docs/evals.html +35 -35
  81. package/dist/docs/guides/agent-to-agent.html +37 -37
  82. package/dist/docs/guides/agent-to-agent.md +4 -2
  83. package/dist/docs/guides/bitbucket.html +35 -35
  84. package/dist/docs/guides/cloud-agents.html +35 -35
  85. package/dist/docs/guides/convert-automation.html +35 -35
  86. package/dist/docs/guides/github.html +37 -37
  87. package/dist/docs/guides/github.md +1 -1
  88. package/dist/docs/guides/gitlab.html +35 -35
  89. package/dist/docs/guides/improve.html +35 -35
  90. package/dist/docs/guides/jev.html +35 -35
  91. package/dist/docs/guides/mcp-oauth.html +37 -37
  92. package/dist/docs/guides/mcp-oauth.md +1 -1
  93. package/dist/docs/guides/migrate.html +37 -37
  94. package/dist/docs/guides/migrate.md +1 -1
  95. package/dist/docs/guides/opentelemetry.html +35 -35
  96. package/dist/docs/guides/pagerduty.html +35 -35
  97. package/dist/docs/guides/slack.html +37 -37
  98. package/dist/docs/guides/slack.md +1 -1
  99. package/dist/docs/guides/webhooks.html +35 -35
  100. package/dist/docs/hashmap.json +1 -1
  101. package/dist/docs/hillclimbing.html +36 -36
  102. package/dist/docs/hillclimbing.md +1 -1
  103. package/dist/docs/index.html +42 -48
  104. package/dist/docs/index.md +8 -14
  105. package/dist/docs/llms-full.txt +70 -50
  106. package/dist/docs/quickstart.html +35 -35
  107. package/dist/docs/reference/access.html +35 -35
  108. package/dist/docs/reference/agent-config.html +39 -39
  109. package/dist/docs/reference/agent-config.md +5 -6
  110. package/dist/docs/reference/artifacts.html +35 -35
  111. package/dist/docs/reference/channels.html +35 -35
  112. package/dist/docs/reference/cli.html +38 -38
  113. package/dist/docs/reference/cli.md +2 -2
  114. package/dist/docs/reference/connections.html +35 -35
  115. package/dist/docs/reference/evals.html +35 -35
  116. package/dist/docs/reference/extensions.html +35 -35
  117. package/dist/docs/reference/hooks.html +37 -37
  118. package/dist/docs/reference/hooks.md +1 -1
  119. package/dist/docs/reference/http-api.html +35 -35
  120. package/dist/docs/reference/instructions.html +35 -35
  121. package/dist/docs/reference/limits.html +35 -35
  122. package/dist/docs/reference/memory.html +35 -35
  123. package/dist/docs/reference/playground.html +35 -35
  124. package/dist/docs/reference/project-layout.html +35 -35
  125. package/dist/docs/reference/schedules.html +38 -38
  126. package/dist/docs/reference/sessions.html +35 -35
  127. package/dist/docs/reference/skills.html +35 -35
  128. package/dist/docs/reference/subagents.html +35 -35
  129. package/dist/docs/reference/tools.html +35 -35
  130. package/dist/docs/templates/agentic-owners.html +35 -35
  131. package/dist/docs/templates/reviews.html +35 -35
  132. package/dist/docs/troubleshooting.html +35 -35
  133. package/dist/filesystem.d.ts +7 -320
  134. package/dist/filesystem.d.ts.map +1 -1
  135. package/dist/filesystem.js +10 -691
  136. package/dist/index.d.ts +1 -1
  137. package/dist/index.d.ts.map +1 -1
  138. package/dist/index.js +1 -1
  139. package/dist/internal/authored-alias-hooks.d.ts +6 -0
  140. package/dist/internal/authored-alias-hooks.d.ts.map +1 -1
  141. package/dist/internal/authored-alias-hooks.js +12 -0
  142. package/dist/internal/authored-loaders.js +10 -1
  143. package/dist/internal/cli/commands/scaffold.js +1 -1
  144. package/dist/internal/continuation-session-ids.d.ts +15 -0
  145. package/dist/internal/continuation-session-ids.d.ts.map +1 -0
  146. package/dist/internal/continuation-session-ids.js +43 -0
  147. package/dist/internal/filesystem/walk.d.ts +1 -5
  148. package/dist/internal/filesystem/walk.d.ts.map +1 -1
  149. package/dist/internal/filesystem/walk.js +1 -9
  150. package/dist/internal/hosted-catch-protocol.d.ts +3 -3
  151. package/dist/internal/hosted-catch-protocol.js +3 -3
  152. package/dist/internal/hosted-fetch.d.ts +7 -0
  153. package/dist/internal/hosted-fetch.d.ts.map +1 -0
  154. package/dist/internal/hosted-fetch.js +26 -0
  155. package/dist/internal/install-cursor-skills.d.ts +5 -6
  156. package/dist/internal/install-cursor-skills.d.ts.map +1 -1
  157. package/dist/internal/install-cursor-skills.js +19 -4
  158. package/dist/internal/mcp-endpoint.js +4 -4
  159. package/dist/internal/model-config.d.ts.map +1 -1
  160. package/dist/internal/model-config.js +11 -4
  161. package/dist/internal/platform-timers.d.ts +3 -7
  162. package/dist/internal/platform-timers.d.ts.map +1 -1
  163. package/dist/internal/platform-timers.js +10 -51
  164. package/dist/internal/server.d.ts.map +1 -1
  165. package/dist/internal/server.js +6 -1
  166. package/dist/internal/session-engine.d.ts +3 -0
  167. package/dist/internal/session-engine.d.ts.map +1 -1
  168. package/dist/internal/session-engine.js +12 -3
  169. package/dist/playground/assets/index-Bno25Cg0.css +1 -0
  170. package/dist/playground/assets/index-SGKsaznh.js +62 -0
  171. package/dist/playground/index.html +2 -2
  172. package/dist/types.d.ts +2 -0
  173. package/dist/types.d.ts.map +1 -1
  174. package/dist/types.js +2 -2
  175. package/docs/README.md +8 -14
  176. package/docs/building-with-agents.md +3 -3
  177. package/docs/changelog.md +20 -1
  178. package/docs/deployment.md +22 -16
  179. package/docs/guides/agent-to-agent.md +4 -2
  180. package/docs/guides/github.md +1 -1
  181. package/docs/guides/mcp-oauth.md +1 -1
  182. package/docs/guides/migrate.md +1 -1
  183. package/docs/guides/slack.md +1 -1
  184. package/docs/hillclimbing.md +1 -1
  185. package/docs/reference/agent-config.md +5 -6
  186. package/docs/reference/cli.md +2 -2
  187. package/docs/reference/hooks.md +1 -1
  188. package/package.json +3 -3
  189. package/skills/cli/SKILL.md +1 -1
  190. package/skills/create-agent/SKILL.md +61 -7
  191. package/skills/debug/SKILL.md +1 -1
  192. package/skills/deploy/SKILL.md +3 -3
  193. package/skills/evals/SKILL.md +1 -1
  194. package/skills/framework-map/SKILL.md +2 -2
  195. package/skills/github/SKILL.md +1 -1
  196. package/skills/hillclimb/SKILL.md +1 -1
  197. package/skills/mcp-auth/SKILL.md +1 -1
  198. package/skills/migrate-v2/SKILL.md +2 -2
  199. package/skills/otel/SKILL.md +1 -1
  200. package/skills/setup-slack/SKILL.md +2 -2
  201. package/dist/docs/assets/changelog.md.BWhC6DET.js +0 -1
  202. package/dist/docs/assets/chunks/@localSearchIndexroot.CWxwVoCG.js +0 -1
  203. package/dist/docs/assets/chunks/channel.Cctv0f7X.js +0 -1
  204. package/dist/docs/assets/chunks/classDiagram-6PBFFD2Q.DU5sqchW.js +0 -1
  205. package/dist/docs/assets/chunks/classDiagram-v2-HSJHXN6E.DU5sqchW.js +0 -1
  206. package/dist/docs/assets/chunks/clone.B9rdNt6j.js +0 -1
  207. package/dist/docs/assets/chunks/stateDiagram-v2-QKLJ7IA2.ECMu2BdJ.js +0 -1
  208. package/dist/docs/assets/index.md.DRfaoRCZ.js +0 -20
  209. package/dist/docs/assets/index.md.DRfaoRCZ.lean.js +0 -1
  210. package/dist/internal/filesystem/errors.d.ts +0 -64
  211. package/dist/internal/filesystem/errors.d.ts.map +0 -1
  212. package/dist/internal/filesystem/errors.js +0 -180
  213. package/dist/internal/filesystem/merge.d.ts +0 -34
  214. package/dist/internal/filesystem/merge.d.ts.map +0 -1
  215. package/dist/internal/filesystem/merge.js +0 -154
  216. package/dist/playground/assets/index-D6mVn9og.js +0 -62
  217. package/dist/playground/assets/index-DlALM6gr.css +0 -1
  218. /package/dist/docs/assets/{building-with-agents.md.BqJ7AAjG.lean.js → building-with-agents.md.Bo3ct-rf.lean.js} +0 -0
  219. /package/dist/docs/assets/{guides_agent-to-agent.md.BcmSqL2z.lean.js → guides_agent-to-agent.md.DcB3nhOz.lean.js} +0 -0
  220. /package/dist/docs/assets/{guides_github.md.6jiEH7dg.lean.js → guides_github.md.CcuZ7keS.lean.js} +0 -0
  221. /package/dist/docs/assets/{guides_mcp-oauth.md.C-Sx_IPa.lean.js → guides_mcp-oauth.md.GVPMKcYl.lean.js} +0 -0
  222. /package/dist/docs/assets/{guides_migrate.md.BbhHYeCr.lean.js → guides_migrate.md.B8CZxnnX.lean.js} +0 -0
  223. /package/dist/docs/assets/{guides_slack.md.BgIGG9ur.lean.js → guides_slack.md.D7Rwyva4.lean.js} +0 -0
  224. /package/dist/docs/assets/{hillclimbing.md.3TkdF79A.lean.js → hillclimbing.md.M51bF-oT.lean.js} +0 -0
  225. /package/dist/docs/assets/{reference_agent-config.md.C0Tp_Fk9.lean.js → reference_agent-config.md.BSNp2uJ7.lean.js} +0 -0
  226. /package/dist/docs/assets/{reference_cli.md.B8GdpaRj.lean.js → reference_cli.md.DHm6DmYk.lean.js} +0 -0
  227. /package/dist/docs/assets/{reference_schedules.md.RhQ9ZLo1.lean.js → reference_schedules.md.Dd8_d0WG.lean.js} +0 -0
@@ -1,4 +1,4 @@
1
- import{_ as i,c as e,o as t,a3 as s}from"./chunks/framework.BNw1pucY.js";const c=JSON.parse('{"title":"Build with a coding agent","description":"Delegate Agent SDK creation, capability work, verification, and measured improvement to a coding agent.","frontmatter":{"title":"Build with a coding agent","description":"Delegate Agent SDK creation, capability work, verification, and measured improvement to a coding agent."},"headers":[],"relativePath":"building-with-agents.md","filePath":"building-with-agents.md"}'),n={name:"building-with-agents.md"};function l(h,a,o,r,p,d){return t(),e("div",null,[...a[0]||(a[0]=[s(`<h1 id="build-with-a-coding-agent" tabindex="-1">Build with a coding agent <a class="header-anchor" href="#build-with-a-coding-agent" aria-label="Permalink to &quot;Build with a coding agent&quot;">​</a></h1><p>A coding agent in your checkout can create an Agent SDK project, call its tools, run a real turn, and check the result from the CLI. You approve the plan and any side effects.</p><p>To let a running agent change its own source, see the <a href="./guides/improve.html">self-improvement extension</a>.</p><h2 id="create-an-agent-from-a-goal" tabindex="-1">Create an agent from a goal <a class="header-anchor" href="#create-an-agent-from-a-goal" aria-label="Permalink to &quot;Create an agent from a goal&quot;">​</a></h2><p>Tell the coding agent what the agent is for and where people reach it, and ask it to follow the <code>bdk-create-agent</code> skill. It asks for any decisions you haven&#39;t made, shows a file plan, and scaffolds a small first version with a smoke eval.</p><h2 id="add-one-capability" tabindex="-1">Add one capability <a class="header-anchor" href="#add-one-capability" aria-label="Permalink to &quot;Add one capability&quot;">​</a></h2><p>For an existing project, name the outcome and point the coding agent at the matching skill, such as <code>bdk-setup-slack</code>, <code>bdk-mcp-auth</code>, or <code>bdk-github</code>. For example:</p><blockquote><p>Add Slack mentions and DMs to this agent. Follow the bdk-setup-slack skill, keep replies in the source thread, and verify one local mention.</p></blockquote><blockquote><p>Connect the private inventory MCP server with host OAuth. Keep its write tools behind a narrow server-tool wrapper.</p></blockquote><blockquote><p>Add a GitHub ready-for-review trigger and replay PR 42 before posting anything live.</p></blockquote><h2 id="verify-tools-before-tuning-the-prompt" tabindex="-1">Verify tools before tuning the prompt <a class="header-anchor" href="#verify-tools-before-tuning-the-prompt" aria-label="Permalink to &quot;Verify tools before tuning the prompt&quot;">​</a></h2><p>Have the coding agent call tools directly and fix any that return the wrong evidence before it touches the instructions. Then it runs one real turn, reads the trace that <code>run</code> prints, and runs the smoke evals:</p><div class="language-bash vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">bash</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">agent-sdk</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> validate</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;"> --dir</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> .</span></span>
1
+ import{_ as i,c as e,o as t,a3 as s}from"./chunks/framework.BNw1pucY.js";const c=JSON.parse('{"title":"Build with a coding agent","description":"Delegate Agent SDK creation, capability work, verification, and measured improvement to a coding agent.","frontmatter":{"title":"Build with a coding agent","description":"Delegate Agent SDK creation, capability work, verification, and measured improvement to a coding agent."},"headers":[],"relativePath":"building-with-agents.md","filePath":"building-with-agents.md"}'),n={name:"building-with-agents.md"};function l(h,a,o,r,p,d){return t(),e("div",null,[...a[0]||(a[0]=[s(`<h1 id="build-with-a-coding-agent" tabindex="-1">Build with a coding agent <a class="header-anchor" href="#build-with-a-coding-agent" aria-label="Permalink to &quot;Build with a coding agent&quot;">​</a></h1><p>A coding agent in your checkout can create an Agent SDK project, call its tools, run a real turn, and check the result from the CLI. You approve the plan and any side effects.</p><p>To let a running agent change its own source, see the <a href="./guides/improve.html">self-improvement extension</a>.</p><h2 id="create-an-agent-from-a-goal" tabindex="-1">Create an agent from a goal <a class="header-anchor" href="#create-an-agent-from-a-goal" aria-label="Permalink to &quot;Create an agent from a goal&quot;">​</a></h2><p>Tell the coding agent what the agent is for and where people reach it, and ask it to follow the <code>agent-sdk-create-agent</code> skill. It asks for any decisions you haven&#39;t made, shows a file plan, and scaffolds a small first version with a smoke eval.</p><h2 id="add-one-capability" tabindex="-1">Add one capability <a class="header-anchor" href="#add-one-capability" aria-label="Permalink to &quot;Add one capability&quot;">​</a></h2><p>For an existing project, name the outcome and point the coding agent at the matching skill, such as <code>agent-sdk-setup-slack</code>, <code>agent-sdk-mcp-auth</code>, or <code>agent-sdk-github</code>. For example:</p><blockquote><p>Add Slack mentions and DMs to this agent. Follow the agent-sdk-setup-slack skill, keep replies in the source thread, and verify one local mention.</p></blockquote><blockquote><p>Connect the private inventory MCP server with host OAuth. Keep its write tools behind a narrow server-tool wrapper.</p></blockquote><blockquote><p>Add a GitHub ready-for-review trigger and replay PR 42 before posting anything live.</p></blockquote><h2 id="verify-tools-before-tuning-the-prompt" tabindex="-1">Verify tools before tuning the prompt <a class="header-anchor" href="#verify-tools-before-tuning-the-prompt" aria-label="Permalink to &quot;Verify tools before tuning the prompt&quot;">​</a></h2><p>Have the coding agent call tools directly and fix any that return the wrong evidence before it touches the instructions. Then it runs one real turn, reads the trace that <code>run</code> prints, and runs the smoke evals:</p><div class="language-bash vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">bash</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">agent-sdk</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> validate</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;"> --dir</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> .</span></span>
2
2
  <span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">agent-sdk</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> info</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;"> --dir</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> .</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;"> --json</span></span>
3
3
  <span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">agent-sdk</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> tool</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> call</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> inspect_pr</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;"> --dir</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> .</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;"> --input</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> &#39;{&quot;prUrl&quot;:&quot;https://github.com/acme/checkout/pull/42&quot;}&#39;</span></span>
4
4
  <span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">agent-sdk</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> run</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;"> --dir</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> .</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;"> --message</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> &quot;Is https://github.com/acme/checkout/pull/42 ready to approve?&quot;</span></span>
@@ -0,0 +1 @@
1
+ import{_ as a,c as o,o as t,a3 as l}from"./chunks/framework.BNw1pucY.js";const u=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 i(s,e,r,h,d,c){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-4-0-2026-10-27" tabindex="-1">0.4.0 (2026-10-27) <a class="header-anchor" href="#_0-4-0-2026-10-27" aria-label="Permalink to &quot;0.4.0 (2026-10-27)&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>The <code>FileSystem</code> type, its helpers, and its errors match the file tools, and the package root exports <code>readOnlyFs</code>.</li><li>Skill ids change from <code>bdk-&lt;name&gt;</code> to <code>agent-sdk-&lt;name&gt;</code> with no alias, and install removes the old folders.</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>An agent with no model uses <code>grok-4.7</code> with high effort and fast speed, and an agent that names a model keeps that model.</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 reply in a Slack thread that a schedule started continues that session.</li><li>A hosted Slack agent with <code>botMentions.allowFrom</code> starts a session when an allowed bot mentions it.</li><li>A <code>check</code> on a peer that is still running returns <code>running</code>, an error, or the reply before the request ends.</li><li>A hosted deploy that uses presigned file URLs passes its health check.</li><li>The dashboard on grok.com embeds the hosted playground.</li></ul><h2 id="_0-3-0-2026-10-25" tabindex="-1">0.3.0 (2026-10-25) <a class="header-anchor" href="#_0-3-0-2026-10-25" aria-label="Permalink to &quot;0.3.0 (2026-10-25)&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>',12)])])}const m=a(n,[["render",i]]);export{u as __pageData,m as default};
@@ -1 +1 @@
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};
1
+ import{_ as a,c as o,o as t,a3 as l}from"./chunks/framework.BNw1pucY.js";const u=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 i(s,e,r,h,d,c){return t(),o("div",null,[...e[0]||(e[0]=[l("",12)])])}const m=a(n,[["render",i]]);export{u as __pageData,m as default};