@grok/agent-sdk 0.6.0 → 0.7.1
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/cursor-account.d.ts +1 -0
- package/dist/channels/github/cursor-account.d.ts.map +1 -1
- package/dist/channels/github/cursor-account.js +8 -2
- 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/origin/cursor-account.d.ts +6 -0
- package/dist/channels/origin/cursor-account.d.ts.map +1 -1
- package/dist/channels/origin/cursor-account.js +17 -0
- 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/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.lt-BYgI2.js → app.CpLKJnOA.js} +4 -4
- package/dist/docs/assets/changelog.md.DoOgjnPC.js +1 -0
- package/dist/docs/assets/{changelog.md.DVNB-ApU.lean.js → changelog.md.DoOgjnPC.lean.js} +1 -1
- package/dist/docs/assets/chunks/@localSearchIndexroot.BJ_1eI6D.js +1 -0
- package/dist/docs/assets/chunks/{VPLocalSearchBox.v_dV4U2Q.js → VPLocalSearchBox.Cr1HJ_9k.js} +2 -2
- package/dist/docs/assets/chunks/{arc.5o92kOg5.js → arc.BjpgGAMM.js} +1 -1
- package/dist/docs/assets/chunks/{architectureDiagram-Q4EWVU46.C-oTwnNq.js → architectureDiagram-Q4EWVU46.CKdhNPPk.js} +1 -1
- package/dist/docs/assets/chunks/{baseUniq.zJ-VNOib.js → baseUniq.iovoEQbg.js} +1 -1
- package/dist/docs/assets/chunks/{blockDiagram-DXYQGD6D.B9ZJZuPd.js → blockDiagram-DXYQGD6D.BYQIeDre.js} +1 -1
- package/dist/docs/assets/chunks/{c4Diagram-AHTNJAMY.BBMwSIaN.js → c4Diagram-AHTNJAMY.gbWi2q8N.js} +1 -1
- package/dist/docs/assets/chunks/channel.BP0n324b.js +1 -0
- package/dist/docs/assets/chunks/{chunk-4BX2VUAB.D8qAJpDD.js → chunk-4BX2VUAB.1Mem4UG9.js} +1 -1
- package/dist/docs/assets/chunks/{chunk-4TB4RGXK.B8QR5cdE.js → chunk-4TB4RGXK.Dn3H-X_H.js} +1 -1
- package/dist/docs/assets/chunks/{chunk-55IACEB6.BsWxVuew.js → chunk-55IACEB6.BkpSDZwX.js} +1 -1
- package/dist/docs/assets/chunks/{chunk-EDXVE4YY.BeGygY_i.js → chunk-EDXVE4YY.BScqy1zP.js} +1 -1
- package/dist/docs/assets/chunks/{chunk-FMBD7UC4.DdwgH-ZH.js → chunk-FMBD7UC4.Cp394LWf.js} +1 -1
- package/dist/docs/assets/chunks/{chunk-OYMX7WX6.B9zC_ALe.js → chunk-OYMX7WX6.BDv9LhoL.js} +1 -1
- package/dist/docs/assets/chunks/{chunk-QZHKN3VN.BIxJ0rcL.js → chunk-QZHKN3VN.CsgCcrKO.js} +1 -1
- package/dist/docs/assets/chunks/{chunk-YZCP3GAM.qiM_23_f.js → chunk-YZCP3GAM.BKBpIC5O.js} +1 -1
- package/dist/docs/assets/chunks/classDiagram-6PBFFD2Q.BhTtyWMA.js +1 -0
- package/dist/docs/assets/chunks/classDiagram-v2-HSJHXN6E.BhTtyWMA.js +1 -0
- package/dist/docs/assets/chunks/clone.BVK2rFqj.js +1 -0
- package/dist/docs/assets/chunks/{cose-bilkent-S5V4N54A.BKB971D5.js → cose-bilkent-S5V4N54A.Bs3ZS9PC.js} +1 -1
- package/dist/docs/assets/chunks/{dagre-KV5264BT.CcILjJgp.js → dagre-KV5264BT.CgWi0tY2.js} +1 -1
- package/dist/docs/assets/chunks/{diagram-5BDNPKRD.DkY9A0nu.js → diagram-5BDNPKRD.rn6qIo9N.js} +1 -1
- package/dist/docs/assets/chunks/{diagram-G4DWMVQ6.BbdzmjMt.js → diagram-G4DWMVQ6.ChhW8oww.js} +1 -1
- package/dist/docs/assets/chunks/{diagram-MMDJMWI5.Be0zy1cM.js → diagram-MMDJMWI5.C0wH5KSk.js} +1 -1
- package/dist/docs/assets/chunks/{diagram-TYMM5635.zOiEycLe.js → diagram-TYMM5635.CNEcrwA0.js} +1 -1
- package/dist/docs/assets/chunks/{erDiagram-SMLLAGMA.DUd_9HMF.js → erDiagram-SMLLAGMA.DCsnKO-7.js} +1 -1
- package/dist/docs/assets/chunks/{flowDiagram-DWJPFMVM.2KPYoZBO.js → flowDiagram-DWJPFMVM.WCMkfvP0.js} +1 -1
- package/dist/docs/assets/chunks/{ganttDiagram-T4ZO3ILL.DqE8_YpP.js → ganttDiagram-T4ZO3ILL.BUb1Sxfr.js} +1 -1
- package/dist/docs/assets/chunks/{gitGraphDiagram-UUTBAWPF.CO0Tk47h.js → gitGraphDiagram-UUTBAWPF._kORbCzm.js} +1 -1
- package/dist/docs/assets/chunks/{graph.CNe5KbNy.js → graph.PrGRm4KW.js} +1 -1
- package/dist/docs/assets/chunks/{infoDiagram-42DDH7IO.BBhJ1X1B.js → infoDiagram-42DDH7IO.BxhCjiQM.js} +1 -1
- package/dist/docs/assets/chunks/{ishikawaDiagram-UXIWVN3A.KSIw9w3I.js → ishikawaDiagram-UXIWVN3A.5ddTis2y.js} +1 -1
- package/dist/docs/assets/chunks/{journeyDiagram-VCZTEJTY.BN2Y5oUJ.js → journeyDiagram-VCZTEJTY.BUStU27-.js} +1 -1
- package/dist/docs/assets/chunks/{kanban-definition-6JOO6SKY.2KFuDYn_.js → kanban-definition-6JOO6SKY.CJd1psl3.js} +1 -1
- package/dist/docs/assets/chunks/{layout.Demb_pzL.js → layout.DqvbZSML.js} +1 -1
- package/dist/docs/assets/chunks/{linear.kYKxzbbR.js → linear.DOmz-1UB.js} +1 -1
- package/dist/docs/assets/chunks/{min.DwmCN5dF.js → min.33k2v8dM.js} +1 -1
- package/dist/docs/assets/chunks/{mindmap-definition-QFDTVHPH.CGlz01QG.js → mindmap-definition-QFDTVHPH.iISCqCXC.js} +1 -1
- package/dist/docs/assets/chunks/{pieDiagram-DEJITSTG.n3qsq4nA.js → pieDiagram-DEJITSTG.BHvVgzmD.js} +1 -1
- package/dist/docs/assets/chunks/{quadrantDiagram-34T5L4WZ.CGNJ1GSb.js → quadrantDiagram-34T5L4WZ.CY3w_-Cn.js} +1 -1
- package/dist/docs/assets/chunks/{requirementDiagram-MS252O5E.VhAzHDwQ.js → requirementDiagram-MS252O5E.CHXKQS1v.js} +1 -1
- package/dist/docs/assets/chunks/{sankeyDiagram-XADWPNL6.DmHA5pW-.js → sankeyDiagram-XADWPNL6.DTtRoGss.js} +1 -1
- package/dist/docs/assets/chunks/{sequenceDiagram-FGHM5R23._TC1aKhg.js → sequenceDiagram-FGHM5R23.NnPcQ3eY.js} +1 -1
- package/dist/docs/assets/chunks/{stateDiagram-FHFEXIEX.B-kLjV3O.js → stateDiagram-FHFEXIEX.D8DFciH7.js} +1 -1
- package/dist/docs/assets/chunks/stateDiagram-v2-QKLJ7IA2.ESAwmMws.js +1 -0
- package/dist/docs/assets/chunks/{theme.BaVlHHL-.js → theme.CwkiT-Fo.js} +2 -2
- package/dist/docs/assets/chunks/{timeline-definition-GMOUNBTQ.CresbphV.js → timeline-definition-GMOUNBTQ._wIWkMU6.js} +1 -1
- package/dist/docs/assets/chunks/{vennDiagram-DHZGUBPP.CegHD8Y4.js → vennDiagram-DHZGUBPP.NLVv7R6r.js} +1 -1
- package/dist/docs/assets/chunks/{wardley-RL74JXVD.DjCmZrUO.js → wardley-RL74JXVD.DbsCXUZp.js} +1 -1
- package/dist/docs/assets/chunks/{wardleyDiagram-NUSXRM2D.BJ7s1zdZ.js → wardleyDiagram-NUSXRM2D.Dp5uAVDl.js} +1 -1
- package/dist/docs/assets/chunks/{xychartDiagram-5P7HB3ND.IrEXlemI.js → xychartDiagram-5P7HB3ND.eOEBq4rX.js} +1 -1
- package/dist/docs/assets/{deployment.md.DJtuDVLh.js → deployment.md.CIRydNl3.js} +3 -3
- package/dist/docs/assets/{deployment.md.DJtuDVLh.lean.js → deployment.md.CIRydNl3.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/guides_workload-identity.md.DBV6YkXX.js +82 -0
- package/dist/docs/assets/guides_workload-identity.md.DBV6YkXX.lean.js +1 -0
- package/dist/docs/assets/{reference_agent-config.md.Bbqf0lgS.js → reference_agent-config.md.CfM1S6Ac.js} +2 -2
- package/dist/docs/assets/{reference_agent-config.md.Bbqf0lgS.lean.js → reference_agent-config.md.CfM1S6Ac.lean.js} +1 -1
- 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 +43 -0
- package/dist/docs/deployment.html +40 -40
- package/dist/docs/deployment.md +14 -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/guides/workload-identity.html +141 -0
- package/dist/docs/guides/workload-identity.md +227 -0
- 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 +881 -5
- package/dist/docs/llms.txt +2 -0
- package/dist/docs/quickstart.html +37 -37
- package/dist/docs/reference/access.html +36 -36
- package/dist/docs/reference/agent-config.html +39 -39
- package/dist/docs/reference/agent-config.md +1 -1
- 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-ax.d.ts.map +1 -1
- package/dist/internal/cli-ax.js +6 -3
- 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 +19 -1
- 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 +8 -1
- package/dist/internal/cursor-account-mcp-auth.d.ts.map +1 -1
- package/dist/internal/cursor-account-mcp-auth.js +22 -6
- 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/agent.d.ts.map +1 -1
- package/dist/internal/discovery/agent.js +2 -1
- package/dist/internal/discovery/connections.d.ts +5 -0
- package/dist/internal/discovery/connections.d.ts.map +1 -1
- package/dist/internal/discovery/connections.js +71 -1
- 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 +26 -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 +4 -0
- package/dist/internal/hosted-delivery-protocol.d.ts.map +1 -1
- package/dist/internal/hosted-delivery-protocol.js +73 -3
- package/dist/internal/hosted-delivery.d.ts +9 -3
- package/dist/internal/hosted-delivery.d.ts.map +1 -1
- package/dist/internal/hosted-delivery.js +14 -3
- 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/ids.d.ts +2 -0
- package/dist/internal/ids.d.ts.map +1 -1
- package/dist/internal/ids.js +5 -0
- 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/schedule-runner.d.ts +1 -0
- package/dist/internal/schedule-runner.d.ts.map +1 -1
- package/dist/internal/schedule-runner.js +10 -1
- package/dist/internal/sdk-runner.d.ts +28 -2
- package/dist/internal/sdk-runner.d.ts.map +1 -1
- package/dist/internal/sdk-runner.js +298 -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 +140 -6
- package/dist/internal/session-engine.d.ts.map +1 -1
- package/dist/internal/session-engine.js +583 -93
- 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/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 +131 -0
- package/dist/oidc-token.d.ts.map +1 -0
- package/dist/oidc-token.js +221 -0
- package/dist/playground/assets/chunk-YOKDWASO-BPO_8GRX.js +115 -0
- package/dist/playground/assets/highlighted-body-KPVGNVTW-CxEV-T_f.js +1 -0
- package/dist/playground/assets/index-CjFJhCtb.js +62 -0
- package/dist/playground/assets/index-vwUVwmk8.css +1 -0
- package/dist/playground/assets/mermaid-HWGCJPDP-eK-fpbFn.js +1 -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 +271 -2
- package/dist/types.d.ts.map +1 -1
- package/docs/changelog.md +43 -0
- package/docs/deployment.md +14 -0
- package/docs/guides/cloud-agents.md +47 -0
- package/docs/guides/teams.md +389 -0
- package/docs/guides/workload-identity.md +232 -0
- package/docs/reference/agent-config.md +1 -1
- 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 +23 -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.DVNB-ApU.js +0 -1
- package/dist/docs/assets/chunks/@localSearchIndexroot.DdlR-9Oe.js +0 -1
- package/dist/docs/assets/chunks/channel.CdyTxaXV.js +0 -1
- package/dist/docs/assets/chunks/classDiagram-6PBFFD2Q.CeUcN6TW.js +0 -1
- package/dist/docs/assets/chunks/classDiagram-v2-HSJHXN6E.CeUcN6TW.js +0 -1
- package/dist/docs/assets/chunks/clone.DpIwUbur.js +0 -1
- package/dist/docs/assets/chunks/stateDiagram-v2-QKLJ7IA2.HtBkUH4J.js +0 -1
- 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-CnFd5R1_.js +0 -62
- package/dist/playground/assets/index-DNzRv6G8.css +0 -1
- /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
|
@@ -15,6 +15,7 @@
|
|
|
15
15
|
*/
|
|
16
16
|
import * as z from "zod/v4";
|
|
17
17
|
import type { McpToolAnnotations } from "../../types.js";
|
|
18
|
+
import { type CloudAgentIdentity } from "./cloud-agent-identity.js";
|
|
18
19
|
export declare class CursorBackendError extends Error {
|
|
19
20
|
readonly status?: number | undefined;
|
|
20
21
|
readonly retryAfterMs?: number | undefined;
|
|
@@ -120,9 +121,12 @@ export interface CursorBackendClientOptions {
|
|
|
120
121
|
logger?: (line: string) => void;
|
|
121
122
|
/** Test seam; defaults to global fetch. */
|
|
122
123
|
fetchImpl?: typeof fetch;
|
|
124
|
+
/** Test seam; defaults to the process-wide cloud agent identity. */
|
|
125
|
+
cloudAgentIdentity?: CloudAgentIdentity;
|
|
123
126
|
}
|
|
124
127
|
export declare class CursorBackendClient {
|
|
125
128
|
private readonly backendUrl;
|
|
129
|
+
private readonly identity;
|
|
126
130
|
private readonly resolveApiKey;
|
|
127
131
|
private readonly logger;
|
|
128
132
|
private readonly fetchImpl;
|
|
@@ -138,7 +142,9 @@ export declare class CursorBackendClient {
|
|
|
138
142
|
* definitions. `serverIdentifiers` restricts discovery (empty = all
|
|
139
143
|
* HTTP/SSE servers on the account).
|
|
140
144
|
*/
|
|
141
|
-
listAccountMcpTools(serverIdentifiers: readonly string[]
|
|
145
|
+
listAccountMcpTools(serverIdentifiers: readonly string[], options?: {
|
|
146
|
+
turnHeaders?: Record<string, string>;
|
|
147
|
+
}): Promise<AccountMcpServer[]>;
|
|
142
148
|
/**
|
|
143
149
|
* Execute one connector tool **on the Cursor backend** with the account's
|
|
144
150
|
* stored OAuth credentials. `toolName` is the fully-qualified name from
|
|
@@ -148,6 +154,7 @@ export declare class CursorBackendClient {
|
|
|
148
154
|
serverIdentifier: string;
|
|
149
155
|
toolName: string;
|
|
150
156
|
args: Record<string, unknown>;
|
|
157
|
+
turnHeaders?: Record<string, string>;
|
|
151
158
|
}): Promise<AccountMcpCallResult>;
|
|
152
159
|
/**
|
|
153
160
|
* The account's dashboard MCP connector listing (id + name per server).
|
|
@@ -156,6 +163,7 @@ export declare class CursorBackendClient {
|
|
|
156
163
|
*/
|
|
157
164
|
getAvailableMcpServers(options?: {
|
|
158
165
|
teamId?: number;
|
|
166
|
+
turnHeaders?: Record<string, string>;
|
|
159
167
|
}): Promise<AvailableMcpServer[]>;
|
|
160
168
|
/**
|
|
161
169
|
* Probe connectors and mint OAuth `authUrl`s where authorization is
|
|
@@ -172,6 +180,7 @@ export declare class CursorBackendClient {
|
|
|
172
180
|
oauthRedirectUri: string;
|
|
173
181
|
serviceAccountId?: string;
|
|
174
182
|
userInitiated: boolean | undefined;
|
|
183
|
+
turnHeaders?: Record<string, string>;
|
|
175
184
|
}): Promise<McpConnectorStatus[]>;
|
|
176
185
|
/** Mint a short-lived GitHub token scoped to the requested repositories. */
|
|
177
186
|
getGithubToken(repos: readonly string[], options?: {
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"backend-client.d.ts","sourceRoot":"","sources":["../../../src/internal/cursor/backend-client.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAGH,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAC5B,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;
|
|
1
|
+
{"version":3,"file":"backend-client.d.ts","sourceRoot":"","sources":["../../../src/internal/cursor/backend-client.ts"],"names":[],"mappings":"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"}
|
|
@@ -21,6 +21,7 @@ import { CLI_COMMAND_NAME as CLI } from "../distribution.js";
|
|
|
21
21
|
import { boundedToolAnnotations } from "../mcp-host.js";
|
|
22
22
|
import { CURSOR_SESSION_EXCHANGE_PATH, CursorSessionExchangeError, exchangeCursorApiKeyForSession, SESSION_TOKEN_EXPIRY_LEEWAY_MS, } from "./session-token.js";
|
|
23
23
|
import { isRecord } from "../is-record.js";
|
|
24
|
+
import { cloudAgentIdentity } from "./cloud-agent-identity.js";
|
|
24
25
|
const CLIENT_VERSION = "agent-serve-0.1.0";
|
|
25
26
|
const DASHBOARD_SERVICE = "DashboardService";
|
|
26
27
|
const LIST_TIMEOUT_MS = 60_000;
|
|
@@ -196,6 +197,7 @@ export class CursorBackendClient {
|
|
|
196
197
|
this.resolveApiKey = options.getApiKey ?? (() => options.apiKey);
|
|
197
198
|
this.logger = options.logger ?? (() => { });
|
|
198
199
|
this.fetchImpl = options.fetchImpl ?? fetch;
|
|
200
|
+
this.identity = options.cloudAgentIdentity ?? cloudAgentIdentity();
|
|
199
201
|
}
|
|
200
202
|
currentApiKey() {
|
|
201
203
|
return this.resolveApiKey().trim();
|
|
@@ -209,8 +211,8 @@ export class CursorBackendClient {
|
|
|
209
211
|
* definitions. `serverIdentifiers` restricts discovery (empty = all
|
|
210
212
|
* HTTP/SSE servers on the account).
|
|
211
213
|
*/
|
|
212
|
-
async listAccountMcpTools(serverIdentifiers) {
|
|
213
|
-
const raw = await this.rpc("ListSandMcpTools", { serverIdentifiers: [...serverIdentifiers] }, LIST_TIMEOUT_MS);
|
|
214
|
+
async listAccountMcpTools(serverIdentifiers, options) {
|
|
215
|
+
const raw = await this.rpc("ListSandMcpTools", { serverIdentifiers: [...serverIdentifiers] }, LIST_TIMEOUT_MS, { runIdentity: true, extraHeaders: options?.turnHeaders });
|
|
214
216
|
const parsed = listSandMcpToolsResponseSchema.parse(raw);
|
|
215
217
|
return (parsed.servers ?? []).map((server) => ({
|
|
216
218
|
serverIdentifier: server.serverIdentifier,
|
|
@@ -239,7 +241,7 @@ export class CursorBackendClient {
|
|
|
239
241
|
toolName: args.toolName,
|
|
240
242
|
args: args.args,
|
|
241
243
|
toolCallId: randomUUID(),
|
|
242
|
-
}, EXECUTE_TIMEOUT_MS);
|
|
244
|
+
}, EXECUTE_TIMEOUT_MS, { runIdentity: true, extraHeaders: args.turnHeaders });
|
|
243
245
|
const parsed = executeResponseSchema.parse(raw);
|
|
244
246
|
return toCallResult(parsed.result ?? {});
|
|
245
247
|
}
|
|
@@ -251,6 +253,7 @@ export class CursorBackendClient {
|
|
|
251
253
|
async getAvailableMcpServers(options) {
|
|
252
254
|
const raw = await this.rpc("GetAvailableMcpServers", {}, LIST_TIMEOUT_MS, {
|
|
253
255
|
teamId: options?.teamId,
|
|
256
|
+
extraHeaders: options?.turnHeaders,
|
|
254
257
|
});
|
|
255
258
|
const parsed = getAvailableMcpServersResponseSchema.parse(raw);
|
|
256
259
|
return (parsed.servers ?? [])
|
|
@@ -278,7 +281,7 @@ export class CursorBackendClient {
|
|
|
278
281
|
oauthRedirectUri: args.oauthRedirectUri,
|
|
279
282
|
serviceAccountId: args.serviceAccountId,
|
|
280
283
|
userInitiated: args.userInitiated,
|
|
281
|
-
}, LIST_TIMEOUT_MS);
|
|
284
|
+
}, LIST_TIMEOUT_MS, args.turnHeaders === undefined ? undefined : { extraHeaders: args.turnHeaders });
|
|
282
285
|
const parsed = checkHttpMcpStatusResponseSchema.parse(raw);
|
|
283
286
|
return (parsed.statuses ?? []).map((status) => ({
|
|
284
287
|
id: status.id ?? 0,
|
|
@@ -372,7 +375,16 @@ export class CursorBackendClient {
|
|
|
372
375
|
}
|
|
373
376
|
async rpc(method, body, timeoutMs = LIST_TIMEOUT_MS, options) {
|
|
374
377
|
const service = options?.service ?? DASHBOARD_SERVICE;
|
|
375
|
-
|
|
378
|
+
// MCP calls carry the cloud agent run identity when this process runs in
|
|
379
|
+
// one, so the backend serves the team's MCP allowlist for cloud agents.
|
|
380
|
+
const extraHeaders = {
|
|
381
|
+
...(options?.runIdentity === true ? await this.identity.headers() : {}),
|
|
382
|
+
...(options?.extraHeaders ?? {}),
|
|
383
|
+
};
|
|
384
|
+
if (options?.teamId !== undefined) {
|
|
385
|
+
extraHeaders["x-cursor-team-id"] = String(options.teamId);
|
|
386
|
+
}
|
|
387
|
+
const headers = Object.keys(extraHeaders).length === 0 ? undefined : extraHeaders;
|
|
376
388
|
const bearer = await this.getAccessToken();
|
|
377
389
|
const first = await connectRpc({
|
|
378
390
|
fetchImpl: this.fetchImpl,
|
|
@@ -382,7 +394,7 @@ export class CursorBackendClient {
|
|
|
382
394
|
bearer,
|
|
383
395
|
body,
|
|
384
396
|
timeoutMs,
|
|
385
|
-
extraHeaders,
|
|
397
|
+
extraHeaders: headers,
|
|
386
398
|
});
|
|
387
399
|
if (first.status !== 401) {
|
|
388
400
|
return parseRpcResponse(method, first);
|
|
@@ -403,7 +415,7 @@ export class CursorBackendClient {
|
|
|
403
415
|
bearer: retryBearer,
|
|
404
416
|
body,
|
|
405
417
|
timeoutMs,
|
|
406
|
-
extraHeaders,
|
|
418
|
+
extraHeaders: headers,
|
|
407
419
|
});
|
|
408
420
|
if (second.status === 401 && this.token?.value === retryBearer) {
|
|
409
421
|
// The freshly minted token was rejected too; do not keep serving it.
|
|
@@ -0,0 +1,81 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Proof that this process runs inside a Cursor cloud agent, for the MCP
|
|
3
|
+
* calls the Cursor backend serves under a team MCP allowlist.
|
|
4
|
+
*
|
|
5
|
+
* A cloud agent pod exposes a host-attested identity socket
|
|
6
|
+
* (`$CURSOR_AGENT_SOCKET`, default `/run/cursor/api.sock`). `POST
|
|
7
|
+
* /v1/tokens/oidc` there mints a short-lived token the platform signs for
|
|
8
|
+
* the agent that owns the pod; the guest cannot name another agent. The
|
|
9
|
+
* backend verifies it and serves the team's MCP allowlist for cloud agents.
|
|
10
|
+
*
|
|
11
|
+
* Best effort by contract: no socket, a refused mint or a slow socket all
|
|
12
|
+
* yield no header, and the call goes out exactly as it would have without it.
|
|
13
|
+
*/
|
|
14
|
+
export declare const CLOUD_AGENT_RUN_IDENTITY_HEADER = "x-cursor-cloud-agent-identity";
|
|
15
|
+
export declare const CLOUD_AGENT_RUN_IDENTITY_AUDIENCE = "https://api.cursor.com/mcp-allowlist";
|
|
16
|
+
export declare const DEFAULT_CURSOR_AGENT_SOCKET = "/run/cursor/api.sock";
|
|
17
|
+
/** Remint this long before expiry so a token never expires in flight. */
|
|
18
|
+
export declare const OIDC_TOKEN_REFRESH_SKEW_MS = 60000;
|
|
19
|
+
type CachedToken = {
|
|
20
|
+
token: string;
|
|
21
|
+
expiresAtMs: number;
|
|
22
|
+
};
|
|
23
|
+
export type CloudAgentIdentityMinter = (socketPath: string) => Promise<CachedToken>;
|
|
24
|
+
export type CloudAgentIdentityOptions = {
|
|
25
|
+
socketPath?: string;
|
|
26
|
+
mint?: CloudAgentIdentityMinter;
|
|
27
|
+
now?: () => number;
|
|
28
|
+
socketExists?: (path: string) => boolean;
|
|
29
|
+
};
|
|
30
|
+
export declare class CloudAgentIdentity {
|
|
31
|
+
private readonly socketPath;
|
|
32
|
+
private readonly mint;
|
|
33
|
+
private readonly now;
|
|
34
|
+
private readonly socketExists;
|
|
35
|
+
private cached;
|
|
36
|
+
private inFlight;
|
|
37
|
+
private retryAfterMs;
|
|
38
|
+
constructor(options?: CloudAgentIdentityOptions);
|
|
39
|
+
/** The header to add to a Cursor MCP call, or none. Never throws. */
|
|
40
|
+
headers(): Promise<Record<string, string>>;
|
|
41
|
+
private token;
|
|
42
|
+
private unexpiredToken;
|
|
43
|
+
}
|
|
44
|
+
/** The process-wide instance, so every MCP path shares one cached token. */
|
|
45
|
+
export declare function cloudAgentIdentity(): CloudAgentIdentity;
|
|
46
|
+
export declare function resetCloudAgentIdentityForTests(): void;
|
|
47
|
+
/**
|
|
48
|
+
* Wraps a fetch so each request whose URL `attachTo` accepts carries the run
|
|
49
|
+
* identity header. Every other request on the same transport (an OAuth
|
|
50
|
+
* discovery or token call to another host, say) passes through untouched.
|
|
51
|
+
*/
|
|
52
|
+
export declare function withCloudAgentIdentity(fetchImpl: (url: string | URL, init?: RequestInit) => Promise<Response>, attachTo: (url: URL) => boolean, identity?: CloudAgentIdentity): (url: string | URL, init?: RequestInit) => Promise<Response>;
|
|
53
|
+
/** What `POST /v1/tokens/oidc` returned. The caller decides which failures throw. */
|
|
54
|
+
export type OidcSocketMintResult = {
|
|
55
|
+
kind: "token";
|
|
56
|
+
token: string;
|
|
57
|
+
expiresAtMs: number;
|
|
58
|
+
} | {
|
|
59
|
+
kind: "http";
|
|
60
|
+
status: number;
|
|
61
|
+
reason?: string;
|
|
62
|
+
} | {
|
|
63
|
+
kind: "timeout";
|
|
64
|
+
} | {
|
|
65
|
+
kind: "malformed";
|
|
66
|
+
} | {
|
|
67
|
+
kind: "transport";
|
|
68
|
+
code?: string;
|
|
69
|
+
};
|
|
70
|
+
/**
|
|
71
|
+
* Mint one audience on the pod identity socket.
|
|
72
|
+
* The MCP allowlist path calls this with its fixed audience.
|
|
73
|
+
*/
|
|
74
|
+
export declare function mintOidcOverSocket(input: {
|
|
75
|
+
socketPath: string;
|
|
76
|
+
audience: string;
|
|
77
|
+
timeoutMs: number;
|
|
78
|
+
}): Promise<OidcSocketMintResult>;
|
|
79
|
+
export declare function parseMintResponse(text: string): CachedToken;
|
|
80
|
+
export {};
|
|
81
|
+
//# sourceMappingURL=cloud-agent-identity.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"cloud-agent-identity.d.ts","sourceRoot":"","sources":["../../../src/internal/cursor/cloud-agent-identity.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAMH,eAAO,MAAM,+BAA+B,kCAAkC,CAAC;AAC/E,eAAO,MAAM,iCAAiC,yCAAyC,CAAC;AAExF,eAAO,MAAM,2BAA2B,yBAAyB,CAAC;AAIlE,yEAAyE;AACzE,eAAO,MAAM,0BAA0B,QAAS,CAAC;AAOjD,KAAK,WAAW,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,CAAC;AAE1D,MAAM,MAAM,wBAAwB,GAAG,CAAC,UAAU,EAAE,MAAM,KAAK,OAAO,CAAC,WAAW,CAAC,CAAC;AAEpF,MAAM,MAAM,yBAAyB,GAAG;IACtC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,IAAI,CAAC,EAAE,wBAAwB,CAAC;IAChC,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC;CAC1C,CAAC;AAEF,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAA2B;IAChD,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAe;IACnC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAA4B;IACzD,OAAO,CAAC,MAAM,CAA0B;IACxC,OAAO,CAAC,QAAQ,CAA0C;IAC1D,OAAO,CAAC,YAAY,CAAK;IAEzB,YAAY,OAAO,GAAE,yBAA8B,EAMlD;IAED,qEAAqE;IAC/D,OAAO,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAG/C;IAED,OAAO,CAAC,KAAK;IA2Bb,OAAO,CAAC,cAAc;CAOvB;AAID,4EAA4E;AAC5E,wBAAgB,kBAAkB,IAAI,kBAAkB,CAGvD;AAED,wBAAgB,+BAA+B,IAAI,IAAI,CAEtD;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CACpC,SAAS,EAAE,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,EAAE,IAAI,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC,QAAQ,CAAC,EACvE,QAAQ,EAAE,CAAC,GAAG,EAAE,GAAG,KAAK,OAAO,EAC/B,QAAQ,GAAE,kBAAyC,GAClD,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,EAAE,IAAI,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC,QAAQ,CAAC,CAe9D;AAUD,qFAAqF;AACrF,MAAM,MAAM,oBAAoB,GAC5B;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,GACrD;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,GACjD;IAAE,IAAI,EAAE,SAAS,CAAA;CAAE,GACnB;IAAE,IAAI,EAAE,WAAW,CAAA;CAAE,GACrB;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAEzC;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE;IACxC,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;CACnB,GAAG,OAAO,CAAC,oBAAoB,CAAC,CA8DhC;AAmCD,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,CAY3D"}
|
|
@@ -0,0 +1,224 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Proof that this process runs inside a Cursor cloud agent, for the MCP
|
|
3
|
+
* calls the Cursor backend serves under a team MCP allowlist.
|
|
4
|
+
*
|
|
5
|
+
* A cloud agent pod exposes a host-attested identity socket
|
|
6
|
+
* (`$CURSOR_AGENT_SOCKET`, default `/run/cursor/api.sock`). `POST
|
|
7
|
+
* /v1/tokens/oidc` there mints a short-lived token the platform signs for
|
|
8
|
+
* the agent that owns the pod; the guest cannot name another agent. The
|
|
9
|
+
* backend verifies it and serves the team's MCP allowlist for cloud agents.
|
|
10
|
+
*
|
|
11
|
+
* Best effort by contract: no socket, a refused mint or a slow socket all
|
|
12
|
+
* yield no header, and the call goes out exactly as it would have without it.
|
|
13
|
+
*/
|
|
14
|
+
import { existsSync } from "node:fs";
|
|
15
|
+
import { request } from "node:http";
|
|
16
|
+
import { isRecord } from "../is-record.js";
|
|
17
|
+
export const CLOUD_AGENT_RUN_IDENTITY_HEADER = "x-cursor-cloud-agent-identity";
|
|
18
|
+
export const CLOUD_AGENT_RUN_IDENTITY_AUDIENCE = "https://api.cursor.com/mcp-allowlist";
|
|
19
|
+
export const DEFAULT_CURSOR_AGENT_SOCKET = "/run/cursor/api.sock";
|
|
20
|
+
const MINT_PATH = "/v1/tokens/oidc";
|
|
21
|
+
/** A mint is one local hop plus one backend round trip; never hold an MCP call longer. */
|
|
22
|
+
const MINT_TIMEOUT_MS = 3_000;
|
|
23
|
+
/** Remint this long before expiry so a token never expires in flight. */
|
|
24
|
+
export const OIDC_TOKEN_REFRESH_SKEW_MS = 60_000;
|
|
25
|
+
/** After a failed mint, skip minting this long so a broken socket costs nothing per call. */
|
|
26
|
+
const FAILURE_BACKOFF_MS = 30_000;
|
|
27
|
+
/** A token this close to expiry is never sent; it could expire before the backend reads it. */
|
|
28
|
+
const EXPIRY_MARGIN_MS = 5_000;
|
|
29
|
+
const MAX_RESPONSE_BYTES = 64 * 1024;
|
|
30
|
+
export class CloudAgentIdentity {
|
|
31
|
+
constructor(options = {}) {
|
|
32
|
+
this.retryAfterMs = 0;
|
|
33
|
+
this.socketPath =
|
|
34
|
+
options.socketPath ?? process.env.CURSOR_AGENT_SOCKET ?? DEFAULT_CURSOR_AGENT_SOCKET;
|
|
35
|
+
this.mint = options.mint ?? mintAllowlistOverSocket;
|
|
36
|
+
this.now = options.now ?? Date.now;
|
|
37
|
+
this.socketExists = options.socketExists ?? existsSync;
|
|
38
|
+
}
|
|
39
|
+
/** The header to add to a Cursor MCP call, or none. Never throws. */
|
|
40
|
+
async headers() {
|
|
41
|
+
const token = await this.token();
|
|
42
|
+
return token === undefined ? {} : { [CLOUD_AGENT_RUN_IDENTITY_HEADER]: token };
|
|
43
|
+
}
|
|
44
|
+
token() {
|
|
45
|
+
const now = this.now();
|
|
46
|
+
if (this.cached !== undefined && this.cached.expiresAtMs - OIDC_TOKEN_REFRESH_SKEW_MS > now) {
|
|
47
|
+
return Promise.resolve(this.cached.token);
|
|
48
|
+
}
|
|
49
|
+
if (now < this.retryAfterMs || !this.socketExists(this.socketPath)) {
|
|
50
|
+
return Promise.resolve(this.unexpiredToken(now));
|
|
51
|
+
}
|
|
52
|
+
this.inFlight ??= Promise.resolve()
|
|
53
|
+
.then(() => this.mint(this.socketPath))
|
|
54
|
+
.then((minted) => {
|
|
55
|
+
this.cached = minted;
|
|
56
|
+
return minted.token;
|
|
57
|
+
})
|
|
58
|
+
.catch(() => {
|
|
59
|
+
// A failed refresh keeps serving the token it meant to replace until
|
|
60
|
+
// that token itself expires.
|
|
61
|
+
const failedAt = this.now();
|
|
62
|
+
this.retryAfterMs = failedAt + FAILURE_BACKOFF_MS;
|
|
63
|
+
return this.unexpiredToken(failedAt);
|
|
64
|
+
})
|
|
65
|
+
.finally(() => {
|
|
66
|
+
this.inFlight = undefined;
|
|
67
|
+
});
|
|
68
|
+
return this.inFlight;
|
|
69
|
+
}
|
|
70
|
+
unexpiredToken(now) {
|
|
71
|
+
if (this.cached === undefined || this.cached.expiresAtMs - EXPIRY_MARGIN_MS <= now) {
|
|
72
|
+
this.cached = undefined;
|
|
73
|
+
return undefined;
|
|
74
|
+
}
|
|
75
|
+
return this.cached.token;
|
|
76
|
+
}
|
|
77
|
+
}
|
|
78
|
+
let shared;
|
|
79
|
+
/** The process-wide instance, so every MCP path shares one cached token. */
|
|
80
|
+
export function cloudAgentIdentity() {
|
|
81
|
+
shared ??= new CloudAgentIdentity();
|
|
82
|
+
return shared;
|
|
83
|
+
}
|
|
84
|
+
export function resetCloudAgentIdentityForTests() {
|
|
85
|
+
shared = undefined;
|
|
86
|
+
}
|
|
87
|
+
/**
|
|
88
|
+
* Wraps a fetch so each request whose URL `attachTo` accepts carries the run
|
|
89
|
+
* identity header. Every other request on the same transport (an OAuth
|
|
90
|
+
* discovery or token call to another host, say) passes through untouched.
|
|
91
|
+
*/
|
|
92
|
+
export function withCloudAgentIdentity(fetchImpl, attachTo, identity = cloudAgentIdentity()) {
|
|
93
|
+
return async (url, init) => {
|
|
94
|
+
if (!attachesTo(attachTo, url)) {
|
|
95
|
+
return fetchImpl(url, init);
|
|
96
|
+
}
|
|
97
|
+
const extra = await identity.headers();
|
|
98
|
+
if (Object.keys(extra).length === 0) {
|
|
99
|
+
return fetchImpl(url, init);
|
|
100
|
+
}
|
|
101
|
+
const headers = new Headers(init?.headers);
|
|
102
|
+
for (const [name, value] of Object.entries(extra)) {
|
|
103
|
+
headers.set(name, value);
|
|
104
|
+
}
|
|
105
|
+
return fetchImpl(url, { ...init, headers });
|
|
106
|
+
};
|
|
107
|
+
}
|
|
108
|
+
function attachesTo(attachTo, url) {
|
|
109
|
+
try {
|
|
110
|
+
return attachTo(url instanceof URL ? url : new URL(url));
|
|
111
|
+
}
|
|
112
|
+
catch {
|
|
113
|
+
return false;
|
|
114
|
+
}
|
|
115
|
+
}
|
|
116
|
+
/**
|
|
117
|
+
* Mint one audience on the pod identity socket.
|
|
118
|
+
* The MCP allowlist path calls this with its fixed audience.
|
|
119
|
+
*/
|
|
120
|
+
export function mintOidcOverSocket(input) {
|
|
121
|
+
const body = JSON.stringify({ aud: input.audience });
|
|
122
|
+
return new Promise((resolve) => {
|
|
123
|
+
let settled = false;
|
|
124
|
+
const finish = (result) => {
|
|
125
|
+
if (settled) {
|
|
126
|
+
return;
|
|
127
|
+
}
|
|
128
|
+
settled = true;
|
|
129
|
+
resolve(result);
|
|
130
|
+
};
|
|
131
|
+
const req = request({
|
|
132
|
+
socketPath: input.socketPath,
|
|
133
|
+
path: MINT_PATH,
|
|
134
|
+
method: "POST",
|
|
135
|
+
headers: {
|
|
136
|
+
"content-type": "application/json",
|
|
137
|
+
"content-length": Buffer.byteLength(body),
|
|
138
|
+
},
|
|
139
|
+
timeout: input.timeoutMs,
|
|
140
|
+
}, (res) => {
|
|
141
|
+
const chunks = [];
|
|
142
|
+
let size = 0;
|
|
143
|
+
res.on("data", (chunk) => {
|
|
144
|
+
size += chunk.length;
|
|
145
|
+
if (size > MAX_RESPONSE_BYTES) {
|
|
146
|
+
finish({ kind: "malformed" });
|
|
147
|
+
req.destroy();
|
|
148
|
+
return;
|
|
149
|
+
}
|
|
150
|
+
chunks.push(chunk);
|
|
151
|
+
});
|
|
152
|
+
res.on("end", () => {
|
|
153
|
+
const text = Buffer.concat(chunks).toString("utf8");
|
|
154
|
+
const status = res.statusCode ?? 0;
|
|
155
|
+
if (status !== 200) {
|
|
156
|
+
finish({ kind: "http", status, reason: reasonFromBody(text) });
|
|
157
|
+
return;
|
|
158
|
+
}
|
|
159
|
+
try {
|
|
160
|
+
const parsed = parseMintResponse(text);
|
|
161
|
+
finish({ kind: "token", token: parsed.token, expiresAtMs: parsed.expiresAtMs });
|
|
162
|
+
}
|
|
163
|
+
catch {
|
|
164
|
+
finish({ kind: "malformed" });
|
|
165
|
+
}
|
|
166
|
+
});
|
|
167
|
+
res.on("error", (error) => {
|
|
168
|
+
finish({ kind: "transport", code: nodeErrorCode(error) });
|
|
169
|
+
});
|
|
170
|
+
});
|
|
171
|
+
req.on("timeout", () => {
|
|
172
|
+
finish({ kind: "timeout" });
|
|
173
|
+
req.destroy();
|
|
174
|
+
});
|
|
175
|
+
req.on("error", (error) => {
|
|
176
|
+
finish({ kind: "transport", code: nodeErrorCode(error) });
|
|
177
|
+
});
|
|
178
|
+
req.end(body);
|
|
179
|
+
});
|
|
180
|
+
}
|
|
181
|
+
/** The allowlist audience, on the short timeout the MCP path already uses. */
|
|
182
|
+
function mintAllowlistOverSocket(socketPath) {
|
|
183
|
+
return mintOidcOverSocket({
|
|
184
|
+
socketPath,
|
|
185
|
+
audience: CLOUD_AGENT_RUN_IDENTITY_AUDIENCE,
|
|
186
|
+
timeoutMs: MINT_TIMEOUT_MS,
|
|
187
|
+
}).then((result) => {
|
|
188
|
+
if (result.kind === "token") {
|
|
189
|
+
return { token: result.token, expiresAtMs: result.expiresAtMs };
|
|
190
|
+
}
|
|
191
|
+
throw new Error("identity mint failed");
|
|
192
|
+
});
|
|
193
|
+
}
|
|
194
|
+
function reasonFromBody(text) {
|
|
195
|
+
try {
|
|
196
|
+
const parsed = JSON.parse(text);
|
|
197
|
+
if (!isRecord(parsed) || typeof parsed.error !== "string" || parsed.error === "") {
|
|
198
|
+
return undefined;
|
|
199
|
+
}
|
|
200
|
+
return parsed.error;
|
|
201
|
+
}
|
|
202
|
+
catch {
|
|
203
|
+
return undefined;
|
|
204
|
+
}
|
|
205
|
+
}
|
|
206
|
+
function nodeErrorCode(error) {
|
|
207
|
+
if (!isRecord(error) || typeof error.code !== "string" || error.code === "") {
|
|
208
|
+
return undefined;
|
|
209
|
+
}
|
|
210
|
+
return error.code;
|
|
211
|
+
}
|
|
212
|
+
export function parseMintResponse(text) {
|
|
213
|
+
const parsed = JSON.parse(text);
|
|
214
|
+
if (!isRecord(parsed)) {
|
|
215
|
+
throw new Error("identity mint response is not an object");
|
|
216
|
+
}
|
|
217
|
+
if (typeof parsed.token !== "string" || parsed.token === "") {
|
|
218
|
+
throw new Error("identity mint response has no token");
|
|
219
|
+
}
|
|
220
|
+
if (typeof parsed.expires_at !== "number" || !Number.isFinite(parsed.expires_at)) {
|
|
221
|
+
throw new Error("identity mint response has no expiry");
|
|
222
|
+
}
|
|
223
|
+
return { token: parsed.token, expiresAtMs: parsed.expires_at * 1000 };
|
|
224
|
+
}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"credentials.d.ts","sourceRoot":"","sources":["../../../src/internal/cursor/credentials.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAOH,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;
|
|
1
|
+
{"version":3,"file":"credentials.d.ts","sourceRoot":"","sources":["../../../src/internal/cursor/credentials.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAOH,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAQ5B,OAAO,EAAE,KAAK,uBAAuB,EAA0B,MAAM,wBAAwB,CAAC;AAE9F,eAAO,MAAM,0BAA0B,2BAA2B,CAAC;AACnE,eAAO,MAAM,+BAA+B,2BAA2B,CAAC;AAGxE;;;;;;GAMG;AACH,wBAAgB,gBAAgB,IAAI,MAAM,CAMzC;AAED,0EAA0E;AAC1E,wBAAgB,oBAAoB,IAAI,MAAM,CAE7C;AAED,gFAAgF;AAChF,wBAAgB,gBAAgB,IAAI,MAAM,CAEzC;AAED,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAErD;AAUD,QAAA,MAAM,uBAAuB,EAAE,CAAC,CAAC,SAAS,CAAC;IAAE,UAAU,EAAE,CAAC,CAAC,SAAS,CAAC;IAAC,MAAM,EAAE,CAAC,CAAC,SAAS,CAAA;CAAE,CAKvF,CAAC;AAEL,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAExE;;;;GAIG;AACH,wBAAgB,aAAa,IAAI,MAAM,CAKtC;AAED,6CAA6C;AAC7C,wBAAgB,mBAAmB,IAAI,MAAM,CAE5C;AAmBD,wBAAgB,yBAAyB,IAAI,iBAAiB,GAAG,SAAS,CASzE;AAED,wBAAsB,qBAAqB,IAAI,OAAO,CAAC,iBAAiB,GAAG,SAAS,CAAC,CASpF;AAED,wBAAsB,sBAAsB,CAAC,WAAW,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CAE1F;AAED,wBAAsB,sBAAsB,IAAI,OAAO,CAAC,OAAO,CAAC,CAO/D;AAMD,MAAM,MAAM,YAAY,GAAG,QAAQ,GAAG,KAAK,GAAG,MAAM,GAAG,iBAAiB,GAAG,OAAO,CAAC;AAEnF,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,YAAY,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,2BAA2B,EAAE,MAA6C,CAAC;AAExF;;;;;GAKG;AACH,wBAAgB,2BAA2B,CACzC,QAAQ,CAAC,EAAE,MAAM,EACjB,GAAG,GAAE,MAAM,CAAC,UAAwB,GACnC,MAAM,CAKR;AAED,wBAAgB,kBAAkB,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAQxE;AAED,MAAM,MAAM,8BAA8B,GAAG;IAC3C,uDAAuD;IACvD,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,uBAAuB,CAAC;CACnC,CAAC;AAEF;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,wBAAwB,CAAC,OAAO,CAAC,EAAE;IACjD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;CACzB,GAAG,8BAA8B,CAoBjC;AAWD;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,CAAC,EAAE;IAC1C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,GAAG,cAAc,GAAG,SAAS,CA0B7B;AAED;;GAEG;AACH,wBAAsB,aAAa,CAAC,OAAO,CAAC,EAAE;IAC5C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,GAAG,OAAO,CAAC,cAAc,GAAG,SAAS,CAAC,CAEtC;AAED,yEAAyE;AACzE,eAAO,MAAM,YAAY,EAAE,MAAiJ,CAAC;AAQ7K,MAAM,WAAW,UAAU;IACzB,4DAA4D;IAC5D,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,IAAI,UAAU,CAU9C;AAKD;;;;GAIG;AACH,MAAM,MAAM,eAAe,GACvB;IAAE,MAAM,EAAE,WAAW,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,GAC5C;IAAE,MAAM,EAAE,WAAW,CAAA;CAAE,GACvB;IAAE,MAAM,EAAE,WAAW,CAAA;CAAE,GACvB;IAAE,MAAM,EAAE,QAAQ,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAE1C;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,kBAAkB,CAAC,IAAI,EAAE;IAC7C,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,4DAA4D;IAC5D,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAChC,2CAA2C;IAC3C,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;IACzB,uEAAuE;IACvE,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,GAAG,OAAO,CAAC,eAAe,CAAC,CAkG3B"}
|
|
@@ -29,7 +29,7 @@ import { join } from "node:path";
|
|
|
29
29
|
import * as z from "zod/v4";
|
|
30
30
|
import { CLI_COMMAND_NAME } from "../distribution.js";
|
|
31
31
|
import { isRecord } from "../is-record.js";
|
|
32
|
-
import { writePrivateFile } from "../private-file.js";
|
|
32
|
+
import { restrictExistingPrivateFile, restrictExistingPrivateFileSync, writePrivateFile, } from "../private-file.js";
|
|
33
33
|
import { destroyBoundSecretFile } from "./bound-secret-file.js";
|
|
34
34
|
export const DEFAULT_CURSOR_BACKEND_URL = "https://api2.cursor.sh";
|
|
35
35
|
export const DEFAULT_CURSOR_EXTERNAL_API_URL = "https://api.cursor.com";
|
|
@@ -101,6 +101,7 @@ function parseStoredCredentialsJson(raw) {
|
|
|
101
101
|
export function readStoredCredentialsSync() {
|
|
102
102
|
let raw;
|
|
103
103
|
try {
|
|
104
|
+
restrictExistingPrivateFileSync(credentialsFilePath());
|
|
104
105
|
raw = readFileSync(credentialsFilePath(), "utf8");
|
|
105
106
|
}
|
|
106
107
|
catch {
|
|
@@ -111,6 +112,7 @@ export function readStoredCredentialsSync() {
|
|
|
111
112
|
export async function readStoredCredentials() {
|
|
112
113
|
let raw;
|
|
113
114
|
try {
|
|
115
|
+
await restrictExistingPrivateFile(credentialsFilePath());
|
|
114
116
|
raw = await readFile(credentialsFilePath(), "utf8");
|
|
115
117
|
}
|
|
116
118
|
catch {
|
|
@@ -12,7 +12,7 @@
|
|
|
12
12
|
* account. Used by `agent-sdk mcp oauth <connection>` and the post-deploy
|
|
13
13
|
* hook in `cli-deploy.ts`.
|
|
14
14
|
*/
|
|
15
|
-
import type { CursorBackendClient } from "./cursor/backend-client.js";
|
|
15
|
+
import type { AvailableMcpServer, CursorBackendClient } from "./cursor/backend-client.js";
|
|
16
16
|
/** Same default the dashboard uses; MCP_OAUTH_REDIRECT_URI overrides for dev. */
|
|
17
17
|
export declare function mcpOauthRedirectUri(): string;
|
|
18
18
|
export interface AuthorizeCursorAccountConnectorsArgs {
|
|
@@ -52,6 +52,12 @@ export interface AuthorizeCursorAccountConnectorsResult {
|
|
|
52
52
|
* each (sequentially), polled until the backend stores the token.
|
|
53
53
|
*/
|
|
54
54
|
export declare function authorizeCursorAccountConnectors(args: AuthorizeCursorAccountConnectorsArgs): Promise<AuthorizeCursorAccountConnectorsResult>;
|
|
55
|
+
/**
|
|
56
|
+
* Whether a declared connector name names `server`, by display name or
|
|
57
|
+
* identifier, ignoring case and surrounding whitespace. A blank name names
|
|
58
|
+
* no connector.
|
|
59
|
+
*/
|
|
60
|
+
export declare function connectorNameMatches(name: string, server: Pick<AvailableMcpServer, "name" | "serverIdentifier">): boolean;
|
|
55
61
|
/**
|
|
56
62
|
* Mint OAuth `authUrl`s for connectors matching `identifiers` (name or
|
|
57
63
|
* `serverIdentifier`). Omit `serviceAccountId` to probe the signed-in user
|
|
@@ -66,5 +72,6 @@ export declare function probeConnectorAuthUrls(args: {
|
|
|
66
72
|
identifiers: readonly string[];
|
|
67
73
|
serviceAccountId?: string;
|
|
68
74
|
userInitiated: false | undefined;
|
|
75
|
+
turnHeaders?: Record<string, string>;
|
|
69
76
|
}): Promise<Map<string, string>>;
|
|
70
77
|
//# sourceMappingURL=cursor-account-mcp-auth.d.ts.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"cursor-account-mcp-auth.d.ts","sourceRoot":"","sources":["../../src/internal/cursor-account-mcp-auth.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,
|
|
1
|
+
{"version":3,"file":"cursor-account-mcp-auth.d.ts","sourceRoot":"","sources":["../../src/internal/cursor-account-mcp-auth.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EACV,kBAAkB,EAClB,mBAAmB,EAEpB,MAAM,4BAA4B,CAAC;AAQpC,iFAAiF;AACjF,wBAAgB,mBAAmB,IAAI,MAAM,CAM5C;AAED,MAAM,WAAW,oCAAoC;IACnD,aAAa,EAAE,IAAI,CAAC,mBAAmB,EAAE,wBAAwB,GAAG,oBAAoB,CAAC,CAAC;IAC1F,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,2DAA2D;IAC3D,gBAAgB,EAAE,MAAM,CAAC;IACzB,sCAAsC;IACtC,cAAc,EAAE,MAAM,CAAC;IACvB,2EAA2E;IAC3E,OAAO,CAAC,EAAE,MAAM,EAAE,GAAG,SAAS,CAAC;IAC/B,yEAAyE;IACzE,WAAW,EAAE,OAAO,CAAC;IACrB,GAAG,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAC5B,GAAG,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAC5B,kBAAkB;IAClB,eAAe,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IACxC,KAAK,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACtC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,sCAAsC;IACrD,0DAA0D;IAC1D,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,gDAAgD;IAChD,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,8CAA8C;IAC9C,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACjD;AAED;;;;GAIG;AACH,wBAAsB,gCAAgC,CACpD,IAAI,EAAE,oCAAoC,GACzC,OAAO,CAAC,sCAAsC,CAAC,CA2FjD;AA4BD;;;;GAIG;AACH,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,IAAI,CAAC,kBAAkB,EAAE,MAAM,GAAG,kBAAkB,CAAC,GAC5D,OAAO,CAST;AA+BD;;;;;;;;GAQG;AACH,wBAAsB,sBAAsB,CAAC,IAAI,EAAE;IACjD,MAAM,EAAE,IAAI,CAAC,mBAAmB,EAAE,wBAAwB,GAAG,oBAAoB,CAAC,CAAC;IACnF,WAAW,EAAE,SAAS,MAAM,EAAE,CAAC;IAC/B,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,aAAa,EAAE,KAAK,GAAG,SAAS,CAAC;IACjC,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACtC,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CA4C/B"}
|
|
@@ -117,8 +117,7 @@ function selectConnectors(available, filter) {
|
|
|
117
117
|
const seen = new Set();
|
|
118
118
|
const unmatched = [];
|
|
119
119
|
for (const name of filter) {
|
|
120
|
-
const
|
|
121
|
-
const matches = available.filter((server) => server.name.toLowerCase() === wanted || server.serverIdentifier?.toLowerCase() === wanted);
|
|
120
|
+
const matches = available.filter((server) => connectorNameMatches(name, server));
|
|
122
121
|
if (matches.length === 0) {
|
|
123
122
|
unmatched.push(name);
|
|
124
123
|
continue;
|
|
@@ -132,19 +131,35 @@ function selectConnectors(available, filter) {
|
|
|
132
131
|
}
|
|
133
132
|
return { servers, unmatched };
|
|
134
133
|
}
|
|
134
|
+
/**
|
|
135
|
+
* Whether a declared connector name names `server`, by display name or
|
|
136
|
+
* identifier, ignoring case and surrounding whitespace. A blank name names
|
|
137
|
+
* no connector.
|
|
138
|
+
*/
|
|
139
|
+
export function connectorNameMatches(name, server) {
|
|
140
|
+
const wanted = connectorNameKey(name);
|
|
141
|
+
if (wanted === "") {
|
|
142
|
+
return false;
|
|
143
|
+
}
|
|
144
|
+
return (connectorNameKey(server.name) === wanted ||
|
|
145
|
+
(server.serverIdentifier !== undefined && connectorNameKey(server.serverIdentifier) === wanted));
|
|
146
|
+
}
|
|
147
|
+
function connectorNameKey(name) {
|
|
148
|
+
return name.trim().toLowerCase();
|
|
149
|
+
}
|
|
135
150
|
function uniqueConnectorMatch(available, identifier) {
|
|
136
|
-
const wanted = identifier
|
|
151
|
+
const wanted = connectorNameKey(identifier);
|
|
137
152
|
if (wanted === "") {
|
|
138
153
|
return undefined;
|
|
139
154
|
}
|
|
140
|
-
const byIdentifier = available.filter((server) => server.serverIdentifier
|
|
155
|
+
const byIdentifier = available.filter((server) => server.serverIdentifier !== undefined && connectorNameKey(server.serverIdentifier) === wanted);
|
|
141
156
|
if (byIdentifier.length === 1) {
|
|
142
157
|
return byIdentifier[0];
|
|
143
158
|
}
|
|
144
159
|
if (byIdentifier.length > 1) {
|
|
145
160
|
return undefined;
|
|
146
161
|
}
|
|
147
|
-
const byName = available.filter((server) => server.name
|
|
162
|
+
const byName = available.filter((server) => connectorNameKey(server.name) === wanted);
|
|
148
163
|
if (byName.length === 1) {
|
|
149
164
|
return byName[0];
|
|
150
165
|
}
|
|
@@ -165,7 +180,7 @@ export async function probeConnectorAuthUrls(args) {
|
|
|
165
180
|
return urls;
|
|
166
181
|
}
|
|
167
182
|
try {
|
|
168
|
-
const available = await args.client.getAvailableMcpServers();
|
|
183
|
+
const available = await args.client.getAvailableMcpServers(args.turnHeaders === undefined ? undefined : { turnHeaders: args.turnHeaders });
|
|
169
184
|
const matched = [];
|
|
170
185
|
const seen = new Set();
|
|
171
186
|
for (const identifier of args.identifiers) {
|
|
@@ -184,6 +199,7 @@ export async function probeConnectorAuthUrls(args) {
|
|
|
184
199
|
oauthRedirectUri: mcpOauthRedirectUri(),
|
|
185
200
|
serviceAccountId: args.serviceAccountId,
|
|
186
201
|
userInitiated: args.userInitiated,
|
|
202
|
+
turnHeaders: args.turnHeaders,
|
|
187
203
|
});
|
|
188
204
|
const statusById = new Map(statuses.map((status) => [status.id, status]));
|
|
189
205
|
for (const identifier of args.identifiers) {
|