@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
|
@@ -1,71 +0,0 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* Your Grok Bot agents as an extension. Mount it and the agent can talk to
|
|
3
|
-
* the Grok Bot agents of the host's account: send a message, read the
|
|
4
|
-
* reply, keep waiting on a long turn, interrupt one.
|
|
5
|
-
*
|
|
6
|
-
* ```ts
|
|
7
|
-
* // agent/extensions/grokbot.ts
|
|
8
|
-
* import cursorGrokBotAgents from "@grok/agent-sdk/extensions/cursor-grokbot-agents";
|
|
9
|
-
*
|
|
10
|
-
* export default cursorGrokBotAgents({
|
|
11
|
-
* agents: [
|
|
12
|
-
* { name: "Plan Keeper", description: "Keeps or moves outdoor plans." },
|
|
13
|
-
* ],
|
|
14
|
-
* });
|
|
15
|
-
* ```
|
|
16
|
-
*
|
|
17
|
-
* Contributes `grokbot__ask`, `grokbot__check`, `grokbot__interrupt`,
|
|
18
|
-
* `grokbot__list` and the `grokbot__consult` skill (the namespace is the
|
|
19
|
-
* mount filename), over the public `/v0/grokbot` session API, under the
|
|
20
|
-
* serve host's Cursor API key (`CURSOR_API_KEY`, key file, or `login`).
|
|
21
|
-
* Agents are addressed by name and resolved on the account the key belongs
|
|
22
|
-
* to; a message lands in that account's own conversation with the agent,
|
|
23
|
-
* and the reply is what the agent sends back during that turn. The tools
|
|
24
|
-
* run on the serve host, so they need the local runtime.
|
|
25
|
-
*/
|
|
26
|
-
import type { Extension } from "../../types.js";
|
|
27
|
-
/**
|
|
28
|
-
* A Grok Bot agent the model may address, by the name shown in the app.
|
|
29
|
-
* Type alias, not an interface: `list` returns these.
|
|
30
|
-
*/
|
|
31
|
-
export type ConfiguredGrokBotAgent = {
|
|
32
|
-
name: string;
|
|
33
|
-
/** What the agent is for; shown to the model by `list`. */
|
|
34
|
-
description?: string;
|
|
35
|
-
};
|
|
36
|
-
/** Mount options; every field is optional. */
|
|
37
|
-
export interface CursorGrokBotAgentsOptions {
|
|
38
|
-
/**
|
|
39
|
-
* The Grok Bot agents the model may talk to, by name. This is the
|
|
40
|
-
* allowlist for a call's own `agent`: names outside it are refused, and a
|
|
41
|
-
* lone configured agent is the default when a call names none. Without
|
|
42
|
-
* it, any name goes through and `needsApproval` defaults to true, since
|
|
43
|
-
* an unknown name creates an agent of that name on the account.
|
|
44
|
-
*/
|
|
45
|
-
agents?: Array<string | ConfiguredGrokBotAgent>;
|
|
46
|
-
/**
|
|
47
|
-
* Park messages for a human approval. Defaults to `true` when no `agents`
|
|
48
|
-
* are configured; `false` once they are. Pass an explicit boolean to
|
|
49
|
-
* override. Configured names still bound the model's choice regardless.
|
|
50
|
-
*/
|
|
51
|
-
needsApproval?: boolean;
|
|
52
|
-
/** Cursor API key. Defaults to the serve host's own key. */
|
|
53
|
-
apiKey?: string;
|
|
54
|
-
/**
|
|
55
|
-
* How often to read the agent's transcript while waiting for a reply, in
|
|
56
|
-
* milliseconds. Defaults to 750.
|
|
57
|
-
*/
|
|
58
|
-
pollIntervalMs?: number;
|
|
59
|
-
}
|
|
60
|
-
/** {@link CursorGrokBotAgentsOptions} with defaults applied. */
|
|
61
|
-
export interface CursorGrokBotAgentsConfig {
|
|
62
|
-
agents?: ConfiguredGrokBotAgent[];
|
|
63
|
-
needsApproval: boolean;
|
|
64
|
-
apiKey?: string;
|
|
65
|
-
pollIntervalMs: number;
|
|
66
|
-
}
|
|
67
|
-
/** The backend's session name limit. */
|
|
68
|
-
export declare const AGENT_NAME_MAX_LENGTH = 255;
|
|
69
|
-
declare const cursorGrokBotAgents: Extension<CursorGrokBotAgentsConfig, CursorGrokBotAgentsOptions | undefined>;
|
|
70
|
-
export default cursorGrokBotAgents;
|
|
71
|
-
//# sourceMappingURL=extension.d.ts.map
|
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"file":"extension.d.ts","sourceRoot":"","sources":["../../../src/extensions/cursor-grokbot-agents/extension.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAIH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAEhD;;;GAGG;AACH,MAAM,MAAM,sBAAsB,GAAG;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,2DAA2D;IAC3D,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF,8CAA8C;AAC9C,MAAM,WAAW,0BAA0B;IACzC;;;;;;OAMG;IACH,MAAM,CAAC,EAAE,KAAK,CAAC,MAAM,GAAG,sBAAsB,CAAC,CAAC;IAChD;;;;OAIG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,4DAA4D;IAC5D,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,gEAAgE;AAChE,MAAM,WAAW,yBAAyB;IACxC,MAAM,CAAC,EAAE,sBAAsB,EAAE,CAAC;IAClC,aAAa,EAAE,OAAO,CAAC;IACvB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,wCAAwC;AACxC,eAAO,MAAM,qBAAqB,MAAM,CAAC;AAmCzC,QAAA,MAAM,mBAAmB,EAAE,SAAS,CAClC,yBAAyB,EACzB,0BAA0B,GAAG,SAAS,CAKtC,CAAC;eAEY,mBAAmB"}
|
|
@@ -1,64 +0,0 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* Your Grok Bot agents as an extension. Mount it and the agent can talk to
|
|
3
|
-
* the Grok Bot agents of the host's account: send a message, read the
|
|
4
|
-
* reply, keep waiting on a long turn, interrupt one.
|
|
5
|
-
*
|
|
6
|
-
* ```ts
|
|
7
|
-
* // agent/extensions/grokbot.ts
|
|
8
|
-
* import cursorGrokBotAgents from "@grok/agent-sdk/extensions/cursor-grokbot-agents";
|
|
9
|
-
*
|
|
10
|
-
* export default cursorGrokBotAgents({
|
|
11
|
-
* agents: [
|
|
12
|
-
* { name: "Plan Keeper", description: "Keeps or moves outdoor plans." },
|
|
13
|
-
* ],
|
|
14
|
-
* });
|
|
15
|
-
* ```
|
|
16
|
-
*
|
|
17
|
-
* Contributes `grokbot__ask`, `grokbot__check`, `grokbot__interrupt`,
|
|
18
|
-
* `grokbot__list` and the `grokbot__consult` skill (the namespace is the
|
|
19
|
-
* mount filename), over the public `/v0/grokbot` session API, under the
|
|
20
|
-
* serve host's Cursor API key (`CURSOR_API_KEY`, key file, or `login`).
|
|
21
|
-
* Agents are addressed by name and resolved on the account the key belongs
|
|
22
|
-
* to; a message lands in that account's own conversation with the agent,
|
|
23
|
-
* and the reply is what the agent sends back during that turn. The tools
|
|
24
|
-
* run on the serve host, so they need the local runtime.
|
|
25
|
-
*/
|
|
26
|
-
import * as z from "zod/v4";
|
|
27
|
-
import { defineExtension } from "../../extensions.js";
|
|
28
|
-
/** The backend's session name limit. */
|
|
29
|
-
export const AGENT_NAME_MAX_LENGTH = 255;
|
|
30
|
-
const DEFAULT_POLL_INTERVAL_MS = 750;
|
|
31
|
-
const agentName = z
|
|
32
|
-
.string()
|
|
33
|
-
.trim()
|
|
34
|
-
.min(1, "Grok Bot agent names must not be empty.")
|
|
35
|
-
.max(AGENT_NAME_MAX_LENGTH);
|
|
36
|
-
const configuredAgent = z
|
|
37
|
-
.union([agentName, z.object({ name: agentName, description: z.string().optional() })])
|
|
38
|
-
.transform((agent) => (typeof agent === "string" ? { name: agent } : agent));
|
|
39
|
-
const agents = z
|
|
40
|
-
.array(configuredAgent)
|
|
41
|
-
.min(1, "agents must name at least one Grok Bot agent; omit it to allow any.")
|
|
42
|
-
.refine((list) => new Set(list.map((agent) => agent.name.toLowerCase())).size === list.length, {
|
|
43
|
-
message: "agents must not repeat a name (names match case-insensitively).",
|
|
44
|
-
// An element that failed `agentName` never reached the transform, so it has no `name`.
|
|
45
|
-
when: (payload) => payload.issues.length === 0,
|
|
46
|
-
});
|
|
47
|
-
const config = z
|
|
48
|
-
.object({
|
|
49
|
-
agents: agents.optional(),
|
|
50
|
-
needsApproval: z.boolean().optional(),
|
|
51
|
-
apiKey: z.string().optional(),
|
|
52
|
-
pollIntervalMs: z.number().int().min(1).default(DEFAULT_POLL_INTERVAL_MS),
|
|
53
|
-
})
|
|
54
|
-
.prefault({})
|
|
55
|
-
.transform((options) => ({
|
|
56
|
-
...options,
|
|
57
|
-
needsApproval: options.needsApproval ?? options.agents === undefined,
|
|
58
|
-
}));
|
|
59
|
-
const cursorGrokBotAgents = defineExtension({
|
|
60
|
-
root: import.meta.dirname,
|
|
61
|
-
description: "Talk to your Grok Bot agents and read their replies.",
|
|
62
|
-
config,
|
|
63
|
-
});
|
|
64
|
-
export default cursorGrokBotAgents;
|
|
@@ -1,11 +0,0 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* Which Grok Bot agent a call addresses. The model names one per call, but
|
|
3
|
-
* the author's `agents` are the allowlist: with them configured, a name
|
|
4
|
-
* outside the list is refused (the backend would create an agent of that
|
|
5
|
-
* name), and a lone configured agent stands in when the call names none.
|
|
6
|
-
* Matching is case-insensitive and resolves to the configured spelling,
|
|
7
|
-
* since the backend looks names up exactly.
|
|
8
|
-
*/
|
|
9
|
-
import type { ConfiguredGrokBotAgent } from "../extension.js";
|
|
10
|
-
export declare function resolveAgentName(requested: string | undefined, configured: ConfiguredGrokBotAgent[] | undefined): string;
|
|
11
|
-
//# sourceMappingURL=agents.d.ts.map
|
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"file":"agents.d.ts","sourceRoot":"","sources":["../../../../src/extensions/cursor-grokbot-agents/lib/agents.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,iBAAiB,CAAC;AAE9D,wBAAgB,gBAAgB,CAC9B,SAAS,EAAE,MAAM,GAAG,SAAS,EAC7B,UAAU,EAAE,sBAAsB,EAAE,GAAG,SAAS,GAC/C,MAAM,CA2BR"}
|
|
@@ -1,31 +0,0 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* Which Grok Bot agent a call addresses. The model names one per call, but
|
|
3
|
-
* the author's `agents` are the allowlist: with them configured, a name
|
|
4
|
-
* outside the list is refused (the backend would create an agent of that
|
|
5
|
-
* name), and a lone configured agent stands in when the call names none.
|
|
6
|
-
* Matching is case-insensitive and resolves to the configured spelling,
|
|
7
|
-
* since the backend looks names up exactly.
|
|
8
|
-
*/
|
|
9
|
-
export function resolveAgentName(requested, configured) {
|
|
10
|
-
const name = requested?.trim();
|
|
11
|
-
if (configured === undefined) {
|
|
12
|
-
if (name === undefined || name === "") {
|
|
13
|
-
throw new Error("`agent` is required: this extension has no configured Grok Bot agents.");
|
|
14
|
-
}
|
|
15
|
-
return name;
|
|
16
|
-
}
|
|
17
|
-
const names = configured.map((agent) => `"${agent.name}"`).join(", ");
|
|
18
|
-
if (name === undefined || name === "") {
|
|
19
|
-
const only = configured.length === 1 ? configured[0] : undefined;
|
|
20
|
-
if (only === undefined) {
|
|
21
|
-
throw new Error(`\`agent\` is required: this extension configures several Grok Bot agents (${names}).`);
|
|
22
|
-
}
|
|
23
|
-
return only.name;
|
|
24
|
-
}
|
|
25
|
-
const match = configured.find((agent) => agent.name === name) ??
|
|
26
|
-
configured.find((agent) => agent.name.toLowerCase() === name.toLowerCase());
|
|
27
|
-
if (match === undefined) {
|
|
28
|
-
throw new Error(`"${name}" is not one of this extension's configured Grok Bot agents (${names}).`);
|
|
29
|
-
}
|
|
30
|
-
return match.name;
|
|
31
|
-
}
|
|
@@ -1,56 +0,0 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* The `/v0/grokbot` session API as the tools use it. Four routes on the
|
|
3
|
-
* external API host (`api.cursor.com`; they 404 on api2), under the host's
|
|
4
|
-
* Cursor API key. A session is a hosted Grok Bot agent of the key's
|
|
5
|
-
* account, get-or-created by name; messages go into its one conversation,
|
|
6
|
-
* and the transcript is read back as entries after a cursor, with the
|
|
7
|
-
* turn's status alongside.
|
|
8
|
-
*/
|
|
9
|
-
export declare class GrokBotApiError extends Error {
|
|
10
|
-
readonly status?: number | undefined;
|
|
11
|
-
constructor(message: string, status?: number | undefined);
|
|
12
|
-
}
|
|
13
|
-
export type GrokBotSession = {
|
|
14
|
-
/** The hosted agent's durable id; every other route addresses it. */
|
|
15
|
-
sessionId: string;
|
|
16
|
-
/** The name as the backend stores it (trimmed). */
|
|
17
|
-
name: string;
|
|
18
|
-
createdAtMs: number;
|
|
19
|
-
/** Transcript tail: reading after it skips the conversation's history. */
|
|
20
|
-
latestUpdatedSeq: string;
|
|
21
|
-
};
|
|
22
|
-
export type GrokBotEntry = {
|
|
23
|
-
seq: string;
|
|
24
|
-
updatedSeq: string;
|
|
25
|
-
kind: string;
|
|
26
|
-
role?: string;
|
|
27
|
-
text?: string;
|
|
28
|
-
createdAtMs: number;
|
|
29
|
-
};
|
|
30
|
-
export type GrokBotTurnStatus = {
|
|
31
|
-
idle: boolean;
|
|
32
|
-
inFlight: boolean;
|
|
33
|
-
queued: number;
|
|
34
|
-
};
|
|
35
|
-
export type GrokBotEntriesPage = {
|
|
36
|
-
entries: GrokBotEntry[];
|
|
37
|
-
latestUpdatedSeq: string;
|
|
38
|
-
turn: GrokBotTurnStatus;
|
|
39
|
-
};
|
|
40
|
-
export declare class GrokBotAgentsBackend {
|
|
41
|
-
private readonly apiKey;
|
|
42
|
-
private readonly fetchImpl;
|
|
43
|
-
constructor(apiKey: () => string, fetchImpl?: typeof fetch);
|
|
44
|
-
/** `POST /v0/grokbot/sessions`: the account's agent of that name, created when missing. */
|
|
45
|
-
session(name: string): Promise<GrokBotSession>;
|
|
46
|
-
/** Deliver one user message to the agent's conversation. */
|
|
47
|
-
send(sessionId: string, text: string): Promise<void>;
|
|
48
|
-
/** Transcript entries after `afterUpdatedSeq`, oldest first, with the turn's status. */
|
|
49
|
-
entries(sessionId: string, afterUpdatedSeq: string): Promise<GrokBotEntriesPage>;
|
|
50
|
-
interrupt(sessionId: string, reason: string): Promise<void>;
|
|
51
|
-
private request;
|
|
52
|
-
}
|
|
53
|
-
/** The process-wide backend for this mount, built on first use. */
|
|
54
|
-
export declare function grokBotAgentsBackend(): GrokBotAgentsBackend;
|
|
55
|
-
export declare function apiKey(): string;
|
|
56
|
-
//# sourceMappingURL=backend.d.ts.map
|
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"file":"backend.d.ts","sourceRoot":"","sources":["../../../../src/extensions/cursor-grokbot-agents/lib/backend.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAcH,qBAAa,eAAgB,SAAQ,KAAK;IAGtC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM;IAF1B,YACE,OAAO,EAAE,MAAM,EACN,MAAM,CAAC,EAAE,MAAM,YAAA,EAIzB;CACF;AAGD,MAAM,MAAM,cAAc,GAAG;IAC3B,qEAAqE;IACrE,SAAS,EAAE,MAAM,CAAC;IAClB,mDAAmD;IACnD,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,0EAA0E;IAC1E,gBAAgB,EAAE,MAAM,CAAC;CAC1B,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG;IACzB,GAAG,EAAE,MAAM,CAAC;IACZ,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,IAAI,EAAE,OAAO,CAAC;IACd,QAAQ,EAAE,OAAO,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG;IAC/B,OAAO,EAAE,YAAY,EAAE,CAAC;IACxB,gBAAgB,EAAE,MAAM,CAAC;IACzB,IAAI,EAAE,iBAAiB,CAAC;CACzB,CAAC;AAiCF,qBAAa,oBAAoB;IAE7B,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,SAAS;IAF5B,YACmB,MAAM,EAAE,MAAM,MAAM,EACpB,SAAS,GAAE,OAAO,KAAa,EAC9C;IAEJ,2FAA2F;IACrF,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,CAYnD;IAED,4DAA4D;IACtD,IAAI,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAYzD;IAED,wFAAwF;IAClF,OAAO,CAAC,SAAS,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAOrF;IAEK,SAAS,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAIhE;YAEa,OAAO;CA+BtB;AAID,mEAAmE;AACnE,wBAAgB,oBAAoB,IAAI,oBAAoB,CAG3D;AAED,wBAAgB,MAAM,IAAI,MAAM,CAO/B"}
|
|
@@ -1,139 +0,0 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* The `/v0/grokbot` session API as the tools use it. Four routes on the
|
|
3
|
-
* external API host (`api.cursor.com`; they 404 on api2), under the host's
|
|
4
|
-
* Cursor API key. A session is a hosted Grok Bot agent of the key's
|
|
5
|
-
* account, get-or-created by name; messages go into its one conversation,
|
|
6
|
-
* and the transcript is read back as entries after a cursor, with the
|
|
7
|
-
* turn's status alongside.
|
|
8
|
-
*/
|
|
9
|
-
import { randomUUID } from "node:crypto";
|
|
10
|
-
import * as z from "zod/v4";
|
|
11
|
-
import { cursorExternalApiUrl, resolveApiKeySync, SIGN_IN_HINT, } from "../../../internal/cursor/credentials.js";
|
|
12
|
-
import extension from "../extension.js";
|
|
13
|
-
import { isRecord } from "../../../internal/is-record.js";
|
|
14
|
-
const REQUEST_TIMEOUT_MS = 60_000;
|
|
15
|
-
export class GrokBotApiError extends Error {
|
|
16
|
-
constructor(message, status) {
|
|
17
|
-
super(message);
|
|
18
|
-
this.status = status;
|
|
19
|
-
this.name = "GrokBotApiError";
|
|
20
|
-
}
|
|
21
|
-
}
|
|
22
|
-
const sessionSchema = z.object({
|
|
23
|
-
id: z.string(),
|
|
24
|
-
name: z.string(),
|
|
25
|
-
createdAtMs: z.number(),
|
|
26
|
-
latestUpdatedSeq: z.string(),
|
|
27
|
-
});
|
|
28
|
-
const sendSchema = z.object({
|
|
29
|
-
messageId: z.string(),
|
|
30
|
-
delivery: z.string(),
|
|
31
|
-
});
|
|
32
|
-
const entriesSchema = z.object({
|
|
33
|
-
entries: z.array(z.object({
|
|
34
|
-
seq: z.string(),
|
|
35
|
-
updatedSeq: z.string(),
|
|
36
|
-
kind: z.string(),
|
|
37
|
-
role: z.string().optional(),
|
|
38
|
-
text: z.string().optional(),
|
|
39
|
-
createdAtMs: z.number(),
|
|
40
|
-
})),
|
|
41
|
-
latestUpdatedSeq: z.string(),
|
|
42
|
-
turn: z.object({
|
|
43
|
-
idle: z.boolean(),
|
|
44
|
-
inFlight: z.boolean(),
|
|
45
|
-
queued: z.number(),
|
|
46
|
-
}),
|
|
47
|
-
});
|
|
48
|
-
export class GrokBotAgentsBackend {
|
|
49
|
-
constructor(apiKey, fetchImpl = fetch) {
|
|
50
|
-
this.apiKey = apiKey;
|
|
51
|
-
this.fetchImpl = fetchImpl;
|
|
52
|
-
}
|
|
53
|
-
/** `POST /v0/grokbot/sessions`: the account's agent of that name, created when missing. */
|
|
54
|
-
async session(name) {
|
|
55
|
-
// No `instructions`: the agent is somebody's, configured in the app, and
|
|
56
|
-
// an omitted field never touches its stored profile.
|
|
57
|
-
const parsed = sessionSchema.parse(await this.request("POST", "/v0/grokbot/sessions", { name }));
|
|
58
|
-
return {
|
|
59
|
-
sessionId: parsed.id,
|
|
60
|
-
name: parsed.name,
|
|
61
|
-
createdAtMs: parsed.createdAtMs,
|
|
62
|
-
latestUpdatedSeq: parsed.latestUpdatedSeq,
|
|
63
|
-
};
|
|
64
|
-
}
|
|
65
|
-
/** Deliver one user message to the agent's conversation. */
|
|
66
|
-
async send(sessionId, text) {
|
|
67
|
-
const { delivery } = sendSchema.parse(await this.request("POST", `/v0/grokbot/sessions/${sessionId}/messages`, {
|
|
68
|
-
text,
|
|
69
|
-
messageId: randomUUID(),
|
|
70
|
-
}));
|
|
71
|
-
if (delivery !== "accepted_temporal" && delivery !== "duplicate") {
|
|
72
|
-
throw new GrokBotApiError(`The Grok Bot agent's harness did not accept the message (delivery: ${delivery}).`);
|
|
73
|
-
}
|
|
74
|
-
}
|
|
75
|
-
/** Transcript entries after `afterUpdatedSeq`, oldest first, with the turn's status. */
|
|
76
|
-
async entries(sessionId, afterUpdatedSeq) {
|
|
77
|
-
return entriesSchema.parse(await this.request("GET", `/v0/grokbot/sessions/${sessionId}/entries?afterUpdatedSeq=${encodeURIComponent(afterUpdatedSeq)}`));
|
|
78
|
-
}
|
|
79
|
-
async interrupt(sessionId, reason) {
|
|
80
|
-
await this.request("POST", `/v0/grokbot/sessions/${sessionId}/interrupt`, {
|
|
81
|
-
reason,
|
|
82
|
-
});
|
|
83
|
-
}
|
|
84
|
-
async request(method, path, body) {
|
|
85
|
-
const headers = {
|
|
86
|
-
authorization: `Bearer ${this.apiKey()}`,
|
|
87
|
-
"x-cursor-client-type": "agent-serve",
|
|
88
|
-
"x-request-id": randomUUID(),
|
|
89
|
-
};
|
|
90
|
-
if (body !== undefined) {
|
|
91
|
-
headers["content-type"] = "application/json";
|
|
92
|
-
}
|
|
93
|
-
let response;
|
|
94
|
-
try {
|
|
95
|
-
response = await this.fetchImpl(`${cursorExternalApiUrl()}${path}`, {
|
|
96
|
-
method,
|
|
97
|
-
headers,
|
|
98
|
-
body: body === undefined ? undefined : JSON.stringify(body),
|
|
99
|
-
signal: AbortSignal.timeout(REQUEST_TIMEOUT_MS),
|
|
100
|
-
});
|
|
101
|
-
}
|
|
102
|
-
catch (error) {
|
|
103
|
-
throw new GrokBotApiError(`Grok Bot API ${method} ${path} failed: ${error instanceof Error ? error.message : String(error)}`);
|
|
104
|
-
}
|
|
105
|
-
const text = await response.text();
|
|
106
|
-
if (!response.ok) {
|
|
107
|
-
throw new GrokBotApiError(`Grok Bot API ${method} ${path} failed (${response.status}): ${apiErrorMessage(text)}`, response.status);
|
|
108
|
-
}
|
|
109
|
-
return JSON.parse(text);
|
|
110
|
-
}
|
|
111
|
-
}
|
|
112
|
-
let backend;
|
|
113
|
-
/** The process-wide backend for this mount, built on first use. */
|
|
114
|
-
export function grokBotAgentsBackend() {
|
|
115
|
-
backend ??= new GrokBotAgentsBackend(apiKey);
|
|
116
|
-
return backend;
|
|
117
|
-
}
|
|
118
|
-
export function apiKey() {
|
|
119
|
-
// Read per call: the host can sign in after the mount.
|
|
120
|
-
const key = resolveApiKeySync({ apiKey: extension.config.apiKey });
|
|
121
|
-
if (key === undefined) {
|
|
122
|
-
throw new Error(`Grok Bot agents need a Cursor API key. ${SIGN_IN_HINT}`);
|
|
123
|
-
}
|
|
124
|
-
return key.apiKey;
|
|
125
|
-
}
|
|
126
|
-
/** The route's `{ error }` envelope when it is one, the raw body otherwise. */
|
|
127
|
-
function apiErrorMessage(text) {
|
|
128
|
-
try {
|
|
129
|
-
const parsed = JSON.parse(text);
|
|
130
|
-
const message = isRecord(parsed) ? (parsed.error ?? parsed.message) : undefined;
|
|
131
|
-
if (typeof message === "string" && message !== "") {
|
|
132
|
-
return message;
|
|
133
|
-
}
|
|
134
|
-
}
|
|
135
|
-
catch {
|
|
136
|
-
// Not JSON; fall through to the raw body.
|
|
137
|
-
}
|
|
138
|
-
return text.slice(0, 300);
|
|
139
|
-
}
|
|
@@ -1,28 +0,0 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* Who has talked to which Grok Bot agent, and how far into its transcript
|
|
3
|
-
* they have read. The tools authenticate with the serve host's one Cursor
|
|
4
|
-
* API key, so every agent is that account's; what the host keeps per
|
|
5
|
-
* principal is the read cursor, so `check` returns what the agent said
|
|
6
|
-
* since that caller last read, and a lookup by name for `check` and
|
|
7
|
-
* `interrupt`, which never create an agent the caller has not spoken to.
|
|
8
|
-
*/
|
|
9
|
-
import type { ToolContext } from "../../../types.js";
|
|
10
|
-
export type Contact = {
|
|
11
|
-
/** The agent's name as the backend stores it. */
|
|
12
|
-
name: string;
|
|
13
|
-
/** The hosted agent's `/v0/grokbot` session id. */
|
|
14
|
-
sessionId: string;
|
|
15
|
-
/** Newest transcript `updatedSeq` this principal has read. */
|
|
16
|
-
cursor: string;
|
|
17
|
-
firstContactAt: string;
|
|
18
|
-
lastContactAt: string;
|
|
19
|
-
};
|
|
20
|
-
/** Unauthenticated sessions (local dev, direct calls) share one principal. */
|
|
21
|
-
export declare function principalOf(ctx: ToolContext): string;
|
|
22
|
-
/** The caller's contacts, most recently spoken to first. */
|
|
23
|
-
export declare function listContacts(ctx: ToolContext): Promise<Contact[]>;
|
|
24
|
-
/** The contact of that name, exact spelling first, then case-insensitively. */
|
|
25
|
-
export declare function findContact(contacts: Contact[], name: string): Contact | undefined;
|
|
26
|
-
/** Insert or replace the caller's record of one agent, newest first. */
|
|
27
|
-
export declare function saveContact(ctx: ToolContext, contact: Contact): Promise<void>;
|
|
28
|
-
//# sourceMappingURL=contacts.d.ts.map
|
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"file":"contacts.d.ts","sourceRoot":"","sources":["../../../../src/extensions/cursor-grokbot-agents/lib/contacts.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAMrD,MAAM,MAAM,OAAO,GAAG;IACpB,iDAAiD;IACjD,IAAI,EAAE,MAAM,CAAC;IACb,mDAAmD;IACnD,SAAS,EAAE,MAAM,CAAC;IAClB,8DAA8D;IAC9D,MAAM,EAAE,MAAM,CAAC;IACf,cAAc,EAAE,MAAM,CAAC;IACvB,aAAa,EAAE,MAAM,CAAC;CACvB,CAAC;AAcF,8EAA8E;AAC9E,wBAAgB,WAAW,CAAC,GAAG,EAAE,WAAW,GAAG,MAAM,CAGpD;AAED,4DAA4D;AAC5D,wBAAsB,YAAY,CAAC,GAAG,EAAE,WAAW,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC,CAGvE;AAED,+EAA+E;AAC/E,wBAAgB,WAAW,CAAC,QAAQ,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,CAMlF;AAED,wEAAwE;AACxE,wBAAsB,WAAW,CAAC,GAAG,EAAE,WAAW,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAQnF"}
|
|
@@ -1,46 +0,0 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* Who has talked to which Grok Bot agent, and how far into its transcript
|
|
3
|
-
* they have read. The tools authenticate with the serve host's one Cursor
|
|
4
|
-
* API key, so every agent is that account's; what the host keeps per
|
|
5
|
-
* principal is the read cursor, so `check` returns what the agent said
|
|
6
|
-
* since that caller last read, and a lookup by name for `check` and
|
|
7
|
-
* `interrupt`, which never create an agent the caller has not spoken to.
|
|
8
|
-
*/
|
|
9
|
-
import * as z from "zod/v4";
|
|
10
|
-
import { KeyedLock } from "./lock.js";
|
|
11
|
-
const PREFIX = "grokbot-agents";
|
|
12
|
-
const contactsSchema = z.array(z.object({
|
|
13
|
-
name: z.string(),
|
|
14
|
-
sessionId: z.string(),
|
|
15
|
-
cursor: z.string(),
|
|
16
|
-
firstContactAt: z.string(),
|
|
17
|
-
lastContactAt: z.string(),
|
|
18
|
-
}));
|
|
19
|
-
const locks = new KeyedLock();
|
|
20
|
-
/** Unauthenticated sessions (local dev, direct calls) share one principal. */
|
|
21
|
-
export function principalOf(ctx) {
|
|
22
|
-
const auth = ctx.session.auth;
|
|
23
|
-
return auth === null ? "anonymous" : `${auth.principalType}:${auth.principalId}`;
|
|
24
|
-
}
|
|
25
|
-
/** The caller's contacts, most recently spoken to first. */
|
|
26
|
-
export async function listContacts(ctx) {
|
|
27
|
-
const contacts = contactsSchema.safeParse(await ctx.host.kv.get(contactsKey(principalOf(ctx))));
|
|
28
|
-
return contacts.success ? contacts.data : [];
|
|
29
|
-
}
|
|
30
|
-
/** The contact of that name, exact spelling first, then case-insensitively. */
|
|
31
|
-
export function findContact(contacts, name) {
|
|
32
|
-
const wanted = name.trim();
|
|
33
|
-
return (contacts.find((contact) => contact.name === wanted) ??
|
|
34
|
-
contacts.find((contact) => contact.name.toLowerCase() === wanted.toLowerCase()));
|
|
35
|
-
}
|
|
36
|
-
/** Insert or replace the caller's record of one agent, newest first. */
|
|
37
|
-
export async function saveContact(ctx, contact) {
|
|
38
|
-
const key = contactsKey(principalOf(ctx));
|
|
39
|
-
await locks.run(key, async () => {
|
|
40
|
-
const others = (await listContacts(ctx)).filter((existing) => existing.sessionId !== contact.sessionId);
|
|
41
|
-
await ctx.host.kv.put(key, [contact, ...others]);
|
|
42
|
-
});
|
|
43
|
-
}
|
|
44
|
-
function contactsKey(principal) {
|
|
45
|
-
return `${PREFIX}/principals/${encodeURIComponent(principal)}`;
|
|
46
|
-
}
|
|
@@ -1,53 +0,0 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* One exchange with a hosted Grok Bot agent: send a user message, then
|
|
3
|
-
* read the transcript until the agent's turn settles. Only `send-message`
|
|
4
|
-
* entries (what the agent delivers through SendToUser) are the reply; its
|
|
5
|
-
* internal work never appears in the transcript. Waits are bounded, so a
|
|
6
|
-
* long turn comes back as `running` and `check` picks it up from the
|
|
7
|
-
* caller's cursor.
|
|
8
|
-
*
|
|
9
|
-
* Sends and reads on one hosted agent are chained within this process, and
|
|
10
|
-
* a send waits for an in-flight turn to settle first, so a reply always
|
|
11
|
-
* attributes to the message that prompted it.
|
|
12
|
-
*/
|
|
13
|
-
import type { ToolContext } from "../../../types.js";
|
|
14
|
-
export declare const DEFAULT_WAIT_SECONDS = 120;
|
|
15
|
-
export declare const MAX_WAIT_SECONDS = 600;
|
|
16
|
-
export type ReplyStatus = "finished" | "running";
|
|
17
|
-
export type AskResult = {
|
|
18
|
-
agent: string;
|
|
19
|
-
sessionId: string;
|
|
20
|
-
status: ReplyStatus;
|
|
21
|
-
/** What the agent sent back, in order; absent when it sent nothing (yet). */
|
|
22
|
-
reply?: string;
|
|
23
|
-
/** Replies to earlier messages that this caller had not read yet. */
|
|
24
|
-
earlierReplies?: string[];
|
|
25
|
-
/** The account had no agent of that name; this call created an empty one. */
|
|
26
|
-
created?: true;
|
|
27
|
-
note?: string;
|
|
28
|
-
};
|
|
29
|
-
export type CheckResult = {
|
|
30
|
-
agent: string;
|
|
31
|
-
sessionId: string;
|
|
32
|
-
status: ReplyStatus;
|
|
33
|
-
reply?: string;
|
|
34
|
-
note?: string;
|
|
35
|
-
};
|
|
36
|
-
export type InterruptResult = {
|
|
37
|
-
agent: string;
|
|
38
|
-
sessionId: string;
|
|
39
|
-
interrupted: true;
|
|
40
|
-
};
|
|
41
|
-
export declare function ask(ctx: ToolContext, input: {
|
|
42
|
-
agent?: string;
|
|
43
|
-
message: string;
|
|
44
|
-
waitSeconds: number;
|
|
45
|
-
}): Promise<AskResult>;
|
|
46
|
-
export declare function check(ctx: ToolContext, input: {
|
|
47
|
-
agent?: string;
|
|
48
|
-
waitSeconds: number;
|
|
49
|
-
}): Promise<CheckResult>;
|
|
50
|
-
export declare function interrupt(ctx: ToolContext, input: {
|
|
51
|
-
agent?: string;
|
|
52
|
-
}): Promise<InterruptResult>;
|
|
53
|
-
//# sourceMappingURL=conversation.d.ts.map
|
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"file":"conversation.d.ts","sourceRoot":"","sources":["../../../../src/extensions/cursor-grokbot-agents/lib/conversation.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAWrD,eAAO,MAAM,oBAAoB,MAAM,CAAC;AACxC,eAAO,MAAM,gBAAgB,MAAM,CAAC;AAkBpC,MAAM,MAAM,WAAW,GAAG,UAAU,GAAG,SAAS,CAAC;AAGjD,MAAM,MAAM,SAAS,GAAG;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,WAAW,CAAC;IACpB,6EAA6E;IAC7E,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,qEAAqE;IACrE,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B,6EAA6E;IAC7E,OAAO,CAAC,EAAE,IAAI,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,CAAC;AAEF,MAAM,MAAM,WAAW,GAAG;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,WAAW,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,IAAI,CAAC;CACnB,CAAC;AAWF,wBAAsB,GAAG,CACvB,GAAG,EAAE,WAAW,EAChB,KAAK,EAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,GAC9D,OAAO,CAAC,SAAS,CAAC,CA0DpB;AAED,wBAAsB,KAAK,CACzB,GAAG,EAAE,WAAW,EAChB,KAAK,EAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,GAC7C,OAAO,CAAC,WAAW,CAAC,CAsBtB;AAED,wBAAsB,SAAS,CAC7B,GAAG,EAAE,WAAW,EAChB,KAAK,EAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,GACxB,OAAO,CAAC,eAAe,CAAC,CAQ1B"}
|