@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
@@ -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") {
@@ -0,0 +1,31 @@
1
+ export interface ProgramOutput {
2
+ code: number | null;
3
+ stdout: string;
4
+ stderr: string;
5
+ timedOut: boolean;
6
+ }
7
+ export interface RunProgramOptions {
8
+ timeoutMs: number;
9
+ signal?: AbortSignal;
10
+ /** Start a Windows `.cmd` program through the host shell. Ignored on other platforms. */
11
+ windowsShell?: boolean;
12
+ platform?: NodeJS.Platform;
13
+ }
14
+ export interface ProgramExecPlan {
15
+ file: string;
16
+ args: readonly string[];
17
+ windowsVerbatimArguments: boolean;
18
+ }
19
+ export declare function programTreeKill(pid: number, platform: NodeJS.Platform): {
20
+ file: string;
21
+ args: readonly string[];
22
+ } | {
23
+ pid: number;
24
+ signal: NodeJS.Signals;
25
+ };
26
+ export declare function programExecPlan(command: string, args: readonly string[], options: {
27
+ windowsShell?: boolean;
28
+ platform?: NodeJS.Platform;
29
+ }): ProgramExecPlan;
30
+ export declare function runProgram(command: string, args: readonly string[], options: RunProgramOptions): Promise<ProgramOutput>;
31
+ //# sourceMappingURL=run-program.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"run-program.d.ts","sourceRoot":"","sources":["../../src/internal/run-program.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,iBAAiB;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,yFAAyF;IACzF,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,EAAE,MAAM,CAAC,QAAQ,CAAC;CAC5B;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,SAAS,MAAM,EAAE,CAAC;IACxB,wBAAwB,EAAE,OAAO,CAAC;CACnC;AAuBD,wBAAgB,eAAe,CAC7B,GAAG,EAAE,MAAM,EACX,QAAQ,EAAE,MAAM,CAAC,QAAQ,GACxB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,SAAS,MAAM,EAAE,CAAA;CAAE,GAAG;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC,OAAO,CAAA;CAAE,CAKrF;AAyCD,wBAAgB,eAAe,CAC7B,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,SAAS,MAAM,EAAE,EACvB,OAAO,EAAE;IAAE,YAAY,CAAC,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,QAAQ,CAAA;CAAE,GAC9D,eAAe,CAYjB;AAED,wBAAsB,UAAU,CAC9B,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,SAAS,MAAM,EAAE,EACvB,OAAO,EAAE,iBAAiB,GACzB,OAAO,CAAC,aAAa,CAAC,CAkExB"}
@@ -0,0 +1,150 @@
1
+ import { spawn } from "node:child_process";
2
+ const UNSAFE_WINDOWS_ARGUMENT = /["%!^&|<>\r\n]/;
3
+ function quoteCmd(arg) {
4
+ if (UNSAFE_WINDOWS_ARGUMENT.test(arg)) {
5
+ throw new Error(`unsafe Windows argument: ${arg}`);
6
+ }
7
+ if (arg === "" || /[\t ()]/.test(arg)) {
8
+ return `"${arg}"`;
9
+ }
10
+ return arg;
11
+ }
12
+ function isErrno(error, code) {
13
+ return (typeof error === "object" &&
14
+ error !== null &&
15
+ "code" in error &&
16
+ error.code === code);
17
+ }
18
+ export function programTreeKill(pid, platform) {
19
+ if (platform === "win32") {
20
+ return { file: "taskkill", args: ["/pid", String(pid), "/T", "/F"] };
21
+ }
22
+ return { pid: -pid, signal: "SIGTERM" };
23
+ }
24
+ function killProgramTree(child) {
25
+ const pid = child.pid;
26
+ if (pid === undefined) {
27
+ child.kill("SIGTERM");
28
+ return;
29
+ }
30
+ const plan = programTreeKill(pid, process.platform);
31
+ if ("file" in plan) {
32
+ const killer = spawn(plan.file, [...plan.args], { windowsHide: true, stdio: "ignore" });
33
+ killer.unref();
34
+ killer.once("error", () => {
35
+ child.kill("SIGTERM");
36
+ });
37
+ return;
38
+ }
39
+ try {
40
+ process.kill(plan.pid, plan.signal);
41
+ }
42
+ catch (error) {
43
+ if (isErrno(error, "ESRCH") && !processAlive(pid)) {
44
+ return;
45
+ }
46
+ child.kill("SIGTERM");
47
+ }
48
+ }
49
+ function processAlive(pid) {
50
+ try {
51
+ process.kill(pid, 0);
52
+ return true;
53
+ }
54
+ catch (error) {
55
+ return !isErrno(error, "ESRCH");
56
+ }
57
+ }
58
+ function shellRequired(options) {
59
+ const platform = options.platform ?? process.platform;
60
+ return options.windowsShell === true && platform === "win32";
61
+ }
62
+ export function programExecPlan(command, args, options) {
63
+ if (!shellRequired(options)) {
64
+ return { file: command, args, windowsVerbatimArguments: false };
65
+ }
66
+ // cmd.exe /s strips one outer pair of quotes, so quote the line and wrap it
67
+ // once. cmd.exe passes %% through unchanged, so refuse metacharacters.
68
+ const line = [command, ...args].map((arg) => quoteCmd(arg)).join(" ");
69
+ return {
70
+ file: process.env.ComSpec ?? "cmd.exe",
71
+ args: ["/d", "/s", "/c", `"${line}"`],
72
+ windowsVerbatimArguments: true,
73
+ };
74
+ }
75
+ export async function runProgram(command, args, options) {
76
+ const plan = programExecPlan(command, args, options);
77
+ return new Promise((resolve, reject) => {
78
+ const { signal } = options;
79
+ if (signal?.aborted === true) {
80
+ reject(abortError(signal));
81
+ return;
82
+ }
83
+ let timedOut = false;
84
+ let settled = false;
85
+ const stdoutChunks = [];
86
+ const stderrChunks = [];
87
+ // On Linux and macOS the program runs detached in its own process group, so
88
+ // Ctrl-C does not reach it. A timeout or an abort kills that whole group,
89
+ // which also ends the Python process under `az`.
90
+ const child = spawn(plan.file, [...plan.args], {
91
+ stdio: ["ignore", "pipe", "pipe"],
92
+ windowsHide: true,
93
+ windowsVerbatimArguments: plan.windowsVerbatimArguments,
94
+ detached: process.platform !== "win32",
95
+ });
96
+ const onAbort = () => {
97
+ killProgramTree(child);
98
+ };
99
+ signal?.addEventListener("abort", onAbort, { once: true });
100
+ child.stdout?.setEncoding("utf8");
101
+ child.stderr?.setEncoding("utf8");
102
+ child.stdout?.on("data", (chunk) => {
103
+ stdoutChunks.push(chunk);
104
+ });
105
+ child.stderr?.on("data", (chunk) => {
106
+ stderrChunks.push(chunk);
107
+ });
108
+ const timer = setTimeout(() => {
109
+ timedOut = true;
110
+ killProgramTree(child);
111
+ }, options.timeoutMs);
112
+ const finish = (error, code) => {
113
+ if (settled) {
114
+ return;
115
+ }
116
+ settled = true;
117
+ clearTimeout(timer);
118
+ signal?.removeEventListener("abort", onAbort);
119
+ const stdout = stdoutChunks.join("");
120
+ const stderr = stderrChunks.join("");
121
+ if (signal?.aborted === true) {
122
+ reject(abortError(signal));
123
+ }
124
+ else if (timedOut) {
125
+ resolve({ code: null, stdout, stderr, timedOut: true });
126
+ }
127
+ else if (error !== undefined) {
128
+ reject(error);
129
+ }
130
+ else if (code === null) {
131
+ reject(new Error(`Command failed: ${plan.file} exited on a signal`));
132
+ }
133
+ else {
134
+ resolve({ code, stdout, stderr, timedOut: false });
135
+ }
136
+ };
137
+ child.once("error", (error) => {
138
+ finish(error, null);
139
+ });
140
+ child.once("close", (code) => {
141
+ finish(undefined, code);
142
+ });
143
+ });
144
+ }
145
+ function abortError(signal) {
146
+ return Object.assign(new Error("The operation was aborted", { cause: signal.reason }), {
147
+ name: "AbortError",
148
+ code: "ABORT_ERR",
149
+ });
150
+ }
@@ -5,10 +5,14 @@
5
5
  * settings; cloud agents use Cursor cloud (`bc-…` ids) with optional
6
6
  * `cloud` options from `defineAgent`.
7
7
  */
8
- import { type LocalAgentStore, type ModelSelection, type RunResult } from "@cursor/sdk";
8
+ import { type LocalAgentStore, type ModelSelection, type RunResult, type RunStatus } from "@cursor/sdk";
9
9
  import { type ModelSetting, type RunnerTurnRequest, type TurnOutcome } from "../types.js";
10
10
  import type { ConversationMirror } from "./conversation-mirror.js";
11
- /** Mirrors @cursor/sdk's SteerAckOutcome; the published dist may predate it. */
11
+ /**
12
+ * What the engine does with a steered message: the turn has it, or it goes out as an ordinary
13
+ * follow-up. A message the server queued as its own follow-up run is delivered, since the server
14
+ * owns it from then on, and so is one whose steer failed after it may have reached the server.
15
+ */
12
16
  export type SteerAckOutcome = "complete_delivered" | "revert_to_followup";
13
17
  /** Internal seam between the session engine and the Cursor SDK harness. */
14
18
  export interface AgentRunner {
@@ -127,6 +131,14 @@ export declare class CursorSdkRunner implements AgentRunner {
127
131
  private logModelFallback;
128
132
  private runTurnAttempt;
129
133
  private runTurnOnAgent;
134
+ /**
135
+ * The turn that continues on the cloud agent an earlier attempt at this
136
+ * delivery created, when creating it again was refused because its id is
137
+ * taken. Undefined for any other failure, or when the agent has no run.
138
+ */
139
+ private adoptDeliveryCloudAgent;
140
+ /** The cloud run as the backend reports it now, or undefined when the lookup fails. */
141
+ private fetchCloudRun;
130
142
  steer(request: {
131
143
  sessionId: string;
132
144
  text: string;
@@ -190,6 +202,20 @@ export declare class CursorSdkRunner implements AgentRunner {
190
202
  private persistConversation;
191
203
  private getStore;
192
204
  }
205
+ /**
206
+ * What a retried delivery does with the cloud run an earlier attempt started,
207
+ * given the run's status on the backend: wait on it again, send the turn
208
+ * again, or take how it ended. Only a run that failed is sent again; a
209
+ * cancelled run stays cancelled. An unknown status, including a failed lookup,
210
+ * waits again rather than risk running the turn twice.
211
+ */
212
+ export declare function decideNext(status: RunStatus | undefined): "reattach" | "resend" | "done";
213
+ /**
214
+ * The `bc-<uuid>` cloud agent id for one model attempt at a hosted delivery.
215
+ * A retry of the attempt gets the same id; a fallback model gets its own
216
+ * agent, since a run on an agent keeps that agent's model.
217
+ */
218
+ export declare function cloudAgentIdForDelivery(platformDeliveryId: string, model: ModelSetting | undefined): string;
193
219
  /** Cloud agent ids minted by the server are `bc-…`; those always resume. */
194
220
  export declare function isServerMintedCloudAgentId(id: string): boolean;
195
221
  /**
@@ -1 +1 @@
1
- {"version":3,"file":"sdk-runner.d.ts","sourceRoot":"","sources":["../../src/internal/sdk-runner.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"sdk-runner.d.ts","sourceRoot":"","sources":["../../src/internal/sdk-runner.ts"],"names":[],"mappings":"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"}