@grok/agent-sdk 0.2.27 → 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 +42 -37
- package/CHANGELOG.md +1 -1
- package/README.md +15 -17
- package/dist/agent-v2-hosting.d.ts +13 -0
- package/dist/agent-v2-hosting.d.ts.map +1 -0
- package/dist/agent-v2-hosting.js +8 -0
- package/dist/artifacts.d.ts +1 -1
- package/dist/artifacts.js +1 -1
- package/dist/bin/agent-serve.d.ts +3 -15
- package/dist/bin/agent-serve.d.ts.map +1 -1
- package/dist/bin/agent-serve.js +30 -1628
- package/dist/channels/bitbucket/api.d.ts.map +1 -1
- package/dist/channels/bitbucket/api.js +3 -3
- package/dist/channels/bitbucket/binding.d.ts.map +1 -1
- package/dist/channels/bitbucket/binding.js +5 -5
- package/dist/channels/bitbucket/bitbucket-channel.d.ts.map +1 -1
- package/dist/channels/bitbucket/bitbucket-channel.js +1 -0
- package/dist/channels/bitbucket/bitbucket-webhook.d.ts.map +1 -1
- package/dist/channels/bitbucket/bitbucket-webhook.js +9 -6
- package/dist/channels/bitbucket/checks.d.ts.map +1 -1
- package/dist/channels/bitbucket/checks.js +4 -0
- package/dist/channels/bitbucket/events.d.ts.map +1 -1
- package/dist/channels/bitbucket/index.d.ts +1 -1
- package/dist/channels/bitbucket/index.js +1 -1
- package/dist/channels/bitbucket/replay.d.ts.map +1 -1
- package/dist/channels/bitbucket/replay.js +4 -3
- package/dist/channels/change-monitors/change-monitors-channel.d.ts.map +1 -1
- package/dist/channels/change-monitors/change-monitors-channel.js +15 -2
- package/dist/channels/change-monitors/claim.d.ts +5 -0
- package/dist/channels/change-monitors/claim.d.ts.map +1 -0
- package/dist/channels/change-monitors/claim.js +6 -0
- package/dist/channels/change-monitors/index.d.ts +1 -0
- package/dist/channels/change-monitors/index.d.ts.map +1 -1
- package/dist/channels/change-monitors/index.js +1 -0
- package/dist/channels/change-monitors/types.d.ts.map +1 -1
- package/dist/channels/deployments/deployments-channel.d.ts +1 -1
- package/dist/channels/deployments/deployments-channel.js +1 -1
- package/dist/channels/deployments/index.d.ts +1 -1
- package/dist/channels/deployments/index.js +1 -1
- package/dist/channels/deployments/types.d.ts.map +1 -1
- package/dist/channels/github/api.d.ts +11 -0
- package/dist/channels/github/api.d.ts.map +1 -1
- package/dist/channels/github/api.js +29 -4
- package/dist/channels/github/binding.d.ts +5 -3
- package/dist/channels/github/binding.d.ts.map +1 -1
- package/dist/channels/github/binding.js +16 -9
- package/dist/channels/github/github-channel.d.ts +7 -2
- package/dist/channels/github/github-channel.d.ts.map +1 -1
- package/dist/channels/github/github-channel.js +20 -11
- package/dist/channels/github/index.d.ts +1 -1
- package/dist/channels/github/index.js +1 -1
- package/dist/channels/github/progress.d.ts.map +1 -1
- package/dist/channels/github/progress.js +4 -0
- package/dist/channels/github/state.d.ts +2 -2
- package/dist/channels/github/state.d.ts.map +1 -1
- package/dist/channels/github/types.d.ts +7 -7
- package/dist/channels/github/types.d.ts.map +1 -1
- package/dist/channels/gitlab/api.d.ts +2 -2
- package/dist/channels/gitlab/api.d.ts.map +1 -1
- package/dist/channels/gitlab/api.js +25 -14
- package/dist/channels/gitlab/binding.d.ts.map +1 -1
- package/dist/channels/gitlab/binding.js +2 -3
- package/dist/channels/gitlab/checks.d.ts.map +1 -1
- package/dist/channels/gitlab/checks.js +4 -0
- package/dist/channels/gitlab/events.d.ts.map +1 -1
- package/dist/channels/gitlab/gitlab-channel.d.ts.map +1 -1
- package/dist/channels/gitlab/gitlab-channel.js +4 -7
- package/dist/channels/gitlab/gitlab-webhook.d.ts.map +1 -1
- package/dist/channels/gitlab/gitlab-webhook.js +11 -8
- package/dist/channels/gitlab/index.d.ts +1 -1
- package/dist/channels/gitlab/index.js +1 -1
- package/dist/channels/gitlab/replay.d.ts.map +1 -1
- package/dist/channels/gitlab/replay.js +2 -0
- package/dist/channels/gitlab/types.d.ts.map +1 -1
- package/dist/channels/issues/claim.d.ts +5 -0
- package/dist/channels/issues/claim.d.ts.map +1 -0
- package/dist/channels/issues/claim.js +6 -0
- package/dist/channels/issues/index.d.ts +1 -0
- package/dist/channels/issues/index.d.ts.map +1 -1
- package/dist/channels/issues/index.js +1 -0
- package/dist/channels/issues/issues-channel.d.ts.map +1 -1
- package/dist/channels/issues/issues-channel.js +16 -3
- package/dist/channels/issues/types.d.ts +2 -2
- package/dist/channels/issues/types.d.ts.map +1 -1
- package/dist/channels/origin/api.d.ts.map +1 -1
- package/dist/channels/origin/api.js +3 -3
- package/dist/channels/origin/index.d.ts +1 -1
- package/dist/channels/origin/index.js +1 -1
- package/dist/channels/origin/origin-channel.d.ts.map +1 -1
- package/dist/channels/origin/origin-channel.js +6 -6
- package/dist/channels/origin/origin-webhook.d.ts.map +1 -1
- package/dist/channels/origin/origin-webhook.js +2 -5
- package/dist/channels/pagerduty/api.d.ts.map +1 -1
- package/dist/channels/pagerduty/api.js +2 -1
- package/dist/channels/pagerduty/index.d.ts +1 -1
- package/dist/channels/pagerduty/index.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 +2 -1
- package/dist/channels/pagerduty/pagerduty-webhook.d.ts.map +1 -1
- package/dist/channels/pagerduty/pagerduty-webhook.js +20 -11
- package/dist/channels/pagerduty/payload.d.ts.map +1 -1
- package/dist/channels/pagerduty/payload.js +2 -3
- package/dist/channels/pagerduty/replay.d.ts +1 -1
- package/dist/channels/pagerduty/replay.d.ts.map +1 -1
- package/dist/channels/pagerduty/replay.js +8 -5
- package/dist/channels/pagerduty/self-user.d.ts.map +1 -1
- package/dist/channels/pagerduty/self-user.js +8 -9
- package/dist/channels/runs/runs-channel.d.ts.map +1 -1
- package/dist/channels/runs/runs-channel.js +8 -2
- package/dist/channels/runs/types.d.ts +2 -2
- package/dist/channels/runs/types.d.ts.map +1 -1
- package/dist/channels/slack/agentic-delivery.d.ts +20 -1
- package/dist/channels/slack/agentic-delivery.d.ts.map +1 -1
- package/dist/channels/slack/agentic-delivery.js +77 -12
- package/dist/channels/slack/agentic-signals.d.ts +2 -0
- package/dist/channels/slack/agentic-signals.d.ts.map +1 -1
- package/dist/channels/slack/agentic-signals.js +24 -7
- package/dist/channels/slack/api.d.ts +1 -1
- package/dist/channels/slack/api.d.ts.map +1 -1
- package/dist/channels/slack/api.js +12 -13
- package/dist/channels/slack/approvals.d.ts.map +1 -1
- package/dist/channels/slack/approvals.js +5 -4
- package/dist/channels/slack/attachments.d.ts.map +1 -1
- package/dist/channels/slack/attachments.js +34 -9
- package/dist/channels/slack/auth.d.ts.map +1 -1
- package/dist/channels/slack/auth.js +3 -1
- package/dist/channels/slack/bot-mentions.d.ts.map +1 -1
- package/dist/channels/slack/bot-mentions.js +2 -4
- package/dist/channels/slack/cli-project.d.ts.map +1 -1
- package/dist/channels/slack/cli-project.js +7 -10
- package/dist/channels/slack/constants.d.ts +7 -0
- package/dist/channels/slack/constants.d.ts.map +1 -1
- package/dist/channels/slack/constants.js +7 -0
- package/dist/channels/slack/defaults.d.ts +12 -0
- package/dist/channels/slack/defaults.d.ts.map +1 -1
- package/dist/channels/slack/defaults.js +10 -2
- package/dist/channels/slack/dispatch.d.ts +7 -1
- package/dist/channels/slack/dispatch.d.ts.map +1 -1
- package/dist/channels/slack/dispatch.js +88 -13
- package/dist/channels/slack/doctor.d.ts.map +1 -1
- package/dist/channels/slack/doctor.js +11 -11
- package/dist/channels/slack/inbound.d.ts +7 -0
- package/dist/channels/slack/inbound.d.ts.map +1 -1
- package/dist/channels/slack/inbound.js +25 -4
- package/dist/channels/slack/index.d.ts +2 -2
- package/dist/channels/slack/index.d.ts.map +1 -1
- package/dist/channels/slack/index.js +2 -2
- package/dist/channels/slack/init.d.ts +2 -0
- package/dist/channels/slack/init.d.ts.map +1 -1
- package/dist/channels/slack/init.js +10 -2
- package/dist/channels/slack/interactive.d.ts +6 -1
- package/dist/channels/slack/interactive.d.ts.map +1 -1
- package/dist/channels/slack/interactive.js +15 -25
- package/dist/channels/slack/manifest.d.ts.map +1 -1
- package/dist/channels/slack/manifest.js +15 -12
- package/dist/channels/slack/message-body.d.ts.map +1 -1
- package/dist/channels/slack/message-body.js +2 -4
- package/dist/channels/slack/nudge-carrier.d.ts.map +1 -1
- package/dist/channels/slack/nudge-carrier.js +27 -1
- package/dist/channels/slack/nudge-store.d.ts.map +1 -1
- package/dist/channels/slack/nudge-store.js +8 -3
- package/dist/channels/slack/placeholder.d.ts +3 -0
- package/dist/channels/slack/placeholder.d.ts.map +1 -1
- package/dist/channels/slack/placeholder.js +6 -5
- package/dist/channels/slack/recording-sink.d.ts.map +1 -1
- package/dist/channels/slack/recording-sink.js +4 -3
- package/dist/channels/slack/sender-name.d.ts.map +1 -1
- package/dist/channels/slack/sender-name.js +2 -3
- package/dist/channels/slack/slack-channel.d.ts +1 -3
- package/dist/channels/slack/slack-channel.d.ts.map +1 -1
- package/dist/channels/slack/slack-channel.js +63 -86
- package/dist/channels/slack/thread-context.d.ts.map +1 -1
- package/dist/channels/slack/thread-context.js +4 -9
- package/dist/channels/slack/tool-cards.d.ts.map +1 -1
- package/dist/channels/slack/tool-cards.js +4 -0
- package/dist/channels/slack/types.d.ts +19 -4
- package/dist/channels/slack/types.d.ts.map +1 -1
- package/dist/channels/slack/upload.d.ts +2 -0
- package/dist/channels/slack/upload.d.ts.map +1 -1
- package/dist/channels/slack/upload.js +49 -12
- package/dist/channels/slack/user-info.d.ts.map +1 -1
- package/dist/channels/slack/user-info.js +3 -6
- package/dist/channels.d.ts +11 -11
- package/dist/channels.d.ts.map +1 -1
- package/dist/channels.js +57 -30
- package/dist/connections.d.ts +1 -1
- package/dist/connections.js +1 -1
- package/dist/docs/404.html +4 -4
- package/dist/docs/architecture.svg +1 -1
- package/dist/docs/assets/{app.wA5xBBcd.js → app.DMrZKFjI.js} +4 -4
- package/dist/docs/assets/building-with-agents.md.Bf1yH2tG.js +9 -0
- package/dist/docs/assets/building-with-agents.md.Bf1yH2tG.lean.js +1 -0
- 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.C29HLCVL.js → VPLocalSearchBox.DQvuw1KA.js} +1 -1
- package/dist/docs/assets/chunks/{arc.BOaoYWmh.js → arc.ahOG-Qza.js} +1 -1
- package/dist/docs/assets/chunks/{architectureDiagram-Q4EWVU46.MfG0itQh.js → architectureDiagram-Q4EWVU46.BcgfYNO_.js} +1 -1
- package/dist/docs/assets/chunks/{baseUniq.CUeJciCF.js → baseUniq.DeIYZrWh.js} +1 -1
- package/dist/docs/assets/chunks/{blockDiagram-DXYQGD6D.BrXMZRtK.js → blockDiagram-DXYQGD6D.HjJ2goMX.js} +1 -1
- package/dist/docs/assets/chunks/{c4Diagram-AHTNJAMY.DfkDHeB9.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.xKz8CiXK.js → chunk-4BX2VUAB.UuZiDiVp.js} +1 -1
- package/dist/docs/assets/chunks/{chunk-4TB4RGXK.kkfBh4zk.js → chunk-4TB4RGXK.5A3YmkhI.js} +1 -1
- package/dist/docs/assets/chunks/{chunk-55IACEB6.BClJGb94.js → chunk-55IACEB6.B4uf1yYV.js} +1 -1
- package/dist/docs/assets/chunks/{chunk-EDXVE4YY.P9BpQ9L3.js → chunk-EDXVE4YY.CoXBce8t.js} +1 -1
- package/dist/docs/assets/chunks/{chunk-FMBD7UC4.R4iYi58S.js → chunk-FMBD7UC4.DnC5NO4e.js} +1 -1
- package/dist/docs/assets/chunks/{chunk-OYMX7WX6.Cpn8L1dw.js → chunk-OYMX7WX6.CzfHCeIi.js} +1 -1
- package/dist/docs/assets/chunks/{chunk-QZHKN3VN.BLftECqU.js → chunk-QZHKN3VN.C6tcwkVd.js} +1 -1
- package/dist/docs/assets/chunks/{chunk-YZCP3GAM.BWDV1AYt.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.DGpAcJ55.js → cose-bilkent-S5V4N54A.BfPVKeId.js} +1 -1
- package/dist/docs/assets/chunks/{dagre-KV5264BT.BBXxGEaD.js → dagre-KV5264BT.CLMLc0lD.js} +1 -1
- package/dist/docs/assets/chunks/{diagram-5BDNPKRD.EKqOwmK2.js → diagram-5BDNPKRD.C7OF7UfH.js} +1 -1
- package/dist/docs/assets/chunks/{diagram-G4DWMVQ6.CB8pdkoZ.js → diagram-G4DWMVQ6.Dpao0Bl1.js} +1 -1
- package/dist/docs/assets/chunks/{diagram-MMDJMWI5.aHh4WGg9.js → diagram-MMDJMWI5.DLnM9eLp.js} +1 -1
- package/dist/docs/assets/chunks/{diagram-TYMM5635.YIsbRH20.js → diagram-TYMM5635.BcpVgA_M.js} +1 -1
- package/dist/docs/assets/chunks/{erDiagram-SMLLAGMA.B3bTCW_e.js → erDiagram-SMLLAGMA.CsL5JuCV.js} +1 -1
- package/dist/docs/assets/chunks/{flowDiagram-DWJPFMVM.M81hXIXZ.js → flowDiagram-DWJPFMVM.MFihq9AF.js} +1 -1
- package/dist/docs/assets/chunks/{ganttDiagram-T4ZO3ILL.BKg7WY--.js → ganttDiagram-T4ZO3ILL.CJeLodyG.js} +1 -1
- package/dist/docs/assets/chunks/{gitGraphDiagram-UUTBAWPF.CLEMZgO3.js → gitGraphDiagram-UUTBAWPF.1HhlE45Z.js} +1 -1
- package/dist/docs/assets/chunks/{graph.DS38W_Q-.js → graph.BS02KkWA.js} +1 -1
- package/dist/docs/assets/chunks/{infoDiagram-42DDH7IO.BTiWTi82.js → infoDiagram-42DDH7IO.fp5gvytQ.js} +1 -1
- package/dist/docs/assets/chunks/{ishikawaDiagram-UXIWVN3A.DcqY_KQL.js → ishikawaDiagram-UXIWVN3A.C6Wk1V4I.js} +1 -1
- package/dist/docs/assets/chunks/{journeyDiagram-VCZTEJTY.0lQNZ40U.js → journeyDiagram-VCZTEJTY.qJt4uJ_H.js} +1 -1
- package/dist/docs/assets/chunks/{kanban-definition-6JOO6SKY.L5sKlf7X.js → kanban-definition-6JOO6SKY.z2tG9kly.js} +1 -1
- package/dist/docs/assets/chunks/{layout.7u4gFhQa.js → layout.BPCkdejr.js} +1 -1
- package/dist/docs/assets/chunks/{linear.D5v33SOb.js → linear.CL3TC3u7.js} +1 -1
- package/dist/docs/assets/chunks/{min.Dc9uCxf9.js → min.SPrSp704.js} +1 -1
- package/dist/docs/assets/chunks/{mindmap-definition-QFDTVHPH.B56nGoB_.js → mindmap-definition-QFDTVHPH.DgrQRFZW.js} +1 -1
- package/dist/docs/assets/chunks/{pieDiagram-DEJITSTG.Cba8e8lS.js → pieDiagram-DEJITSTG.Ba7yxiW2.js} +1 -1
- package/dist/docs/assets/chunks/{quadrantDiagram-34T5L4WZ.2YjBycHF.js → quadrantDiagram-34T5L4WZ.Bvskad4p.js} +1 -1
- package/dist/docs/assets/chunks/{requirementDiagram-MS252O5E.D4P5RqVI.js → requirementDiagram-MS252O5E.Ce70ugV9.js} +1 -1
- package/dist/docs/assets/chunks/{sankeyDiagram-XADWPNL6.C0Hn8NUm.js → sankeyDiagram-XADWPNL6.BJ5OEULO.js} +1 -1
- package/dist/docs/assets/chunks/{sequenceDiagram-FGHM5R23.BZm7EaoT.js → sequenceDiagram-FGHM5R23.C8a1hDs6.js} +1 -1
- package/dist/docs/assets/chunks/{stateDiagram-FHFEXIEX.DcR4f3X2.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.DvfKzyXq.js → theme.DRciHmS1.js} +2 -2
- package/dist/docs/assets/chunks/{timeline-definition-GMOUNBTQ.CgDh96vg.js → timeline-definition-GMOUNBTQ.C4ePrY8-.js} +1 -1
- package/dist/docs/assets/chunks/{vennDiagram-DHZGUBPP.B4fagbC8.js → vennDiagram-DHZGUBPP.Dzso6dEA.js} +1 -1
- package/dist/docs/assets/chunks/{wardley-RL74JXVD.Ck68omim.js → wardley-RL74JXVD.djgXR0ar.js} +1 -1
- package/dist/docs/assets/chunks/{wardleyDiagram-NUSXRM2D.DBUg0bvz.js → wardleyDiagram-NUSXRM2D.Bf2ICxjh.js} +1 -1
- package/dist/docs/assets/chunks/{xychartDiagram-5P7HB3ND.DnKSGQE1.js → xychartDiagram-5P7HB3ND.DEH4BcVJ.js} +1 -1
- package/dist/docs/assets/deployment.md.KW0Ni_rY.js +31 -0
- package/dist/docs/assets/deployment.md.KW0Ni_rY.lean.js +1 -0
- package/dist/docs/assets/{evals.md.CHR34K1Y.js → evals.md.DiljU__Z.js} +10 -10
- package/dist/docs/assets/{guides_agent-to-agent.md.CwL5cwuE.js → guides_agent-to-agent.md.D1D5f6Jc.js} +7 -7
- package/dist/docs/assets/guides_agent-to-agent.md.D1D5f6Jc.lean.js +1 -0
- package/dist/docs/assets/{guides_bitbucket.md.CKUayYtD.js → guides_bitbucket.md.DkjkBRU8.js} +3 -3
- package/dist/docs/assets/guides_cloud-agents.md.Ceyjv0ul.js +9 -0
- package/dist/docs/assets/guides_cloud-agents.md.Ceyjv0ul.lean.js +1 -0
- package/dist/docs/assets/{guides_convert-automation.md.DMEX9nF-.js → guides_convert-automation.md.BjraCvok.js} +11 -11
- package/dist/docs/assets/guides_convert-automation.md.BjraCvok.lean.js +1 -0
- package/dist/docs/assets/{guides_github.md.TuNiZAOQ.js → guides_github.md.CgN5sNbW.js} +14 -14
- package/dist/docs/assets/{guides_github.md.TuNiZAOQ.lean.js → guides_github.md.CgN5sNbW.lean.js} +1 -1
- package/dist/docs/assets/{guides_gitlab.md.CtNI4fSH.js → guides_gitlab.md.DCE0p7_w.js} +3 -3
- package/dist/docs/assets/{guides_hooks.md.B2XfGX50.js → guides_hooks.md.BjeEiM7s.js} +4 -4
- package/dist/docs/assets/{guides_hooks.md.B2XfGX50.lean.js → guides_hooks.md.BjeEiM7s.lean.js} +1 -1
- package/dist/docs/assets/{guides_improve.md.CZKVt1cT.js → guides_improve.md.BFYtrtLE.js} +4 -4
- package/dist/docs/assets/{guides_improve.md.CZKVt1cT.lean.js → guides_improve.md.BFYtrtLE.lean.js} +1 -1
- package/dist/docs/assets/{guides_jev.md.D7XH4JH3.js → guides_jev.md.CEqLgjj9.js} +12 -12
- package/dist/docs/assets/{guides_jev.md.D7XH4JH3.lean.js → guides_jev.md.CEqLgjj9.lean.js} +1 -1
- package/dist/docs/assets/{guides_mcp-oauth.md.Cxq2TxBB.js → guides_mcp-oauth.md.DrGY92u4.js} +8 -8
- package/dist/docs/assets/{guides_mcp-oauth.md.Cxq2TxBB.lean.js → guides_mcp-oauth.md.DrGY92u4.lean.js} +1 -1
- package/dist/docs/assets/guides_migrate.md.RS9Eu-Xh.js +8 -0
- package/dist/docs/assets/guides_migrate.md.RS9Eu-Xh.lean.js +1 -0
- package/dist/docs/assets/guides_opentelemetry.md.CoZ1kNyd.js +28 -0
- package/dist/docs/assets/guides_opentelemetry.md.CoZ1kNyd.lean.js +1 -0
- package/dist/docs/assets/{guides_pagerduty.md.BHXMcMtx.js → guides_pagerduty.md.mnKXe9U0.js} +10 -10
- package/dist/docs/assets/{guides_slack.md.ClIyi7FI.js → guides_slack.md.BwXHURvY.js} +21 -8
- package/dist/docs/assets/{guides_slack.md.ClIyi7FI.lean.js → guides_slack.md.BwXHURvY.lean.js} +1 -1
- package/dist/docs/assets/{guides_webhooks.md.Cpdc3BDX.js → guides_webhooks.md.BJk63ZTs.js} +9 -5
- package/dist/docs/assets/{guides_webhooks.md.Cpdc3BDX.lean.js → guides_webhooks.md.BJk63ZTs.lean.js} +1 -1
- package/dist/docs/assets/{hillclimbing.md.Dxvd-0gT.js → hillclimbing.md.By61f3uq.js} +2 -2
- package/dist/docs/assets/index.md.CAruw_rp.js +26 -0
- package/dist/docs/assets/index.md.CAruw_rp.lean.js +1 -0
- package/dist/docs/assets/{quickstart.md.D8JDfkKO.js → quickstart.md.CljDaJBi.js} +12 -12
- package/dist/docs/assets/quickstart.md.CljDaJBi.lean.js +1 -0
- 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.CZrbHOfT.js → reference_agent-config.md.Ck29qYNj.js} +10 -8
- package/dist/docs/assets/{reference_agent-config.md.CZrbHOfT.lean.js → reference_agent-config.md.Ck29qYNj.lean.js} +1 -1
- package/dist/docs/assets/{reference_artifacts.md.DLV9MZES.js → reference_artifacts.md.C-hKR2hp.js} +2 -2
- package/dist/docs/assets/reference_channels.md.DsJfGSBJ.js +22 -0
- package/dist/docs/assets/{reference_channels.md.CNNIS6K7.lean.js → reference_channels.md.DsJfGSBJ.lean.js} +1 -1
- package/dist/docs/assets/reference_cli.md.BkdLRbXg.js +99 -0
- package/dist/docs/assets/reference_cli.md.BkdLRbXg.lean.js +1 -0
- package/dist/docs/assets/{reference_connections.md.BJE2Zllp.js → reference_connections.md.BoAotr7_.js} +7 -7
- package/dist/docs/assets/{reference_evals.md.Ccwp4x3o.js → reference_evals.md.2BXeMiO2.js} +31 -11
- package/dist/docs/assets/{reference_evals.md.Ccwp4x3o.lean.js → reference_evals.md.2BXeMiO2.lean.js} +1 -1
- package/dist/docs/assets/{reference_extensions.md.DKxTuCIw.js → reference_extensions.md.DI5X5x8p.js} +10 -10
- package/dist/docs/assets/{reference_extensions.md.DKxTuCIw.lean.js → reference_extensions.md.DI5X5x8p.lean.js} +1 -1
- package/dist/docs/assets/{reference_hooks.md.CROr0QgC.js → reference_hooks.md.B-bwJuiG.js} +5 -5
- package/dist/docs/assets/{reference_http-api.md.Dji-DD_Z.js → reference_http-api.md._RWELr3d.js} +1 -1
- package/dist/docs/assets/{reference_instructions.md.BYMVxAkw.js → reference_instructions.md.yL2hXLnl.js} +1 -1
- package/dist/docs/assets/reference_limits.md.BCCnvt3o.js +8 -0
- package/dist/docs/assets/reference_limits.md.BCCnvt3o.lean.js +1 -0
- package/dist/docs/assets/reference_memory.md.Dd7cyV9V.js +4 -0
- package/dist/docs/assets/reference_playground.md.CQiJk9CM.js +1 -0
- package/dist/docs/assets/{reference_project-layout.md.mFcS8yDD.js → reference_project-layout.md.BamcPDUn.js} +4 -4
- package/dist/docs/assets/{reference_prompt.md.DqPh71XN.js → reference_prompt.md.BMjm1Jp3.js} +2 -2
- package/dist/docs/assets/{reference_schedules.md.BqWnJES4.js → reference_schedules.md.RC47aFm4.js} +4 -4
- package/dist/docs/assets/{reference_sessions.md.Bi6lHttM.js → reference_sessions.md.C7KFhWXV.js} +1 -1
- package/dist/docs/assets/{reference_skills.md.Ckddg6KX.js → reference_skills.md.Dej2zQxi.js} +2 -2
- package/dist/docs/assets/{reference_skills.md.Ckddg6KX.lean.js → reference_skills.md.Dej2zQxi.lean.js} +1 -1
- package/dist/docs/assets/{reference_subagents.md.ChNGh6HK.js → reference_subagents.md.CAhvW4yS.js} +1 -1
- package/dist/docs/assets/{reference_tools.md.Bo0UfT0a.js → reference_tools.md.DQr7Fnhu.js} +10 -10
- package/dist/docs/assets/{reference_tools.md.Bo0UfT0a.lean.js → reference_tools.md.DQr7Fnhu.lean.js} +1 -1
- package/dist/docs/assets/{style.B9o0luvp.css → style.DK0YX1WL.css} +1 -1
- package/dist/docs/assets/{templates_agentic-owners.md.CTEnR0jp.js → templates_agentic-owners.md.Dh2nDSqg.js} +4 -4
- package/dist/docs/assets/templates_security-reviewer.md.DnwXdnB5.js +3 -0
- package/dist/docs/assets/templates_thermo-quality-review.md.MJIdHkzE.js +3 -0
- package/dist/docs/assets/{templates_thermo-quality-review.md.B77UyTrX.lean.js → templates_thermo-quality-review.md.MJIdHkzE.lean.js} +1 -1
- package/dist/docs/assets/templates_thermo-review.md.DfN1OFOl.js +3 -0
- package/dist/docs/assets/{templates_thermo-review.md.DRJ7mC5U.lean.js → templates_thermo-review.md.DfN1OFOl.lean.js} +1 -1
- package/dist/docs/assets/{templates_triage.md.CNN6b0JZ.js → templates_triage.md.BYWMloV4.js} +4 -4
- package/dist/docs/assets/troubleshooting.md.CGOdNVAL.js +1 -0
- package/dist/docs/building-with-agents.html +46 -46
- package/dist/docs/building-with-agents.md +20 -20
- package/dist/docs/changelog.html +39 -39
- package/dist/docs/changelog.md +57 -11
- package/dist/docs/deployment.html +54 -54
- package/dist/docs/deployment.md +115 -53
- package/dist/docs/evals.html +48 -48
- package/dist/docs/evals.md +15 -13
- package/dist/docs/guides/agent-to-agent.html +45 -45
- package/dist/docs/guides/agent-to-agent.md +7 -7
- package/dist/docs/guides/bitbucket.html +41 -41
- package/dist/docs/guides/bitbucket.md +5 -5
- package/dist/docs/guides/cloud-agents.html +41 -41
- package/dist/docs/guides/cloud-agents.md +3 -3
- package/dist/docs/guides/convert-automation.html +49 -49
- package/dist/docs/guides/convert-automation.md +16 -15
- package/dist/docs/guides/github.html +50 -50
- package/dist/docs/guides/github.md +17 -17
- package/dist/docs/guides/gitlab.html +41 -41
- package/dist/docs/guides/gitlab.md +5 -5
- package/dist/docs/guides/hooks.html +40 -40
- package/dist/docs/guides/hooks.md +3 -3
- package/dist/docs/guides/improve.html +41 -41
- package/dist/docs/guides/improve.md +2 -2
- package/dist/docs/guides/jev.html +48 -48
- package/dist/docs/guides/jev.md +15 -10
- package/dist/docs/guides/mcp-oauth.html +45 -45
- package/dist/docs/guides/mcp-oauth.md +10 -11
- package/dist/docs/guides/migrate.html +43 -42
- package/dist/docs/guides/migrate.md +36 -29
- package/dist/docs/guides/opentelemetry.html +50 -59
- package/dist/docs/guides/opentelemetry.md +61 -130
- package/dist/docs/guides/pagerduty.html +48 -48
- package/dist/docs/guides/pagerduty.md +18 -18
- package/dist/docs/guides/slack.html +58 -45
- package/dist/docs/guides/slack.md +87 -17
- package/dist/docs/guides/webhooks.html +46 -42
- package/dist/docs/guides/webhooks.md +61 -3
- package/dist/docs/hashmap.json +1 -1
- package/dist/docs/hillclimbing.html +39 -39
- package/dist/docs/hillclimbing.md +4 -4
- package/dist/docs/index.html +56 -57
- package/dist/docs/index.md +31 -31
- package/dist/docs/llms-full.txt +1333 -1417
- package/dist/docs/llms.txt +13 -14
- 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 +50 -50
- package/dist/docs/quickstart.md +25 -21
- package/dist/docs/reference/access.html +60 -0
- package/dist/docs/reference/access.md +22 -0
- package/dist/docs/reference/agent-config.html +46 -44
- package/dist/docs/reference/agent-config.md +54 -12
- package/dist/docs/reference/artifacts.html +39 -39
- package/dist/docs/reference/artifacts.md +2 -2
- package/dist/docs/reference/channels.html +39 -39
- package/dist/docs/reference/channels.md +29 -9
- package/dist/docs/reference/cli.html +96 -100
- package/dist/docs/reference/cli.md +363 -366
- package/dist/docs/reference/connections.html +44 -44
- package/dist/docs/reference/connections.md +10 -10
- package/dist/docs/reference/evals.html +68 -48
- package/dist/docs/reference/evals.md +48 -13
- package/dist/docs/reference/extensions.html +47 -47
- package/dist/docs/reference/extensions.md +12 -12
- package/dist/docs/reference/hooks.html +42 -42
- package/dist/docs/reference/hooks.md +11 -11
- package/dist/docs/reference/http-api.html +39 -39
- package/dist/docs/reference/http-api.md +1 -1
- package/dist/docs/reference/instructions.html +39 -39
- package/dist/docs/reference/instructions.md +1 -1
- package/dist/docs/reference/limits.html +67 -0
- package/dist/docs/reference/limits.md +37 -0
- package/dist/docs/reference/memory.html +40 -40
- package/dist/docs/reference/memory.md +7 -7
- package/dist/docs/reference/playground.html +38 -38
- package/dist/docs/reference/playground.md +1 -1
- package/dist/docs/reference/project-layout.html +41 -41
- package/dist/docs/reference/project-layout.md +6 -6
- package/dist/docs/reference/prompt.html +39 -39
- package/dist/docs/reference/prompt.md +2 -2
- package/dist/docs/reference/schedules.html +42 -42
- package/dist/docs/reference/schedules.md +4 -4
- package/dist/docs/reference/sessions.html +39 -39
- package/dist/docs/reference/sessions.md +3 -3
- package/dist/docs/reference/skills.html +39 -39
- package/dist/docs/reference/skills.md +2 -2
- package/dist/docs/reference/subagents.html +39 -39
- package/dist/docs/reference/subagents.md +1 -1
- package/dist/docs/reference/tools.html +47 -47
- package/dist/docs/reference/tools.md +31 -21
- package/dist/docs/templates/agentic-owners.html +41 -41
- package/dist/docs/templates/agentic-owners.md +7 -7
- package/dist/docs/templates/security-reviewer.html +39 -39
- package/dist/docs/templates/security-reviewer.md +6 -6
- package/dist/docs/templates/thermo-quality-review.html +40 -40
- package/dist/docs/templates/thermo-quality-review.md +7 -7
- package/dist/docs/templates/thermo-review.html +40 -40
- package/dist/docs/templates/thermo-review.md +7 -7
- package/dist/docs/templates/triage.html +41 -41
- package/dist/docs/templates/triage.md +9 -9
- package/dist/docs/troubleshooting.html +38 -38
- package/dist/docs/troubleshooting.md +26 -24
- package/dist/evals/assertions.d.ts.map +1 -1
- package/dist/evals/assertions.js +2 -2
- package/dist/evals/expect.d.ts.map +1 -1
- package/dist/evals/expect.js +9 -1
- package/dist/evals/judge.js +2 -2
- package/dist/evals/loaders.d.ts +3 -3
- package/dist/evals/loaders.d.ts.map +1 -1
- package/dist/evals/loaders.js +6 -3
- package/dist/evals/matchers.d.ts +1 -1
- package/dist/evals/matchers.d.ts.map +1 -1
- package/dist/evals/matchers.js +40 -6
- package/dist/evals/reporters.d.ts +2 -2
- package/dist/evals/reporters.js +2 -2
- package/dist/evals/results.d.ts +1 -1
- package/dist/evals/results.js +1 -1
- package/dist/evals.d.ts +3 -3
- package/dist/evals.js +1 -1
- package/dist/executors.d.ts +1 -1
- package/dist/executors.d.ts.map +1 -1
- package/dist/executors.js +2 -2
- package/dist/extensions/cursor-cloud-agents/extension.d.ts +1 -1
- package/dist/extensions/cursor-cloud-agents/extension.js +1 -1
- package/dist/extensions/cursor-cloud-agents/lib/backend.d.ts.map +1 -1
- package/dist/extensions/cursor-cloud-agents/lib/backend.js +13 -2
- package/dist/extensions/cursor-cloud-agents/reminders/cloud-agent-stop-watch.js +3 -3
- package/dist/extensions/improve/extension.d.ts +1 -1
- package/dist/extensions/improve/extension.js +1 -1
- package/dist/extensions/jev/extension.d.ts +13 -3
- package/dist/extensions/jev/extension.d.ts.map +1 -1
- package/dist/extensions/jev/extension.js +5 -1
- package/dist/extensions/jev/lib/evaluate.d.ts +33 -6
- package/dist/extensions/jev/lib/evaluate.d.ts.map +1 -1
- package/dist/extensions/jev/lib/evaluate.js +44 -11
- package/dist/extensions/jev/skills/gated-write.md +1 -1
- package/dist/extensions/slack-communication/extension.d.ts +1 -1
- package/dist/extensions/slack-communication/extension.js +1 -1
- package/dist/extensions/slack-communication/skills/slack-voice.js +1 -1
- package/dist/extensions/slack-communication/tools/post-file.d.ts.map +1 -1
- package/dist/extensions/slack-communication/tools/post-file.js +45 -2
- package/dist/extensions.d.ts +2 -2
- package/dist/extensions.d.ts.map +1 -1
- package/dist/extensions.js +7 -3
- package/dist/files-backends/cursor-hosted.d.ts.map +1 -1
- package/dist/files-backends/cursor-hosted.js +5 -0
- package/dist/files-backends/local-fs.d.ts.map +1 -1
- package/dist/files-backends/local-fs.js +4 -3
- package/dist/filesystem.d.ts +24 -54
- package/dist/filesystem.d.ts.map +1 -1
- package/dist/filesystem.js +172 -104
- package/dist/hooks.d.ts +1 -1
- package/dist/hooks.js +1 -1
- package/dist/index.d.ts +11 -4
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +10 -3
- package/dist/internal/advertise-tools.d.ts +3 -3
- package/dist/internal/advertise-tools.d.ts.map +1 -1
- package/dist/internal/advertise-tools.js +9 -5
- package/dist/internal/artifacts-store.d.ts.map +1 -1
- package/dist/internal/artifacts-store.js +15 -6
- package/dist/internal/as-of.d.ts.map +1 -1
- package/dist/internal/as-of.js +4 -3
- package/dist/internal/authored-alias-hooks.d.ts +1 -20
- package/dist/internal/authored-alias-hooks.d.ts.map +1 -1
- package/dist/internal/authored-alias-hooks.js +54 -7
- package/dist/internal/authored-loaders.d.ts +2 -2
- package/dist/internal/authored-loaders.d.ts.map +1 -1
- package/dist/internal/authored-loaders.js +38 -13
- package/dist/internal/brand.d.ts.map +1 -1
- package/dist/internal/brand.js +25 -2
- package/dist/internal/builtin-tools/artifacts.d.ts.map +1 -1
- package/dist/internal/builtin-tools/artifacts.js +19 -3
- package/dist/internal/channel-dispatch.d.ts.map +1 -1
- package/dist/internal/channel-dispatch.js +1 -1
- package/dist/internal/channel-state.d.ts.map +1 -1
- package/dist/internal/channel-state.js +13 -8
- package/dist/internal/chat-client.d.ts.map +1 -1
- package/dist/internal/chat-client.js +14 -5
- package/dist/internal/cli/command.d.ts +134 -0
- package/dist/internal/cli/command.d.ts.map +1 -0
- package/dist/internal/cli/command.js +54 -0
- package/dist/internal/cli/commands/channels.d.ts +26 -0
- package/dist/internal/cli/commands/channels.d.ts.map +1 -0
- package/dist/internal/cli/commands/channels.js +524 -0
- package/dist/internal/cli/commands/develop.d.ts +15 -0
- package/dist/internal/cli/commands/develop.d.ts.map +1 -0
- package/dist/internal/cli/commands/develop.js +577 -0
- package/dist/internal/cli/commands/hosted.d.ts +22 -0
- package/dist/internal/cli/commands/hosted.d.ts.map +1 -0
- package/dist/internal/cli/commands/hosted.js +407 -0
- package/dist/internal/cli/commands/index.d.ts +4 -0
- package/dist/internal/cli/commands/index.d.ts.map +1 -0
- package/dist/internal/cli/commands/index.js +84 -0
- package/dist/internal/cli/commands/mcp.d.ts +6 -0
- package/dist/internal/cli/commands/mcp.d.ts.map +1 -0
- package/dist/internal/cli/commands/mcp.js +89 -0
- package/dist/internal/cli/commands/project.d.ts +5 -0
- package/dist/internal/cli/commands/project.d.ts.map +1 -0
- package/dist/internal/cli/commands/project.js +136 -0
- package/dist/internal/cli/commands/scaffold.d.ts +12 -0
- package/dist/internal/cli/commands/scaffold.d.ts.map +1 -0
- package/dist/internal/cli/commands/scaffold.js +282 -0
- package/dist/internal/cli/commands/serve.d.ts +11 -0
- package/dist/internal/cli/commands/serve.d.ts.map +1 -0
- package/dist/internal/cli/commands/serve.js +370 -0
- package/dist/internal/cli/commands/session.d.ts +7 -0
- package/dist/internal/cli/commands/session.d.ts.map +1 -0
- package/dist/internal/cli/commands/session.js +359 -0
- package/dist/internal/cli/dispatch.d.ts +46 -0
- package/dist/internal/cli/dispatch.d.ts.map +1 -0
- package/dist/internal/cli/dispatch.js +385 -0
- package/dist/internal/cli/errors.d.ts +51 -0
- package/dist/internal/cli/errors.d.ts.map +1 -0
- package/dist/internal/cli/errors.js +142 -0
- package/dist/internal/cli/flags.d.ts +186 -0
- package/dist/internal/cli/flags.d.ts.map +1 -0
- package/dist/internal/cli/flags.js +167 -0
- package/dist/internal/cli/help-command.d.ts +7 -0
- package/dist/internal/cli/help-command.d.ts.map +1 -0
- package/dist/internal/cli/help-command.js +60 -0
- package/dist/internal/cli/help.d.ts +63 -0
- package/dist/internal/cli/help.d.ts.map +1 -0
- package/dist/internal/cli/help.js +203 -0
- package/dist/internal/cli/io.d.ts +11 -0
- package/dist/internal/cli/io.d.ts.map +1 -0
- package/dist/internal/cli/io.js +33 -0
- package/dist/internal/cli/output.d.ts +54 -0
- package/dist/internal/cli/output.d.ts.map +1 -0
- package/dist/internal/cli/output.js +132 -0
- package/dist/internal/cli/value-kinds.d.ts +20 -0
- package/dist/internal/cli/value-kinds.d.ts.map +1 -0
- package/dist/internal/cli/value-kinds.js +70 -0
- package/dist/internal/cli-ax.d.ts +35 -20
- package/dist/internal/cli-ax.d.ts.map +1 -1
- package/dist/internal/cli-ax.js +439 -365
- package/dist/internal/cli-convert-automation.d.ts +3 -1
- package/dist/internal/cli-convert-automation.d.ts.map +1 -1
- package/dist/internal/cli-convert-automation.js +52 -20
- package/dist/internal/cli-cursor.js +5 -1
- package/dist/internal/cli-deploy.d.ts +23 -9
- package/dist/internal/cli-deploy.d.ts.map +1 -1
- package/dist/internal/cli-deploy.js +234 -508
- package/dist/internal/cli-docs.d.ts +1 -1
- package/dist/internal/cli-docs.js +3 -2
- package/dist/internal/cli-github.js +1 -0
- package/dist/internal/cli-images.d.ts.map +1 -1
- package/dist/internal/cli-images.js +44 -14
- package/dist/internal/cli-invocation.d.ts +22 -0
- package/dist/internal/cli-invocation.d.ts.map +1 -0
- package/dist/internal/cli-invocation.js +86 -0
- package/dist/internal/cli-manifest.d.ts +4 -1
- package/dist/internal/cli-manifest.d.ts.map +1 -1
- package/dist/internal/cli-manifest.js +16 -4
- package/dist/internal/cli-mcp-oauth.d.ts +7 -11
- package/dist/internal/cli-mcp-oauth.d.ts.map +1 -1
- package/dist/internal/cli-mcp-oauth.js +24 -104
- package/dist/internal/cli-mcp.d.ts +17 -28
- package/dist/internal/cli-mcp.d.ts.map +1 -1
- package/dist/internal/cli-mcp.js +64 -304
- package/dist/internal/cli-migrate.d.ts +3 -1
- package/dist/internal/cli-migrate.d.ts.map +1 -1
- package/dist/internal/cli-migrate.js +43 -15
- package/dist/internal/cli-pagerduty.d.ts +1 -1
- package/dist/internal/cli-pagerduty.js +1 -1
- package/dist/internal/cli-skills.d.ts +30 -2
- package/dist/internal/cli-skills.d.ts.map +1 -1
- package/dist/internal/cli-skills.js +63 -3
- package/dist/internal/cli-slack-context.d.ts +91 -0
- package/dist/internal/cli-slack-context.d.ts.map +1 -0
- package/dist/internal/cli-slack-context.js +112 -0
- package/dist/internal/cli-slack-manual.d.ts +2 -0
- package/dist/internal/cli-slack-manual.d.ts.map +1 -1
- package/dist/internal/cli-slack-manual.js +12 -0
- package/dist/internal/cli-slack.d.ts +1 -49
- package/dist/internal/cli-slack.d.ts.map +1 -1
- package/dist/internal/cli-slack.js +27 -147
- package/dist/internal/cloud-merge.d.ts +2 -4
- package/dist/internal/cloud-merge.d.ts.map +1 -1
- package/dist/internal/cloud-merge.js +2 -7
- package/dist/internal/continuation-channel.d.ts.map +1 -1
- package/dist/internal/continuation-channel.js +10 -22
- package/dist/internal/continuation-identity.d.ts +33 -12
- package/dist/internal/continuation-identity.d.ts.map +1 -1
- package/dist/internal/continuation-identity.js +161 -43
- package/dist/internal/continuation-registration.d.ts +26 -0
- package/dist/internal/continuation-registration.d.ts.map +1 -0
- package/dist/internal/continuation-registration.js +35 -0
- package/dist/internal/conversation-mirror.d.ts.map +1 -1
- package/dist/internal/conversation-mirror.js +23 -14
- package/dist/internal/convert-automation/convert-workflow.d.ts.map +1 -1
- package/dist/internal/convert-automation/convert-workflow.js +28 -22
- package/dist/internal/convert-automation/types.d.ts +1 -1
- package/dist/internal/convert-automation/types.js +1 -1
- package/dist/internal/cursor/account-mcp.js +1 -1
- package/dist/internal/cursor/backend-client.d.ts.map +1 -1
- package/dist/internal/cursor/backend-client.js +6 -8
- package/dist/internal/cursor/bound-secret-file.d.ts.map +1 -1
- package/dist/internal/cursor/bound-secret-file.js +2 -1
- package/dist/internal/cursor/credentials.d.ts +4 -17
- package/dist/internal/cursor/credentials.d.ts.map +1 -1
- package/dist/internal/cursor/credentials.js +11 -27
- package/dist/internal/cursor/session-token.d.ts.map +1 -1
- package/dist/internal/cursor/session-token.js +3 -4
- package/dist/internal/cursor/store-api-client.d.ts.map +1 -1
- package/dist/internal/cursor/store-api-client.js +3 -2
- package/dist/internal/cursor-agent-template.d.ts +1 -1
- package/dist/internal/cursor-agent-template.d.ts.map +1 -1
- package/dist/internal/cursor-agent-template.js +2 -2
- package/dist/internal/cursor-deployment-relay.d.ts.map +1 -1
- package/dist/internal/cursor-deployment-relay.js +24 -2
- package/dist/internal/cursor-event-relay.d.ts.map +1 -1
- package/dist/internal/cursor-event-relay.js +26 -2
- package/dist/internal/cursor-relay-core.d.ts.map +1 -1
- package/dist/internal/cursor-relay-core.js +22 -3
- package/dist/internal/deploy-client.d.ts +104 -94
- package/dist/internal/deploy-client.d.ts.map +1 -1
- package/dist/internal/deploy-client.js +143 -178
- package/dist/internal/deploy-manifest.d.ts +2 -2
- package/dist/internal/deploy-manifest.d.ts.map +1 -1
- package/dist/internal/deploy-manifest.js +6 -6
- package/dist/internal/describe-error.d.ts +4 -0
- package/dist/internal/describe-error.d.ts.map +1 -1
- package/dist/internal/describe-error.js +20 -0
- package/dist/internal/discovery/agent-config.d.ts +1 -5
- package/dist/internal/discovery/agent-config.d.ts.map +1 -1
- package/dist/internal/discovery/agent-config.js +5 -11
- package/dist/internal/discovery/agent.d.ts.map +1 -1
- package/dist/internal/discovery/agent.js +24 -30
- package/dist/internal/discovery/channels.d.ts.map +1 -1
- package/dist/internal/discovery/channels.js +2 -0
- package/dist/internal/discovery/connections.d.ts.map +1 -1
- package/dist/internal/discovery/connections.js +6 -4
- package/dist/internal/discovery/context.d.ts.map +1 -1
- package/dist/internal/discovery/context.js +6 -1
- package/dist/internal/discovery/extension-overlay.d.ts +1 -1
- package/dist/internal/discovery/extension-overlay.d.ts.map +1 -1
- package/dist/internal/discovery/extension-overlay.js +1 -0
- package/dist/internal/discovery/extensions.d.ts.map +1 -1
- package/dist/internal/discovery/extensions.js +12 -5
- package/dist/internal/discovery/fs.d.ts.map +1 -1
- package/dist/internal/discovery/fs.js +2 -1
- package/dist/internal/discovery/hooks.d.ts.map +1 -1
- package/dist/internal/discovery/hooks.js +1 -0
- package/dist/internal/discovery/info.d.ts.map +1 -1
- package/dist/internal/discovery/info.js +0 -3
- package/dist/internal/discovery/instructions.d.ts.map +1 -1
- package/dist/internal/discovery/instructions.js +4 -1
- package/dist/internal/discovery/instrumentation.js +1 -1
- package/dist/internal/discovery/modules.d.ts.map +1 -1
- package/dist/internal/discovery/modules.js +4 -1
- package/dist/internal/discovery/project.js +1 -1
- package/dist/internal/discovery/reminders.d.ts.map +1 -1
- package/dist/internal/discovery/reminders.js +1 -0
- package/dist/internal/discovery/runtime.d.ts +0 -16
- package/dist/internal/discovery/runtime.d.ts.map +1 -1
- package/dist/internal/discovery/runtime.js +2 -47
- package/dist/internal/discovery/schedules.d.ts.map +1 -1
- package/dist/internal/discovery/schedules.js +1 -0
- package/dist/internal/discovery/services.d.ts.map +1 -1
- package/dist/internal/discovery/services.js +3 -1
- package/dist/internal/discovery/skills.d.ts.map +1 -1
- package/dist/internal/discovery/skills.js +1 -0
- package/dist/internal/discovery/tools.d.ts +1 -1
- package/dist/internal/discovery/tools.d.ts.map +1 -1
- package/dist/internal/discovery/tools.js +3 -1
- package/dist/internal/discovery.d.ts +1 -1
- package/dist/internal/discovery.d.ts.map +1 -1
- package/dist/internal/discovery.js +1 -1
- package/dist/internal/distribution.d.ts +9 -14
- package/dist/internal/distribution.d.ts.map +1 -1
- package/dist/internal/distribution.js +54 -18
- package/dist/internal/docs-site.d.ts.map +1 -1
- package/dist/internal/docs-site.js +15 -2
- package/dist/internal/dry-run.d.ts +32 -0
- package/dist/internal/dry-run.d.ts.map +1 -0
- package/dist/internal/dry-run.js +62 -0
- package/dist/internal/duration.d.ts.map +1 -1
- package/dist/internal/duration.js +1 -0
- package/dist/internal/estimate-cost.d.ts.map +1 -1
- package/dist/internal/estimate-cost.js +12 -5
- package/dist/internal/eval-run-store.d.ts.map +1 -1
- package/dist/internal/eval-run-store.js +6 -5
- package/dist/internal/eval-runner.d.ts +0 -2
- package/dist/internal/eval-runner.d.ts.map +1 -1
- package/dist/internal/eval-runner.js +3 -3
- package/dist/internal/evals-client.d.ts.map +1 -1
- package/dist/internal/evals-client.js +60 -15
- package/dist/internal/event-log.d.ts.map +1 -1
- package/dist/internal/event-log.js +3 -11
- package/dist/internal/event-mapper.d.ts.map +1 -1
- package/dist/internal/event-mapper.js +33 -15
- package/dist/internal/expected-delivery-failure.d.ts.map +1 -1
- package/dist/internal/expected-delivery-failure.js +5 -4
- package/dist/internal/fetch-text.d.ts +8 -0
- package/dist/internal/fetch-text.d.ts.map +1 -0
- package/dist/internal/fetch-text.js +32 -0
- package/dist/internal/filesystem/errors.d.ts.map +1 -1
- package/dist/internal/filesystem/errors.js +8 -0
- package/dist/internal/filesystem/scratch.js +1 -4
- package/dist/internal/filesystem/sdk-schemas.d.ts +19 -19
- package/dist/internal/filesystem/sdk-schemas.d.ts.map +1 -1
- package/dist/internal/filesystem/sdk-schemas.js +15 -21
- package/dist/internal/filesystem/tools.d.ts +15 -4
- package/dist/internal/filesystem/tools.d.ts.map +1 -1
- package/dist/internal/filesystem/tools.js +33 -47
- package/dist/internal/filesystem/walk.d.ts.map +1 -1
- package/dist/internal/filesystem/walk.js +4 -0
- package/dist/internal/framework-file-storage.d.ts.map +1 -1
- package/dist/internal/framework-file-storage.js +2 -1
- package/dist/internal/frontmatter.d.ts.map +1 -1
- package/dist/internal/frontmatter.js +5 -1
- package/dist/internal/github-fanout.js +2 -1
- package/dist/internal/guest-network.d.ts.map +1 -1
- package/dist/internal/guest-network.js +6 -0
- package/dist/internal/handleAgentServeTrigger.d.ts +8 -0
- package/dist/internal/handleAgentServeTrigger.d.ts.map +1 -1
- package/dist/internal/handleAgentServeTrigger.js +27 -1
- package/dist/internal/host-kv.d.ts.map +1 -1
- package/dist/internal/host-kv.js +4 -2
- package/dist/internal/host-otel.d.ts.map +1 -1
- package/dist/internal/host-otel.js +2 -8
- package/dist/internal/host-platforms.d.ts.map +1 -1
- package/dist/internal/host-platforms.js +17 -10
- package/dist/internal/hosted-catch-protocol.d.ts.map +1 -1
- package/dist/internal/hosted-catch-protocol.js +26 -9
- package/dist/internal/hosted-catch.d.ts +13 -10
- package/dist/internal/hosted-catch.d.ts.map +1 -1
- package/dist/internal/hosted-catch.js +23 -11
- package/dist/internal/hosted-delivery-protocol.d.ts +1 -1
- package/dist/internal/hosted-delivery-protocol.d.ts.map +1 -1
- package/dist/internal/hosted-delivery-protocol.js +75 -45
- package/dist/internal/hosted-delivery.d.ts +1 -2
- package/dist/internal/hosted-delivery.d.ts.map +1 -1
- package/dist/internal/hosted-delivery.js +27 -32
- package/dist/internal/hosted-execution-diag.d.ts.map +1 -1
- package/dist/internal/hosted-execution-diag.js +11 -13
- package/dist/internal/hosted-execution-flush.js +1 -1
- package/dist/internal/hosted-execution-latency.d.ts.map +1 -1
- package/dist/internal/hosted-execution-latency.js +12 -1
- package/dist/internal/hosted-hints.d.ts +16 -0
- package/dist/internal/hosted-hints.d.ts.map +1 -0
- package/dist/internal/hosted-hints.js +23 -0
- package/dist/internal/hosted-managed-automation.d.ts.map +1 -1
- package/dist/internal/hosted-managed-automation.js +1 -0
- package/dist/internal/hosted-session-fixture.d.ts +26 -0
- package/dist/internal/hosted-session-fixture.d.ts.map +1 -0
- package/dist/internal/hosted-session-fixture.js +34 -0
- package/dist/internal/hosted-session-view.d.ts +48 -0
- package/dist/internal/hosted-session-view.d.ts.map +1 -0
- package/dist/internal/hosted-session-view.js +305 -0
- package/dist/internal/http-channel.d.ts.map +1 -1
- package/dist/internal/http-channel.js +8 -5
- package/dist/internal/http-control-plane-session.d.ts.map +1 -1
- package/dist/internal/http-control-plane-session.js +8 -9
- package/dist/internal/init-interview.js +2 -2
- package/dist/internal/init-project.d.ts +14 -16
- package/dist/internal/init-project.d.ts.map +1 -1
- package/dist/internal/init-project.js +63 -27
- 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 +22 -9
- package/dist/internal/inline-stdio-define-stub.d.ts +1 -1
- package/dist/internal/inline-stdio-define-stub.d.ts.map +1 -1
- package/dist/internal/inline-stdio-define-stub.js +1 -1
- package/dist/internal/inline-stdio-mcp.d.ts.map +1 -1
- package/dist/internal/inline-stdio-mcp.js +31 -8
- package/dist/internal/install-cursor-skills.d.ts +22 -15
- package/dist/internal/install-cursor-skills.d.ts.map +1 -1
- package/dist/internal/install-cursor-skills.js +66 -31
- package/dist/internal/interview/agent-questions.d.ts.map +1 -1
- package/dist/internal/interview/agent-questions.js +4 -1
- package/dist/internal/interview/question.d.ts +1 -1
- package/dist/internal/interview/question.js +1 -1
- package/dist/internal/json-schema.d.ts +3 -2
- package/dist/internal/json-schema.d.ts.map +1 -1
- package/dist/internal/json-schema.js +83 -3
- package/dist/internal/json-value.d.ts +20 -0
- package/dist/internal/json-value.d.ts.map +1 -0
- package/dist/internal/json-value.js +56 -0
- package/dist/internal/logs-client.d.ts +4 -25
- package/dist/internal/logs-client.d.ts.map +1 -1
- package/dist/internal/logs-client.js +17 -174
- package/dist/internal/mcp-endpoint.d.ts +1 -1
- package/dist/internal/mcp-endpoint.js +2 -1
- package/dist/internal/mcp-host.d.ts.map +1 -1
- package/dist/internal/mcp-host.js +22 -9
- package/dist/internal/mcp-oauth.d.ts +2 -2
- package/dist/internal/mcp-oauth.d.ts.map +1 -1
- package/dist/internal/mcp-oauth.js +61 -8
- package/dist/internal/named-webhook-secret.d.ts +12 -0
- package/dist/internal/named-webhook-secret.d.ts.map +1 -1
- package/dist/internal/named-webhook-secret.js +18 -0
- package/dist/internal/otel/bind-telemetry.d.ts +26 -0
- package/dist/internal/otel/bind-telemetry.d.ts.map +1 -0
- package/dist/internal/otel/bind-telemetry.js +36 -0
- package/dist/internal/otel/collector.d.ts.map +1 -1
- package/dist/internal/otel/collector.js +94 -42
- package/dist/internal/otel/config.d.ts.map +1 -1
- package/dist/internal/otel/config.js +4 -3
- package/dist/internal/otel/conversation-span-processor.d.ts.map +1 -1
- package/dist/internal/otel/conversation-span-processor.js +5 -2
- package/dist/internal/otel/customer.d.ts +1 -5
- package/dist/internal/otel/customer.d.ts.map +1 -1
- package/dist/internal/otel/customer.js +35 -13
- package/dist/internal/otel/http.d.ts +1 -1
- package/dist/internal/otel/http.d.ts.map +1 -1
- package/dist/internal/otel/http.js +5 -3
- package/dist/internal/otel/propagation.d.ts +3 -2
- package/dist/internal/otel/propagation.d.ts.map +1 -1
- package/dist/internal/otel/propagation.js +3 -2
- package/dist/internal/otel/reserved-attributes.d.ts +8 -0
- package/dist/internal/otel/reserved-attributes.d.ts.map +1 -0
- package/dist/internal/otel/reserved-attributes.js +24 -0
- package/dist/internal/otel/runtime.d.ts.map +1 -1
- package/dist/internal/otel/runtime.js +9 -2
- package/dist/internal/otel/session-telemetry.d.ts +22 -0
- package/dist/internal/otel/session-telemetry.d.ts.map +1 -0
- package/dist/internal/otel/session-telemetry.js +30 -0
- package/dist/internal/otel/telemetry-attributes.d.ts +7 -0
- package/dist/internal/otel/telemetry-attributes.d.ts.map +1 -0
- package/dist/internal/otel/telemetry-attributes.js +35 -0
- package/dist/internal/otel/telemetry-processor.d.ts +7 -0
- package/dist/internal/otel/telemetry-processor.d.ts.map +1 -0
- package/dist/internal/otel/telemetry-processor.js +47 -0
- package/dist/internal/otel/tool-error-class.d.ts.map +1 -1
- package/dist/internal/otel/tool-error-class.js +4 -0
- package/dist/internal/package-inline-stdio.d.ts.map +1 -1
- package/dist/internal/package-inline-stdio.js +2 -2
- package/dist/internal/peer-connections.js +1 -1
- package/dist/internal/persistent-stage-log-mirror.js +2 -5
- package/dist/internal/platform-timers.d.ts.map +1 -1
- package/dist/internal/platform-timers.js +32 -1
- package/dist/internal/playground/toolchain.d.ts.map +1 -1
- package/dist/internal/playground/toolchain.js +16 -3
- package/dist/internal/playground-proxy.d.ts +6 -27
- package/dist/internal/playground-proxy.d.ts.map +1 -1
- package/dist/internal/playground-proxy.js +25 -83
- package/dist/internal/private-file.d.ts +2 -0
- package/dist/internal/private-file.d.ts.map +1 -0
- package/dist/internal/private-file.js +8 -0
- package/dist/internal/reminder-control-plane-protocol.d.ts.map +1 -1
- package/dist/internal/reminder-control-plane-protocol.js +4 -2
- package/dist/internal/reminder-runner.d.ts.map +1 -1
- package/dist/internal/reminder-runner.js +12 -25
- package/dist/internal/reminder-schedule.js +1 -1
- package/dist/internal/reminder-store.d.ts.map +1 -1
- package/dist/internal/reminder-store.js +16 -21
- package/dist/internal/request-headers.d.ts +2 -2
- package/dist/internal/request-headers.d.ts.map +1 -1
- package/dist/internal/request-headers.js +1 -1
- package/dist/internal/resolve-prod-target.d.ts +9 -65
- package/dist/internal/resolve-prod-target.d.ts.map +1 -1
- package/dist/internal/resolve-prod-target.js +20 -187
- package/dist/internal/resolved-connections.js +1 -1
- package/dist/internal/{factory-resource-channel.d.ts → resource-channel.d.ts} +10 -10
- package/dist/internal/resource-channel.d.ts.map +1 -0
- package/dist/internal/{factory-resource-channel.js → resource-channel.js} +9 -7
- package/dist/internal/run-client.d.ts.map +1 -1
- package/dist/internal/run-client.js +4 -1
- package/dist/internal/sdk-runner.d.ts +2 -2
- package/dist/internal/sdk-runner.d.ts.map +1 -1
- package/dist/internal/sdk-runner.js +19 -16
- package/dist/internal/sdk-subagent-inherit-support.d.ts.map +1 -1
- package/dist/internal/sdk-subagent-inherit-support.js +3 -2
- package/dist/internal/serve-restart.d.ts +3 -0
- package/dist/internal/serve-restart.d.ts.map +1 -1
- package/dist/internal/serve-restart.js +8 -4
- package/dist/internal/server.d.ts +5 -1
- package/dist/internal/server.d.ts.map +1 -1
- package/dist/internal/server.js +71 -64
- 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 +5 -5
- package/dist/internal/session-engine.d.ts +22 -8
- package/dist/internal/session-engine.d.ts.map +1 -1
- package/dist/internal/session-engine.js +170 -75
- package/dist/internal/session-links.js +2 -1
- package/dist/internal/session-live-publisher.d.ts +0 -7
- package/dist/internal/session-live-publisher.d.ts.map +1 -1
- package/dist/internal/session-live-publisher.js +20 -7
- package/dist/internal/session-run-log.d.ts.map +1 -1
- package/dist/internal/session-run-log.js +19 -5
- package/dist/internal/session-store.d.ts.map +1 -1
- package/dist/internal/session-store.js +17 -3
- package/dist/internal/sessions-client.d.ts +2 -0
- package/dist/internal/sessions-client.d.ts.map +1 -1
- package/dist/internal/sessions-client.js +44 -10
- package/dist/internal/shallow-clone.d.ts +258 -0
- package/dist/internal/shallow-clone.d.ts.map +1 -0
- package/dist/internal/shallow-clone.js +644 -0
- package/dist/internal/slack-bot-scopes.d.ts +3 -0
- package/dist/internal/slack-bot-scopes.d.ts.map +1 -0
- package/dist/internal/slack-bot-scopes.js +2 -0
- package/dist/internal/slack-manifest-opt-in.d.ts +26 -0
- package/dist/internal/slack-manifest-opt-in.d.ts.map +1 -0
- package/dist/internal/slack-manifest-opt-in.js +63 -0
- package/dist/internal/slack-provision-client.d.ts +8 -24
- package/dist/internal/slack-provision-client.d.ts.map +1 -1
- package/dist/internal/slack-provision-client.js +21 -20
- package/dist/internal/slack-thread-key.d.ts +8 -3
- package/dist/internal/slack-thread-key.d.ts.map +1 -1
- package/dist/internal/slack-thread-key.js +6 -6
- package/dist/internal/sqlite-experimental-warning.js +1 -1
- package/dist/internal/start-log-store.d.ts.map +1 -1
- package/dist/internal/start-log-store.js +2 -5
- package/dist/internal/storage-coordinator.d.ts.map +1 -1
- package/dist/internal/storage-coordinator.js +49 -20
- package/dist/internal/stored-eval-run.d.ts +17 -0
- package/dist/internal/stored-eval-run.d.ts.map +1 -0
- package/dist/internal/stored-eval-run.js +305 -0
- package/dist/internal/stream-progress.d.ts.map +1 -1
- package/dist/internal/stream-progress.js +1 -1
- package/dist/internal/tcp-address.d.ts +4 -0
- package/dist/internal/tcp-address.d.ts.map +1 -0
- package/dist/internal/tcp-address.js +8 -0
- package/dist/internal/terminal-style.js +2 -2
- package/dist/internal/testing/pagerduty-continuation-fixtures.d.ts +1 -1
- package/dist/internal/testing/pagerduty-continuation-fixtures.js +1 -1
- package/dist/internal/testing/scm-continuation-fixtures.d.ts +1 -1
- package/dist/internal/testing/scm-continuation-fixtures.js +1 -1
- package/dist/internal/testing/slack-continuation-fixtures.d.ts +12 -6
- package/dist/internal/testing/slack-continuation-fixtures.d.ts.map +1 -1
- package/dist/internal/testing/slack-continuation-fixtures.js +74 -3
- package/dist/internal/tool-call-retry.d.ts +35 -7
- package/dist/internal/tool-call-retry.d.ts.map +1 -1
- package/dist/internal/tool-call-retry.js +108 -108
- package/dist/internal/tool-catalog.d.ts.map +1 -1
- package/dist/internal/tool-catalog.js +7 -2
- package/dist/internal/tool-policy.d.ts +20 -7
- package/dist/internal/tool-policy.d.ts.map +1 -1
- package/dist/internal/tool-policy.js +39 -11
- package/dist/internal/tool-result.d.ts +0 -5
- package/dist/internal/tool-result.d.ts.map +1 -1
- package/dist/internal/tool-result.js +26 -6
- package/dist/internal/trajectory.d.ts.map +1 -1
- package/dist/internal/trajectory.js +5 -1
- package/dist/internal/turn-outbox.d.ts.map +1 -1
- package/dist/internal/turn-outbox.js +1 -0
- package/dist/internal/update-check.d.ts +2 -0
- package/dist/internal/update-check.d.ts.map +1 -1
- package/dist/internal/update-check.js +4 -0
- package/dist/internal/workspace.d.ts +3 -4
- package/dist/internal/workspace.d.ts.map +1 -1
- package/dist/internal/workspace.js +5 -5
- package/dist/kv/memory-kv.d.ts +1 -1
- package/dist/kv/memory-kv.js +1 -1
- package/dist/kv.d.ts +9 -2
- package/dist/kv.d.ts.map +1 -1
- package/dist/kv.js +10 -2
- package/dist/memory.d.ts +1 -1
- package/dist/memory.js +1 -1
- package/dist/otel-public.d.ts +2 -1
- package/dist/otel-public.d.ts.map +1 -1
- package/dist/otel-public.js +2 -1
- package/dist/otel.d.ts.map +1 -1
- package/dist/otel.js +6 -2
- package/dist/playground/assets/cursor-icons-16-QUmxS7q3.woff2 +0 -0
- package/dist/playground/assets/index-Cl9zvmmf.js +62 -0
- package/dist/playground/assets/index-F8b5WvWi.css +1 -0
- package/dist/playground/index.html +2 -2
- package/dist/prompt.d.ts +1 -1
- package/dist/prompt.js +1 -1
- package/dist/public-deprecated.d.ts +11 -12
- package/dist/public-deprecated.d.ts.map +1 -1
- package/dist/public-deprecated.js +8 -9
- package/dist/reminders.d.ts +2 -2
- package/dist/reminders.js +2 -2
- package/dist/schedules.d.ts +1 -1
- package/dist/schedules.js +1 -1
- package/dist/scm.d.ts +2 -0
- package/dist/scm.d.ts.map +1 -0
- package/dist/scm.js +1 -0
- package/dist/skills.d.ts +1 -1
- package/dist/skills.js +1 -1
- package/dist/storage-backends/cursor-hosted.d.ts.map +1 -1
- package/dist/storage-backends/cursor-hosted.js +5 -3
- package/dist/storage-backends/file-kv.d.ts +3 -2
- package/dist/storage-backends/file-kv.d.ts.map +1 -1
- package/dist/storage-backends/file-kv.js +20 -8
- package/dist/storage.d.ts +2 -3
- package/dist/storage.d.ts.map +1 -1
- package/dist/storage.js +9 -5
- package/dist/telemetry.d.ts +12 -0
- package/dist/telemetry.d.ts.map +1 -0
- package/dist/telemetry.js +11 -0
- package/dist/tools.d.ts +1 -1
- package/dist/tools.d.ts.map +1 -1
- package/dist/tools.js +2 -1
- package/dist/types.d.ts +59 -46
- package/dist/types.d.ts.map +1 -1
- package/dist/types.js +4 -4
- package/docs/README.md +33 -33
- package/docs/building-with-agents.md +16 -16
- package/docs/changelog.md +58 -12
- package/docs/deployment.md +116 -54
- package/docs/evals.md +14 -12
- package/docs/guides/agent-to-agent.md +8 -8
- package/docs/guides/bitbucket.md +5 -5
- package/docs/guides/cloud-agents.md +4 -4
- package/docs/guides/convert-automation.md +17 -16
- package/docs/guides/github.md +16 -16
- package/docs/guides/gitlab.md +5 -5
- package/docs/guides/hooks.md +3 -3
- package/docs/guides/improve.md +2 -2
- package/docs/guides/jev.md +15 -10
- package/docs/guides/mcp-oauth.md +9 -10
- package/docs/guides/migrate.md +35 -28
- package/docs/guides/opentelemetry.md +61 -130
- package/docs/guides/pagerduty.md +18 -18
- package/docs/guides/slack.md +85 -15
- package/docs/guides/webhooks.md +61 -3
- package/docs/hillclimbing.md +2 -2
- package/docs/quickstart.md +26 -22
- package/docs/reference/access.md +27 -0
- package/docs/reference/agent-config.md +54 -12
- package/docs/reference/artifacts.md +2 -2
- package/docs/reference/channels.md +29 -9
- package/docs/reference/cli.md +364 -367
- package/docs/reference/connections.md +9 -9
- package/docs/reference/evals.md +48 -13
- package/docs/reference/extensions.md +12 -12
- package/docs/reference/hooks.md +11 -11
- package/docs/reference/http-api.md +1 -1
- package/docs/reference/instructions.md +1 -1
- package/docs/reference/limits.md +42 -0
- package/docs/reference/memory.md +7 -7
- package/docs/reference/playground.md +1 -1
- package/docs/reference/project-layout.md +6 -6
- package/docs/reference/prompt.md +2 -2
- package/docs/reference/schedules.md +4 -4
- package/docs/reference/sessions.md +3 -3
- package/docs/reference/skills.md +2 -2
- package/docs/reference/subagents.md +1 -1
- package/docs/reference/tools.md +31 -21
- package/docs/templates/agentic-owners.md +7 -7
- package/docs/templates/security-reviewer.md +6 -6
- package/docs/templates/thermo-quality-review.md +7 -7
- package/docs/templates/thermo-review.md +7 -7
- package/docs/templates/triage.md +9 -9
- package/docs/troubleshooting.md +26 -24
- package/package.json +52 -99
- package/scripts/install-cursor-skills.mjs +2 -2
- package/skills/cli/SKILL.md +125 -0
- package/skills/create-agent/SKILL.md +29 -26
- package/skills/debug/SKILL.md +6 -6
- package/skills/deploy/SKILL.md +47 -44
- package/skills/evals/SKILL.md +13 -13
- package/skills/framework-map/SKILL.md +9 -8
- package/skills/github/SKILL.md +10 -10
- package/skills/hillclimb/SKILL.md +6 -6
- package/skills/mcp-auth/SKILL.md +3 -3
- package/skills/migrate-v2/SKILL.md +67 -70
- package/skills/otel/SKILL.md +36 -6
- package/skills/setup-slack/SKILL.md +11 -11
- package/templates/agentic-owners/README.md +6 -6
- package/templates/agentic-owners/bot/agent.ts +1 -1
- package/templates/agentic-owners/bot/channels/github.ts +1 -1
- package/templates/agentic-owners/bot/lib/github.ts +2 -2
- package/templates/agentic-owners/bot/lib/owners/parse.ts +1 -1
- package/templates/agentic-owners/bot/lib/owners/policyMode.ts +6 -2
- package/templates/agentic-owners/bot/lib/review.ts +7 -3
- package/templates/agentic-owners/bot/tools/record_review.ts +3 -3
- package/templates/agentic-owners/evals/evals.config.ts +1 -1
- package/templates/agentic-owners/evals/owners.eval.ts +1 -1
- package/templates/agentic-owners/package.json +3 -3
- package/templates/agents-md/README.md +5 -5
- package/templates/agents-md/bot/agent.ts +1 -1
- package/templates/agents-md/bot/channels/github.ts +1 -1
- package/templates/agents-md/bot/channels/queue.ts +5 -3
- package/templates/agents-md/bot/channels/slack.ts +1 -1
- package/templates/agents-md/bot/lib/collect.ts +1 -1
- package/templates/agents-md/bot/schedules/weekly.ts +6 -6
- package/templates/agents-md/bot/tools/apply_agents.ts +2 -2
- package/templates/agents-md/evals/agents.eval.ts +1 -1
- package/templates/agents-md/evals/evals.config.ts +1 -1
- package/templates/agents-md/package.json +3 -3
- package/templates/code-wiki/README.md +4 -4
- package/templates/code-wiki/bot/agent.ts +1 -1
- package/templates/code-wiki/bot/channels/github.ts +3 -3
- package/templates/code-wiki/bot/tools/apply_wiki.ts +3 -3
- package/templates/code-wiki/evals/evals.config.ts +1 -1
- package/templates/code-wiki/evals/wiki.eval.ts +1 -1
- package/templates/code-wiki/package.json +3 -3
- package/templates/demo/README.md +4 -4
- package/templates/demo/bot/agent.ts +1 -1
- package/templates/demo/bot/channels/github.ts +7 -3
- package/templates/demo/bot/channels/queue.ts +5 -5
- package/templates/demo/bot/lib/collect.ts +2 -2
- package/templates/demo/bot/tools/record_demo.ts +2 -2
- package/templates/demo/evals/demo.eval.ts +1 -1
- package/templates/demo/evals/evals.config.ts +1 -1
- package/templates/demo/package.json +3 -3
- package/templates/pr-autofixer/bot/agent.ts +1 -1
- package/templates/pr-autofixer/bot/channels/drive.ts +1 -1
- package/templates/pr-autofixer/bot/channels/github.ts +3 -3
- package/templates/pr-autofixer/bot/channels/slack.ts +1 -1
- package/templates/pr-autofixer/bot/hooks/bind-agent.ts +1 -1
- package/templates/pr-autofixer/bot/lib/affinity.ts +1 -1
- package/templates/pr-autofixer/bot/lib/drive.ts +2 -2
- package/templates/pr-autofixer/bot/lib/merge-watch.ts +4 -4
- package/templates/pr-autofixer/bot/lib/pr-state.ts +1 -1
- package/templates/pr-autofixer/bot/lib/start-drive.ts +2 -2
- package/templates/pr-autofixer/bot/lib/webhook-buffer.ts +1 -1
- package/templates/pr-autofixer/bot/lib/webhook-routing.ts +1 -1
- package/templates/pr-autofixer/bot/tools/drive_pr.ts +1 -1
- package/templates/pr-autofixer/evals/coordinator.eval.ts +1 -1
- package/templates/pr-autofixer/evals/evals.config.ts +1 -1
- package/templates/pr-autofixer/package.json +3 -3
- package/templates/security-help/.gitignore +4 -0
- package/templates/security-help/README.md +6 -6
- package/templates/security-help/bot/agent.ts +1 -1
- package/templates/security-help/bot/channels/github.ts +1 -1
- package/templates/security-help/bot/channels/slack.ts +1 -1
- package/templates/security-help/bot/lib/pr-first-pass.ts +3 -3
- package/templates/security-help/evals/evals.config.ts +1 -1
- package/templates/security-help/evals/security-help.eval.ts +1 -1
- package/templates/security-help/package.json +2 -2
- package/templates/security-reviewer/README.md +4 -4
- package/templates/security-reviewer/bot/agent.ts +1 -1
- package/templates/security-reviewer/bot/channels/github.ts +2 -2
- package/templates/security-reviewer/bot/tools/post_findings.ts +2 -2
- package/templates/security-reviewer/evals/evals.config.ts +1 -1
- package/templates/security-reviewer/evals/review.eval.ts +1 -1
- package/templates/security-reviewer/package.json +3 -3
- package/templates/thermo-quality-review/README.md +5 -5
- package/templates/thermo-quality-review/bot/agent.ts +1 -1
- package/templates/thermo-quality-review/bot/channels/github.ts +2 -2
- package/templates/thermo-quality-review/bot/tools/post_findings.ts +2 -2
- package/templates/thermo-quality-review/evals/evals.config.ts +1 -1
- package/templates/thermo-quality-review/evals/review.eval.ts +1 -1
- package/templates/thermo-quality-review/package.json +3 -3
- package/templates/thermo-review/README.md +5 -5
- package/templates/thermo-review/bot/agent.ts +1 -1
- package/templates/thermo-review/bot/channels/github.ts +2 -2
- package/templates/thermo-review/bot/tools/post_findings.ts +2 -2
- package/templates/thermo-review/evals/evals.config.ts +1 -1
- package/templates/thermo-review/evals/review.eval.ts +1 -1
- package/templates/thermo-review/package.json +3 -3
- package/templates/triage/README.md +5 -5
- package/templates/triage/bot/agent.ts +1 -1
- package/templates/triage/bot/channels/queue.ts +5 -5
- package/templates/triage/bot/channels/webhook.ts +5 -5
- package/templates/triage/bot/hooks/memory.ts +1 -1
- package/templates/triage/bot/lib/actuate.ts +2 -2
- package/templates/triage/bot/tools/record_triage.ts +1 -1
- package/templates/triage/evals/evals.config.ts +1 -1
- package/templates/triage/evals/triage.eval.ts +1 -1
- package/templates/triage/overlays/jira/README.md +4 -4
- package/templates/triage/overlays/jira/bot/mcp-connections/tracker.ts +1 -1
- package/templates/triage/overlays/linear/README.md +4 -4
- package/templates/triage/overlays/linear/bot/mcp-connections/tracker.ts +1 -1
- package/templates/triage/package.json +3 -3
- package/dist/bin/agent-sdk.js +0 -2
- package/dist/docs/assets/building-with-agents.md.FZXrY8Nk.js +0 -9
- package/dist/docs/assets/building-with-agents.md.FZXrY8Nk.lean.js +0 -1
- package/dist/docs/assets/changelog.md.BvHRIiMH.js +0 -1
- package/dist/docs/assets/changelog.md.BvHRIiMH.lean.js +0 -1
- package/dist/docs/assets/chunks/@localSearchIndexroot.BoDEJQWv.js +0 -1
- package/dist/docs/assets/chunks/channel.D2BTz0L-.js +0 -1
- package/dist/docs/assets/chunks/classDiagram-6PBFFD2Q.DqByliAC.js +0 -1
- package/dist/docs/assets/chunks/classDiagram-v2-HSJHXN6E.DqByliAC.js +0 -1
- package/dist/docs/assets/chunks/clone.CldT1lbQ.js +0 -1
- package/dist/docs/assets/chunks/stateDiagram-v2-QKLJ7IA2.Bb4oMe0P.js +0 -1
- package/dist/docs/assets/deployment.md.3MMWuPeV.js +0 -31
- package/dist/docs/assets/deployment.md.3MMWuPeV.lean.js +0 -1
- package/dist/docs/assets/guides_agent-to-agent.md.CwL5cwuE.lean.js +0 -1
- package/dist/docs/assets/guides_cloud-agents.md.BzbzcOyj.js +0 -9
- package/dist/docs/assets/guides_cloud-agents.md.BzbzcOyj.lean.js +0 -1
- package/dist/docs/assets/guides_convert-automation.md.DMEX9nF-.lean.js +0 -1
- package/dist/docs/assets/guides_export-grokbot.md.qo5bxi4h.js +0 -55
- package/dist/docs/assets/guides_export-grokbot.md.qo5bxi4h.lean.js +0 -1
- package/dist/docs/assets/guides_grokbot-agents.md.BwAykJ7U.js +0 -15
- package/dist/docs/assets/guides_grokbot-agents.md.BwAykJ7U.lean.js +0 -1
- package/dist/docs/assets/guides_migrate.md.CQlGaBKX.js +0 -7
- package/dist/docs/assets/guides_migrate.md.CQlGaBKX.lean.js +0 -1
- package/dist/docs/assets/guides_opentelemetry.md.D4wO7_8v.js +0 -37
- package/dist/docs/assets/guides_opentelemetry.md.D4wO7_8v.lean.js +0 -1
- package/dist/docs/assets/index.md.CAnsLl8D.js +0 -27
- package/dist/docs/assets/index.md.CAnsLl8D.lean.js +0 -1
- package/dist/docs/assets/quickstart.md.D8JDfkKO.lean.js +0 -1
- package/dist/docs/assets/reference_channels.md.CNNIS6K7.js +0 -22
- package/dist/docs/assets/reference_cli.md.1o_TqKdt.js +0 -103
- package/dist/docs/assets/reference_cli.md.1o_TqKdt.lean.js +0 -1
- package/dist/docs/assets/reference_memory.md.BwyJXYZe.js +0 -4
- package/dist/docs/assets/reference_playground.md.q4MI-0td.js +0 -1
- package/dist/docs/assets/templates_grokbot-agents.md.DgpPEs7B.js +0 -5
- package/dist/docs/assets/templates_grokbot-agents.md.DgpPEs7B.lean.js +0 -1
- package/dist/docs/assets/templates_security-reviewer.md.Gh6EF9Us.js +0 -3
- package/dist/docs/assets/templates_thermo-quality-review.md.B77UyTrX.js +0 -3
- package/dist/docs/assets/templates_thermo-review.md.DRJ7mC5U.js +0 -3
- package/dist/docs/assets/troubleshooting.md.DFnoTDlQ.js +0 -1
- package/dist/docs/guides/export-grokbot.html +0 -114
- package/dist/docs/guides/export-grokbot.md +0 -239
- package/dist/docs/guides/grokbot-agents.html +0 -74
- package/dist/docs/guides/grokbot-agents.md +0 -135
- package/dist/docs/templates/grokbot-agents.html +0 -64
- package/dist/docs/templates/grokbot-agents.md +0 -55
- package/dist/extensions/cursor-grokbot-agents/extension.d.ts +0 -77
- package/dist/extensions/cursor-grokbot-agents/extension.d.ts.map +0 -1
- package/dist/extensions/cursor-grokbot-agents/extension.js +0 -70
- 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 -138
- 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/internal/cli-init-grokbot.d.ts +0 -29
- package/dist/internal/cli-init-grokbot.d.ts.map +0 -1
- package/dist/internal/cli-init-grokbot.js +0 -181
- package/dist/internal/convert-grokbot/answers.d.ts +0 -127
- package/dist/internal/convert-grokbot/answers.d.ts.map +0 -1
- package/dist/internal/convert-grokbot/answers.js +0 -445
- package/dist/internal/convert-grokbot/bot.d.ts +0 -50
- package/dist/internal/convert-grokbot/bot.d.ts.map +0 -1
- package/dist/internal/convert-grokbot/bot.js +0 -72
- package/dist/internal/convert-grokbot/checks.d.ts +0 -26
- package/dist/internal/convert-grokbot/checks.d.ts.map +0 -1
- package/dist/internal/convert-grokbot/checks.js +0 -170
- package/dist/internal/convert-grokbot/convert.d.ts +0 -60
- package/dist/internal/convert-grokbot/convert.d.ts.map +0 -1
- package/dist/internal/convert-grokbot/convert.js +0 -470
- package/dist/internal/convert-grokbot/handoff.d.ts +0 -44
- package/dist/internal/convert-grokbot/handoff.d.ts.map +0 -1
- package/dist/internal/convert-grokbot/handoff.js +0 -160
- package/dist/internal/convert-grokbot/recipe.d.ts +0 -61
- package/dist/internal/convert-grokbot/recipe.d.ts.map +0 -1
- package/dist/internal/convert-grokbot/recipe.js +0 -94
- package/dist/internal/convert-grokbot/routine.d.ts +0 -51
- package/dist/internal/convert-grokbot/routine.d.ts.map +0 -1
- package/dist/internal/convert-grokbot/routine.js +0 -128
- package/dist/internal/convert-grokbot/slack.d.ts +0 -28
- package/dist/internal/convert-grokbot/slack.d.ts.map +0 -1
- package/dist/internal/convert-grokbot/slack.js +0 -50
- package/dist/internal/factory-resource-channel.d.ts.map +0 -1
- package/dist/internal/legacy-command-guard.d.ts +0 -24
- package/dist/internal/legacy-command-guard.d.ts.map +0 -1
- package/dist/internal/legacy-command-guard.js +0 -47
- package/dist/internal/runtime-dispatch-runner.d.ts +0 -25
- package/dist/internal/runtime-dispatch-runner.d.ts.map +0 -1
- package/dist/internal/runtime-dispatch-runner.js +0 -35
- package/dist/internal/testing/factory-resource-fixtures.d.ts +0 -64
- package/dist/internal/testing/factory-resource-fixtures.d.ts.map +0 -1
- package/dist/internal/testing/factory-resource-fixtures.js +0 -55
- package/dist/playground/assets/cursor-icons-16-DfKNljMZ.woff2 +0 -0
- package/dist/playground/assets/index-B3_YohwW.js +0 -62
- package/dist/playground/assets/index-Cn3-adsJ.css +0 -1
- package/docs/guides/export-grokbot.md +0 -244
- package/docs/guides/grokbot-agents.md +0 -140
- package/docs/templates/grokbot-agents.md +0 -60
- package/schemas/grokbot-answers.schema.json +0 -354
- package/templates/grokbot-agents/README.md +0 -27
- package/templates/grokbot-agents/bot/agent.ts +0 -6
- package/templates/grokbot-agents/bot/extensions/grokbot.ts +0 -5
- package/templates/grokbot-agents/bot/instructions.md +0 -7
- package/templates/grokbot-agents/evals/evals.config.ts +0 -5
- package/templates/grokbot-agents/evals/grokbot-agents.eval.ts +0 -18
- package/templates/grokbot-agents/init.json +0 -18
- package/templates/grokbot-agents/package.json +0 -17
- package/templates/grokbot-agents/tsconfig.json +0 -12
- /package/dist/docs/assets/{evals.md.CHR34K1Y.lean.js → evals.md.DiljU__Z.lean.js} +0 -0
- /package/dist/docs/assets/{guides_bitbucket.md.CKUayYtD.lean.js → guides_bitbucket.md.DkjkBRU8.lean.js} +0 -0
- /package/dist/docs/assets/{guides_gitlab.md.CtNI4fSH.lean.js → guides_gitlab.md.DCE0p7_w.lean.js} +0 -0
- /package/dist/docs/assets/{guides_pagerduty.md.BHXMcMtx.lean.js → guides_pagerduty.md.mnKXe9U0.lean.js} +0 -0
- /package/dist/docs/assets/{hillclimbing.md.Dxvd-0gT.lean.js → hillclimbing.md.By61f3uq.lean.js} +0 -0
- /package/dist/docs/assets/{reference_artifacts.md.DLV9MZES.lean.js → reference_artifacts.md.C-hKR2hp.lean.js} +0 -0
- /package/dist/docs/assets/{reference_connections.md.BJE2Zllp.lean.js → reference_connections.md.BoAotr7_.lean.js} +0 -0
- /package/dist/docs/assets/{reference_hooks.md.CROr0QgC.lean.js → reference_hooks.md.B-bwJuiG.lean.js} +0 -0
- /package/dist/docs/assets/{reference_http-api.md.Dji-DD_Z.lean.js → reference_http-api.md._RWELr3d.lean.js} +0 -0
- /package/dist/docs/assets/{reference_instructions.md.BYMVxAkw.lean.js → reference_instructions.md.yL2hXLnl.lean.js} +0 -0
- /package/dist/docs/assets/{reference_memory.md.BwyJXYZe.lean.js → reference_memory.md.Dd7cyV9V.lean.js} +0 -0
- /package/dist/docs/assets/{reference_playground.md.q4MI-0td.lean.js → reference_playground.md.CQiJk9CM.lean.js} +0 -0
- /package/dist/docs/assets/{reference_project-layout.md.mFcS8yDD.lean.js → reference_project-layout.md.BamcPDUn.lean.js} +0 -0
- /package/dist/docs/assets/{reference_prompt.md.DqPh71XN.lean.js → reference_prompt.md.BMjm1Jp3.lean.js} +0 -0
- /package/dist/docs/assets/{reference_schedules.md.BqWnJES4.lean.js → reference_schedules.md.RC47aFm4.lean.js} +0 -0
- /package/dist/docs/assets/{reference_sessions.md.Bi6lHttM.lean.js → reference_sessions.md.C7KFhWXV.lean.js} +0 -0
- /package/dist/docs/assets/{reference_subagents.md.ChNGh6HK.lean.js → reference_subagents.md.CAhvW4yS.lean.js} +0 -0
- /package/dist/docs/assets/{templates_agentic-owners.md.CTEnR0jp.lean.js → templates_agentic-owners.md.Dh2nDSqg.lean.js} +0 -0
- /package/dist/docs/assets/{templates_security-reviewer.md.Gh6EF9Us.lean.js → templates_security-reviewer.md.DnwXdnB5.lean.js} +0 -0
- /package/dist/docs/assets/{templates_triage.md.CNN6b0JZ.lean.js → templates_triage.md.BYWMloV4.lean.js} +0 -0
- /package/dist/docs/assets/{troubleshooting.md.DFnoTDlQ.lean.js → troubleshooting.md.CGOdNVAL.lean.js} +0 -0
|
@@ -1,21 +1,29 @@
|
|
|
1
|
-
#
|
|
1
|
+
# Agent SDK CLI
|
|
2
2
|
|
|
3
|
-
The
|
|
3
|
+
The Agent SDK is published as `@grok/agent-sdk` with the `agent-sdk`
|
|
4
4
|
CLI.
|
|
5
5
|
|
|
6
6
|
```text
|
|
7
|
-
|
|
7
|
+
agent-sdk <command>
|
|
8
8
|
```
|
|
9
9
|
|
|
10
|
-
The command catalog below documents the `
|
|
11
|
-
`@
|
|
10
|
+
The command catalog below documents the `agent-sdk` binary from
|
|
11
|
+
`@grok/agent-sdk`. Run it with Node 22.13 or newer; Bun is not
|
|
12
12
|
supported. Commands exit nonzero when validation or a synchronous request fails;
|
|
13
13
|
asynchronous commands can exit `0` once work is accepted. Project paths use the
|
|
14
|
-
[
|
|
14
|
+
[Agent SDK project layout](/docs/reference/project-layout.md).
|
|
15
15
|
|
|
16
|
-
Install `@
|
|
17
|
-
|
|
18
|
-
|
|
16
|
+
Install `@grok/agent-sdk` to obtain the binary. Bare `agent-sdk` prints the command
|
|
17
|
+
index. `agent-sdk <command> --help` prints one command's help, `agent-sdk help --all`
|
|
18
|
+
prints every command, and `agent-sdk help <command> --json` prints one command's
|
|
19
|
+
arguments and flags as JSON.
|
|
20
|
+
|
|
21
|
+
The `bdk` command remains available.
|
|
22
|
+
|
|
23
|
+
Commands are named `agent-sdk <resource> <verb>`, such as `agent-sdk deployment list`,
|
|
24
|
+
except for a few workflow verbs (`init`, `dev`, `run`, `eval`, `deploy`, and
|
|
25
|
+
others). Older names, such as `agent-sdk deployments` or `agent-sdk secrets set`, still
|
|
26
|
+
run for now. Each one prints the new form on stderr.
|
|
19
27
|
|
|
20
28
|
## Command catalog
|
|
21
29
|
|
|
@@ -23,17 +31,16 @@ provide their own `help` subcommands.
|
|
|
23
31
|
|
|
24
32
|
| Command | Contract |
|
|
25
33
|
| --- | --- |
|
|
26
|
-
| `help`, `--help`, `-h` | Print
|
|
34
|
+
| `help`, `--help`, `-h` | Print the command index, or one command's help |
|
|
27
35
|
| [`serve`](#serve) | Serve one or more agents over HTTP |
|
|
28
36
|
| [`dev`](#dev) | Serve agents with local-development behavior |
|
|
29
|
-
| [`docs`](#docs) | Serve the documentation bundled with `@
|
|
30
|
-
| [`init`](#init) | Scaffold
|
|
31
|
-
| [`convert-automation`](#convert-automation) | Export a Cursor Automation into a project |
|
|
37
|
+
| [`docs`](#docs) | Serve the documentation bundled with `@grok/agent-sdk` |
|
|
38
|
+
| [`init`](#init) | Scaffold an Agent SDK project, or convert an Automation |
|
|
32
39
|
| [`migrate`](#migrate) | Move an early-alpha project to architecture v2 through a pull request |
|
|
33
|
-
| [`
|
|
34
|
-
| [`
|
|
40
|
+
| [`skills list`](#skills-install) | List the bundled coding-agent skills and their installed versions |
|
|
41
|
+
| [`skills install`](#skills-install) | Refresh the bundled coding-agent skills |
|
|
42
|
+
| [`info`](#info) | Print the discovered project surface or its deployment manifest |
|
|
35
43
|
| [`validate`](#validate) | Check project diagnostics and set the exit status |
|
|
36
|
-
| [`manifest`](#manifest) | Print deployment metadata as JSON |
|
|
37
44
|
| [`version`](#version) | Print the installed package version |
|
|
38
45
|
| [`update`](#update) | Upgrade the installed CLI |
|
|
39
46
|
| [`login`](#login-logout-whoami) | Sign the host in to Cursor |
|
|
@@ -44,50 +51,47 @@ provide their own `help` subcommands.
|
|
|
44
51
|
|
|
45
52
|
| Command | Contract |
|
|
46
53
|
| --- | --- |
|
|
47
|
-
| [`chat`](#chat) | Talk to a running agent |
|
|
48
|
-
| [`
|
|
49
|
-
| [`
|
|
50
|
-
| [`call`](#call) | Call a server tool without a model turn |
|
|
51
|
-
| [`skill`](#skill) | Read an authored skill without a model turn |
|
|
54
|
+
| [`chat`](#chat) | Talk to a running agent, or reattach a session |
|
|
55
|
+
| [`run`](#run) | Run turns on a local or running agent |
|
|
56
|
+
| [`tool call`](#tool-call) | Call a server tool without a model turn |
|
|
52
57
|
| [`logs`](#logs) | Follow or dump agent logs |
|
|
53
|
-
| [`
|
|
54
|
-
| [`session`](#session) | Inspect a session or
|
|
55
|
-
| [`
|
|
56
|
-
| [`
|
|
57
|
-
| [`trajectory`](#trajectory) | Summarize a saved event stream |
|
|
58
|
-
| [`eval`](#eval) | List, run, inspect, or cancel evals |
|
|
58
|
+
| [`session list`](#session-list) | List sessions, or their costs |
|
|
59
|
+
| [`session get`](#session-get) | Inspect a session or a saved trace, or open it in the playground |
|
|
60
|
+
| [`session create`](#session-create) | Start or continue a hosted session |
|
|
61
|
+
| [`eval`](#eval) | Run evals, or list, get, and cancel remote eval batches |
|
|
59
62
|
|
|
60
63
|
### Managed hosting commands
|
|
61
64
|
|
|
62
65
|
| Command | Contract |
|
|
63
66
|
| --- | --- |
|
|
64
67
|
| [`deploy`](#deploy) | Deploy one or more agents |
|
|
65
|
-
| [`
|
|
66
|
-
| [`deployment`](#deployment) | Inspect one deployment |
|
|
67
|
-
| [`stop`](#stop) | Stop a deployment |
|
|
68
|
-
| [`start`](#start) | Start a stopped deployment |
|
|
69
|
-
| [`kill`](#kill) | Stop a deployment, cancel its runs, and lock deploys |
|
|
70
|
-
| [`unlock
|
|
71
|
-
| [`cancel-runs`](#cancel-runs) | Cancel active runs and reminder wakes |
|
|
72
|
-
| [`
|
|
73
|
-
| [`upgrade`](#upgrade) | Move a deployment to a release |
|
|
74
|
-
| [`rollback`](#rollback) | Move a deployment to an earlier release |
|
|
75
|
-
| [`delete`](#delete) | Delete a deployment |
|
|
76
|
-
| [`rotate-token`](#rotate-token) | Replace a deployment's alias token |
|
|
77
|
-
| [`
|
|
78
|
-
| [`
|
|
68
|
+
| [`deployment list`](#deployment-list) | List deployments |
|
|
69
|
+
| [`deployment get`](#deployment-get) | Inspect one deployment |
|
|
70
|
+
| [`deployment stop`](#deployment-stop) | Stop a deployment |
|
|
71
|
+
| [`deployment start`](#deployment-start) | Start a stopped deployment |
|
|
72
|
+
| [`deployment kill`](#deployment-kill) | Stop a deployment, cancel its runs, and lock deploys |
|
|
73
|
+
| [`deployment unlock`](#deployment-unlock) | Let a killed deployment deploy again |
|
|
74
|
+
| [`deployment cancel-runs`](#deployment-cancel-runs) | Cancel active runs and reminder wakes |
|
|
75
|
+
| [`deployment update`](#deployment-update) | Replace a deployment's event repositories |
|
|
76
|
+
| [`deployment upgrade`](#deployment-upgrade) | Move a deployment to a release |
|
|
77
|
+
| [`deployment rollback`](#deployment-rollback) | Move a deployment to an earlier release |
|
|
78
|
+
| [`deployment delete`](#deployment-delete) | Delete a deployment |
|
|
79
|
+
| [`deployment rotate-token`](#deployment-rotate-token) | Replace a deployment's alias token |
|
|
80
|
+
| [`secret`](#secret) | Set, list, or delete deployment secrets |
|
|
81
|
+
| [`image`](#image) | Push, list, or delete container images for persistent agents |
|
|
79
82
|
|
|
80
83
|
### Connection and channel commands
|
|
81
84
|
|
|
82
85
|
| Command | Contract |
|
|
83
86
|
| --- | --- |
|
|
84
|
-
| [`mcp`](#mcp) | Proxy an agent's MCP endpoint over stdio |
|
|
87
|
+
| [`mcp serve`](#mcp) | Proxy an agent's MCP endpoint over stdio |
|
|
85
88
|
| [`mcp install`](#mcp) | Add the agent to an MCP client config |
|
|
86
89
|
| [`mcp oauth`](#mcp-oauth) | Authorize an MCP connection |
|
|
87
90
|
| [`slack`](#slack) | Provision and check Slack channel apps |
|
|
88
91
|
| [`github`](#github) | Forward, replay, and inspect GitHub webhooks |
|
|
89
92
|
| [`gitlab`](#gitlab) | Replay and inspect GitLab webhooks |
|
|
90
93
|
| [`bitbucket`](#bitbucket) | Replay and inspect Bitbucket webhooks |
|
|
94
|
+
| [`pagerduty`](#pagerduty) | Replay and inspect PagerDuty webhooks |
|
|
91
95
|
|
|
92
96
|
## Targets {#choose-a-target}
|
|
93
97
|
|
|
@@ -95,10 +99,10 @@ Commands that send requests support these targets:
|
|
|
95
99
|
|
|
96
100
|
| Target | Selection | Commands |
|
|
97
101
|
| --- | --- | --- |
|
|
98
|
-
| Ephemeral local server | Omit `--url` and `--prod` | `run`, `call`, `
|
|
99
|
-
| Running server | Pass `--url <baseUrl>` | `chat`, `
|
|
100
|
-
| Default local server | Omit `--url` and `--prod`; uses `http://127.0.0.1:3000` | `chat`, `
|
|
101
|
-
| Hosted deployment | Pass `--prod` | `
|
|
102
|
+
| Ephemeral local server | Omit `--url` and `--prod` | `run`, `tool call`, `eval` |
|
|
103
|
+
| Running server | Pass `--url <baseUrl>` | `chat`, `run`, `tool call`, `eval`, `logs`, `session list`, `session get`, `mcp serve` |
|
|
104
|
+
| Default local server | Omit `--url` and `--prod`; uses `http://127.0.0.1:3000` | `chat`, `logs`, `session list`, `session get` |
|
|
105
|
+
| Hosted deployment | Pass `--prod` | `session list`, `session get`, `logs`; `session create` is always hosted |
|
|
102
106
|
|
|
103
107
|
An explicit `--url` must include the slug for a multi-agent server, such as
|
|
104
108
|
`http://127.0.0.1:3000/pr-approver`. `--slug` never changes an explicit URL.
|
|
@@ -108,13 +112,13 @@ An explicit `--url` must include the slug for a multi-agent server, such as
|
|
|
108
112
|
| --- | --- |
|
|
109
113
|
| `--dir <path>` | Select the project root. The default is the current directory. |
|
|
110
114
|
| `--url <baseUrl>` | Use a running agent instead of local project discovery. |
|
|
111
|
-
| `--prod` | Use the hosted deployment.
|
|
115
|
+
| `--prod` | Use the hosted deployment. `session list`, `session get`, and `logs` accept it; `chat`, `run`, `tool call`, `mcp serve`, and `eval` exit with a usage error. |
|
|
112
116
|
| `--slug <slug>` | Select an agent from a multi-agent project or a hosted deployment. Under `--prod`, the default is the `--dir` basename. |
|
|
113
117
|
| `--team <id>` | Select a Cursor team. The signed-in account's team is the default. |
|
|
114
118
|
| `--api-key <key>` | Override the Cursor credential for commands that authenticate with Cursor. |
|
|
115
119
|
| `--bearer-token <token>` | Authenticate to a running server with a bearer token. |
|
|
116
|
-
| `--state-root <path>` | Select local state for `serve` and ephemeral `run`, `call`,
|
|
117
|
-
| `--json` |
|
|
120
|
+
| `--state-root <path>` | Select local state for `serve` and ephemeral `run`, `tool call`, and `eval` targets. Running and `--prod` targets ignore it. |
|
|
121
|
+
| `--json` | Print one JSON document on stdout, errors included (`{"error":{"code","message","hint"}}`). Without it, output is text, also when piped. `agent-sdk help` lists the exit codes. |
|
|
118
122
|
|
|
119
123
|
## Local servers
|
|
120
124
|
|
|
@@ -123,13 +127,12 @@ An explicit `--url` must include the slug for a multi-agent server, such as
|
|
|
123
127
|
`serve` mounts every project discovered under `--dir`:
|
|
124
128
|
|
|
125
129
|
```text
|
|
126
|
-
|
|
130
|
+
agent-sdk serve [--dir <path>] [--port <n>] [--host <host>]
|
|
127
131
|
[--mode multi|single] [--dev] [--api-key <key>]
|
|
128
132
|
[--state-root <path>]
|
|
129
133
|
[--bearer-token <secret> | --allow-anonymous]
|
|
130
134
|
[--allow-anonymous-cursor-github]
|
|
131
135
|
[--allow-anonymous-cursor-account-mcp]
|
|
132
|
-
[--allow-anonymous-grokbot]
|
|
133
136
|
[--public-url <url>]
|
|
134
137
|
[--peers-url <url>]
|
|
135
138
|
[--no-schedules] [--no-playground] [--no-docs]
|
|
@@ -148,7 +151,6 @@ bdk serve [--dir <path>] [--port <n>] [--host <host>]
|
|
|
148
151
|
| `--allow-anonymous` | Admit callers as one anonymous principal. Use it only behind a trusted network boundary. |
|
|
149
152
|
| `--allow-anonymous-cursor-github` | Let anonymous callers use sessions with a Cursor account's repository-scoped GitHub credential. Requires an authenticating proxy. |
|
|
150
153
|
| `--allow-anonymous-cursor-account-mcp` | Let anonymous callers use Cursor account MCP connections. Requires an authenticating proxy. |
|
|
151
|
-
| `--allow-anonymous-grokbot` | Let anonymous callers drive hosted Grok Bot runtime agents. Requires an authenticating proxy. |
|
|
152
154
|
| `--public-url <url>` | Set the externally reachable base URL that turns running off the serve host use for peer MCP and host bridges. It does not expose the server; configure the listener or proxy separately. Local-runtime peers use loopback. |
|
|
153
155
|
| `--peers-url <url>` | Resolve declared peers for a single-agent serve through a hosting-provided peer service. Cursor-managed hosting sets this option automatically; a multi-agent serve rejects it. |
|
|
154
156
|
| `--no-schedules` | Disable schedule firing outside dev mode. |
|
|
@@ -164,8 +166,8 @@ digits, `_`, or `-`. The reserved slugs are `v1`, `playground`, and `docs`.
|
|
|
164
166
|
`dev` is `serve --dev` with an optional positional project path:
|
|
165
167
|
|
|
166
168
|
```text
|
|
167
|
-
|
|
168
|
-
|
|
169
|
+
agent-sdk dev
|
|
170
|
+
agent-sdk dev ./agent-sdk-pr-reviewer --port 3000
|
|
169
171
|
```
|
|
170
172
|
|
|
171
173
|
It accepts every `serve` option. Pass at most one positional path, and don't
|
|
@@ -174,7 +176,7 @@ combine it with a different `--dir`.
|
|
|
174
176
|
### Serve the docs {#docs}
|
|
175
177
|
|
|
176
178
|
```text
|
|
177
|
-
|
|
179
|
+
agent-sdk docs [--port <n>] [--host 127.0.0.1] [--print]
|
|
178
180
|
```
|
|
179
181
|
|
|
180
182
|
`docs` serves the bundled documentation without an agent project. It uses an
|
|
@@ -188,7 +190,7 @@ prints the URL without opening a browser.
|
|
|
188
190
|
`chat` connects to a running server and never starts an ephemeral one:
|
|
189
191
|
|
|
190
192
|
```text
|
|
191
|
-
|
|
193
|
+
agent-sdk chat [--url <baseUrl>] [--message <text>]
|
|
192
194
|
[--session <id> | --resume] [--continuation-token <token>]
|
|
193
195
|
[--slug <slug>] [--json] [--text] [--no-color]
|
|
194
196
|
```
|
|
@@ -202,149 +204,153 @@ bdk chat [--url <baseUrl>] [--message <text>]
|
|
|
202
204
|
| `--json --message <text>` | Send one turn and print `{ ok, sessionId, continuationToken, trajectory }`. |
|
|
203
205
|
| `--json --text --message <text>` | Print a compact trajectory instead of JSON. |
|
|
204
206
|
|
|
205
|
-
Use `--session <id>` to reattach a stored session
|
|
206
|
-
`--continuation-token`, the CLI looks it up from the target's
|
|
207
|
-
`--resume` selects the most recently updated session with a
|
|
208
|
-
token. An explicit session ID takes precedence.
|
|
209
|
-
|
|
210
|
-
### Resume a session {#resume}
|
|
211
|
-
|
|
212
|
-
`resume` provides the same reattachment contract as `chat --session`:
|
|
213
|
-
|
|
214
|
-
```text
|
|
215
|
-
bdk resume [sessionId] [--url <baseUrl>]
|
|
216
|
-
[--message <text>] [--json] [--text]
|
|
217
|
-
[--continuation-token <token>] [--slug <slug>]
|
|
218
|
-
```
|
|
219
|
-
|
|
220
|
-
Omit the session ID to select the most recently updated followable session.
|
|
221
|
-
The command replays the transcript before accepting follow-ups.
|
|
222
|
-
`resume --json` requires `--message`.
|
|
207
|
+
Use `--session <id>` to reattach a stored session and replay its transcript.
|
|
208
|
+
If you omit `--continuation-token`, the CLI looks it up from the target's
|
|
209
|
+
session list. `--resume` selects the most recently updated session with a
|
|
210
|
+
continuation token. An explicit session ID takes precedence.
|
|
223
211
|
|
|
224
212
|
### Run turns {#run}
|
|
225
213
|
|
|
226
|
-
`run` sends messages to an ephemeral
|
|
214
|
+
`run` sends messages to an ephemeral local server or a running server:
|
|
227
215
|
|
|
228
216
|
```text
|
|
229
|
-
|
|
230
|
-
[--messages-file <path>] [--url <baseUrl>
|
|
217
|
+
agent-sdk run [--dir <path>] [--message <text>]...
|
|
218
|
+
[--messages-file <path>] [--url <baseUrl>]
|
|
231
219
|
[--session <id>] [--continuation-token <token>]
|
|
232
|
-
[--
|
|
233
|
-
[--timeout-ms <n>] [--no-stream] [--slug <slug>] [--
|
|
234
|
-
[--dry-run] [--as-of <instant>] [--component <key>]
|
|
220
|
+
[--trace <file> | --no-trace] [--json]
|
|
221
|
+
[--timeout-ms <n>] [--no-stream] [--slug <slug>] [--dry-run]
|
|
235
222
|
```
|
|
236
223
|
|
|
237
224
|
| Option | Contract |
|
|
238
225
|
| --- | --- |
|
|
239
|
-
| `--message <text>` | Send a user message. Repeat it for a multi-turn
|
|
226
|
+
| `--message <text>` | Send a user message. Repeat it for a multi-turn run. |
|
|
240
227
|
| `--messages-file <path>` | Read a JSON array of strings. File messages run before repeated `--message` values. |
|
|
241
|
-
| `--session <id>` | Continue a session
|
|
242
|
-
| `--continuation-token <token>` | Continue the session selected by `--session` on a running server.
|
|
243
|
-
| `--
|
|
244
|
-
| `--no-
|
|
245
|
-
| `--
|
|
228
|
+
| `--session <id>` | Continue a session on the target. |
|
|
229
|
+
| `--continuation-token <token>` | Continue the session selected by `--session` on a running server. |
|
|
230
|
+
| `--trace <file>` | Write the raw NDJSON stream to this path. |
|
|
231
|
+
| `--no-trace` | Skip the NDJSON trace. |
|
|
232
|
+
| `--json` | Print the JSON result instead of the compact trajectory. |
|
|
246
233
|
| `--timeout-ms <n>` | Stop waiting after a positive number of milliseconds. There is no default timeout. |
|
|
247
234
|
| `--no-stream` | Hide live tool and reply progress on stderr. |
|
|
248
|
-
| `--dry-run` |
|
|
249
|
-
| `--as-of <instant>` | Freeze a `--prod` session's clock at an ISO-8601 instant with a timezone, such as `2026-08-31T12:00:00Z`. |
|
|
250
|
-
| `--component <key>` | Wake a named component of a `--prod` deployment instead of its default. A continued session must belong to that component. |
|
|
235
|
+
| `--dry-run` | Send nothing. Print the request the run would send. A local run starts no server. |
|
|
251
236
|
|
|
252
|
-
|
|
253
|
-
|
|
254
|
-
and `trajectory`. The `trace` value
|
|
255
|
-
enabled.
|
|
237
|
+
Text output is the compact trajectory, with the session ID and trace path on
|
|
238
|
+
stderr. `--json` output contains `ok`, `sessionId`, `continuationToken`,
|
|
239
|
+
`trace`, `playgroundUrl`, `visualize`, and `trajectory`. The `trace` value
|
|
240
|
+
gives the saved path when trace output is enabled.
|
|
256
241
|
|
|
257
|
-
|
|
258
|
-
exits `0` before the turn outcome is known. It prints `deliveryId`,
|
|
259
|
-
`workflowId`, and `sessionMode`, plus `dryRun` and `asOf` when set. A fresh
|
|
260
|
-
start has no `sessionId` yet; a continuation echoes the `--session` value.
|
|
261
|
-
`--events`, `--no-events`, `--text`, `--timeout-ms`, and `--no-stream` have no
|
|
262
|
-
effect. See [Verify a hosted turn](/docs/deployment.md#verify-a-hosted-turn) for
|
|
263
|
-
finding and following the new session.
|
|
242
|
+
For the hosted deployment, use [`session create`](#session-create).
|
|
264
243
|
|
|
265
|
-
### Call a tool {#call}
|
|
244
|
+
### Call a tool {#tool-call}
|
|
266
245
|
|
|
267
|
-
`call` invokes a server tool without a model turn:
|
|
246
|
+
`tool call` invokes a server tool without a model turn:
|
|
268
247
|
|
|
269
248
|
```text
|
|
270
|
-
|
|
249
|
+
agent-sdk tool call <tool> [--input <json>]
|
|
271
250
|
[--dir <path> | --url <baseUrl>]
|
|
272
|
-
[--session <id>] [--slug <slug>]
|
|
251
|
+
[--session <id>] [--slug <slug>] [--json]
|
|
273
252
|
```
|
|
274
253
|
|
|
275
254
|
`--input` accepts JSON and defaults to `{}`. `--session` uses the session
|
|
276
255
|
workspace and records the call on its event stream. The command prints the
|
|
277
|
-
|
|
278
|
-
|
|
256
|
+
tool result (a string as is, anything else as JSON). `--json` prints the
|
|
257
|
+
server's full JSON response. The command succeeds only when the HTTP response
|
|
258
|
+
succeeds with `ok: true`.
|
|
279
259
|
|
|
280
|
-
Hosted deployments don't support `call`. Start a model turn with
|
|
281
|
-
|
|
260
|
+
Hosted deployments don't support `tool call`. Start a model turn with
|
|
261
|
+
[`session create`](#session-create) and check it with
|
|
262
|
+
[`session get`](#session-get).
|
|
282
263
|
|
|
283
264
|
See [Tools](/docs/reference/tools.md#call-a-tool-without-a-model-turn) for validation,
|
|
284
265
|
busy-session behavior, and error codes.
|
|
285
266
|
|
|
286
|
-
###
|
|
287
|
-
|
|
288
|
-
`skill` reads an authored skill without a model turn:
|
|
267
|
+
### List sessions {#session-list}
|
|
289
268
|
|
|
290
269
|
```text
|
|
291
|
-
|
|
292
|
-
[--slug <slug>] [--
|
|
293
|
-
|
|
294
|
-
|
|
295
|
-
The default output is the server's JSON response. `--text` prints the rendered
|
|
296
|
-
`SKILL.md` content.
|
|
297
|
-
|
|
298
|
-
### List sessions {#sessions}
|
|
299
|
-
|
|
300
|
-
```text
|
|
301
|
-
bdk sessions [--url <baseUrl>]
|
|
302
|
-
[--slug <slug>] [--bearer-token <token>] [--json]
|
|
270
|
+
agent-sdk session list [--url <baseUrl> | --prod] [--since <duration|instant>]
|
|
271
|
+
[--view sessions|cost] [--slug <slug>] [--team <id>]
|
|
272
|
+
[--bearer-token <token>] [--limit <n>] [--page-token <token>] [--json]
|
|
303
273
|
```
|
|
304
274
|
|
|
305
275
|
Text output shows the session ID, channel, mode, turn count, running status,
|
|
306
|
-
and update time. `--json` prints `{
|
|
307
|
-
tokens.
|
|
276
|
+
and update time. `--json` prints `{ items, nextPageToken }`, including
|
|
277
|
+
continuation tokens. `--limit` (default 20, at most 100) sets the page size,
|
|
278
|
+
and `--page-token` reads the next page.
|
|
279
|
+
|
|
280
|
+
With `--prod`, `session list` lists the hosted deployment's most recently
|
|
281
|
+
active sessions; `--since 24h` (or an ISO-8601 date or instant) reads back to
|
|
282
|
+
that cutoff, up to `--limit` sessions. Check one with
|
|
283
|
+
[`session get <sessionId> --prod`](#session-get).
|
|
308
284
|
|
|
309
|
-
|
|
310
|
-
|
|
311
|
-
|
|
285
|
+
`--view cost` prints token usage per session and a total from a running
|
|
286
|
+
server. Turns saved before cost tracking appear as unpriced. `--json` prints
|
|
287
|
+
`{ sessions }`. `--prod` doesn't support this view.
|
|
312
288
|
|
|
313
|
-
### Inspect a session {#session}
|
|
289
|
+
### Inspect a session {#session-get}
|
|
314
290
|
|
|
315
291
|
```text
|
|
316
|
-
|
|
292
|
+
agent-sdk session get <sessionId> [--url <baseUrl> | --prod]
|
|
317
293
|
[--slug <slug>] [--team <id>]
|
|
318
|
-
[--
|
|
294
|
+
[--view trajectory|events|cost] [--json [--fields <a,b.c>]]
|
|
295
|
+
[--trace <file.ndjson>] [--web [--print]]
|
|
319
296
|
|
|
320
|
-
|
|
321
|
-
[--team <id>] [--dry-run] [--as-of <instant>] [--component <key>]
|
|
297
|
+
agent-sdk session get --file <file.ndjson> [--json]
|
|
322
298
|
```
|
|
323
299
|
|
|
324
300
|
| Option | Contract |
|
|
325
301
|
| --- | --- |
|
|
326
|
-
| No
|
|
327
|
-
| `--text` | Select the compact trajectory explicitly. |
|
|
302
|
+
| No option | Print a compact trajectory. |
|
|
328
303
|
| `--json` | Print the trajectory object. |
|
|
329
|
-
| `--events` | Print `{ sessionId, events }` with the raw event list. |
|
|
330
|
-
| `--
|
|
331
|
-
| `--
|
|
304
|
+
| `--view events` | Print `{ sessionId, events }` with the raw event list. With `--prod`, each tool call is an `actions.requested` or `action.result` event. The tool name is `toolName`. |
|
|
305
|
+
| `--view cost` | Print per-turn token usage and estimated cost from a running server. `--prod` doesn't support it. |
|
|
306
|
+
| `--trace <file.ndjson>` | Write the raw NDJSON trace instead of printing it. Not available with `--prod`. |
|
|
307
|
+
| `--file <file.ndjson>` | Read a saved trace (for example from `run --trace`) instead of a server, and print its trajectory. |
|
|
308
|
+
| `--web` | Open the session in the playground, or the [Deployed Agents](https://cursor.com/dashboard/deployed-agents) playground with `--prod`. `--print` prints the URL only. A running target with credentials that a browser can't send starts a loopback proxy and stays open until Ctrl-C. |
|
|
332
309
|
|
|
333
|
-
|
|
334
|
-
|
|
310
|
+
Use [`chat --session`](#chat) to continue a conversational session on a
|
|
311
|
+
local or running server.
|
|
335
312
|
|
|
336
313
|
With `--prod`, the command prints the session's hosted executions: one line
|
|
337
314
|
per run with its status, duration, and time, followed by that run's log
|
|
338
|
-
lines.
|
|
339
|
-
|
|
340
|
-
|
|
341
|
-
`
|
|
342
|
-
|
|
315
|
+
lines. When the deployment stored process output, a `Process output:` section
|
|
316
|
+
prints that output next. `--json` prints `{ sessionId, executions, startLog, ... }`.
|
|
317
|
+
`startLog` is the process output, or `null` when none is stored.
|
|
318
|
+
`--view events` prints `{ sessionId, events }`. `--trace` isn't available.
|
|
319
|
+
While a turn is running, text output also reports the event count and latest
|
|
320
|
+
event type and prints `Turn running; runs may lag behind events.` A run can
|
|
321
|
+
show `running` with no logs until the turn ends, so a growing event count is
|
|
322
|
+
the progress signal.
|
|
323
|
+
|
|
324
|
+
### Start a hosted session {#session-create}
|
|
325
|
+
|
|
326
|
+
```text
|
|
327
|
+
agent-sdk session create --message <text> [--session <ses_...>]
|
|
328
|
+
[--slug <slug>] [--team <id>] [--wait [--timeout-ms <n>]]
|
|
329
|
+
[--read-only] [--as-of <instant>] [--component <key>] [--dry-run] [--json]
|
|
330
|
+
```
|
|
331
|
+
|
|
332
|
+
| Option | Contract |
|
|
333
|
+
| --- | --- |
|
|
334
|
+
| `--message <text>` | The message to send. Exactly one. |
|
|
335
|
+
| `--session <ses_...>` | Continue a hosted session that `session create` started. Slack, SCM, and custom-route sessions can't be continued this way. |
|
|
336
|
+
| `--wait` | Poll the delivery until it names the session, then print it. Exit `3` (`pending`) when `--timeout-ms` (default 120000) passes first. A skipped or failed delivery exits `1`. |
|
|
337
|
+
| `--read-only` | Run read tools and stub write tools. |
|
|
338
|
+
| `--as-of <instant>` | Freeze the session's clock at an ISO-8601 instant with a timezone, such as `2026-08-31T12:00:00Z`. |
|
|
339
|
+
| `--component <key>` | Wake a named component instead of the deployment's default. A continued session must belong to that component. |
|
|
340
|
+
| `--dry-run` | Send nothing. Print the request it would send. |
|
|
341
|
+
|
|
342
|
+
Without `--wait`, the command returns as soon as the deployment accepts the
|
|
343
|
+
turn and exits `0` before the turn outcome is known. It prints the delivery
|
|
344
|
+
ID, the session ID when known, and the session mode. `--json` prints
|
|
345
|
+
`deliveryId`, `workflowId`, `sessionMode`, and `sessionId` when known, plus
|
|
346
|
+
`dryRun` and `asOf` when set. A fresh start has no `sessionId` until the turn
|
|
347
|
+
starts; a continuation echoes the `--session` value. See
|
|
348
|
+
[Verify a hosted turn](/docs/deployment.md#verify-a-hosted-turn).
|
|
343
349
|
|
|
344
350
|
### Follow logs {#logs}
|
|
345
351
|
|
|
346
352
|
```text
|
|
347
|
-
|
|
353
|
+
agent-sdk logs [sessionId] [--url <baseUrl> | --prod]
|
|
348
354
|
[--session <sessionId>] [--slug <slug>] [--team <id>] [--once] [--json]
|
|
349
355
|
```
|
|
350
356
|
|
|
@@ -352,44 +358,15 @@ The command follows logs until Ctrl-C. `--once` prints the current buffer and
|
|
|
352
358
|
exits; `--json` emits newline-delimited JSON events. With `--prod`, it follows
|
|
353
359
|
the output of the hosted deployment's most recent sessions on every channel
|
|
354
360
|
and prints a `==> <sessionId> (<channel>) <==` header each time the output
|
|
355
|
-
switches sessions.
|
|
356
|
-
|
|
361
|
+
switches sessions. A persistent deployment also prints a `==> process-output <==`
|
|
362
|
+
block. That block is the process log that [Deployed Agents](https://cursor.com/dashboard/deployed-agents) shows for the deployment.
|
|
363
|
+
Pass a session ID, as an argument or with `--session`, to follow only that
|
|
364
|
+
session; a session ID requires `--prod`. The session view starts with
|
|
365
|
+
`Process output:` for the deployment process log and `Session process output:`
|
|
366
|
+
for that session's own process output, and a `tool <name>` line for each tool
|
|
367
|
+
call. Hosted log events
|
|
357
368
|
carry `sessionId` and `line` rather than `index` and `at`.
|
|
358
369
|
|
|
359
|
-
### Report costs {#cost}
|
|
360
|
-
|
|
361
|
-
```text
|
|
362
|
-
bdk cost [sessionId] [--url <baseUrl>]
|
|
363
|
-
[--slug <slug>] [--json]
|
|
364
|
-
```
|
|
365
|
-
|
|
366
|
-
With a session ID, `cost` prints per-turn token usage and estimated cost.
|
|
367
|
-
Without one, it prints one row per session and a total. Turns saved before
|
|
368
|
-
cost tracking appear as unpriced. `--json` prints the underlying report or
|
|
369
|
-
`{ sessions }` for an aggregate.
|
|
370
|
-
|
|
371
|
-
### Open the playground {#playground}
|
|
372
|
-
|
|
373
|
-
```text
|
|
374
|
-
bdk playground [--url <baseUrl> | --prod] [--session <id>]
|
|
375
|
-
[--slug <slug>] [--team <id>] [--bearer-token <token>] [--print]
|
|
376
|
-
```
|
|
377
|
-
|
|
378
|
-
The command prints the playground URL and opens it unless `--print` is set.
|
|
379
|
-
`--session` opens a deep link. A running target with credentials that a
|
|
380
|
-
browser can't send starts a loopback proxy and stays open until Ctrl-C.
|
|
381
|
-
With `--prod`, the URL opens the deployment's playground under **Deployed
|
|
382
|
-
Agents** in the dashboard.
|
|
383
|
-
|
|
384
|
-
### Inspect a trajectory {#trajectory}
|
|
385
|
-
|
|
386
|
-
```text
|
|
387
|
-
bdk trajectory --events <file.ndjson> [--text]
|
|
388
|
-
```
|
|
389
|
-
|
|
390
|
-
The command converts an NDJSON stream into the trajectory JSON returned by
|
|
391
|
-
`run`. `--text` prints the compact view.
|
|
392
|
-
|
|
393
370
|
## Evals
|
|
394
371
|
|
|
395
372
|
### Run evals {#eval}
|
|
@@ -397,7 +374,7 @@ The command converts an NDJSON stream into the trajectory JSON returned by
|
|
|
397
374
|
`eval` discovers `evals/**/*.eval.{ts,js}` and runs selected cases:
|
|
398
375
|
|
|
399
376
|
```text
|
|
400
|
-
|
|
377
|
+
agent-sdk eval [--dir <path>] [evalId...]
|
|
401
378
|
[--list] [--tag <tag>]... [--json] [--verbose]
|
|
402
379
|
[--timeout-ms <n>] [--strict] [--max-concurrency <n>]
|
|
403
380
|
[--junit <path>] [--artifacts <dir> | --no-artifacts]
|
|
@@ -406,9 +383,10 @@ bdk eval [--dir <path>] [evalId...]
|
|
|
406
383
|
```
|
|
407
384
|
|
|
408
385
|
Select an exact case such as `weather/nyc`, a file prefix such as `weather`,
|
|
409
|
-
several IDs, or no IDs for every case. Repeat `--tag` for OR matching.
|
|
410
|
-
|
|
411
|
-
|
|
386
|
+
several IDs, or no IDs for every case. Repeat `--tag` for OR matching. To run
|
|
387
|
+
an eval whose ID is a subcommand word (`list`, `get`, `cancel`), put it after
|
|
388
|
+
`--`, as in `agent-sdk eval -- list`. Projects must provide
|
|
389
|
+
`evals/evals.config.{ts,js}` with `maxConcurrency` between 1 and 200.
|
|
412
390
|
|
|
413
391
|
| Option | Contract |
|
|
414
392
|
| --- | --- |
|
|
@@ -431,79 +409,50 @@ A running server prints its Eval ID when it accepts the batch.
|
|
|
431
409
|
Use these commands to inspect or cancel it:
|
|
432
410
|
|
|
433
411
|
```text
|
|
434
|
-
|
|
435
|
-
|
|
412
|
+
agent-sdk eval list --url <baseUrl> [--limit <n>] [--page-token <token>]
|
|
413
|
+
agent-sdk eval get <evalId> --url <baseUrl> [--out <file.json>]
|
|
414
|
+
agent-sdk eval cancel <evalId> --url <baseUrl>
|
|
436
415
|
```
|
|
437
416
|
|
|
438
|
-
`eval
|
|
439
|
-
|
|
417
|
+
`eval list` lists recent remote runs. `eval get` exits `3` (`pending`) while
|
|
418
|
+
the batch still runs. All three require `--url`.
|
|
440
419
|
|
|
441
420
|
## Projects
|
|
442
421
|
|
|
443
422
|
### Scaffold a project {#init}
|
|
444
423
|
|
|
445
424
|
```text
|
|
446
|
-
|
|
447
|
-
|
|
448
|
-
[--answers <file>] [--dry-run] [--json]
|
|
425
|
+
agent-sdk init [directory] [--template <name>] [--var id=value]... [--json] [--dry-run]
|
|
426
|
+
agent-sdk init [directory] --from automation:<url-or-uuid> [--dry-run] [--json]
|
|
449
427
|
```
|
|
450
428
|
|
|
451
429
|
Without a directory, `init` prints the setup guide and changes no files. With
|
|
452
430
|
a directory, it preserves existing scaffold files, adds missing files,
|
|
453
|
-
installs dependencies, and tries to put `
|
|
431
|
+
installs dependencies, and tries to put `agent-sdk` on `PATH`.
|
|
454
432
|
|
|
455
433
|
| Option | Contract |
|
|
456
434
|
| --- | --- |
|
|
457
|
-
| `--template <name>` | Use a bundled template: `agentic-owners`, `agents-md`, `code-wiki`, `demo`, `
|
|
435
|
+
| `--template <name>` | Use a bundled template: `agentic-owners`, `agents-md`, `code-wiki`, `demo`, `security-help`, `security-reviewer`, `thermo-quality-review`, `thermo-review`, `triage-jira`, or `triage-linear`. `triage` selects `triage-linear`. |
|
|
458
436
|
| `--var id=value` | Answer a template question without a prompt. Repeat for multiple answers. |
|
|
459
437
|
| `--json` | Skip interactive login and skill prompts, then print `{ ok, directory, template, created, skipped, installed, installError, cliOnPath, cliLinkError, next }`. `ok` reflects dependency installation. |
|
|
438
|
+
| `--dry-run` | List the files `init` would create. Write and install nothing. |
|
|
460
439
|
|
|
461
440
|
On a TTY, templates with questions run their interview before writing files.
|
|
462
441
|
`init` also offers to refresh the bundled coding-agent skills and starts login
|
|
463
442
|
when the host has no Cursor credential.
|
|
464
443
|
|
|
465
|
-
|
|
466
|
-
|
|
467
|
-
`--from-grokbot` reads a Grok Bot recipe and maps its profile, selected skills
|
|
468
|
-
and routines, memory, channels, and connectors into a BDK project. The target
|
|
469
|
-
directory defaults to the resolved `location` answer; a positional directory
|
|
470
|
-
overrides it. A target previously created with `bdk init --template` is
|
|
471
|
-
rejected; export into a fresh directory instead.
|
|
472
|
-
|
|
473
|
-
| Option | Contract |
|
|
474
|
-
| --- | --- |
|
|
475
|
-
| `--from-grokbot <recipe.json>` | Read the recipe to export. |
|
|
476
|
-
| `--answers <file>` | Read export decisions from a JSON object. Fields present in the file are not asked again. The published schema is `schemas/grokbot-answers.schema.json`. |
|
|
477
|
-
| `--dry-run` | Print the planned files, defaults, exclusions, unmapped behavior, placeholders, secret names, warnings, and setup steps without writing files or installing dependencies. |
|
|
478
|
-
| `--json` | Never prompt and print machine-readable output. Combine it with `--dry-run` for a machine-readable preview. |
|
|
479
|
-
|
|
480
|
-
On a TTY, the command asks for missing decisions and offers recipe-derived
|
|
481
|
-
defaults. Off a TTY, it never prompts, takes defaults where possible, and
|
|
482
|
-
lists the fields it defaulted.
|
|
483
|
-
|
|
484
|
-
`--dry-run --json` prints `{ ok, dryRun, directory, preview }`. The preview
|
|
485
|
-
contains `version`, `name`, resolved `answers`, `defaulted`, `ignored`, `files`
|
|
486
|
-
as `{ path, from }`, `excluded`, `unmapped` as `{ from, reason }`, `fillIns`,
|
|
487
|
-
`secrets` as `{ names, reauth }`, `warnings`, and `setupSteps`. A write with
|
|
488
|
-
`--json` also reports `files`, `installed`, and `installError`. A dependency
|
|
489
|
-
install failure leaves `ok: true`, sets `installed: false`, reports
|
|
490
|
-
`installError`, and exits `0`. Other errors print `{ ok: false, error }` and
|
|
491
|
-
exit nonzero.
|
|
492
|
-
|
|
493
|
-
`--answers` and `--dry-run` require `--from-grokbot`. This export mode does
|
|
494
|
-
not accept `--template` or `--var`.
|
|
495
|
-
|
|
496
|
-
See [Export a Grok Bot](/docs/guides/export-grokbot.md) for the preview-first
|
|
497
|
-
workflow, mapping table, and post-export checklist.
|
|
444
|
+
`--from grokbot:<recipe.json>` and `--from-grokbot <recipe.json>` exit with
|
|
445
|
+
`Grok Bot import was removed.`
|
|
498
446
|
|
|
499
|
-
|
|
447
|
+
#### Convert an Automation {#convert-automation}
|
|
500
448
|
|
|
501
449
|
```text
|
|
502
|
-
|
|
450
|
+
agent-sdk init [directory] --from automation:<url-or-uuid> [--dry-run] [--json]
|
|
503
451
|
```
|
|
504
452
|
|
|
505
453
|
The input can be a Cursor Automation dashboard URL or its UUID. The output
|
|
506
|
-
directory defaults to `./<automation-name
|
|
454
|
+
directory defaults to `./<automation-name>`; a positional directory overrides
|
|
455
|
+
it. Generated files don't overwrite
|
|
507
456
|
existing paths, and missing scaffold files are added. The following
|
|
508
457
|
`npm install` can update lockfiles and run lifecycle scripts from an existing
|
|
509
458
|
`package.json`.
|
|
@@ -520,11 +469,11 @@ generated project and features that need manual review.
|
|
|
520
469
|
### Migrate an early-alpha project {#migrate}
|
|
521
470
|
|
|
522
471
|
```text
|
|
523
|
-
|
|
472
|
+
agent-sdk migrate [--dir <path>] [--repo <https-url>] [--ref <git-ref>]
|
|
524
473
|
[--path <agent-path>] [--no-wait] [--json] [--api-key <key>]
|
|
525
474
|
```
|
|
526
475
|
|
|
527
|
-
`migrate` applies only to projects deployed on architecture v1 during the
|
|
476
|
+
`migrate` applies only to projects deployed on architecture v1 during the Agent SDK
|
|
528
477
|
early alpha. It reads a pushed Git ref, starts a Cursor cloud agent with the
|
|
529
478
|
bundled `bdk-migrate-v2` skill, and opens a pull request with the source
|
|
530
479
|
changes. The command waits for the pull request by default and never deploys
|
|
@@ -534,7 +483,7 @@ create the prod Slack app, unset peer URL secrets, and set secrets a new slug
|
|
|
534
483
|
still needs.
|
|
535
484
|
|
|
536
485
|
The command prints `Nothing to migrate.` and exits 0 only when `--dir` shows
|
|
537
|
-
no migration work. That check looks for
|
|
486
|
+
no migration work. That check looks for a legacy early-alpha package dependency,
|
|
538
487
|
`architecture: "v1"`, `bot/storage.ts` or `agent/storage.ts`,
|
|
539
488
|
`runtime: "grokbot"`, a literal SCM credential, a `/v1` continuation selector,
|
|
540
489
|
an anonymous reminder, and a `*_MCP_URL` peer connection. When any of those is
|
|
@@ -543,7 +492,7 @@ does not read the hosted deployment.
|
|
|
543
492
|
|
|
544
493
|
| Option | Contract |
|
|
545
494
|
| --- | --- |
|
|
546
|
-
| `--dir <path>` | Select the local
|
|
495
|
+
| `--dir <path>` | Select the local Agent SDK project. The default is the current directory. |
|
|
547
496
|
| `--repo <https-url>` | Select the source repository. The CLI infers the current checkout's origin when possible. |
|
|
548
497
|
| `--ref <git-ref>` | Select the pushed ref for the cloud agent. The CLI infers the current branch when possible. |
|
|
549
498
|
| `--path <agent-path>` | Select the project path relative to the repository root. The CLI infers it from `--dir` when possible. |
|
|
@@ -553,27 +502,43 @@ does not read the hosted deployment.
|
|
|
553
502
|
|
|
554
503
|
Credential resolution follows the normal order: `--api-key`,
|
|
555
504
|
`CURSOR_API_KEY`, `CURSOR_API_KEY_FILE`, `CURSOR_SERVICE_ACCOUNT_KEY`, then
|
|
556
|
-
the stored `
|
|
505
|
+
the stored `agent-sdk login` credential. See
|
|
557
506
|
[Migrate an early-alpha project](/docs/guides/migrate.md) for detection, pull
|
|
558
507
|
request review, and deployment cutover.
|
|
559
508
|
|
|
560
|
-
### Install coding-agent skills {#install
|
|
509
|
+
### Install and list coding-agent skills {#skills-install}
|
|
561
510
|
|
|
562
511
|
```text
|
|
563
|
-
|
|
512
|
+
agent-sdk skills install [--dry-run] [--json]
|
|
564
513
|
```
|
|
565
514
|
|
|
566
|
-
The command replaces the installed
|
|
567
|
-
removes stale bundled skills. `--
|
|
515
|
+
The command replaces the installed Agent SDK skills with the package copy and
|
|
516
|
+
removes stale bundled skills. `--dry-run` previews the change. `--json` prints
|
|
568
517
|
`{ ok, dryRun, directory, firstInstall, skills, removed }`.
|
|
569
518
|
|
|
570
519
|
Package installation performs this copy.
|
|
571
|
-
Run `
|
|
520
|
+
Run `agent-sdk skills install` when you need to refresh it.
|
|
521
|
+
|
|
522
|
+
Each installed `SKILL.md` records the package release in `metadata.version`.
|
|
523
|
+
|
|
524
|
+
```text
|
|
525
|
+
agent-sdk skills list [--json [--fields <a,b.c>]] [--limit <n>] [--page-token <token>]
|
|
526
|
+
```
|
|
527
|
+
|
|
528
|
+
`skills list` prints each bundled skill and the version of its installed
|
|
529
|
+
copy. `--json` prints `{ items, nextPageToken }`. Each item has `name`,
|
|
530
|
+
`description`, `version`, `installedVersion`, and `path`. `installedVersion`
|
|
531
|
+
is `null` when the skill is not installed, and `"unknown"` when the installed
|
|
532
|
+
copy has no `metadata.version`. When `installedVersion` differs from
|
|
533
|
+
`version`, run `agent-sdk skills install`.
|
|
534
|
+
|
|
535
|
+
The `bdk-cli` skill holds the rules for agents that run `agent-sdk`: `--json`,
|
|
536
|
+
exit codes, `--fields`, `--dry-run`, `--yes`, secrets, and untrusted output.
|
|
572
537
|
|
|
573
538
|
### Inspect a project {#info}
|
|
574
539
|
|
|
575
540
|
```text
|
|
576
|
-
|
|
541
|
+
agent-sdk info [--dir <path>] [--view info|manifest] [--json [--fields <a,b.c>]]
|
|
577
542
|
```
|
|
578
543
|
|
|
579
544
|
Text output lists the model, instructions, tools, skills, extensions,
|
|
@@ -581,10 +546,14 @@ connections, subagents, channels, schedules, hooks, hosting settings, and
|
|
|
581
546
|
diagnostics. For one unslugged project, `--json` prints its project info
|
|
582
547
|
object. For slugged or multi-agent discovery, it prints `{ agents }`.
|
|
583
548
|
|
|
549
|
+
`--view manifest` validates one project and prints a summary of its
|
|
550
|
+
deployment metadata without a network request. `--json` then prints the full
|
|
551
|
+
manifest JSON.
|
|
552
|
+
|
|
584
553
|
### Validate a project {#validate}
|
|
585
554
|
|
|
586
555
|
```text
|
|
587
|
-
|
|
556
|
+
agent-sdk validate [--dir <path>]
|
|
588
557
|
```
|
|
589
558
|
|
|
590
559
|
`validate` prints every discovered project's diagnostics and exits nonzero
|
|
@@ -598,24 +567,14 @@ quotes the `{ secretName: "NAME" }` form to use instead. A project that still
|
|
|
598
567
|
sets `architecture: "v1"` gets the same finding as a warning, so run
|
|
599
568
|
`validate` before removing the pin to list what the migration must rename.
|
|
600
569
|
|
|
601
|
-
### Print a deployment manifest {#manifest}
|
|
602
|
-
|
|
603
|
-
```text
|
|
604
|
-
bdk manifest [--dir <path>] [--json]
|
|
605
|
-
```
|
|
606
|
-
|
|
607
|
-
`manifest` validates one project and prints its deployment metadata without a
|
|
608
|
-
network request. Default output is indented JSON; `--json` prints one compact
|
|
609
|
-
line.
|
|
610
|
-
|
|
611
570
|
## Credentials and versions
|
|
612
571
|
|
|
613
572
|
### Manage credentials {#login-logout-whoami}
|
|
614
573
|
|
|
615
574
|
```text
|
|
616
|
-
|
|
617
|
-
|
|
618
|
-
|
|
575
|
+
agent-sdk login [--api-key <key>] [--key-name <name>]
|
|
576
|
+
agent-sdk whoami [--json]
|
|
577
|
+
agent-sdk logout
|
|
619
578
|
```
|
|
620
579
|
|
|
621
580
|
| Command | Contract |
|
|
@@ -627,9 +586,9 @@ bdk logout
|
|
|
627
586
|
### Print the version {#version}
|
|
628
587
|
|
|
629
588
|
```text
|
|
630
|
-
|
|
631
|
-
|
|
632
|
-
|
|
589
|
+
agent-sdk version [--json]
|
|
590
|
+
agent-sdk --version
|
|
591
|
+
agent-sdk -V
|
|
633
592
|
```
|
|
634
593
|
|
|
635
594
|
Text output is the version number. `--json` prints
|
|
@@ -638,7 +597,7 @@ Text output is the version number. `--json` prints
|
|
|
638
597
|
### Update the CLI {#update}
|
|
639
598
|
|
|
640
599
|
```text
|
|
641
|
-
|
|
600
|
+
agent-sdk update
|
|
642
601
|
```
|
|
643
602
|
|
|
644
603
|
`update` checks npm's `latest` tag and upgrades a recognized global or project
|
|
@@ -651,13 +610,23 @@ automatic warning.
|
|
|
651
610
|
|
|
652
611
|
## Managed hosting
|
|
653
612
|
|
|
613
|
+
Every command here that changes a deployment takes `--dry-run`. It runs the
|
|
614
|
+
reads (sign-in, team, and deployment checks), then stops at the first request
|
|
615
|
+
that would change state and prints that request, with secret values
|
|
616
|
+
redacted. Nothing is sent, and the command exits `0`.
|
|
617
|
+
|
|
618
|
+
`deployment kill`, `deployment cancel-runs`, `deployment delete`,
|
|
619
|
+
`deployment rotate-token`, `secret delete`, `image delete`, and
|
|
620
|
+
`slack destroy` cannot be undone. On a terminal they ask you to type the
|
|
621
|
+
slug or name. Without a terminal, as when an agent runs them, they exit `2`
|
|
622
|
+
unless you pass `--yes`.
|
|
623
|
+
|
|
654
624
|
### Deploy agents {#deploy}
|
|
655
625
|
|
|
656
626
|
```text
|
|
657
|
-
|
|
627
|
+
agent-sdk deploy [--dir <path>] [--slug <slug> | --all] [--team <id>]
|
|
658
628
|
[--repo <https-url>] [--ref <git-ref>] [--path <agent-path>]
|
|
659
|
-
[--cursor-events-repo <repo>]...
|
|
660
|
-
[--allow-domain <domain>]... [--no-wait] [--json]
|
|
629
|
+
[--cursor-events-repo <repo>]... [--no-wait] [--json]
|
|
661
630
|
```
|
|
662
631
|
|
|
663
632
|
Managed hosting requires a team with agent hosting enabled. A team
|
|
@@ -672,7 +641,6 @@ service-account API key with agent access can deploy.
|
|
|
672
641
|
| `--ref <git-ref>` | Set the source Git ref. The CLI infers the current branch when possible. |
|
|
673
642
|
| `--path <agent-path>` | Set the project path relative to the repository root. |
|
|
674
643
|
| `--cursor-events-repo <repo>` | Watch a repository's Cursor events. Write `owner/name` for GitHub and Origin, `gitlab.com/<group>/<project>` for GitLab (subgroups allowed), or `bitbucket.org/<workspace>/<repo>` for Bitbucket. Repeat the flag for each repository; the repositories you pass replace the previous list. Without the flag, the deployment watches its GitHub source repository. |
|
|
675
|
-
| `--allow-domain <domain>` | Add an egress hostname. Repeat for multiple domains; values are combined with `hosting.egressDomains`. |
|
|
676
644
|
| `--no-wait` | Return after the deployment request is accepted. |
|
|
677
645
|
| `--json` | Print one object for one target or an array for multiple targets. |
|
|
678
646
|
|
|
@@ -687,131 +655,145 @@ if it reaches a failed state. A first deployment can return an alias token
|
|
|
687
655
|
once. Store it as a secret and send it as `X-Agent-Alias-Token` when calling
|
|
688
656
|
the stable alias URL.
|
|
689
657
|
|
|
690
|
-
|
|
658
|
+
When the team egress policy blocks a host, `deploy` exits nonzero and prints
|
|
659
|
+
`Error: agent-sdk deploy blocked.` The message names each blocked host, the team
|
|
660
|
+
egress mode, and two fixes: add the hosts to the team egress list, or remove
|
|
661
|
+
them from `hosting.egressDomains` and deploy again. The running bot does not
|
|
662
|
+
change.
|
|
663
|
+
|
|
664
|
+
An agent that sets `architecture: "v1"` does not deploy: `deploy` exits
|
|
665
|
+
nonzero and tells you to run [`migrate`](#migrate) first.
|
|
666
|
+
|
|
667
|
+
### List deployments {#deployment-list}
|
|
691
668
|
|
|
692
669
|
```text
|
|
693
|
-
|
|
670
|
+
agent-sdk deployment list [--team <id>] [--limit <n>] [--page-token <token>]
|
|
671
|
+
[--json [--fields <a,b.c>]]
|
|
694
672
|
```
|
|
695
673
|
|
|
696
|
-
Text output shows slug, status,
|
|
697
|
-
|
|
674
|
+
Text output shows slug, status, and update time. `--json` prints
|
|
675
|
+
`{ items, nextPageToken }`. `--limit` (default 20, at most 100) sets the page
|
|
676
|
+
size, and `--page-token` reads the next page. An empty list succeeds.
|
|
698
677
|
|
|
699
|
-
### Inspect a deployment {#deployment}
|
|
678
|
+
### Inspect a deployment {#deployment-get}
|
|
700
679
|
|
|
701
680
|
```text
|
|
702
|
-
|
|
681
|
+
agent-sdk deployment get <slug> [--team <id>] [--json [--fields <a,b.c>]] [--web]
|
|
703
682
|
```
|
|
704
683
|
|
|
705
|
-
Text output includes status,
|
|
706
|
-
the latest error. `--
|
|
707
|
-
|
|
684
|
+
Text output includes status, release, watched repositories, routes, secret
|
|
685
|
+
names, and the latest error. `--web` opens the deployment's page in
|
|
686
|
+
[Deployed Agents](https://cursor.com/dashboard/deployed-agents). A deployment still on architecture v1 shows its status with
|
|
687
|
+
`architecture: v1` and the [`migrate`](#migrate) steps; `deployment stop` and
|
|
688
|
+
`deployment delete` also still accept it.
|
|
708
689
|
|
|
709
|
-
### Stop a deployment {#stop}
|
|
690
|
+
### Stop a deployment {#deployment-stop}
|
|
710
691
|
|
|
711
692
|
```text
|
|
712
|
-
|
|
693
|
+
agent-sdk deployment stop <slug> [--team <id>] [--no-wait] [--cancel-runs] [--json]
|
|
713
694
|
```
|
|
714
695
|
|
|
715
696
|
The command waits for `stopped` by default. `--no-wait` returns after the
|
|
716
697
|
request is accepted. `--cancel-runs` also requests cancellation of active
|
|
717
698
|
runs and reminder wakes.
|
|
718
699
|
|
|
719
|
-
### Start a deployment {#start}
|
|
700
|
+
### Start a deployment {#deployment-start}
|
|
720
701
|
|
|
721
702
|
```text
|
|
722
|
-
|
|
703
|
+
agent-sdk deployment start <slug> [--team <id>] [--json]
|
|
723
704
|
```
|
|
724
705
|
|
|
725
|
-
`start` resumes a stopped deployment. It doesn't remove the
|
|
726
|
-
that [`kill`](#kill) sets.
|
|
706
|
+
`deployment start` resumes a stopped deployment. It doesn't remove the
|
|
707
|
+
deploy lock that [`deployment kill`](#deployment-kill) sets.
|
|
727
708
|
|
|
728
|
-
### Kill a deployment {#kill}
|
|
709
|
+
### Kill a deployment {#deployment-kill}
|
|
729
710
|
|
|
730
711
|
```text
|
|
731
|
-
|
|
712
|
+
agent-sdk deployment kill <slug> [--team <id>] [--yes] [--dry-run] [--json]
|
|
732
713
|
```
|
|
733
714
|
|
|
734
|
-
Use `kill` in an emergency. It locks deploys of the slug, stops
|
|
735
|
-
deployment, and requests cancellation of its active runs and reminder
|
|
715
|
+
Use `deployment kill` in an emergency. It locks deploys of the slug, stops
|
|
716
|
+
the deployment, and requests cancellation of its active runs and reminder
|
|
736
717
|
wakes. To bring the deployment back, run
|
|
737
|
-
[`unlock
|
|
718
|
+
[`deployment unlock`](#deployment-unlock) and then
|
|
719
|
+
[`deployment start`](#deployment-start).
|
|
738
720
|
|
|
739
|
-
### Unlock deploys {#unlock
|
|
721
|
+
### Unlock deploys {#deployment-unlock}
|
|
740
722
|
|
|
741
723
|
```text
|
|
742
|
-
|
|
724
|
+
agent-sdk deployment unlock <slug> [--team <id>] [--json]
|
|
743
725
|
```
|
|
744
726
|
|
|
745
|
-
`unlock
|
|
746
|
-
`upgrade`, and `rollback` work for the slug
|
|
747
|
-
traffic; run `start` for that.
|
|
727
|
+
`deployment unlock` removes the lock that `deployment kill` sets, so
|
|
728
|
+
`deploy`, `deployment upgrade`, and `deployment rollback` work for the slug
|
|
729
|
+
again. It doesn't resume traffic; run `deployment start` for that.
|
|
748
730
|
|
|
749
|
-
### Cancel active runs {#cancel-runs}
|
|
731
|
+
### Cancel active runs {#deployment-cancel-runs}
|
|
750
732
|
|
|
751
733
|
```text
|
|
752
|
-
|
|
734
|
+
agent-sdk deployment cancel-runs <slug> [--team <id>] [--yes] [--dry-run] [--json]
|
|
753
735
|
```
|
|
754
736
|
|
|
755
737
|
The command requests cancellation for a deployment's active runs and reminder
|
|
756
738
|
wakes. It exits nonzero if any cancellation request fails to start.
|
|
757
739
|
|
|
758
|
-
### Replace event repositories {#
|
|
740
|
+
### Replace event repositories {#deployment-update}
|
|
759
741
|
|
|
760
742
|
```text
|
|
761
|
-
|
|
762
|
-
[--team <id>] [--json]
|
|
743
|
+
agent-sdk deployment update <slug> (--event-repo <owner/name>... | --no-event-repos)
|
|
744
|
+
[--team <id>] [--dry-run] [--json]
|
|
763
745
|
```
|
|
764
746
|
|
|
765
747
|
The supplied repositories replace the deployment's complete event repository
|
|
766
|
-
list; they aren't merged with the previous list.
|
|
767
|
-
list.
|
|
748
|
+
list; they aren't merged with the previous list. `--no-event-repos` clears
|
|
749
|
+
the list.
|
|
768
750
|
|
|
769
|
-
### Upgrade a deployment {#upgrade}
|
|
751
|
+
### Upgrade a deployment {#deployment-upgrade}
|
|
770
752
|
|
|
771
753
|
```text
|
|
772
|
-
|
|
754
|
+
agent-sdk deployment upgrade <slug> [--release <id-or-version>]
|
|
773
755
|
[--team <id>] [--json]
|
|
774
756
|
```
|
|
775
757
|
|
|
776
758
|
`--release` accepts a release ID or version. Omit it to select the newest
|
|
777
759
|
ready release. `--json` prints `{ releaseId }`.
|
|
778
760
|
|
|
779
|
-
### Roll back a deployment {#rollback}
|
|
761
|
+
### Roll back a deployment {#deployment-rollback}
|
|
780
762
|
|
|
781
763
|
```text
|
|
782
|
-
|
|
764
|
+
agent-sdk deployment rollback <slug> [--release <id-or-version>]
|
|
783
765
|
[--team <id>] [--json]
|
|
784
766
|
```
|
|
785
767
|
|
|
786
|
-
`rollback` moves the deployment to an earlier ready release without
|
|
768
|
+
`deployment rollback` moves the deployment to an earlier ready release without
|
|
787
769
|
building a new one. Omit `--release` to select the release before the
|
|
788
770
|
current one. `--json` prints `{ releaseId }`.
|
|
789
771
|
|
|
790
|
-
### Delete a deployment {#delete}
|
|
772
|
+
### Delete a deployment {#deployment-delete}
|
|
791
773
|
|
|
792
774
|
```text
|
|
793
|
-
|
|
775
|
+
agent-sdk deployment delete <slug> [--team <id>] [--no-wait] [--yes] [--dry-run] [--json]
|
|
794
776
|
```
|
|
795
777
|
|
|
796
|
-
`delete` removes the deployment and frees its slug. It waits until the
|
|
778
|
+
`deployment delete` removes the deployment and frees its slug. It waits until the
|
|
797
779
|
deployment is gone unless `--no-wait` is set.
|
|
798
780
|
|
|
799
|
-
### Rotate an alias token {#rotate-token}
|
|
781
|
+
### Rotate an alias token {#deployment-rotate-token}
|
|
800
782
|
|
|
801
783
|
```text
|
|
802
|
-
|
|
784
|
+
agent-sdk deployment rotate-token <slug> [--team <id>] [--yes] [--dry-run] [--json]
|
|
803
785
|
```
|
|
804
786
|
|
|
805
787
|
The old token stops working immediately. The replacement appears once;
|
|
806
788
|
`--json` prints `{ aliasToken }`.
|
|
807
789
|
|
|
808
|
-
### Manage deployment secrets {#
|
|
790
|
+
### Manage deployment secrets {#secret}
|
|
809
791
|
|
|
810
792
|
```text
|
|
811
|
-
|
|
793
|
+
agent-sdk secret set <slug> NAME [NAME2 ...]
|
|
812
794
|
[--team <id>] [--from-argv] [--json]
|
|
813
|
-
|
|
814
|
-
|
|
795
|
+
agent-sdk secret list <slug> [--team <id>] [--limit <n>] [--page-token <token>] [--json]
|
|
796
|
+
agent-sdk secret delete <slug> NAME [--team <id>] [--yes] [--dry-run] [--json]
|
|
815
797
|
```
|
|
816
798
|
|
|
817
799
|
Pass secret names to `set`. On a TTY, the CLI prompts for a hidden value and
|
|
@@ -820,7 +802,7 @@ whole value and one trailing newline is removed, so a PEM private key keeps
|
|
|
820
802
|
its line breaks:
|
|
821
803
|
|
|
822
804
|
```bash
|
|
823
|
-
|
|
805
|
+
agent-sdk secret set my-bot GITHUB_APP_PRIVATE_KEY < ./app.private-key.pem
|
|
824
806
|
```
|
|
825
807
|
|
|
826
808
|
With several names, provide one line per name. `set` rejects `NAME=VALUE` on
|
|
@@ -832,15 +814,15 @@ characters. Names beginning with `CURSOR_` are reserved. Values contain at
|
|
|
832
814
|
most 4096 bytes, and each deployment holds at most 32 secrets.
|
|
833
815
|
|
|
834
816
|
`list` returns names and creation times, never values. JSON output is
|
|
835
|
-
`{ secretNames }` for `set`, `{
|
|
836
|
-
`
|
|
817
|
+
`{ secretNames }` for `set`, `{ items, nextPageToken }` for `list`, and
|
|
818
|
+
`{ removed }` for `delete`. Changes are available to subsequent hosted work.
|
|
837
819
|
|
|
838
|
-
### Manage container images {#
|
|
820
|
+
### Manage container images {#image}
|
|
839
821
|
|
|
840
822
|
```text
|
|
841
|
-
|
|
842
|
-
|
|
843
|
-
|
|
823
|
+
agent-sdk image push <local-image> --name <name> [--team <id>] [--json]
|
|
824
|
+
agent-sdk image list [--team <id>] [--limit <n>] [--page-token <token>] [--json]
|
|
825
|
+
agent-sdk image delete <name> [--team <id>] [--yes] [--dry-run] [--json]
|
|
844
826
|
```
|
|
845
827
|
|
|
846
828
|
A persistent agent can run inside a container image that your team pushes
|
|
@@ -849,8 +831,8 @@ checks the local image first: the image must be `linux/amd64` and have
|
|
|
849
831
|
`bash`, `git`, `node` 22.13 or newer, and `npm` on `PATH`. The command
|
|
850
832
|
then compresses the image and uploads it under `--name`.
|
|
851
833
|
|
|
852
|
-
`list` shows the team's images and how many the team can keep
|
|
853
|
-
deletes one image. A deploy pins the image it uses, so after you push a
|
|
834
|
+
`list` shows the team's images and how many the team can keep (`--json`:
|
|
835
|
+
`{ items, nextPageToken, teamImageLimit }`), and `delete` deletes one image. A deploy pins the image it uses, so after you push a
|
|
854
836
|
new image under the same name, deploy again to pick it up.
|
|
855
837
|
|
|
856
838
|
## MCP connections
|
|
@@ -858,24 +840,24 @@ new image under the same name, deploy again to pick it up.
|
|
|
858
840
|
### Connect an MCP client {#mcp}
|
|
859
841
|
|
|
860
842
|
```text
|
|
861
|
-
|
|
843
|
+
agent-sdk mcp serve --url <baseUrl> [--bearer-token <token>]
|
|
862
844
|
|
|
863
|
-
|
|
864
|
-
[--name <server-name>] [--
|
|
845
|
+
agent-sdk mcp install --url <baseUrl> [--bearer-token <token>]
|
|
846
|
+
[--name <server-name>] [--dry-run] [--json]
|
|
865
847
|
```
|
|
866
848
|
|
|
867
849
|
| Command | Contract |
|
|
868
850
|
| --- | --- |
|
|
869
|
-
| `mcp` | Read newline-delimited JSON-RPC from stdin and proxy it to the selected agent's MCP endpoint. stdout is reserved for MCP messages. A target is required. |
|
|
870
|
-
| `mcp install` | Add the selected agent to `~/.cursor/mcp.json`. `--name` sets the server name, `--
|
|
851
|
+
| `mcp serve` | Read newline-delimited JSON-RPC from stdin and proxy it to the selected agent's MCP endpoint. stdout is reserved for MCP messages. A target is required. |
|
|
852
|
+
| `mcp install` | Add the selected agent to `~/.cursor/mcp.json`. The entry runs `agent-sdk mcp`, which older CLI versions also understand. `--name` sets the server name, `--dry-run` previews the entry, and `--json` prints a machine-readable result. A `--url` entry with `--bearer-token` contains that token; handle printed and written copies as credentials. |
|
|
871
853
|
|
|
872
|
-
Hosted deployments don't support `mcp` or `mcp install`; both
|
|
873
|
-
|
|
854
|
+
Hosted deployments don't support `mcp serve` or `mcp install`; both exit with a
|
|
855
|
+
usage error when you pass `--prod`.
|
|
874
856
|
|
|
875
857
|
### Authorize MCP OAuth {#mcp-oauth}
|
|
876
858
|
|
|
877
859
|
```text
|
|
878
|
-
|
|
860
|
+
agent-sdk mcp oauth <connection> [--dir <path>]
|
|
879
861
|
[--slug <slug>] [--team <id>]
|
|
880
862
|
```
|
|
881
863
|
|
|
@@ -885,7 +867,7 @@ bdk mcp oauth <connection> [--dir <path>]
|
|
|
885
867
|
| Connection | Result |
|
|
886
868
|
| --- | --- |
|
|
887
869
|
| `defineConnection({ url, oauth: true })` | Open a browser PKCE flow and save tokens in `mcp-auth.json` under the CLI config directory. |
|
|
888
|
-
| `defineConnection({ cursorAccount: true })` |
|
|
870
|
+
| `defineConnection({ cursorAccount: true })` | Exits nonzero and points at the cursor.com dashboard, where you authorize the deployment's connectors. |
|
|
889
871
|
|
|
890
872
|
URL-connection tokens are bound to the resource URL; authorize again after
|
|
891
873
|
changing it.
|
|
@@ -897,31 +879,31 @@ See [Host MCP OAuth](/docs/guides/mcp-oauth.md) for the full setup flow.
|
|
|
897
879
|
### Configure Slack {#slack}
|
|
898
880
|
|
|
899
881
|
```text
|
|
900
|
-
|
|
901
|
-
|
|
882
|
+
agent-sdk slack setup
|
|
883
|
+
agent-sdk slack create [--dir <path>] [--name <name>] [--env prod]
|
|
902
884
|
[--slack-team <id>] [--team <id>] [--icon <url-or-file>]
|
|
903
885
|
[--prefix <prefix> | --no-prefix] [--channel-posts] [--json]
|
|
904
|
-
|
|
886
|
+
agent-sdk slack destroy [--dir <path>] [--env prod] [--yes] [--dry-run]
|
|
905
887
|
[--slack-team <id>] [--team <id>] [--json]
|
|
906
|
-
|
|
888
|
+
agent-sdk slack icon <url-or-file> [--dir <path>] [--env prod]
|
|
907
889
|
[--slack-team <id>] [--team <id>] [--json]
|
|
908
|
-
|
|
890
|
+
agent-sdk slack init --manual [--dir <path>] [--name <name>]
|
|
909
891
|
[--prefix <prefix> | --no-prefix] [--channel-posts]
|
|
910
|
-
[--install | --no-install] [--slack-team <id>] [--prod]
|
|
911
|
-
|
|
912
|
-
[--env dev|prod|both] [--channel-posts] [--
|
|
913
|
-
|
|
892
|
+
[--install | --no-install] [--slack-team <id>] [--env dev|prod]
|
|
893
|
+
agent-sdk slack manifest [--dir <path>] [--name <name>]
|
|
894
|
+
[--env dev|prod|both] [--channel-posts] [--dry-run]
|
|
895
|
+
agent-sdk slack doctor [--dir <path>]
|
|
914
896
|
[--prefix <prefix> | --no-prefix] [--channel <id>]... [--json]
|
|
915
897
|
```
|
|
916
898
|
|
|
917
899
|
| Subcommand | Contract |
|
|
918
900
|
| --- | --- |
|
|
919
901
|
| `setup` | Print the setup choices without changing files. |
|
|
920
|
-
| `create` | Open the signed-in
|
|
902
|
+
| `create` | Open the signed-in [Deployed Agents](https://cursor.com/dashboard/deployed-agents) wizard, write the resulting token pair to `.env.local`, and run `doctor`. The development app is the default; `--env prod` selects production. A second create overwrites the live app manifest. |
|
|
921
903
|
| `destroy` | Delete the provisioned app. Existing local token entries remain but stop working. |
|
|
922
904
|
| `icon` | Set an HTTPS or local PNG, JPG, or GIF icon of at most 512 KB. |
|
|
923
905
|
| `init --manual` | Write the channel, manifests, Slack CLI project, and setup files for a manually managed app. |
|
|
924
|
-
| `manifest` | Generate Slack manifests. `--env` defaults to `both`; with `--
|
|
906
|
+
| `manifest` | Generate Slack manifests. `--env` defaults to `both`; with `--dry-run`, select one environment when you need one JSON document. |
|
|
925
907
|
| `doctor` | Check both tokens, Socket Mode connectivity, Slack authentication, and any repeatable `--channel` values. |
|
|
926
908
|
|
|
927
909
|
The default token prefix is the project directory name normalized to upper
|
|
@@ -936,17 +918,17 @@ See [Slack](/docs/guides/slack.md) for app consent and manual setup.
|
|
|
936
918
|
### Test GitHub webhooks {#github}
|
|
937
919
|
|
|
938
920
|
```text
|
|
939
|
-
|
|
921
|
+
agent-sdk github forward [--dir <path>] [--slug <slug>] [--channel <id>]
|
|
940
922
|
[--repo owner/repo | --org <org>] [--events a,b,c]
|
|
941
923
|
[--url <url>] [--host <host>] [--port <n>]
|
|
942
924
|
[--secret <secret>] [--install]
|
|
943
|
-
|
|
925
|
+
agent-sdk github replay <pr-url-or-owner/repo#N>
|
|
944
926
|
[--events a,b,c | '*'] [--action <action>] [--conclusion <result>]
|
|
945
927
|
[--comment <body>] [--context <name>] [--dir <path>]
|
|
946
928
|
[--slug <slug>] [--channel <id>] [--url <url>]
|
|
947
|
-
[--secret <secret>] [--dry-run] [--
|
|
948
|
-
|
|
949
|
-
|
|
929
|
+
[--secret <secret>] [--dry-run] [--fixtures-dir <dir>] [--json]
|
|
930
|
+
agent-sdk github events [--dir <path>] [--host <host>] [--port <n>] [--json]
|
|
931
|
+
agent-sdk github doctor [--install] [--json]
|
|
950
932
|
```
|
|
951
933
|
|
|
952
934
|
| Subcommand | Contract |
|
|
@@ -958,7 +940,7 @@ bdk github doctor [--install] [--json]
|
|
|
958
940
|
|
|
959
941
|
Replay supports `pull_request`, `issue_comment`,
|
|
960
942
|
`pull_request_review_comment`, `check_run`, `check_suite`, `workflow_run`, and
|
|
961
|
-
`status`. `--dry-run` prints without posting. `--
|
|
943
|
+
`status`. `--dry-run` prints without posting. `--fixtures-dir` writes fixtures and
|
|
962
944
|
still posts unless combined with `--dry-run`.
|
|
963
945
|
|
|
964
946
|
Forwarding requires repository admin access, or organization owner access for
|
|
@@ -970,14 +952,14 @@ See [GitHub](/docs/guides/github.md) for channel setup and live delivery.
|
|
|
970
952
|
### Test GitLab webhooks {#gitlab}
|
|
971
953
|
|
|
972
954
|
```text
|
|
973
|
-
|
|
955
|
+
agent-sdk gitlab replay <mr-url-or-group/project!N>
|
|
974
956
|
[--events a,b,c | '*'] [--action <action>]
|
|
975
957
|
[--conclusion <status>] [--comment <body>]
|
|
976
958
|
[--dir <path>] [--slug <slug>] [--channel <id>]
|
|
977
959
|
[--url <url>] [--host <host>] [--port <n>]
|
|
978
|
-
[--secret <secret>] [--dry-run] [--
|
|
979
|
-
|
|
980
|
-
|
|
960
|
+
[--secret <secret>] [--dry-run] [--fixtures-dir <dir>] [--json]
|
|
961
|
+
agent-sdk gitlab events [--dir <path>] [--host <host>] [--port <n>] [--json]
|
|
962
|
+
agent-sdk gitlab forward [--dir <path>] [--host <host>] [--port <n>]
|
|
981
963
|
```
|
|
982
964
|
|
|
983
965
|
| Subcommand | Contract |
|
|
@@ -988,7 +970,7 @@ bdk gitlab forward [--dir <path>] [--host <host>] [--port <n>]
|
|
|
988
970
|
|
|
989
971
|
Replay supports `merge_request`, `note`, `pipeline`, and `push`. It requires
|
|
990
972
|
`GITLAB_TOKEN` with project read access. `--secret` defaults to
|
|
991
|
-
`GITLAB_WEBHOOK_SECRET`; `--dry-run` and `--
|
|
973
|
+
`GITLAB_WEBHOOK_SECRET`; `--dry-run` and `--fixtures-dir` follow the GitHub replay
|
|
992
974
|
contract.
|
|
993
975
|
|
|
994
976
|
See [GitLab](/docs/guides/gitlab.md) for channel setup and self-managed hosts.
|
|
@@ -996,13 +978,13 @@ See [GitLab](/docs/guides/gitlab.md) for channel setup and self-managed hosts.
|
|
|
996
978
|
### Test Bitbucket webhooks {#bitbucket}
|
|
997
979
|
|
|
998
980
|
```text
|
|
999
|
-
|
|
981
|
+
agent-sdk bitbucket replay <pr-url-or-workspace/repo#N>
|
|
1000
982
|
[--events a,b,c | '*'] [--comment <body>]
|
|
1001
983
|
[--dir <path>] [--slug <slug>] [--channel <id>]
|
|
1002
984
|
[--url <url>] [--host <host>] [--port <n>]
|
|
1003
|
-
[--secret <secret>] [--dry-run] [--
|
|
1004
|
-
|
|
1005
|
-
|
|
985
|
+
[--secret <secret>] [--dry-run] [--fixtures-dir <dir>] [--json]
|
|
986
|
+
agent-sdk bitbucket events [--dir <path>] [--host <host>] [--port <n>] [--json]
|
|
987
|
+
agent-sdk bitbucket forward [--dir <path>] [--host <host>] [--port <n>]
|
|
1006
988
|
```
|
|
1007
989
|
|
|
1008
990
|
| Subcommand | Contract |
|
|
@@ -1022,12 +1004,12 @@ See [Bitbucket](/docs/guides/bitbucket.md) for Cloud and Data Center setup.
|
|
|
1022
1004
|
### Test PagerDuty webhooks {#pagerduty}
|
|
1023
1005
|
|
|
1024
1006
|
```text
|
|
1025
|
-
|
|
1007
|
+
agent-sdk pagerduty replay [incident-id]
|
|
1026
1008
|
[--events a,b,c | '*'] [--comment <body>]
|
|
1027
1009
|
[--dir <path>] [--slug <slug>] [--channel <id>]
|
|
1028
1010
|
[--url <url>] [--host <host>] [--port <n>]
|
|
1029
|
-
[--secret <secret>] [--dry-run] [--
|
|
1030
|
-
|
|
1011
|
+
[--secret <secret>] [--dry-run] [--fixtures-dir <dir>] [--json]
|
|
1012
|
+
agent-sdk pagerduty events [--dir <path>] [--host <host>] [--port <n>] [--json]
|
|
1031
1013
|
```
|
|
1032
1014
|
|
|
1033
1015
|
| Subcommand | Contract |
|
|
@@ -1040,7 +1022,7 @@ Replay supports `incident.triggered`, `.acknowledged`, `.annotated`,
|
|
|
1040
1022
|
(`resolved`). It needs no PagerDuty account. The incident id defaults to
|
|
1041
1023
|
`PREPLAY1`, and `--comment` is the note body for `annotated`. `--secret`
|
|
1042
1024
|
defaults to `PAGERDUTY_WEBHOOK_SECRET`, signing with its first line when it
|
|
1043
|
-
lists several; without either the deliveries are unsigned, which `
|
|
1025
|
+
lists several; without either the deliveries are unsigned, which `agent-sdk dev`
|
|
1044
1026
|
admits from loopback. `--dry-run` and `--out`
|
|
1045
1027
|
follow the GitHub replay contract.
|
|
1046
1028
|
|
|
@@ -1057,7 +1039,7 @@ Credential resolution follows this order: `--api-key`, `CURSOR_API_KEY`,
|
|
|
1057
1039
|
| `CURSOR_API_KEY_FILE` | Path to a Cursor credential file. |
|
|
1058
1040
|
| `CURSOR_SERVICE_ACCOUNT_KEY` | Team service-account credential used after the API key and key-file sources. |
|
|
1059
1041
|
| `CURSOR_API_BASE_URL` | Backend for login, account, deployment, and event commands. |
|
|
1060
|
-
| `CURSOR_BACKEND_URL` | Backend for
|
|
1042
|
+
| `CURSOR_BACKEND_URL` | Backend for Agent SDK turns. Set it with `CURSOR_API_BASE_URL` when using a non-default backend. |
|
|
1061
1043
|
| `AGENT_SERVE_CONFIG_DIR` | Override the CLI config directory for stored credentials and update state. |
|
|
1062
1044
|
| `AGENT_SERVE_NO_UPDATE_CHECK`, `NO_UPDATE_NOTIFIER`, `CI` | Disable published-version checks when set to a non-empty value other than `0`. |
|
|
1063
1045
|
| `GITHUB_WEBHOOK_SECRET` | Default signature secret for GitHub forwarding and replay. |
|
|
@@ -1073,18 +1055,33 @@ Credential resolution follows this order: `--api-key`, `CURSOR_API_KEY`,
|
|
|
1073
1055
|
|
|
1074
1056
|
## Exit status
|
|
1075
1057
|
|
|
1058
|
+
Every command uses one exit code table. `agent-sdk help` prints it, and
|
|
1059
|
+
`agent-sdk help --json` includes it as `exitCodes`.
|
|
1060
|
+
|
|
1061
|
+
| Code | Meaning |
|
|
1062
|
+
| --- | --- |
|
|
1063
|
+
| `0` | ok |
|
|
1064
|
+
| `1` | failed (also `aborted`, `invalid_argument`, `rate_limited`, `unavailable`) |
|
|
1065
|
+
| `2` | usage: bad command, flag, or argument |
|
|
1066
|
+
| `3` | pending: the work is still running |
|
|
1067
|
+
| `4` | `not_found` |
|
|
1068
|
+
| `5` | `unauthenticated` or `permission_denied` |
|
|
1069
|
+
| `6` | `conflict` or `failed_precondition` |
|
|
1070
|
+
|
|
1076
1071
|
| Command | Nonzero contract |
|
|
1077
1072
|
| --- | --- |
|
|
1078
|
-
| No command | Print
|
|
1073
|
+
| No command | Print the command index and exit `0`. An unknown command exits `2`. |
|
|
1079
1074
|
| `run` | For local and running-server trajectories, exit `1` when the trajectory fails. |
|
|
1080
|
-
| `call` | Exit `1` unless the response succeeds with `ok: true`. |
|
|
1081
|
-
| `
|
|
1082
|
-
| `
|
|
1075
|
+
| `tool call` | Exit `1` unless the response succeeds with `ok: true`. |
|
|
1076
|
+
| `session get --file` | Exit `1` when the reconstructed trajectory failed. |
|
|
1077
|
+
| `session create --wait` | Exit `3` when the delivery names no session before `--timeout-ms`, and `1` when it was skipped or failed. |
|
|
1083
1078
|
| `eval` | Exit `1` for failed cases, or scored cases below threshold with `--strict`; exit `2` for invalid eval options or an execution with no matching cases. An empty `--list` succeeds. |
|
|
1084
|
-
| `eval
|
|
1085
|
-
| `chat`, `session` | Exit `2` for documented option conflicts or missing required input. |
|
|
1079
|
+
| `eval get` | Exit `3` while the batch runs, `1` when it failed or was cancelled, and `2` for invalid usage. |
|
|
1080
|
+
| `chat`, `session get` | Exit `2` for documented option conflicts or missing required input. |
|
|
1086
1081
|
| `validate` | Exit `1` when any project diagnostic has error severity. |
|
|
1087
|
-
|
|
|
1082
|
+
| Commands that cannot be undone | Exit `2` without `--yes` when there is no terminal to ask on. Exit `1` (`aborted`) when the typed confirmation does not match. |
|
|
1083
|
+
| Any command with `--dry-run` | Exit `0` after printing what it would do, unless a check before the first change fails. |
|
|
1084
|
+
| `init --from automation:…` | Exit `1` for invalid input, authentication, export, or file-write failure. Warnings and dependency-install failure don't change a successful conversion exit. |
|
|
1088
1085
|
| `migrate` | Exit `0` when nothing needs a migration, after starting with `--no-wait`, or after the agent opens a pull request. Exit `1` for invalid input, authentication or agent failure, or a completed run without a pull request. |
|
|
1089
1086
|
| Other commands | Exit nonzero when validation, authentication, a request, or the requested operation fails. |
|
|
1090
1087
|
|