@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
|
@@ -5,39 +5,19 @@ description: "Delegate Agent SDK creation, capability work, verification, and me
|
|
|
5
5
|
|
|
6
6
|
# Build with a coding agent
|
|
7
7
|
|
|
8
|
-
Agent SDK
|
|
9
|
-
commands. A coding agent can create the project, exercise its tools, run a
|
|
10
|
-
real turn, and inspect the result. You approve the plan and side effects while
|
|
11
|
-
the coding agent owns the edit-and-test loop.
|
|
8
|
+
A coding agent in your checkout can create an Agent SDK project, call its tools, run a real turn, and check the result from the CLI. You approve the plan and any side effects.
|
|
12
9
|
|
|
13
|
-
|
|
14
|
-
running agent propose changes to its own source, use the separate
|
|
15
|
-
[self-improvement extension](./guides/improve.md).
|
|
10
|
+
To let a running agent change its own source, see the [self-improvement extension](./guides/improve.md).
|
|
16
11
|
|
|
17
12
|
## Create an agent from a goal
|
|
18
13
|
|
|
19
|
-
|
|
20
|
-
`create-agent` skill asks only for missing decisions, shows a file plan,
|
|
21
|
-
then scaffolds and verifies a small first version.
|
|
22
|
-
|
|
23
|
-
> Use the Agent SDK create-agent skill to build a PR triage agent
|
|
24
|
-
> reachable through GitHub. It should summarize failed checks, post one
|
|
25
|
-
> review comment per pull request, and include one smoke eval.
|
|
26
|
-
|
|
27
|
-
Ask it to read
|
|
28
|
-
[`skills/create-agent/SKILL.md`](../skills/create-agent/SKILL.md). The
|
|
29
|
-
first version should stay narrow: instructions, one or two tools, the
|
|
30
|
-
chosen channels or connections, and a smoke eval.
|
|
14
|
+
Tell the coding agent what the agent is for and where people reach it, and ask it to follow the `bdk-create-agent` skill. It asks for any decisions you haven't made, shows a file plan, and scaffolds a small first version with a smoke eval.
|
|
31
15
|
|
|
32
16
|
## Add one capability
|
|
33
17
|
|
|
34
|
-
For an existing project, name the
|
|
35
|
-
coding agent at the matching procedure. It should inspect the current
|
|
36
|
-
agent first, make the smallest change, then exercise the new path.
|
|
37
|
-
|
|
38
|
-
Examples:
|
|
18
|
+
For an existing project, name the outcome and point the coding agent at the matching skill, such as `bdk-setup-slack`, `bdk-mcp-auth`, or `bdk-github`. For example:
|
|
39
19
|
|
|
40
|
-
> Add Slack mentions and DMs to this agent. Follow the setup-slack
|
|
20
|
+
> Add Slack mentions and DMs to this agent. Follow the bdk-setup-slack
|
|
41
21
|
> skill, keep replies in the source thread, and verify one local mention.
|
|
42
22
|
|
|
43
23
|
> Connect the private inventory MCP server with host OAuth. Keep its
|
|
@@ -46,94 +26,21 @@ Examples:
|
|
|
46
26
|
> Add a GitHub ready-for-review trigger and replay PR 42 before posting
|
|
47
27
|
> anything live.
|
|
48
28
|
|
|
49
|
-
The companion skills live under `skills/`: [Slack](../skills/setup-slack/SKILL.md),
|
|
50
|
-
[MCP OAuth](../skills/mcp-auth/SKILL.md), and
|
|
51
|
-
[GitHub](../skills/github/SKILL.md). Use the capability guide for the
|
|
52
|
-
reader experience and the skill for the coding procedure.
|
|
53
|
-
|
|
54
29
|
## Verify tools before tuning the prompt
|
|
55
30
|
|
|
56
|
-
|
|
57
|
-
model turn. If a tool returns the wrong evidence, fix the tool before
|
|
58
|
-
changing instructions.
|
|
31
|
+
Have the coding agent call tools directly and fix any that return the wrong evidence before it touches the instructions. Then it runs one real turn, reads the trace that `run` prints, and runs the smoke evals:
|
|
59
32
|
|
|
60
|
-
```
|
|
33
|
+
```bash
|
|
61
34
|
agent-sdk validate --dir .
|
|
62
35
|
agent-sdk info --dir . --json
|
|
63
|
-
|
|
64
|
-
agent-sdk
|
|
65
|
-
--input '{"prUrl":"https://github.com/acme/checkout/pull/42"}'
|
|
66
|
-
```
|
|
67
|
-
|
|
68
|
-
`validate` confirms the discovered project shape. `info` shows what the
|
|
69
|
-
serve host will mount. `tool call` runs the authored tool with schema
|
|
70
|
-
validation and exposes its real output.
|
|
71
|
-
|
|
72
|
-
## Verify one end-to-end turn
|
|
73
|
-
|
|
74
|
-
Once deterministic inputs are correct, send the same request a user
|
|
75
|
-
will. The coding agent should check the final answer and tool trajectory
|
|
76
|
-
before declaring the capability complete.
|
|
77
|
-
|
|
78
|
-
```text
|
|
79
|
-
agent-sdk run --dir . \
|
|
80
|
-
--message "Is https://github.com/acme/checkout/pull/42 ready to approve?"
|
|
81
|
-
```
|
|
82
|
-
|
|
83
|
-
`run` prints the saved trace path. Use that exact path instead of
|
|
84
|
-
constructing one from the session ID:
|
|
85
|
-
|
|
86
|
-
```text
|
|
36
|
+
agent-sdk tool call inspect_pr --dir . --input '{"prUrl":"https://github.com/acme/checkout/pull/42"}'
|
|
37
|
+
agent-sdk run --dir . --message "Is https://github.com/acme/checkout/pull/42 ready to approve?"
|
|
87
38
|
agent-sdk session get --file <trace-path-printed-by-run>
|
|
88
39
|
agent-sdk eval --dir . --tag smoke
|
|
89
40
|
```
|
|
90
41
|
|
|
91
|
-
Finish with the project's TypeScript check.
|
|
92
|
-
TypeScript through type stripping, so a successful turn does not prove
|
|
93
|
-
the project type-checks.
|
|
94
|
-
|
|
95
|
-
## Hand off credential-dependent checks
|
|
96
|
-
|
|
97
|
-
Project discovery, `info`, server-tool calls, and serve bring-up do not
|
|
98
|
-
need a model credential. Model turns and evals resolve
|
|
99
|
-
`CURSOR_API_KEY`, `CURSOR_API_KEY_FILE`,
|
|
100
|
-
`CURSOR_SERVICE_ACCOUNT_KEY`, then `agent-sdk login`.
|
|
101
|
-
|
|
102
|
-
When the coding environment has none, it should complete every key-free
|
|
103
|
-
check and hand you the exact remaining commands:
|
|
104
|
-
|
|
105
|
-
```text
|
|
106
|
-
agent-sdk run --dir . --message "<fixture prompt>"
|
|
107
|
-
agent-sdk serve --dir . --dev
|
|
108
|
-
agent-sdk eval --dir . --tag smoke
|
|
109
|
-
```
|
|
110
|
-
|
|
111
|
-
Missing access is a handoff boundary, not a reason to skip verification
|
|
112
|
-
or invent a substitute result.
|
|
42
|
+
Finish with the project's TypeScript check, because a passing turn doesn't prove the project type-checks. Only `run` and `eval` need a Cursor credential, and [Environment variables](./reference/cli.md#environment-variables) lists the ways to provide one.
|
|
113
43
|
|
|
114
44
|
## Improve a working agent
|
|
115
45
|
|
|
116
|
-
|
|
117
|
-
success criterion, and the behavior that must not change. The
|
|
118
|
-
hillclimb skill measures the current run, changes one lever, remeasures,
|
|
119
|
-
and adds an eval for every kept improvement.
|
|
120
|
-
|
|
121
|
-
> Hillclimb the PR triage agent on these two saved PRs. Reduce repeated
|
|
122
|
-
> reads without losing either gold finding. Keep the review JSON shape
|
|
123
|
-
> and all existing evals unchanged.
|
|
124
|
-
|
|
125
|
-
Ask it to read
|
|
126
|
-
[`skills/hillclimb/SKILL.md`](../skills/hillclimb/SKILL.md). Keep
|
|
127
|
-
creation and improvement separate: a smoke turn proves the surface
|
|
128
|
-
works; a measured climb proves it works better on fixed inputs.
|
|
129
|
-
|
|
130
|
-
## Related
|
|
131
|
-
|
|
132
|
-
- [Early-alpha migration](./guides/migrate.md): hand an architecture v1
|
|
133
|
-
migration to `agent-sdk migrate` or the bundled coding-agent skill
|
|
134
|
-
- [Quickstart](./quickstart.md): build the first agent manually
|
|
135
|
-
- [Evals](./evals.md): protect behavior with regression cases
|
|
136
|
-
- [Hillclimbing](./hillclimbing.md): run one measured improvement round
|
|
137
|
-
- [Self-improvement](./guides/improve.md): let a running agent propose a
|
|
138
|
-
source change through a pull request
|
|
139
|
-
- [CLI reference](./reference/cli.md): command contracts and flags
|
|
46
|
+
Once a smoke turn passes, follow [Hillclimbing](./hillclimbing.md) to improve the agent against fixed inputs.
|
package/docs/changelog.md
CHANGED
|
@@ -1,165 +1,15 @@
|
|
|
1
1
|
---
|
|
2
2
|
title: Changelog
|
|
3
|
-
description:
|
|
3
|
+
description: Changelog for @grok/agent-sdk releases.
|
|
4
4
|
---
|
|
5
5
|
|
|
6
6
|
# Changelog
|
|
7
7
|
|
|
8
|
-
## 0.
|
|
9
|
-
|
|
10
|
-
### Breaking changes
|
|
11
|
-
|
|
12
|
-
- `@grok/agent-sdk/extensions/cursor-grokbot-agents` is removed. Remove that import. The package has no replacement.
|
|
13
|
-
|
|
14
|
-
### Behavior changes
|
|
15
|
-
|
|
16
|
-
- Rename commands and errors to agent-sdk
|
|
17
|
-
|
|
18
|
-
## 0.2.28 (2026-10-21)
|
|
19
|
-
|
|
20
|
-
### Breaking changes
|
|
21
|
-
|
|
22
|
-
- Semantic search is removed. Use Grep. Read [Migrate off semantic search](reference/agent-config.md#migrate-off-semantic-search).
|
|
23
|
-
- `CATCH_DELIVERY_ID_HEADER` left `@grok/agent-sdk/channels`. Remove that import. The npm package has no replacement.
|
|
24
|
-
- `attachRelayMcp` was not a published export. Remove that import. The npm package has no replacement.
|
|
25
|
-
- `CursorBackendClient` was not a published export. Remove that import. Clone a pull request with `@grok/agent-sdk/scm`.
|
|
26
|
-
- `postRelaySlackMessage` was not a published export. Remove that import. The npm package has no replacement.
|
|
27
|
-
|
|
28
|
-
### Behavior changes
|
|
29
|
-
|
|
30
|
-
- With deploy caps on, `agent-sdk deploy` stops at 20 deployments or 100 deploys in 24 hours. Read [Limits](reference/limits.md).
|
|
31
|
-
- `agent-sdk deploy` refuses `persistent: true`. A running persistent deployment keeps serving.
|
|
32
|
-
- A direct file-tool call respects `tools`. A path outside the workspace fails.
|
|
33
|
-
- With `local.sandbox` on, file tools refuse a path outside the session workspace.
|
|
34
|
-
- `@grok/agent-sdk` depends on `@modelcontextprotocol/sdk` 1.32.1.
|
|
35
|
-
- An MCP server that redirects to a different host or port fails.
|
|
36
|
-
- `agent-sdk init` and the templates depend on zod 4.
|
|
37
|
-
|
|
38
|
-
### New
|
|
39
|
-
|
|
40
|
-
- `claimIssue` is newly public on `@grok/agent-sdk/channels/issues`.
|
|
41
|
-
- `claimCheckpoint` is newly public on `@grok/agent-sdk/channels/change-monitors`.
|
|
42
|
-
- `@grok/agent-sdk/scm` is newly public.
|
|
43
|
-
- `agent-sdk sessions --prod` lists sessions on a Cursor-managed deployment.
|
|
44
|
-
- Set `botScopes` in `slack-manifest.json`, then run `agent-sdk slack create` again.
|
|
45
|
-
- Slack `post-file` accepts `alt_txt` and `initial_comment`.
|
|
46
|
-
- Send `X-BDK-Session-Key` to keep one hosted session for that key.
|
|
47
|
-
- A pull request on `<tenant>.ghe.com` keeps its own session.
|
|
48
|
-
- `agent-sdk logs --prod` prints process output and a `tool <name>` line. `agent-sdk session --prod --events` prints the events.
|
|
49
|
-
|
|
50
|
-
### Fixes
|
|
51
|
-
|
|
52
|
-
- A failed Slack file upload is reported on that thread.
|
|
53
|
-
|
|
54
|
-
## 0.2.27 (2026-10-16)
|
|
55
|
-
|
|
56
|
-
### Breaking changes
|
|
57
|
-
|
|
58
|
-
- Each `handle.agents` entry is `{ slug, url, info }`. It no longer has `project`. Read `info` instead.
|
|
59
|
-
|
|
60
|
-
### Behavior changes
|
|
61
|
-
|
|
62
|
-
- `@grok/agent-sdk` requires `@cursor/sdk` 1.0.38.
|
|
63
|
-
- In project info, a function `needsApproval` is `"dynamic"` instead of `true`.
|
|
64
|
-
- Project info has `schemaVersion: 1` and `architecture`. Diagnostic paths are relative to the project directory.
|
|
65
|
-
- `handle.project` is deprecated. Use `handle.agents`.
|
|
66
|
-
- `loadAgentProject`, `loadAgentProjects`, and `projectInfo` are deprecated. Use `loadProject`.
|
|
67
|
-
- `root` on `defineAgent` is deprecated. Use `fs`. Setting both is an error.
|
|
68
|
-
|
|
69
|
-
### New
|
|
70
|
-
|
|
71
|
-
- `loadProject(dir)` loads a project without serving it. Its `info` matches `GET /v1/info`. Pass `{ strict: true }` to fail on warnings.
|
|
72
|
-
- `serve` accepts a directory or a `Project` from `loadProject`.
|
|
73
|
-
- `defineAgent({ fs })` mounts your filesystem at `/`. Agent SDK mounts `/tmp` and `/agent/skills` over it.
|
|
74
|
-
- With `fs`, the agent's skills are read-only at `/agent/skills/<name>/SKILL.md`. Set `skills: false` to keep your own `/agent/skills`.
|
|
75
|
-
- Listing a directory includes the files of mounts nested under it.
|
|
76
|
-
|
|
77
|
-
### Fixes
|
|
78
|
-
|
|
79
|
-
- A local agent can use a model variant that needs Max Mode, such as Grok 4.7 with a 500k context window.
|
|
80
|
-
- A session that has been idle for 10 minutes releases its memory. Its next turn resumes the conversation.
|
|
81
|
-
|
|
82
|
-
## 0.2.26 (2026-10-16)
|
|
83
|
-
|
|
84
|
-
### Breaking changes
|
|
8
|
+
## 0.3.0 (2026-10-23)
|
|
85
9
|
|
|
86
|
-
-
|
|
10
|
+
- GA Release
|
|
11
|
+
- `persistent` option is removed from `defineAgent`
|
|
87
12
|
|
|
88
|
-
|
|
89
|
-
|
|
90
|
-
- `ctx.host.otel` is deprecated. It still runs for this release. The first call emits one deprecation warning. Set `OTEL_*` variables. Record with `metrics.getMeter` and `trace.getTracer` from `@opentelemetry/api`.
|
|
91
|
-
- A span started during a turn or a tool gets `cursor.conversation.id` from the active context when the span does not set it. A metric does not. Call `currentConversationId` from `@grok/agent-sdk/otel` and set the attribute yourself. See [OpenTelemetry](guides/opentelemetry.md#what-you-can-record).
|
|
92
|
-
- 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. `toolApprovals: true` shows Connect, and so does `buildToolApprovalEvents` in `events`. A schedule, a reminder, a webhook, an eval, or a Slack channel without Connect does not wait. A required connection fails with `Reconnect <connection>`. An optional connection is skipped.
|
|
93
|
-
- A turn never waits to authorize an `optional` connection, also in the playground.
|
|
94
|
-
- A turn that waits for MCP OAuth stops after 10 minutes with `Reconnect <connection>`. `interrupt()` also stops the wait.
|
|
95
|
-
- `agent-sdk deploy` rejects a source host other than GitHub, gitlab.com, or Origin.
|
|
96
|
-
- A new scaffold imports `zod/v4`. A zod 3 schema and a zod 4 schema both still parse.
|
|
97
|
-
- `agent-sdk deploy` with no terminal lists a connector that needs sign-in as pending.
|
|
98
|
-
|
|
99
|
-
### New
|
|
100
|
-
|
|
101
|
-
- `agent-sdk deploy` deploys a bot from a gitlab.com repository.
|
|
102
|
-
- When you omit `--cursor-events-repo`, a GitLab deploy watches that project. A nested group is part of the path.
|
|
103
|
-
- When that deploy cannot watch the project, the deploy still finishes. The CLI says the deployment is not watching the project.
|
|
104
|
-
- An agentic Slack reply can set `cards: { display: "plan" }`. Slack shows the `post-card` steps from that turn as one checklist.
|
|
105
|
-
- A `title` names that checklist. A title has at most 256 characters.
|
|
106
|
-
- With no `cards` option, Slack keeps one card for each step.
|
|
107
|
-
- `send()` returns a delivery id. Set `deliveryId` to choose it. `nudge.delivered` and `message.received` include that id.
|
|
108
|
-
|
|
109
|
-
### Fixes
|
|
110
|
-
|
|
111
|
-
- Public helper signatures use portable types. A webhook body is a `string` or a `Uint8Array`. An environment map is `Record<string, string | undefined>`.
|
|
112
|
-
- `HostFilesApi.read` takes a `HostFileTextEncoding`. A `Buffer` and `process.env` still type-check.
|
|
113
|
-
- OpenTelemetry ends each tool span when that tool finishes.
|
|
114
|
-
- With no OpenTelemetry endpoint, the process holds at most 2048 spans and 2048 log records.
|
|
115
|
-
- A follow-up after a redeploy resumes the same agent. A changed workspace path does not start a new conversation.
|
|
116
|
-
- In a Slack Connect channel, sender checks use the workspace where the app is installed.
|
|
117
|
-
- A `cursorAccount` GitHub GraphQL call includes the repository.
|
|
118
|
-
- A Slack bot with a lapsed MCP connection replies with a reconnect message.
|
|
119
|
-
|
|
120
|
-
## 0.2.25 (2026-10-14)
|
|
121
|
-
|
|
122
|
-
### New
|
|
123
|
-
|
|
124
|
-
- `agent-sdk validate --json` writes one JSON object. Each diagnostic has a code.
|
|
125
|
-
|
|
126
|
-
### Fixes
|
|
127
|
-
|
|
128
|
-
- OpenTelemetry metrics follow `OTEL_EXPORTER_OTLP_METRICS_TEMPORALITY_PREFERENCE`. The default stays delta.
|
|
129
|
-
- `ctx.host.github.getOctokit()` tries again after a failed lookup. A later call can succeed after a GitHub token becomes available.
|
|
130
|
-
|
|
131
|
-
## 0.2.24 (2026-10-13)
|
|
132
|
-
|
|
133
|
-
### Breaking changes
|
|
134
|
-
|
|
135
|
-
- Install `zod` in the project. The peer range is `^3.25.0` or `^4.0.0`. A new scaffold imports `zod/v3`.
|
|
136
|
-
|
|
137
|
-
### Behavior changes
|
|
138
|
-
|
|
139
|
-
- `setContinuationToken(null)` releases the continuation key. The next delivery starts a new session.
|
|
140
|
-
- Model fallback continues when a blocked model sends progress updates and no assistant text. Those updates are `user-message-appended`, `step-started`, and `step-completed`.
|
|
141
|
-
- Read a secret inside a handler, a tool, or a callback. A `process.env` read while the module is still loading returns an empty value on a Cursor-managed deploy.
|
|
142
|
-
- In the Agentic Approver template, a `paths` glob is relative to the policy directory.
|
|
143
|
-
- The package depends on `tsx` 4.23.15.
|
|
144
|
-
|
|
145
|
-
### New
|
|
146
|
-
|
|
147
|
-
- `hmacSignatureAuth` takes an optional `separator`. One header can then carry several HMAC signatures. PagerDuty uses a comma.
|
|
148
|
-
- `cursorCloudAgents` accepts `cloud.teamMcpServers`. The launch uses the team MCP servers you name.
|
|
149
|
-
|
|
150
|
-
### Fixes
|
|
151
|
-
|
|
152
|
-
- On Cursor-managed hosting, OpenTelemetry reads the endpoint, the headers, and the resource after secrets load. You can remove a workaround that reads `OTEL_EXPORTER_OTLP_HEADERS` again.
|
|
153
|
-
|
|
154
|
-
## 0.2.23 (2026-10-09)
|
|
155
|
-
|
|
156
|
-
### Behavior changes
|
|
157
|
-
|
|
158
|
-
- `agent-sdk migrate` rewrites a URL-secret MCP peer to `defineConnection({ agent })` in the migration pull request.
|
|
159
|
-
- `agent-sdk migrate` prints a checklist after the migration. It says when there is nothing to migrate.
|
|
160
|
-
- `agent-sdk slack create --prod` says the deployment redeploys by itself.
|
|
161
|
-
- `agent-sdk deploy` on a folder of several agents prints one command per agent. You run each command to deploy that agent.
|
|
162
|
-
|
|
163
|
-
### New
|
|
13
|
+
## 0.2.29 (2026-10-23)
|
|
164
14
|
|
|
165
|
-
-
|
|
15
|
+
- Bug Fixes
|