@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/troubleshooting.md
CHANGED
|
@@ -10,147 +10,94 @@ Start with three checks:
|
|
|
10
10
|
1. Run `agent-sdk validate --dir .`.
|
|
11
11
|
2. Confirm the expected agent and connections in
|
|
12
12
|
`agent-sdk info --dir . --json`.
|
|
13
|
-
3. Reproduce once, then
|
|
13
|
+
3. Reproduce the problem once, then read the serve log or the
|
|
14
|
+
[session trace](#read-the-session-trace).
|
|
14
15
|
|
|
15
|
-
|
|
16
|
-
|
|
17
|
-
## Serve or the playground will not work
|
|
18
|
-
|
|
19
|
-
| What you see | What to do |
|
|
20
|
-
| --- | --- |
|
|
21
|
-
| `serve` exits before listening | Fix the errors from `agent-sdk validate --dir .`, then start it again. |
|
|
22
|
-
| Playground is blank or says there are no agents | Start `agent-sdk serve`; built playground assets have no agent data without the server. |
|
|
23
|
-
| Agent-file edits do not appear | Open the URL printed by `serve --dev`, then press Enter in its TTY to reload after file changes. |
|
|
24
|
-
| Sessions exist but the list is empty | The list is scoped to the authenticated principal. Use the same identity that created the session; a `?sessionId=` deep link does not bypass authorization. |
|
|
25
|
-
| The preferred port is busy | Use the next port printed by the CLI, pass `--port <number>`, or pass `--port 0` for any free port. |
|
|
26
|
-
|
|
27
|
-
## A model turn fails
|
|
16
|
+
## Serve or the playground won't work
|
|
28
17
|
|
|
29
18
|
| What you see | What to do |
|
|
30
19
|
| --- | --- |
|
|
31
|
-
|
|
|
32
|
-
|
|
|
33
|
-
|
|
|
34
|
-
| Login succeeds but the model host rejects the key | Point login and model traffic at the same API host; check `CURSOR_API_BASE_URL` and `CURSOR_BACKEND_URL`. |
|
|
35
|
-
| The first turn reports `[resource_exhausted]` | Treat it as a capacity-shaped error. For a GitHub wake, also check the connected GitHub credential and any GitHub `429` rate limit before assuming the model quota is exhausted. |
|
|
20
|
+
| The playground is blank or lists no agents | Start `agent-sdk serve`, because the playground gets its agents from the server. |
|
|
21
|
+
| Agent-file edits don't appear | Open the URL that `serve --dev` prints, and press Enter in its terminal to reload. |
|
|
22
|
+
| Sessions exist but the list is empty | The list shows only your own sessions, so use the identity that created them. |
|
|
36
23
|
|
|
37
|
-
## A turn
|
|
24
|
+
## A turn fails or misbehaves
|
|
38
25
|
|
|
39
26
|
| What you see | What to do |
|
|
40
27
|
| --- | --- |
|
|
41
|
-
|
|
|
42
|
-
|
|
|
43
|
-
|
|
|
44
|
-
|
|
|
28
|
+
| Reads and greps keep failing with `NGHTTP2_FRAME_SIZE_ERROR` | Run the agent under Node 22.13 or newer, never Bun. |
|
|
29
|
+
| `Semantic search has been removed. Use Grep.` | Delete `search` from a custom `fs`, drop `SearchQuery` and `SearchResult`, and remove `SemanticSearch` or `semSearch` from `tools` and `bot/tools/`. |
|
|
30
|
+
| The turn reports a missing API key | Set `CURSOR_API_KEY`, `CURSOR_API_KEY_FILE`, or `CURSOR_SERVICE_ACCOUNT_KEY`, or run `agent-sdk login`. |
|
|
31
|
+
| Login works but the model host rejects the key | Point `CURSOR_API_BASE_URL` and `CURSOR_BACKEND_URL` at the same API host. |
|
|
32
|
+
| The first turn reports `[resource_exhausted]` | The model is usually out of capacity. If a GitHub event started the turn, check for a GitHub `429` rate-limit response first. |
|
|
33
|
+
| Replies quote an ancestor `AGENTS.md` or unrelated repository rules | Set `defineAgent({ local: { cwd } })` so the agent doesn't inherit the parent checkout. `/v1/info` shows the current `local.cwd`. |
|
|
34
|
+
| The model lists IDE meta-tools but never calls named MCP tools | Set `advertiseTools: true` on the local connection. |
|
|
35
|
+
| Server tools, skills, or seed files are missing | Check the discovered project in `/v1/info`, and follow the warning from `validate`. |
|
|
36
|
+
| `validate` and `run` pass but CI type-checking fails | Return JSON-shaped tool results, such as object literals or `type` aliases, instead of `interface` types. |
|
|
45
37
|
|
|
46
38
|
## HTTP returns 401, 403, or 409
|
|
47
39
|
|
|
48
40
|
| What you see | What to do |
|
|
49
41
|
| --- | --- |
|
|
50
|
-
| `401` outside local development | Send the
|
|
51
|
-
| `403` on a stream or follow-up | Use the
|
|
52
|
-
| A custom
|
|
53
|
-
| `409` on a follow-up | Refresh the rotating `continuationToken
|
|
54
|
-
| `409 session_busy` from `call --session` | Wait for the turn, omit `--session`, or mark a read-only tool
|
|
55
|
-
| A custom route fails schema type-checking | Add the required Zod `querySchema` for `GET`, or `bodySchema` for `POST`, `PUT`, and `PATCH`. See [Channels](./reference/channels.md). |
|
|
42
|
+
| `401` outside local development | Send the bearer token, alias token, or channel credential. Default custom routes accept only direct loopback calls. |
|
|
43
|
+
| `403` on a stream or follow-up | Use the identity that created the session. |
|
|
44
|
+
| A custom route fails through a tunnel or LAN | Protect the host with `--bearer-token` or channel auth. Use `--allow-anonymous` only behind a proxy that authenticates every caller. |
|
|
45
|
+
| `409` on a follow-up | Refresh the rotating `continuationToken`. Task sessions don't accept follow-ups. |
|
|
46
|
+
| `409 session_busy` from `call --session` | Wait for the turn, omit `--session`, or mark a read-only tool `effect: "read"` so it can run alongside the turn. |
|
|
56
47
|
|
|
57
48
|
## A hosted deployment fails or looks stale
|
|
58
49
|
|
|
59
50
|
| What you see | What to do |
|
|
60
51
|
| --- | --- |
|
|
61
|
-
| `validate` or `deploy` reports `architecture "v2" requires a named secret` |
|
|
62
|
-
| Local changes
|
|
63
|
-
| The deployment never
|
|
64
|
-
| A secret or egress change has no effect | Confirm the name with `secret list`,
|
|
65
|
-
|
|
|
66
|
-
|
|
|
67
|
-
| `session create` prints a `deliveryId` but no `sessionId` | Expected without `--wait`: the session is created when the turn starts. Pass `--wait`, or find it with `agent-sdk logs --prod --once --slug <slug>`, then follow [Verify a hosted turn](./deployment.md#verify-a-hosted-turn). |
|
|
68
|
-
| `session get <sessionId> --prod` shows a `running` run with no logs | Runs lag behind events, and a high-effort turn can take several minutes. Rerun the command; a growing event count means the turn is still working. |
|
|
69
|
-
| A [Deployed Agents](https://cursor.com/dashboard/deployed-agents) link to a single session doesn't open | Check the session with `agent-sdk session get <sessionId> --prod --slug <slug>`. |
|
|
70
|
-
| `chat`, `tool call`, `skill`, `session get --view cost`, or `mcp` with `--prod` exits with a usage error | Hosted deployments take `--prod` only on `session list`, `session get`, and `logs`; `session create` is always hosted. See [Verify a hosted turn](./deployment.md#verify-a-hosted-turn). |
|
|
71
|
-
| `session create --session <sessionId>` reports the session belongs to another channel | `--session` continues only sessions that `session create` started. Reach Slack, SCM, and custom-route sessions through their own channel. |
|
|
72
|
-
| A custom route returns `202` with no body | Expected on managed hosting. The handler runs after the response, so deliver results from the channel. See [Route responses](./reference/channels.md#route-responses). |
|
|
73
|
-
| External HTTP rejects the alias token | Update the caller with the current token. If the token is lost or exposed, run `agent-sdk deployment rotate-token <slug>` and replace it everywhere. |
|
|
74
|
-
| `deploy`, a hosted session, or an eval run says it is not available with Privacy Mode (Legacy) | Switch to Privacy Mode, or ask a team admin if your team enforces this setting. A refused session does not store the message. See [Privacy Mode](./deployment.md#privacy-mode). |
|
|
75
|
-
| `deploy` says persistent deployments are limited to 1 per team | Another deployment of the team already sets `persistent: true`. Remove the setting from one agent, or delete that deployment. |
|
|
76
|
-
| A schedule does not fire on the hosted deployment | Make sure the deployment is running and its release has the schedule. Deploy again with `@grok/agent-sdk` 0.2.14 or newer. |
|
|
77
|
-
| A request to a custom route gets `429` | The deployment received more requests than its limit. Wait for the time in `Retry-After`, then send the request again. |
|
|
78
|
-
|
|
79
|
-
See [Deployment](./deployment.md) for source, credential, and
|
|
80
|
-
redeployment boundaries.
|
|
52
|
+
| `validate` or `deploy` reports `architecture "v2" requires a named secret` | Replace the literal or getter with a [named secret](./deployment.md#add-egress-and-secrets), and set its value with `agent-sdk secret set <slug> NAME`. |
|
|
53
|
+
| Local changes don't appear after deploy | `deploy` builds the pushed ref, so commit and push your changes, then deploy again. |
|
|
54
|
+
| The deployment never reaches `running` | Run `agent-sdk deployment get <slug>`, and fix the error it reports. |
|
|
55
|
+
| A secret or egress change has no effect | Confirm the name with `secret list`, check that the `hosting` block is on the pushed ref, and redeploy. |
|
|
56
|
+
| A hosted schedule doesn't fire | Check that the deployment is running and that the schedule is in `bot/schedules/` on the deployed ref. |
|
|
57
|
+
| A custom route returns `429` | Wait for the time in `Retry-After`, then send it again. |
|
|
81
58
|
|
|
82
59
|
## GitHub deliveries fail
|
|
83
60
|
|
|
84
61
|
| What you see | What to do |
|
|
85
62
|
| --- | --- |
|
|
86
|
-
| `github forward`
|
|
87
|
-
| `Hook already exists` |
|
|
88
|
-
| Direct
|
|
89
|
-
| You
|
|
63
|
+
| `github forward` gets `401` on every delivery | Clear the token variables so the forwarder uses your `gh` login, as in `GITHUB_TOKEN= GH_TOKEN= agent-sdk github forward`. |
|
|
64
|
+
| `Hook already exists` | Stop the stale forwarder. GitHub allows one per repository. |
|
|
65
|
+
| Direct webhooks are rejected outside `--dev` | Set the same `GITHUB_WEBHOOK_SECRET` on the signer and the server. |
|
|
66
|
+
| You can't create a forwarder | Use `agent-sdk github replay <pr-url>`, which needs only pull access. |
|
|
90
67
|
|
|
91
|
-
|
|
92
|
-
direct webhooks.
|
|
93
|
-
|
|
94
|
-
## Slack does not respond
|
|
68
|
+
## Slack doesn't respond
|
|
95
69
|
|
|
96
70
|
| What you see | What to do |
|
|
97
71
|
| --- | --- |
|
|
98
|
-
| Logs say `channel idle ... missing credentials` | Run `agent-sdk slack create --dir <agent>`, then check the
|
|
99
|
-
| `slack create`
|
|
100
|
-
| The bot ignores ordinary channel posts | Configure `engagement.channelPosts`, create the app with `--channel-posts`, and invite it to
|
|
101
|
-
|
|
102
|
-
See the [Slack guide](./guides/slack.md) for app setup and engagement
|
|
103
|
-
choices.
|
|
72
|
+
| Logs say `channel idle ... missing credentials` | Run `agent-sdk slack create --dir <agent>`, then check the prefix with `agent-sdk slack doctor`. |
|
|
73
|
+
| `slack create` waits for workspace approval | Keep the CLI running and open the **Request approval** link it prints. After an admin approves, select **Retry** in the [Deployed Agents](https://cursor.com/dashboard/deployed-agents) **Add Slack** wizard. |
|
|
74
|
+
| The bot ignores ordinary channel posts | Configure `engagement.channelPosts`, create the app with `--channel-posts`, and invite it to each allowed channel. |
|
|
104
75
|
|
|
105
76
|
## MCP authorization fails
|
|
106
77
|
|
|
107
78
|
| What you see | What to do |
|
|
108
79
|
| --- | --- |
|
|
109
|
-
| `must be defineConnection({ url, oauth: true })` | Add `oauth: true` to the
|
|
110
|
-
| Local auth works but hosted calls return unauthorized |
|
|
111
|
-
| The model invents `mcp_auth` instead of calling the server | Set `advertiseTools: true` for named local tools, or expose a
|
|
112
|
-
|
|
113
|
-
See [Host MCP OAuth](./guides/mcp-oauth.md) for the credential lifecycle.
|
|
80
|
+
| `must be defineConnection({ url, oauth: true })` | Add `oauth: true` to the connection, or fix the filename you passed to `mcp oauth`. |
|
|
81
|
+
| Local auth works but hosted calls return unauthorized | Your local OAuth tokens don't reach a deployment. Use a `cursorAccount: true` connection, as described in [Host MCP OAuth](./guides/mcp-oauth.md#use-an-oauth-server-from-a-hosted-agent). |
|
|
82
|
+
| The model invents `mcp_auth` instead of calling the server | Set `advertiseTools: true` for named local tools, or expose a wrapper through `ctx.host.mcp`. |
|
|
114
83
|
|
|
115
84
|
## Schedules or reminders stall
|
|
116
85
|
|
|
117
86
|
| What you see | What to do |
|
|
118
87
|
| --- | --- |
|
|
119
|
-
| A schedule or reminder never fires under `--dev` |
|
|
120
|
-
| A reminder is disarmed with `handler_lost_on_restart` | Recreate handler-form reminders after restart, or use a prompt-form reminder. |
|
|
121
|
-
|
|
|
122
|
-
|
|
123
|
-
## A credential was exposed
|
|
124
|
-
|
|
125
|
-
| What you see | What to do |
|
|
126
|
-
| --- | --- |
|
|
127
|
-
| A secret value appears in a command, transcript, or shell history | Rotate it at the provider, set it again through hidden input or stdin, and test the feature. |
|
|
128
|
-
| An alias token appears outside its secure destination | Run `agent-sdk deployment rotate-token <slug>`, store the new value outside transcripts, and update every caller. |
|
|
129
|
-
| Someone printed a secret to verify it | Rotate it. Confirm only the name with `agent-sdk secret list <slug>`, then redeploy and exercise the feature. |
|
|
88
|
+
| A schedule or reminder never fires under `--dev` | `--dev` doesn't fire them on its own, so trigger one through its `/v1/dev/schedules/<id>` or `/v1/dev/reminders/<id>` route. |
|
|
89
|
+
| A reminder is disarmed with `handler_lost_on_restart` | Recreate handler-form reminders after a restart, or use a prompt-form reminder. |
|
|
90
|
+
| One schedule fires on several self-hosted processes | Pass `--no-schedules` to every serving process but one. |
|
|
130
91
|
|
|
131
92
|
## Read the session trace
|
|
132
93
|
|
|
133
|
-
|
|
134
|
-
|
|
135
|
-
|
|
136
|
-
|
|
137
|
-
`turn.failed` with `turn interrupted` usually means a follow-up or stop
|
|
138
|
-
ended the turn deliberately. Other failures should have an error event
|
|
139
|
-
near the tool or model boundary that produced them.
|
|
140
|
-
|
|
141
|
-
Use the trace path printed by `agent-sdk run`:
|
|
142
|
-
|
|
143
|
-
```text
|
|
94
|
+
```bash
|
|
95
|
+
agent-sdk session list --prod --slug <slug>
|
|
96
|
+
agent-sdk session get <sessionId> --prod --slug <slug> --view events
|
|
144
97
|
agent-sdk session get --file <trace-path>
|
|
145
98
|
```
|
|
146
99
|
|
|
147
|
-
|
|
148
|
-
|
|
149
|
-
|
|
150
|
-
|
|
151
|
-
## Related
|
|
152
|
-
|
|
153
|
-
- [Deployment](./deployment.md): hosted and self-hosted boundaries
|
|
154
|
-
- [Sessions](./reference/sessions.md): session ownership and event
|
|
155
|
-
vocabulary
|
|
156
|
-
- [CLI reference](./reference/cli.md): command flags and exit behavior
|
|
100
|
+
Find a hosted session with `session list`, then print its events with
|
|
101
|
+
`--view events`. For a local run, pass the trace path from `agent-sdk run`
|
|
102
|
+
to `--file`. Pair each `actions.requested` event with its `action.result`
|
|
103
|
+
to find the call that failed.
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@grok/agent-sdk",
|
|
3
|
-
"version": "0.
|
|
3
|
+
"version": "0.3.0",
|
|
4
4
|
"description": "Build, test, and deploy agents as code on Cursor's agent harness.",
|
|
5
5
|
"license": "SEE LICENSE IN LICENSE.md",
|
|
6
6
|
"repository": {
|
|
@@ -351,7 +351,7 @@
|
|
|
351
351
|
"rehype-highlight": "^7.0.2",
|
|
352
352
|
"remark-gfm": "^4.0.1",
|
|
353
353
|
"typescript": "npm:@typescript/typescript6@^6.0.2",
|
|
354
|
-
"vite": "8.3.
|
|
354
|
+
"vite": "8.3.4",
|
|
355
355
|
"vitepress": "1.6.4",
|
|
356
356
|
"vitepress-plugin-mermaid": "^2.0.17",
|
|
357
357
|
"vitest": "5.0.3",
|
package/skills/deploy/SKILL.md
CHANGED
|
@@ -72,7 +72,6 @@ ends. That model changes code in three places:
|
|
|
72
72
|
| `ctx.host.kv`, `ctx.host.files`, artifacts | Supported, in platform-selected storage |
|
|
73
73
|
| Reminders with `prompt` or a named `handler` | Supported |
|
|
74
74
|
| Secrets and `hosting.egressDomains` | Supported. Same-slug deploys copy v1 secrets. |
|
|
75
|
-
| `persistent: true` and `hosting.image` | Supported, one persistent deployment per team |
|
|
76
75
|
| Local `agent-sdk dev`, `run`, `eval`, and the playground | Supported |
|
|
77
76
|
| `defineStorage` in `agent/storage.ts` | Not supported. Delete the file. |
|
|
78
77
|
| Reminders with inline `run` or a function `until` | Not supported. Use a named handler. |
|
|
@@ -1,9 +0,0 @@
|
|
|
1
|
-
import{_ as t,c as a,o as n,a3 as i}from"./chunks/framework.BNw1pucY.js";const u=JSON.parse('{"title":"Build with a coding agent","description":"Delegate Agent SDK creation, capability work, verification, and measured improvement to a coding agent.","frontmatter":{"title":"Build with a coding agent","description":"Delegate Agent SDK creation, capability work, verification, and measured improvement to a coding agent."},"headers":[],"relativePath":"building-with-agents.md","filePath":"building-with-agents.md"}'),s={name:"building-with-agents.md"};function o(r,e,l,c,d,p){return n(),a("div",null,[...e[0]||(e[0]=[i(`<h1 id="build-with-a-coding-agent" tabindex="-1">Build with a coding agent <a class="header-anchor" href="#build-with-a-coding-agent" aria-label="Permalink to "Build with a coding agent""></a></h1><p>Agent SDK projects live in files and expose structured CLI commands. A coding agent can create the project, exercise its tools, run a real turn, and inspect the result. You approve the plan and side effects while the coding agent owns the edit-and-test loop.</p><p>This page covers a coding agent working inside a checkout. To let a running agent propose changes to its own source, use the separate <a href="./guides/improve.html">self-improvement extension</a>.</p><h2 id="create-an-agent-from-a-goal" tabindex="-1">Create an agent from a goal <a class="header-anchor" href="#create-an-agent-from-a-goal" aria-label="Permalink to "Create an agent from a goal""></a></h2><p>Give the coding agent a purpose and the surfaces people will use. The <code>create-agent</code> skill asks only for missing decisions, shows a file plan, then scaffolds and verifies a small first version.</p><blockquote><p>Use the Agent SDK create-agent skill to build a PR triage agent reachable through GitHub. It should summarize failed checks, post one review comment per pull request, and include one smoke eval.</p></blockquote><p>Ask it to read <a href="./../skills/create-agent/SKILL.html"><code>skills/create-agent/SKILL.md</code></a>. The first version should stay narrow: instructions, one or two tools, the chosen channels or connections, and a smoke eval.</p><h2 id="add-one-capability" tabindex="-1">Add one capability <a class="header-anchor" href="#add-one-capability" aria-label="Permalink to "Add one capability""></a></h2><p>For an existing project, name the user-visible outcome and point the coding agent at the matching procedure. It should inspect the current agent first, make the smallest change, then exercise the new path.</p><p>Examples:</p><blockquote><p>Add Slack mentions and DMs to this agent. Follow the setup-slack skill, keep replies in the source thread, and verify one local mention.</p></blockquote><blockquote><p>Connect the private inventory MCP server with host OAuth. Keep its write tools behind a narrow server-tool wrapper.</p></blockquote><blockquote><p>Add a GitHub ready-for-review trigger and replay PR 42 before posting anything live.</p></blockquote><p>The companion skills live under <code>skills/</code>: <a href="./../skills/setup-slack/SKILL.html">Slack</a>, <a href="./../skills/mcp-auth/SKILL.html">MCP OAuth</a>, and <a href="./../skills/github/SKILL.html">GitHub</a>. Use the capability guide for the reader experience and the skill for the coding procedure.</p><h2 id="verify-tools-before-tuning-the-prompt" tabindex="-1">Verify tools before tuning the prompt <a class="header-anchor" href="#verify-tools-before-tuning-the-prompt" aria-label="Permalink to "Verify tools before tuning the prompt""></a></h2><p>Start with discovery, then call deterministic server tools without a model turn. If a tool returns the wrong evidence, fix the tool before changing instructions.</p><div class="language-text vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">text</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span>agent-sdk validate --dir .</span></span>
|
|
2
|
-
<span class="line"><span>agent-sdk info --dir . --json</span></span>
|
|
3
|
-
<span class="line"><span></span></span>
|
|
4
|
-
<span class="line"><span>agent-sdk tool call inspect_pr --dir . \\</span></span>
|
|
5
|
-
<span class="line"><span> --input '{"prUrl":"https://github.com/acme/checkout/pull/42"}'</span></span></code></pre></div><p><code>validate</code> confirms the discovered project shape. <code>info</code> shows what the serve host will mount. <code>tool call</code> runs the authored tool with schema validation and exposes its real output.</p><h2 id="verify-one-end-to-end-turn" tabindex="-1">Verify one end-to-end turn <a class="header-anchor" href="#verify-one-end-to-end-turn" aria-label="Permalink to "Verify one end-to-end turn""></a></h2><p>Once deterministic inputs are correct, send the same request a user will. The coding agent should check the final answer and tool trajectory before declaring the capability complete.</p><div class="language-text vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">text</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span>agent-sdk run --dir . \\</span></span>
|
|
6
|
-
<span class="line"><span> --message "Is https://github.com/acme/checkout/pull/42 ready to approve?"</span></span></code></pre></div><p><code>run</code> prints the saved trace path. Use that exact path instead of constructing one from the session ID:</p><div class="language-text vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">text</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span>agent-sdk session get --file <trace-path-printed-by-run></span></span>
|
|
7
|
-
<span class="line"><span>agent-sdk eval --dir . --tag smoke</span></span></code></pre></div><p>Finish with the project's TypeScript check. Agent SDK executes TypeScript through type stripping, so a successful turn does not prove the project type-checks.</p><h2 id="hand-off-credential-dependent-checks" tabindex="-1">Hand off credential-dependent checks <a class="header-anchor" href="#hand-off-credential-dependent-checks" aria-label="Permalink to "Hand off credential-dependent checks""></a></h2><p>Project discovery, <code>info</code>, server-tool calls, and serve bring-up do not need a model credential. Model turns and evals resolve <code>CURSOR_API_KEY</code>, <code>CURSOR_API_KEY_FILE</code>, <code>CURSOR_SERVICE_ACCOUNT_KEY</code>, then <code>agent-sdk login</code>.</p><p>When the coding environment has none, it should complete every key-free check and hand you the exact remaining commands:</p><div class="language-text vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">text</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span>agent-sdk run --dir . --message "<fixture prompt>"</span></span>
|
|
8
|
-
<span class="line"><span>agent-sdk serve --dir . --dev</span></span>
|
|
9
|
-
<span class="line"><span>agent-sdk eval --dir . --tag smoke</span></span></code></pre></div><p>Missing access is a handoff boundary, not a reason to skip verification or invent a substitute result.</p><h2 id="improve-a-working-agent" tabindex="-1">Improve a working agent <a class="header-anchor" href="#improve-a-working-agent" aria-label="Permalink to "Improve a working agent""></a></h2><p>After one smoke turn passes, give the coding agent fixed fixtures, one success criterion, and the behavior that must not change. The hillclimb skill measures the current run, changes one lever, remeasures, and adds an eval for every kept improvement.</p><blockquote><p>Hillclimb the PR triage agent on these two saved PRs. Reduce repeated reads without losing either gold finding. Keep the review JSON shape and all existing evals unchanged.</p></blockquote><p>Ask it to read <a href="./../skills/hillclimb/SKILL.html"><code>skills/hillclimb/SKILL.md</code></a>. Keep creation and improvement separate: a smoke turn proves the surface works; a measured climb proves it works better on fixed inputs.</p><h2 id="related" tabindex="-1">Related <a class="header-anchor" href="#related" aria-label="Permalink to "Related""></a></h2><ul><li><a href="./guides/migrate.html">Early-alpha migration</a>: hand an architecture v1 migration to <code>agent-sdk migrate</code> or the bundled coding-agent skill</li><li><a href="./quickstart.html">Quickstart</a>: build the first agent manually</li><li><a href="./evals.html">Evals</a>: protect behavior with regression cases</li><li><a href="./hillclimbing.html">Hillclimbing</a>: run one measured improvement round</li><li><a href="./guides/improve.html">Self-improvement</a>: let a running agent propose a source change through a pull request</li><li><a href="./reference/cli.html">CLI reference</a>: command contracts and flags</li></ul>`,35)])])}const g=t(s,[["render",o]]);export{u as __pageData,g as default};
|
|
@@ -1 +0,0 @@
|
|
|
1
|
-
import{_ as a,c as o,o as t,a3 as i}from"./chunks/framework.BNw1pucY.js";const g=JSON.parse('{"title":"Changelog","description":"Changes for each release of @grok/agent-sdk","frontmatter":{"title":"Changelog","description":"Changes for each release of @grok/agent-sdk"},"headers":[],"relativePath":"changelog.md","filePath":"changelog.md"}'),n={name:"changelog.md"};function c(s,e,d,l,r,h){return t(),o("div",null,[...e[0]||(e[0]=[i('<h1 id="changelog" tabindex="-1">Changelog <a class="header-anchor" href="#changelog" aria-label="Permalink to "Changelog""></a></h1><h2 id="_0-2-29-2026-10-23" tabindex="-1">0.2.29 (2026-10-23) <a class="header-anchor" href="#_0-2-29-2026-10-23" aria-label="Permalink to "0.2.29 (2026-10-23)""></a></h2><h3 id="breaking-changes" tabindex="-1">Breaking changes <a class="header-anchor" href="#breaking-changes" aria-label="Permalink to "Breaking changes""></a></h3><ul><li><code>@grok/agent-sdk/extensions/cursor-grokbot-agents</code> is removed. Remove that import. The package has no replacement.</li></ul><h3 id="behavior-changes" tabindex="-1">Behavior changes <a class="header-anchor" href="#behavior-changes" aria-label="Permalink to "Behavior changes""></a></h3><ul><li>Rename commands and errors to agent-sdk</li></ul><h2 id="_0-2-28-2026-10-21" tabindex="-1">0.2.28 (2026-10-21) <a class="header-anchor" href="#_0-2-28-2026-10-21" aria-label="Permalink to "0.2.28 (2026-10-21)""></a></h2><h3 id="breaking-changes-1" tabindex="-1">Breaking changes <a class="header-anchor" href="#breaking-changes-1" aria-label="Permalink to "Breaking changes""></a></h3><ul><li>Semantic search is removed. Use Grep. Read <a href="./reference/agent-config.html#migrate-off-semantic-search">Migrate off semantic search</a>.</li><li><code>CATCH_DELIVERY_ID_HEADER</code> left <code>@grok/agent-sdk/channels</code>. Remove that import. The npm package has no replacement.</li><li><code>attachRelayMcp</code> was not a published export. Remove that import. The npm package has no replacement.</li><li><code>CursorBackendClient</code> was not a published export. Remove that import. Clone a pull request with <code>@grok/agent-sdk/scm</code>.</li><li><code>postRelaySlackMessage</code> was not a published export. Remove that import. The npm package has no replacement.</li></ul><h3 id="behavior-changes-1" tabindex="-1">Behavior changes <a class="header-anchor" href="#behavior-changes-1" aria-label="Permalink to "Behavior changes""></a></h3><ul><li>With deploy caps on, <code>agent-sdk deploy</code> stops at 20 deployments or 100 deploys in 24 hours. Read <a href="./reference/limits.html">Limits</a>.</li><li><code>agent-sdk deploy</code> refuses <code>persistent: true</code>. A running persistent deployment keeps serving.</li><li>A direct file-tool call respects <code>tools</code>. A path outside the workspace fails.</li><li>With <code>local.sandbox</code> on, file tools refuse a path outside the session workspace.</li><li><code>@grok/agent-sdk</code> depends on <code>@modelcontextprotocol/sdk</code> 1.32.1.</li><li>An MCP server that redirects to a different host or port fails.</li><li><code>agent-sdk init</code> and the templates depend on zod 4.</li></ul><h3 id="new" tabindex="-1">New <a class="header-anchor" href="#new" aria-label="Permalink to "New""></a></h3><ul><li><code>claimIssue</code> is newly public on <code>@grok/agent-sdk/channels/issues</code>.</li><li><code>claimCheckpoint</code> is newly public on <code>@grok/agent-sdk/channels/change-monitors</code>.</li><li><code>@grok/agent-sdk/scm</code> is newly public.</li><li><code>agent-sdk sessions --prod</code> lists sessions on a Cursor-managed deployment.</li><li>Set <code>botScopes</code> in <code>slack-manifest.json</code>, then run <code>agent-sdk slack create</code> again.</li><li>Slack <code>post-file</code> accepts <code>alt_txt</code> and <code>initial_comment</code>.</li><li>Send <code>X-BDK-Session-Key</code> to keep one hosted session for that key.</li><li>A pull request on <code><tenant>.ghe.com</code> keeps its own session.</li><li><code>agent-sdk logs --prod</code> prints process output and a <code>tool <name></code> line. <code>agent-sdk session --prod --events</code> prints the events.</li></ul><h3 id="fixes" tabindex="-1">Fixes <a class="header-anchor" href="#fixes" aria-label="Permalink to "Fixes""></a></h3><ul><li>A failed Slack file upload is reported on that thread.</li></ul><h2 id="_0-2-27-2026-10-16" tabindex="-1">0.2.27 (2026-10-16) <a class="header-anchor" href="#_0-2-27-2026-10-16" aria-label="Permalink to "0.2.27 (2026-10-16)""></a></h2><h3 id="breaking-changes-2" tabindex="-1">Breaking changes <a class="header-anchor" href="#breaking-changes-2" aria-label="Permalink to "Breaking changes""></a></h3><ul><li>Each <code>handle.agents</code> entry is <code>{ slug, url, info }</code>. It no longer has <code>project</code>. Read <code>info</code> instead.</li></ul><h3 id="behavior-changes-2" tabindex="-1">Behavior changes <a class="header-anchor" href="#behavior-changes-2" aria-label="Permalink to "Behavior changes""></a></h3><ul><li><code>@grok/agent-sdk</code> requires <code>@cursor/sdk</code> 1.0.38.</li><li>In project info, a function <code>needsApproval</code> is <code>"dynamic"</code> instead of <code>true</code>.</li><li>Project info has <code>schemaVersion: 1</code> and <code>architecture</code>. Diagnostic paths are relative to the project directory.</li><li><code>handle.project</code> is deprecated. Use <code>handle.agents</code>.</li><li><code>loadAgentProject</code>, <code>loadAgentProjects</code>, and <code>projectInfo</code> are deprecated. Use <code>loadProject</code>.</li><li><code>root</code> on <code>defineAgent</code> is deprecated. Use <code>fs</code>. Setting both is an error.</li></ul><h3 id="new-1" tabindex="-1">New <a class="header-anchor" href="#new-1" aria-label="Permalink to "New""></a></h3><ul><li><code>loadProject(dir)</code> loads a project without serving it. Its <code>info</code> matches <code>GET /v1/info</code>. Pass <code>{ strict: true }</code> to fail on warnings.</li><li><code>serve</code> accepts a directory or a <code>Project</code> from <code>loadProject</code>.</li><li><code>defineAgent({ fs })</code> mounts your filesystem at <code>/</code>. Agent SDK mounts <code>/tmp</code> and <code>/agent/skills</code> over it.</li><li>With <code>fs</code>, the agent's skills are read-only at <code>/agent/skills/<name>/SKILL.md</code>. Set <code>skills: false</code> to keep your own <code>/agent/skills</code>.</li><li>Listing a directory includes the files of mounts nested under it.</li></ul><h3 id="fixes-1" tabindex="-1">Fixes <a class="header-anchor" href="#fixes-1" aria-label="Permalink to "Fixes""></a></h3><ul><li>A local agent can use a model variant that needs Max Mode, such as Grok 4.7 with a 500k context window.</li><li>A session that has been idle for 10 minutes releases its memory. Its next turn resumes the conversation.</li></ul><h2 id="_0-2-26-2026-10-16" tabindex="-1">0.2.26 (2026-10-16) <a class="header-anchor" href="#_0-2-26-2026-10-16" aria-label="Permalink to "0.2.26 (2026-10-16)""></a></h2><h3 id="breaking-changes-3" tabindex="-1">Breaking changes <a class="header-anchor" href="#breaking-changes-3" aria-label="Permalink to "Breaking changes""></a></h3><ul><li><code>serve({ otel })</code> is removed. Delete <code>bot/otel.ts</code>, <code>agent/otel.ts</code>, and <code>bot/instrumentation.ts</code>. Set <code>OTEL_*</code> variables. Read <a href="./guides/opentelemetry.html#migrating-from-serve-otel">Migrating from serve({ otel })</a>.</li></ul><h3 id="behavior-changes-3" tabindex="-1">Behavior changes <a class="header-anchor" href="#behavior-changes-3" aria-label="Permalink to "Behavior changes""></a></h3><ul><li><code>ctx.host.otel</code> is deprecated. It still runs for this release. The first call emits one deprecation warning. Set <code>OTEL_*</code> variables. Record with <code>metrics.getMeter</code> and <code>trace.getTracer</code> from <code>@opentelemetry/api</code>.</li><li>A span started during a turn or a tool gets <code>cursor.conversation.id</code> from the active context when the span does not set it. A metric does not. Call <code>currentConversationId</code> from <code>@grok/agent-sdk/otel</code> and set the attribute yourself. See <a href="./guides/opentelemetry.html#what-you-can-record">OpenTelemetry</a>.</li><li>A turn waits for MCP OAuth only when a person can connect. That is a playground or HTTP chat turn, or a Slack message on a channel that shows Connect. <code>toolApprovals: true</code> shows Connect, and so does <code>buildToolApprovalEvents</code> in <code>events</code>. A schedule, a reminder, a webhook, an eval, or a Slack channel without Connect does not wait. A required connection fails with <code>Reconnect <connection></code>. An optional connection is skipped.</li><li>A turn never waits to authorize an <code>optional</code> connection, also in the playground.</li><li>A turn that waits for MCP OAuth stops after 10 minutes with <code>Reconnect <connection></code>. <code>interrupt()</code> also stops the wait.</li><li><code>agent-sdk deploy</code> rejects a source host other than GitHub, gitlab.com, or Origin.</li><li>A new scaffold imports <code>zod/v4</code>. A zod 3 schema and a zod 4 schema both still parse.</li><li><code>agent-sdk deploy</code> with no terminal lists a connector that needs sign-in as pending.</li></ul><h3 id="new-2" tabindex="-1">New <a class="header-anchor" href="#new-2" aria-label="Permalink to "New""></a></h3><ul><li><code>agent-sdk deploy</code> deploys a bot from a gitlab.com repository.</li><li>When you omit <code>--cursor-events-repo</code>, a GitLab deploy watches that project. A nested group is part of the path.</li><li>When that deploy cannot watch the project, the deploy still finishes. The CLI says the deployment is not watching the project.</li><li>An agentic Slack reply can set <code>cards: { display: "plan" }</code>. Slack shows the <code>post-card</code> steps from that turn as one checklist.</li><li>A <code>title</code> names that checklist. A title has at most 256 characters.</li><li>With no <code>cards</code> option, Slack keeps one card for each step.</li><li><code>send()</code> returns a delivery id. Set <code>deliveryId</code> to choose it. <code>nudge.delivered</code> and <code>message.received</code> include that id.</li></ul><h3 id="fixes-2" tabindex="-1">Fixes <a class="header-anchor" href="#fixes-2" aria-label="Permalink to "Fixes""></a></h3><ul><li>Public helper signatures use portable types. A webhook body is a <code>string</code> or a <code>Uint8Array</code>. An environment map is <code>Record<string, string | undefined></code>.</li><li><code>HostFilesApi.read</code> takes a <code>HostFileTextEncoding</code>. A <code>Buffer</code> and <code>process.env</code> still type-check.</li><li>OpenTelemetry ends each tool span when that tool finishes.</li><li>With no OpenTelemetry endpoint, the process holds at most 2048 spans and 2048 log records.</li><li>A follow-up after a redeploy resumes the same agent. A changed workspace path does not start a new conversation.</li><li>In a Slack Connect channel, sender checks use the workspace where the app is installed.</li><li>A <code>cursorAccount</code> GitHub GraphQL call includes the repository.</li><li>A Slack bot with a lapsed MCP connection replies with a reconnect message.</li></ul><h2 id="_0-2-25-2026-10-14" tabindex="-1">0.2.25 (2026-10-14) <a class="header-anchor" href="#_0-2-25-2026-10-14" aria-label="Permalink to "0.2.25 (2026-10-14)""></a></h2><h3 id="new-3" tabindex="-1">New <a class="header-anchor" href="#new-3" aria-label="Permalink to "New""></a></h3><ul><li><code>agent-sdk validate --json</code> writes one JSON object. Each diagnostic has a code.</li></ul><h3 id="fixes-3" tabindex="-1">Fixes <a class="header-anchor" href="#fixes-3" aria-label="Permalink to "Fixes""></a></h3><ul><li>OpenTelemetry metrics follow <code>OTEL_EXPORTER_OTLP_METRICS_TEMPORALITY_PREFERENCE</code>. The default stays delta.</li><li><code>ctx.host.github.getOctokit()</code> tries again after a failed lookup. A later call can succeed after a GitHub token becomes available.</li></ul><h2 id="_0-2-24-2026-10-13" tabindex="-1">0.2.24 (2026-10-13) <a class="header-anchor" href="#_0-2-24-2026-10-13" aria-label="Permalink to "0.2.24 (2026-10-13)""></a></h2><h3 id="breaking-changes-4" tabindex="-1">Breaking changes <a class="header-anchor" href="#breaking-changes-4" aria-label="Permalink to "Breaking changes""></a></h3><ul><li>Install <code>zod</code> in the project. The peer range is <code>^3.25.0</code> or <code>^4.0.0</code>. A new scaffold imports <code>zod/v3</code>.</li></ul><h3 id="behavior-changes-4" tabindex="-1">Behavior changes <a class="header-anchor" href="#behavior-changes-4" aria-label="Permalink to "Behavior changes""></a></h3><ul><li><code>setContinuationToken(null)</code> releases the continuation key. The next delivery starts a new session.</li><li>Model fallback continues when a blocked model sends progress updates and no assistant text. Those updates are <code>user-message-appended</code>, <code>step-started</code>, and <code>step-completed</code>.</li><li>Read a secret inside a handler, a tool, or a callback. A <code>process.env</code> read while the module is still loading returns an empty value on a Cursor-managed deploy.</li><li>In the Agentic Approver template, a <code>paths</code> glob is relative to the policy directory.</li><li>The package depends on <code>tsx</code> 4.23.15.</li></ul><h3 id="new-4" tabindex="-1">New <a class="header-anchor" href="#new-4" aria-label="Permalink to "New""></a></h3><ul><li><code>hmacSignatureAuth</code> takes an optional <code>separator</code>. One header can then carry several HMAC signatures. PagerDuty uses a comma.</li><li><code>cursorCloudAgents</code> accepts <code>cloud.teamMcpServers</code>. The launch uses the team MCP servers you name.</li></ul><h3 id="fixes-4" tabindex="-1">Fixes <a class="header-anchor" href="#fixes-4" aria-label="Permalink to "Fixes""></a></h3><ul><li>On Cursor-managed hosting, OpenTelemetry reads the endpoint, the headers, and the resource after secrets load. You can remove a workaround that reads <code>OTEL_EXPORTER_OTLP_HEADERS</code> again.</li></ul><h2 id="_0-2-23-2026-10-09" tabindex="-1">0.2.23 (2026-10-09) <a class="header-anchor" href="#_0-2-23-2026-10-09" aria-label="Permalink to "0.2.23 (2026-10-09)""></a></h2><h3 id="behavior-changes-5" tabindex="-1">Behavior changes <a class="header-anchor" href="#behavior-changes-5" aria-label="Permalink to "Behavior changes""></a></h3><ul><li><code>agent-sdk migrate</code> rewrites a URL-secret MCP peer to <code>defineConnection({ agent })</code> in the migration pull request.</li><li><code>agent-sdk migrate</code> prints a checklist after the migration. It says when there is nothing to migrate.</li><li><code>agent-sdk slack create --prod</code> says the deployment redeploys by itself.</li><li><code>agent-sdk deploy</code> on a folder of several agents prints one command per agent. You run each command to deploy that agent.</li></ul><h3 id="new-5" tabindex="-1">New <a class="header-anchor" href="#new-5" aria-label="Permalink to "New""></a></h3><ul><li>A Slack app can opt in to the <code>chat:write.customize</code> scope. A post can then set its username and its icon. An app that leaves the scope off keeps its current scopes.</li></ul>',52)])])}const p=a(n,[["render",c]]);export{g as __pageData,p as default};
|
|
@@ -1 +0,0 @@
|
|
|
1
|
-
import{_ as a,c as o,o as t,a3 as i}from"./chunks/framework.BNw1pucY.js";const g=JSON.parse('{"title":"Changelog","description":"Changes for each release of @grok/agent-sdk","frontmatter":{"title":"Changelog","description":"Changes for each release of @grok/agent-sdk"},"headers":[],"relativePath":"changelog.md","filePath":"changelog.md"}'),n={name:"changelog.md"};function c(s,e,d,l,r,h){return t(),o("div",null,[...e[0]||(e[0]=[i("",52)])])}const p=a(n,[["render",c]]);export{g as __pageData,p as default};
|