@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,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.4.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};