@grok/agent-sdk 0.3.0 → 0.5.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/channels/match-ready/index.d.ts +4 -0
- package/dist/channels/match-ready/index.d.ts.map +1 -0
- package/dist/channels/match-ready/index.js +2 -0
- package/dist/channels/match-ready/match-ready-channel.d.ts +5 -0
- package/dist/channels/match-ready/match-ready-channel.d.ts.map +1 -0
- package/dist/channels/match-ready/match-ready-channel.js +42 -0
- package/dist/channels/match-ready/types.d.ts +25 -0
- package/dist/channels/match-ready/types.d.ts.map +1 -0
- package/dist/channels/match-ready/types.js +1 -0
- package/dist/channels/slack/slack-channel.d.ts.map +1 -1
- package/dist/channels/slack/slack-channel.js +27 -14
- package/dist/docs/404.html +2 -2
- package/dist/docs/assets/{app.BzTUBOAD.js → app.CYdjweqP.js} +4 -4
- package/dist/docs/assets/{building-with-agents.md.BqJ7AAjG.js → building-with-agents.md.Bo3ct-rf.js} +1 -1
- package/dist/docs/assets/changelog.md.BMrJ5WxW.js +1 -0
- package/dist/docs/assets/changelog.md.BMrJ5WxW.lean.js +1 -0
- package/dist/docs/assets/chunks/@localSearchIndexroot.dUaE1f8e.js +1 -0
- package/dist/docs/assets/chunks/{VPLocalSearchBox.DsnRlUT5.js → VPLocalSearchBox.CRATKS9J.js} +1 -1
- package/dist/docs/assets/chunks/{arc.DH8GOhiv.js → arc.BxM78ISR.js} +1 -1
- package/dist/docs/assets/chunks/{architectureDiagram-Q4EWVU46.9m9ObyuE.js → architectureDiagram-Q4EWVU46.Bi6MuKaU.js} +1 -1
- package/dist/docs/assets/chunks/{baseUniq.BXHpx1lE.js → baseUniq.L47qqpDG.js} +1 -1
- package/dist/docs/assets/chunks/{blockDiagram-DXYQGD6D.xY3EX59q.js → blockDiagram-DXYQGD6D.kHFF2FK5.js} +1 -1
- package/dist/docs/assets/chunks/{c4Diagram-AHTNJAMY.DnqgMVgc.js → c4Diagram-AHTNJAMY.BTW85ll3.js} +1 -1
- package/dist/docs/assets/chunks/channel.ljJtQtBi.js +1 -0
- package/dist/docs/assets/chunks/{chunk-4BX2VUAB.BjFxK2A3.js → chunk-4BX2VUAB.Bbh3_48g.js} +1 -1
- package/dist/docs/assets/chunks/{chunk-4TB4RGXK.BujS_Spt.js → chunk-4TB4RGXK.WeAmK3fK.js} +1 -1
- package/dist/docs/assets/chunks/{chunk-55IACEB6.YbTjhdaM.js → chunk-55IACEB6.DTdUiVHf.js} +1 -1
- package/dist/docs/assets/chunks/{chunk-EDXVE4YY.DnQ8t4GC.js → chunk-EDXVE4YY.n5XzANDz.js} +1 -1
- package/dist/docs/assets/chunks/{chunk-FMBD7UC4.B67AwAmj.js → chunk-FMBD7UC4.D51eewCb.js} +1 -1
- package/dist/docs/assets/chunks/{chunk-OYMX7WX6.DrZIAFOm.js → chunk-OYMX7WX6.BrY0U7ZV.js} +1 -1
- package/dist/docs/assets/chunks/{chunk-QZHKN3VN.BLmmydkn.js → chunk-QZHKN3VN.B0OA4aFV.js} +1 -1
- package/dist/docs/assets/chunks/{chunk-YZCP3GAM.DaoOfw0O.js → chunk-YZCP3GAM.Djt3Mjft.js} +1 -1
- package/dist/docs/assets/chunks/classDiagram-6PBFFD2Q.BZ3Uc-XU.js +1 -0
- package/dist/docs/assets/chunks/classDiagram-v2-HSJHXN6E.BZ3Uc-XU.js +1 -0
- package/dist/docs/assets/chunks/clone.BDtbEo69.js +1 -0
- package/dist/docs/assets/chunks/{cose-bilkent-S5V4N54A.DMQuNhM5.js → cose-bilkent-S5V4N54A.DiMcA6Q8.js} +1 -1
- package/dist/docs/assets/chunks/{dagre-KV5264BT.CZoGVuUf.js → dagre-KV5264BT.BGqI4vrS.js} +1 -1
- package/dist/docs/assets/chunks/{diagram-5BDNPKRD.CLt9uOyL.js → diagram-5BDNPKRD.bDqFuMoH.js} +1 -1
- package/dist/docs/assets/chunks/{diagram-G4DWMVQ6.DpczEm1G.js → diagram-G4DWMVQ6.Y0sxaXRU.js} +1 -1
- package/dist/docs/assets/chunks/{diagram-MMDJMWI5.D4r13DvJ.js → diagram-MMDJMWI5.Bg43b0yi.js} +1 -1
- package/dist/docs/assets/chunks/{diagram-TYMM5635.CYU9eGFu.js → diagram-TYMM5635.DCfVasEC.js} +1 -1
- package/dist/docs/assets/chunks/{erDiagram-SMLLAGMA.QA9naWEw.js → erDiagram-SMLLAGMA.C72GaD16.js} +1 -1
- package/dist/docs/assets/chunks/{flowDiagram-DWJPFMVM.BbNoVZYd.js → flowDiagram-DWJPFMVM.DxRQj7pP.js} +1 -1
- package/dist/docs/assets/chunks/{ganttDiagram-T4ZO3ILL.IHjDoG7r.js → ganttDiagram-T4ZO3ILL.DiLZy5Q4.js} +1 -1
- package/dist/docs/assets/chunks/{gitGraphDiagram-UUTBAWPF.B21VMdf5.js → gitGraphDiagram-UUTBAWPF.DL8XkRvh.js} +1 -1
- package/dist/docs/assets/chunks/{graph.DgJ4L-8V.js → graph.3Xub80xJ.js} +1 -1
- package/dist/docs/assets/chunks/{infoDiagram-42DDH7IO.CQjrcthc.js → infoDiagram-42DDH7IO.O3lGaspu.js} +1 -1
- package/dist/docs/assets/chunks/{ishikawaDiagram-UXIWVN3A.D4tPGtVo.js → ishikawaDiagram-UXIWVN3A.w-pCiQzn.js} +1 -1
- package/dist/docs/assets/chunks/{journeyDiagram-VCZTEJTY.BD3WaNbQ.js → journeyDiagram-VCZTEJTY.Cg_oBs9j.js} +1 -1
- package/dist/docs/assets/chunks/{kanban-definition-6JOO6SKY.Ca0o4Tqz.js → kanban-definition-6JOO6SKY.BpfMGPwn.js} +1 -1
- package/dist/docs/assets/chunks/{layout.DXXqX4MQ.js → layout.CtwXs__p.js} +1 -1
- package/dist/docs/assets/chunks/{linear.5c61gNw4.js → linear.NmCskOrP.js} +1 -1
- package/dist/docs/assets/chunks/{min.B1-NAjHX.js → min.DpQtsLKs.js} +1 -1
- package/dist/docs/assets/chunks/{mindmap-definition-QFDTVHPH.BELznv3-.js → mindmap-definition-QFDTVHPH.B-P-aKVp.js} +1 -1
- package/dist/docs/assets/chunks/{pieDiagram-DEJITSTG.qPzO1mq5.js → pieDiagram-DEJITSTG.BfjjqK7j.js} +1 -1
- package/dist/docs/assets/chunks/{quadrantDiagram-34T5L4WZ.CxIvzbjX.js → quadrantDiagram-34T5L4WZ.BTzHo53F.js} +1 -1
- package/dist/docs/assets/chunks/{requirementDiagram-MS252O5E.CqA0iJx8.js → requirementDiagram-MS252O5E.DIT2FIKr.js} +1 -1
- package/dist/docs/assets/chunks/{sankeyDiagram-XADWPNL6.XRTutBnb.js → sankeyDiagram-XADWPNL6.NK1wCsgt.js} +1 -1
- package/dist/docs/assets/chunks/{sequenceDiagram-FGHM5R23.E--7bRLQ.js → sequenceDiagram-FGHM5R23.D9oElkvo.js} +1 -1
- package/dist/docs/assets/chunks/{stateDiagram-FHFEXIEX.C4vGu8zq.js → stateDiagram-FHFEXIEX.IPksnixH.js} +1 -1
- package/dist/docs/assets/chunks/stateDiagram-v2-QKLJ7IA2.CbhzVsQE.js +1 -0
- package/dist/docs/assets/chunks/{theme.DMj_7q3B.js → theme.CgKu7tr3.js} +2 -2
- package/dist/docs/assets/chunks/{timeline-definition-GMOUNBTQ.C7LgNVAL.js → timeline-definition-GMOUNBTQ.CuAtJapY.js} +1 -1
- package/dist/docs/assets/chunks/{vennDiagram-DHZGUBPP.HUwoZcy_.js → vennDiagram-DHZGUBPP.B87nNW9E.js} +1 -1
- package/dist/docs/assets/chunks/wardley-RL74JXVD.BFIVMaoi.js +162 -0
- package/dist/docs/assets/chunks/{wardleyDiagram-NUSXRM2D.B2pSo5rB.js → wardleyDiagram-NUSXRM2D.BELjSq8w.js} +1 -1
- package/dist/docs/assets/chunks/{xychartDiagram-5P7HB3ND.NQhMiOOL.js → xychartDiagram-5P7HB3ND.5zN5ZGsz.js} +1 -1
- package/dist/docs/assets/{deployment.md.BtqJrHhp.js → deployment.md.DJtuDVLh.js} +3 -3
- package/dist/docs/assets/{deployment.md.BtqJrHhp.lean.js → deployment.md.DJtuDVLh.lean.js} +1 -1
- package/dist/docs/assets/{guides_agent-to-agent.md.BcmSqL2z.js → guides_agent-to-agent.md.DcB3nhOz.js} +1 -1
- package/dist/docs/assets/{guides_github.md.6jiEH7dg.js → guides_github.md.CcuZ7keS.js} +1 -1
- package/dist/docs/assets/{guides_mcp-oauth.md.C-Sx_IPa.js → guides_mcp-oauth.md.GVPMKcYl.js} +1 -1
- package/dist/docs/assets/{guides_migrate.md.BbhHYeCr.js → guides_migrate.md.B8CZxnnX.js} +1 -1
- package/dist/docs/assets/{guides_slack.md.BgIGG9ur.js → guides_slack.md.D7Rwyva4.js} +1 -1
- package/dist/docs/assets/{hillclimbing.md.3TkdF79A.js → hillclimbing.md.M51bF-oT.js} +1 -1
- package/dist/docs/assets/index.md.DnJPj_B6.js +14 -0
- package/dist/docs/assets/index.md.DnJPj_B6.lean.js +1 -0
- package/dist/docs/assets/{reference_agent-config.md.C0Tp_Fk9.js → reference_agent-config.md.Bbqf0lgS.js} +13 -5
- package/dist/docs/assets/{reference_agent-config.md.C0Tp_Fk9.lean.js → reference_agent-config.md.Bbqf0lgS.lean.js} +1 -1
- package/dist/docs/assets/{reference_cli.md.B8GdpaRj.js → reference_cli.md.DHm6DmYk.js} +2 -2
- package/dist/docs/assets/{reference_hooks.md.CSWmOwMM.js → reference_hooks.md.vbIM394-.js} +2 -2
- package/dist/docs/assets/{reference_hooks.md.CSWmOwMM.lean.js → reference_hooks.md.vbIM394-.lean.js} +1 -1
- package/dist/docs/assets/{reference_tools.md.B2OaR1Nb.js → reference_tools.md.BhqW6neF.js} +4 -2
- package/dist/docs/assets/{reference_tools.md.B2OaR1Nb.lean.js → reference_tools.md.BhqW6neF.lean.js} +1 -1
- package/dist/docs/building-with-agents.html +36 -36
- package/dist/docs/building-with-agents.md +3 -3
- package/dist/docs/changelog.html +36 -36
- package/dist/docs/changelog.md +44 -1
- package/dist/docs/deployment.html +37 -37
- package/dist/docs/deployment.md +22 -16
- package/dist/docs/evals.html +35 -35
- package/dist/docs/guides/agent-to-agent.html +37 -37
- package/dist/docs/guides/agent-to-agent.md +4 -2
- package/dist/docs/guides/bitbucket.html +35 -35
- package/dist/docs/guides/cloud-agents.html +35 -35
- package/dist/docs/guides/convert-automation.html +35 -35
- package/dist/docs/guides/github.html +37 -37
- package/dist/docs/guides/github.md +1 -1
- package/dist/docs/guides/gitlab.html +35 -35
- package/dist/docs/guides/improve.html +35 -35
- package/dist/docs/guides/jev.html +35 -35
- package/dist/docs/guides/mcp-oauth.html +37 -37
- package/dist/docs/guides/mcp-oauth.md +1 -1
- package/dist/docs/guides/migrate.html +37 -37
- package/dist/docs/guides/migrate.md +1 -1
- 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 +1 -1
- package/dist/docs/guides/webhooks.html +35 -35
- package/dist/docs/hashmap.json +1 -1
- package/dist/docs/hillclimbing.html +36 -36
- package/dist/docs/hillclimbing.md +1 -1
- package/dist/docs/index.html +42 -48
- package/dist/docs/index.md +8 -14
- package/dist/docs/llms-full.txt +176 -54
- package/dist/docs/quickstart.html +35 -35
- package/dist/docs/reference/access.html +35 -35
- package/dist/docs/reference/agent-config.html +47 -39
- package/dist/docs/reference/agent-config.md +75 -10
- package/dist/docs/reference/artifacts.html +35 -35
- package/dist/docs/reference/channels.html +35 -35
- package/dist/docs/reference/cli.html +38 -38
- package/dist/docs/reference/cli.md +2 -2
- package/dist/docs/reference/connections.html +35 -35
- package/dist/docs/reference/evals.html +35 -35
- package/dist/docs/reference/extensions.html +35 -35
- package/dist/docs/reference/hooks.html +37 -37
- package/dist/docs/reference/hooks.md +1 -1
- package/dist/docs/reference/http-api.html +35 -35
- package/dist/docs/reference/instructions.html +35 -35
- package/dist/docs/reference/limits.html +35 -35
- 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/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 +39 -37
- package/dist/docs/reference/tools.md +12 -0
- package/dist/docs/templates/agentic-owners.html +35 -35
- package/dist/docs/templates/reviews.html +35 -35
- package/dist/docs/troubleshooting.html +35 -35
- package/dist/filesystem.d.ts +12 -412
- package/dist/filesystem.d.ts.map +1 -1
- package/dist/filesystem.js +37 -980
- package/dist/index.d.ts +1 -3
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +1 -3
- package/dist/internal/authored-alias-hooks.d.ts +6 -0
- package/dist/internal/authored-alias-hooks.d.ts.map +1 -1
- package/dist/internal/authored-alias-hooks.js +12 -0
- package/dist/internal/authored-loaders.js +10 -1
- package/dist/internal/cli/commands/scaffold.js +1 -1
- package/dist/internal/continuation-channel.d.ts +3 -3
- package/dist/internal/continuation-channel.js +3 -3
- package/dist/internal/continuation-identity.d.ts +6 -5
- package/dist/internal/continuation-identity.d.ts.map +1 -1
- package/dist/internal/continuation-identity.js +17 -2
- package/dist/internal/continuation-session-ids.d.ts +15 -0
- package/dist/internal/continuation-session-ids.d.ts.map +1 -0
- package/dist/internal/continuation-session-ids.js +43 -0
- package/dist/internal/direct-file-tools.d.ts +21 -0
- package/dist/internal/direct-file-tools.d.ts.map +1 -0
- package/dist/internal/direct-file-tools.js +60 -0
- package/dist/internal/discovery/agent.d.ts.map +1 -1
- package/dist/internal/discovery/agent.js +71 -66
- package/dist/internal/filesystem/walk.d.ts +4 -56
- package/dist/internal/filesystem/walk.d.ts.map +1 -1
- package/dist/internal/filesystem/walk.js +4 -198
- package/dist/internal/hosted-catch-protocol.d.ts +3 -3
- package/dist/internal/hosted-catch-protocol.js +3 -3
- package/dist/internal/hosted-fetch.d.ts +7 -0
- package/dist/internal/hosted-fetch.d.ts.map +1 -0
- package/dist/internal/hosted-fetch.js +26 -0
- package/dist/internal/hosted-managed-automation.js +1 -1
- package/dist/internal/install-cursor-skills.d.ts +5 -6
- package/dist/internal/install-cursor-skills.d.ts.map +1 -1
- package/dist/internal/install-cursor-skills.js +19 -4
- package/dist/internal/mcp-endpoint.js +4 -4
- package/dist/internal/model-config.d.ts.map +1 -1
- package/dist/internal/model-config.js +11 -4
- package/dist/internal/otel/http.d.ts +2 -1
- package/dist/internal/otel/http.d.ts.map +1 -1
- package/dist/internal/otel/http.js +2 -3
- package/dist/internal/platform-timers.d.ts +3 -7
- package/dist/internal/platform-timers.d.ts.map +1 -1
- package/dist/internal/platform-timers.js +10 -51
- package/dist/internal/sdk-runner.d.ts.map +1 -1
- package/dist/internal/sdk-runner.js +22 -40
- package/dist/internal/server.d.ts.map +1 -1
- package/dist/internal/server.js +6 -1
- package/dist/internal/session-engine.d.ts +36 -19
- package/dist/internal/session-engine.d.ts.map +1 -1
- package/dist/internal/session-engine.js +182 -254
- package/dist/internal/tool-paths.d.ts +8 -0
- package/dist/internal/tool-paths.d.ts.map +1 -0
- package/dist/internal/tool-paths.js +12 -0
- package/dist/internal/workspace-tree.d.ts +27 -0
- package/dist/internal/workspace-tree.d.ts.map +1 -0
- package/dist/internal/workspace-tree.js +106 -0
- package/dist/playground/assets/index-D0-FHg1x.css +1 -0
- package/dist/playground/assets/index-D5SLKUy6.js +62 -0
- package/dist/playground/index.html +2 -2
- package/dist/types.d.ts +43 -23
- package/dist/types.d.ts.map +1 -1
- package/dist/types.js +2 -2
- package/docs/README.md +8 -14
- package/docs/building-with-agents.md +3 -3
- package/docs/changelog.md +44 -1
- package/docs/deployment.md +22 -16
- package/docs/guides/agent-to-agent.md +4 -2
- package/docs/guides/github.md +1 -1
- package/docs/guides/mcp-oauth.md +1 -1
- package/docs/guides/migrate.md +1 -1
- package/docs/guides/slack.md +1 -1
- package/docs/hillclimbing.md +1 -1
- package/docs/reference/agent-config.md +75 -10
- package/docs/reference/cli.md +2 -2
- package/docs/reference/hooks.md +1 -1
- package/docs/reference/tools.md +12 -0
- package/package.json +10 -15
- package/skills/cli/SKILL.md +1 -1
- package/skills/create-agent/SKILL.md +61 -7
- package/skills/debug/SKILL.md +1 -1
- package/skills/deploy/SKILL.md +3 -3
- package/skills/evals/SKILL.md +1 -1
- package/skills/framework-map/SKILL.md +2 -2
- package/skills/github/SKILL.md +1 -1
- package/skills/hillclimb/SKILL.md +1 -1
- package/skills/mcp-auth/SKILL.md +1 -1
- package/skills/migrate-v2/SKILL.md +2 -2
- package/skills/otel/SKILL.md +1 -1
- package/skills/setup-slack/SKILL.md +2 -2
- package/dist/docs/assets/changelog.md.BWhC6DET.js +0 -1
- package/dist/docs/assets/changelog.md.BWhC6DET.lean.js +0 -1
- package/dist/docs/assets/chunks/@localSearchIndexroot.CWxwVoCG.js +0 -1
- package/dist/docs/assets/chunks/channel.Cctv0f7X.js +0 -1
- package/dist/docs/assets/chunks/classDiagram-6PBFFD2Q.DU5sqchW.js +0 -1
- package/dist/docs/assets/chunks/classDiagram-v2-HSJHXN6E.DU5sqchW.js +0 -1
- package/dist/docs/assets/chunks/clone.B9rdNt6j.js +0 -1
- package/dist/docs/assets/chunks/stateDiagram-v2-QKLJ7IA2.ECMu2BdJ.js +0 -1
- package/dist/docs/assets/chunks/wardley-RL74JXVD.BxFEFYZS.js +0 -162
- package/dist/docs/assets/index.md.DRfaoRCZ.js +0 -20
- package/dist/docs/assets/index.md.DRfaoRCZ.lean.js +0 -1
- package/dist/executors.d.ts +0 -11
- package/dist/executors.d.ts.map +0 -1
- package/dist/executors.js +0 -21
- package/dist/internal/filesystem/errors.d.ts +0 -64
- package/dist/internal/filesystem/errors.d.ts.map +0 -1
- package/dist/internal/filesystem/errors.js +0 -180
- package/dist/internal/filesystem/format.d.ts +0 -28
- package/dist/internal/filesystem/format.d.ts.map +0 -1
- package/dist/internal/filesystem/format.js +0 -209
- package/dist/internal/filesystem/merge.d.ts +0 -34
- package/dist/internal/filesystem/merge.d.ts.map +0 -1
- package/dist/internal/filesystem/merge.js +0 -154
- package/dist/internal/filesystem/nearest.d.ts +0 -15
- package/dist/internal/filesystem/nearest.d.ts.map +0 -1
- package/dist/internal/filesystem/nearest.js +0 -90
- package/dist/internal/filesystem/scratch.d.ts +0 -60
- package/dist/internal/filesystem/scratch.d.ts.map +0 -1
- package/dist/internal/filesystem/scratch.js +0 -187
- package/dist/internal/filesystem/sdk-schemas.d.ts +0 -29
- package/dist/internal/filesystem/sdk-schemas.d.ts.map +0 -1
- package/dist/internal/filesystem/sdk-schemas.js +0 -148
- package/dist/internal/filesystem/subagent-inherit.d.ts +0 -39
- package/dist/internal/filesystem/subagent-inherit.d.ts.map +0 -1
- package/dist/internal/filesystem/subagent-inherit.js +0 -96
- package/dist/internal/filesystem/tools.d.ts +0 -59
- package/dist/internal/filesystem/tools.d.ts.map +0 -1
- package/dist/internal/filesystem/tools.js +0 -634
- package/dist/internal/otel/propagation.d.ts +0 -7
- package/dist/internal/otel/propagation.d.ts.map +0 -1
- package/dist/internal/otel/propagation.js +0 -15
- package/dist/internal/sdk-subagent-inherit-support.d.ts +0 -9
- package/dist/internal/sdk-subagent-inherit-support.d.ts.map +0 -1
- package/dist/internal/sdk-subagent-inherit-support.js +0 -90
- package/dist/playground/assets/index-D6mVn9og.js +0 -62
- package/dist/playground/assets/index-DlALM6gr.css +0 -1
- /package/dist/docs/assets/{building-with-agents.md.BqJ7AAjG.lean.js → building-with-agents.md.Bo3ct-rf.lean.js} +0 -0
- /package/dist/docs/assets/{guides_agent-to-agent.md.BcmSqL2z.lean.js → guides_agent-to-agent.md.DcB3nhOz.lean.js} +0 -0
- /package/dist/docs/assets/{guides_github.md.6jiEH7dg.lean.js → guides_github.md.CcuZ7keS.lean.js} +0 -0
- /package/dist/docs/assets/{guides_mcp-oauth.md.C-Sx_IPa.lean.js → guides_mcp-oauth.md.GVPMKcYl.lean.js} +0 -0
- /package/dist/docs/assets/{guides_migrate.md.BbhHYeCr.lean.js → guides_migrate.md.B8CZxnnX.lean.js} +0 -0
- /package/dist/docs/assets/{guides_slack.md.BgIGG9ur.lean.js → guides_slack.md.D7Rwyva4.lean.js} +0 -0
- /package/dist/docs/assets/{hillclimbing.md.3TkdF79A.lean.js → hillclimbing.md.M51bF-oT.lean.js} +0 -0
- /package/dist/docs/assets/{reference_cli.md.B8GdpaRj.lean.js → reference_cli.md.DHm6DmYk.lean.js} +0 -0
package/docs/guides/migrate.md
CHANGED
|
@@ -48,7 +48,7 @@ agent-sdk migrate --dir .
|
|
|
48
48
|
To migrate a pushed source outside your checkout, pass `--repo`, `--ref`, and
|
|
49
49
|
`--path`. The [CLI reference](../reference/cli.md#migrate) lists every flag.
|
|
50
50
|
|
|
51
|
-
You can also ask a coding agent in your checkout to follow the bundled `
|
|
51
|
+
You can also ask a coding agent in your checkout to follow the bundled `agent-sdk-migrate-v2` skill. If the project
|
|
52
52
|
relies on a v1 capability that has no v2 path, the agent stops and names the
|
|
53
53
|
blocker.
|
|
54
54
|
|
package/docs/guides/slack.md
CHANGED
|
@@ -253,4 +253,4 @@ The person who runs `slack create` grants Cursor three user scopes on their own
|
|
|
253
253
|
create and install the app, and `botScopes` doesn't change them.
|
|
254
254
|
|
|
255
255
|
If you already own the Slack app, run `agent-sdk slack init --manual --dir . --name "Triage"` and
|
|
256
|
-
follow the `
|
|
256
|
+
follow the `agent-sdk-setup-slack` skill for installation and tokens.
|
package/docs/hillclimbing.md
CHANGED
|
@@ -8,7 +8,7 @@ description: "Iteratively improve agent behavior with evals"
|
|
|
8
8
|
Hillclimbing improves an agent one measured change at a time. Hold the inputs fixed, change one
|
|
9
9
|
thing, and keep it only when the same run gets better without moving the behavior you froze.
|
|
10
10
|
|
|
11
|
-
A coding agent in your checkout can run this loop by following the `
|
|
11
|
+
A coding agent in your checkout can run this loop by following the `agent-sdk-hillclimb` skill.
|
|
12
12
|
|
|
13
13
|
## Run one measured round
|
|
14
14
|
|
|
@@ -14,9 +14,9 @@ import { defineAgent } from "@grok/agent-sdk";
|
|
|
14
14
|
|
|
15
15
|
export default defineAgent({
|
|
16
16
|
model: {
|
|
17
|
-
id: "grok-4.
|
|
17
|
+
id: "grok-4.7",
|
|
18
18
|
params: [
|
|
19
|
-
{ id: "
|
|
19
|
+
{ id: "reasoning_effort", value: "high" },
|
|
20
20
|
{ id: "fast", value: "true" },
|
|
21
21
|
],
|
|
22
22
|
}, // optional; this is the default
|
|
@@ -27,7 +27,7 @@ export default defineAgent({
|
|
|
27
27
|
|
|
28
28
|
| Field | Type | Meaning |
|
|
29
29
|
| --- | --- | --- |
|
|
30
|
-
| `model` | string or `{ id, params }` | Cursor model for turns. Defaults to `grok-4.
|
|
30
|
+
| `model` | string or `{ id, params }` | Cursor model for turns. Defaults to `grok-4.7` with `reasoning_effort=high` and `fast=true`. Subagents omit it to inherit. |
|
|
31
31
|
| `name` | string | Display name. Defaults to the package or directory name. |
|
|
32
32
|
| `description` | string | What the agent is for. Required on subagents, where the parent model reads it to decide when to delegate. |
|
|
33
33
|
| `instructions` | string | Inline instructions for subagents and generated configs. Prefer `instructions.md`. |
|
|
@@ -37,15 +37,15 @@ export default defineAgent({
|
|
|
37
37
|
| `builtinTools` | `{ reminders? }` | Opt-in tools that Agent SDK provides. See [Built-in tools](#built-in-tools). |
|
|
38
38
|
| `tools` | `ToolName[]` | Allowlist of built-in tools. Omit it for the full standard toolset. See [Harness tools](#harness-tools). |
|
|
39
39
|
| `fs` | `FileSystem` or `(ctx) => FileSystem` | Custom file tree for the session. `root` is the deprecated name. See [Custom filesystem](#custom-filesystem). |
|
|
40
|
+
| `workspace` | string | With `fs`, the folder inside the tree the agent works in, and where project rules load from. Defaults to `/`. For a sandboxed agent without shell, where its session workspace is mounted, `/workspace` by default. |
|
|
40
41
|
| `skills` | `false` or `(ctx) => FileSystem` | Replaces the skills tree mounted at `/agent/skills`, or turns that mount off. |
|
|
41
42
|
|
|
42
43
|
The `persistent` field was removed. Discovery rejects a config that still sets it, and the error is `persistent was removed. Delete it from defineAgent.`, so `validate`, `dev`, and `deploy` fail until you delete the field. A deployment that is already running keeps serving until you stop or delete it.
|
|
43
44
|
|
|
44
45
|
## Model
|
|
45
46
|
|
|
46
|
-
|
|
47
|
-
|
|
48
|
-
string when you don't need any:
|
|
47
|
+
Set effort and speed with params, not in the id. Use the object form shown above
|
|
48
|
+
to set params, or a plain string when you don't need any:
|
|
49
49
|
|
|
50
50
|
```ts
|
|
51
51
|
model: "composer-2.5",
|
|
@@ -65,10 +65,34 @@ untrusted input, such as webhook payloads, PR diffs, or inbound chat. The
|
|
|
65
65
|
sandbox limits the tools themselves, so an injected prompt can't talk the model
|
|
66
66
|
past it.
|
|
67
67
|
|
|
68
|
-
|
|
69
|
-
|
|
70
|
-
|
|
71
|
-
|
|
68
|
+
With `local.sandbox` on, shell commands run without network access, writes and
|
|
69
|
+
deletes outside the session workspace are refused, and a tool call that needs
|
|
70
|
+
approval, such as an external MCP call, fails closed. What the agent can read
|
|
71
|
+
depends on its `tools`:
|
|
72
|
+
|
|
73
|
+
- **With shell** (or with `tools` omitted, which includes it), the agent runs on
|
|
74
|
+
the host disk. Shell commands and the file tools (`read`, `grep`, `glob`,
|
|
75
|
+
`ls`) can read any file the serve process can, including credentials on the
|
|
76
|
+
host.
|
|
77
|
+
- **With file tools and no shell**, such as `tools: ["read", "grep"]`, the agent
|
|
78
|
+
runs on its session workspace as a tree, mounted at `/workspace`. Set
|
|
79
|
+
[`workspace`](#custom-filesystem) to mount it elsewhere. Every file tool sees
|
|
80
|
+
only the workspace and refuses a path outside it, including through a
|
|
81
|
+
symlink. Running on a tree also turns off what only the host disk provides:
|
|
82
|
+
Cursor hooks don't run, so a Slack follow-up waits for the turn to end
|
|
83
|
+
instead of reaching the running turn; `.cursor/mcp.json` from the workspace
|
|
84
|
+
or an enclosing checkout isn't loaded (connections in `bot/` still are); host
|
|
85
|
+
git status doesn't reach the model; and skills are at `/agent/skills`
|
|
86
|
+
instead of `.cursor/skills`. `AGENTS.md` and `.cursor/rules/` in the
|
|
87
|
+
workspace still load. Tools a tree can't run, such as `readLints`, are left
|
|
88
|
+
out with a warning.
|
|
89
|
+
|
|
90
|
+
To keep an agent's reads inside a tree you choose, give it
|
|
91
|
+
[`fs`](#custom-filesystem) instead.
|
|
92
|
+
|
|
93
|
+
A [direct tool call](./tools.md#call-a-tool-without-a-model-turn) on a
|
|
94
|
+
host-disk agent refuses a path outside the session workspace, after symlinks,
|
|
95
|
+
with `Path is outside the workspace`, whether or not `local.sandbox` is on.
|
|
72
96
|
|
|
73
97
|
### Local cwd
|
|
74
98
|
|
|
@@ -85,8 +109,49 @@ at a checkout only when the agent should inherit that tree.
|
|
|
85
109
|
|
|
86
110
|
## Custom filesystem
|
|
87
111
|
|
|
112
|
+
Set `fs` and the agent's file tools (Read, Write, StrReplace, LS, Grep, Glob,
|
|
113
|
+
Delete) and its subagents work on your tree instead of the host disk. Build it
|
|
114
|
+
with `tempFs`, `unionFs`, `overlayFs`, `readOnlyFs`, or your own `FileSystem`.
|
|
115
|
+
|
|
116
|
+
```ts
|
|
117
|
+
import { defineAgent, readOnlyFs, tempFs, unionFs } from "@grok/agent-sdk";
|
|
118
|
+
|
|
119
|
+
export default defineAgent({
|
|
120
|
+
fs: unionFs({
|
|
121
|
+
"/repo": readOnlyFs(repoFs),
|
|
122
|
+
"/notes": tempFs({ "/todo.md": "- check the rollout" }),
|
|
123
|
+
}),
|
|
124
|
+
workspace: "/repo",
|
|
125
|
+
});
|
|
126
|
+
```
|
|
127
|
+
|
|
88
128
|
`fs` is mounted at `/`, and Agent SDK mounts `/tmp` and `/agent/skills` over it. Set `fs` or the deprecated `root`, not both. A tree that already has `/agent/skills` fails session start unless `skills` is `false`.
|
|
89
129
|
|
|
130
|
+
Each turn gets an empty `/tmp`, and large web results land there. Write anything
|
|
131
|
+
the next turn needs elsewhere in the tree. Subagents work on the same tree, so
|
|
132
|
+
their writes are visible to the agent right away, as subagents share the host
|
|
133
|
+
workspace without `fs`.
|
|
134
|
+
|
|
135
|
+
`workspace` is the folder the model works in. Relative paths resolve against
|
|
136
|
+
it, and LS, Grep, and Glob search it when a call names no path. It must be an
|
|
137
|
+
absolute path outside `/tmp`, and defaults to `/`.
|
|
138
|
+
|
|
139
|
+
As on the host, the workspace's `AGENTS.md` and `.cursor/rules/` load as
|
|
140
|
+
project rules. Don't make a checkout you don't trust, such as a pull request
|
|
141
|
+
under review, the workspace. Mount it beside the workspace instead, for example
|
|
142
|
+
at `/repo` with `workspace` left at `/`, where its rules don't load.
|
|
143
|
+
|
|
144
|
+
An `fs` agent has no shell, and listing `"shell"` in `tools` fails validation.
|
|
145
|
+
Tools a tree can't run, such as `readLints` or `computerUse`, are left out: an
|
|
146
|
+
omitted `tools` never includes them, and a `tools` list that names them gets a
|
|
147
|
+
warning. A `tools` list gets only the file tools it names. Omit `tools` to get
|
|
148
|
+
all of them. `fs` works on local turns only.
|
|
149
|
+
|
|
150
|
+
With `fs`, `local.sandbox` only affects approvals: a tool call that needs
|
|
151
|
+
approval, such as an external MCP call, fails closed, as it does without `fs`.
|
|
152
|
+
It changes nothing about file access, because the file tools already see only
|
|
153
|
+
the tree.
|
|
154
|
+
|
|
90
155
|
## Harness tools
|
|
91
156
|
|
|
92
157
|
Use `tools` to limit which built-in Cursor tools the model can call.
|
package/docs/reference/cli.md
CHANGED
|
@@ -316,7 +316,7 @@ agent-sdk migrate [--dir <path>] [--repo <https-url>] [--ref <git-ref>]
|
|
|
316
316
|
|
|
317
317
|
`migrate` applies only to projects that deployed with `architecture: "v1"`
|
|
318
318
|
during the early alpha. It starts a Cursor cloud agent on a pushed Git ref
|
|
319
|
-
with the bundled `
|
|
319
|
+
with the bundled `agent-sdk-migrate-v2` skill, and the agent opens a pull request
|
|
320
320
|
with the source changes. The command never deploys or changes secrets.
|
|
321
321
|
|
|
322
322
|
With nothing to change, it prints `Nothing to migrate.` and exits `0`, and it exits `1` if the run ends without a pull request. `deploy` refuses a project that sets `architecture: "v1"` and points to `migrate`. See [Migrate an early-alpha project](../guides/migrate.md).
|
|
@@ -328,7 +328,7 @@ agent-sdk skills install [--dry-run] [--json]
|
|
|
328
328
|
agent-sdk skills list [--json [--fields <a,b.c>]] [--limit <n>] [--page-token <token>]
|
|
329
329
|
```
|
|
330
330
|
|
|
331
|
-
Package installation copies the bundled skills, `skills install` replaces the installed copies and removes stale ones, and `skills list` prints each skill's bundled and installed versions. The `
|
|
331
|
+
Package installation copies the bundled skills, `skills install` replaces the installed copies and removes stale ones, and `skills list` prints each skill's bundled and installed versions. The `agent-sdk-cli` skill teaches agents to run `agent-sdk` safely.
|
|
332
332
|
|
|
333
333
|
### Inspect a project {#info}
|
|
334
334
|
|
package/docs/reference/hooks.md
CHANGED
|
@@ -71,7 +71,7 @@ Keys are event types from the [event vocabulary](./sessions.md#stream-events), o
|
|
|
71
71
|
| --- | --- |
|
|
72
72
|
| `message.received` | `{ text }` |
|
|
73
73
|
| `turn.completed` | `{ result?, usage?, cost? }`. `usage` has `inputTokens`, `outputTokens`, `cacheReadTokens`, `cacheWriteTokens`, and optional `reasoningTokens`. `cost` has `totalUsd` and the `model` it was priced against |
|
|
74
|
-
| `turn.failed` | `{ message, status? }`. `status` is `"error"` or `"cancelled"` when present |
|
|
74
|
+
| `turn.failed` | `{ message, status?, code? }`. `status` is `"error"` or `"cancelled"` when present. `code` is the runner's stable error code, such as a Cursor SDK `RunError.code`, when the failure supplied one |
|
|
75
75
|
| `actions.requested` | `{ calls: [{ callId, toolName, args?, parentCallId? }], parentCallId? }`. One envelope per model step. `parentCallId` marks subagent work |
|
|
76
76
|
| `actions.completed` | `{ results: [{ callId, toolName, output?, isError, stubbed?, parentCallId? }], parentCallId? }`. Emitted when every call in that batch has a result |
|
|
77
77
|
| `action.result` | `{ callId, toolName, output?, isError, stubbed?, parentCallId? }`. Live per-call envelope. `stubbed` means a dry-run session answered a write without running it |
|
package/docs/reference/tools.md
CHANGED
|
@@ -198,6 +198,18 @@ agent-sdk tool call inspect_pr --dir . \
|
|
|
198
198
|
--input '{"prUrl":"https://github.com/acme/checkout/pull/42"}'
|
|
199
199
|
```
|
|
200
200
|
|
|
201
|
+
The built-in file tools run the same way: `Read`, `Write`, `StrReplace`,
|
|
202
|
+
`LS`, `Grep`, `Glob`, and `Delete`, on the agent's `fs` tree or on the
|
|
203
|
+
session workspace. Your `tools` allowlist applies, and the result is the
|
|
204
|
+
tool's own result, the same one a turn's tool-call event carries. A read
|
|
205
|
+
returns `{ "status": "success", "value": { "content": "…" } }`.
|
|
206
|
+
|
|
207
|
+
```bash
|
|
208
|
+
curl -X POST http://127.0.0.1:3000/<slug>/v1/tools/Read \
|
|
209
|
+
-H 'content-type: application/json' \
|
|
210
|
+
-d '{"input":{"path":"README.md"},"sessionId":"<session>"}'
|
|
211
|
+
```
|
|
212
|
+
|
|
201
213
|
Programmatically, `callTool(toolName, input, options?)` is available on
|
|
202
214
|
the serve handle, on channel route handlers and `onStart` args, and on
|
|
203
215
|
schedule `run` handlers, so a channel can mix deterministic calls with
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@grok/agent-sdk",
|
|
3
|
-
"version": "0.
|
|
3
|
+
"version": "0.5.0",
|
|
4
4
|
"description": "Build, test, and deploy agents as code on Cursor's agent harness.",
|
|
5
5
|
"license": "SEE LICENSE IN LICENSE.md",
|
|
6
6
|
"repository": {
|
|
@@ -29,7 +29,6 @@
|
|
|
29
29
|
"!dist/internal/tenant-mcp/**",
|
|
30
30
|
"!dist/internal/tenant-slack/**",
|
|
31
31
|
"!dist/internal/review-comments*",
|
|
32
|
-
"!dist/filesystem-executors.*",
|
|
33
32
|
"skills/**/*",
|
|
34
33
|
"templates/**/*",
|
|
35
34
|
"!templates/pr-autofixer/README.md",
|
|
@@ -51,13 +50,6 @@
|
|
|
51
50
|
"import": "./dist/index.js",
|
|
52
51
|
"default": "./dist/index.js"
|
|
53
52
|
},
|
|
54
|
-
"./executors": {
|
|
55
|
-
"anysphere-source": "./src/filesystem-executors.ts",
|
|
56
|
-
"bun": "./dist/executors.js",
|
|
57
|
-
"types": "./dist/executors.d.ts",
|
|
58
|
-
"import": "./dist/executors.js",
|
|
59
|
-
"default": "./dist/executors.js"
|
|
60
|
-
},
|
|
61
53
|
"./internal/hosted": {
|
|
62
54
|
"anysphere-source": "./src/internal/hosted/index.ts",
|
|
63
55
|
"types": "./src/internal/hosted/index.ts",
|
|
@@ -122,6 +114,13 @@
|
|
|
122
114
|
"import": "./dist/channels/runs/index.js",
|
|
123
115
|
"default": "./dist/channels/runs/index.js"
|
|
124
116
|
},
|
|
117
|
+
"./channels/match-ready": {
|
|
118
|
+
"anysphere-source": "./src/channels/match-ready/index.ts",
|
|
119
|
+
"bun": "./dist/channels/match-ready/index.js",
|
|
120
|
+
"types": "./dist/channels/match-ready/index.d.ts",
|
|
121
|
+
"import": "./dist/channels/match-ready/index.js",
|
|
122
|
+
"default": "./dist/channels/match-ready/index.js"
|
|
123
|
+
},
|
|
125
124
|
"./channels/bitbucket": {
|
|
126
125
|
"anysphere-source": "./src/channels/bitbucket/index.ts",
|
|
127
126
|
"types": "./dist/channels/bitbucket/index.d.ts",
|
|
@@ -281,7 +280,7 @@
|
|
|
281
280
|
},
|
|
282
281
|
"dependencies": {
|
|
283
282
|
"@bazel/runfiles": "6.5.0",
|
|
284
|
-
"@cursor/sdk": "1.0
|
|
283
|
+
"@cursor/sdk": "1.2.0",
|
|
285
284
|
"@modelcontextprotocol/sdk": "^1.32.1",
|
|
286
285
|
"@octokit/auth-app": "^7.2.0",
|
|
287
286
|
"@octokit/rest": "^21.1.1",
|
|
@@ -319,11 +318,7 @@
|
|
|
319
318
|
"zod": "^3.25.0 || ^4.0.0"
|
|
320
319
|
},
|
|
321
320
|
"devDependencies": {
|
|
322
|
-
"@anysphere/agent-exec": "1.0.0",
|
|
323
321
|
"@anysphere/agent-store-sync": "1.0.0",
|
|
324
|
-
"@anysphere/context": "1.0.0",
|
|
325
|
-
"@anysphere/cursor-sdk-shared": "1.0.0",
|
|
326
|
-
"@anysphere/proto": "1.0.0",
|
|
327
322
|
"@anysphere/ui": "1.0.0",
|
|
328
323
|
"@braintree/sanitize-url": "7.1.2",
|
|
329
324
|
"@microsoft/api-extractor": "7.59.4",
|
|
@@ -356,7 +351,7 @@
|
|
|
356
351
|
"vitepress-plugin-mermaid": "^2.0.17",
|
|
357
352
|
"vitest": "5.0.3",
|
|
358
353
|
"yaml": "^2.4.2",
|
|
359
|
-
"zod": "4.6.
|
|
354
|
+
"zod": "4.6.7",
|
|
360
355
|
"zustand": "^5.0.9"
|
|
361
356
|
},
|
|
362
357
|
"scripts": {
|
package/skills/cli/SKILL.md
CHANGED
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
---
|
|
2
|
-
name:
|
|
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. **
|
|
12
|
-
|
|
13
|
-
|
|
14
|
-
|
|
15
|
-
|
|
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.
|
|
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
|
package/skills/debug/SKILL.md
CHANGED
package/skills/deploy/SKILL.md
CHANGED
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
---
|
|
2
|
-
name:
|
|
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 `
|
|
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.
|
|
42
|
+
BDK_VERSION="0.5.0"
|
|
43
43
|
BDK_PACKAGE="@grok/agent-sdk"
|
|
44
44
|
case "$BDK_VERSION" in
|
|
45
45
|
__BDK_V*)
|
package/skills/evals/SKILL.md
CHANGED
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
---
|
|
2
|
-
name:
|
|
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 `
|
|
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
|
package/skills/github/SKILL.md
CHANGED
package/skills/mcp-auth/SKILL.md
CHANGED
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
---
|
|
2
|
-
name:
|
|
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 `
|
|
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
|
package/skills/otel/SKILL.md
CHANGED
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
---
|
|
2
|
-
name:
|
|
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 "Changelog""></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 "0.3.0 (2026-10-23)""></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 "0.2.29 (2026-10-23)""></a></h2><ul><li>Bug Fixes</li></ul>',5)])])}const u=a(n,[["render",r]]);export{_ as __pageData,u as default};
|
|
@@ -1 +0,0 @@
|
|
|
1
|
-
import{_ as a,c as o,o as t,a3 as l}from"./chunks/framework.BNw1pucY.js";const _=JSON.parse('{"title":"Changelog","description":"Changelog for @grok/agent-sdk releases.","frontmatter":{"title":"Changelog","description":"Changelog for @grok/agent-sdk releases."},"headers":[],"relativePath":"changelog.md","filePath":"changelog.md"}'),n={name:"changelog.md"};function r(i,e,s,g,c,d){return t(),o("div",null,[...e[0]||(e[0]=[l("",5)])])}const u=a(n,[["render",r]]);export{_ as __pageData,u as default};
|