@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
@@ -5,8 +5,9 @@
5
5
  * settings; cloud agents use Cursor cloud (`bc-…` ids) with optional
6
6
  * `cloud` options from `defineAgent`.
7
7
  */
8
+ import { createHash } from "node:crypto";
8
9
  import { mkdir } from "node:fs/promises";
9
- import { Agent, Cursor, createAgentPlatform, } from "@cursor/sdk";
10
+ import { Agent, ConfigurationError, Cursor, createAgentPlatform, NetworkError, } from "@cursor/sdk";
10
11
  import { SqliteLocalAgentStore } from "@cursor/sdk/sqlite";
11
12
  import { DEFAULT_MODEL, } from "../types.js";
12
13
  import { mapSdkTokenUsage, usageTokenSum } from "./cloud-turn-usage.js";
@@ -169,6 +170,20 @@ function mcpServersField(servers) {
169
170
  }
170
171
  return { mcpServers: servers };
171
172
  }
173
+ /**
174
+ * `onMcpAuthRequest` is newer than the pinned SDK's `LocalSendOptions`, so it
175
+ * is added after the type check. An SDK without it ignores the key.
176
+ */
177
+ function withMcpAuthRequest(local, onMcpAuthRequest) {
178
+ if (onMcpAuthRequest === undefined) {
179
+ return local;
180
+ }
181
+ const withHook = {
182
+ ...local,
183
+ onMcpAuthRequest,
184
+ };
185
+ return withHook;
186
+ }
172
187
  function errorCodeOf(error) {
173
188
  if (!isRecord(error) || typeof error.code !== "string") {
174
189
  return undefined;
@@ -279,6 +294,7 @@ export class CursorSdkRunner {
279
294
  async runTurnWithTransportRetry(request, onStreamed) {
280
295
  let sawUpdate = false;
281
296
  let mintedSdkAgentId;
297
+ let startedCloudRunId;
282
298
  const tracked = {
283
299
  ...request,
284
300
  onUpdate: (update) => {
@@ -292,8 +308,26 @@ export class CursorSdkRunner {
292
308
  mintedSdkAgentId = sdkAgentId;
293
309
  await request.onSdkAgentId?.(sdkAgentId);
294
310
  },
311
+ onCloudRunStarted: async (run) => {
312
+ startedCloudRunId = run.runId;
313
+ await request.onCloudRunStarted?.(run);
314
+ },
295
315
  };
296
- const outcome = await this.runTurnAttempt(tracked);
316
+ // A retry continues from the adopted agent and its run, not from the
317
+ // create that found them.
318
+ let attempted = tracked;
319
+ let outcome;
320
+ try {
321
+ outcome = await this.runTurnAttempt(tracked);
322
+ }
323
+ catch (error) {
324
+ const adopted = await this.adoptDeliveryCloudAgent(tracked, error);
325
+ if (adopted === undefined) {
326
+ throw error;
327
+ }
328
+ attempted = adopted;
329
+ outcome = await this.runTurnAttempt(adopted);
330
+ }
297
331
  if (outcome.status !== "error" || sawUpdate || request.signal?.aborted === true) {
298
332
  return outcome;
299
333
  }
@@ -306,9 +340,14 @@ export class CursorSdkRunner {
306
340
  this.log(`[bdk] session ${request.sessionId}: ${reason}: ${outcome.errorMessage}; retrying the turn`);
307
341
  // The failed attempt already minted this cloud agent; resuming it is what
308
342
  // keeps one trigger from leaving two `bc-…` agents behind.
309
- const retried = mintedSdkAgentId !== undefined && isServerMintedCloudAgentId(mintedSdkAgentId)
310
- ? { ...tracked, sdkAgentId: mintedSdkAgentId }
311
- : tracked;
343
+ const resumed = mintedSdkAgentId !== undefined && isServerMintedCloudAgentId(mintedSdkAgentId)
344
+ ? { ...attempted, sdkAgentId: mintedSdkAgentId }
345
+ : attempted;
346
+ // A reattached turn that sent again has a newer run of its own; waiting on
347
+ // the older one again would see it ended and send a third time.
348
+ const retried = attempted.reattachCloudRunId === undefined || startedCloudRunId === undefined
349
+ ? resumed
350
+ : { ...resumed, reattachCloudRunId: startedCloudRunId };
312
351
  try {
313
352
  return await this.runTurnAttempt(retried);
314
353
  }
@@ -349,34 +388,45 @@ export class CursorSdkRunner {
349
388
  : request.prompt;
350
389
  // oxlint-disable-next-line typescript/no-unsafe-type-assertion -- ConnectionTransport is the engine's view of the SDK mcpServers map
351
390
  const sendMcpServers = request.mcpServers;
352
- const run = await agent.send(sendMessage, {
353
- onDelta: async ({ update }) => {
354
- try {
355
- await request.onUpdate(update);
356
- }
357
- catch {
358
- // Stream mapping must never reject into the SDK transport.
359
- }
360
- },
361
- // The SDK builds this send's MCP session from exactly this set, so
362
- // a turn always runs on the headers the engine evaluated for it —
363
- // never on the ones a previous turn opened the cached handle with.
364
- ...mcpServersField(request.runtime === "local" && request.perSendMcpServers === true
365
- ? sendMcpServers
366
- : undefined),
367
- local: request.runtime === "local"
368
- ? {
369
- customTools: request.customTools,
370
- // The session's tree for this turn; a cached agent handle
371
- // still carries the tree it was opened with.
372
- fs: request.fs,
373
- // Follow-up turns expire any run still marked active on the
374
- // agent (a preempted or crash-wedged run) so this send is not
375
- // rejected with "already has active run".
376
- ...(request.forceExpireActiveRun === true ? { force: true } : {}),
377
- }
378
- : undefined,
379
- });
391
+ const reattachRunId = request.runtime === "cloud" ? request.reattachCloudRunId : undefined;
392
+ if (reattachRunId !== undefined) {
393
+ this.log(`[bdk] session ${request.sessionId}: waiting on cloud run ${reattachRunId} of ${agent.agentId}, which this delivery already started`);
394
+ }
395
+ const run = reattachRunId !== undefined
396
+ ? await Agent.getRun(reattachRunId, {
397
+ runtime: "cloud",
398
+ agentId: agent.agentId,
399
+ apiKey: this.requireApiKey(),
400
+ })
401
+ : await agent.send(sendMessage, {
402
+ onDelta: async ({ update }) => {
403
+ try {
404
+ await request.onUpdate(update);
405
+ }
406
+ catch {
407
+ // Stream mapping must never reject into the SDK transport.
408
+ }
409
+ },
410
+ // The SDK builds this send's MCP session from exactly this set, so
411
+ // a turn always runs on the headers the engine evaluated for it —
412
+ // never on the ones a previous turn opened the cached handle with.
413
+ ...mcpServersField(request.runtime === "local" && request.perSendMcpServers === true
414
+ ? sendMcpServers
415
+ : undefined),
416
+ local: request.runtime === "local"
417
+ ? withMcpAuthRequest({
418
+ customTools: request.customTools,
419
+ // The session's tree for this turn; a cached agent handle
420
+ // still carries the tree it was opened with.
421
+ fs: request.fs,
422
+ // Follow-up turns expire any run still marked active on the
423
+ // agent (a preempted or crash-wedged run) so this send is not
424
+ // rejected with "already has active run".
425
+ ...(request.forceExpireActiveRun === true ? { force: true } : {}),
426
+ }, request.onMcpAuthRequest)
427
+ : undefined,
428
+ });
429
+ const replay = reattachRunId === undefined ? undefined : collectCloudRunUpdates(run);
380
430
  // A follow-up can preempt this turn: cancelling tears down execution and
381
431
  // marks the SDK run terminal so the next send is admitted cleanly. The
382
432
  // signal may already be aborted if the preempt landed while send() was
@@ -399,6 +449,12 @@ export class CursorSdkRunner {
399
449
  if (request.onSdkAgentId !== undefined) {
400
450
  await request.onSdkAgentId(agent.agentId);
401
451
  }
452
+ if (request.runtime === "cloud" &&
453
+ reattachRunId === undefined &&
454
+ run.id !== "" &&
455
+ request.onCloudRunStarted !== undefined) {
456
+ await request.onCloudRunStarted({ sdkAgentId: agent.agentId, runId: run.id });
457
+ }
402
458
  // Readable on the handle as soon as send resolves, long before wait().
403
459
  if (request.onRequestId !== undefined &&
404
460
  run.requestId !== undefined &&
@@ -407,8 +463,36 @@ export class CursorSdkRunner {
407
463
  }
408
464
  this.activeRuns.set(request.sessionId, run);
409
465
  try {
410
- const result = await run.wait();
466
+ let result = await run.wait();
467
+ const replayed = (await replay) ?? [];
411
468
  let outcome = toTurnOutcome(result);
469
+ const aborted = () => signal?.aborted === true;
470
+ if (reattachRunId !== undefined && outcome.status !== "finished" && !aborted()) {
471
+ // A `wait()` error can come from the client (an expired stream, an
472
+ // auth failure) while the run goes on, so only the backend's status
473
+ // decides between the run's result and a second send.
474
+ const settled = await this.fetchCloudRun(agent.agentId, reattachRunId);
475
+ const next = decideNext(settled?.status);
476
+ if (next === "done" && settled !== undefined && settled.status !== "running") {
477
+ result = {
478
+ id: settled.id,
479
+ status: settled.status,
480
+ result: settled.result,
481
+ usage: settled.usage,
482
+ };
483
+ outcome = toTurnOutcome(result);
484
+ }
485
+ else if (next === "resend" && !aborted()) {
486
+ this.log(`[bdk] session ${request.sessionId}: cloud run ${reattachRunId} ended in error; sending the turn again`);
487
+ return await this.runTurnOnAgent({ ...request, reattachCloudRunId: undefined }, agentPromise);
488
+ }
489
+ }
490
+ // Only a finished result keeps the replayed events. On a failed wait
491
+ // they would mark the turn as streamed, which stops the transport
492
+ // retry from waiting on the same run, and a later retry replays them.
493
+ if (outcome.status === "finished") {
494
+ await deliverUpdates(replayed, request.onUpdate);
495
+ }
412
496
  if (outcome.status === "error") {
413
497
  // An error result usually means the handle's transport is poisoned
414
498
  // — most often a cached access token that aged past its 60-minute
@@ -456,17 +540,72 @@ export class CursorSdkRunner {
456
540
  throw error;
457
541
  }
458
542
  }
543
+ /**
544
+ * The turn that continues on the cloud agent an earlier attempt at this
545
+ * delivery created, when creating it again was refused because its id is
546
+ * taken. Undefined for any other failure, or when the agent has no run.
547
+ */
548
+ async adoptDeliveryCloudAgent(request, error) {
549
+ const agentId = deliveryCloudAgentId(request);
550
+ if (agentId === undefined || !isAgentIdConflictError(error)) {
551
+ return undefined;
552
+ }
553
+ let runs;
554
+ try {
555
+ runs = await Agent.listRuns(agentId, {
556
+ runtime: "cloud",
557
+ apiKey: this.requireApiKey(),
558
+ limit: 1,
559
+ });
560
+ }
561
+ catch (lookupError) {
562
+ this.log(`[bdk] session ${request.sessionId}: cloud agent ${agentId} already exists for this delivery (${describeError(error)}); reading its runs failed`);
563
+ throw lookupError;
564
+ }
565
+ const latest = runs.items[0];
566
+ if (latest === undefined) {
567
+ return undefined;
568
+ }
569
+ this.log(`[bdk] session ${request.sessionId}: cloud agent ${agentId} already exists for this delivery; its run ${latest.id} is ${latest.status}`);
570
+ if (decideNext(latest.status) === "resend") {
571
+ return { ...request, sdkAgentId: agentId, reattachCloudRunId: undefined };
572
+ }
573
+ // Recorded like a run this attempt started, so a later attempt waits on
574
+ // it instead of sending. A finished or cancelled run is reattached too:
575
+ // waiting on it returns how it ended and replays its events.
576
+ await request.onCloudRunStarted?.({ sdkAgentId: agentId, runId: latest.id });
577
+ return { ...request, sdkAgentId: agentId, reattachCloudRunId: latest.id };
578
+ }
579
+ /** The cloud run as the backend reports it now, or undefined when the lookup fails. */
580
+ async fetchCloudRun(agentId, runId) {
581
+ try {
582
+ return await Agent.getRun(runId, {
583
+ runtime: "cloud",
584
+ agentId,
585
+ apiKey: this.requireApiKey(),
586
+ });
587
+ }
588
+ catch {
589
+ return undefined;
590
+ }
591
+ }
459
592
  async steer(request) {
460
593
  const run = this.activeRuns.get(request.sessionId);
461
594
  if (run?.steer === undefined) {
462
595
  return "revert_to_followup";
463
596
  }
464
597
  try {
465
- return await run.steer(request.text);
598
+ const outcome = await run.steer(request.text);
599
+ return typeof outcome === "string" ? outcome : "complete_delivered";
466
600
  }
467
601
  catch (error) {
468
602
  this.log(`[bdk] session ${request.sessionId}: steer failed: ${describeError(error)}`);
469
- return "revert_to_followup";
603
+ // The SDK marks a network error or 5xx on the steer request itself not retryable, since the
604
+ // server may have taken the message; resending could deliver it twice. Every other failure,
605
+ // including one before the request was sent, means the turn never got it.
606
+ return error instanceof NetworkError && !error.isRetryable
607
+ ? "complete_delivered"
608
+ : "revert_to_followup";
470
609
  }
471
610
  }
472
611
  /**
@@ -775,6 +914,7 @@ export class CursorSdkRunner {
775
914
  ...shared,
776
915
  cloud,
777
916
  };
917
+ const deliveryAgentId = deliveryCloudAgentId(request);
778
918
  const sdkAgentId = request.sdkAgentId?.trim();
779
919
  if (sdkAgentId !== undefined && sdkAgentId !== "") {
780
920
  // A server-minted `bc-…` id always resumes — including on the first
@@ -792,7 +932,7 @@ export class CursorSdkRunner {
792
932
  }
793
933
  }
794
934
  if (request.isFirstTurn) {
795
- return Agent.create(options);
935
+ return Agent.create({ ...options, agentId: deliveryAgentId });
796
936
  }
797
937
  // A cloud session past its first turn should carry the bound agent id
798
938
  // (the engine persists it via onSdkAgentId as soon as create() reports
@@ -802,7 +942,7 @@ export class CursorSdkRunner {
802
942
  // host-replacement path above: a fresh conversation beats failing this
803
943
  // thread forever, and the new id binds to the session for later resumes.
804
944
  this.log(`[bdk] cloud session ${request.sessionId} has no bound cloud agent; creating a fresh one`);
805
- return Agent.create(options);
945
+ return Agent.create({ ...options, agentId: deliveryAgentId });
806
946
  }
807
947
  resolveStore(request) {
808
948
  return this.options.store !== undefined
@@ -841,6 +981,60 @@ export class CursorSdkRunner {
841
981
  return storePromise;
842
982
  }
843
983
  }
984
+ /**
985
+ * What a retried delivery does with the cloud run an earlier attempt started,
986
+ * given the run's status on the backend: wait on it again, send the turn
987
+ * again, or take how it ended. Only a run that failed is sent again; a
988
+ * cancelled run stays cancelled. An unknown status, including a failed lookup,
989
+ * waits again rather than risk running the turn twice.
990
+ */
991
+ export function decideNext(status) {
992
+ if (status === "error") {
993
+ return "resend";
994
+ }
995
+ if (status === "finished" || status === "cancelled") {
996
+ return "done";
997
+ }
998
+ return "reattach";
999
+ }
1000
+ /**
1001
+ * The `bc-<uuid>` cloud agent id for one model attempt at a hosted delivery.
1002
+ * A retry of the attempt gets the same id; a fallback model gets its own
1003
+ * agent, since a run on an agent keeps that agent's model.
1004
+ */
1005
+ export function cloudAgentIdForDelivery(platformDeliveryId, model) {
1006
+ const hex = createHash("sha256")
1007
+ .update(JSON.stringify([
1008
+ "agent-serve-delivery",
1009
+ platformDeliveryId,
1010
+ toModelSelection(model ?? DEFAULT_MODEL),
1011
+ ]))
1012
+ .digest("hex");
1013
+ // RFC 9562 version 8 (custom) and variant bits.
1014
+ const variant = ((Number.parseInt(hex.charAt(16), 16) & 0x3) | 0x8).toString(16);
1015
+ return `bc-${hex.slice(0, 8)}-${hex.slice(8, 12)}-8${hex.slice(13, 16)}-${variant}${hex.slice(17, 20)}-${hex.slice(20, 32)}`;
1016
+ }
1017
+ /**
1018
+ * The id a cloud turn creates its agent under when it answers a hosted
1019
+ * delivery: every attempt on one model names the same agent, so a retry that
1020
+ * finds it taken continues on it. Undefined when the turn already names an
1021
+ * agent, or sets envVars, which the API only accepts with an id it mints.
1022
+ */
1023
+ function deliveryCloudAgentId(request) {
1024
+ const envVars = request.cloud?.envVars;
1025
+ if (request.runtime !== "cloud" ||
1026
+ request.platformDeliveryId === undefined ||
1027
+ (request.sdkAgentId?.trim() ?? "") !== "" ||
1028
+ (envVars !== undefined && Object.keys(envVars).length > 0)) {
1029
+ return undefined;
1030
+ }
1031
+ return cloudAgentIdForDelivery(request.platformDeliveryId, request.model);
1032
+ }
1033
+ function isAgentIdConflictError(error) {
1034
+ return (error instanceof ConfigurationError &&
1035
+ error.status === 409 &&
1036
+ error.code === "agent_id_conflict");
1037
+ }
844
1038
  /** Cloud agent ids minted by the server are `bc-…`; those always resume. */
845
1039
  export function isServerMintedCloudAgentId(id) {
846
1040
  return id.startsWith("bc-");
@@ -946,6 +1140,72 @@ function toAgentDefinitions(subagents) {
946
1140
  }
947
1141
  return definitions;
948
1142
  }
1143
+ /**
1144
+ * A reattached cloud run's messages as turn updates, the ones `send`'s
1145
+ * `onDelta` gives a run this host started. A fetched run takes no `onDelta`,
1146
+ * but its stream replays the run's persisted events and then follows it. The
1147
+ * updates are collected rather than delivered, because a run that ends
1148
+ * cancelled or failed is sent again and its events must not join that turn.
1149
+ */
1150
+ async function collectCloudRunUpdates(run) {
1151
+ const updates = [];
1152
+ try {
1153
+ for await (const message of run.stream()) {
1154
+ updates.push(...cloudRunMessageUpdates(message));
1155
+ }
1156
+ }
1157
+ catch {
1158
+ // The turn's outcome comes from `wait()`, which reports a failed stream.
1159
+ }
1160
+ return updates;
1161
+ }
1162
+ async function deliverUpdates(updates, onUpdate) {
1163
+ for (const update of updates) {
1164
+ try {
1165
+ await onUpdate(update);
1166
+ }
1167
+ catch {
1168
+ // Stream mapping must never reject into the SDK transport.
1169
+ }
1170
+ }
1171
+ }
1172
+ function cloudRunMessageUpdates(message) {
1173
+ switch (message.type) {
1174
+ case "assistant": {
1175
+ const text = message.message.content
1176
+ .filter((block) => block.type === "text")
1177
+ .map((block) => block.text)
1178
+ .join("");
1179
+ return text === "" ? [] : [{ type: "text-delta", text }];
1180
+ }
1181
+ case "thinking":
1182
+ if (message.thinking_duration_ms !== undefined && message.text === "") {
1183
+ return [{ type: "thinking-completed", thinkingDurationMs: message.thinking_duration_ms }];
1184
+ }
1185
+ return [{ type: "thinking-delta", text: message.text }];
1186
+ case "tool_call": {
1187
+ if (message.status === "running") {
1188
+ return [];
1189
+ }
1190
+ // oxlint-disable-next-line typescript/no-unsafe-type-assertion -- the stream names a tool by a free string, not a generated ToolCall kind
1191
+ const toolCall = {
1192
+ type: message.name,
1193
+ args: message.args,
1194
+ result: message.result,
1195
+ truncated: message.truncated,
1196
+ };
1197
+ // The engine pairs each result with its start, and the stream carries
1198
+ // only the finished call.
1199
+ const ids = { callId: message.call_id, modelCallId: message.call_id };
1200
+ return [
1201
+ { type: "tool-call-started", ...ids, toolCall },
1202
+ { type: "tool-call-completed", ...ids, toolCall },
1203
+ ];
1204
+ }
1205
+ default:
1206
+ return [];
1207
+ }
1208
+ }
949
1209
  function toTurnOutcome(result) {
950
1210
  const usage = result.usage === undefined
951
1211
  ? undefined
@@ -1 +1 @@
1
- {"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/internal/server.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,EAAsC,KAAK,cAAc,EAAE,MAAM,WAAW,CAAC;AA6CpF,OAAO,KAAK,EACV,YAAY,EACZ,gBAAgB,EAUhB,YAAY,EACb,MAAM,aAAa,CAAC;AAiGrB,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AA+CpE,OAAO,EAAE,KAAK,WAAW,EAAmB,MAAM,iBAAiB,CAAC;AAUpE,OAAO,EAEL,wBAAwB,EAEzB,MAAM,sBAAsB,CAAC;AAO9B,OAAO,EAAsB,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAW/E;;;GAGG;AACH,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,YAAY,CAAC;CACvB;AAuCD,6EAA6E;AAC7E,MAAM,WAAW,0BAA0B;IACzC,oEAAoE;IACpE,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,4EAA4E;IAC5E,eAAe,CAAC,EAAE,qBAAqB,CAAC;IACxC,yEAAyE;IACzE,aAAa,CAAC,EAAE,UAAU,CAAC,OAAO,wBAAwB,CAAC,CAAC;IAC5D,wEAAwE;IACxE,aAAa,CAAC,EAAE,UAAU,CAAC,OAAO,mBAAmB,CAAC,CAAC;IACvD;;;;OAIG;IACH,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,kEAAkE;IAClE,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,2FAA2F;IAC3F,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED;;;;GAIG;AACH,wBAAsB,WAAW,CAC/B,MAAM,EAAE,UAAU,EAAE,EACpB,OAAO,GAAE,YAAY,GAAG,0BAA+B,GACtD,OAAO,CAAC,gBAAgB,CAAC,CAgnC3B;AA6nDD,wBAAsB,kBAAkB,CACtC,QAAQ,EAAE,QAAQ,EAClB,GAAG,EAAE,cAAc,EACnB,MAAM,SAAQ,GACb,OAAO,CAAC,IAAI,CAAC,CAkDf"}
1
+ {"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/internal/server.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,EAAsC,KAAK,cAAc,EAAE,MAAM,WAAW,CAAC;AA6CpF,OAAO,KAAK,EACV,YAAY,EACZ,gBAAgB,EAUhB,YAAY,EACb,MAAM,aAAa,CAAC;AAoGrB,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AA+CpE,OAAO,EAAE,KAAK,WAAW,EAAmB,MAAM,iBAAiB,CAAC;AAUpE,OAAO,EAEL,wBAAwB,EAEzB,MAAM,sBAAsB,CAAC;AAO9B,OAAO,EAAsB,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAW/E;;;GAGG;AACH,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,YAAY,CAAC;CACvB;AAuCD,6EAA6E;AAC7E,MAAM,WAAW,0BAA0B;IACzC,oEAAoE;IACpE,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,4EAA4E;IAC5E,eAAe,CAAC,EAAE,qBAAqB,CAAC;IACxC,yEAAyE;IACzE,aAAa,CAAC,EAAE,UAAU,CAAC,OAAO,wBAAwB,CAAC,CAAC;IAC5D,wEAAwE;IACxE,aAAa,CAAC,EAAE,UAAU,CAAC,OAAO,mBAAmB,CAAC,CAAC;IACvD;;;;OAIG;IACH,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,kEAAkE;IAClE,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,2FAA2F;IAC3F,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED;;;;GAIG;AACH,wBAAsB,WAAW,CAC/B,MAAM,EAAE,UAAU,EAAE,EACpB,OAAO,GAAE,YAAY,GAAG,0BAA+B,GACtD,OAAO,CAAC,gBAAgB,CAAC,CA0oC3B;AA8oDD,wBAAsB,kBAAkB,CACtC,QAAQ,EAAE,QAAQ,EAClB,GAAG,EAAE,cAAc,EACnB,MAAM,SAAQ,GACb,OAAO,CAAC,IAAI,CAAC,CAkDf"}
@@ -27,7 +27,7 @@ import { ARTIFACTS_PAGE_DEFAULT_LIMIT, ARTIFACTS_PAGE_MAX_LIMIT, InvalidArtifact
27
27
  import { browserOriginGuardOptionsForPublicUrl, isTrustedBrowserMutation, } from "./browser-origin-guard.js";
28
28
  import { invokeChannelRoute } from "./channel-route-dispatch.js";
29
29
  import { selectConversationMirror } from "./conversation-mirror.js";
30
- import { CursorAccountMcpBridge, collectCursorAccountConnections, cursorAccountMcpPath, } from "./cursor/account-mcp.js";
30
+ import { CursorAccountMcpBridge, collectCursorAccountConnections, cursorAccountMcpPath, cursorAccountSignInDiscovery, cursorAccountSignInIssuerPath, cursorAccountSignInPath, } from "./cursor/account-mcp.js";
31
31
  import { CursorBackendClient } from "./cursor/backend-client.js";
32
32
  import { cursorBackendUrl, cursorExternalApiUrl, resolveApiKey, resolveApiKeySync, SIGN_IN_HINT, } from "./cursor/credentials.js";
33
33
  import { CursorGithubCredentialProvider } from "./cursor/github-credentials.js";
@@ -495,6 +495,24 @@ export async function startServer(mounts, options = {}) {
495
495
  // Cloud turns reach the bridge through the serve publicUrl; without
496
496
  // one, the bridge admits loopback callers only.
497
497
  allowRemoteCallers: options.publicUrl !== undefined,
498
+ turnContextFor: (sessionId) => {
499
+ for (const runtime of runtimes) {
500
+ const turn = runtime.engine.turnContextFor(sessionId);
501
+ if (turn !== undefined) {
502
+ return turn;
503
+ }
504
+ }
505
+ return undefined;
506
+ },
507
+ turnSessionKeyFor: (sessionId) => {
508
+ for (const runtime of runtimes) {
509
+ const key = runtime.engine.turnSessionKeyFor(sessionId);
510
+ if (key !== undefined) {
511
+ return key;
512
+ }
513
+ }
514
+ return undefined;
515
+ },
498
516
  });
499
517
  }
500
518
  for (const { slug, project } of mounts) {
@@ -599,6 +617,10 @@ export async function startServer(mounts, options = {}) {
599
617
  cancelForContinuation: (token, reason) => reminderRunner.cancelForContinuation(token, reason),
600
618
  rekeyContinuation: (channelId, oldToken, newToken) => reminderRunner.rekeyContinuation(channelId, oldToken, newToken),
601
619
  dispatch: (id) => reminderRunner.dispatch(id),
620
+ fireNow: (id) => reminderRunner.fireNow(id),
621
+ createRequest: useReminderCpProtocol
622
+ ? (input) => reminderRunner.createRequest(input)
623
+ : undefined,
602
624
  });
603
625
  engine.setEvals({
604
626
  list: () => evalRuns.list(),
@@ -931,12 +953,16 @@ export async function startServer(mounts, options = {}) {
931
953
  runtime.engine.setMcpOauthCallbackUrl(mcpOauthServeCallbackUrl(oauthOrigin, oauthBase));
932
954
  if (accountBridge !== undefined && accountRefs !== undefined) {
933
955
  const bridge = accountBridge;
934
- runtime.engine.setCursorAccountAuthProbe(async (connection) => {
956
+ runtime.engine.setCursorAccountAuthProbe(async (connection, sessionId) => {
935
957
  const ref = accountRefs.find((entry) => entry.name === connection);
936
958
  if (ref === undefined) {
937
959
  return undefined;
938
960
  }
939
- return await bridge.probeAuthUrl(ref);
961
+ return await bridge.probeAuthUrl(ref, sessionId);
962
+ });
963
+ runtime.engine.setIndividualConnectedCheck(async (connection, sessionId) => {
964
+ const ref = accountRefs.find((entry) => entry.name === connection);
965
+ return ref !== undefined && (await bridge.individualConnected(ref, sessionId));
940
966
  });
941
967
  }
942
968
  const hasServerTools = runtime.project.agent.tools.some((tool) => tool.execution === "server");
@@ -1141,6 +1167,19 @@ function mountAgentRoutes(router, runtime, args) {
1141
1167
  return bridge.handle(request, ref, appendSlackQuietHint);
1142
1168
  },
1143
1169
  });
1170
+ for (const pattern of [
1171
+ cursorAccountSignInPath(":connection"),
1172
+ cursorAccountSignInIssuerPath(":connection"),
1173
+ ]) {
1174
+ router.add({
1175
+ method: "GET",
1176
+ pattern: `${base}${pattern}`,
1177
+ auth: [bridge.signInDiscoveryPolicy()],
1178
+ handler: (request, ctx) => refByName.get(ctx.params.connection ?? "")?.credentials === "individual"
1179
+ ? cursorAccountSignInDiscovery(request)
1180
+ : errorResponse(404, "not_found", "No sign-in for this connection."),
1181
+ });
1182
+ }
1144
1183
  }
1145
1184
  const defaultAuth = args.authToken !== undefined
1146
1185
  ? [bearerAuth(args.authToken)]
@@ -1175,10 +1214,11 @@ function mountAgentRoutes(router, runtime, args) {
1175
1214
  // The built-in http channel is not in `project.channels`; the control
1176
1215
  // plane's session start (`agentsdk.session`) is delivered to it.
1177
1216
  channels: [...project.channels, { id: HTTP_CHANNEL_ID, definition: project.httpChannel }],
1178
- buildHandlerArgs: (channelId, hostedSessionId) => buildChannelHandlerArgs({
1217
+ buildHandlerArgs: (channelId, hostedSessionId, execution) => buildChannelHandlerArgs({
1179
1218
  runtime,
1180
1219
  channelId,
1181
1220
  hostedSessionId,
1221
+ platformDeliveryId: execution?.platformDeliveryId,
1182
1222
  }),
1183
1223
  fireReminder: (reminderId, fireCount) => reminderRunner.dispatch(reminderId, { expectedFireCount: fireCount }),
1184
1224
  executeReminderDescriptor: async (descriptor) => {
@@ -2345,6 +2385,7 @@ function buildChannelHandlerArgs(input) {
2345
2385
  ...sendOptions,
2346
2386
  auth: sendOptions.auth !== undefined ? sendOptions.auth : auth,
2347
2387
  hostedSessionId: input.hostedSessionId,
2388
+ platformDeliveryId: input.platformDeliveryId,
2348
2389
  }),
2349
2390
  getSession: (sessionId) => runtime.engine.getChannelSession(channelId, sessionId),
2350
2391
  receive: (target, inputReceive) => runtime.engine.receive(target, inputReceive),
@@ -0,0 +1,14 @@
1
+ /**
2
+ * Per-session credentials under a per-boot key that is never sent. Holding
3
+ * one session's credential, or any secret the serve host hands out, mints no
4
+ * other session's.
5
+ */
6
+ export declare class SessionCredentials {
7
+ private readonly key;
8
+ for(sessionId: string): string;
9
+ /** Whether `presented` is the credential of `sessionId`. */
10
+ verifies(sessionId: string | null, presented: string | null | undefined): sessionId is string;
11
+ }
12
+ /** Query parameter carrying a session's credential to the tool MCP endpoint. */
13
+ export declare const TOOL_SESSION_CREDENTIAL_PARAM = "agentkitSessionCredential";
14
+ //# sourceMappingURL=session-credential.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"session-credential.d.ts","sourceRoot":"","sources":["../../src/internal/session-credential.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAmB;IAEvC,GAAG,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAE7B;IAED,4DAA4D;IAC5D,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,SAAS,IAAI,MAAM,CAO5F;CACF;AAED,gFAAgF;AAChF,eAAO,MAAM,6BAA6B,8BAA8B,CAAC"}
@@ -0,0 +1,25 @@
1
+ import { createHmac, randomBytes, timingSafeEqual } from "node:crypto";
2
+ /**
3
+ * Per-session credentials under a per-boot key that is never sent. Holding
4
+ * one session's credential, or any secret the serve host hands out, mints no
5
+ * other session's.
6
+ */
7
+ export class SessionCredentials {
8
+ constructor() {
9
+ this.key = randomBytes(32);
10
+ }
11
+ for(sessionId) {
12
+ return createHmac("sha256", this.key).update(sessionId).digest("hex");
13
+ }
14
+ /** Whether `presented` is the credential of `sessionId`. */
15
+ verifies(sessionId, presented) {
16
+ if (sessionId === null || sessionId === "" || presented === null || presented === undefined) {
17
+ return false;
18
+ }
19
+ const given = Buffer.from(presented);
20
+ const expected = Buffer.from(this.for(sessionId));
21
+ return given.length === expected.length && timingSafeEqual(given, expected);
22
+ }
23
+ }
24
+ /** Query parameter carrying a session's credential to the tool MCP endpoint. */
25
+ export const TOOL_SESSION_CREDENTIAL_PARAM = "agentkitSessionCredential";