@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
package/docs/guides/hooks.md
DELETED
|
@@ -1,121 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
title: "Hooks"
|
|
3
|
-
description: "Observe session events for metrics, alerts, and other side effects without changing the turn."
|
|
4
|
-
---
|
|
5
|
-
|
|
6
|
-
# Hooks
|
|
7
|
-
|
|
8
|
-
Hooks observe session events after they are recorded and run side effects such
|
|
9
|
-
as updating metrics or sending alerts. They never change the turn, prompt, or
|
|
10
|
-
reply. Author them under `bot/hooks/` with `defineHook` from
|
|
11
|
-
`@grok/agent-sdk/hooks`.
|
|
12
|
-
|
|
13
|
-
## Meter token usage
|
|
14
|
-
|
|
15
|
-
With [OpenTelemetry](./opentelemetry.md) configured, this hook adds a live
|
|
16
|
-
turn's reported input and output tokens to your counters. Eval runs stay quiet,
|
|
17
|
-
so the dashboard reflects live traffic instead of the test suite.
|
|
18
|
-
|
|
19
|
-
```ts
|
|
20
|
-
// bot/hooks/usage.ts
|
|
21
|
-
import { metrics } from "@opentelemetry/api";
|
|
22
|
-
import { defineHook } from "@grok/agent-sdk/hooks";
|
|
23
|
-
|
|
24
|
-
const meter = metrics.getMeter("acme");
|
|
25
|
-
const inputTokens = meter.createCounter("acme.tokens.input");
|
|
26
|
-
const outputTokens = meter.createCounter("acme.tokens.output");
|
|
27
|
-
|
|
28
|
-
export default defineHook({
|
|
29
|
-
events: {
|
|
30
|
-
async "turn.completed"(event, ctx) {
|
|
31
|
-
if (ctx.session.purpose === "eval") {
|
|
32
|
-
return;
|
|
33
|
-
}
|
|
34
|
-
if (event.data.usage === undefined) {
|
|
35
|
-
return;
|
|
36
|
-
}
|
|
37
|
-
|
|
38
|
-
inputTokens.add(event.data.usage.inputTokens);
|
|
39
|
-
outputTokens.add(event.data.usage.outputTokens);
|
|
40
|
-
},
|
|
41
|
-
},
|
|
42
|
-
});
|
|
43
|
-
```
|
|
44
|
-
|
|
45
|
-
## Alert on failure
|
|
46
|
-
|
|
47
|
-
Set `PAGER_WEBHOOK_URL` to your pager's webhook. When a live turn fails, this
|
|
48
|
-
hook posts the agent, session, and failure message there. Eval runs and
|
|
49
|
-
interrupted turns stay quiet, so tests and preemptions do not page anyone.
|
|
50
|
-
|
|
51
|
-
```ts
|
|
52
|
-
// bot/hooks/page-on-failure.ts
|
|
53
|
-
import { defineHook } from "@grok/agent-sdk/hooks";
|
|
54
|
-
|
|
55
|
-
export default defineHook({
|
|
56
|
-
events: {
|
|
57
|
-
async "turn.failed"(event, ctx) {
|
|
58
|
-
if (ctx.session.purpose === "eval") {
|
|
59
|
-
return;
|
|
60
|
-
}
|
|
61
|
-
if (event.data.message === "turn interrupted") {
|
|
62
|
-
return;
|
|
63
|
-
}
|
|
64
|
-
|
|
65
|
-
const pagerUrl = process.env.PAGER_WEBHOOK_URL;
|
|
66
|
-
if (pagerUrl === undefined) {
|
|
67
|
-
return;
|
|
68
|
-
}
|
|
69
|
-
|
|
70
|
-
await fetch(pagerUrl, {
|
|
71
|
-
method: "POST",
|
|
72
|
-
headers: { "content-type": "application/json" },
|
|
73
|
-
body: JSON.stringify({
|
|
74
|
-
agent: ctx.agent.name,
|
|
75
|
-
session: ctx.session.id,
|
|
76
|
-
channel: ctx.channel.id,
|
|
77
|
-
message: event.data.message,
|
|
78
|
-
}),
|
|
79
|
-
signal: AbortSignal.timeout(5_000),
|
|
80
|
-
});
|
|
81
|
-
},
|
|
82
|
-
},
|
|
83
|
-
});
|
|
84
|
-
```
|
|
85
|
-
|
|
86
|
-
## Events / when hooks run
|
|
87
|
-
|
|
88
|
-
Use event names from the
|
|
89
|
-
[session event vocabulary](../reference/sessions.md#stream-events). A hook
|
|
90
|
-
receives each matching event after it is recorded, and the model does not wait
|
|
91
|
-
for the handler.
|
|
92
|
-
|
|
93
|
-
Within one session, handlers run one at a time. A slow handler delays later
|
|
94
|
-
handlers for that session, but it does not delay the model or handlers for
|
|
95
|
-
other sessions. Hooks also fire for evals, so check
|
|
96
|
-
`ctx.session.purpose === "eval"` before metering or paging. A restart does not
|
|
97
|
-
replay recorded events into hooks.
|
|
98
|
-
|
|
99
|
-
## When not to use a hook
|
|
100
|
-
|
|
101
|
-
| Want | Use instead |
|
|
102
|
-
| --- | --- |
|
|
103
|
-
| Add context before the model | `instructions.md`, skills, or `workspaceFiles` |
|
|
104
|
-
| Deliver to Slack or a PR | Channel [`events`](../reference/channels.md#events) or packs |
|
|
105
|
-
| Gate behavior | [Evals](../evals.md) |
|
|
106
|
-
|
|
107
|
-
To act on a turn's decision, have the model record it with an authored
|
|
108
|
-
[tool](../reference/tools.md), then act on it from a `turn.completed` hook.
|
|
109
|
-
|
|
110
|
-
[Cursor Agent hooks](https://cursor.com/docs/agent/hooks) in
|
|
111
|
-
`.cursor/hooks.json` are a different product. They can observe, block, or
|
|
112
|
-
modify the local agent loop.
|
|
113
|
-
|
|
114
|
-
## Related
|
|
115
|
-
|
|
116
|
-
- [Hooks reference](../reference/hooks.md): payloads, context, and discovery
|
|
117
|
-
- [Sessions: stream events](../reference/sessions.md#stream-events): event
|
|
118
|
-
vocabulary and payload sequence
|
|
119
|
-
- [OpenTelemetry](./opentelemetry.md): export traces and custom metrics
|
|
120
|
-
- [Channels: events](../reference/channels.md#events): deliver replies back to
|
|
121
|
-
Slack, source control, or another surface
|
package/docs/reference/prompt.md
DELETED
|
@@ -1,52 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
title: "Prompt strings"
|
|
3
|
-
description: "Write indented multi-line strings without carrying source indentation into their values."
|
|
4
|
-
---
|
|
5
|
-
|
|
6
|
-
# Prompt strings
|
|
7
|
-
|
|
8
|
-
The `prompt` template tag keeps multi-line strings aligned with the
|
|
9
|
-
surrounding TypeScript while returning dedented text. Use it for tool
|
|
10
|
-
descriptions, reminder prompts, channel context, and errors. Import it
|
|
11
|
-
from the package root or the dedicated entrypoint:
|
|
12
|
-
|
|
13
|
-
```ts
|
|
14
|
-
import { prompt } from "@grok/agent-sdk";
|
|
15
|
-
// or: import { prompt } from "@grok/agent-sdk/prompt";
|
|
16
|
-
```
|
|
17
|
-
|
|
18
|
-
## Dedented strings
|
|
19
|
-
|
|
20
|
-
`prompt` returns one string. It removes the common leading whitespace
|
|
21
|
-
and one newline immediately after the opening backtick.
|
|
22
|
-
|
|
23
|
-
```ts
|
|
24
|
-
throw new Error(prompt`
|
|
25
|
-
It is outside business hours (Mon-Fri 9am-5pm ET).
|
|
26
|
-
Use request_author_approval, or pass approval=human_request.
|
|
27
|
-
`);
|
|
28
|
-
```
|
|
29
|
-
|
|
30
|
-
Blank lines inside the body are preserved. Relative indentation after the
|
|
31
|
-
common prefix is preserved, so nested lists keep their shape.
|
|
32
|
-
|
|
33
|
-
When interpolating multi-line values (for example a list of services), give
|
|
34
|
-
those lines the same indent as the `prompt` body so dedent stays consistent.
|
|
35
|
-
|
|
36
|
-
## Line arrays
|
|
37
|
-
|
|
38
|
-
`prompt.lines` applies the same rules and returns `string[]`, with one
|
|
39
|
-
entry per line. Use it when an API accepts separate context lines:
|
|
40
|
-
|
|
41
|
-
```ts
|
|
42
|
-
context: prompt.lines`
|
|
43
|
-
Merged PR detected: ${pr.url} by ${author}.
|
|
44
|
-
|
|
45
|
-
Call plan_deploy, then follow its nextStep.
|
|
46
|
-
`
|
|
47
|
-
```
|
|
48
|
-
|
|
49
|
-
## Related
|
|
50
|
-
|
|
51
|
-
- [Tools](./tools.md)
|
|
52
|
-
- [Channels](./channels.md)
|
|
@@ -1,86 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
title: "Review pull requests for exploitable bugs"
|
|
3
|
-
description: "Scaffold the agent, pick repos, replay a PR, and deploy."
|
|
4
|
-
---
|
|
5
|
-
|
|
6
|
-
# Review pull requests for exploitable bugs
|
|
7
|
-
|
|
8
|
-
This agent reads a pull request diff and posts one review comment. It
|
|
9
|
-
reports exploitable bugs: injection, authz bypass, secret leaks, SSRF,
|
|
10
|
-
RCE. Style nits stay out.
|
|
11
|
-
|
|
12
|
-
This template is one model turn: read the diff, then post one comment.
|
|
13
|
-
|
|
14
|
-
## Scaffold
|
|
15
|
-
|
|
16
|
-
```text
|
|
17
|
-
agent-sdk init ./security-reviewer --template security-reviewer \
|
|
18
|
-
--var repos=acme/api
|
|
19
|
-
```
|
|
20
|
-
|
|
21
|
-
`--var repos` must name a repository already connected in Cursor for
|
|
22
|
-
your account. Separate multiple repositories with commas; they must
|
|
23
|
-
share one owner. `init` writes the list to `bot/lib/repos.ts`.
|
|
24
|
-
|
|
25
|
-
## Connect GitHub through Cursor
|
|
26
|
-
|
|
27
|
-
Connect GitHub in Cursor for those repositories (Settings or
|
|
28
|
-
[cursor.com/dashboard](https://cursor.com/dashboard)). Sign the host in:
|
|
29
|
-
|
|
30
|
-
```text
|
|
31
|
-
cd security-reviewer
|
|
32
|
-
agent-sdk login
|
|
33
|
-
```
|
|
34
|
-
|
|
35
|
-
`cursorAccount` pulls SCM events from Cursor and mints a short-lived,
|
|
36
|
-
repo-scoped credential. `ctx.host.github` and child `gh` commands share
|
|
37
|
-
it. See the [GitHub guide](../guides/github.md).
|
|
38
|
-
|
|
39
|
-
## First review
|
|
40
|
-
|
|
41
|
-
```text
|
|
42
|
-
agent-sdk dev
|
|
43
|
-
```
|
|
44
|
-
|
|
45
|
-
`dev` starts the Cursor event relay for the watched repos. To drive a
|
|
46
|
-
known PR without waiting on a live push:
|
|
47
|
-
|
|
48
|
-
```text
|
|
49
|
-
agent-sdk github replay https://github.com/acme/api/pull/12 --dir .
|
|
50
|
-
```
|
|
51
|
-
|
|
52
|
-
`replay` needs pull access. Draft PRs and repos outside
|
|
53
|
-
`bot/lib/repos.ts` are ignored. The channel writes `pr/diff.patch`
|
|
54
|
-
after the wake is acknowledged, then starts a model turn. The model
|
|
55
|
-
calls `post_findings` once.
|
|
56
|
-
|
|
57
|
-
Chat replies stay in the playground. `post_findings` writes the GitHub
|
|
58
|
-
comment.
|
|
59
|
-
|
|
60
|
-
## What to edit
|
|
61
|
-
|
|
62
|
-
- `bot/lib/repos.ts`: watched repos
|
|
63
|
-
- `bot/instructions.md`: what counts as a finding and the comment
|
|
64
|
-
shape
|
|
65
|
-
- `evals/review.eval.ts`: smoke cases
|
|
66
|
-
|
|
67
|
-
## Evals
|
|
68
|
-
|
|
69
|
-
Use the two smoke cases, one XSS fixture and one docs-only change, as a
|
|
70
|
-
local exercise:
|
|
71
|
-
|
|
72
|
-
```text
|
|
73
|
-
agent-sdk eval
|
|
74
|
-
```
|
|
75
|
-
|
|
76
|
-
Eval sessions skip the GitHub write.
|
|
77
|
-
|
|
78
|
-
## Deploy
|
|
79
|
-
|
|
80
|
-
```text
|
|
81
|
-
agent-sdk deploy
|
|
82
|
-
```
|
|
83
|
-
|
|
84
|
-
Run it from the agent's git checkout. The command infers repository,
|
|
85
|
-
ref, path, and slug. The deployment uses the team's Cursor GitHub
|
|
86
|
-
connection for the same watched repos.
|
|
@@ -1,80 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
title: "Review pull requests for structural code quality"
|
|
3
|
-
description: "Scaffold the agent, deploy it, and open a PR."
|
|
4
|
-
---
|
|
5
|
-
|
|
6
|
-
# Review pull requests for structural code quality
|
|
7
|
-
|
|
8
|
-
This agent reads a pull request diff and posts one review comment. It
|
|
9
|
-
reports missing abstractions, deeply nested control flow, feature logic
|
|
10
|
-
leaking into shared paths, and files pushed past 1,000 lines. Style nits
|
|
11
|
-
and behavior disputes stay out.
|
|
12
|
-
|
|
13
|
-
This template is one model turn: read the diff, then post one comment.
|
|
14
|
-
|
|
15
|
-
## Scaffold
|
|
16
|
-
|
|
17
|
-
```text
|
|
18
|
-
agent-sdk init ./thermo-quality-review --template thermo-quality-review
|
|
19
|
-
cd thermo-quality-review
|
|
20
|
-
```
|
|
21
|
-
|
|
22
|
-
## Deploy
|
|
23
|
-
|
|
24
|
-
Sign in once, then deploy from a pushed checkout:
|
|
25
|
-
|
|
26
|
-
```text
|
|
27
|
-
agent-sdk login
|
|
28
|
-
agent-sdk deploy --cursor-events-repo acme/api
|
|
29
|
-
```
|
|
30
|
-
|
|
31
|
-
Repeat `--cursor-events-repo` for each repo. Every repo must share one
|
|
32
|
-
owner. The deployment watches those repos through your team's Cursor
|
|
33
|
-
GitHub connection and reviews each opened PR. No webhook or local
|
|
34
|
-
server.
|
|
35
|
-
|
|
36
|
-
Change repos later without redeploying:
|
|
37
|
-
|
|
38
|
-
```text
|
|
39
|
-
agent-sdk deployment update thermo-quality-review --event-repo acme/api --event-repo acme/web
|
|
40
|
-
```
|
|
41
|
-
|
|
42
|
-
## Try it locally
|
|
43
|
-
|
|
44
|
-
Skip the deploy while you iterate. Start the relay for one repo:
|
|
45
|
-
|
|
46
|
-
```text
|
|
47
|
-
agent-sdk dev --cursor-events --repo acme/api
|
|
48
|
-
```
|
|
49
|
-
|
|
50
|
-
Open a PR, or replay a known one without pushing:
|
|
51
|
-
|
|
52
|
-
```text
|
|
53
|
-
agent-sdk github replay https://github.com/acme/api/pull/12 --dir .
|
|
54
|
-
```
|
|
55
|
-
|
|
56
|
-
`replay` needs pull access. Draft PRs are ignored. The channel writes
|
|
57
|
-
`pr/diff.patch`, then starts a model turn. The model calls
|
|
58
|
-
`post_findings` once. Chat replies stay in the playground.
|
|
59
|
-
`post_findings` writes the GitHub comment.
|
|
60
|
-
|
|
61
|
-
Connect GitHub in Cursor first (Settings or
|
|
62
|
-
[cursor.com/dashboard](https://cursor.com/dashboard)) so the relay and
|
|
63
|
-
API calls use your account. See the [GitHub guide](../guides/github.md).
|
|
64
|
-
|
|
65
|
-
## Evals
|
|
66
|
-
|
|
67
|
-
Use the two smoke cases, one spaghetti-branch fixture and one clean fix,
|
|
68
|
-
as a local exercise. They need no GitHub access.
|
|
69
|
-
|
|
70
|
-
```text
|
|
71
|
-
agent-sdk eval
|
|
72
|
-
```
|
|
73
|
-
|
|
74
|
-
Eval sessions skip the GitHub write.
|
|
75
|
-
|
|
76
|
-
## What to edit
|
|
77
|
-
|
|
78
|
-
- `bot/instructions.md`: what counts as a finding and the comment
|
|
79
|
-
shape
|
|
80
|
-
- `evals/review.eval.ts`: smoke cases
|
|
@@ -1,80 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
title: "Review pull requests for bugs and breakage"
|
|
3
|
-
description: "Scaffold the agent, deploy it, and open a PR."
|
|
4
|
-
---
|
|
5
|
-
|
|
6
|
-
# Review pull requests for bugs and breakage
|
|
7
|
-
|
|
8
|
-
This agent reads a pull request diff and posts one review comment. It
|
|
9
|
-
reports bugs, breaking side effects, developer workflow failures, and
|
|
10
|
-
unintended feature exposure in added or modified code. Style nits stay
|
|
11
|
-
out.
|
|
12
|
-
|
|
13
|
-
This template is one model turn: read the diff, then post one comment.
|
|
14
|
-
|
|
15
|
-
## Scaffold
|
|
16
|
-
|
|
17
|
-
```text
|
|
18
|
-
agent-sdk init ./thermo-review --template thermo-review
|
|
19
|
-
cd thermo-review
|
|
20
|
-
```
|
|
21
|
-
|
|
22
|
-
## Deploy
|
|
23
|
-
|
|
24
|
-
Sign in once, then deploy from a pushed checkout:
|
|
25
|
-
|
|
26
|
-
```text
|
|
27
|
-
agent-sdk login
|
|
28
|
-
agent-sdk deploy --cursor-events-repo acme/api
|
|
29
|
-
```
|
|
30
|
-
|
|
31
|
-
Repeat `--cursor-events-repo` for each repo. Every repo must share one
|
|
32
|
-
owner. The deployment watches those repos through your team's Cursor
|
|
33
|
-
GitHub connection and reviews each opened PR. No webhook or local
|
|
34
|
-
server.
|
|
35
|
-
|
|
36
|
-
Change repos later without redeploying:
|
|
37
|
-
|
|
38
|
-
```text
|
|
39
|
-
agent-sdk deployment update thermo-review --event-repo acme/api --event-repo acme/web
|
|
40
|
-
```
|
|
41
|
-
|
|
42
|
-
## Try it locally
|
|
43
|
-
|
|
44
|
-
Skip the deploy while you iterate. Start the relay for one repo:
|
|
45
|
-
|
|
46
|
-
```text
|
|
47
|
-
agent-sdk dev --cursor-events --repo acme/api
|
|
48
|
-
```
|
|
49
|
-
|
|
50
|
-
Open a PR, or replay a known one without pushing:
|
|
51
|
-
|
|
52
|
-
```text
|
|
53
|
-
agent-sdk github replay https://github.com/acme/api/pull/12 --dir .
|
|
54
|
-
```
|
|
55
|
-
|
|
56
|
-
`replay` needs pull access. Draft PRs are ignored. The channel writes
|
|
57
|
-
`pr/diff.patch`, then starts a model turn. The model calls
|
|
58
|
-
`post_findings` once. Chat replies stay in the playground.
|
|
59
|
-
`post_findings` writes the GitHub comment.
|
|
60
|
-
|
|
61
|
-
Connect GitHub in Cursor first (Settings or
|
|
62
|
-
[cursor.com/dashboard](https://cursor.com/dashboard)) so the relay and
|
|
63
|
-
API calls use your account. See the [GitHub guide](../guides/github.md).
|
|
64
|
-
|
|
65
|
-
## Evals
|
|
66
|
-
|
|
67
|
-
Use the two smoke cases, one auth-bypass fixture and one docs-only
|
|
68
|
-
change, as a local exercise. They need no GitHub access.
|
|
69
|
-
|
|
70
|
-
```text
|
|
71
|
-
agent-sdk eval
|
|
72
|
-
```
|
|
73
|
-
|
|
74
|
-
Eval sessions skip the GitHub write.
|
|
75
|
-
|
|
76
|
-
## What to edit
|
|
77
|
-
|
|
78
|
-
- `bot/instructions.md`: what counts as a finding and the comment
|
|
79
|
-
shape
|
|
80
|
-
- `evals/review.eval.ts`: smoke cases
|
package/docs/templates/triage.md
DELETED
|
@@ -1,106 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
title: "Triage Linear or Jira issues in place"
|
|
3
|
-
description: "Scaffold the agent, point it at an existing ticket, tune the rubric, run evals, and deploy."
|
|
4
|
-
---
|
|
5
|
-
|
|
6
|
-
# Triage Linear or Jira issues in place
|
|
7
|
-
|
|
8
|
-
This agent comments on tickets you already filed. It classifies the
|
|
9
|
-
issue, writes a `Triage:` comment, sets bug priority, and links a
|
|
10
|
-
duplicate when titles match.
|
|
11
|
-
|
|
12
|
-
File the ticket however you already do. This template starts after the
|
|
13
|
-
ticket exists.
|
|
14
|
-
|
|
15
|
-
## Scaffold
|
|
16
|
-
|
|
17
|
-
```text
|
|
18
|
-
agent-sdk init ./triage-agent --template triage-linear
|
|
19
|
-
agent-sdk init ./triage-agent --template triage-jira
|
|
20
|
-
```
|
|
21
|
-
|
|
22
|
-
`agent-sdk init --template triage` selects `triage-linear`.
|
|
23
|
-
|
|
24
|
-
Pick the tracker you use. The agent is the same. The overlay is the
|
|
25
|
-
connection.
|
|
26
|
-
|
|
27
|
-
`init` writes the project, installs dependencies, and puts `agent-sdk`
|
|
28
|
-
on PATH.
|
|
29
|
-
|
|
30
|
-
## Log in
|
|
31
|
-
|
|
32
|
-
Model turns and Cursor MCP use your Cursor account.
|
|
33
|
-
|
|
34
|
-
```text
|
|
35
|
-
cd triage-agent
|
|
36
|
-
agent-sdk login
|
|
37
|
-
```
|
|
38
|
-
|
|
39
|
-
The command opens a browser if you have no stored credential.
|
|
40
|
-
|
|
41
|
-
## Connect the tracker
|
|
42
|
-
|
|
43
|
-
In the Cursor dashboard, open MCP and connect Linear or Jira.
|
|
44
|
-
|
|
45
|
-
The connection stays on the host. The model calls `record_triage`.
|
|
46
|
-
Linear and Jira tools stay off the model's tool list.
|
|
47
|
-
|
|
48
|
-
Linear or Jira MCP must be connected for comments, priority changes,
|
|
49
|
-
and duplicate links; queueing an issue can still classify it through
|
|
50
|
-
`record_triage` without that connection.
|
|
51
|
-
|
|
52
|
-
## First verdict
|
|
53
|
-
|
|
54
|
-
```text
|
|
55
|
-
agent-sdk dev
|
|
56
|
-
```
|
|
57
|
-
|
|
58
|
-
Open the playground. Run `/queue/issue` and paste an existing issue.
|
|
59
|
-
|
|
60
|
-
You can also POST:
|
|
61
|
-
|
|
62
|
-
```bash
|
|
63
|
-
curl -X POST http://127.0.0.1:3000/triage-agent/v1/channels/queue/issue \
|
|
64
|
-
-H 'content-type: application/json' \
|
|
65
|
-
-d '{
|
|
66
|
-
"identifier": "ENG-142",
|
|
67
|
-
"title": "CSV export returns 500",
|
|
68
|
-
"description": "Export has returned 500 since this morning."
|
|
69
|
-
}'
|
|
70
|
-
```
|
|
71
|
-
|
|
72
|
-
For create webhooks, set `LINEAR_WEBHOOK_SECRET` or
|
|
73
|
-
`JIRA_WEBHOOK_SECRET`. Point the provider at the deployed alias under
|
|
74
|
-
`/v1/channels/webhook`. Signed events start or resume triage for that issue.
|
|
75
|
-
|
|
76
|
-
`record_triage` comments on the issue that started the session, not
|
|
77
|
-
whatever identifier the model copies out of the ticket body.
|
|
78
|
-
|
|
79
|
-
## Rubric
|
|
80
|
-
|
|
81
|
-
Edit `bot/skills/triage-rubric.md` for kinds, tie-breakers, and what
|
|
82
|
-
`urgent` means on your team. The next turn reads the file.
|
|
83
|
-
|
|
84
|
-
`bot/instructions.md` is the procedure around the rubric: missing
|
|
85
|
-
details, when to call `record_triage`, how to reply.
|
|
86
|
-
|
|
87
|
-
## Evals
|
|
88
|
-
|
|
89
|
-
Use the three smoke cases, one per kind, as a local exercise after you
|
|
90
|
-
change the rubric.
|
|
91
|
-
|
|
92
|
-
```text
|
|
93
|
-
agent-sdk eval
|
|
94
|
-
```
|
|
95
|
-
|
|
96
|
-
Eval sessions skip tracker writes.
|
|
97
|
-
|
|
98
|
-
## Deploy
|
|
99
|
-
|
|
100
|
-
```text
|
|
101
|
-
agent-sdk deploy
|
|
102
|
-
```
|
|
103
|
-
|
|
104
|
-
Run it from the agent's git checkout. It infers repository, ref, path,
|
|
105
|
-
and slug, builds on Cursor-managed hosting, and prints the URL.
|
|
106
|
-
`agent-sdk deployment list` shows status.
|