@grok/agent-sdk 0.6.0 → 0.7.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (521) hide show
  1. package/AGENTS.md +40 -0
  2. package/dist/channels/github/forward.d.ts +5 -0
  3. package/dist/channels/github/forward.d.ts.map +1 -1
  4. package/dist/channels/github/forward.js +6 -3
  5. package/dist/channels/slack/api.d.ts +18 -0
  6. package/dist/channels/slack/api.d.ts.map +1 -1
  7. package/dist/channels/slack/api.js +31 -0
  8. package/dist/channels/slack/approvals.d.ts +19 -2
  9. package/dist/channels/slack/approvals.d.ts.map +1 -1
  10. package/dist/channels/slack/approvals.js +90 -19
  11. package/dist/channels/slack/attachments.d.ts +7 -2
  12. package/dist/channels/slack/attachments.d.ts.map +1 -1
  13. package/dist/channels/slack/attachments.js +318 -156
  14. package/dist/channels/slack/connect-card.d.ts +16 -0
  15. package/dist/channels/slack/connect-card.d.ts.map +1 -0
  16. package/dist/channels/slack/connect-card.js +31 -0
  17. package/dist/channels/slack/credentials.d.ts +10 -2
  18. package/dist/channels/slack/credentials.d.ts.map +1 -1
  19. package/dist/channels/slack/credentials.js +17 -15
  20. package/dist/channels/slack/defaults.d.ts.map +1 -1
  21. package/dist/channels/slack/defaults.js +18 -9
  22. package/dist/channels/slack/dispatch.d.ts +1 -1
  23. package/dist/channels/slack/dispatch.d.ts.map +1 -1
  24. package/dist/channels/slack/dispatch.js +19 -3
  25. package/dist/channels/slack/inbound.d.ts +8 -2
  26. package/dist/channels/slack/inbound.d.ts.map +1 -1
  27. package/dist/channels/slack/inbound.js +25 -4
  28. package/dist/channels/slack/index.d.ts +3 -2
  29. package/dist/channels/slack/index.d.ts.map +1 -1
  30. package/dist/channels/slack/index.js +3 -2
  31. package/dist/channels/slack/init.d.ts.map +1 -1
  32. package/dist/channels/slack/init.js +2 -1
  33. package/dist/channels/slack/mentions.d.ts +28 -0
  34. package/dist/channels/slack/mentions.d.ts.map +1 -0
  35. package/dist/channels/slack/mentions.js +178 -0
  36. package/dist/channels/slack/setup.js +1 -1
  37. package/dist/channels/slack/slack-channel.d.ts.map +1 -1
  38. package/dist/channels/slack/slack-channel.js +46 -3
  39. package/dist/channels/slack/stop.d.ts.map +1 -1
  40. package/dist/channels/slack/stop.js +7 -1
  41. package/dist/channels/slack/thread-context.d.ts +3 -0
  42. package/dist/channels/slack/thread-context.d.ts.map +1 -1
  43. package/dist/channels/slack/thread-context.js +17 -7
  44. package/dist/channels/slack/tool-approval-events.d.ts.map +1 -1
  45. package/dist/channels/slack/tool-approval-events.js +55 -2
  46. package/dist/channels/slack/types.d.ts +2 -0
  47. package/dist/channels/slack/types.d.ts.map +1 -1
  48. package/dist/channels/teams/activity.d.ts +33 -0
  49. package/dist/channels/teams/activity.d.ts.map +1 -0
  50. package/dist/channels/teams/activity.js +213 -0
  51. package/dist/channels/teams/auth.d.ts +25 -0
  52. package/dist/channels/teams/auth.d.ts.map +1 -0
  53. package/dist/channels/teams/auth.js +55 -0
  54. package/dist/channels/teams/bot-framework-auth.d.ts +33 -0
  55. package/dist/channels/teams/bot-framework-auth.d.ts.map +1 -0
  56. package/dist/channels/teams/bot-framework-auth.js +154 -0
  57. package/dist/channels/teams/cards.d.ts +23 -0
  58. package/dist/channels/teams/cards.d.ts.map +1 -0
  59. package/dist/channels/teams/cards.js +107 -0
  60. package/dist/channels/teams/connector.d.ts +48 -0
  61. package/dist/channels/teams/connector.d.ts.map +1 -0
  62. package/dist/channels/teams/connector.js +159 -0
  63. package/dist/channels/teams/credentials.d.ts +65 -0
  64. package/dist/channels/teams/credentials.d.ts.map +1 -0
  65. package/dist/channels/teams/credentials.js +84 -0
  66. package/dist/channels/teams/delivery.d.ts +14 -0
  67. package/dist/channels/teams/delivery.d.ts.map +1 -0
  68. package/dist/channels/teams/delivery.js +169 -0
  69. package/dist/channels/teams/dispatch.d.ts +45 -0
  70. package/dist/channels/teams/dispatch.d.ts.map +1 -0
  71. package/dist/channels/teams/dispatch.js +402 -0
  72. package/dist/channels/teams/engagement.d.ts +32 -0
  73. package/dist/channels/teams/engagement.d.ts.map +1 -0
  74. package/dist/channels/teams/engagement.js +120 -0
  75. package/dist/channels/teams/index.d.ts +21 -0
  76. package/dist/channels/teams/index.d.ts.map +1 -0
  77. package/dist/channels/teams/index.js +19 -0
  78. package/dist/channels/teams/marks.d.ts +19 -0
  79. package/dist/channels/teams/marks.d.ts.map +1 -0
  80. package/dist/channels/teams/marks.js +96 -0
  81. package/dist/channels/teams/senders.d.ts +27 -0
  82. package/dist/channels/teams/senders.d.ts.map +1 -0
  83. package/dist/channels/teams/senders.js +72 -0
  84. package/dist/channels/teams/teams-channel.d.ts +43 -0
  85. package/dist/channels/teams/teams-channel.d.ts.map +1 -0
  86. package/dist/channels/teams/teams-channel.js +278 -0
  87. package/dist/channels/teams/text.d.ts +7 -0
  88. package/dist/channels/teams/text.d.ts.map +1 -0
  89. package/dist/channels/teams/text.js +63 -0
  90. package/dist/channels/teams/types.d.ts +306 -0
  91. package/dist/channels/teams/types.d.ts.map +1 -0
  92. package/dist/channels/teams/types.js +1 -0
  93. package/dist/channels.d.ts +31 -0
  94. package/dist/channels.d.ts.map +1 -1
  95. package/dist/channels.js +37 -0
  96. package/dist/connections.d.ts +1 -1
  97. package/dist/connections.d.ts.map +1 -1
  98. package/dist/docs/404.html +3 -3
  99. package/dist/docs/assets/{app.lt-BYgI2.js → app.Ch-048af.js} +4 -4
  100. package/dist/docs/assets/changelog.md.SoN0MK7o.js +1 -0
  101. package/dist/docs/assets/{changelog.md.DVNB-ApU.lean.js → changelog.md.SoN0MK7o.lean.js} +1 -1
  102. package/dist/docs/assets/chunks/@localSearchIndexroot.BdYoBKxY.js +1 -0
  103. package/dist/docs/assets/chunks/{VPLocalSearchBox.v_dV4U2Q.js → VPLocalSearchBox.D7BIa9Su.js} +2 -2
  104. package/dist/docs/assets/chunks/{arc.5o92kOg5.js → arc.BIzu7OVF.js} +1 -1
  105. package/dist/docs/assets/chunks/{architectureDiagram-Q4EWVU46.C-oTwnNq.js → architectureDiagram-Q4EWVU46.DNznI0Sn.js} +1 -1
  106. package/dist/docs/assets/chunks/{baseUniq.zJ-VNOib.js → baseUniq.B4y6Y5eG.js} +1 -1
  107. package/dist/docs/assets/chunks/{blockDiagram-DXYQGD6D.B9ZJZuPd.js → blockDiagram-DXYQGD6D.BudnBsgw.js} +1 -1
  108. package/dist/docs/assets/chunks/{c4Diagram-AHTNJAMY.BBMwSIaN.js → c4Diagram-AHTNJAMY._bB00GdB.js} +1 -1
  109. package/dist/docs/assets/chunks/channel.CgxlmuBS.js +1 -0
  110. package/dist/docs/assets/chunks/{chunk-4BX2VUAB.D8qAJpDD.js → chunk-4BX2VUAB.CRftnUwS.js} +1 -1
  111. package/dist/docs/assets/chunks/{chunk-4TB4RGXK.B8QR5cdE.js → chunk-4TB4RGXK.CSx1x2Ob.js} +1 -1
  112. package/dist/docs/assets/chunks/{chunk-55IACEB6.BsWxVuew.js → chunk-55IACEB6.KkLHAAbH.js} +1 -1
  113. package/dist/docs/assets/chunks/{chunk-EDXVE4YY.BeGygY_i.js → chunk-EDXVE4YY.DDeKCCtX.js} +1 -1
  114. package/dist/docs/assets/chunks/{chunk-FMBD7UC4.DdwgH-ZH.js → chunk-FMBD7UC4.DrLlsD9m.js} +1 -1
  115. package/dist/docs/assets/chunks/{chunk-OYMX7WX6.B9zC_ALe.js → chunk-OYMX7WX6.DeVYOGcT.js} +1 -1
  116. package/dist/docs/assets/chunks/{chunk-QZHKN3VN.BIxJ0rcL.js → chunk-QZHKN3VN.Cz4_bS6p.js} +1 -1
  117. package/dist/docs/assets/chunks/{chunk-YZCP3GAM.qiM_23_f.js → chunk-YZCP3GAM.CwrYtDVo.js} +1 -1
  118. package/dist/docs/assets/chunks/classDiagram-6PBFFD2Q.DWroREP-.js +1 -0
  119. package/dist/docs/assets/chunks/classDiagram-v2-HSJHXN6E.DWroREP-.js +1 -0
  120. package/dist/docs/assets/chunks/clone.F824-PNx.js +1 -0
  121. package/dist/docs/assets/chunks/{cose-bilkent-S5V4N54A.BKB971D5.js → cose-bilkent-S5V4N54A.3d8hflz6.js} +1 -1
  122. package/dist/docs/assets/chunks/{dagre-KV5264BT.CcILjJgp.js → dagre-KV5264BT.BVEgjiPg.js} +1 -1
  123. package/dist/docs/assets/chunks/{diagram-5BDNPKRD.DkY9A0nu.js → diagram-5BDNPKRD.j7dZpUK_.js} +1 -1
  124. package/dist/docs/assets/chunks/{diagram-G4DWMVQ6.BbdzmjMt.js → diagram-G4DWMVQ6.4flIgIon.js} +1 -1
  125. package/dist/docs/assets/chunks/{diagram-MMDJMWI5.Be0zy1cM.js → diagram-MMDJMWI5.BlJiFh-S.js} +1 -1
  126. package/dist/docs/assets/chunks/{diagram-TYMM5635.zOiEycLe.js → diagram-TYMM5635.DHAOHEyM.js} +1 -1
  127. package/dist/docs/assets/chunks/{erDiagram-SMLLAGMA.DUd_9HMF.js → erDiagram-SMLLAGMA.DkmyG7xK.js} +1 -1
  128. package/dist/docs/assets/chunks/{flowDiagram-DWJPFMVM.2KPYoZBO.js → flowDiagram-DWJPFMVM.L_WiaAU6.js} +1 -1
  129. package/dist/docs/assets/chunks/{ganttDiagram-T4ZO3ILL.DqE8_YpP.js → ganttDiagram-T4ZO3ILL.CT6kOI2a.js} +1 -1
  130. package/dist/docs/assets/chunks/{gitGraphDiagram-UUTBAWPF.CO0Tk47h.js → gitGraphDiagram-UUTBAWPF.D8CRlLqh.js} +1 -1
  131. package/dist/docs/assets/chunks/{graph.CNe5KbNy.js → graph.CdOyJvsX.js} +1 -1
  132. package/dist/docs/assets/chunks/{infoDiagram-42DDH7IO.BBhJ1X1B.js → infoDiagram-42DDH7IO.DcmXeSos.js} +1 -1
  133. package/dist/docs/assets/chunks/{ishikawaDiagram-UXIWVN3A.KSIw9w3I.js → ishikawaDiagram-UXIWVN3A.BBjY4mxr.js} +1 -1
  134. package/dist/docs/assets/chunks/{journeyDiagram-VCZTEJTY.BN2Y5oUJ.js → journeyDiagram-VCZTEJTY.BrXteAB6.js} +1 -1
  135. package/dist/docs/assets/chunks/{kanban-definition-6JOO6SKY.2KFuDYn_.js → kanban-definition-6JOO6SKY.OlHsUJVV.js} +1 -1
  136. package/dist/docs/assets/chunks/{layout.Demb_pzL.js → layout.DDwvoQlY.js} +1 -1
  137. package/dist/docs/assets/chunks/{linear.kYKxzbbR.js → linear.BRXPDWj3.js} +1 -1
  138. package/dist/docs/assets/chunks/{min.DwmCN5dF.js → min.3YwC0t3o.js} +1 -1
  139. package/dist/docs/assets/chunks/{mindmap-definition-QFDTVHPH.CGlz01QG.js → mindmap-definition-QFDTVHPH.mPHnT2lN.js} +1 -1
  140. package/dist/docs/assets/chunks/{pieDiagram-DEJITSTG.n3qsq4nA.js → pieDiagram-DEJITSTG.DEK2--em.js} +1 -1
  141. package/dist/docs/assets/chunks/{quadrantDiagram-34T5L4WZ.CGNJ1GSb.js → quadrantDiagram-34T5L4WZ.NCdRAOzK.js} +1 -1
  142. package/dist/docs/assets/chunks/{requirementDiagram-MS252O5E.VhAzHDwQ.js → requirementDiagram-MS252O5E.DLAocFWZ.js} +1 -1
  143. package/dist/docs/assets/chunks/{sankeyDiagram-XADWPNL6.DmHA5pW-.js → sankeyDiagram-XADWPNL6.afIOqpyT.js} +1 -1
  144. package/dist/docs/assets/chunks/{sequenceDiagram-FGHM5R23._TC1aKhg.js → sequenceDiagram-FGHM5R23.DXBjvkkE.js} +1 -1
  145. package/dist/docs/assets/chunks/{stateDiagram-FHFEXIEX.B-kLjV3O.js → stateDiagram-FHFEXIEX.B_SGgvgs.js} +1 -1
  146. package/dist/docs/assets/chunks/stateDiagram-v2-QKLJ7IA2.OKAy5Bz7.js +1 -0
  147. package/dist/docs/assets/chunks/{theme.BaVlHHL-.js → theme.bNyH5NPA.js} +2 -2
  148. package/dist/docs/assets/chunks/{timeline-definition-GMOUNBTQ.CresbphV.js → timeline-definition-GMOUNBTQ.CE6S1iSb.js} +1 -1
  149. package/dist/docs/assets/chunks/{vennDiagram-DHZGUBPP.CegHD8Y4.js → vennDiagram-DHZGUBPP.Blk7wb8V.js} +1 -1
  150. package/dist/docs/assets/chunks/{wardley-RL74JXVD.DjCmZrUO.js → wardley-RL74JXVD.DQqE3WF8.js} +1 -1
  151. package/dist/docs/assets/chunks/{wardleyDiagram-NUSXRM2D.BJ7s1zdZ.js → wardleyDiagram-NUSXRM2D.MUEQyRnz.js} +1 -1
  152. package/dist/docs/assets/chunks/{xychartDiagram-5P7HB3ND.IrEXlemI.js → xychartDiagram-5P7HB3ND.DnJA2aXp.js} +1 -1
  153. package/dist/docs/assets/{deployment.md.DJtuDVLh.js → deployment.md.N9S5KC5R.js} +2 -2
  154. package/dist/docs/assets/{deployment.md.DJtuDVLh.lean.js → deployment.md.N9S5KC5R.lean.js} +1 -1
  155. package/dist/docs/assets/guides_cloud-agents.md.BdWqmUGb.js +14 -0
  156. package/dist/docs/assets/{guides_cloud-agents.md.CiXAW6on.lean.js → guides_cloud-agents.md.BdWqmUGb.lean.js} +1 -1
  157. package/dist/docs/assets/guides_teams.md.7Lz2sbqB.js +50 -0
  158. package/dist/docs/assets/guides_teams.md.7Lz2sbqB.lean.js +1 -0
  159. package/dist/docs/assets/{reference_channels.md.CPWOpdsC.js → reference_channels.md.CRvqgU0n.js} +1 -1
  160. package/dist/docs/assets/{reference_cli.md.DHm6DmYk.js → reference_cli.md.NS6U5a-7.js} +14 -4
  161. package/dist/docs/assets/{reference_cli.md.DHm6DmYk.lean.js → reference_cli.md.NS6U5a-7.lean.js} +1 -1
  162. package/dist/docs/assets/{reference_limits.md.CbdtFr4T.js → reference_limits.md.CW9PTdxr.js} +3 -3
  163. package/dist/docs/assets/{reference_limits.md.CbdtFr4T.lean.js → reference_limits.md.CW9PTdxr.lean.js} +1 -1
  164. package/dist/docs/assets/{reference_schedules.md.RhQ9ZLo1.js → reference_schedules.md.Dd8_d0WG.js} +3 -3
  165. package/dist/docs/assets/{reference_sessions.md.NXVQt9mP.js → reference_sessions.md.CoCyQLEz.js} +2 -2
  166. package/dist/docs/assets/{reference_sessions.md.NXVQt9mP.lean.js → reference_sessions.md.CoCyQLEz.lean.js} +1 -1
  167. package/dist/docs/assets/{reference_skills.md.DzCPNPkG.js → reference_skills.md.SFRZDC41.js} +4 -4
  168. package/dist/docs/assets/{reference_skills.md.DzCPNPkG.lean.js → reference_skills.md.SFRZDC41.lean.js} +1 -1
  169. package/dist/docs/assets/{style.DK0YX1WL.css → style.B7zPxANR.css} +1 -1
  170. package/dist/docs/assets/troubleshooting.md.CsQTleto.js +3 -0
  171. package/dist/docs/assets/{troubleshooting.md.DfKKvW1R.lean.js → troubleshooting.md.CsQTleto.lean.js} +1 -1
  172. package/dist/docs/building-with-agents.html +37 -37
  173. package/dist/docs/changelog.html +37 -37
  174. package/dist/docs/changelog.md +35 -0
  175. package/dist/docs/deployment.html +39 -39
  176. package/dist/docs/deployment.md +10 -0
  177. package/dist/docs/evals.html +37 -37
  178. package/dist/docs/guides/agent-to-agent.html +37 -37
  179. package/dist/docs/guides/bitbucket.html +37 -37
  180. package/dist/docs/guides/cloud-agents.html +43 -38
  181. package/dist/docs/guides/cloud-agents.md +47 -0
  182. package/dist/docs/guides/convert-automation.html +37 -37
  183. package/dist/docs/guides/github.html +37 -37
  184. package/dist/docs/guides/gitlab.html +37 -37
  185. package/dist/docs/guides/improve.html +37 -37
  186. package/dist/docs/guides/jev.html +37 -37
  187. package/dist/docs/guides/mcp-oauth.html +37 -37
  188. package/dist/docs/guides/migrate.html +37 -37
  189. package/dist/docs/guides/opentelemetry.html +37 -37
  190. package/dist/docs/guides/pagerduty.html +37 -37
  191. package/dist/docs/guides/slack.html +37 -37
  192. package/dist/docs/guides/teams.html +109 -0
  193. package/dist/docs/guides/teams.md +384 -0
  194. package/dist/docs/guides/webhooks.html +37 -37
  195. package/dist/docs/hashmap.json +1 -1
  196. package/dist/docs/hillclimbing.html +37 -37
  197. package/dist/docs/index.html +37 -37
  198. package/dist/docs/llms-full.txt +636 -4
  199. package/dist/docs/llms.txt +1 -0
  200. package/dist/docs/quickstart.html +37 -37
  201. package/dist/docs/reference/access.html +36 -36
  202. package/dist/docs/reference/agent-config.html +37 -37
  203. package/dist/docs/reference/artifacts.html +37 -37
  204. package/dist/docs/reference/channels.html +38 -38
  205. package/dist/docs/reference/channels.md +1 -0
  206. package/dist/docs/reference/cli.html +50 -40
  207. package/dist/docs/reference/cli.md +116 -0
  208. package/dist/docs/reference/connections.html +37 -37
  209. package/dist/docs/reference/evals.html +37 -37
  210. package/dist/docs/reference/extensions.html +37 -37
  211. package/dist/docs/reference/hooks.html +37 -37
  212. package/dist/docs/reference/http-api.html +37 -37
  213. package/dist/docs/reference/instructions.html +37 -37
  214. package/dist/docs/reference/limits.html +39 -39
  215. package/dist/docs/reference/limits.md +4 -4
  216. package/dist/docs/reference/memory.html +37 -37
  217. package/dist/docs/reference/playground.html +36 -36
  218. package/dist/docs/reference/project-layout.html +37 -37
  219. package/dist/docs/reference/schedules.html +40 -40
  220. package/dist/docs/reference/sessions.html +38 -38
  221. package/dist/docs/reference/sessions.md +13 -0
  222. package/dist/docs/reference/skills.html +40 -40
  223. package/dist/docs/reference/subagents.html +37 -37
  224. package/dist/docs/reference/tools.html +37 -37
  225. package/dist/docs/templates/agentic-owners.html +37 -37
  226. package/dist/docs/templates/reviews.html +37 -37
  227. package/dist/docs/troubleshooting.html +38 -38
  228. package/dist/docs/troubleshooting.md +21 -0
  229. package/dist/evals/run-facts.d.ts.map +1 -1
  230. package/dist/evals/run-facts.js +4 -0
  231. package/dist/extensions/cursor-cloud-agents/channels/cursor-cloud-agents.d.ts +12 -0
  232. package/dist/extensions/cursor-cloud-agents/channels/cursor-cloud-agents.d.ts.map +1 -0
  233. package/dist/extensions/cursor-cloud-agents/channels/cursor-cloud-agents.js +42 -0
  234. package/dist/extensions/cursor-cloud-agents/extension.d.ts +10 -7
  235. package/dist/extensions/cursor-cloud-agents/extension.d.ts.map +1 -1
  236. package/dist/extensions/cursor-cloud-agents/extension.js +3 -2
  237. package/dist/extensions/cursor-cloud-agents/lib/agent-id.d.ts +5 -0
  238. package/dist/extensions/cursor-cloud-agents/lib/agent-id.d.ts.map +1 -0
  239. package/dist/extensions/cursor-cloud-agents/lib/agent-id.js +10 -0
  240. package/dist/extensions/cursor-cloud-agents/lib/backend.d.ts +57 -3
  241. package/dist/extensions/cursor-cloud-agents/lib/backend.d.ts.map +1 -1
  242. package/dist/extensions/cursor-cloud-agents/lib/backend.js +150 -35
  243. package/dist/extensions/cursor-cloud-agents/lib/fleet.d.ts +32 -4
  244. package/dist/extensions/cursor-cloud-agents/lib/fleet.d.ts.map +1 -1
  245. package/dist/extensions/cursor-cloud-agents/lib/fleet.js +93 -7
  246. package/dist/extensions/cursor-cloud-agents/lib/launch-agent.d.ts +24 -7
  247. package/dist/extensions/cursor-cloud-agents/lib/launch-agent.d.ts.map +1 -1
  248. package/dist/extensions/cursor-cloud-agents/lib/launch-agent.js +158 -25
  249. package/dist/extensions/cursor-cloud-agents/lib/stop-signal.d.ts +18 -0
  250. package/dist/extensions/cursor-cloud-agents/lib/stop-signal.d.ts.map +1 -0
  251. package/dist/extensions/cursor-cloud-agents/lib/stop-signal.js +27 -0
  252. package/dist/extensions/cursor-cloud-agents/lib/transcript.d.ts.map +1 -1
  253. package/dist/extensions/cursor-cloud-agents/lib/transcript.js +2 -3
  254. package/dist/extensions/cursor-cloud-agents/lib/watch.d.ts +26 -12
  255. package/dist/extensions/cursor-cloud-agents/lib/watch.d.ts.map +1 -1
  256. package/dist/extensions/cursor-cloud-agents/lib/watch.js +115 -46
  257. package/dist/extensions/cursor-cloud-agents/reminders/cloud-agent-stop-watch.d.ts +16 -5
  258. package/dist/extensions/cursor-cloud-agents/reminders/cloud-agent-stop-watch.d.ts.map +1 -1
  259. package/dist/extensions/cursor-cloud-agents/reminders/cloud-agent-stop-watch.js +76 -20
  260. package/dist/extensions/cursor-cloud-agents/skills/handoff.md +2 -2
  261. package/dist/extensions/cursor-cloud-agents/tools/get.js +2 -2
  262. package/dist/extensions/cursor-cloud-agents/tools/launch.js +1 -1
  263. package/dist/extensions.d.ts.map +1 -1
  264. package/dist/extensions.js +18 -3
  265. package/dist/files-backends/agent-store-presigned-url.js +5 -1
  266. package/dist/index.d.ts +1 -0
  267. package/dist/index.d.ts.map +1 -1
  268. package/dist/index.js +1 -0
  269. package/dist/internal/approval-gate.d.ts +6 -1
  270. package/dist/internal/approval-gate.d.ts.map +1 -1
  271. package/dist/internal/approval-gate.js +13 -2
  272. package/dist/internal/authored-loaders.js +1 -1
  273. package/dist/internal/channel-architecture.d.ts.map +1 -1
  274. package/dist/internal/channel-architecture.js +3 -1
  275. package/dist/internal/cli/commands/channels.d.ts +9 -3
  276. package/dist/internal/cli/commands/channels.d.ts.map +1 -1
  277. package/dist/internal/cli/commands/channels.js +193 -4
  278. package/dist/internal/cli/commands/index.d.ts.map +1 -1
  279. package/dist/internal/cli/commands/index.js +6 -1
  280. package/dist/internal/cli/commands/serve.d.ts.map +1 -1
  281. package/dist/internal/cli/commands/serve.js +25 -5
  282. package/dist/internal/cli/dispatch.d.ts.map +1 -1
  283. package/dist/internal/cli/dispatch.js +22 -8
  284. package/dist/internal/cli/flags.d.ts +14 -0
  285. package/dist/internal/cli/flags.d.ts.map +1 -1
  286. package/dist/internal/cli/flags.js +14 -0
  287. package/dist/internal/cli/help.d.ts.map +1 -1
  288. package/dist/internal/cli/help.js +3 -1
  289. package/dist/internal/cli-cursor.js +2 -2
  290. package/dist/internal/cli-deploy.d.ts +1 -0
  291. package/dist/internal/cli-deploy.d.ts.map +1 -1
  292. package/dist/internal/cli-deploy.js +19 -1
  293. package/dist/internal/cli-mcp.d.ts.map +1 -1
  294. package/dist/internal/cli-mcp.js +5 -3
  295. package/dist/internal/cli-teams-doctor.d.ts +39 -0
  296. package/dist/internal/cli-teams-doctor.d.ts.map +1 -0
  297. package/dist/internal/cli-teams-doctor.js +508 -0
  298. package/dist/internal/cli-teams-forward.d.ts +84 -0
  299. package/dist/internal/cli-teams-forward.d.ts.map +1 -0
  300. package/dist/internal/cli-teams-forward.js +386 -0
  301. package/dist/internal/cli-teams-package.d.ts +26 -0
  302. package/dist/internal/cli-teams-package.d.ts.map +1 -0
  303. package/dist/internal/cli-teams-package.js +123 -0
  304. package/dist/internal/cli-teams.d.ts +15 -0
  305. package/dist/internal/cli-teams.d.ts.map +1 -0
  306. package/dist/internal/cli-teams.js +253 -0
  307. package/dist/internal/connect-click.d.ts +12 -0
  308. package/dist/internal/connect-click.d.ts.map +1 -0
  309. package/dist/internal/connect-click.js +22 -0
  310. package/dist/internal/continuation-channel.d.ts +5 -1
  311. package/dist/internal/continuation-channel.d.ts.map +1 -1
  312. package/dist/internal/continuation-channel.js +34 -0
  313. package/dist/internal/continuation-identity.d.ts +7 -4
  314. package/dist/internal/continuation-identity.d.ts.map +1 -1
  315. package/dist/internal/continuation-identity.js +66 -1
  316. package/dist/internal/convert-automation/convert-workflow.js +2 -2
  317. package/dist/internal/credential-env-names.d.ts +36 -0
  318. package/dist/internal/credential-env-names.d.ts.map +1 -0
  319. package/dist/internal/credential-env-names.js +68 -0
  320. package/dist/internal/cursor/account-mcp.d.ts +67 -9
  321. package/dist/internal/cursor/account-mcp.d.ts.map +1 -1
  322. package/dist/internal/cursor/account-mcp.js +206 -25
  323. package/dist/internal/cursor/backend-client.d.ts +10 -1
  324. package/dist/internal/cursor/backend-client.d.ts.map +1 -1
  325. package/dist/internal/cursor/backend-client.js +19 -7
  326. package/dist/internal/cursor/cloud-agent-identity.d.ts +81 -0
  327. package/dist/internal/cursor/cloud-agent-identity.d.ts.map +1 -0
  328. package/dist/internal/cursor/cloud-agent-identity.js +224 -0
  329. package/dist/internal/cursor/credentials.d.ts.map +1 -1
  330. package/dist/internal/cursor/credentials.js +3 -1
  331. package/dist/internal/cursor-account-mcp-auth.d.ts +1 -0
  332. package/dist/internal/cursor-account-mcp-auth.d.ts.map +1 -1
  333. package/dist/internal/cursor-account-mcp-auth.js +2 -1
  334. package/dist/internal/deploy-client.d.ts.map +1 -1
  335. package/dist/internal/deploy-client.js +34 -2
  336. package/dist/internal/deploy-manifest.d.ts +51 -3
  337. package/dist/internal/deploy-manifest.d.ts.map +1 -1
  338. package/dist/internal/deploy-manifest.js +96 -7
  339. package/dist/internal/discovery/agent-config.d.ts.map +1 -1
  340. package/dist/internal/discovery/agent-config.js +6 -1
  341. package/dist/internal/discovery/connections.d.ts.map +1 -1
  342. package/dist/internal/discovery/connections.js +53 -0
  343. package/dist/internal/discovery/extensions.d.ts.map +1 -1
  344. package/dist/internal/discovery/extensions.js +2 -0
  345. package/dist/internal/discovery/info.d.ts.map +1 -1
  346. package/dist/internal/discovery/info.js +4 -0
  347. package/dist/internal/env-file.d.ts +1 -0
  348. package/dist/internal/env-file.d.ts.map +1 -1
  349. package/dist/internal/env-file.js +18 -17
  350. package/dist/internal/env-prefix.d.ts +11 -0
  351. package/dist/internal/env-prefix.d.ts.map +1 -0
  352. package/dist/internal/env-prefix.js +23 -0
  353. package/dist/internal/event-id-dedupe.d.ts +12 -0
  354. package/dist/internal/event-id-dedupe.d.ts.map +1 -0
  355. package/dist/{channels/slack → internal}/event-id-dedupe.js +7 -4
  356. package/dist/internal/event-mapper.d.ts +7 -2
  357. package/dist/internal/event-mapper.d.ts.map +1 -1
  358. package/dist/internal/event-mapper.js +7 -0
  359. package/dist/internal/expected-delivery-failure.d.ts.map +1 -1
  360. package/dist/internal/expected-delivery-failure.js +3 -0
  361. package/dist/internal/extension-namespace.d.ts +9 -0
  362. package/dist/internal/extension-namespace.d.ts.map +1 -0
  363. package/dist/internal/extension-namespace.js +14 -0
  364. package/dist/internal/guid.d.ts +2 -0
  365. package/dist/internal/guid.d.ts.map +1 -0
  366. package/dist/internal/guid.js +4 -0
  367. package/dist/internal/host-kv-cas.d.ts +13 -0
  368. package/dist/internal/host-kv-cas.d.ts.map +1 -0
  369. package/dist/internal/host-kv-cas.js +8 -0
  370. package/dist/internal/host-kv.d.ts +4 -1
  371. package/dist/internal/host-kv.d.ts.map +1 -1
  372. package/dist/internal/host-kv.js +15 -2
  373. package/dist/internal/hosted-catch-protocol.d.ts +5 -0
  374. package/dist/internal/hosted-catch-protocol.d.ts.map +1 -1
  375. package/dist/internal/hosted-catch-protocol.js +5 -0
  376. package/dist/internal/hosted-catch.d.ts +2 -0
  377. package/dist/internal/hosted-catch.d.ts.map +1 -1
  378. package/dist/internal/hosted-catch.js +6 -1
  379. package/dist/internal/hosted-delivery-protocol.d.ts +3 -0
  380. package/dist/internal/hosted-delivery-protocol.d.ts.map +1 -1
  381. package/dist/internal/hosted-delivery-protocol.js +69 -1
  382. package/dist/internal/hosted-delivery.d.ts +5 -2
  383. package/dist/internal/hosted-delivery.d.ts.map +1 -1
  384. package/dist/internal/hosted-delivery.js +11 -2
  385. package/dist/internal/hosted-session-fixture.js +1 -1
  386. package/dist/internal/hosting.d.ts +5 -0
  387. package/dist/internal/hosting.d.ts.map +1 -1
  388. package/dist/internal/hosting.js +7 -1
  389. package/dist/internal/install-cursor-skills.d.ts +6 -7
  390. package/dist/internal/install-cursor-skills.d.ts.map +1 -1
  391. package/dist/internal/install-cursor-skills.js +15 -9
  392. package/dist/internal/interview/agent-questions.d.ts +1 -1
  393. package/dist/internal/interview/agent-questions.d.ts.map +1 -1
  394. package/dist/internal/interview/agent-questions.js +4 -3
  395. package/dist/internal/local-control-plane.d.ts.map +1 -1
  396. package/dist/internal/local-control-plane.js +24 -0
  397. package/dist/internal/mcp-allowlist-in-use.d.ts +23 -0
  398. package/dist/internal/mcp-allowlist-in-use.d.ts.map +1 -0
  399. package/dist/internal/mcp-allowlist-in-use.js +93 -0
  400. package/dist/internal/mcp-endpoint.d.ts.map +1 -1
  401. package/dist/internal/mcp-endpoint.js +8 -10
  402. package/dist/internal/mcp-host.d.ts +19 -1
  403. package/dist/internal/mcp-host.d.ts.map +1 -1
  404. package/dist/internal/mcp-host.js +67 -3
  405. package/dist/internal/mcp-oauth.d.ts.map +1 -1
  406. package/dist/internal/mcp-oauth.js +5 -7
  407. package/dist/internal/oidcAudiences.d.ts +22 -0
  408. package/dist/internal/oidcAudiences.d.ts.map +1 -0
  409. package/dist/internal/oidcAudiences.js +35 -0
  410. package/dist/internal/otel/collector.d.ts.map +1 -1
  411. package/dist/internal/otel/collector.js +2 -0
  412. package/dist/internal/platform-timers.d.ts +2 -0
  413. package/dist/internal/platform-timers.d.ts.map +1 -1
  414. package/dist/internal/platform-timers.js +14 -0
  415. package/dist/internal/private-file.d.ts +32 -1
  416. package/dist/internal/private-file.d.ts.map +1 -1
  417. package/dist/internal/private-file.js +209 -7
  418. package/dist/internal/redact-values.d.ts +3 -0
  419. package/dist/internal/redact-values.d.ts.map +1 -0
  420. package/dist/internal/redact-values.js +19 -0
  421. package/dist/internal/reminder-control-plane-protocol.d.ts +7 -1
  422. package/dist/internal/reminder-control-plane-protocol.d.ts.map +1 -1
  423. package/dist/internal/reminder-followup-error.d.ts +23 -0
  424. package/dist/internal/reminder-followup-error.d.ts.map +1 -0
  425. package/dist/internal/reminder-followup-error.js +12 -0
  426. package/dist/internal/reminder-runner.d.ts +15 -1
  427. package/dist/internal/reminder-runner.d.ts.map +1 -1
  428. package/dist/internal/reminder-runner.js +95 -21
  429. package/dist/internal/resolved-connections.d.ts.map +1 -1
  430. package/dist/internal/resolved-connections.js +23 -3
  431. package/dist/internal/run-client.js +2 -1
  432. package/dist/internal/run-program.d.ts +31 -0
  433. package/dist/internal/run-program.d.ts.map +1 -0
  434. package/dist/internal/run-program.js +150 -0
  435. package/dist/internal/sdk-runner.d.ts +28 -2
  436. package/dist/internal/sdk-runner.d.ts.map +1 -1
  437. package/dist/internal/sdk-runner.js +298 -38
  438. package/dist/internal/server.d.ts.map +1 -1
  439. package/dist/internal/server.js +45 -4
  440. package/dist/internal/session-credential.d.ts +14 -0
  441. package/dist/internal/session-credential.d.ts.map +1 -0
  442. package/dist/internal/session-credential.js +25 -0
  443. package/dist/internal/session-engine.d.ts +136 -5
  444. package/dist/internal/session-engine.d.ts.map +1 -1
  445. package/dist/internal/session-engine.js +580 -92
  446. package/dist/internal/storage-coordinator.d.ts +3 -1
  447. package/dist/internal/storage-coordinator.d.ts.map +1 -1
  448. package/dist/internal/storage-coordinator.js +13 -0
  449. package/dist/internal/storage-roles.d.ts +9 -1
  450. package/dist/internal/storage-roles.d.ts.map +1 -1
  451. package/dist/internal/teams-channel-profile.d.ts +41 -0
  452. package/dist/internal/teams-channel-profile.d.ts.map +1 -0
  453. package/dist/internal/teams-channel-profile.js +91 -0
  454. package/dist/internal/teams-devtunnel.d.ts +55 -0
  455. package/dist/internal/teams-devtunnel.d.ts.map +1 -0
  456. package/dist/internal/teams-devtunnel.js +205 -0
  457. package/dist/internal/teams-tunnel-proxy.d.ts +17 -0
  458. package/dist/internal/teams-tunnel-proxy.d.ts.map +1 -0
  459. package/dist/internal/teams-tunnel-proxy.js +100 -0
  460. package/dist/internal/testing/conversation-identity-vectors.d.ts +7 -1
  461. package/dist/internal/testing/conversation-identity-vectors.d.ts.map +1 -1
  462. package/dist/internal/testing/conversation-identity-vectors.js +67 -0
  463. package/dist/internal/testing/hosted-http.d.ts +15 -0
  464. package/dist/internal/testing/hosted-http.d.ts.map +1 -0
  465. package/dist/internal/testing/hosted-http.js +86 -0
  466. package/dist/internal/testing/teams-activity-fixtures.d.ts +28 -0
  467. package/dist/internal/testing/teams-activity-fixtures.d.ts.map +1 -0
  468. package/dist/internal/testing/teams-activity-fixtures.js +236 -0
  469. package/dist/internal/testing/teams-doctor-fixtures.d.ts +76 -0
  470. package/dist/internal/testing/teams-doctor-fixtures.d.ts.map +1 -0
  471. package/dist/internal/testing/teams-doctor-fixtures.js +216 -0
  472. package/dist/internal/tunnel-process.d.ts +29 -0
  473. package/dist/internal/tunnel-process.d.ts.map +1 -0
  474. package/dist/internal/tunnel-process.js +105 -0
  475. package/dist/internal/turn-context.d.ts +28 -0
  476. package/dist/internal/turn-context.d.ts.map +1 -0
  477. package/dist/internal/turn-context.js +1 -0
  478. package/dist/oidc-token.d.ts +127 -0
  479. package/dist/oidc-token.d.ts.map +1 -0
  480. package/dist/oidc-token.js +221 -0
  481. package/dist/playground/assets/index-BaBSZXki.css +1 -0
  482. package/dist/playground/assets/index-BkAF8YlO.js +62 -0
  483. package/dist/playground/index.html +2 -2
  484. package/dist/teams-app-package.d.ts +78 -0
  485. package/dist/teams-app-package.d.ts.map +1 -0
  486. package/dist/teams-app-package.js +204 -0
  487. package/dist/tools.d.ts +1 -1
  488. package/dist/tools.d.ts.map +1 -1
  489. package/dist/types.d.ts +271 -2
  490. package/dist/types.d.ts.map +1 -1
  491. package/docs/changelog.md +35 -0
  492. package/docs/deployment.md +10 -0
  493. package/docs/guides/cloud-agents.md +47 -0
  494. package/docs/guides/teams.md +389 -0
  495. package/docs/reference/channels.md +1 -0
  496. package/docs/reference/cli.md +116 -0
  497. package/docs/reference/limits.md +4 -4
  498. package/docs/reference/sessions.md +13 -0
  499. package/docs/troubleshooting.md +21 -0
  500. package/package.json +21 -46
  501. package/skills/create-agent/SKILL.md +17 -4
  502. package/skills/debug/SKILL.md +1 -0
  503. package/skills/deploy/SKILL.md +1 -1
  504. package/skills/framework-map/SKILL.md +1 -0
  505. package/skills/setup-teams/SKILL.md +141 -0
  506. package/templates/agentic-owners/bot/lib/owners/parse.ts +1 -0
  507. package/dist/channels/slack/event-id-dedupe.d.ts +0 -10
  508. package/dist/channels/slack/event-id-dedupe.d.ts.map +0 -1
  509. package/dist/docs/assets/changelog.md.DVNB-ApU.js +0 -1
  510. package/dist/docs/assets/chunks/@localSearchIndexroot.DdlR-9Oe.js +0 -1
  511. package/dist/docs/assets/chunks/channel.CdyTxaXV.js +0 -1
  512. package/dist/docs/assets/chunks/classDiagram-6PBFFD2Q.CeUcN6TW.js +0 -1
  513. package/dist/docs/assets/chunks/classDiagram-v2-HSJHXN6E.CeUcN6TW.js +0 -1
  514. package/dist/docs/assets/chunks/clone.DpIwUbur.js +0 -1
  515. package/dist/docs/assets/chunks/stateDiagram-v2-QKLJ7IA2.HtBkUH4J.js +0 -1
  516. package/dist/docs/assets/guides_cloud-agents.md.CiXAW6on.js +0 -9
  517. package/dist/docs/assets/troubleshooting.md.DfKKvW1R.js +0 -3
  518. package/dist/playground/assets/index-CnFd5R1_.js +0 -62
  519. package/dist/playground/assets/index-DNzRv6G8.css +0 -1
  520. /package/dist/docs/assets/{reference_channels.md.CPWOpdsC.lean.js → reference_channels.md.CRvqgU0n.lean.js} +0 -0
  521. /package/dist/docs/assets/{reference_schedules.md.RhQ9ZLo1.lean.js → reference_schedules.md.Dd8_d0WG.lean.js} +0 -0
@@ -34,6 +34,7 @@ import { resolveConnectionEnvTemplates } from "./connection-env.js";
34
34
  import { applyAgentContinuationDefaults, channelContinuationIdentity, httpContinuationIdentity, } from "./continuation-channel.js";
35
35
  import { continuationSource, isOneShotContinuationKey, resolveV2Key, V2EngineError, } from "./continuation-identity.js";
36
36
  import { describeError, describeErrorCode } from "./describe-error.js";
37
+ import { parseConnectClickText } from "./connect-click.js";
37
38
  import { isDevMode } from "./dev-mode.js";
38
39
  import { EventLogStore } from "./event-log.js";
39
40
  import { TurnEventMapper } from "./event-mapper.js";
@@ -53,6 +54,7 @@ import { McpOauthOnDemandHub } from "./mcp-oauth-on-demand.js";
53
54
  import { shouldStartProcessMemoryTelemetry, startProcessMemoryTelemetry, } from "./process-memory-telemetry.js";
54
55
  import { buildSessionContextBlock, SCHEDULE_CHANNEL_PREFIX } from "./prompt-context.js";
55
56
  import { assertCloudCanHonorAccountServersFilters } from "./resolved-connections.js";
57
+ import { SessionCredentials, TOOL_SESSION_CREDENTIAL_PARAM } from "./session-credential.js";
56
58
  import { sessionExternalLinks } from "./session-links.js";
57
59
  import { SessionStore } from "./session-store.js";
58
60
  import { MEMORY_DIR_NAME } from "./memory-dir.js";
@@ -177,7 +179,58 @@ export class AuthInterruptedError extends Error {
177
179
  }
178
180
  /** How long an interactive turn waits for a person to authorize a connection. */
179
181
  export const MCP_AUTH_PARK_TIMEOUT_MS = 10 * 60_000;
182
+ function toolDenialText(toolName, reason) {
183
+ switch (reason) {
184
+ case "timeout":
185
+ return `Tool "${toolName}" was not approved in time.`;
186
+ case "interrupt":
187
+ return `Tool "${toolName}" was not run: the turn stopped before anyone approved it.`;
188
+ case undefined:
189
+ return `Tool "${toolName}" was denied by a human approver.`;
190
+ default: {
191
+ const unexpected = reason;
192
+ return unexpected;
193
+ }
194
+ }
195
+ }
196
+ /**
197
+ * Deny a parked call when the turn aborts or the wait reaches `timeoutMs`.
198
+ * Returns a stop function the caller runs when the park ends.
199
+ */
200
+ function armParkDeadline(signal, timeoutMs, end) {
201
+ const endForAbort = () => {
202
+ end("interrupt");
203
+ };
204
+ if (signal?.aborted === true) {
205
+ endForAbort();
206
+ }
207
+ else {
208
+ signal?.addEventListener("abort", endForAbort, { once: true });
209
+ }
210
+ const timer = setTimeout(() => {
211
+ end("timeout");
212
+ }, timeoutMs);
213
+ timer.unref();
214
+ return () => {
215
+ clearTimeout(timer);
216
+ signal?.removeEventListener("abort", endForAbort);
217
+ };
218
+ }
180
219
  const mcpAuthAls = new AsyncLocalStorage();
220
+ /**
221
+ * The queue key for a turn: its user id. A turn with no user is keyed by its
222
+ * chat sender, so two unlinked senders never share a turn; a run with no
223
+ * sender, such as a schedule, is `"none"`.
224
+ */
225
+ export function userKey(ctx) {
226
+ if (ctx?.user !== undefined) {
227
+ return String(ctx.user.id);
228
+ }
229
+ const source = ctx?.source;
230
+ return source?.kind === "slack" || source?.kind === "teams"
231
+ ? `none:${source.kind}:${source.tenantId}/${source.userId}`
232
+ : "none";
233
+ }
181
234
  const RELEASED_CONTINUATIONS_CAP = 256;
182
235
  /** Marker that we `git init`'d this shared harness so scaffold is ours to write. */
183
236
  const OWNED_HARNESS = join(".agent-serve", "owned-harness");
@@ -282,10 +335,16 @@ export class SessionEngine {
282
335
  /** Live turn snapshot so a coalesced Slack wake can repaint on this process. */
283
336
  this.liveTurns = new Map();
284
337
  /**
285
- * Per-session coalesce queue for `admission: "coalesce"` (Slack). Drained
286
- * into one follow-up turn when the active turn finishes without interrupt.
338
+ * Per-session coalesce queues for `admission: "coalesce"` (Slack), one per
339
+ * {@link userKey} in arrival order. Each drain starts one key's queue as one
340
+ * follow-up turn when the active turn finishes without interrupt.
287
341
  */
288
342
  this.coalesceQueues = new Map();
343
+ /**
344
+ * Context of the session's latest turn, held until that turn's drain ends.
345
+ * The wrapper's identity tells a turn's own entry from its successor's.
346
+ */
347
+ this.turnContexts = new Map();
289
348
  /**
290
349
  * Sessions whose turn lifecycle is draining coalesced follow-ups. Counts as
291
350
  * busy so inbound coalesce admits enqueue instead of racing `clearCoalesced`.
@@ -300,6 +359,8 @@ export class SessionEngine {
300
359
  this.oauthHub = new McpOauthOnDemandHub();
301
360
  /** Serve-time resolved connections (see {@link setResolvedConnections}). */
302
361
  this.resolvedConnections = [];
362
+ /** Prove which session a tool MCP endpoint request comes from. */
363
+ this.toolSessionCredentials = new SessionCredentials();
303
364
  /** Sessions whose completed turns all carry usage (no further backfill). */
304
365
  this.cloudUsageBackfillDone = new Set();
305
366
  /** Deduped in-flight cloud usage backfills, keyed by session id. */
@@ -397,7 +458,7 @@ export class SessionEngine {
397
458
  this.mcpHost = new McpHost([
398
459
  ...options.project.agent.connections,
399
460
  ...(options.project.agent.hostConnections ?? []),
400
- ].filter((connection) => !isSymbolicConnectionTransport(connection.transport)));
461
+ ].filter((connection) => !isSymbolicConnectionTransport(connection.transport)), { log: this.logger });
401
462
  const basePlatforms = options.platforms ?? createHostPlatforms();
402
463
  const slackBinding = resolveDedicatedSlackHostBinding(options.project.channels);
403
464
  this.platforms =
@@ -494,6 +555,10 @@ export class SessionEngine {
494
555
  setCursorAccountAuthProbe(probe) {
495
556
  this.probeCursorAccount = probe;
496
557
  }
558
+ /** Whether the session's turn user has connected an individual connection. */
559
+ setIndividualConnectedCheck(check) {
560
+ this.individualConnectedCheck = check;
561
+ }
497
562
  get oauthCallbackHub() {
498
563
  return this.oauthHub;
499
564
  }
@@ -683,7 +748,10 @@ export class SessionEngine {
683
748
  }
684
749
  slackNudgeHostApi() {
685
750
  return {
686
- append: (input) => this.nudgeStore.append(input),
751
+ append: async (input) => (await this.runsTurnFor(input.continuationKey)) &&
752
+ !this.queuedForAnotherUser(input.sourceTs)
753
+ ? this.nudgeStore.append(input)
754
+ : false,
687
755
  drainFormatted: (continuationKey) => this.nudgeStore.drainFormatted(continuationKey),
688
756
  clear: (continuationKey) => this.nudgeStore.clear(continuationKey),
689
757
  hasUndelivered: (continuationKey) => this.nudgeStore.hasUndelivered(continuationKey),
@@ -779,19 +847,24 @@ export class SessionEngine {
779
847
  // synchronize). Leave the durable continuation key unchanged.
780
848
  let record = existing;
781
849
  const enqueueOnly = sendOptions.hostedEnqueueOnly === true;
850
+ const admission = enqueueOnly ? "coalesce" : (sendOptions.admission ?? "preempt");
851
+ // A coalesced message may be queued and later dropped by a stop or a
852
+ // preempt; images on the record would then attach to an unrelated turn.
853
+ const admitImages = admission === "coalesce" ? sendOptions.images : undefined;
854
+ const recordImages = admission === "coalesce" ? undefined : sendOptions.images;
782
855
  if (!enqueueOnly) {
783
856
  const refreshWorkspace = sendOptions.workspaceDir !== undefined &&
784
857
  sendOptions.workspaceDir !== existing.workspaceOverride;
785
858
  if (refreshWorkspace ||
786
859
  sendOptions.workspaceFiles !== undefined ||
787
- sendOptions.images !== undefined) {
860
+ recordImages !== undefined) {
788
861
  record = await this.updateRecord(existing.sessionId, (current) => ({
789
862
  ...current,
790
863
  workspaceOverride: refreshWorkspace
791
864
  ? sendOptions.workspaceDir
792
865
  : current.workspaceOverride,
793
866
  pendingWorkspaceFiles: mergePendingWorkspaceFiles(current.pendingWorkspaceFiles, sendOptions.workspaceFiles),
794
- pendingImages: mergePendingImages(current.pendingImages, sendOptions.images),
867
+ pendingImages: mergePendingImages(current.pendingImages, recordImages),
795
868
  }));
796
869
  }
797
870
  // A caller can explicitly return a continuation to the agent's
@@ -822,12 +895,16 @@ export class SessionEngine {
822
895
  const since = (await this.logs.get(record.sessionId)).count;
823
896
  const coalesced = await this.startTurn(record.sessionId, message, {
824
897
  turnMode: sendOptions.turnMode ?? "non-interactive",
825
- admission: enqueueOnly ? "coalesce" : (sendOptions.admission ?? "preempt"),
898
+ admission,
826
899
  ...(sendOptions.coalesceSourceTs === undefined
827
900
  ? {}
828
901
  : { sourceTs: sendOptions.coalesceSourceTs }),
829
902
  ...(enqueueOnly ? { hostedEnqueueOnly: true } : {}),
830
903
  deliveryIds: [deliveryId],
904
+ platformDeliveryId: sendOptions.platformDeliveryId,
905
+ images: admitImages,
906
+ turnContext: sendOptions.turnContext,
907
+ turnSessionKey: sendOptions.turnSessionKey,
831
908
  });
832
909
  if (enqueueOnly && !coalesced) {
833
910
  throw new HostedEnqueueNotActiveError(record.sessionId);
@@ -891,6 +968,9 @@ export class SessionEngine {
891
968
  ? {}
892
969
  : { sourceTs: sendOptions.coalesceSourceTs }),
893
970
  deliveryIds: [deliveryId],
971
+ turnContext: sendOptions.turnContext,
972
+ turnSessionKey: sendOptions.turnSessionKey,
973
+ platformDeliveryId: sendOptions.platformDeliveryId,
894
974
  });
895
975
  return this.channelSession(record.sessionId, record, deliveryId, true, false, since);
896
976
  }
@@ -1022,11 +1102,16 @@ export class SessionEngine {
1022
1102
  state: repaintState,
1023
1103
  continuationToken: record.continuationKey,
1024
1104
  setContinuationToken: (token) => this.setContinuationToken(sessionId, token),
1025
- }, {
1026
- session: live.session,
1105
+ }, this.sessionContext({ sessionId, session: live.session, turnId: live.turnId }));
1106
+ }
1107
+ /** The context every channel `events` handler and hook gets for one event. */
1108
+ sessionContext({ sessionId, session, turnId, }) {
1109
+ return {
1110
+ session,
1027
1111
  host: this.hostForSession(sessionId),
1028
- artifacts: this.artifactsApi({ sessionId }),
1029
- });
1112
+ artifacts: this.artifactsApi({ sessionId, turnId }),
1113
+ steer: (message, steerOptions) => this.steerRunningTurn(sessionId, turnId, message, steerOptions),
1114
+ };
1030
1115
  }
1031
1116
  /**
1032
1117
  * Admit a turn for `sessionId`.
@@ -1051,7 +1136,10 @@ export class SessionEngine {
1051
1136
  if (options.hostedEnqueueOnly === true) {
1052
1137
  throw new HostedEnqueueNotActiveError(sessionId);
1053
1138
  }
1054
- await this.outbox.post(sessionId, { message, options });
1139
+ await this.outbox.post(sessionId, {
1140
+ message,
1141
+ options: { ...options, admission: "coalesce" },
1142
+ });
1055
1143
  return true;
1056
1144
  }
1057
1145
  return this.admitTurn(sessionId, message, options);
@@ -1059,6 +1147,19 @@ export class SessionEngine {
1059
1147
  this.admissionChains.set(sessionId, admitted.catch(() => { }));
1060
1148
  return admitted;
1061
1149
  }
1150
+ /**
1151
+ * A nudge reaches only a turn running in this process: the carrier runs
1152
+ * inside it. Another server's turn may belong to another user, which this
1153
+ * server cannot see, so its follow-ups arrive through the outbox instead.
1154
+ */
1155
+ async runsTurnFor(continuationKey) {
1156
+ for (const sessionId of this.turnAborts.keys()) {
1157
+ if ((await this.sessions.get(sessionId))?.continuationKey === continuationKey) {
1158
+ return true;
1159
+ }
1160
+ }
1161
+ return false;
1162
+ }
1062
1163
  /** Admit what other servers handed to this turn's holder. Never awaited by the lifecycle. */
1063
1164
  drainOutbox(sessionId) {
1064
1165
  void this.outbox
@@ -1071,7 +1172,9 @@ export class SessionEngine {
1071
1172
  .catch(() => { });
1072
1173
  }
1073
1174
  enqueueCoalesced(sessionId, item) {
1074
- const queue = this.coalesceQueues.get(sessionId) ?? [];
1175
+ const queues = this.coalesceQueues.get(sessionId) ?? new Map();
1176
+ const key = userKey(item.turnContext);
1177
+ const queue = queues.get(key) ?? [];
1075
1178
  const duplicate = item.sourceTs === undefined
1076
1179
  ? undefined
1077
1180
  : queue.find((entry) => entry.sourceTs === item.sourceTs);
@@ -1084,10 +1187,49 @@ export class SessionEngine {
1084
1187
  if (item.turnMode === "interactive") {
1085
1188
  duplicate.turnMode = "interactive";
1086
1189
  }
1190
+ if (duplicate.images === undefined || duplicate.images.length === 0) {
1191
+ duplicate.images = item.images;
1192
+ }
1087
1193
  return;
1088
1194
  }
1089
1195
  queue.push(item);
1090
- this.coalesceQueues.set(sessionId, queue);
1196
+ queues.set(key, queue);
1197
+ this.coalesceQueues.set(sessionId, queues);
1198
+ }
1199
+ /**
1200
+ * Take the next key's queue: the key of the turn that just finished first,
1201
+ * so its follow-ups the nudge carrier holds settle before another user's
1202
+ * turn runs, then the others in arrival order.
1203
+ */
1204
+ takeCoalescedQueue(sessionId) {
1205
+ const queues = this.coalesceQueues.get(sessionId);
1206
+ if (queues === undefined) {
1207
+ return undefined;
1208
+ }
1209
+ const finishedKey = userKey(this.turnContextFor(sessionId));
1210
+ const key = queues.has(finishedKey) ? finishedKey : queues.keys().next().value;
1211
+ if (key === undefined) {
1212
+ this.coalesceQueues.delete(sessionId);
1213
+ return undefined;
1214
+ }
1215
+ const queue = queues.get(key);
1216
+ queues.delete(key);
1217
+ if (queues.size === 0) {
1218
+ this.coalesceQueues.delete(sessionId);
1219
+ }
1220
+ return queue;
1221
+ }
1222
+ /** Whether a Slack follow-up waits in another user's queue, so no turn may carry it. */
1223
+ queuedForAnotherUser(sourceTs) {
1224
+ for (const [sessionId, queues] of this.coalesceQueues) {
1225
+ const runningKey = userKey(this.turnContextFor(sessionId));
1226
+ for (const [key, queue] of queues) {
1227
+ if (key !== runningKey && queue.some((item) => item.sourceTs === sourceTs)) {
1228
+ return true;
1229
+ }
1230
+ }
1231
+ }
1232
+ return false;
1091
1233
  }
1092
1234
  clearCoalesced(sessionId) {
1093
1235
  this.coalesceQueues.delete(sessionId);
@@ -1157,15 +1299,16 @@ export class SessionEngine {
1157
1299
  return parts.join("\n").trimEnd();
1158
1300
  }
1159
1301
  async drainCoalescedFollowups(sessionId) {
1160
- const queued = this.coalesceQueues.get(sessionId) ?? [];
1161
- if (queued.length === 0) {
1162
- return;
1163
- }
1164
- this.coalesceQueues.delete(sessionId);
1165
- const pending = await this.withoutNudgedFollowups(sessionId, queued);
1166
- if (pending.length === 0) {
1167
- this.logger(`[session] coalesce drain skipped; all follow-ups already nudged ${sessionId}`);
1168
- return;
1302
+ let pending = [];
1303
+ while (pending.length === 0) {
1304
+ const queued = this.takeCoalescedQueue(sessionId);
1305
+ if (queued === undefined) {
1306
+ return;
1307
+ }
1308
+ pending = await this.withoutNudgedFollowups(sessionId, queued);
1309
+ if (pending.length === 0) {
1310
+ this.logger(`[session] coalesce drain skipped; all follow-ups already nudged ${sessionId}`);
1311
+ }
1169
1312
  }
1170
1313
  // These become the next turn's prompt, so settle them in the nudge store
1171
1314
  // first: a surviving pending record would be injected by that turn's own
@@ -1173,6 +1316,7 @@ export class SessionEngine {
1173
1316
  await this.settleDrainedFollowups(sessionId, pending);
1174
1317
  const message = this.formatCoalescedFollowups(pending);
1175
1318
  this.logger(`[session] coalesce drain starting follow-up (${pending.length}) ${sessionId}`);
1319
+ const images = pending.flatMap((item) => item.images ?? []);
1176
1320
  await this.startTurn(sessionId, message, {
1177
1321
  turnMode: pending.some((item) => item.turnMode === "interactive")
1178
1322
  ? "interactive"
@@ -1180,8 +1324,33 @@ export class SessionEngine {
1180
1324
  admission: "preempt",
1181
1325
  retainCoalesced: true,
1182
1326
  deliveryIds: pending.flatMap((item) => item.deliveryIds),
1327
+ images: images.length > 0 ? images : undefined,
1328
+ turnContext: pending.at(-1)?.turnContext,
1329
+ turnSessionKey: pending.at(-1)?.turnSessionKey,
1183
1330
  });
1184
1331
  }
1332
+ /**
1333
+ * The public {@link SteerTurn}: steer into the session's running turn, or
1334
+ * report why not. Never admits, enqueues, or creates anything. `turnId`
1335
+ * pins the turn the caller belongs to.
1336
+ */
1337
+ async steerRunningTurn(sessionId, turnId, message, options = {}) {
1338
+ const deliveryId = resolveDeliveryId(options.deliveryId);
1339
+ const active = this.activeToolContexts.get(sessionId);
1340
+ if (active === undefined || (turnId !== undefined && active.turnId !== turnId)) {
1341
+ return { status: "no_turn" };
1342
+ }
1343
+ if (this.runner.steer === undefined) {
1344
+ return { status: "not_delivered", reason: "unsupported" };
1345
+ }
1346
+ if ((await this.steerIntoRunningTurn(sessionId, message)) !== "complete_delivered") {
1347
+ return { status: "not_delivered", reason: "refused" };
1348
+ }
1349
+ this.logger(`[session] steered own turn ${sessionId}`);
1350
+ active.emit({ type: "message.received", data: { text: message, deliveryIds: [deliveryId] } });
1351
+ active.emit({ type: "nudge.delivered", data: { deliveryId } });
1352
+ return { status: "steered", turnId: active.turnId, deliveryId };
1353
+ }
1185
1354
  async steerIntoRunningTurn(sessionId, message) {
1186
1355
  if (this.runner.steer === undefined) {
1187
1356
  return "revert_to_followup";
@@ -1196,7 +1365,12 @@ export class SessionEngine {
1196
1365
  }
1197
1366
  async admitTurn(sessionId, message, options) {
1198
1367
  const admission = options.admission ?? "preempt";
1199
- if (admission === "coalesce" && steeringEnabled() && this.isTurnRunning(sessionId)) {
1368
+ const images = options.images !== undefined && options.images.length > 0 ? options.images : undefined;
1369
+ if (admission === "coalesce" &&
1370
+ images === undefined &&
1371
+ steeringEnabled() &&
1372
+ this.isTurnRunning(sessionId) &&
1373
+ userKey(options.turnContext) === userKey(this.turnContextFor(sessionId))) {
1200
1374
  const toolCtx = this.activeToolContexts.get(sessionId);
1201
1375
  const steerOutcome = await this.steerIntoRunningTurn(sessionId, message);
1202
1376
  if (steerOutcome === "complete_delivered") {
@@ -1225,19 +1399,25 @@ export class SessionEngine {
1225
1399
  sourceTs: options.sourceTs,
1226
1400
  turnMode: options.turnMode,
1227
1401
  deliveryIds: [...(options.deliveryIds ?? [])],
1402
+ images,
1403
+ turnContext: options.turnContext,
1404
+ turnSessionKey: options.turnSessionKey,
1228
1405
  });
1229
1406
  this.logger(`[session] coalesce enqueue ${sessionId}`);
1230
1407
  return true;
1231
1408
  }
1232
- // Another server owns this session, so coalesce even a preempt. No local
1233
- // enqueue: `drainCoalescedFollowups` reads only this process's queue, so
1234
- // the shared nudge store is the carrier. Not redundant with `acquire`
1235
- // below — this returns before preempt's `clearCoalesced` drops the queue.
1236
- // Enqueue-only cannot claim coalesced here: nothing joined a local turn.
1409
+ // Another server owns this session, so coalesce even a preempt through
1410
+ // its outbox. Not redundant with `acquire` below — this returns before
1411
+ // preempt's `clearCoalesced` drops the queue. Enqueue-only cannot claim
1412
+ // coalesced here: nothing joined a local turn.
1237
1413
  if (await this.turnLeases.runningElsewhere(sessionId)) {
1238
1414
  if (options.hostedEnqueueOnly === true) {
1239
1415
  throw new HostedEnqueueNotActiveError(sessionId);
1240
1416
  }
1417
+ await this.outbox.post(sessionId, {
1418
+ message,
1419
+ options: { ...options, admission: "coalesce" },
1420
+ });
1241
1421
  this.logger(`[session] coalesce; another server owns ${sessionId}`);
1242
1422
  return true;
1243
1423
  }
@@ -1276,6 +1456,7 @@ export class SessionEngine {
1276
1456
  const record = await this.updateRecord(sessionId, (current) => ({
1277
1457
  ...current,
1278
1458
  turnCount: current.turnCount + 1,
1459
+ pendingImages: mergePendingImages(current.pendingImages, images),
1279
1460
  }));
1280
1461
  const turnId = `turn_${record.turnCount}`;
1281
1462
  const isFirstTurn = record.turnCount === 1;
@@ -1289,6 +1470,16 @@ export class SessionEngine {
1289
1470
  const abort = new AbortController();
1290
1471
  this.turnAborts.set(sessionId, abort);
1291
1472
  this.turnModes.set(sessionId, options.turnMode);
1473
+ const ownContext = { context: options.turnContext, sessionKey: options.turnSessionKey };
1474
+ this.turnContexts.set(sessionId, ownContext);
1475
+ const unlinkedSlackUserId = this.unlinkedSlackSenderNeedingLink(options);
1476
+ if (unlinkedSlackUserId !== undefined) {
1477
+ await this.appendEvent(sessionId, {
1478
+ type: "action.account_link_requested",
1479
+ turnId,
1480
+ data: { slackUserId: unlinkedSlackUserId },
1481
+ });
1482
+ }
1292
1483
  // Lifecycle promise includes post-turn coalesce drain so waiters and
1293
1484
  // interrupt settle after follow-ups are admitted (not only executeTurn).
1294
1485
  // Assigned before the async body runs so self-identity checks typecheck.
@@ -1298,7 +1489,7 @@ export class SessionEngine {
1298
1489
  const poll = setInterval(() => this.drainOutbox(sessionId), 1_000);
1299
1490
  poll.unref();
1300
1491
  try {
1301
- outcome = await this.executeTurn(record, turnId, message, isFirstTurn, abort.signal);
1492
+ outcome = await this.executeTurn(record, turnId, message, isFirstTurn, abort.signal, options.platformDeliveryId);
1302
1493
  if (outcome.status === "cancelled") {
1303
1494
  outcome.cancellationReason = abort.signal.aborted ? "signal" : "runner";
1304
1495
  }
@@ -1339,6 +1530,9 @@ export class SessionEngine {
1339
1530
  }
1340
1531
  }
1341
1532
  }
1533
+ if (this.turnContexts.get(sessionId) === ownContext) {
1534
+ this.turnContexts.delete(sessionId);
1535
+ }
1342
1536
  // The drain may have nested a successor turn, which took its own
1343
1537
  // reference; the lease outlives this release until that one ends too.
1344
1538
  await lease.release();
@@ -1386,7 +1580,7 @@ export class SessionEngine {
1386
1580
  const hadWork = this.turnAborts.has(sessionId) ||
1387
1581
  this.activeTurns.has(sessionId) ||
1388
1582
  this.coalesceDrains.has(sessionId) ||
1389
- (this.coalesceQueues.get(sessionId)?.length ?? 0) > 0;
1583
+ (this.coalesceQueues.get(sessionId)?.size ?? 0) > 0;
1390
1584
  this.clearCoalesced(sessionId);
1391
1585
  await this.outbox.clear(sessionId);
1392
1586
  const record = await this.sessions.get(sessionId);
@@ -1579,6 +1773,33 @@ export class SessionEngine {
1579
1773
  this.sessionRootInflight.delete(options.sessionId);
1580
1774
  }
1581
1775
  }
1776
+ /**
1777
+ * The discovered skills the session's `skills` tree serves, asked on
1778
+ * every turn: a skill the tree stops serving drops out of the index, and
1779
+ * so does one whose stat throws.
1780
+ */
1781
+ async mountedSkills(record) {
1782
+ const { skills: mount } = await this.resolveAuthoredFileSystem({
1783
+ sessionId: record.sessionId,
1784
+ continuationKey: record.continuationKey ?? undefined,
1785
+ cache: true,
1786
+ });
1787
+ const served = [];
1788
+ if (mount === undefined) {
1789
+ return served;
1790
+ }
1791
+ for (const skill of this.project.agent.skills) {
1792
+ try {
1793
+ if ((await mount.stat(`/${skill.name}/SKILL.md`)).kind === "file") {
1794
+ served.push(skill);
1795
+ }
1796
+ }
1797
+ catch (error) {
1798
+ this.logger(`[session] skill ${skill.name} left out of the index for ${record.sessionId}: ${describeError(error)}`);
1799
+ }
1800
+ }
1801
+ return served;
1802
+ }
1582
1803
  baseSkillsFileSystem() {
1583
1804
  this.baseSkills ??= skillsFileSystem(this.project.agent.skills).catch((error) => {
1584
1805
  this.baseSkills = undefined;
@@ -1761,7 +1982,7 @@ export class SessionEngine {
1761
1982
  }
1762
1983
  return this.harnessCwd(record);
1763
1984
  }
1764
- async executeTurn(record, turnId, message, isFirstTurn, signal) {
1985
+ async executeTurn(record, turnId, message, isFirstTurn, signal, platformDeliveryId) {
1765
1986
  const sessionId = record.sessionId;
1766
1987
  const workspaceDir = this.scaffoldDir(record);
1767
1988
  const harnessCwd = this.harnessCwd(record);
@@ -1770,6 +1991,7 @@ export class SessionEngine {
1770
1991
  channelState: structuredClone(turnChannelState),
1771
1992
  channelStateAtTurnStart: structuredClone(turnChannelState),
1772
1993
  session: this.sessionInfo(record),
1994
+ turnId,
1773
1995
  };
1774
1996
  this.liveTurns.set(sessionId, eventContext);
1775
1997
  // Hold the open log so tool events append synchronously. Fire-and-forget
@@ -1891,8 +2113,11 @@ export class SessionEngine {
1891
2113
  await yieldEventLoop();
1892
2114
  }
1893
2115
  };
2116
+ const settled = runtime === "local" && this.hasIndividualAccountConnections()
2117
+ ? await this.settleConnects(sessionId, message, emit)
2118
+ : undefined;
1894
2119
  const endBuildRequest = this.startTurnPhase(record, turnId, "build_request");
1895
- const request = await this.buildTurnRequest(record, turnId, message, isFirstTurn, emit, eventContext, onUpdate, signal, pendingImages);
2120
+ const request = await this.buildTurnRequest(record, turnId, message, isFirstTurn, emit, eventContext, onUpdate, signal, pendingImages, platformDeliveryId);
1896
2121
  endBuildRequest();
1897
2122
  // Runner start (SDK agent create/resume, MCP connect, model request)
1898
2123
  // until the first streamed update.
@@ -1900,7 +2125,13 @@ export class SessionEngine {
1900
2125
  this.activeToolContexts.set(sessionId, { record, turnId, emit });
1901
2126
  this.stubbedCallIds.set(sessionId, stubbed);
1902
2127
  try {
1903
- outcome = await this.runTurnExecute(record, turnId, () => this.runner.runTurn(request));
2128
+ if (settled === undefined) {
2129
+ outcome = await this.runTurnExecute(record, turnId, () => this.runner.runTurn(request));
2130
+ }
2131
+ else {
2132
+ mapper.handleUpdate({ type: "text-delta", text: settled.skip });
2133
+ outcome = { status: "finished", result: settled.skip };
2134
+ }
1904
2135
  }
1905
2136
  finally {
1906
2137
  endFirstUpdate?.();
@@ -2156,7 +2387,7 @@ export class SessionEngine {
2156
2387
  fallbackAfterStream: undefined,
2157
2388
  };
2158
2389
  }
2159
- async buildTurnRequest(record, turnId, prompt, isFirstTurn, emit, eventContext, onUpdate, signal, images) {
2390
+ async buildTurnRequest(record, turnId, prompt, isFirstTurn, emit, eventContext, onUpdate, signal, images, platformDeliveryId) {
2160
2391
  const agent = this.project.agent;
2161
2392
  const instructionsAgent = agentWithInstructionsOverride(agent, record.instructions);
2162
2393
  // Per-session cloud attach (channel/tool handoff) forces cloud runtime
@@ -2288,10 +2519,9 @@ export class SessionEngine {
2288
2519
  // bodies and indexes the skills mounted in the tree.
2289
2520
  const localInstructions = runtime === "local"
2290
2521
  ? authoredRoot
2291
- ? buildAgentsMdContent(instructionsAgent, {
2292
- includeScripts: true,
2293
- skillsIndex: agent.skillsMount !== false,
2294
- })
2522
+ ? buildAgentsMdContent(typeof agent.skillsMount === "function"
2523
+ ? { ...instructionsAgent, skills: await this.mountedSkills(record) }
2524
+ : instructionsAgent, { includeScripts: true, skillsIndex: agent.skillsMount !== false })
2295
2525
  : buildAgentsMdContent(instructionsAgent, {
2296
2526
  includeScripts: this.hasBorrowedWorkspace(record),
2297
2527
  skillsIndex: workspaceConfined && agent.skills.length > 0,
@@ -2352,6 +2582,9 @@ export class SessionEngine {
2352
2582
  this.project.agent.connections.some((connection) => isCursorAccountTransport(connection.transport)))
2353
2583
  ? { perSendMcpServers: true }
2354
2584
  : {}),
2585
+ onMcpAuthRequest: runtime === "local" && this.hasIndividualAccountConnections()
2586
+ ? (request) => this.answerMcpAuth(record.sessionId, turnId, emit, request)
2587
+ : undefined,
2355
2588
  subagents: buildRunnerSubagents(agent),
2356
2589
  onUpdate,
2357
2590
  signal,
@@ -2382,13 +2615,28 @@ export class SessionEngine {
2382
2615
  },
2383
2616
  }, eventContext);
2384
2617
  },
2618
+ reattachCloudRunId: reattachableCloudRunId(record, platformDeliveryId),
2619
+ platformDeliveryId,
2620
+ onCloudRunStarted: async ({ sdkAgentId, runId }) => {
2621
+ if (platformDeliveryId !== undefined) {
2622
+ await this.updateRecord(record.sessionId, (current) => ({
2623
+ ...current,
2624
+ hostedCloudRun: { platformDeliveryId, sdkAgentId, runId },
2625
+ }));
2626
+ }
2627
+ // The cloud run outlives this process. Storage otherwise sees the
2628
+ // bound agent only at turn end, so a host that replaces this one
2629
+ // mid-turn would start a second cloud agent.
2630
+ this.storage?.flushSessionExact(record.sessionId);
2631
+ },
2385
2632
  };
2386
2633
  }
2387
2634
  /**
2388
2635
  * Connection names a cloud turn can only reach through the host connection
2389
2636
  * bridge on the tool MCP endpoint: filtered account connections without a
2390
2637
  * public bridge URL, and host-OAuth connections whose tokens live on this
2391
- * host.
2638
+ * host. Individual connections never qualify: the endpoint authenticates
2639
+ * the deployment, not the session, so it cannot dial as a session's user.
2392
2640
  */
2393
2641
  cloudBridgeableConnectionNames() {
2394
2642
  const names = [];
@@ -2398,7 +2646,9 @@ export class SessionEngine {
2398
2646
  }
2399
2647
  }
2400
2648
  for (const resolved of this.resolvedConnections) {
2401
- if (resolved.accountServersFilter !== undefined && resolved.cloudUrl === undefined) {
2649
+ if (resolved.accountServersFilter !== undefined &&
2650
+ resolved.individualCredentials !== true &&
2651
+ resolved.cloudUrl === undefined) {
2402
2652
  names.push(resolved.name);
2403
2653
  }
2404
2654
  }
@@ -2426,11 +2676,25 @@ export class SessionEngine {
2426
2676
  if (connection === undefined || !("url" in connection)) {
2427
2677
  return undefined;
2428
2678
  }
2429
- const url = new URL(connection.url);
2430
- url.searchParams.set("agentkitSessionId", sessionId);
2679
+ const url = this.sessionToolsUrl(connection.url, sessionId);
2431
2680
  url.searchParams.set("connection", connectionName);
2432
2681
  return { ...connection, url: url.toString() };
2433
2682
  }
2683
+ /** The tool MCP endpoint URL bound to `sessionId` and carrying its credential. */
2684
+ sessionToolsUrl(base, sessionId) {
2685
+ const url = new URL(base);
2686
+ url.searchParams.set("agentkitSessionId", sessionId);
2687
+ url.searchParams.set(TOOL_SESSION_CREDENTIAL_PARAM, this.toolSessionCredentials.for(sessionId));
2688
+ return url;
2689
+ }
2690
+ /**
2691
+ * Whether a tool MCP endpoint request presents the credential of the
2692
+ * session it names. The endpoint's own auth admits the deployment, not a
2693
+ * session, so this is what keeps one session out of another's tools.
2694
+ */
2695
+ presentsToolSessionCredential(sessionId, presented) {
2696
+ return this.toolSessionCredentials.verifies(sessionId, presented);
2697
+ }
2434
2698
  /**
2435
2699
  * Authored + resolved MCP servers for a turn. Skips advertised
2436
2700
  * connections (those surface as named server tools). On cloud turns,
@@ -2508,8 +2772,9 @@ export class SessionEngine {
2508
2772
  const url = runtime === "cloud" ? resolved.cloudUrl : resolved.localUrl;
2509
2773
  if (url === undefined) {
2510
2774
  // Filtered account connections bridge through the host so the
2511
- // `servers` filter is honored; unfiltered ones keep their documented
2512
- // fallback to the account's native connectors on the VM.
2775
+ // `servers` filter is honored; the rest keep their documented
2776
+ // fallback to the account's native connectors on the VM. An
2777
+ // individual one never gets here: the turn refuses it first.
2513
2778
  const bridged = bridgeTransport(resolved.name);
2514
2779
  if (bridged !== undefined) {
2515
2780
  servers[resolved.name] = bridged;
@@ -2524,7 +2789,7 @@ export class SessionEngine {
2524
2789
  bound.searchParams.set("agentkitSessionId", sessionId);
2525
2790
  servers[resolved.name] = {
2526
2791
  url: bound.toString(),
2527
- headers: resolved.headers,
2792
+ headers: resolved.sessionHeaders?.(sessionId) ?? resolved.headers,
2528
2793
  };
2529
2794
  continue;
2530
2795
  }
@@ -2542,11 +2807,9 @@ export class SessionEngine {
2542
2807
  }
2543
2808
  const connection = this.currentCloudServerToolsConnection();
2544
2809
  if (connection !== undefined && "url" in connection) {
2545
- const url = new URL(connection.url);
2546
- url.searchParams.set("agentkitSessionId", sessionId);
2547
2810
  servers[SERVER_TOOLS_MCP_SERVER_NAME] = {
2548
2811
  ...connection,
2549
- url: url.toString(),
2812
+ url: this.sessionToolsUrl(connection.url, sessionId).toString(),
2550
2813
  };
2551
2814
  }
2552
2815
  }
@@ -2561,6 +2824,9 @@ export class SessionEngine {
2561
2824
  hasAttachedAuthedConnections() {
2562
2825
  return this.project.agent.connections.some((connection) => connection.auth !== undefined && connection.advertiseTools !== true);
2563
2826
  }
2827
+ hasIndividualAccountConnections() {
2828
+ return this.project.agent.connections.some((connection) => connection.credentials === "individual" && isCursorAccountTransport(connection.transport));
2829
+ }
2564
2830
  /**
2565
2831
  * Evaluate per-session connection auth (`defineConnection({ auth })`)
2566
2832
  * for connections that attach to the model this turn. Advertised
@@ -2761,6 +3027,7 @@ export class SessionEngine {
2761
3027
  }),
2762
3028
  getSession: (channelId, sessionId) => this.getChannelSession(channelId, sessionId),
2763
3029
  emit: args.emit,
3030
+ steer: (message, steerOptions) => this.steerRunningTurn(args.record.sessionId, args.turnId, message, steerOptions),
2764
3031
  // Built before runInCall binds the turn. Methods read the active
2765
3032
  // context when the tool calls them.
2766
3033
  telemetry,
@@ -2809,8 +3076,9 @@ export class SessionEngine {
2809
3076
  }
2810
3077
  const needsGate = await evaluateNeedsApproval(args.tool.definition.needsApproval, validation.value);
2811
3078
  if (needsGate) {
2812
- const { decision, approver } = await this.parkForApproval({
3079
+ const { decision, reason, approver } = await this.parkForApproval({
2813
3080
  sessionId: args.record.sessionId,
3081
+ channelId: args.record.channelId,
2814
3082
  turnId: args.turnId,
2815
3083
  callId: toolCallId,
2816
3084
  toolName: args.tool.name,
@@ -2818,7 +3086,7 @@ export class SessionEngine {
2818
3086
  emit: args.emit,
2819
3087
  });
2820
3088
  if (decision === "deny") {
2821
- return toolErrorResult(`Tool "${args.tool.name}" was denied by a human approver.`);
3089
+ return toolErrorResult(toolDenialText(args.tool.name, reason));
2822
3090
  }
2823
3091
  toolCtx.approvedBy = approver;
2824
3092
  }
@@ -2953,7 +3221,13 @@ export class SessionEngine {
2953
3221
  },
2954
3222
  });
2955
3223
  this.logger(`[session] tool ${args.toolName} awaiting approval (${args.callId})`);
2956
- const { decision, by, approver } = await resolutionPromise;
3224
+ const timeoutMs = this.channelsById.get(args.channelId)?.meta?.toolApprovalTimeoutMs;
3225
+ const stopDeadline = timeoutMs === undefined
3226
+ ? () => { }
3227
+ : armParkDeadline(this.turnAborts.get(args.sessionId)?.signal, timeoutMs, (reason) => {
3228
+ this.approvals.expire(args.sessionId, args.callId, reason);
3229
+ });
3230
+ const { decision, by, approver, reason } = await resolutionPromise.finally(stopDeadline);
2957
3231
  await this.updateRecord(args.sessionId, (current) => ({
2958
3232
  ...current,
2959
3233
  pendingApprovals: (current.pendingApprovals ?? []).filter((item) => item.callId !== args.callId),
@@ -2964,11 +3238,12 @@ export class SessionEngine {
2964
3238
  callId: args.callId,
2965
3239
  toolName: args.toolName,
2966
3240
  decision,
2967
- ...(by === undefined ? {} : { by }),
3241
+ by,
3242
+ reason,
2968
3243
  },
2969
3244
  });
2970
3245
  this.logger(`[session] tool ${args.toolName} approval ${decision} (${args.callId})`);
2971
- return { decision, by, approver };
3246
+ return { decision, by, approver, reason };
2972
3247
  }
2973
3248
  async clearPendingApprovals(sessionId) {
2974
3249
  const current = await this.sessions.get(sessionId);
@@ -3096,6 +3371,10 @@ export class SessionEngine {
3096
3371
  if (!canPark() && !canRefresh) {
3097
3372
  return giveUp();
3098
3373
  }
3374
+ if (authored?.credentials === "individual" &&
3375
+ this.turnContextFor(ctx.sessionId)?.user === undefined) {
3376
+ throw new McpReconnectError(authored.name, individualNoUserMessage(authored.name), error);
3377
+ }
3099
3378
  const minted = await this.mintAuthUrl(connection, ctx.sessionId);
3100
3379
  if (minted === undefined) {
3101
3380
  return giveUp();
@@ -3105,6 +3384,9 @@ export class SessionEngine {
3105
3384
  await this.mcpHost.dropClient(connection);
3106
3385
  return await this.withMcpAuth(connection, run);
3107
3386
  }
3387
+ if (authored?.credentials === "individual") {
3388
+ return this.sendPrivateSignIn(ctx, authored, minted.authUrl, error);
3389
+ }
3108
3390
  if (minted.state !== "") {
3109
3391
  const bind = this.oauthHub.bind(minted.state, ctx.sessionId, ctx.callId);
3110
3392
  if (bind === "already_done") {
@@ -3138,6 +3420,41 @@ export class SessionEngine {
3138
3420
  await this.mcpHost.dropClient(connection);
3139
3421
  return await this.withMcpAuth(connection, run);
3140
3422
  }
3423
+ /**
3424
+ * An individual connection signs in only the person who started the turn,
3425
+ * so the link goes to them alone and the turn does not wait for them.
3426
+ */
3427
+ sendPrivateSignIn(ctx, connection, authUrl, cause) {
3428
+ const source = this.turnContextFor(ctx.sessionId)?.source;
3429
+ const slackUserId = source?.kind === "slack" ? source.userId : undefined;
3430
+ ctx.emit({
3431
+ type: "action.auth_requested",
3432
+ data: {
3433
+ callId: ctx.callId,
3434
+ toolName: ctx.toolName,
3435
+ connection: connection.name,
3436
+ authUrl,
3437
+ privateTo: { slackUserId },
3438
+ },
3439
+ });
3440
+ throw new McpReconnectError(connection.name, privateSignInMessage({
3441
+ connection: connection.name,
3442
+ authUrl,
3443
+ sentToSlack: slackUserId !== undefined,
3444
+ }), cause);
3445
+ }
3446
+ /** The Slack member to tell how to link an account, when this turn has none and needs one. */
3447
+ unlinkedSlackSenderNeedingLink(options) {
3448
+ const turn = options.turnContext;
3449
+ if (options.turnMode !== "interactive" ||
3450
+ turn === undefined ||
3451
+ turn.user !== undefined ||
3452
+ turn.source.kind !== "slack" ||
3453
+ !this.project.agent.connections.some((item) => item.credentials === "individual")) {
3454
+ return undefined;
3455
+ }
3456
+ return turn.source.userId;
3457
+ }
3141
3458
  async persistHostedMcpOauth(connection) {
3142
3459
  const authored = this.authoredConnection(connection);
3143
3460
  if (authored === undefined || !isHostOauthConnectionTransport(authored.transport)) {
@@ -3155,7 +3472,7 @@ export class SessionEngine {
3155
3472
  if (probe === undefined) {
3156
3473
  return undefined;
3157
3474
  }
3158
- const authUrl = await probe(connection);
3475
+ const authUrl = await probe(connection, sessionId);
3159
3476
  if (authUrl === undefined || authUrl === "") {
3160
3477
  return undefined;
3161
3478
  }
@@ -3201,34 +3518,11 @@ export class SessionEngine {
3201
3518
  },
3202
3519
  });
3203
3520
  this.logger(`[session] tool ${args.toolName} awaiting MCP auth ${args.connection} (${args.callId})`);
3204
- const endWait = (by) => {
3521
+ const stopDeadline = armParkDeadline(this.turnAborts.get(args.sessionId)?.signal, MCP_AUTH_PARK_TIMEOUT_MS, (reason) => {
3205
3522
  void this.oauthHub.abortCall(args.sessionId, args.callId);
3206
- return this.auths.resolve(args.sessionId, args.callId, "deny", by);
3207
- };
3208
- const signal = this.turnAborts.get(args.sessionId)?.signal;
3209
- const endForAbort = () => {
3210
- endWait("interrupt");
3211
- };
3212
- if (signal?.aborted) {
3213
- endForAbort();
3214
- }
3215
- else {
3216
- signal?.addEventListener("abort", endForAbort, { once: true });
3217
- }
3218
- let timedOut = false;
3219
- const timer = setTimeout(() => {
3220
- timedOut = endWait("timeout");
3221
- }, MCP_AUTH_PARK_TIMEOUT_MS);
3222
- timer.unref();
3223
- let decision;
3224
- let by;
3225
- try {
3226
- ({ decision, by } = await resolutionPromise);
3227
- }
3228
- finally {
3229
- clearTimeout(timer);
3230
- signal?.removeEventListener("abort", endForAbort);
3231
- }
3523
+ this.auths.expire(args.sessionId, args.callId, reason);
3524
+ });
3525
+ const { decision, by, reason } = await resolutionPromise.finally(stopDeadline);
3232
3526
  await this.updateRecord(args.sessionId, (current) => ({
3233
3527
  ...current,
3234
3528
  pendingAuths: (current.pendingAuths ?? []).filter((item) => item.callId !== args.callId),
@@ -3241,24 +3535,158 @@ export class SessionEngine {
3241
3535
  connection: args.connection,
3242
3536
  decision,
3243
3537
  by,
3538
+ reason,
3244
3539
  },
3245
3540
  });
3246
- const outcome = timedOut ? "timeout" : decision;
3541
+ const outcome = reason === "timeout" ? "timeout" : decision;
3247
3542
  this.logger(`[session] tool ${args.toolName} MCP auth ${outcome} (${args.callId})`);
3248
3543
  return outcome;
3249
3544
  }
3545
+ /** Keeps connects that wait for the person's next turn rather than this one. */
3250
3546
  async clearPendingAuths(sessionId) {
3251
3547
  await this.oauthHub.abortSession(sessionId);
3252
3548
  const current = await this.sessions.get(sessionId);
3253
3549
  if (current === undefined ||
3254
3550
  current.pendingAuths === undefined ||
3255
- current.pendingAuths.length === 0) {
3551
+ current.pendingAuths.every((item) => item.awaitsNextTurn === true)) {
3256
3552
  return;
3257
3553
  }
3258
3554
  await this.updateRecord(sessionId, (record) => ({
3259
3555
  ...record,
3260
- pendingAuths: [],
3556
+ pendingAuths: (record.pendingAuths ?? []).filter((item) => item.awaitsNextTurn === true),
3557
+ }));
3558
+ }
3559
+ /**
3560
+ * The agent's `mcp_auth` for an individual connection, answered at once:
3561
+ * the person connects from the card and clicks Connected, which starts
3562
+ * their next turn on fresh MCP clients. A repeat request reuses the pending
3563
+ * link. Only an already-connected connection is approved, because the SDK
3564
+ * does not reload a server it approves.
3565
+ */
3566
+ async answerMcpAuth(sessionId, turnId, emit, request) {
3567
+ const connection = this.authoredConnection(request.serverName);
3568
+ if (connection?.credentials !== "individual" ||
3569
+ !isCursorAccountTransport(connection.transport)) {
3570
+ return undefined;
3571
+ }
3572
+ const turn = this.turnContextFor(sessionId);
3573
+ if (turn?.user === undefined) {
3574
+ return { kind: "rejected", reason: individualNoUserMessage(connection.name) };
3575
+ }
3576
+ const sentToSlack = turn.source.kind === "slack";
3577
+ const userId = turn.user.id;
3578
+ const pending = (await this.sessions.get(sessionId))?.pendingAuths?.find((item) => item.awaitsNextTurn === true &&
3579
+ item.userId === userId &&
3580
+ item.connection === connection.name);
3581
+ if (pending !== undefined) {
3582
+ // A later turn shows the same card again, in case Connected came early.
3583
+ if (pending.turnId !== turnId) {
3584
+ emit({
3585
+ type: "action.auth_requested",
3586
+ data: {
3587
+ callId: pending.callId,
3588
+ toolName: pending.toolName,
3589
+ connection: pending.connection,
3590
+ authUrl: pending.authUrl,
3591
+ privateTo: {
3592
+ slackUserId: turn.source.kind === "slack" ? turn.source.userId : undefined,
3593
+ },
3594
+ },
3595
+ });
3596
+ await this.updateRecord(sessionId, (current) => ({
3597
+ ...current,
3598
+ pendingAuths: (current.pendingAuths ?? []).map((item) => item.callId === pending.callId ? { ...item, turnId } : item),
3599
+ }));
3600
+ }
3601
+ return {
3602
+ kind: "rejected",
3603
+ reason: connectThenContinueMessage(connection.name, pending.authUrl, sentToSlack),
3604
+ };
3605
+ }
3606
+ if ((await this.individualConnectedCheck?.(connection.name, sessionId)) === true) {
3607
+ return { kind: "approved" };
3608
+ }
3609
+ const minted = await this.mintAuthUrl(connection.name, sessionId);
3610
+ if (minted === undefined || !("authUrl" in minted)) {
3611
+ return {
3612
+ kind: "rejected",
3613
+ reason: `${connection.name} could not start a sign-in. Answer without ${connection.name}.`,
3614
+ };
3615
+ }
3616
+ const entry = {
3617
+ callId: request.toolCallId,
3618
+ turnId,
3619
+ toolName: MCP_AUTH_TOOL_NAME,
3620
+ connection: connection.name,
3621
+ authUrl: minted.authUrl,
3622
+ requestedAt: new Date().toISOString(),
3623
+ awaitsNextTurn: true,
3624
+ userId,
3625
+ };
3626
+ await this.updateRecord(sessionId, (current) => ({
3627
+ ...current,
3628
+ pendingAuths: [
3629
+ ...(current.pendingAuths ?? []).filter((item) => item.callId !== entry.callId),
3630
+ entry,
3631
+ ],
3261
3632
  }));
3633
+ emit({
3634
+ type: "action.auth_requested",
3635
+ data: {
3636
+ callId: entry.callId,
3637
+ toolName: entry.toolName,
3638
+ connection: entry.connection,
3639
+ authUrl: entry.authUrl,
3640
+ privateTo: { slackUserId: turn.source.kind === "slack" ? turn.source.userId : undefined },
3641
+ },
3642
+ });
3643
+ return {
3644
+ kind: "rejected",
3645
+ reason: connectThenContinueMessage(connection.name, entry.authUrl, sentToSlack),
3646
+ };
3647
+ }
3648
+ /**
3649
+ * Settles pending connects at turn start, each once: Cancel drops one, and
3650
+ * a connect the person finished resolves. A Connected or Cancel click with
3651
+ * nothing pending for its connection does not run the request again.
3652
+ */
3653
+ async settleConnects(sessionId, message, emit) {
3654
+ const userId = this.turnContextFor(sessionId)?.user?.id;
3655
+ if (userId === undefined) {
3656
+ return undefined;
3657
+ }
3658
+ // A Slack thread can hold several people; each settles only their own connects.
3659
+ const pending = ((await this.sessions.get(sessionId))?.pendingAuths ?? []).filter((item) => item.awaitsNextTurn === true && item.userId === userId);
3660
+ const individual = this.project.agent.connections
3661
+ .filter((connection) => connection.credentials === "individual" && isCursorAccountTransport(connection.transport))
3662
+ .map((connection) => connection.name);
3663
+ const click = parseConnectClickText(message, individual);
3664
+ if (click !== undefined && !pending.some((item) => item.connection === click.connection)) {
3665
+ return { skip: `Nothing is waiting on ${click.connection}.` };
3666
+ }
3667
+ const resolve = async (item, decision) => {
3668
+ await this.removePendingAuth(sessionId, item.callId);
3669
+ emit({
3670
+ type: "action.auth_resolved",
3671
+ data: {
3672
+ callId: item.callId,
3673
+ toolName: item.toolName,
3674
+ connection: item.connection,
3675
+ decision,
3676
+ },
3677
+ });
3678
+ };
3679
+ for (const item of pending) {
3680
+ if (click?.decision === "deny" && click.connection === item.connection) {
3681
+ await resolve(item, "deny");
3682
+ continue;
3683
+ }
3684
+ const connected = await this.individualConnectedCheck?.(item.connection, sessionId).catch(() => false);
3685
+ if (connected === true) {
3686
+ await resolve(item, "approve");
3687
+ }
3688
+ }
3689
+ return undefined;
3262
3690
  }
3263
3691
  async listPendingAuths(sessionId) {
3264
3692
  const record = await this.sessions.get(sessionId);
@@ -3286,6 +3714,24 @@ export class SessionEngine {
3286
3714
  throw new AuthNotFoundError(sessionId, callId);
3287
3715
  }
3288
3716
  const resolvedBy = approvalResolverLabel(auth);
3717
+ if (pending.awaitsNextTurn === true) {
3718
+ // No turn waits on it. Connected leaves it for the next turn to confirm.
3719
+ if (decision === "deny") {
3720
+ await this.removePendingAuth(sessionId, callId);
3721
+ await this.appendEvent(sessionId, {
3722
+ type: "action.auth_resolved",
3723
+ turnId: pending.turnId,
3724
+ data: {
3725
+ callId,
3726
+ toolName: pending.toolName,
3727
+ connection: pending.connection,
3728
+ decision,
3729
+ by: resolvedBy,
3730
+ },
3731
+ });
3732
+ }
3733
+ return pending;
3734
+ }
3289
3735
  if (decision === "deny") {
3290
3736
  await this.oauthHub.abortCall(sessionId, callId);
3291
3737
  }
@@ -3877,14 +4323,11 @@ export class SessionEngine {
3877
4323
  }
3878
4324
  async dispatchEventHandlers(sessionId, event, context, record) {
3879
4325
  const channelState = context === undefined ? (record.channelState ?? null) : context.channelState;
3880
- const sessionCtx = {
4326
+ const sessionCtx = this.sessionContext({
4327
+ sessionId: record.sessionId,
3881
4328
  session: context?.session ?? this.sessionInfo(record),
3882
- host: this.hostForSession(record.sessionId),
3883
- artifacts: this.artifactsApi({
3884
- sessionId: record.sessionId,
3885
- turnId: event.turnId,
3886
- }),
3887
- };
4329
+ turnId: event.turnId,
4330
+ });
3888
4331
  const channelEvents = this.channelEventHandlersFor(record.channelId);
3889
4332
  if (channelEvents !== undefined) {
3890
4333
  const handlers = [
@@ -4408,6 +4851,14 @@ export class SessionEngine {
4408
4851
  takeContinuationRelease(continuationKey) {
4409
4852
  return this.releasedContinuations.delete(continuationKey);
4410
4853
  }
4854
+ /** The running turn's context. A follow-up that joins the turn reads this one. */
4855
+ turnContextFor(sessionId) {
4856
+ return this.turnContexts.get(sessionId)?.context;
4857
+ }
4858
+ /** The mailbox key the running turn's user was signed under; see {@link EngineSendOptions.turnSessionKey}. */
4859
+ turnSessionKeyFor(sessionId) {
4860
+ return this.turnContexts.get(sessionId)?.sessionKey;
4861
+ }
4411
4862
  isTurnRunning(sessionId) {
4412
4863
  // Include the admit window (pendingTurns) and coalesce drain so busy
4413
4864
  // policies do not treat a turn that has finished executeTurn but not yet
@@ -4725,6 +5176,25 @@ export class SessionEngine {
4725
5176
  }
4726
5177
  }
4727
5178
  const DEPLOYED_AGENTS_DASHBOARD_URL = "https://cursor.com/dashboard/deployed-agents";
5179
+ /** What the model reads after an individual connection's sign-in link went to the asker alone. */
5180
+ export function privateSignInMessage(args) {
5181
+ const { connection } = args;
5182
+ const link = args.sentToSlack
5183
+ ? " They were sent a private link to connect it. Do not post a link."
5184
+ : ` Give them this link to connect it: ${args.authUrl}`;
5185
+ return `${connection} uses each person's own account, and the person who asked has not connected theirs.${link} Do not wait for them: answer without ${connection}, and tell them to ask again after they connect.`;
5186
+ }
5187
+ const MCP_AUTH_TOOL_NAME = "mcp_auth";
5188
+ /** Told to the model when an individual connection's sign-in card is shown. */
5189
+ export function connectThenContinueMessage(connection, authUrl, sentToSlack) {
5190
+ const where = sentToSlack
5191
+ ? "They were sent a private Connect card. Do not post a link."
5192
+ : `They see a Connect card. If they cannot, give them this link: ${authUrl}`;
5193
+ return `${connection} uses each person's own account, and the person who asked has not connected theirs. ${where} Tell them to connect, then click Connected, and stop: their request continues on their next turn. Do not call ${MCP_AUTH_TOOL_NAME} again for ${connection} in this turn.`;
5194
+ }
5195
+ function individualNoUserMessage(connection) {
5196
+ return `${connection} uses each person's own account, and the person who asked has no linked Cursor account. Do not post a link: answer without ${connection}.`;
5197
+ }
4728
5198
  function mcpAuthReconnectMessage(connection) {
4729
5199
  if (isCursorAccountTransport(connection.transport)) {
4730
5200
  return `Reconnect ${connection.name}: the MCP connection needs authorization. Ask the bot owner to reconnect ${connection.name} at ${DEPLOYED_AGENTS_DASHBOARD_URL}`;
@@ -4804,6 +5274,21 @@ export function withTurnCountClampedToEvents(record, events) {
4804
5274
  }
4805
5275
  return maxTurn > record.turnCount ? { ...record, turnCount: maxTurn } : record;
4806
5276
  }
5277
+ /**
5278
+ * The cloud run this hosted delivery already started on the session's bound
5279
+ * agent, when an earlier host recorded one. Another delivery never matches,
5280
+ * so its message is still sent.
5281
+ */
5282
+ function reattachableCloudRunId(record, platformDeliveryId) {
5283
+ const recorded = record.hostedCloudRun;
5284
+ if (platformDeliveryId === undefined ||
5285
+ recorded === undefined ||
5286
+ recorded.platformDeliveryId !== platformDeliveryId ||
5287
+ recorded.sdkAgentId !== record.sdkAgentId) {
5288
+ return undefined;
5289
+ }
5290
+ return recorded.runId;
5291
+ }
4807
5292
  function subagentPrompt(subagent) {
4808
5293
  if (subagent.instructions !== undefined && subagent.instructions !== "") {
4809
5294
  return subagent.instructions;
@@ -4888,6 +5373,9 @@ function approvalResolverLabel(auth) {
4888
5373
  if (auth === null) {
4889
5374
  return undefined;
4890
5375
  }
5376
+ if (auth.label !== undefined && auth.label !== "") {
5377
+ return auth.label;
5378
+ }
4891
5379
  const slackUser = auth.attributes?.user_id;
4892
5380
  if (auth.authenticator === "slack" && slackUser !== undefined && slackUser !== "") {
4893
5381
  return slackUser;