@grok/agent-sdk 0.2.29 → 0.4.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/channels/slack/slack-channel.d.ts.map +1 -1
- package/dist/channels/slack/slack-channel.js +27 -14
- package/dist/docs/404.html +2 -2
- package/dist/docs/assets/{app.DMrZKFjI.js → app.BSH__xV4.js} +4 -4
- package/dist/docs/assets/building-with-agents.md.Bo3ct-rf.js +6 -0
- package/dist/docs/assets/{building-with-agents.md.Bf1yH2tG.lean.js → building-with-agents.md.Bo3ct-rf.lean.js} +1 -1
- package/dist/docs/assets/changelog.md.b6H_ea44.js +1 -0
- package/dist/docs/assets/changelog.md.b6H_ea44.lean.js +1 -0
- package/dist/docs/assets/chunks/@localSearchIndexroot.CiRGcfZg.js +1 -0
- package/dist/docs/assets/chunks/{VPLocalSearchBox.DQvuw1KA.js → VPLocalSearchBox.Cadl7A0k.js} +1 -1
- package/dist/docs/assets/chunks/{arc.ahOG-Qza.js → arc.K7t9nNY6.js} +1 -1
- package/dist/docs/assets/chunks/{architectureDiagram-Q4EWVU46.BcgfYNO_.js → architectureDiagram-Q4EWVU46.SlHEknkX.js} +1 -1
- package/dist/docs/assets/chunks/{baseUniq.DeIYZrWh.js → baseUniq.DJLRMLkz.js} +1 -1
- package/dist/docs/assets/chunks/{blockDiagram-DXYQGD6D.HjJ2goMX.js → blockDiagram-DXYQGD6D.Bs6XxFpe.js} +1 -1
- package/dist/docs/assets/chunks/{c4Diagram-AHTNJAMY.C1QTb9GM.js → c4Diagram-AHTNJAMY.CyLg6Ovc.js} +1 -1
- package/dist/docs/assets/chunks/channel.CVTdqYx0.js +1 -0
- package/dist/docs/assets/chunks/{chunk-4BX2VUAB.UuZiDiVp.js → chunk-4BX2VUAB.DTQ4TinT.js} +1 -1
- package/dist/docs/assets/chunks/{chunk-4TB4RGXK.5A3YmkhI.js → chunk-4TB4RGXK.Es84IgcH.js} +1 -1
- package/dist/docs/assets/chunks/{chunk-55IACEB6.B4uf1yYV.js → chunk-55IACEB6.Clm3cGPQ.js} +1 -1
- package/dist/docs/assets/chunks/{chunk-EDXVE4YY.CoXBce8t.js → chunk-EDXVE4YY.DE4CRkS5.js} +1 -1
- package/dist/docs/assets/chunks/{chunk-FMBD7UC4.DnC5NO4e.js → chunk-FMBD7UC4.Bf8HCvqp.js} +1 -1
- package/dist/docs/assets/chunks/{chunk-OYMX7WX6.CzfHCeIi.js → chunk-OYMX7WX6.eub-7nSx.js} +1 -1
- package/dist/docs/assets/chunks/{chunk-QZHKN3VN.C6tcwkVd.js → chunk-QZHKN3VN.WyP9VAS_.js} +1 -1
- package/dist/docs/assets/chunks/{chunk-YZCP3GAM._oboyZ1A.js → chunk-YZCP3GAM.LO9ohhDE.js} +1 -1
- package/dist/docs/assets/chunks/classDiagram-6PBFFD2Q.CsJJyx6-.js +1 -0
- package/dist/docs/assets/chunks/classDiagram-v2-HSJHXN6E.CsJJyx6-.js +1 -0
- package/dist/docs/assets/chunks/clone.Dk8KvtOB.js +1 -0
- package/dist/docs/assets/chunks/{cose-bilkent-S5V4N54A.BfPVKeId.js → cose-bilkent-S5V4N54A.D5za6aH0.js} +1 -1
- package/dist/docs/assets/chunks/{dagre-KV5264BT.CLMLc0lD.js → dagre-KV5264BT.Dq1daUru.js} +1 -1
- package/dist/docs/assets/chunks/{diagram-5BDNPKRD.C7OF7UfH.js → diagram-5BDNPKRD.j1YL5BKS.js} +1 -1
- package/dist/docs/assets/chunks/{diagram-G4DWMVQ6.Dpao0Bl1.js → diagram-G4DWMVQ6.Bi1aLdhC.js} +1 -1
- package/dist/docs/assets/chunks/{diagram-MMDJMWI5.DLnM9eLp.js → diagram-MMDJMWI5.BOzMEkAr.js} +1 -1
- package/dist/docs/assets/chunks/{diagram-TYMM5635.BcpVgA_M.js → diagram-TYMM5635.Dx2FVhCr.js} +1 -1
- package/dist/docs/assets/chunks/{erDiagram-SMLLAGMA.CsL5JuCV.js → erDiagram-SMLLAGMA.DI4TNkye.js} +1 -1
- package/dist/docs/assets/chunks/{flowDiagram-DWJPFMVM.MFihq9AF.js → flowDiagram-DWJPFMVM.C58Z9uPK.js} +1 -1
- package/dist/docs/assets/chunks/{ganttDiagram-T4ZO3ILL.CJeLodyG.js → ganttDiagram-T4ZO3ILL.DXSpW809.js} +1 -1
- package/dist/docs/assets/chunks/{gitGraphDiagram-UUTBAWPF.1HhlE45Z.js → gitGraphDiagram-UUTBAWPF.B955oaFl.js} +1 -1
- package/dist/docs/assets/chunks/{graph.BS02KkWA.js → graph.BQXhKtxS.js} +1 -1
- package/dist/docs/assets/chunks/{infoDiagram-42DDH7IO.fp5gvytQ.js → infoDiagram-42DDH7IO.Dozj_-Gm.js} +1 -1
- package/dist/docs/assets/chunks/{ishikawaDiagram-UXIWVN3A.C6Wk1V4I.js → ishikawaDiagram-UXIWVN3A.D2140OzH.js} +1 -1
- package/dist/docs/assets/chunks/{journeyDiagram-VCZTEJTY.qJt4uJ_H.js → journeyDiagram-VCZTEJTY.DrqrMhCk.js} +1 -1
- package/dist/docs/assets/chunks/{kanban-definition-6JOO6SKY.z2tG9kly.js → kanban-definition-6JOO6SKY.Dv-LTrlw.js} +1 -1
- package/dist/docs/assets/chunks/{layout.BPCkdejr.js → layout.CGtHp49X.js} +1 -1
- package/dist/docs/assets/chunks/{linear.CL3TC3u7.js → linear.CHZLYB52.js} +1 -1
- package/dist/docs/assets/chunks/{min.SPrSp704.js → min.D4Vt3eIy.js} +1 -1
- package/dist/docs/assets/chunks/{mindmap-definition-QFDTVHPH.DgrQRFZW.js → mindmap-definition-QFDTVHPH.BBfpYTea.js} +1 -1
- package/dist/docs/assets/chunks/{pieDiagram-DEJITSTG.Ba7yxiW2.js → pieDiagram-DEJITSTG.BVYvElmY.js} +1 -1
- package/dist/docs/assets/chunks/{quadrantDiagram-34T5L4WZ.Bvskad4p.js → quadrantDiagram-34T5L4WZ.C6Gc2mdY.js} +1 -1
- package/dist/docs/assets/chunks/{requirementDiagram-MS252O5E.Ce70ugV9.js → requirementDiagram-MS252O5E.DWa8b4cn.js} +1 -1
- package/dist/docs/assets/chunks/{sankeyDiagram-XADWPNL6.BJ5OEULO.js → sankeyDiagram-XADWPNL6.Bi-g4ajv.js} +1 -1
- package/dist/docs/assets/chunks/{sequenceDiagram-FGHM5R23.C8a1hDs6.js → sequenceDiagram-FGHM5R23.DlU3vVN9.js} +1 -1
- package/dist/docs/assets/chunks/{stateDiagram-FHFEXIEX.D2D8A5CK.js → stateDiagram-FHFEXIEX.CeqJRqnU.js} +1 -1
- package/dist/docs/assets/chunks/stateDiagram-v2-QKLJ7IA2.DE0BnUZh.js +1 -0
- package/dist/docs/assets/chunks/{theme.DRciHmS1.js → theme.DGq7D4tt.js} +2 -2
- package/dist/docs/assets/chunks/{timeline-definition-GMOUNBTQ.C4ePrY8-.js → timeline-definition-GMOUNBTQ.Cqf2kjq9.js} +1 -1
- package/dist/docs/assets/chunks/{vennDiagram-DHZGUBPP.Dzso6dEA.js → vennDiagram-DHZGUBPP.BeOpE_lM.js} +1 -1
- package/dist/docs/assets/chunks/{wardley-RL74JXVD.djgXR0ar.js → wardley-RL74JXVD.FMQXA-6q.js} +1 -1
- package/dist/docs/assets/chunks/{wardleyDiagram-NUSXRM2D.Bf2ICxjh.js → wardleyDiagram-NUSXRM2D.BXS65dAC.js} +1 -1
- package/dist/docs/assets/chunks/{xychartDiagram-5P7HB3ND.DEH4BcVJ.js → xychartDiagram-5P7HB3ND.haEiSxqc.js} +1 -1
- package/dist/docs/assets/deployment.md.DJtuDVLh.js +31 -0
- package/dist/docs/assets/{deployment.md.KW0Ni_rY.lean.js → deployment.md.DJtuDVLh.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.DcB3nhOz.js} +8 -8
- package/dist/docs/assets/guides_agent-to-agent.md.DcB3nhOz.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.CcuZ7keS.js} +11 -19
- package/dist/docs/assets/{guides_github.md.CgN5sNbW.lean.js → guides_github.md.CcuZ7keS.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.GVPMKcYl.js} +3 -5
- package/dist/docs/assets/{guides_mcp-oauth.md.DrGY92u4.lean.js → guides_mcp-oauth.md.GVPMKcYl.lean.js} +1 -1
- package/dist/docs/assets/guides_migrate.md.B8CZxnnX.js +3 -0
- package/dist/docs/assets/{guides_migrate.md.RS9Eu-Xh.lean.js → guides_migrate.md.B8CZxnnX.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.D7Rwyva4.js +82 -0
- package/dist/docs/assets/{guides_slack.md.BwXHURvY.lean.js → guides_slack.md.D7Rwyva4.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.M51bF-oT.js +5 -0
- package/dist/docs/assets/hillclimbing.md.M51bF-oT.lean.js +1 -0
- package/dist/docs/assets/index.md.DnJPj_B6.js +14 -0
- package/dist/docs/assets/index.md.DnJPj_B6.lean.js +1 -0
- package/dist/docs/assets/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.BSNp2uJ7.js +27 -0
- package/dist/docs/assets/{reference_agent-config.md.Ck29qYNj.lean.js → reference_agent-config.md.BSNp2uJ7.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.DHm6DmYk.js +83 -0
- package/dist/docs/assets/reference_cli.md.DHm6DmYk.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.vbIM394-.js +39 -0
- package/dist/docs/assets/reference_hooks.md.vbIM394-.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.Dd8_d0WG.js +45 -0
- package/dist/docs/assets/{reference_schedules.md.RC47aFm4.lean.js → reference_schedules.md.Dd8_d0WG.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 +14 -145
- package/dist/docs/deployment.html +54 -54
- package/dist/docs/deployment.md +97 -270
- 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 +29 -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 +49 -61
- package/dist/docs/index.md +42 -82
- package/dist/docs/llms-full.txt +2272 -5711
- 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 +45 -58
- package/dist/docs/reference/agent-config.md +92 -176
- 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 +44 -46
- 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/filesystem.d.ts +7 -320
- package/dist/filesystem.d.ts.map +1 -1
- package/dist/filesystem.js +10 -691
- package/dist/index.d.ts +1 -1
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +1 -1
- package/dist/internal/authored-alias-hooks.d.ts +6 -0
- package/dist/internal/authored-alias-hooks.d.ts.map +1 -1
- package/dist/internal/authored-alias-hooks.js +12 -0
- package/dist/internal/authored-loaders.js +10 -1
- package/dist/internal/cli/commands/scaffold.js +1 -1
- package/dist/internal/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/continuation-session-ids.d.ts +15 -0
- package/dist/internal/continuation-session-ids.d.ts.map +1 -0
- package/dist/internal/continuation-session-ids.js +43 -0
- package/dist/internal/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/filesystem/walk.d.ts +1 -5
- package/dist/internal/filesystem/walk.d.ts.map +1 -1
- package/dist/internal/filesystem/walk.js +1 -9
- package/dist/internal/hosted-catch-protocol.d.ts +3 -3
- package/dist/internal/hosted-catch-protocol.js +3 -3
- package/dist/internal/hosted-fetch.d.ts +7 -0
- package/dist/internal/hosted-fetch.d.ts.map +1 -0
- package/dist/internal/hosted-fetch.js +26 -0
- package/dist/internal/init-project.d.ts.map +1 -1
- package/dist/internal/init-project.js +7 -5
- package/dist/internal/install-cursor-skills.d.ts +5 -6
- package/dist/internal/install-cursor-skills.d.ts.map +1 -1
- package/dist/internal/install-cursor-skills.js +19 -4
- package/dist/internal/mcp-endpoint.js +4 -4
- package/dist/internal/model-config.d.ts.map +1 -1
- package/dist/internal/model-config.js +11 -4
- package/dist/internal/platform-timers.d.ts +3 -7
- package/dist/internal/platform-timers.d.ts.map +1 -1
- package/dist/internal/platform-timers.js +10 -51
- package/dist/internal/reminder-runner.js +1 -1
- package/dist/internal/server.d.ts.map +1 -1
- package/dist/internal/server.js +6 -1
- package/dist/internal/session-engine.d.ts +3 -0
- package/dist/internal/session-engine.d.ts.map +1 -1
- package/dist/internal/session-engine.js +13 -4
- package/dist/internal/shallow-clone.js +1 -1
- package/dist/playground/assets/index-Bno25Cg0.css +1 -0
- package/dist/playground/assets/index-SGKsaznh.js +62 -0
- package/dist/playground/index.html +2 -2
- package/dist/types.d.ts +6 -17
- package/dist/types.d.ts.map +1 -1
- package/dist/types.js +2 -2
- package/docs/README.md +42 -82
- package/docs/building-with-agents.md +11 -104
- package/docs/changelog.md +15 -146
- package/docs/deployment.md +97 -270
- package/docs/evals.md +34 -130
- package/docs/guides/agent-to-agent.md +29 -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 +92 -176
- 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 +4 -4
- package/skills/cli/SKILL.md +1 -1
- package/skills/create-agent/SKILL.md +61 -7
- package/skills/debug/SKILL.md +1 -1
- package/skills/deploy/SKILL.md +3 -3
- package/skills/evals/SKILL.md +1 -1
- package/skills/framework-map/SKILL.md +2 -2
- package/skills/github/SKILL.md +1 -1
- package/skills/hillclimb/SKILL.md +1 -1
- package/skills/mcp-auth/SKILL.md +1 -1
- package/skills/migrate-v2/SKILL.md +2 -3
- package/skills/otel/SKILL.md +1 -1
- package/skills/setup-slack/SKILL.md +2 -2
- 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/index.md.CAruw_rp.lean.js +0 -1
- 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/internal/filesystem/errors.d.ts +0 -64
- package/dist/internal/filesystem/errors.d.ts.map +0 -1
- package/dist/internal/filesystem/errors.js +0 -180
- package/dist/internal/filesystem/merge.d.ts +0 -34
- package/dist/internal/filesystem/merge.d.ts.map +0 -1
- package/dist/internal/filesystem/merge.js +0 -154
- package/dist/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
package/docs/guides/bitbucket.md
CHANGED
|
@@ -5,32 +5,64 @@ description: "Review pull requests, answer comments, and triage pushes on Bitbuc
|
|
|
5
5
|
|
|
6
6
|
# Bitbucket agents
|
|
7
7
|
|
|
8
|
-
A Bitbucket agent wakes
|
|
9
|
-
|
|
10
|
-
|
|
11
|
-
|
|
8
|
+
A Bitbucket agent wakes on pull request, comment, and push events from
|
|
9
|
+
Bitbucket Cloud or Data Center, then writes its results back to the
|
|
10
|
+
repository. Declare `onPullRequest`, `onPullRequestComment`, or `onPush`
|
|
11
|
+
on `bitbucketChannel()` for each event that should wake it.
|
|
12
|
+
|
|
13
|
+
## Connect a repository
|
|
14
|
+
|
|
15
|
+
Name the repository hook secret and list the repositories that may wake
|
|
16
|
+
the agent.
|
|
17
|
+
|
|
18
|
+
```ts
|
|
19
|
+
// bot/channels/bitbucket.ts
|
|
20
|
+
import { bitbucketChannel } from "@grok/agent-sdk/channels/bitbucket";
|
|
21
|
+
|
|
22
|
+
export default bitbucketChannel({
|
|
23
|
+
repos: ["acme/widgets"],
|
|
24
|
+
webhookSecret: { secretName: "BITBUCKET_WEBHOOK_SECRET" },
|
|
25
|
+
});
|
|
26
|
+
```
|
|
27
|
+
|
|
28
|
+
Add a repository webhook for
|
|
29
|
+
`https://<your-host>/<slug>/v1/channels/bitbucket` with the same secret.
|
|
30
|
+
On Cursor hosting, a delivery with the wrong secret gets a `401` and
|
|
31
|
+
never reaches your agent. For Data Center, set the REST base and the API token:
|
|
32
|
+
|
|
33
|
+
```ts
|
|
34
|
+
export default bitbucketChannel({
|
|
35
|
+
repos: ["PLATFORM/api"],
|
|
36
|
+
webhookSecret: { secretName: "BITBUCKET_WEBHOOK_SECRET" },
|
|
37
|
+
token: () => process.env.BITBUCKET_TOKEN ?? "",
|
|
38
|
+
apiBaseUrl: "https://bitbucket.example.com/rest/api/1.0",
|
|
39
|
+
});
|
|
40
|
+
```
|
|
41
|
+
|
|
42
|
+
For Bitbucket Cloud, omit `apiBaseUrl`. To set the secrets on a deployment, see
|
|
43
|
+
[Add egress and secrets](../deployment.md#add-egress-and-secrets).
|
|
44
|
+
|
|
45
|
+
For Bitbucket Cloud on Cursor hosting, you can skip the repository
|
|
46
|
+
webhook. Set `cursorAccount: { repos: ["acme/widgets"] }`, and events and
|
|
47
|
+
`ctx.bitbucket` calls go through your signed-in Cursor account.
|
|
12
48
|
|
|
13
49
|
## Review a pull request
|
|
14
50
|
|
|
15
|
-
|
|
16
|
-
request,
|
|
17
|
-
|
|
18
|
-
answer appears as a comment on the pull request.
|
|
51
|
+
When someone opens a pull request, or pushes new commits to a Data Center
|
|
52
|
+
pull request, the agent reads the diff and posts its review as a comment
|
|
53
|
+
on the pull request.
|
|
19
54
|
|
|
20
55
|
```ts
|
|
21
56
|
// bot/channels/bitbucket.ts
|
|
22
57
|
import {
|
|
23
58
|
bitbucketChannel,
|
|
24
|
-
bitbucketChannelStateForEvent,
|
|
25
59
|
defaultBitbucketAuth,
|
|
26
60
|
} from "@grok/agent-sdk/channels/bitbucket";
|
|
27
|
-
import {
|
|
28
|
-
postPullRequestComment,
|
|
29
|
-
setPushTriageStatus,
|
|
30
|
-
} from "../lib/bitbucket.js";
|
|
61
|
+
import { postPullRequestComment } from "../lib/bitbucket.js";
|
|
31
62
|
|
|
32
63
|
export default bitbucketChannel({
|
|
33
64
|
repos: ["acme/widgets"],
|
|
65
|
+
webhookSecret: { secretName: "BITBUCKET_WEBHOOK_SECRET" },
|
|
34
66
|
onPullRequest: async (ctx, pullRequest) => {
|
|
35
67
|
if (pullRequest.draft) {
|
|
36
68
|
return null;
|
|
@@ -66,28 +98,25 @@ export default bitbucketChannel({
|
|
|
66
98
|
) {
|
|
67
99
|
return;
|
|
68
100
|
}
|
|
69
|
-
await postPullRequestComment(
|
|
70
|
-
channel.state,
|
|
71
|
-
pullRequestId,
|
|
72
|
-
event.data.text
|
|
73
|
-
);
|
|
101
|
+
await postPullRequestComment(channel.state, pullRequestId, event.data.text);
|
|
74
102
|
},
|
|
75
103
|
},
|
|
76
104
|
});
|
|
77
105
|
```
|
|
78
106
|
|
|
79
|
-
`postPullRequestComment` is a small
|
|
80
|
-
|
|
81
|
-
|
|
82
|
-
|
|
83
|
-
|
|
107
|
+
`postPullRequestComment` is a small helper you write in
|
|
108
|
+
`bot/lib/bitbucket.ts` that posts a comment through the Bitbucket API
|
|
109
|
+
with `BITBUCKET_TOKEN`. It uses the repository and pull request from the
|
|
110
|
+
session state, so the model never picks where the review goes.
|
|
111
|
+
|
|
112
|
+
Each hook returns `{ auth }`, `{ task }`, or `null`, as
|
|
113
|
+
[handler results](../reference/channels.md#handler-results) describes.
|
|
114
|
+
All events on the same pull request go to the same session, so the agent
|
|
115
|
+
sees the whole conversation.
|
|
84
116
|
|
|
85
117
|
## Answer a pull-request comment
|
|
86
118
|
|
|
87
|
-
|
|
88
|
-
request's conversation, and the first example's reply sink posts the
|
|
89
|
-
answer back to the same PR. The author guard ignores comments written
|
|
90
|
-
by the agent, preventing each reply from starting another turn.
|
|
119
|
+
Skip the agent's own comments, and answer a comment that mentions the agent:
|
|
91
120
|
|
|
92
121
|
```ts
|
|
93
122
|
const AGENT_USERNAME = "cursor-reviewer";
|
|
@@ -106,17 +135,19 @@ onPullRequestComment: (ctx, comment) => {
|
|
|
106
135
|
},
|
|
107
136
|
```
|
|
108
137
|
|
|
109
|
-
Add this property to the same `bitbucketChannel()`
|
|
110
|
-
review handler.
|
|
138
|
+
Add this property to the same `bitbucketChannel()` as the review handler.
|
|
111
139
|
|
|
112
140
|
## Triage a push to `main`
|
|
113
141
|
|
|
114
|
-
|
|
115
|
-
status to the new commit. The webhook is acknowledged while the model
|
|
116
|
-
investigates, then the status reports whether that triage turn
|
|
117
|
-
completed.
|
|
142
|
+
Mark the new commit as in progress, then start the triage turn:
|
|
118
143
|
|
|
119
144
|
```ts
|
|
145
|
+
import {
|
|
146
|
+
bitbucketChannelStateForEvent,
|
|
147
|
+
defaultBitbucketAuth,
|
|
148
|
+
} from "@grok/agent-sdk/channels/bitbucket";
|
|
149
|
+
import { setPushTriageStatus } from "../lib/bitbucket.js";
|
|
150
|
+
|
|
120
151
|
onPush: (ctx, push) => {
|
|
121
152
|
const change = push.changes.find(
|
|
122
153
|
candidate =>
|
|
@@ -154,8 +185,7 @@ onPush: (ctx, push) => {
|
|
|
154
185
|
},
|
|
155
186
|
```
|
|
156
187
|
|
|
157
|
-
|
|
158
|
-
status through the same provider wrapper:
|
|
188
|
+
When the turn ends, update that same status:
|
|
159
189
|
|
|
160
190
|
```ts
|
|
161
191
|
async "message.completed"(event, channel, ctx) {
|
|
@@ -191,108 +221,17 @@ async "turn.failed"(_event, channel, ctx) {
|
|
|
191
221
|
},
|
|
192
222
|
```
|
|
193
223
|
|
|
194
|
-
This status reports the triage run, not the health of the pushed commit
|
|
195
|
-
itself.
|
|
196
|
-
|
|
197
|
-
## Events
|
|
198
|
-
|
|
199
|
-
Use `onPullRequest`, `onPullRequestComment`, or `onPush` for the events
|
|
200
|
-
shown above. Each hook returns one of three decisions:
|
|
201
|
-
|
|
202
|
-
| Return | What happens |
|
|
203
|
-
| --- | --- |
|
|
204
|
-
| `{ auth }` | Start a model turn as the Bitbucket event sender |
|
|
205
|
-
| `{ task }` | Acknowledge the webhook, then run host code that may also call `send` |
|
|
206
|
-
| `null` | Skip the event |
|
|
207
|
-
|
|
208
|
-
The [Channels reference](../reference/channels.md) covers the remaining
|
|
209
|
-
hook and session behavior.
|
|
210
|
-
|
|
211
|
-
## Pull-request affinity
|
|
212
|
-
|
|
213
|
-
Every pull-request event and comment for the same repository and PR ID
|
|
214
|
-
resumes one agent session. A new PR, later commits, and a mention in the
|
|
215
|
-
discussion therefore share the same conversation across both Bitbucket
|
|
216
|
-
dialects.
|
|
217
|
-
|
|
218
|
-
## Call Bitbucket through `ctx.bitbucket`
|
|
219
|
-
|
|
220
|
-
Each hook receives an API client already bound to the repository and
|
|
221
|
-
dialect from the verified delivery. Use `ctx.bitbucket.api` for
|
|
222
|
-
pull-request reads and comments, `setBuildStatus()` for one status
|
|
223
|
-
update, or `createCheck()` when a status changes throughout longer
|
|
224
|
-
work.
|
|
225
|
-
|
|
226
|
-
The repository does not come from model output. Keep API calls on this
|
|
227
|
-
bound client so the event decides where reads and writes go.
|
|
228
|
-
|
|
229
|
-
## Connect
|
|
230
|
-
|
|
231
|
-
On Cursor-managed hosting, use the signed-in Cursor account and list
|
|
232
|
-
the repositories that may wake the agent:
|
|
233
|
-
|
|
234
|
-
```ts
|
|
235
|
-
export default bitbucketChannel({
|
|
236
|
-
cursorAccount: {
|
|
237
|
-
repos: ["acme/widgets"],
|
|
238
|
-
},
|
|
239
|
-
});
|
|
240
|
-
```
|
|
241
|
-
|
|
242
|
-
`cursorAccount` covers event delivery and API calls made through
|
|
243
|
-
`ctx.bitbucket` inside hooks. The `postPullRequestComment` and
|
|
244
|
-
`setPushTriageStatus` wrappers are separate REST clients, so configure
|
|
245
|
-
their Bitbucket API credential too.
|
|
224
|
+
This status reports the triage run, not the health of the pushed commit.
|
|
246
225
|
|
|
247
|
-
|
|
248
|
-
and allowed repositories. Data Center also needs its REST API base:
|
|
226
|
+
## Test with replay
|
|
249
227
|
|
|
250
|
-
|
|
251
|
-
|
|
252
|
-
|
|
253
|
-
|
|
254
|
-
token: () => process.env.BITBUCKET_TOKEN ?? "",
|
|
255
|
-
apiBaseUrl: "https://bitbucket.example.com/rest/api/1.0",
|
|
256
|
-
});
|
|
257
|
-
```
|
|
258
|
-
|
|
259
|
-
Without `webhookSecret`, the direct production route stays
|
|
260
|
-
loopback-only. Setting it admits deliveries signed with the matching
|
|
261
|
-
repository-hook secret; `token` authorizes the API reads and writes in
|
|
262
|
-
the examples.
|
|
263
|
-
|
|
264
|
-
Name the secret rather than reading it. Locally the channel reads that
|
|
265
|
-
environment variable, and on Cursor hosting the platform verifies
|
|
266
|
-
`X-Hub-Signature` with the deployment secret of that name at ingestion,
|
|
267
|
-
so an unsigned or mis-signed delivery gets a `401` before any compute
|
|
268
|
-
starts. `architecture: "v2"` requires the named form and `agent-sdk validate`
|
|
269
|
-
rejects a literal or `() => process.env.X` getter there; set the value
|
|
270
|
-
with `agent-sdk secret set <slug> BITBUCKET_WEBHOOK_SECRET`.
|
|
271
|
-
|
|
272
|
-
Register the repository webhook at
|
|
273
|
-
`https://<your-host>/<slug>/v1/channels/bitbucket` with the same secret.
|
|
274
|
-
For Bitbucket Cloud, omit `apiBaseUrl`.
|
|
275
|
-
|
|
276
|
-
## Test locally
|
|
277
|
-
|
|
278
|
-
Replay lets you exercise the same hooks with a pull request you can
|
|
279
|
-
read before registering a live repository webhook.
|
|
228
|
+
Replay a pull request you can read against your local agent, or save the
|
|
229
|
+
payloads as fixtures. For Data Center, pass the full pull request URL.
|
|
230
|
+
[`bitbucket replay`](../reference/cli.md#replay-other-webhooks) lists
|
|
231
|
+
every flag.
|
|
280
232
|
|
|
281
233
|
```text
|
|
282
234
|
agent-sdk dev
|
|
283
|
-
agent-sdk bitbucket replay
|
|
284
|
-
|
|
285
|
-
--events '*'
|
|
235
|
+
agent-sdk bitbucket replay acme/widgets#42 --events '*'
|
|
236
|
+
agent-sdk bitbucket replay acme/widgets#42 --events '*' --dry-run --fixtures-dir fixtures/bitbucket
|
|
286
237
|
```
|
|
287
|
-
|
|
288
|
-
Use `--dry-run --out fixtures/bitbucket` to save the payloads instead of
|
|
289
|
-
posting them. `BITBUCKET_TOKEN` needs read access to the pull request.
|
|
290
|
-
|
|
291
|
-
## Related
|
|
292
|
-
|
|
293
|
-
- [Channels reference](../reference/channels.md): channel hooks,
|
|
294
|
-
dispatch decisions, and session behavior
|
|
295
|
-
- [Webhooks and custom channels](./webhooks.md): direct webhook auth
|
|
296
|
-
and reply delivery
|
|
297
|
-
- [Evals](../evals.md): turn saved Bitbucket payloads into regression
|
|
298
|
-
fixtures
|
|
@@ -5,11 +5,9 @@ description: "Let an Agent SDK agent hand coding work to Cursor cloud agents and
|
|
|
5
5
|
|
|
6
6
|
# Cloud agents
|
|
7
7
|
|
|
8
|
-
The `cursor-cloud-agents` extension
|
|
9
|
-
|
|
10
|
-
|
|
11
|
-
keep talking while it runs, inspect the result, and steer or stop the
|
|
12
|
-
same branch.
|
|
8
|
+
The `cursor-cloud-agents` extension lets an Agent SDK agent hand coding work to
|
|
9
|
+
Cursor cloud agents. A cloud agent works in a repository checkout and pushes
|
|
10
|
+
branches and pull requests while your agent keeps talking to the person.
|
|
13
11
|
|
|
14
12
|
## Mount it
|
|
15
13
|
|
|
@@ -26,61 +24,33 @@ export default cursorCloudAgents({
|
|
|
26
24
|
```
|
|
27
25
|
|
|
28
26
|
Launches run under the host's signed-in account (`agent-sdk login`,
|
|
29
|
-
`CURSOR_API_KEY`, or `CURSOR_SERVICE_ACCOUNT_KEY`) and spend its
|
|
30
|
-
|
|
31
|
-
`cloud.repos`.
|
|
27
|
+
`CURSOR_API_KEY`, or `CURSOR_SERVICE_ACCOUNT_KEY`) and spend its cloud-agent
|
|
28
|
+
budget.
|
|
32
29
|
|
|
33
30
|
## What the agent can do
|
|
34
31
|
|
|
35
|
-
With the extension mounted, the agent can
|
|
36
|
-
|
|
32
|
+
With the extension mounted, the agent can launch a cloud agent on a repository
|
|
33
|
+
or pull request, check its status, read its conversation and edits, steer or
|
|
34
|
+
stop it, and list the agents it launched. A bundled skill teaches the model when
|
|
35
|
+
to delegate and how to write a brief a cloud agent can act on alone.
|
|
37
36
|
|
|
38
|
-
|
|
39
|
-
|
|
40
|
-
|
|
41
|
-
|
|
42
|
-
produced, and which branches or pull requests it pushed.
|
|
43
|
-
- **Read what was done.** Pull the agent's full conversation into the
|
|
44
|
-
workspace, quote its final report, or trace the exact edits before
|
|
45
|
-
summarizing for a person.
|
|
46
|
-
- **Steer or stop.** Send a follow-up to an agent it launched; it queues
|
|
47
|
-
behind the current run, or interrupts it on request. Cancel a run that
|
|
48
|
-
went sideways.
|
|
49
|
-
- **Keep track.** List the agents launched in this conversation, or
|
|
50
|
-
everything it has launched before.
|
|
51
|
-
|
|
52
|
-
A skill teaches the model when to delegate, how to write a brief a cloud
|
|
53
|
-
agent can act on alone, and how to follow up. Everything the extension
|
|
54
|
-
launches stays bound to whoever launched it: an agent started by another
|
|
55
|
-
user, or outside the extension, is out of reach. That separation is only
|
|
56
|
-
as fine as your host's auth; a shared bearer token or `--allow-anonymous`
|
|
57
|
-
makes every caller one principal, so use
|
|
58
|
-
[authored auth](../reference/channels.md#auth-policies) when callers need
|
|
59
|
-
their own.
|
|
37
|
+
Each caller can only see and steer the cloud agents they launched. If every
|
|
38
|
+
caller uses the same bearer token, the extension treats them all as one person.
|
|
39
|
+
Use [authored auth](../reference/channels.md#auth-policies) to keep callers
|
|
40
|
+
apart.
|
|
60
41
|
|
|
61
42
|
## Configure it
|
|
62
43
|
|
|
63
|
-
|
|
64
|
-
|
|
|
65
|
-
|
|
|
66
|
-
| `cloud`
|
|
67
|
-
| `cloud.
|
|
68
|
-
| `
|
|
69
|
-
| `
|
|
70
|
-
| `apiKey` | A Cursor API key to launch with instead of the host's own. |
|
|
71
|
-
|
|
72
|
-
|
|
73
|
-
|
|
44
|
+
| Option | What it controls |
|
|
45
|
+
| --- | --- |
|
|
46
|
+
| `cloud` | Launch defaults for repositories, environment, and pull request behavior. |
|
|
47
|
+
| `cloud.repos` | The repositories the agent may hand work to, each with a default branch or pull request. Without it, launches run with no repository, so secrets in `cloud.envVars` never reach a repository you didn't list. |
|
|
48
|
+
| `cloud.teamMcpServers` | Up to 50 team MCP server names that launched agents may use, matched case-insensitively. Omit it to allow every team server the account can use. Personal servers and `cloud.mcpServers` aren't filtered. |
|
|
49
|
+
| `model` | The model launched agents run. Omit it to use the account default. |
|
|
50
|
+
| `apiKey` | A Cursor API key to launch with instead of the host's own. |
|
|
74
51
|
|
|
75
52
|
## Adjust it
|
|
76
53
|
|
|
77
|
-
To
|
|
78
|
-
directory and disable that tool
|
|
79
|
-
[
|
|
80
|
-
|
|
81
|
-
## What's next
|
|
82
|
-
|
|
83
|
-
Continue with these pages:
|
|
84
|
-
|
|
85
|
-
- [Extensions](../reference/extensions.md): how mounts, namespaces, and
|
|
86
|
-
overrides work
|
|
54
|
+
To remove a capability such as sending follow-ups, mount the extension as a
|
|
55
|
+
directory and disable that tool. See
|
|
56
|
+
[Adjust a mounted extension](../reference/extensions.md#adjust-a-mounted-extension).
|
|
@@ -5,21 +5,15 @@ description: "Turn a dashboard Automation into an Agent SDK project, then reconn
|
|
|
5
5
|
|
|
6
6
|
# Convert a Cursor Automation
|
|
7
7
|
|
|
8
|
-
Convert a dashboard Automation when you want to edit its behavior as
|
|
9
|
-
|
|
10
|
-
|
|
11
|
-
path.
|
|
12
|
-
|
|
13
|
-
`init --from automation:…` carries over what it can prove from the exported
|
|
14
|
-
configuration and prints a checklist for everything that still needs
|
|
15
|
-
your judgment.
|
|
8
|
+
Convert a dashboard Automation when you want to edit its behavior as code, test
|
|
9
|
+
it locally, or deploy it as an Agent SDK project. To change only the prompt or
|
|
10
|
+
the trigger, stay in the dashboard.
|
|
16
11
|
|
|
17
12
|
## Convert and run locally
|
|
18
13
|
|
|
19
|
-
|
|
20
|
-
|
|
21
|
-
|
|
22
|
-
the playground before reconnecting any live trigger.
|
|
14
|
+
`init --from automation:<url>` creates a project with the Automation's prompt,
|
|
15
|
+
model, and any schedules, channels, and account connections it can represent.
|
|
16
|
+
It prints warnings and setup steps for the rest.
|
|
23
17
|
|
|
24
18
|
```text
|
|
25
19
|
agent-sdk login
|
|
@@ -27,22 +21,18 @@ agent-sdk init --from \
|
|
|
27
21
|
automation:https://cursor.com/automations/0a1b2c3d-0000-1111-2222-333344445555
|
|
28
22
|
|
|
29
23
|
cd nightly-triage
|
|
30
|
-
agent-sdk validate
|
|
31
24
|
agent-sdk dev
|
|
32
25
|
```
|
|
33
26
|
|
|
34
|
-
|
|
35
|
-
|
|
36
|
-
|
|
37
|
-
[CLI reference](../reference/cli.md#convert-automation) covers custom
|
|
38
|
-
output directories, JSON output, and command failures.
|
|
27
|
+
Try the agent in the playground before you reconnect a live trigger. The
|
|
28
|
+
[CLI reference](../reference/cli.md#convert-automation) covers the other
|
|
29
|
+
options.
|
|
39
30
|
|
|
40
31
|
## Reconnect account-backed actions
|
|
41
32
|
|
|
42
|
-
For an HTTP or SSE MCP server, the converter writes a name
|
|
43
|
-
|
|
44
|
-
|
|
45
|
-
converted agent can use that server's tools through your account.
|
|
33
|
+
For an HTTP or SSE MCP server, the converter writes a connection by name,
|
|
34
|
+
without its URL or credentials. Connect the same server under MCP in Cursor,
|
|
35
|
+
sign in on the local host, and the agent uses its tools through your account.
|
|
46
36
|
|
|
47
37
|
```ts
|
|
48
38
|
// bot/mcp-connections/linear.ts
|
|
@@ -54,55 +44,21 @@ export default defineConnection({
|
|
|
54
44
|
});
|
|
55
45
|
```
|
|
56
46
|
|
|
57
|
-
The summary adds a `Verify:` step when an original dashboard action
|
|
58
|
-
does not map to one generated tool. Treat that step as a behavior test:
|
|
59
|
-
run the converted agent with a representative input and confirm the
|
|
60
|
-
same external write happens before you consider the action restored.
|
|
61
|
-
|
|
62
47
|
## Bring a Slack trigger online
|
|
63
48
|
|
|
64
|
-
|
|
65
|
-
|
|
66
|
-
wakes on allowed posts, but only after you subscribe the app with
|
|
67
|
-
`--channel-posts`.
|
|
49
|
+
Once you create the [Slack app](./slack.md), the agent answers mentions in the
|
|
50
|
+
same thread. For a channel watch, also subscribe the app to channel posts:
|
|
68
51
|
|
|
69
52
|
```text
|
|
70
53
|
agent-sdk slack create --dir . --channel-posts
|
|
71
54
|
```
|
|
72
55
|
|
|
73
|
-
The converter
|
|
74
|
-
|
|
75
|
-
generated channel before inviting the bot:
|
|
76
|
-
|
|
77
|
-
```ts
|
|
78
|
-
export default slackChannel({
|
|
79
|
-
envPrefix: "NIGHTLY_TRIAGE",
|
|
80
|
-
engagement: {
|
|
81
|
-
channelPosts: { allow: ["C123"] },
|
|
82
|
-
},
|
|
83
|
-
onChannelPost: async (_ctx, message) => {
|
|
84
|
-
if (!message.markdown.includes("deploy")) {
|
|
85
|
-
return null;
|
|
86
|
-
}
|
|
87
|
-
// `{}` starts a model turn as the sender.
|
|
88
|
-
return {};
|
|
89
|
-
},
|
|
90
|
-
});
|
|
91
|
-
```
|
|
92
|
-
|
|
93
|
-
For mention-only Automations, run `agent-sdk slack create --dir .`
|
|
94
|
-
without `--channel-posts`. The [Slack guide](./slack.md) covers the
|
|
95
|
-
reply experience and app setup.
|
|
56
|
+
The converter keeps the watch allowlist. If a warning says the Automation also
|
|
57
|
+
filtered messages by text, add that check to the channel's `onChannelPost` hook.
|
|
96
58
|
|
|
97
59
|
## Bring a GitHub trigger online
|
|
98
60
|
|
|
99
|
-
The generated GitHub channel keeps
|
|
100
|
-
actions, branches, issue actions, repositories, and simple user
|
|
101
|
-
allowlists. Conditions that depend on dashboard-only context stay
|
|
102
|
-
fail-closed, so the corresponding hook returns `null` until you replace
|
|
103
|
-
them.
|
|
104
|
-
|
|
105
|
-
For example, a converted CI trigger can wake only when the suite fails:
|
|
61
|
+
The generated GitHub channel keeps simple filters such as PR actions, branches, and repositories, and a hook whose condition depended on dashboard-only context returns `null` until you replace it. This converted CI trigger wakes only when the suite fails:
|
|
106
62
|
|
|
107
63
|
```ts
|
|
108
64
|
import {
|
|
@@ -117,70 +73,30 @@ export default githubChannel({
|
|
|
117
73
|
if (suite.conclusion !== "failure") {
|
|
118
74
|
return null;
|
|
119
75
|
}
|
|
120
|
-
// `auth` starts a model turn running as the sender.
|
|
121
76
|
return { auth: defaultGitHubAuth(ctx) };
|
|
122
77
|
},
|
|
123
78
|
});
|
|
124
79
|
```
|
|
125
80
|
|
|
126
|
-
Replay a
|
|
81
|
+
Replay a failing PR before you connect live delivery:
|
|
127
82
|
|
|
128
83
|
```text
|
|
129
|
-
agent-sdk github replay acme/api#42
|
|
130
|
-
--dir . \
|
|
131
|
-
--events '*' \
|
|
132
|
-
--conclusion failure
|
|
84
|
+
agent-sdk github replay acme/api#42 --dir . --events '*' --conclusion failure
|
|
133
85
|
```
|
|
134
86
|
|
|
135
|
-
Cursor-account delivery carries PR and comment events. Push, issue, and
|
|
136
|
-
|
|
137
|
-
|
|
138
|
-
|
|
139
|
-
## Treat warnings as the migration checklist
|
|
140
|
-
|
|
141
|
-
A successful conversion means the project was generated, not that
|
|
142
|
-
every source behavior survived. Read the warnings and setup steps before
|
|
143
|
-
turning on a live trigger:
|
|
144
|
-
|
|
145
|
-
- A setup step names something you must connect or configure.
|
|
146
|
-
|
|
147
|
-
- A `Verify:` step names an external action whose behavior needs a test.
|
|
148
|
-
|
|
149
|
-
- A fail-closed hook intentionally starts no turns until you restore its
|
|
150
|
-
filter.
|
|
151
|
-
|
|
152
|
-
- A `.todo.md` file is ignored by the framework and marks a connection
|
|
153
|
-
you must replace.
|
|
154
|
-
|
|
155
|
-
Keep the source Automation enabled while you work through this list, so
|
|
156
|
-
you still have its behavior as a reference.
|
|
157
|
-
|
|
158
|
-
## Know the conversion boundary
|
|
159
|
-
|
|
160
|
-
The converter can reproduce configuration that has a direct home in an
|
|
161
|
-
Agent SDK project: instructions, the selected model, cron schedules,
|
|
162
|
-
mechanical GitHub filters, Slack mentions and watch allowlists, and
|
|
163
|
-
named Cursor-account MCP connections.
|
|
87
|
+
Cursor-account delivery carries PR and comment events. Push, issue, and CI
|
|
88
|
+
triggers need webhook delivery through a GitHub App or `github forward`, as the
|
|
89
|
+
[GitHub guide](./github.md) explains.
|
|
164
90
|
|
|
165
|
-
|
|
166
|
-
conditions, provider webhook registration and auth, credentials,
|
|
167
|
-
unsupported trigger semantics, and built-in action behavior remain
|
|
168
|
-
warnings, comments, or TODO files for you to resolve. Credentials are
|
|
169
|
-
never exported. Automation memory does not carry over. See
|
|
170
|
-
[RA-893](https://linear.app/xai-linear/issue/RA-893).
|
|
91
|
+
## Work through the checklist
|
|
171
92
|
|
|
172
|
-
|
|
173
|
-
|
|
93
|
+
The converter doesn't carry every behavior over. Before you turn on a live
|
|
94
|
+
trigger, go through the warnings and setup steps it prints:
|
|
174
95
|
|
|
175
|
-
|
|
96
|
+
- A setup step names something you have to connect or configure.
|
|
97
|
+
- A `Verify:` step names a dashboard action with no matching tool. Run the agent
|
|
98
|
+
and confirm the same external write happens.
|
|
99
|
+
- A `.todo.md` file marks a connection you have to replace.
|
|
100
|
+
- Credentials, webhook registration, and Automation memory never carry over.
|
|
176
101
|
|
|
177
|
-
|
|
178
|
-
JSON output, and failures
|
|
179
|
-
- [MCP connections](../reference/connections.md): Cursor-account
|
|
180
|
-
connectors and hosted authorization
|
|
181
|
-
- [GitHub](./github.md): event delivery, hook filters, and replay
|
|
182
|
-
- [Slack](./slack.md): mentions, channel watches, and reply modes
|
|
183
|
-
- [Webhooks](./webhooks.md): auth and filtering for generated provider
|
|
184
|
-
routes
|
|
185
|
-
- [Deployment](../deployment.md): deploy the reviewed project, then
|
|
186
|
-
disable the source Automation before enabling the same live triggers
|
|
102
|
+
Keep the source Automation enabled while you work, and when you [deploy](../deployment.md), disable it before you turn on the same live triggers. The converter doesn't support Cursor-managed Automations.
|