@grok/agent-sdk 0.2.28 → 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/AGENTS.md +29 -29
- package/dist/bin/agent-serve.d.ts +2 -2
- package/dist/bin/agent-serve.js +3 -3
- package/dist/channels/pagerduty/api.js +1 -1
- package/dist/channels/pagerduty/pagerduty-channel.d.ts +1 -1
- package/dist/channels/pagerduty/pagerduty-channel.d.ts.map +1 -1
- package/dist/channels/pagerduty/pagerduty-channel.js +1 -1
- package/dist/channels/pagerduty/replay.d.ts +1 -1
- package/dist/channels/pagerduty/replay.js +4 -4
- package/dist/channels/slack/cli-project.js +1 -1
- package/dist/docs/404.html +2 -2
- package/dist/docs/assets/{app.DF9vlcdn.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.D8OuwKO0.js → VPLocalSearchBox.DsnRlUT5.js} +1 -1
- package/dist/docs/assets/chunks/{arc.DCq_TCYV.js → arc.DH8GOhiv.js} +1 -1
- package/dist/docs/assets/chunks/{architectureDiagram-Q4EWVU46.PWRNTPbk.js → architectureDiagram-Q4EWVU46.9m9ObyuE.js} +1 -1
- package/dist/docs/assets/chunks/{baseUniq.BeRPvRUL.js → baseUniq.BXHpx1lE.js} +1 -1
- package/dist/docs/assets/chunks/{blockDiagram-DXYQGD6D.BuRmZVSo.js → blockDiagram-DXYQGD6D.xY3EX59q.js} +1 -1
- package/dist/docs/assets/chunks/{c4Diagram-AHTNJAMY.7DKSMwuv.js → c4Diagram-AHTNJAMY.DnqgMVgc.js} +1 -1
- package/dist/docs/assets/chunks/channel.Cctv0f7X.js +1 -0
- package/dist/docs/assets/chunks/{chunk-4BX2VUAB.7VrO9-9i.js → chunk-4BX2VUAB.BjFxK2A3.js} +1 -1
- package/dist/docs/assets/chunks/{chunk-4TB4RGXK.CHystNE2.js → chunk-4TB4RGXK.BujS_Spt.js} +1 -1
- package/dist/docs/assets/chunks/{chunk-55IACEB6.Nuh9TbTq.js → chunk-55IACEB6.YbTjhdaM.js} +1 -1
- package/dist/docs/assets/chunks/{chunk-EDXVE4YY.CA0EKugm.js → chunk-EDXVE4YY.DnQ8t4GC.js} +1 -1
- package/dist/docs/assets/chunks/{chunk-FMBD7UC4.F9_mp7U8.js → chunk-FMBD7UC4.B67AwAmj.js} +1 -1
- package/dist/docs/assets/chunks/{chunk-OYMX7WX6.CEU4QfE1.js → chunk-OYMX7WX6.DrZIAFOm.js} +1 -1
- package/dist/docs/assets/chunks/{chunk-QZHKN3VN.B8h_x9_i.js → chunk-QZHKN3VN.BLmmydkn.js} +1 -1
- package/dist/docs/assets/chunks/{chunk-YZCP3GAM.Btfb-rKg.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.DKvc96Wa.js → cose-bilkent-S5V4N54A.DMQuNhM5.js} +1 -1
- package/dist/docs/assets/chunks/{dagre-KV5264BT.CMo0cy1b.js → dagre-KV5264BT.CZoGVuUf.js} +1 -1
- package/dist/docs/assets/chunks/{diagram-5BDNPKRD.DDgMOQhB.js → diagram-5BDNPKRD.CLt9uOyL.js} +1 -1
- package/dist/docs/assets/chunks/{diagram-G4DWMVQ6.BdJnoIsU.js → diagram-G4DWMVQ6.DpczEm1G.js} +1 -1
- package/dist/docs/assets/chunks/{diagram-MMDJMWI5.oSvhAZaL.js → diagram-MMDJMWI5.D4r13DvJ.js} +1 -1
- package/dist/docs/assets/chunks/{diagram-TYMM5635.C9zZLIE-.js → diagram-TYMM5635.CYU9eGFu.js} +1 -1
- package/dist/docs/assets/chunks/{erDiagram-SMLLAGMA.BNhVyccy.js → erDiagram-SMLLAGMA.QA9naWEw.js} +1 -1
- package/dist/docs/assets/chunks/{flowDiagram-DWJPFMVM.BEFLLBiU.js → flowDiagram-DWJPFMVM.BbNoVZYd.js} +1 -1
- package/dist/docs/assets/chunks/{ganttDiagram-T4ZO3ILL.BdUzXBgY.js → ganttDiagram-T4ZO3ILL.IHjDoG7r.js} +1 -1
- package/dist/docs/assets/chunks/{gitGraphDiagram-UUTBAWPF.Rd3LlOIJ.js → gitGraphDiagram-UUTBAWPF.B21VMdf5.js} +1 -1
- package/dist/docs/assets/chunks/{graph.DnJC1GpG.js → graph.DgJ4L-8V.js} +1 -1
- package/dist/docs/assets/chunks/{infoDiagram-42DDH7IO.xv0xntDJ.js → infoDiagram-42DDH7IO.CQjrcthc.js} +1 -1
- package/dist/docs/assets/chunks/{ishikawaDiagram-UXIWVN3A.BaGIlviU.js → ishikawaDiagram-UXIWVN3A.D4tPGtVo.js} +1 -1
- package/dist/docs/assets/chunks/{journeyDiagram-VCZTEJTY.Cof_h0fp.js → journeyDiagram-VCZTEJTY.BD3WaNbQ.js} +1 -1
- package/dist/docs/assets/chunks/{kanban-definition-6JOO6SKY.C5GozFuU.js → kanban-definition-6JOO6SKY.Ca0o4Tqz.js} +1 -1
- package/dist/docs/assets/chunks/{layout.zc9UShLc.js → layout.DXXqX4MQ.js} +1 -1
- package/dist/docs/assets/chunks/{linear.BoqrFVcJ.js → linear.5c61gNw4.js} +1 -1
- package/dist/docs/assets/chunks/{min.DwIfr8hG.js → min.B1-NAjHX.js} +1 -1
- package/dist/docs/assets/chunks/{mindmap-definition-QFDTVHPH.Dkq2yTtp.js → mindmap-definition-QFDTVHPH.BELznv3-.js} +1 -1
- package/dist/docs/assets/chunks/{pieDiagram-DEJITSTG.B4CpTmHK.js → pieDiagram-DEJITSTG.qPzO1mq5.js} +1 -1
- package/dist/docs/assets/chunks/{quadrantDiagram-34T5L4WZ.BqXnFC9C.js → quadrantDiagram-34T5L4WZ.CxIvzbjX.js} +1 -1
- package/dist/docs/assets/chunks/{requirementDiagram-MS252O5E.DhIN2z-E.js → requirementDiagram-MS252O5E.CqA0iJx8.js} +1 -1
- package/dist/docs/assets/chunks/{sankeyDiagram-XADWPNL6.BhxUAmg2.js → sankeyDiagram-XADWPNL6.XRTutBnb.js} +1 -1
- package/dist/docs/assets/chunks/{sequenceDiagram-FGHM5R23.BqgU7HU-.js → sequenceDiagram-FGHM5R23.E--7bRLQ.js} +1 -1
- package/dist/docs/assets/chunks/{stateDiagram-FHFEXIEX.B1BCO18N.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.oV7rddEz.js → theme.DMj_7q3B.js} +2 -2
- package/dist/docs/assets/chunks/{timeline-definition-GMOUNBTQ.oRI8UwMC.js → timeline-definition-GMOUNBTQ.C7LgNVAL.js} +1 -1
- package/dist/docs/assets/chunks/{vennDiagram-DHZGUBPP.DmuWrIxN.js → vennDiagram-DHZGUBPP.HUwoZcy_.js} +1 -1
- package/dist/docs/assets/chunks/{wardley-RL74JXVD.CEBjM5ov.js → wardley-RL74JXVD.BxFEFYZS.js} +1 -1
- package/dist/docs/assets/chunks/{wardleyDiagram-NUSXRM2D.m5zsCOF9.js → wardleyDiagram-NUSXRM2D.B2pSo5rB.js} +1 -1
- package/dist/docs/assets/chunks/{xychartDiagram-5P7HB3ND.cPN-587n.js → xychartDiagram-5P7HB3ND.NQhMiOOL.js} +1 -1
- package/dist/docs/assets/deployment.md.BtqJrHhp.js +31 -0
- package/dist/docs/assets/{deployment.md.DDmjAVbg.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.Ccw4pedT.js → guides_jev.md.DGCzkMUN.js} +20 -60
- package/dist/docs/assets/{guides_jev.md.Ccw4pedT.lean.js → guides_jev.md.DGCzkMUN.lean.js} +1 -1
- package/dist/docs/assets/{guides_mcp-oauth.md.ekpWOZCC.js → guides_mcp-oauth.md.C-Sx_IPa.js} +3 -5
- package/dist/docs/assets/{guides_mcp-oauth.md.ekpWOZCC.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.BqiGSYGX.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.DRfaoRCZ.lean.js +1 -0
- package/dist/docs/assets/quickstart.md.r-oE8nkX.js +113 -0
- package/dist/docs/assets/{quickstart.md.DaLk4ZIF.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.CExlH_mR.lean.js → reference_access.md.C5lblfUC.lean.js} +1 -1
- package/dist/docs/assets/reference_agent-config.md.C0Tp_Fk9.js +27 -0
- package/dist/docs/assets/{reference_agent-config.md.11E_xe--.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.DYKjGFi-.lean.js → reference_evals.md.DgfUtfIc.lean.js} +1 -1
- package/dist/docs/assets/{reference_extensions.md.pEVj72Xo.js → reference_extensions.md.DHbW6eOf.js} +6 -8
- package/dist/docs/assets/{reference_extensions.md.pEVj72Xo.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.AGJ3jDzj.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 -145
- package/dist/docs/deployment.html +54 -54
- package/dist/docs/deployment.md +86 -265
- package/dist/docs/evals.html +52 -71
- package/dist/docs/evals.md +33 -127
- 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 +57 -159
- package/dist/docs/guides/mcp-oauth.html +38 -40
- package/dist/docs/guides/mcp-oauth.md +34 -69
- 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 -205
- 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 -62
- package/dist/docs/index.md +49 -82
- package/dist/docs/llms-full.txt +2292 -5830
- package/dist/docs/llms.txt +9 -15
- package/dist/docs/quickstart.html +96 -153
- package/dist/docs/quickstart.md +93 -178
- 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 +93 -176
- package/dist/docs/reference/artifacts.html +38 -39
- package/dist/docs/reference/artifacts.md +38 -62
- package/dist/docs/reference/channels.html +38 -39
- package/dist/docs/reference/channels.md +102 -151
- package/dist/docs/reference/cli.html +68 -84
- package/dist/docs/reference/cli.md +233 -698
- package/dist/docs/reference/connections.html +45 -57
- package/dist/docs/reference/connections.md +83 -164
- package/dist/docs/reference/evals.html +66 -53
- package/dist/docs/reference/evals.md +97 -128
- 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/evals.d.ts +2 -2
- package/dist/extensions/jev/extension.d.ts +12 -2
- package/dist/extensions/jev/extension.d.ts.map +1 -1
- package/dist/extensions/jev/extension.js +4 -0
- package/dist/extensions/jev/lib/evaluate.d.ts +31 -4
- package/dist/extensions/jev/lib/evaluate.d.ts.map +1 -1
- package/dist/extensions/jev/lib/evaluate.js +18 -4
- package/dist/internal/cli/command.d.ts +1 -1
- package/dist/internal/cli/command.js +1 -1
- package/dist/internal/cli/commands/channels.js +6 -6
- package/dist/internal/cli/commands/develop.d.ts.map +1 -1
- package/dist/internal/cli/commands/develop.js +23 -14
- package/dist/internal/cli/commands/hosted.js +4 -4
- package/dist/internal/cli/commands/index.d.ts +1 -1
- package/dist/internal/cli/commands/index.d.ts.map +1 -1
- package/dist/internal/cli/commands/index.js +1 -1
- package/dist/internal/cli/commands/mcp.js +1 -1
- package/dist/internal/cli/commands/project.js +4 -4
- package/dist/internal/cli/commands/scaffold.d.ts.map +1 -1
- package/dist/internal/cli/commands/scaffold.js +9 -6
- package/dist/internal/cli/commands/serve.d.ts +1 -1
- package/dist/internal/cli/commands/serve.js +5 -5
- package/dist/internal/cli/commands/session.d.ts.map +1 -1
- package/dist/internal/cli/commands/session.js +12 -7
- package/dist/internal/cli/dispatch.d.ts +3 -3
- package/dist/internal/cli/dispatch.js +3 -3
- package/dist/internal/cli/errors.d.ts +1 -1
- package/dist/internal/cli/errors.d.ts.map +1 -1
- package/dist/internal/cli/errors.js +1 -1
- package/dist/internal/cli/flags.d.ts +2 -2
- package/dist/internal/cli/flags.d.ts.map +1 -1
- package/dist/internal/cli/flags.js +2 -2
- package/dist/internal/cli/help-command.d.ts +1 -1
- package/dist/internal/cli/help-command.js +2 -2
- package/dist/internal/cli/help.d.ts +7 -7
- package/dist/internal/cli/help.d.ts.map +1 -1
- package/dist/internal/cli/help.js +8 -8
- package/dist/internal/cli-ax.d.ts.map +1 -1
- package/dist/internal/cli-ax.js +3 -0
- package/dist/internal/cli-convert-automation.d.ts +1 -1
- package/dist/internal/cli-convert-automation.js +1 -1
- package/dist/internal/cli-deploy.js +1 -1
- package/dist/internal/cli-docs.js +1 -1
- package/dist/internal/cli-images.js +1 -1
- package/dist/internal/cli-migrate.d.ts +1 -1
- package/dist/internal/cli-migrate.js +1 -1
- package/dist/internal/cli-pagerduty.d.ts +1 -1
- package/dist/internal/cli-pagerduty.js +1 -1
- package/dist/internal/cli-skills.js +1 -1
- package/dist/internal/convert-automation/types.d.ts +1 -1
- package/dist/internal/convert-automation/types.js +1 -1
- package/dist/internal/cursor/credentials.js +1 -1
- package/dist/internal/deploy-client.d.ts +2 -2
- package/dist/internal/deploy-client.d.ts.map +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 +7 -3
- package/dist/internal/init-project.d.ts.map +1 -1
- package/dist/internal/init-project.js +60 -12
- package/dist/internal/init-scaffold.d.ts +2 -1
- package/dist/internal/init-scaffold.d.ts.map +1 -1
- package/dist/internal/init-scaffold.js +20 -7
- package/dist/internal/peer-connections.js +1 -1
- package/dist/internal/reminder-runner.js +1 -1
- package/dist/internal/server.d.ts +1 -1
- package/dist/internal/session-cost.d.ts +4 -4
- package/dist/internal/session-cost.d.ts.map +1 -1
- package/dist/internal/session-cost.js +4 -4
- package/dist/internal/session-engine.d.ts +1 -1
- package/dist/internal/session-engine.js +2 -2
- 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 +9 -22
- package/dist/types.d.ts.map +1 -1
- package/docs/README.md +49 -82
- package/docs/building-with-agents.md +11 -104
- package/docs/changelog.md +6 -146
- package/docs/deployment.md +86 -265
- package/docs/evals.md +34 -128
- 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 +57 -159
- package/docs/guides/mcp-oauth.md +34 -69
- 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 -205
- package/docs/guides/webhooks.md +64 -146
- package/docs/hillclimbing.md +41 -103
- package/docs/quickstart.md +93 -178
- package/docs/reference/access.md +7 -12
- package/docs/reference/agent-config.md +93 -176
- package/docs/reference/artifacts.md +38 -62
- package/docs/reference/channels.md +102 -151
- package/docs/reference/cli.md +233 -698
- package/docs/reference/connections.md +83 -164
- package/docs/reference/evals.md +97 -128
- 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 +3 -9
- package/skills/cli/SKILL.md +15 -15
- package/skills/create-agent/SKILL.md +20 -19
- package/skills/debug/SKILL.md +4 -4
- package/skills/deploy/SKILL.md +2 -2
- package/skills/evals/SKILL.md +8 -8
- package/skills/framework-map/SKILL.md +3 -3
- package/skills/github/SKILL.md +7 -7
- package/skills/hillclimb/SKILL.md +4 -4
- package/skills/mcp-auth/SKILL.md +3 -3
- package/skills/migrate-v2/SKILL.md +40 -41
- package/skills/otel/SKILL.md +2 -2
- package/skills/setup-slack/SKILL.md +8 -8
- package/templates/agentic-owners/README.md +5 -5
- package/templates/agentic-owners/bot/tools/record_review.ts +1 -1
- package/templates/agentic-owners/package.json +1 -1
- package/templates/agents-md/README.md +4 -4
- package/templates/agents-md/package.json +1 -1
- package/templates/code-wiki/README.md +3 -3
- package/templates/code-wiki/package.json +1 -1
- package/templates/demo/README.md +3 -3
- package/templates/demo/package.json +1 -1
- package/templates/pr-autofixer/package.json +1 -1
- package/templates/security-help/README.md +5 -5
- package/templates/security-help/package.json +1 -1
- package/templates/security-reviewer/README.md +3 -3
- package/templates/security-reviewer/package.json +1 -1
- package/templates/thermo-quality-review/README.md +4 -4
- package/templates/thermo-quality-review/package.json +1 -1
- package/templates/thermo-review/README.md +4 -4
- package/templates/thermo-review/package.json +1 -1
- package/templates/triage/README.md +3 -3
- package/templates/triage/overlays/jira/README.md +3 -3
- package/templates/triage/overlays/linear/README.md +3 -3
- package/templates/triage/package.json +1 -1
- package/dist/docs/assets/building-with-agents.md.Bf1yH2tG.js +0 -9
- package/dist/docs/assets/changelog.md.fZ-NNFeJ.js +0 -1
- package/dist/docs/assets/changelog.md.fZ-NNFeJ.lean.js +0 -1
- package/dist/docs/assets/chunks/@localSearchIndexroot.mfzjiOsL.js +0 -1
- package/dist/docs/assets/chunks/channel.goFR5lbe.js +0 -1
- package/dist/docs/assets/chunks/classDiagram-6PBFFD2Q.B2yLtFja.js +0 -1
- package/dist/docs/assets/chunks/classDiagram-v2-HSJHXN6E.B2yLtFja.js +0 -1
- package/dist/docs/assets/chunks/clone.CztV97Wu.js +0 -1
- package/dist/docs/assets/chunks/stateDiagram-v2-QKLJ7IA2.CZlVHdDZ.js +0 -1
- package/dist/docs/assets/deployment.md.DDmjAVbg.js +0 -31
- package/dist/docs/assets/evals.md.OjKb7tNA.js +0 -68
- package/dist/docs/assets/evals.md.OjKb7tNA.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_grokbot-agents.md.D0PpM_Gf.js +0 -15
- package/dist/docs/assets/guides_grokbot-agents.md.D0PpM_Gf.lean.js +0 -1
- 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.BqiGSYGX.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.CVRjO09Y.js +0 -27
- package/dist/docs/assets/index.md.CVRjO09Y.lean.js +0 -1
- package/dist/docs/assets/quickstart.md.DaLk4ZIF.js +0 -170
- package/dist/docs/assets/reference_access.md.CExlH_mR.js +0 -1
- package/dist/docs/assets/reference_agent-config.md.11E_xe--.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.DQ3dCgmk.js +0 -99
- package/dist/docs/assets/reference_cli.md.DQ3dCgmk.lean.js +0 -1
- package/dist/docs/assets/reference_connections.md.BoAotr7_.js +0 -66
- package/dist/docs/assets/reference_evals.md.DYKjGFi-.js +0 -56
- 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.Da1HegjB.js +0 -8
- package/dist/docs/assets/reference_limits.md.Da1HegjB.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.AGJ3jDzj.js +0 -1
- package/dist/docs/guides/grokbot-agents.html +0 -74
- package/dist/docs/guides/grokbot-agents.md +0 -129
- package/dist/docs/guides/hooks.html +0 -113
- package/dist/docs/guides/hooks.md +0 -116
- 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/extensions/cursor-grokbot-agents/extension.d.ts +0 -71
- package/dist/extensions/cursor-grokbot-agents/extension.d.ts.map +0 -1
- package/dist/extensions/cursor-grokbot-agents/extension.js +0 -64
- package/dist/extensions/cursor-grokbot-agents/lib/agents.d.ts +0 -11
- package/dist/extensions/cursor-grokbot-agents/lib/agents.d.ts.map +0 -1
- package/dist/extensions/cursor-grokbot-agents/lib/agents.js +0 -31
- package/dist/extensions/cursor-grokbot-agents/lib/backend.d.ts +0 -56
- package/dist/extensions/cursor-grokbot-agents/lib/backend.d.ts.map +0 -1
- package/dist/extensions/cursor-grokbot-agents/lib/backend.js +0 -139
- package/dist/extensions/cursor-grokbot-agents/lib/contacts.d.ts +0 -28
- package/dist/extensions/cursor-grokbot-agents/lib/contacts.d.ts.map +0 -1
- package/dist/extensions/cursor-grokbot-agents/lib/contacts.js +0 -46
- package/dist/extensions/cursor-grokbot-agents/lib/conversation.d.ts +0 -53
- package/dist/extensions/cursor-grokbot-agents/lib/conversation.d.ts.map +0 -1
- package/dist/extensions/cursor-grokbot-agents/lib/conversation.js +0 -186
- package/dist/extensions/cursor-grokbot-agents/lib/inputs.d.ts +0 -4
- package/dist/extensions/cursor-grokbot-agents/lib/inputs.d.ts.map +0 -1
- package/dist/extensions/cursor-grokbot-agents/lib/inputs.js +0 -15
- package/dist/extensions/cursor-grokbot-agents/lib/lock.d.ts +0 -12
- package/dist/extensions/cursor-grokbot-agents/lib/lock.d.ts.map +0 -1
- package/dist/extensions/cursor-grokbot-agents/lib/lock.js +0 -24
- package/dist/extensions/cursor-grokbot-agents/skills/consult.md +0 -40
- package/dist/extensions/cursor-grokbot-agents/tools/ask.d.ts +0 -4
- package/dist/extensions/cursor-grokbot-agents/tools/ask.d.ts.map +0 -1
- package/dist/extensions/cursor-grokbot-agents/tools/ask.js +0 -26
- package/dist/extensions/cursor-grokbot-agents/tools/check.d.ts +0 -4
- package/dist/extensions/cursor-grokbot-agents/tools/check.d.ts.map +0 -1
- package/dist/extensions/cursor-grokbot-agents/tools/check.js +0 -21
- package/dist/extensions/cursor-grokbot-agents/tools/interrupt.d.ts +0 -4
- package/dist/extensions/cursor-grokbot-agents/tools/interrupt.d.ts.map +0 -1
- package/dist/extensions/cursor-grokbot-agents/tools/interrupt.js +0 -13
- package/dist/extensions/cursor-grokbot-agents/tools/list.d.ts +0 -4
- package/dist/extensions/cursor-grokbot-agents/tools/list.d.ts.map +0 -1
- package/dist/extensions/cursor-grokbot-agents/tools/list.js +0 -22
- package/dist/playground/assets/index-BMpVzZzC.css +0 -1
- package/dist/playground/assets/index-_3zz3yh8.js +0 -62
- package/docs/guides/grokbot-agents.md +0 -134
- 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,147 +5,94 @@ Start with three checks:
|
|
|
5
5
|
1. Run `agent-sdk validate --dir .`.
|
|
6
6
|
2. Confirm the expected agent and connections in
|
|
7
7
|
`agent-sdk info --dir . --json`.
|
|
8
|
-
3. Reproduce once, then
|
|
8
|
+
3. Reproduce the problem once, then read the serve log or the
|
|
9
|
+
[session trace](#read-the-session-trace).
|
|
9
10
|
|
|
10
|
-
|
|
11
|
-
|
|
12
|
-
## Serve or the playground will not work
|
|
13
|
-
|
|
14
|
-
| What you see | What to do |
|
|
15
|
-
| --- | --- |
|
|
16
|
-
| `serve` exits before listening | Fix the errors from `agent-sdk validate --dir .`, then start it again. |
|
|
17
|
-
| Playground is blank or says there are no agents | Start `agent-sdk serve`; built playground assets have no agent data without the server. |
|
|
18
|
-
| Agent-file edits do not appear | Open the URL printed by `serve --dev`, then press Enter in its TTY to reload after file changes. |
|
|
19
|
-
| 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. |
|
|
20
|
-
| The preferred port is busy | Use the next port printed by the CLI, pass `--port <number>`, or pass `--port 0` for any free port. |
|
|
21
|
-
|
|
22
|
-
## A model turn fails
|
|
11
|
+
## Serve or the playground won't work
|
|
23
12
|
|
|
24
13
|
| What you see | What to do |
|
|
25
14
|
| --- | --- |
|
|
26
|
-
|
|
|
27
|
-
|
|
|
28
|
-
|
|
|
29
|
-
| 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`. |
|
|
30
|
-
| 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. |
|
|
15
|
+
| The playground is blank or lists no agents | Start `agent-sdk serve`, because the playground gets its agents from the server. |
|
|
16
|
+
| Agent-file edits don't appear | Open the URL that `serve --dev` prints, and press Enter in its terminal to reload. |
|
|
17
|
+
| Sessions exist but the list is empty | The list shows only your own sessions, so use the identity that created them. |
|
|
31
18
|
|
|
32
|
-
## A turn
|
|
19
|
+
## A turn fails or misbehaves
|
|
33
20
|
|
|
34
21
|
| What you see | What to do |
|
|
35
22
|
| --- | --- |
|
|
36
|
-
|
|
|
37
|
-
|
|
|
38
|
-
|
|
|
39
|
-
|
|
|
23
|
+
| Reads and greps keep failing with `NGHTTP2_FRAME_SIZE_ERROR` | Run the agent under Node 22.13 or newer, never Bun. |
|
|
24
|
+
| `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/`. |
|
|
25
|
+
| 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`. |
|
|
26
|
+
| Login works but the model host rejects the key | Point `CURSOR_API_BASE_URL` and `CURSOR_BACKEND_URL` at the same API host. |
|
|
27
|
+
| 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. |
|
|
28
|
+
| 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`. |
|
|
29
|
+
| The model lists IDE meta-tools but never calls named MCP tools | Set `advertiseTools: true` on the local connection. |
|
|
30
|
+
| Server tools, skills, or seed files are missing | Check the discovered project in `/v1/info`, and follow the warning from `validate`. |
|
|
31
|
+
| `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. |
|
|
40
32
|
|
|
41
33
|
## HTTP returns 401, 403, or 409
|
|
42
34
|
|
|
43
35
|
| What you see | What to do |
|
|
44
36
|
| --- | --- |
|
|
45
|
-
| `401` outside local development | Send the
|
|
46
|
-
| `403` on a stream or follow-up | Use the
|
|
47
|
-
| A custom
|
|
48
|
-
| `409` on a follow-up | Refresh the rotating `continuationToken
|
|
49
|
-
| `409 session_busy` from `call --session` | Wait for the turn, omit `--session`, or mark a read-only tool
|
|
50
|
-
| A custom route fails schema type-checking | Add the required Zod `querySchema` for `GET`, or `bodySchema` for `POST`, `PUT`, and `PATCH`. See [Channels](/docs/reference/channels.md). |
|
|
37
|
+
| `401` outside local development | Send the bearer token, alias token, or channel credential. Default custom routes accept only direct loopback calls. |
|
|
38
|
+
| `403` on a stream or follow-up | Use the identity that created the session. |
|
|
39
|
+
| 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. |
|
|
40
|
+
| `409` on a follow-up | Refresh the rotating `continuationToken`. Task sessions don't accept follow-ups. |
|
|
41
|
+
| `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. |
|
|
51
42
|
|
|
52
43
|
## A hosted deployment fails or looks stale
|
|
53
44
|
|
|
54
45
|
| What you see | What to do |
|
|
55
46
|
| --- | --- |
|
|
56
|
-
| `validate` or `deploy` reports `architecture "v2" requires a named secret` |
|
|
57
|
-
| Local changes
|
|
58
|
-
| The deployment never
|
|
59
|
-
| A secret or egress change has no effect | Confirm the name with `secret list`,
|
|
60
|
-
|
|
|
61
|
-
|
|
|
62
|
-
| `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](/docs/deployment.md#verify-a-hosted-turn). |
|
|
63
|
-
| `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. |
|
|
64
|
-
| A dashboard link to a single session doesn't open | Check the session with `agent-sdk session get <sessionId> --prod --slug <slug>`. |
|
|
65
|
-
| `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](/docs/deployment.md#verify-a-hosted-turn). |
|
|
66
|
-
| `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. |
|
|
67
|
-
| 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](/docs/reference/channels.md#route-responses). |
|
|
68
|
-
| 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. |
|
|
69
|
-
| `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](/docs/deployment.md#privacy-mode). |
|
|
70
|
-
| `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. |
|
|
71
|
-
| 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. |
|
|
72
|
-
| 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. |
|
|
73
|
-
|
|
74
|
-
See [Deployment](/docs/deployment.md) for source, credential, and
|
|
75
|
-
redeployment boundaries.
|
|
47
|
+
| `validate` or `deploy` reports `architecture "v2" requires a named secret` | Replace the literal or getter with a [named secret](/docs/deployment.md#add-egress-and-secrets), and set its value with `agent-sdk secret set <slug> NAME`. |
|
|
48
|
+
| Local changes don't appear after deploy | `deploy` builds the pushed ref, so commit and push your changes, then deploy again. |
|
|
49
|
+
| The deployment never reaches `running` | Run `agent-sdk deployment get <slug>`, and fix the error it reports. |
|
|
50
|
+
| 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. |
|
|
51
|
+
| A hosted schedule doesn't fire | Check that the deployment is running and that the schedule is in `bot/schedules/` on the deployed ref. |
|
|
52
|
+
| A custom route returns `429` | Wait for the time in `Retry-After`, then send it again. |
|
|
76
53
|
|
|
77
54
|
## GitHub deliveries fail
|
|
78
55
|
|
|
79
56
|
| What you see | What to do |
|
|
80
57
|
| --- | --- |
|
|
81
|
-
| `github forward`
|
|
82
|
-
| `Hook already exists` |
|
|
83
|
-
| Direct
|
|
84
|
-
| You
|
|
58
|
+
| `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`. |
|
|
59
|
+
| `Hook already exists` | Stop the stale forwarder. GitHub allows one per repository. |
|
|
60
|
+
| Direct webhooks are rejected outside `--dev` | Set the same `GITHUB_WEBHOOK_SECRET` on the signer and the server. |
|
|
61
|
+
| You can't create a forwarder | Use `agent-sdk github replay <pr-url>`, which needs only pull access. |
|
|
85
62
|
|
|
86
|
-
|
|
87
|
-
direct webhooks.
|
|
88
|
-
|
|
89
|
-
## Slack does not respond
|
|
63
|
+
## Slack doesn't respond
|
|
90
64
|
|
|
91
65
|
| What you see | What to do |
|
|
92
66
|
| --- | --- |
|
|
93
|
-
| Logs say `channel idle ... missing credentials` | Run `agent-sdk slack create --dir <agent>`, then check the
|
|
94
|
-
| `slack create`
|
|
95
|
-
| The bot ignores ordinary channel posts | Configure `engagement.channelPosts`, create the app with `--channel-posts`, and invite it to
|
|
96
|
-
|
|
97
|
-
See the [Slack guide](/docs/guides/slack.md) for app setup and engagement
|
|
98
|
-
choices.
|
|
67
|
+
| Logs say `channel idle ... missing credentials` | Run `agent-sdk slack create --dir <agent>`, then check the prefix with `agent-sdk slack doctor`. |
|
|
68
|
+
| `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. |
|
|
69
|
+
| The bot ignores ordinary channel posts | Configure `engagement.channelPosts`, create the app with `--channel-posts`, and invite it to each allowed channel. |
|
|
99
70
|
|
|
100
71
|
## MCP authorization fails
|
|
101
72
|
|
|
102
73
|
| What you see | What to do |
|
|
103
74
|
| --- | --- |
|
|
104
|
-
| `must be defineConnection({ url, oauth: true })` | Add `oauth: true` to the
|
|
105
|
-
| Local auth works but hosted calls return unauthorized |
|
|
106
|
-
| The model invents `mcp_auth` instead of calling the server | Set `advertiseTools: true` for named local tools, or expose a
|
|
107
|
-
|
|
108
|
-
See [Host MCP OAuth](/docs/guides/mcp-oauth.md) for the credential lifecycle.
|
|
75
|
+
| `must be defineConnection({ url, oauth: true })` | Add `oauth: true` to the connection, or fix the filename you passed to `mcp oauth`. |
|
|
76
|
+
| 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](/docs/guides/mcp-oauth.md#use-an-oauth-server-from-a-hosted-agent). |
|
|
77
|
+
| 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`. |
|
|
109
78
|
|
|
110
79
|
## Schedules or reminders stall
|
|
111
80
|
|
|
112
81
|
| What you see | What to do |
|
|
113
82
|
| --- | --- |
|
|
114
|
-
| A schedule or reminder never fires under `--dev` |
|
|
115
|
-
| A reminder is disarmed with `handler_lost_on_restart` | Recreate handler-form reminders after restart, or use a prompt-form reminder. |
|
|
116
|
-
|
|
|
117
|
-
|
|
118
|
-
## A credential was exposed
|
|
119
|
-
|
|
120
|
-
| What you see | What to do |
|
|
121
|
-
| --- | --- |
|
|
122
|
-
| 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. |
|
|
123
|
-
| 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. |
|
|
124
|
-
| 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. |
|
|
83
|
+
| 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. |
|
|
84
|
+
| A reminder is disarmed with `handler_lost_on_restart` | Recreate handler-form reminders after a restart, or use a prompt-form reminder. |
|
|
85
|
+
| One schedule fires on several self-hosted processes | Pass `--no-schedules` to every serving process but one. |
|
|
125
86
|
|
|
126
87
|
## Read the session trace
|
|
127
88
|
|
|
128
|
-
|
|
129
|
-
|
|
130
|
-
|
|
131
|
-
|
|
132
|
-
`turn.failed` with `turn interrupted` usually means a follow-up or stop
|
|
133
|
-
ended the turn deliberately. Other failures should have an error event
|
|
134
|
-
near the tool or model boundary that produced them.
|
|
135
|
-
|
|
136
|
-
Use the trace path printed by `agent-sdk run`:
|
|
137
|
-
|
|
138
|
-
```text
|
|
89
|
+
```bash
|
|
90
|
+
agent-sdk session list --prod --slug <slug>
|
|
91
|
+
agent-sdk session get <sessionId> --prod --slug <slug> --view events
|
|
139
92
|
agent-sdk session get --file <trace-path>
|
|
140
93
|
```
|
|
141
94
|
|
|
142
|
-
|
|
143
|
-
|
|
144
|
-
|
|
145
|
-
|
|
146
|
-
## Related
|
|
147
|
-
|
|
148
|
-
- [Deployment](/docs/deployment.md): hosted and self-hosted boundaries
|
|
149
|
-
- [Sessions](/docs/reference/sessions.md): session ownership and event
|
|
150
|
-
vocabulary
|
|
151
|
-
- [CLI reference](/docs/reference/cli.md): command flags and exit behavior
|
|
95
|
+
Find a hosted session with `session list`, then print its events with
|
|
96
|
+
`--view events`. For a local run, pass the trace path from `agent-sdk run`
|
|
97
|
+
to `--file`. Pair each `actions.requested` event with its `action.result`
|
|
98
|
+
to find the call that failed.
|
package/dist/evals.d.ts
CHANGED
|
@@ -377,7 +377,7 @@ export interface HostStartEvalRunInput {
|
|
|
377
377
|
}
|
|
378
378
|
/**
|
|
379
379
|
* Host-facing playground eval batches — the same surface as
|
|
380
|
-
* `/v1/dev/evals*` and `
|
|
380
|
+
* `/v1/dev/evals*` and `agent-sdk eval --url`. Attached to
|
|
381
381
|
* {@link import("./types.js").HostContext.evals} by `serve`.
|
|
382
382
|
*/
|
|
383
383
|
export interface HostEvalsApi {
|
|
@@ -417,7 +417,7 @@ export interface EvalConfigFile {
|
|
|
417
417
|
* Optional. Max batches kept in the **playground / `/v1/dev/evals*`**
|
|
418
418
|
* history window (in-memory, and pruned from the `defineStorage` evals
|
|
419
419
|
* table when one is configured). Includes server-side batches started by
|
|
420
|
-
* `
|
|
420
|
+
* `agent-sdk eval --url` (not the default local harness).
|
|
421
421
|
*
|
|
422
422
|
* Default {@link EVAL_DEFAULT_MAX_PLAYGROUND_RUNS}; hard-capped at
|
|
423
423
|
* {@link EVAL_MAX_PLAYGROUND_RUNS}. Newest batches win.
|
|
@@ -19,9 +19,15 @@
|
|
|
19
19
|
*
|
|
20
20
|
* Hosted deploys allowlist `api.typesafe.ai` for the mounting agent and
|
|
21
21
|
* expect a `TYPESAFE_API_KEY` secret.
|
|
22
|
+
*
|
|
23
|
+
* Experimental: the exports and behavior of this module can change in
|
|
24
|
+
* any release, without a deprecation period.
|
|
22
25
|
*/
|
|
23
26
|
import type { Extension } from "../../types.js";
|
|
24
|
-
/**
|
|
27
|
+
/**
|
|
28
|
+
* Mount options; every field is optional.
|
|
29
|
+
* @experimental
|
|
30
|
+
*/
|
|
25
31
|
export interface JevOptions {
|
|
26
32
|
/** TypeSafe API key. Defaults to `TYPESAFE_API_KEY`. */
|
|
27
33
|
apiKey?: string;
|
|
@@ -32,13 +38,17 @@ export interface JevOptions {
|
|
|
32
38
|
/** Mount the `questions` and `gated-write` skills. Defaults to true. */
|
|
33
39
|
skills?: boolean;
|
|
34
40
|
}
|
|
35
|
-
/**
|
|
41
|
+
/**
|
|
42
|
+
* {@link JevOptions} with defaults applied.
|
|
43
|
+
* @experimental
|
|
44
|
+
*/
|
|
36
45
|
export interface JevConfig {
|
|
37
46
|
apiKey?: string;
|
|
38
47
|
model: string;
|
|
39
48
|
harnessTools: boolean;
|
|
40
49
|
skills: boolean;
|
|
41
50
|
}
|
|
51
|
+
/** @experimental */
|
|
42
52
|
declare const jev: Extension<JevConfig, JevOptions | undefined>;
|
|
43
53
|
export type { AnswersFor, BooleanAnswer, BooleanQuestion, ChoiceAnswer, ChoiceQuestion, EvaluateArgs, EvaluateResult, EvaluationAnswer, EvaluationQuestion, EvaluationState, QuestionMap, ScoreAnswer, ScoreQuestion, } from "./lib/evaluate.js";
|
|
44
54
|
export { above, DEFAULT_EVALUATION_MODEL, DEFAULT_HUMAN_THRESHOLD, decide, evaluate, needsHuman, } from "./lib/evaluate.js";
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"extension.d.ts","sourceRoot":"","sources":["../../../src/extensions/jev/extension.ts"],"names":[],"mappings":"AAAA
|
|
1
|
+
{"version":3,"file":"extension.d.ts","sourceRoot":"","sources":["../../../src/extensions/jev/extension.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAIH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAOhD;;;GAGG;AACH,MAAM,WAAW,UAAU;IACzB,wDAAwD;IACxD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,mDAAmD;IACnD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,sEAAsE;IACtE,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,wEAAwE;IACxE,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED;;;GAGG;AACH,MAAM,WAAW,SAAS;IACxB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,EAAE,OAAO,CAAC;IACtB,MAAM,EAAE,OAAO,CAAC;CACjB;AAiBD,oBAAoB;AACpB,QAAA,MAAM,GAAG,EAAE,SAAS,CAAC,SAAS,EAAE,UAAU,GAAG,SAAS,CAcpD,CAAC;AAEH,YAAY,EACV,UAAU,EACV,aAAa,EACb,eAAe,EACf,YAAY,EACZ,cAAc,EACd,YAAY,EACZ,cAAc,EACd,gBAAgB,EAChB,kBAAkB,EAClB,eAAe,EACf,WAAW,EACX,WAAW,EACX,aAAa,GACd,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,KAAK,EACL,wBAAwB,EACxB,uBAAuB,EACvB,MAAM,EACN,QAAQ,EACR,UAAU,GACX,MAAM,mBAAmB,CAAC;eAEZ,GAAG"}
|
|
@@ -19,6 +19,9 @@
|
|
|
19
19
|
*
|
|
20
20
|
* Hosted deploys allowlist `api.typesafe.ai` for the mounting agent and
|
|
21
21
|
* expect a `TYPESAFE_API_KEY` secret.
|
|
22
|
+
*
|
|
23
|
+
* Experimental: the exports and behavior of this module can change in
|
|
24
|
+
* any release, without a deprecation period.
|
|
22
25
|
*/
|
|
23
26
|
import * as z from "zod/v4";
|
|
24
27
|
import { defineExtension } from "../../extensions.js";
|
|
@@ -37,6 +40,7 @@ const config = z
|
|
|
37
40
|
harnessTools: options.harnessTools,
|
|
38
41
|
skills: options.skills,
|
|
39
42
|
}));
|
|
43
|
+
/** @experimental */
|
|
40
44
|
const jev = defineExtension({
|
|
41
45
|
root: import.meta.dirname,
|
|
42
46
|
description: "Ask Jev for typed choice, score, and boolean answers.",
|
|
@@ -36,15 +36,23 @@
|
|
|
36
36
|
* Auth is `TYPESAFE_API_KEY`. `model` is a TypeSafe id (`jev-latest` by
|
|
37
37
|
* default).
|
|
38
38
|
*/
|
|
39
|
-
/**
|
|
39
|
+
/**
|
|
40
|
+
* TypeSafe model used when {@link EvaluateArgs.model} is omitted.
|
|
41
|
+
* @experimental
|
|
42
|
+
*/
|
|
40
43
|
export declare const DEFAULT_EVALUATION_MODEL = "jev-latest";
|
|
41
|
-
/**
|
|
44
|
+
/**
|
|
45
|
+
* Default bar for {@link needsHuman} when the caller does not pass one.
|
|
46
|
+
* @experimental
|
|
47
|
+
*/
|
|
42
48
|
export declare const DEFAULT_HUMAN_THRESHOLD = 0.7;
|
|
43
49
|
/** Host behind the default base URL. */
|
|
44
50
|
export declare const DEFAULT_TYPESAFE_HOST: string;
|
|
45
51
|
/** Environment variable holding the TypeSafe key when a call passes no `apiKey`. */
|
|
46
52
|
export declare const TYPESAFE_API_KEY_ENV = "TYPESAFE_API_KEY";
|
|
53
|
+
/** @experimental */
|
|
47
54
|
export type EvaluationState = string | Record<string, unknown> | readonly unknown[];
|
|
55
|
+
/** @experimental */
|
|
48
56
|
export type BooleanQuestion = {
|
|
49
57
|
type: "boolean";
|
|
50
58
|
instructions: string;
|
|
@@ -52,22 +60,28 @@ export type BooleanQuestion = {
|
|
|
52
60
|
export type ChoiceCriterion = string | readonly string[] | {
|
|
53
61
|
includes: readonly string[];
|
|
54
62
|
} | null;
|
|
63
|
+
/** @experimental */
|
|
55
64
|
export type ChoiceQuestion<C extends Record<string, ChoiceCriterion> = Record<string, ChoiceCriterion>> = {
|
|
56
65
|
type: "choice";
|
|
57
66
|
instructions: string;
|
|
58
67
|
criteria: C;
|
|
59
68
|
};
|
|
69
|
+
/** @experimental */
|
|
60
70
|
export type ScoreQuestion = {
|
|
61
71
|
type: "score";
|
|
62
72
|
instructions: string;
|
|
63
73
|
criteria: readonly string[];
|
|
64
74
|
};
|
|
75
|
+
/** @experimental */
|
|
65
76
|
export type EvaluationQuestion = BooleanQuestion | ChoiceQuestion | ScoreQuestion;
|
|
77
|
+
/** @experimental */
|
|
66
78
|
export type QuestionMap = Record<string, EvaluationQuestion>;
|
|
79
|
+
/** @experimental */
|
|
67
80
|
export type BooleanAnswer = {
|
|
68
81
|
type: "boolean";
|
|
69
82
|
probability: number;
|
|
70
83
|
};
|
|
84
|
+
/** @experimental */
|
|
71
85
|
export type ChoiceAnswer<C extends Record<string, unknown> = Record<string, unknown>> = {
|
|
72
86
|
type: "choice";
|
|
73
87
|
choice: keyof C & string;
|
|
@@ -75,19 +89,24 @@ export type ChoiceAnswer<C extends Record<string, unknown> = Record<string, unkn
|
|
|
75
89
|
[K in keyof C]: number;
|
|
76
90
|
};
|
|
77
91
|
};
|
|
92
|
+
/** @experimental */
|
|
78
93
|
export type ScoreAnswer = {
|
|
79
94
|
type: "score";
|
|
80
95
|
score: number;
|
|
81
96
|
probabilities: Record<string, number>;
|
|
82
97
|
};
|
|
98
|
+
/** @experimental */
|
|
83
99
|
export type EvaluationAnswer = BooleanAnswer | ChoiceAnswer | ScoreAnswer;
|
|
84
100
|
export type AnswerFor<Q> = Q extends BooleanQuestion ? BooleanAnswer : Q extends ChoiceQuestion<infer C> ? ChoiceAnswer<C> : Q extends ScoreQuestion ? ScoreAnswer : never;
|
|
101
|
+
/** @experimental */
|
|
85
102
|
export type AnswersFor<Q extends QuestionMap> = {
|
|
86
103
|
[K in keyof Q]: AnswerFor<Q[K]>;
|
|
87
104
|
};
|
|
105
|
+
/** @experimental */
|
|
88
106
|
export type EvaluateResult<Q extends QuestionMap = QuestionMap> = {
|
|
89
107
|
answers: AnswersFor<Q>;
|
|
90
108
|
};
|
|
109
|
+
/** @experimental */
|
|
91
110
|
export type EvaluateArgs<Q extends QuestionMap = QuestionMap> = {
|
|
92
111
|
model?: string;
|
|
93
112
|
state: EvaluationState;
|
|
@@ -96,10 +115,18 @@ export type EvaluateArgs<Q extends QuestionMap = QuestionMap> = {
|
|
|
96
115
|
baseUrl?: string;
|
|
97
116
|
fetch?: typeof globalThis.fetch;
|
|
98
117
|
};
|
|
99
|
-
/**
|
|
118
|
+
/**
|
|
119
|
+
* Ask Jev for typed answers over one state.
|
|
120
|
+
* @experimental
|
|
121
|
+
*/
|
|
100
122
|
export declare function evaluate<const Q extends QuestionMap>(args: EvaluateArgs<Q>): Promise<EvaluateResult<Q>>;
|
|
101
|
-
/**
|
|
123
|
+
/**
|
|
124
|
+
* Same as {@link evaluate}, returning only `answers`.
|
|
125
|
+
* @experimental
|
|
126
|
+
*/
|
|
102
127
|
export declare function decide<const Q extends QuestionMap>(args: EvaluateArgs<Q>): Promise<AnswersFor<Q>>;
|
|
128
|
+
/** @experimental */
|
|
103
129
|
export declare function above(answer: BooleanAnswer | ScoreAnswer, threshold: number): boolean;
|
|
130
|
+
/** @experimental */
|
|
104
131
|
export declare function needsHuman(answer: BooleanAnswer | ChoiceAnswer, threshold?: number): boolean;
|
|
105
132
|
//# sourceMappingURL=evaluate.d.ts.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"evaluate.d.ts","sourceRoot":"","sources":["../../../../src/extensions/jev/lib/evaluate.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AAIH
|
|
1
|
+
{"version":3,"file":"evaluate.d.ts","sourceRoot":"","sources":["../../../../src/extensions/jev/lib/evaluate.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AAIH;;;GAGG;AACH,eAAO,MAAM,wBAAwB,eAAe,CAAC;AAErD;;;GAGG;AACH,eAAO,MAAM,uBAAuB,MAAM,CAAC;AAI3C,wCAAwC;AACxC,eAAO,MAAM,qBAAqB,EAAE,MAA2C,CAAC;AAEhF,oFAAoF;AACpF,eAAO,MAAM,oBAAoB,qBAAqB,CAAC;AAEvD,oBAAoB;AACpB,MAAM,MAAM,eAAe,GAAG,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,OAAO,EAAE,CAAC;AAEpF,oBAAoB;AACpB,MAAM,MAAM,eAAe,GAAG;IAC5B,IAAI,EAAE,SAAS,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG,MAAM,GAAG,SAAS,MAAM,EAAE,GAAG;IAAE,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAA;CAAE,GAAG,IAAI,CAAC;AAElG,oBAAoB;AACpB,MAAM,MAAM,cAAc,CACxB,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,IACzE;IACF,IAAI,EAAE,QAAQ,CAAC;IACf,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,CAAC,CAAC;CACb,CAAC;AAEF,oBAAoB;AACpB,MAAM,MAAM,aAAa,GAAG;IAC1B,IAAI,EAAE,OAAO,CAAC;IACd,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;CAC7B,CAAC;AAEF,oBAAoB;AACpB,MAAM,MAAM,kBAAkB,GAAG,eAAe,GAAG,cAAc,GAAG,aAAa,CAAC;AAElF,oBAAoB;AACpB,MAAM,MAAM,WAAW,GAAG,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC;AAE7D,oBAAoB;AACpB,MAAM,MAAM,aAAa,GAAG;IAC1B,IAAI,EAAE,SAAS,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF,oBAAoB;AACpB,MAAM,MAAM,YAAY,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,IAAI;IACtF,IAAI,EAAE,QAAQ,CAAC;IACf,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,CAAC;IACzB,aAAa,EAAE;SAAG,CAAC,IAAI,MAAM,CAAC,GAAG,MAAM;KAAE,CAAC;CAC3C,CAAC;AAEF,oBAAoB;AACpB,MAAM,MAAM,WAAW,GAAG;IACxB,IAAI,EAAE,OAAO,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACvC,CAAC;AAEF,oBAAoB;AACpB,MAAM,MAAM,gBAAgB,GAAG,aAAa,GAAG,YAAY,GAAG,WAAW,CAAC;AAE1E,MAAM,MAAM,SAAS,CAAC,CAAC,IAAI,CAAC,SAAS,eAAe,GAChD,aAAa,GACb,CAAC,SAAS,cAAc,CAAC,MAAM,CAAC,CAAC,GAC/B,YAAY,CAAC,CAAC,CAAC,GACf,CAAC,SAAS,aAAa,GACrB,WAAW,GACX,KAAK,CAAC;AAEd,oBAAoB;AACpB,MAAM,MAAM,UAAU,CAAC,CAAC,SAAS,WAAW,IAAI;KAC7C,CAAC,IAAI,MAAM,CAAC,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;CAChC,CAAC;AAEF,oBAAoB;AACpB,MAAM,MAAM,cAAc,CAAC,CAAC,SAAS,WAAW,GAAG,WAAW,IAAI;IAChE,OAAO,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC;CACxB,CAAC;AAEF,oBAAoB;AACpB,MAAM,MAAM,YAAY,CAAC,CAAC,SAAS,WAAW,GAAG,WAAW,IAAI;IAC9D,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,eAAe,CAAC;IACvB,SAAS,EAAE,CAAC,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,OAAO,UAAU,CAAC,KAAK,CAAC;CACjC,CAAC;AA2GF;;;GAGG;AACH,wBAAsB,QAAQ,CAAC,KAAK,CAAC,CAAC,SAAS,WAAW,EACxD,IAAI,EAAE,YAAY,CAAC,CAAC,CAAC,GACpB,OAAO,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,CA2B5B;AAED;;;GAGG;AACH,wBAAsB,MAAM,CAAC,KAAK,CAAC,CAAC,SAAS,WAAW,EACtD,IAAI,EAAE,YAAY,CAAC,CAAC,CAAC,GACpB,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAGxB;AAED,oBAAoB;AACpB,wBAAgB,KAAK,CAAC,MAAM,EAAE,aAAa,GAAG,WAAW,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAKrF;AAED,oBAAoB;AACpB,wBAAgB,UAAU,CACxB,MAAM,EAAE,aAAa,GAAG,YAAY,EACpC,SAAS,GAAE,MAAgC,GAC1C,OAAO,CAKT"}
|
|
@@ -37,9 +37,15 @@
|
|
|
37
37
|
* default).
|
|
38
38
|
*/
|
|
39
39
|
import { isRecord } from "../../../internal/is-record.js";
|
|
40
|
-
/**
|
|
40
|
+
/**
|
|
41
|
+
* TypeSafe model used when {@link EvaluateArgs.model} is omitted.
|
|
42
|
+
* @experimental
|
|
43
|
+
*/
|
|
41
44
|
export const DEFAULT_EVALUATION_MODEL = "jev-latest";
|
|
42
|
-
/**
|
|
45
|
+
/**
|
|
46
|
+
* Default bar for {@link needsHuman} when the caller does not pass one.
|
|
47
|
+
* @experimental
|
|
48
|
+
*/
|
|
43
49
|
export const DEFAULT_HUMAN_THRESHOLD = 0.7;
|
|
44
50
|
const DEFAULT_BASE_URL = "https://api.typesafe.ai/v1";
|
|
45
51
|
/** Host behind the default base URL. */
|
|
@@ -125,7 +131,10 @@ async function postSystemOne(args) {
|
|
|
125
131
|
}
|
|
126
132
|
return asRecord(asRecord(parsed, "response is not an object").answers, "response is missing answers");
|
|
127
133
|
}
|
|
128
|
-
/**
|
|
134
|
+
/**
|
|
135
|
+
* Ask Jev for typed answers over one state.
|
|
136
|
+
* @experimental
|
|
137
|
+
*/
|
|
129
138
|
export async function evaluate(args) {
|
|
130
139
|
const questions = {};
|
|
131
140
|
for (const [id, question] of Object.entries(args.questions)) {
|
|
@@ -154,17 +163,22 @@ export async function evaluate(args) {
|
|
|
154
163
|
answers: answers,
|
|
155
164
|
};
|
|
156
165
|
}
|
|
157
|
-
/**
|
|
166
|
+
/**
|
|
167
|
+
* Same as {@link evaluate}, returning only `answers`.
|
|
168
|
+
* @experimental
|
|
169
|
+
*/
|
|
158
170
|
export async function decide(args) {
|
|
159
171
|
const result = await evaluate(args);
|
|
160
172
|
return result.answers;
|
|
161
173
|
}
|
|
174
|
+
/** @experimental */
|
|
162
175
|
export function above(answer, threshold) {
|
|
163
176
|
if (answer.type === "boolean") {
|
|
164
177
|
return answer.probability >= threshold;
|
|
165
178
|
}
|
|
166
179
|
return answer.score >= threshold;
|
|
167
180
|
}
|
|
181
|
+
/** @experimental */
|
|
168
182
|
export function needsHuman(answer, threshold = DEFAULT_HUMAN_THRESHOLD) {
|
|
169
183
|
if (answer.type === "boolean") {
|
|
170
184
|
return answer.probability < threshold;
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
/**
|
|
2
2
|
* One declarative table of CLI commands. Each command owns its flags, so
|
|
3
3
|
* parsing rejects a flag that belongs to another command, `--help` works on
|
|
4
|
-
* every command, and `
|
|
4
|
+
* every command, and `agent-sdk help --json` prints the same table for agents.
|
|
5
5
|
*/
|
|
6
6
|
import type { ParseArgsOptionDescriptor, parseArgs } from "node:util";
|
|
7
7
|
import type { ValueKind } from "./value-kinds.js";
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
/**
|
|
2
2
|
* One declarative table of CLI commands. Each command owns its flags, so
|
|
3
3
|
* parsing rejects a flag that belongs to another command, `--help` works on
|
|
4
|
-
* every command, and `
|
|
4
|
+
* every command, and `agent-sdk help --json` prints the same table for agents.
|
|
5
5
|
*/
|
|
6
6
|
/**
|
|
7
7
|
* The index of the first positional argument in `rest`, or -1. Skips the
|
|
@@ -79,7 +79,7 @@ function forgeReplay(values) {
|
|
|
79
79
|
out: values["fixtures-dir"] ?? values.out,
|
|
80
80
|
};
|
|
81
81
|
}
|
|
82
|
-
const servingNote = "Needs the agent already serving (`
|
|
82
|
+
const servingNote = "Needs the agent already serving (`agent-sdk dev` or `agent-sdk serve --dev`).";
|
|
83
83
|
// ---------------------------------------------------------------- GitHub --
|
|
84
84
|
export const githubForwardCommand = defineCommand({
|
|
85
85
|
name: "github forward",
|
|
@@ -140,7 +140,7 @@ posts them to the matching channels. ${servingNote}`,
|
|
|
140
140
|
context: { type: "string", value: "<context>", description: "Commit-status context." },
|
|
141
141
|
},
|
|
142
142
|
effect: "write",
|
|
143
|
-
examples: ["
|
|
143
|
+
examples: ["agent-sdk github replay https://github.com/o/r/pull/12 --events '*' --dry-run"],
|
|
144
144
|
async run({ values, positionals }) {
|
|
145
145
|
const { cmdGithub } = await import("../../cli-github.js");
|
|
146
146
|
return cmdGithub("replay", {
|
|
@@ -369,9 +369,9 @@ export const slackCreateCommand = defineCommand({
|
|
|
369
369
|
summary: "Create a dedicated Socket Mode Slack app through the Cursor dashboard wizard.",
|
|
370
370
|
description: `
|
|
371
371
|
Finish the name, workspace, and Slack consent in the wizard. The CLI then writes
|
|
372
|
-
the token pair into <dir>/.env.local and runs doctor. Needs \`
|
|
372
|
+
the token pair into <dir>/.env.local and runs doctor. Needs \`agent-sdk login\` (or
|
|
373
373
|
CURSOR_API_KEY). A team service-account key cannot create Slack apps. Uses the
|
|
374
|
-
v2 control plane: an agent that sets architecture: "v1" must run \`
|
|
374
|
+
v2 control plane: an agent that sets architecture: "v1" must run \`agent-sdk migrate\`
|
|
375
375
|
first.`,
|
|
376
376
|
flags: {
|
|
377
377
|
...slackProvisionFlags,
|
|
@@ -388,7 +388,7 @@ first.`,
|
|
|
388
388
|
...dryRunFlag,
|
|
389
389
|
},
|
|
390
390
|
effect: "write",
|
|
391
|
-
examples: ["
|
|
391
|
+
examples: ["agent-sdk slack create --dir ./my-agent --channel-posts"],
|
|
392
392
|
async run({ values }) {
|
|
393
393
|
const { cmdSlack } = await import("../../cli-slack.js");
|
|
394
394
|
return cmdSlack("create", {
|
|
@@ -434,7 +434,7 @@ export const slackInitCommand = defineCommand({
|
|
|
434
434
|
description: `
|
|
435
435
|
Writes the channel file, manifests, a Slack CLI .slack/ project, env.example,
|
|
436
436
|
and setup-status.json. When ~/.slack/bin/slack is logged in, installs the app.
|
|
437
|
-
Without --manual this is not the first-run path: use \`
|
|
437
|
+
Without --manual this is not the first-run path: use \`agent-sdk slack create\`.`,
|
|
438
438
|
flags: {
|
|
439
439
|
...slackAppFlags,
|
|
440
440
|
manual: { type: "boolean", description: "Set up a manually created app." },
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"develop.d.ts","sourceRoot":"","sources":["../../../../src/internal/cli/commands/develop.ts"],"names":[],"mappings":"AAAA,2EAA2E;AAe3E,OAAO,EAAE,KAAK,WAAW,EAAoD,MAAM,eAAe,CAAC;
|
|
1
|
+
{"version":3,"file":"develop.d.ts","sourceRoot":"","sources":["../../../../src/internal/cli/commands/develop.ts"],"names":[],"mappings":"AAAA,2EAA2E;AAe3E,OAAO,EAAE,KAAK,WAAW,EAAoD,MAAM,eAAe,CAAC;AA8CnG,8DAA8D;AAC9D,wBAAsB,YAAY,CAChC,QAAQ,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,EACvC,YAAY,EAAE,MAAM,GAAG,SAAS,GAC/B,OAAO,CAAC,MAAM,EAAE,CAAC,CAiBnB;AA8BD,eAAO,MAAM,UAAU,EAAE,WA4FvB,CAAC;AAgHH,eAAO,MAAM,WAAW,EAAE,WAyCxB,CAAC;AAaH,eAAO,MAAM,eAAe,EAAE,WA8C5B,CAAC;AAEH,eAAO,MAAM,cAAc,EAAE,WAqB3B,CAAC;AAEH,eAAO,MAAM,iBAAiB,EAAE,WAkB9B,CAAC;AAuBH,eAAO,MAAM,WAAW,EAAE,WAyCxB,CAAC;AAEH,eAAO,MAAM,eAAe,EAAE,WAqD5B,CAAC;AAEH,4EAA4E;AAC5E,eAAO,MAAM,YAAY,EAAE,WA6BzB,CAAC;AAEH,eAAO,MAAM,WAAW,EAAE,WAwBxB,CAAC"}
|
|
@@ -19,11 +19,16 @@ const messageFlag = {
|
|
|
19
19
|
};
|
|
20
20
|
/** `run --prod` flags, accepted for old scripts. `session create` documents them. */
|
|
21
21
|
const hiddenHostedTurnFlags = {
|
|
22
|
-
"read-only": { type: "boolean", hidden: true, description: "See `
|
|
23
|
-
"as-of": { type: "string", hidden: true, description: "See `
|
|
24
|
-
component: { type: "string", hidden: true, description: "See `
|
|
25
|
-
team: {
|
|
26
|
-
|
|
22
|
+
"read-only": { type: "boolean", hidden: true, description: "See `agent-sdk session create`." },
|
|
23
|
+
"as-of": { type: "string", hidden: true, description: "See `agent-sdk session create`." },
|
|
24
|
+
component: { type: "string", hidden: true, description: "See `agent-sdk session create`." },
|
|
25
|
+
team: {
|
|
26
|
+
type: "string",
|
|
27
|
+
hidden: true,
|
|
28
|
+
kind: "teamId",
|
|
29
|
+
description: "See `agent-sdk session create`.",
|
|
30
|
+
},
|
|
31
|
+
"api-key": { type: "string", hidden: true, description: "See `agent-sdk session create`." },
|
|
27
32
|
};
|
|
28
33
|
/** `--message` values after the `--messages-file` entries. */
|
|
29
34
|
export async function loadMessages(messages, messagesFile) {
|
|
@@ -74,9 +79,9 @@ export const runCommand = defineCommand({
|
|
|
74
79
|
group: "develop",
|
|
75
80
|
summary: "Run one turn on an ephemeral local server and print the trajectory.",
|
|
76
81
|
description: `
|
|
77
|
-
Writes one events.ndjson trace (read it with \`
|
|
82
|
+
Writes one events.ndjson trace (read it with \`agent-sdk session get --file\`).
|
|
78
83
|
Streams tool calls and reply text to stderr when stderr is a TTY. --url uses a
|
|
79
|
-
running server. For the hosted deployment, use \`
|
|
84
|
+
running server. For the hosted deployment, use \`agent-sdk session create\`.`,
|
|
80
85
|
flags: {
|
|
81
86
|
...dirFlag,
|
|
82
87
|
...messageFlag,
|
|
@@ -119,13 +124,17 @@ running server. For the hosted deployment, use \`bdk session create\`.`,
|
|
|
119
124
|
...noStreamFlag,
|
|
120
125
|
...dryRunFlag,
|
|
121
126
|
// The hosted turn moved to `session create`; these keep old scripts working.
|
|
122
|
-
prod: {
|
|
127
|
+
prod: {
|
|
128
|
+
type: "boolean",
|
|
129
|
+
hidden: true,
|
|
130
|
+
description: "Older form of `agent-sdk session create`.",
|
|
131
|
+
},
|
|
123
132
|
...hiddenHostedTurnFlags,
|
|
124
133
|
},
|
|
125
134
|
effect: "write",
|
|
126
135
|
examples: [
|
|
127
|
-
'
|
|
128
|
-
'
|
|
136
|
+
'agent-sdk run --message "What is the temperature in NYC?"',
|
|
137
|
+
'agent-sdk run --message "What is the temperature in NYC?" --json',
|
|
129
138
|
],
|
|
130
139
|
async run({ values, io }) {
|
|
131
140
|
const messages = await loadMessages(values.message, values["messages-file"]);
|
|
@@ -284,9 +293,9 @@ supported.`,
|
|
|
284
293
|
flags: evalFlags,
|
|
285
294
|
effect: "write",
|
|
286
295
|
examples: [
|
|
287
|
-
"
|
|
288
|
-
"
|
|
289
|
-
"
|
|
296
|
+
"agent-sdk eval --list",
|
|
297
|
+
"agent-sdk eval weather/nyc --json",
|
|
298
|
+
"agent-sdk eval --url http://127.0.0.1:3000 --no-wait",
|
|
290
299
|
],
|
|
291
300
|
async run({ values, positionals }) {
|
|
292
301
|
if (values.limit !== undefined ||
|
|
@@ -482,7 +491,7 @@ export const toolCallCommand = defineCommand({
|
|
|
482
491
|
...dryRunFlag,
|
|
483
492
|
},
|
|
484
493
|
effect: "write",
|
|
485
|
-
examples: [`
|
|
494
|
+
examples: [`agent-sdk tool call get_weather --input '{"city":"NYC"}' --json`],
|
|
486
495
|
async run({ values, positionals }) {
|
|
487
496
|
if (values["dry-run"] === true && values.url === undefined && values.prod !== true) {
|
|
488
497
|
let input;
|