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