@grok/agent-sdk 0.5.0 → 0.7.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (530) 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/manifest.d.ts.map +1 -1
  34. package/dist/channels/slack/manifest.js +2 -15
  35. package/dist/channels/slack/mentions.d.ts +28 -0
  36. package/dist/channels/slack/mentions.d.ts.map +1 -0
  37. package/dist/channels/slack/mentions.js +178 -0
  38. package/dist/channels/slack/setup.js +1 -1
  39. package/dist/channels/slack/slack-channel.d.ts.map +1 -1
  40. package/dist/channels/slack/slack-channel.js +46 -3
  41. package/dist/channels/slack/stop.d.ts.map +1 -1
  42. package/dist/channels/slack/stop.js +7 -1
  43. package/dist/channels/slack/thread-context.d.ts +3 -0
  44. package/dist/channels/slack/thread-context.d.ts.map +1 -1
  45. package/dist/channels/slack/thread-context.js +17 -7
  46. package/dist/channels/slack/tool-approval-events.d.ts.map +1 -1
  47. package/dist/channels/slack/tool-approval-events.js +55 -2
  48. package/dist/channels/slack/types.d.ts +2 -0
  49. package/dist/channels/slack/types.d.ts.map +1 -1
  50. package/dist/channels/teams/activity.d.ts +33 -0
  51. package/dist/channels/teams/activity.d.ts.map +1 -0
  52. package/dist/channels/teams/activity.js +213 -0
  53. package/dist/channels/teams/auth.d.ts +25 -0
  54. package/dist/channels/teams/auth.d.ts.map +1 -0
  55. package/dist/channels/teams/auth.js +55 -0
  56. package/dist/channels/teams/bot-framework-auth.d.ts +33 -0
  57. package/dist/channels/teams/bot-framework-auth.d.ts.map +1 -0
  58. package/dist/channels/teams/bot-framework-auth.js +154 -0
  59. package/dist/channels/teams/cards.d.ts +23 -0
  60. package/dist/channels/teams/cards.d.ts.map +1 -0
  61. package/dist/channels/teams/cards.js +107 -0
  62. package/dist/channels/teams/connector.d.ts +48 -0
  63. package/dist/channels/teams/connector.d.ts.map +1 -0
  64. package/dist/channels/teams/connector.js +159 -0
  65. package/dist/channels/teams/credentials.d.ts +65 -0
  66. package/dist/channels/teams/credentials.d.ts.map +1 -0
  67. package/dist/channels/teams/credentials.js +84 -0
  68. package/dist/channels/teams/delivery.d.ts +14 -0
  69. package/dist/channels/teams/delivery.d.ts.map +1 -0
  70. package/dist/channels/teams/delivery.js +169 -0
  71. package/dist/channels/teams/dispatch.d.ts +45 -0
  72. package/dist/channels/teams/dispatch.d.ts.map +1 -0
  73. package/dist/channels/teams/dispatch.js +402 -0
  74. package/dist/channels/teams/engagement.d.ts +32 -0
  75. package/dist/channels/teams/engagement.d.ts.map +1 -0
  76. package/dist/channels/teams/engagement.js +120 -0
  77. package/dist/channels/teams/index.d.ts +21 -0
  78. package/dist/channels/teams/index.d.ts.map +1 -0
  79. package/dist/channels/teams/index.js +19 -0
  80. package/dist/channels/teams/marks.d.ts +19 -0
  81. package/dist/channels/teams/marks.d.ts.map +1 -0
  82. package/dist/channels/teams/marks.js +96 -0
  83. package/dist/channels/teams/senders.d.ts +27 -0
  84. package/dist/channels/teams/senders.d.ts.map +1 -0
  85. package/dist/channels/teams/senders.js +72 -0
  86. package/dist/channels/teams/teams-channel.d.ts +43 -0
  87. package/dist/channels/teams/teams-channel.d.ts.map +1 -0
  88. package/dist/channels/teams/teams-channel.js +278 -0
  89. package/dist/channels/teams/text.d.ts +7 -0
  90. package/dist/channels/teams/text.d.ts.map +1 -0
  91. package/dist/channels/teams/text.js +63 -0
  92. package/dist/channels/teams/types.d.ts +306 -0
  93. package/dist/channels/teams/types.d.ts.map +1 -0
  94. package/dist/channels/teams/types.js +1 -0
  95. package/dist/channels.d.ts +31 -0
  96. package/dist/channels.d.ts.map +1 -1
  97. package/dist/channels.js +37 -0
  98. package/dist/connections.d.ts +1 -1
  99. package/dist/connections.d.ts.map +1 -1
  100. package/dist/docs/404.html +3 -3
  101. package/dist/docs/assets/{app.CYdjweqP.js → app.Ch-048af.js} +4 -4
  102. package/dist/docs/assets/changelog.md.SoN0MK7o.js +1 -0
  103. package/dist/docs/assets/{changelog.md.BMrJ5WxW.lean.js → changelog.md.SoN0MK7o.lean.js} +1 -1
  104. package/dist/docs/assets/chunks/@localSearchIndexroot.BdYoBKxY.js +1 -0
  105. package/dist/docs/assets/chunks/{VPLocalSearchBox.CRATKS9J.js → VPLocalSearchBox.D7BIa9Su.js} +2 -2
  106. package/dist/docs/assets/chunks/{arc.BxM78ISR.js → arc.BIzu7OVF.js} +1 -1
  107. package/dist/docs/assets/chunks/{architectureDiagram-Q4EWVU46.Bi6MuKaU.js → architectureDiagram-Q4EWVU46.DNznI0Sn.js} +1 -1
  108. package/dist/docs/assets/chunks/{baseUniq.L47qqpDG.js → baseUniq.B4y6Y5eG.js} +1 -1
  109. package/dist/docs/assets/chunks/{blockDiagram-DXYQGD6D.kHFF2FK5.js → blockDiagram-DXYQGD6D.BudnBsgw.js} +1 -1
  110. package/dist/docs/assets/chunks/{c4Diagram-AHTNJAMY.BTW85ll3.js → c4Diagram-AHTNJAMY._bB00GdB.js} +1 -1
  111. package/dist/docs/assets/chunks/channel.CgxlmuBS.js +1 -0
  112. package/dist/docs/assets/chunks/{chunk-4BX2VUAB.Bbh3_48g.js → chunk-4BX2VUAB.CRftnUwS.js} +1 -1
  113. package/dist/docs/assets/chunks/{chunk-4TB4RGXK.WeAmK3fK.js → chunk-4TB4RGXK.CSx1x2Ob.js} +1 -1
  114. package/dist/docs/assets/chunks/{chunk-55IACEB6.DTdUiVHf.js → chunk-55IACEB6.KkLHAAbH.js} +1 -1
  115. package/dist/docs/assets/chunks/{chunk-EDXVE4YY.n5XzANDz.js → chunk-EDXVE4YY.DDeKCCtX.js} +1 -1
  116. package/dist/docs/assets/chunks/{chunk-FMBD7UC4.D51eewCb.js → chunk-FMBD7UC4.DrLlsD9m.js} +1 -1
  117. package/dist/docs/assets/chunks/{chunk-OYMX7WX6.BrY0U7ZV.js → chunk-OYMX7WX6.DeVYOGcT.js} +1 -1
  118. package/dist/docs/assets/chunks/{chunk-QZHKN3VN.B0OA4aFV.js → chunk-QZHKN3VN.Cz4_bS6p.js} +1 -1
  119. package/dist/docs/assets/chunks/{chunk-YZCP3GAM.Djt3Mjft.js → chunk-YZCP3GAM.CwrYtDVo.js} +1 -1
  120. package/dist/docs/assets/chunks/classDiagram-6PBFFD2Q.DWroREP-.js +1 -0
  121. package/dist/docs/assets/chunks/classDiagram-v2-HSJHXN6E.DWroREP-.js +1 -0
  122. package/dist/docs/assets/chunks/clone.F824-PNx.js +1 -0
  123. package/dist/docs/assets/chunks/{cose-bilkent-S5V4N54A.DiMcA6Q8.js → cose-bilkent-S5V4N54A.3d8hflz6.js} +1 -1
  124. package/dist/docs/assets/chunks/{dagre-KV5264BT.BGqI4vrS.js → dagre-KV5264BT.BVEgjiPg.js} +1 -1
  125. package/dist/docs/assets/chunks/{diagram-5BDNPKRD.bDqFuMoH.js → diagram-5BDNPKRD.j7dZpUK_.js} +1 -1
  126. package/dist/docs/assets/chunks/{diagram-G4DWMVQ6.Y0sxaXRU.js → diagram-G4DWMVQ6.4flIgIon.js} +1 -1
  127. package/dist/docs/assets/chunks/{diagram-MMDJMWI5.Bg43b0yi.js → diagram-MMDJMWI5.BlJiFh-S.js} +1 -1
  128. package/dist/docs/assets/chunks/{diagram-TYMM5635.DCfVasEC.js → diagram-TYMM5635.DHAOHEyM.js} +1 -1
  129. package/dist/docs/assets/chunks/{erDiagram-SMLLAGMA.C72GaD16.js → erDiagram-SMLLAGMA.DkmyG7xK.js} +1 -1
  130. package/dist/docs/assets/chunks/{flowDiagram-DWJPFMVM.DxRQj7pP.js → flowDiagram-DWJPFMVM.L_WiaAU6.js} +1 -1
  131. package/dist/docs/assets/chunks/{ganttDiagram-T4ZO3ILL.DiLZy5Q4.js → ganttDiagram-T4ZO3ILL.CT6kOI2a.js} +1 -1
  132. package/dist/docs/assets/chunks/{gitGraphDiagram-UUTBAWPF.DL8XkRvh.js → gitGraphDiagram-UUTBAWPF.D8CRlLqh.js} +1 -1
  133. package/dist/docs/assets/chunks/{graph.3Xub80xJ.js → graph.CdOyJvsX.js} +1 -1
  134. package/dist/docs/assets/chunks/{infoDiagram-42DDH7IO.O3lGaspu.js → infoDiagram-42DDH7IO.DcmXeSos.js} +1 -1
  135. package/dist/docs/assets/chunks/{ishikawaDiagram-UXIWVN3A.w-pCiQzn.js → ishikawaDiagram-UXIWVN3A.BBjY4mxr.js} +1 -1
  136. package/dist/docs/assets/chunks/{journeyDiagram-VCZTEJTY.Cg_oBs9j.js → journeyDiagram-VCZTEJTY.BrXteAB6.js} +1 -1
  137. package/dist/docs/assets/chunks/{kanban-definition-6JOO6SKY.BpfMGPwn.js → kanban-definition-6JOO6SKY.OlHsUJVV.js} +1 -1
  138. package/dist/docs/assets/chunks/{layout.CtwXs__p.js → layout.DDwvoQlY.js} +1 -1
  139. package/dist/docs/assets/chunks/{linear.NmCskOrP.js → linear.BRXPDWj3.js} +1 -1
  140. package/dist/docs/assets/chunks/{min.DpQtsLKs.js → min.3YwC0t3o.js} +1 -1
  141. package/dist/docs/assets/chunks/{mindmap-definition-QFDTVHPH.B-P-aKVp.js → mindmap-definition-QFDTVHPH.mPHnT2lN.js} +1 -1
  142. package/dist/docs/assets/chunks/{pieDiagram-DEJITSTG.BfjjqK7j.js → pieDiagram-DEJITSTG.DEK2--em.js} +1 -1
  143. package/dist/docs/assets/chunks/{quadrantDiagram-34T5L4WZ.BTzHo53F.js → quadrantDiagram-34T5L4WZ.NCdRAOzK.js} +1 -1
  144. package/dist/docs/assets/chunks/{requirementDiagram-MS252O5E.DIT2FIKr.js → requirementDiagram-MS252O5E.DLAocFWZ.js} +1 -1
  145. package/dist/docs/assets/chunks/{sankeyDiagram-XADWPNL6.NK1wCsgt.js → sankeyDiagram-XADWPNL6.afIOqpyT.js} +1 -1
  146. package/dist/docs/assets/chunks/{sequenceDiagram-FGHM5R23.D9oElkvo.js → sequenceDiagram-FGHM5R23.DXBjvkkE.js} +1 -1
  147. package/dist/docs/assets/chunks/{stateDiagram-FHFEXIEX.IPksnixH.js → stateDiagram-FHFEXIEX.B_SGgvgs.js} +1 -1
  148. package/dist/docs/assets/chunks/stateDiagram-v2-QKLJ7IA2.OKAy5Bz7.js +1 -0
  149. package/dist/docs/assets/chunks/{theme.CgKu7tr3.js → theme.bNyH5NPA.js} +2 -2
  150. package/dist/docs/assets/chunks/{timeline-definition-GMOUNBTQ.CuAtJapY.js → timeline-definition-GMOUNBTQ.CE6S1iSb.js} +1 -1
  151. package/dist/docs/assets/chunks/{vennDiagram-DHZGUBPP.B87nNW9E.js → vennDiagram-DHZGUBPP.Blk7wb8V.js} +1 -1
  152. package/dist/docs/assets/chunks/wardley-RL74JXVD.DQqE3WF8.js +162 -0
  153. package/dist/docs/assets/chunks/{wardleyDiagram-NUSXRM2D.BELjSq8w.js → wardleyDiagram-NUSXRM2D.MUEQyRnz.js} +1 -1
  154. package/dist/docs/assets/chunks/{xychartDiagram-5P7HB3ND.5zN5ZGsz.js → xychartDiagram-5P7HB3ND.DnJA2aXp.js} +1 -1
  155. package/dist/docs/assets/{deployment.md.DJtuDVLh.js → deployment.md.N9S5KC5R.js} +2 -2
  156. package/dist/docs/assets/{deployment.md.DJtuDVLh.lean.js → deployment.md.N9S5KC5R.lean.js} +1 -1
  157. package/dist/docs/assets/guides_cloud-agents.md.BdWqmUGb.js +14 -0
  158. package/dist/docs/assets/{guides_cloud-agents.md.CiXAW6on.lean.js → guides_cloud-agents.md.BdWqmUGb.lean.js} +1 -1
  159. package/dist/docs/assets/guides_teams.md.7Lz2sbqB.js +50 -0
  160. package/dist/docs/assets/guides_teams.md.7Lz2sbqB.lean.js +1 -0
  161. package/dist/docs/assets/{reference_channels.md.CPWOpdsC.js → reference_channels.md.CRvqgU0n.js} +1 -1
  162. package/dist/docs/assets/{reference_cli.md.DHm6DmYk.js → reference_cli.md.NS6U5a-7.js} +14 -4
  163. package/dist/docs/assets/{reference_cli.md.DHm6DmYk.lean.js → reference_cli.md.NS6U5a-7.lean.js} +1 -1
  164. package/dist/docs/assets/{reference_limits.md.CbdtFr4T.js → reference_limits.md.CW9PTdxr.js} +3 -3
  165. package/dist/docs/assets/{reference_limits.md.CbdtFr4T.lean.js → reference_limits.md.CW9PTdxr.lean.js} +1 -1
  166. package/dist/docs/assets/{reference_schedules.md.RhQ9ZLo1.js → reference_schedules.md.Dd8_d0WG.js} +3 -3
  167. package/dist/docs/assets/{reference_sessions.md.NXVQt9mP.js → reference_sessions.md.CoCyQLEz.js} +2 -2
  168. package/dist/docs/assets/{reference_sessions.md.NXVQt9mP.lean.js → reference_sessions.md.CoCyQLEz.lean.js} +1 -1
  169. package/dist/docs/assets/{reference_skills.md.DzCPNPkG.js → reference_skills.md.SFRZDC41.js} +4 -4
  170. package/dist/docs/assets/{reference_skills.md.DzCPNPkG.lean.js → reference_skills.md.SFRZDC41.lean.js} +1 -1
  171. package/dist/docs/assets/{style.DK0YX1WL.css → style.B7zPxANR.css} +1 -1
  172. package/dist/docs/assets/troubleshooting.md.CsQTleto.js +3 -0
  173. package/dist/docs/assets/{troubleshooting.md.DfKKvW1R.lean.js → troubleshooting.md.CsQTleto.lean.js} +1 -1
  174. package/dist/docs/building-with-agents.html +37 -37
  175. package/dist/docs/changelog.html +37 -37
  176. package/dist/docs/changelog.md +51 -0
  177. package/dist/docs/deployment.html +39 -39
  178. package/dist/docs/deployment.md +10 -0
  179. package/dist/docs/evals.html +37 -37
  180. package/dist/docs/guides/agent-to-agent.html +37 -37
  181. package/dist/docs/guides/bitbucket.html +37 -37
  182. package/dist/docs/guides/cloud-agents.html +43 -38
  183. package/dist/docs/guides/cloud-agents.md +47 -0
  184. package/dist/docs/guides/convert-automation.html +37 -37
  185. package/dist/docs/guides/github.html +37 -37
  186. package/dist/docs/guides/gitlab.html +37 -37
  187. package/dist/docs/guides/improve.html +37 -37
  188. package/dist/docs/guides/jev.html +37 -37
  189. package/dist/docs/guides/mcp-oauth.html +37 -37
  190. package/dist/docs/guides/migrate.html +37 -37
  191. package/dist/docs/guides/opentelemetry.html +37 -37
  192. package/dist/docs/guides/pagerduty.html +37 -37
  193. package/dist/docs/guides/slack.html +37 -37
  194. package/dist/docs/guides/teams.html +109 -0
  195. package/dist/docs/guides/teams.md +384 -0
  196. package/dist/docs/guides/webhooks.html +37 -37
  197. package/dist/docs/hashmap.json +1 -1
  198. package/dist/docs/hillclimbing.html +37 -37
  199. package/dist/docs/index.html +37 -37
  200. package/dist/docs/llms-full.txt +652 -4
  201. package/dist/docs/llms.txt +1 -0
  202. package/dist/docs/quickstart.html +37 -37
  203. package/dist/docs/reference/access.html +36 -36
  204. package/dist/docs/reference/agent-config.html +37 -37
  205. package/dist/docs/reference/artifacts.html +37 -37
  206. package/dist/docs/reference/channels.html +38 -38
  207. package/dist/docs/reference/channels.md +1 -0
  208. package/dist/docs/reference/cli.html +50 -40
  209. package/dist/docs/reference/cli.md +116 -0
  210. package/dist/docs/reference/connections.html +37 -37
  211. package/dist/docs/reference/evals.html +37 -37
  212. package/dist/docs/reference/extensions.html +37 -37
  213. package/dist/docs/reference/hooks.html +37 -37
  214. package/dist/docs/reference/http-api.html +37 -37
  215. package/dist/docs/reference/instructions.html +37 -37
  216. package/dist/docs/reference/limits.html +39 -39
  217. package/dist/docs/reference/limits.md +4 -4
  218. package/dist/docs/reference/memory.html +37 -37
  219. package/dist/docs/reference/playground.html +36 -36
  220. package/dist/docs/reference/project-layout.html +37 -37
  221. package/dist/docs/reference/schedules.html +40 -40
  222. package/dist/docs/reference/sessions.html +38 -38
  223. package/dist/docs/reference/sessions.md +13 -0
  224. package/dist/docs/reference/skills.html +40 -40
  225. package/dist/docs/reference/subagents.html +37 -37
  226. package/dist/docs/reference/tools.html +37 -37
  227. package/dist/docs/templates/agentic-owners.html +37 -37
  228. package/dist/docs/templates/reviews.html +37 -37
  229. package/dist/docs/troubleshooting.html +38 -38
  230. package/dist/docs/troubleshooting.md +21 -0
  231. package/dist/evals/run-facts.d.ts.map +1 -1
  232. package/dist/evals/run-facts.js +4 -0
  233. package/dist/extensions/cursor-cloud-agents/channels/cursor-cloud-agents.d.ts +12 -0
  234. package/dist/extensions/cursor-cloud-agents/channels/cursor-cloud-agents.d.ts.map +1 -0
  235. package/dist/extensions/cursor-cloud-agents/channels/cursor-cloud-agents.js +42 -0
  236. package/dist/extensions/cursor-cloud-agents/extension.d.ts +10 -7
  237. package/dist/extensions/cursor-cloud-agents/extension.d.ts.map +1 -1
  238. package/dist/extensions/cursor-cloud-agents/extension.js +3 -2
  239. package/dist/extensions/cursor-cloud-agents/lib/agent-id.d.ts +5 -0
  240. package/dist/extensions/cursor-cloud-agents/lib/agent-id.d.ts.map +1 -0
  241. package/dist/extensions/cursor-cloud-agents/lib/agent-id.js +10 -0
  242. package/dist/extensions/cursor-cloud-agents/lib/backend.d.ts +57 -3
  243. package/dist/extensions/cursor-cloud-agents/lib/backend.d.ts.map +1 -1
  244. package/dist/extensions/cursor-cloud-agents/lib/backend.js +150 -35
  245. package/dist/extensions/cursor-cloud-agents/lib/fleet.d.ts +32 -4
  246. package/dist/extensions/cursor-cloud-agents/lib/fleet.d.ts.map +1 -1
  247. package/dist/extensions/cursor-cloud-agents/lib/fleet.js +93 -7
  248. package/dist/extensions/cursor-cloud-agents/lib/launch-agent.d.ts +24 -7
  249. package/dist/extensions/cursor-cloud-agents/lib/launch-agent.d.ts.map +1 -1
  250. package/dist/extensions/cursor-cloud-agents/lib/launch-agent.js +158 -25
  251. package/dist/extensions/cursor-cloud-agents/lib/stop-signal.d.ts +18 -0
  252. package/dist/extensions/cursor-cloud-agents/lib/stop-signal.d.ts.map +1 -0
  253. package/dist/extensions/cursor-cloud-agents/lib/stop-signal.js +27 -0
  254. package/dist/extensions/cursor-cloud-agents/lib/transcript.d.ts.map +1 -1
  255. package/dist/extensions/cursor-cloud-agents/lib/transcript.js +2 -3
  256. package/dist/extensions/cursor-cloud-agents/lib/watch.d.ts +26 -12
  257. package/dist/extensions/cursor-cloud-agents/lib/watch.d.ts.map +1 -1
  258. package/dist/extensions/cursor-cloud-agents/lib/watch.js +115 -46
  259. package/dist/extensions/cursor-cloud-agents/reminders/cloud-agent-stop-watch.d.ts +16 -5
  260. package/dist/extensions/cursor-cloud-agents/reminders/cloud-agent-stop-watch.d.ts.map +1 -1
  261. package/dist/extensions/cursor-cloud-agents/reminders/cloud-agent-stop-watch.js +76 -20
  262. package/dist/extensions/cursor-cloud-agents/skills/handoff.md +2 -2
  263. package/dist/extensions/cursor-cloud-agents/tools/get.js +2 -2
  264. package/dist/extensions/cursor-cloud-agents/tools/launch.js +1 -1
  265. package/dist/extensions.d.ts.map +1 -1
  266. package/dist/extensions.js +18 -3
  267. package/dist/files-backends/agent-store-presigned-url.js +5 -1
  268. package/dist/index.d.ts +1 -0
  269. package/dist/index.d.ts.map +1 -1
  270. package/dist/index.js +1 -0
  271. package/dist/internal/approval-gate.d.ts +6 -1
  272. package/dist/internal/approval-gate.d.ts.map +1 -1
  273. package/dist/internal/approval-gate.js +13 -2
  274. package/dist/internal/authored-loaders.js +1 -1
  275. package/dist/internal/channel-architecture.d.ts.map +1 -1
  276. package/dist/internal/channel-architecture.js +3 -1
  277. package/dist/internal/cli/commands/channels.d.ts +9 -3
  278. package/dist/internal/cli/commands/channels.d.ts.map +1 -1
  279. package/dist/internal/cli/commands/channels.js +193 -4
  280. package/dist/internal/cli/commands/index.d.ts.map +1 -1
  281. package/dist/internal/cli/commands/index.js +6 -1
  282. package/dist/internal/cli/commands/serve.d.ts.map +1 -1
  283. package/dist/internal/cli/commands/serve.js +25 -5
  284. package/dist/internal/cli/dispatch.d.ts.map +1 -1
  285. package/dist/internal/cli/dispatch.js +22 -8
  286. package/dist/internal/cli/flags.d.ts +14 -0
  287. package/dist/internal/cli/flags.d.ts.map +1 -1
  288. package/dist/internal/cli/flags.js +14 -0
  289. package/dist/internal/cli/help.d.ts.map +1 -1
  290. package/dist/internal/cli/help.js +3 -1
  291. package/dist/internal/cli-cursor.js +2 -2
  292. package/dist/internal/cli-deploy.d.ts +1 -0
  293. package/dist/internal/cli-deploy.d.ts.map +1 -1
  294. package/dist/internal/cli-deploy.js +31 -8
  295. package/dist/internal/cli-mcp.d.ts.map +1 -1
  296. package/dist/internal/cli-mcp.js +5 -3
  297. package/dist/internal/cli-teams-doctor.d.ts +39 -0
  298. package/dist/internal/cli-teams-doctor.d.ts.map +1 -0
  299. package/dist/internal/cli-teams-doctor.js +508 -0
  300. package/dist/internal/cli-teams-forward.d.ts +84 -0
  301. package/dist/internal/cli-teams-forward.d.ts.map +1 -0
  302. package/dist/internal/cli-teams-forward.js +386 -0
  303. package/dist/internal/cli-teams-package.d.ts +26 -0
  304. package/dist/internal/cli-teams-package.d.ts.map +1 -0
  305. package/dist/internal/cli-teams-package.js +123 -0
  306. package/dist/internal/cli-teams.d.ts +15 -0
  307. package/dist/internal/cli-teams.d.ts.map +1 -0
  308. package/dist/internal/cli-teams.js +253 -0
  309. package/dist/internal/connect-click.d.ts +12 -0
  310. package/dist/internal/connect-click.d.ts.map +1 -0
  311. package/dist/internal/connect-click.js +22 -0
  312. package/dist/internal/continuation-channel.d.ts +5 -1
  313. package/dist/internal/continuation-channel.d.ts.map +1 -1
  314. package/dist/internal/continuation-channel.js +34 -0
  315. package/dist/internal/continuation-identity.d.ts +7 -4
  316. package/dist/internal/continuation-identity.d.ts.map +1 -1
  317. package/dist/internal/continuation-identity.js +66 -1
  318. package/dist/internal/convert-automation/convert-workflow.js +2 -2
  319. package/dist/internal/credential-env-names.d.ts +36 -0
  320. package/dist/internal/credential-env-names.d.ts.map +1 -0
  321. package/dist/internal/credential-env-names.js +68 -0
  322. package/dist/internal/cursor/account-mcp.d.ts +67 -9
  323. package/dist/internal/cursor/account-mcp.d.ts.map +1 -1
  324. package/dist/internal/cursor/account-mcp.js +206 -25
  325. package/dist/internal/cursor/backend-client.d.ts +10 -1
  326. package/dist/internal/cursor/backend-client.d.ts.map +1 -1
  327. package/dist/internal/cursor/backend-client.js +19 -7
  328. package/dist/internal/cursor/cloud-agent-identity.d.ts +81 -0
  329. package/dist/internal/cursor/cloud-agent-identity.d.ts.map +1 -0
  330. package/dist/internal/cursor/cloud-agent-identity.js +224 -0
  331. package/dist/internal/cursor/credentials.d.ts.map +1 -1
  332. package/dist/internal/cursor/credentials.js +3 -1
  333. package/dist/internal/cursor-account-mcp-auth.d.ts +1 -0
  334. package/dist/internal/cursor-account-mcp-auth.d.ts.map +1 -1
  335. package/dist/internal/cursor-account-mcp-auth.js +2 -1
  336. package/dist/internal/deploy-client.d.ts.map +1 -1
  337. package/dist/internal/deploy-client.js +34 -2
  338. package/dist/internal/deploy-manifest.d.ts +51 -3
  339. package/dist/internal/deploy-manifest.d.ts.map +1 -1
  340. package/dist/internal/deploy-manifest.js +96 -7
  341. package/dist/internal/discovery/agent-config.d.ts.map +1 -1
  342. package/dist/internal/discovery/agent-config.js +6 -1
  343. package/dist/internal/discovery/connections.d.ts.map +1 -1
  344. package/dist/internal/discovery/connections.js +53 -0
  345. package/dist/internal/discovery/extensions.d.ts.map +1 -1
  346. package/dist/internal/discovery/extensions.js +2 -0
  347. package/dist/internal/discovery/info.d.ts.map +1 -1
  348. package/dist/internal/discovery/info.js +4 -0
  349. package/dist/internal/env-file.d.ts +1 -0
  350. package/dist/internal/env-file.d.ts.map +1 -1
  351. package/dist/internal/env-file.js +18 -17
  352. package/dist/internal/env-prefix.d.ts +11 -0
  353. package/dist/internal/env-prefix.d.ts.map +1 -0
  354. package/dist/internal/env-prefix.js +23 -0
  355. package/dist/internal/event-id-dedupe.d.ts +12 -0
  356. package/dist/internal/event-id-dedupe.d.ts.map +1 -0
  357. package/dist/{channels/slack → internal}/event-id-dedupe.js +7 -4
  358. package/dist/internal/event-mapper.d.ts +7 -2
  359. package/dist/internal/event-mapper.d.ts.map +1 -1
  360. package/dist/internal/event-mapper.js +7 -0
  361. package/dist/internal/expected-delivery-failure.d.ts.map +1 -1
  362. package/dist/internal/expected-delivery-failure.js +3 -0
  363. package/dist/internal/extension-namespace.d.ts +9 -0
  364. package/dist/internal/extension-namespace.d.ts.map +1 -0
  365. package/dist/internal/extension-namespace.js +14 -0
  366. package/dist/internal/guid.d.ts +2 -0
  367. package/dist/internal/guid.d.ts.map +1 -0
  368. package/dist/internal/guid.js +4 -0
  369. package/dist/internal/host-kv-cas.d.ts +13 -0
  370. package/dist/internal/host-kv-cas.d.ts.map +1 -0
  371. package/dist/internal/host-kv-cas.js +8 -0
  372. package/dist/internal/host-kv.d.ts +4 -1
  373. package/dist/internal/host-kv.d.ts.map +1 -1
  374. package/dist/internal/host-kv.js +15 -2
  375. package/dist/internal/hosted-catch-protocol.d.ts +5 -0
  376. package/dist/internal/hosted-catch-protocol.d.ts.map +1 -1
  377. package/dist/internal/hosted-catch-protocol.js +5 -0
  378. package/dist/internal/hosted-catch.d.ts +2 -0
  379. package/dist/internal/hosted-catch.d.ts.map +1 -1
  380. package/dist/internal/hosted-catch.js +6 -1
  381. package/dist/internal/hosted-delivery-protocol.d.ts +6 -0
  382. package/dist/internal/hosted-delivery-protocol.d.ts.map +1 -1
  383. package/dist/internal/hosted-delivery-protocol.js +71 -1
  384. package/dist/internal/hosted-delivery.d.ts +5 -2
  385. package/dist/internal/hosted-delivery.d.ts.map +1 -1
  386. package/dist/internal/hosted-delivery.js +36 -12
  387. package/dist/internal/hosted-execution-latency.d.ts +3 -0
  388. package/dist/internal/hosted-execution-latency.d.ts.map +1 -1
  389. package/dist/internal/hosted-execution-latency.js +11 -0
  390. package/dist/internal/hosted-session-fixture.js +1 -1
  391. package/dist/internal/hosting.d.ts +5 -0
  392. package/dist/internal/hosting.d.ts.map +1 -1
  393. package/dist/internal/hosting.js +7 -1
  394. package/dist/internal/install-cursor-skills.d.ts +6 -7
  395. package/dist/internal/install-cursor-skills.d.ts.map +1 -1
  396. package/dist/internal/install-cursor-skills.js +15 -9
  397. package/dist/internal/interview/agent-questions.d.ts +1 -1
  398. package/dist/internal/interview/agent-questions.d.ts.map +1 -1
  399. package/dist/internal/interview/agent-questions.js +4 -3
  400. package/dist/internal/local-control-plane.d.ts.map +1 -1
  401. package/dist/internal/local-control-plane.js +24 -0
  402. package/dist/internal/mcp-allowlist-in-use.d.ts +23 -0
  403. package/dist/internal/mcp-allowlist-in-use.d.ts.map +1 -0
  404. package/dist/internal/mcp-allowlist-in-use.js +93 -0
  405. package/dist/internal/mcp-endpoint.d.ts.map +1 -1
  406. package/dist/internal/mcp-endpoint.js +8 -10
  407. package/dist/internal/mcp-host.d.ts +19 -1
  408. package/dist/internal/mcp-host.d.ts.map +1 -1
  409. package/dist/internal/mcp-host.js +67 -3
  410. package/dist/internal/mcp-oauth.d.ts.map +1 -1
  411. package/dist/internal/mcp-oauth.js +5 -7
  412. package/dist/internal/oidcAudiences.d.ts +22 -0
  413. package/dist/internal/oidcAudiences.d.ts.map +1 -0
  414. package/dist/internal/oidcAudiences.js +35 -0
  415. package/dist/internal/otel/collector.d.ts.map +1 -1
  416. package/dist/internal/otel/collector.js +2 -0
  417. package/dist/internal/platform-timers.d.ts +2 -0
  418. package/dist/internal/platform-timers.d.ts.map +1 -1
  419. package/dist/internal/platform-timers.js +14 -0
  420. package/dist/internal/private-file.d.ts +32 -1
  421. package/dist/internal/private-file.d.ts.map +1 -1
  422. package/dist/internal/private-file.js +209 -7
  423. package/dist/internal/redact-values.d.ts +3 -0
  424. package/dist/internal/redact-values.d.ts.map +1 -0
  425. package/dist/internal/redact-values.js +19 -0
  426. package/dist/internal/reminder-control-plane-protocol.d.ts +7 -1
  427. package/dist/internal/reminder-control-plane-protocol.d.ts.map +1 -1
  428. package/dist/internal/reminder-followup-error.d.ts +23 -0
  429. package/dist/internal/reminder-followup-error.d.ts.map +1 -0
  430. package/dist/internal/reminder-followup-error.js +12 -0
  431. package/dist/internal/reminder-runner.d.ts +15 -1
  432. package/dist/internal/reminder-runner.d.ts.map +1 -1
  433. package/dist/internal/reminder-runner.js +95 -21
  434. package/dist/internal/resolved-connections.d.ts.map +1 -1
  435. package/dist/internal/resolved-connections.js +23 -3
  436. package/dist/internal/run-client.js +2 -1
  437. package/dist/internal/run-program.d.ts +31 -0
  438. package/dist/internal/run-program.d.ts.map +1 -0
  439. package/dist/internal/run-program.js +150 -0
  440. package/dist/internal/sdk-runner.d.ts +29 -3
  441. package/dist/internal/sdk-runner.d.ts.map +1 -1
  442. package/dist/internal/sdk-runner.js +304 -38
  443. package/dist/internal/server.d.ts.map +1 -1
  444. package/dist/internal/server.js +53 -8
  445. package/dist/internal/session-credential.d.ts +14 -0
  446. package/dist/internal/session-credential.d.ts.map +1 -0
  447. package/dist/internal/session-credential.js +25 -0
  448. package/dist/internal/session-engine.d.ts +137 -5
  449. package/dist/internal/session-engine.d.ts.map +1 -1
  450. package/dist/internal/session-engine.js +606 -92
  451. package/dist/internal/storage-coordinator.d.ts +3 -1
  452. package/dist/internal/storage-coordinator.d.ts.map +1 -1
  453. package/dist/internal/storage-coordinator.js +13 -0
  454. package/dist/internal/storage-roles.d.ts +9 -1
  455. package/dist/internal/storage-roles.d.ts.map +1 -1
  456. package/dist/internal/tcp-address.d.ts +3 -1
  457. package/dist/internal/tcp-address.d.ts.map +1 -1
  458. package/dist/internal/tcp-address.js +6 -0
  459. package/dist/internal/teams-channel-profile.d.ts +41 -0
  460. package/dist/internal/teams-channel-profile.d.ts.map +1 -0
  461. package/dist/internal/teams-channel-profile.js +91 -0
  462. package/dist/internal/teams-devtunnel.d.ts +55 -0
  463. package/dist/internal/teams-devtunnel.d.ts.map +1 -0
  464. package/dist/internal/teams-devtunnel.js +205 -0
  465. package/dist/internal/teams-tunnel-proxy.d.ts +17 -0
  466. package/dist/internal/teams-tunnel-proxy.d.ts.map +1 -0
  467. package/dist/internal/teams-tunnel-proxy.js +100 -0
  468. package/dist/internal/testing/conversation-identity-vectors.d.ts +7 -1
  469. package/dist/internal/testing/conversation-identity-vectors.d.ts.map +1 -1
  470. package/dist/internal/testing/conversation-identity-vectors.js +67 -0
  471. package/dist/internal/testing/hosted-http.d.ts +15 -0
  472. package/dist/internal/testing/hosted-http.d.ts.map +1 -0
  473. package/dist/internal/testing/hosted-http.js +86 -0
  474. package/dist/internal/testing/teams-activity-fixtures.d.ts +28 -0
  475. package/dist/internal/testing/teams-activity-fixtures.d.ts.map +1 -0
  476. package/dist/internal/testing/teams-activity-fixtures.js +236 -0
  477. package/dist/internal/testing/teams-doctor-fixtures.d.ts +76 -0
  478. package/dist/internal/testing/teams-doctor-fixtures.d.ts.map +1 -0
  479. package/dist/internal/testing/teams-doctor-fixtures.js +216 -0
  480. package/dist/internal/tunnel-process.d.ts +29 -0
  481. package/dist/internal/tunnel-process.d.ts.map +1 -0
  482. package/dist/internal/tunnel-process.js +105 -0
  483. package/dist/internal/turn-context.d.ts +28 -0
  484. package/dist/internal/turn-context.d.ts.map +1 -0
  485. package/dist/internal/turn-context.js +1 -0
  486. package/dist/oidc-token.d.ts +127 -0
  487. package/dist/oidc-token.d.ts.map +1 -0
  488. package/dist/oidc-token.js +221 -0
  489. package/dist/playground/assets/index-BaBSZXki.css +1 -0
  490. package/dist/playground/assets/index-BkAF8YlO.js +62 -0
  491. package/dist/playground/index.html +2 -2
  492. package/dist/teams-app-package.d.ts +78 -0
  493. package/dist/teams-app-package.d.ts.map +1 -0
  494. package/dist/teams-app-package.js +204 -0
  495. package/dist/tools.d.ts +1 -1
  496. package/dist/tools.d.ts.map +1 -1
  497. package/dist/types.d.ts +278 -2
  498. package/dist/types.d.ts.map +1 -1
  499. package/docs/changelog.md +51 -0
  500. package/docs/deployment.md +10 -0
  501. package/docs/guides/cloud-agents.md +47 -0
  502. package/docs/guides/teams.md +389 -0
  503. package/docs/reference/channels.md +1 -0
  504. package/docs/reference/cli.md +116 -0
  505. package/docs/reference/limits.md +4 -4
  506. package/docs/reference/sessions.md +13 -0
  507. package/docs/troubleshooting.md +21 -0
  508. package/package.json +21 -46
  509. package/skills/create-agent/SKILL.md +17 -4
  510. package/skills/debug/SKILL.md +1 -0
  511. package/skills/deploy/SKILL.md +1 -1
  512. package/skills/framework-map/SKILL.md +1 -0
  513. package/skills/setup-teams/SKILL.md +141 -0
  514. package/templates/agentic-owners/bot/lib/owners/parse.ts +1 -0
  515. package/dist/channels/slack/event-id-dedupe.d.ts +0 -10
  516. package/dist/channels/slack/event-id-dedupe.d.ts.map +0 -1
  517. package/dist/docs/assets/changelog.md.BMrJ5WxW.js +0 -1
  518. package/dist/docs/assets/chunks/@localSearchIndexroot.dUaE1f8e.js +0 -1
  519. package/dist/docs/assets/chunks/channel.ljJtQtBi.js +0 -1
  520. package/dist/docs/assets/chunks/classDiagram-6PBFFD2Q.BZ3Uc-XU.js +0 -1
  521. package/dist/docs/assets/chunks/classDiagram-v2-HSJHXN6E.BZ3Uc-XU.js +0 -1
  522. package/dist/docs/assets/chunks/clone.BDtbEo69.js +0 -1
  523. package/dist/docs/assets/chunks/stateDiagram-v2-QKLJ7IA2.CbhzVsQE.js +0 -1
  524. package/dist/docs/assets/chunks/wardley-RL74JXVD.BFIVMaoi.js +0 -162
  525. package/dist/docs/assets/guides_cloud-agents.md.CiXAW6on.js +0 -9
  526. package/dist/docs/assets/troubleshooting.md.DfKKvW1R.js +0 -3
  527. package/dist/playground/assets/index-D0-FHg1x.css +0 -1
  528. package/dist/playground/assets/index-D5SLKUy6.js +0 -62
  529. /package/dist/docs/assets/{reference_channels.md.CPWOpdsC.lean.js → reference_channels.md.CRvqgU0n.lean.js} +0 -0
  530. /package/dist/docs/assets/{reference_schedules.md.RhQ9ZLo1.lean.js → reference_schedules.md.Dd8_d0WG.lean.js} +0 -0
@@ -1,8 +1,210 @@
1
- import { chmod, mkdir, writeFile } from "node:fs/promises";
2
- import { dirname } from "node:path";
3
- export async function writePrivateFile(path, contents) {
4
- await mkdir(dirname(path), { recursive: true, mode: 0o700 });
5
- await writeFile(path, contents, { mode: 0o600 });
6
- // writeFile mode only applies on create; clamp pre-existing files too.
7
- await chmod(path, 0o600);
1
+ import { randomBytes } from "node:crypto";
2
+ import { chmodSync, lstatSync, statSync } from "node:fs";
3
+ import { chmod, lstat, mkdir, open, readlink, realpath, rename, rm, stat } from "node:fs/promises";
4
+ import { basename, dirname, join, resolve } from "node:path";
5
+ import { setTimeout as sleep } from "node:timers/promises";
6
+ const PRIVATE_FILE_MODE = 0o600;
7
+ const PRIVATE_DIRECTORY_MODE = 0o700;
8
+ const GROUP_AND_OTHER_BITS = 0o077;
9
+ const MAX_SYMLINK_HOPS = 40;
10
+ const WINDOWS_RENAME_RETRY_DELAYS_MS = [10, 25, 50, 100, 200];
11
+ const WINDOWS_TRANSIENT_RENAME_CODES = new Set(["EPERM", "EACCES", "EBUSY"]);
12
+ const UNSUPPORTED_MODE_CODES = new Set([
13
+ "ENOSYS",
14
+ "ENOTSUP",
15
+ "EOPNOTSUPP",
16
+ "EINVAL",
17
+ "EPERM",
18
+ ]);
19
+ /**
20
+ * Writes `contents` through an `O_EXCL` temporary file created `0600` beside
21
+ * the target and renames it into place, so the secret never exists on disk
22
+ * with a looser mode and readers never see a partial file. A symbolic link at
23
+ * the target is replaced, not followed. On Windows the file inherits the
24
+ * directory's per-user ACL.
25
+ */
26
+ export async function writePrivateFile(path, contents, options = {}) {
27
+ const directory = dirname(path);
28
+ await mkdir(dirname(directory), { recursive: true });
29
+ try {
30
+ await mkdir(directory, { mode: PRIVATE_DIRECTORY_MODE });
31
+ }
32
+ catch (error) {
33
+ if (errorCode(error) !== "EEXIST") {
34
+ throw error;
35
+ }
36
+ }
37
+ if (options.privateDirectory !== false) {
38
+ await removeGroupAndOtherAccess(directory, "directory").catch(ignoreUnsupportedMode);
39
+ }
40
+ const temporary = join(directory, `.${basename(path)}.${randomBytes(6).toString("hex")}.tmp`);
41
+ const handle = await open(temporary, "wx", PRIVATE_FILE_MODE);
42
+ try {
43
+ try {
44
+ await handle.chmod(PRIVATE_FILE_MODE).catch(ignoreUnsupportedMode);
45
+ await handle.writeFile(contents, "utf8");
46
+ await handle.sync();
47
+ }
48
+ finally {
49
+ await handle.close();
50
+ }
51
+ await renameReplacing(temporary, path);
52
+ }
53
+ catch (error) {
54
+ await rm(temporary, { force: true });
55
+ throw error;
56
+ }
57
+ }
58
+ /**
59
+ * Resolves symbolic links in `path` so a write lands on the file a user linked
60
+ * in (a dotfiles checkout, a shared `.env`) instead of replacing the link. A
61
+ * link whose target does not exist yet resolves to that target, so the write
62
+ * creates it. A missing path is returned unchanged.
63
+ */
64
+ export async function resolveLinkedFile(path) {
65
+ let current = path;
66
+ for (let hop = 0; hop < MAX_SYMLINK_HOPS; hop++) {
67
+ try {
68
+ return await realpath(current);
69
+ }
70
+ catch (error) {
71
+ if (errorCode(error) !== "ENOENT") {
72
+ throw error;
73
+ }
74
+ }
75
+ let target;
76
+ try {
77
+ target = await readlink(current);
78
+ }
79
+ catch (error) {
80
+ const code = errorCode(error);
81
+ if (code === "ENOENT" || code === "EINVAL") {
82
+ return current;
83
+ }
84
+ throw error;
85
+ }
86
+ current = resolve(await realpath(dirname(current)), target);
87
+ }
88
+ return current;
89
+ }
90
+ /**
91
+ * Removes group and other access from a secret file an older build may have
92
+ * written world-readable, and from its directory unless `privateDirectory` is
93
+ * false. Never throws, so a read can follow it unconditionally.
94
+ */
95
+ export async function restrictExistingPrivateFile(path, options = {}) {
96
+ if (process.platform === "win32") {
97
+ return;
98
+ }
99
+ // Each is tried on its own: a directory we may not chmod still leaves the file to narrow.
100
+ // A failure is ignored, because the next write replaces the file with a 0600 one.
101
+ if (options.privateDirectory !== false) {
102
+ await removeGroupAndOtherAccess(dirname(path), "directory").catch(() => undefined);
103
+ }
104
+ await removeGroupAndOtherAccess(path, "file").catch(() => undefined);
105
+ }
106
+ /** Synchronous {@link restrictExistingPrivateFile}, for readers that cannot await. */
107
+ export function restrictExistingPrivateFileSync(path, options = {}) {
108
+ if (process.platform === "win32") {
109
+ return;
110
+ }
111
+ if (options.privateDirectory !== false) {
112
+ try {
113
+ removeGroupAndOtherAccessSync(dirname(path), "directory");
114
+ }
115
+ catch {
116
+ // Best effort, as in restrictExistingPrivateFile.
117
+ }
118
+ }
119
+ try {
120
+ removeGroupAndOtherAccessSync(path, "file");
121
+ }
122
+ catch {
123
+ // Best effort, as in restrictExistingPrivateFile.
124
+ }
125
+ }
126
+ async function removeGroupAndOtherAccess(path, target) {
127
+ let stats;
128
+ try {
129
+ stats = target === "file" ? await lstat(path) : await stat(path);
130
+ }
131
+ catch (error) {
132
+ if (errorCode(error) === "ENOENT") {
133
+ return;
134
+ }
135
+ throw error;
136
+ }
137
+ const mode = narrowedMode(stats);
138
+ if (mode !== undefined) {
139
+ await chmod(path, mode);
140
+ }
141
+ }
142
+ function removeGroupAndOtherAccessSync(path, target) {
143
+ let stats;
144
+ try {
145
+ stats = target === "file" ? lstatSync(path) : statSync(path);
146
+ }
147
+ catch (error) {
148
+ if (errorCode(error) === "ENOENT") {
149
+ return;
150
+ }
151
+ throw error;
152
+ }
153
+ const mode = narrowedMode(stats);
154
+ if (mode !== undefined) {
155
+ chmodSync(path, mode);
156
+ }
157
+ }
158
+ /** The owner-only mode to set, or undefined when the path should be left alone. */
159
+ function narrowedMode(stats) {
160
+ if (process.platform === "win32") {
161
+ return undefined;
162
+ }
163
+ // chmod follows symbolic links, and a linked file may be one the user keeps elsewhere.
164
+ // A linked directory is still narrowed: it holds the store's files.
165
+ if (stats.isSymbolicLink()) {
166
+ return undefined;
167
+ }
168
+ const { mode, uid } = stats;
169
+ if ((mode & GROUP_AND_OTHER_BITS) === 0) {
170
+ return undefined;
171
+ }
172
+ if (process.getuid !== undefined && uid !== process.getuid()) {
173
+ return undefined;
174
+ }
175
+ return mode & 0o777 & ~GROUP_AND_OTHER_BITS;
176
+ }
177
+ async function renameReplacing(from, to) {
178
+ if (process.platform !== "win32") {
179
+ await rename(from, to);
180
+ return;
181
+ }
182
+ // Windows refuses to replace a file another process holds open without
183
+ // delete sharing (an indexer, antivirus); that clears quickly.
184
+ for (const wait of WINDOWS_RENAME_RETRY_DELAYS_MS) {
185
+ try {
186
+ await rename(from, to);
187
+ return;
188
+ }
189
+ catch (error) {
190
+ const code = errorCode(error);
191
+ if (code === undefined || !WINDOWS_TRANSIENT_RENAME_CODES.has(code)) {
192
+ throw error;
193
+ }
194
+ await sleep(wait);
195
+ }
196
+ }
197
+ await rename(from, to);
198
+ }
199
+ function ignoreUnsupportedMode(error) {
200
+ const code = errorCode(error);
201
+ if (process.platform === "win32" || (code !== undefined && UNSUPPORTED_MODE_CODES.has(code))) {
202
+ return;
203
+ }
204
+ throw error;
205
+ }
206
+ function errorCode(error) {
207
+ return error instanceof Error && "code" in error && typeof error.code === "string"
208
+ ? error.code
209
+ : undefined;
8
210
  }
@@ -0,0 +1,3 @@
1
+ /** Replace values under secret-looking keys before tool arguments are shown in a chat card. */
2
+ export declare function redactSensitiveValues(value: unknown): unknown;
3
+ //# sourceMappingURL=redact-values.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"redact-values.d.ts","sourceRoot":"","sources":["../../src/internal/redact-values.ts"],"names":[],"mappings":"AAIA,+FAA+F;AAC/F,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAe7D"}
@@ -0,0 +1,19 @@
1
+ const REDACTED = "[REDACTED]";
2
+ const SENSITIVE_KEY = /(?:pass(?:word|wd)?|secret|token|api[_-]?key|authorization|credential|private[_-]?key|access[_-]?key)/i;
3
+ /** Replace values under secret-looking keys before tool arguments are shown in a chat card. */
4
+ export function redactSensitiveValues(value) {
5
+ if (value === null || value === undefined) {
6
+ return value;
7
+ }
8
+ if (Array.isArray(value)) {
9
+ return value.map((item) => redactSensitiveValues(item));
10
+ }
11
+ if (typeof value === "object") {
12
+ const out = {};
13
+ for (const [key, nested] of Object.entries(value)) {
14
+ out[key] = SENSITIVE_KEY.test(key) ? REDACTED : redactSensitiveValues(nested);
15
+ }
16
+ return out;
17
+ }
18
+ return value;
19
+ }
@@ -9,7 +9,7 @@
9
9
  *
10
10
  * Not part of the public package API — keep behind the internal boundary.
11
11
  */
12
- import type { JsonObject, ReminderBusyPolicy, ReminderScheduleKind } from "../types.js";
12
+ import type { JsonObject, ReminderBusyPolicy, ReminderScheduleKind, ReminderStatus } from "../types.js";
13
13
  import type { ReminderRecord } from "./reminder-store.js";
14
14
  /** Wire / persistence version for this control-plane protocol. */
15
15
  export declare const REMINDER_CP_PROTOCOL_VERSION: 1;
@@ -138,10 +138,16 @@ export interface ReminderControlPlane {
138
138
  * applied before that page so a keyed read is not hidden by older rows.
139
139
  */
140
140
  listReminders(filter?: {
141
+ status?: ReminderStatus;
141
142
  purpose?: string;
142
143
  continuationToken?: string;
143
144
  }): Promise<ReminderRecord[]>;
144
145
  cancelReminder(id: string, reason?: string): Promise<ReminderRecord | undefined>;
146
+ /**
147
+ * Move an armed reminder's next fire to now. A reminder that is not armed,
148
+ * or is already due, is returned unchanged; an unknown id returns undefined.
149
+ */
150
+ fireReminderNow(id: string): Promise<ReminderRecord | undefined>;
145
151
  /**
146
152
  * Re-key armed (and in-flight) reminders for a continuation rotation.
147
153
  * Bumps generation so an in-flight outcome cannot land on the old token.
@@ -1 +1 @@
1
- {"version":3,"file":"reminder-control-plane-protocol.d.ts","sourceRoot":"","sources":["../../src/internal/reminder-control-plane-protocol.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"reminder-control-plane-protocol.d.ts","sourceRoot":"","sources":["../../src/internal/reminder-control-plane-protocol.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,23 @@
1
+ /**
2
+ * Why a reminder fire's `followup` reached no session. Each reason means the
3
+ * wake message was not sent, so no turn started from it.
4
+ *
5
+ * - `restore_failed`: reading the session back from durable storage threw.
6
+ * - `session_gone`: no session exists for the continuation, on the pod or in
7
+ * durable storage.
8
+ * - `session_unreadable`: durable storage has the session, but the pod could
9
+ * not read it back.
10
+ * - `session_busy`: the session refused the message because a turn was
11
+ * running.
12
+ */
13
+ export type ReminderFollowupNotSentReason = "restore_failed" | "session_gone" | "session_unreadable" | "session_busy";
14
+ /**
15
+ * Thrown by `fire.followup` when the wake message was not sent. A handler can
16
+ * fire again later without a double wake. Any other error from `followup`
17
+ * can come after the message started a turn.
18
+ */
19
+ export declare class ReminderFollowupNotSentError extends Error {
20
+ readonly reason: ReminderFollowupNotSentReason;
21
+ constructor(reason: ReminderFollowupNotSentReason, message: string, options?: ErrorOptions);
22
+ }
23
+ //# sourceMappingURL=reminder-followup-error.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"reminder-followup-error.d.ts","sourceRoot":"","sources":["../../src/internal/reminder-followup-error.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,MAAM,MAAM,6BAA6B,GACrC,gBAAgB,GAChB,cAAc,GACd,oBAAoB,GACpB,cAAc,CAAC;AAEnB;;;;GAIG;AACH,qBAAa,4BAA6B,SAAQ,KAAK;IACrD,QAAQ,CAAC,MAAM,EAAE,6BAA6B,CAAC;IAE/C,YAAY,MAAM,EAAE,6BAA6B,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY,EAIzF;CACF"}
@@ -0,0 +1,12 @@
1
+ /**
2
+ * Thrown by `fire.followup` when the wake message was not sent. A handler can
3
+ * fire again later without a double wake. Any other error from `followup`
4
+ * can come after the message started a turn.
5
+ */
6
+ export class ReminderFollowupNotSentError extends Error {
7
+ constructor(reason, message, options) {
8
+ super(message, options);
9
+ this.name = "ReminderFollowupNotSentError";
10
+ this.reason = reason;
11
+ }
12
+ }
@@ -3,7 +3,7 @@
3
3
  * prompt XOR named handler XOR run, every/cron/delay/at schedules, and
4
4
  * until as function XOR prompt.
5
5
  */
6
- import type { AuthContext, DiscoveredReminder, ReminderCreateInput, ReminderInfo, ReminderStatus } from "../types.js";
6
+ import type { AuthContext, DiscoveredReminder, JsonObject, ReminderCreateInput, ReminderInfo, ReminderStatus } from "../types.js";
7
7
  import type { PlatformTimers } from "./platform-timers.js";
8
8
  import { type ReminderControlPlane, type ReminderExecutionOutcome, type ReminderFireDescriptor } from "./reminder-control-plane-protocol.js";
9
9
  import { type SessionEngine } from "./session-engine.js";
@@ -135,12 +135,26 @@ export declare class ReminderRunner {
135
135
  */
136
136
  private recordsForList;
137
137
  stop(): void;
138
+ /** Validate a create input and resolve its handler, as `create` does before it writes. */
139
+ private validateCreate;
140
+ /**
141
+ * The control-plane create request for `input`, validated as `create`
142
+ * validates it, without creating the reminder. Off the control-plane
143
+ * protocol there is no such request.
144
+ */
145
+ createRequest(input: ReminderCreateInput): Promise<JsonObject>;
146
+ private createIntent;
138
147
  create(input: ReminderCreateInput): Promise<ReminderInfo>;
139
148
  list(filter?: {
140
149
  status?: ReminderStatus;
141
150
  purpose?: string;
142
151
  continuationToken?: string;
143
152
  }): Promise<ReminderInfo[]>;
153
+ /**
154
+ * Fire an armed reminder as soon as the control plane can. Without the CP
155
+ * protocol the reminder fires in the background in this process.
156
+ */
157
+ fireNow(id: string): Promise<ReminderInfo | undefined>;
144
158
  cancel(id: string, reason?: string): Promise<ReminderInfo | undefined>;
145
159
  /** Cancel armed and firing reminders for one continuation. */
146
160
  cancelForContinuation(continuationToken: string, reason: string): Promise<number>;
@@ -1 +1 @@
1
- {"version":3,"file":"reminder-runner.d.ts","sourceRoot":"","sources":["../../src/internal/reminder-runner.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"reminder-runner.d.ts","sourceRoot":"","sources":["../../src/internal/reminder-runner.ts"],"names":[],"mappings":"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"}
@@ -12,6 +12,7 @@ import { continuationSource, isOneShotContinuationKey } from "./continuation-ide
12
12
  import { NAME_PATTERN } from "./discovery/names.js";
13
13
  import { parseDuration } from "./duration.js";
14
14
  import { REMINDER_CP_PROTOCOL_VERSION, scheduleSpecFromCreateInput, toWireReschedule, } from "./reminder-control-plane-protocol.js";
15
+ import { ReminderFollowupNotSentError } from "./reminder-followup-error.js";
15
16
  import { defaultBusyPolicy, MAX_TIMER_MS, nextCronFireMs, ReminderValidationError, resolveSchedule, } from "./reminder-schedule.js";
16
17
  import { APP_AUTH } from "./schedule-runner.js";
17
18
  import { HTTP_CHANNEL_ID, SessionAuthError, SessionBusyError, } from "./session-engine.js";
@@ -317,6 +318,7 @@ export class ReminderRunner {
317
318
  (filter?.purpose !== undefined || filter?.continuationToken !== undefined)) {
318
319
  try {
319
320
  const remote = await this.controlPlane.listReminders({
321
+ status: filter.status,
320
322
  ...(filter.purpose === undefined ? {} : { purpose: filter.purpose }),
321
323
  ...(filter.continuationToken === undefined
322
324
  ? {}
@@ -343,7 +345,8 @@ export class ReminderRunner {
343
345
  this.timers.clear();
344
346
  this.idleGates.clear();
345
347
  }
346
- async create(input) {
348
+ /** Validate a create input and resolve its handler, as `create` does before it writes. */
349
+ validateCreate(input) {
347
350
  const hasPrompt = input.prompt !== undefined;
348
351
  const hasRun = input.run !== undefined;
349
352
  const hasHandler = input.handler !== undefined;
@@ -405,28 +408,52 @@ export class ReminderRunner {
405
408
  else if (input.args !== undefined) {
406
409
  throw new ReminderValidationError("reminders.create args is only valid with handler");
407
410
  }
411
+ return { handlerName, handlerArgs, untilPrompt, untilFn };
412
+ }
413
+ /**
414
+ * The control-plane create request for `input`, validated as `create`
415
+ * validates it, without creating the reminder. Off the control-plane
416
+ * protocol there is no such request.
417
+ */
418
+ async createRequest(input) {
419
+ if (!this.usesControlPlaneProtocol) {
420
+ throw new ReminderValidationError("reminders.createRequest needs the reminder control-plane protocol");
421
+ }
422
+ const request = JSON.parse(JSON.stringify(this.createIntent(input, this.validateCreate(input))));
423
+ if (!isJsonObject(request)) {
424
+ throw new ReminderValidationError("reminders.createRequest built no JSON object");
425
+ }
426
+ return request;
427
+ }
428
+ createIntent(input, validated) {
429
+ const schedule = resolveSchedule(input);
430
+ return {
431
+ protocolVersion: REMINDER_CP_PROTOCOL_VERSION,
432
+ purpose: input.purpose,
433
+ channelId: input.channelId,
434
+ continuationToken: input.continuationToken,
435
+ target: input.target,
436
+ // CP recalculates nextFireAtMs / intervalMs from the raw schedule.
437
+ schedule: scheduleSpecFromCreateInput(input),
438
+ prompt: input.prompt,
439
+ handler: validated.handlerName,
440
+ args: validated.handlerArgs,
441
+ hasRunHandler: input.run !== undefined,
442
+ hasUntilFn: validated.untilFn !== undefined,
443
+ untilPrompt: validated.untilPrompt,
444
+ busyPolicy: input.busyPolicy ?? defaultBusyPolicy(schedule.kind),
445
+ };
446
+ }
447
+ async create(input) {
448
+ const validated = this.validateCreate(input);
449
+ const { handlerName, handlerArgs, untilPrompt, untilFn } = validated;
408
450
  const schedule = resolveSchedule(input);
409
451
  const busyPolicy = input.busyPolicy ?? defaultBusyPolicy(schedule.kind);
410
452
  const hasRunHandler = input.run !== undefined;
411
453
  const hasUntilFn = untilFn !== undefined;
412
454
  let record;
413
455
  if (this.usesControlPlaneProtocol) {
414
- const intent = {
415
- protocolVersion: REMINDER_CP_PROTOCOL_VERSION,
416
- purpose: input.purpose,
417
- channelId: input.channelId,
418
- continuationToken: input.continuationToken,
419
- target: input.target,
420
- // CP recalculates nextFireAtMs / intervalMs from the raw schedule.
421
- schedule: scheduleSpecFromCreateInput(input),
422
- prompt: input.prompt,
423
- handler: handlerName,
424
- args: handlerArgs,
425
- hasRunHandler,
426
- hasUntilFn,
427
- untilPrompt,
428
- busyPolicy,
429
- };
456
+ const intent = this.createIntent(input, validated);
430
457
  record = await this.controlPlane.createReminder(intent);
431
458
  this.records.set(record.id, record);
432
459
  }
@@ -499,6 +526,30 @@ export class ReminderRunner {
499
526
  };
500
527
  });
501
528
  }
529
+ /**
530
+ * Fire an armed reminder as soon as the control plane can. Without the CP
531
+ * protocol the reminder fires in the background in this process.
532
+ */
533
+ async fireNow(id) {
534
+ if (!this.usesControlPlaneProtocol) {
535
+ const record = await this.getRecord(id);
536
+ if (record === undefined) {
537
+ return undefined;
538
+ }
539
+ if (record.status === "armed") {
540
+ this.engine.trackBackground(this.fire(id, { force: true }).catch((error) => {
541
+ this.logger(`[bdk] reminder "${id}" fire-now failed: ${error instanceof Error ? error.message : String(error)}`);
542
+ }));
543
+ }
544
+ return toInfo(record);
545
+ }
546
+ const updated = await this.controlPlane.fireReminderNow(id);
547
+ if (updated === undefined) {
548
+ return undefined;
549
+ }
550
+ this.records.set(id, updated);
551
+ return toInfo(updated);
552
+ }
502
553
  async cancel(id, reason = "explicit_cancel") {
503
554
  if (this.usesControlPlaneProtocol) {
504
555
  const updated = await this.controlPlane.cancelReminder(id, reason);
@@ -580,6 +631,15 @@ export class ReminderRunner {
580
631
  reason: "stale_fire_count",
581
632
  };
582
633
  }
634
+ if (this.usesControlPlaneProtocol) {
635
+ if (record.status !== "armed") {
636
+ return { reminderId, outcome: "noop", reason: "not_armed" };
637
+ }
638
+ const requested = await this.fireNow(record.id);
639
+ return requested === undefined
640
+ ? { reminderId, outcome: "noop", reason: "not_found" }
641
+ : { reminderId, outcome: "fired" };
642
+ }
583
643
  const result = await this.fire(record.id, { force: true });
584
644
  return { reminderId, ...result };
585
645
  }
@@ -1025,6 +1085,9 @@ export class ReminderRunner {
1025
1085
  * outcome is applied, and `delivered` must mean the turn ran.
1026
1086
  */
1027
1087
  async settleFollowup(session, settle) {
1088
+ if (settle !== undefined) {
1089
+ settle.sent = true;
1090
+ }
1028
1091
  const completion = this.engine.waitForCompletion(session.id);
1029
1092
  if (this.hostedGuest === undefined) {
1030
1093
  this.engine.trackBackground(completion);
@@ -1091,7 +1154,13 @@ export class ReminderRunner {
1091
1154
  appAuth: APP_AUTH,
1092
1155
  artifacts: this.engine.artifacts,
1093
1156
  async followup(args) {
1094
- const target = await self.resolveFollowupTarget(record);
1157
+ let target;
1158
+ try {
1159
+ target = await self.resolveFollowupTarget(record);
1160
+ }
1161
+ catch (error) {
1162
+ throw new ReminderFollowupNotSentError("restore_failed", `Reminder "${record.id}" followup: session restore failed`, { cause: error });
1163
+ }
1095
1164
  let address = target.auth === undefined ? undefined : target;
1096
1165
  // `openAuth` opens only when nothing exists anywhere: an unreadable
1097
1166
  // durable session must not be shadowed by a second one on the same
@@ -1107,11 +1176,16 @@ export class ReminderRunner {
1107
1176
  if (!self.usesControlPlaneProtocol) {
1108
1177
  await self.disarm(record, "session_gone");
1109
1178
  }
1110
- throw new Error(`Reminder "${record.id}" followup: session gone for continuation`);
1179
+ throw new ReminderFollowupNotSentError(target.reached === "session_unreadable" ? "session_unreadable" : "session_gone", `Reminder "${record.id}" followup: session gone for continuation`);
1111
1180
  }
1112
- const result = await self.sendFollowup(record, args.message, address, undefined, args);
1181
+ const settle = {};
1182
+ const result = await self.sendFollowup(record, args.message, address, settle, args);
1113
1183
  if (result.action === "skip") {
1114
- throw new Error(`Reminder "${record.id}" followup skipped: session busy`);
1184
+ // A send that the engine accepted can fail while it settles. Its
1185
+ // turn may have started, so only an unsent message is safe to retry.
1186
+ throw settle.sent === true
1187
+ ? new Error(`Reminder "${record.id}" followup failed after it was sent`)
1188
+ : new ReminderFollowupNotSentError("session_busy", `Reminder "${record.id}" followup skipped: session busy`);
1115
1189
  }
1116
1190
  const existing = await self.boundSession(record);
1117
1191
  if (existing === undefined) {
@@ -1 +1 @@
1
- {"version":3,"file":"resolved-connections.d.ts","sourceRoot":"","sources":["../../src/internal/resolved-connections.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,KAAK,YAAY,EAAkC,MAAM,aAAa,CAAC;AAChF,OAAO,EACL,KAAK,0BAA0B,EAC/B,KAAK,sBAAsB,EAE5B,MAAM,yBAAyB,CAAC;AACjC,OAAO,EACL,KAAK,iBAAiB,EAGvB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,qBAAqB,CAAC;AAEpE,+EAA+E;AAC/E,wBAAgB,8BAA8B,CAAC,IAAI,EAAE;IACnD,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,YAAY,CAAC;IACtB,WAAW,CAAC,EAAE,0BAA0B,EAAE,CAAC;IAC3C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;;;OAKG;IACH,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B,GAAG,IAAI,CA0BP;AAED,qEAAqE;AACrE,wBAAgB,wCAAwC,CAAC,IAAI,EAAE;IAC7D,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC;IAC3B,mBAAmB,EAAE,SAAS,wBAAwB,EAAE,CAAC;IACzD;;;;OAIG;IACH,YAAY,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;CACpC,GAAG,IAAI,CAoBP;AAED,iFAAiF;AACjF,wBAAgB,oCAAoC,CAAC,IAAI,EAAE;IACzD,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB;;;;OAIG;IACH,8BAA8B,CAAC,EAAE,OAAO,CAAC;IACzC,qBAAqB,EAAE,OAAO,CAAC;CAChC,GAAG,IAAI,CAUP;AAED,wBAAgB,uBAAuB,CAAC,IAAI,EAAE;IAC5C,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,YAAY,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,iBAAiB,EAAE,CAAC;IAC/B,WAAW,CAAC,EAAE,0BAA0B,EAAE,CAAC;IAC3C,aAAa,CAAC,EAAE,sBAAsB,CAAC;IACvC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,+EAA+E;IAC/E,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,kDAAkD;IAClD,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CAChC,GAAG,wBAAwB,EAAE,CAmE7B"}
1
+ {"version":3,"file":"resolved-connections.d.ts","sourceRoot":"","sources":["../../src/internal/resolved-connections.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,KAAK,YAAY,EAAkC,MAAM,aAAa,CAAC;AAChF,OAAO,EACL,KAAK,0BAA0B,EAC/B,KAAK,sBAAsB,EAE5B,MAAM,yBAAyB,CAAC;AACjC,OAAO,EACL,KAAK,iBAAiB,EAGvB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,qBAAqB,CAAC;AAEpE,+EAA+E;AAC/E,wBAAgB,8BAA8B,CAAC,IAAI,EAAE;IACnD,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,YAAY,CAAC;IACtB,WAAW,CAAC,EAAE,0BAA0B,EAAE,CAAC;IAC3C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;;;OAKG;IACH,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B,GAAG,IAAI,CAsCP;AAED,qEAAqE;AACrE,wBAAgB,wCAAwC,CAAC,IAAI,EAAE;IAC7D,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC;IAC3B,mBAAmB,EAAE,SAAS,wBAAwB,EAAE,CAAC;IACzD;;;;OAIG;IACH,YAAY,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;CACpC,GAAG,IAAI,CAkCP;AAED,iFAAiF;AACjF,wBAAgB,oCAAoC,CAAC,IAAI,EAAE;IACzD,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB;;;;OAIG;IACH,8BAA8B,CAAC,EAAE,OAAO,CAAC;IACzC,qBAAqB,EAAE,OAAO,CAAC;CAChC,GAAG,IAAI,CAUP;AAED,wBAAgB,uBAAuB,CAAC,IAAI,EAAE;IAC5C,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,YAAY,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,iBAAiB,EAAE,CAAC;IAC/B,WAAW,CAAC,EAAE,0BAA0B,EAAE,CAAC;IAC3C,aAAa,CAAC,EAAE,sBAAsB,CAAC;IACvC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,+EAA+E;IAC/E,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,kDAAkD;IAClD,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CAChC,GAAG,wBAAwB,EAAE,CAqE7B"}
@@ -17,12 +17,22 @@ export function validateMountConnectionsConfig(args) {
17
17
  }
18
18
  const agent = args.project.agent;
19
19
  const cloudCapable = agent.runtime === "cloud" || agent.cloud !== undefined;
20
- if (!cloudCapable || args.publicUrl !== undefined || args.cloudToolsBridge === true) {
20
+ if (!cloudCapable || args.publicUrl !== undefined) {
21
21
  return;
22
22
  }
23
23
  const label = args.slug === "" ? args.project.name : args.slug;
24
24
  const hostConnectionNames = new Set((args.project.agent.hostConnections ?? []).map((connection) => connection.name));
25
- const filteredRefs = args.accountRefs.filter((ref) => ref.servers !== undefined && !hostConnectionNames.has(ref.name));
25
+ const turnRefs = args.accountRefs.filter((ref) => !hostConnectionNames.has(ref.name));
26
+ const individualRefs = turnRefs.filter((ref) => ref.credentials === "individual");
27
+ if (individualRefs.length > 0) {
28
+ throw new Error(`[bdk] agent "${label}" has Cursor account MCP connections with individual credentials (${individualRefs
29
+ .map((ref) => ref.name)
30
+ .join(", ")}) but no --public-url; cloud-runtime turns reach them as the turn's user only through the public account bridge, which carries each session's own bearer. Set --public-url.`);
31
+ }
32
+ if (args.cloudToolsBridge === true) {
33
+ return;
34
+ }
35
+ const filteredRefs = turnRefs.filter((ref) => ref.servers !== undefined);
26
36
  if (filteredRefs.length === 0) {
27
37
  return;
28
38
  }
@@ -35,6 +45,14 @@ export function assertCloudCanHonorAccountServersFilters(args) {
35
45
  if (args.runtime !== "cloud") {
36
46
  return;
37
47
  }
48
+ // The host connection bridge authenticates the deployment, not the
49
+ // session, so it never carries an individual connection.
50
+ const individual = args.resolvedConnections.filter((connection) => connection.individualCredentials === true && connection.cloudUrl === undefined);
51
+ if (individual.length > 0) {
52
+ throw new Error(`[bdk] cloud turn cannot run Cursor account connections with individual credentials (${individual
53
+ .map((connection) => connection.name)
54
+ .join(", ")}) as the turn's user without --public-url; set --public-url so cloud turns reach the account bridge with their session's bearer.`);
55
+ }
38
56
  const blocked = args.resolvedConnections.filter((connection) => connection.accountServersFilter !== undefined &&
39
57
  connection.cloudUrl === undefined &&
40
58
  args.bridgedNames?.has(connection.name) !== true);
@@ -89,11 +107,13 @@ export function resolveMountConnections(args) {
89
107
  }
90
108
  }
91
109
  if (args.accountRefs !== undefined && args.accountBridge !== undefined) {
110
+ const bridge = args.accountBridge;
92
111
  resolved.push(...resolveCursorAccountConnections({
93
112
  refs: args.accountRefs,
94
113
  serverUrl: args.serverUrl,
95
114
  basePath: args.slug === "" ? "" : `/${args.slug}`,
96
- bridgeSecret: args.accountBridge.secret,
115
+ bridgeSecret: bridge.secret,
116
+ sessionBearer: (sessionId) => bridge.sessionBearer(sessionId),
97
117
  ...(args.publicUrl === undefined ? {} : { publicUrl: args.publicUrl }),
98
118
  }));
99
119
  // Non-blocking startup DX: connector statuses land in the serve log.
@@ -175,7 +175,8 @@ class TurnEvents {
175
175
  return;
176
176
  }
177
177
  this.events.push(event);
178
- if (event.type === "action.approval_requested" || event.type === "action.auth_requested") {
178
+ if (event.type === "action.approval_requested" ||
179
+ (event.type === "action.auth_requested" && event.data.privateTo === undefined)) {
179
180
  this.asks.add(event.data.callId);
180
181
  }
181
182
  else if (event.type === "action.approval_resolved" || event.type === "action.auth_resolved") {