@grok/agent-sdk 0.5.0 → 0.7.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 +40 -0
- package/dist/channels/github/forward.d.ts +5 -0
- package/dist/channels/github/forward.d.ts.map +1 -1
- package/dist/channels/github/forward.js +6 -3
- package/dist/channels/slack/api.d.ts +18 -0
- package/dist/channels/slack/api.d.ts.map +1 -1
- package/dist/channels/slack/api.js +31 -0
- package/dist/channels/slack/approvals.d.ts +19 -2
- package/dist/channels/slack/approvals.d.ts.map +1 -1
- package/dist/channels/slack/approvals.js +90 -19
- package/dist/channels/slack/attachments.d.ts +7 -2
- package/dist/channels/slack/attachments.d.ts.map +1 -1
- package/dist/channels/slack/attachments.js +318 -156
- package/dist/channels/slack/connect-card.d.ts +16 -0
- package/dist/channels/slack/connect-card.d.ts.map +1 -0
- package/dist/channels/slack/connect-card.js +31 -0
- package/dist/channels/slack/credentials.d.ts +10 -2
- package/dist/channels/slack/credentials.d.ts.map +1 -1
- package/dist/channels/slack/credentials.js +17 -15
- package/dist/channels/slack/defaults.d.ts.map +1 -1
- package/dist/channels/slack/defaults.js +18 -9
- package/dist/channels/slack/dispatch.d.ts +1 -1
- package/dist/channels/slack/dispatch.d.ts.map +1 -1
- package/dist/channels/slack/dispatch.js +19 -3
- package/dist/channels/slack/inbound.d.ts +8 -2
- package/dist/channels/slack/inbound.d.ts.map +1 -1
- package/dist/channels/slack/inbound.js +25 -4
- package/dist/channels/slack/index.d.ts +3 -2
- package/dist/channels/slack/index.d.ts.map +1 -1
- package/dist/channels/slack/index.js +3 -2
- package/dist/channels/slack/init.d.ts.map +1 -1
- package/dist/channels/slack/init.js +2 -1
- package/dist/channels/slack/manifest.d.ts.map +1 -1
- package/dist/channels/slack/manifest.js +2 -15
- package/dist/channels/slack/mentions.d.ts +28 -0
- package/dist/channels/slack/mentions.d.ts.map +1 -0
- package/dist/channels/slack/mentions.js +178 -0
- package/dist/channels/slack/setup.js +1 -1
- package/dist/channels/slack/slack-channel.d.ts.map +1 -1
- package/dist/channels/slack/slack-channel.js +46 -3
- package/dist/channels/slack/stop.d.ts.map +1 -1
- package/dist/channels/slack/stop.js +7 -1
- package/dist/channels/slack/thread-context.d.ts +3 -0
- package/dist/channels/slack/thread-context.d.ts.map +1 -1
- package/dist/channels/slack/thread-context.js +17 -7
- package/dist/channels/slack/tool-approval-events.d.ts.map +1 -1
- package/dist/channels/slack/tool-approval-events.js +55 -2
- package/dist/channels/slack/types.d.ts +2 -0
- package/dist/channels/slack/types.d.ts.map +1 -1
- package/dist/channels/teams/activity.d.ts +33 -0
- package/dist/channels/teams/activity.d.ts.map +1 -0
- package/dist/channels/teams/activity.js +213 -0
- package/dist/channels/teams/auth.d.ts +25 -0
- package/dist/channels/teams/auth.d.ts.map +1 -0
- package/dist/channels/teams/auth.js +55 -0
- package/dist/channels/teams/bot-framework-auth.d.ts +33 -0
- package/dist/channels/teams/bot-framework-auth.d.ts.map +1 -0
- package/dist/channels/teams/bot-framework-auth.js +154 -0
- package/dist/channels/teams/cards.d.ts +23 -0
- package/dist/channels/teams/cards.d.ts.map +1 -0
- package/dist/channels/teams/cards.js +107 -0
- package/dist/channels/teams/connector.d.ts +48 -0
- package/dist/channels/teams/connector.d.ts.map +1 -0
- package/dist/channels/teams/connector.js +159 -0
- package/dist/channels/teams/credentials.d.ts +65 -0
- package/dist/channels/teams/credentials.d.ts.map +1 -0
- package/dist/channels/teams/credentials.js +84 -0
- package/dist/channels/teams/delivery.d.ts +14 -0
- package/dist/channels/teams/delivery.d.ts.map +1 -0
- package/dist/channels/teams/delivery.js +169 -0
- package/dist/channels/teams/dispatch.d.ts +45 -0
- package/dist/channels/teams/dispatch.d.ts.map +1 -0
- package/dist/channels/teams/dispatch.js +402 -0
- package/dist/channels/teams/engagement.d.ts +32 -0
- package/dist/channels/teams/engagement.d.ts.map +1 -0
- package/dist/channels/teams/engagement.js +120 -0
- package/dist/channels/teams/index.d.ts +21 -0
- package/dist/channels/teams/index.d.ts.map +1 -0
- package/dist/channels/teams/index.js +19 -0
- package/dist/channels/teams/marks.d.ts +19 -0
- package/dist/channels/teams/marks.d.ts.map +1 -0
- package/dist/channels/teams/marks.js +96 -0
- package/dist/channels/teams/senders.d.ts +27 -0
- package/dist/channels/teams/senders.d.ts.map +1 -0
- package/dist/channels/teams/senders.js +72 -0
- package/dist/channels/teams/teams-channel.d.ts +43 -0
- package/dist/channels/teams/teams-channel.d.ts.map +1 -0
- package/dist/channels/teams/teams-channel.js +278 -0
- package/dist/channels/teams/text.d.ts +7 -0
- package/dist/channels/teams/text.d.ts.map +1 -0
- package/dist/channels/teams/text.js +63 -0
- package/dist/channels/teams/types.d.ts +306 -0
- package/dist/channels/teams/types.d.ts.map +1 -0
- package/dist/channels/teams/types.js +1 -0
- package/dist/channels.d.ts +31 -0
- package/dist/channels.d.ts.map +1 -1
- package/dist/channels.js +37 -0
- package/dist/connections.d.ts +1 -1
- package/dist/connections.d.ts.map +1 -1
- package/dist/docs/404.html +3 -3
- package/dist/docs/assets/{app.CYdjweqP.js → app.Ch-048af.js} +4 -4
- package/dist/docs/assets/changelog.md.SoN0MK7o.js +1 -0
- package/dist/docs/assets/{changelog.md.BMrJ5WxW.lean.js → changelog.md.SoN0MK7o.lean.js} +1 -1
- package/dist/docs/assets/chunks/@localSearchIndexroot.BdYoBKxY.js +1 -0
- package/dist/docs/assets/chunks/{VPLocalSearchBox.CRATKS9J.js → VPLocalSearchBox.D7BIa9Su.js} +2 -2
- package/dist/docs/assets/chunks/{arc.BxM78ISR.js → arc.BIzu7OVF.js} +1 -1
- package/dist/docs/assets/chunks/{architectureDiagram-Q4EWVU46.Bi6MuKaU.js → architectureDiagram-Q4EWVU46.DNznI0Sn.js} +1 -1
- package/dist/docs/assets/chunks/{baseUniq.L47qqpDG.js → baseUniq.B4y6Y5eG.js} +1 -1
- package/dist/docs/assets/chunks/{blockDiagram-DXYQGD6D.kHFF2FK5.js → blockDiagram-DXYQGD6D.BudnBsgw.js} +1 -1
- package/dist/docs/assets/chunks/{c4Diagram-AHTNJAMY.BTW85ll3.js → c4Diagram-AHTNJAMY._bB00GdB.js} +1 -1
- package/dist/docs/assets/chunks/channel.CgxlmuBS.js +1 -0
- package/dist/docs/assets/chunks/{chunk-4BX2VUAB.Bbh3_48g.js → chunk-4BX2VUAB.CRftnUwS.js} +1 -1
- package/dist/docs/assets/chunks/{chunk-4TB4RGXK.WeAmK3fK.js → chunk-4TB4RGXK.CSx1x2Ob.js} +1 -1
- package/dist/docs/assets/chunks/{chunk-55IACEB6.DTdUiVHf.js → chunk-55IACEB6.KkLHAAbH.js} +1 -1
- package/dist/docs/assets/chunks/{chunk-EDXVE4YY.n5XzANDz.js → chunk-EDXVE4YY.DDeKCCtX.js} +1 -1
- package/dist/docs/assets/chunks/{chunk-FMBD7UC4.D51eewCb.js → chunk-FMBD7UC4.DrLlsD9m.js} +1 -1
- package/dist/docs/assets/chunks/{chunk-OYMX7WX6.BrY0U7ZV.js → chunk-OYMX7WX6.DeVYOGcT.js} +1 -1
- package/dist/docs/assets/chunks/{chunk-QZHKN3VN.B0OA4aFV.js → chunk-QZHKN3VN.Cz4_bS6p.js} +1 -1
- package/dist/docs/assets/chunks/{chunk-YZCP3GAM.Djt3Mjft.js → chunk-YZCP3GAM.CwrYtDVo.js} +1 -1
- package/dist/docs/assets/chunks/classDiagram-6PBFFD2Q.DWroREP-.js +1 -0
- package/dist/docs/assets/chunks/classDiagram-v2-HSJHXN6E.DWroREP-.js +1 -0
- package/dist/docs/assets/chunks/clone.F824-PNx.js +1 -0
- package/dist/docs/assets/chunks/{cose-bilkent-S5V4N54A.DiMcA6Q8.js → cose-bilkent-S5V4N54A.3d8hflz6.js} +1 -1
- package/dist/docs/assets/chunks/{dagre-KV5264BT.BGqI4vrS.js → dagre-KV5264BT.BVEgjiPg.js} +1 -1
- package/dist/docs/assets/chunks/{diagram-5BDNPKRD.bDqFuMoH.js → diagram-5BDNPKRD.j7dZpUK_.js} +1 -1
- package/dist/docs/assets/chunks/{diagram-G4DWMVQ6.Y0sxaXRU.js → diagram-G4DWMVQ6.4flIgIon.js} +1 -1
- package/dist/docs/assets/chunks/{diagram-MMDJMWI5.Bg43b0yi.js → diagram-MMDJMWI5.BlJiFh-S.js} +1 -1
- package/dist/docs/assets/chunks/{diagram-TYMM5635.DCfVasEC.js → diagram-TYMM5635.DHAOHEyM.js} +1 -1
- package/dist/docs/assets/chunks/{erDiagram-SMLLAGMA.C72GaD16.js → erDiagram-SMLLAGMA.DkmyG7xK.js} +1 -1
- package/dist/docs/assets/chunks/{flowDiagram-DWJPFMVM.DxRQj7pP.js → flowDiagram-DWJPFMVM.L_WiaAU6.js} +1 -1
- package/dist/docs/assets/chunks/{ganttDiagram-T4ZO3ILL.DiLZy5Q4.js → ganttDiagram-T4ZO3ILL.CT6kOI2a.js} +1 -1
- package/dist/docs/assets/chunks/{gitGraphDiagram-UUTBAWPF.DL8XkRvh.js → gitGraphDiagram-UUTBAWPF.D8CRlLqh.js} +1 -1
- package/dist/docs/assets/chunks/{graph.3Xub80xJ.js → graph.CdOyJvsX.js} +1 -1
- package/dist/docs/assets/chunks/{infoDiagram-42DDH7IO.O3lGaspu.js → infoDiagram-42DDH7IO.DcmXeSos.js} +1 -1
- package/dist/docs/assets/chunks/{ishikawaDiagram-UXIWVN3A.w-pCiQzn.js → ishikawaDiagram-UXIWVN3A.BBjY4mxr.js} +1 -1
- package/dist/docs/assets/chunks/{journeyDiagram-VCZTEJTY.Cg_oBs9j.js → journeyDiagram-VCZTEJTY.BrXteAB6.js} +1 -1
- package/dist/docs/assets/chunks/{kanban-definition-6JOO6SKY.BpfMGPwn.js → kanban-definition-6JOO6SKY.OlHsUJVV.js} +1 -1
- package/dist/docs/assets/chunks/{layout.CtwXs__p.js → layout.DDwvoQlY.js} +1 -1
- package/dist/docs/assets/chunks/{linear.NmCskOrP.js → linear.BRXPDWj3.js} +1 -1
- package/dist/docs/assets/chunks/{min.DpQtsLKs.js → min.3YwC0t3o.js} +1 -1
- package/dist/docs/assets/chunks/{mindmap-definition-QFDTVHPH.B-P-aKVp.js → mindmap-definition-QFDTVHPH.mPHnT2lN.js} +1 -1
- package/dist/docs/assets/chunks/{pieDiagram-DEJITSTG.BfjjqK7j.js → pieDiagram-DEJITSTG.DEK2--em.js} +1 -1
- package/dist/docs/assets/chunks/{quadrantDiagram-34T5L4WZ.BTzHo53F.js → quadrantDiagram-34T5L4WZ.NCdRAOzK.js} +1 -1
- package/dist/docs/assets/chunks/{requirementDiagram-MS252O5E.DIT2FIKr.js → requirementDiagram-MS252O5E.DLAocFWZ.js} +1 -1
- package/dist/docs/assets/chunks/{sankeyDiagram-XADWPNL6.NK1wCsgt.js → sankeyDiagram-XADWPNL6.afIOqpyT.js} +1 -1
- package/dist/docs/assets/chunks/{sequenceDiagram-FGHM5R23.D9oElkvo.js → sequenceDiagram-FGHM5R23.DXBjvkkE.js} +1 -1
- package/dist/docs/assets/chunks/{stateDiagram-FHFEXIEX.IPksnixH.js → stateDiagram-FHFEXIEX.B_SGgvgs.js} +1 -1
- package/dist/docs/assets/chunks/stateDiagram-v2-QKLJ7IA2.OKAy5Bz7.js +1 -0
- package/dist/docs/assets/chunks/{theme.CgKu7tr3.js → theme.bNyH5NPA.js} +2 -2
- package/dist/docs/assets/chunks/{timeline-definition-GMOUNBTQ.CuAtJapY.js → timeline-definition-GMOUNBTQ.CE6S1iSb.js} +1 -1
- package/dist/docs/assets/chunks/{vennDiagram-DHZGUBPP.B87nNW9E.js → vennDiagram-DHZGUBPP.Blk7wb8V.js} +1 -1
- package/dist/docs/assets/chunks/wardley-RL74JXVD.DQqE3WF8.js +162 -0
- package/dist/docs/assets/chunks/{wardleyDiagram-NUSXRM2D.BELjSq8w.js → wardleyDiagram-NUSXRM2D.MUEQyRnz.js} +1 -1
- package/dist/docs/assets/chunks/{xychartDiagram-5P7HB3ND.5zN5ZGsz.js → xychartDiagram-5P7HB3ND.DnJA2aXp.js} +1 -1
- package/dist/docs/assets/{deployment.md.DJtuDVLh.js → deployment.md.N9S5KC5R.js} +2 -2
- package/dist/docs/assets/{deployment.md.DJtuDVLh.lean.js → deployment.md.N9S5KC5R.lean.js} +1 -1
- package/dist/docs/assets/guides_cloud-agents.md.BdWqmUGb.js +14 -0
- package/dist/docs/assets/{guides_cloud-agents.md.CiXAW6on.lean.js → guides_cloud-agents.md.BdWqmUGb.lean.js} +1 -1
- package/dist/docs/assets/guides_teams.md.7Lz2sbqB.js +50 -0
- package/dist/docs/assets/guides_teams.md.7Lz2sbqB.lean.js +1 -0
- package/dist/docs/assets/{reference_channels.md.CPWOpdsC.js → reference_channels.md.CRvqgU0n.js} +1 -1
- package/dist/docs/assets/{reference_cli.md.DHm6DmYk.js → reference_cli.md.NS6U5a-7.js} +14 -4
- package/dist/docs/assets/{reference_cli.md.DHm6DmYk.lean.js → reference_cli.md.NS6U5a-7.lean.js} +1 -1
- package/dist/docs/assets/{reference_limits.md.CbdtFr4T.js → reference_limits.md.CW9PTdxr.js} +3 -3
- package/dist/docs/assets/{reference_limits.md.CbdtFr4T.lean.js → reference_limits.md.CW9PTdxr.lean.js} +1 -1
- package/dist/docs/assets/{reference_schedules.md.RhQ9ZLo1.js → reference_schedules.md.Dd8_d0WG.js} +3 -3
- package/dist/docs/assets/{reference_sessions.md.NXVQt9mP.js → reference_sessions.md.CoCyQLEz.js} +2 -2
- package/dist/docs/assets/{reference_sessions.md.NXVQt9mP.lean.js → reference_sessions.md.CoCyQLEz.lean.js} +1 -1
- package/dist/docs/assets/{reference_skills.md.DzCPNPkG.js → reference_skills.md.SFRZDC41.js} +4 -4
- package/dist/docs/assets/{reference_skills.md.DzCPNPkG.lean.js → reference_skills.md.SFRZDC41.lean.js} +1 -1
- package/dist/docs/assets/{style.DK0YX1WL.css → style.B7zPxANR.css} +1 -1
- package/dist/docs/assets/troubleshooting.md.CsQTleto.js +3 -0
- package/dist/docs/assets/{troubleshooting.md.DfKKvW1R.lean.js → troubleshooting.md.CsQTleto.lean.js} +1 -1
- package/dist/docs/building-with-agents.html +37 -37
- package/dist/docs/changelog.html +37 -37
- package/dist/docs/changelog.md +51 -0
- package/dist/docs/deployment.html +39 -39
- package/dist/docs/deployment.md +10 -0
- package/dist/docs/evals.html +37 -37
- package/dist/docs/guides/agent-to-agent.html +37 -37
- package/dist/docs/guides/bitbucket.html +37 -37
- package/dist/docs/guides/cloud-agents.html +43 -38
- package/dist/docs/guides/cloud-agents.md +47 -0
- package/dist/docs/guides/convert-automation.html +37 -37
- package/dist/docs/guides/github.html +37 -37
- package/dist/docs/guides/gitlab.html +37 -37
- package/dist/docs/guides/improve.html +37 -37
- package/dist/docs/guides/jev.html +37 -37
- package/dist/docs/guides/mcp-oauth.html +37 -37
- package/dist/docs/guides/migrate.html +37 -37
- package/dist/docs/guides/opentelemetry.html +37 -37
- package/dist/docs/guides/pagerduty.html +37 -37
- package/dist/docs/guides/slack.html +37 -37
- package/dist/docs/guides/teams.html +109 -0
- package/dist/docs/guides/teams.md +384 -0
- package/dist/docs/guides/webhooks.html +37 -37
- package/dist/docs/hashmap.json +1 -1
- package/dist/docs/hillclimbing.html +37 -37
- package/dist/docs/index.html +37 -37
- package/dist/docs/llms-full.txt +652 -4
- package/dist/docs/llms.txt +1 -0
- package/dist/docs/quickstart.html +37 -37
- package/dist/docs/reference/access.html +36 -36
- package/dist/docs/reference/agent-config.html +37 -37
- package/dist/docs/reference/artifacts.html +37 -37
- package/dist/docs/reference/channels.html +38 -38
- package/dist/docs/reference/channels.md +1 -0
- package/dist/docs/reference/cli.html +50 -40
- package/dist/docs/reference/cli.md +116 -0
- package/dist/docs/reference/connections.html +37 -37
- package/dist/docs/reference/evals.html +37 -37
- package/dist/docs/reference/extensions.html +37 -37
- package/dist/docs/reference/hooks.html +37 -37
- package/dist/docs/reference/http-api.html +37 -37
- package/dist/docs/reference/instructions.html +37 -37
- package/dist/docs/reference/limits.html +39 -39
- package/dist/docs/reference/limits.md +4 -4
- package/dist/docs/reference/memory.html +37 -37
- package/dist/docs/reference/playground.html +36 -36
- package/dist/docs/reference/project-layout.html +37 -37
- package/dist/docs/reference/schedules.html +40 -40
- package/dist/docs/reference/sessions.html +38 -38
- package/dist/docs/reference/sessions.md +13 -0
- package/dist/docs/reference/skills.html +40 -40
- package/dist/docs/reference/subagents.html +37 -37
- package/dist/docs/reference/tools.html +37 -37
- package/dist/docs/templates/agentic-owners.html +37 -37
- package/dist/docs/templates/reviews.html +37 -37
- package/dist/docs/troubleshooting.html +38 -38
- package/dist/docs/troubleshooting.md +21 -0
- package/dist/evals/run-facts.d.ts.map +1 -1
- package/dist/evals/run-facts.js +4 -0
- package/dist/extensions/cursor-cloud-agents/channels/cursor-cloud-agents.d.ts +12 -0
- package/dist/extensions/cursor-cloud-agents/channels/cursor-cloud-agents.d.ts.map +1 -0
- package/dist/extensions/cursor-cloud-agents/channels/cursor-cloud-agents.js +42 -0
- package/dist/extensions/cursor-cloud-agents/extension.d.ts +10 -7
- package/dist/extensions/cursor-cloud-agents/extension.d.ts.map +1 -1
- package/dist/extensions/cursor-cloud-agents/extension.js +3 -2
- package/dist/extensions/cursor-cloud-agents/lib/agent-id.d.ts +5 -0
- package/dist/extensions/cursor-cloud-agents/lib/agent-id.d.ts.map +1 -0
- package/dist/extensions/cursor-cloud-agents/lib/agent-id.js +10 -0
- package/dist/extensions/cursor-cloud-agents/lib/backend.d.ts +57 -3
- package/dist/extensions/cursor-cloud-agents/lib/backend.d.ts.map +1 -1
- package/dist/extensions/cursor-cloud-agents/lib/backend.js +150 -35
- package/dist/extensions/cursor-cloud-agents/lib/fleet.d.ts +32 -4
- package/dist/extensions/cursor-cloud-agents/lib/fleet.d.ts.map +1 -1
- package/dist/extensions/cursor-cloud-agents/lib/fleet.js +93 -7
- package/dist/extensions/cursor-cloud-agents/lib/launch-agent.d.ts +24 -7
- package/dist/extensions/cursor-cloud-agents/lib/launch-agent.d.ts.map +1 -1
- package/dist/extensions/cursor-cloud-agents/lib/launch-agent.js +158 -25
- package/dist/extensions/cursor-cloud-agents/lib/stop-signal.d.ts +18 -0
- package/dist/extensions/cursor-cloud-agents/lib/stop-signal.d.ts.map +1 -0
- package/dist/extensions/cursor-cloud-agents/lib/stop-signal.js +27 -0
- package/dist/extensions/cursor-cloud-agents/lib/transcript.d.ts.map +1 -1
- package/dist/extensions/cursor-cloud-agents/lib/transcript.js +2 -3
- package/dist/extensions/cursor-cloud-agents/lib/watch.d.ts +26 -12
- package/dist/extensions/cursor-cloud-agents/lib/watch.d.ts.map +1 -1
- package/dist/extensions/cursor-cloud-agents/lib/watch.js +115 -46
- package/dist/extensions/cursor-cloud-agents/reminders/cloud-agent-stop-watch.d.ts +16 -5
- package/dist/extensions/cursor-cloud-agents/reminders/cloud-agent-stop-watch.d.ts.map +1 -1
- package/dist/extensions/cursor-cloud-agents/reminders/cloud-agent-stop-watch.js +76 -20
- package/dist/extensions/cursor-cloud-agents/skills/handoff.md +2 -2
- package/dist/extensions/cursor-cloud-agents/tools/get.js +2 -2
- package/dist/extensions/cursor-cloud-agents/tools/launch.js +1 -1
- package/dist/extensions.d.ts.map +1 -1
- package/dist/extensions.js +18 -3
- package/dist/files-backends/agent-store-presigned-url.js +5 -1
- package/dist/index.d.ts +1 -0
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +1 -0
- package/dist/internal/approval-gate.d.ts +6 -1
- package/dist/internal/approval-gate.d.ts.map +1 -1
- package/dist/internal/approval-gate.js +13 -2
- package/dist/internal/authored-loaders.js +1 -1
- package/dist/internal/channel-architecture.d.ts.map +1 -1
- package/dist/internal/channel-architecture.js +3 -1
- package/dist/internal/cli/commands/channels.d.ts +9 -3
- package/dist/internal/cli/commands/channels.d.ts.map +1 -1
- package/dist/internal/cli/commands/channels.js +193 -4
- package/dist/internal/cli/commands/index.d.ts.map +1 -1
- package/dist/internal/cli/commands/index.js +6 -1
- package/dist/internal/cli/commands/serve.d.ts.map +1 -1
- package/dist/internal/cli/commands/serve.js +25 -5
- package/dist/internal/cli/dispatch.d.ts.map +1 -1
- package/dist/internal/cli/dispatch.js +22 -8
- package/dist/internal/cli/flags.d.ts +14 -0
- package/dist/internal/cli/flags.d.ts.map +1 -1
- package/dist/internal/cli/flags.js +14 -0
- package/dist/internal/cli/help.d.ts.map +1 -1
- package/dist/internal/cli/help.js +3 -1
- package/dist/internal/cli-cursor.js +2 -2
- package/dist/internal/cli-deploy.d.ts +1 -0
- package/dist/internal/cli-deploy.d.ts.map +1 -1
- package/dist/internal/cli-deploy.js +31 -8
- package/dist/internal/cli-mcp.d.ts.map +1 -1
- package/dist/internal/cli-mcp.js +5 -3
- package/dist/internal/cli-teams-doctor.d.ts +39 -0
- package/dist/internal/cli-teams-doctor.d.ts.map +1 -0
- package/dist/internal/cli-teams-doctor.js +508 -0
- package/dist/internal/cli-teams-forward.d.ts +84 -0
- package/dist/internal/cli-teams-forward.d.ts.map +1 -0
- package/dist/internal/cli-teams-forward.js +386 -0
- package/dist/internal/cli-teams-package.d.ts +26 -0
- package/dist/internal/cli-teams-package.d.ts.map +1 -0
- package/dist/internal/cli-teams-package.js +123 -0
- package/dist/internal/cli-teams.d.ts +15 -0
- package/dist/internal/cli-teams.d.ts.map +1 -0
- package/dist/internal/cli-teams.js +253 -0
- package/dist/internal/connect-click.d.ts +12 -0
- package/dist/internal/connect-click.d.ts.map +1 -0
- package/dist/internal/connect-click.js +22 -0
- package/dist/internal/continuation-channel.d.ts +5 -1
- package/dist/internal/continuation-channel.d.ts.map +1 -1
- package/dist/internal/continuation-channel.js +34 -0
- package/dist/internal/continuation-identity.d.ts +7 -4
- package/dist/internal/continuation-identity.d.ts.map +1 -1
- package/dist/internal/continuation-identity.js +66 -1
- package/dist/internal/convert-automation/convert-workflow.js +2 -2
- package/dist/internal/credential-env-names.d.ts +36 -0
- package/dist/internal/credential-env-names.d.ts.map +1 -0
- package/dist/internal/credential-env-names.js +68 -0
- package/dist/internal/cursor/account-mcp.d.ts +67 -9
- package/dist/internal/cursor/account-mcp.d.ts.map +1 -1
- package/dist/internal/cursor/account-mcp.js +206 -25
- package/dist/internal/cursor/backend-client.d.ts +10 -1
- package/dist/internal/cursor/backend-client.d.ts.map +1 -1
- package/dist/internal/cursor/backend-client.js +19 -7
- package/dist/internal/cursor/cloud-agent-identity.d.ts +81 -0
- package/dist/internal/cursor/cloud-agent-identity.d.ts.map +1 -0
- package/dist/internal/cursor/cloud-agent-identity.js +224 -0
- package/dist/internal/cursor/credentials.d.ts.map +1 -1
- package/dist/internal/cursor/credentials.js +3 -1
- package/dist/internal/cursor-account-mcp-auth.d.ts +1 -0
- package/dist/internal/cursor-account-mcp-auth.d.ts.map +1 -1
- package/dist/internal/cursor-account-mcp-auth.js +2 -1
- package/dist/internal/deploy-client.d.ts.map +1 -1
- package/dist/internal/deploy-client.js +34 -2
- package/dist/internal/deploy-manifest.d.ts +51 -3
- package/dist/internal/deploy-manifest.d.ts.map +1 -1
- package/dist/internal/deploy-manifest.js +96 -7
- package/dist/internal/discovery/agent-config.d.ts.map +1 -1
- package/dist/internal/discovery/agent-config.js +6 -1
- package/dist/internal/discovery/connections.d.ts.map +1 -1
- package/dist/internal/discovery/connections.js +53 -0
- package/dist/internal/discovery/extensions.d.ts.map +1 -1
- package/dist/internal/discovery/extensions.js +2 -0
- package/dist/internal/discovery/info.d.ts.map +1 -1
- package/dist/internal/discovery/info.js +4 -0
- package/dist/internal/env-file.d.ts +1 -0
- package/dist/internal/env-file.d.ts.map +1 -1
- package/dist/internal/env-file.js +18 -17
- package/dist/internal/env-prefix.d.ts +11 -0
- package/dist/internal/env-prefix.d.ts.map +1 -0
- package/dist/internal/env-prefix.js +23 -0
- package/dist/internal/event-id-dedupe.d.ts +12 -0
- package/dist/internal/event-id-dedupe.d.ts.map +1 -0
- package/dist/{channels/slack → internal}/event-id-dedupe.js +7 -4
- package/dist/internal/event-mapper.d.ts +7 -2
- package/dist/internal/event-mapper.d.ts.map +1 -1
- package/dist/internal/event-mapper.js +7 -0
- package/dist/internal/expected-delivery-failure.d.ts.map +1 -1
- package/dist/internal/expected-delivery-failure.js +3 -0
- package/dist/internal/extension-namespace.d.ts +9 -0
- package/dist/internal/extension-namespace.d.ts.map +1 -0
- package/dist/internal/extension-namespace.js +14 -0
- package/dist/internal/guid.d.ts +2 -0
- package/dist/internal/guid.d.ts.map +1 -0
- package/dist/internal/guid.js +4 -0
- package/dist/internal/host-kv-cas.d.ts +13 -0
- package/dist/internal/host-kv-cas.d.ts.map +1 -0
- package/dist/internal/host-kv-cas.js +8 -0
- package/dist/internal/host-kv.d.ts +4 -1
- package/dist/internal/host-kv.d.ts.map +1 -1
- package/dist/internal/host-kv.js +15 -2
- package/dist/internal/hosted-catch-protocol.d.ts +5 -0
- package/dist/internal/hosted-catch-protocol.d.ts.map +1 -1
- package/dist/internal/hosted-catch-protocol.js +5 -0
- package/dist/internal/hosted-catch.d.ts +2 -0
- package/dist/internal/hosted-catch.d.ts.map +1 -1
- package/dist/internal/hosted-catch.js +6 -1
- package/dist/internal/hosted-delivery-protocol.d.ts +6 -0
- package/dist/internal/hosted-delivery-protocol.d.ts.map +1 -1
- package/dist/internal/hosted-delivery-protocol.js +71 -1
- package/dist/internal/hosted-delivery.d.ts +5 -2
- package/dist/internal/hosted-delivery.d.ts.map +1 -1
- package/dist/internal/hosted-delivery.js +36 -12
- package/dist/internal/hosted-execution-latency.d.ts +3 -0
- package/dist/internal/hosted-execution-latency.d.ts.map +1 -1
- package/dist/internal/hosted-execution-latency.js +11 -0
- package/dist/internal/hosted-session-fixture.js +1 -1
- package/dist/internal/hosting.d.ts +5 -0
- package/dist/internal/hosting.d.ts.map +1 -1
- package/dist/internal/hosting.js +7 -1
- package/dist/internal/install-cursor-skills.d.ts +6 -7
- package/dist/internal/install-cursor-skills.d.ts.map +1 -1
- package/dist/internal/install-cursor-skills.js +15 -9
- package/dist/internal/interview/agent-questions.d.ts +1 -1
- package/dist/internal/interview/agent-questions.d.ts.map +1 -1
- package/dist/internal/interview/agent-questions.js +4 -3
- package/dist/internal/local-control-plane.d.ts.map +1 -1
- package/dist/internal/local-control-plane.js +24 -0
- package/dist/internal/mcp-allowlist-in-use.d.ts +23 -0
- package/dist/internal/mcp-allowlist-in-use.d.ts.map +1 -0
- package/dist/internal/mcp-allowlist-in-use.js +93 -0
- package/dist/internal/mcp-endpoint.d.ts.map +1 -1
- package/dist/internal/mcp-endpoint.js +8 -10
- package/dist/internal/mcp-host.d.ts +19 -1
- package/dist/internal/mcp-host.d.ts.map +1 -1
- package/dist/internal/mcp-host.js +67 -3
- package/dist/internal/mcp-oauth.d.ts.map +1 -1
- package/dist/internal/mcp-oauth.js +5 -7
- package/dist/internal/oidcAudiences.d.ts +22 -0
- package/dist/internal/oidcAudiences.d.ts.map +1 -0
- package/dist/internal/oidcAudiences.js +35 -0
- package/dist/internal/otel/collector.d.ts.map +1 -1
- package/dist/internal/otel/collector.js +2 -0
- package/dist/internal/platform-timers.d.ts +2 -0
- package/dist/internal/platform-timers.d.ts.map +1 -1
- package/dist/internal/platform-timers.js +14 -0
- package/dist/internal/private-file.d.ts +32 -1
- package/dist/internal/private-file.d.ts.map +1 -1
- package/dist/internal/private-file.js +209 -7
- package/dist/internal/redact-values.d.ts +3 -0
- package/dist/internal/redact-values.d.ts.map +1 -0
- package/dist/internal/redact-values.js +19 -0
- package/dist/internal/reminder-control-plane-protocol.d.ts +7 -1
- package/dist/internal/reminder-control-plane-protocol.d.ts.map +1 -1
- package/dist/internal/reminder-followup-error.d.ts +23 -0
- package/dist/internal/reminder-followup-error.d.ts.map +1 -0
- package/dist/internal/reminder-followup-error.js +12 -0
- package/dist/internal/reminder-runner.d.ts +15 -1
- package/dist/internal/reminder-runner.d.ts.map +1 -1
- package/dist/internal/reminder-runner.js +95 -21
- package/dist/internal/resolved-connections.d.ts.map +1 -1
- package/dist/internal/resolved-connections.js +23 -3
- package/dist/internal/run-client.js +2 -1
- package/dist/internal/run-program.d.ts +31 -0
- package/dist/internal/run-program.d.ts.map +1 -0
- package/dist/internal/run-program.js +150 -0
- package/dist/internal/sdk-runner.d.ts +29 -3
- package/dist/internal/sdk-runner.d.ts.map +1 -1
- package/dist/internal/sdk-runner.js +304 -38
- package/dist/internal/server.d.ts.map +1 -1
- package/dist/internal/server.js +53 -8
- package/dist/internal/session-credential.d.ts +14 -0
- package/dist/internal/session-credential.d.ts.map +1 -0
- package/dist/internal/session-credential.js +25 -0
- package/dist/internal/session-engine.d.ts +137 -5
- package/dist/internal/session-engine.d.ts.map +1 -1
- package/dist/internal/session-engine.js +606 -92
- package/dist/internal/storage-coordinator.d.ts +3 -1
- package/dist/internal/storage-coordinator.d.ts.map +1 -1
- package/dist/internal/storage-coordinator.js +13 -0
- package/dist/internal/storage-roles.d.ts +9 -1
- package/dist/internal/storage-roles.d.ts.map +1 -1
- package/dist/internal/tcp-address.d.ts +3 -1
- package/dist/internal/tcp-address.d.ts.map +1 -1
- package/dist/internal/tcp-address.js +6 -0
- package/dist/internal/teams-channel-profile.d.ts +41 -0
- package/dist/internal/teams-channel-profile.d.ts.map +1 -0
- package/dist/internal/teams-channel-profile.js +91 -0
- package/dist/internal/teams-devtunnel.d.ts +55 -0
- package/dist/internal/teams-devtunnel.d.ts.map +1 -0
- package/dist/internal/teams-devtunnel.js +205 -0
- package/dist/internal/teams-tunnel-proxy.d.ts +17 -0
- package/dist/internal/teams-tunnel-proxy.d.ts.map +1 -0
- package/dist/internal/teams-tunnel-proxy.js +100 -0
- package/dist/internal/testing/conversation-identity-vectors.d.ts +7 -1
- package/dist/internal/testing/conversation-identity-vectors.d.ts.map +1 -1
- package/dist/internal/testing/conversation-identity-vectors.js +67 -0
- package/dist/internal/testing/hosted-http.d.ts +15 -0
- package/dist/internal/testing/hosted-http.d.ts.map +1 -0
- package/dist/internal/testing/hosted-http.js +86 -0
- package/dist/internal/testing/teams-activity-fixtures.d.ts +28 -0
- package/dist/internal/testing/teams-activity-fixtures.d.ts.map +1 -0
- package/dist/internal/testing/teams-activity-fixtures.js +236 -0
- package/dist/internal/testing/teams-doctor-fixtures.d.ts +76 -0
- package/dist/internal/testing/teams-doctor-fixtures.d.ts.map +1 -0
- package/dist/internal/testing/teams-doctor-fixtures.js +216 -0
- package/dist/internal/tunnel-process.d.ts +29 -0
- package/dist/internal/tunnel-process.d.ts.map +1 -0
- package/dist/internal/tunnel-process.js +105 -0
- package/dist/internal/turn-context.d.ts +28 -0
- package/dist/internal/turn-context.d.ts.map +1 -0
- package/dist/internal/turn-context.js +1 -0
- package/dist/oidc-token.d.ts +127 -0
- package/dist/oidc-token.d.ts.map +1 -0
- package/dist/oidc-token.js +221 -0
- package/dist/playground/assets/index-BaBSZXki.css +1 -0
- package/dist/playground/assets/index-BkAF8YlO.js +62 -0
- package/dist/playground/index.html +2 -2
- package/dist/teams-app-package.d.ts +78 -0
- package/dist/teams-app-package.d.ts.map +1 -0
- package/dist/teams-app-package.js +204 -0
- package/dist/tools.d.ts +1 -1
- package/dist/tools.d.ts.map +1 -1
- package/dist/types.d.ts +278 -2
- package/dist/types.d.ts.map +1 -1
- package/docs/changelog.md +51 -0
- package/docs/deployment.md +10 -0
- package/docs/guides/cloud-agents.md +47 -0
- package/docs/guides/teams.md +389 -0
- package/docs/reference/channels.md +1 -0
- package/docs/reference/cli.md +116 -0
- package/docs/reference/limits.md +4 -4
- package/docs/reference/sessions.md +13 -0
- package/docs/troubleshooting.md +21 -0
- package/package.json +21 -46
- package/skills/create-agent/SKILL.md +17 -4
- package/skills/debug/SKILL.md +1 -0
- package/skills/deploy/SKILL.md +1 -1
- package/skills/framework-map/SKILL.md +1 -0
- package/skills/setup-teams/SKILL.md +141 -0
- package/templates/agentic-owners/bot/lib/owners/parse.ts +1 -0
- package/dist/channels/slack/event-id-dedupe.d.ts +0 -10
- package/dist/channels/slack/event-id-dedupe.d.ts.map +0 -1
- package/dist/docs/assets/changelog.md.BMrJ5WxW.js +0 -1
- package/dist/docs/assets/chunks/@localSearchIndexroot.dUaE1f8e.js +0 -1
- package/dist/docs/assets/chunks/channel.ljJtQtBi.js +0 -1
- package/dist/docs/assets/chunks/classDiagram-6PBFFD2Q.BZ3Uc-XU.js +0 -1
- package/dist/docs/assets/chunks/classDiagram-v2-HSJHXN6E.BZ3Uc-XU.js +0 -1
- package/dist/docs/assets/chunks/clone.BDtbEo69.js +0 -1
- package/dist/docs/assets/chunks/stateDiagram-v2-QKLJ7IA2.CbhzVsQE.js +0 -1
- package/dist/docs/assets/chunks/wardley-RL74JXVD.BFIVMaoi.js +0 -162
- package/dist/docs/assets/guides_cloud-agents.md.CiXAW6on.js +0 -9
- package/dist/docs/assets/troubleshooting.md.DfKKvW1R.js +0 -3
- package/dist/playground/assets/index-D0-FHg1x.css +0 -1
- package/dist/playground/assets/index-D5SLKUy6.js +0 -62
- /package/dist/docs/assets/{reference_channels.md.CPWOpdsC.lean.js → reference_channels.md.CRvqgU0n.lean.js} +0 -0
- /package/dist/docs/assets/{reference_schedules.md.RhQ9ZLo1.lean.js → reference_schedules.md.Dd8_d0WG.lean.js} +0 -0
|
@@ -0,0 +1,68 @@
|
|
|
1
|
+
import { validateSecretName } from "./hosting.js";
|
|
2
|
+
/**
|
|
3
|
+
* Why `keys` cannot be deployment secret names, or undefined when they fit.
|
|
4
|
+
* A bad prefix fails here, with the channel id and the name, instead of
|
|
5
|
+
* as a schema rejection of the whole manifest or a refused secret write.
|
|
6
|
+
*/
|
|
7
|
+
export function credentialEnvNameError(channelId, env) {
|
|
8
|
+
for (const key of Object.values(env.keys)) {
|
|
9
|
+
const error = validateSecretName(key);
|
|
10
|
+
if (error !== undefined) {
|
|
11
|
+
const prefix = env.envPrefix === "" ? "(none)" : env.envPrefix;
|
|
12
|
+
return `channels/${channelId}: envPrefix ${prefix} makes credential env name ${JSON.stringify(key)} invalid. ${error}`;
|
|
13
|
+
}
|
|
14
|
+
}
|
|
15
|
+
return undefined;
|
|
16
|
+
}
|
|
17
|
+
/**
|
|
18
|
+
* Stored secret names that are the same credential under a different prefix
|
|
19
|
+
* than a channel reads. A missing name is not a mismatch. The result names
|
|
20
|
+
* only secret names, never values.
|
|
21
|
+
*/
|
|
22
|
+
export function credentialEnvMismatch(channels, stored) {
|
|
23
|
+
const storedSet = new Set(stored);
|
|
24
|
+
const declaredKeys = new Set(channels.flatMap((channel) => Object.values(channel.keys)));
|
|
25
|
+
const mismatchedStored = [];
|
|
26
|
+
const expected = [];
|
|
27
|
+
for (const channel of channels) {
|
|
28
|
+
for (const key of Object.values(channel.keys)) {
|
|
29
|
+
if (storedSet.has(key)) {
|
|
30
|
+
continue;
|
|
31
|
+
}
|
|
32
|
+
const suffix = suffixAfterPrefix(channel.envPrefix, key);
|
|
33
|
+
if (suffix === undefined) {
|
|
34
|
+
continue;
|
|
35
|
+
}
|
|
36
|
+
for (const name of stored) {
|
|
37
|
+
// A name that is some channel's key is already the right prefix.
|
|
38
|
+
if (declaredKeys.has(name)) {
|
|
39
|
+
continue;
|
|
40
|
+
}
|
|
41
|
+
if (name === suffix || name.endsWith(`_${suffix}`)) {
|
|
42
|
+
mismatchedStored.push(name);
|
|
43
|
+
expected.push(key);
|
|
44
|
+
}
|
|
45
|
+
}
|
|
46
|
+
}
|
|
47
|
+
}
|
|
48
|
+
return {
|
|
49
|
+
stored: [...new Set(mismatchedStored)].sort(),
|
|
50
|
+
expected: [...new Set(expected)].sort(),
|
|
51
|
+
};
|
|
52
|
+
}
|
|
53
|
+
export function formatCredentialEnvMismatch(args) {
|
|
54
|
+
const { stored, expected } = args.mismatch;
|
|
55
|
+
return (`warning: secrets stored on ${args.slug} do not match the credential env names the channels read: ${stored.join(", ")}\n` +
|
|
56
|
+
` the channels read ${expected.join(", ")}\n` +
|
|
57
|
+
` set them with \`${args.command} secret set ${args.slug} ${expected.join(" ")}\`\n`);
|
|
58
|
+
}
|
|
59
|
+
function suffixAfterPrefix(envPrefix, key) {
|
|
60
|
+
if (envPrefix === "") {
|
|
61
|
+
return key;
|
|
62
|
+
}
|
|
63
|
+
const marked = `${envPrefix}_`;
|
|
64
|
+
if (!key.startsWith(marked) || key.length === marked.length) {
|
|
65
|
+
return undefined;
|
|
66
|
+
}
|
|
67
|
+
return key.slice(marked.length);
|
|
68
|
+
}
|
|
@@ -13,7 +13,8 @@
|
|
|
13
13
|
* (so `servers` filters apply there too); without one they omit the bridge
|
|
14
14
|
* and fall back to the account's natively hydrated connectors.
|
|
15
15
|
*/
|
|
16
|
-
import
|
|
16
|
+
import type { TurnContextLookup } from "../turn-context.js";
|
|
17
|
+
import { type AgentProject, type AuthPolicy, type ConnectionCredentialMode } from "../../types.js";
|
|
17
18
|
import type { EngineResolvedConnection } from "../session-engine.js";
|
|
18
19
|
import { type TerminalPalette } from "../terminal-style.js";
|
|
19
20
|
import type { AccountMcpCallResult, AccountMcpServer, CursorBackendClient } from "./backend-client.js";
|
|
@@ -26,6 +27,8 @@ export interface CursorAccountConnectionRef {
|
|
|
26
27
|
name: string;
|
|
27
28
|
/** Connector-name filter, or undefined for every connected server. */
|
|
28
29
|
servers?: string[];
|
|
30
|
+
/** Whose account the connection uses. Omitted means the deployment's sign-in. */
|
|
31
|
+
credentials?: ConnectionCredentialMode;
|
|
29
32
|
}
|
|
30
33
|
/**
|
|
31
34
|
* Collect `cursorAccount` connections across `mounts`, grouped by mount
|
|
@@ -38,6 +41,13 @@ export declare function collectCursorAccountConnections(mounts: Array<{
|
|
|
38
41
|
}>): Map<string, CursorAccountConnectionRef[]>;
|
|
39
42
|
/** Bridge mount path for one account MCP connection, relative to the agent base. */
|
|
40
43
|
export declare function cursorAccountMcpPath(connectionName: string): string;
|
|
44
|
+
/**
|
|
45
|
+
* Sign-in discovery for one account MCP connection, relative to the agent
|
|
46
|
+
* base. It is the protected-resource document a 401 names and the issuer
|
|
47
|
+
* that document names; the issuer's OpenID document sits below it.
|
|
48
|
+
*/
|
|
49
|
+
export declare function cursorAccountSignInPath(connectionName: string): string;
|
|
50
|
+
export declare function cursorAccountSignInIssuerPath(connectionName: string): string;
|
|
41
51
|
/**
|
|
42
52
|
* Resolve account refs to engine connections once the server is listening.
|
|
43
53
|
* Local turns and host-side `ctx.host.mcp` reach the loopback bridge with
|
|
@@ -50,16 +60,22 @@ export declare function resolveCursorAccountConnections(args: {
|
|
|
50
60
|
serverUrl: string;
|
|
51
61
|
basePath: string;
|
|
52
62
|
bridgeSecret: string;
|
|
63
|
+
/** The bearer of one session's connections; see {@link CursorAccountMcpBridge.sessionBearer}. */
|
|
64
|
+
sessionBearer: (sessionId: string) => string;
|
|
53
65
|
publicUrl?: string;
|
|
54
66
|
}): EngineResolvedConnection[];
|
|
55
67
|
export declare class CursorAccountMcpBridge {
|
|
56
68
|
/** Per-boot shared secret; resolved connections carry it as a bearer. */
|
|
57
69
|
readonly secret: string;
|
|
70
|
+
/** Signs session bearers. Never sent, so holding {@link secret} mints none. */
|
|
71
|
+
private readonly sessionBearers;
|
|
58
72
|
private readonly client;
|
|
59
73
|
private readonly logger;
|
|
60
74
|
private readonly palette;
|
|
61
75
|
private readonly secretPolicy;
|
|
62
76
|
private readonly allowRemoteCallers;
|
|
77
|
+
private readonly turnContextFor;
|
|
78
|
+
private readonly turnSessionKeyFor;
|
|
63
79
|
private readonly catalogs;
|
|
64
80
|
constructor(args: {
|
|
65
81
|
client: CursorBackendClient;
|
|
@@ -72,11 +88,32 @@ export declare class CursorAccountMcpBridge {
|
|
|
72
88
|
* through it); otherwise the bridge stays strictly loopback-only.
|
|
73
89
|
*/
|
|
74
90
|
allowRemoteCallers?: boolean;
|
|
91
|
+
/** The running turn's context for a session, whose user an individual connection dials as. */
|
|
92
|
+
turnContextFor?: TurnContextLookup;
|
|
93
|
+
/** The mailbox key the running turn's user was signed under. */
|
|
94
|
+
turnSessionKeyFor?: (sessionId: string) => string | undefined;
|
|
75
95
|
});
|
|
76
96
|
/**
|
|
77
|
-
*
|
|
78
|
-
*
|
|
79
|
-
*
|
|
97
|
+
* Every call names its connection, so the backend applies the mode the
|
|
98
|
+
* manifest declares. An individual connection also carries the running
|
|
99
|
+
* turn's user as the backend signed it, and the mailbox key it was signed
|
|
100
|
+
* under so the backend can check it is this session's. The pod never reads
|
|
101
|
+
* the signature.
|
|
102
|
+
*/
|
|
103
|
+
private turnHeaders;
|
|
104
|
+
/**
|
|
105
|
+
* The bearer one session's connections carry. Only it lets a request dial
|
|
106
|
+
* as that session's turn user, so holding the per-boot secret, or another
|
|
107
|
+
* session's bearer, never reaches this session's user.
|
|
108
|
+
*/
|
|
109
|
+
sessionBearer(sessionId: string): string;
|
|
110
|
+
/** Whether `request` presents the bearer of the session its URL names. */
|
|
111
|
+
private presentsSessionBearer;
|
|
112
|
+
/**
|
|
113
|
+
* Route auth for the bridge: the per-boot bearer secret, or the bearer of
|
|
114
|
+
* the session the URL names, from a loopback TCP peer — or from anywhere
|
|
115
|
+
* when the serve host exposed the bridge via `publicUrl` (cloud turns
|
|
116
|
+
* arrive through that ingress with the secret).
|
|
80
117
|
*/
|
|
81
118
|
authPolicy(): AuthPolicy;
|
|
82
119
|
/**
|
|
@@ -93,19 +130,40 @@ export declare class CursorAccountMcpBridge {
|
|
|
93
130
|
* Returns a promise that settles when every ref's log lines are written —
|
|
94
131
|
* callers may ignore it; tests can await it.
|
|
95
132
|
*/
|
|
96
|
-
probeAuthUrl(ref: CursorAccountConnectionRef): Promise<string | undefined>;
|
|
133
|
+
probeAuthUrl(ref: CursorAccountConnectionRef, sessionId?: string): Promise<string | undefined>;
|
|
97
134
|
logPreflight(refs: CursorAccountConnectionRef[]): Promise<void>;
|
|
98
135
|
private runPreflight;
|
|
136
|
+
/**
|
|
137
|
+
* `turnSessionId` is the session whose turn user this request may dial as:
|
|
138
|
+
* the URL's session when the request carries that session's bearer, else
|
|
139
|
+
* none.
|
|
140
|
+
*/
|
|
99
141
|
private buildServer;
|
|
142
|
+
private signedIndividual;
|
|
143
|
+
/** Whether the session's turn user has connected every server of an individual connection. */
|
|
144
|
+
individualConnected(ref: CursorAccountConnectionRef, sessionId: string): Promise<boolean>;
|
|
145
|
+
/** Discovery reads carry no bearer and hold nothing secret, so loopback is enough. */
|
|
146
|
+
signInDiscoveryPolicy(): AuthPolicy;
|
|
100
147
|
/** Resolve a tool by exposed name, refreshing once when it is unknown. */
|
|
101
148
|
private findTool;
|
|
102
149
|
/**
|
|
103
|
-
* Fetch (or join) the catalog for `ref`'s server filter.
|
|
104
|
-
*
|
|
105
|
-
*
|
|
150
|
+
* Fetch (or join) the catalog for `ref`'s server filter. An individual
|
|
151
|
+
* connection's catalog is the turn's user's, so it is cached per user.
|
|
152
|
+
* Staleness and joining are decided synchronously: in-flight entries
|
|
153
|
+
* always join their promise; fresh entries use
|
|
154
|
+
* {@link CatalogEntry.freshAtMs} for TTL.
|
|
106
155
|
*/
|
|
107
156
|
private getCatalog;
|
|
108
157
|
}
|
|
158
|
+
/**
|
|
159
|
+
* The sign-in discovery documents. On a 401 the MCP client runs OAuth
|
|
160
|
+
* discovery: when it finds no authorization server it fails the connection
|
|
161
|
+
* as an error, and when it finds one without client registration it stops at
|
|
162
|
+
* needing sign-in, which is what makes the agent offer `mcp_auth`. Nothing
|
|
163
|
+
* calls the `authorize`, `token` or `jwks` URLs named here: the host answers
|
|
164
|
+
* `mcp_auth` itself, and sign-in happens through the connection's Connect link.
|
|
165
|
+
*/
|
|
166
|
+
export declare function cursorAccountSignInDiscovery(request: Request): Response;
|
|
109
167
|
export interface CursorAccountMcpWarningServer {
|
|
110
168
|
serverIdentifier: string;
|
|
111
169
|
status: string;
|
|
@@ -131,5 +189,5 @@ export declare function formatServerStatusSummary(server: AccountMcpServer, erro
|
|
|
131
189
|
* returns the status enum today, so probe ExecuteSandMcpTool (ping) and surface
|
|
132
190
|
* the backend failure text (e.g. `HTTP MCP tool execution failed: fetch failed`).
|
|
133
191
|
*/
|
|
134
|
-
export declare function diagnoseConnectorError(client: Pick<CursorBackendClient, "executeAccountMcpTool">, serverIdentifier: string): Promise<string | undefined>;
|
|
192
|
+
export declare function diagnoseConnectorError(client: Pick<CursorBackendClient, "executeAccountMcpTool">, serverIdentifier: string, turnHeaders?: Record<string, string>): Promise<string | undefined>;
|
|
135
193
|
//# sourceMappingURL=account-mcp.d.ts.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"account-mcp.d.ts","sourceRoot":"","sources":["../../../src/internal/cursor/account-mcp.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAMH,OAAO,EACL,KAAK,YAAY,EACjB,KAAK,UAAU,
|
|
1
|
+
{"version":3,"file":"account-mcp.d.ts","sourceRoot":"","sources":["../../../src/internal/cursor/account-mcp.ts"],"names":[],"mappings":"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"}
|
|
@@ -24,7 +24,12 @@ import { LOG_PREFIX } from "../distribution.js";
|
|
|
24
24
|
import { handleStatelessMcpRequest } from "../mcp-endpoint.js";
|
|
25
25
|
import { isLoopbackAddress } from "../net.js";
|
|
26
26
|
import { sanitizeMcpToolName, suffixMcpToolName } from "../sanitize-mcp-tool-name.js";
|
|
27
|
+
import { SessionCredentials } from "../session-credential.js";
|
|
27
28
|
import { colorEnabledFor, formatTerminalBox, stdoutPalette, terminalHyperlink, } from "../terminal-style.js";
|
|
29
|
+
const MCP_CONNECTION_HEADER = "x-cursor-mcp-connection";
|
|
30
|
+
const MCP_USER_ID_HEADER = "x-cursor-mcp-user-id";
|
|
31
|
+
const MCP_SIGNATURE_HEADER = "x-cursor-mcp-signature";
|
|
32
|
+
const MCP_SESSION_HEADER = "x-cursor-mcp-session";
|
|
28
33
|
/** Catalog freshness window; a miss inside it re-uses the cached listing. */
|
|
29
34
|
const CATALOG_TTL_MS = 60_000;
|
|
30
35
|
/**
|
|
@@ -57,6 +62,7 @@ export function collectCursorAccountConnections(mounts) {
|
|
|
57
62
|
...(connection.transport.servers === undefined
|
|
58
63
|
? {}
|
|
59
64
|
: { servers: [...connection.transport.servers] }),
|
|
65
|
+
credentials: connection.credentials,
|
|
60
66
|
});
|
|
61
67
|
}
|
|
62
68
|
if (refs.length > 0) {
|
|
@@ -69,6 +75,18 @@ export function collectCursorAccountConnections(mounts) {
|
|
|
69
75
|
export function cursorAccountMcpPath(connectionName) {
|
|
70
76
|
return `/v1/cursor-account/${connectionName}/mcp`;
|
|
71
77
|
}
|
|
78
|
+
/**
|
|
79
|
+
* Sign-in discovery for one account MCP connection, relative to the agent
|
|
80
|
+
* base. It is the protected-resource document a 401 names and the issuer
|
|
81
|
+
* that document names; the issuer's OpenID document sits below it.
|
|
82
|
+
*/
|
|
83
|
+
export function cursorAccountSignInPath(connectionName) {
|
|
84
|
+
return `/v1/cursor-account/${connectionName}/sign-in`;
|
|
85
|
+
}
|
|
86
|
+
const OPENID_CONFIGURATION_SUFFIX = "/.well-known/openid-configuration";
|
|
87
|
+
export function cursorAccountSignInIssuerPath(connectionName) {
|
|
88
|
+
return `${cursorAccountSignInPath(connectionName)}${OPENID_CONFIGURATION_SUFFIX}`;
|
|
89
|
+
}
|
|
72
90
|
/**
|
|
73
91
|
* Resolve account refs to engine connections once the server is listening.
|
|
74
92
|
* Local turns and host-side `ctx.host.mcp` reach the loopback bridge with
|
|
@@ -88,24 +106,70 @@ export function resolveCursorAccountConnections(args) {
|
|
|
88
106
|
cloudUrl: `${publicBase}${args.basePath}${cursorAccountMcpPath(ref.name)}`,
|
|
89
107
|
}),
|
|
90
108
|
headers,
|
|
109
|
+
sessionHeaders: (sessionId) => ({
|
|
110
|
+
authorization: `Bearer ${args.sessionBearer(sessionId)}`,
|
|
111
|
+
}),
|
|
91
112
|
...(ref.servers === undefined ? {} : { accountServersFilter: ref.servers }),
|
|
113
|
+
individualCredentials: ref.credentials === "individual" ? true : undefined,
|
|
92
114
|
}));
|
|
93
115
|
}
|
|
94
116
|
export class CursorAccountMcpBridge {
|
|
95
117
|
constructor(args) {
|
|
96
118
|
/** Per-boot shared secret; resolved connections carry it as a bearer. */
|
|
97
119
|
this.secret = randomBytes(32).toString("hex");
|
|
120
|
+
/** Signs session bearers. Never sent, so holding {@link secret} mints none. */
|
|
121
|
+
this.sessionBearers = new SessionCredentials();
|
|
98
122
|
this.catalogs = new Map();
|
|
99
123
|
this.client = args.client;
|
|
100
124
|
this.logger = args.logger ?? (() => { });
|
|
101
125
|
this.palette = args.palette ?? stdoutPalette();
|
|
102
126
|
this.secretPolicy = bearerAuth(this.secret);
|
|
103
127
|
this.allowRemoteCallers = args.allowRemoteCallers === true;
|
|
128
|
+
this.turnContextFor = args.turnContextFor;
|
|
129
|
+
this.turnSessionKeyFor = args.turnSessionKeyFor;
|
|
130
|
+
}
|
|
131
|
+
/**
|
|
132
|
+
* Every call names its connection, so the backend applies the mode the
|
|
133
|
+
* manifest declares. An individual connection also carries the running
|
|
134
|
+
* turn's user as the backend signed it, and the mailbox key it was signed
|
|
135
|
+
* under so the backend can check it is this session's. The pod never reads
|
|
136
|
+
* the signature.
|
|
137
|
+
*/
|
|
138
|
+
turnHeaders(ref, sessionId) {
|
|
139
|
+
const headers = { [MCP_CONNECTION_HEADER]: ref.name };
|
|
140
|
+
if (ref.credentials !== "individual" || sessionId === "") {
|
|
141
|
+
return headers;
|
|
142
|
+
}
|
|
143
|
+
const user = this.turnContextFor?.(sessionId)?.user;
|
|
144
|
+
const sessionKey = this.turnSessionKeyFor?.(sessionId);
|
|
145
|
+
if (user !== undefined && sessionKey !== undefined) {
|
|
146
|
+
headers[MCP_USER_ID_HEADER] = String(user.id);
|
|
147
|
+
headers[MCP_SIGNATURE_HEADER] = user.signature;
|
|
148
|
+
headers[MCP_SESSION_HEADER] = sessionKey;
|
|
149
|
+
}
|
|
150
|
+
return headers;
|
|
151
|
+
}
|
|
152
|
+
/**
|
|
153
|
+
* The bearer one session's connections carry. Only it lets a request dial
|
|
154
|
+
* as that session's turn user, so holding the per-boot secret, or another
|
|
155
|
+
* session's bearer, never reaches this session's user.
|
|
156
|
+
*/
|
|
157
|
+
sessionBearer(sessionId) {
|
|
158
|
+
return this.sessionBearers.for(sessionId);
|
|
159
|
+
}
|
|
160
|
+
/** Whether `request` presents the bearer of the session its URL names. */
|
|
161
|
+
presentsSessionBearer(request, sessionId) {
|
|
162
|
+
const header = request.headers.get("authorization");
|
|
163
|
+
if (header === null || !header.toLowerCase().startsWith("bearer ")) {
|
|
164
|
+
return false;
|
|
165
|
+
}
|
|
166
|
+
return this.sessionBearers.verifies(sessionId, header.slice("bearer ".length).trim());
|
|
104
167
|
}
|
|
105
168
|
/**
|
|
106
|
-
* Route auth for the bridge: the per-boot bearer secret,
|
|
107
|
-
*
|
|
108
|
-
*
|
|
169
|
+
* Route auth for the bridge: the per-boot bearer secret, or the bearer of
|
|
170
|
+
* the session the URL names, from a loopback TCP peer — or from anywhere
|
|
171
|
+
* when the serve host exposed the bridge via `publicUrl` (cloud turns
|
|
172
|
+
* arrive through that ingress with the secret).
|
|
109
173
|
*/
|
|
110
174
|
authPolicy() {
|
|
111
175
|
return async (request, info) => {
|
|
@@ -113,7 +177,9 @@ export class CursorAccountMcpBridge {
|
|
|
113
177
|
if (!loopback && !this.allowRemoteCallers) {
|
|
114
178
|
return null;
|
|
115
179
|
}
|
|
116
|
-
|
|
180
|
+
const sessionId = new URL(request.url).searchParams.get("agentkitSessionId") ?? "";
|
|
181
|
+
if (!this.presentsSessionBearer(request, sessionId) &&
|
|
182
|
+
(await this.secretPolicy(request, info)) === null) {
|
|
117
183
|
return null;
|
|
118
184
|
}
|
|
119
185
|
return {
|
|
@@ -127,11 +193,18 @@ export class CursorAccountMcpBridge {
|
|
|
127
193
|
* Handle one streamable-HTTP MCP request for the connection described by
|
|
128
194
|
* `ref` (stateless: fresh server per POST, like the per-agent endpoint).
|
|
129
195
|
*/
|
|
130
|
-
handle(request, ref, decorate) {
|
|
196
|
+
async handle(request, ref, decorate) {
|
|
131
197
|
const sessionId = new URL(request.url).searchParams.get("agentkitSessionId") ?? "";
|
|
132
|
-
|
|
198
|
+
const turnSessionId = this.presentsSessionBearer(request, sessionId) ? sessionId : "";
|
|
199
|
+
const individualCatalog = this.signedIndividual(ref, turnSessionId)
|
|
200
|
+
? await this.getCatalog(ref, turnSessionId)
|
|
201
|
+
: undefined;
|
|
202
|
+
if (individualCatalog !== undefined && needsSignIn(individualCatalog)) {
|
|
203
|
+
return signInRequired(request);
|
|
204
|
+
}
|
|
205
|
+
return await handleStatelessMcpRequest({
|
|
133
206
|
request,
|
|
134
|
-
buildServer: () => this.buildServer(ref, sessionId, decorate),
|
|
207
|
+
buildServer: () => this.buildServer(ref, { sessionId, turnSessionId, individualCatalog }, decorate),
|
|
135
208
|
label: "cursor account bridge",
|
|
136
209
|
logger: this.logger,
|
|
137
210
|
});
|
|
@@ -145,14 +218,16 @@ export class CursorAccountMcpBridge {
|
|
|
145
218
|
* Returns a promise that settles when every ref's log lines are written —
|
|
146
219
|
* callers may ignore it; tests can await it.
|
|
147
220
|
*/
|
|
148
|
-
async probeAuthUrl(ref) {
|
|
221
|
+
async probeAuthUrl(ref, sessionId = "") {
|
|
222
|
+
const turnHeaders = this.turnHeaders(ref, sessionId);
|
|
149
223
|
const identifiers = ref.servers !== undefined && ref.servers.length > 0
|
|
150
224
|
? [...ref.servers]
|
|
151
|
-
: (await this.client.getAvailableMcpServers()).map((server) => server.serverIdentifier ?? server.name);
|
|
225
|
+
: (await this.client.getAvailableMcpServers({ turnHeaders })).map((server) => server.serverIdentifier ?? server.name);
|
|
152
226
|
const urls = await probeConnectorAuthUrls({
|
|
153
227
|
client: this.client,
|
|
154
228
|
identifiers,
|
|
155
229
|
userInitiated: undefined,
|
|
230
|
+
turnHeaders,
|
|
156
231
|
});
|
|
157
232
|
for (const url of urls.values()) {
|
|
158
233
|
if (url !== "") {
|
|
@@ -166,7 +241,8 @@ export class CursorAccountMcpBridge {
|
|
|
166
241
|
}
|
|
167
242
|
async runPreflight(ref) {
|
|
168
243
|
try {
|
|
169
|
-
const
|
|
244
|
+
const turnHeaders = this.turnHeaders(ref, "");
|
|
245
|
+
const catalog = await this.getCatalog(ref, "");
|
|
170
246
|
const errorDetails = new Map();
|
|
171
247
|
const needsAuthNames = catalog.servers
|
|
172
248
|
.filter((server) => server.status === "needsAuth")
|
|
@@ -176,11 +252,12 @@ export class CursorAccountMcpBridge {
|
|
|
176
252
|
client: this.client,
|
|
177
253
|
identifiers: needsAuthNames,
|
|
178
254
|
userInitiated: false,
|
|
255
|
+
turnHeaders,
|
|
179
256
|
}),
|
|
180
257
|
Promise.all(catalog.servers
|
|
181
258
|
.filter((server) => server.status === "error")
|
|
182
259
|
.map(async (server) => {
|
|
183
|
-
const detail = await diagnoseConnectorError(this.client, server.serverIdentifier);
|
|
260
|
+
const detail = await diagnoseConnectorError(this.client, server.serverIdentifier, turnHeaders);
|
|
184
261
|
if (detail !== undefined) {
|
|
185
262
|
errorDetails.set(server.serverIdentifier, detail);
|
|
186
263
|
}
|
|
@@ -210,13 +287,18 @@ export class CursorAccountMcpBridge {
|
|
|
210
287
|
this.logger(`${LOG_PREFIX} Cursor account MCP connection "${ref.name}" preflight failed: ${describeError(error)}`);
|
|
211
288
|
}
|
|
212
289
|
}
|
|
213
|
-
|
|
290
|
+
/**
|
|
291
|
+
* `turnSessionId` is the session whose turn user this request may dial as:
|
|
292
|
+
* the URL's session when the request carries that session's bearer, else
|
|
293
|
+
* none.
|
|
294
|
+
*/
|
|
295
|
+
buildServer(ref, { sessionId, turnSessionId, individualCatalog, }, decorate) {
|
|
214
296
|
const server = new Server({ name: `cursor-account:${ref.name}`, version: "0.1.0" }, {
|
|
215
297
|
capabilities: { tools: {} },
|
|
216
298
|
instructions: "Tools from the Cursor account's MCP connectors. Every call executes on the Cursor backend with the account's stored credentials.",
|
|
217
299
|
});
|
|
218
300
|
server.setRequestHandler(ListToolsRequestSchema, async () => {
|
|
219
|
-
const catalog = await this.getCatalog(ref);
|
|
301
|
+
const catalog = individualCatalog ?? (await this.getCatalog(ref, turnSessionId));
|
|
220
302
|
return {
|
|
221
303
|
tools: catalog.tools.map((tool) => ({
|
|
222
304
|
name: tool.exposedName,
|
|
@@ -230,9 +312,9 @@ export class CursorAccountMcpBridge {
|
|
|
230
312
|
};
|
|
231
313
|
});
|
|
232
314
|
server.setRequestHandler(CallToolRequestSchema, async (request) => {
|
|
233
|
-
const tool = await this.findTool(ref, request.params.name);
|
|
315
|
+
const tool = await this.findTool(ref, request.params.name, turnSessionId);
|
|
234
316
|
if (tool === undefined) {
|
|
235
|
-
const catalog = await this.getCatalog(ref);
|
|
317
|
+
const catalog = await this.getCatalog(ref, turnSessionId);
|
|
236
318
|
const unhealthy = catalog.servers.filter((server) => server.status !== "connected");
|
|
237
319
|
const statusHint = unhealthy.length === 0
|
|
238
320
|
? ""
|
|
@@ -254,6 +336,7 @@ export class CursorAccountMcpBridge {
|
|
|
254
336
|
serverIdentifier: tool.serverIdentifier,
|
|
255
337
|
toolName: tool.backendName,
|
|
256
338
|
args: request.params.arguments ?? {},
|
|
339
|
+
turnHeaders: this.turnHeaders(ref, turnSessionId),
|
|
257
340
|
});
|
|
258
341
|
const decorated = decorate === undefined ? executed : decorate(sessionId, executed);
|
|
259
342
|
return {
|
|
@@ -276,23 +359,52 @@ export class CursorAccountMcpBridge {
|
|
|
276
359
|
});
|
|
277
360
|
return server;
|
|
278
361
|
}
|
|
362
|
+
signedIndividual(ref, turnSessionId) {
|
|
363
|
+
return (ref.credentials === "individual" &&
|
|
364
|
+
turnSessionId !== "" &&
|
|
365
|
+
this.turnContextFor?.(turnSessionId)?.user !== undefined);
|
|
366
|
+
}
|
|
367
|
+
/** Whether the session's turn user has connected every server of an individual connection. */
|
|
368
|
+
async individualConnected(ref, sessionId) {
|
|
369
|
+
if (ref.credentials !== "individual" || this.turnContextFor?.(sessionId)?.user === undefined) {
|
|
370
|
+
return false;
|
|
371
|
+
}
|
|
372
|
+
const catalog = await this.getCatalog(ref, sessionId, { forceRefresh: true });
|
|
373
|
+
return (catalog.servers.length > 0 && catalog.servers.every((server) => server.status === "connected"));
|
|
374
|
+
}
|
|
375
|
+
/** Discovery reads carry no bearer and hold nothing secret, so loopback is enough. */
|
|
376
|
+
signInDiscoveryPolicy() {
|
|
377
|
+
return (_request, info) => this.allowRemoteCallers || (info.requestIp !== null && isLoopbackAddress(info.requestIp))
|
|
378
|
+
? {
|
|
379
|
+
authenticator: "cursor-account-bridge",
|
|
380
|
+
principalId: "cursor-account-bridge",
|
|
381
|
+
principalType: "runtime",
|
|
382
|
+
}
|
|
383
|
+
: null;
|
|
384
|
+
}
|
|
279
385
|
/** Resolve a tool by exposed name, refreshing once when it is unknown. */
|
|
280
|
-
async findTool(ref, exposedName) {
|
|
281
|
-
const catalog = await this.getCatalog(ref);
|
|
386
|
+
async findTool(ref, exposedName, sessionId) {
|
|
387
|
+
const catalog = await this.getCatalog(ref, sessionId);
|
|
282
388
|
const hit = catalog.byExposedName.get(exposedName);
|
|
283
389
|
if (hit !== undefined) {
|
|
284
390
|
return hit;
|
|
285
391
|
}
|
|
286
|
-
const fresh = await this.getCatalog(ref, { forceRefresh: true });
|
|
392
|
+
const fresh = await this.getCatalog(ref, sessionId, { forceRefresh: true });
|
|
287
393
|
return fresh.byExposedName.get(exposedName);
|
|
288
394
|
}
|
|
289
395
|
/**
|
|
290
|
-
* Fetch (or join) the catalog for `ref`'s server filter.
|
|
291
|
-
*
|
|
292
|
-
*
|
|
396
|
+
* Fetch (or join) the catalog for `ref`'s server filter. An individual
|
|
397
|
+
* connection's catalog is the turn's user's, so it is cached per user.
|
|
398
|
+
* Staleness and joining are decided synchronously: in-flight entries
|
|
399
|
+
* always join their promise; fresh entries use
|
|
400
|
+
* {@link CatalogEntry.freshAtMs} for TTL.
|
|
293
401
|
*/
|
|
294
|
-
getCatalog(ref, options) {
|
|
295
|
-
const
|
|
402
|
+
getCatalog(ref, sessionId, options) {
|
|
403
|
+
const turnHeaders = this.turnHeaders(ref, sessionId);
|
|
404
|
+
const servers = ref.servers === undefined ? "*" : [...ref.servers].sort().join("\n");
|
|
405
|
+
const key = ref.credentials === "individual"
|
|
406
|
+
? `individual\n${ref.name}\n${turnHeaders[MCP_USER_ID_HEADER] ?? "none"}\n${servers}`
|
|
407
|
+
: servers;
|
|
296
408
|
const entry = this.catalogs.get(key);
|
|
297
409
|
if (entry !== undefined) {
|
|
298
410
|
if (entry.freshAtMs === undefined) {
|
|
@@ -306,9 +418,18 @@ export class CursorAccountMcpBridge {
|
|
|
306
418
|
}
|
|
307
419
|
const fresh = {
|
|
308
420
|
promise: this.client
|
|
309
|
-
.listAccountMcpTools(ref.servers ?? [])
|
|
421
|
+
.listAccountMcpTools(ref.servers ?? [], { turnHeaders })
|
|
310
422
|
.then((servers) => {
|
|
311
423
|
const catalog = buildCatalog(servers);
|
|
424
|
+
// A refused individual mount lists as empty, and the same user's
|
|
425
|
+
// next turn may carry a valid signature, so an empty catalog for
|
|
426
|
+
// an individual connection is served once and never kept.
|
|
427
|
+
if (ref.credentials === "individual" && servers.length === 0) {
|
|
428
|
+
if (this.catalogs.get(key) === fresh) {
|
|
429
|
+
this.catalogs.delete(key);
|
|
430
|
+
}
|
|
431
|
+
return catalog;
|
|
432
|
+
}
|
|
312
433
|
fresh.freshAtMs = Date.now();
|
|
313
434
|
return catalog;
|
|
314
435
|
})
|
|
@@ -325,6 +446,65 @@ export class CursorAccountMcpBridge {
|
|
|
325
446
|
return fresh.promise;
|
|
326
447
|
}
|
|
327
448
|
}
|
|
449
|
+
/**
|
|
450
|
+
* A signed turn user who has connected none of an individual connection's
|
|
451
|
+
* servers. The MCP client then shows the server as needing sign-in, so the
|
|
452
|
+
* agent offers `mcp_auth` whatever it decides to call.
|
|
453
|
+
*/
|
|
454
|
+
function needsSignIn(catalog) {
|
|
455
|
+
return (catalog.tools.length === 0 && catalog.servers.some((server) => server.status === "needsAuth"));
|
|
456
|
+
}
|
|
457
|
+
function signInUrl(request) {
|
|
458
|
+
const url = new URL(request.url);
|
|
459
|
+
url.pathname = url.pathname.replace(/\/mcp$/, "/sign-in");
|
|
460
|
+
url.search = "";
|
|
461
|
+
return url;
|
|
462
|
+
}
|
|
463
|
+
/**
|
|
464
|
+
* A 401 the MCP client reads as "needs sign-in". Its discovery finds an
|
|
465
|
+
* authorization server with no client registration, so the client stops at
|
|
466
|
+
* needing sign-in instead of failing the connection.
|
|
467
|
+
*/
|
|
468
|
+
function signInRequired(request) {
|
|
469
|
+
return new Response("Connect your own account to use this connection.", {
|
|
470
|
+
status: 401,
|
|
471
|
+
headers: {
|
|
472
|
+
"content-type": "text/plain; charset=utf-8",
|
|
473
|
+
"www-authenticate": `Bearer error="invalid_token", resource_metadata="${signInUrl(request).toString()}"`,
|
|
474
|
+
},
|
|
475
|
+
});
|
|
476
|
+
}
|
|
477
|
+
/**
|
|
478
|
+
* The sign-in discovery documents. On a 401 the MCP client runs OAuth
|
|
479
|
+
* discovery: when it finds no authorization server it fails the connection
|
|
480
|
+
* as an error, and when it finds one without client registration it stops at
|
|
481
|
+
* needing sign-in, which is what makes the agent offer `mcp_auth`. Nothing
|
|
482
|
+
* calls the `authorize`, `token` or `jwks` URLs named here: the host answers
|
|
483
|
+
* `mcp_auth` itself, and sign-in happens through the connection's Connect link.
|
|
484
|
+
*/
|
|
485
|
+
export function cursorAccountSignInDiscovery(request) {
|
|
486
|
+
const url = new URL(request.url);
|
|
487
|
+
url.search = "";
|
|
488
|
+
if (url.pathname.endsWith(OPENID_CONFIGURATION_SUFFIX)) {
|
|
489
|
+
const issuer = `${url.origin}${url.pathname.slice(0, -OPENID_CONFIGURATION_SUFFIX.length)}`;
|
|
490
|
+
return Response.json({
|
|
491
|
+
issuer,
|
|
492
|
+
authorization_endpoint: `${issuer}/authorize`,
|
|
493
|
+
token_endpoint: `${issuer}/token`,
|
|
494
|
+
jwks_uri: `${issuer}/jwks`,
|
|
495
|
+
response_types_supported: ["code"],
|
|
496
|
+
subject_types_supported: ["public"],
|
|
497
|
+
id_token_signing_alg_values_supported: ["RS256"],
|
|
498
|
+
code_challenge_methods_supported: ["S256"],
|
|
499
|
+
});
|
|
500
|
+
}
|
|
501
|
+
const resource = new URL(url);
|
|
502
|
+
resource.pathname = url.pathname.replace(/\/sign-in$/, "/mcp");
|
|
503
|
+
return Response.json({
|
|
504
|
+
resource: resource.toString(),
|
|
505
|
+
authorization_servers: [url.toString()],
|
|
506
|
+
});
|
|
507
|
+
}
|
|
328
508
|
/**
|
|
329
509
|
* Build the exposed-tool catalog. Collision suffixes are assigned after
|
|
330
510
|
* sorting the colliding group by backend identity, so the exposed-name →
|
|
@@ -485,7 +665,7 @@ export function formatServerStatusSummary(server, errorDetail) {
|
|
|
485
665
|
* returns the status enum today, so probe ExecuteSandMcpTool (ping) and surface
|
|
486
666
|
* the backend failure text (e.g. `HTTP MCP tool execution failed: fetch failed`).
|
|
487
667
|
*/
|
|
488
|
-
export async function diagnoseConnectorError(client, serverIdentifier) {
|
|
668
|
+
export async function diagnoseConnectorError(client, serverIdentifier, turnHeaders) {
|
|
489
669
|
try {
|
|
490
670
|
const result = await client.executeAccountMcpTool({
|
|
491
671
|
serverIdentifier,
|
|
@@ -493,6 +673,7 @@ export async function diagnoseConnectorError(client, serverIdentifier) {
|
|
|
493
673
|
// surfaces the same transport failure when the connector is down.
|
|
494
674
|
toolName: `${serverIdentifier}-ping`,
|
|
495
675
|
args: {},
|
|
676
|
+
turnHeaders,
|
|
496
677
|
});
|
|
497
678
|
const text = result.content
|
|
498
679
|
.filter((part) => part.type === "text")
|