@cursor/bdk 0.2.2 → 0.2.4

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 (697) hide show
  1. package/AGENTS.md +1 -1
  2. package/dist/bin/agent-serve.js +32 -8
  3. package/dist/channels/github/auth.d.ts.map +1 -1
  4. package/dist/channels/github/auth.js +36 -5
  5. package/dist/channels/slack/attachments.d.ts +2 -1
  6. package/dist/channels/slack/attachments.d.ts.map +1 -1
  7. package/dist/channels/slack/attachments.js +19 -9
  8. package/dist/channels/slack/dispatch.d.ts.map +1 -1
  9. package/dist/channels/slack/dispatch.js +26 -24
  10. package/dist/channels/slack/thread-context.d.ts +21 -11
  11. package/dist/channels/slack/thread-context.d.ts.map +1 -1
  12. package/dist/channels/slack/thread-context.js +75 -27
  13. package/dist/connections.d.ts +1 -1
  14. package/dist/connections.js +1 -1
  15. package/dist/docs/404.html +2 -2
  16. package/dist/docs/assets/{app.DtYVVVyK.js → app.4kQ8Db_q.js} +4 -4
  17. package/dist/docs/assets/chunks/@localSearchIndexroot.CvuAJ0My.js +1 -0
  18. package/dist/docs/assets/chunks/{VPLocalSearchBox.D47xT7J4.js → VPLocalSearchBox.DY1RwB8Q.js} +1 -1
  19. package/dist/docs/assets/chunks/{arc.CDJ6xzxR.js → arc.CxE_fSPK.js} +1 -1
  20. package/dist/docs/assets/chunks/{architectureDiagram-Q4EWVU46.l1Xnjd3N.js → architectureDiagram-Q4EWVU46.CPX426ui.js} +1 -1
  21. package/dist/docs/assets/chunks/{baseUniq.x-finShZ.js → baseUniq.CB52JrKG.js} +1 -1
  22. package/dist/docs/assets/chunks/{blockDiagram-DXYQGD6D.COC3qynH.js → blockDiagram-DXYQGD6D.J0cNaQCL.js} +1 -1
  23. package/dist/docs/assets/chunks/{c4Diagram-AHTNJAMY.DdQO850E.js → c4Diagram-AHTNJAMY.DJn3vEGT.js} +1 -1
  24. package/dist/docs/assets/chunks/channel.BoNycAoN.js +1 -0
  25. package/dist/docs/assets/chunks/{chunk-4BX2VUAB.Dpn8omLk.js → chunk-4BX2VUAB.Dao618F6.js} +1 -1
  26. package/dist/docs/assets/chunks/{chunk-4TB4RGXK.C0XWStUN.js → chunk-4TB4RGXK.QW8Rhjai.js} +1 -1
  27. package/dist/docs/assets/chunks/{chunk-55IACEB6.DsKSZfIM.js → chunk-55IACEB6.DfRLLKF_.js} +1 -1
  28. package/dist/docs/assets/chunks/{chunk-EDXVE4YY.dNU6JDu6.js → chunk-EDXVE4YY.CIV2ApKQ.js} +1 -1
  29. package/dist/docs/assets/chunks/{chunk-FMBD7UC4.DN41fxKE.js → chunk-FMBD7UC4.BEheSuxp.js} +1 -1
  30. package/dist/docs/assets/chunks/{chunk-OYMX7WX6.COpKCZus.js → chunk-OYMX7WX6.CUN88ENB.js} +1 -1
  31. package/dist/docs/assets/chunks/{chunk-QZHKN3VN.HDB-azx2.js → chunk-QZHKN3VN.CgqCs8b_.js} +1 -1
  32. package/dist/docs/assets/chunks/{chunk-YZCP3GAM.DEeX_a2j.js → chunk-YZCP3GAM.iCH0nnTJ.js} +1 -1
  33. package/dist/docs/assets/chunks/classDiagram-6PBFFD2Q.C4x07Gkj.js +1 -0
  34. package/dist/docs/assets/chunks/classDiagram-v2-HSJHXN6E.C4x07Gkj.js +1 -0
  35. package/dist/docs/assets/chunks/clone.Db22cH_-.js +1 -0
  36. package/dist/docs/assets/chunks/{cose-bilkent-S5V4N54A.C3yGL2A8.js → cose-bilkent-S5V4N54A.BLcUxhWE.js} +1 -1
  37. package/dist/docs/assets/chunks/{dagre-KV5264BT.Bpl24en4.js → dagre-KV5264BT.Ep7LofOm.js} +1 -1
  38. package/dist/docs/assets/chunks/{diagram-5BDNPKRD.nFco6seU.js → diagram-5BDNPKRD.Bzf4GSQ4.js} +1 -1
  39. package/dist/docs/assets/chunks/{diagram-G4DWMVQ6.DXhA6DWR.js → diagram-G4DWMVQ6.DD6Jh-eM.js} +1 -1
  40. package/dist/docs/assets/chunks/{diagram-MMDJMWI5.8GoOYcwk.js → diagram-MMDJMWI5.oOIl8bWd.js} +1 -1
  41. package/dist/docs/assets/chunks/{diagram-TYMM5635.DDBlqvlJ.js → diagram-TYMM5635.DHs85Ade.js} +1 -1
  42. package/dist/docs/assets/chunks/{erDiagram-SMLLAGMA.vl_N81P4.js → erDiagram-SMLLAGMA.BIb5ghCk.js} +1 -1
  43. package/dist/docs/assets/chunks/{flowDiagram-DWJPFMVM.Cteg8g7I.js → flowDiagram-DWJPFMVM.DV4paY9k.js} +1 -1
  44. package/dist/docs/assets/chunks/{ganttDiagram-T4ZO3ILL.D4aMhlMM.js → ganttDiagram-T4ZO3ILL.AyEKA6_v.js} +1 -1
  45. package/dist/docs/assets/chunks/{gitGraphDiagram-UUTBAWPF.DF_J0D4q.js → gitGraphDiagram-UUTBAWPF.BltiCDFo.js} +1 -1
  46. package/dist/docs/assets/chunks/{graph.DJs0LDCf.js → graph.DzuEYGdC.js} +1 -1
  47. package/dist/docs/assets/chunks/{infoDiagram-42DDH7IO.Bb-4RQwg.js → infoDiagram-42DDH7IO.BV2l981J.js} +1 -1
  48. package/dist/docs/assets/chunks/{ishikawaDiagram-UXIWVN3A.DEtQRSbc.js → ishikawaDiagram-UXIWVN3A.BA4Izf-m.js} +1 -1
  49. package/dist/docs/assets/chunks/{journeyDiagram-VCZTEJTY.DhQQ75FA.js → journeyDiagram-VCZTEJTY.DjaFbFS3.js} +1 -1
  50. package/dist/docs/assets/chunks/{kanban-definition-6JOO6SKY.C4gEw3Rk.js → kanban-definition-6JOO6SKY.CfTFieDs.js} +1 -1
  51. package/dist/docs/assets/chunks/{layout.DT-PGlXa.js → layout.DzfWqTBV.js} +1 -1
  52. package/dist/docs/assets/chunks/{linear.BMMe__JW.js → linear.BO6mpulV.js} +1 -1
  53. package/dist/docs/assets/chunks/{min.XyaU9K9Q.js → min.BGgTadgT.js} +1 -1
  54. package/dist/docs/assets/chunks/{mindmap-definition-QFDTVHPH.CbBM6xZ-.js → mindmap-definition-QFDTVHPH.DPuIXVWY.js} +1 -1
  55. package/dist/docs/assets/chunks/{pieDiagram-DEJITSTG.DFJoIVou.js → pieDiagram-DEJITSTG.BOnl3bBg.js} +1 -1
  56. package/dist/docs/assets/chunks/{quadrantDiagram-34T5L4WZ.CQjkDYqb.js → quadrantDiagram-34T5L4WZ.DNB6Ckdc.js} +1 -1
  57. package/dist/docs/assets/chunks/{requirementDiagram-MS252O5E.D-mK-JQu.js → requirementDiagram-MS252O5E.D5-Qo7vb.js} +1 -1
  58. package/dist/docs/assets/chunks/{sankeyDiagram-XADWPNL6.BStQInpd.js → sankeyDiagram-XADWPNL6.8t65cesf.js} +1 -1
  59. package/dist/docs/assets/chunks/{sequenceDiagram-FGHM5R23.CA_eooPJ.js → sequenceDiagram-FGHM5R23.CaG07BdS.js} +1 -1
  60. package/dist/docs/assets/chunks/{stateDiagram-FHFEXIEX.BXl-b7ad.js → stateDiagram-FHFEXIEX.TKOweTB6.js} +1 -1
  61. package/dist/docs/assets/chunks/stateDiagram-v2-QKLJ7IA2.CuqmyQc4.js +1 -0
  62. package/dist/docs/assets/chunks/{theme.q37tOs4x.js → theme.Dx-JhpTB.js} +2 -2
  63. package/dist/docs/assets/chunks/{timeline-definition-GMOUNBTQ.vjuaGOSe.js → timeline-definition-GMOUNBTQ.fE53zQ2s.js} +1 -1
  64. package/dist/docs/assets/chunks/{vennDiagram-DHZGUBPP.BxduJl-F.js → vennDiagram-DHZGUBPP.DJsZZaJg.js} +1 -1
  65. package/dist/docs/assets/chunks/wardley-RL74JXVD.844kyrjl.js +162 -0
  66. package/dist/docs/assets/chunks/{wardleyDiagram-NUSXRM2D.D1z3ds0D.js → wardleyDiagram-NUSXRM2D.CMZ-Ru_t.js} +1 -1
  67. package/dist/docs/assets/chunks/{xychartDiagram-5P7HB3ND.CRU5Ti9b.js → xychartDiagram-5P7HB3ND.XXrhBc7a.js} +1 -1
  68. package/dist/docs/assets/{deployment.md.nGo1yIsa.js → deployment.md.UhnJIMr-.js} +6 -9
  69. package/dist/docs/assets/{deployment.md.nGo1yIsa.lean.js → deployment.md.UhnJIMr-.lean.js} +1 -1
  70. package/dist/docs/assets/{guides_github.md.C2_DSWlE.js → guides_github.md.Bq9kQU9B.js} +9 -3
  71. package/dist/docs/assets/{guides_github.md.C2_DSWlE.lean.js → guides_github.md.Bq9kQU9B.lean.js} +1 -1
  72. package/dist/docs/assets/{guides_jev.md.BNDm14Gy.js → guides_jev.md.CRcgmjDb.js} +2 -2
  73. package/dist/docs/assets/{guides_jev.md.BNDm14Gy.lean.js → guides_jev.md.CRcgmjDb.lean.js} +1 -1
  74. package/dist/docs/assets/{guides_slack.md.ZbHQETOT.js → guides_slack.md.diqqXTTm.js} +2 -2
  75. package/dist/docs/assets/{guides_slack.md.ZbHQETOT.lean.js → guides_slack.md.diqqXTTm.lean.js} +1 -1
  76. package/dist/docs/assets/{quickstart.md.wG4shE1f.js → quickstart.md.CHpHPBUN.js} +5 -3
  77. package/dist/docs/assets/{quickstart.md.wG4shE1f.lean.js → quickstart.md.CHpHPBUN.lean.js} +1 -1
  78. package/dist/docs/assets/{reference_agent-config.md.DzGI777n.js → reference_agent-config.md.Cj5uBKp4.js} +1 -1
  79. package/dist/docs/assets/{reference_artifacts.md.CFMNPreZ.js → reference_artifacts.md.CQfKq8F2.js} +1 -1
  80. package/dist/docs/assets/reference_cli.md.DgeLTO18.js +91 -0
  81. package/dist/docs/assets/reference_cli.md.DgeLTO18.lean.js +1 -0
  82. package/dist/docs/assets/{reference_connections.md._XpKiOaF.js → reference_connections.md.COq--gAm.js} +7 -3
  83. package/dist/docs/assets/{reference_connections.md._XpKiOaF.lean.js → reference_connections.md.COq--gAm.lean.js} +1 -1
  84. package/dist/docs/assets/{reference_evals.md.DqNyHMA6.js → reference_evals.md.CJm3uCUm.js} +4 -4
  85. package/dist/docs/assets/{reference_evals.md.DqNyHMA6.lean.js → reference_evals.md.CJm3uCUm.lean.js} +1 -1
  86. package/dist/docs/assets/{reference_extensions.md.CPPrkWlJ.js → reference_extensions.md.pa2tN-e4.js} +4 -3
  87. package/dist/docs/assets/{reference_extensions.md.CPPrkWlJ.lean.js → reference_extensions.md.pa2tN-e4.lean.js} +1 -1
  88. package/dist/docs/assets/{reference_skills.md.CRFTxt9M.js → reference_skills.md.Cy00QMKS.js} +3 -3
  89. package/dist/docs/assets/{reference_skills.md.CRFTxt9M.lean.js → reference_skills.md.Cy00QMKS.lean.js} +1 -1
  90. package/dist/docs/assets/troubleshooting.md.Cw5PKa3t.js +1 -0
  91. package/dist/docs/assets/{troubleshooting.md.BzZSu1Gz.lean.js → troubleshooting.md.Cw5PKa3t.lean.js} +1 -1
  92. package/dist/docs/building-with-agents.html +35 -35
  93. package/dist/docs/deployment.html +41 -44
  94. package/dist/docs/deployment.md +49 -16
  95. package/dist/docs/evals.html +35 -35
  96. package/dist/docs/guides/agent-to-agent.html +35 -35
  97. package/dist/docs/guides/bitbucket.html +35 -35
  98. package/dist/docs/guides/cloud-agents.html +35 -35
  99. package/dist/docs/guides/convert-automation.html +35 -35
  100. package/dist/docs/guides/github.html +43 -37
  101. package/dist/docs/guides/github.md +34 -0
  102. package/dist/docs/guides/gitlab.html +35 -35
  103. package/dist/docs/guides/grokbot-agents.html +35 -35
  104. package/dist/docs/guides/hooks.html +35 -35
  105. package/dist/docs/guides/improve.html +35 -35
  106. package/dist/docs/guides/jev.html +37 -37
  107. package/dist/docs/guides/jev.md +7 -0
  108. package/dist/docs/guides/mcp-oauth.html +35 -35
  109. package/dist/docs/guides/opentelemetry.html +35 -35
  110. package/dist/docs/guides/slack.html +37 -37
  111. package/dist/docs/guides/slack.md +5 -0
  112. package/dist/docs/guides/webhooks.html +35 -35
  113. package/dist/docs/hashmap.json +1 -1
  114. package/dist/docs/hillclimbing.html +35 -35
  115. package/dist/docs/index.html +35 -35
  116. package/dist/docs/llms-full.txt +223 -94
  117. package/dist/docs/quickstart.html +40 -38
  118. package/dist/docs/quickstart.md +7 -1
  119. package/dist/docs/reference/agent-config.html +37 -37
  120. package/dist/docs/reference/agent-config.md +1 -1
  121. package/dist/docs/reference/artifacts.html +37 -37
  122. package/dist/docs/reference/artifacts.md +1 -1
  123. package/dist/docs/reference/channels.html +35 -35
  124. package/dist/docs/reference/cli.html +55 -61
  125. package/dist/docs/reference/cli.md +65 -63
  126. package/dist/docs/reference/connections.html +42 -38
  127. package/dist/docs/reference/connections.md +28 -2
  128. package/dist/docs/reference/evals.html +39 -39
  129. package/dist/docs/reference/evals.md +6 -7
  130. package/dist/docs/reference/extensions.html +39 -38
  131. package/dist/docs/reference/extensions.md +13 -0
  132. package/dist/docs/reference/hooks.html +35 -35
  133. package/dist/docs/reference/http-api.html +35 -35
  134. package/dist/docs/reference/instructions.html +35 -35
  135. package/dist/docs/reference/playground.html +35 -35
  136. package/dist/docs/reference/project-layout.html +35 -35
  137. package/dist/docs/reference/prompt.html +35 -35
  138. package/dist/docs/reference/schedules.html +35 -35
  139. package/dist/docs/reference/sessions.html +35 -35
  140. package/dist/docs/reference/skills.html +38 -38
  141. package/dist/docs/reference/subagents.html +35 -35
  142. package/dist/docs/reference/tools.html +35 -35
  143. package/dist/docs/templates/agentic-owners.html +35 -35
  144. package/dist/docs/templates/security-reviewer.html +35 -35
  145. package/dist/docs/templates/thermo-quality-review.html +35 -35
  146. package/dist/docs/templates/thermo-review.html +35 -35
  147. package/dist/docs/templates/triage.html +35 -35
  148. package/dist/docs/troubleshooting.html +36 -36
  149. package/dist/docs/troubleshooting.md +7 -3
  150. package/dist/extensions/cursor-grokbot-agents/extension.d.ts +77 -0
  151. package/dist/extensions/cursor-grokbot-agents/extension.d.ts.map +1 -0
  152. package/dist/extensions/cursor-grokbot-agents/extension.js +63 -0
  153. package/dist/extensions/cursor-grokbot-agents/lib/agents.d.ts +11 -0
  154. package/dist/extensions/cursor-grokbot-agents/lib/agents.d.ts.map +1 -0
  155. package/dist/extensions/cursor-grokbot-agents/lib/agents.js +31 -0
  156. package/dist/extensions/cursor-grokbot-agents/lib/backend.d.ts +56 -0
  157. package/dist/extensions/cursor-grokbot-agents/lib/backend.d.ts.map +1 -0
  158. package/dist/extensions/cursor-grokbot-agents/lib/backend.js +158 -0
  159. package/dist/extensions/cursor-grokbot-agents/lib/contacts.d.ts +28 -0
  160. package/dist/extensions/cursor-grokbot-agents/lib/contacts.d.ts.map +1 -0
  161. package/dist/extensions/cursor-grokbot-agents/lib/contacts.js +59 -0
  162. package/dist/extensions/cursor-grokbot-agents/lib/conversation.d.ts +53 -0
  163. package/dist/extensions/cursor-grokbot-agents/lib/conversation.d.ts.map +1 -0
  164. package/dist/extensions/cursor-grokbot-agents/lib/conversation.js +206 -0
  165. package/dist/extensions/cursor-grokbot-agents/lib/inputs.d.ts +4 -0
  166. package/dist/extensions/cursor-grokbot-agents/lib/inputs.d.ts.map +1 -0
  167. package/dist/extensions/cursor-grokbot-agents/lib/inputs.js +15 -0
  168. package/dist/extensions/cursor-grokbot-agents/lib/lock.d.ts +12 -0
  169. package/dist/extensions/cursor-grokbot-agents/lib/lock.d.ts.map +1 -0
  170. package/dist/extensions/cursor-grokbot-agents/lib/lock.js +25 -0
  171. package/dist/extensions/cursor-grokbot-agents/skills/consult.md +40 -0
  172. package/dist/extensions/cursor-grokbot-agents/tools/ask.d.ts +4 -0
  173. package/dist/extensions/cursor-grokbot-agents/tools/ask.d.ts.map +1 -0
  174. package/dist/extensions/cursor-grokbot-agents/tools/ask.js +37 -0
  175. package/dist/extensions/cursor-grokbot-agents/tools/check.d.ts +4 -0
  176. package/dist/extensions/cursor-grokbot-agents/tools/check.d.ts.map +1 -0
  177. package/dist/extensions/cursor-grokbot-agents/tools/check.js +32 -0
  178. package/dist/extensions/cursor-grokbot-agents/tools/interrupt.d.ts +4 -0
  179. package/dist/extensions/cursor-grokbot-agents/tools/interrupt.d.ts.map +1 -0
  180. package/dist/extensions/cursor-grokbot-agents/tools/interrupt.js +24 -0
  181. package/dist/extensions/cursor-grokbot-agents/tools/list.d.ts +4 -0
  182. package/dist/extensions/cursor-grokbot-agents/tools/list.d.ts.map +1 -0
  183. package/dist/extensions/cursor-grokbot-agents/tools/list.js +34 -0
  184. package/dist/extensions/jev/extension.d.ts +3 -0
  185. package/dist/extensions/jev/extension.d.ts.map +1 -1
  186. package/dist/extensions/jev/extension.js +10 -1
  187. package/dist/extensions/jev/lib/evaluate.d.ts +4 -0
  188. package/dist/extensions/jev/lib/evaluate.d.ts.map +1 -1
  189. package/dist/extensions/jev/lib/evaluate.js +6 -2
  190. package/dist/extensions.d.ts +4 -2
  191. package/dist/extensions.d.ts.map +1 -1
  192. package/dist/extensions.js +5 -2
  193. package/dist/internal/cli-ax.d.ts +1 -0
  194. package/dist/internal/cli-ax.d.ts.map +1 -1
  195. package/dist/internal/cli-ax.js +43 -10
  196. package/dist/internal/cli-deploy.d.ts +5 -1
  197. package/dist/internal/cli-deploy.d.ts.map +1 -1
  198. package/dist/internal/cli-deploy.js +41 -9
  199. package/dist/internal/cli-mcp-oauth.d.ts.map +1 -1
  200. package/dist/internal/cli-mcp-oauth.js +2 -1
  201. package/dist/internal/cli-skills.d.ts +1 -1
  202. package/dist/internal/cli-skills.d.ts.map +1 -1
  203. package/dist/internal/cli-skills.js +5 -5
  204. package/dist/internal/connection-env.d.ts +31 -0
  205. package/dist/internal/connection-env.d.ts.map +1 -0
  206. package/dist/internal/connection-env.js +84 -0
  207. package/dist/internal/cursor/backend-client.js +5 -0
  208. package/dist/internal/deploy-client.d.ts +30 -6
  209. package/dist/internal/deploy-client.d.ts.map +1 -1
  210. package/dist/internal/deploy-client.js +45 -9
  211. package/dist/internal/discovery/agent-config.d.ts +6 -5
  212. package/dist/internal/discovery/agent-config.d.ts.map +1 -1
  213. package/dist/internal/discovery/agent-config.js +29 -28
  214. package/dist/internal/discovery/agent.js +1 -1
  215. package/dist/internal/discovery/connections.d.ts.map +1 -1
  216. package/dist/internal/discovery/connections.js +11 -0
  217. package/dist/internal/discovery/extensions.d.ts.map +1 -1
  218. package/dist/internal/discovery/extensions.js +12 -0
  219. package/dist/internal/hosted-delivery-protocol.d.ts +36 -11
  220. package/dist/internal/hosted-delivery-protocol.d.ts.map +1 -1
  221. package/dist/internal/hosted-delivery-protocol.js +31 -8
  222. package/dist/internal/hosted-delivery.d.ts +2 -2
  223. package/dist/internal/hosted-delivery.d.ts.map +1 -1
  224. package/dist/internal/hosted-delivery.js +228 -48
  225. package/dist/internal/hosting.d.ts +10 -2
  226. package/dist/internal/hosting.d.ts.map +1 -1
  227. package/dist/internal/hosting.js +33 -3
  228. package/dist/internal/install-cursor-skills.d.ts +20 -24
  229. package/dist/internal/install-cursor-skills.d.ts.map +1 -1
  230. package/dist/internal/install-cursor-skills.js +50 -48
  231. package/dist/internal/legacy-command-guard.d.ts +2 -0
  232. package/dist/internal/legacy-command-guard.d.ts.map +1 -1
  233. package/dist/internal/legacy-command-guard.js +10 -1
  234. package/dist/internal/mcp-host.d.ts +6 -0
  235. package/dist/internal/mcp-host.d.ts.map +1 -1
  236. package/dist/internal/mcp-host.js +35 -16
  237. package/dist/internal/sdk-runner.d.ts +2 -0
  238. package/dist/internal/sdk-runner.d.ts.map +1 -1
  239. package/dist/internal/sdk-runner.js +10 -0
  240. package/dist/internal/server.d.ts.map +1 -1
  241. package/dist/internal/server.js +11 -1
  242. package/dist/internal/session-engine.d.ts.map +1 -1
  243. package/dist/internal/session-engine.js +9 -5
  244. package/dist/types.d.ts +29 -3
  245. package/dist/types.d.ts.map +1 -1
  246. package/docs/deployment.md +49 -16
  247. package/docs/guides/github.md +34 -0
  248. package/docs/guides/jev.md +7 -0
  249. package/docs/guides/slack.md +5 -0
  250. package/docs/quickstart.md +7 -1
  251. package/docs/reference/agent-config.md +1 -1
  252. package/docs/reference/artifacts.md +1 -1
  253. package/docs/reference/cli.md +65 -63
  254. package/docs/reference/connections.md +28 -2
  255. package/docs/reference/evals.md +6 -7
  256. package/docs/reference/extensions.md +13 -0
  257. package/docs/troubleshooting.md +7 -3
  258. package/package.json +1 -11
  259. package/scripts/install-cursor-skills.mjs +1 -1
  260. package/skills/create-agent/SKILL.md +1 -1
  261. package/skills/debug/SKILL.md +1 -1
  262. package/skills/deploy/SKILL.md +1 -1
  263. package/skills/evals/SKILL.md +1 -1
  264. package/skills/framework-map/SKILL.md +1 -1
  265. package/skills/github/SKILL.md +1 -1
  266. package/skills/hillclimb/SKILL.md +1 -1
  267. package/skills/mcp-auth/SKILL.md +1 -1
  268. package/skills/otel/SKILL.md +1 -1
  269. package/skills/setup-slack/SKILL.md +1 -1
  270. package/templates/agents-md/bot/lib/collect.ts +1 -4
  271. package/templates/code-wiki/bot/channels/github.ts +2 -2
  272. package/templates/demo/bot/channels/github.ts +5 -1
  273. package/templates/pr-autofixer/bot/lib/start-drive.ts +4 -4
  274. package/templates/triage/bot/lib/types.ts +6 -6
  275. package/dist/docs/assets/chunks/@localSearchIndexroot.BgTA2tV1.js +0 -1
  276. package/dist/docs/assets/chunks/channel.B2nMEx82.js +0 -1
  277. package/dist/docs/assets/chunks/classDiagram-6PBFFD2Q.D8iCH2ve.js +0 -1
  278. package/dist/docs/assets/chunks/classDiagram-v2-HSJHXN6E.D8iCH2ve.js +0 -1
  279. package/dist/docs/assets/chunks/clone.5XNLjby0.js +0 -1
  280. package/dist/docs/assets/chunks/stateDiagram-v2-QKLJ7IA2.yGM2uLZQ.js +0 -1
  281. package/dist/docs/assets/chunks/wardley-RL74JXVD.DKfyIejL.js +0 -162
  282. package/dist/docs/assets/reference_cli.md.BK2QUH67.js +0 -97
  283. package/dist/docs/assets/reference_cli.md.BK2QUH67.lean.js +0 -1
  284. package/dist/docs/assets/troubleshooting.md.BzZSu1Gz.js +0 -1
  285. package/src/artifacts.ts +0 -68
  286. package/src/bin/agent-serve.ts +0 -1833
  287. package/src/channels/bitbucket/api.ts +0 -891
  288. package/src/channels/bitbucket/binding.ts +0 -417
  289. package/src/channels/bitbucket/bitbucket-channel.ts +0 -162
  290. package/src/channels/bitbucket/bitbucket-webhook.ts +0 -519
  291. package/src/channels/bitbucket/checks.ts +0 -146
  292. package/src/channels/bitbucket/cursor-account.ts +0 -106
  293. package/src/channels/bitbucket/defaults.ts +0 -100
  294. package/src/channels/bitbucket/events.ts +0 -74
  295. package/src/channels/bitbucket/index.ts +0 -51
  296. package/src/channels/bitbucket/replay.ts +0 -421
  297. package/src/channels/bitbucket/state.ts +0 -59
  298. package/src/channels/bitbucket/types.ts +0 -261
  299. package/src/channels/change-monitors/change-monitors-channel.ts +0 -63
  300. package/src/channels/change-monitors/index.ts +0 -8
  301. package/src/channels/change-monitors/types.ts +0 -42
  302. package/src/channels/checks.ts +0 -185
  303. package/src/channels/deployments/deployments-channel.ts +0 -224
  304. package/src/channels/deployments/index.ts +0 -25
  305. package/src/channels/deployments/types.ts +0 -92
  306. package/src/channels/github/api.ts +0 -526
  307. package/src/channels/github/auth.ts +0 -254
  308. package/src/channels/github/binding.ts +0 -233
  309. package/src/channels/github/checks.ts +0 -145
  310. package/src/channels/github/cursor-account.ts +0 -303
  311. package/src/channels/github/defaults.ts +0 -168
  312. package/src/channels/github/events.ts +0 -67
  313. package/src/channels/github/forward.ts +0 -359
  314. package/src/channels/github/github-channel.ts +0 -2334
  315. package/src/channels/github/index.ts +0 -54
  316. package/src/channels/github/progress.ts +0 -365
  317. package/src/channels/github/replay.ts +0 -372
  318. package/src/channels/github/state.ts +0 -124
  319. package/src/channels/github/types.ts +0 -590
  320. package/src/channels/gitlab/api.ts +0 -329
  321. package/src/channels/gitlab/binding.ts +0 -231
  322. package/src/channels/gitlab/checks.ts +0 -228
  323. package/src/channels/gitlab/cursor-account.ts +0 -105
  324. package/src/channels/gitlab/defaults.ts +0 -80
  325. package/src/channels/gitlab/events.ts +0 -37
  326. package/src/channels/gitlab/gitlab-channel.ts +0 -160
  327. package/src/channels/gitlab/gitlab-webhook.ts +0 -509
  328. package/src/channels/gitlab/index.ts +0 -44
  329. package/src/channels/gitlab/replay.ts +0 -328
  330. package/src/channels/gitlab/state.ts +0 -55
  331. package/src/channels/gitlab/types.ts +0 -247
  332. package/src/channels/issues/index.ts +0 -9
  333. package/src/channels/issues/issues-channel.ts +0 -45
  334. package/src/channels/issues/types.ts +0 -38
  335. package/src/channels/origin/api.ts +0 -507
  336. package/src/channels/origin/binding.ts +0 -114
  337. package/src/channels/origin/checks.ts +0 -250
  338. package/src/channels/origin/cursor-account.ts +0 -58
  339. package/src/channels/origin/defaults.ts +0 -140
  340. package/src/channels/origin/events.ts +0 -35
  341. package/src/channels/origin/index.ts +0 -35
  342. package/src/channels/origin/origin-channel.ts +0 -815
  343. package/src/channels/origin/origin-webhook.ts +0 -296
  344. package/src/channels/origin/reactions.ts +0 -72
  345. package/src/channels/origin/state.ts +0 -54
  346. package/src/channels/origin/types.ts +0 -295
  347. package/src/channels/slack/agentic-delivery.ts +0 -634
  348. package/src/channels/slack/agentic-posted.ts +0 -135
  349. package/src/channels/slack/agentic-signals.ts +0 -231
  350. package/src/channels/slack/api.ts +0 -761
  351. package/src/channels/slack/approvals.ts +0 -279
  352. package/src/channels/slack/assistant.ts +0 -76
  353. package/src/channels/slack/attachments.ts +0 -596
  354. package/src/channels/slack/auth.ts +0 -127
  355. package/src/channels/slack/blocks.ts +0 -131
  356. package/src/channels/slack/bot-mentions.ts +0 -318
  357. package/src/channels/slack/channel-watch.ts +0 -314
  358. package/src/channels/slack/cli-project.ts +0 -249
  359. package/src/channels/slack/code-fences.ts +0 -171
  360. package/src/channels/slack/constants.ts +0 -38
  361. package/src/channels/slack/credentials.ts +0 -88
  362. package/src/channels/slack/defaults.ts +0 -714
  363. package/src/channels/slack/dispatch.ts +0 -1060
  364. package/src/channels/slack/doctor.ts +0 -338
  365. package/src/channels/slack/eval-directive.ts +0 -306
  366. package/src/channels/slack/event-id-dedupe.ts +0 -30
  367. package/src/channels/slack/external-policy.ts +0 -75
  368. package/src/channels/slack/footer.ts +0 -106
  369. package/src/channels/slack/inbound.ts +0 -416
  370. package/src/channels/slack/index.ts +0 -53
  371. package/src/channels/slack/init.ts +0 -169
  372. package/src/channels/slack/interactive.ts +0 -406
  373. package/src/channels/slack/links.ts +0 -23
  374. package/src/channels/slack/live-delivery.ts +0 -489
  375. package/src/channels/slack/log.ts +0 -70
  376. package/src/channels/slack/manifest.ts +0 -240
  377. package/src/channels/slack/message-body.ts +0 -82
  378. package/src/channels/slack/nudge-carrier.ts +0 -224
  379. package/src/channels/slack/nudge-store.ts +0 -334
  380. package/src/channels/slack/paint-start.ts +0 -93
  381. package/src/channels/slack/placeholder.ts +0 -358
  382. package/src/channels/slack/pr-ref.ts +0 -74
  383. package/src/channels/slack/progress-delivery.ts +0 -138
  384. package/src/channels/slack/reasoning-card.ts +0 -125
  385. package/src/channels/slack/reasoning-chip.ts +0 -41
  386. package/src/channels/slack/recording-sink.ts +0 -167
  387. package/src/channels/slack/redact.ts +0 -6
  388. package/src/channels/slack/reply-options.ts +0 -279
  389. package/src/channels/slack/setup.ts +0 -125
  390. package/src/channels/slack/slack-channel.ts +0 -744
  391. package/src/channels/slack/socket-mode.ts +0 -140
  392. package/src/channels/slack/stop.ts +0 -25
  393. package/src/channels/slack/stream.ts +0 -66
  394. package/src/channels/slack/thread-context.ts +0 -485
  395. package/src/channels/slack/tool-approval-events.ts +0 -233
  396. package/src/channels/slack/tool-cards.ts +0 -198
  397. package/src/channels/slack/tool-chip.ts +0 -34
  398. package/src/channels/slack/types.ts +0 -787
  399. package/src/channels/slack/upload.ts +0 -137
  400. package/src/channels.ts +0 -543
  401. package/src/connections.ts +0 -153
  402. package/src/dashboard-session-url.ts +0 -30
  403. package/src/evals/assertions.ts +0 -688
  404. package/src/evals/expect.ts +0 -250
  405. package/src/evals/judge.ts +0 -329
  406. package/src/evals/loaders.ts +0 -111
  407. package/src/evals/matchers.ts +0 -223
  408. package/src/evals/reporters.ts +0 -257
  409. package/src/evals/results.ts +0 -130
  410. package/src/evals/run-facts.ts +0 -306
  411. package/src/evals.ts +0 -709
  412. package/src/extensions/cursor-cloud-agents/extension.ts +0 -131
  413. package/src/extensions/cursor-cloud-agents/lib/backend.ts +0 -386
  414. package/src/extensions/cursor-cloud-agents/lib/channels.ts +0 -11
  415. package/src/extensions/cursor-cloud-agents/lib/fleet.ts +0 -98
  416. package/src/extensions/cursor-cloud-agents/lib/inputs.ts +0 -5
  417. package/src/extensions/cursor-cloud-agents/lib/repos.ts +0 -80
  418. package/src/extensions/cursor-cloud-agents/lib/transcript.ts +0 -19
  419. package/src/extensions/cursor-cloud-agents/skills/handoff.md +0 -37
  420. package/src/extensions/cursor-cloud-agents/tools/cancel.ts +0 -21
  421. package/src/extensions/cursor-cloud-agents/tools/dump.ts +0 -47
  422. package/src/extensions/cursor-cloud-agents/tools/get.ts +0 -18
  423. package/src/extensions/cursor-cloud-agents/tools/launch.ts +0 -62
  424. package/src/extensions/cursor-cloud-agents/tools/list.ts +0 -31
  425. package/src/extensions/cursor-cloud-agents/tools/reply.ts +0 -36
  426. package/src/extensions/improve/extension.ts +0 -69
  427. package/src/extensions/improve/skills/yourself.ts +0 -50
  428. package/src/extensions/jev/extension.ts +0 -95
  429. package/src/extensions/jev/lib/evaluate.ts +0 -266
  430. package/src/extensions/jev/skills/gated-write.md +0 -25
  431. package/src/extensions/jev/skills/questions.md +0 -33
  432. package/src/extensions/jev/tools/evaluate.ts +0 -82
  433. package/src/extensions/slack-communication/evals/harness.ts +0 -705
  434. package/src/extensions/slack-communication/evals/slack-communication.eval.ts +0 -830
  435. package/src/extensions/slack-communication/evals/slack-placeholder.eval.ts +0 -172
  436. package/src/extensions/slack-communication/extension.ts +0 -44
  437. package/src/extensions/slack-communication/skills/slack-voice.ts +0 -56
  438. package/src/extensions/slack-communication/tools/delete-message.ts +0 -33
  439. package/src/extensions/slack-communication/tools/edit-message.ts +0 -42
  440. package/src/extensions/slack-communication/tools/post-card.ts +0 -28
  441. package/src/extensions/slack-communication/tools/post-file.ts +0 -82
  442. package/src/extensions/slack-communication/tools/post-update.ts +0 -40
  443. package/src/extensions/slack-communication/tools/react.ts +0 -30
  444. package/src/extensions/slack-communication/tools/set-status.ts +0 -21
  445. package/src/extensions.ts +0 -179
  446. package/src/files-backends/agent-store-presigned-url.ts +0 -11
  447. package/src/files-backends/cursor-hosted.ts +0 -1212
  448. package/src/files-backends/local-fs.ts +0 -163
  449. package/src/files.ts +0 -293
  450. package/src/filesystem.ts +0 -2005
  451. package/src/hooks.ts +0 -30
  452. package/src/index.ts +0 -259
  453. package/src/internal/advertise-tools.ts +0 -370
  454. package/src/internal/approval-gate.ts +0 -103
  455. package/src/internal/artifacts-store.ts +0 -836
  456. package/src/internal/as-of.ts +0 -257
  457. package/src/internal/auth.ts +0 -46
  458. package/src/internal/authored-alias-hooks.ts +0 -138
  459. package/src/internal/authored-loaders.ts +0 -188
  460. package/src/internal/bounded-int.ts +0 -24
  461. package/src/internal/bounded.ts +0 -25
  462. package/src/internal/brand.ts +0 -28
  463. package/src/internal/browser-origin-guard.ts +0 -67
  464. package/src/internal/builtin-tools/artifacts.ts +0 -62
  465. package/src/internal/builtin-tools/index.ts +0 -53
  466. package/src/internal/builtin-tools/reminders.ts +0 -145
  467. package/src/internal/channel-dispatch.ts +0 -129
  468. package/src/internal/channel-route-dispatch.ts +0 -58
  469. package/src/internal/channel-state.ts +0 -83
  470. package/src/internal/chat-client.ts +0 -594
  471. package/src/internal/cli-ax.ts +0 -2273
  472. package/src/internal/cli-bitbucket.ts +0 -438
  473. package/src/internal/cli-convert-automation.ts +0 -335
  474. package/src/internal/cli-cursor.ts +0 -282
  475. package/src/internal/cli-deploy.ts +0 -2486
  476. package/src/internal/cli-docs.ts +0 -192
  477. package/src/internal/cli-github.ts +0 -806
  478. package/src/internal/cli-gitlab.ts +0 -452
  479. package/src/internal/cli-images.ts +0 -672
  480. package/src/internal/cli-manifest.ts +0 -56
  481. package/src/internal/cli-mcp-oauth.ts +0 -395
  482. package/src/internal/cli-mcp.ts +0 -808
  483. package/src/internal/cli-skills.ts +0 -99
  484. package/src/internal/cli-slack-manual.ts +0 -418
  485. package/src/internal/cli-slack.ts +0 -874
  486. package/src/internal/cloud-merge.ts +0 -51
  487. package/src/internal/cloud-turn-cost.ts +0 -159
  488. package/src/internal/continuation-channel.ts +0 -233
  489. package/src/internal/continuation-identity.ts +0 -935
  490. package/src/internal/conversation-mirror.ts +0 -423
  491. package/src/internal/convert-automation/convert-workflow.ts +0 -1377
  492. package/src/internal/convert-automation/slug.ts +0 -29
  493. package/src/internal/convert-automation/types.ts +0 -212
  494. package/src/internal/cron.ts +0 -76
  495. package/src/internal/cursor/account-mcp.ts +0 -692
  496. package/src/internal/cursor/backend-client.ts +0 -978
  497. package/src/internal/cursor/bound-secret-file.ts +0 -101
  498. package/src/internal/cursor/credentials.ts +0 -560
  499. package/src/internal/cursor/cursor-api-transport.ts +0 -65
  500. package/src/internal/cursor/github-credentials.ts +0 -228
  501. package/src/internal/cursor/hosted-bound-secrets.ts +0 -71
  502. package/src/internal/cursor/hosted-deployment-secrets.ts +0 -100
  503. package/src/internal/cursor/hosted-store-secrets.ts +0 -152
  504. package/src/internal/cursor/session-token.ts +0 -111
  505. package/src/internal/cursor/store-api-client.ts +0 -323
  506. package/src/internal/cursor-account-mcp-auth.ts +0 -303
  507. package/src/internal/cursor-agent-template.ts +0 -50
  508. package/src/internal/cursor-deployment-relay.ts +0 -315
  509. package/src/internal/cursor-event-relay.ts +0 -675
  510. package/src/internal/cursor-relay-core.ts +0 -563
  511. package/src/internal/deferred-channel-session.ts +0 -61
  512. package/src/internal/deploy-client.ts +0 -1504
  513. package/src/internal/deploy-manifest.ts +0 -361
  514. package/src/internal/deploy-source.ts +0 -144
  515. package/src/internal/describe-error.ts +0 -32
  516. package/src/internal/dev-mode.ts +0 -20
  517. package/src/internal/discovery/agent-config.ts +0 -288
  518. package/src/internal/discovery/agent.ts +0 -381
  519. package/src/internal/discovery/channels.ts +0 -100
  520. package/src/internal/discovery/connections.ts +0 -505
  521. package/src/internal/discovery/context.ts +0 -38
  522. package/src/internal/discovery/cursor-plugin.ts +0 -628
  523. package/src/internal/discovery/extension-overlay.ts +0 -247
  524. package/src/internal/discovery/extensions.ts +0 -490
  525. package/src/internal/discovery/fs.ts +0 -103
  526. package/src/internal/discovery/hooks.ts +0 -63
  527. package/src/internal/discovery/info.ts +0 -174
  528. package/src/internal/discovery/instructions.ts +0 -98
  529. package/src/internal/discovery/modules.ts +0 -107
  530. package/src/internal/discovery/names.ts +0 -45
  531. package/src/internal/discovery/project.ts +0 -319
  532. package/src/internal/discovery/reminders.ts +0 -65
  533. package/src/internal/discovery/runtime.ts +0 -158
  534. package/src/internal/discovery/schedules.ts +0 -120
  535. package/src/internal/discovery/seed-files.ts +0 -34
  536. package/src/internal/discovery/services.ts +0 -151
  537. package/src/internal/discovery/skills.ts +0 -174
  538. package/src/internal/discovery/subagent.ts +0 -138
  539. package/src/internal/discovery/tools.ts +0 -170
  540. package/src/internal/discovery.ts +0 -27
  541. package/src/internal/distribution.ts +0 -126
  542. package/src/internal/docs-site.ts +0 -248
  543. package/src/internal/duration.ts +0 -37
  544. package/src/internal/env-file.ts +0 -83
  545. package/src/internal/eval-judge-model.ts +0 -142
  546. package/src/internal/eval-run-store.ts +0 -585
  547. package/src/internal/eval-runner.ts +0 -823
  548. package/src/internal/evals-client.ts +0 -475
  549. package/src/internal/event-log.ts +0 -342
  550. package/src/internal/event-mapper.ts +0 -811
  551. package/src/internal/expected-delivery-failure.ts +0 -34
  552. package/src/internal/factory-resource-channel.ts +0 -103
  553. package/src/internal/filesystem/errors.ts +0 -207
  554. package/src/internal/filesystem/format.ts +0 -253
  555. package/src/internal/filesystem/merge.ts +0 -192
  556. package/src/internal/filesystem/nearest.ts +0 -112
  557. package/src/internal/filesystem/scratch.ts +0 -239
  558. package/src/internal/filesystem/sdk-schemas.ts +0 -204
  559. package/src/internal/filesystem/tools.ts +0 -804
  560. package/src/internal/filesystem/walk.ts +0 -366
  561. package/src/internal/fixtures/units-server.ts +0 -52
  562. package/src/internal/framework-file-storage.ts +0 -357
  563. package/src/internal/framework-storage-selection.ts +0 -156
  564. package/src/internal/frontmatter.ts +0 -108
  565. package/src/internal/github-fanout.ts +0 -144
  566. package/src/internal/guest-network.ts +0 -391
  567. package/src/internal/handleAgentServeTrigger.ts +0 -286
  568. package/src/internal/host-files.ts +0 -341
  569. package/src/internal/host-kv.ts +0 -81
  570. package/src/internal/host-otel.ts +0 -231
  571. package/src/internal/host-platforms.ts +0 -170
  572. package/src/internal/hosted-admission-adapter.ts +0 -47
  573. package/src/internal/hosted-admission-context.ts +0 -37
  574. package/src/internal/hosted-catch-protocol.ts +0 -112
  575. package/src/internal/hosted-catch.ts +0 -179
  576. package/src/internal/hosted-delivery-protocol.ts +0 -787
  577. package/src/internal/hosted-delivery.ts +0 -1152
  578. package/src/internal/hosted-execution-diag.ts +0 -291
  579. package/src/internal/hosted-execution-flush.ts +0 -136
  580. package/src/internal/hosted-execution-latency.ts +0 -301
  581. package/src/internal/hosted-managed-automation.ts +0 -116
  582. package/src/internal/hosting.ts +0 -107
  583. package/src/internal/http-channel-define.ts +0 -25
  584. package/src/internal/http-channel.ts +0 -669
  585. package/src/internal/http-control-plane-session.ts +0 -110
  586. package/src/internal/ids.ts +0 -39
  587. package/src/internal/incoming-headers-to-fetch.ts +0 -45
  588. package/src/internal/init-interview.ts +0 -360
  589. package/src/internal/init-project.ts +0 -711
  590. package/src/internal/init-scaffold.ts +0 -182
  591. package/src/internal/inline-stdio-define-stub.ts +0 -4
  592. package/src/internal/inline-stdio-mcp.ts +0 -230
  593. package/src/internal/install-cursor-skills.ts +0 -601
  594. package/src/internal/is-record.ts +0 -3
  595. package/src/internal/json-schema.ts +0 -95
  596. package/src/internal/legacy-command-guard.ts +0 -54
  597. package/src/internal/listen-port.ts +0 -85
  598. package/src/internal/local-control-plane.ts +0 -442
  599. package/src/internal/local-env.ts +0 -59
  600. package/src/internal/local-ingress.ts +0 -90
  601. package/src/internal/log-ring.ts +0 -59
  602. package/src/internal/logs-client.ts +0 -477
  603. package/src/internal/map-pool.ts +0 -39
  604. package/src/internal/mcp-endpoint.ts +0 -747
  605. package/src/internal/mcp-host.ts +0 -481
  606. package/src/internal/mcp-oauth-on-demand.ts +0 -337
  607. package/src/internal/mcp-oauth-persist.ts +0 -118
  608. package/src/internal/mcp-oauth.ts +0 -549
  609. package/src/internal/net.ts +0 -29
  610. package/src/internal/open-browser.ts +0 -41
  611. package/src/internal/otel/attrs.ts +0 -16
  612. package/src/internal/otel/collector.ts +0 -937
  613. package/src/internal/otel/config.ts +0 -287
  614. package/src/internal/otel/http.ts +0 -122
  615. package/src/internal/otel/mcp.ts +0 -56
  616. package/src/internal/otel/propagation.ts +0 -17
  617. package/src/internal/otel/runtime.ts +0 -441
  618. package/src/internal/package-inline-stdio.ts +0 -114
  619. package/src/internal/peer-connections.ts +0 -96
  620. package/src/internal/platform-schedule-sync.ts +0 -75
  621. package/src/internal/platform-timers.ts +0 -365
  622. package/src/internal/playground/static.ts +0 -278
  623. package/src/internal/playground/toolchain.ts +0 -270
  624. package/src/internal/playground-proxy.ts +0 -564
  625. package/src/internal/process-memory-telemetry.ts +0 -334
  626. package/src/internal/project-layout.ts +0 -31
  627. package/src/internal/prompt-context.ts +0 -116
  628. package/src/internal/reminder-control-plane-protocol.ts +0 -482
  629. package/src/internal/reminder-runner.ts +0 -1559
  630. package/src/internal/reminder-schedule.ts +0 -104
  631. package/src/internal/reminder-store.ts +0 -176
  632. package/src/internal/request-error-status.ts +0 -95
  633. package/src/internal/request-headers.ts +0 -21
  634. package/src/internal/resolve-prod-target.ts +0 -334
  635. package/src/internal/resolved-connections.ts +0 -190
  636. package/src/internal/router.ts +0 -143
  637. package/src/internal/run-client.ts +0 -354
  638. package/src/internal/runtime-dispatch-runner.ts +0 -50
  639. package/src/internal/sanitize-mcp-tool-name.ts +0 -31
  640. package/src/internal/schedule-runner.ts +0 -154
  641. package/src/internal/scm/pr-url.ts +0 -245
  642. package/src/internal/sdk-runner.ts +0 -948
  643. package/src/internal/serve-restart.ts +0 -113
  644. package/src/internal/server.ts +0 -3135
  645. package/src/internal/session-cost.ts +0 -208
  646. package/src/internal/session-engine.ts +0 -5618
  647. package/src/internal/session-links.ts +0 -84
  648. package/src/internal/session-run-log.ts +0 -535
  649. package/src/internal/session-store.ts +0 -307
  650. package/src/internal/session-urls.ts +0 -32
  651. package/src/internal/sessions-client.ts +0 -239
  652. package/src/internal/skill-catalog.ts +0 -66
  653. package/src/internal/skills-sync.ts +0 -55
  654. package/src/internal/slack-provision-client.ts +0 -544
  655. package/src/internal/slack-thread-key.ts +0 -11
  656. package/src/internal/sleep.ts +0 -3
  657. package/src/internal/start-log-store.ts +0 -164
  658. package/src/internal/steering.ts +0 -17
  659. package/src/internal/storage-coordinator.ts +0 -800
  660. package/src/internal/storage-roles.ts +0 -86
  661. package/src/internal/storage.ts +0 -1
  662. package/src/internal/store-api-protocol.ts +0 -205
  663. package/src/internal/store-mirror.ts +0 -73
  664. package/src/internal/stream-progress.ts +0 -294
  665. package/src/internal/terminal-style.ts +0 -133
  666. package/src/internal/testing/factory-resource-fixtures.ts +0 -84
  667. package/src/internal/testing/scm-continuation-fixtures.ts +0 -285
  668. package/src/internal/tool-catalog.ts +0 -104
  669. package/src/internal/tool-policy.ts +0 -222
  670. package/src/internal/tool-result.ts +0 -50
  671. package/src/internal/trajectory.ts +0 -418
  672. package/src/internal/turn-cost.ts +0 -136
  673. package/src/internal/turn-governor.ts +0 -145
  674. package/src/internal/turn-lease-store.ts +0 -144
  675. package/src/internal/turn-outbox.ts +0 -77
  676. package/src/internal/update-check.ts +0 -517
  677. package/src/internal/v2-hosting.ts +0 -52
  678. package/src/internal/workspace-sync.ts +0 -114
  679. package/src/internal/workspace.ts +0 -505
  680. package/src/kv/memory-kv.ts +0 -94
  681. package/src/kv.ts +0 -18
  682. package/src/memory.ts +0 -487
  683. package/src/otel-public.ts +0 -24
  684. package/src/otel.ts +0 -320
  685. package/src/prompt.ts +0 -80
  686. package/src/reminders.ts +0 -65
  687. package/src/schedules.ts +0 -31
  688. package/src/skills.ts +0 -27
  689. package/src/storage-backends/cursor-hosted-v2.ts +0 -204
  690. package/src/storage-backends/cursor-hosted.ts +0 -388
  691. package/src/storage-backends/file-kv.ts +0 -276
  692. package/src/storage-protocol.ts +0 -261
  693. package/src/storage.ts +0 -408
  694. package/src/tools.ts +0 -166
  695. package/src/types.ts +0 -3766
  696. /package/dist/docs/assets/{reference_agent-config.md.DzGI777n.lean.js → reference_agent-config.md.Cj5uBKp4.lean.js} +0 -0
  697. /package/dist/docs/assets/{reference_artifacts.md.CFMNPreZ.lean.js → reference_artifacts.md.CQfKq8F2.lean.js} +0 -0
@@ -1,303 +0,0 @@
1
- /**
2
- * Service-account connector authorization for
3
- * `defineConnection({ cursorAccount: true })` on hosted deployments.
4
- *
5
- * Hosted engines authenticate as their deployment's dedicated service
6
- * account, whose connector OAuth tokens live backend-side. This flow is the
7
- * dashboard's Authenticate button as a CLI loop: probe the connectors via
8
- * `CheckHttpMcpStatus` (which mints a complete OAuth `authUrl` per connector
9
- * needing auth), open each URL for the human to grant, and poll until the
10
- * backend reports the token stored. Nothing token-shaped ever touches this
11
- * process — the cursor.com callback stores tokens against the service
12
- * account. Used by `agent-sdk mcp oauth <connection>` and the post-deploy
13
- * hook in `cli-deploy.ts`.
14
- */
15
-
16
- import type {
17
- AvailableMcpServer,
18
- CursorBackendClient,
19
- McpConnectorStatus,
20
- } from "./cursor/backend-client.js";
21
- import { LOG_PREFIX } from "./distribution.js";
22
- import { openBrowser } from "./mcp-oauth.js";
23
- import { sleep as defaultSleep } from "./sleep.js";
24
-
25
- const DEFAULT_POLL_INTERVAL_MS = 3_000;
26
- const DEFAULT_POLL_TIMEOUT_MS = 5 * 60 * 1000;
27
-
28
- /** Same default the dashboard uses; MCP_OAUTH_REDIRECT_URI overrides for dev. */
29
- export function mcpOauthRedirectUri(): string {
30
- const override = process.env.MCP_OAUTH_REDIRECT_URI;
31
- if (override !== undefined && override.trim() !== "") {
32
- return override.trim();
33
- }
34
- return "https://www.cursor.com/agents/mcp/oauth/callback";
35
- }
36
-
37
- export interface AuthorizeCursorAccountConnectorsArgs {
38
- backendClient: Pick<CursorBackendClient, "getAvailableMcpServers" | "checkHttpMcpStatus">;
39
- teamId: number;
40
- slug: string;
41
- /** The deployment's dedicated service account (`sa_…`). */
42
- serviceAccountId: string;
43
- /** Connection name, for log lines. */
44
- connectionName: string;
45
- /** The connection's `servers` filter; undefined = every team connector. */
46
- servers?: string[] | undefined;
47
- /** Open auth URLs and poll for completion (TTY); false = report only. */
48
- interactive: boolean;
49
- out: (text: string) => void;
50
- err: (text: string) => void;
51
- /** Test seams. */
52
- openBrowserImpl?: (url: string) => void;
53
- sleep?: (ms: number) => Promise<void>;
54
- pollIntervalMs?: number;
55
- pollTimeoutMs?: number;
56
- }
57
-
58
- export interface AuthorizeCursorAccountConnectorsResult {
59
- /** Connectors with a stored credential after the flow. */
60
- authorized: string[];
61
- /** Connectors still requiring authorization. */
62
- pending: string[];
63
- /** Connectors the backend could not probe. */
64
- errored: Array<{ name: string; error: string }>;
65
- }
66
-
67
- /**
68
- * Authorize the deployment service account for the connection's connectors.
69
- * Already-authorized connectors are skipped; the rest get a browser OAuth
70
- * each (sequentially), polled until the backend stores the token.
71
- */
72
- export async function authorizeCursorAccountConnectors(
73
- args: AuthorizeCursorAccountConnectorsArgs,
74
- ): Promise<AuthorizeCursorAccountConnectorsResult> {
75
- const { backendClient, teamId, serviceAccountId, connectionName, out, err } = args;
76
- const open = args.openBrowserImpl ?? openBrowser;
77
- const sleep = args.sleep ?? defaultSleep;
78
- const pollIntervalMs = args.pollIntervalMs ?? DEFAULT_POLL_INTERVAL_MS;
79
- const pollTimeoutMs = args.pollTimeoutMs ?? DEFAULT_POLL_TIMEOUT_MS;
80
- const redirectUri = mcpOauthRedirectUri();
81
-
82
- // Team-scoped connectors only: the hosted bridge resolves the SA's team
83
- // servers, so personal connectors can never apply to a deployment.
84
- const available = (await backendClient.getAvailableMcpServers({ teamId })).filter(
85
- server => server.isTeamServer,
86
- );
87
-
88
- const selected = selectConnectors(available, args.servers);
89
- for (const missing of selected.unmatched) {
90
- err(
91
- `${LOG_PREFIX} Connection "${connectionName}" lists connector ${JSON.stringify(missing)}, but the team has no such connector (dashboard → MCP).\n`,
92
- );
93
- }
94
- if (selected.servers.length === 0) {
95
- err(`${LOG_PREFIX} No matching team connectors for connection "${connectionName}".\n`);
96
- return { authorized: [], pending: [], errored: [] };
97
- }
98
-
99
- const nameById = new Map(selected.servers.map(server => [server.id, server.name]));
100
- const statuses = await backendClient.checkHttpMcpStatus({
101
- serverIds: selected.servers.map(server => server.id),
102
- oauthRedirectUri: redirectUri,
103
- serviceAccountId,
104
- });
105
-
106
- const result: AuthorizeCursorAccountConnectorsResult = {
107
- authorized: [],
108
- pending: [],
109
- errored: [],
110
- };
111
-
112
- for (const status of statuses) {
113
- const name = nameById.get(status.id) ?? `#${status.id}`;
114
- if (!status.requiresAuth) {
115
- if (status.error !== undefined && status.error !== "") {
116
- err(`${LOG_PREFIX} ${name}: ${status.error}\n`);
117
- result.errored.push({ name, error: status.error });
118
- continue;
119
- }
120
- out(`${LOG_PREFIX} ${name}: already authorized ✓\n`);
121
- result.authorized.push(name);
122
- continue;
123
- }
124
- if (status.authUrl === undefined || status.authUrl === "") {
125
- const error = status.error ?? "no authorization URL was minted";
126
- err(`${LOG_PREFIX} ${name}: ${error}\n`);
127
- result.errored.push({ name, error });
128
- continue;
129
- }
130
- if (!args.interactive) {
131
- result.pending.push(name);
132
- continue;
133
- }
134
-
135
- out(
136
- `${LOG_PREFIX} ${name}: authorization needed. You'll authorize ${name} as yourself; ` +
137
- `anyone who can talk to this agent can act with that access.\n` +
138
- `${LOG_PREFIX} Opening (or open manually):\n ${status.authUrl}\n`,
139
- );
140
- open(status.authUrl);
141
-
142
- const authorized = await pollUntilAuthorized({
143
- backendClient,
144
- serverId: status.id,
145
- serviceAccountId,
146
- redirectUri,
147
- sleep,
148
- pollIntervalMs,
149
- pollTimeoutMs,
150
- });
151
- if (authorized) {
152
- out(`${LOG_PREFIX} ${name}: authorized ✓\n`);
153
- result.authorized.push(name);
154
- } else {
155
- err(`${LOG_PREFIX} ${name}: still waiting on authorization; giving up for now.\n`);
156
- result.pending.push(name);
157
- }
158
- }
159
-
160
- return result;
161
- }
162
-
163
- function selectConnectors(
164
- available: AvailableMcpServer[],
165
- filter: string[] | undefined,
166
- ): { servers: AvailableMcpServer[]; unmatched: string[] } {
167
- if (filter === undefined || filter.length === 0) {
168
- return { servers: available, unmatched: [] };
169
- }
170
- const servers: AvailableMcpServer[] = [];
171
- const seen = new Set<number>();
172
- const unmatched: string[] = [];
173
- for (const name of filter) {
174
- const wanted = name.trim().toLowerCase();
175
- const matches = available.filter(
176
- server =>
177
- server.name.toLowerCase() === wanted || server.serverIdentifier?.toLowerCase() === wanted,
178
- );
179
- if (matches.length === 0) {
180
- unmatched.push(name);
181
- continue;
182
- }
183
- for (const match of matches) {
184
- if (!seen.has(match.id)) {
185
- seen.add(match.id);
186
- servers.push(match);
187
- }
188
- }
189
- }
190
- return { servers, unmatched };
191
- }
192
-
193
- function uniqueConnectorMatch(
194
- available: AvailableMcpServer[],
195
- identifier: string,
196
- ): AvailableMcpServer | undefined {
197
- const wanted = identifier.trim().toLowerCase();
198
- if (wanted === "") {
199
- return undefined;
200
- }
201
- const byIdentifier = available.filter(
202
- server => server.serverIdentifier?.toLowerCase() === wanted,
203
- );
204
- if (byIdentifier.length === 1) {
205
- return byIdentifier[0];
206
- }
207
- if (byIdentifier.length > 1) {
208
- return undefined;
209
- }
210
- const byName = available.filter(server => server.name.toLowerCase() === wanted);
211
- if (byName.length === 1) {
212
- return byName[0];
213
- }
214
- return undefined;
215
- }
216
-
217
- /**
218
- * Mint OAuth `authUrl`s for connectors matching `identifiers` (name or
219
- * `serverIdentifier`). Omit `serviceAccountId` to probe the signed-in user
220
- * (local `serve` preflight). Failures return an empty map so the caller
221
- * can fall back to the dashboard URL.
222
- */
223
- export async function probeConnectorAuthUrls(args: {
224
- client: Pick<CursorBackendClient, "getAvailableMcpServers" | "checkHttpMcpStatus">;
225
- identifiers: readonly string[];
226
- serviceAccountId?: string;
227
- }): Promise<Map<string, string>> {
228
- const urls = new Map<string, string>();
229
- if (args.identifiers.length === 0) {
230
- return urls;
231
- }
232
- try {
233
- const available = await args.client.getAvailableMcpServers();
234
- const matched: AvailableMcpServer[] = [];
235
- const seen = new Set<number>();
236
- for (const identifier of args.identifiers) {
237
- const match = uniqueConnectorMatch(available, identifier);
238
- if (match === undefined || seen.has(match.id)) {
239
- continue;
240
- }
241
- seen.add(match.id);
242
- matched.push(match);
243
- }
244
- if (matched.length === 0) {
245
- return urls;
246
- }
247
- const statuses = await args.client.checkHttpMcpStatus({
248
- serverIds: matched.map(server => server.id),
249
- oauthRedirectUri: mcpOauthRedirectUri(),
250
- serviceAccountId: args.serviceAccountId,
251
- });
252
- const statusById = new Map(statuses.map(status => [status.id, status] as const));
253
- for (const identifier of args.identifiers) {
254
- const match = uniqueConnectorMatch(available, identifier);
255
- if (match === undefined) {
256
- continue;
257
- }
258
- const authUrl = statusById.get(match.id)?.authUrl?.trim();
259
- if (authUrl !== undefined && authUrl !== "") {
260
- urls.set(identifier, authUrl);
261
- }
262
- }
263
- return urls;
264
- } catch {
265
- return urls;
266
- }
267
- }
268
-
269
- async function pollUntilAuthorized(args: {
270
- backendClient: Pick<CursorBackendClient, "checkHttpMcpStatus">;
271
- serverId: number;
272
- serviceAccountId: string;
273
- redirectUri: string;
274
- sleep: (ms: number) => Promise<void>;
275
- pollIntervalMs: number;
276
- pollTimeoutMs: number;
277
- }): Promise<boolean> {
278
- const deadline = Date.now() + args.pollTimeoutMs;
279
- // Each unauthorized probe is a full backend connect to the provider, so
280
- // back off while the human works through the OAuth pages.
281
- let intervalMs = args.pollIntervalMs;
282
- const maxIntervalMs = Math.max(args.pollIntervalMs, 15_000);
283
- while (Date.now() < deadline) {
284
- await args.sleep(intervalMs);
285
- intervalMs = Math.min(intervalMs * 1.5, maxIntervalMs);
286
- let statuses: McpConnectorStatus[];
287
- try {
288
- statuses = await args.backendClient.checkHttpMcpStatus({
289
- serverIds: [args.serverId],
290
- oauthRedirectUri: args.redirectUri,
291
- serviceAccountId: args.serviceAccountId,
292
- });
293
- } catch {
294
- // Transient probe errors; keep polling until the deadline.
295
- continue;
296
- }
297
- const status = statuses.find(entry => entry.id === args.serverId);
298
- if (status !== undefined && !status.requiresAuth) {
299
- return true;
300
- }
301
- }
302
- return false;
303
- }
@@ -1,50 +0,0 @@
1
- import { readFileSync } from "node:fs";
2
- import { join } from "node:path";
3
-
4
- const MAX = 64;
5
- const TEMPLATE_NAMES = [
6
- "agentic-owners",
7
- "agents-md",
8
- "code-wiki",
9
- "demo",
10
- "grokbot-agents",
11
- "pr-autofixer",
12
- "security-help",
13
- "security-reviewer",
14
- "thermo-quality-review",
15
- "thermo-review",
16
- "triage-linear",
17
- "triage-jira",
18
- ] as const;
19
- export type TemplateName = (typeof TEMPLATE_NAMES)[number];
20
- const NAMES = new Set<string>(TEMPLATE_NAMES);
21
-
22
- export function canonicalTemplateName(name: string): string {
23
- return name === "triage" ? "triage-linear" : name;
24
- }
25
-
26
- export function isTemplateName(name: string): name is TemplateName {
27
- return NAMES.has(name);
28
- }
29
-
30
- /** Raw scaffold marker. Validation depends on the consuming boundary. */
31
- export function readCursorAgentTemplate(rootDir: string): string | undefined {
32
- try {
33
- const pkg = JSON.parse(readFileSync(join(rootDir, "package.json"), "utf8")) as {
34
- cursorAgentTemplate?: unknown;
35
- };
36
- const stamp = pkg.cursorAgentTemplate;
37
- return typeof stamp === "string" ? stamp : undefined;
38
- } catch {
39
- return undefined;
40
- }
41
- }
42
-
43
- export function readDeployTemplate(rootDir: string): string | undefined {
44
- const stamp = readCursorAgentTemplate(rootDir);
45
- if (stamp === undefined || stamp.length === 0 || stamp.length > MAX) {
46
- return undefined;
47
- }
48
- const name = canonicalTemplateName(stamp);
49
- return isTemplateName(name) ? name : undefined;
50
- }
@@ -1,315 +0,0 @@
1
- /**
2
- * Pull relay for `/v0/deployment-events`.
3
- *
4
- * A {@link RelayAdapter} over {@link CursorRelayCore} — the same engine the
5
- * GitHub SCM and Slack relays use, so registration heartbeats, durable
6
- * offsets, backoff, and bounded dispatch retry are inherited rather than
7
- * reimplemented. Only the subscribe/poll paths, the registration body, and
8
- * the per-event filter differ.
9
- */
10
-
11
- import type {
12
- DeploymentEvent,
13
- DeploymentEventType,
14
- DeploymentSubscription,
15
- } from "../channels/deployments/types.js";
16
- import { CursorRelayCore, type RelayAdapter } from "./cursor-relay-core.js";
17
-
18
- const DEFAULT_EVENTS: readonly DeploymentEventType[] = ["deployment.succeeded"];
19
-
20
- /** One page entry: the event fields plus its stream offset, as the sibling
21
- * providers spell it. */
22
- export type DeploymentRelayEvent = DeploymentEvent & { offset: string };
23
-
24
- export interface ResolvedSubscription {
25
- deploySourceUri: string;
26
- environments: string[];
27
- events: Set<DeploymentEventType>;
28
- }
29
-
30
- interface SubscriptionStatus {
31
- deploySourceUri: string;
32
- isSubscribed: boolean;
33
- detail?: string;
34
- }
35
-
36
- export type DeploymentSubscriptionSource =
37
- | readonly ResolvedSubscription[]
38
- | (() => readonly ResolvedSubscription[]);
39
-
40
- export interface DeploymentEventRelayOptions {
41
- baseUrl: string;
42
- apiKey: string;
43
- stateDir: string;
44
- /**
45
- * Snapshot or a getter. A getter is re-read on every registration
46
- * heartbeat so a channel that refreshes `deploySourceUris` after start
47
- * can add sources without restarting the relay.
48
- */
49
- subscriptions: DeploymentSubscriptionSource;
50
- dispatch: (event: DeploymentEvent) => Promise<void>;
51
- logger: (line: string) => void;
52
- fetchImpl?: typeof fetch;
53
- pollWaitMs?: number;
54
- }
55
-
56
- /** Current subscriptions: a live getter, otherwise the snapshot. */
57
- export function currentDeploymentSubscriptions(
58
- subscriptions: DeploymentSubscriptionSource,
59
- ): readonly ResolvedSubscription[] {
60
- return typeof subscriptions === "function" ? subscriptions() : subscriptions;
61
- }
62
-
63
- /**
64
- * Normalize the channel's `deploySourceUris` option into concrete
65
- * subscriptions. An omitted or empty option resolves to none, which callers
66
- * read as "defer to the deploy scope".
67
- */
68
- export function resolveDeploymentSubscriptions(options: {
69
- deploySourceUris?: readonly (string | DeploymentSubscription)[];
70
- environments?: readonly string[];
71
- events?: readonly DeploymentEventType[];
72
- }): ResolvedSubscription[] {
73
- const bySource = new Map<string, ResolvedSubscription>();
74
- for (const entry of options.deploySourceUris ?? []) {
75
- const subscription: DeploymentSubscription =
76
- typeof entry === "string" ? { deploySourceUri: entry } : entry;
77
- // Case-folded only: `Deployment.deploy_source_uri` has no documented
78
- // format, and the server keys subscriptions the same way.
79
- const deploySourceUri = subscription.deploySourceUri.trim().toLowerCase();
80
- if (deploySourceUri === "") {
81
- throw new Error(
82
- `deploymentsChannel: invalid deploy source "${subscription.deploySourceUri}".`,
83
- );
84
- }
85
- const environments = [
86
- ...new Set(
87
- (subscription.environments ?? options.environments ?? [])
88
- .map(value => value.trim())
89
- .filter(Boolean),
90
- ),
91
- ];
92
- const events = new Set(subscription.events ?? options.events ?? DEFAULT_EVENTS);
93
- if (events.size === 0) {
94
- throw new Error(
95
- `deploymentsChannel: deploy source "${deploySourceUri}" subscribes to no events.`,
96
- );
97
- }
98
- // Later entries for the same deploy source widen the earlier one rather
99
- // than silently replacing it.
100
- const existing = bySource.get(deploySourceUri);
101
- if (existing === undefined) {
102
- bySource.set(deploySourceUri, { deploySourceUri, environments, events });
103
- continue;
104
- }
105
- for (const event of events) existing.events.add(event);
106
- existing.environments =
107
- existing.environments.length === 0 || environments.length === 0
108
- ? []
109
- : [...new Set([...existing.environments, ...environments])];
110
- }
111
- // Empty means "this channel names nothing". The relay wire reads that as
112
- // deregistration, hosted admission reads it as "defer to the deploy
113
- // scope". The host re-resolves on each heartbeat, so a channel that later
114
- // fills `deploySourceUris` registers without a restart.
115
- return [...bySource.values()];
116
- }
117
-
118
- /**
119
- * Union per-channel subscriptions, widening events and environments when
120
- * the same deploy source appears more than once. An empty environment
121
- * list means every environment and absorbs a narrower list.
122
- */
123
- export function mergeResolvedSubscriptions(
124
- groups: readonly (readonly ResolvedSubscription[])[],
125
- ): ResolvedSubscription[] {
126
- const bySource = new Map<string, ResolvedSubscription>();
127
- for (const group of groups) {
128
- for (const subscription of group) {
129
- const existing = bySource.get(subscription.deploySourceUri);
130
- if (existing === undefined) {
131
- bySource.set(subscription.deploySourceUri, {
132
- deploySourceUri: subscription.deploySourceUri,
133
- environments: [...subscription.environments],
134
- events: new Set(subscription.events),
135
- });
136
- continue;
137
- }
138
- for (const event of subscription.events) existing.events.add(event);
139
- existing.environments =
140
- existing.environments.length === 0 || subscription.environments.length === 0
141
- ? []
142
- : [...new Set([...existing.environments, ...subscription.environments])];
143
- }
144
- }
145
- return [...bySource.values()];
146
- }
147
-
148
- /** Whether one confirmed subscription wants this event. */
149
- export function deploymentEventMatches(
150
- subscription: ResolvedSubscription,
151
- envelope: DeploymentEvent,
152
- ): boolean {
153
- if (!subscription.events.has(envelope.eventType)) {
154
- return false;
155
- }
156
- return (
157
- subscription.environments.length === 0 ||
158
- subscription.environments.includes(envelope.environment)
159
- );
160
- }
161
-
162
- /** One channel the host can deliver a deployment event to. */
163
- export interface DeploymentDispatchTarget {
164
- /** Display name for logs, e.g. `executor/deployments`. */
165
- name: string;
166
- subscriptions: readonly ResolvedSubscription[];
167
- deliver: (event: DeploymentEvent) => Promise<unknown>;
168
- }
169
-
170
- /**
171
- * Deliver one event to every channel subscribed to it.
172
- *
173
- * Each channel is delivered independently: one channel's handler throwing
174
- * must not skip the channels after it, because the relay core retries the
175
- * whole dispatch and the channels that already ran would see the event twice.
176
- * Throws only when every subscribed channel failed, so a retry cannot
177
- * re-deliver to a channel that succeeded.
178
- */
179
- export async function fanOutDeploymentEvent(input: {
180
- targets: readonly DeploymentDispatchTarget[];
181
- event: DeploymentEvent;
182
- logger: (line: string) => void;
183
- }): Promise<void> {
184
- const { event, logger } = input;
185
- const matched = input.targets.filter(target =>
186
- target.subscriptions.some(
187
- subscription =>
188
- subscription.deploySourceUri === event.deploySourceUri &&
189
- deploymentEventMatches(subscription, event),
190
- ),
191
- );
192
- const failures: string[] = [];
193
- for (const target of matched) {
194
- try {
195
- await target.deliver(event);
196
- } catch (error) {
197
- failures.push(target.name);
198
- logger(
199
- `[agent-sdk] deployment-events: ${target.name} failed on ${event.eventId}: ${
200
- error instanceof Error ? error.message : String(error)
201
- }`,
202
- );
203
- }
204
- }
205
- logger(
206
- `[agent-sdk] deployment-events: ${event.eventType} ${event.deploySourceUri}@${event.deployVersion} (${event.environment}) → ${matched.length - failures.length}/${matched.length} channel(s)`,
207
- );
208
- if (failures.length > 0 && failures.length === matched.length) {
209
- throw new Error(
210
- `deployment-events: every subscribed channel failed on ${event.eventId} (${failures.join(", ")})`,
211
- );
212
- }
213
- }
214
-
215
- export class DeploymentEventRelay {
216
- private readonly core: CursorRelayCore<DeploymentRelayEvent>;
217
- private subscribed = new Map<string, ResolvedSubscription>();
218
- private readonly loggedSkippedSources = new Set<string>();
219
-
220
- constructor(private readonly options: DeploymentEventRelayOptions) {
221
- const adapter: RelayAdapter<DeploymentRelayEvent> = {
222
- logPrefix: "deployment-events",
223
- subscribePath: "/v0/deployment-events/subscriptions",
224
- pollPath: "/v0/deployment-events",
225
- buildRegistrationBody: consumerId => ({
226
- consumerId,
227
- subscriptions: currentDeploymentSubscriptions(options.subscriptions).map(subscription => ({
228
- deploySourceUri: subscription.deploySourceUri,
229
- environments: subscription.environments,
230
- events: [...subscription.events],
231
- })),
232
- }),
233
- // Empty subscriptions drop this consumer's registration on clean stop
234
- // instead of leaving it to lapse by TTL.
235
- buildDeregistrationBody: consumerId => ({
236
- consumerId,
237
- subscriptions: [],
238
- }),
239
- applyRegistrationResponse: json => {
240
- const result = json as { deploySourceUris?: SubscriptionStatus[] };
241
- const wantedSubscriptions = currentDeploymentSubscriptions(options.subscriptions);
242
- this.subscribed = new Map();
243
- this.loggedSkippedSources.clear();
244
- const lines: string[] = [];
245
- const confirmed: string[] = [];
246
- for (const status of result.deploySourceUris ?? []) {
247
- const wanted = wantedSubscriptions.find(
248
- subscription => subscription.deploySourceUri === status.deploySourceUri,
249
- );
250
- if (!status.isSubscribed || wanted === undefined) {
251
- lines.push(
252
- `not subscribed to ${status.deploySourceUri}: ${status.detail ?? "unknown reason"}`,
253
- );
254
- continue;
255
- }
256
- this.subscribed.set(status.deploySourceUri, wanted);
257
- confirmed.push(status.deploySourceUri);
258
- }
259
- if (confirmed.length > 0) {
260
- const kinds = [...new Set(wantedSubscriptions.flatMap(s => [...s.events]))];
261
- lines.push(`subscribed to ${confirmed.join(", ")} for events: ${kinds.join(", ")}`);
262
- }
263
- return lines;
264
- },
265
- shouldDispatch: event => this.shouldDispatch(event),
266
- dispatch: ({ offset: _offset, ...envelope }) => options.dispatch(envelope),
267
- };
268
- this.core = new CursorRelayCore<DeploymentRelayEvent>({
269
- baseUrl: options.baseUrl,
270
- apiKey: options.apiKey,
271
- stateDir: options.stateDir,
272
- adapter,
273
- logger: options.logger,
274
- ...(options.fetchImpl === undefined ? {} : { fetchImpl: options.fetchImpl }),
275
- ...(options.pollWaitMs === undefined ? {} : { pollWaitMs: options.pollWaitMs }),
276
- });
277
- }
278
-
279
- /**
280
- * Whether an event from this principal's stream belongs to THIS relay.
281
- * The stream is per-principal, and one API key can back several relays
282
- * (other hosts, or an agent running its own alongside the host's), so each
283
- * one re-checks the events against the subscriptions the server confirmed
284
- * for it.
285
- */
286
- private shouldDispatch(event: DeploymentRelayEvent): boolean {
287
- const envelope = event;
288
- if (
289
- envelope === null ||
290
- typeof envelope !== "object" ||
291
- typeof envelope.deploySourceUri !== "string"
292
- ) {
293
- return false;
294
- }
295
- const subscription = this.subscribed.get(envelope.deploySourceUri);
296
- if (subscription === undefined) {
297
- if (!this.loggedSkippedSources.has(envelope.deploySourceUri)) {
298
- this.loggedSkippedSources.add(envelope.deploySourceUri);
299
- this.options.logger(
300
- `[agent-sdk] deployment-events: skipping events for ${envelope.deploySourceUri}: not in this host's subscription (another consumer of this API key likely subscribed it)`,
301
- );
302
- }
303
- return false;
304
- }
305
- return deploymentEventMatches(subscription, envelope);
306
- }
307
-
308
- start(): void {
309
- this.core.start();
310
- }
311
-
312
- async stop(): Promise<void> {
313
- await this.core.stop();
314
- }
315
- }