@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
@@ -1,5 +1,5 @@
1
1
  /**
2
- * The one launch path: channel gate, v1 launch with the mount's model,
2
+ * The one launch path: channel gate, launch with the mount's model,
3
3
  * principal binding, and the stop watch. `cloud__launch` calls it with the
4
4
  * mount's repositories; an authored tool can call it with its own
5
5
  * `cloud` target (a named saved environment, say) and its own `model` after
@@ -12,18 +12,34 @@ import { type CloudAgentInfo, type CloudAgentLaunch, type CloudAgentLaunchTarget
12
12
  export type CloudAgentLaunchResult = CloudAgentLaunch & {
13
13
  watching: boolean;
14
14
  };
15
+ /**
16
+ * On Cursor hosting with the host's own key, one platform call arms the stop
17
+ * watch and launches with the agent's status webhook. Every other launch goes
18
+ * straight to the Cloud Agents API, with no webhook and no watch.
19
+ *
20
+ * A launch with the same `agentId` as an earlier launch by this principal
21
+ * through this extension returns that agent; the API answers 409 and no
22
+ * second agent starts. A 409 for any other agent is refused.
23
+ */
15
24
  export declare function launchCloudAgent(ctx: ToolContext, request: {
16
25
  prompt: string;
17
26
  name?: string;
18
27
  cloud: CloudAgentLaunchTarget;
19
28
  /** Overrides the mount's model for this launch only. */
20
29
  model?: ModelSetting;
30
+ /**
31
+ * A `bc-<uuid>` to launch the agent under; one is generated when omitted.
32
+ * Pass the same id again to retry a launch that timed out or failed.
33
+ * Not allowed with `cloud.envVars`.
34
+ */
35
+ agentId?: string;
21
36
  }): Promise<CloudAgentLaunchResult>;
22
37
  /**
23
38
  * Queue a follow-up on an agent this principal launched, with the same
24
- * channel gate and ownership check as `cloud__reply`, then watch the agent
25
- * again: the launch's stop watch ends at the first stop, so without this the
26
- * conversation is never woken when the follow-up run stops.
39
+ * channel gate and ownership check as `cloud__reply`. When the launch
40
+ * registered the status webhook, arm a new stop watch first: the launch's
41
+ * watch ends at the first stop, and a follow-up run that stops at once must
42
+ * find the new one.
27
43
  */
28
44
  export declare function followUpCloudAgent(ctx: ToolContext, request: {
29
45
  agentId: string;
@@ -35,9 +51,10 @@ export declare function followUpCloudAgent(ctx: ToolContext, request: {
35
51
  }>;
36
52
  /**
37
53
  * One agent's status, branch, pull request, summary, and error under the
38
- * mount's API key. Unlike `cloud__get` there is no principal check, so pass
39
- * only ids authored code launched (a reminder that reports its own launch's
40
- * outcome), never an id a model chose.
54
+ * mount's API key, plus its `result` (its latest run's final answer) once it
55
+ * stopped. Unlike `cloud__get` there is no principal check, so pass only ids
56
+ * authored code launched (a reminder that reports its own launch's outcome),
57
+ * never an id a model chose.
41
58
  */
42
59
  export declare function getCloudAgent(agentId: string): Promise<CloudAgentInfo>;
43
60
  /** A saved environment by public id under the mount's API key; undefined when not visible. */
@@ -1 +1 @@
1
- {"version":3,"file":"launch-agent.d.ts","sourceRoot":"","sources":["../../../../src/extensions/cursor-cloud-agents/lib/launch-agent.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEnE,OAAO,EACL,KAAK,cAAc,EACnB,KAAK,gBAAgB,EACrB,KAAK,sBAAsB,EAC3B,KAAK,gBAAgB,EAEtB,MAAM,cAAc,CAAC;AAKtB,MAAM,MAAM,sBAAsB,GAAG,gBAAgB,GAAG;IAAE,QAAQ,EAAE,OAAO,CAAA;CAAE,CAAC;AAE9E,wBAAsB,gBAAgB,CACpC,GAAG,EAAE,WAAW,EAChB,OAAO,EAAE;IACP,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,sBAAsB,CAAC;IAC9B,wDAAwD;IACxD,KAAK,CAAC,EAAE,YAAY,CAAC;CACtB,GACA,OAAO,CAAC,sBAAsB,CAAC,CAUjC;AAED;;;;;GAKG;AACH,wBAAsB,kBAAkB,CACtC,GAAG,EAAE,WAAW,EAChB,OAAO,EAAE;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,OAAO,CAAA;CAAE,GAChE,OAAO,CAAC;IAAE,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC;IAAC,QAAQ,EAAE,OAAO,CAAA;CAAE,CAAC,CAgB3D;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,CAEtE;AAED,8FAA8F;AAC9F,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,GAAG,SAAS,CAAC,CAE3F;AAED,uEAAuE;AACvE,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAEpF"}
1
+ {"version":3,"file":"launch-agent.d.ts","sourceRoot":"","sources":["../../../../src/extensions/cursor-cloud-agents/lib/launch-agent.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEnE,OAAO,EACL,KAAK,cAAc,EACnB,KAAK,gBAAgB,EACrB,KAAK,sBAAsB,EAC3B,KAAK,gBAAgB,EAKtB,MAAM,cAAc,CAAC;AAMtB,MAAM,MAAM,sBAAsB,GAAG,gBAAgB,GAAG;IAAE,QAAQ,EAAE,OAAO,CAAA;CAAE,CAAC;AAE9E;;;;;;;;GAQG;AACH,wBAAsB,gBAAgB,CACpC,GAAG,EAAE,WAAW,EAChB,OAAO,EAAE;IACP,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,sBAAsB,CAAC;IAC9B,wDAAwD;IACxD,KAAK,CAAC,EAAE,YAAY,CAAC;IACrB;;;;OAIG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,GACA,OAAO,CAAC,sBAAsB,CAAC,CAgFjC;AA2DD;;;;;;GAMG;AACH,wBAAsB,kBAAkB,CACtC,GAAG,EAAE,WAAW,EAChB,OAAO,EAAE;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,OAAO,CAAA;CAAE,GAChE,OAAO,CAAC;IAAE,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC;IAAC,QAAQ,EAAE,OAAO,CAAA;CAAE,CAAC,CAsB3D;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,CAEtE;AAED,8FAA8F;AAC9F,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,GAAG,SAAS,CAAC,CAE3F;AAED,uEAAuE;AACvE,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAEpF"}
@@ -1,5 +1,5 @@
1
1
  /**
2
- * The one launch path: channel gate, v1 launch with the mount's model,
2
+ * The one launch path: channel gate, launch with the mount's model,
3
3
  * principal binding, and the stop watch. `cloud__launch` calls it with the
4
4
  * mount's repositories; an authored tool can call it with its own
5
5
  * `cloud` target (a named saved environment, say) and its own `model` after
@@ -7,50 +7,183 @@
7
7
  * mount's `get` / `dump` / `reply` / `cancel` like any other, or with
8
8
  * {@link followUpCloudAgent} from authored code.
9
9
  */
10
- import { cloudAgentUrl } from "../../../internal/cursor/credentials.js";
10
+ import { AGENT_SERVE_PUBLIC_ID_ENV } from "../../../dashboard-session-url.js";
11
+ import { describeError } from "../../../internal/describe-error.js";
11
12
  import extension from "../extension.js";
12
- import { cloudAgentsBackend, } from "./backend.js";
13
+ import { CloudAgentsApiError, cloudAgentsBackend, isStoppedRun, } from "./backend.js";
14
+ import { isCloudAgentId, newCloudAgentId } from "./agent-id.js";
13
15
  import { assertWriteChannel } from "./channels.js";
14
- import { assertOwned, recordLaunch } from "./fleet.js";
15
- import { armWatch } from "./watch.js";
16
+ import { assertOwned, claimAgentId, recordLaunch } from "./fleet.js";
17
+ import { armWatch, isWatched, launchWatch } from "./watch.js";
18
+ /**
19
+ * On Cursor hosting with the host's own key, one platform call arms the stop
20
+ * watch and launches with the agent's status webhook. Every other launch goes
21
+ * straight to the Cloud Agents API, with no webhook and no watch.
22
+ *
23
+ * A launch with the same `agentId` as an earlier launch by this principal
24
+ * through this extension returns that agent; the API answers 409 and no
25
+ * second agent starts. A 409 for any other agent is refused.
26
+ */
16
27
  export async function launchCloudAgent(ctx, request) {
17
28
  assertWriteChannel(ctx);
18
- const launched = await cloudAgentsBackend().launch({
29
+ const backend = cloudAgentsBackend();
30
+ const launchRequest = {
19
31
  prompt: request.prompt,
20
32
  name: request.name,
21
33
  model: request.model ?? extension.config.model,
22
34
  cloud: request.cloud,
23
- });
24
- await recordLaunch(ctx, launched.agentId, request.name);
25
- return { ...launched, watching: await armWatch(ctx, launched) };
35
+ };
36
+ // The API refuses a client-chosen agent id together with envVars.
37
+ if (request.cloud.envVars !== undefined) {
38
+ if (request.agentId !== undefined) {
39
+ throw new Error("A launch with `cloud.envVars` cannot take an `agentId`.");
40
+ }
41
+ const launched = await backend.launch(launchRequest);
42
+ await recordLaunch(ctx, launched.agentId, request.name, { webhook: false });
43
+ return { ...launched, watching: false };
44
+ }
45
+ if (request.agentId !== undefined && !isCloudAgentId(request.agentId)) {
46
+ throw new Error(`Agent id ${request.agentId} is not a bc-<uuid>.`);
47
+ }
48
+ const agentId = request.agentId ?? newCloudAgentId();
49
+ const claim = await claimAgentId(ctx, agentId);
50
+ // An earlier launch of this id, in this call or before it, may have created the agent.
51
+ let mayExist = claim.earlier;
52
+ let sent = false;
53
+ let refused = false;
54
+ const adopt = async () => {
55
+ const { launch, createdAt } = await backend.existingLaunch(agentId);
56
+ // Keep the claim, so a retry still compares against the first claim time.
57
+ if (claim.claimedAt !== undefined && !createdSince(createdAt, claim.claimedAt)) {
58
+ throw alreadyExists(agentId);
59
+ }
60
+ // For a new claim, only this call's route attempt can have created the agent.
61
+ const webhook = claim.webhook || !claim.earlier;
62
+ await recordLaunch(ctx, agentId, request.name, { webhook });
63
+ return { ...launch, watching: webhook ? await isWatched(ctx, agentId) : false };
64
+ };
65
+ try {
66
+ const watch = onCursorHostingWithHostKey() ? await launchWatch(ctx, agentId) : undefined;
67
+ if (watch !== undefined) {
68
+ sent = true;
69
+ try {
70
+ const watched = await backend.launchWithWatch({ ...launchRequest, agentId }, watch);
71
+ await recordLaunch(ctx, agentId, request.name, { webhook: true });
72
+ return { ...watched.launch, watching: watched.reminderId !== undefined };
73
+ }
74
+ catch (error) {
75
+ refused = isRefusal(error);
76
+ if (isConflict(error) && mayExist) {
77
+ return await adopt();
78
+ }
79
+ if (!platformUnavailable(error)) {
80
+ throw error;
81
+ }
82
+ console.warn(`[cursor-cloud-agents] launching ${agentId} directly: the platform launch failed: ${describeError(error)}`);
83
+ mayExist ||= !refused;
84
+ }
85
+ }
86
+ sent = true;
87
+ try {
88
+ const launched = await backend.launch({ ...launchRequest, agentId });
89
+ await recordLaunch(ctx, agentId, request.name, { webhook: false });
90
+ return { ...launched, watching: false };
91
+ }
92
+ catch (error) {
93
+ refused = isRefusal(error);
94
+ if (!(isConflict(error) && mayExist)) {
95
+ throw error;
96
+ }
97
+ }
98
+ return await adopt();
99
+ }
100
+ catch (error) {
101
+ // Keep the claim while an agent this call launched may exist.
102
+ if (mayExist || (sent && !refused)) {
103
+ throw error;
104
+ }
105
+ await claim.release();
106
+ throw isConflict(error) ? alreadyExists(agentId) : error;
107
+ }
108
+ }
109
+ /** Pod and API clocks can differ by this much. */
110
+ const CLOCK_SKEW_MS = 60_000;
111
+ /** The API created the agent at or after the claim, so no earlier agent holds the id. */
112
+ function createdSince(createdAt, claimedAt) {
113
+ return createdAt !== undefined && Date.parse(createdAt) >= claimedAt - CLOCK_SKEW_MS;
114
+ }
115
+ function alreadyExists(agentId) {
116
+ return new Error(`Agent ${agentId} already exists and was not launched through this extension by this principal.`);
117
+ }
118
+ function isConflict(error) {
119
+ return error instanceof CloudAgentsApiError && error.status === 409;
120
+ }
121
+ /** A 4xx answer: this request created no agent. */
122
+ function isRefusal(error) {
123
+ return (error instanceof CloudAgentsApiError &&
124
+ error.status !== undefined &&
125
+ error.status >= 400 &&
126
+ error.status < 500);
127
+ }
128
+ /**
129
+ * The route is off (404), failed (5xx), or unreachable (no status: connection,
130
+ * DNS, TLS, or timeout). Any other status is the Cloud Agents API's own answer.
131
+ */
132
+ function platformUnavailable(error) {
133
+ if (!(error instanceof CloudAgentsApiError)) {
134
+ return false;
135
+ }
136
+ return error.status === undefined || error.status === 404 || error.status >= 500;
137
+ }
138
+ /** The run before a follow-up, so a late webhook for its stop does not end the new watch. */
139
+ async function latestRunOf(agentId) {
140
+ try {
141
+ return await cloudAgentsBackend().latestRun(agentId);
142
+ }
143
+ catch (error) {
144
+ console.warn(`[cursor-cloud-agents] could not read the latest run of ${agentId}: ${describeError(error)}`);
145
+ return undefined;
146
+ }
147
+ }
148
+ function onCursorHostingWithHostKey() {
149
+ return (process.env[AGENT_SERVE_PUBLIC_ID_ENV] !== undefined && extension.config.apiKey === undefined);
26
150
  }
27
151
  /**
28
152
  * Queue a follow-up on an agent this principal launched, with the same
29
- * channel gate and ownership check as `cloud__reply`, then watch the agent
30
- * again: the launch's stop watch ends at the first stop, so without this the
31
- * conversation is never woken when the follow-up run stops.
153
+ * channel gate and ownership check as `cloud__reply`. When the launch
154
+ * registered the status webhook, arm a new stop watch first: the launch's
155
+ * watch ends at the first stop, and a follow-up run that stops at once must
156
+ * find the new one.
32
157
  */
33
158
  export async function followUpCloudAgent(ctx, request) {
34
159
  const { agentId, prompt } = request;
35
160
  assertWriteChannel(ctx);
36
- await assertOwned(ctx, agentId);
37
- const { runId } = await cloudAgentsBackend().followUp(agentId, prompt, request.interrupt === true);
38
- const watching = await armWatch(ctx, {
39
- agentId,
40
- runId: runId ?? "",
41
- status: "running",
42
- url: cloudAgentUrl(agentId),
43
- });
44
- return { runId, watching };
161
+ const launch = await assertOwned(ctx, agentId);
162
+ const previous = launch.webhook ? await latestRunOf(agentId) : undefined;
163
+ const watching = launch.webhook
164
+ ? await armWatch(ctx, agentId, { previousRunId: previous?.id })
165
+ : false;
166
+ try {
167
+ const { runId } = await cloudAgentsBackend().followUp(agentId, prompt, request.interrupt === true);
168
+ return { runId, watching };
169
+ }
170
+ catch (error) {
171
+ // The new watch would skip the stop of the run that is still going.
172
+ if (watching && previous !== undefined && !isStoppedRun(previous.status)) {
173
+ await armWatch(ctx, agentId, { replace: true });
174
+ }
175
+ throw error;
176
+ }
45
177
  }
46
178
  /**
47
179
  * One agent's status, branch, pull request, summary, and error under the
48
- * mount's API key. Unlike `cloud__get` there is no principal check, so pass
49
- * only ids authored code launched (a reminder that reports its own launch's
50
- * outcome), never an id a model chose.
180
+ * mount's API key, plus its `result` (its latest run's final answer) once it
181
+ * stopped. Unlike `cloud__get` there is no principal check, so pass only ids
182
+ * authored code launched (a reminder that reports its own launch's outcome),
183
+ * never an id a model chose.
51
184
  */
52
185
  export function getCloudAgent(agentId) {
53
- return cloudAgentsBackend().info(agentId);
186
+ return cloudAgentsBackend().infoWithResult(agentId);
54
187
  }
55
188
  /** A saved environment by public id under the mount's API key; undefined when not visible. */
56
189
  export function getCloudEnvironment(publicId) {
@@ -0,0 +1,18 @@
1
+ /**
2
+ * The stop status a signed status webhook carried, saved by the channel so
3
+ * the watch it fires can wake without reading a status that may lag.
4
+ */
5
+ import type { HostKvApi } from "../../../types.js";
6
+ import type { CloudAgentStatus } from "./backend.js";
7
+ export type StopSignal = {
8
+ status: CloudAgentStatus;
9
+ at: string;
10
+ };
11
+ /** Save `status` when it is a stop; other statuses leave the last stop in place. */
12
+ export declare function saveStopSignal(kv: HostKvApi, agentId: string, webhook: {
13
+ status: string;
14
+ timestamp: string;
15
+ }): Promise<void>;
16
+ /** The saved stop of `agentId` at or after `since`, or undefined. */
17
+ export declare function readStopSignal(kv: HostKvApi, agentId: string, since: number): Promise<StopSignal | undefined>;
18
+ //# sourceMappingURL=stop-signal.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"stop-signal.d.ts","sourceRoot":"","sources":["../../../../src/extensions/cursor-cloud-agents/lib/stop-signal.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAErD,MAAM,MAAM,UAAU,GAAG;IAAE,MAAM,EAAE,gBAAgB,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,CAAC;AAWlE,oFAAoF;AACpF,wBAAsB,cAAc,CAClC,EAAE,EAAE,SAAS,EACb,OAAO,EAAE,MAAM,EACf,OAAO,EAAE;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GAC7C,OAAO,CAAC,IAAI,CAAC,CAQf;AAED,qEAAqE;AACrE,wBAAsB,cAAc,CAClC,EAAE,EAAE,SAAS,EACb,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,UAAU,GAAG,SAAS,CAAC,CAGjC"}
@@ -0,0 +1,27 @@
1
+ /**
2
+ * The stop status a signed status webhook carried, saved by the channel so
3
+ * the watch it fires can wake without reading a status that may lag.
4
+ */
5
+ import * as z from "zod/v4";
6
+ const stopSignal = z.object({
7
+ status: z.enum(["finished", "error", "expired"]),
8
+ at: z.string().datetime(),
9
+ });
10
+ function stopSignalKey(agentId) {
11
+ return `cloud-agents/stops/${agentId}`;
12
+ }
13
+ /** Save `status` when it is a stop; other statuses leave the last stop in place. */
14
+ export async function saveStopSignal(kv, agentId, webhook) {
15
+ const signal = stopSignal.safeParse({
16
+ status: webhook.status.toLowerCase(),
17
+ at: webhook.timestamp,
18
+ });
19
+ if (signal.success) {
20
+ await kv.put(stopSignalKey(agentId), signal.data);
21
+ }
22
+ }
23
+ /** The saved stop of `agentId` at or after `since`, or undefined. */
24
+ export async function readStopSignal(kv, agentId, since) {
25
+ const saved = stopSignal.safeParse(await kv.get(stopSignalKey(agentId)));
26
+ return saved.success && Date.parse(saved.data.at) >= since ? saved.data : undefined;
27
+ }
@@ -1 +1 @@
1
- {"version":3,"file":"transcript.d.ts","sourceRoot":"","sources":["../../../../src/extensions/cursor-cloud-agents/lib/transcript.ts"],"names":[],"mappings":"AAAA,yEAAyE;AAEzE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAEtD,mFAAmF;AACnF,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAEtD;AAED,wBAAgB,eAAe,CAAC,QAAQ,EAAE,iBAAiB,EAAE,GAAG,MAAM,EAAE,CAEvE;AAED,kEAAkE;AAClE,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,iBAAiB,EAAE,GAAG,MAAM,GAAG,SAAS,CAInF"}
1
+ {"version":3,"file":"transcript.d.ts","sourceRoot":"","sources":["../../../../src/extensions/cursor-cloud-agents/lib/transcript.ts"],"names":[],"mappings":"AAAA,yEAAyE;AAEzE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAEtD,mFAAmF;AACnF,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAEtD;AAED,wBAAgB,eAAe,CAAC,QAAQ,EAAE,iBAAiB,EAAE,GAAG,MAAM,EAAE,CAEvE;AAED,kEAAkE;AAClE,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,iBAAiB,EAAE,GAAG,MAAM,GAAG,SAAS,CAGnF"}
@@ -8,7 +8,6 @@ export function transcriptLines(messages) {
8
8
  }
9
9
  /** The text of the last assistant message, the agent's report. */
10
10
  export function lastAssistantText(messages) {
11
- return messages
12
- .toReversed()
13
- .find((message) => message.role === "assistant" && message.text !== undefined)?.text;
11
+ return messages.findLast((message) => message.role === "assistant" && message.text !== undefined)
12
+ ?.text;
14
13
  }
@@ -1,17 +1,31 @@
1
1
  /**
2
- * Arming the stop watch (`reminders/cloud-agent-stop-watch.ts`): one reminder
3
- * per launched agent, bound to the session whose turn launched it, so the
4
- * host wakes that conversation once the launched run stops.
2
+ * The stop watch (`reminders/cloud-agent-stop-watch.ts`): one one-shot
3
+ * reminder per watched agent, bound to the session whose turn launched it.
4
+ * The agent's status webhook fires it early, so the host wakes that
5
+ * conversation once the agent's run stops. Nothing polls the agent.
5
6
  */
6
- import type { ToolContext } from "../../../types.js";
7
- import type { CloudAgentLaunch } from "./backend.js";
7
+ import type { ReminderHostApi, ToolContext } from "../../../types.js";
8
+ import type { LaunchWatch } from "./backend.js";
8
9
  /**
9
- * Watch a launched agent from this conversation unless it already does.
10
- * False when the mount opted out, the run already stopped, the host has no
11
- * reminders, the session has no continuation key, or arming failed; the
12
- * agent runs either way.
10
+ * The stop watch the platform arms in the same call as the launch, and the
11
+ * channel the agent's status webhook targets. Undefined when this session
12
+ * cannot be watched: see {@link watchInput}.
13
13
  */
14
- export declare function armWatch(ctx: ToolContext, launch: CloudAgentLaunch): Promise<boolean>;
15
- /** End every watch on `agentId`, whose run was stopped on purpose. */
16
- export declare function disarmWatches(ctx: ToolContext, agentId: string): Promise<void>;
14
+ export declare function launchWatch(ctx: ToolContext, agentId: string): Promise<LaunchWatch | undefined>;
15
+ /**
16
+ * Watch `agentId` from this conversation unless it already does. A follow-up
17
+ * passes the run before it, and its watch replaces this conversation's
18
+ * earlier watch on the agent; `replace` does the same with no run. False when this session cannot be watched (see
19
+ * {@link watchInput}) or arming failed; the agent runs either way.
20
+ */
21
+ export declare function armWatch(ctx: ToolContext, agentId: string, options?: {
22
+ previousRunId?: string;
23
+ replace?: boolean;
24
+ }): Promise<boolean>;
25
+ /** Some watch on `agentId` is armed. */
26
+ export declare function isWatched(ctx: ToolContext, agentId: string): Promise<boolean>;
27
+ /** End every watch on `agentId`, whose run was stopped on purpose or never launched. */
28
+ export declare function disarmWatches(ctx: ToolContext, agentId: string, reason?: string): Promise<void>;
29
+ /** Fire every armed watch on `agentId` now; its run just stopped. */
30
+ export declare function fireWatches(reminders: ReminderHostApi, agentId: string): Promise<number>;
17
31
  //# sourceMappingURL=watch.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"watch.d.ts","sourceRoot":"","sources":["../../../../src/extensions/cursor-cloud-agents/lib/watch.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAgB,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAMnE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAerD;;;;;GAKG;AACH,wBAAsB,QAAQ,CAAC,GAAG,EAAE,WAAW,EAAE,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAAC,OAAO,CAAC,CA2C3F;AAED,sEAAsE;AACtE,wBAAsB,aAAa,CAAC,GAAG,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAgBpF"}
1
+ {"version":3,"file":"watch.d.ts","sourceRoot":"","sources":["../../../../src/extensions/cursor-cloud-agents/lib/watch.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAEV,eAAe,EAEf,WAAW,EACZ,MAAM,mBAAmB,CAAC;AAM3B,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAOhD;;;;GAIG;AACH,wBAAsB,WAAW,CAC/B,GAAG,EAAE,WAAW,EAChB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,WAAW,GAAG,SAAS,CAAC,CAalC;AAED;;;;;GAKG;AACH,wBAAsB,QAAQ,CAC5B,GAAG,EAAE,WAAW,EAChB,OAAO,EAAE,MAAM,EACf,OAAO,GAAE;IAAE,aAAa,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,OAAO,CAAA;CAAO,GAC1D,OAAO,CAAC,OAAO,CAAC,CAiClB;AA0CD,wCAAwC;AACxC,wBAAsB,SAAS,CAAC,GAAG,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAcnF;AAED,wFAAwF;AACxF,wBAAsB,aAAa,CACjC,GAAG,EAAE,WAAW,EAChB,OAAO,EAAE,MAAM,EACf,MAAM,SAA0B,GAC/B,OAAO,CAAC,IAAI,CAAC,CAgBf;AAED,qEAAqE;AACrE,wBAAsB,WAAW,CAAC,SAAS,EAAE,eAAe,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAY9F"}
@@ -1,61 +1,67 @@
1
1
  /**
2
- * Arming the stop watch (`reminders/cloud-agent-stop-watch.ts`): one reminder
3
- * per launched agent, bound to the session whose turn launched it, so the
4
- * host wakes that conversation once the launched run stops.
2
+ * The stop watch (`reminders/cloud-agent-stop-watch.ts`): one one-shot
3
+ * reminder per watched agent, bound to the session whose turn launched it.
4
+ * The agent's status webhook fires it early, so the host wakes that
5
+ * conversation once the agent's run stops. Nothing polls the agent.
5
6
  */
6
7
  import { describeError } from "../../../internal/describe-error.js";
7
8
  import extension from "../extension.js";
8
9
  import stopWatch, { WATCH_WINDOW_HOURS, } from "../reminders/cloud-agent-stop-watch.js";
9
10
  const WATCH_PURPOSE = "cloud_agent_stop_watch";
10
- /** The shortest recurring interval every reminder control plane accepts. */
11
- const POLL_INTERVAL = "1m";
12
- /** Cloud Agents API run statuses of a launch whose run already stopped. */
13
- const STOPPED_RUN_STATUSES = new Set([
14
- "finished",
15
- "error",
16
- "cancelled",
17
- "expired",
18
- ]);
11
+ /** `channels/cursor-cloud-agents.ts`, which the mount exposes as `<ns>__cursor-cloud-agents`. */
12
+ const STOP_WEBHOOK_CHANNEL = "cursor-cloud-agents";
19
13
  /**
20
- * Watch a launched agent from this conversation unless it already does.
21
- * False when the mount opted out, the run already stopped, the host has no
22
- * reminders, the session has no continuation key, or arming failed; the
23
- * agent runs either way.
14
+ * The stop watch the platform arms in the same call as the launch, and the
15
+ * channel the agent's status webhook targets. Undefined when this session
16
+ * cannot be watched: see {@link watchInput}.
24
17
  */
25
- export async function armWatch(ctx, launch) {
18
+ export async function launchWatch(ctx, agentId) {
26
19
  const reminders = ctx.host.reminders;
27
- const continuationToken = ctx.session.continuationKey;
28
- if (!extension.config.watchStops ||
29
- STOPPED_RUN_STATUSES.has(launch.status) ||
30
- reminders === undefined ||
31
- continuationToken == null) {
20
+ if (reminders?.createRequest === undefined) {
21
+ return undefined;
22
+ }
23
+ const input = watchInput(ctx, agentId);
24
+ if (input === undefined) {
25
+ return undefined;
26
+ }
27
+ return {
28
+ watch: await reminders.createRequest(input),
29
+ channel: `${extension.namespace}__${STOP_WEBHOOK_CHANNEL}`,
30
+ };
31
+ }
32
+ /**
33
+ * Watch `agentId` from this conversation unless it already does. A follow-up
34
+ * passes the run before it, and its watch replaces this conversation's
35
+ * earlier watch on the agent; `replace` does the same with no run. False when this session cannot be watched (see
36
+ * {@link watchInput}) or arming failed; the agent runs either way.
37
+ */
38
+ export async function armWatch(ctx, agentId, options = {}) {
39
+ const { previousRunId } = options;
40
+ const replace = options.replace ?? previousRunId !== undefined;
41
+ const reminders = ctx.host.reminders;
42
+ const input = watchInput(ctx, agentId, previousRunId);
43
+ if (reminders === undefined || input === undefined) {
32
44
  return false;
33
45
  }
34
- const { agentId } = launch;
35
- const { channelId } = ctx.session;
36
46
  try {
37
- const armed = await reminders.list({
47
+ const armed = (await reminders.list({
38
48
  status: "armed",
39
49
  purpose: WATCH_PURPOSE,
40
- continuationToken,
41
- });
42
- if (armed.some((reminder) => reminder.channelId === channelId && watched(reminder) === agentId)) {
43
- return true;
50
+ continuationToken: input.continuationToken,
51
+ })).filter((reminder) => reminder.channelId === input.channelId && watched(reminder) === agentId);
52
+ if (!replace) {
53
+ if (armed.length > 0) {
54
+ return true;
55
+ }
44
56
  }
45
- const args = {
46
- agentId,
47
- deadline: new Date(Date.now() + WATCH_WINDOW_HOURS * 3_600_000).toISOString(),
48
- };
49
- await reminders.create({
50
- purpose: WATCH_PURPOSE,
51
- channelId,
52
- continuationToken,
53
- handler: stopWatch,
54
- args,
55
- every: POLL_INTERVAL,
56
- // A fire during a turn waits for it instead of skipping to the next poll.
57
- busyPolicy: "queueBehindTurn",
58
- });
57
+ else {
58
+ // A watch from before the follow-up would wake on a late webhook for
59
+ // the run before it, and then miss the follow-up run's stop.
60
+ for (const reminder of armed) {
61
+ await reminders.cancel(reminder.id, "cloud_agent_followed_up");
62
+ }
63
+ }
64
+ await reminders.create(input);
59
65
  return true;
60
66
  }
61
67
  catch (error) {
@@ -63,8 +69,57 @@ export async function armWatch(ctx, launch) {
63
69
  return false;
64
70
  }
65
71
  }
66
- /** End every watch on `agentId`, whose run was stopped on purpose. */
67
- export async function disarmWatches(ctx, agentId) {
72
+ /**
73
+ * The one-shot watch on `agentId` for this session, at its deadline. Undefined
74
+ * when the mount opted out, the host has no reminders, or the session has no
75
+ * continuation key.
76
+ */
77
+ function watchInput(ctx, agentId, previousRunId) {
78
+ if (!extension.config.watchStops) {
79
+ return undefined;
80
+ }
81
+ const unwatched = (reason) => {
82
+ console.warn(`[cursor-cloud-agents] not watching ${agentId}: ${reason}`);
83
+ return undefined;
84
+ };
85
+ if (ctx.host.reminders === undefined) {
86
+ return unwatched("this host has no reminders");
87
+ }
88
+ const continuationToken = ctx.session.continuationKey;
89
+ if (continuationToken == null) {
90
+ return unwatched("the session has no continuation key");
91
+ }
92
+ const deadline = new Date(Date.now() + WATCH_WINDOW_HOURS * 3_600_000).toISOString();
93
+ // Reminder args are JSON, so a missing previous run leaves the key out.
94
+ const args = previousRunId === undefined ? { agentId, deadline } : { agentId, deadline, previousRunId };
95
+ return {
96
+ purpose: WATCH_PURPOSE,
97
+ channelId: ctx.session.channelId,
98
+ continuationToken,
99
+ handler: stopWatch,
100
+ args,
101
+ at: deadline,
102
+ // A fire during a turn waits for it instead of losing the wake.
103
+ busyPolicy: "queueBehindTurn",
104
+ };
105
+ }
106
+ /** Some watch on `agentId` is armed. */
107
+ export async function isWatched(ctx, agentId) {
108
+ const reminders = ctx.host.reminders;
109
+ if (reminders === undefined) {
110
+ return false;
111
+ }
112
+ try {
113
+ const armed = await reminders.list({ status: "armed", purpose: WATCH_PURPOSE });
114
+ return armed.some((reminder) => watched(reminder) === agentId);
115
+ }
116
+ catch (error) {
117
+ console.warn(`[cursor-cloud-agents] could not read the watch on ${agentId}: ${describeError(error)}`);
118
+ return false;
119
+ }
120
+ }
121
+ /** End every watch on `agentId`, whose run was stopped on purpose or never launched. */
122
+ export async function disarmWatches(ctx, agentId, reason = "cloud_agent_cancelled") {
68
123
  const reminders = ctx.host.reminders;
69
124
  if (reminders === undefined) {
70
125
  return;
@@ -72,7 +127,7 @@ export async function disarmWatches(ctx, agentId) {
72
127
  try {
73
128
  for (const reminder of await reminders.list({ status: "armed", purpose: WATCH_PURPOSE })) {
74
129
  if (watched(reminder) === agentId) {
75
- await reminders.cancel(reminder.id, "cloud_agent_cancelled");
130
+ await reminders.cancel(reminder.id, reason);
76
131
  }
77
132
  }
78
133
  }
@@ -80,6 +135,20 @@ export async function disarmWatches(ctx, agentId) {
80
135
  console.warn(`[cursor-cloud-agents] could not stop watching ${agentId}: ${describeError(error)}`);
81
136
  }
82
137
  }
138
+ /** Fire every armed watch on `agentId` now; its run just stopped. */
139
+ export async function fireWatches(reminders, agentId) {
140
+ if (reminders.fireNow === undefined) {
141
+ return 0;
142
+ }
143
+ let fired = 0;
144
+ for (const reminder of await reminders.list({ status: "armed", purpose: WATCH_PURPOSE })) {
145
+ if (watched(reminder) === agentId) {
146
+ await reminders.fireNow(reminder.id);
147
+ fired += 1;
148
+ }
149
+ }
150
+ return fired;
151
+ }
83
152
  function watched(reminder) {
84
153
  return reminder.args?.agentId;
85
154
  }
@@ -1,18 +1,29 @@
1
1
  /**
2
- * The stop watch on one launched cloud agent, armed by `lib/watch.ts`. Every
3
- * fire is host-only: it polls the agent and skips while the agent runs, so
4
- * no model turn starts. The first fire that sees the agent stopped wakes the
5
- * bound conversation once and ends the watch.
2
+ * The stop watch on one launched cloud agent: a one-shot reminder at its
3
+ * deadline. The agent's status webhook (`channels/cursor-cloud-agents.ts`)
4
+ * fires it early, when the agent's run stops. Every fire is host-only, so no
5
+ * model turn starts until the one wake.
6
+ *
7
+ * - An early fire on a stopped agent wakes the bound conversation once, with
8
+ * how the latest run ended, and ends the watch. The stop the signed webhook
9
+ * saved (`lib/stop-signal.ts`) counts without a status read.
10
+ * - An early fire on an agent that still runs (a replayed or early webhook)
11
+ * keeps the watch until the deadline.
12
+ * - A wake that was not sent, or a status read that failed, tries again in a
13
+ * minute, at most 10 times.
14
+ * - The deadline fire stops with no read and no wake.
6
15
  *
7
16
  * A fire never throws, because a v1 host stops firing a reminder whose
8
17
  * handler threw; every outcome is a skip or a stop.
9
18
  */
10
19
  import type { ReminderDefinition } from "../../../types.js";
11
- /** How long a watch polls before it stops without a wake. */
20
+ /** How long a watch waits for the agent's webhook before it stops without a wake. */
12
21
  export declare const WATCH_WINDOW_HOURS = 24;
13
22
  export type WatchArgs = {
14
23
  agentId: string;
15
24
  deadline: string;
25
+ /** The agent's latest run when a follow-up armed this watch; its stop is not this watch's. */
26
+ previousRunId?: string;
16
27
  };
17
28
  declare const watch: ReminderDefinition;
18
29
  export default watch;