@grok/agent-sdk 0.2.29 → 0.3.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/channels/slack/cli-project.js +1 -1
- package/dist/docs/404.html +2 -2
- package/dist/docs/assets/{app.DMrZKFjI.js → app.BzTUBOAD.js} +4 -4
- package/dist/docs/assets/building-with-agents.md.BqJ7AAjG.js +6 -0
- package/dist/docs/assets/{building-with-agents.md.Bf1yH2tG.lean.js → building-with-agents.md.BqJ7AAjG.lean.js} +1 -1
- package/dist/docs/assets/changelog.md.BWhC6DET.js +1 -0
- package/dist/docs/assets/changelog.md.BWhC6DET.lean.js +1 -0
- package/dist/docs/assets/chunks/@localSearchIndexroot.CWxwVoCG.js +1 -0
- package/dist/docs/assets/chunks/{VPLocalSearchBox.DQvuw1KA.js → VPLocalSearchBox.DsnRlUT5.js} +1 -1
- package/dist/docs/assets/chunks/{arc.ahOG-Qza.js → arc.DH8GOhiv.js} +1 -1
- package/dist/docs/assets/chunks/{architectureDiagram-Q4EWVU46.BcgfYNO_.js → architectureDiagram-Q4EWVU46.9m9ObyuE.js} +1 -1
- package/dist/docs/assets/chunks/{baseUniq.DeIYZrWh.js → baseUniq.BXHpx1lE.js} +1 -1
- package/dist/docs/assets/chunks/{blockDiagram-DXYQGD6D.HjJ2goMX.js → blockDiagram-DXYQGD6D.xY3EX59q.js} +1 -1
- package/dist/docs/assets/chunks/{c4Diagram-AHTNJAMY.C1QTb9GM.js → c4Diagram-AHTNJAMY.DnqgMVgc.js} +1 -1
- package/dist/docs/assets/chunks/channel.Cctv0f7X.js +1 -0
- package/dist/docs/assets/chunks/{chunk-4BX2VUAB.UuZiDiVp.js → chunk-4BX2VUAB.BjFxK2A3.js} +1 -1
- package/dist/docs/assets/chunks/{chunk-4TB4RGXK.5A3YmkhI.js → chunk-4TB4RGXK.BujS_Spt.js} +1 -1
- package/dist/docs/assets/chunks/{chunk-55IACEB6.B4uf1yYV.js → chunk-55IACEB6.YbTjhdaM.js} +1 -1
- package/dist/docs/assets/chunks/{chunk-EDXVE4YY.CoXBce8t.js → chunk-EDXVE4YY.DnQ8t4GC.js} +1 -1
- package/dist/docs/assets/chunks/{chunk-FMBD7UC4.DnC5NO4e.js → chunk-FMBD7UC4.B67AwAmj.js} +1 -1
- package/dist/docs/assets/chunks/{chunk-OYMX7WX6.CzfHCeIi.js → chunk-OYMX7WX6.DrZIAFOm.js} +1 -1
- package/dist/docs/assets/chunks/{chunk-QZHKN3VN.C6tcwkVd.js → chunk-QZHKN3VN.BLmmydkn.js} +1 -1
- package/dist/docs/assets/chunks/{chunk-YZCP3GAM._oboyZ1A.js → chunk-YZCP3GAM.DaoOfw0O.js} +1 -1
- package/dist/docs/assets/chunks/classDiagram-6PBFFD2Q.DU5sqchW.js +1 -0
- package/dist/docs/assets/chunks/classDiagram-v2-HSJHXN6E.DU5sqchW.js +1 -0
- package/dist/docs/assets/chunks/clone.B9rdNt6j.js +1 -0
- package/dist/docs/assets/chunks/{cose-bilkent-S5V4N54A.BfPVKeId.js → cose-bilkent-S5V4N54A.DMQuNhM5.js} +1 -1
- package/dist/docs/assets/chunks/{dagre-KV5264BT.CLMLc0lD.js → dagre-KV5264BT.CZoGVuUf.js} +1 -1
- package/dist/docs/assets/chunks/{diagram-5BDNPKRD.C7OF7UfH.js → diagram-5BDNPKRD.CLt9uOyL.js} +1 -1
- package/dist/docs/assets/chunks/{diagram-G4DWMVQ6.Dpao0Bl1.js → diagram-G4DWMVQ6.DpczEm1G.js} +1 -1
- package/dist/docs/assets/chunks/{diagram-MMDJMWI5.DLnM9eLp.js → diagram-MMDJMWI5.D4r13DvJ.js} +1 -1
- package/dist/docs/assets/chunks/{diagram-TYMM5635.BcpVgA_M.js → diagram-TYMM5635.CYU9eGFu.js} +1 -1
- package/dist/docs/assets/chunks/{erDiagram-SMLLAGMA.CsL5JuCV.js → erDiagram-SMLLAGMA.QA9naWEw.js} +1 -1
- package/dist/docs/assets/chunks/{flowDiagram-DWJPFMVM.MFihq9AF.js → flowDiagram-DWJPFMVM.BbNoVZYd.js} +1 -1
- package/dist/docs/assets/chunks/{ganttDiagram-T4ZO3ILL.CJeLodyG.js → ganttDiagram-T4ZO3ILL.IHjDoG7r.js} +1 -1
- package/dist/docs/assets/chunks/{gitGraphDiagram-UUTBAWPF.1HhlE45Z.js → gitGraphDiagram-UUTBAWPF.B21VMdf5.js} +1 -1
- package/dist/docs/assets/chunks/{graph.BS02KkWA.js → graph.DgJ4L-8V.js} +1 -1
- package/dist/docs/assets/chunks/{infoDiagram-42DDH7IO.fp5gvytQ.js → infoDiagram-42DDH7IO.CQjrcthc.js} +1 -1
- package/dist/docs/assets/chunks/{ishikawaDiagram-UXIWVN3A.C6Wk1V4I.js → ishikawaDiagram-UXIWVN3A.D4tPGtVo.js} +1 -1
- package/dist/docs/assets/chunks/{journeyDiagram-VCZTEJTY.qJt4uJ_H.js → journeyDiagram-VCZTEJTY.BD3WaNbQ.js} +1 -1
- package/dist/docs/assets/chunks/{kanban-definition-6JOO6SKY.z2tG9kly.js → kanban-definition-6JOO6SKY.Ca0o4Tqz.js} +1 -1
- package/dist/docs/assets/chunks/{layout.BPCkdejr.js → layout.DXXqX4MQ.js} +1 -1
- package/dist/docs/assets/chunks/{linear.CL3TC3u7.js → linear.5c61gNw4.js} +1 -1
- package/dist/docs/assets/chunks/{min.SPrSp704.js → min.B1-NAjHX.js} +1 -1
- package/dist/docs/assets/chunks/{mindmap-definition-QFDTVHPH.DgrQRFZW.js → mindmap-definition-QFDTVHPH.BELznv3-.js} +1 -1
- package/dist/docs/assets/chunks/{pieDiagram-DEJITSTG.Ba7yxiW2.js → pieDiagram-DEJITSTG.qPzO1mq5.js} +1 -1
- package/dist/docs/assets/chunks/{quadrantDiagram-34T5L4WZ.Bvskad4p.js → quadrantDiagram-34T5L4WZ.CxIvzbjX.js} +1 -1
- package/dist/docs/assets/chunks/{requirementDiagram-MS252O5E.Ce70ugV9.js → requirementDiagram-MS252O5E.CqA0iJx8.js} +1 -1
- package/dist/docs/assets/chunks/{sankeyDiagram-XADWPNL6.BJ5OEULO.js → sankeyDiagram-XADWPNL6.XRTutBnb.js} +1 -1
- package/dist/docs/assets/chunks/{sequenceDiagram-FGHM5R23.C8a1hDs6.js → sequenceDiagram-FGHM5R23.E--7bRLQ.js} +1 -1
- package/dist/docs/assets/chunks/{stateDiagram-FHFEXIEX.D2D8A5CK.js → stateDiagram-FHFEXIEX.C4vGu8zq.js} +1 -1
- package/dist/docs/assets/chunks/stateDiagram-v2-QKLJ7IA2.ECMu2BdJ.js +1 -0
- package/dist/docs/assets/chunks/{theme.DRciHmS1.js → theme.DMj_7q3B.js} +2 -2
- package/dist/docs/assets/chunks/{timeline-definition-GMOUNBTQ.C4ePrY8-.js → timeline-definition-GMOUNBTQ.C7LgNVAL.js} +1 -1
- package/dist/docs/assets/chunks/{vennDiagram-DHZGUBPP.Dzso6dEA.js → vennDiagram-DHZGUBPP.HUwoZcy_.js} +1 -1
- package/dist/docs/assets/chunks/{wardley-RL74JXVD.djgXR0ar.js → wardley-RL74JXVD.BxFEFYZS.js} +1 -1
- package/dist/docs/assets/chunks/{wardleyDiagram-NUSXRM2D.Bf2ICxjh.js → wardleyDiagram-NUSXRM2D.B2pSo5rB.js} +1 -1
- package/dist/docs/assets/chunks/{xychartDiagram-5P7HB3ND.DEH4BcVJ.js → xychartDiagram-5P7HB3ND.NQhMiOOL.js} +1 -1
- package/dist/docs/assets/deployment.md.BtqJrHhp.js +31 -0
- package/dist/docs/assets/{deployment.md.KW0Ni_rY.lean.js → deployment.md.BtqJrHhp.lean.js} +1 -1
- package/dist/docs/assets/evals.md.Dne6VRmZ.js +49 -0
- package/dist/docs/assets/evals.md.Dne6VRmZ.lean.js +1 -0
- package/dist/docs/assets/{guides_agent-to-agent.md.D1D5f6Jc.js → guides_agent-to-agent.md.BcmSqL2z.js} +8 -8
- package/dist/docs/assets/guides_agent-to-agent.md.BcmSqL2z.lean.js +1 -0
- package/dist/docs/assets/{guides_bitbucket.md.DkjkBRU8.js → guides_bitbucket.md.BiA6ZMFW.js} +27 -27
- package/dist/docs/assets/{guides_bitbucket.md.DkjkBRU8.lean.js → guides_bitbucket.md.BiA6ZMFW.lean.js} +1 -1
- package/dist/docs/assets/guides_cloud-agents.md.CiXAW6on.js +9 -0
- package/dist/docs/assets/{guides_cloud-agents.md.Ceyjv0ul.lean.js → guides_cloud-agents.md.CiXAW6on.lean.js} +1 -1
- package/dist/docs/assets/guides_convert-automation.md.BvTxsJ8J.js +26 -0
- package/dist/docs/assets/{guides_convert-automation.md.BjraCvok.lean.js → guides_convert-automation.md.BvTxsJ8J.lean.js} +1 -1
- package/dist/docs/assets/{guides_github.md.CgN5sNbW.js → guides_github.md.6jiEH7dg.js} +11 -19
- package/dist/docs/assets/{guides_github.md.CgN5sNbW.lean.js → guides_github.md.6jiEH7dg.lean.js} +1 -1
- package/dist/docs/assets/{guides_gitlab.md.DCE0p7_w.js → guides_gitlab.md.DcKusOcU.js} +63 -73
- package/dist/docs/assets/{guides_gitlab.md.DCE0p7_w.lean.js → guides_gitlab.md.DcKusOcU.lean.js} +1 -1
- package/dist/docs/assets/guides_improve.md.o3WOGR7n.js +16 -0
- package/dist/docs/assets/{guides_improve.md.BFYtrtLE.lean.js → guides_improve.md.o3WOGR7n.lean.js} +1 -1
- package/dist/docs/assets/{guides_jev.md.CEqLgjj9.js → guides_jev.md.DGCzkMUN.js} +20 -60
- package/dist/docs/assets/{guides_jev.md.CEqLgjj9.lean.js → guides_jev.md.DGCzkMUN.lean.js} +1 -1
- package/dist/docs/assets/{guides_mcp-oauth.md.DrGY92u4.js → guides_mcp-oauth.md.C-Sx_IPa.js} +3 -5
- package/dist/docs/assets/{guides_mcp-oauth.md.DrGY92u4.lean.js → guides_mcp-oauth.md.C-Sx_IPa.lean.js} +1 -1
- package/dist/docs/assets/guides_migrate.md.BbhHYeCr.js +3 -0
- package/dist/docs/assets/{guides_migrate.md.RS9Eu-Xh.lean.js → guides_migrate.md.BbhHYeCr.lean.js} +1 -1
- package/dist/docs/assets/guides_opentelemetry.md.BRSktBHt.js +26 -0
- package/dist/docs/assets/guides_opentelemetry.md.BRSktBHt.lean.js +1 -0
- package/dist/docs/assets/guides_pagerduty.md.pMXUkZZc.js +61 -0
- package/dist/docs/assets/guides_pagerduty.md.pMXUkZZc.lean.js +1 -0
- package/dist/docs/assets/guides_slack.md.BgIGG9ur.js +82 -0
- package/dist/docs/assets/{guides_slack.md.BwXHURvY.lean.js → guides_slack.md.BgIGG9ur.lean.js} +1 -1
- package/dist/docs/assets/{guides_webhooks.md.BJk63ZTs.js → guides_webhooks.md.B5DXt2v1.js} +7 -7
- package/dist/docs/assets/{guides_webhooks.md.BJk63ZTs.lean.js → guides_webhooks.md.B5DXt2v1.lean.js} +1 -1
- package/dist/docs/assets/hillclimbing.md.3TkdF79A.js +5 -0
- package/dist/docs/assets/hillclimbing.md.3TkdF79A.lean.js +1 -0
- package/dist/docs/assets/index.md.DRfaoRCZ.js +20 -0
- package/dist/docs/assets/{index.md.CAruw_rp.lean.js → index.md.DRfaoRCZ.lean.js} +1 -1
- package/dist/docs/assets/quickstart.md.r-oE8nkX.js +113 -0
- package/dist/docs/assets/{quickstart.md.CljDaJBi.lean.js → quickstart.md.r-oE8nkX.lean.js} +1 -1
- package/dist/docs/assets/reference_access.md.C5lblfUC.js +1 -0
- package/dist/docs/assets/reference_access.md.C5lblfUC.lean.js +1 -0
- package/dist/docs/assets/reference_agent-config.md.C0Tp_Fk9.js +27 -0
- package/dist/docs/assets/{reference_agent-config.md.Ck29qYNj.lean.js → reference_agent-config.md.C0Tp_Fk9.lean.js} +1 -1
- package/dist/docs/assets/reference_artifacts.md.BJpAI7h9.js +17 -0
- package/dist/docs/assets/{reference_artifacts.md.C-hKR2hp.lean.js → reference_artifacts.md.BJpAI7h9.lean.js} +1 -1
- package/dist/docs/assets/reference_channels.md.CPWOpdsC.js +21 -0
- package/dist/docs/assets/{reference_channels.md.DsJfGSBJ.lean.js → reference_channels.md.CPWOpdsC.lean.js} +1 -1
- package/dist/docs/assets/reference_cli.md.B8GdpaRj.js +83 -0
- package/dist/docs/assets/reference_cli.md.B8GdpaRj.lean.js +1 -0
- package/dist/docs/assets/reference_connections.md.DoY4vrDH.js +54 -0
- package/dist/docs/assets/{reference_connections.md.BoAotr7_.lean.js → reference_connections.md.DoY4vrDH.lean.js} +1 -1
- package/dist/docs/assets/reference_evals.md.DgfUtfIc.js +69 -0
- package/dist/docs/assets/{reference_evals.md.2BXeMiO2.lean.js → reference_evals.md.DgfUtfIc.lean.js} +1 -1
- package/dist/docs/assets/{reference_extensions.md.DI5X5x8p.js → reference_extensions.md.DHbW6eOf.js} +6 -8
- package/dist/docs/assets/{reference_extensions.md.DI5X5x8p.lean.js → reference_extensions.md.DHbW6eOf.lean.js} +1 -1
- package/dist/docs/assets/reference_hooks.md.CSWmOwMM.js +39 -0
- package/dist/docs/assets/reference_hooks.md.CSWmOwMM.lean.js +1 -0
- package/dist/docs/assets/reference_http-api.md.C7Cb0r2J.js +7 -0
- package/dist/docs/assets/{reference_http-api.md._RWELr3d.lean.js → reference_http-api.md.C7Cb0r2J.lean.js} +1 -1
- package/dist/docs/assets/reference_instructions.md.CV6Qq0UX.js +14 -0
- package/dist/docs/assets/reference_instructions.md.CV6Qq0UX.lean.js +1 -0
- package/dist/docs/assets/reference_limits.md.CbdtFr4T.js +8 -0
- package/dist/docs/assets/reference_limits.md.CbdtFr4T.lean.js +1 -0
- package/dist/docs/assets/reference_memory.md.CdoJISM-.js +3 -0
- package/dist/docs/assets/{reference_memory.md.Dd7cyV9V.lean.js → reference_memory.md.CdoJISM-.lean.js} +1 -1
- package/dist/docs/assets/reference_playground.md.DIUsRAcy.js +1 -0
- package/dist/docs/assets/{reference_playground.md.CQiJk9CM.lean.js → reference_playground.md.DIUsRAcy.lean.js} +1 -1
- package/dist/docs/assets/reference_project-layout.md.9DiKoE16.js +26 -0
- package/dist/docs/assets/reference_project-layout.md.9DiKoE16.lean.js +1 -0
- package/dist/docs/assets/reference_schedules.md.RhQ9ZLo1.js +45 -0
- package/dist/docs/assets/{reference_schedules.md.RC47aFm4.lean.js → reference_schedules.md.RhQ9ZLo1.lean.js} +1 -1
- package/dist/docs/assets/reference_sessions.md.NXVQt9mP.js +22 -0
- package/dist/docs/assets/{reference_sessions.md.C7KFhWXV.lean.js → reference_sessions.md.NXVQt9mP.lean.js} +1 -1
- package/dist/docs/assets/{reference_skills.md.Dej2zQxi.js → reference_skills.md.DzCPNPkG.js} +4 -4
- package/dist/docs/assets/{reference_skills.md.Dej2zQxi.lean.js → reference_skills.md.DzCPNPkG.lean.js} +1 -1
- package/dist/docs/assets/reference_subagents.md.Dvpq2sUu.js +10 -0
- package/dist/docs/assets/{reference_subagents.md.CAhvW4yS.lean.js → reference_subagents.md.Dvpq2sUu.lean.js} +1 -1
- package/dist/docs/assets/reference_tools.md.B2OaR1Nb.js +62 -0
- package/dist/docs/assets/{reference_tools.md.DQr7Fnhu.lean.js → reference_tools.md.B2OaR1Nb.lean.js} +1 -1
- package/dist/docs/assets/templates_agentic-owners.md.B6ZmKAzT.js +13 -0
- package/dist/docs/assets/{templates_agentic-owners.md.Dh2nDSqg.lean.js → templates_agentic-owners.md.B6ZmKAzT.lean.js} +1 -1
- package/dist/docs/assets/templates_reviews.md.dr9Xv_KM.js +10 -0
- package/dist/docs/assets/templates_reviews.md.dr9Xv_KM.lean.js +1 -0
- package/dist/docs/assets/troubleshooting.md.DfKKvW1R.js +3 -0
- package/dist/docs/assets/{troubleshooting.md.CGOdNVAL.lean.js → troubleshooting.md.DfKKvW1R.lean.js} +1 -1
- package/dist/docs/building-with-agents.html +41 -44
- package/dist/docs/building-with-agents.md +11 -104
- package/dist/docs/changelog.html +37 -37
- package/dist/docs/changelog.md +5 -155
- package/dist/docs/deployment.html +54 -54
- package/dist/docs/deployment.md +83 -262
- package/dist/docs/evals.html +52 -71
- package/dist/docs/evals.md +33 -129
- package/dist/docs/guides/agent-to-agent.html +43 -43
- package/dist/docs/guides/agent-to-agent.md +27 -64
- package/dist/docs/guides/bitbucket.html +62 -62
- package/dist/docs/guides/bitbucket.md +73 -134
- package/dist/docs/guides/cloud-agents.html +37 -37
- package/dist/docs/guides/cloud-agents.md +23 -53
- package/dist/docs/guides/convert-automation.html +39 -56
- package/dist/docs/guides/convert-automation.md +31 -115
- package/dist/docs/guides/github.html +46 -54
- package/dist/docs/guides/github.md +49 -131
- package/dist/docs/guides/gitlab.html +98 -108
- package/dist/docs/guides/gitlab.md +104 -184
- package/dist/docs/guides/improve.html +38 -43
- package/dist/docs/guides/improve.md +24 -90
- package/dist/docs/guides/jev.html +55 -95
- package/dist/docs/guides/jev.md +53 -160
- package/dist/docs/guides/mcp-oauth.html +38 -40
- package/dist/docs/guides/mcp-oauth.md +33 -67
- package/dist/docs/guides/migrate.html +38 -43
- package/dist/docs/guides/migrate.md +56 -130
- package/dist/docs/guides/opentelemetry.html +41 -43
- package/dist/docs/guides/opentelemetry.md +32 -27
- package/dist/docs/guides/pagerduty.html +50 -49
- package/dist/docs/guides/pagerduty.md +65 -199
- package/dist/docs/guides/slack.html +51 -57
- package/dist/docs/guides/slack.md +76 -204
- package/dist/docs/guides/webhooks.html +42 -42
- package/dist/docs/guides/webhooks.md +64 -146
- package/dist/docs/hashmap.json +1 -1
- package/dist/docs/hillclimbing.html +40 -42
- package/dist/docs/hillclimbing.md +40 -102
- package/dist/docs/index.html +55 -61
- package/dist/docs/index.md +49 -83
- package/dist/docs/llms-full.txt +2262 -5721
- package/dist/docs/llms.txt +9 -14
- package/dist/docs/quickstart.html +95 -152
- package/dist/docs/quickstart.md +91 -180
- package/dist/docs/reference/access.html +36 -36
- package/dist/docs/reference/access.md +7 -12
- package/dist/docs/reference/agent-config.html +43 -56
- package/dist/docs/reference/agent-config.md +91 -174
- package/dist/docs/reference/artifacts.html +38 -39
- package/dist/docs/reference/artifacts.md +38 -62
- package/dist/docs/reference/channels.html +38 -39
- package/dist/docs/reference/channels.md +102 -151
- package/dist/docs/reference/cli.html +68 -84
- package/dist/docs/reference/cli.md +232 -697
- package/dist/docs/reference/connections.html +45 -57
- package/dist/docs/reference/connections.md +83 -164
- package/dist/docs/reference/evals.html +47 -54
- package/dist/docs/reference/evals.md +75 -141
- package/dist/docs/reference/extensions.html +41 -43
- package/dist/docs/reference/extensions.md +37 -70
- package/dist/docs/reference/hooks.html +40 -52
- package/dist/docs/reference/hooks.md +62 -133
- package/dist/docs/reference/http-api.html +38 -42
- package/dist/docs/reference/http-api.md +66 -118
- package/dist/docs/reference/instructions.html +39 -39
- package/dist/docs/reference/instructions.md +19 -29
- package/dist/docs/reference/limits.html +38 -38
- package/dist/docs/reference/limits.md +9 -21
- package/dist/docs/reference/memory.html +37 -38
- package/dist/docs/reference/memory.md +38 -75
- package/dist/docs/reference/playground.html +36 -36
- package/dist/docs/reference/playground.md +14 -22
- package/dist/docs/reference/project-layout.html +49 -48
- package/dist/docs/reference/project-layout.md +38 -84
- package/dist/docs/reference/schedules.html +46 -48
- package/dist/docs/reference/schedules.md +59 -90
- package/dist/docs/reference/sessions.html +37 -37
- package/dist/docs/reference/sessions.md +66 -113
- package/dist/docs/reference/skills.html +39 -39
- package/dist/docs/reference/skills.md +11 -31
- package/dist/docs/reference/subagents.html +37 -37
- package/dist/docs/reference/subagents.md +17 -31
- package/dist/docs/reference/tools.html +47 -64
- package/dist/docs/reference/tools.md +48 -130
- package/dist/docs/templates/agentic-owners.html +38 -38
- package/dist/docs/templates/agentic-owners.md +50 -74
- package/dist/docs/templates/reviews.html +69 -0
- package/dist/docs/templates/reviews.md +71 -0
- package/dist/docs/troubleshooting.html +38 -36
- package/dist/docs/troubleshooting.md +48 -101
- package/dist/internal/cli-deploy.js +1 -1
- package/dist/internal/cli-docs.js +1 -1
- package/dist/internal/cli-images.js +1 -1
- package/dist/internal/cli-skills.js +1 -1
- package/dist/internal/cursor/credentials.js +1 -1
- package/dist/internal/deploy-manifest.d.ts +1 -0
- package/dist/internal/deploy-manifest.d.ts.map +1 -1
- package/dist/internal/deploy-manifest.js +0 -1
- package/dist/internal/discovery/agent-config.d.ts +2 -6
- package/dist/internal/discovery/agent-config.d.ts.map +1 -1
- package/dist/internal/discovery/agent-config.js +8 -25
- package/dist/internal/discovery/agent.d.ts.map +1 -1
- package/dist/internal/discovery/agent.js +2 -3
- package/dist/internal/discovery/project.d.ts.map +1 -1
- package/dist/internal/discovery/project.js +15 -0
- package/dist/internal/init-project.d.ts.map +1 -1
- package/dist/internal/init-project.js +7 -5
- package/dist/internal/reminder-runner.js +1 -1
- package/dist/internal/session-engine.js +1 -1
- package/dist/internal/shallow-clone.js +1 -1
- package/dist/playground/assets/index-D6mVn9og.js +62 -0
- package/dist/playground/assets/index-DlALM6gr.css +1 -0
- package/dist/playground/index.html +2 -2
- package/dist/types.d.ts +4 -17
- package/dist/types.d.ts.map +1 -1
- package/docs/README.md +49 -83
- package/docs/building-with-agents.md +11 -104
- package/docs/changelog.md +6 -156
- package/docs/deployment.md +83 -262
- package/docs/evals.md +34 -130
- package/docs/guides/agent-to-agent.md +27 -64
- package/docs/guides/bitbucket.md +73 -134
- package/docs/guides/cloud-agents.md +23 -53
- package/docs/guides/convert-automation.md +31 -115
- package/docs/guides/github.md +49 -131
- package/docs/guides/gitlab.md +104 -184
- package/docs/guides/improve.md +24 -90
- package/docs/guides/jev.md +53 -160
- package/docs/guides/mcp-oauth.md +33 -67
- package/docs/guides/migrate.md +56 -130
- package/docs/guides/opentelemetry.md +37 -27
- package/docs/guides/pagerduty.md +68 -200
- package/docs/guides/slack.md +76 -204
- package/docs/guides/webhooks.md +64 -146
- package/docs/hillclimbing.md +41 -103
- package/docs/quickstart.md +91 -180
- package/docs/reference/access.md +7 -12
- package/docs/reference/agent-config.md +91 -174
- package/docs/reference/artifacts.md +38 -62
- package/docs/reference/channels.md +102 -151
- package/docs/reference/cli.md +232 -697
- package/docs/reference/connections.md +83 -164
- package/docs/reference/evals.md +75 -141
- package/docs/reference/extensions.md +37 -70
- package/docs/reference/hooks.md +61 -132
- package/docs/reference/http-api.md +66 -118
- package/docs/reference/instructions.md +20 -30
- package/docs/reference/limits.md +10 -22
- package/docs/reference/memory.md +38 -75
- package/docs/reference/playground.md +14 -22
- package/docs/reference/project-layout.md +38 -84
- package/docs/reference/schedules.md +59 -90
- package/docs/reference/sessions.md +66 -113
- package/docs/reference/skills.md +12 -32
- package/docs/reference/subagents.md +17 -31
- package/docs/reference/tools.md +48 -130
- package/docs/templates/agentic-owners.md +50 -74
- package/docs/templates/reviews.md +76 -0
- package/docs/troubleshooting.md +48 -101
- package/package.json +2 -2
- package/skills/deploy/SKILL.md +1 -1
- package/skills/migrate-v2/SKILL.md +0 -1
- package/dist/docs/assets/building-with-agents.md.Bf1yH2tG.js +0 -9
- package/dist/docs/assets/changelog.md.DrLFQUlu.js +0 -1
- package/dist/docs/assets/changelog.md.DrLFQUlu.lean.js +0 -1
- package/dist/docs/assets/chunks/@localSearchIndexroot.Dpd_wxVU.js +0 -1
- package/dist/docs/assets/chunks/channel._fZX_hvU.js +0 -1
- package/dist/docs/assets/chunks/classDiagram-6PBFFD2Q.eClS1Q0E.js +0 -1
- package/dist/docs/assets/chunks/classDiagram-v2-HSJHXN6E.eClS1Q0E.js +0 -1
- package/dist/docs/assets/chunks/clone.W1Phdw9P.js +0 -1
- package/dist/docs/assets/chunks/stateDiagram-v2-QKLJ7IA2.77yf4kRr.js +0 -1
- package/dist/docs/assets/deployment.md.KW0Ni_rY.js +0 -31
- package/dist/docs/assets/evals.md.DiljU__Z.js +0 -68
- package/dist/docs/assets/evals.md.DiljU__Z.lean.js +0 -1
- package/dist/docs/assets/guides_agent-to-agent.md.D1D5f6Jc.lean.js +0 -1
- package/dist/docs/assets/guides_cloud-agents.md.Ceyjv0ul.js +0 -9
- package/dist/docs/assets/guides_convert-automation.md.BjraCvok.js +0 -43
- package/dist/docs/assets/guides_hooks.md.BjeEiM7s.js +0 -54
- package/dist/docs/assets/guides_hooks.md.BjeEiM7s.lean.js +0 -1
- package/dist/docs/assets/guides_improve.md.BFYtrtLE.js +0 -21
- package/dist/docs/assets/guides_migrate.md.RS9Eu-Xh.js +0 -8
- package/dist/docs/assets/guides_opentelemetry.md.CoZ1kNyd.js +0 -28
- package/dist/docs/assets/guides_opentelemetry.md.CoZ1kNyd.lean.js +0 -1
- package/dist/docs/assets/guides_pagerduty.md.mnKXe9U0.js +0 -60
- package/dist/docs/assets/guides_pagerduty.md.mnKXe9U0.lean.js +0 -1
- package/dist/docs/assets/guides_slack.md.BwXHURvY.js +0 -88
- package/dist/docs/assets/hillclimbing.md.By61f3uq.js +0 -7
- package/dist/docs/assets/hillclimbing.md.By61f3uq.lean.js +0 -1
- package/dist/docs/assets/index.md.CAruw_rp.js +0 -26
- package/dist/docs/assets/quickstart.md.CljDaJBi.js +0 -170
- package/dist/docs/assets/reference_access.md.CEtibb4i.js +0 -1
- package/dist/docs/assets/reference_access.md.CEtibb4i.lean.js +0 -1
- package/dist/docs/assets/reference_agent-config.md.Ck29qYNj.js +0 -40
- package/dist/docs/assets/reference_artifacts.md.C-hKR2hp.js +0 -18
- package/dist/docs/assets/reference_channels.md.DsJfGSBJ.js +0 -22
- package/dist/docs/assets/reference_cli.md.BkdLRbXg.js +0 -99
- package/dist/docs/assets/reference_cli.md.BkdLRbXg.lean.js +0 -1
- package/dist/docs/assets/reference_connections.md.BoAotr7_.js +0 -66
- package/dist/docs/assets/reference_evals.md.2BXeMiO2.js +0 -76
- package/dist/docs/assets/reference_hooks.md.B-bwJuiG.js +0 -51
- package/dist/docs/assets/reference_hooks.md.B-bwJuiG.lean.js +0 -1
- package/dist/docs/assets/reference_http-api.md._RWELr3d.js +0 -11
- package/dist/docs/assets/reference_instructions.md.yL2hXLnl.js +0 -14
- package/dist/docs/assets/reference_instructions.md.yL2hXLnl.lean.js +0 -1
- package/dist/docs/assets/reference_limits.md.BCCnvt3o.js +0 -8
- package/dist/docs/assets/reference_limits.md.BCCnvt3o.lean.js +0 -1
- package/dist/docs/assets/reference_memory.md.Dd7cyV9V.js +0 -4
- package/dist/docs/assets/reference_playground.md.CQiJk9CM.js +0 -1
- package/dist/docs/assets/reference_project-layout.md.BamcPDUn.js +0 -25
- package/dist/docs/assets/reference_project-layout.md.BamcPDUn.lean.js +0 -1
- package/dist/docs/assets/reference_prompt.md.BMjm1Jp3.js +0 -9
- package/dist/docs/assets/reference_prompt.md.BMjm1Jp3.lean.js +0 -1
- package/dist/docs/assets/reference_schedules.md.RC47aFm4.js +0 -47
- package/dist/docs/assets/reference_sessions.md.C7KFhWXV.js +0 -22
- package/dist/docs/assets/reference_subagents.md.CAhvW4yS.js +0 -10
- package/dist/docs/assets/reference_tools.md.DQr7Fnhu.js +0 -79
- package/dist/docs/assets/templates_agentic-owners.md.Dh2nDSqg.js +0 -13
- package/dist/docs/assets/templates_security-reviewer.md.DnwXdnB5.js +0 -3
- package/dist/docs/assets/templates_security-reviewer.md.DnwXdnB5.lean.js +0 -1
- package/dist/docs/assets/templates_thermo-quality-review.md.MJIdHkzE.js +0 -3
- package/dist/docs/assets/templates_thermo-quality-review.md.MJIdHkzE.lean.js +0 -1
- package/dist/docs/assets/templates_thermo-review.md.DfN1OFOl.js +0 -3
- package/dist/docs/assets/templates_thermo-review.md.DfN1OFOl.lean.js +0 -1
- package/dist/docs/assets/templates_triage.md.BYWMloV4.js +0 -9
- package/dist/docs/assets/templates_triage.md.BYWMloV4.lean.js +0 -1
- package/dist/docs/assets/troubleshooting.md.CGOdNVAL.js +0 -1
- package/dist/docs/guides/hooks.html +0 -113
- package/dist/docs/guides/hooks.md +0 -116
- package/dist/docs/package/skills/create-agent/SKILL.md +0 -178
- package/dist/docs/package/skills/evals/SKILL.md +0 -145
- package/dist/docs/package/skills/github/SKILL.md +0 -133
- package/dist/docs/package/skills/hillclimb/SKILL.md +0 -63
- package/dist/docs/package/skills/mcp-auth/SKILL.md +0 -60
- package/dist/docs/package/skills/migrate-v2/SKILL.md +0 -394
- package/dist/docs/package/skills/setup-slack/SKILL.md +0 -136
- package/dist/docs/reference/prompt.html +0 -68
- package/dist/docs/reference/prompt.md +0 -47
- package/dist/docs/templates/security-reviewer.html +0 -62
- package/dist/docs/templates/security-reviewer.md +0 -81
- package/dist/docs/templates/thermo-quality-review.html +0 -62
- package/dist/docs/templates/thermo-quality-review.md +0 -75
- package/dist/docs/templates/thermo-review.html +0 -62
- package/dist/docs/templates/thermo-review.md +0 -75
- package/dist/docs/templates/triage.html +0 -68
- package/dist/docs/templates/triage.md +0 -101
- package/dist/playground/assets/index-Cl9zvmmf.js +0 -62
- package/dist/playground/assets/index-F8b5WvWi.css +0 -1
- package/docs/guides/hooks.md +0 -121
- package/docs/reference/prompt.md +0 -52
- package/docs/templates/security-reviewer.md +0 -86
- package/docs/templates/thermo-quality-review.md +0 -80
- package/docs/templates/thermo-review.md +0 -80
- package/docs/templates/triage.md +0 -106
|
@@ -1,145 +0,0 @@
|
|
|
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.
|
|
@@ -1,133 +0,0 @@
|
|
|
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.
|
|
@@ -1,63 +0,0 @@
|
|
|
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.
|
|
@@ -1,60 +0,0 @@
|
|
|
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.
|