@grok/agent-sdk 0.2.28 → 0.2.29
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/AGENTS.md +29 -29
- package/dist/bin/agent-serve.d.ts +2 -2
- package/dist/bin/agent-serve.js +3 -3
- package/dist/channels/pagerduty/api.js +1 -1
- package/dist/channels/pagerduty/pagerduty-channel.d.ts +1 -1
- package/dist/channels/pagerduty/pagerduty-channel.d.ts.map +1 -1
- package/dist/channels/pagerduty/pagerduty-channel.js +1 -1
- package/dist/channels/pagerduty/replay.d.ts +1 -1
- package/dist/channels/pagerduty/replay.js +4 -4
- package/dist/docs/404.html +2 -2
- package/dist/docs/assets/{app.DF9vlcdn.js → app.DMrZKFjI.js} +4 -4
- package/dist/docs/assets/changelog.md.DrLFQUlu.js +1 -0
- package/dist/docs/assets/changelog.md.DrLFQUlu.lean.js +1 -0
- package/dist/docs/assets/chunks/@localSearchIndexroot.Dpd_wxVU.js +1 -0
- package/dist/docs/assets/chunks/{VPLocalSearchBox.D8OuwKO0.js → VPLocalSearchBox.DQvuw1KA.js} +1 -1
- package/dist/docs/assets/chunks/{arc.DCq_TCYV.js → arc.ahOG-Qza.js} +1 -1
- package/dist/docs/assets/chunks/{architectureDiagram-Q4EWVU46.PWRNTPbk.js → architectureDiagram-Q4EWVU46.BcgfYNO_.js} +1 -1
- package/dist/docs/assets/chunks/{baseUniq.BeRPvRUL.js → baseUniq.DeIYZrWh.js} +1 -1
- package/dist/docs/assets/chunks/{blockDiagram-DXYQGD6D.BuRmZVSo.js → blockDiagram-DXYQGD6D.HjJ2goMX.js} +1 -1
- package/dist/docs/assets/chunks/{c4Diagram-AHTNJAMY.7DKSMwuv.js → c4Diagram-AHTNJAMY.C1QTb9GM.js} +1 -1
- package/dist/docs/assets/chunks/channel._fZX_hvU.js +1 -0
- package/dist/docs/assets/chunks/{chunk-4BX2VUAB.7VrO9-9i.js → chunk-4BX2VUAB.UuZiDiVp.js} +1 -1
- package/dist/docs/assets/chunks/{chunk-4TB4RGXK.CHystNE2.js → chunk-4TB4RGXK.5A3YmkhI.js} +1 -1
- package/dist/docs/assets/chunks/{chunk-55IACEB6.Nuh9TbTq.js → chunk-55IACEB6.B4uf1yYV.js} +1 -1
- package/dist/docs/assets/chunks/{chunk-EDXVE4YY.CA0EKugm.js → chunk-EDXVE4YY.CoXBce8t.js} +1 -1
- package/dist/docs/assets/chunks/{chunk-FMBD7UC4.F9_mp7U8.js → chunk-FMBD7UC4.DnC5NO4e.js} +1 -1
- package/dist/docs/assets/chunks/{chunk-OYMX7WX6.CEU4QfE1.js → chunk-OYMX7WX6.CzfHCeIi.js} +1 -1
- package/dist/docs/assets/chunks/{chunk-QZHKN3VN.B8h_x9_i.js → chunk-QZHKN3VN.C6tcwkVd.js} +1 -1
- package/dist/docs/assets/chunks/{chunk-YZCP3GAM.Btfb-rKg.js → chunk-YZCP3GAM._oboyZ1A.js} +1 -1
- package/dist/docs/assets/chunks/classDiagram-6PBFFD2Q.eClS1Q0E.js +1 -0
- package/dist/docs/assets/chunks/classDiagram-v2-HSJHXN6E.eClS1Q0E.js +1 -0
- package/dist/docs/assets/chunks/clone.W1Phdw9P.js +1 -0
- package/dist/docs/assets/chunks/{cose-bilkent-S5V4N54A.DKvc96Wa.js → cose-bilkent-S5V4N54A.BfPVKeId.js} +1 -1
- package/dist/docs/assets/chunks/{dagre-KV5264BT.CMo0cy1b.js → dagre-KV5264BT.CLMLc0lD.js} +1 -1
- package/dist/docs/assets/chunks/{diagram-5BDNPKRD.DDgMOQhB.js → diagram-5BDNPKRD.C7OF7UfH.js} +1 -1
- package/dist/docs/assets/chunks/{diagram-G4DWMVQ6.BdJnoIsU.js → diagram-G4DWMVQ6.Dpao0Bl1.js} +1 -1
- package/dist/docs/assets/chunks/{diagram-MMDJMWI5.oSvhAZaL.js → diagram-MMDJMWI5.DLnM9eLp.js} +1 -1
- package/dist/docs/assets/chunks/{diagram-TYMM5635.C9zZLIE-.js → diagram-TYMM5635.BcpVgA_M.js} +1 -1
- package/dist/docs/assets/chunks/{erDiagram-SMLLAGMA.BNhVyccy.js → erDiagram-SMLLAGMA.CsL5JuCV.js} +1 -1
- package/dist/docs/assets/chunks/{flowDiagram-DWJPFMVM.BEFLLBiU.js → flowDiagram-DWJPFMVM.MFihq9AF.js} +1 -1
- package/dist/docs/assets/chunks/{ganttDiagram-T4ZO3ILL.BdUzXBgY.js → ganttDiagram-T4ZO3ILL.CJeLodyG.js} +1 -1
- package/dist/docs/assets/chunks/{gitGraphDiagram-UUTBAWPF.Rd3LlOIJ.js → gitGraphDiagram-UUTBAWPF.1HhlE45Z.js} +1 -1
- package/dist/docs/assets/chunks/{graph.DnJC1GpG.js → graph.BS02KkWA.js} +1 -1
- package/dist/docs/assets/chunks/{infoDiagram-42DDH7IO.xv0xntDJ.js → infoDiagram-42DDH7IO.fp5gvytQ.js} +1 -1
- package/dist/docs/assets/chunks/{ishikawaDiagram-UXIWVN3A.BaGIlviU.js → ishikawaDiagram-UXIWVN3A.C6Wk1V4I.js} +1 -1
- package/dist/docs/assets/chunks/{journeyDiagram-VCZTEJTY.Cof_h0fp.js → journeyDiagram-VCZTEJTY.qJt4uJ_H.js} +1 -1
- package/dist/docs/assets/chunks/{kanban-definition-6JOO6SKY.C5GozFuU.js → kanban-definition-6JOO6SKY.z2tG9kly.js} +1 -1
- package/dist/docs/assets/chunks/{layout.zc9UShLc.js → layout.BPCkdejr.js} +1 -1
- package/dist/docs/assets/chunks/{linear.BoqrFVcJ.js → linear.CL3TC3u7.js} +1 -1
- package/dist/docs/assets/chunks/{min.DwIfr8hG.js → min.SPrSp704.js} +1 -1
- package/dist/docs/assets/chunks/{mindmap-definition-QFDTVHPH.Dkq2yTtp.js → mindmap-definition-QFDTVHPH.DgrQRFZW.js} +1 -1
- package/dist/docs/assets/chunks/{pieDiagram-DEJITSTG.B4CpTmHK.js → pieDiagram-DEJITSTG.Ba7yxiW2.js} +1 -1
- package/dist/docs/assets/chunks/{quadrantDiagram-34T5L4WZ.BqXnFC9C.js → quadrantDiagram-34T5L4WZ.Bvskad4p.js} +1 -1
- package/dist/docs/assets/chunks/{requirementDiagram-MS252O5E.DhIN2z-E.js → requirementDiagram-MS252O5E.Ce70ugV9.js} +1 -1
- package/dist/docs/assets/chunks/{sankeyDiagram-XADWPNL6.BhxUAmg2.js → sankeyDiagram-XADWPNL6.BJ5OEULO.js} +1 -1
- package/dist/docs/assets/chunks/{sequenceDiagram-FGHM5R23.BqgU7HU-.js → sequenceDiagram-FGHM5R23.C8a1hDs6.js} +1 -1
- package/dist/docs/assets/chunks/{stateDiagram-FHFEXIEX.B1BCO18N.js → stateDiagram-FHFEXIEX.D2D8A5CK.js} +1 -1
- package/dist/docs/assets/chunks/stateDiagram-v2-QKLJ7IA2.77yf4kRr.js +1 -0
- package/dist/docs/assets/chunks/{theme.oV7rddEz.js → theme.DRciHmS1.js} +2 -2
- package/dist/docs/assets/chunks/{timeline-definition-GMOUNBTQ.oRI8UwMC.js → timeline-definition-GMOUNBTQ.C4ePrY8-.js} +1 -1
- package/dist/docs/assets/chunks/{vennDiagram-DHZGUBPP.DmuWrIxN.js → vennDiagram-DHZGUBPP.Dzso6dEA.js} +1 -1
- package/dist/docs/assets/chunks/{wardley-RL74JXVD.CEBjM5ov.js → wardley-RL74JXVD.djgXR0ar.js} +1 -1
- package/dist/docs/assets/chunks/{wardleyDiagram-NUSXRM2D.m5zsCOF9.js → wardleyDiagram-NUSXRM2D.Bf2ICxjh.js} +1 -1
- package/dist/docs/assets/chunks/{xychartDiagram-5P7HB3ND.cPN-587n.js → xychartDiagram-5P7HB3ND.DEH4BcVJ.js} +1 -1
- package/dist/docs/assets/{deployment.md.DDmjAVbg.js → deployment.md.KW0Ni_rY.js} +5 -5
- package/dist/docs/assets/{evals.md.OjKb7tNA.js → evals.md.DiljU__Z.js} +1 -1
- package/dist/docs/assets/{guides_jev.md.Ccw4pedT.js → guides_jev.md.CEqLgjj9.js} +2 -2
- package/dist/docs/assets/{guides_jev.md.Ccw4pedT.lean.js → guides_jev.md.CEqLgjj9.lean.js} +1 -1
- package/dist/docs/assets/{guides_mcp-oauth.md.ekpWOZCC.js → guides_mcp-oauth.md.DrGY92u4.js} +1 -1
- package/dist/docs/assets/{guides_slack.md.BqiGSYGX.js → guides_slack.md.BwXHURvY.js} +1 -1
- package/dist/docs/assets/index.md.CAruw_rp.js +26 -0
- package/dist/docs/assets/{index.md.CVRjO09Y.lean.js → index.md.CAruw_rp.lean.js} +1 -1
- package/dist/docs/assets/{quickstart.md.DaLk4ZIF.js → quickstart.md.CljDaJBi.js} +3 -3
- package/dist/docs/assets/{quickstart.md.DaLk4ZIF.lean.js → quickstart.md.CljDaJBi.lean.js} +1 -1
- package/dist/docs/assets/reference_access.md.CEtibb4i.js +1 -0
- package/dist/docs/assets/reference_access.md.CEtibb4i.lean.js +1 -0
- package/dist/docs/assets/{reference_agent-config.md.11E_xe--.js → reference_agent-config.md.Ck29qYNj.js} +1 -1
- package/dist/docs/assets/{reference_cli.md.DQ3dCgmk.js → reference_cli.md.BkdLRbXg.js} +5 -5
- package/dist/docs/assets/{reference_evals.md.DYKjGFi-.js → reference_evals.md.2BXeMiO2.js} +23 -3
- package/dist/docs/assets/{reference_evals.md.DYKjGFi-.lean.js → reference_evals.md.2BXeMiO2.lean.js} +1 -1
- package/dist/docs/assets/{reference_extensions.md.pEVj72Xo.js → reference_extensions.md.DI5X5x8p.js} +1 -1
- package/dist/docs/assets/{reference_limits.md.Da1HegjB.js → reference_limits.md.BCCnvt3o.js} +2 -2
- package/dist/docs/assets/{reference_limits.md.Da1HegjB.lean.js → reference_limits.md.BCCnvt3o.lean.js} +1 -1
- package/dist/docs/assets/troubleshooting.md.CGOdNVAL.js +1 -0
- package/dist/docs/building-with-agents.html +35 -35
- package/dist/docs/building-with-agents.md +5 -5
- package/dist/docs/changelog.html +36 -36
- package/dist/docs/changelog.md +10 -0
- package/dist/docs/deployment.html +41 -41
- package/dist/docs/deployment.md +8 -8
- package/dist/docs/evals.html +37 -37
- package/dist/docs/evals.md +4 -2
- package/dist/docs/guides/agent-to-agent.html +35 -35
- package/dist/docs/guides/bitbucket.html +35 -35
- package/dist/docs/guides/cloud-agents.html +36 -36
- package/dist/docs/guides/convert-automation.html +35 -35
- package/dist/docs/guides/github.html +35 -35
- package/dist/docs/guides/github.md +1 -1
- package/dist/docs/guides/gitlab.html +35 -35
- package/dist/docs/guides/hooks.html +35 -35
- package/dist/docs/guides/improve.html +36 -36
- package/dist/docs/guides/jev.html +36 -36
- package/dist/docs/guides/jev.md +5 -0
- package/dist/docs/guides/mcp-oauth.html +37 -37
- package/dist/docs/guides/mcp-oauth.md +2 -3
- package/dist/docs/guides/migrate.html +35 -35
- package/dist/docs/guides/migrate.md +2 -2
- package/dist/docs/guides/opentelemetry.html +35 -35
- package/dist/docs/guides/pagerduty.html +35 -35
- package/dist/docs/guides/slack.html +37 -37
- package/dist/docs/guides/slack.md +5 -6
- package/dist/docs/guides/webhooks.html +35 -35
- package/dist/docs/hashmap.json +1 -1
- package/dist/docs/hillclimbing.html +35 -35
- package/dist/docs/hillclimbing.md +2 -2
- package/dist/docs/index.html +51 -52
- package/dist/docs/index.md +17 -16
- package/dist/docs/llms-full.txt +120 -199
- package/dist/docs/llms.txt +0 -1
- package/dist/docs/package/skills/create-agent/SKILL.md +178 -0
- package/dist/docs/package/skills/evals/SKILL.md +145 -0
- package/dist/docs/package/skills/github/SKILL.md +133 -0
- package/dist/docs/package/skills/hillclimb/SKILL.md +63 -0
- package/dist/docs/package/skills/mcp-auth/SKILL.md +60 -0
- package/dist/docs/package/skills/migrate-v2/SKILL.md +394 -0
- package/dist/docs/package/skills/setup-slack/SKILL.md +136 -0
- package/dist/docs/quickstart.html +38 -38
- package/dist/docs/quickstart.md +5 -1
- package/dist/docs/reference/access.html +36 -36
- package/dist/docs/reference/access.md +3 -3
- package/dist/docs/reference/agent-config.html +37 -37
- package/dist/docs/reference/agent-config.md +1 -1
- package/dist/docs/reference/artifacts.html +35 -35
- package/dist/docs/reference/channels.html +35 -35
- package/dist/docs/reference/cli.html +41 -41
- package/dist/docs/reference/cli.md +6 -6
- package/dist/docs/reference/connections.html +35 -35
- package/dist/docs/reference/connections.md +1 -1
- package/dist/docs/reference/evals.html +57 -37
- package/dist/docs/reference/evals.md +35 -0
- package/dist/docs/reference/extensions.html +37 -37
- package/dist/docs/reference/extensions.md +2 -2
- package/dist/docs/reference/hooks.html +35 -35
- package/dist/docs/reference/http-api.html +35 -35
- package/dist/docs/reference/instructions.html +35 -35
- package/dist/docs/reference/limits.html +37 -37
- package/dist/docs/reference/limits.md +2 -2
- package/dist/docs/reference/memory.html +35 -35
- package/dist/docs/reference/playground.html +35 -35
- package/dist/docs/reference/project-layout.html +35 -35
- package/dist/docs/reference/prompt.html +35 -35
- package/dist/docs/reference/schedules.html +35 -35
- package/dist/docs/reference/sessions.html +35 -35
- package/dist/docs/reference/skills.html +35 -35
- package/dist/docs/reference/subagents.html +35 -35
- package/dist/docs/reference/tools.html +35 -35
- package/dist/docs/templates/agentic-owners.html +35 -35
- package/dist/docs/templates/security-reviewer.html +35 -35
- package/dist/docs/templates/thermo-quality-review.html +35 -35
- package/dist/docs/templates/thermo-review.html +35 -35
- package/dist/docs/templates/triage.html +35 -35
- package/dist/docs/troubleshooting.html +36 -36
- package/dist/docs/troubleshooting.md +4 -4
- package/dist/evals.d.ts +2 -2
- package/dist/extensions/jev/extension.d.ts +12 -2
- package/dist/extensions/jev/extension.d.ts.map +1 -1
- package/dist/extensions/jev/extension.js +4 -0
- package/dist/extensions/jev/lib/evaluate.d.ts +31 -4
- package/dist/extensions/jev/lib/evaluate.d.ts.map +1 -1
- package/dist/extensions/jev/lib/evaluate.js +18 -4
- package/dist/internal/cli/command.d.ts +1 -1
- package/dist/internal/cli/command.js +1 -1
- package/dist/internal/cli/commands/channels.js +6 -6
- package/dist/internal/cli/commands/develop.d.ts.map +1 -1
- package/dist/internal/cli/commands/develop.js +23 -14
- package/dist/internal/cli/commands/hosted.js +4 -4
- package/dist/internal/cli/commands/index.d.ts +1 -1
- package/dist/internal/cli/commands/index.d.ts.map +1 -1
- package/dist/internal/cli/commands/index.js +1 -1
- package/dist/internal/cli/commands/mcp.js +1 -1
- package/dist/internal/cli/commands/project.js +4 -4
- package/dist/internal/cli/commands/scaffold.d.ts.map +1 -1
- package/dist/internal/cli/commands/scaffold.js +9 -6
- package/dist/internal/cli/commands/serve.d.ts +1 -1
- package/dist/internal/cli/commands/serve.js +5 -5
- package/dist/internal/cli/commands/session.d.ts.map +1 -1
- package/dist/internal/cli/commands/session.js +12 -7
- package/dist/internal/cli/dispatch.d.ts +3 -3
- package/dist/internal/cli/dispatch.js +3 -3
- package/dist/internal/cli/errors.d.ts +1 -1
- package/dist/internal/cli/errors.d.ts.map +1 -1
- package/dist/internal/cli/errors.js +1 -1
- package/dist/internal/cli/flags.d.ts +2 -2
- package/dist/internal/cli/flags.d.ts.map +1 -1
- package/dist/internal/cli/flags.js +2 -2
- package/dist/internal/cli/help-command.d.ts +1 -1
- package/dist/internal/cli/help-command.js +2 -2
- package/dist/internal/cli/help.d.ts +7 -7
- package/dist/internal/cli/help.d.ts.map +1 -1
- package/dist/internal/cli/help.js +8 -8
- package/dist/internal/cli-ax.d.ts.map +1 -1
- package/dist/internal/cli-ax.js +3 -0
- package/dist/internal/cli-convert-automation.d.ts +1 -1
- package/dist/internal/cli-convert-automation.js +1 -1
- package/dist/internal/cli-migrate.d.ts +1 -1
- package/dist/internal/cli-migrate.js +1 -1
- package/dist/internal/cli-pagerduty.d.ts +1 -1
- package/dist/internal/cli-pagerduty.js +1 -1
- package/dist/internal/convert-automation/types.d.ts +1 -1
- package/dist/internal/convert-automation/types.js +1 -1
- package/dist/internal/deploy-client.d.ts +2 -2
- package/dist/internal/deploy-client.d.ts.map +1 -1
- package/dist/internal/init-project.d.ts +7 -3
- package/dist/internal/init-project.d.ts.map +1 -1
- package/dist/internal/init-project.js +53 -7
- package/dist/internal/init-scaffold.d.ts +2 -1
- package/dist/internal/init-scaffold.d.ts.map +1 -1
- package/dist/internal/init-scaffold.js +20 -7
- package/dist/internal/peer-connections.js +1 -1
- package/dist/internal/server.d.ts +1 -1
- package/dist/internal/session-cost.d.ts +4 -4
- package/dist/internal/session-cost.d.ts.map +1 -1
- package/dist/internal/session-cost.js +4 -4
- package/dist/internal/session-engine.d.ts +1 -1
- package/dist/internal/session-engine.js +1 -1
- package/dist/playground/assets/{index-_3zz3yh8.js → index-Cl9zvmmf.js} +40 -40
- package/dist/playground/assets/index-F8b5WvWi.css +1 -0
- package/dist/playground/index.html +2 -2
- package/dist/types.d.ts +5 -5
- package/docs/README.md +17 -16
- package/docs/changelog.md +10 -0
- package/docs/deployment.md +8 -8
- package/docs/evals.md +3 -1
- package/docs/guides/jev.md +5 -0
- package/docs/guides/mcp-oauth.md +1 -2
- package/docs/guides/slack.md +3 -4
- package/docs/quickstart.md +5 -1
- package/docs/reference/access.md +3 -3
- package/docs/reference/agent-config.md +1 -1
- package/docs/reference/cli.md +6 -6
- package/docs/reference/evals.md +35 -0
- package/docs/reference/extensions.md +2 -2
- package/docs/reference/limits.md +2 -2
- package/docs/troubleshooting.md +4 -4
- package/package.json +2 -8
- package/skills/cli/SKILL.md +15 -15
- package/skills/create-agent/SKILL.md +20 -19
- package/skills/debug/SKILL.md +4 -4
- package/skills/deploy/SKILL.md +2 -2
- package/skills/evals/SKILL.md +8 -8
- package/skills/framework-map/SKILL.md +3 -3
- package/skills/github/SKILL.md +7 -7
- package/skills/hillclimb/SKILL.md +4 -4
- package/skills/mcp-auth/SKILL.md +3 -3
- package/skills/migrate-v2/SKILL.md +40 -40
- package/skills/otel/SKILL.md +2 -2
- package/skills/setup-slack/SKILL.md +8 -8
- package/templates/agentic-owners/README.md +5 -5
- package/templates/agentic-owners/bot/tools/record_review.ts +1 -1
- package/templates/agentic-owners/package.json +1 -1
- package/templates/agents-md/README.md +4 -4
- package/templates/agents-md/package.json +1 -1
- package/templates/code-wiki/README.md +3 -3
- package/templates/code-wiki/package.json +1 -1
- package/templates/demo/README.md +3 -3
- package/templates/demo/package.json +1 -1
- package/templates/pr-autofixer/package.json +1 -1
- package/templates/security-help/README.md +5 -5
- package/templates/security-help/package.json +1 -1
- package/templates/security-reviewer/README.md +3 -3
- package/templates/security-reviewer/package.json +1 -1
- package/templates/thermo-quality-review/README.md +4 -4
- package/templates/thermo-quality-review/package.json +1 -1
- package/templates/thermo-review/README.md +4 -4
- package/templates/thermo-review/package.json +1 -1
- package/templates/triage/README.md +3 -3
- package/templates/triage/overlays/jira/README.md +3 -3
- package/templates/triage/overlays/linear/README.md +3 -3
- package/templates/triage/package.json +1 -1
- package/dist/docs/assets/changelog.md.fZ-NNFeJ.js +0 -1
- package/dist/docs/assets/changelog.md.fZ-NNFeJ.lean.js +0 -1
- package/dist/docs/assets/chunks/@localSearchIndexroot.mfzjiOsL.js +0 -1
- package/dist/docs/assets/chunks/channel.goFR5lbe.js +0 -1
- package/dist/docs/assets/chunks/classDiagram-6PBFFD2Q.B2yLtFja.js +0 -1
- package/dist/docs/assets/chunks/classDiagram-v2-HSJHXN6E.B2yLtFja.js +0 -1
- package/dist/docs/assets/chunks/clone.CztV97Wu.js +0 -1
- package/dist/docs/assets/chunks/stateDiagram-v2-QKLJ7IA2.CZlVHdDZ.js +0 -1
- package/dist/docs/assets/guides_grokbot-agents.md.D0PpM_Gf.js +0 -15
- package/dist/docs/assets/guides_grokbot-agents.md.D0PpM_Gf.lean.js +0 -1
- package/dist/docs/assets/index.md.CVRjO09Y.js +0 -27
- package/dist/docs/assets/reference_access.md.CExlH_mR.js +0 -1
- package/dist/docs/assets/reference_access.md.CExlH_mR.lean.js +0 -1
- package/dist/docs/assets/troubleshooting.md.AGJ3jDzj.js +0 -1
- package/dist/docs/guides/grokbot-agents.html +0 -74
- package/dist/docs/guides/grokbot-agents.md +0 -129
- package/dist/extensions/cursor-grokbot-agents/extension.d.ts +0 -71
- package/dist/extensions/cursor-grokbot-agents/extension.d.ts.map +0 -1
- package/dist/extensions/cursor-grokbot-agents/extension.js +0 -64
- package/dist/extensions/cursor-grokbot-agents/lib/agents.d.ts +0 -11
- package/dist/extensions/cursor-grokbot-agents/lib/agents.d.ts.map +0 -1
- package/dist/extensions/cursor-grokbot-agents/lib/agents.js +0 -31
- package/dist/extensions/cursor-grokbot-agents/lib/backend.d.ts +0 -56
- package/dist/extensions/cursor-grokbot-agents/lib/backend.d.ts.map +0 -1
- package/dist/extensions/cursor-grokbot-agents/lib/backend.js +0 -139
- package/dist/extensions/cursor-grokbot-agents/lib/contacts.d.ts +0 -28
- package/dist/extensions/cursor-grokbot-agents/lib/contacts.d.ts.map +0 -1
- package/dist/extensions/cursor-grokbot-agents/lib/contacts.js +0 -46
- package/dist/extensions/cursor-grokbot-agents/lib/conversation.d.ts +0 -53
- package/dist/extensions/cursor-grokbot-agents/lib/conversation.d.ts.map +0 -1
- package/dist/extensions/cursor-grokbot-agents/lib/conversation.js +0 -186
- package/dist/extensions/cursor-grokbot-agents/lib/inputs.d.ts +0 -4
- package/dist/extensions/cursor-grokbot-agents/lib/inputs.d.ts.map +0 -1
- package/dist/extensions/cursor-grokbot-agents/lib/inputs.js +0 -15
- package/dist/extensions/cursor-grokbot-agents/lib/lock.d.ts +0 -12
- package/dist/extensions/cursor-grokbot-agents/lib/lock.d.ts.map +0 -1
- package/dist/extensions/cursor-grokbot-agents/lib/lock.js +0 -24
- package/dist/extensions/cursor-grokbot-agents/skills/consult.md +0 -40
- package/dist/extensions/cursor-grokbot-agents/tools/ask.d.ts +0 -4
- package/dist/extensions/cursor-grokbot-agents/tools/ask.d.ts.map +0 -1
- package/dist/extensions/cursor-grokbot-agents/tools/ask.js +0 -26
- package/dist/extensions/cursor-grokbot-agents/tools/check.d.ts +0 -4
- package/dist/extensions/cursor-grokbot-agents/tools/check.d.ts.map +0 -1
- package/dist/extensions/cursor-grokbot-agents/tools/check.js +0 -21
- package/dist/extensions/cursor-grokbot-agents/tools/interrupt.d.ts +0 -4
- package/dist/extensions/cursor-grokbot-agents/tools/interrupt.d.ts.map +0 -1
- package/dist/extensions/cursor-grokbot-agents/tools/interrupt.js +0 -13
- package/dist/extensions/cursor-grokbot-agents/tools/list.d.ts +0 -4
- package/dist/extensions/cursor-grokbot-agents/tools/list.d.ts.map +0 -1
- package/dist/extensions/cursor-grokbot-agents/tools/list.js +0 -22
- package/dist/playground/assets/index-BMpVzZzC.css +0 -1
- package/docs/guides/grokbot-agents.md +0 -134
- /package/dist/docs/assets/{deployment.md.DDmjAVbg.lean.js → deployment.md.KW0Ni_rY.lean.js} +0 -0
- /package/dist/docs/assets/{evals.md.OjKb7tNA.lean.js → evals.md.DiljU__Z.lean.js} +0 -0
- /package/dist/docs/assets/{guides_mcp-oauth.md.ekpWOZCC.lean.js → guides_mcp-oauth.md.DrGY92u4.lean.js} +0 -0
- /package/dist/docs/assets/{guides_slack.md.BqiGSYGX.lean.js → guides_slack.md.BwXHURvY.lean.js} +0 -0
- /package/dist/docs/assets/{reference_agent-config.md.11E_xe--.lean.js → reference_agent-config.md.Ck29qYNj.lean.js} +0 -0
- /package/dist/docs/assets/{reference_cli.md.DQ3dCgmk.lean.js → reference_cli.md.BkdLRbXg.lean.js} +0 -0
- /package/dist/docs/assets/{reference_extensions.md.pEVj72Xo.lean.js → reference_extensions.md.DI5X5x8p.lean.js} +0 -0
- /package/dist/docs/assets/{troubleshooting.md.AGJ3jDzj.lean.js → troubleshooting.md.CGOdNVAL.lean.js} +0 -0
|
@@ -9,13 +9,13 @@ description: >-
|
|
|
9
9
|
# Create an Agent SDK agent
|
|
10
10
|
|
|
11
11
|
1. **Interview.** Two `AskQuestion` rounds, then a plan gate.
|
|
12
|
-
2. **Scaffold.** `
|
|
12
|
+
2. **Scaffold.** `agent-sdk init`, then shape the files.
|
|
13
13
|
3. **Verify.** `validate` / `info` / `tool call`, then a model turn.
|
|
14
14
|
4. **Channels.** Slack, GitHub, webhook, or schedule as chosen.
|
|
15
15
|
5. **Hillclimb.** `skills/hillclimb/SKILL.md`.
|
|
16
16
|
|
|
17
17
|
Read `skills/framework-map/SKILL.md` if you have not. CLI is
|
|
18
|
-
`
|
|
18
|
+
`agent-sdk`. Public docs:
|
|
19
19
|
`node_modules/@grok/agent-sdk/dist/docs/llms.txt` or `/docs/llms.txt`
|
|
20
20
|
on a running host.
|
|
21
21
|
|
|
@@ -33,7 +33,7 @@ on a running host.
|
|
|
33
33
|
- If `AskQuestion` is missing or the user skips, state defaults
|
|
34
34
|
in one list and proceed.
|
|
35
35
|
|
|
36
|
-
<!-- interview:start (generated from the
|
|
36
|
+
<!-- interview:start (generated from the agent-sdk init questions; do not edit by hand) -->
|
|
37
37
|
### Round 1: identity
|
|
38
38
|
|
|
39
39
|
| Question | Options | Guidance |
|
|
@@ -59,7 +59,7 @@ something". Write files only after approval.
|
|
|
59
59
|
|
|
60
60
|
| Purpose | Shape |
|
|
61
61
|
| --- | --- |
|
|
62
|
-
| Slack chat | `slackChannel({ envPrefix })` + suggested prompts. `
|
|
62
|
+
| Slack chat | `slackChannel({ envPrefix })` + suggested prompts. `agent-sdk slack create` mints the bot. Prefix: `skills/setup-slack/SKILL.md` |
|
|
63
63
|
| PR review with host prep | Channel `callTool` into a trimmed workspace `pr/` tree |
|
|
64
64
|
| GitHub automation | `githubChannel()` hooks, replay fixtures |
|
|
65
65
|
| Domain assistant | Server tools + one MCP connection + a skill |
|
|
@@ -105,7 +105,7 @@ Smells: prose builders in `.ts` (write `.md`); `bot/lib/` +
|
|
|
105
105
|
## Scaffold
|
|
106
106
|
|
|
107
107
|
```bash
|
|
108
|
-
|
|
108
|
+
agent-sdk init ./<slug>
|
|
109
109
|
```
|
|
110
110
|
|
|
111
111
|
`init` writes the project, runs `npm install`, and may wait on
|
|
@@ -115,13 +115,14 @@ bdk init ./<slug>
|
|
|
115
115
|
2. Real `instructions.md`. Replace `echo.ts`.
|
|
116
116
|
3. Chosen `channels/`, `mcp-connections/`, `skills/`,
|
|
117
117
|
`subagents/<id>/` (needs `description`), `schedules/`, `hooks/`.
|
|
118
|
-
Slack: `
|
|
118
|
+
Slack: `agent-sdk slack create --dir ./<slug> --name "<Name>"`,
|
|
119
119
|
not a hand-written channel. Manual Slack app:
|
|
120
|
-
`
|
|
120
|
+
`agent-sdk slack init --manual` (Slack CLI, or paste at
|
|
121
121
|
api.slack.com).
|
|
122
|
-
4. `evals/evals.config.ts`
|
|
123
|
-
cap 200)
|
|
124
|
-
`t.
|
|
122
|
+
4. Blank init writes `evals/evals.config.ts` (`maxConcurrency: 20`,
|
|
123
|
+
cap 200) and `evals/smoke.eval.ts`. The smoke case uses `echo`
|
|
124
|
+
and asserts `t.succeeded()` and `t.calledTool("echo")`. Replace
|
|
125
|
+
that case when you replace the tool. API: `skills/evals/SKILL.md`.
|
|
125
126
|
|
|
126
127
|
Stay on deps the Agent SDK already ships (`zod`,
|
|
127
128
|
`@modelcontextprotocol/sdk`, `tsx`).
|
|
@@ -129,25 +130,25 @@ Stay on deps the Agent SDK already ships (`zod`,
|
|
|
129
130
|
## Verify
|
|
130
131
|
|
|
131
132
|
```bash
|
|
132
|
-
|
|
133
|
-
|
|
134
|
-
|
|
135
|
-
|
|
133
|
+
agent-sdk validate --dir ./<slug>
|
|
134
|
+
agent-sdk info --dir ./<slug> --json
|
|
135
|
+
agent-sdk tool call <tool> --dir ./<slug> --input '{…}'
|
|
136
|
+
agent-sdk eval --dir ./<slug> --list
|
|
136
137
|
npx tsc --noEmit -p ./<slug>
|
|
137
138
|
```
|
|
138
139
|
|
|
139
140
|
tsx does not typecheck. Tool `execute` must return JSON-shaped
|
|
140
141
|
values: object literals or `type` aliases, not `interface` types.
|
|
141
142
|
|
|
142
|
-
Model turns need a Cursor credential (`CURSOR_API_KEY`, then `CURSOR_API_KEY_FILE`, then `CURSOR_SERVICE_ACCOUNT_KEY`, then `
|
|
143
|
+
Model turns need a Cursor credential (`CURSOR_API_KEY`, then `CURSOR_API_KEY_FILE`, then `CURSOR_SERVICE_ACCOUNT_KEY`, then `agent-sdk login`). Without one, finish the
|
|
143
144
|
key-free checks, confirm `run` fails with only the API-key error,
|
|
144
145
|
and hand these over:
|
|
145
146
|
|
|
146
147
|
```bash
|
|
147
|
-
|
|
148
|
-
|
|
148
|
+
agent-sdk run --dir ./<slug> --message "<fixture prompt>"
|
|
149
|
+
agent-sdk serve --dir ./<slug> --mode single --dev
|
|
149
150
|
# http://127.0.0.1:3000/playground
|
|
150
|
-
|
|
151
|
+
agent-sdk eval --dir ./<slug>
|
|
151
152
|
```
|
|
152
153
|
|
|
153
154
|
Serve only this agent's directory. Session files land in the
|
|
@@ -170,7 +171,7 @@ project state directory (`--state-root`). That is not harness cwd.
|
|
|
170
171
|
Once a smoke turn passes, agree fixtures, success criteria, and a
|
|
171
172
|
freeze line, then follow `skills/hillclimb/SKILL.md`. Seed from
|
|
172
173
|
the smoke session under the project state directory. GitHub:
|
|
173
|
-
snapshot `
|
|
174
|
+
snapshot `agent-sdk github replay ... --dry-run --fixtures-dir fixtures/github`.
|
|
174
175
|
|
|
175
176
|
Do not deploy or post to real Slack/GitHub beyond the smoke the
|
|
176
177
|
user asked for. If the plan grows past ~10 files, cut scope.
|
package/skills/debug/SKILL.md
CHANGED
|
@@ -8,10 +8,10 @@ description: >-
|
|
|
8
8
|
|
|
9
9
|
# Debugging the Agent SDK locally
|
|
10
10
|
|
|
11
|
-
Local `
|
|
11
|
+
Local `agent-sdk serve`. Hosted start failures:
|
|
12
12
|
`docs/troubleshooting.md` and `docs/deployment.md`.
|
|
13
13
|
|
|
14
|
-
1. **Validate.** `
|
|
14
|
+
1. **Validate.** `agent-sdk validate --dir <project>`
|
|
15
15
|
2. **Info.** `curl -s http://127.0.0.1:3000/<slug>/v1/info | jq .`
|
|
16
16
|
3. **Trace.** Session events under the project state directory.
|
|
17
17
|
Then match the table.
|
|
@@ -33,11 +33,11 @@ Local `bdk serve`. Hosted start failures:
|
|
|
33
33
|
| `403` on stream | Wrong principal. Same auth as create; beyond loopback send `--bearer-token`. |
|
|
34
34
|
| Works on loopback, blocked via tunnel | `localDevStrict()` rejects forwarded headers. Use `--bearer-token`. Never `--allow-anonymous` with account MCP. |
|
|
35
35
|
| Slack `channel idle … missing credentials` | Expected. `slack doctor --prefix <PREFIX>`. |
|
|
36
|
-
| Immediate API-key error | Model turns need a Cursor credential (`CURSOR_API_KEY`, then `CURSOR_API_KEY_FILE`, then `CURSOR_SERVICE_ACCOUNT_KEY`, then `
|
|
36
|
+
| Immediate API-key error | Model turns need a Cursor credential (`CURSOR_API_KEY`, then `CURSOR_API_KEY_FILE`, then `CURSOR_SERVICE_ACCOUNT_KEY`, then `agent-sdk login`). |
|
|
37
37
|
| `validate` clean, CI typecheck fails | tsx skipped types. JSON-shaped returns; `type` not `interface`. |
|
|
38
38
|
| `validate`: `architecture "v2" requires a named secret` | Getter or literal SCM credential. Use the quoted `{ secretName: "NAME" }`; `secrets set <slug> NAME` after deploy. |
|
|
39
39
|
|
|
40
40
|
Count `action.result` by `toolName` before blaming latency.
|
|
41
41
|
`turn.failed` + `"turn interrupted"` is a follow-up or stop, not a
|
|
42
|
-
crash. `
|
|
42
|
+
crash. `agent-sdk session get --file <file>` renders a saved
|
|
43
43
|
trace.
|
package/skills/deploy/SKILL.md
CHANGED
|
@@ -34,12 +34,12 @@ Do not ask for values the checkout or existing deployment supplies.
|
|
|
34
34
|
## Use the attached service account
|
|
35
35
|
|
|
36
36
|
Continue only when `CURSOR_SERVICE_ACCOUNT_KEY` is present. Never print
|
|
37
|
-
the value. Do not run `
|
|
37
|
+
the value. Do not run `agent-sdk login`.
|
|
38
38
|
|
|
39
39
|
On Linux and macOS, run every Agent SDK command through this wrapper:
|
|
40
40
|
|
|
41
41
|
```bash
|
|
42
|
-
BDK_VERSION="0.2.
|
|
42
|
+
BDK_VERSION="0.2.29"
|
|
43
43
|
BDK_PACKAGE="@grok/agent-sdk"
|
|
44
44
|
case "$BDK_VERSION" in
|
|
45
45
|
__BDK_V*)
|
package/skills/evals/SKILL.md
CHANGED
|
@@ -13,13 +13,13 @@ project-root `evals/**/*.eval.ts`. `bot/evals/` is ignored.
|
|
|
13
13
|
Guide: `docs/evals.md`.
|
|
14
14
|
|
|
15
15
|
Observing production: hooks. Tool logic without a model:
|
|
16
|
-
`
|
|
16
|
+
`agent-sdk tool call <tool> --input '{...}'`.
|
|
17
17
|
|
|
18
18
|
```bash
|
|
19
|
-
|
|
20
|
-
|
|
21
|
-
|
|
22
|
-
|
|
19
|
+
agent-sdk eval --dir . --list
|
|
20
|
+
agent-sdk eval --dir . --json
|
|
21
|
+
agent-sdk eval --dir . weather/nyc
|
|
22
|
+
agent-sdk eval --dir . --tag smoke
|
|
23
23
|
```
|
|
24
24
|
|
|
25
25
|
| Form | Case id |
|
|
@@ -32,7 +32,7 @@ bdk eval --dir . --tag smoke
|
|
|
32
32
|
`eval` boots an ephemeral server and a temp state root. `--url`
|
|
33
33
|
points at a running agent. Model turns need a Cursor credential
|
|
34
34
|
(`CURSOR_API_KEY`, then `CURSOR_API_KEY_FILE`, then
|
|
35
|
-
`CURSOR_SERVICE_ACCOUNT_KEY`, then `
|
|
35
|
+
`CURSOR_SERVICE_ACCOUNT_KEY`, then `agent-sdk login`); `--list` does
|
|
36
36
|
not. Node 22.13+, never Bun.
|
|
37
37
|
|
|
38
38
|
## Seeding
|
|
@@ -124,7 +124,7 @@ drifting inputs (pin them).
|
|
|
124
124
|
| Surface | Fixture |
|
|
125
125
|
| --- | --- |
|
|
126
126
|
| Chat | One frozen prompt |
|
|
127
|
-
| Tool-heavy | `
|
|
127
|
+
| Tool-heavy | `agent-sdk tool call` first, then the prompt |
|
|
128
128
|
| GitHub | `github replay … --dry-run --fixtures-dir fixtures/github` |
|
|
129
129
|
| Host-prep PR review | A team-owned PR; gate findings shape, not counts |
|
|
130
130
|
| Workspace | `workspaceFiles` in `t.send` |
|
|
@@ -137,7 +137,7 @@ tool I/O, final text, logs) under `evals/<stamp>/` in the project state
|
|
|
137
137
|
directory (the CLI prints the path); read it before editing the eval.
|
|
138
138
|
`--state-root <path>` keeps the raw session events too.
|
|
139
139
|
|
|
140
|
-
CI: `
|
|
140
|
+
CI: `agent-sdk eval --dir . --json --no-stream --junit reports/evals.xml`.
|
|
141
141
|
Exit `1` on a failed gate, `2` when nothing matched, `--strict` to fail
|
|
142
142
|
on `scored`.
|
|
143
143
|
|
|
@@ -13,8 +13,8 @@ description: >-
|
|
|
13
13
|
over HTTP, Slack, and GitHub. Markdown is prose. TypeScript is typed
|
|
14
14
|
behavior. Ground truth: package `README.md` and `AGENTS.md`.
|
|
15
15
|
|
|
16
|
-
CLI is `
|
|
17
|
-
run
|
|
16
|
+
CLI is `agent-sdk` (Node, never Bun). Follow the `bdk-cli` skill before you
|
|
17
|
+
run an `agent-sdk` command.
|
|
18
18
|
|
|
19
19
|
Public docs: `node_modules/@grok/agent-sdk/dist/docs/llms.txt` or
|
|
20
20
|
`/docs/llms.txt` on a running host.
|
|
@@ -32,7 +32,7 @@ Public docs: `node_modules/@grok/agent-sdk/dist/docs/llms.txt` or
|
|
|
32
32
|
5. **Attached MCP is nameless** until `advertiseTools: true`.
|
|
33
33
|
6. **Model turns need a Cursor credential** (`CURSOR_API_KEY`, then
|
|
34
34
|
`CURSOR_API_KEY_FILE`, then `CURSOR_SERVICE_ACCOUNT_KEY`, then
|
|
35
|
-
`
|
|
35
|
+
`agent-sdk login`). `validate`,
|
|
36
36
|
`info`, `tool call`, and `serve` bring-up do not.
|
|
37
37
|
7. **Memory is `ctx.host.kv`.** On Cursor hosting, a later event
|
|
38
38
|
can run in a new process. Module `Map`s, globals, and local files
|
package/skills/github/SKILL.md
CHANGED
|
@@ -56,7 +56,7 @@ at deploy. Repos must share one GitHub owner.
|
|
|
56
56
|
|
|
57
57
|
| Source | When |
|
|
58
58
|
| ------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
|
|
59
|
-
| `cursorAccount` + `serve --cursor-events` | Preferred. Signed-in host (`
|
|
59
|
+
| `cursorAccount` + `serve --cursor-events` | Preferred. Signed-in host (`agent-sdk login`, `CURSOR_API_KEY`, or `CURSOR_SERVICE_ACCOUNT_KEY`). Repos from the channel and from repeatable `--repo owner/name`. Cap 20, one GitHub owner |
|
|
60
60
|
| HTTP `POST /<slug>/v1/channels/github` with a webhook secret | `allowAll()` + `X-Hub-Signature-256` |
|
|
61
61
|
| HTTP, no secret | Loopback only. `serve --dev` also admits unsigned loopback (fixtures / forward) |
|
|
62
62
|
|
|
@@ -88,7 +88,7 @@ credentials: {
|
|
|
88
88
|
},
|
|
89
89
|
```
|
|
90
90
|
|
|
91
|
-
A literal or `() => process.env.X` getter fails `
|
|
91
|
+
A literal or `() => process.env.X` getter fails `agent-sdk validate` on
|
|
92
92
|
architecture v2 (the default) with `requires a named secret`; the
|
|
93
93
|
message quotes the `{ secretName }` to use. Omit a field to keep its
|
|
94
94
|
default name; a numeric `appId` is allowed. Only `architecture: "v1"`
|
|
@@ -111,22 +111,22 @@ curl -s -X POST http://127.0.0.1:3000/<slug>/v1/channels/github \
|
|
|
111
111
|
2. **Replay** (hillclimb tier; pull access is enough):
|
|
112
112
|
|
|
113
113
|
```bash
|
|
114
|
-
|
|
115
|
-
|
|
114
|
+
agent-sdk github replay owner/repo#123 --dir <project>
|
|
115
|
+
agent-sdk github replay owner/repo#123 --dir <project> --events '*' --dry-run --fixtures-dir fixtures/github
|
|
116
116
|
```
|
|
117
117
|
|
|
118
118
|
3. **Forward** (live; repo admin). One forwarder per repo. Blank
|
|
119
119
|
`GITHUB_TOKEN`/`GH_TOKEN` or every delivery 401s:
|
|
120
120
|
|
|
121
121
|
```bash
|
|
122
|
-
|
|
123
|
-
GITHUB_TOKEN= GH_TOKEN=
|
|
122
|
+
agent-sdk github doctor --install
|
|
123
|
+
GITHUB_TOKEN= GH_TOKEN= agent-sdk github forward --dir <project>
|
|
124
124
|
```
|
|
125
125
|
|
|
126
126
|
4. **Cursor pull** (same as production):
|
|
127
127
|
|
|
128
128
|
```bash
|
|
129
|
-
|
|
129
|
+
agent-sdk serve --dir <project> --cursor-events --repo owner/repo
|
|
130
130
|
```
|
|
131
131
|
|
|
132
132
|
Volume, debounce, and `progress.commitStatus` / `progress.banner`
|
|
@@ -26,13 +26,13 @@ Ask before editing if any are missing. A moving fixture is noise.
|
|
|
26
26
|
|
|
27
27
|
| Surface | Pin it |
|
|
28
28
|
| --- | --- |
|
|
29
|
-
| GitHub | `
|
|
30
|
-
| One tool | `
|
|
31
|
-
| Chat | `
|
|
29
|
+
| GitHub | `agent-sdk github replay <pr> --dir <project>` (`--dry-run --out fixtures/github`) |
|
|
30
|
+
| One tool | `agent-sdk tool call <tool> --dir <project> --input '{...}'` |
|
|
31
|
+
| Chat | `agent-sdk run --dir <project> --message "<fixture>"` |
|
|
32
32
|
|
|
33
33
|
## Loop
|
|
34
34
|
|
|
35
|
-
1. **Serve.** `
|
|
35
|
+
1. **Serve.** `agent-sdk serve --dir <project> --mode single --dev`
|
|
36
36
|
Playground: `http://127.0.0.1:3000/playground`.
|
|
37
37
|
2. **Hit it.** Same path a user would. Record status, wall time,
|
|
38
38
|
`sessionId`, output, and `action.result` counts by `toolName`.
|
package/skills/mcp-auth/SKILL.md
CHANGED
|
@@ -2,7 +2,7 @@
|
|
|
2
2
|
name: bdk-mcp-auth
|
|
3
3
|
description: >-
|
|
4
4
|
Authorize host MCP OAuth for defineConnection({ url, oauth: true }):
|
|
5
|
-
|
|
5
|
+
agent-sdk mcp oauth, local tokens, advertiseTools, egress, and the hosted
|
|
6
6
|
cursorAccount path. Use when wiring or debugging MCP auth.
|
|
7
7
|
---
|
|
8
8
|
|
|
@@ -26,7 +26,7 @@ can still call `ctx.host.mcp`.
|
|
|
26
26
|
the model must not see it.
|
|
27
27
|
2. **Allow egress** on hosted non-bootstrap hosts:
|
|
28
28
|
`hosting.egressDomains`.
|
|
29
|
-
3. **Authorize.** Local: `
|
|
29
|
+
3. **Authorize.** Local: `agent-sdk mcp oauth <name>`, or finish
|
|
30
30
|
Connect in the playground so the current process can retry.
|
|
31
31
|
Tokens stay on this machine. Hosted: use a
|
|
32
32
|
`cursorAccount: true` connection and connect the server from
|
|
@@ -42,7 +42,7 @@ export default defineConnection({
|
|
|
42
42
|
```
|
|
43
43
|
|
|
44
44
|
```bash
|
|
45
|
-
|
|
45
|
+
agent-sdk mcp oauth <connection>
|
|
46
46
|
```
|
|
47
47
|
|
|
48
48
|
Browser callback: `http://127.0.0.1:8787/callback`. Tokens live in
|
|
@@ -20,14 +20,14 @@ Migrate when any of these is true:
|
|
|
20
20
|
|
|
21
21
|
- `package.json` depends on `@cursor/july`.
|
|
22
22
|
- `agent/agent.ts` sets `architecture: "v1"`.
|
|
23
|
-
- `
|
|
23
|
+
- `agent-sdk deployment get <slug>` for the hosted copy does not print
|
|
24
24
|
`architecture: v2`.
|
|
25
25
|
|
|
26
26
|
Stop when none is true. Your final message must start with
|
|
27
27
|
`Nothing to migrate.` and must name the checks you ran. Open no pull
|
|
28
28
|
request.
|
|
29
29
|
|
|
30
|
-
`
|
|
30
|
+
`agent-sdk migrate` checks `--dir` before it starts an agent. It starts an
|
|
31
31
|
agent when it finds any of these: an `@cursor/july` dependency or
|
|
32
32
|
import, `architecture: "v1"`, `bot/storage.ts` or `agent/storage.ts`,
|
|
33
33
|
`runtime: "grokbot"`, a literal or `() => process.env` SCM credential,
|
|
@@ -35,8 +35,8 @@ import, `architecture: "v1"`, `bot/storage.ts` or `agent/storage.ts`,
|
|
|
35
35
|
`until`, or a `defineConnection` whose URL comes from a `*_MCP_URL`
|
|
36
36
|
secret. When none of those is present it prints `Nothing to migrate.`
|
|
37
37
|
and exits. When it cannot read a file, it starts the agent. It does
|
|
38
|
-
not run `
|
|
39
|
-
source has moved. Check with `
|
|
38
|
+
not run `agent-sdk deployment`. A hosted copy can still be on v1 after the
|
|
39
|
+
source has moved. Check with `agent-sdk deployment get <slug>`, and deploy when
|
|
40
40
|
that output does not show `architecture: v2`.
|
|
41
41
|
|
|
42
42
|
## Know what changes
|
|
@@ -73,12 +73,12 @@ ends. That model changes code in three places:
|
|
|
73
73
|
| Reminders with `prompt` or a named `handler` | Supported |
|
|
74
74
|
| Secrets and `hosting.egressDomains` | Supported. Same-slug deploys copy v1 secrets. |
|
|
75
75
|
| `persistent: true` and `hosting.image` | Supported, one persistent deployment per team |
|
|
76
|
-
| Local `
|
|
76
|
+
| Local `agent-sdk dev`, `run`, `eval`, and the playground | Supported |
|
|
77
77
|
| `defineStorage` in `agent/storage.ts` | Not supported. Delete the file. |
|
|
78
78
|
| Reminders with inline `run` or a function `until` | Not supported. Use a named handler. |
|
|
79
79
|
| Cron schedules in `agent/schedules/` on Cursor hosting | Supported with `@grok/agent-sdk` 0.2.14 or newer. Each fire runs in a new runtime and must finish in 26 minutes. |
|
|
80
80
|
| Slack tool-approval buttons on Cursor hosting | Not supported yet |
|
|
81
|
-
| `
|
|
81
|
+
| `agent-sdk mcp oauth --store` for host MCP OAuth | Not supported. Connect Cursor-account MCP servers from **Deployed Agents** in the dashboard. |
|
|
82
82
|
| Session, tool, and MCP APIs on the deployment URL | Not reachable |
|
|
83
83
|
| Another Agent SDK agent reached through a deployment URL secret | Not supported. Declare `defineConnection({ agent: "<slug>" })`. Both agents must be team-owned and deployed on `@grok/agent-sdk` 0.2.18 or newer. |
|
|
84
84
|
| `--prod` with `chat`, `tool call`, `skill`, `session get --view cost`, or `mcp` | Not supported. Use `session create`, `logs --prod`, `session list --prod`, `session get --prod`, and `session get --prod --web`. |
|
|
@@ -183,12 +183,12 @@ still loads.
|
|
|
183
183
|
},
|
|
184
184
|
```
|
|
185
185
|
|
|
186
|
-
`
|
|
186
|
+
`agent-sdk validate` lists each field still in the old shape. While
|
|
187
187
|
`architecture: "v1"` is set the finding is a warning, so you can run
|
|
188
188
|
it before step 2 to see the full list; after step 2 the same finding
|
|
189
189
|
is an error and blocks `deploy`. Do not set the values: a same-slug
|
|
190
190
|
deploy copies the v1 secrets, and a new slug takes
|
|
191
|
-
`
|
|
191
|
+
`agent-sdk secret set <new-slug> NAME` after the deploy.
|
|
192
192
|
|
|
193
193
|
7. **Move secret reads.** Replace module-scope `process.env.NAME` reads
|
|
194
194
|
with reads inside the function that uses them. Give MCP connections a
|
|
@@ -250,9 +250,9 @@ still loads.
|
|
|
250
250
|
on `defineAgent`, and from an extension `hosting` block that declares
|
|
251
251
|
it. Leave every secret something else still reads.
|
|
252
252
|
|
|
253
|
-
Do not change deployment secrets, and do not run `
|
|
253
|
+
Do not change deployment secrets, and do not run `agent-sdk secret delete`.
|
|
254
254
|
In the pull request body, list each secret this step stopped using,
|
|
255
|
-
with the command `
|
|
255
|
+
with the command `agent-sdk secret delete <slug> NAME`, so the user can
|
|
256
256
|
unset it after both agents are deployed.
|
|
257
257
|
|
|
258
258
|
Both agents must be team-owned and deployed with `@grok/agent-sdk` 0.2.18
|
|
@@ -267,13 +267,13 @@ still loads.
|
|
|
267
267
|
## Verify locally
|
|
268
268
|
|
|
269
269
|
Run the project's installed CLI. Prefix each command with `npx` when
|
|
270
|
-
`
|
|
270
|
+
`agent-sdk` is not on `PATH`.
|
|
271
271
|
|
|
272
272
|
```bash
|
|
273
|
-
|
|
274
|
-
|
|
275
|
-
|
|
276
|
-
|
|
273
|
+
agent-sdk validate --dir .
|
|
274
|
+
agent-sdk info --dir . --json
|
|
275
|
+
agent-sdk run --dir . --message "<a representative request>"
|
|
276
|
+
agent-sdk eval --dir .
|
|
277
277
|
```
|
|
278
278
|
|
|
279
279
|
Fix every validation error, but never change `runtime` to pass
|
|
@@ -288,44 +288,44 @@ Run the project's own typecheck and tests.
|
|
|
288
288
|
Describe each removed or changed behavior, each unsupported row the
|
|
289
289
|
agent touched, and the deploy steps. For each peer URL you rewrote, name
|
|
290
290
|
the slug and the connection file. List every secret name the rewrite
|
|
291
|
-
left unused, and the `
|
|
291
|
+
left unused, and the `agent-sdk secret delete <slug> NAME` command for it.
|
|
292
292
|
Name each TODO whose slug you could not determine. Do not deploy from
|
|
293
293
|
the pull request branch, and do not change deployment secrets.
|
|
294
294
|
|
|
295
295
|
Copy this post-merge checklist into the pull request body. One
|
|
296
|
-
`
|
|
297
|
-
Then `
|
|
298
|
-
for each agent that uses Slack. Then `
|
|
299
|
-
each unused peer URL secret, and `
|
|
300
|
-
`
|
|
301
|
-
to deploy again after Slack setup or after `
|
|
296
|
+
`agent-sdk deploy --dir <agent-folder>` per agent. Do not use `agent-sdk deploy --all`.
|
|
297
|
+
Then `agent-sdk slack create --env prod --dir <agent-folder> [--team <team-id>]`
|
|
298
|
+
for each agent that uses Slack. Then `agent-sdk secret delete <slug> NAME` for
|
|
299
|
+
each unused peer URL secret, and `agent-sdk secret list <slug>` plus
|
|
300
|
+
`agent-sdk secret set <slug> NAME` when the slug is new. Do not tell the user
|
|
301
|
+
to deploy again after Slack setup or after `agent-sdk secret set`. The server
|
|
302
302
|
redeploys after Slack setup, and a secret is injected on the next
|
|
303
303
|
request.
|
|
304
304
|
|
|
305
305
|
## Deploy after merge
|
|
306
306
|
|
|
307
|
-
Deploy from a pushed ref. `
|
|
307
|
+
Deploy from a pushed ref. `agent-sdk deploy` reads Git and never uploads the
|
|
308
308
|
working tree.
|
|
309
309
|
|
|
310
310
|
When the folder contains one agent:
|
|
311
311
|
|
|
312
312
|
```bash
|
|
313
|
-
|
|
314
|
-
|
|
315
|
-
|
|
313
|
+
agent-sdk login
|
|
314
|
+
agent-sdk validate --dir .
|
|
315
|
+
agent-sdk deploy --dir . --slug <existing-slug> \
|
|
316
316
|
--cursor-events-repo <owner/repo>
|
|
317
317
|
```
|
|
318
318
|
|
|
319
319
|
When the folder contains more than one agent, deploy each agent alone.
|
|
320
|
-
Run the command one time for each agent folder. A `
|
|
320
|
+
Run the command one time for each agent folder. A `agent-sdk deploy` on the
|
|
321
321
|
parent folder prints those commands and does not deploy. Do not run
|
|
322
|
-
`
|
|
322
|
+
`agent-sdk deploy --all`. Repeat `agent-sdk slack create --env prod` for each agent
|
|
323
323
|
folder too.
|
|
324
324
|
The app slug is the folder name, so that name must match the deployed
|
|
325
325
|
slug.
|
|
326
326
|
|
|
327
327
|
```bash
|
|
328
|
-
|
|
328
|
+
agent-sdk deploy --dir <agent-folder> --slug <that-agent-slug> \
|
|
329
329
|
--cursor-events-repo <owner/repo>
|
|
330
330
|
```
|
|
331
331
|
|
|
@@ -337,17 +337,17 @@ deployment is running. The peer needs no matching file. After both
|
|
|
337
337
|
deploys are running, unset each URL secret the pull request lists:
|
|
338
338
|
|
|
339
339
|
```bash
|
|
340
|
-
|
|
340
|
+
agent-sdk secret delete <slug> NAME
|
|
341
341
|
```
|
|
342
342
|
|
|
343
|
-
Pass every `--cursor-events-repo` value the v1 deployment used. `
|
|
343
|
+
Pass every `--cursor-events-repo` value the v1 deployment used. `agent-sdk deploy`
|
|
344
344
|
has no `--allow-domain` flag. Add every egress domain that the v1
|
|
345
345
|
deployment allowed to `hosting.egressDomains` in the agent config, and
|
|
346
346
|
merge that change before you deploy. Print only those two fields,
|
|
347
347
|
because the full output holds credentials:
|
|
348
348
|
|
|
349
349
|
```bash
|
|
350
|
-
|
|
350
|
+
agent-sdk deployment get <slug> --json --fields cursorEventRepos,egressAllowedDomains
|
|
351
351
|
```
|
|
352
352
|
|
|
353
353
|
Choose a cutover before you deploy:
|
|
@@ -359,10 +359,10 @@ Choose a cutover before you deploy:
|
|
|
359
359
|
below. If the command reports that same-slug replacement is
|
|
360
360
|
unavailable, use a new slug.
|
|
361
361
|
- **New slug.** v1 keeps serving while you test. Set secrets with
|
|
362
|
-
`
|
|
362
|
+
`agent-sdk secret set <new-slug> NAME`. Both deployments act on events from
|
|
363
363
|
the same repositories, so point the trial at a test repository with
|
|
364
364
|
`--cursor-events-repo`. Then move senders over and run
|
|
365
|
-
`
|
|
365
|
+
`agent-sdk deployment delete <old-slug>`, which deletes v1's hosted data the same way.
|
|
366
366
|
|
|
367
367
|
Prefer a new slug when the agent serves Slack, receives webhooks, or
|
|
368
368
|
keeps data in `ctx.host.kv`.
|
|
@@ -372,22 +372,22 @@ After the deploy is running:
|
|
|
372
372
|
- Store the alias token the deploy prints. Point every webhook sender
|
|
373
373
|
and HTTP caller at the new alias URL.
|
|
374
374
|
- For Slack, log in as a person. A team service-account key cannot
|
|
375
|
-
create the app. Run `
|
|
375
|
+
create the app. Run `agent-sdk slack create --env prod --dir <agent-folder>`
|
|
376
376
|
once per agent (`--team <team-id>` selects the Cursor team that owns
|
|
377
377
|
the deployment). The server redeploys by itself. Do not deploy again
|
|
378
378
|
for Slack. The new app is a different bot. Uninstall the old Slack app
|
|
379
379
|
and invite the new bot to the channels the old one joined. The copied
|
|
380
380
|
v1 Slack secrets go unused.
|
|
381
381
|
- For secrets, a same-slug deploy copies the v1 secrets. A new slug
|
|
382
|
-
needs `
|
|
383
|
-
`
|
|
382
|
+
needs `agent-sdk secret set <slug> NAME`. Check with
|
|
383
|
+
`agent-sdk secret list <slug> [--team <team-id>]`. `deploy` warns when a
|
|
384
384
|
declared secret is unset. A secret is injected on the next request.
|
|
385
|
-
Do not deploy again after `
|
|
385
|
+
Do not deploy again after `agent-sdk secret set`.
|
|
386
386
|
- Reconnect Cursor-account MCP servers from **Deployed Agents** in the
|
|
387
387
|
dashboard.
|
|
388
|
-
- Start a turn with `
|
|
388
|
+
- Start a turn with `agent-sdk session create --slug <slug> --message "..." --wait`.
|
|
389
389
|
It prints the `sessionId` once the delivery names it. Then read the turn
|
|
390
|
-
with `
|
|
390
|
+
with `agent-sdk session get <ses_...> --prod --slug <slug>` until the latest run
|
|
391
391
|
finishes.
|
|
392
392
|
|
|
393
393
|
The deploy skill (`skills/deploy/SKILL.md`) covers deploys with an attached
|
package/skills/otel/SKILL.md
CHANGED
|
@@ -67,10 +67,10 @@ Read the guide section "Migrating from serve({ otel })".
|
|
|
67
67
|
|
|
68
68
|
Hosted agents:
|
|
69
69
|
|
|
70
|
-
- Put the same variables in `
|
|
70
|
+
- Put the same variables in `agent-sdk secret set`, and add the collector
|
|
71
71
|
host to `hosting.egressDomains`.
|
|
72
72
|
- Header values are URL-encoded (`Authorization=Basic%20...`).
|
|
73
|
-
- A new header or URL from `
|
|
73
|
+
- A new header or URL from `agent-sdk secret set` applies on the next export.
|
|
74
74
|
|
|
75
75
|
Not supported yet: custom span processors, samplers, views, your own
|
|
76
76
|
SDK, and library auto-instrumentation. A span that ends before the
|
|
@@ -8,7 +8,7 @@ description: >-
|
|
|
8
8
|
|
|
9
9
|
# Setup Slack for the Agent SDK
|
|
10
10
|
|
|
11
|
-
Dedicated Socket Mode bot. `
|
|
11
|
+
Dedicated Socket Mode bot. `agent-sdk slack create` opens the
|
|
12
12
|
signed-in dashboard wizard. Tokens land in `.env.local` and as
|
|
13
13
|
deployment secrets. Never print token values.
|
|
14
14
|
|
|
@@ -23,8 +23,8 @@ Guide: `docs/guides/slack.md`.
|
|
|
23
23
|
## 1. Wizard (default)
|
|
24
24
|
|
|
25
25
|
```bash
|
|
26
|
-
|
|
27
|
-
|
|
26
|
+
agent-sdk login
|
|
27
|
+
agent-sdk slack create --dir .
|
|
28
28
|
```
|
|
29
29
|
|
|
30
30
|
Same Cursor account in the browser. **Add Slack to this agent**,
|
|
@@ -57,10 +57,10 @@ handler.
|
|
|
57
57
|
|
|
58
58
|
A second `slack create` for the same agent and env overwrites the
|
|
59
59
|
app (same Slack app id, new manifest and tokens).
|
|
60
|
-
`
|
|
60
|
+
`agent-sdk slack destroy` deletes it.
|
|
61
61
|
|
|
62
62
|
Local serve does not need a hosted engine. Next
|
|
63
|
-
`
|
|
63
|
+
`agent-sdk deploy` injects the stored secrets.
|
|
64
64
|
|
|
65
65
|
## 2. Manual (`slack init --manual`)
|
|
66
66
|
|
|
@@ -69,7 +69,7 @@ Only when they own the app. Preferred: Slack CLI
|
|
|
69
69
|
missing. Never `slack deploy`; Agent SDK serve owns Socket Mode.
|
|
70
70
|
|
|
71
71
|
```bash
|
|
72
|
-
|
|
72
|
+
agent-sdk slack init --manual --dir . --name "My Agent"
|
|
73
73
|
# --slack-team T0123ABCD when several workspaces are logged in
|
|
74
74
|
# --no-install to scaffold only
|
|
75
75
|
```
|
|
@@ -100,8 +100,8 @@ Human gates, one at a time. Stop after each.
|
|
|
100
100
|
## 3. Doctor and smoke
|
|
101
101
|
|
|
102
102
|
```bash
|
|
103
|
-
|
|
104
|
-
|
|
103
|
+
agent-sdk slack doctor --prefix JENNY
|
|
104
|
+
agent-sdk serve --dir . --dev
|
|
105
105
|
```
|
|
106
106
|
|
|
107
107
|
Green: `app_token`, `connections_open`, `bot_token`, `auth_test`.
|
|
@@ -18,14 +18,14 @@ repos: ["acme/api"],
|
|
|
18
18
|
```
|
|
19
19
|
|
|
20
20
|
```text
|
|
21
|
-
|
|
22
|
-
|
|
21
|
+
agent-sdk login
|
|
22
|
+
agent-sdk dev
|
|
23
23
|
```
|
|
24
24
|
|
|
25
25
|
That is enough: PR events stream through your Cursor account, no webhook
|
|
26
26
|
or GitHub App setup. Open a PR (or replay one with
|
|
27
|
-
`
|
|
28
|
-
and watch the review land. Deploy with `
|
|
27
|
+
`agent-sdk github replay <pr-url>`, which also works with `repos` empty)
|
|
28
|
+
and watch the review land. Deploy with `agent-sdk deploy`.
|
|
29
29
|
|
|
30
30
|
## Policies
|
|
31
31
|
|
|
@@ -75,4 +75,4 @@ notify winners unchanged, and they skip a `skip_teams` team or a
|
|
|
75
75
|
- `bot/lib/owners/prompts/base-review.md`: the risk rubric
|
|
76
76
|
- `.agentic-owners/policy.yml` in your repo: ownership rules
|
|
77
77
|
|
|
78
|
-
`
|
|
78
|
+
`agent-sdk eval` runs three smoke reviews and skips GitHub writes.
|
|
@@ -35,7 +35,7 @@ export default defineTool({
|
|
|
35
35
|
return {
|
|
36
36
|
status: "failed",
|
|
37
37
|
message:
|
|
38
|
-
"not a GitHub pull-request session — reviews start from the github channel (
|
|
38
|
+
"not a GitHub pull-request session — reviews start from the github channel (agent-sdk github replay <pr-url> to test locally)",
|
|
39
39
|
};
|
|
40
40
|
}
|
|
41
41
|
// Wake froze the assessed head into the session workspace. A model-supplied
|
|
@@ -5,7 +5,7 @@
|
|
|
5
5
|
"description": "Reviews pull requests against committed .agentic-owners policies: risk-tiers the diff, requests the owners as reviewers, approves what the policy allows.",
|
|
6
6
|
"scripts": {
|
|
7
7
|
"check": "tsc --noEmit",
|
|
8
|
-
"dev": "
|
|
8
|
+
"dev": "agent-sdk dev"
|
|
9
9
|
},
|
|
10
10
|
"dependencies": {
|
|
11
11
|
"@grok/agent-sdk": "latest",
|
|
@@ -19,13 +19,13 @@ the bot to each listed channel, including private ones. Then sign the
|
|
|
19
19
|
host in:
|
|
20
20
|
|
|
21
21
|
```text
|
|
22
|
-
|
|
23
|
-
|
|
24
|
-
|
|
22
|
+
agent-sdk login
|
|
23
|
+
agent-sdk slack create --dir .
|
|
24
|
+
agent-sdk dev
|
|
25
25
|
```
|
|
26
26
|
|
|
27
27
|
The Slack app uses `AGENTS_MD_SLACK_BOT_TOKEN` and
|
|
28
|
-
`AGENTS_MD_SLACK_APP_TOKEN`. `
|
|
28
|
+
`AGENTS_MD_SLACK_APP_TOKEN`. `agent-sdk slack create` writes both values to
|
|
29
29
|
`.env.local`.
|
|
30
30
|
|
|
31
31
|
Schedules do not fire under `dev`. Dispatch the weekly job:
|