@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.
Files changed (550) hide show
  1. package/AGENTS.md +40 -0
  2. package/dist/channels/github/cursor-account.d.ts +1 -0
  3. package/dist/channels/github/cursor-account.d.ts.map +1 -1
  4. package/dist/channels/github/cursor-account.js +8 -2
  5. package/dist/channels/github/forward.d.ts +5 -0
  6. package/dist/channels/github/forward.d.ts.map +1 -1
  7. package/dist/channels/github/forward.js +6 -3
  8. package/dist/channels/origin/cursor-account.d.ts +6 -0
  9. package/dist/channels/origin/cursor-account.d.ts.map +1 -1
  10. package/dist/channels/origin/cursor-account.js +17 -0
  11. package/dist/channels/slack/api.d.ts +18 -0
  12. package/dist/channels/slack/api.d.ts.map +1 -1
  13. package/dist/channels/slack/api.js +31 -0
  14. package/dist/channels/slack/approvals.d.ts +19 -2
  15. package/dist/channels/slack/approvals.d.ts.map +1 -1
  16. package/dist/channels/slack/approvals.js +90 -19
  17. package/dist/channels/slack/attachments.d.ts +7 -2
  18. package/dist/channels/slack/attachments.d.ts.map +1 -1
  19. package/dist/channels/slack/attachments.js +318 -156
  20. package/dist/channels/slack/connect-card.d.ts +16 -0
  21. package/dist/channels/slack/connect-card.d.ts.map +1 -0
  22. package/dist/channels/slack/connect-card.js +31 -0
  23. package/dist/channels/slack/credentials.d.ts +10 -2
  24. package/dist/channels/slack/credentials.d.ts.map +1 -1
  25. package/dist/channels/slack/credentials.js +17 -15
  26. package/dist/channels/slack/defaults.d.ts.map +1 -1
  27. package/dist/channels/slack/defaults.js +18 -9
  28. package/dist/channels/slack/dispatch.d.ts +1 -1
  29. package/dist/channels/slack/dispatch.d.ts.map +1 -1
  30. package/dist/channels/slack/dispatch.js +19 -3
  31. package/dist/channels/slack/inbound.d.ts +8 -2
  32. package/dist/channels/slack/inbound.d.ts.map +1 -1
  33. package/dist/channels/slack/inbound.js +25 -4
  34. package/dist/channels/slack/index.d.ts +3 -2
  35. package/dist/channels/slack/index.d.ts.map +1 -1
  36. package/dist/channels/slack/index.js +3 -2
  37. package/dist/channels/slack/init.d.ts.map +1 -1
  38. package/dist/channels/slack/init.js +2 -1
  39. package/dist/channels/slack/mentions.d.ts +28 -0
  40. package/dist/channels/slack/mentions.d.ts.map +1 -0
  41. package/dist/channels/slack/mentions.js +178 -0
  42. package/dist/channels/slack/setup.js +1 -1
  43. package/dist/channels/slack/slack-channel.d.ts.map +1 -1
  44. package/dist/channels/slack/slack-channel.js +46 -3
  45. package/dist/channels/slack/stop.d.ts.map +1 -1
  46. package/dist/channels/slack/stop.js +7 -1
  47. package/dist/channels/slack/thread-context.d.ts +3 -0
  48. package/dist/channels/slack/thread-context.d.ts.map +1 -1
  49. package/dist/channels/slack/thread-context.js +17 -7
  50. package/dist/channels/slack/tool-approval-events.d.ts.map +1 -1
  51. package/dist/channels/slack/tool-approval-events.js +55 -2
  52. package/dist/channels/slack/types.d.ts +2 -0
  53. package/dist/channels/slack/types.d.ts.map +1 -1
  54. package/dist/channels/teams/activity.d.ts +33 -0
  55. package/dist/channels/teams/activity.d.ts.map +1 -0
  56. package/dist/channels/teams/activity.js +213 -0
  57. package/dist/channels/teams/auth.d.ts +25 -0
  58. package/dist/channels/teams/auth.d.ts.map +1 -0
  59. package/dist/channels/teams/auth.js +55 -0
  60. package/dist/channels/teams/bot-framework-auth.d.ts +33 -0
  61. package/dist/channels/teams/bot-framework-auth.d.ts.map +1 -0
  62. package/dist/channels/teams/bot-framework-auth.js +154 -0
  63. package/dist/channels/teams/cards.d.ts +23 -0
  64. package/dist/channels/teams/cards.d.ts.map +1 -0
  65. package/dist/channels/teams/cards.js +107 -0
  66. package/dist/channels/teams/connector.d.ts +48 -0
  67. package/dist/channels/teams/connector.d.ts.map +1 -0
  68. package/dist/channels/teams/connector.js +159 -0
  69. package/dist/channels/teams/credentials.d.ts +65 -0
  70. package/dist/channels/teams/credentials.d.ts.map +1 -0
  71. package/dist/channels/teams/credentials.js +84 -0
  72. package/dist/channels/teams/delivery.d.ts +14 -0
  73. package/dist/channels/teams/delivery.d.ts.map +1 -0
  74. package/dist/channels/teams/delivery.js +169 -0
  75. package/dist/channels/teams/dispatch.d.ts +45 -0
  76. package/dist/channels/teams/dispatch.d.ts.map +1 -0
  77. package/dist/channels/teams/dispatch.js +402 -0
  78. package/dist/channels/teams/engagement.d.ts +32 -0
  79. package/dist/channels/teams/engagement.d.ts.map +1 -0
  80. package/dist/channels/teams/engagement.js +120 -0
  81. package/dist/channels/teams/index.d.ts +21 -0
  82. package/dist/channels/teams/index.d.ts.map +1 -0
  83. package/dist/channels/teams/index.js +19 -0
  84. package/dist/channels/teams/marks.d.ts +19 -0
  85. package/dist/channels/teams/marks.d.ts.map +1 -0
  86. package/dist/channels/teams/marks.js +96 -0
  87. package/dist/channels/teams/senders.d.ts +27 -0
  88. package/dist/channels/teams/senders.d.ts.map +1 -0
  89. package/dist/channels/teams/senders.js +72 -0
  90. package/dist/channels/teams/teams-channel.d.ts +43 -0
  91. package/dist/channels/teams/teams-channel.d.ts.map +1 -0
  92. package/dist/channels/teams/teams-channel.js +278 -0
  93. package/dist/channels/teams/text.d.ts +7 -0
  94. package/dist/channels/teams/text.d.ts.map +1 -0
  95. package/dist/channels/teams/text.js +63 -0
  96. package/dist/channels/teams/types.d.ts +306 -0
  97. package/dist/channels/teams/types.d.ts.map +1 -0
  98. package/dist/channels/teams/types.js +1 -0
  99. package/dist/channels.d.ts +31 -0
  100. package/dist/channels.d.ts.map +1 -1
  101. package/dist/channels.js +37 -0
  102. package/dist/connections.d.ts +1 -1
  103. package/dist/connections.d.ts.map +1 -1
  104. package/dist/docs/404.html +3 -3
  105. package/dist/docs/assets/{app.lt-BYgI2.js → app.CpLKJnOA.js} +4 -4
  106. package/dist/docs/assets/changelog.md.DoOgjnPC.js +1 -0
  107. package/dist/docs/assets/{changelog.md.DVNB-ApU.lean.js → changelog.md.DoOgjnPC.lean.js} +1 -1
  108. package/dist/docs/assets/chunks/@localSearchIndexroot.BJ_1eI6D.js +1 -0
  109. package/dist/docs/assets/chunks/{VPLocalSearchBox.v_dV4U2Q.js → VPLocalSearchBox.Cr1HJ_9k.js} +2 -2
  110. package/dist/docs/assets/chunks/{arc.5o92kOg5.js → arc.BjpgGAMM.js} +1 -1
  111. package/dist/docs/assets/chunks/{architectureDiagram-Q4EWVU46.C-oTwnNq.js → architectureDiagram-Q4EWVU46.CKdhNPPk.js} +1 -1
  112. package/dist/docs/assets/chunks/{baseUniq.zJ-VNOib.js → baseUniq.iovoEQbg.js} +1 -1
  113. package/dist/docs/assets/chunks/{blockDiagram-DXYQGD6D.B9ZJZuPd.js → blockDiagram-DXYQGD6D.BYQIeDre.js} +1 -1
  114. package/dist/docs/assets/chunks/{c4Diagram-AHTNJAMY.BBMwSIaN.js → c4Diagram-AHTNJAMY.gbWi2q8N.js} +1 -1
  115. package/dist/docs/assets/chunks/channel.BP0n324b.js +1 -0
  116. package/dist/docs/assets/chunks/{chunk-4BX2VUAB.D8qAJpDD.js → chunk-4BX2VUAB.1Mem4UG9.js} +1 -1
  117. package/dist/docs/assets/chunks/{chunk-4TB4RGXK.B8QR5cdE.js → chunk-4TB4RGXK.Dn3H-X_H.js} +1 -1
  118. package/dist/docs/assets/chunks/{chunk-55IACEB6.BsWxVuew.js → chunk-55IACEB6.BkpSDZwX.js} +1 -1
  119. package/dist/docs/assets/chunks/{chunk-EDXVE4YY.BeGygY_i.js → chunk-EDXVE4YY.BScqy1zP.js} +1 -1
  120. package/dist/docs/assets/chunks/{chunk-FMBD7UC4.DdwgH-ZH.js → chunk-FMBD7UC4.Cp394LWf.js} +1 -1
  121. package/dist/docs/assets/chunks/{chunk-OYMX7WX6.B9zC_ALe.js → chunk-OYMX7WX6.BDv9LhoL.js} +1 -1
  122. package/dist/docs/assets/chunks/{chunk-QZHKN3VN.BIxJ0rcL.js → chunk-QZHKN3VN.CsgCcrKO.js} +1 -1
  123. package/dist/docs/assets/chunks/{chunk-YZCP3GAM.qiM_23_f.js → chunk-YZCP3GAM.BKBpIC5O.js} +1 -1
  124. package/dist/docs/assets/chunks/classDiagram-6PBFFD2Q.BhTtyWMA.js +1 -0
  125. package/dist/docs/assets/chunks/classDiagram-v2-HSJHXN6E.BhTtyWMA.js +1 -0
  126. package/dist/docs/assets/chunks/clone.BVK2rFqj.js +1 -0
  127. package/dist/docs/assets/chunks/{cose-bilkent-S5V4N54A.BKB971D5.js → cose-bilkent-S5V4N54A.Bs3ZS9PC.js} +1 -1
  128. package/dist/docs/assets/chunks/{dagre-KV5264BT.CcILjJgp.js → dagre-KV5264BT.CgWi0tY2.js} +1 -1
  129. package/dist/docs/assets/chunks/{diagram-5BDNPKRD.DkY9A0nu.js → diagram-5BDNPKRD.rn6qIo9N.js} +1 -1
  130. package/dist/docs/assets/chunks/{diagram-G4DWMVQ6.BbdzmjMt.js → diagram-G4DWMVQ6.ChhW8oww.js} +1 -1
  131. package/dist/docs/assets/chunks/{diagram-MMDJMWI5.Be0zy1cM.js → diagram-MMDJMWI5.C0wH5KSk.js} +1 -1
  132. package/dist/docs/assets/chunks/{diagram-TYMM5635.zOiEycLe.js → diagram-TYMM5635.CNEcrwA0.js} +1 -1
  133. package/dist/docs/assets/chunks/{erDiagram-SMLLAGMA.DUd_9HMF.js → erDiagram-SMLLAGMA.DCsnKO-7.js} +1 -1
  134. package/dist/docs/assets/chunks/{flowDiagram-DWJPFMVM.2KPYoZBO.js → flowDiagram-DWJPFMVM.WCMkfvP0.js} +1 -1
  135. package/dist/docs/assets/chunks/{ganttDiagram-T4ZO3ILL.DqE8_YpP.js → ganttDiagram-T4ZO3ILL.BUb1Sxfr.js} +1 -1
  136. package/dist/docs/assets/chunks/{gitGraphDiagram-UUTBAWPF.CO0Tk47h.js → gitGraphDiagram-UUTBAWPF._kORbCzm.js} +1 -1
  137. package/dist/docs/assets/chunks/{graph.CNe5KbNy.js → graph.PrGRm4KW.js} +1 -1
  138. package/dist/docs/assets/chunks/{infoDiagram-42DDH7IO.BBhJ1X1B.js → infoDiagram-42DDH7IO.BxhCjiQM.js} +1 -1
  139. package/dist/docs/assets/chunks/{ishikawaDiagram-UXIWVN3A.KSIw9w3I.js → ishikawaDiagram-UXIWVN3A.5ddTis2y.js} +1 -1
  140. package/dist/docs/assets/chunks/{journeyDiagram-VCZTEJTY.BN2Y5oUJ.js → journeyDiagram-VCZTEJTY.BUStU27-.js} +1 -1
  141. package/dist/docs/assets/chunks/{kanban-definition-6JOO6SKY.2KFuDYn_.js → kanban-definition-6JOO6SKY.CJd1psl3.js} +1 -1
  142. package/dist/docs/assets/chunks/{layout.Demb_pzL.js → layout.DqvbZSML.js} +1 -1
  143. package/dist/docs/assets/chunks/{linear.kYKxzbbR.js → linear.DOmz-1UB.js} +1 -1
  144. package/dist/docs/assets/chunks/{min.DwmCN5dF.js → min.33k2v8dM.js} +1 -1
  145. package/dist/docs/assets/chunks/{mindmap-definition-QFDTVHPH.CGlz01QG.js → mindmap-definition-QFDTVHPH.iISCqCXC.js} +1 -1
  146. package/dist/docs/assets/chunks/{pieDiagram-DEJITSTG.n3qsq4nA.js → pieDiagram-DEJITSTG.BHvVgzmD.js} +1 -1
  147. package/dist/docs/assets/chunks/{quadrantDiagram-34T5L4WZ.CGNJ1GSb.js → quadrantDiagram-34T5L4WZ.CY3w_-Cn.js} +1 -1
  148. package/dist/docs/assets/chunks/{requirementDiagram-MS252O5E.VhAzHDwQ.js → requirementDiagram-MS252O5E.CHXKQS1v.js} +1 -1
  149. package/dist/docs/assets/chunks/{sankeyDiagram-XADWPNL6.DmHA5pW-.js → sankeyDiagram-XADWPNL6.DTtRoGss.js} +1 -1
  150. package/dist/docs/assets/chunks/{sequenceDiagram-FGHM5R23._TC1aKhg.js → sequenceDiagram-FGHM5R23.NnPcQ3eY.js} +1 -1
  151. package/dist/docs/assets/chunks/{stateDiagram-FHFEXIEX.B-kLjV3O.js → stateDiagram-FHFEXIEX.D8DFciH7.js} +1 -1
  152. package/dist/docs/assets/chunks/stateDiagram-v2-QKLJ7IA2.ESAwmMws.js +1 -0
  153. package/dist/docs/assets/chunks/{theme.BaVlHHL-.js → theme.CwkiT-Fo.js} +2 -2
  154. package/dist/docs/assets/chunks/{timeline-definition-GMOUNBTQ.CresbphV.js → timeline-definition-GMOUNBTQ._wIWkMU6.js} +1 -1
  155. package/dist/docs/assets/chunks/{vennDiagram-DHZGUBPP.CegHD8Y4.js → vennDiagram-DHZGUBPP.NLVv7R6r.js} +1 -1
  156. package/dist/docs/assets/chunks/{wardley-RL74JXVD.DjCmZrUO.js → wardley-RL74JXVD.DbsCXUZp.js} +1 -1
  157. package/dist/docs/assets/chunks/{wardleyDiagram-NUSXRM2D.BJ7s1zdZ.js → wardleyDiagram-NUSXRM2D.Dp5uAVDl.js} +1 -1
  158. package/dist/docs/assets/chunks/{xychartDiagram-5P7HB3ND.IrEXlemI.js → xychartDiagram-5P7HB3ND.eOEBq4rX.js} +1 -1
  159. package/dist/docs/assets/{deployment.md.DJtuDVLh.js → deployment.md.CIRydNl3.js} +3 -3
  160. package/dist/docs/assets/{deployment.md.DJtuDVLh.lean.js → deployment.md.CIRydNl3.lean.js} +1 -1
  161. package/dist/docs/assets/guides_cloud-agents.md.BdWqmUGb.js +14 -0
  162. package/dist/docs/assets/{guides_cloud-agents.md.CiXAW6on.lean.js → guides_cloud-agents.md.BdWqmUGb.lean.js} +1 -1
  163. package/dist/docs/assets/guides_teams.md.7Lz2sbqB.js +50 -0
  164. package/dist/docs/assets/guides_teams.md.7Lz2sbqB.lean.js +1 -0
  165. package/dist/docs/assets/guides_workload-identity.md.DBV6YkXX.js +82 -0
  166. package/dist/docs/assets/guides_workload-identity.md.DBV6YkXX.lean.js +1 -0
  167. package/dist/docs/assets/{reference_agent-config.md.Bbqf0lgS.js → reference_agent-config.md.CfM1S6Ac.js} +2 -2
  168. package/dist/docs/assets/{reference_agent-config.md.Bbqf0lgS.lean.js → reference_agent-config.md.CfM1S6Ac.lean.js} +1 -1
  169. package/dist/docs/assets/{reference_channels.md.CPWOpdsC.js → reference_channels.md.CRvqgU0n.js} +1 -1
  170. package/dist/docs/assets/{reference_cli.md.DHm6DmYk.js → reference_cli.md.NS6U5a-7.js} +14 -4
  171. package/dist/docs/assets/{reference_cli.md.DHm6DmYk.lean.js → reference_cli.md.NS6U5a-7.lean.js} +1 -1
  172. package/dist/docs/assets/{reference_limits.md.CbdtFr4T.js → reference_limits.md.CW9PTdxr.js} +3 -3
  173. package/dist/docs/assets/{reference_limits.md.CbdtFr4T.lean.js → reference_limits.md.CW9PTdxr.lean.js} +1 -1
  174. package/dist/docs/assets/{reference_schedules.md.RhQ9ZLo1.js → reference_schedules.md.Dd8_d0WG.js} +3 -3
  175. package/dist/docs/assets/{reference_sessions.md.NXVQt9mP.js → reference_sessions.md.CoCyQLEz.js} +2 -2
  176. package/dist/docs/assets/{reference_sessions.md.NXVQt9mP.lean.js → reference_sessions.md.CoCyQLEz.lean.js} +1 -1
  177. package/dist/docs/assets/{reference_skills.md.DzCPNPkG.js → reference_skills.md.SFRZDC41.js} +4 -4
  178. package/dist/docs/assets/{reference_skills.md.DzCPNPkG.lean.js → reference_skills.md.SFRZDC41.lean.js} +1 -1
  179. package/dist/docs/assets/{style.DK0YX1WL.css → style.B7zPxANR.css} +1 -1
  180. package/dist/docs/assets/troubleshooting.md.CsQTleto.js +3 -0
  181. package/dist/docs/assets/{troubleshooting.md.DfKKvW1R.lean.js → troubleshooting.md.CsQTleto.lean.js} +1 -1
  182. package/dist/docs/building-with-agents.html +37 -37
  183. package/dist/docs/changelog.html +37 -37
  184. package/dist/docs/changelog.md +43 -0
  185. package/dist/docs/deployment.html +40 -40
  186. package/dist/docs/deployment.md +14 -0
  187. package/dist/docs/evals.html +37 -37
  188. package/dist/docs/guides/agent-to-agent.html +37 -37
  189. package/dist/docs/guides/bitbucket.html +37 -37
  190. package/dist/docs/guides/cloud-agents.html +43 -38
  191. package/dist/docs/guides/cloud-agents.md +47 -0
  192. package/dist/docs/guides/convert-automation.html +37 -37
  193. package/dist/docs/guides/github.html +37 -37
  194. package/dist/docs/guides/gitlab.html +37 -37
  195. package/dist/docs/guides/improve.html +37 -37
  196. package/dist/docs/guides/jev.html +37 -37
  197. package/dist/docs/guides/mcp-oauth.html +37 -37
  198. package/dist/docs/guides/migrate.html +37 -37
  199. package/dist/docs/guides/opentelemetry.html +37 -37
  200. package/dist/docs/guides/pagerduty.html +37 -37
  201. package/dist/docs/guides/slack.html +37 -37
  202. package/dist/docs/guides/teams.html +109 -0
  203. package/dist/docs/guides/teams.md +384 -0
  204. package/dist/docs/guides/webhooks.html +37 -37
  205. package/dist/docs/guides/workload-identity.html +141 -0
  206. package/dist/docs/guides/workload-identity.md +227 -0
  207. package/dist/docs/hashmap.json +1 -1
  208. package/dist/docs/hillclimbing.html +37 -37
  209. package/dist/docs/index.html +37 -37
  210. package/dist/docs/llms-full.txt +881 -5
  211. package/dist/docs/llms.txt +2 -0
  212. package/dist/docs/quickstart.html +37 -37
  213. package/dist/docs/reference/access.html +36 -36
  214. package/dist/docs/reference/agent-config.html +39 -39
  215. package/dist/docs/reference/agent-config.md +1 -1
  216. package/dist/docs/reference/artifacts.html +37 -37
  217. package/dist/docs/reference/channels.html +38 -38
  218. package/dist/docs/reference/channels.md +1 -0
  219. package/dist/docs/reference/cli.html +50 -40
  220. package/dist/docs/reference/cli.md +116 -0
  221. package/dist/docs/reference/connections.html +37 -37
  222. package/dist/docs/reference/evals.html +37 -37
  223. package/dist/docs/reference/extensions.html +37 -37
  224. package/dist/docs/reference/hooks.html +37 -37
  225. package/dist/docs/reference/http-api.html +37 -37
  226. package/dist/docs/reference/instructions.html +37 -37
  227. package/dist/docs/reference/limits.html +39 -39
  228. package/dist/docs/reference/limits.md +4 -4
  229. package/dist/docs/reference/memory.html +37 -37
  230. package/dist/docs/reference/playground.html +36 -36
  231. package/dist/docs/reference/project-layout.html +37 -37
  232. package/dist/docs/reference/schedules.html +40 -40
  233. package/dist/docs/reference/sessions.html +38 -38
  234. package/dist/docs/reference/sessions.md +13 -0
  235. package/dist/docs/reference/skills.html +40 -40
  236. package/dist/docs/reference/subagents.html +37 -37
  237. package/dist/docs/reference/tools.html +37 -37
  238. package/dist/docs/templates/agentic-owners.html +37 -37
  239. package/dist/docs/templates/reviews.html +37 -37
  240. package/dist/docs/troubleshooting.html +38 -38
  241. package/dist/docs/troubleshooting.md +21 -0
  242. package/dist/evals/run-facts.d.ts.map +1 -1
  243. package/dist/evals/run-facts.js +4 -0
  244. package/dist/extensions/cursor-cloud-agents/channels/cursor-cloud-agents.d.ts +12 -0
  245. package/dist/extensions/cursor-cloud-agents/channels/cursor-cloud-agents.d.ts.map +1 -0
  246. package/dist/extensions/cursor-cloud-agents/channels/cursor-cloud-agents.js +42 -0
  247. package/dist/extensions/cursor-cloud-agents/extension.d.ts +10 -7
  248. package/dist/extensions/cursor-cloud-agents/extension.d.ts.map +1 -1
  249. package/dist/extensions/cursor-cloud-agents/extension.js +3 -2
  250. package/dist/extensions/cursor-cloud-agents/lib/agent-id.d.ts +5 -0
  251. package/dist/extensions/cursor-cloud-agents/lib/agent-id.d.ts.map +1 -0
  252. package/dist/extensions/cursor-cloud-agents/lib/agent-id.js +10 -0
  253. package/dist/extensions/cursor-cloud-agents/lib/backend.d.ts +57 -3
  254. package/dist/extensions/cursor-cloud-agents/lib/backend.d.ts.map +1 -1
  255. package/dist/extensions/cursor-cloud-agents/lib/backend.js +150 -35
  256. package/dist/extensions/cursor-cloud-agents/lib/fleet.d.ts +32 -4
  257. package/dist/extensions/cursor-cloud-agents/lib/fleet.d.ts.map +1 -1
  258. package/dist/extensions/cursor-cloud-agents/lib/fleet.js +93 -7
  259. package/dist/extensions/cursor-cloud-agents/lib/launch-agent.d.ts +24 -7
  260. package/dist/extensions/cursor-cloud-agents/lib/launch-agent.d.ts.map +1 -1
  261. package/dist/extensions/cursor-cloud-agents/lib/launch-agent.js +158 -25
  262. package/dist/extensions/cursor-cloud-agents/lib/stop-signal.d.ts +18 -0
  263. package/dist/extensions/cursor-cloud-agents/lib/stop-signal.d.ts.map +1 -0
  264. package/dist/extensions/cursor-cloud-agents/lib/stop-signal.js +27 -0
  265. package/dist/extensions/cursor-cloud-agents/lib/transcript.d.ts.map +1 -1
  266. package/dist/extensions/cursor-cloud-agents/lib/transcript.js +2 -3
  267. package/dist/extensions/cursor-cloud-agents/lib/watch.d.ts +26 -12
  268. package/dist/extensions/cursor-cloud-agents/lib/watch.d.ts.map +1 -1
  269. package/dist/extensions/cursor-cloud-agents/lib/watch.js +115 -46
  270. package/dist/extensions/cursor-cloud-agents/reminders/cloud-agent-stop-watch.d.ts +16 -5
  271. package/dist/extensions/cursor-cloud-agents/reminders/cloud-agent-stop-watch.d.ts.map +1 -1
  272. package/dist/extensions/cursor-cloud-agents/reminders/cloud-agent-stop-watch.js +76 -20
  273. package/dist/extensions/cursor-cloud-agents/skills/handoff.md +2 -2
  274. package/dist/extensions/cursor-cloud-agents/tools/get.js +2 -2
  275. package/dist/extensions/cursor-cloud-agents/tools/launch.js +1 -1
  276. package/dist/extensions.d.ts.map +1 -1
  277. package/dist/extensions.js +18 -3
  278. package/dist/files-backends/agent-store-presigned-url.js +5 -1
  279. package/dist/index.d.ts +1 -0
  280. package/dist/index.d.ts.map +1 -1
  281. package/dist/index.js +1 -0
  282. package/dist/internal/approval-gate.d.ts +6 -1
  283. package/dist/internal/approval-gate.d.ts.map +1 -1
  284. package/dist/internal/approval-gate.js +13 -2
  285. package/dist/internal/authored-loaders.js +1 -1
  286. package/dist/internal/channel-architecture.d.ts.map +1 -1
  287. package/dist/internal/channel-architecture.js +3 -1
  288. package/dist/internal/cli/commands/channels.d.ts +9 -3
  289. package/dist/internal/cli/commands/channels.d.ts.map +1 -1
  290. package/dist/internal/cli/commands/channels.js +193 -4
  291. package/dist/internal/cli/commands/index.d.ts.map +1 -1
  292. package/dist/internal/cli/commands/index.js +6 -1
  293. package/dist/internal/cli/commands/serve.d.ts.map +1 -1
  294. package/dist/internal/cli/commands/serve.js +25 -5
  295. package/dist/internal/cli/dispatch.d.ts.map +1 -1
  296. package/dist/internal/cli/dispatch.js +22 -8
  297. package/dist/internal/cli/flags.d.ts +14 -0
  298. package/dist/internal/cli/flags.d.ts.map +1 -1
  299. package/dist/internal/cli/flags.js +14 -0
  300. package/dist/internal/cli/help.d.ts.map +1 -1
  301. package/dist/internal/cli/help.js +3 -1
  302. package/dist/internal/cli-ax.d.ts.map +1 -1
  303. package/dist/internal/cli-ax.js +6 -3
  304. package/dist/internal/cli-cursor.js +2 -2
  305. package/dist/internal/cli-deploy.d.ts +1 -0
  306. package/dist/internal/cli-deploy.d.ts.map +1 -1
  307. package/dist/internal/cli-deploy.js +19 -1
  308. package/dist/internal/cli-mcp.d.ts.map +1 -1
  309. package/dist/internal/cli-mcp.js +5 -3
  310. package/dist/internal/cli-teams-doctor.d.ts +39 -0
  311. package/dist/internal/cli-teams-doctor.d.ts.map +1 -0
  312. package/dist/internal/cli-teams-doctor.js +508 -0
  313. package/dist/internal/cli-teams-forward.d.ts +84 -0
  314. package/dist/internal/cli-teams-forward.d.ts.map +1 -0
  315. package/dist/internal/cli-teams-forward.js +386 -0
  316. package/dist/internal/cli-teams-package.d.ts +26 -0
  317. package/dist/internal/cli-teams-package.d.ts.map +1 -0
  318. package/dist/internal/cli-teams-package.js +123 -0
  319. package/dist/internal/cli-teams.d.ts +15 -0
  320. package/dist/internal/cli-teams.d.ts.map +1 -0
  321. package/dist/internal/cli-teams.js +253 -0
  322. package/dist/internal/connect-click.d.ts +12 -0
  323. package/dist/internal/connect-click.d.ts.map +1 -0
  324. package/dist/internal/connect-click.js +22 -0
  325. package/dist/internal/continuation-channel.d.ts +5 -1
  326. package/dist/internal/continuation-channel.d.ts.map +1 -1
  327. package/dist/internal/continuation-channel.js +34 -0
  328. package/dist/internal/continuation-identity.d.ts +7 -4
  329. package/dist/internal/continuation-identity.d.ts.map +1 -1
  330. package/dist/internal/continuation-identity.js +66 -1
  331. package/dist/internal/convert-automation/convert-workflow.js +2 -2
  332. package/dist/internal/credential-env-names.d.ts +36 -0
  333. package/dist/internal/credential-env-names.d.ts.map +1 -0
  334. package/dist/internal/credential-env-names.js +68 -0
  335. package/dist/internal/cursor/account-mcp.d.ts +67 -9
  336. package/dist/internal/cursor/account-mcp.d.ts.map +1 -1
  337. package/dist/internal/cursor/account-mcp.js +206 -25
  338. package/dist/internal/cursor/backend-client.d.ts +10 -1
  339. package/dist/internal/cursor/backend-client.d.ts.map +1 -1
  340. package/dist/internal/cursor/backend-client.js +19 -7
  341. package/dist/internal/cursor/cloud-agent-identity.d.ts +81 -0
  342. package/dist/internal/cursor/cloud-agent-identity.d.ts.map +1 -0
  343. package/dist/internal/cursor/cloud-agent-identity.js +224 -0
  344. package/dist/internal/cursor/credentials.d.ts.map +1 -1
  345. package/dist/internal/cursor/credentials.js +3 -1
  346. package/dist/internal/cursor-account-mcp-auth.d.ts +8 -1
  347. package/dist/internal/cursor-account-mcp-auth.d.ts.map +1 -1
  348. package/dist/internal/cursor-account-mcp-auth.js +22 -6
  349. package/dist/internal/deploy-client.d.ts.map +1 -1
  350. package/dist/internal/deploy-client.js +34 -2
  351. package/dist/internal/deploy-manifest.d.ts +51 -3
  352. package/dist/internal/deploy-manifest.d.ts.map +1 -1
  353. package/dist/internal/deploy-manifest.js +96 -7
  354. package/dist/internal/discovery/agent-config.d.ts.map +1 -1
  355. package/dist/internal/discovery/agent-config.js +6 -1
  356. package/dist/internal/discovery/agent.d.ts.map +1 -1
  357. package/dist/internal/discovery/agent.js +2 -1
  358. package/dist/internal/discovery/connections.d.ts +5 -0
  359. package/dist/internal/discovery/connections.d.ts.map +1 -1
  360. package/dist/internal/discovery/connections.js +71 -1
  361. package/dist/internal/discovery/extensions.d.ts.map +1 -1
  362. package/dist/internal/discovery/extensions.js +2 -0
  363. package/dist/internal/discovery/info.d.ts.map +1 -1
  364. package/dist/internal/discovery/info.js +4 -0
  365. package/dist/internal/env-file.d.ts +1 -0
  366. package/dist/internal/env-file.d.ts.map +1 -1
  367. package/dist/internal/env-file.js +18 -17
  368. package/dist/internal/env-prefix.d.ts +11 -0
  369. package/dist/internal/env-prefix.d.ts.map +1 -0
  370. package/dist/internal/env-prefix.js +23 -0
  371. package/dist/internal/event-id-dedupe.d.ts +12 -0
  372. package/dist/internal/event-id-dedupe.d.ts.map +1 -0
  373. package/dist/{channels/slack → internal}/event-id-dedupe.js +7 -4
  374. package/dist/internal/event-mapper.d.ts +7 -2
  375. package/dist/internal/event-mapper.d.ts.map +1 -1
  376. package/dist/internal/event-mapper.js +7 -0
  377. package/dist/internal/expected-delivery-failure.d.ts.map +1 -1
  378. package/dist/internal/expected-delivery-failure.js +3 -0
  379. package/dist/internal/extension-namespace.d.ts +9 -0
  380. package/dist/internal/extension-namespace.d.ts.map +1 -0
  381. package/dist/internal/extension-namespace.js +14 -0
  382. package/dist/internal/guid.d.ts +2 -0
  383. package/dist/internal/guid.d.ts.map +1 -0
  384. package/dist/internal/guid.js +4 -0
  385. package/dist/internal/host-kv-cas.d.ts +13 -0
  386. package/dist/internal/host-kv-cas.d.ts.map +1 -0
  387. package/dist/internal/host-kv-cas.js +26 -0
  388. package/dist/internal/host-kv.d.ts +4 -1
  389. package/dist/internal/host-kv.d.ts.map +1 -1
  390. package/dist/internal/host-kv.js +15 -2
  391. package/dist/internal/hosted-catch-protocol.d.ts +5 -0
  392. package/dist/internal/hosted-catch-protocol.d.ts.map +1 -1
  393. package/dist/internal/hosted-catch-protocol.js +5 -0
  394. package/dist/internal/hosted-catch.d.ts +2 -0
  395. package/dist/internal/hosted-catch.d.ts.map +1 -1
  396. package/dist/internal/hosted-catch.js +6 -1
  397. package/dist/internal/hosted-delivery-protocol.d.ts +4 -0
  398. package/dist/internal/hosted-delivery-protocol.d.ts.map +1 -1
  399. package/dist/internal/hosted-delivery-protocol.js +73 -3
  400. package/dist/internal/hosted-delivery.d.ts +9 -3
  401. package/dist/internal/hosted-delivery.d.ts.map +1 -1
  402. package/dist/internal/hosted-delivery.js +14 -3
  403. package/dist/internal/hosted-session-fixture.js +1 -1
  404. package/dist/internal/hosting.d.ts +5 -0
  405. package/dist/internal/hosting.d.ts.map +1 -1
  406. package/dist/internal/hosting.js +7 -1
  407. package/dist/internal/ids.d.ts +2 -0
  408. package/dist/internal/ids.d.ts.map +1 -1
  409. package/dist/internal/ids.js +5 -0
  410. package/dist/internal/install-cursor-skills.d.ts +6 -7
  411. package/dist/internal/install-cursor-skills.d.ts.map +1 -1
  412. package/dist/internal/install-cursor-skills.js +15 -9
  413. package/dist/internal/interview/agent-questions.d.ts +1 -1
  414. package/dist/internal/interview/agent-questions.d.ts.map +1 -1
  415. package/dist/internal/interview/agent-questions.js +4 -3
  416. package/dist/internal/local-control-plane.d.ts.map +1 -1
  417. package/dist/internal/local-control-plane.js +24 -0
  418. package/dist/internal/mcp-allowlist-in-use.d.ts +23 -0
  419. package/dist/internal/mcp-allowlist-in-use.d.ts.map +1 -0
  420. package/dist/internal/mcp-allowlist-in-use.js +93 -0
  421. package/dist/internal/mcp-endpoint.d.ts.map +1 -1
  422. package/dist/internal/mcp-endpoint.js +8 -10
  423. package/dist/internal/mcp-host.d.ts +19 -1
  424. package/dist/internal/mcp-host.d.ts.map +1 -1
  425. package/dist/internal/mcp-host.js +67 -3
  426. package/dist/internal/mcp-oauth.d.ts.map +1 -1
  427. package/dist/internal/mcp-oauth.js +5 -7
  428. package/dist/internal/oidcAudiences.d.ts +22 -0
  429. package/dist/internal/oidcAudiences.d.ts.map +1 -0
  430. package/dist/internal/oidcAudiences.js +35 -0
  431. package/dist/internal/otel/collector.d.ts.map +1 -1
  432. package/dist/internal/otel/collector.js +2 -0
  433. package/dist/internal/platform-timers.d.ts +2 -0
  434. package/dist/internal/platform-timers.d.ts.map +1 -1
  435. package/dist/internal/platform-timers.js +14 -0
  436. package/dist/internal/private-file.d.ts +32 -1
  437. package/dist/internal/private-file.d.ts.map +1 -1
  438. package/dist/internal/private-file.js +209 -7
  439. package/dist/internal/redact-values.d.ts +3 -0
  440. package/dist/internal/redact-values.d.ts.map +1 -0
  441. package/dist/internal/redact-values.js +19 -0
  442. package/dist/internal/reminder-control-plane-protocol.d.ts +7 -1
  443. package/dist/internal/reminder-control-plane-protocol.d.ts.map +1 -1
  444. package/dist/internal/reminder-followup-error.d.ts +23 -0
  445. package/dist/internal/reminder-followup-error.d.ts.map +1 -0
  446. package/dist/internal/reminder-followup-error.js +12 -0
  447. package/dist/internal/reminder-runner.d.ts +15 -1
  448. package/dist/internal/reminder-runner.d.ts.map +1 -1
  449. package/dist/internal/reminder-runner.js +95 -21
  450. package/dist/internal/resolved-connections.d.ts.map +1 -1
  451. package/dist/internal/resolved-connections.js +23 -3
  452. package/dist/internal/run-client.js +2 -1
  453. package/dist/internal/run-program.d.ts +31 -0
  454. package/dist/internal/run-program.d.ts.map +1 -0
  455. package/dist/internal/run-program.js +150 -0
  456. package/dist/internal/schedule-runner.d.ts +1 -0
  457. package/dist/internal/schedule-runner.d.ts.map +1 -1
  458. package/dist/internal/schedule-runner.js +10 -1
  459. package/dist/internal/sdk-runner.d.ts +28 -2
  460. package/dist/internal/sdk-runner.d.ts.map +1 -1
  461. package/dist/internal/sdk-runner.js +298 -38
  462. package/dist/internal/server.d.ts.map +1 -1
  463. package/dist/internal/server.js +53 -8
  464. package/dist/internal/session-credential.d.ts +14 -0
  465. package/dist/internal/session-credential.d.ts.map +1 -0
  466. package/dist/internal/session-credential.js +25 -0
  467. package/dist/internal/session-engine.d.ts +140 -6
  468. package/dist/internal/session-engine.d.ts.map +1 -1
  469. package/dist/internal/session-engine.js +583 -93
  470. package/dist/internal/storage-coordinator.d.ts +3 -1
  471. package/dist/internal/storage-coordinator.d.ts.map +1 -1
  472. package/dist/internal/storage-coordinator.js +13 -0
  473. package/dist/internal/storage-roles.d.ts +9 -1
  474. package/dist/internal/storage-roles.d.ts.map +1 -1
  475. package/dist/internal/teams-channel-profile.d.ts +41 -0
  476. package/dist/internal/teams-channel-profile.d.ts.map +1 -0
  477. package/dist/internal/teams-channel-profile.js +91 -0
  478. package/dist/internal/teams-devtunnel.d.ts +55 -0
  479. package/dist/internal/teams-devtunnel.d.ts.map +1 -0
  480. package/dist/internal/teams-devtunnel.js +205 -0
  481. package/dist/internal/teams-tunnel-proxy.d.ts +17 -0
  482. package/dist/internal/teams-tunnel-proxy.d.ts.map +1 -0
  483. package/dist/internal/teams-tunnel-proxy.js +100 -0
  484. package/dist/internal/testing/conversation-identity-vectors.d.ts +7 -1
  485. package/dist/internal/testing/conversation-identity-vectors.d.ts.map +1 -1
  486. package/dist/internal/testing/conversation-identity-vectors.js +67 -0
  487. package/dist/internal/testing/hosted-http.d.ts +15 -0
  488. package/dist/internal/testing/hosted-http.d.ts.map +1 -0
  489. package/dist/internal/testing/hosted-http.js +86 -0
  490. package/dist/internal/testing/teams-activity-fixtures.d.ts +28 -0
  491. package/dist/internal/testing/teams-activity-fixtures.d.ts.map +1 -0
  492. package/dist/internal/testing/teams-activity-fixtures.js +236 -0
  493. package/dist/internal/testing/teams-doctor-fixtures.d.ts +76 -0
  494. package/dist/internal/testing/teams-doctor-fixtures.d.ts.map +1 -0
  495. package/dist/internal/testing/teams-doctor-fixtures.js +216 -0
  496. package/dist/internal/tunnel-process.d.ts +29 -0
  497. package/dist/internal/tunnel-process.d.ts.map +1 -0
  498. package/dist/internal/tunnel-process.js +105 -0
  499. package/dist/internal/turn-context.d.ts +28 -0
  500. package/dist/internal/turn-context.d.ts.map +1 -0
  501. package/dist/internal/turn-context.js +1 -0
  502. package/dist/oidc-token.d.ts +131 -0
  503. package/dist/oidc-token.d.ts.map +1 -0
  504. package/dist/oidc-token.js +221 -0
  505. package/dist/playground/assets/chunk-YOKDWASO-BPO_8GRX.js +115 -0
  506. package/dist/playground/assets/highlighted-body-KPVGNVTW-CxEV-T_f.js +1 -0
  507. package/dist/playground/assets/index-CjFJhCtb.js +62 -0
  508. package/dist/playground/assets/index-vwUVwmk8.css +1 -0
  509. package/dist/playground/assets/mermaid-HWGCJPDP-eK-fpbFn.js +1 -0
  510. package/dist/playground/index.html +2 -2
  511. package/dist/teams-app-package.d.ts +78 -0
  512. package/dist/teams-app-package.d.ts.map +1 -0
  513. package/dist/teams-app-package.js +204 -0
  514. package/dist/tools.d.ts +1 -1
  515. package/dist/tools.d.ts.map +1 -1
  516. package/dist/types.d.ts +271 -2
  517. package/dist/types.d.ts.map +1 -1
  518. package/docs/changelog.md +43 -0
  519. package/docs/deployment.md +14 -0
  520. package/docs/guides/cloud-agents.md +47 -0
  521. package/docs/guides/teams.md +389 -0
  522. package/docs/guides/workload-identity.md +232 -0
  523. package/docs/reference/agent-config.md +1 -1
  524. package/docs/reference/channels.md +1 -0
  525. package/docs/reference/cli.md +116 -0
  526. package/docs/reference/limits.md +4 -4
  527. package/docs/reference/sessions.md +13 -0
  528. package/docs/troubleshooting.md +21 -0
  529. package/package.json +23 -46
  530. package/skills/create-agent/SKILL.md +17 -4
  531. package/skills/debug/SKILL.md +1 -0
  532. package/skills/deploy/SKILL.md +1 -1
  533. package/skills/framework-map/SKILL.md +1 -0
  534. package/skills/setup-teams/SKILL.md +141 -0
  535. package/templates/agentic-owners/bot/lib/owners/parse.ts +1 -0
  536. package/dist/channels/slack/event-id-dedupe.d.ts +0 -10
  537. package/dist/channels/slack/event-id-dedupe.d.ts.map +0 -1
  538. package/dist/docs/assets/changelog.md.DVNB-ApU.js +0 -1
  539. package/dist/docs/assets/chunks/@localSearchIndexroot.DdlR-9Oe.js +0 -1
  540. package/dist/docs/assets/chunks/channel.CdyTxaXV.js +0 -1
  541. package/dist/docs/assets/chunks/classDiagram-6PBFFD2Q.CeUcN6TW.js +0 -1
  542. package/dist/docs/assets/chunks/classDiagram-v2-HSJHXN6E.CeUcN6TW.js +0 -1
  543. package/dist/docs/assets/chunks/clone.DpIwUbur.js +0 -1
  544. package/dist/docs/assets/chunks/stateDiagram-v2-QKLJ7IA2.HtBkUH4J.js +0 -1
  545. package/dist/docs/assets/guides_cloud-agents.md.CiXAW6on.js +0 -9
  546. package/dist/docs/assets/troubleshooting.md.DfKKvW1R.js +0 -3
  547. package/dist/playground/assets/index-CnFd5R1_.js +0 -62
  548. package/dist/playground/assets/index-DNzRv6G8.css +0 -1
  549. /package/dist/docs/assets/{reference_channels.md.CPWOpdsC.lean.js → reference_channels.md.CRvqgU0n.lean.js} +0 -0
  550. /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 { type AgentProject, type AuthPolicy } from "../../types.js";
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
- * Route auth for the bridge: the per-boot bearer secret, from a loopback
78
- * TCP peer — or from anywhere when the serve host exposed the bridge via
79
- * `publicUrl` (cloud turns arrive through that ingress with the secret).
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. Staleness and
104
- * joining are decided synchronously: in-flight entries always join their
105
- * promise; fresh entries use {@link CatalogEntry.freshAtMs} for TTL.
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,EAGhB,MAAM,gBAAgB,CAAC;AAOxB,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,sBAAsB,CAAC;AACrE,OAAO,EAIL,KAAK,eAAe,EAErB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,KAAK,EACV,oBAAoB,EACpB,gBAAgB,EAChB,mBAAmB,EACpB,MAAM,qBAAqB,CAAC;AAU7B,0EAA0E;AAC1E,eAAO,MAAM,gCAAgC,8CAA8C,CAAC;AAC5F,2EAA2E;AAC3E,eAAO,MAAM,oCAAoC,yDACO,CAAC;AAMzD,MAAM,WAAW,0BAA0B;IACzC,kFAAkF;IAClF,IAAI,EAAE,MAAM,CAAC;IACb,sEAAsE;IACtE,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;CACpB;AAED;;;;GAIG;AACH,wBAAgB,+BAA+B,CAC7C,MAAM,EAAE,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,YAAY,CAAA;CAAE,CAAC,GACrD,GAAG,CAAC,MAAM,EAAE,0BAA0B,EAAE,CAAC,CAuB3C;AAED,oFAAoF;AACpF,wBAAgB,oBAAoB,CAAC,cAAc,EAAE,MAAM,GAAG,MAAM,CAEnE;AAED;;;;;GAKG;AACH,wBAAgB,+BAA+B,CAAC,IAAI,EAAE;IACpD,IAAI,EAAE,0BAA0B,EAAE,CAAC;IACnC,+CAA+C;IAC/C,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,GAAG,wBAAwB,EAAE,CAe7B;AAqCD,qBAAa,sBAAsB;IACjC,yEAAyE;IACzE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAmC;IAC1D,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAsB;IAC7C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAyB;IAChD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAkB;IAC1C,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAa;IAC1C,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAU;IAC7C,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAmC;IAE5D,YAAY,IAAI,EAAE;QAChB,MAAM,EAAE,mBAAmB,CAAC;QAC5B,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;QAChC,2EAA2E;QAC3E,OAAO,CAAC,EAAE,eAAe,CAAC;QAC1B;;;;WAIG;QACH,kBAAkB,CAAC,EAAE,OAAO,CAAC;KAC9B,EAMA;IAED;;;;OAIG;IACH,UAAU,IAAI,UAAU,CAevB;IAED;;;OAGG;IACH,MAAM,CACJ,OAAO,EAAE,OAAO,EAChB,GAAG,EAAE,0BAA0B,EAC/B,QAAQ,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,oBAAoB,KAAK,oBAAoB,GACnF,OAAO,CAAC,QAAQ,CAAC,CAQnB;IAED;;;;;;;;OAQG;IACG,YAAY,CAAC,GAAG,EAAE,0BAA0B,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAkB/E;IAED,YAAY,CAAC,IAAI,EAAE,0BAA0B,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAE9D;YAEa,YAAY;IA0D1B,OAAO,CAAC,WAAW;IAgFnB,0EAA0E;YAC5D,QAAQ;IAatB;;;;OAIG;IACH,OAAO,CAAC,UAAU;CAqCnB;AAqED,MAAM,WAAW,6BAA6B;IAC5C,gBAAgB,EAAE,MAAM,CAAC;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,8EAA8E;IAC9E,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AA2CD;;;GAGG;AACH,wBAAgB,gCAAgC,CAAC,IAAI,EAAE;IACrD,cAAc,EAAE,MAAM,CAAC;IACvB,OAAO,EAAE,SAAS,6BAA6B,EAAE,CAAC;IAClD,OAAO,CAAC,EAAE,eAAe,CAAC;IAC1B,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB,GAAG,MAAM,CAQT;AAyCD,yFAAyF;AACzF,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,gBAAgB,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,MAAM,CAkBhG;AAED;;;;GAIG;AACH,wBAAsB,sBAAsB,CAC1C,MAAM,EAAE,IAAI,CAAC,mBAAmB,EAAE,uBAAuB,CAAC,EAC1D,gBAAgB,EAAE,MAAM,GACvB,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAwB7B"}
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, from a loopback
107
- * TCP peer — or from anywhere when the serve host exposed the bridge via
108
- * `publicUrl` (cloud turns arrive through that ingress with the secret).
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
- if ((await this.secretPolicy(request, info)) === null) {
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
- return handleStatelessMcpRequest({
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 catalog = await this.getCatalog(ref);
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
- buildServer(ref, sessionId, decorate) {
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. Staleness and
291
- * joining are decided synchronously: in-flight entries always join their
292
- * promise; fresh entries use {@link CatalogEntry.freshAtMs} for TTL.
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 key = ref.servers === undefined ? "*" : [...ref.servers].sort().join("\n");
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")