@grok/agent-sdk 0.2.27 → 0.2.29
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/AGENTS.md +42 -37
- package/CHANGELOG.md +1 -1
- package/README.md +15 -17
- package/dist/agent-v2-hosting.d.ts +13 -0
- package/dist/agent-v2-hosting.d.ts.map +1 -0
- package/dist/agent-v2-hosting.js +8 -0
- package/dist/artifacts.d.ts +1 -1
- package/dist/artifacts.js +1 -1
- package/dist/bin/agent-serve.d.ts +3 -15
- package/dist/bin/agent-serve.d.ts.map +1 -1
- package/dist/bin/agent-serve.js +30 -1628
- package/dist/channels/bitbucket/api.d.ts.map +1 -1
- package/dist/channels/bitbucket/api.js +3 -3
- package/dist/channels/bitbucket/binding.d.ts.map +1 -1
- package/dist/channels/bitbucket/binding.js +5 -5
- package/dist/channels/bitbucket/bitbucket-channel.d.ts.map +1 -1
- package/dist/channels/bitbucket/bitbucket-channel.js +1 -0
- package/dist/channels/bitbucket/bitbucket-webhook.d.ts.map +1 -1
- package/dist/channels/bitbucket/bitbucket-webhook.js +9 -6
- package/dist/channels/bitbucket/checks.d.ts.map +1 -1
- package/dist/channels/bitbucket/checks.js +4 -0
- package/dist/channels/bitbucket/events.d.ts.map +1 -1
- package/dist/channels/bitbucket/index.d.ts +1 -1
- package/dist/channels/bitbucket/index.js +1 -1
- package/dist/channels/bitbucket/replay.d.ts.map +1 -1
- package/dist/channels/bitbucket/replay.js +4 -3
- package/dist/channels/change-monitors/change-monitors-channel.d.ts.map +1 -1
- package/dist/channels/change-monitors/change-monitors-channel.js +15 -2
- package/dist/channels/change-monitors/claim.d.ts +5 -0
- package/dist/channels/change-monitors/claim.d.ts.map +1 -0
- package/dist/channels/change-monitors/claim.js +6 -0
- package/dist/channels/change-monitors/index.d.ts +1 -0
- package/dist/channels/change-monitors/index.d.ts.map +1 -1
- package/dist/channels/change-monitors/index.js +1 -0
- package/dist/channels/change-monitors/types.d.ts.map +1 -1
- package/dist/channels/deployments/deployments-channel.d.ts +1 -1
- package/dist/channels/deployments/deployments-channel.js +1 -1
- package/dist/channels/deployments/index.d.ts +1 -1
- package/dist/channels/deployments/index.js +1 -1
- package/dist/channels/deployments/types.d.ts.map +1 -1
- package/dist/channels/github/api.d.ts +11 -0
- package/dist/channels/github/api.d.ts.map +1 -1
- package/dist/channels/github/api.js +29 -4
- package/dist/channels/github/binding.d.ts +5 -3
- package/dist/channels/github/binding.d.ts.map +1 -1
- package/dist/channels/github/binding.js +16 -9
- package/dist/channels/github/github-channel.d.ts +7 -2
- package/dist/channels/github/github-channel.d.ts.map +1 -1
- package/dist/channels/github/github-channel.js +20 -11
- package/dist/channels/github/index.d.ts +1 -1
- package/dist/channels/github/index.js +1 -1
- package/dist/channels/github/progress.d.ts.map +1 -1
- package/dist/channels/github/progress.js +4 -0
- package/dist/channels/github/state.d.ts +2 -2
- package/dist/channels/github/state.d.ts.map +1 -1
- package/dist/channels/github/types.d.ts +7 -7
- package/dist/channels/github/types.d.ts.map +1 -1
- package/dist/channels/gitlab/api.d.ts +2 -2
- package/dist/channels/gitlab/api.d.ts.map +1 -1
- package/dist/channels/gitlab/api.js +25 -14
- package/dist/channels/gitlab/binding.d.ts.map +1 -1
- package/dist/channels/gitlab/binding.js +2 -3
- package/dist/channels/gitlab/checks.d.ts.map +1 -1
- package/dist/channels/gitlab/checks.js +4 -0
- package/dist/channels/gitlab/events.d.ts.map +1 -1
- package/dist/channels/gitlab/gitlab-channel.d.ts.map +1 -1
- package/dist/channels/gitlab/gitlab-channel.js +4 -7
- package/dist/channels/gitlab/gitlab-webhook.d.ts.map +1 -1
- package/dist/channels/gitlab/gitlab-webhook.js +11 -8
- package/dist/channels/gitlab/index.d.ts +1 -1
- package/dist/channels/gitlab/index.js +1 -1
- package/dist/channels/gitlab/replay.d.ts.map +1 -1
- package/dist/channels/gitlab/replay.js +2 -0
- package/dist/channels/gitlab/types.d.ts.map +1 -1
- package/dist/channels/issues/claim.d.ts +5 -0
- package/dist/channels/issues/claim.d.ts.map +1 -0
- package/dist/channels/issues/claim.js +6 -0
- package/dist/channels/issues/index.d.ts +1 -0
- package/dist/channels/issues/index.d.ts.map +1 -1
- package/dist/channels/issues/index.js +1 -0
- package/dist/channels/issues/issues-channel.d.ts.map +1 -1
- package/dist/channels/issues/issues-channel.js +16 -3
- package/dist/channels/issues/types.d.ts +2 -2
- package/dist/channels/issues/types.d.ts.map +1 -1
- package/dist/channels/origin/api.d.ts.map +1 -1
- package/dist/channels/origin/api.js +3 -3
- package/dist/channels/origin/index.d.ts +1 -1
- package/dist/channels/origin/index.js +1 -1
- package/dist/channels/origin/origin-channel.d.ts.map +1 -1
- package/dist/channels/origin/origin-channel.js +6 -6
- package/dist/channels/origin/origin-webhook.d.ts.map +1 -1
- package/dist/channels/origin/origin-webhook.js +2 -5
- package/dist/channels/pagerduty/api.d.ts.map +1 -1
- package/dist/channels/pagerduty/api.js +2 -1
- package/dist/channels/pagerduty/index.d.ts +1 -1
- package/dist/channels/pagerduty/index.js +1 -1
- package/dist/channels/pagerduty/pagerduty-channel.d.ts +1 -1
- package/dist/channels/pagerduty/pagerduty-channel.d.ts.map +1 -1
- package/dist/channels/pagerduty/pagerduty-channel.js +2 -1
- package/dist/channels/pagerduty/pagerduty-webhook.d.ts.map +1 -1
- package/dist/channels/pagerduty/pagerduty-webhook.js +20 -11
- package/dist/channels/pagerduty/payload.d.ts.map +1 -1
- package/dist/channels/pagerduty/payload.js +2 -3
- package/dist/channels/pagerduty/replay.d.ts +1 -1
- package/dist/channels/pagerduty/replay.d.ts.map +1 -1
- package/dist/channels/pagerduty/replay.js +8 -5
- package/dist/channels/pagerduty/self-user.d.ts.map +1 -1
- package/dist/channels/pagerduty/self-user.js +8 -9
- package/dist/channels/runs/runs-channel.d.ts.map +1 -1
- package/dist/channels/runs/runs-channel.js +8 -2
- package/dist/channels/runs/types.d.ts +2 -2
- package/dist/channels/runs/types.d.ts.map +1 -1
- package/dist/channels/slack/agentic-delivery.d.ts +20 -1
- package/dist/channels/slack/agentic-delivery.d.ts.map +1 -1
- package/dist/channels/slack/agentic-delivery.js +77 -12
- package/dist/channels/slack/agentic-signals.d.ts +2 -0
- package/dist/channels/slack/agentic-signals.d.ts.map +1 -1
- package/dist/channels/slack/agentic-signals.js +24 -7
- package/dist/channels/slack/api.d.ts +1 -1
- package/dist/channels/slack/api.d.ts.map +1 -1
- package/dist/channels/slack/api.js +12 -13
- package/dist/channels/slack/approvals.d.ts.map +1 -1
- package/dist/channels/slack/approvals.js +5 -4
- package/dist/channels/slack/attachments.d.ts.map +1 -1
- package/dist/channels/slack/attachments.js +34 -9
- package/dist/channels/slack/auth.d.ts.map +1 -1
- package/dist/channels/slack/auth.js +3 -1
- package/dist/channels/slack/bot-mentions.d.ts.map +1 -1
- package/dist/channels/slack/bot-mentions.js +2 -4
- package/dist/channels/slack/cli-project.d.ts.map +1 -1
- package/dist/channels/slack/cli-project.js +7 -10
- package/dist/channels/slack/constants.d.ts +7 -0
- package/dist/channels/slack/constants.d.ts.map +1 -1
- package/dist/channels/slack/constants.js +7 -0
- package/dist/channels/slack/defaults.d.ts +12 -0
- package/dist/channels/slack/defaults.d.ts.map +1 -1
- package/dist/channels/slack/defaults.js +10 -2
- package/dist/channels/slack/dispatch.d.ts +7 -1
- package/dist/channels/slack/dispatch.d.ts.map +1 -1
- package/dist/channels/slack/dispatch.js +88 -13
- package/dist/channels/slack/doctor.d.ts.map +1 -1
- package/dist/channels/slack/doctor.js +11 -11
- package/dist/channels/slack/inbound.d.ts +7 -0
- package/dist/channels/slack/inbound.d.ts.map +1 -1
- package/dist/channels/slack/inbound.js +25 -4
- package/dist/channels/slack/index.d.ts +2 -2
- package/dist/channels/slack/index.d.ts.map +1 -1
- package/dist/channels/slack/index.js +2 -2
- package/dist/channels/slack/init.d.ts +2 -0
- package/dist/channels/slack/init.d.ts.map +1 -1
- package/dist/channels/slack/init.js +10 -2
- package/dist/channels/slack/interactive.d.ts +6 -1
- package/dist/channels/slack/interactive.d.ts.map +1 -1
- package/dist/channels/slack/interactive.js +15 -25
- package/dist/channels/slack/manifest.d.ts.map +1 -1
- package/dist/channels/slack/manifest.js +15 -12
- package/dist/channels/slack/message-body.d.ts.map +1 -1
- package/dist/channels/slack/message-body.js +2 -4
- package/dist/channels/slack/nudge-carrier.d.ts.map +1 -1
- package/dist/channels/slack/nudge-carrier.js +27 -1
- package/dist/channels/slack/nudge-store.d.ts.map +1 -1
- package/dist/channels/slack/nudge-store.js +8 -3
- package/dist/channels/slack/placeholder.d.ts +3 -0
- package/dist/channels/slack/placeholder.d.ts.map +1 -1
- package/dist/channels/slack/placeholder.js +6 -5
- package/dist/channels/slack/recording-sink.d.ts.map +1 -1
- package/dist/channels/slack/recording-sink.js +4 -3
- package/dist/channels/slack/sender-name.d.ts.map +1 -1
- package/dist/channels/slack/sender-name.js +2 -3
- package/dist/channels/slack/slack-channel.d.ts +1 -3
- package/dist/channels/slack/slack-channel.d.ts.map +1 -1
- package/dist/channels/slack/slack-channel.js +63 -86
- package/dist/channels/slack/thread-context.d.ts.map +1 -1
- package/dist/channels/slack/thread-context.js +4 -9
- package/dist/channels/slack/tool-cards.d.ts.map +1 -1
- package/dist/channels/slack/tool-cards.js +4 -0
- package/dist/channels/slack/types.d.ts +19 -4
- package/dist/channels/slack/types.d.ts.map +1 -1
- package/dist/channels/slack/upload.d.ts +2 -0
- package/dist/channels/slack/upload.d.ts.map +1 -1
- package/dist/channels/slack/upload.js +49 -12
- package/dist/channels/slack/user-info.d.ts.map +1 -1
- package/dist/channels/slack/user-info.js +3 -6
- package/dist/channels.d.ts +11 -11
- package/dist/channels.d.ts.map +1 -1
- package/dist/channels.js +57 -30
- package/dist/connections.d.ts +1 -1
- package/dist/connections.js +1 -1
- package/dist/docs/404.html +4 -4
- package/dist/docs/architecture.svg +1 -1
- package/dist/docs/assets/{app.wA5xBBcd.js → app.DMrZKFjI.js} +4 -4
- package/dist/docs/assets/building-with-agents.md.Bf1yH2tG.js +9 -0
- package/dist/docs/assets/building-with-agents.md.Bf1yH2tG.lean.js +1 -0
- package/dist/docs/assets/changelog.md.DrLFQUlu.js +1 -0
- package/dist/docs/assets/changelog.md.DrLFQUlu.lean.js +1 -0
- package/dist/docs/assets/chunks/@localSearchIndexroot.Dpd_wxVU.js +1 -0
- package/dist/docs/assets/chunks/{VPLocalSearchBox.C29HLCVL.js → VPLocalSearchBox.DQvuw1KA.js} +1 -1
- package/dist/docs/assets/chunks/{arc.BOaoYWmh.js → arc.ahOG-Qza.js} +1 -1
- package/dist/docs/assets/chunks/{architectureDiagram-Q4EWVU46.MfG0itQh.js → architectureDiagram-Q4EWVU46.BcgfYNO_.js} +1 -1
- package/dist/docs/assets/chunks/{baseUniq.CUeJciCF.js → baseUniq.DeIYZrWh.js} +1 -1
- package/dist/docs/assets/chunks/{blockDiagram-DXYQGD6D.BrXMZRtK.js → blockDiagram-DXYQGD6D.HjJ2goMX.js} +1 -1
- package/dist/docs/assets/chunks/{c4Diagram-AHTNJAMY.DfkDHeB9.js → c4Diagram-AHTNJAMY.C1QTb9GM.js} +1 -1
- package/dist/docs/assets/chunks/channel._fZX_hvU.js +1 -0
- package/dist/docs/assets/chunks/{chunk-4BX2VUAB.xKz8CiXK.js → chunk-4BX2VUAB.UuZiDiVp.js} +1 -1
- package/dist/docs/assets/chunks/{chunk-4TB4RGXK.kkfBh4zk.js → chunk-4TB4RGXK.5A3YmkhI.js} +1 -1
- package/dist/docs/assets/chunks/{chunk-55IACEB6.BClJGb94.js → chunk-55IACEB6.B4uf1yYV.js} +1 -1
- package/dist/docs/assets/chunks/{chunk-EDXVE4YY.P9BpQ9L3.js → chunk-EDXVE4YY.CoXBce8t.js} +1 -1
- package/dist/docs/assets/chunks/{chunk-FMBD7UC4.R4iYi58S.js → chunk-FMBD7UC4.DnC5NO4e.js} +1 -1
- package/dist/docs/assets/chunks/{chunk-OYMX7WX6.Cpn8L1dw.js → chunk-OYMX7WX6.CzfHCeIi.js} +1 -1
- package/dist/docs/assets/chunks/{chunk-QZHKN3VN.BLftECqU.js → chunk-QZHKN3VN.C6tcwkVd.js} +1 -1
- package/dist/docs/assets/chunks/{chunk-YZCP3GAM.BWDV1AYt.js → chunk-YZCP3GAM._oboyZ1A.js} +1 -1
- package/dist/docs/assets/chunks/classDiagram-6PBFFD2Q.eClS1Q0E.js +1 -0
- package/dist/docs/assets/chunks/classDiagram-v2-HSJHXN6E.eClS1Q0E.js +1 -0
- package/dist/docs/assets/chunks/clone.W1Phdw9P.js +1 -0
- package/dist/docs/assets/chunks/{cose-bilkent-S5V4N54A.DGpAcJ55.js → cose-bilkent-S5V4N54A.BfPVKeId.js} +1 -1
- package/dist/docs/assets/chunks/{dagre-KV5264BT.BBXxGEaD.js → dagre-KV5264BT.CLMLc0lD.js} +1 -1
- package/dist/docs/assets/chunks/{diagram-5BDNPKRD.EKqOwmK2.js → diagram-5BDNPKRD.C7OF7UfH.js} +1 -1
- package/dist/docs/assets/chunks/{diagram-G4DWMVQ6.CB8pdkoZ.js → diagram-G4DWMVQ6.Dpao0Bl1.js} +1 -1
- package/dist/docs/assets/chunks/{diagram-MMDJMWI5.aHh4WGg9.js → diagram-MMDJMWI5.DLnM9eLp.js} +1 -1
- package/dist/docs/assets/chunks/{diagram-TYMM5635.YIsbRH20.js → diagram-TYMM5635.BcpVgA_M.js} +1 -1
- package/dist/docs/assets/chunks/{erDiagram-SMLLAGMA.B3bTCW_e.js → erDiagram-SMLLAGMA.CsL5JuCV.js} +1 -1
- package/dist/docs/assets/chunks/{flowDiagram-DWJPFMVM.M81hXIXZ.js → flowDiagram-DWJPFMVM.MFihq9AF.js} +1 -1
- package/dist/docs/assets/chunks/{ganttDiagram-T4ZO3ILL.BKg7WY--.js → ganttDiagram-T4ZO3ILL.CJeLodyG.js} +1 -1
- package/dist/docs/assets/chunks/{gitGraphDiagram-UUTBAWPF.CLEMZgO3.js → gitGraphDiagram-UUTBAWPF.1HhlE45Z.js} +1 -1
- package/dist/docs/assets/chunks/{graph.DS38W_Q-.js → graph.BS02KkWA.js} +1 -1
- package/dist/docs/assets/chunks/{infoDiagram-42DDH7IO.BTiWTi82.js → infoDiagram-42DDH7IO.fp5gvytQ.js} +1 -1
- package/dist/docs/assets/chunks/{ishikawaDiagram-UXIWVN3A.DcqY_KQL.js → ishikawaDiagram-UXIWVN3A.C6Wk1V4I.js} +1 -1
- package/dist/docs/assets/chunks/{journeyDiagram-VCZTEJTY.0lQNZ40U.js → journeyDiagram-VCZTEJTY.qJt4uJ_H.js} +1 -1
- package/dist/docs/assets/chunks/{kanban-definition-6JOO6SKY.L5sKlf7X.js → kanban-definition-6JOO6SKY.z2tG9kly.js} +1 -1
- package/dist/docs/assets/chunks/{layout.7u4gFhQa.js → layout.BPCkdejr.js} +1 -1
- package/dist/docs/assets/chunks/{linear.D5v33SOb.js → linear.CL3TC3u7.js} +1 -1
- package/dist/docs/assets/chunks/{min.Dc9uCxf9.js → min.SPrSp704.js} +1 -1
- package/dist/docs/assets/chunks/{mindmap-definition-QFDTVHPH.B56nGoB_.js → mindmap-definition-QFDTVHPH.DgrQRFZW.js} +1 -1
- package/dist/docs/assets/chunks/{pieDiagram-DEJITSTG.Cba8e8lS.js → pieDiagram-DEJITSTG.Ba7yxiW2.js} +1 -1
- package/dist/docs/assets/chunks/{quadrantDiagram-34T5L4WZ.2YjBycHF.js → quadrantDiagram-34T5L4WZ.Bvskad4p.js} +1 -1
- package/dist/docs/assets/chunks/{requirementDiagram-MS252O5E.D4P5RqVI.js → requirementDiagram-MS252O5E.Ce70ugV9.js} +1 -1
- package/dist/docs/assets/chunks/{sankeyDiagram-XADWPNL6.C0Hn8NUm.js → sankeyDiagram-XADWPNL6.BJ5OEULO.js} +1 -1
- package/dist/docs/assets/chunks/{sequenceDiagram-FGHM5R23.BZm7EaoT.js → sequenceDiagram-FGHM5R23.C8a1hDs6.js} +1 -1
- package/dist/docs/assets/chunks/{stateDiagram-FHFEXIEX.DcR4f3X2.js → stateDiagram-FHFEXIEX.D2D8A5CK.js} +1 -1
- package/dist/docs/assets/chunks/stateDiagram-v2-QKLJ7IA2.77yf4kRr.js +1 -0
- package/dist/docs/assets/chunks/{theme.DvfKzyXq.js → theme.DRciHmS1.js} +2 -2
- package/dist/docs/assets/chunks/{timeline-definition-GMOUNBTQ.CgDh96vg.js → timeline-definition-GMOUNBTQ.C4ePrY8-.js} +1 -1
- package/dist/docs/assets/chunks/{vennDiagram-DHZGUBPP.B4fagbC8.js → vennDiagram-DHZGUBPP.Dzso6dEA.js} +1 -1
- package/dist/docs/assets/chunks/{wardley-RL74JXVD.Ck68omim.js → wardley-RL74JXVD.djgXR0ar.js} +1 -1
- package/dist/docs/assets/chunks/{wardleyDiagram-NUSXRM2D.DBUg0bvz.js → wardleyDiagram-NUSXRM2D.Bf2ICxjh.js} +1 -1
- package/dist/docs/assets/chunks/{xychartDiagram-5P7HB3ND.DnKSGQE1.js → xychartDiagram-5P7HB3ND.DEH4BcVJ.js} +1 -1
- package/dist/docs/assets/deployment.md.KW0Ni_rY.js +31 -0
- package/dist/docs/assets/deployment.md.KW0Ni_rY.lean.js +1 -0
- package/dist/docs/assets/{evals.md.CHR34K1Y.js → evals.md.DiljU__Z.js} +10 -10
- package/dist/docs/assets/{guides_agent-to-agent.md.CwL5cwuE.js → guides_agent-to-agent.md.D1D5f6Jc.js} +7 -7
- package/dist/docs/assets/guides_agent-to-agent.md.D1D5f6Jc.lean.js +1 -0
- package/dist/docs/assets/{guides_bitbucket.md.CKUayYtD.js → guides_bitbucket.md.DkjkBRU8.js} +3 -3
- package/dist/docs/assets/guides_cloud-agents.md.Ceyjv0ul.js +9 -0
- package/dist/docs/assets/guides_cloud-agents.md.Ceyjv0ul.lean.js +1 -0
- package/dist/docs/assets/{guides_convert-automation.md.DMEX9nF-.js → guides_convert-automation.md.BjraCvok.js} +11 -11
- package/dist/docs/assets/guides_convert-automation.md.BjraCvok.lean.js +1 -0
- package/dist/docs/assets/{guides_github.md.TuNiZAOQ.js → guides_github.md.CgN5sNbW.js} +14 -14
- package/dist/docs/assets/{guides_github.md.TuNiZAOQ.lean.js → guides_github.md.CgN5sNbW.lean.js} +1 -1
- package/dist/docs/assets/{guides_gitlab.md.CtNI4fSH.js → guides_gitlab.md.DCE0p7_w.js} +3 -3
- package/dist/docs/assets/{guides_hooks.md.B2XfGX50.js → guides_hooks.md.BjeEiM7s.js} +4 -4
- package/dist/docs/assets/{guides_hooks.md.B2XfGX50.lean.js → guides_hooks.md.BjeEiM7s.lean.js} +1 -1
- package/dist/docs/assets/{guides_improve.md.CZKVt1cT.js → guides_improve.md.BFYtrtLE.js} +4 -4
- package/dist/docs/assets/{guides_improve.md.CZKVt1cT.lean.js → guides_improve.md.BFYtrtLE.lean.js} +1 -1
- package/dist/docs/assets/{guides_jev.md.D7XH4JH3.js → guides_jev.md.CEqLgjj9.js} +12 -12
- package/dist/docs/assets/{guides_jev.md.D7XH4JH3.lean.js → guides_jev.md.CEqLgjj9.lean.js} +1 -1
- package/dist/docs/assets/{guides_mcp-oauth.md.Cxq2TxBB.js → guides_mcp-oauth.md.DrGY92u4.js} +8 -8
- package/dist/docs/assets/{guides_mcp-oauth.md.Cxq2TxBB.lean.js → guides_mcp-oauth.md.DrGY92u4.lean.js} +1 -1
- package/dist/docs/assets/guides_migrate.md.RS9Eu-Xh.js +8 -0
- package/dist/docs/assets/guides_migrate.md.RS9Eu-Xh.lean.js +1 -0
- package/dist/docs/assets/guides_opentelemetry.md.CoZ1kNyd.js +28 -0
- package/dist/docs/assets/guides_opentelemetry.md.CoZ1kNyd.lean.js +1 -0
- package/dist/docs/assets/{guides_pagerduty.md.BHXMcMtx.js → guides_pagerduty.md.mnKXe9U0.js} +10 -10
- package/dist/docs/assets/{guides_slack.md.ClIyi7FI.js → guides_slack.md.BwXHURvY.js} +21 -8
- package/dist/docs/assets/{guides_slack.md.ClIyi7FI.lean.js → guides_slack.md.BwXHURvY.lean.js} +1 -1
- package/dist/docs/assets/{guides_webhooks.md.Cpdc3BDX.js → guides_webhooks.md.BJk63ZTs.js} +9 -5
- package/dist/docs/assets/{guides_webhooks.md.Cpdc3BDX.lean.js → guides_webhooks.md.BJk63ZTs.lean.js} +1 -1
- package/dist/docs/assets/{hillclimbing.md.Dxvd-0gT.js → hillclimbing.md.By61f3uq.js} +2 -2
- package/dist/docs/assets/index.md.CAruw_rp.js +26 -0
- package/dist/docs/assets/index.md.CAruw_rp.lean.js +1 -0
- package/dist/docs/assets/{quickstart.md.D8JDfkKO.js → quickstart.md.CljDaJBi.js} +12 -12
- package/dist/docs/assets/quickstart.md.CljDaJBi.lean.js +1 -0
- package/dist/docs/assets/reference_access.md.CEtibb4i.js +1 -0
- package/dist/docs/assets/reference_access.md.CEtibb4i.lean.js +1 -0
- package/dist/docs/assets/{reference_agent-config.md.CZrbHOfT.js → reference_agent-config.md.Ck29qYNj.js} +10 -8
- package/dist/docs/assets/{reference_agent-config.md.CZrbHOfT.lean.js → reference_agent-config.md.Ck29qYNj.lean.js} +1 -1
- package/dist/docs/assets/{reference_artifacts.md.DLV9MZES.js → reference_artifacts.md.C-hKR2hp.js} +2 -2
- package/dist/docs/assets/reference_channels.md.DsJfGSBJ.js +22 -0
- package/dist/docs/assets/{reference_channels.md.CNNIS6K7.lean.js → reference_channels.md.DsJfGSBJ.lean.js} +1 -1
- package/dist/docs/assets/reference_cli.md.BkdLRbXg.js +99 -0
- package/dist/docs/assets/reference_cli.md.BkdLRbXg.lean.js +1 -0
- package/dist/docs/assets/{reference_connections.md.BJE2Zllp.js → reference_connections.md.BoAotr7_.js} +7 -7
- package/dist/docs/assets/{reference_evals.md.Ccwp4x3o.js → reference_evals.md.2BXeMiO2.js} +31 -11
- package/dist/docs/assets/{reference_evals.md.Ccwp4x3o.lean.js → reference_evals.md.2BXeMiO2.lean.js} +1 -1
- package/dist/docs/assets/{reference_extensions.md.DKxTuCIw.js → reference_extensions.md.DI5X5x8p.js} +10 -10
- package/dist/docs/assets/{reference_extensions.md.DKxTuCIw.lean.js → reference_extensions.md.DI5X5x8p.lean.js} +1 -1
- package/dist/docs/assets/{reference_hooks.md.CROr0QgC.js → reference_hooks.md.B-bwJuiG.js} +5 -5
- package/dist/docs/assets/{reference_http-api.md.Dji-DD_Z.js → reference_http-api.md._RWELr3d.js} +1 -1
- package/dist/docs/assets/{reference_instructions.md.BYMVxAkw.js → reference_instructions.md.yL2hXLnl.js} +1 -1
- package/dist/docs/assets/reference_limits.md.BCCnvt3o.js +8 -0
- package/dist/docs/assets/reference_limits.md.BCCnvt3o.lean.js +1 -0
- package/dist/docs/assets/reference_memory.md.Dd7cyV9V.js +4 -0
- package/dist/docs/assets/reference_playground.md.CQiJk9CM.js +1 -0
- package/dist/docs/assets/{reference_project-layout.md.mFcS8yDD.js → reference_project-layout.md.BamcPDUn.js} +4 -4
- package/dist/docs/assets/{reference_prompt.md.DqPh71XN.js → reference_prompt.md.BMjm1Jp3.js} +2 -2
- package/dist/docs/assets/{reference_schedules.md.BqWnJES4.js → reference_schedules.md.RC47aFm4.js} +4 -4
- package/dist/docs/assets/{reference_sessions.md.Bi6lHttM.js → reference_sessions.md.C7KFhWXV.js} +1 -1
- package/dist/docs/assets/{reference_skills.md.Ckddg6KX.js → reference_skills.md.Dej2zQxi.js} +2 -2
- package/dist/docs/assets/{reference_skills.md.Ckddg6KX.lean.js → reference_skills.md.Dej2zQxi.lean.js} +1 -1
- package/dist/docs/assets/{reference_subagents.md.ChNGh6HK.js → reference_subagents.md.CAhvW4yS.js} +1 -1
- package/dist/docs/assets/{reference_tools.md.Bo0UfT0a.js → reference_tools.md.DQr7Fnhu.js} +10 -10
- package/dist/docs/assets/{reference_tools.md.Bo0UfT0a.lean.js → reference_tools.md.DQr7Fnhu.lean.js} +1 -1
- package/dist/docs/assets/{style.B9o0luvp.css → style.DK0YX1WL.css} +1 -1
- package/dist/docs/assets/{templates_agentic-owners.md.CTEnR0jp.js → templates_agentic-owners.md.Dh2nDSqg.js} +4 -4
- package/dist/docs/assets/templates_security-reviewer.md.DnwXdnB5.js +3 -0
- package/dist/docs/assets/templates_thermo-quality-review.md.MJIdHkzE.js +3 -0
- package/dist/docs/assets/{templates_thermo-quality-review.md.B77UyTrX.lean.js → templates_thermo-quality-review.md.MJIdHkzE.lean.js} +1 -1
- package/dist/docs/assets/templates_thermo-review.md.DfN1OFOl.js +3 -0
- package/dist/docs/assets/{templates_thermo-review.md.DRJ7mC5U.lean.js → templates_thermo-review.md.DfN1OFOl.lean.js} +1 -1
- package/dist/docs/assets/{templates_triage.md.CNN6b0JZ.js → templates_triage.md.BYWMloV4.js} +4 -4
- package/dist/docs/assets/troubleshooting.md.CGOdNVAL.js +1 -0
- package/dist/docs/building-with-agents.html +46 -46
- package/dist/docs/building-with-agents.md +20 -20
- package/dist/docs/changelog.html +39 -39
- package/dist/docs/changelog.md +57 -11
- package/dist/docs/deployment.html +54 -54
- package/dist/docs/deployment.md +115 -53
- package/dist/docs/evals.html +48 -48
- package/dist/docs/evals.md +15 -13
- package/dist/docs/guides/agent-to-agent.html +45 -45
- package/dist/docs/guides/agent-to-agent.md +7 -7
- package/dist/docs/guides/bitbucket.html +41 -41
- package/dist/docs/guides/bitbucket.md +5 -5
- package/dist/docs/guides/cloud-agents.html +41 -41
- package/dist/docs/guides/cloud-agents.md +3 -3
- package/dist/docs/guides/convert-automation.html +49 -49
- package/dist/docs/guides/convert-automation.md +16 -15
- package/dist/docs/guides/github.html +50 -50
- package/dist/docs/guides/github.md +17 -17
- package/dist/docs/guides/gitlab.html +41 -41
- package/dist/docs/guides/gitlab.md +5 -5
- package/dist/docs/guides/hooks.html +40 -40
- package/dist/docs/guides/hooks.md +3 -3
- package/dist/docs/guides/improve.html +41 -41
- package/dist/docs/guides/improve.md +2 -2
- package/dist/docs/guides/jev.html +48 -48
- package/dist/docs/guides/jev.md +15 -10
- package/dist/docs/guides/mcp-oauth.html +45 -45
- package/dist/docs/guides/mcp-oauth.md +10 -11
- package/dist/docs/guides/migrate.html +43 -42
- package/dist/docs/guides/migrate.md +36 -29
- package/dist/docs/guides/opentelemetry.html +50 -59
- package/dist/docs/guides/opentelemetry.md +61 -130
- package/dist/docs/guides/pagerduty.html +48 -48
- package/dist/docs/guides/pagerduty.md +18 -18
- package/dist/docs/guides/slack.html +58 -45
- package/dist/docs/guides/slack.md +87 -17
- package/dist/docs/guides/webhooks.html +46 -42
- package/dist/docs/guides/webhooks.md +61 -3
- package/dist/docs/hashmap.json +1 -1
- package/dist/docs/hillclimbing.html +39 -39
- package/dist/docs/hillclimbing.md +4 -4
- package/dist/docs/index.html +56 -57
- package/dist/docs/index.md +31 -31
- package/dist/docs/llms-full.txt +1333 -1417
- package/dist/docs/llms.txt +13 -14
- package/dist/docs/package/skills/create-agent/SKILL.md +178 -0
- package/dist/docs/package/skills/evals/SKILL.md +145 -0
- package/dist/docs/package/skills/github/SKILL.md +133 -0
- package/dist/docs/package/skills/hillclimb/SKILL.md +63 -0
- package/dist/docs/package/skills/mcp-auth/SKILL.md +60 -0
- package/dist/docs/package/skills/migrate-v2/SKILL.md +394 -0
- package/dist/docs/package/skills/setup-slack/SKILL.md +136 -0
- package/dist/docs/quickstart.html +50 -50
- package/dist/docs/quickstart.md +25 -21
- package/dist/docs/reference/access.html +60 -0
- package/dist/docs/reference/access.md +22 -0
- package/dist/docs/reference/agent-config.html +46 -44
- package/dist/docs/reference/agent-config.md +54 -12
- package/dist/docs/reference/artifacts.html +39 -39
- package/dist/docs/reference/artifacts.md +2 -2
- package/dist/docs/reference/channels.html +39 -39
- package/dist/docs/reference/channels.md +29 -9
- package/dist/docs/reference/cli.html +96 -100
- package/dist/docs/reference/cli.md +363 -366
- package/dist/docs/reference/connections.html +44 -44
- package/dist/docs/reference/connections.md +10 -10
- package/dist/docs/reference/evals.html +68 -48
- package/dist/docs/reference/evals.md +48 -13
- package/dist/docs/reference/extensions.html +47 -47
- package/dist/docs/reference/extensions.md +12 -12
- package/dist/docs/reference/hooks.html +42 -42
- package/dist/docs/reference/hooks.md +11 -11
- package/dist/docs/reference/http-api.html +39 -39
- package/dist/docs/reference/http-api.md +1 -1
- package/dist/docs/reference/instructions.html +39 -39
- package/dist/docs/reference/instructions.md +1 -1
- package/dist/docs/reference/limits.html +67 -0
- package/dist/docs/reference/limits.md +37 -0
- package/dist/docs/reference/memory.html +40 -40
- package/dist/docs/reference/memory.md +7 -7
- package/dist/docs/reference/playground.html +38 -38
- package/dist/docs/reference/playground.md +1 -1
- package/dist/docs/reference/project-layout.html +41 -41
- package/dist/docs/reference/project-layout.md +6 -6
- package/dist/docs/reference/prompt.html +39 -39
- package/dist/docs/reference/prompt.md +2 -2
- package/dist/docs/reference/schedules.html +42 -42
- package/dist/docs/reference/schedules.md +4 -4
- package/dist/docs/reference/sessions.html +39 -39
- package/dist/docs/reference/sessions.md +3 -3
- package/dist/docs/reference/skills.html +39 -39
- package/dist/docs/reference/skills.md +2 -2
- package/dist/docs/reference/subagents.html +39 -39
- package/dist/docs/reference/subagents.md +1 -1
- package/dist/docs/reference/tools.html +47 -47
- package/dist/docs/reference/tools.md +31 -21
- package/dist/docs/templates/agentic-owners.html +41 -41
- package/dist/docs/templates/agentic-owners.md +7 -7
- package/dist/docs/templates/security-reviewer.html +39 -39
- package/dist/docs/templates/security-reviewer.md +6 -6
- package/dist/docs/templates/thermo-quality-review.html +40 -40
- package/dist/docs/templates/thermo-quality-review.md +7 -7
- package/dist/docs/templates/thermo-review.html +40 -40
- package/dist/docs/templates/thermo-review.md +7 -7
- package/dist/docs/templates/triage.html +41 -41
- package/dist/docs/templates/triage.md +9 -9
- package/dist/docs/troubleshooting.html +38 -38
- package/dist/docs/troubleshooting.md +26 -24
- package/dist/evals/assertions.d.ts.map +1 -1
- package/dist/evals/assertions.js +2 -2
- package/dist/evals/expect.d.ts.map +1 -1
- package/dist/evals/expect.js +9 -1
- package/dist/evals/judge.js +2 -2
- package/dist/evals/loaders.d.ts +3 -3
- package/dist/evals/loaders.d.ts.map +1 -1
- package/dist/evals/loaders.js +6 -3
- package/dist/evals/matchers.d.ts +1 -1
- package/dist/evals/matchers.d.ts.map +1 -1
- package/dist/evals/matchers.js +40 -6
- package/dist/evals/reporters.d.ts +2 -2
- package/dist/evals/reporters.js +2 -2
- package/dist/evals/results.d.ts +1 -1
- package/dist/evals/results.js +1 -1
- package/dist/evals.d.ts +3 -3
- package/dist/evals.js +1 -1
- package/dist/executors.d.ts +1 -1
- package/dist/executors.d.ts.map +1 -1
- package/dist/executors.js +2 -2
- package/dist/extensions/cursor-cloud-agents/extension.d.ts +1 -1
- package/dist/extensions/cursor-cloud-agents/extension.js +1 -1
- package/dist/extensions/cursor-cloud-agents/lib/backend.d.ts.map +1 -1
- package/dist/extensions/cursor-cloud-agents/lib/backend.js +13 -2
- package/dist/extensions/cursor-cloud-agents/reminders/cloud-agent-stop-watch.js +3 -3
- package/dist/extensions/improve/extension.d.ts +1 -1
- package/dist/extensions/improve/extension.js +1 -1
- package/dist/extensions/jev/extension.d.ts +13 -3
- package/dist/extensions/jev/extension.d.ts.map +1 -1
- package/dist/extensions/jev/extension.js +5 -1
- package/dist/extensions/jev/lib/evaluate.d.ts +33 -6
- package/dist/extensions/jev/lib/evaluate.d.ts.map +1 -1
- package/dist/extensions/jev/lib/evaluate.js +44 -11
- package/dist/extensions/jev/skills/gated-write.md +1 -1
- package/dist/extensions/slack-communication/extension.d.ts +1 -1
- package/dist/extensions/slack-communication/extension.js +1 -1
- package/dist/extensions/slack-communication/skills/slack-voice.js +1 -1
- package/dist/extensions/slack-communication/tools/post-file.d.ts.map +1 -1
- package/dist/extensions/slack-communication/tools/post-file.js +45 -2
- package/dist/extensions.d.ts +2 -2
- package/dist/extensions.d.ts.map +1 -1
- package/dist/extensions.js +7 -3
- package/dist/files-backends/cursor-hosted.d.ts.map +1 -1
- package/dist/files-backends/cursor-hosted.js +5 -0
- package/dist/files-backends/local-fs.d.ts.map +1 -1
- package/dist/files-backends/local-fs.js +4 -3
- package/dist/filesystem.d.ts +24 -54
- package/dist/filesystem.d.ts.map +1 -1
- package/dist/filesystem.js +172 -104
- package/dist/hooks.d.ts +1 -1
- package/dist/hooks.js +1 -1
- package/dist/index.d.ts +11 -4
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +10 -3
- package/dist/internal/advertise-tools.d.ts +3 -3
- package/dist/internal/advertise-tools.d.ts.map +1 -1
- package/dist/internal/advertise-tools.js +9 -5
- package/dist/internal/artifacts-store.d.ts.map +1 -1
- package/dist/internal/artifacts-store.js +15 -6
- package/dist/internal/as-of.d.ts.map +1 -1
- package/dist/internal/as-of.js +4 -3
- package/dist/internal/authored-alias-hooks.d.ts +1 -20
- package/dist/internal/authored-alias-hooks.d.ts.map +1 -1
- package/dist/internal/authored-alias-hooks.js +54 -7
- package/dist/internal/authored-loaders.d.ts +2 -2
- package/dist/internal/authored-loaders.d.ts.map +1 -1
- package/dist/internal/authored-loaders.js +38 -13
- package/dist/internal/brand.d.ts.map +1 -1
- package/dist/internal/brand.js +25 -2
- package/dist/internal/builtin-tools/artifacts.d.ts.map +1 -1
- package/dist/internal/builtin-tools/artifacts.js +19 -3
- package/dist/internal/channel-dispatch.d.ts.map +1 -1
- package/dist/internal/channel-dispatch.js +1 -1
- package/dist/internal/channel-state.d.ts.map +1 -1
- package/dist/internal/channel-state.js +13 -8
- package/dist/internal/chat-client.d.ts.map +1 -1
- package/dist/internal/chat-client.js +14 -5
- package/dist/internal/cli/command.d.ts +134 -0
- package/dist/internal/cli/command.d.ts.map +1 -0
- package/dist/internal/cli/command.js +54 -0
- package/dist/internal/cli/commands/channels.d.ts +26 -0
- package/dist/internal/cli/commands/channels.d.ts.map +1 -0
- package/dist/internal/cli/commands/channels.js +524 -0
- package/dist/internal/cli/commands/develop.d.ts +15 -0
- package/dist/internal/cli/commands/develop.d.ts.map +1 -0
- package/dist/internal/cli/commands/develop.js +577 -0
- package/dist/internal/cli/commands/hosted.d.ts +22 -0
- package/dist/internal/cli/commands/hosted.d.ts.map +1 -0
- package/dist/internal/cli/commands/hosted.js +407 -0
- package/dist/internal/cli/commands/index.d.ts +4 -0
- package/dist/internal/cli/commands/index.d.ts.map +1 -0
- package/dist/internal/cli/commands/index.js +84 -0
- package/dist/internal/cli/commands/mcp.d.ts +6 -0
- package/dist/internal/cli/commands/mcp.d.ts.map +1 -0
- package/dist/internal/cli/commands/mcp.js +89 -0
- package/dist/internal/cli/commands/project.d.ts +5 -0
- package/dist/internal/cli/commands/project.d.ts.map +1 -0
- package/dist/internal/cli/commands/project.js +136 -0
- package/dist/internal/cli/commands/scaffold.d.ts +12 -0
- package/dist/internal/cli/commands/scaffold.d.ts.map +1 -0
- package/dist/internal/cli/commands/scaffold.js +282 -0
- package/dist/internal/cli/commands/serve.d.ts +11 -0
- package/dist/internal/cli/commands/serve.d.ts.map +1 -0
- package/dist/internal/cli/commands/serve.js +370 -0
- package/dist/internal/cli/commands/session.d.ts +7 -0
- package/dist/internal/cli/commands/session.d.ts.map +1 -0
- package/dist/internal/cli/commands/session.js +359 -0
- package/dist/internal/cli/dispatch.d.ts +46 -0
- package/dist/internal/cli/dispatch.d.ts.map +1 -0
- package/dist/internal/cli/dispatch.js +385 -0
- package/dist/internal/cli/errors.d.ts +51 -0
- package/dist/internal/cli/errors.d.ts.map +1 -0
- package/dist/internal/cli/errors.js +142 -0
- package/dist/internal/cli/flags.d.ts +186 -0
- package/dist/internal/cli/flags.d.ts.map +1 -0
- package/dist/internal/cli/flags.js +167 -0
- package/dist/internal/cli/help-command.d.ts +7 -0
- package/dist/internal/cli/help-command.d.ts.map +1 -0
- package/dist/internal/cli/help-command.js +60 -0
- package/dist/internal/cli/help.d.ts +63 -0
- package/dist/internal/cli/help.d.ts.map +1 -0
- package/dist/internal/cli/help.js +203 -0
- package/dist/internal/cli/io.d.ts +11 -0
- package/dist/internal/cli/io.d.ts.map +1 -0
- package/dist/internal/cli/io.js +33 -0
- package/dist/internal/cli/output.d.ts +54 -0
- package/dist/internal/cli/output.d.ts.map +1 -0
- package/dist/internal/cli/output.js +132 -0
- package/dist/internal/cli/value-kinds.d.ts +20 -0
- package/dist/internal/cli/value-kinds.d.ts.map +1 -0
- package/dist/internal/cli/value-kinds.js +70 -0
- package/dist/internal/cli-ax.d.ts +35 -20
- package/dist/internal/cli-ax.d.ts.map +1 -1
- package/dist/internal/cli-ax.js +439 -365
- package/dist/internal/cli-convert-automation.d.ts +3 -1
- package/dist/internal/cli-convert-automation.d.ts.map +1 -1
- package/dist/internal/cli-convert-automation.js +52 -20
- package/dist/internal/cli-cursor.js +5 -1
- package/dist/internal/cli-deploy.d.ts +23 -9
- package/dist/internal/cli-deploy.d.ts.map +1 -1
- package/dist/internal/cli-deploy.js +234 -508
- package/dist/internal/cli-docs.d.ts +1 -1
- package/dist/internal/cli-docs.js +3 -2
- package/dist/internal/cli-github.js +1 -0
- package/dist/internal/cli-images.d.ts.map +1 -1
- package/dist/internal/cli-images.js +44 -14
- package/dist/internal/cli-invocation.d.ts +22 -0
- package/dist/internal/cli-invocation.d.ts.map +1 -0
- package/dist/internal/cli-invocation.js +86 -0
- package/dist/internal/cli-manifest.d.ts +4 -1
- package/dist/internal/cli-manifest.d.ts.map +1 -1
- package/dist/internal/cli-manifest.js +16 -4
- package/dist/internal/cli-mcp-oauth.d.ts +7 -11
- package/dist/internal/cli-mcp-oauth.d.ts.map +1 -1
- package/dist/internal/cli-mcp-oauth.js +24 -104
- package/dist/internal/cli-mcp.d.ts +17 -28
- package/dist/internal/cli-mcp.d.ts.map +1 -1
- package/dist/internal/cli-mcp.js +64 -304
- package/dist/internal/cli-migrate.d.ts +3 -1
- package/dist/internal/cli-migrate.d.ts.map +1 -1
- package/dist/internal/cli-migrate.js +43 -15
- package/dist/internal/cli-pagerduty.d.ts +1 -1
- package/dist/internal/cli-pagerduty.js +1 -1
- package/dist/internal/cli-skills.d.ts +30 -2
- package/dist/internal/cli-skills.d.ts.map +1 -1
- package/dist/internal/cli-skills.js +63 -3
- package/dist/internal/cli-slack-context.d.ts +91 -0
- package/dist/internal/cli-slack-context.d.ts.map +1 -0
- package/dist/internal/cli-slack-context.js +112 -0
- package/dist/internal/cli-slack-manual.d.ts +2 -0
- package/dist/internal/cli-slack-manual.d.ts.map +1 -1
- package/dist/internal/cli-slack-manual.js +12 -0
- package/dist/internal/cli-slack.d.ts +1 -49
- package/dist/internal/cli-slack.d.ts.map +1 -1
- package/dist/internal/cli-slack.js +27 -147
- package/dist/internal/cloud-merge.d.ts +2 -4
- package/dist/internal/cloud-merge.d.ts.map +1 -1
- package/dist/internal/cloud-merge.js +2 -7
- package/dist/internal/continuation-channel.d.ts.map +1 -1
- package/dist/internal/continuation-channel.js +10 -22
- package/dist/internal/continuation-identity.d.ts +33 -12
- package/dist/internal/continuation-identity.d.ts.map +1 -1
- package/dist/internal/continuation-identity.js +161 -43
- package/dist/internal/continuation-registration.d.ts +26 -0
- package/dist/internal/continuation-registration.d.ts.map +1 -0
- package/dist/internal/continuation-registration.js +35 -0
- package/dist/internal/conversation-mirror.d.ts.map +1 -1
- package/dist/internal/conversation-mirror.js +23 -14
- package/dist/internal/convert-automation/convert-workflow.d.ts.map +1 -1
- package/dist/internal/convert-automation/convert-workflow.js +28 -22
- package/dist/internal/convert-automation/types.d.ts +1 -1
- package/dist/internal/convert-automation/types.js +1 -1
- package/dist/internal/cursor/account-mcp.js +1 -1
- package/dist/internal/cursor/backend-client.d.ts.map +1 -1
- package/dist/internal/cursor/backend-client.js +6 -8
- package/dist/internal/cursor/bound-secret-file.d.ts.map +1 -1
- package/dist/internal/cursor/bound-secret-file.js +2 -1
- package/dist/internal/cursor/credentials.d.ts +4 -17
- package/dist/internal/cursor/credentials.d.ts.map +1 -1
- package/dist/internal/cursor/credentials.js +11 -27
- package/dist/internal/cursor/session-token.d.ts.map +1 -1
- package/dist/internal/cursor/session-token.js +3 -4
- package/dist/internal/cursor/store-api-client.d.ts.map +1 -1
- package/dist/internal/cursor/store-api-client.js +3 -2
- package/dist/internal/cursor-agent-template.d.ts +1 -1
- package/dist/internal/cursor-agent-template.d.ts.map +1 -1
- package/dist/internal/cursor-agent-template.js +2 -2
- package/dist/internal/cursor-deployment-relay.d.ts.map +1 -1
- package/dist/internal/cursor-deployment-relay.js +24 -2
- package/dist/internal/cursor-event-relay.d.ts.map +1 -1
- package/dist/internal/cursor-event-relay.js +26 -2
- package/dist/internal/cursor-relay-core.d.ts.map +1 -1
- package/dist/internal/cursor-relay-core.js +22 -3
- package/dist/internal/deploy-client.d.ts +104 -94
- package/dist/internal/deploy-client.d.ts.map +1 -1
- package/dist/internal/deploy-client.js +143 -178
- package/dist/internal/deploy-manifest.d.ts +2 -2
- package/dist/internal/deploy-manifest.d.ts.map +1 -1
- package/dist/internal/deploy-manifest.js +6 -6
- package/dist/internal/describe-error.d.ts +4 -0
- package/dist/internal/describe-error.d.ts.map +1 -1
- package/dist/internal/describe-error.js +20 -0
- package/dist/internal/discovery/agent-config.d.ts +1 -5
- package/dist/internal/discovery/agent-config.d.ts.map +1 -1
- package/dist/internal/discovery/agent-config.js +5 -11
- package/dist/internal/discovery/agent.d.ts.map +1 -1
- package/dist/internal/discovery/agent.js +24 -30
- package/dist/internal/discovery/channels.d.ts.map +1 -1
- package/dist/internal/discovery/channels.js +2 -0
- package/dist/internal/discovery/connections.d.ts.map +1 -1
- package/dist/internal/discovery/connections.js +6 -4
- package/dist/internal/discovery/context.d.ts.map +1 -1
- package/dist/internal/discovery/context.js +6 -1
- package/dist/internal/discovery/extension-overlay.d.ts +1 -1
- package/dist/internal/discovery/extension-overlay.d.ts.map +1 -1
- package/dist/internal/discovery/extension-overlay.js +1 -0
- package/dist/internal/discovery/extensions.d.ts.map +1 -1
- package/dist/internal/discovery/extensions.js +12 -5
- package/dist/internal/discovery/fs.d.ts.map +1 -1
- package/dist/internal/discovery/fs.js +2 -1
- package/dist/internal/discovery/hooks.d.ts.map +1 -1
- package/dist/internal/discovery/hooks.js +1 -0
- package/dist/internal/discovery/info.d.ts.map +1 -1
- package/dist/internal/discovery/info.js +0 -3
- package/dist/internal/discovery/instructions.d.ts.map +1 -1
- package/dist/internal/discovery/instructions.js +4 -1
- package/dist/internal/discovery/instrumentation.js +1 -1
- package/dist/internal/discovery/modules.d.ts.map +1 -1
- package/dist/internal/discovery/modules.js +4 -1
- package/dist/internal/discovery/project.js +1 -1
- package/dist/internal/discovery/reminders.d.ts.map +1 -1
- package/dist/internal/discovery/reminders.js +1 -0
- package/dist/internal/discovery/runtime.d.ts +0 -16
- package/dist/internal/discovery/runtime.d.ts.map +1 -1
- package/dist/internal/discovery/runtime.js +2 -47
- package/dist/internal/discovery/schedules.d.ts.map +1 -1
- package/dist/internal/discovery/schedules.js +1 -0
- package/dist/internal/discovery/services.d.ts.map +1 -1
- package/dist/internal/discovery/services.js +3 -1
- package/dist/internal/discovery/skills.d.ts.map +1 -1
- package/dist/internal/discovery/skills.js +1 -0
- package/dist/internal/discovery/tools.d.ts +1 -1
- package/dist/internal/discovery/tools.d.ts.map +1 -1
- package/dist/internal/discovery/tools.js +3 -1
- package/dist/internal/discovery.d.ts +1 -1
- package/dist/internal/discovery.d.ts.map +1 -1
- package/dist/internal/discovery.js +1 -1
- package/dist/internal/distribution.d.ts +9 -14
- package/dist/internal/distribution.d.ts.map +1 -1
- package/dist/internal/distribution.js +54 -18
- package/dist/internal/docs-site.d.ts.map +1 -1
- package/dist/internal/docs-site.js +15 -2
- package/dist/internal/dry-run.d.ts +32 -0
- package/dist/internal/dry-run.d.ts.map +1 -0
- package/dist/internal/dry-run.js +62 -0
- package/dist/internal/duration.d.ts.map +1 -1
- package/dist/internal/duration.js +1 -0
- package/dist/internal/estimate-cost.d.ts.map +1 -1
- package/dist/internal/estimate-cost.js +12 -5
- package/dist/internal/eval-run-store.d.ts.map +1 -1
- package/dist/internal/eval-run-store.js +6 -5
- package/dist/internal/eval-runner.d.ts +0 -2
- package/dist/internal/eval-runner.d.ts.map +1 -1
- package/dist/internal/eval-runner.js +3 -3
- package/dist/internal/evals-client.d.ts.map +1 -1
- package/dist/internal/evals-client.js +60 -15
- package/dist/internal/event-log.d.ts.map +1 -1
- package/dist/internal/event-log.js +3 -11
- package/dist/internal/event-mapper.d.ts.map +1 -1
- package/dist/internal/event-mapper.js +33 -15
- package/dist/internal/expected-delivery-failure.d.ts.map +1 -1
- package/dist/internal/expected-delivery-failure.js +5 -4
- package/dist/internal/fetch-text.d.ts +8 -0
- package/dist/internal/fetch-text.d.ts.map +1 -0
- package/dist/internal/fetch-text.js +32 -0
- package/dist/internal/filesystem/errors.d.ts.map +1 -1
- package/dist/internal/filesystem/errors.js +8 -0
- package/dist/internal/filesystem/scratch.js +1 -4
- package/dist/internal/filesystem/sdk-schemas.d.ts +19 -19
- package/dist/internal/filesystem/sdk-schemas.d.ts.map +1 -1
- package/dist/internal/filesystem/sdk-schemas.js +15 -21
- package/dist/internal/filesystem/tools.d.ts +15 -4
- package/dist/internal/filesystem/tools.d.ts.map +1 -1
- package/dist/internal/filesystem/tools.js +33 -47
- package/dist/internal/filesystem/walk.d.ts.map +1 -1
- package/dist/internal/filesystem/walk.js +4 -0
- package/dist/internal/framework-file-storage.d.ts.map +1 -1
- package/dist/internal/framework-file-storage.js +2 -1
- package/dist/internal/frontmatter.d.ts.map +1 -1
- package/dist/internal/frontmatter.js +5 -1
- package/dist/internal/github-fanout.js +2 -1
- package/dist/internal/guest-network.d.ts.map +1 -1
- package/dist/internal/guest-network.js +6 -0
- package/dist/internal/handleAgentServeTrigger.d.ts +8 -0
- package/dist/internal/handleAgentServeTrigger.d.ts.map +1 -1
- package/dist/internal/handleAgentServeTrigger.js +27 -1
- package/dist/internal/host-kv.d.ts.map +1 -1
- package/dist/internal/host-kv.js +4 -2
- package/dist/internal/host-otel.d.ts.map +1 -1
- package/dist/internal/host-otel.js +2 -8
- package/dist/internal/host-platforms.d.ts.map +1 -1
- package/dist/internal/host-platforms.js +17 -10
- package/dist/internal/hosted-catch-protocol.d.ts.map +1 -1
- package/dist/internal/hosted-catch-protocol.js +26 -9
- package/dist/internal/hosted-catch.d.ts +13 -10
- package/dist/internal/hosted-catch.d.ts.map +1 -1
- package/dist/internal/hosted-catch.js +23 -11
- package/dist/internal/hosted-delivery-protocol.d.ts +1 -1
- package/dist/internal/hosted-delivery-protocol.d.ts.map +1 -1
- package/dist/internal/hosted-delivery-protocol.js +75 -45
- package/dist/internal/hosted-delivery.d.ts +1 -2
- package/dist/internal/hosted-delivery.d.ts.map +1 -1
- package/dist/internal/hosted-delivery.js +27 -32
- package/dist/internal/hosted-execution-diag.d.ts.map +1 -1
- package/dist/internal/hosted-execution-diag.js +11 -13
- package/dist/internal/hosted-execution-flush.js +1 -1
- package/dist/internal/hosted-execution-latency.d.ts.map +1 -1
- package/dist/internal/hosted-execution-latency.js +12 -1
- package/dist/internal/hosted-hints.d.ts +16 -0
- package/dist/internal/hosted-hints.d.ts.map +1 -0
- package/dist/internal/hosted-hints.js +23 -0
- package/dist/internal/hosted-managed-automation.d.ts.map +1 -1
- package/dist/internal/hosted-managed-automation.js +1 -0
- package/dist/internal/hosted-session-fixture.d.ts +26 -0
- package/dist/internal/hosted-session-fixture.d.ts.map +1 -0
- package/dist/internal/hosted-session-fixture.js +34 -0
- package/dist/internal/hosted-session-view.d.ts +48 -0
- package/dist/internal/hosted-session-view.d.ts.map +1 -0
- package/dist/internal/hosted-session-view.js +305 -0
- package/dist/internal/http-channel.d.ts.map +1 -1
- package/dist/internal/http-channel.js +8 -5
- package/dist/internal/http-control-plane-session.d.ts.map +1 -1
- package/dist/internal/http-control-plane-session.js +8 -9
- package/dist/internal/init-interview.js +2 -2
- package/dist/internal/init-project.d.ts +14 -16
- package/dist/internal/init-project.d.ts.map +1 -1
- package/dist/internal/init-project.js +63 -27
- package/dist/internal/init-scaffold.d.ts +2 -1
- package/dist/internal/init-scaffold.d.ts.map +1 -1
- package/dist/internal/init-scaffold.js +22 -9
- package/dist/internal/inline-stdio-define-stub.d.ts +1 -1
- package/dist/internal/inline-stdio-define-stub.d.ts.map +1 -1
- package/dist/internal/inline-stdio-define-stub.js +1 -1
- package/dist/internal/inline-stdio-mcp.d.ts.map +1 -1
- package/dist/internal/inline-stdio-mcp.js +31 -8
- package/dist/internal/install-cursor-skills.d.ts +22 -15
- package/dist/internal/install-cursor-skills.d.ts.map +1 -1
- package/dist/internal/install-cursor-skills.js +66 -31
- package/dist/internal/interview/agent-questions.d.ts.map +1 -1
- package/dist/internal/interview/agent-questions.js +4 -1
- package/dist/internal/interview/question.d.ts +1 -1
- package/dist/internal/interview/question.js +1 -1
- package/dist/internal/json-schema.d.ts +3 -2
- package/dist/internal/json-schema.d.ts.map +1 -1
- package/dist/internal/json-schema.js +83 -3
- package/dist/internal/json-value.d.ts +20 -0
- package/dist/internal/json-value.d.ts.map +1 -0
- package/dist/internal/json-value.js +56 -0
- package/dist/internal/logs-client.d.ts +4 -25
- package/dist/internal/logs-client.d.ts.map +1 -1
- package/dist/internal/logs-client.js +17 -174
- package/dist/internal/mcp-endpoint.d.ts +1 -1
- package/dist/internal/mcp-endpoint.js +2 -1
- package/dist/internal/mcp-host.d.ts.map +1 -1
- package/dist/internal/mcp-host.js +22 -9
- package/dist/internal/mcp-oauth.d.ts +2 -2
- package/dist/internal/mcp-oauth.d.ts.map +1 -1
- package/dist/internal/mcp-oauth.js +61 -8
- package/dist/internal/named-webhook-secret.d.ts +12 -0
- package/dist/internal/named-webhook-secret.d.ts.map +1 -1
- package/dist/internal/named-webhook-secret.js +18 -0
- package/dist/internal/otel/bind-telemetry.d.ts +26 -0
- package/dist/internal/otel/bind-telemetry.d.ts.map +1 -0
- package/dist/internal/otel/bind-telemetry.js +36 -0
- package/dist/internal/otel/collector.d.ts.map +1 -1
- package/dist/internal/otel/collector.js +94 -42
- package/dist/internal/otel/config.d.ts.map +1 -1
- package/dist/internal/otel/config.js +4 -3
- package/dist/internal/otel/conversation-span-processor.d.ts.map +1 -1
- package/dist/internal/otel/conversation-span-processor.js +5 -2
- package/dist/internal/otel/customer.d.ts +1 -5
- package/dist/internal/otel/customer.d.ts.map +1 -1
- package/dist/internal/otel/customer.js +35 -13
- package/dist/internal/otel/http.d.ts +1 -1
- package/dist/internal/otel/http.d.ts.map +1 -1
- package/dist/internal/otel/http.js +5 -3
- package/dist/internal/otel/propagation.d.ts +3 -2
- package/dist/internal/otel/propagation.d.ts.map +1 -1
- package/dist/internal/otel/propagation.js +3 -2
- package/dist/internal/otel/reserved-attributes.d.ts +8 -0
- package/dist/internal/otel/reserved-attributes.d.ts.map +1 -0
- package/dist/internal/otel/reserved-attributes.js +24 -0
- package/dist/internal/otel/runtime.d.ts.map +1 -1
- package/dist/internal/otel/runtime.js +9 -2
- package/dist/internal/otel/session-telemetry.d.ts +22 -0
- package/dist/internal/otel/session-telemetry.d.ts.map +1 -0
- package/dist/internal/otel/session-telemetry.js +30 -0
- package/dist/internal/otel/telemetry-attributes.d.ts +7 -0
- package/dist/internal/otel/telemetry-attributes.d.ts.map +1 -0
- package/dist/internal/otel/telemetry-attributes.js +35 -0
- package/dist/internal/otel/telemetry-processor.d.ts +7 -0
- package/dist/internal/otel/telemetry-processor.d.ts.map +1 -0
- package/dist/internal/otel/telemetry-processor.js +47 -0
- package/dist/internal/otel/tool-error-class.d.ts.map +1 -1
- package/dist/internal/otel/tool-error-class.js +4 -0
- package/dist/internal/package-inline-stdio.d.ts.map +1 -1
- package/dist/internal/package-inline-stdio.js +2 -2
- package/dist/internal/peer-connections.js +1 -1
- package/dist/internal/persistent-stage-log-mirror.js +2 -5
- package/dist/internal/platform-timers.d.ts.map +1 -1
- package/dist/internal/platform-timers.js +32 -1
- package/dist/internal/playground/toolchain.d.ts.map +1 -1
- package/dist/internal/playground/toolchain.js +16 -3
- package/dist/internal/playground-proxy.d.ts +6 -27
- package/dist/internal/playground-proxy.d.ts.map +1 -1
- package/dist/internal/playground-proxy.js +25 -83
- package/dist/internal/private-file.d.ts +2 -0
- package/dist/internal/private-file.d.ts.map +1 -0
- package/dist/internal/private-file.js +8 -0
- package/dist/internal/reminder-control-plane-protocol.d.ts.map +1 -1
- package/dist/internal/reminder-control-plane-protocol.js +4 -2
- package/dist/internal/reminder-runner.d.ts.map +1 -1
- package/dist/internal/reminder-runner.js +12 -25
- package/dist/internal/reminder-schedule.js +1 -1
- package/dist/internal/reminder-store.d.ts.map +1 -1
- package/dist/internal/reminder-store.js +16 -21
- package/dist/internal/request-headers.d.ts +2 -2
- package/dist/internal/request-headers.d.ts.map +1 -1
- package/dist/internal/request-headers.js +1 -1
- package/dist/internal/resolve-prod-target.d.ts +9 -65
- package/dist/internal/resolve-prod-target.d.ts.map +1 -1
- package/dist/internal/resolve-prod-target.js +20 -187
- package/dist/internal/resolved-connections.js +1 -1
- package/dist/internal/{factory-resource-channel.d.ts → resource-channel.d.ts} +10 -10
- package/dist/internal/resource-channel.d.ts.map +1 -0
- package/dist/internal/{factory-resource-channel.js → resource-channel.js} +9 -7
- package/dist/internal/run-client.d.ts.map +1 -1
- package/dist/internal/run-client.js +4 -1
- package/dist/internal/sdk-runner.d.ts +2 -2
- package/dist/internal/sdk-runner.d.ts.map +1 -1
- package/dist/internal/sdk-runner.js +19 -16
- package/dist/internal/sdk-subagent-inherit-support.d.ts.map +1 -1
- package/dist/internal/sdk-subagent-inherit-support.js +3 -2
- package/dist/internal/serve-restart.d.ts +3 -0
- package/dist/internal/serve-restart.d.ts.map +1 -1
- package/dist/internal/serve-restart.js +8 -4
- package/dist/internal/server.d.ts +5 -1
- package/dist/internal/server.d.ts.map +1 -1
- package/dist/internal/server.js +71 -64
- package/dist/internal/session-cost.d.ts +4 -4
- package/dist/internal/session-cost.d.ts.map +1 -1
- package/dist/internal/session-cost.js +5 -5
- package/dist/internal/session-engine.d.ts +22 -8
- package/dist/internal/session-engine.d.ts.map +1 -1
- package/dist/internal/session-engine.js +170 -75
- package/dist/internal/session-links.js +2 -1
- package/dist/internal/session-live-publisher.d.ts +0 -7
- package/dist/internal/session-live-publisher.d.ts.map +1 -1
- package/dist/internal/session-live-publisher.js +20 -7
- package/dist/internal/session-run-log.d.ts.map +1 -1
- package/dist/internal/session-run-log.js +19 -5
- package/dist/internal/session-store.d.ts.map +1 -1
- package/dist/internal/session-store.js +17 -3
- package/dist/internal/sessions-client.d.ts +2 -0
- package/dist/internal/sessions-client.d.ts.map +1 -1
- package/dist/internal/sessions-client.js +44 -10
- package/dist/internal/shallow-clone.d.ts +258 -0
- package/dist/internal/shallow-clone.d.ts.map +1 -0
- package/dist/internal/shallow-clone.js +644 -0
- package/dist/internal/slack-bot-scopes.d.ts +3 -0
- package/dist/internal/slack-bot-scopes.d.ts.map +1 -0
- package/dist/internal/slack-bot-scopes.js +2 -0
- package/dist/internal/slack-manifest-opt-in.d.ts +26 -0
- package/dist/internal/slack-manifest-opt-in.d.ts.map +1 -0
- package/dist/internal/slack-manifest-opt-in.js +63 -0
- package/dist/internal/slack-provision-client.d.ts +8 -24
- package/dist/internal/slack-provision-client.d.ts.map +1 -1
- package/dist/internal/slack-provision-client.js +21 -20
- package/dist/internal/slack-thread-key.d.ts +8 -3
- package/dist/internal/slack-thread-key.d.ts.map +1 -1
- package/dist/internal/slack-thread-key.js +6 -6
- package/dist/internal/sqlite-experimental-warning.js +1 -1
- package/dist/internal/start-log-store.d.ts.map +1 -1
- package/dist/internal/start-log-store.js +2 -5
- package/dist/internal/storage-coordinator.d.ts.map +1 -1
- package/dist/internal/storage-coordinator.js +49 -20
- package/dist/internal/stored-eval-run.d.ts +17 -0
- package/dist/internal/stored-eval-run.d.ts.map +1 -0
- package/dist/internal/stored-eval-run.js +305 -0
- package/dist/internal/stream-progress.d.ts.map +1 -1
- package/dist/internal/stream-progress.js +1 -1
- package/dist/internal/tcp-address.d.ts +4 -0
- package/dist/internal/tcp-address.d.ts.map +1 -0
- package/dist/internal/tcp-address.js +8 -0
- package/dist/internal/terminal-style.js +2 -2
- package/dist/internal/testing/pagerduty-continuation-fixtures.d.ts +1 -1
- package/dist/internal/testing/pagerduty-continuation-fixtures.js +1 -1
- package/dist/internal/testing/scm-continuation-fixtures.d.ts +1 -1
- package/dist/internal/testing/scm-continuation-fixtures.js +1 -1
- package/dist/internal/testing/slack-continuation-fixtures.d.ts +12 -6
- package/dist/internal/testing/slack-continuation-fixtures.d.ts.map +1 -1
- package/dist/internal/testing/slack-continuation-fixtures.js +74 -3
- package/dist/internal/tool-call-retry.d.ts +35 -7
- package/dist/internal/tool-call-retry.d.ts.map +1 -1
- package/dist/internal/tool-call-retry.js +108 -108
- package/dist/internal/tool-catalog.d.ts.map +1 -1
- package/dist/internal/tool-catalog.js +7 -2
- package/dist/internal/tool-policy.d.ts +20 -7
- package/dist/internal/tool-policy.d.ts.map +1 -1
- package/dist/internal/tool-policy.js +39 -11
- package/dist/internal/tool-result.d.ts +0 -5
- package/dist/internal/tool-result.d.ts.map +1 -1
- package/dist/internal/tool-result.js +26 -6
- package/dist/internal/trajectory.d.ts.map +1 -1
- package/dist/internal/trajectory.js +5 -1
- package/dist/internal/turn-outbox.d.ts.map +1 -1
- package/dist/internal/turn-outbox.js +1 -0
- package/dist/internal/update-check.d.ts +2 -0
- package/dist/internal/update-check.d.ts.map +1 -1
- package/dist/internal/update-check.js +4 -0
- package/dist/internal/workspace.d.ts +3 -4
- package/dist/internal/workspace.d.ts.map +1 -1
- package/dist/internal/workspace.js +5 -5
- package/dist/kv/memory-kv.d.ts +1 -1
- package/dist/kv/memory-kv.js +1 -1
- package/dist/kv.d.ts +9 -2
- package/dist/kv.d.ts.map +1 -1
- package/dist/kv.js +10 -2
- package/dist/memory.d.ts +1 -1
- package/dist/memory.js +1 -1
- package/dist/otel-public.d.ts +2 -1
- package/dist/otel-public.d.ts.map +1 -1
- package/dist/otel-public.js +2 -1
- package/dist/otel.d.ts.map +1 -1
- package/dist/otel.js +6 -2
- package/dist/playground/assets/cursor-icons-16-QUmxS7q3.woff2 +0 -0
- package/dist/playground/assets/index-Cl9zvmmf.js +62 -0
- package/dist/playground/assets/index-F8b5WvWi.css +1 -0
- package/dist/playground/index.html +2 -2
- package/dist/prompt.d.ts +1 -1
- package/dist/prompt.js +1 -1
- package/dist/public-deprecated.d.ts +11 -12
- package/dist/public-deprecated.d.ts.map +1 -1
- package/dist/public-deprecated.js +8 -9
- package/dist/reminders.d.ts +2 -2
- package/dist/reminders.js +2 -2
- package/dist/schedules.d.ts +1 -1
- package/dist/schedules.js +1 -1
- package/dist/scm.d.ts +2 -0
- package/dist/scm.d.ts.map +1 -0
- package/dist/scm.js +1 -0
- package/dist/skills.d.ts +1 -1
- package/dist/skills.js +1 -1
- package/dist/storage-backends/cursor-hosted.d.ts.map +1 -1
- package/dist/storage-backends/cursor-hosted.js +5 -3
- package/dist/storage-backends/file-kv.d.ts +3 -2
- package/dist/storage-backends/file-kv.d.ts.map +1 -1
- package/dist/storage-backends/file-kv.js +20 -8
- package/dist/storage.d.ts +2 -3
- package/dist/storage.d.ts.map +1 -1
- package/dist/storage.js +9 -5
- package/dist/telemetry.d.ts +12 -0
- package/dist/telemetry.d.ts.map +1 -0
- package/dist/telemetry.js +11 -0
- package/dist/tools.d.ts +1 -1
- package/dist/tools.d.ts.map +1 -1
- package/dist/tools.js +2 -1
- package/dist/types.d.ts +59 -46
- package/dist/types.d.ts.map +1 -1
- package/dist/types.js +4 -4
- package/docs/README.md +33 -33
- package/docs/building-with-agents.md +16 -16
- package/docs/changelog.md +58 -12
- package/docs/deployment.md +116 -54
- package/docs/evals.md +14 -12
- package/docs/guides/agent-to-agent.md +8 -8
- package/docs/guides/bitbucket.md +5 -5
- package/docs/guides/cloud-agents.md +4 -4
- package/docs/guides/convert-automation.md +17 -16
- package/docs/guides/github.md +16 -16
- package/docs/guides/gitlab.md +5 -5
- package/docs/guides/hooks.md +3 -3
- package/docs/guides/improve.md +2 -2
- package/docs/guides/jev.md +15 -10
- package/docs/guides/mcp-oauth.md +9 -10
- package/docs/guides/migrate.md +35 -28
- package/docs/guides/opentelemetry.md +61 -130
- package/docs/guides/pagerduty.md +18 -18
- package/docs/guides/slack.md +85 -15
- package/docs/guides/webhooks.md +61 -3
- package/docs/hillclimbing.md +2 -2
- package/docs/quickstart.md +26 -22
- package/docs/reference/access.md +27 -0
- package/docs/reference/agent-config.md +54 -12
- package/docs/reference/artifacts.md +2 -2
- package/docs/reference/channels.md +29 -9
- package/docs/reference/cli.md +364 -367
- package/docs/reference/connections.md +9 -9
- package/docs/reference/evals.md +48 -13
- package/docs/reference/extensions.md +12 -12
- package/docs/reference/hooks.md +11 -11
- package/docs/reference/http-api.md +1 -1
- package/docs/reference/instructions.md +1 -1
- package/docs/reference/limits.md +42 -0
- package/docs/reference/memory.md +7 -7
- package/docs/reference/playground.md +1 -1
- package/docs/reference/project-layout.md +6 -6
- package/docs/reference/prompt.md +2 -2
- package/docs/reference/schedules.md +4 -4
- package/docs/reference/sessions.md +3 -3
- package/docs/reference/skills.md +2 -2
- package/docs/reference/subagents.md +1 -1
- package/docs/reference/tools.md +31 -21
- package/docs/templates/agentic-owners.md +7 -7
- package/docs/templates/security-reviewer.md +6 -6
- package/docs/templates/thermo-quality-review.md +7 -7
- package/docs/templates/thermo-review.md +7 -7
- package/docs/templates/triage.md +9 -9
- package/docs/troubleshooting.md +26 -24
- package/package.json +52 -99
- package/scripts/install-cursor-skills.mjs +2 -2
- package/skills/cli/SKILL.md +125 -0
- package/skills/create-agent/SKILL.md +29 -26
- package/skills/debug/SKILL.md +6 -6
- package/skills/deploy/SKILL.md +47 -44
- package/skills/evals/SKILL.md +13 -13
- package/skills/framework-map/SKILL.md +9 -8
- package/skills/github/SKILL.md +10 -10
- package/skills/hillclimb/SKILL.md +6 -6
- package/skills/mcp-auth/SKILL.md +3 -3
- package/skills/migrate-v2/SKILL.md +67 -70
- package/skills/otel/SKILL.md +36 -6
- package/skills/setup-slack/SKILL.md +11 -11
- package/templates/agentic-owners/README.md +6 -6
- package/templates/agentic-owners/bot/agent.ts +1 -1
- package/templates/agentic-owners/bot/channels/github.ts +1 -1
- package/templates/agentic-owners/bot/lib/github.ts +2 -2
- package/templates/agentic-owners/bot/lib/owners/parse.ts +1 -1
- package/templates/agentic-owners/bot/lib/owners/policyMode.ts +6 -2
- package/templates/agentic-owners/bot/lib/review.ts +7 -3
- package/templates/agentic-owners/bot/tools/record_review.ts +3 -3
- package/templates/agentic-owners/evals/evals.config.ts +1 -1
- package/templates/agentic-owners/evals/owners.eval.ts +1 -1
- package/templates/agentic-owners/package.json +3 -3
- package/templates/agents-md/README.md +5 -5
- package/templates/agents-md/bot/agent.ts +1 -1
- package/templates/agents-md/bot/channels/github.ts +1 -1
- package/templates/agents-md/bot/channels/queue.ts +5 -3
- package/templates/agents-md/bot/channels/slack.ts +1 -1
- package/templates/agents-md/bot/lib/collect.ts +1 -1
- package/templates/agents-md/bot/schedules/weekly.ts +6 -6
- package/templates/agents-md/bot/tools/apply_agents.ts +2 -2
- package/templates/agents-md/evals/agents.eval.ts +1 -1
- package/templates/agents-md/evals/evals.config.ts +1 -1
- package/templates/agents-md/package.json +3 -3
- package/templates/code-wiki/README.md +4 -4
- package/templates/code-wiki/bot/agent.ts +1 -1
- package/templates/code-wiki/bot/channels/github.ts +3 -3
- package/templates/code-wiki/bot/tools/apply_wiki.ts +3 -3
- package/templates/code-wiki/evals/evals.config.ts +1 -1
- package/templates/code-wiki/evals/wiki.eval.ts +1 -1
- package/templates/code-wiki/package.json +3 -3
- package/templates/demo/README.md +4 -4
- package/templates/demo/bot/agent.ts +1 -1
- package/templates/demo/bot/channels/github.ts +7 -3
- package/templates/demo/bot/channels/queue.ts +5 -5
- package/templates/demo/bot/lib/collect.ts +2 -2
- package/templates/demo/bot/tools/record_demo.ts +2 -2
- package/templates/demo/evals/demo.eval.ts +1 -1
- package/templates/demo/evals/evals.config.ts +1 -1
- package/templates/demo/package.json +3 -3
- package/templates/pr-autofixer/bot/agent.ts +1 -1
- package/templates/pr-autofixer/bot/channels/drive.ts +1 -1
- package/templates/pr-autofixer/bot/channels/github.ts +3 -3
- package/templates/pr-autofixer/bot/channels/slack.ts +1 -1
- package/templates/pr-autofixer/bot/hooks/bind-agent.ts +1 -1
- package/templates/pr-autofixer/bot/lib/affinity.ts +1 -1
- package/templates/pr-autofixer/bot/lib/drive.ts +2 -2
- package/templates/pr-autofixer/bot/lib/merge-watch.ts +4 -4
- package/templates/pr-autofixer/bot/lib/pr-state.ts +1 -1
- package/templates/pr-autofixer/bot/lib/start-drive.ts +2 -2
- package/templates/pr-autofixer/bot/lib/webhook-buffer.ts +1 -1
- package/templates/pr-autofixer/bot/lib/webhook-routing.ts +1 -1
- package/templates/pr-autofixer/bot/tools/drive_pr.ts +1 -1
- package/templates/pr-autofixer/evals/coordinator.eval.ts +1 -1
- package/templates/pr-autofixer/evals/evals.config.ts +1 -1
- package/templates/pr-autofixer/package.json +3 -3
- package/templates/security-help/.gitignore +4 -0
- package/templates/security-help/README.md +6 -6
- package/templates/security-help/bot/agent.ts +1 -1
- package/templates/security-help/bot/channels/github.ts +1 -1
- package/templates/security-help/bot/channels/slack.ts +1 -1
- package/templates/security-help/bot/lib/pr-first-pass.ts +3 -3
- package/templates/security-help/evals/evals.config.ts +1 -1
- package/templates/security-help/evals/security-help.eval.ts +1 -1
- package/templates/security-help/package.json +2 -2
- package/templates/security-reviewer/README.md +4 -4
- package/templates/security-reviewer/bot/agent.ts +1 -1
- package/templates/security-reviewer/bot/channels/github.ts +2 -2
- package/templates/security-reviewer/bot/tools/post_findings.ts +2 -2
- package/templates/security-reviewer/evals/evals.config.ts +1 -1
- package/templates/security-reviewer/evals/review.eval.ts +1 -1
- package/templates/security-reviewer/package.json +3 -3
- package/templates/thermo-quality-review/README.md +5 -5
- package/templates/thermo-quality-review/bot/agent.ts +1 -1
- package/templates/thermo-quality-review/bot/channels/github.ts +2 -2
- package/templates/thermo-quality-review/bot/tools/post_findings.ts +2 -2
- package/templates/thermo-quality-review/evals/evals.config.ts +1 -1
- package/templates/thermo-quality-review/evals/review.eval.ts +1 -1
- package/templates/thermo-quality-review/package.json +3 -3
- package/templates/thermo-review/README.md +5 -5
- package/templates/thermo-review/bot/agent.ts +1 -1
- package/templates/thermo-review/bot/channels/github.ts +2 -2
- package/templates/thermo-review/bot/tools/post_findings.ts +2 -2
- package/templates/thermo-review/evals/evals.config.ts +1 -1
- package/templates/thermo-review/evals/review.eval.ts +1 -1
- package/templates/thermo-review/package.json +3 -3
- package/templates/triage/README.md +5 -5
- package/templates/triage/bot/agent.ts +1 -1
- package/templates/triage/bot/channels/queue.ts +5 -5
- package/templates/triage/bot/channels/webhook.ts +5 -5
- package/templates/triage/bot/hooks/memory.ts +1 -1
- package/templates/triage/bot/lib/actuate.ts +2 -2
- package/templates/triage/bot/tools/record_triage.ts +1 -1
- package/templates/triage/evals/evals.config.ts +1 -1
- package/templates/triage/evals/triage.eval.ts +1 -1
- package/templates/triage/overlays/jira/README.md +4 -4
- package/templates/triage/overlays/jira/bot/mcp-connections/tracker.ts +1 -1
- package/templates/triage/overlays/linear/README.md +4 -4
- package/templates/triage/overlays/linear/bot/mcp-connections/tracker.ts +1 -1
- package/templates/triage/package.json +3 -3
- package/dist/bin/agent-sdk.js +0 -2
- package/dist/docs/assets/building-with-agents.md.FZXrY8Nk.js +0 -9
- package/dist/docs/assets/building-with-agents.md.FZXrY8Nk.lean.js +0 -1
- package/dist/docs/assets/changelog.md.BvHRIiMH.js +0 -1
- package/dist/docs/assets/changelog.md.BvHRIiMH.lean.js +0 -1
- package/dist/docs/assets/chunks/@localSearchIndexroot.BoDEJQWv.js +0 -1
- package/dist/docs/assets/chunks/channel.D2BTz0L-.js +0 -1
- package/dist/docs/assets/chunks/classDiagram-6PBFFD2Q.DqByliAC.js +0 -1
- package/dist/docs/assets/chunks/classDiagram-v2-HSJHXN6E.DqByliAC.js +0 -1
- package/dist/docs/assets/chunks/clone.CldT1lbQ.js +0 -1
- package/dist/docs/assets/chunks/stateDiagram-v2-QKLJ7IA2.Bb4oMe0P.js +0 -1
- package/dist/docs/assets/deployment.md.3MMWuPeV.js +0 -31
- package/dist/docs/assets/deployment.md.3MMWuPeV.lean.js +0 -1
- package/dist/docs/assets/guides_agent-to-agent.md.CwL5cwuE.lean.js +0 -1
- package/dist/docs/assets/guides_cloud-agents.md.BzbzcOyj.js +0 -9
- package/dist/docs/assets/guides_cloud-agents.md.BzbzcOyj.lean.js +0 -1
- package/dist/docs/assets/guides_convert-automation.md.DMEX9nF-.lean.js +0 -1
- package/dist/docs/assets/guides_export-grokbot.md.qo5bxi4h.js +0 -55
- package/dist/docs/assets/guides_export-grokbot.md.qo5bxi4h.lean.js +0 -1
- package/dist/docs/assets/guides_grokbot-agents.md.BwAykJ7U.js +0 -15
- package/dist/docs/assets/guides_grokbot-agents.md.BwAykJ7U.lean.js +0 -1
- package/dist/docs/assets/guides_migrate.md.CQlGaBKX.js +0 -7
- package/dist/docs/assets/guides_migrate.md.CQlGaBKX.lean.js +0 -1
- package/dist/docs/assets/guides_opentelemetry.md.D4wO7_8v.js +0 -37
- package/dist/docs/assets/guides_opentelemetry.md.D4wO7_8v.lean.js +0 -1
- package/dist/docs/assets/index.md.CAnsLl8D.js +0 -27
- package/dist/docs/assets/index.md.CAnsLl8D.lean.js +0 -1
- package/dist/docs/assets/quickstart.md.D8JDfkKO.lean.js +0 -1
- package/dist/docs/assets/reference_channels.md.CNNIS6K7.js +0 -22
- package/dist/docs/assets/reference_cli.md.1o_TqKdt.js +0 -103
- package/dist/docs/assets/reference_cli.md.1o_TqKdt.lean.js +0 -1
- package/dist/docs/assets/reference_memory.md.BwyJXYZe.js +0 -4
- package/dist/docs/assets/reference_playground.md.q4MI-0td.js +0 -1
- package/dist/docs/assets/templates_grokbot-agents.md.DgpPEs7B.js +0 -5
- package/dist/docs/assets/templates_grokbot-agents.md.DgpPEs7B.lean.js +0 -1
- package/dist/docs/assets/templates_security-reviewer.md.Gh6EF9Us.js +0 -3
- package/dist/docs/assets/templates_thermo-quality-review.md.B77UyTrX.js +0 -3
- package/dist/docs/assets/templates_thermo-review.md.DRJ7mC5U.js +0 -3
- package/dist/docs/assets/troubleshooting.md.DFnoTDlQ.js +0 -1
- package/dist/docs/guides/export-grokbot.html +0 -114
- package/dist/docs/guides/export-grokbot.md +0 -239
- package/dist/docs/guides/grokbot-agents.html +0 -74
- package/dist/docs/guides/grokbot-agents.md +0 -135
- package/dist/docs/templates/grokbot-agents.html +0 -64
- package/dist/docs/templates/grokbot-agents.md +0 -55
- package/dist/extensions/cursor-grokbot-agents/extension.d.ts +0 -77
- package/dist/extensions/cursor-grokbot-agents/extension.d.ts.map +0 -1
- package/dist/extensions/cursor-grokbot-agents/extension.js +0 -70
- package/dist/extensions/cursor-grokbot-agents/lib/agents.d.ts +0 -11
- package/dist/extensions/cursor-grokbot-agents/lib/agents.d.ts.map +0 -1
- package/dist/extensions/cursor-grokbot-agents/lib/agents.js +0 -31
- package/dist/extensions/cursor-grokbot-agents/lib/backend.d.ts +0 -56
- package/dist/extensions/cursor-grokbot-agents/lib/backend.d.ts.map +0 -1
- package/dist/extensions/cursor-grokbot-agents/lib/backend.js +0 -138
- package/dist/extensions/cursor-grokbot-agents/lib/contacts.d.ts +0 -28
- package/dist/extensions/cursor-grokbot-agents/lib/contacts.d.ts.map +0 -1
- package/dist/extensions/cursor-grokbot-agents/lib/contacts.js +0 -46
- package/dist/extensions/cursor-grokbot-agents/lib/conversation.d.ts +0 -53
- package/dist/extensions/cursor-grokbot-agents/lib/conversation.d.ts.map +0 -1
- package/dist/extensions/cursor-grokbot-agents/lib/conversation.js +0 -186
- package/dist/extensions/cursor-grokbot-agents/lib/inputs.d.ts +0 -4
- package/dist/extensions/cursor-grokbot-agents/lib/inputs.d.ts.map +0 -1
- package/dist/extensions/cursor-grokbot-agents/lib/inputs.js +0 -15
- package/dist/extensions/cursor-grokbot-agents/lib/lock.d.ts +0 -12
- package/dist/extensions/cursor-grokbot-agents/lib/lock.d.ts.map +0 -1
- package/dist/extensions/cursor-grokbot-agents/lib/lock.js +0 -24
- package/dist/extensions/cursor-grokbot-agents/skills/consult.md +0 -40
- package/dist/extensions/cursor-grokbot-agents/tools/ask.d.ts +0 -4
- package/dist/extensions/cursor-grokbot-agents/tools/ask.d.ts.map +0 -1
- package/dist/extensions/cursor-grokbot-agents/tools/ask.js +0 -26
- package/dist/extensions/cursor-grokbot-agents/tools/check.d.ts +0 -4
- package/dist/extensions/cursor-grokbot-agents/tools/check.d.ts.map +0 -1
- package/dist/extensions/cursor-grokbot-agents/tools/check.js +0 -21
- package/dist/extensions/cursor-grokbot-agents/tools/interrupt.d.ts +0 -4
- package/dist/extensions/cursor-grokbot-agents/tools/interrupt.d.ts.map +0 -1
- package/dist/extensions/cursor-grokbot-agents/tools/interrupt.js +0 -13
- package/dist/extensions/cursor-grokbot-agents/tools/list.d.ts +0 -4
- package/dist/extensions/cursor-grokbot-agents/tools/list.d.ts.map +0 -1
- package/dist/extensions/cursor-grokbot-agents/tools/list.js +0 -22
- package/dist/internal/cli-init-grokbot.d.ts +0 -29
- package/dist/internal/cli-init-grokbot.d.ts.map +0 -1
- package/dist/internal/cli-init-grokbot.js +0 -181
- package/dist/internal/convert-grokbot/answers.d.ts +0 -127
- package/dist/internal/convert-grokbot/answers.d.ts.map +0 -1
- package/dist/internal/convert-grokbot/answers.js +0 -445
- package/dist/internal/convert-grokbot/bot.d.ts +0 -50
- package/dist/internal/convert-grokbot/bot.d.ts.map +0 -1
- package/dist/internal/convert-grokbot/bot.js +0 -72
- package/dist/internal/convert-grokbot/checks.d.ts +0 -26
- package/dist/internal/convert-grokbot/checks.d.ts.map +0 -1
- package/dist/internal/convert-grokbot/checks.js +0 -170
- package/dist/internal/convert-grokbot/convert.d.ts +0 -60
- package/dist/internal/convert-grokbot/convert.d.ts.map +0 -1
- package/dist/internal/convert-grokbot/convert.js +0 -470
- package/dist/internal/convert-grokbot/handoff.d.ts +0 -44
- package/dist/internal/convert-grokbot/handoff.d.ts.map +0 -1
- package/dist/internal/convert-grokbot/handoff.js +0 -160
- package/dist/internal/convert-grokbot/recipe.d.ts +0 -61
- package/dist/internal/convert-grokbot/recipe.d.ts.map +0 -1
- package/dist/internal/convert-grokbot/recipe.js +0 -94
- package/dist/internal/convert-grokbot/routine.d.ts +0 -51
- package/dist/internal/convert-grokbot/routine.d.ts.map +0 -1
- package/dist/internal/convert-grokbot/routine.js +0 -128
- package/dist/internal/convert-grokbot/slack.d.ts +0 -28
- package/dist/internal/convert-grokbot/slack.d.ts.map +0 -1
- package/dist/internal/convert-grokbot/slack.js +0 -50
- package/dist/internal/factory-resource-channel.d.ts.map +0 -1
- package/dist/internal/legacy-command-guard.d.ts +0 -24
- package/dist/internal/legacy-command-guard.d.ts.map +0 -1
- package/dist/internal/legacy-command-guard.js +0 -47
- package/dist/internal/runtime-dispatch-runner.d.ts +0 -25
- package/dist/internal/runtime-dispatch-runner.d.ts.map +0 -1
- package/dist/internal/runtime-dispatch-runner.js +0 -35
- package/dist/internal/testing/factory-resource-fixtures.d.ts +0 -64
- package/dist/internal/testing/factory-resource-fixtures.d.ts.map +0 -1
- package/dist/internal/testing/factory-resource-fixtures.js +0 -55
- package/dist/playground/assets/cursor-icons-16-DfKNljMZ.woff2 +0 -0
- package/dist/playground/assets/index-B3_YohwW.js +0 -62
- package/dist/playground/assets/index-Cn3-adsJ.css +0 -1
- package/docs/guides/export-grokbot.md +0 -244
- package/docs/guides/grokbot-agents.md +0 -140
- package/docs/templates/grokbot-agents.md +0 -60
- package/schemas/grokbot-answers.schema.json +0 -354
- package/templates/grokbot-agents/README.md +0 -27
- package/templates/grokbot-agents/bot/agent.ts +0 -6
- package/templates/grokbot-agents/bot/extensions/grokbot.ts +0 -5
- package/templates/grokbot-agents/bot/instructions.md +0 -7
- package/templates/grokbot-agents/evals/evals.config.ts +0 -5
- package/templates/grokbot-agents/evals/grokbot-agents.eval.ts +0 -18
- package/templates/grokbot-agents/init.json +0 -18
- package/templates/grokbot-agents/package.json +0 -17
- package/templates/grokbot-agents/tsconfig.json +0 -12
- /package/dist/docs/assets/{evals.md.CHR34K1Y.lean.js → evals.md.DiljU__Z.lean.js} +0 -0
- /package/dist/docs/assets/{guides_bitbucket.md.CKUayYtD.lean.js → guides_bitbucket.md.DkjkBRU8.lean.js} +0 -0
- /package/dist/docs/assets/{guides_gitlab.md.CtNI4fSH.lean.js → guides_gitlab.md.DCE0p7_w.lean.js} +0 -0
- /package/dist/docs/assets/{guides_pagerduty.md.BHXMcMtx.lean.js → guides_pagerduty.md.mnKXe9U0.lean.js} +0 -0
- /package/dist/docs/assets/{hillclimbing.md.Dxvd-0gT.lean.js → hillclimbing.md.By61f3uq.lean.js} +0 -0
- /package/dist/docs/assets/{reference_artifacts.md.DLV9MZES.lean.js → reference_artifacts.md.C-hKR2hp.lean.js} +0 -0
- /package/dist/docs/assets/{reference_connections.md.BJE2Zllp.lean.js → reference_connections.md.BoAotr7_.lean.js} +0 -0
- /package/dist/docs/assets/{reference_hooks.md.CROr0QgC.lean.js → reference_hooks.md.B-bwJuiG.lean.js} +0 -0
- /package/dist/docs/assets/{reference_http-api.md.Dji-DD_Z.lean.js → reference_http-api.md._RWELr3d.lean.js} +0 -0
- /package/dist/docs/assets/{reference_instructions.md.BYMVxAkw.lean.js → reference_instructions.md.yL2hXLnl.lean.js} +0 -0
- /package/dist/docs/assets/{reference_memory.md.BwyJXYZe.lean.js → reference_memory.md.Dd7cyV9V.lean.js} +0 -0
- /package/dist/docs/assets/{reference_playground.md.q4MI-0td.lean.js → reference_playground.md.CQiJk9CM.lean.js} +0 -0
- /package/dist/docs/assets/{reference_project-layout.md.mFcS8yDD.lean.js → reference_project-layout.md.BamcPDUn.lean.js} +0 -0
- /package/dist/docs/assets/{reference_prompt.md.DqPh71XN.lean.js → reference_prompt.md.BMjm1Jp3.lean.js} +0 -0
- /package/dist/docs/assets/{reference_schedules.md.BqWnJES4.lean.js → reference_schedules.md.RC47aFm4.lean.js} +0 -0
- /package/dist/docs/assets/{reference_sessions.md.Bi6lHttM.lean.js → reference_sessions.md.C7KFhWXV.lean.js} +0 -0
- /package/dist/docs/assets/{reference_subagents.md.ChNGh6HK.lean.js → reference_subagents.md.CAhvW4yS.lean.js} +0 -0
- /package/dist/docs/assets/{templates_agentic-owners.md.CTEnR0jp.lean.js → templates_agentic-owners.md.Dh2nDSqg.lean.js} +0 -0
- /package/dist/docs/assets/{templates_security-reviewer.md.Gh6EF9Us.lean.js → templates_security-reviewer.md.DnwXdnB5.lean.js} +0 -0
- /package/dist/docs/assets/{templates_triage.md.CNN6b0JZ.lean.js → templates_triage.md.BYWMloV4.lean.js} +0 -0
- /package/dist/docs/assets/{troubleshooting.md.DFnoTDlQ.lean.js → troubleshooting.md.CGOdNVAL.lean.js} +0 -0
package/dist/docs/llms.txt
CHANGED
|
@@ -1,25 +1,24 @@
|
|
|
1
|
-
#
|
|
1
|
+
# Agent SDK documentation
|
|
2
2
|
|
|
3
3
|
> Build and serve bots and agents from versioned Markdown and TypeScript.
|
|
4
4
|
|
|
5
5
|
## Overview
|
|
6
6
|
|
|
7
|
-
- [
|
|
7
|
+
- [Agent SDK](/docs/index.md): Build, test, and deploy bots and agents as code with the Agent SDK.
|
|
8
8
|
|
|
9
9
|
## Getting started
|
|
10
10
|
|
|
11
|
-
- [Build with a coding agent](/docs/building-with-agents.md): Delegate
|
|
12
|
-
- [Changelog](/docs/changelog.md): Changes for each release of @
|
|
13
|
-
- [Deployment](/docs/deployment.md): Deploy
|
|
11
|
+
- [Build with a coding agent](/docs/building-with-agents.md): Delegate Agent SDK creation, capability work, verification, and measured improvement to a coding agent.
|
|
12
|
+
- [Changelog](/docs/changelog.md): Changes for each release of @grok/agent-sdk
|
|
13
|
+
- [Deployment](/docs/deployment.md): Deploy an Agent SDK project from Git with Cursor-managed hosting, or run one secure process on your own infrastructure.
|
|
14
14
|
- [Evals](/docs/evals.md): Protect agent decisions with fixed inputs, trajectory assertions, and regression checks that run locally or in CI.
|
|
15
15
|
- [Hillclimbing](/docs/hillclimbing.md): Improve one agent behavior at a time by measuring fixed inputs, changing one lever, and locking each win with an eval.
|
|
16
|
-
- [Build a PR reviewer](/docs/quickstart.md): Create
|
|
16
|
+
- [Build a PR reviewer](/docs/quickstart.md): Create an Agent SDK bot or agent that reviews pull requests by complexity, approves safe changes, and handles GitHub webhook events.
|
|
17
17
|
- [Fix common agent problems](/docs/troubleshooting.md): Match the symptom to one corrective action, then inspect the session trace when the first fix is not enough.
|
|
18
18
|
|
|
19
19
|
## Templates
|
|
20
20
|
|
|
21
21
|
- [Review pull requests with owners policies](/docs/templates/agentic-owners.md): Scaffold the agent, commit .agentic-owners policies, and let it risk-tier PRs, request the owners, and approve what the policy allows.
|
|
22
|
-
- [Consult named Grok Bot agents](/docs/templates/grokbot-agents.md): Scaffold an agent that delegates a focused question to an allowed Grok Bot agent and carries the reply back.
|
|
23
22
|
- [Review pull requests for exploitable bugs](/docs/templates/security-reviewer.md): Scaffold the agent, pick repos, replay a PR, and deploy.
|
|
24
23
|
- [Review pull requests for structural code quality](/docs/templates/thermo-quality-review.md): Scaffold the agent, deploy it, and open a PR.
|
|
25
24
|
- [Review pull requests for bugs and breakage](/docs/templates/thermo-review.md): Scaffold the agent, deploy it, and open a PR.
|
|
@@ -27,19 +26,17 @@
|
|
|
27
26
|
|
|
28
27
|
## Guides
|
|
29
28
|
|
|
30
|
-
- [Peer agents](/docs/guides/agent-to-agent.md): Let one
|
|
29
|
+
- [Peer agents](/docs/guides/agent-to-agent.md): Let one Agent SDK agent consult an independent specialist, continue its session, or call its deterministic tools.
|
|
31
30
|
- [Bitbucket](/docs/guides/bitbucket.md): Review pull requests, answer comments, and triage pushes on Bitbucket Cloud or Data Center.
|
|
32
|
-
- [Cursor cloud agents](/docs/guides/cloud-agents.md): Let
|
|
33
|
-
- [Convert a Cursor Automation](/docs/guides/convert-automation.md): Turn a dashboard Automation into
|
|
34
|
-
- [Export a Grok Bot](/docs/guides/export-grokbot.md): Turn a Grok Bot recipe into a BDK project, preview what maps, and finish secrets and connector sign-ins.
|
|
31
|
+
- [Cursor cloud agents](/docs/guides/cloud-agents.md): Let an Agent SDK agent hand coding work to Cursor cloud agents and steer them: mount the extension and pick the repositories it may touch.
|
|
32
|
+
- [Convert a Cursor Automation](/docs/guides/convert-automation.md): Turn a dashboard Automation into an Agent SDK project, then reconnect its actions and triggers.
|
|
35
33
|
- [GitHub](/docs/guides/github.md): Let your agent read pull requests and CI, then write back reviews, comments, and checks.
|
|
36
34
|
- [GitLab](/docs/guides/gitlab.md): Review merge requests, answer notes, and triage failed pipelines on GitLab.com or self-managed GitLab.
|
|
37
|
-
- [Cursor Grok Bot agents](/docs/guides/grokbot-agents.md): Mount an extension that lets your agent consult named Grok Bot agents, wait for long replies, and interrupt work.
|
|
38
35
|
- [Hooks](/docs/guides/hooks.md): Observe session events for metrics, alerts, and other side effects without changing the turn.
|
|
39
36
|
- [Self-improvement](/docs/guides/improve.md): Let an agent propose a change to its own source through a branch and pull request, with review and deployment kept separate.
|
|
40
37
|
- [Jev](/docs/guides/jev.md): Use typed Jev decisions to filter findings, route pull requests, and gate review actions.
|
|
41
38
|
- [Host MCP OAuth](/docs/guides/mcp-oauth.md): Authorize a private MCP server locally, constrain its tools, and choose where its credentials live.
|
|
42
|
-
- [Migrate an early-alpha project](/docs/guides/migrate.md): Move a hosted
|
|
39
|
+
- [Migrate an early-alpha project](/docs/guides/migrate.md): Move a hosted Agent SDK architecture v1 project to v2 through a reviewed pull request.
|
|
43
40
|
- [OpenTelemetry](/docs/guides/opentelemetry.md)
|
|
44
41
|
- [PagerDuty](/docs/guides/pagerduty.md): Respond to PagerDuty incidents: investigate a page, follow it through acknowledgement and resolution, and ignore your own actions.
|
|
45
42
|
- [Slack](/docs/guides/slack.md): Wake your agent from mentions, DMs, and watched posts, then reply in the thread.
|
|
@@ -47,16 +44,18 @@
|
|
|
47
44
|
|
|
48
45
|
## Reference
|
|
49
46
|
|
|
47
|
+
- [Access](/docs/reference/access.md): Who can view, deploy, and manage a deployed bot.
|
|
50
48
|
- [Agent config](/docs/reference/agent-config.md): defineAgent at bot/agent.ts: the model, local workspace, and programmatic serving.
|
|
51
49
|
- [Artifacts](/docs/reference/artifacts.md): Declare, tag, list, stream, and download durable agent outputs.
|
|
52
50
|
- [Channels](/docs/reference/channels.md): Define custom channel routes, schemas, state, events, and authentication.
|
|
53
|
-
- [CLI](/docs/reference/cli.md): Look up
|
|
51
|
+
- [CLI](/docs/reference/cli.md): Look up Agent SDK commands, targets, flags, outputs, and exit status.
|
|
54
52
|
- [MCP connections](/docs/reference/connections.md): Pull in tools from MCP servers: remote, stdio, the signed-in Cursor account's connectors, and peer agents.
|
|
55
53
|
- [Evals](/docs/reference/evals.md): Define eval cases, drive turns, assert trajectories, and interpret results.
|
|
56
54
|
- [Extensions](/docs/reference/extensions.md): Mount a namespaced package of tools, skills, connections, and other agent capabilities, then inspect or override what it adds.
|
|
57
55
|
- [Hooks](/docs/reference/hooks.md): Observe-only subscribers to the session event stream: audit logs, metrics, transcript mirrors, derived state.
|
|
58
56
|
- [HTTP API](/docs/reference/http-api.md): Public session, discovery, and channel routes callers use.
|
|
59
57
|
- [Instructions](/docs/reference/instructions.md): The always-on system prompt: authoring forms, how it reaches the local harness, and what makes instructions hold up.
|
|
58
|
+
- [Limits](/docs/reference/limits.md): Deploy limits for Agent SDK projects on Cursor-managed hosting, and the error a deploy returns when Cursor has turned those limits on.
|
|
60
59
|
- [Memory](/docs/reference/memory.md): Journal every turn so later sessions can read what earlier ones did.
|
|
61
60
|
- [Playground](/docs/reference/playground.md): The built-in web UI: chat with streaming, Try buttons and slash commands, session replay, and dev-mode dispatch.
|
|
62
61
|
- [Project layout](/docs/reference/project-layout.md): The canonical bot/ folder layout and its path-derived naming rules.
|
|
@@ -0,0 +1,178 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: bdk-create-agent
|
|
3
|
+
description: >-
|
|
4
|
+
Scaffold a new Agent SDK agent: short AskQuestion interview, then
|
|
5
|
+
verify a turn and hand off to hillclimb. Use when creating a new
|
|
6
|
+
agent. Ask only what the invoking message left open.
|
|
7
|
+
---
|
|
8
|
+
|
|
9
|
+
# Create an Agent SDK agent
|
|
10
|
+
|
|
11
|
+
1. **Interview.** Two `AskQuestion` rounds, then a plan gate.
|
|
12
|
+
2. **Scaffold.** `agent-sdk init`, then shape the files.
|
|
13
|
+
3. **Verify.** `validate` / `info` / `tool call`, then a model turn.
|
|
14
|
+
4. **Channels.** Slack, GitHub, webhook, or schedule as chosen.
|
|
15
|
+
5. **Hillclimb.** `skills/hillclimb/SKILL.md`.
|
|
16
|
+
|
|
17
|
+
Read `skills/framework-map/SKILL.md` if you have not. CLI is
|
|
18
|
+
`agent-sdk`. Public docs:
|
|
19
|
+
`node_modules/@grok/agent-sdk/dist/docs/llms.txt` or `/docs/llms.txt`
|
|
20
|
+
on a running host.
|
|
21
|
+
|
|
22
|
+
## Interview
|
|
23
|
+
|
|
24
|
+
`AskQuestion`: batched, recommended option first and labeled
|
|
25
|
+
`(recommended)`.
|
|
26
|
+
|
|
27
|
+
- Mine the invoking message. Target: two rounds, then files.
|
|
28
|
+
- Round 1 is identity. Round 2 is the surface, tailored by round 1.
|
|
29
|
+
- Multi-select for channels, MCP, capabilities. Other where a
|
|
30
|
+
custom answer is plausible.
|
|
31
|
+
- Ask decisions, not how to build it. File layout, tool names,
|
|
32
|
+
env prefix, and eval shape are yours.
|
|
33
|
+
- If `AskQuestion` is missing or the user skips, state defaults
|
|
34
|
+
in one list and proceed.
|
|
35
|
+
|
|
36
|
+
<!-- interview:start (generated from the agent-sdk init questions; do not edit by hand) -->
|
|
37
|
+
### Round 1: identity
|
|
38
|
+
|
|
39
|
+
| Question | Options | Guidance |
|
|
40
|
+
| --- | --- | --- |
|
|
41
|
+
| **Purpose** | chat assistant · PR / repo automation · domain assistant over APIs/tools · scheduled reporter · Other | |
|
|
42
|
+
| **Name** | 2–3 slugs from the purpose + Other | Directory: `[A-Za-z0-9][A-Za-z0-9_-]*`, not `v1`/`playground`/`docs` |
|
|
43
|
+
| **Location** | `./<slug>` (default) · another directory | |
|
|
44
|
+
|
|
45
|
+
### Round 2: surface
|
|
46
|
+
|
|
47
|
+
| Question | Options | Guidance |
|
|
48
|
+
| --- | --- | --- |
|
|
49
|
+
| **Model** | `grok-4.5` + `effort=high`, `fast=true` · Other id | Params, not id suffixes: `{ id: "grok-4.5", params: [{ id: "effort", value: "high" }, { id: "fast", value: "true" }] }` |
|
|
50
|
+
| **Channels** (multi) | playground + HTTP (always on) · Slack · GitHub · custom webhook · schedule | Slack: `skills/setup-slack/SKILL.md`. GitHub: `skills/github/SKILL.md`. No Discord/Teams pack; offer custom webhook. |
|
|
51
|
+
| **MCP** (multi) | none · remote URL · local stdio · Cursor account connectors · Other | One file under `bot/mcp-connections/`. Account file is `account.ts`, never `cursor.ts`. Named local tools need `advertiseTools: true`. Privileged servers go in `bot/host-connections/`. |
|
|
52
|
+
| **Capabilities** (multi) | server tools · agent tools · skills · subagents · hooks · sandbox seeds · evals (recommend) | Always recommend one smoke eval. |
|
|
53
|
+
<!-- interview:end -->
|
|
54
|
+
|
|
55
|
+
Close with the plan and file tree, then "Scaffold it" / "Adjust
|
|
56
|
+
something". Write files only after approval.
|
|
57
|
+
|
|
58
|
+
## Fill the blanks
|
|
59
|
+
|
|
60
|
+
| Purpose | Shape |
|
|
61
|
+
| --- | --- |
|
|
62
|
+
| Slack chat | `slackChannel({ envPrefix })` + suggested prompts. `agent-sdk slack create` mints the bot. Prefix: `skills/setup-slack/SKILL.md` |
|
|
63
|
+
| PR review with host prep | Channel `callTool` into a trimmed workspace `pr/` tree |
|
|
64
|
+
| GitHub automation | `githubChannel()` hooks, replay fixtures |
|
|
65
|
+
| Domain assistant | Server tools + one MCP connection + a skill |
|
|
66
|
+
| Wrap an existing pipeline | GitHub `{ task }` over a thin `bot/lib/` loop |
|
|
67
|
+
|
|
68
|
+
Defaults:
|
|
69
|
+
|
|
70
|
+
- Instructions + 1–2 tools + chosen channels + one smoke eval.
|
|
71
|
+
- `local.cwd` stays outside a monorepo checkout (default: a cache
|
|
72
|
+
directory under `~/.cache`) unless the agent must inherit that
|
|
73
|
+
tree.
|
|
74
|
+
- `bot/instructions.md`: identity, when to use which tool,
|
|
75
|
+
output shape.
|
|
76
|
+
- One tool per file. Prefer `execution: "server"` + zod
|
|
77
|
+
`inputSchema`. Declare `effect: "read"`, `"write"`, or `"idempotent"`
|
|
78
|
+
on each tool. `"idempotent"` may mutate, and the same arguments have
|
|
79
|
+
no additional effect. It is not a read and it is not non-destructive.
|
|
80
|
+
- Long prompts: `prompt\`…\`` / `prompt.lines\`…\`` from
|
|
81
|
+
`@grok/agent-sdk`.
|
|
82
|
+
- Host prep is for evidence (`callTool`, `workspaceFiles`), not
|
|
83
|
+
judgment, formatting, or replies.
|
|
84
|
+
- Remembered state is `ctx.host.kv`. On Cursor hosting, a later
|
|
85
|
+
event can run in a new process, where a module `Map` starts empty.
|
|
86
|
+
File bytes that must outlive the process go in `ctx.host.files`.
|
|
87
|
+
See `skills/framework-map/SKILL.md`.
|
|
88
|
+
|
|
89
|
+
### Deterministic-path budget
|
|
90
|
+
|
|
91
|
+
Default to instructions and skills. Promote to TypeScript only
|
|
92
|
+
when it earns the left column:
|
|
93
|
+
|
|
94
|
+
| Code owns | Model owns |
|
|
95
|
+
| --- | --- |
|
|
96
|
+
| Side-effect gates (approve, deploy, post) | Human-facing output to a stated shape |
|
|
97
|
+
| Dedupe of external writes (`ctx.host.kv`) | Summarizing, classifying, wording |
|
|
98
|
+
| Auth and signature checks | What to do next from ground truth |
|
|
99
|
+
| Evidence seeding | Soft-failure retries |
|
|
100
|
+
| Hard API caps | Formatting under those caps |
|
|
101
|
+
|
|
102
|
+
Smells: prose builders in `.ts` (write `.md`); `bot/lib/` +
|
|
103
|
+
`tools/` dwarfing instructions + skills on a first cut.
|
|
104
|
+
|
|
105
|
+
## Scaffold
|
|
106
|
+
|
|
107
|
+
```bash
|
|
108
|
+
agent-sdk init ./<slug>
|
|
109
|
+
```
|
|
110
|
+
|
|
111
|
+
`init` writes the project, runs `npm install`, and may wait on
|
|
112
|
+
`login`. Then shape it:
|
|
113
|
+
|
|
114
|
+
1. `defineAgent` with the chosen model.
|
|
115
|
+
2. Real `instructions.md`. Replace `echo.ts`.
|
|
116
|
+
3. Chosen `channels/`, `mcp-connections/`, `skills/`,
|
|
117
|
+
`subagents/<id>/` (needs `description`), `schedules/`, `hooks/`.
|
|
118
|
+
Slack: `agent-sdk slack create --dir ./<slug> --name "<Name>"`,
|
|
119
|
+
not a hand-written channel. Manual Slack app:
|
|
120
|
+
`agent-sdk slack init --manual` (Slack CLI, or paste at
|
|
121
|
+
api.slack.com).
|
|
122
|
+
4. Blank init writes `evals/evals.config.ts` (`maxConcurrency: 20`,
|
|
123
|
+
cap 200) and `evals/smoke.eval.ts`. The smoke case uses `echo`
|
|
124
|
+
and asserts `t.succeeded()` and `t.calledTool("echo")`. Replace
|
|
125
|
+
that case when you replace the tool. API: `skills/evals/SKILL.md`.
|
|
126
|
+
|
|
127
|
+
Stay on deps the Agent SDK already ships (`zod`,
|
|
128
|
+
`@modelcontextprotocol/sdk`, `tsx`).
|
|
129
|
+
|
|
130
|
+
## Verify
|
|
131
|
+
|
|
132
|
+
```bash
|
|
133
|
+
agent-sdk validate --dir ./<slug>
|
|
134
|
+
agent-sdk info --dir ./<slug> --json
|
|
135
|
+
agent-sdk tool call <tool> --dir ./<slug> --input '{…}'
|
|
136
|
+
agent-sdk eval --dir ./<slug> --list
|
|
137
|
+
npx tsc --noEmit -p ./<slug>
|
|
138
|
+
```
|
|
139
|
+
|
|
140
|
+
tsx does not typecheck. Tool `execute` must return JSON-shaped
|
|
141
|
+
values: object literals or `type` aliases, not `interface` types.
|
|
142
|
+
|
|
143
|
+
Model turns need a Cursor credential (`CURSOR_API_KEY`, then `CURSOR_API_KEY_FILE`, then `CURSOR_SERVICE_ACCOUNT_KEY`, then `agent-sdk login`). Without one, finish the
|
|
144
|
+
key-free checks, confirm `run` fails with only the API-key error,
|
|
145
|
+
and hand these over:
|
|
146
|
+
|
|
147
|
+
```bash
|
|
148
|
+
agent-sdk run --dir ./<slug> --message "<fixture prompt>"
|
|
149
|
+
agent-sdk serve --dir ./<slug> --mode single --dev
|
|
150
|
+
# http://127.0.0.1:3000/playground
|
|
151
|
+
agent-sdk eval --dir ./<slug>
|
|
152
|
+
```
|
|
153
|
+
|
|
154
|
+
Serve only this agent's directory. Session files land in the
|
|
155
|
+
project state directory (`--state-root`). That is not harness cwd.
|
|
156
|
+
|
|
157
|
+
## Channel setup
|
|
158
|
+
|
|
159
|
+
- **Slack.** `skills/setup-slack/SKILL.md`
|
|
160
|
+
- **GitHub.** `skills/github/SKILL.md`
|
|
161
|
+
- **Custom webhook.** `POST /v1/channels/<id>/<route>`.
|
|
162
|
+
Loopback-only until you add `bearerAuth(...)`. Hosted callers
|
|
163
|
+
get an empty `202` before the handler runs, so return
|
|
164
|
+
`new Response(null, { status: 202 })` and deliver results from
|
|
165
|
+
the channel's `events`.
|
|
166
|
+
- **Schedules.** Never auto-fire under `--dev`.
|
|
167
|
+
`POST /v1/dev/schedules/<id>`.
|
|
168
|
+
|
|
169
|
+
## Hillclimb handoff
|
|
170
|
+
|
|
171
|
+
Once a smoke turn passes, agree fixtures, success criteria, and a
|
|
172
|
+
freeze line, then follow `skills/hillclimb/SKILL.md`. Seed from
|
|
173
|
+
the smoke session under the project state directory. GitHub:
|
|
174
|
+
snapshot `agent-sdk github replay ... --dry-run --fixtures-dir fixtures/github`.
|
|
175
|
+
|
|
176
|
+
Do not deploy or post to real Slack/GitHub beyond the smoke the
|
|
177
|
+
user asked for. If the plan grows past ~10 files, cut scope.
|
|
178
|
+
Re-check the budget at hand-off.
|
|
@@ -0,0 +1,145 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: bdk-evals
|
|
3
|
+
description: >-
|
|
4
|
+
Author and run defineEval cases. Use when writing, fixing, seeding,
|
|
5
|
+
or hillclimbing evals. Ask whether to generate samples or take
|
|
6
|
+
uploaded data. Materialize API-backed fixtures first.
|
|
7
|
+
---
|
|
8
|
+
|
|
9
|
+
# Agent SDK evals
|
|
10
|
+
|
|
11
|
+
Fixed input, model turn, gates on the trajectory. Files live at
|
|
12
|
+
project-root `evals/**/*.eval.ts`. `bot/evals/` is ignored.
|
|
13
|
+
Guide: `docs/evals.md`.
|
|
14
|
+
|
|
15
|
+
Observing production: hooks. Tool logic without a model:
|
|
16
|
+
`agent-sdk tool call <tool> --input '{...}'`.
|
|
17
|
+
|
|
18
|
+
```bash
|
|
19
|
+
agent-sdk eval --dir . --list
|
|
20
|
+
agent-sdk eval --dir . --json
|
|
21
|
+
agent-sdk eval --dir . weather/nyc
|
|
22
|
+
agent-sdk eval --dir . --tag smoke
|
|
23
|
+
```
|
|
24
|
+
|
|
25
|
+
| Form | Case id |
|
|
26
|
+
| --- | --- |
|
|
27
|
+
| `evals/weather.eval.ts` + `test` | `weather` |
|
|
28
|
+
| `evals/weather/nyc.eval.ts` + `test` | `weather/nyc` |
|
|
29
|
+
| `evals/weather.eval.ts` + `{ id: "nyc" }` | `weather/nyc` |
|
|
30
|
+
| `evals/sql.eval.ts` exporting an array of `defineEval` calls | `sql/0000`, `sql/0001`, ... |
|
|
31
|
+
|
|
32
|
+
`eval` boots an ephemeral server and a temp state root. `--url`
|
|
33
|
+
points at a running agent. Model turns need a Cursor credential
|
|
34
|
+
(`CURSOR_API_KEY`, then `CURSOR_API_KEY_FILE`, then
|
|
35
|
+
`CURSOR_SERVICE_ACCOUNT_KEY`, then `agent-sdk login`); `--list` does
|
|
36
|
+
not. Node 22.13+, never Bun.
|
|
37
|
+
|
|
38
|
+
## Seeding
|
|
39
|
+
|
|
40
|
+
Creating or expanding cases: `AskQuestion` first.
|
|
41
|
+
|
|
42
|
+
| Question | Options |
|
|
43
|
+
| --- | --- |
|
|
44
|
+
| **How should we get eval samples?** | Generate test eval samples for me `(recommended)` · I will add / upload the data manually |
|
|
45
|
+
|
|
46
|
+
1. **Manual.** They provide files or paste. Show the shape below.
|
|
47
|
+
Do not invent cases. Then `eval --list` and wire gates.
|
|
48
|
+
API-backed pointers (PR URLs, SHAs, gold labels): materialize
|
|
49
|
+
under `fixtures/` first.
|
|
50
|
+
2. **Generated.** Ask count (`3` recommended). Append to an
|
|
51
|
+
existing `cases` array when it fits. Never overwrite or weaken
|
|
52
|
+
a datapoint. Create `evals/evals.config.ts` if missing
|
|
53
|
+
(`maxConcurrency: 20`; cap 200).
|
|
54
|
+
|
|
55
|
+
## API
|
|
56
|
+
|
|
57
|
+
```ts
|
|
58
|
+
import { defineEval, includes, satisfies } from "@grok/agent-sdk/evals";
|
|
59
|
+
|
|
60
|
+
export default defineEval({
|
|
61
|
+
tags: ["smoke", "weather"],
|
|
62
|
+
cases: [
|
|
63
|
+
{
|
|
64
|
+
id: "nyc",
|
|
65
|
+
description: "NYC temperature.",
|
|
66
|
+
async test(t) {
|
|
67
|
+
await t.send("What's the temperature in NYC?");
|
|
68
|
+
t.succeeded();
|
|
69
|
+
t.calledTool("get_weather");
|
|
70
|
+
t.notCalledTool("save_weather_note");
|
|
71
|
+
t.check(t.reply, includes(/°|[FC]/));
|
|
72
|
+
},
|
|
73
|
+
},
|
|
74
|
+
],
|
|
75
|
+
});
|
|
76
|
+
```
|
|
77
|
+
|
|
78
|
+
```ts
|
|
79
|
+
import { defineEvalConfig } from "@grok/agent-sdk/evals";
|
|
80
|
+
|
|
81
|
+
export default defineEvalConfig({
|
|
82
|
+
maxConcurrency: 20,
|
|
83
|
+
});
|
|
84
|
+
```
|
|
85
|
+
|
|
86
|
+
Either `test(t)` or `cases`, not both. `t.send` waits for the turn to
|
|
87
|
+
settle (complete or fail) and returns it; `turn.calledTool(...)`
|
|
88
|
+
reads only that turn, `t.*` reads the whole run. First-send options:
|
|
89
|
+
`workspaceFiles`, `workspaceDir`.
|
|
90
|
+
|
|
91
|
+
Gates: `t.succeeded()`,
|
|
92
|
+
`calledTool(name, { input, output, status, count })` / `notCalledTool`,
|
|
93
|
+
`toolOrder`, `maxToolCalls`, `taggedArtifact`, `event` / `notEvent`,
|
|
94
|
+
`t.check(value, includes | equals | matches | similarity | satisfies)`.
|
|
95
|
+
Records: `t.metric`, `t.log`, `t.score` (soft 0-1).
|
|
96
|
+
|
|
97
|
+
Severity is on the handle: default gate; `.soft()` tracked;
|
|
98
|
+
`.atLeast(0.8)` soft with a bar (verdict `scored`, exit 1 only under
|
|
99
|
+
`--strict`); `.gate(0.8)` hard. `t.judge.factuality`, `summarizes`,
|
|
100
|
+
`closedQA`, and `sql` are soft by default and need a judge model
|
|
101
|
+
(`judge` in `evals.config.ts`, on the eval or case, or per-call
|
|
102
|
+
`{ model }`).
|
|
103
|
+
|
|
104
|
+
## Side effects
|
|
105
|
+
|
|
106
|
+
Eval sessions run real tools. Guard actuation with
|
|
107
|
+
`ctx.session.purpose === "eval"` in the tool or hook
|
|
108
|
+
and return a shaped result so `calledTool` can still assert the
|
|
109
|
+
decision.
|
|
110
|
+
|
|
111
|
+
## What to gate
|
|
112
|
+
|
|
113
|
+
Decisions and shape, not prose.
|
|
114
|
+
|
|
115
|
+
1. `t.succeeded()` first
|
|
116
|
+
2. Intended tool + the tempting wrong one
|
|
117
|
+
3. A shape regex or `satisfies` on parsed fields
|
|
118
|
+
4. If formatting keeps failing, tighten instructions. Do not move
|
|
119
|
+
rendering into a host tool.
|
|
120
|
+
|
|
121
|
+
Anti-patterns: exact phrasing; more than ~5 gates (split); live
|
|
122
|
+
drifting inputs (pin them).
|
|
123
|
+
|
|
124
|
+
| Surface | Fixture |
|
|
125
|
+
| --- | --- |
|
|
126
|
+
| Chat | One frozen prompt |
|
|
127
|
+
| Tool-heavy | `agent-sdk tool call` first, then the prompt |
|
|
128
|
+
| GitHub | `github replay … --dry-run --fixtures-dir fixtures/github` |
|
|
129
|
+
| Host-prep PR review | A team-owned PR; gate findings shape, not counts |
|
|
130
|
+
| Workspace | `workspaceFiles` in `t.send` |
|
|
131
|
+
| Dataset | `loadJson` / `loadJsonl` / `loadYaml` from `@grok/agent-sdk/evals/loaders`, paths from the project root |
|
|
132
|
+
|
|
133
|
+
## Debug and CI
|
|
134
|
+
|
|
135
|
+
A failed local run leaves `evals/<case-id>.json` (assertions, inputs,
|
|
136
|
+
tool I/O, final text, logs) under `evals/<stamp>/` in the project state
|
|
137
|
+
directory (the CLI prints the path); read it before editing the eval.
|
|
138
|
+
`--state-root <path>` keeps the raw session events too.
|
|
139
|
+
|
|
140
|
+
CI: `agent-sdk eval --dir . --json --no-stream --junit reports/evals.xml`.
|
|
141
|
+
Exit `1` on a failed gate, `2` when nothing matched, `--strict` to fail
|
|
142
|
+
on `scored`.
|
|
143
|
+
|
|
144
|
+
Every kept hillclimb change lands an eval that would have failed
|
|
145
|
+
before it. Never weaken a gate to pass a round.
|
|
@@ -0,0 +1,133 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: bdk-github
|
|
3
|
+
description: >-
|
|
4
|
+
Build and test GitHub-driven Agent SDK agents: githubChannel hooks
|
|
5
|
+
(auth turn vs host task), cursorAccount / --cursor-events, and
|
|
6
|
+
local test tiers (fixtures, replay, forward). Use when wiring
|
|
7
|
+
GitHub events or debugging delivery.
|
|
8
|
+
---
|
|
9
|
+
|
|
10
|
+
# GitHub channels in the Agent SDK
|
|
11
|
+
|
|
12
|
+
Author `bot/channels/github.ts`. Production wakes:
|
|
13
|
+
`cursorAccount` + `serve --cursor-events`. No public webhook URL.
|
|
14
|
+
Use the HTTP route for fixtures, replay, and hosts that already
|
|
15
|
+
terminate GitHub webhooks.
|
|
16
|
+
|
|
17
|
+
Guide: `docs/guides/github.md`.
|
|
18
|
+
|
|
19
|
+
```ts
|
|
20
|
+
import { defaultGitHubAuth, githubChannel } from "@grok/agent-sdk/channels/github";
|
|
21
|
+
|
|
22
|
+
export default githubChannel({
|
|
23
|
+
botName: "my-agent",
|
|
24
|
+
cursorAccount: { repos: ["owner/repo"] }, // permissions?: "read" | "pr-write" | "contents-write"
|
|
25
|
+
|
|
26
|
+
onPullRequest: (ctx, pr) => {
|
|
27
|
+
if (pr.action !== "opened") {
|
|
28
|
+
return null;
|
|
29
|
+
}
|
|
30
|
+
return { auth: defaultGitHubAuth(ctx) };
|
|
31
|
+
},
|
|
32
|
+
onCheckSuite: (ctx, suite) => {
|
|
33
|
+
if (suite.conclusion !== "failure") {
|
|
34
|
+
return null;
|
|
35
|
+
}
|
|
36
|
+
return { task: () => triage(ctx) };
|
|
37
|
+
},
|
|
38
|
+
});
|
|
39
|
+
```
|
|
40
|
+
|
|
41
|
+
Hooks: `onPullRequest`, `onComment`, `onIssue`, `onCheckSuite`,
|
|
42
|
+
`onCheckRun`, `onWorkflowRun`, `onStatus`, plus `onEvent` and
|
|
43
|
+
`onStart`/`onStop`.
|
|
44
|
+
|
|
45
|
+
| Return | Meaning |
|
|
46
|
+
| ---------- | -------------------------------------------------------------------------------- |
|
|
47
|
+
| `{ auth }` | Model turn. Session shows in the playground. `workspaceFiles` can be a function. |
|
|
48
|
+
| `{ task }` | Host work. No chat session. Use when the work can outlive a webhook timeout. |
|
|
49
|
+
| `null` | Skip |
|
|
50
|
+
|
|
51
|
+
To keep repo scope in deploy config, use `cursorAccount: true`
|
|
52
|
+
and pass `--repo owner/name` at serve / `--cursor-events-repo`
|
|
53
|
+
at deploy. Repos must share one GitHub owner.
|
|
54
|
+
|
|
55
|
+
## Event sources
|
|
56
|
+
|
|
57
|
+
| Source | When |
|
|
58
|
+
| ------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
|
|
59
|
+
| `cursorAccount` + `serve --cursor-events` | Preferred. Signed-in host (`agent-sdk login`, `CURSOR_API_KEY`, or `CURSOR_SERVICE_ACCOUNT_KEY`). Repos from the channel and from repeatable `--repo owner/name`. Cap 20, one GitHub owner |
|
|
60
|
+
| HTTP `POST /<slug>/v1/channels/github` with a webhook secret | `allowAll()` + `X-Hub-Signature-256` |
|
|
61
|
+
| HTTP, no secret | Loopback only. `serve --dev` also admits unsigned loopback (fixtures / forward) |
|
|
62
|
+
|
|
63
|
+
`permissions`: `"read"` inspect; `"pr-write"` (default) comments /
|
|
64
|
+
PR writes; `"contents-write"` push or merge-box checks.
|
|
65
|
+
`progress.commitStatus` needs check-write; see the GitHub guide.
|
|
66
|
+
Set `checks: true` when channel code posts its own Checks API
|
|
67
|
+
runs through `ctx.github.createCheck`. The flag grants access.
|
|
68
|
+
It does not post a check.
|
|
69
|
+
|
|
70
|
+
Without `cursorAccount`, outbound calls prefer App installation
|
|
71
|
+
tokens (`GITHUB_APP_ID` + `GITHUB_APP_PRIVATE_KEY`). Local tests
|
|
72
|
+
can use `GITHUB_TOKEN` / `gh auth login`.
|
|
73
|
+
|
|
74
|
+
## Credentials
|
|
75
|
+
|
|
76
|
+
Name secrets; never read them. Each `credentials` field
|
|
77
|
+
(`webhookSecret`, `token`, `installationToken`, `appId`,
|
|
78
|
+
`privateKey`) takes `{ secretName: "NAME" }`: the env var locally,
|
|
79
|
+
the deployment secret of that name on Cursor hosting. The platform
|
|
80
|
+
verifies `X-Hub-Signature-256` against the named secret before any
|
|
81
|
+
compute starts and `deploy` warns when a named secret is unset.
|
|
82
|
+
|
|
83
|
+
```ts
|
|
84
|
+
credentials: {
|
|
85
|
+
webhookSecret: { secretName: "GITHUB_WEBHOOK_SECRET" },
|
|
86
|
+
appId: { secretName: "GITHUB_APP_ID" },
|
|
87
|
+
privateKey: { secretName: "GITHUB_APP_PRIVATE_KEY" },
|
|
88
|
+
},
|
|
89
|
+
```
|
|
90
|
+
|
|
91
|
+
A literal or `() => process.env.X` getter fails `agent-sdk validate` on
|
|
92
|
+
architecture v2 (the default) with `requires a named secret`; the
|
|
93
|
+
message quotes the `{ secretName }` to use. Omit a field to keep its
|
|
94
|
+
default name; a numeric `appId` is allowed. Only `architecture: "v1"`
|
|
95
|
+
still accepts getters, and `validate` warns there.
|
|
96
|
+
|
|
97
|
+
The Cursor stream is metadata, not full webhook bodies. Re-read
|
|
98
|
+
the PR from GitHub.
|
|
99
|
+
|
|
100
|
+
## Test locally
|
|
101
|
+
|
|
102
|
+
1. **Fixtures** (offline, `--dev`, no signature):
|
|
103
|
+
|
|
104
|
+
```bash
|
|
105
|
+
curl -s -X POST http://127.0.0.1:3000/<slug>/v1/channels/github \
|
|
106
|
+
-H 'content-type: application/json' \
|
|
107
|
+
-H 'x-github-event: pull_request' \
|
|
108
|
+
-d @fixtures/github/pull_request.synchronize.json
|
|
109
|
+
```
|
|
110
|
+
|
|
111
|
+
2. **Replay** (hillclimb tier; pull access is enough):
|
|
112
|
+
|
|
113
|
+
```bash
|
|
114
|
+
agent-sdk github replay owner/repo#123 --dir <project>
|
|
115
|
+
agent-sdk github replay owner/repo#123 --dir <project> --events '*' --dry-run --fixtures-dir fixtures/github
|
|
116
|
+
```
|
|
117
|
+
|
|
118
|
+
3. **Forward** (live; repo admin). One forwarder per repo. Blank
|
|
119
|
+
`GITHUB_TOKEN`/`GH_TOKEN` or every delivery 401s:
|
|
120
|
+
|
|
121
|
+
```bash
|
|
122
|
+
agent-sdk github doctor --install
|
|
123
|
+
GITHUB_TOKEN= GH_TOKEN= agent-sdk github forward --dir <project>
|
|
124
|
+
```
|
|
125
|
+
|
|
126
|
+
4. **Cursor pull** (same as production):
|
|
127
|
+
|
|
128
|
+
```bash
|
|
129
|
+
agent-sdk serve --dir <project> --cursor-events --repo owner/repo
|
|
130
|
+
```
|
|
131
|
+
|
|
132
|
+
Volume, debounce, and `progress.commitStatus` / `progress.banner`
|
|
133
|
+
live in `docs/guides/github.md`. Do not preinstall them.
|
|
@@ -0,0 +1,63 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: bdk-hillclimb
|
|
3
|
+
description: >-
|
|
4
|
+
Improve one existing Agent SDK agent: pin fixtures, measure, change
|
|
5
|
+
one lever, remeasure, lock the win with an eval. Use when an agent
|
|
6
|
+
already runs and needs better results.
|
|
7
|
+
---
|
|
8
|
+
|
|
9
|
+
# Agent SDK hillclimb
|
|
10
|
+
|
|
11
|
+
Measure → change one lever → remeasure. One failure mode per round.
|
|
12
|
+
|
|
13
|
+
Siblings: `skills/evals/SKILL.md`, `skills/github/SKILL.md`,
|
|
14
|
+
`skills/debug/SKILL.md`.
|
|
15
|
+
|
|
16
|
+
## Preconditions
|
|
17
|
+
|
|
18
|
+
From the user or the invoking message:
|
|
19
|
+
|
|
20
|
+
1. **Target.** Path or slug
|
|
21
|
+
2. **Fixtures.** Fixed inputs
|
|
22
|
+
3. **Success.** What better means this round
|
|
23
|
+
4. **Freeze line.** What must not change
|
|
24
|
+
|
|
25
|
+
Ask before editing if any are missing. A moving fixture is noise.
|
|
26
|
+
|
|
27
|
+
| Surface | Pin it |
|
|
28
|
+
| --- | --- |
|
|
29
|
+
| GitHub | `agent-sdk github replay <pr> --dir <project>` (`--dry-run --out fixtures/github`) |
|
|
30
|
+
| One tool | `agent-sdk tool call <tool> --dir <project> --input '{...}'` |
|
|
31
|
+
| Chat | `agent-sdk run --dir <project> --message "<fixture>"` |
|
|
32
|
+
|
|
33
|
+
## Loop
|
|
34
|
+
|
|
35
|
+
1. **Serve.** `agent-sdk serve --dir <project> --mode single --dev`
|
|
36
|
+
Playground: `http://127.0.0.1:3000/playground`.
|
|
37
|
+
2. **Hit it.** Same path a user would. Record status, wall time,
|
|
38
|
+
`sessionId`, output, and `action.result` counts by `toolName`.
|
|
39
|
+
3. **Name the failure.** Score correctness, efficiency, harness
|
|
40
|
+
fit. One dominant failure this round.
|
|
41
|
+
4. **Change one lever.** Smallest first. Delete the code or prompt
|
|
42
|
+
that caused it. Then instructions / skills, evidence shape,
|
|
43
|
+
host prep (`workspaceFiles`, channel `callTool`) for wandering
|
|
44
|
+
and latency (not formatting or judgment), remove or gate
|
|
45
|
+
wandering tools, framework only if the agent cannot express
|
|
46
|
+
the fix. Hypothesis: *If we X, metric Y should move because Z.*
|
|
47
|
+
5. **Remeasure.** Same fixtures. Keep only if the target metric
|
|
48
|
+
improves and the freeze line holds.
|
|
49
|
+
6. **Lock.** A kept change gets an eval that would have failed
|
|
50
|
+
before it (`skills/evals/SKILL.md`). Never weaken a gate to
|
|
51
|
+
pass a round.
|
|
52
|
+
|
|
53
|
+
```markdown
|
|
54
|
+
### Hillclimb round N. `<slug>`
|
|
55
|
+
- Fixture(s): …
|
|
56
|
+
- Hypothesis: …
|
|
57
|
+
- Change: …
|
|
58
|
+
- Before → after: tools …; wall …; quality …
|
|
59
|
+
- Verdict: keep | revert | narrow
|
|
60
|
+
- Next failure mode:
|
|
61
|
+
```
|
|
62
|
+
|
|
63
|
+
Do not deploy or post real GitHub reviews unless asked.
|
|
@@ -0,0 +1,60 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: bdk-mcp-auth
|
|
3
|
+
description: >-
|
|
4
|
+
Authorize host MCP OAuth for defineConnection({ url, oauth: true }):
|
|
5
|
+
agent-sdk mcp oauth, local tokens, advertiseTools, egress, and the hosted
|
|
6
|
+
cursorAccount path. Use when wiring or debugging MCP auth.
|
|
7
|
+
---
|
|
8
|
+
|
|
9
|
+
# Host MCP OAuth
|
|
10
|
+
|
|
11
|
+
Guide: `docs/guides/mcp-oauth.md`.
|
|
12
|
+
|
|
13
|
+
| Need | Use |
|
|
14
|
+
| --- | --- |
|
|
15
|
+
| Connector already in the Cursor dashboard | `defineConnection({ cursorAccount: true })` or `servers: "*"` / `servers: […]` |
|
|
16
|
+
| Remote URL that speaks OAuth; host holds tokens | `defineConnection({ url, oauth: true })` + this skill |
|
|
17
|
+
| Static bearer / API key | `headers` / env on `{ url }` |
|
|
18
|
+
|
|
19
|
+
`advertiseTools: true` puts named tools on local turns. Host tools
|
|
20
|
+
can still call `ctx.host.mcp`.
|
|
21
|
+
|
|
22
|
+
## Checklist
|
|
23
|
+
|
|
24
|
+
1. **Declare the connection.** `bot/mcp-connections/<name>.ts`
|
|
25
|
+
with `url` + `oauth: true`. Use `bot/host-connections/` when
|
|
26
|
+
the model must not see it.
|
|
27
|
+
2. **Allow egress** on hosted non-bootstrap hosts:
|
|
28
|
+
`hosting.egressDomains`.
|
|
29
|
+
3. **Authorize.** Local: `agent-sdk mcp oauth <name>`, or finish
|
|
30
|
+
Connect in the playground so the current process can retry.
|
|
31
|
+
Tokens stay on this machine. Hosted: use a
|
|
32
|
+
`cursorAccount: true` connection and connect the server from
|
|
33
|
+
**Deployed Agents** in the dashboard; its tokens stay on the
|
|
34
|
+
Cursor backend.
|
|
35
|
+
|
|
36
|
+
```ts
|
|
37
|
+
// bot/mcp-connections/inventory.ts
|
|
38
|
+
export default defineConnection({
|
|
39
|
+
url: "https://mcp.example.com/inventory",
|
|
40
|
+
oauth: true,
|
|
41
|
+
});
|
|
42
|
+
```
|
|
43
|
+
|
|
44
|
+
```bash
|
|
45
|
+
agent-sdk mcp oauth <connection>
|
|
46
|
+
```
|
|
47
|
+
|
|
48
|
+
Browser callback: `http://127.0.0.1:8787/callback`. Tokens live in
|
|
49
|
+
the CLI config directory (`mcp-auth.json` or
|
|
50
|
+
`$AGENT_SERVE_CONFIG_DIR`). URL change drops the old entry; re-run.
|
|
51
|
+
|
|
52
|
+
| Symptom | Fix |
|
|
53
|
+
| --- | --- |
|
|
54
|
+
| `must be defineConnection({ url, oauth: true })` | Wrong name or missing `oauth: true` |
|
|
55
|
+
| `Unknown MCP connection` | Filename must match the CLI arg |
|
|
56
|
+
| Callback hang | Free port 8787; finish the browser flow here |
|
|
57
|
+
| Hosted 401 | Local tokens don't reach the deployment. Switch to `cursorAccount: true`; connect from **Deployed Agents** |
|
|
58
|
+
| Model invents `mcp_auth` / IDE MCP | `advertiseTools: true` on local turns |
|
|
59
|
+
|
|
60
|
+
No raw tokens in git.
|