@grok/agent-sdk 0.6.0 → 0.7.1

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 (550) hide show
  1. package/AGENTS.md +40 -0
  2. package/dist/channels/github/cursor-account.d.ts +1 -0
  3. package/dist/channels/github/cursor-account.d.ts.map +1 -1
  4. package/dist/channels/github/cursor-account.js +8 -2
  5. package/dist/channels/github/forward.d.ts +5 -0
  6. package/dist/channels/github/forward.d.ts.map +1 -1
  7. package/dist/channels/github/forward.js +6 -3
  8. package/dist/channels/origin/cursor-account.d.ts +6 -0
  9. package/dist/channels/origin/cursor-account.d.ts.map +1 -1
  10. package/dist/channels/origin/cursor-account.js +17 -0
  11. package/dist/channels/slack/api.d.ts +18 -0
  12. package/dist/channels/slack/api.d.ts.map +1 -1
  13. package/dist/channels/slack/api.js +31 -0
  14. package/dist/channels/slack/approvals.d.ts +19 -2
  15. package/dist/channels/slack/approvals.d.ts.map +1 -1
  16. package/dist/channels/slack/approvals.js +90 -19
  17. package/dist/channels/slack/attachments.d.ts +7 -2
  18. package/dist/channels/slack/attachments.d.ts.map +1 -1
  19. package/dist/channels/slack/attachments.js +318 -156
  20. package/dist/channels/slack/connect-card.d.ts +16 -0
  21. package/dist/channels/slack/connect-card.d.ts.map +1 -0
  22. package/dist/channels/slack/connect-card.js +31 -0
  23. package/dist/channels/slack/credentials.d.ts +10 -2
  24. package/dist/channels/slack/credentials.d.ts.map +1 -1
  25. package/dist/channels/slack/credentials.js +17 -15
  26. package/dist/channels/slack/defaults.d.ts.map +1 -1
  27. package/dist/channels/slack/defaults.js +18 -9
  28. package/dist/channels/slack/dispatch.d.ts +1 -1
  29. package/dist/channels/slack/dispatch.d.ts.map +1 -1
  30. package/dist/channels/slack/dispatch.js +19 -3
  31. package/dist/channels/slack/inbound.d.ts +8 -2
  32. package/dist/channels/slack/inbound.d.ts.map +1 -1
  33. package/dist/channels/slack/inbound.js +25 -4
  34. package/dist/channels/slack/index.d.ts +3 -2
  35. package/dist/channels/slack/index.d.ts.map +1 -1
  36. package/dist/channels/slack/index.js +3 -2
  37. package/dist/channels/slack/init.d.ts.map +1 -1
  38. package/dist/channels/slack/init.js +2 -1
  39. package/dist/channels/slack/mentions.d.ts +28 -0
  40. package/dist/channels/slack/mentions.d.ts.map +1 -0
  41. package/dist/channels/slack/mentions.js +178 -0
  42. package/dist/channels/slack/setup.js +1 -1
  43. package/dist/channels/slack/slack-channel.d.ts.map +1 -1
  44. package/dist/channels/slack/slack-channel.js +46 -3
  45. package/dist/channels/slack/stop.d.ts.map +1 -1
  46. package/dist/channels/slack/stop.js +7 -1
  47. package/dist/channels/slack/thread-context.d.ts +3 -0
  48. package/dist/channels/slack/thread-context.d.ts.map +1 -1
  49. package/dist/channels/slack/thread-context.js +17 -7
  50. package/dist/channels/slack/tool-approval-events.d.ts.map +1 -1
  51. package/dist/channels/slack/tool-approval-events.js +55 -2
  52. package/dist/channels/slack/types.d.ts +2 -0
  53. package/dist/channels/slack/types.d.ts.map +1 -1
  54. package/dist/channels/teams/activity.d.ts +33 -0
  55. package/dist/channels/teams/activity.d.ts.map +1 -0
  56. package/dist/channels/teams/activity.js +213 -0
  57. package/dist/channels/teams/auth.d.ts +25 -0
  58. package/dist/channels/teams/auth.d.ts.map +1 -0
  59. package/dist/channels/teams/auth.js +55 -0
  60. package/dist/channels/teams/bot-framework-auth.d.ts +33 -0
  61. package/dist/channels/teams/bot-framework-auth.d.ts.map +1 -0
  62. package/dist/channels/teams/bot-framework-auth.js +154 -0
  63. package/dist/channels/teams/cards.d.ts +23 -0
  64. package/dist/channels/teams/cards.d.ts.map +1 -0
  65. package/dist/channels/teams/cards.js +107 -0
  66. package/dist/channels/teams/connector.d.ts +48 -0
  67. package/dist/channels/teams/connector.d.ts.map +1 -0
  68. package/dist/channels/teams/connector.js +159 -0
  69. package/dist/channels/teams/credentials.d.ts +65 -0
  70. package/dist/channels/teams/credentials.d.ts.map +1 -0
  71. package/dist/channels/teams/credentials.js +84 -0
  72. package/dist/channels/teams/delivery.d.ts +14 -0
  73. package/dist/channels/teams/delivery.d.ts.map +1 -0
  74. package/dist/channels/teams/delivery.js +169 -0
  75. package/dist/channels/teams/dispatch.d.ts +45 -0
  76. package/dist/channels/teams/dispatch.d.ts.map +1 -0
  77. package/dist/channels/teams/dispatch.js +402 -0
  78. package/dist/channels/teams/engagement.d.ts +32 -0
  79. package/dist/channels/teams/engagement.d.ts.map +1 -0
  80. package/dist/channels/teams/engagement.js +120 -0
  81. package/dist/channels/teams/index.d.ts +21 -0
  82. package/dist/channels/teams/index.d.ts.map +1 -0
  83. package/dist/channels/teams/index.js +19 -0
  84. package/dist/channels/teams/marks.d.ts +19 -0
  85. package/dist/channels/teams/marks.d.ts.map +1 -0
  86. package/dist/channels/teams/marks.js +96 -0
  87. package/dist/channels/teams/senders.d.ts +27 -0
  88. package/dist/channels/teams/senders.d.ts.map +1 -0
  89. package/dist/channels/teams/senders.js +72 -0
  90. package/dist/channels/teams/teams-channel.d.ts +43 -0
  91. package/dist/channels/teams/teams-channel.d.ts.map +1 -0
  92. package/dist/channels/teams/teams-channel.js +278 -0
  93. package/dist/channels/teams/text.d.ts +7 -0
  94. package/dist/channels/teams/text.d.ts.map +1 -0
  95. package/dist/channels/teams/text.js +63 -0
  96. package/dist/channels/teams/types.d.ts +306 -0
  97. package/dist/channels/teams/types.d.ts.map +1 -0
  98. package/dist/channels/teams/types.js +1 -0
  99. package/dist/channels.d.ts +31 -0
  100. package/dist/channels.d.ts.map +1 -1
  101. package/dist/channels.js +37 -0
  102. package/dist/connections.d.ts +1 -1
  103. package/dist/connections.d.ts.map +1 -1
  104. package/dist/docs/404.html +3 -3
  105. package/dist/docs/assets/{app.lt-BYgI2.js → app.CpLKJnOA.js} +4 -4
  106. package/dist/docs/assets/changelog.md.DoOgjnPC.js +1 -0
  107. package/dist/docs/assets/{changelog.md.DVNB-ApU.lean.js → changelog.md.DoOgjnPC.lean.js} +1 -1
  108. package/dist/docs/assets/chunks/@localSearchIndexroot.BJ_1eI6D.js +1 -0
  109. package/dist/docs/assets/chunks/{VPLocalSearchBox.v_dV4U2Q.js → VPLocalSearchBox.Cr1HJ_9k.js} +2 -2
  110. package/dist/docs/assets/chunks/{arc.5o92kOg5.js → arc.BjpgGAMM.js} +1 -1
  111. package/dist/docs/assets/chunks/{architectureDiagram-Q4EWVU46.C-oTwnNq.js → architectureDiagram-Q4EWVU46.CKdhNPPk.js} +1 -1
  112. package/dist/docs/assets/chunks/{baseUniq.zJ-VNOib.js → baseUniq.iovoEQbg.js} +1 -1
  113. package/dist/docs/assets/chunks/{blockDiagram-DXYQGD6D.B9ZJZuPd.js → blockDiagram-DXYQGD6D.BYQIeDre.js} +1 -1
  114. package/dist/docs/assets/chunks/{c4Diagram-AHTNJAMY.BBMwSIaN.js → c4Diagram-AHTNJAMY.gbWi2q8N.js} +1 -1
  115. package/dist/docs/assets/chunks/channel.BP0n324b.js +1 -0
  116. package/dist/docs/assets/chunks/{chunk-4BX2VUAB.D8qAJpDD.js → chunk-4BX2VUAB.1Mem4UG9.js} +1 -1
  117. package/dist/docs/assets/chunks/{chunk-4TB4RGXK.B8QR5cdE.js → chunk-4TB4RGXK.Dn3H-X_H.js} +1 -1
  118. package/dist/docs/assets/chunks/{chunk-55IACEB6.BsWxVuew.js → chunk-55IACEB6.BkpSDZwX.js} +1 -1
  119. package/dist/docs/assets/chunks/{chunk-EDXVE4YY.BeGygY_i.js → chunk-EDXVE4YY.BScqy1zP.js} +1 -1
  120. package/dist/docs/assets/chunks/{chunk-FMBD7UC4.DdwgH-ZH.js → chunk-FMBD7UC4.Cp394LWf.js} +1 -1
  121. package/dist/docs/assets/chunks/{chunk-OYMX7WX6.B9zC_ALe.js → chunk-OYMX7WX6.BDv9LhoL.js} +1 -1
  122. package/dist/docs/assets/chunks/{chunk-QZHKN3VN.BIxJ0rcL.js → chunk-QZHKN3VN.CsgCcrKO.js} +1 -1
  123. package/dist/docs/assets/chunks/{chunk-YZCP3GAM.qiM_23_f.js → chunk-YZCP3GAM.BKBpIC5O.js} +1 -1
  124. package/dist/docs/assets/chunks/classDiagram-6PBFFD2Q.BhTtyWMA.js +1 -0
  125. package/dist/docs/assets/chunks/classDiagram-v2-HSJHXN6E.BhTtyWMA.js +1 -0
  126. package/dist/docs/assets/chunks/clone.BVK2rFqj.js +1 -0
  127. package/dist/docs/assets/chunks/{cose-bilkent-S5V4N54A.BKB971D5.js → cose-bilkent-S5V4N54A.Bs3ZS9PC.js} +1 -1
  128. package/dist/docs/assets/chunks/{dagre-KV5264BT.CcILjJgp.js → dagre-KV5264BT.CgWi0tY2.js} +1 -1
  129. package/dist/docs/assets/chunks/{diagram-5BDNPKRD.DkY9A0nu.js → diagram-5BDNPKRD.rn6qIo9N.js} +1 -1
  130. package/dist/docs/assets/chunks/{diagram-G4DWMVQ6.BbdzmjMt.js → diagram-G4DWMVQ6.ChhW8oww.js} +1 -1
  131. package/dist/docs/assets/chunks/{diagram-MMDJMWI5.Be0zy1cM.js → diagram-MMDJMWI5.C0wH5KSk.js} +1 -1
  132. package/dist/docs/assets/chunks/{diagram-TYMM5635.zOiEycLe.js → diagram-TYMM5635.CNEcrwA0.js} +1 -1
  133. package/dist/docs/assets/chunks/{erDiagram-SMLLAGMA.DUd_9HMF.js → erDiagram-SMLLAGMA.DCsnKO-7.js} +1 -1
  134. package/dist/docs/assets/chunks/{flowDiagram-DWJPFMVM.2KPYoZBO.js → flowDiagram-DWJPFMVM.WCMkfvP0.js} +1 -1
  135. package/dist/docs/assets/chunks/{ganttDiagram-T4ZO3ILL.DqE8_YpP.js → ganttDiagram-T4ZO3ILL.BUb1Sxfr.js} +1 -1
  136. package/dist/docs/assets/chunks/{gitGraphDiagram-UUTBAWPF.CO0Tk47h.js → gitGraphDiagram-UUTBAWPF._kORbCzm.js} +1 -1
  137. package/dist/docs/assets/chunks/{graph.CNe5KbNy.js → graph.PrGRm4KW.js} +1 -1
  138. package/dist/docs/assets/chunks/{infoDiagram-42DDH7IO.BBhJ1X1B.js → infoDiagram-42DDH7IO.BxhCjiQM.js} +1 -1
  139. package/dist/docs/assets/chunks/{ishikawaDiagram-UXIWVN3A.KSIw9w3I.js → ishikawaDiagram-UXIWVN3A.5ddTis2y.js} +1 -1
  140. package/dist/docs/assets/chunks/{journeyDiagram-VCZTEJTY.BN2Y5oUJ.js → journeyDiagram-VCZTEJTY.BUStU27-.js} +1 -1
  141. package/dist/docs/assets/chunks/{kanban-definition-6JOO6SKY.2KFuDYn_.js → kanban-definition-6JOO6SKY.CJd1psl3.js} +1 -1
  142. package/dist/docs/assets/chunks/{layout.Demb_pzL.js → layout.DqvbZSML.js} +1 -1
  143. package/dist/docs/assets/chunks/{linear.kYKxzbbR.js → linear.DOmz-1UB.js} +1 -1
  144. package/dist/docs/assets/chunks/{min.DwmCN5dF.js → min.33k2v8dM.js} +1 -1
  145. package/dist/docs/assets/chunks/{mindmap-definition-QFDTVHPH.CGlz01QG.js → mindmap-definition-QFDTVHPH.iISCqCXC.js} +1 -1
  146. package/dist/docs/assets/chunks/{pieDiagram-DEJITSTG.n3qsq4nA.js → pieDiagram-DEJITSTG.BHvVgzmD.js} +1 -1
  147. package/dist/docs/assets/chunks/{quadrantDiagram-34T5L4WZ.CGNJ1GSb.js → quadrantDiagram-34T5L4WZ.CY3w_-Cn.js} +1 -1
  148. package/dist/docs/assets/chunks/{requirementDiagram-MS252O5E.VhAzHDwQ.js → requirementDiagram-MS252O5E.CHXKQS1v.js} +1 -1
  149. package/dist/docs/assets/chunks/{sankeyDiagram-XADWPNL6.DmHA5pW-.js → sankeyDiagram-XADWPNL6.DTtRoGss.js} +1 -1
  150. package/dist/docs/assets/chunks/{sequenceDiagram-FGHM5R23._TC1aKhg.js → sequenceDiagram-FGHM5R23.NnPcQ3eY.js} +1 -1
  151. package/dist/docs/assets/chunks/{stateDiagram-FHFEXIEX.B-kLjV3O.js → stateDiagram-FHFEXIEX.D8DFciH7.js} +1 -1
  152. package/dist/docs/assets/chunks/stateDiagram-v2-QKLJ7IA2.ESAwmMws.js +1 -0
  153. package/dist/docs/assets/chunks/{theme.BaVlHHL-.js → theme.CwkiT-Fo.js} +2 -2
  154. package/dist/docs/assets/chunks/{timeline-definition-GMOUNBTQ.CresbphV.js → timeline-definition-GMOUNBTQ._wIWkMU6.js} +1 -1
  155. package/dist/docs/assets/chunks/{vennDiagram-DHZGUBPP.CegHD8Y4.js → vennDiagram-DHZGUBPP.NLVv7R6r.js} +1 -1
  156. package/dist/docs/assets/chunks/{wardley-RL74JXVD.DjCmZrUO.js → wardley-RL74JXVD.DbsCXUZp.js} +1 -1
  157. package/dist/docs/assets/chunks/{wardleyDiagram-NUSXRM2D.BJ7s1zdZ.js → wardleyDiagram-NUSXRM2D.Dp5uAVDl.js} +1 -1
  158. package/dist/docs/assets/chunks/{xychartDiagram-5P7HB3ND.IrEXlemI.js → xychartDiagram-5P7HB3ND.eOEBq4rX.js} +1 -1
  159. package/dist/docs/assets/{deployment.md.DJtuDVLh.js → deployment.md.CIRydNl3.js} +3 -3
  160. package/dist/docs/assets/{deployment.md.DJtuDVLh.lean.js → deployment.md.CIRydNl3.lean.js} +1 -1
  161. package/dist/docs/assets/guides_cloud-agents.md.BdWqmUGb.js +14 -0
  162. package/dist/docs/assets/{guides_cloud-agents.md.CiXAW6on.lean.js → guides_cloud-agents.md.BdWqmUGb.lean.js} +1 -1
  163. package/dist/docs/assets/guides_teams.md.7Lz2sbqB.js +50 -0
  164. package/dist/docs/assets/guides_teams.md.7Lz2sbqB.lean.js +1 -0
  165. package/dist/docs/assets/guides_workload-identity.md.DBV6YkXX.js +82 -0
  166. package/dist/docs/assets/guides_workload-identity.md.DBV6YkXX.lean.js +1 -0
  167. package/dist/docs/assets/{reference_agent-config.md.Bbqf0lgS.js → reference_agent-config.md.CfM1S6Ac.js} +2 -2
  168. package/dist/docs/assets/{reference_agent-config.md.Bbqf0lgS.lean.js → reference_agent-config.md.CfM1S6Ac.lean.js} +1 -1
  169. package/dist/docs/assets/{reference_channels.md.CPWOpdsC.js → reference_channels.md.CRvqgU0n.js} +1 -1
  170. package/dist/docs/assets/{reference_cli.md.DHm6DmYk.js → reference_cli.md.NS6U5a-7.js} +14 -4
  171. package/dist/docs/assets/{reference_cli.md.DHm6DmYk.lean.js → reference_cli.md.NS6U5a-7.lean.js} +1 -1
  172. package/dist/docs/assets/{reference_limits.md.CbdtFr4T.js → reference_limits.md.CW9PTdxr.js} +3 -3
  173. package/dist/docs/assets/{reference_limits.md.CbdtFr4T.lean.js → reference_limits.md.CW9PTdxr.lean.js} +1 -1
  174. package/dist/docs/assets/{reference_schedules.md.RhQ9ZLo1.js → reference_schedules.md.Dd8_d0WG.js} +3 -3
  175. package/dist/docs/assets/{reference_sessions.md.NXVQt9mP.js → reference_sessions.md.CoCyQLEz.js} +2 -2
  176. package/dist/docs/assets/{reference_sessions.md.NXVQt9mP.lean.js → reference_sessions.md.CoCyQLEz.lean.js} +1 -1
  177. package/dist/docs/assets/{reference_skills.md.DzCPNPkG.js → reference_skills.md.SFRZDC41.js} +4 -4
  178. package/dist/docs/assets/{reference_skills.md.DzCPNPkG.lean.js → reference_skills.md.SFRZDC41.lean.js} +1 -1
  179. package/dist/docs/assets/{style.DK0YX1WL.css → style.B7zPxANR.css} +1 -1
  180. package/dist/docs/assets/troubleshooting.md.CsQTleto.js +3 -0
  181. package/dist/docs/assets/{troubleshooting.md.DfKKvW1R.lean.js → troubleshooting.md.CsQTleto.lean.js} +1 -1
  182. package/dist/docs/building-with-agents.html +37 -37
  183. package/dist/docs/changelog.html +37 -37
  184. package/dist/docs/changelog.md +43 -0
  185. package/dist/docs/deployment.html +40 -40
  186. package/dist/docs/deployment.md +14 -0
  187. package/dist/docs/evals.html +37 -37
  188. package/dist/docs/guides/agent-to-agent.html +37 -37
  189. package/dist/docs/guides/bitbucket.html +37 -37
  190. package/dist/docs/guides/cloud-agents.html +43 -38
  191. package/dist/docs/guides/cloud-agents.md +47 -0
  192. package/dist/docs/guides/convert-automation.html +37 -37
  193. package/dist/docs/guides/github.html +37 -37
  194. package/dist/docs/guides/gitlab.html +37 -37
  195. package/dist/docs/guides/improve.html +37 -37
  196. package/dist/docs/guides/jev.html +37 -37
  197. package/dist/docs/guides/mcp-oauth.html +37 -37
  198. package/dist/docs/guides/migrate.html +37 -37
  199. package/dist/docs/guides/opentelemetry.html +37 -37
  200. package/dist/docs/guides/pagerduty.html +37 -37
  201. package/dist/docs/guides/slack.html +37 -37
  202. package/dist/docs/guides/teams.html +109 -0
  203. package/dist/docs/guides/teams.md +384 -0
  204. package/dist/docs/guides/webhooks.html +37 -37
  205. package/dist/docs/guides/workload-identity.html +141 -0
  206. package/dist/docs/guides/workload-identity.md +227 -0
  207. package/dist/docs/hashmap.json +1 -1
  208. package/dist/docs/hillclimbing.html +37 -37
  209. package/dist/docs/index.html +37 -37
  210. package/dist/docs/llms-full.txt +881 -5
  211. package/dist/docs/llms.txt +2 -0
  212. package/dist/docs/quickstart.html +37 -37
  213. package/dist/docs/reference/access.html +36 -36
  214. package/dist/docs/reference/agent-config.html +39 -39
  215. package/dist/docs/reference/agent-config.md +1 -1
  216. package/dist/docs/reference/artifacts.html +37 -37
  217. package/dist/docs/reference/channels.html +38 -38
  218. package/dist/docs/reference/channels.md +1 -0
  219. package/dist/docs/reference/cli.html +50 -40
  220. package/dist/docs/reference/cli.md +116 -0
  221. package/dist/docs/reference/connections.html +37 -37
  222. package/dist/docs/reference/evals.html +37 -37
  223. package/dist/docs/reference/extensions.html +37 -37
  224. package/dist/docs/reference/hooks.html +37 -37
  225. package/dist/docs/reference/http-api.html +37 -37
  226. package/dist/docs/reference/instructions.html +37 -37
  227. package/dist/docs/reference/limits.html +39 -39
  228. package/dist/docs/reference/limits.md +4 -4
  229. package/dist/docs/reference/memory.html +37 -37
  230. package/dist/docs/reference/playground.html +36 -36
  231. package/dist/docs/reference/project-layout.html +37 -37
  232. package/dist/docs/reference/schedules.html +40 -40
  233. package/dist/docs/reference/sessions.html +38 -38
  234. package/dist/docs/reference/sessions.md +13 -0
  235. package/dist/docs/reference/skills.html +40 -40
  236. package/dist/docs/reference/subagents.html +37 -37
  237. package/dist/docs/reference/tools.html +37 -37
  238. package/dist/docs/templates/agentic-owners.html +37 -37
  239. package/dist/docs/templates/reviews.html +37 -37
  240. package/dist/docs/troubleshooting.html +38 -38
  241. package/dist/docs/troubleshooting.md +21 -0
  242. package/dist/evals/run-facts.d.ts.map +1 -1
  243. package/dist/evals/run-facts.js +4 -0
  244. package/dist/extensions/cursor-cloud-agents/channels/cursor-cloud-agents.d.ts +12 -0
  245. package/dist/extensions/cursor-cloud-agents/channels/cursor-cloud-agents.d.ts.map +1 -0
  246. package/dist/extensions/cursor-cloud-agents/channels/cursor-cloud-agents.js +42 -0
  247. package/dist/extensions/cursor-cloud-agents/extension.d.ts +10 -7
  248. package/dist/extensions/cursor-cloud-agents/extension.d.ts.map +1 -1
  249. package/dist/extensions/cursor-cloud-agents/extension.js +3 -2
  250. package/dist/extensions/cursor-cloud-agents/lib/agent-id.d.ts +5 -0
  251. package/dist/extensions/cursor-cloud-agents/lib/agent-id.d.ts.map +1 -0
  252. package/dist/extensions/cursor-cloud-agents/lib/agent-id.js +10 -0
  253. package/dist/extensions/cursor-cloud-agents/lib/backend.d.ts +57 -3
  254. package/dist/extensions/cursor-cloud-agents/lib/backend.d.ts.map +1 -1
  255. package/dist/extensions/cursor-cloud-agents/lib/backend.js +150 -35
  256. package/dist/extensions/cursor-cloud-agents/lib/fleet.d.ts +32 -4
  257. package/dist/extensions/cursor-cloud-agents/lib/fleet.d.ts.map +1 -1
  258. package/dist/extensions/cursor-cloud-agents/lib/fleet.js +93 -7
  259. package/dist/extensions/cursor-cloud-agents/lib/launch-agent.d.ts +24 -7
  260. package/dist/extensions/cursor-cloud-agents/lib/launch-agent.d.ts.map +1 -1
  261. package/dist/extensions/cursor-cloud-agents/lib/launch-agent.js +158 -25
  262. package/dist/extensions/cursor-cloud-agents/lib/stop-signal.d.ts +18 -0
  263. package/dist/extensions/cursor-cloud-agents/lib/stop-signal.d.ts.map +1 -0
  264. package/dist/extensions/cursor-cloud-agents/lib/stop-signal.js +27 -0
  265. package/dist/extensions/cursor-cloud-agents/lib/transcript.d.ts.map +1 -1
  266. package/dist/extensions/cursor-cloud-agents/lib/transcript.js +2 -3
  267. package/dist/extensions/cursor-cloud-agents/lib/watch.d.ts +26 -12
  268. package/dist/extensions/cursor-cloud-agents/lib/watch.d.ts.map +1 -1
  269. package/dist/extensions/cursor-cloud-agents/lib/watch.js +115 -46
  270. package/dist/extensions/cursor-cloud-agents/reminders/cloud-agent-stop-watch.d.ts +16 -5
  271. package/dist/extensions/cursor-cloud-agents/reminders/cloud-agent-stop-watch.d.ts.map +1 -1
  272. package/dist/extensions/cursor-cloud-agents/reminders/cloud-agent-stop-watch.js +76 -20
  273. package/dist/extensions/cursor-cloud-agents/skills/handoff.md +2 -2
  274. package/dist/extensions/cursor-cloud-agents/tools/get.js +2 -2
  275. package/dist/extensions/cursor-cloud-agents/tools/launch.js +1 -1
  276. package/dist/extensions.d.ts.map +1 -1
  277. package/dist/extensions.js +18 -3
  278. package/dist/files-backends/agent-store-presigned-url.js +5 -1
  279. package/dist/index.d.ts +1 -0
  280. package/dist/index.d.ts.map +1 -1
  281. package/dist/index.js +1 -0
  282. package/dist/internal/approval-gate.d.ts +6 -1
  283. package/dist/internal/approval-gate.d.ts.map +1 -1
  284. package/dist/internal/approval-gate.js +13 -2
  285. package/dist/internal/authored-loaders.js +1 -1
  286. package/dist/internal/channel-architecture.d.ts.map +1 -1
  287. package/dist/internal/channel-architecture.js +3 -1
  288. package/dist/internal/cli/commands/channels.d.ts +9 -3
  289. package/dist/internal/cli/commands/channels.d.ts.map +1 -1
  290. package/dist/internal/cli/commands/channels.js +193 -4
  291. package/dist/internal/cli/commands/index.d.ts.map +1 -1
  292. package/dist/internal/cli/commands/index.js +6 -1
  293. package/dist/internal/cli/commands/serve.d.ts.map +1 -1
  294. package/dist/internal/cli/commands/serve.js +25 -5
  295. package/dist/internal/cli/dispatch.d.ts.map +1 -1
  296. package/dist/internal/cli/dispatch.js +22 -8
  297. package/dist/internal/cli/flags.d.ts +14 -0
  298. package/dist/internal/cli/flags.d.ts.map +1 -1
  299. package/dist/internal/cli/flags.js +14 -0
  300. package/dist/internal/cli/help.d.ts.map +1 -1
  301. package/dist/internal/cli/help.js +3 -1
  302. package/dist/internal/cli-ax.d.ts.map +1 -1
  303. package/dist/internal/cli-ax.js +6 -3
  304. package/dist/internal/cli-cursor.js +2 -2
  305. package/dist/internal/cli-deploy.d.ts +1 -0
  306. package/dist/internal/cli-deploy.d.ts.map +1 -1
  307. package/dist/internal/cli-deploy.js +19 -1
  308. package/dist/internal/cli-mcp.d.ts.map +1 -1
  309. package/dist/internal/cli-mcp.js +5 -3
  310. package/dist/internal/cli-teams-doctor.d.ts +39 -0
  311. package/dist/internal/cli-teams-doctor.d.ts.map +1 -0
  312. package/dist/internal/cli-teams-doctor.js +508 -0
  313. package/dist/internal/cli-teams-forward.d.ts +84 -0
  314. package/dist/internal/cli-teams-forward.d.ts.map +1 -0
  315. package/dist/internal/cli-teams-forward.js +386 -0
  316. package/dist/internal/cli-teams-package.d.ts +26 -0
  317. package/dist/internal/cli-teams-package.d.ts.map +1 -0
  318. package/dist/internal/cli-teams-package.js +123 -0
  319. package/dist/internal/cli-teams.d.ts +15 -0
  320. package/dist/internal/cli-teams.d.ts.map +1 -0
  321. package/dist/internal/cli-teams.js +253 -0
  322. package/dist/internal/connect-click.d.ts +12 -0
  323. package/dist/internal/connect-click.d.ts.map +1 -0
  324. package/dist/internal/connect-click.js +22 -0
  325. package/dist/internal/continuation-channel.d.ts +5 -1
  326. package/dist/internal/continuation-channel.d.ts.map +1 -1
  327. package/dist/internal/continuation-channel.js +34 -0
  328. package/dist/internal/continuation-identity.d.ts +7 -4
  329. package/dist/internal/continuation-identity.d.ts.map +1 -1
  330. package/dist/internal/continuation-identity.js +66 -1
  331. package/dist/internal/convert-automation/convert-workflow.js +2 -2
  332. package/dist/internal/credential-env-names.d.ts +36 -0
  333. package/dist/internal/credential-env-names.d.ts.map +1 -0
  334. package/dist/internal/credential-env-names.js +68 -0
  335. package/dist/internal/cursor/account-mcp.d.ts +67 -9
  336. package/dist/internal/cursor/account-mcp.d.ts.map +1 -1
  337. package/dist/internal/cursor/account-mcp.js +206 -25
  338. package/dist/internal/cursor/backend-client.d.ts +10 -1
  339. package/dist/internal/cursor/backend-client.d.ts.map +1 -1
  340. package/dist/internal/cursor/backend-client.js +19 -7
  341. package/dist/internal/cursor/cloud-agent-identity.d.ts +81 -0
  342. package/dist/internal/cursor/cloud-agent-identity.d.ts.map +1 -0
  343. package/dist/internal/cursor/cloud-agent-identity.js +224 -0
  344. package/dist/internal/cursor/credentials.d.ts.map +1 -1
  345. package/dist/internal/cursor/credentials.js +3 -1
  346. package/dist/internal/cursor-account-mcp-auth.d.ts +8 -1
  347. package/dist/internal/cursor-account-mcp-auth.d.ts.map +1 -1
  348. package/dist/internal/cursor-account-mcp-auth.js +22 -6
  349. package/dist/internal/deploy-client.d.ts.map +1 -1
  350. package/dist/internal/deploy-client.js +34 -2
  351. package/dist/internal/deploy-manifest.d.ts +51 -3
  352. package/dist/internal/deploy-manifest.d.ts.map +1 -1
  353. package/dist/internal/deploy-manifest.js +96 -7
  354. package/dist/internal/discovery/agent-config.d.ts.map +1 -1
  355. package/dist/internal/discovery/agent-config.js +6 -1
  356. package/dist/internal/discovery/agent.d.ts.map +1 -1
  357. package/dist/internal/discovery/agent.js +2 -1
  358. package/dist/internal/discovery/connections.d.ts +5 -0
  359. package/dist/internal/discovery/connections.d.ts.map +1 -1
  360. package/dist/internal/discovery/connections.js +71 -1
  361. package/dist/internal/discovery/extensions.d.ts.map +1 -1
  362. package/dist/internal/discovery/extensions.js +2 -0
  363. package/dist/internal/discovery/info.d.ts.map +1 -1
  364. package/dist/internal/discovery/info.js +4 -0
  365. package/dist/internal/env-file.d.ts +1 -0
  366. package/dist/internal/env-file.d.ts.map +1 -1
  367. package/dist/internal/env-file.js +18 -17
  368. package/dist/internal/env-prefix.d.ts +11 -0
  369. package/dist/internal/env-prefix.d.ts.map +1 -0
  370. package/dist/internal/env-prefix.js +23 -0
  371. package/dist/internal/event-id-dedupe.d.ts +12 -0
  372. package/dist/internal/event-id-dedupe.d.ts.map +1 -0
  373. package/dist/{channels/slack → internal}/event-id-dedupe.js +7 -4
  374. package/dist/internal/event-mapper.d.ts +7 -2
  375. package/dist/internal/event-mapper.d.ts.map +1 -1
  376. package/dist/internal/event-mapper.js +7 -0
  377. package/dist/internal/expected-delivery-failure.d.ts.map +1 -1
  378. package/dist/internal/expected-delivery-failure.js +3 -0
  379. package/dist/internal/extension-namespace.d.ts +9 -0
  380. package/dist/internal/extension-namespace.d.ts.map +1 -0
  381. package/dist/internal/extension-namespace.js +14 -0
  382. package/dist/internal/guid.d.ts +2 -0
  383. package/dist/internal/guid.d.ts.map +1 -0
  384. package/dist/internal/guid.js +4 -0
  385. package/dist/internal/host-kv-cas.d.ts +13 -0
  386. package/dist/internal/host-kv-cas.d.ts.map +1 -0
  387. package/dist/internal/host-kv-cas.js +26 -0
  388. package/dist/internal/host-kv.d.ts +4 -1
  389. package/dist/internal/host-kv.d.ts.map +1 -1
  390. package/dist/internal/host-kv.js +15 -2
  391. package/dist/internal/hosted-catch-protocol.d.ts +5 -0
  392. package/dist/internal/hosted-catch-protocol.d.ts.map +1 -1
  393. package/dist/internal/hosted-catch-protocol.js +5 -0
  394. package/dist/internal/hosted-catch.d.ts +2 -0
  395. package/dist/internal/hosted-catch.d.ts.map +1 -1
  396. package/dist/internal/hosted-catch.js +6 -1
  397. package/dist/internal/hosted-delivery-protocol.d.ts +4 -0
  398. package/dist/internal/hosted-delivery-protocol.d.ts.map +1 -1
  399. package/dist/internal/hosted-delivery-protocol.js +73 -3
  400. package/dist/internal/hosted-delivery.d.ts +9 -3
  401. package/dist/internal/hosted-delivery.d.ts.map +1 -1
  402. package/dist/internal/hosted-delivery.js +14 -3
  403. package/dist/internal/hosted-session-fixture.js +1 -1
  404. package/dist/internal/hosting.d.ts +5 -0
  405. package/dist/internal/hosting.d.ts.map +1 -1
  406. package/dist/internal/hosting.js +7 -1
  407. package/dist/internal/ids.d.ts +2 -0
  408. package/dist/internal/ids.d.ts.map +1 -1
  409. package/dist/internal/ids.js +5 -0
  410. package/dist/internal/install-cursor-skills.d.ts +6 -7
  411. package/dist/internal/install-cursor-skills.d.ts.map +1 -1
  412. package/dist/internal/install-cursor-skills.js +15 -9
  413. package/dist/internal/interview/agent-questions.d.ts +1 -1
  414. package/dist/internal/interview/agent-questions.d.ts.map +1 -1
  415. package/dist/internal/interview/agent-questions.js +4 -3
  416. package/dist/internal/local-control-plane.d.ts.map +1 -1
  417. package/dist/internal/local-control-plane.js +24 -0
  418. package/dist/internal/mcp-allowlist-in-use.d.ts +23 -0
  419. package/dist/internal/mcp-allowlist-in-use.d.ts.map +1 -0
  420. package/dist/internal/mcp-allowlist-in-use.js +93 -0
  421. package/dist/internal/mcp-endpoint.d.ts.map +1 -1
  422. package/dist/internal/mcp-endpoint.js +8 -10
  423. package/dist/internal/mcp-host.d.ts +19 -1
  424. package/dist/internal/mcp-host.d.ts.map +1 -1
  425. package/dist/internal/mcp-host.js +67 -3
  426. package/dist/internal/mcp-oauth.d.ts.map +1 -1
  427. package/dist/internal/mcp-oauth.js +5 -7
  428. package/dist/internal/oidcAudiences.d.ts +22 -0
  429. package/dist/internal/oidcAudiences.d.ts.map +1 -0
  430. package/dist/internal/oidcAudiences.js +35 -0
  431. package/dist/internal/otel/collector.d.ts.map +1 -1
  432. package/dist/internal/otel/collector.js +2 -0
  433. package/dist/internal/platform-timers.d.ts +2 -0
  434. package/dist/internal/platform-timers.d.ts.map +1 -1
  435. package/dist/internal/platform-timers.js +14 -0
  436. package/dist/internal/private-file.d.ts +32 -1
  437. package/dist/internal/private-file.d.ts.map +1 -1
  438. package/dist/internal/private-file.js +209 -7
  439. package/dist/internal/redact-values.d.ts +3 -0
  440. package/dist/internal/redact-values.d.ts.map +1 -0
  441. package/dist/internal/redact-values.js +19 -0
  442. package/dist/internal/reminder-control-plane-protocol.d.ts +7 -1
  443. package/dist/internal/reminder-control-plane-protocol.d.ts.map +1 -1
  444. package/dist/internal/reminder-followup-error.d.ts +23 -0
  445. package/dist/internal/reminder-followup-error.d.ts.map +1 -0
  446. package/dist/internal/reminder-followup-error.js +12 -0
  447. package/dist/internal/reminder-runner.d.ts +15 -1
  448. package/dist/internal/reminder-runner.d.ts.map +1 -1
  449. package/dist/internal/reminder-runner.js +95 -21
  450. package/dist/internal/resolved-connections.d.ts.map +1 -1
  451. package/dist/internal/resolved-connections.js +23 -3
  452. package/dist/internal/run-client.js +2 -1
  453. package/dist/internal/run-program.d.ts +31 -0
  454. package/dist/internal/run-program.d.ts.map +1 -0
  455. package/dist/internal/run-program.js +150 -0
  456. package/dist/internal/schedule-runner.d.ts +1 -0
  457. package/dist/internal/schedule-runner.d.ts.map +1 -1
  458. package/dist/internal/schedule-runner.js +10 -1
  459. package/dist/internal/sdk-runner.d.ts +28 -2
  460. package/dist/internal/sdk-runner.d.ts.map +1 -1
  461. package/dist/internal/sdk-runner.js +298 -38
  462. package/dist/internal/server.d.ts.map +1 -1
  463. package/dist/internal/server.js +53 -8
  464. package/dist/internal/session-credential.d.ts +14 -0
  465. package/dist/internal/session-credential.d.ts.map +1 -0
  466. package/dist/internal/session-credential.js +25 -0
  467. package/dist/internal/session-engine.d.ts +140 -6
  468. package/dist/internal/session-engine.d.ts.map +1 -1
  469. package/dist/internal/session-engine.js +583 -93
  470. package/dist/internal/storage-coordinator.d.ts +3 -1
  471. package/dist/internal/storage-coordinator.d.ts.map +1 -1
  472. package/dist/internal/storage-coordinator.js +13 -0
  473. package/dist/internal/storage-roles.d.ts +9 -1
  474. package/dist/internal/storage-roles.d.ts.map +1 -1
  475. package/dist/internal/teams-channel-profile.d.ts +41 -0
  476. package/dist/internal/teams-channel-profile.d.ts.map +1 -0
  477. package/dist/internal/teams-channel-profile.js +91 -0
  478. package/dist/internal/teams-devtunnel.d.ts +55 -0
  479. package/dist/internal/teams-devtunnel.d.ts.map +1 -0
  480. package/dist/internal/teams-devtunnel.js +205 -0
  481. package/dist/internal/teams-tunnel-proxy.d.ts +17 -0
  482. package/dist/internal/teams-tunnel-proxy.d.ts.map +1 -0
  483. package/dist/internal/teams-tunnel-proxy.js +100 -0
  484. package/dist/internal/testing/conversation-identity-vectors.d.ts +7 -1
  485. package/dist/internal/testing/conversation-identity-vectors.d.ts.map +1 -1
  486. package/dist/internal/testing/conversation-identity-vectors.js +67 -0
  487. package/dist/internal/testing/hosted-http.d.ts +15 -0
  488. package/dist/internal/testing/hosted-http.d.ts.map +1 -0
  489. package/dist/internal/testing/hosted-http.js +86 -0
  490. package/dist/internal/testing/teams-activity-fixtures.d.ts +28 -0
  491. package/dist/internal/testing/teams-activity-fixtures.d.ts.map +1 -0
  492. package/dist/internal/testing/teams-activity-fixtures.js +236 -0
  493. package/dist/internal/testing/teams-doctor-fixtures.d.ts +76 -0
  494. package/dist/internal/testing/teams-doctor-fixtures.d.ts.map +1 -0
  495. package/dist/internal/testing/teams-doctor-fixtures.js +216 -0
  496. package/dist/internal/tunnel-process.d.ts +29 -0
  497. package/dist/internal/tunnel-process.d.ts.map +1 -0
  498. package/dist/internal/tunnel-process.js +105 -0
  499. package/dist/internal/turn-context.d.ts +28 -0
  500. package/dist/internal/turn-context.d.ts.map +1 -0
  501. package/dist/internal/turn-context.js +1 -0
  502. package/dist/oidc-token.d.ts +131 -0
  503. package/dist/oidc-token.d.ts.map +1 -0
  504. package/dist/oidc-token.js +221 -0
  505. package/dist/playground/assets/chunk-YOKDWASO-BPO_8GRX.js +115 -0
  506. package/dist/playground/assets/highlighted-body-KPVGNVTW-CxEV-T_f.js +1 -0
  507. package/dist/playground/assets/index-CjFJhCtb.js +62 -0
  508. package/dist/playground/assets/index-vwUVwmk8.css +1 -0
  509. package/dist/playground/assets/mermaid-HWGCJPDP-eK-fpbFn.js +1 -0
  510. package/dist/playground/index.html +2 -2
  511. package/dist/teams-app-package.d.ts +78 -0
  512. package/dist/teams-app-package.d.ts.map +1 -0
  513. package/dist/teams-app-package.js +204 -0
  514. package/dist/tools.d.ts +1 -1
  515. package/dist/tools.d.ts.map +1 -1
  516. package/dist/types.d.ts +271 -2
  517. package/dist/types.d.ts.map +1 -1
  518. package/docs/changelog.md +43 -0
  519. package/docs/deployment.md +14 -0
  520. package/docs/guides/cloud-agents.md +47 -0
  521. package/docs/guides/teams.md +389 -0
  522. package/docs/guides/workload-identity.md +232 -0
  523. package/docs/reference/agent-config.md +1 -1
  524. package/docs/reference/channels.md +1 -0
  525. package/docs/reference/cli.md +116 -0
  526. package/docs/reference/limits.md +4 -4
  527. package/docs/reference/sessions.md +13 -0
  528. package/docs/troubleshooting.md +21 -0
  529. package/package.json +23 -46
  530. package/skills/create-agent/SKILL.md +17 -4
  531. package/skills/debug/SKILL.md +1 -0
  532. package/skills/deploy/SKILL.md +1 -1
  533. package/skills/framework-map/SKILL.md +1 -0
  534. package/skills/setup-teams/SKILL.md +141 -0
  535. package/templates/agentic-owners/bot/lib/owners/parse.ts +1 -0
  536. package/dist/channels/slack/event-id-dedupe.d.ts +0 -10
  537. package/dist/channels/slack/event-id-dedupe.d.ts.map +0 -1
  538. package/dist/docs/assets/changelog.md.DVNB-ApU.js +0 -1
  539. package/dist/docs/assets/chunks/@localSearchIndexroot.DdlR-9Oe.js +0 -1
  540. package/dist/docs/assets/chunks/channel.CdyTxaXV.js +0 -1
  541. package/dist/docs/assets/chunks/classDiagram-6PBFFD2Q.CeUcN6TW.js +0 -1
  542. package/dist/docs/assets/chunks/classDiagram-v2-HSJHXN6E.CeUcN6TW.js +0 -1
  543. package/dist/docs/assets/chunks/clone.DpIwUbur.js +0 -1
  544. package/dist/docs/assets/chunks/stateDiagram-v2-QKLJ7IA2.HtBkUH4J.js +0 -1
  545. package/dist/docs/assets/guides_cloud-agents.md.CiXAW6on.js +0 -9
  546. package/dist/docs/assets/troubleshooting.md.DfKKvW1R.js +0 -3
  547. package/dist/playground/assets/index-CnFd5R1_.js +0 -62
  548. package/dist/playground/assets/index-DNzRv6G8.css +0 -1
  549. /package/dist/docs/assets/{reference_channels.md.CPWOpdsC.lean.js → reference_channels.md.CRvqgU0n.lean.js} +0 -0
  550. /package/dist/docs/assets/{reference_schedules.md.RhQ9ZLo1.lean.js → reference_schedules.md.Dd8_d0WG.lean.js} +0 -0
@@ -24,8 +24,9 @@
24
24
  * The tools run on the serve host, so they need the local runtime.
25
25
  *
26
26
  * The `cloud__cloud-agent-stop-watch` reminder wakes the conversation that
27
- * launched an agent once that agent stops (`watchStops`). The host polls the
28
- * agent; no model turn runs until the one wake.
27
+ * launched an agent once that agent stops (`watchStops`). On Cursor hosting
28
+ * the agent's status webhook fires it; nothing polls the agent, and no model
29
+ * turn runs until the one wake.
29
30
  */
30
31
  import * as z from "zod/v4";
31
32
  import { defineExtension } from "../../extensions.js";
@@ -0,0 +1,5 @@
1
+ /** A fresh Cloud Agents API agent id, chosen before the launch. */
2
+ export declare function newCloudAgentId(): string;
3
+ /** The `bc-<uuid>` form the Cloud Agents API takes as a client-chosen agent id. */
4
+ export declare function isCloudAgentId(value: string): boolean;
5
+ //# sourceMappingURL=agent-id.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"agent-id.d.ts","sourceRoot":"","sources":["../../../../src/extensions/cursor-cloud-agents/lib/agent-id.ts"],"names":[],"mappings":"AAIA,mEAAmE;AACnE,wBAAgB,eAAe,IAAI,MAAM,CAExC;AAED,mFAAmF;AACnF,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAErD"}
@@ -0,0 +1,10 @@
1
+ import { randomUUID } from "node:crypto";
2
+ const AGENT_ID_PATTERN = /^bc-[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
3
+ /** A fresh Cloud Agents API agent id, chosen before the launch. */
4
+ export function newCloudAgentId() {
5
+ return `bc-${randomUUID()}`;
6
+ }
7
+ /** The `bc-<uuid>` form the Cloud Agents API takes as a client-chosen agent id. */
8
+ export function isCloudAgentId(value) {
9
+ return AGENT_ID_PATTERN.test(value);
10
+ }
@@ -1,18 +1,25 @@
1
1
  /**
2
2
  * The Cursor backend as the tools use it: launches go through the public
3
- * v1 Cloud Agents API (the only surface that takes per-launch `envVars`),
4
- * everything about an existing agent goes through the same
3
+ * v1 Cloud Agents API (the only surface that takes per-launch `envVars`), and
4
+ * so does a run's final answer, which the platform records when the run
5
+ * finishes. Everything else about an existing agent goes through the same
5
6
  * `aiserver.v1.BackgroundComposerService` RPCs Sand's CloudAgent tool
6
7
  * calls, so follow-ups queue, runs pause, and the full conversation is
7
8
  * readable. Both authenticate with the host's Cursor API key; the RPCs
8
9
  * exchange it for a session token the way the dashboard client does.
9
10
  */
10
- import type { AgentCloudOptions, ModelSetting } from "../../../types.js";
11
+ import type { AgentCloudOptions, JsonObject, ModelSetting } from "../../../types.js";
12
+ /** The platform route that arms a stop watch and launches with its status webhook in one call. */
13
+ export declare const FACTORY_LAUNCH_PATH = "/internal/agentsdk/cloud-agents/launch";
11
14
  export declare class CloudAgentsApiError extends Error {
12
15
  readonly status?: number | undefined;
13
16
  constructor(message: string, status?: number | undefined);
14
17
  }
15
18
  export type CloudAgentStatus = "creating" | "running" | "finished" | "error" | "expired" | "unknown";
19
+ /** The run ended. An unknown status is not a stop. */
20
+ export declare function isStoppedRun(status: string | undefined): boolean;
21
+ /** The agent stopped working: it finished, failed, or expired. */
22
+ export declare function isStopped(status: CloudAgentStatus): boolean;
16
23
  export type CloudAgentInfo = {
17
24
  agentId: string;
18
25
  name: string;
@@ -28,6 +35,8 @@ export type CloudAgentInfo = {
28
35
  linesAdded: number;
29
36
  linesRemoved: number;
30
37
  };
38
+ /** The final answer of the agent's latest run, once the agent stopped and that run finished. */
39
+ result?: string;
31
40
  };
32
41
  export type CloudAgentToolCall = {
33
42
  name: string;
@@ -81,11 +90,21 @@ export type CloudAgentLaunchTarget = AgentCloudOptions & {
81
90
  teamMcpServers?: string[];
82
91
  };
83
92
  export type LaunchRequest = {
93
+ /**
94
+ * A client-chosen `bc-<uuid>`. The API keeps it as the agent id and answers
95
+ * 409 when it already exists; it refuses it together with `envVars`.
96
+ */
97
+ agentId?: string;
84
98
  prompt: string;
85
99
  name?: string;
86
100
  cloud: CloudAgentLaunchTarget;
87
101
  model?: ModelSetting;
88
102
  };
103
+ /** The stop watch the platform arms before it launches, and the channel its webhook targets. */
104
+ export type LaunchWatch = {
105
+ watch: JsonObject;
106
+ channel: string;
107
+ };
89
108
  export declare class CloudAgentsBackend {
90
109
  private readonly apiKey;
91
110
  private readonly fetchImpl;
@@ -93,6 +112,17 @@ export declare class CloudAgentsBackend {
93
112
  constructor(apiKey: () => string, fetchImpl?: typeof fetch);
94
113
  /** `POST /v1/agents`: create the agent and start its first run in one call. */
95
114
  launch(request: LaunchRequest): Promise<CloudAgentLaunch>;
115
+ /**
116
+ * The platform's launch route: it arms `watch`, then calls `POST /v1/agents`
117
+ * with the status webhook of this deployment's `channel`. Throws when the
118
+ * route is missing, turned off, or fails.
119
+ */
120
+ launchWithWatch(request: LaunchRequest & {
121
+ agentId: string;
122
+ }, watch: LaunchWatch): Promise<{
123
+ launch: CloudAgentLaunch;
124
+ reminderId: string | undefined;
125
+ }>;
96
126
  /** `GetEnvironment`: one saved environment by public id, or undefined when not visible. */
97
127
  environment(publicId: string): Promise<CloudEnvironment | undefined>;
98
128
  /**
@@ -102,6 +132,28 @@ export declare class CloudAgentsBackend {
102
132
  */
103
133
  environmentsNamed(name: string): Promise<CloudEnvironment[]>;
104
134
  info(agentId: string): Promise<CloudAgentInfo>;
135
+ /** `info`, plus the agent's `result` once it stopped. */
136
+ infoWithResult(agentId: string): Promise<CloudAgentInfo>;
137
+ /**
138
+ * An agent that already exists, as its launch would have returned it, and
139
+ * when the API created it.
140
+ */
141
+ existingLaunch(agentId: string): Promise<{
142
+ launch: CloudAgentLaunch;
143
+ createdAt: string | undefined;
144
+ }>;
145
+ /**
146
+ * The agent's latest run from the v1 API: its status, such as `FINISHED`
147
+ * or `CANCELLED`, and its final answer. The platform records the answer
148
+ * only when a run finishes, so an errored or expired run has none.
149
+ */
150
+ latestRun(agentId: string): Promise<{
151
+ id: string;
152
+ status?: string;
153
+ result?: string;
154
+ } | undefined>;
155
+ private agentRecord;
156
+ private run;
105
157
  conversation(agentId: string): Promise<CloudAgentMessage[]>;
106
158
  /**
107
159
  * Queue a follow-up behind the current run, or with `interrupt` cancel the
@@ -111,6 +163,8 @@ export declare class CloudAgentsBackend {
111
163
  runId: string | undefined;
112
164
  }>;
113
165
  pause(agentId: string): Promise<void>;
166
+ /** One public v1 Cloud Agents API call: a POST when it has a body, else a GET. */
167
+ private v1Request;
114
168
  }
115
169
  /** The process-wide backend for this mount, built on first use. */
116
170
  export declare function cloudAgentsBackend(): CloudAgentsBackend;
@@ -1 +1 @@
1
- {"version":3,"file":"backend.d.ts","sourceRoot":"","sources":["../../../../src/extensions/cursor-cloud-agents/lib/backend.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"backend.d.ts","sourceRoot":"","sources":["../../../../src/extensions/cursor-cloud-agents/lib/backend.ts"],"names":[],"mappings":"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"}
@@ -1,7 +1,8 @@
1
1
  /**
2
2
  * The Cursor backend as the tools use it: launches go through the public
3
- * v1 Cloud Agents API (the only surface that takes per-launch `envVars`),
4
- * everything about an existing agent goes through the same
3
+ * v1 Cloud Agents API (the only surface that takes per-launch `envVars`), and
4
+ * so does a run's final answer, which the platform records when the run
5
+ * finishes. Everything else about an existing agent goes through the same
5
6
  * `aiserver.v1.BackgroundComposerService` RPCs Sand's CloudAgent tool
6
7
  * calls, so follow-ups queue, runs pause, and the full conversation is
7
8
  * readable. Both authenticate with the host's Cursor API key; the RPCs
@@ -10,6 +11,7 @@
10
11
  import { randomUUID } from "node:crypto";
11
12
  import * as z from "zod/v4";
12
13
  import { CursorBackendClient } from "../../../internal/cursor/backend-client.js";
14
+ import { hostedControlPlaneFetch } from "../../../internal/hosted-fetch.js";
13
15
  import { isRecord } from "../../../internal/is-record.js";
14
16
  import { cloudAgentUrl, cursorBackendUrl, cursorExternalApiUrl, resolveApiKeySync, SIGN_IN_HINT, } from "../../../internal/cursor/credentials.js";
15
17
  import { toModelSelection } from "../../../internal/sdk-runner.js";
@@ -20,6 +22,8 @@ const SOURCE = "BACKGROUND_COMPOSER_SOURCE_SDK";
20
22
  const RPC_TIMEOUT_MS = 60_000;
21
23
  // The create call returns once the initial run exists, which can wait on a VM.
22
24
  const LAUNCH_TIMEOUT_MS = 300_000;
25
+ /** The platform route that arms a stop watch and launches with its status webhook in one call. */
26
+ export const FACTORY_LAUNCH_PATH = "/internal/agentsdk/cloud-agents/launch";
23
27
  export class CloudAgentsApiError extends Error {
24
28
  constructor(message, status) {
25
29
  super(message);
@@ -27,6 +31,22 @@ export class CloudAgentsApiError extends Error {
27
31
  this.name = "CloudAgentsApiError";
28
32
  }
29
33
  }
34
+ const STOPPED_STATUSES = new Set(["finished", "error", "expired"]);
35
+ /** Cloud Agents API run statuses of a run that ended. */
36
+ const STOPPED_RUN_STATUSES = new Set([
37
+ "FINISHED",
38
+ "ERROR",
39
+ "CANCELLED",
40
+ "EXPIRED",
41
+ ]);
42
+ /** The run ended. An unknown status is not a stop. */
43
+ export function isStoppedRun(status) {
44
+ return status !== undefined && STOPPED_RUN_STATUSES.has(status);
45
+ }
46
+ /** The agent stopped working: it finished, failed, or expired. */
47
+ export function isStopped(status) {
48
+ return STOPPED_STATUSES.has(status);
49
+ }
30
50
  // ---------------------------------------------------------------------------
31
51
  // Proto-JSON response schemas (camelCase; default-valued fields are omitted)
32
52
  // ---------------------------------------------------------------------------
@@ -95,6 +115,19 @@ const launchResponseSchema = z.object({
95
115
  agent: z.object({ id: z.string(), url: z.string().optional() }),
96
116
  run: z.object({ id: z.string(), status: z.string() }),
97
117
  });
118
+ /** A null `reminderId` means the platform cancelled the watch, for a run that already stopped. */
119
+ const factoryLaunchResponseSchema = z.object({
120
+ launch: launchResponseSchema,
121
+ reminderId: z.string().nullable(),
122
+ });
123
+ const agentResponseSchema = z.object({
124
+ latestRunId: z.string().optional(),
125
+ createdAt: z.string().optional(),
126
+ });
127
+ const runResponseSchema = z.object({
128
+ status: z.string().optional(),
129
+ result: z.string().optional(),
130
+ });
98
131
  // ---------------------------------------------------------------------------
99
132
  export class CloudAgentsBackend {
100
133
  constructor(apiKey, fetchImpl = fetch) {
@@ -110,34 +143,23 @@ export class CloudAgentsBackend {
110
143
  }
111
144
  /** `POST /v1/agents`: create the agent and start its first run in one call. */
112
145
  async launch(request) {
113
- const { cloud } = request;
114
- const body = {
115
- prompt: { text: request.prompt },
116
- name: request.name,
117
- model: request.model === undefined ? undefined : toModelSelection(request.model),
118
- env: cloud.env,
119
- envVars: cloud.envVars,
120
- mcpServers: cloud.mcpServers,
121
- teamMcpServers: cloud.teamMcpServers,
122
- repos: cloud.repos,
123
- workOnCurrentBranch: cloud.workOnCurrentBranch,
124
- autoCreatePR: cloud.autoCreatePR,
125
- skipReviewerRequest: cloud.skipReviewerRequest,
126
- };
146
+ return toLaunch(launchResponseSchema.parse(await this.v1Request("/v1/agents", "launch", {
147
+ body: launchBody(request),
148
+ timeoutMs: LAUNCH_TIMEOUT_MS,
149
+ })));
150
+ }
151
+ /**
152
+ * The platform's launch route: it arms `watch`, then calls `POST /v1/agents`
153
+ * with the status webhook of this deployment's `channel`. Throws when the
154
+ * route is missing, turned off, or fails.
155
+ */
156
+ async launchWithWatch(request, watch) {
127
157
  let response;
128
158
  try {
129
- response = await this.fetchImpl(`${cursorExternalApiUrl()}/v1/agents`, {
130
- method: "POST",
131
- headers: {
132
- "content-type": "application/json",
133
- authorization: `Bearer ${this.apiKey()}`,
134
- "x-ghost-mode": "true",
135
- "x-cursor-client-type": "agent-serve",
136
- "x-request-id": randomUUID(),
137
- },
138
- body: JSON.stringify(body),
139
- signal: AbortSignal.timeout(LAUNCH_TIMEOUT_MS),
140
- });
159
+ response = await hostedControlPlaneFetch({
160
+ apiKey: this.apiKey(),
161
+ fetch: (input, init) => this.fetchImpl(input, { ...init, signal: AbortSignal.timeout(LAUNCH_TIMEOUT_MS) }),
162
+ }, "POST", FACTORY_LAUNCH_PATH, { launch: launchBody(request), watch: watch.watch, channel: watch.channel });
141
163
  }
142
164
  catch (error) {
143
165
  throw new CloudAgentsApiError(`Cloud agent launch failed: ${error instanceof Error ? error.message : String(error)}`);
@@ -146,13 +168,8 @@ export class CloudAgentsBackend {
146
168
  if (!response.ok) {
147
169
  throw new CloudAgentsApiError(`Cloud agent launch failed (${response.status}): ${apiErrorMessage(text)}`, response.status);
148
170
  }
149
- const parsed = launchResponseSchema.parse(JSON.parse(text));
150
- return {
151
- agentId: parsed.agent.id,
152
- runId: parsed.run.id,
153
- status: parsed.run.status.toLowerCase(),
154
- url: parsed.agent.url ?? cloudAgentUrl(parsed.agent.id),
155
- };
171
+ const parsed = factoryLaunchResponseSchema.parse(JSON.parse(text));
172
+ return { launch: toLaunch(parsed.launch), reminderId: parsed.reminderId ?? undefined };
156
173
  }
157
174
  /** `GetEnvironment`: one saved environment by public id, or undefined when not visible. */
158
175
  async environment(publicId) {
@@ -193,6 +210,53 @@ export class CloudAgentsBackend {
193
210
  },
194
211
  };
195
212
  }
213
+ /** `info`, plus the agent's `result` once it stopped. */
214
+ async infoWithResult(agentId) {
215
+ const info = await this.info(agentId);
216
+ if (!isStopped(info.status)) {
217
+ return info;
218
+ }
219
+ const result = (await this.latestRun(agentId))?.result;
220
+ return result === undefined ? info : { ...info, result };
221
+ }
222
+ /**
223
+ * An agent that already exists, as its launch would have returned it, and
224
+ * when the API created it.
225
+ */
226
+ async existingLaunch(agentId) {
227
+ const { latestRunId, createdAt } = await this.agentRecord(agentId);
228
+ const run = latestRunId === undefined ? undefined : await this.run(agentId, latestRunId);
229
+ return {
230
+ launch: {
231
+ agentId,
232
+ runId: run?.id ?? "",
233
+ status: run?.status?.toLowerCase() ?? "unknown",
234
+ url: cloudAgentUrl(agentId),
235
+ },
236
+ createdAt,
237
+ };
238
+ }
239
+ /**
240
+ * The agent's latest run from the v1 API: its status, such as `FINISHED`
241
+ * or `CANCELLED`, and its final answer. The platform records the answer
242
+ * only when a run finishes, so an errored or expired run has none.
243
+ */
244
+ async latestRun(agentId) {
245
+ const { latestRunId } = await this.agentRecord(agentId);
246
+ return latestRunId === undefined ? undefined : this.run(agentId, latestRunId);
247
+ }
248
+ async agentRecord(agentId) {
249
+ return agentResponseSchema.parse(await this.v1Request(`/v1/agents/${encodeURIComponent(agentId)}`, "read", {
250
+ timeoutMs: RPC_TIMEOUT_MS,
251
+ }));
252
+ }
253
+ async run(agentId, latestRunId) {
254
+ const agentPath = `/v1/agents/${encodeURIComponent(agentId)}`;
255
+ const run = runResponseSchema.parse(await this.v1Request(`${agentPath}/runs/${encodeURIComponent(latestRunId)}`, "run read", {
256
+ timeoutMs: RPC_TIMEOUT_MS,
257
+ }));
258
+ return { id: latestRunId, ...run };
259
+ }
196
260
  async conversation(agentId) {
197
261
  const { conversation } = conversationResponseSchema.parse(await this.rpcClient.serviceRpc(SERVICE, "GetBackgroundComposerConversation", { bcId: agentId }, RPC_TIMEOUT_MS));
198
262
  return (conversation ?? []).map((message) => {
@@ -230,6 +294,57 @@ export class CloudAgentsBackend {
230
294
  async pause(agentId) {
231
295
  await this.rpcClient.serviceRpc(SERVICE, "PauseBackgroundComposer", { bcId: agentId, source: SOURCE }, RPC_TIMEOUT_MS);
232
296
  }
297
+ /** One public v1 Cloud Agents API call: a POST when it has a body, else a GET. */
298
+ async v1Request(path, action, init) {
299
+ let response;
300
+ try {
301
+ response = await this.fetchImpl(`${cursorExternalApiUrl()}${path}`, {
302
+ method: init.body === undefined ? "GET" : "POST",
303
+ headers: {
304
+ "content-type": "application/json",
305
+ authorization: `Bearer ${this.apiKey()}`,
306
+ "x-ghost-mode": "true",
307
+ "x-cursor-client-type": "agent-serve",
308
+ "x-request-id": randomUUID(),
309
+ },
310
+ body: init.body === undefined ? undefined : JSON.stringify(init.body),
311
+ signal: AbortSignal.timeout(init.timeoutMs),
312
+ });
313
+ }
314
+ catch (error) {
315
+ throw new CloudAgentsApiError(`Cloud agent ${action} failed: ${error instanceof Error ? error.message : String(error)}`);
316
+ }
317
+ const text = await response.text();
318
+ if (!response.ok) {
319
+ throw new CloudAgentsApiError(`Cloud agent ${action} failed (${response.status}): ${apiErrorMessage(text)}`, response.status);
320
+ }
321
+ return JSON.parse(text);
322
+ }
323
+ }
324
+ function launchBody(request) {
325
+ const { cloud } = request;
326
+ return {
327
+ agentId: request.agentId,
328
+ prompt: { text: request.prompt },
329
+ name: request.name,
330
+ model: request.model === undefined ? undefined : toModelSelection(request.model),
331
+ env: cloud.env,
332
+ envVars: cloud.envVars,
333
+ mcpServers: cloud.mcpServers,
334
+ teamMcpServers: cloud.teamMcpServers,
335
+ repos: cloud.repos,
336
+ workOnCurrentBranch: cloud.workOnCurrentBranch,
337
+ autoCreatePR: cloud.autoCreatePR,
338
+ skipReviewerRequest: cloud.skipReviewerRequest,
339
+ };
340
+ }
341
+ function toLaunch(parsed) {
342
+ return {
343
+ agentId: parsed.agent.id,
344
+ runId: parsed.run.id,
345
+ status: parsed.run.status.toLowerCase(),
346
+ url: parsed.agent.url ?? cloudAgentUrl(parsed.agent.id),
347
+ };
233
348
  }
234
349
  let backend;
235
350
  /** The process-wide backend for this mount, built on first use. */
@@ -6,7 +6,7 @@
6
6
  * the fleet listing is that principal's records, by default narrowed to the
7
7
  * session that launched them.
8
8
  */
9
- import type { ToolContext } from "../../../types.js";
9
+ import type { HostKvApi, ToolContext } from "../../../types.js";
10
10
  export type FleetEntry = {
11
11
  agentId: string;
12
12
  name?: string;
@@ -17,9 +17,37 @@ export type FleetEntry = {
17
17
  export type FleetScope = "session" | "all";
18
18
  /** Unauthenticated sessions (local dev, direct calls) share one principal. */
19
19
  export declare function principalOf(ctx: ToolContext): string;
20
- export declare function recordLaunch(ctx: ToolContext, agentId: string, name: string | undefined): Promise<void>;
21
- /** Refuse agents launched by another principal, or not through the extension. */
22
- export declare function assertOwned(ctx: ToolContext, agentId: string): Promise<void>;
20
+ export declare function recordLaunch(ctx: ToolContext, agentId: string, name: string | undefined, launch: {
21
+ webhook: boolean;
22
+ }): Promise<void>;
23
+ /**
24
+ * Bind an agent id to this principal before its launch, so that a retry of
25
+ * the same launch can take the agent the first attempt created. Refuses an
26
+ * id that another principal holds. `earlier` is true when this principal
27
+ * held the id before this call. `claimedAt` is set while no launch of the id
28
+ * has returned, so an agent the API created before it is not this claim's.
29
+ */
30
+ export declare function claimAgentId(ctx: ToolContext, agentId: string): Promise<{
31
+ earlier: boolean;
32
+ webhook: boolean;
33
+ claimedAt: number | undefined;
34
+ release: () => Promise<void>;
35
+ }>;
36
+ /**
37
+ * Refuse agents launched by another principal, or not through the extension.
38
+ * A claim whose launch never returned does not count.
39
+ * Resolves with whether the launch registered the status webhook.
40
+ */
41
+ export declare function assertOwned(ctx: ToolContext, agentId: string): Promise<{
42
+ webhook: boolean;
43
+ }>;
44
+ /**
45
+ * Turn a pending claim on `agentId` into a launch with the status webhook.
46
+ * Only a signed status webhook may call this: it names only agents the
47
+ * platform launched with this deployment's webhook, so the launch whose reply
48
+ * was lost created the agent. Any other record is left as it is.
49
+ */
50
+ export declare function adoptPendingLaunch(kv: HostKvApi, agentId: string): Promise<void>;
23
51
  /** The caller's launches, newest first: this session's, or every session's. */
24
52
  export declare function listFleet(ctx: ToolContext, scope?: FleetScope): Promise<FleetEntry[]>;
25
53
  //# sourceMappingURL=fleet.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"fleet.d.ts","sourceRoot":"","sources":["../../../../src/extensions/cursor-cloud-agents/lib/fleet.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAKrD,MAAM,MAAM,UAAU,GAAG;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,0FAA0F;IAC1F,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,MAAM,MAAM,UAAU,GAAG,SAAS,GAAG,KAAK,CAAC;AA2B3C,8EAA8E;AAC9E,wBAAgB,WAAW,CAAC,GAAG,EAAE,WAAW,GAAG,MAAM,CAGpD;AAED,wBAAsB,YAAY,CAChC,GAAG,EAAE,WAAW,EAChB,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,GAAG,SAAS,GACvB,OAAO,CAAC,IAAI,CAAC,CAaf;AAED,iFAAiF;AACjF,wBAAsB,WAAW,CAAC,GAAG,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAOlF;AAED,+EAA+E;AAC/E,wBAAsB,SAAS,CAC7B,GAAG,EAAE,WAAW,EAChB,KAAK,GAAE,UAAkB,GACxB,OAAO,CAAC,UAAU,EAAE,CAAC,CAIvB"}
1
+ {"version":3,"file":"fleet.d.ts","sourceRoot":"","sources":["../../../../src/extensions/cursor-cloud-agents/lib/fleet.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,KAAK,EAAE,SAAS,EAAa,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAK3E,MAAM,MAAM,UAAU,GAAG;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,0FAA0F;IAC1F,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,MAAM,MAAM,UAAU,GAAG,SAAS,GAAG,KAAK,CAAC;AAmC3C,8EAA8E;AAC9E,wBAAgB,WAAW,CAAC,GAAG,EAAE,WAAW,GAAG,MAAM,CAGpD;AAED,wBAAsB,YAAY,CAChC,GAAG,EAAE,WAAW,EAChB,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,GAAG,SAAS,EACxB,MAAM,EAAE;IAAE,OAAO,EAAE,OAAO,CAAA;CAAE,GAC3B,OAAO,CAAC,IAAI,CAAC,CAmBf;AAED;;;;;;GAMG;AACH,wBAAsB,YAAY,CAChC,GAAG,EAAE,WAAW,EAChB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC;IACT,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9B,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC9B,CAAC,CAkCD;AAED;;;;GAIG;AACH,wBAAsB,WAAW,CAC/B,GAAG,EAAE,WAAW,EAChB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC;IAAE,OAAO,EAAE,OAAO,CAAA;CAAE,CAAC,CAM/B;AAED;;;;;GAKG;AACH,wBAAsB,kBAAkB,CAAC,EAAE,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAMtF;AAwBD,+EAA+E;AAC/E,wBAAsB,SAAS,CAC7B,GAAG,EAAE,WAAW,EAChB,KAAK,GAAE,UAAkB,GACxB,OAAO,CAAC,UAAU,EAAE,CAAC,CAIvB"}
@@ -6,6 +6,7 @@
6
6
  * the fleet listing is that principal's records, by default narrowed to the
7
7
  * session that launched them.
8
8
  */
9
+ import { randomUUID } from "node:crypto";
9
10
  import * as z from "zod/v4";
10
11
  const PREFIX = "cloud-agents";
11
12
  const fleetSchema = z.array(z.object({
@@ -14,7 +15,15 @@ const fleetSchema = z.array(z.object({
14
15
  launchedAt: z.string(),
15
16
  sessionId: z.string().optional(),
16
17
  }));
17
- const ownerSchema = z.object({ principal: z.string() });
18
+ const ownerSchema = z.object({
19
+ principal: z.string(),
20
+ /** The launch registered the status webhook; absent on launches before it existed. */
21
+ webhook: z.literal(true).optional(),
22
+ /** Set while no launch of the claimed id has returned; one value per claim. */
23
+ pending: z.string().optional(),
24
+ /** When the pending claim was written, in ms since the epoch. */
25
+ claimedAt: z.number().optional(),
26
+ });
18
27
  // `host.kv` has no compare-and-swap, and a model that launches two agents in
19
28
  // one turn calls this tool in parallel. Chain the index read-modify-write per
20
29
  // principal so neither launch overwrites the other's entry.
@@ -33,7 +42,7 @@ export function principalOf(ctx) {
33
42
  const auth = ctx.session.auth;
34
43
  return auth === null ? "anonymous" : `${auth.principalType}:${auth.principalId}`;
35
44
  }
36
- export async function recordLaunch(ctx, agentId, name) {
45
+ export async function recordLaunch(ctx, agentId, name, launch) {
37
46
  const principal = principalOf(ctx);
38
47
  const entry = {
39
48
  agentId,
@@ -41,18 +50,95 @@ export async function recordLaunch(ctx, agentId, name) {
41
50
  launchedAt: new Date().toISOString(),
42
51
  sessionId: ctx.session.id,
43
52
  };
44
- await ctx.host.kv.put(`${PREFIX}/agents/${agentId}`, { principal });
53
+ await ctx.host.kv.put(ownerKey(agentId), launch.webhook ? { principal, webhook: true } : { principal });
45
54
  await withIndexLock(fleetKey(principal), async () => {
46
55
  const fleet = await listFleet(ctx);
47
- await ctx.host.kv.put(fleetKey(principal), [entry, ...fleet]);
56
+ await ctx.host.kv.put(fleetKey(principal), [
57
+ entry,
58
+ ...fleet.filter((earlier) => earlier.agentId !== agentId),
59
+ ]);
48
60
  });
49
61
  }
50
- /** Refuse agents launched by another principal, or not through the extension. */
62
+ /**
63
+ * Bind an agent id to this principal before its launch, so that a retry of
64
+ * the same launch can take the agent the first attempt created. Refuses an
65
+ * id that another principal holds. `earlier` is true when this principal
66
+ * held the id before this call. `claimedAt` is set while no launch of the id
67
+ * has returned, so an agent the API created before it is not this claim's.
68
+ */
69
+ export async function claimAgentId(ctx, agentId) {
70
+ const key = ownerKey(agentId);
71
+ const stored = await ctx.host.kv.get(key);
72
+ let pending;
73
+ let claimedAt;
74
+ if (stored === undefined) {
75
+ pending = randomUUID();
76
+ claimedAt = Date.now();
77
+ await ctx.host.kv.put(key, { principal: principalOf(ctx), pending, claimedAt });
78
+ }
79
+ else {
80
+ const owner = ownerOf(ctx, agentId, stored);
81
+ if (owner.pending === undefined || owner.claimedAt === undefined) {
82
+ return {
83
+ earlier: true,
84
+ webhook: owner.webhook === true,
85
+ claimedAt: undefined,
86
+ release: async () => { },
87
+ };
88
+ }
89
+ pending = owner.pending;
90
+ claimedAt = owner.claimedAt;
91
+ }
92
+ return {
93
+ earlier: stored !== undefined,
94
+ webhook: false,
95
+ claimedAt,
96
+ // Leave the record when a parallel launch of the same id replaced the claim.
97
+ release: async () => {
98
+ const current = ownerSchema.safeParse(await ctx.host.kv.get(key));
99
+ if (current.success && current.data.pending === pending) {
100
+ await ctx.host.kv.delete(key);
101
+ }
102
+ },
103
+ };
104
+ }
105
+ /**
106
+ * Refuse agents launched by another principal, or not through the extension.
107
+ * A claim whose launch never returned does not count.
108
+ * Resolves with whether the launch registered the status webhook.
109
+ */
51
110
  export async function assertOwned(ctx, agentId) {
52
- const owner = ownerSchema.safeParse(await ctx.host.kv.get(`${PREFIX}/agents/${agentId}`));
111
+ const owner = ownerOf(ctx, agentId, await ctx.host.kv.get(ownerKey(agentId)));
112
+ if (owner.pending !== undefined) {
113
+ throw notLaunchedHere(agentId);
114
+ }
115
+ return { webhook: owner.webhook === true };
116
+ }
117
+ /**
118
+ * Turn a pending claim on `agentId` into a launch with the status webhook.
119
+ * Only a signed status webhook may call this: it names only agents the
120
+ * platform launched with this deployment's webhook, so the launch whose reply
121
+ * was lost created the agent. Any other record is left as it is.
122
+ */
123
+ export async function adoptPendingLaunch(kv, agentId) {
124
+ const key = ownerKey(agentId);
125
+ const owner = ownerSchema.safeParse(await kv.get(key));
126
+ if (owner.success && owner.data.pending !== undefined) {
127
+ await kv.put(key, { principal: owner.data.principal, webhook: true });
128
+ }
129
+ }
130
+ function ownerOf(ctx, agentId, stored) {
131
+ const owner = ownerSchema.safeParse(stored);
53
132
  if (!owner.success || owner.data.principal !== principalOf(ctx)) {
54
- throw new Error(`Agent ${agentId} was not launched through this extension by this principal; only your own launches can be read or steered.`);
133
+ throw notLaunchedHere(agentId);
55
134
  }
135
+ return owner.data;
136
+ }
137
+ function notLaunchedHere(agentId) {
138
+ return new Error(`Agent ${agentId} was not launched through this extension by this principal; only your own launches can be read or steered.`);
139
+ }
140
+ function ownerKey(agentId) {
141
+ return `${PREFIX}/agents/${agentId}`;
56
142
  }
57
143
  /** The caller's launches, newest first: this session's, or every session's. */
58
144
  export async function listFleet(ctx, scope = "all") {