@cursor/bdk 0.2.6 → 0.2.7

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 (335) hide show
  1. package/dist/bin/agent-serve.js +52 -57
  2. package/dist/channels/github/github-channel.d.ts.map +1 -1
  3. package/dist/channels/github/github-channel.js +34 -8
  4. package/dist/channels/github/types.d.ts +6 -0
  5. package/dist/channels/github/types.d.ts.map +1 -1
  6. package/dist/channels/slack/dispatch.d.ts.map +1 -1
  7. package/dist/channels/slack/dispatch.js +37 -29
  8. package/dist/channels/slack/external-policy.d.ts.map +1 -1
  9. package/dist/channels/slack/external-policy.js +6 -6
  10. package/dist/channels/slack/inbound.d.ts +5 -0
  11. package/dist/channels/slack/inbound.d.ts.map +1 -1
  12. package/dist/channels/slack/inbound.js +13 -0
  13. package/dist/channels/slack/index.d.ts +3 -0
  14. package/dist/channels/slack/index.d.ts.map +1 -1
  15. package/dist/channels/slack/index.js +3 -0
  16. package/dist/channels/slack/log.d.ts +1 -1
  17. package/dist/channels/slack/log.js +1 -1
  18. package/dist/channels/slack/self-identity.d.ts +15 -0
  19. package/dist/channels/slack/self-identity.d.ts.map +1 -0
  20. package/dist/channels/slack/self-identity.js +48 -0
  21. package/dist/channels/slack/sender-name.d.ts +17 -0
  22. package/dist/channels/slack/sender-name.d.ts.map +1 -0
  23. package/dist/channels/slack/sender-name.js +87 -0
  24. package/dist/channels/slack/setup.js +1 -1
  25. package/dist/channels/slack/user-info.d.ts +15 -0
  26. package/dist/channels/slack/user-info.d.ts.map +1 -0
  27. package/dist/channels/slack/user-info.js +57 -0
  28. package/dist/docs/404.html +2 -2
  29. package/dist/docs/assets/{app.CJLKDVza.js → app.oyjtOr3W.js} +4 -4
  30. package/dist/docs/assets/chunks/@localSearchIndexroot.C25zYVuc.js +1 -0
  31. package/dist/docs/assets/chunks/{VPLocalSearchBox.BW9mrQmq.js → VPLocalSearchBox.D0P6J_UJ.js} +1 -1
  32. package/dist/docs/assets/chunks/{arc.D8ZOvM1m.js → arc.B0LY1J1h.js} +1 -1
  33. package/dist/docs/assets/chunks/{architectureDiagram-Q4EWVU46.CXEKhLW-.js → architectureDiagram-Q4EWVU46.dPduLUxY.js} +1 -1
  34. package/dist/docs/assets/chunks/{baseUniq.BJkVKblr.js → baseUniq.B_Ohm21h.js} +1 -1
  35. package/dist/docs/assets/chunks/{blockDiagram-DXYQGD6D.DQDbHxor.js → blockDiagram-DXYQGD6D.B4zcanaJ.js} +1 -1
  36. package/dist/docs/assets/chunks/{c4Diagram-AHTNJAMY.ByMD6LYM.js → c4Diagram-AHTNJAMY.D9Iw21nx.js} +1 -1
  37. package/dist/docs/assets/chunks/channel.CRUyWDV-.js +1 -0
  38. package/dist/docs/assets/chunks/{chunk-4BX2VUAB.Dtq1aVI9.js → chunk-4BX2VUAB.DDVwRShI.js} +1 -1
  39. package/dist/docs/assets/chunks/{chunk-4TB4RGXK.BL_XrkoQ.js → chunk-4TB4RGXK.DsYcdn1i.js} +1 -1
  40. package/dist/docs/assets/chunks/{chunk-55IACEB6.BDPXu94_.js → chunk-55IACEB6.BzzQvcYp.js} +1 -1
  41. package/dist/docs/assets/chunks/{chunk-EDXVE4YY.DhGOQj4k.js → chunk-EDXVE4YY.BMiXZ7FX.js} +1 -1
  42. package/dist/docs/assets/chunks/{chunk-FMBD7UC4.DSF5nr8v.js → chunk-FMBD7UC4.D_mBcLoc.js} +1 -1
  43. package/dist/docs/assets/chunks/{chunk-OYMX7WX6.Day7wayw.js → chunk-OYMX7WX6.CMVjWVMx.js} +1 -1
  44. package/dist/docs/assets/chunks/{chunk-QZHKN3VN.CpBEC0zA.js → chunk-QZHKN3VN.BG-FrPv9.js} +1 -1
  45. package/dist/docs/assets/chunks/{chunk-YZCP3GAM.X_7rY1rx.js → chunk-YZCP3GAM.CkFE1ap3.js} +1 -1
  46. package/dist/docs/assets/chunks/classDiagram-6PBFFD2Q.CG_UObcQ.js +1 -0
  47. package/dist/docs/assets/chunks/classDiagram-v2-HSJHXN6E.CG_UObcQ.js +1 -0
  48. package/dist/docs/assets/chunks/clone.NYSZ9qZN.js +1 -0
  49. package/dist/docs/assets/chunks/{cose-bilkent-S5V4N54A.BVRmi2ko.js → cose-bilkent-S5V4N54A.BVNnCTvY.js} +1 -1
  50. package/dist/docs/assets/chunks/{dagre-KV5264BT.Dei9oslB.js → dagre-KV5264BT.CDN5PR9l.js} +1 -1
  51. package/dist/docs/assets/chunks/{diagram-5BDNPKRD._M-efGt7.js → diagram-5BDNPKRD.DQRUlT-i.js} +1 -1
  52. package/dist/docs/assets/chunks/{diagram-G4DWMVQ6.D1Vmhfsj.js → diagram-G4DWMVQ6.CoeblYQT.js} +1 -1
  53. package/dist/docs/assets/chunks/{diagram-MMDJMWI5.cE1bmvAC.js → diagram-MMDJMWI5.DW3ymjl0.js} +1 -1
  54. package/dist/docs/assets/chunks/{diagram-TYMM5635.DkXAfznP.js → diagram-TYMM5635.BP0uN4Jw.js} +1 -1
  55. package/dist/docs/assets/chunks/{erDiagram-SMLLAGMA.DH_pSwPg.js → erDiagram-SMLLAGMA.DVFUWEn4.js} +1 -1
  56. package/dist/docs/assets/chunks/{flowDiagram-DWJPFMVM.kAWVN9j1.js → flowDiagram-DWJPFMVM.HU-eHspv.js} +1 -1
  57. package/dist/docs/assets/chunks/{ganttDiagram-T4ZO3ILL.8r0w49-p.js → ganttDiagram-T4ZO3ILL.DHNhXijY.js} +1 -1
  58. package/dist/docs/assets/chunks/{gitGraphDiagram-UUTBAWPF.BDa7Bi1i.js → gitGraphDiagram-UUTBAWPF.DkISXcO3.js} +1 -1
  59. package/dist/docs/assets/chunks/{graph.BMPXHz_B.js → graph.CCV0fuRR.js} +1 -1
  60. package/dist/docs/assets/chunks/{infoDiagram-42DDH7IO.BmlcqewS.js → infoDiagram-42DDH7IO.bgILzOoc.js} +1 -1
  61. package/dist/docs/assets/chunks/{ishikawaDiagram-UXIWVN3A.CVSEQSul.js → ishikawaDiagram-UXIWVN3A.CuryXC0F.js} +1 -1
  62. package/dist/docs/assets/chunks/{journeyDiagram-VCZTEJTY.BpeWJ5n-.js → journeyDiagram-VCZTEJTY.BL1Pr-wu.js} +1 -1
  63. package/dist/docs/assets/chunks/{kanban-definition-6JOO6SKY.DHbDXuxB.js → kanban-definition-6JOO6SKY.BbGjvk4l.js} +1 -1
  64. package/dist/docs/assets/chunks/{layout.CzrCDgkP.js → layout.C4PfdldS.js} +1 -1
  65. package/dist/docs/assets/chunks/{linear.HwBsflwN.js → linear.C3xD1T6X.js} +1 -1
  66. package/dist/docs/assets/chunks/{min.DqGHolT3.js → min.CzgRAQ9c.js} +1 -1
  67. package/dist/docs/assets/chunks/{mindmap-definition-QFDTVHPH.ZYGlOawh.js → mindmap-definition-QFDTVHPH.CA9rSWum.js} +1 -1
  68. package/dist/docs/assets/chunks/{pieDiagram-DEJITSTG.C2KRXlNR.js → pieDiagram-DEJITSTG.B8MprgJu.js} +1 -1
  69. package/dist/docs/assets/chunks/{quadrantDiagram-34T5L4WZ.CHj3Qefp.js → quadrantDiagram-34T5L4WZ.DndDwbKT.js} +1 -1
  70. package/dist/docs/assets/chunks/{requirementDiagram-MS252O5E.B1L4Tf7k.js → requirementDiagram-MS252O5E.Zhfgwlnn.js} +1 -1
  71. package/dist/docs/assets/chunks/{sankeyDiagram-XADWPNL6.dNR2yi1B.js → sankeyDiagram-XADWPNL6.B6RRm6N5.js} +1 -1
  72. package/dist/docs/assets/chunks/{sequenceDiagram-FGHM5R23.BrvQ3C6m.js → sequenceDiagram-FGHM5R23.Bfmz-1PN.js} +1 -1
  73. package/dist/docs/assets/chunks/{stateDiagram-FHFEXIEX.BtehEykA.js → stateDiagram-FHFEXIEX.gbrdNqgj.js} +1 -1
  74. package/dist/docs/assets/chunks/stateDiagram-v2-QKLJ7IA2.DOOmulfQ.js +1 -0
  75. package/dist/docs/assets/chunks/{theme.BDHBZUkP.js → theme.gpWjytMh.js} +2 -2
  76. package/dist/docs/assets/chunks/{timeline-definition-GMOUNBTQ.Bn7nhqEN.js → timeline-definition-GMOUNBTQ.Bl1l7M1f.js} +1 -1
  77. package/dist/docs/assets/chunks/{vennDiagram-DHZGUBPP.DKhc38sz.js → vennDiagram-DHZGUBPP.Dfle4U0d.js} +1 -1
  78. package/dist/docs/assets/chunks/{wardley-RL74JXVD.DOXQ0w8J.js → wardley-RL74JXVD.BJrCW6xc.js} +1 -1
  79. package/dist/docs/assets/chunks/{wardleyDiagram-NUSXRM2D.Bbq5B2Ic.js → wardleyDiagram-NUSXRM2D.CM_4lmvZ.js} +1 -1
  80. package/dist/docs/assets/chunks/{xychartDiagram-5P7HB3ND.B77HE1K8.js → xychartDiagram-5P7HB3ND.CHT5X28R.js} +1 -1
  81. package/dist/docs/assets/{reference_cli.md.BsgDqYPh.js → reference_cli.md.GwugN3n-.js} +5 -5
  82. package/dist/docs/assets/reference_cli.md.GwugN3n-.lean.js +1 -0
  83. package/dist/docs/assets/{reference_skills.md.ClkMoQsV.js → reference_skills.md.C0guGcH0.js} +3 -3
  84. package/dist/docs/building-with-agents.html +35 -35
  85. package/dist/docs/deployment.html +35 -35
  86. package/dist/docs/evals.html +35 -35
  87. package/dist/docs/guides/agent-to-agent.html +35 -35
  88. package/dist/docs/guides/bitbucket.html +35 -35
  89. package/dist/docs/guides/cloud-agents.html +35 -35
  90. package/dist/docs/guides/convert-automation.html +35 -35
  91. package/dist/docs/guides/github.html +35 -35
  92. package/dist/docs/guides/gitlab.html +35 -35
  93. package/dist/docs/guides/grokbot-agents.html +35 -35
  94. package/dist/docs/guides/hooks.html +35 -35
  95. package/dist/docs/guides/improve.html +35 -35
  96. package/dist/docs/guides/jev.html +35 -35
  97. package/dist/docs/guides/mcp-oauth.html +35 -35
  98. package/dist/docs/guides/opentelemetry.html +35 -35
  99. package/dist/docs/guides/slack.html +35 -35
  100. package/dist/docs/guides/webhooks.html +35 -35
  101. package/dist/docs/hashmap.json +1 -1
  102. package/dist/docs/hillclimbing.html +35 -35
  103. package/dist/docs/index.html +35 -35
  104. package/dist/docs/llms-full.txt +20 -9
  105. package/dist/docs/quickstart.html +35 -35
  106. package/dist/docs/reference/agent-config.html +35 -35
  107. package/dist/docs/reference/artifacts.html +35 -35
  108. package/dist/docs/reference/channels.html +35 -35
  109. package/dist/docs/reference/cli.html +39 -39
  110. package/dist/docs/reference/cli.md +20 -9
  111. package/dist/docs/reference/connections.html +35 -35
  112. package/dist/docs/reference/evals.html +35 -35
  113. package/dist/docs/reference/extensions.html +35 -35
  114. package/dist/docs/reference/hooks.html +35 -35
  115. package/dist/docs/reference/http-api.html +35 -35
  116. package/dist/docs/reference/instructions.html +35 -35
  117. package/dist/docs/reference/playground.html +35 -35
  118. package/dist/docs/reference/project-layout.html +35 -35
  119. package/dist/docs/reference/prompt.html +35 -35
  120. package/dist/docs/reference/schedules.html +35 -35
  121. package/dist/docs/reference/sessions.html +35 -35
  122. package/dist/docs/reference/skills.html +38 -38
  123. package/dist/docs/reference/subagents.html +35 -35
  124. package/dist/docs/reference/tools.html +35 -35
  125. package/dist/docs/templates/agentic-owners.html +35 -35
  126. package/dist/docs/templates/grokbot-agents.html +35 -35
  127. package/dist/docs/templates/security-reviewer.html +35 -35
  128. package/dist/docs/templates/thermo-quality-review.html +35 -35
  129. package/dist/docs/templates/thermo-review.html +35 -35
  130. package/dist/docs/templates/triage.html +35 -35
  131. package/dist/docs/troubleshooting.html +35 -35
  132. package/dist/extensions/cursor-cloud-agents/extension.d.ts +14 -0
  133. package/dist/extensions/cursor-cloud-agents/extension.d.ts.map +1 -1
  134. package/dist/extensions/cursor-cloud-agents/extension.js +5 -0
  135. package/dist/extensions/cursor-cloud-agents/lib/watch.d.ts +17 -0
  136. package/dist/extensions/cursor-cloud-agents/lib/watch.d.ts.map +1 -0
  137. package/dist/extensions/cursor-cloud-agents/lib/watch.js +99 -0
  138. package/dist/extensions/cursor-cloud-agents/reminders/cloud-agent-stop-watch.d.ts +19 -0
  139. package/dist/extensions/cursor-cloud-agents/reminders/cloud-agent-stop-watch.d.ts.map +1 -0
  140. package/dist/extensions/cursor-cloud-agents/reminders/cloud-agent-stop-watch.js +71 -0
  141. package/dist/extensions/cursor-cloud-agents/skills/handoff.md +9 -5
  142. package/dist/extensions/cursor-cloud-agents/tools/cancel.d.ts.map +1 -1
  143. package/dist/extensions/cursor-cloud-agents/tools/cancel.js +3 -1
  144. package/dist/extensions/cursor-cloud-agents/tools/launch.d.ts.map +1 -1
  145. package/dist/extensions/cursor-cloud-agents/tools/launch.js +3 -2
  146. package/dist/extensions.d.ts +1 -1
  147. package/dist/extensions.js +1 -1
  148. package/dist/files-backends/cursor-hosted.d.ts +22 -83
  149. package/dist/files-backends/cursor-hosted.d.ts.map +1 -1
  150. package/dist/files-backends/cursor-hosted.js +46 -160
  151. package/dist/files.d.ts +9 -32
  152. package/dist/files.d.ts.map +1 -1
  153. package/dist/files.js +7 -32
  154. package/dist/internal/artifacts-store.d.ts +13 -25
  155. package/dist/internal/artifacts-store.d.ts.map +1 -1
  156. package/dist/internal/artifacts-store.js +25 -46
  157. package/dist/internal/cli-ax.d.ts +10 -17
  158. package/dist/internal/cli-ax.d.ts.map +1 -1
  159. package/dist/internal/cli-ax.js +87 -155
  160. package/dist/internal/cli-bitbucket.js +5 -5
  161. package/dist/internal/cli-deploy.d.ts +4 -1
  162. package/dist/internal/cli-deploy.d.ts.map +1 -1
  163. package/dist/internal/cli-deploy.js +117 -20
  164. package/dist/internal/cli-github.js +13 -13
  165. package/dist/internal/cli-gitlab.js +5 -5
  166. package/dist/internal/continuation-identity.d.ts +2 -0
  167. package/dist/internal/continuation-identity.d.ts.map +1 -1
  168. package/dist/internal/continuation-identity.js +4 -0
  169. package/dist/internal/conversation-mirror.d.ts +9 -38
  170. package/dist/internal/conversation-mirror.d.ts.map +1 -1
  171. package/dist/internal/conversation-mirror.js +62 -68
  172. package/dist/internal/cursor/account-mcp.d.ts +1 -1
  173. package/dist/internal/cursor/account-mcp.js +1 -1
  174. package/dist/internal/cursor/backend-client.js +1 -1
  175. package/dist/internal/cursor/github-credentials.js +3 -3
  176. package/dist/internal/cursor/hosted-bound-secrets.d.ts +6 -2
  177. package/dist/internal/cursor/hosted-bound-secrets.d.ts.map +1 -1
  178. package/dist/internal/cursor/hosted-bound-secrets.js +13 -2
  179. package/dist/internal/cursor/hosted-store-secrets.d.ts +13 -37
  180. package/dist/internal/cursor/hosted-store-secrets.d.ts.map +1 -1
  181. package/dist/internal/cursor/hosted-store-secrets.js +13 -37
  182. package/dist/internal/cursor/store-api-client.d.ts +17 -39
  183. package/dist/internal/cursor/store-api-client.d.ts.map +1 -1
  184. package/dist/internal/cursor/store-api-client.js +15 -37
  185. package/dist/internal/cursor-deployment-relay.js +3 -3
  186. package/dist/internal/cursor-event-relay.js +1 -1
  187. package/dist/internal/cursor-relay-core.d.ts +1 -1
  188. package/dist/internal/cursor-relay-core.d.ts.map +1 -1
  189. package/dist/internal/deploy-client.d.ts +55 -63
  190. package/dist/internal/deploy-client.d.ts.map +1 -1
  191. package/dist/internal/deploy-client.js +48 -28
  192. package/dist/internal/discovery/agent.d.ts +1 -1
  193. package/dist/internal/discovery/agent.d.ts.map +1 -1
  194. package/dist/internal/discovery/agent.js +4 -0
  195. package/dist/internal/discovery/extensions.d.ts +2 -1
  196. package/dist/internal/discovery/extensions.d.ts.map +1 -1
  197. package/dist/internal/discovery/extensions.js +11 -1
  198. package/dist/internal/discovery/project.d.ts.map +1 -1
  199. package/dist/internal/discovery/project.js +1 -0
  200. package/dist/internal/distribution.d.ts +2 -2
  201. package/dist/internal/distribution.d.ts.map +1 -1
  202. package/dist/internal/distribution.js +2 -2
  203. package/dist/internal/docs-site.js +3 -3
  204. package/dist/internal/eval-run-store.js +8 -8
  205. package/dist/internal/framework-file-storage.d.ts +10 -34
  206. package/dist/internal/framework-file-storage.d.ts.map +1 -1
  207. package/dist/internal/framework-file-storage.js +12 -39
  208. package/dist/internal/framework-storage-selection.d.ts +10 -46
  209. package/dist/internal/framework-storage-selection.d.ts.map +1 -1
  210. package/dist/internal/framework-storage-selection.js +15 -64
  211. package/dist/internal/github-fanout.js +2 -2
  212. package/dist/internal/handleAgentServeTrigger.d.ts +5 -8
  213. package/dist/internal/handleAgentServeTrigger.d.ts.map +1 -1
  214. package/dist/internal/handleAgentServeTrigger.js +5 -8
  215. package/dist/internal/host-files.js +6 -9
  216. package/dist/internal/host-platforms.js +5 -5
  217. package/dist/internal/hosted-catch.d.ts +3 -2
  218. package/dist/internal/hosted-catch.d.ts.map +1 -1
  219. package/dist/internal/hosted-catch.js +27 -9
  220. package/dist/internal/hosted-delivery-protocol.d.ts +31 -8
  221. package/dist/internal/hosted-delivery-protocol.d.ts.map +1 -1
  222. package/dist/internal/hosted-delivery-protocol.js +102 -1
  223. package/dist/internal/hosted-delivery.d.ts.map +1 -1
  224. package/dist/internal/hosted-delivery.js +32 -12
  225. package/dist/internal/hosted-execution-diag.d.ts +13 -24
  226. package/dist/internal/hosted-execution-diag.d.ts.map +1 -1
  227. package/dist/internal/hosted-execution-diag.js +11 -20
  228. package/dist/internal/hosted-execution-flush.d.ts +22 -10
  229. package/dist/internal/hosted-execution-flush.d.ts.map +1 -1
  230. package/dist/internal/hosted-execution-flush.js +45 -9
  231. package/dist/internal/hosted-managed-automation.js +5 -5
  232. package/dist/internal/hosting.d.ts +5 -10
  233. package/dist/internal/hosting.d.ts.map +1 -1
  234. package/dist/internal/hosting.js +5 -10
  235. package/dist/internal/legacy-command-guard.d.ts +1 -4
  236. package/dist/internal/legacy-command-guard.d.ts.map +1 -1
  237. package/dist/internal/legacy-command-guard.js +2 -11
  238. package/dist/internal/listen-port.js +1 -1
  239. package/dist/internal/local-control-plane.js +6 -6
  240. package/dist/internal/logs-client.d.ts +20 -1
  241. package/dist/internal/logs-client.d.ts.map +1 -1
  242. package/dist/internal/logs-client.js +89 -1
  243. package/dist/internal/mcp-endpoint.js +1 -1
  244. package/dist/internal/otel/collector.js +1 -1
  245. package/dist/internal/otel/runtime.js +13 -13
  246. package/dist/internal/platform-schedule-sync.js +2 -2
  247. package/dist/internal/playground/toolchain.js +6 -6
  248. package/dist/internal/process-memory-telemetry.js +2 -2
  249. package/dist/internal/reminder-runner.d.ts +8 -3
  250. package/dist/internal/reminder-runner.d.ts.map +1 -1
  251. package/dist/internal/reminder-runner.js +51 -52
  252. package/dist/internal/resolve-prod-target.d.ts +1 -12
  253. package/dist/internal/resolve-prod-target.d.ts.map +1 -1
  254. package/dist/internal/resolve-prod-target.js +2 -32
  255. package/dist/internal/resolved-connections.js +8 -8
  256. package/dist/internal/run-client.d.ts +4 -3
  257. package/dist/internal/run-client.d.ts.map +1 -1
  258. package/dist/internal/run-client.js +98 -61
  259. package/dist/internal/runtime-dispatch-runner.d.ts +1 -0
  260. package/dist/internal/runtime-dispatch-runner.d.ts.map +1 -1
  261. package/dist/internal/runtime-dispatch-runner.js +7 -1
  262. package/dist/internal/schedule-runner.js +1 -1
  263. package/dist/internal/sdk-runner.d.ts +4 -0
  264. package/dist/internal/sdk-runner.d.ts.map +1 -1
  265. package/dist/internal/sdk-runner.js +37 -22
  266. package/dist/internal/server.d.ts +2 -0
  267. package/dist/internal/server.d.ts.map +1 -1
  268. package/dist/internal/server.js +39 -38
  269. package/dist/internal/session-engine.d.ts +31 -44
  270. package/dist/internal/session-engine.d.ts.map +1 -1
  271. package/dist/internal/session-engine.js +67 -83
  272. package/dist/internal/session-run-log.d.ts +10 -24
  273. package/dist/internal/session-run-log.d.ts.map +1 -1
  274. package/dist/internal/session-run-log.js +13 -27
  275. package/dist/internal/sessions-client.d.ts.map +1 -1
  276. package/dist/internal/sessions-client.js +6 -3
  277. package/dist/internal/skills-sync.d.ts +3 -5
  278. package/dist/internal/skills-sync.d.ts.map +1 -1
  279. package/dist/internal/skills-sync.js +3 -5
  280. package/dist/internal/start-log-store.d.ts +7 -18
  281. package/dist/internal/start-log-store.d.ts.map +1 -1
  282. package/dist/internal/start-log-store.js +47 -24
  283. package/dist/internal/storage-coordinator.d.ts +7 -10
  284. package/dist/internal/storage-coordinator.d.ts.map +1 -1
  285. package/dist/internal/storage-coordinator.js +18 -20
  286. package/dist/internal/storage-roles.d.ts +5 -0
  287. package/dist/internal/storage-roles.d.ts.map +1 -1
  288. package/dist/internal/store-api-protocol.d.ts +12 -33
  289. package/dist/internal/store-api-protocol.d.ts.map +1 -1
  290. package/dist/internal/store-api-protocol.js +6 -22
  291. package/dist/internal/store-mirror.d.ts +4 -5
  292. package/dist/internal/store-mirror.d.ts.map +1 -1
  293. package/dist/internal/store-mirror.js +6 -8
  294. package/dist/internal/turn-lease-store.d.ts +12 -5
  295. package/dist/internal/turn-lease-store.d.ts.map +1 -1
  296. package/dist/internal/turn-lease-store.js +61 -8
  297. package/dist/internal/v2-hosting.d.ts +4 -7
  298. package/dist/internal/v2-hosting.d.ts.map +1 -1
  299. package/dist/internal/v2-hosting.js +4 -7
  300. package/dist/internal/workspace-sync.d.ts +3 -6
  301. package/dist/internal/workspace-sync.d.ts.map +1 -1
  302. package/dist/internal/workspace-sync.js +3 -6
  303. package/dist/internal/workspace.d.ts +10 -16
  304. package/dist/internal/workspace.d.ts.map +1 -1
  305. package/dist/internal/workspace.js +9 -14
  306. package/dist/memory.d.ts +17 -43
  307. package/dist/memory.d.ts.map +1 -1
  308. package/dist/memory.js +34 -80
  309. package/dist/playground/assets/index-DPKLl4C_.css +1 -0
  310. package/dist/playground/assets/index-MijLHTbB.js +71 -0
  311. package/dist/playground/index.html +2 -2
  312. package/dist/storage-backends/cursor-hosted-v2.d.ts +8 -36
  313. package/dist/storage-backends/cursor-hosted-v2.d.ts.map +1 -1
  314. package/dist/storage-backends/cursor-hosted-v2.js +9 -37
  315. package/dist/storage-backends/cursor-hosted.d.ts +17 -30
  316. package/dist/storage-backends/cursor-hosted.d.ts.map +1 -1
  317. package/dist/storage-backends/cursor-hosted.js +14 -27
  318. package/dist/storage-protocol.d.ts +13 -38
  319. package/dist/storage-protocol.d.ts.map +1 -1
  320. package/dist/storage-protocol.js +14 -39
  321. package/dist/types.d.ts +29 -30
  322. package/dist/types.d.ts.map +1 -1
  323. package/docs/reference/cli.md +20 -9
  324. package/package.json +1 -1
  325. package/templates/pr-autofixer/bot/instructions.md +3 -3
  326. package/dist/docs/assets/chunks/@localSearchIndexroot.Bq-pxRXm.js +0 -1
  327. package/dist/docs/assets/chunks/channel.DCU8W1RP.js +0 -1
  328. package/dist/docs/assets/chunks/classDiagram-6PBFFD2Q.DwpXsM06.js +0 -1
  329. package/dist/docs/assets/chunks/classDiagram-v2-HSJHXN6E.DwpXsM06.js +0 -1
  330. package/dist/docs/assets/chunks/clone.DH6Mx2zB.js +0 -1
  331. package/dist/docs/assets/chunks/stateDiagram-v2-QKLJ7IA2.kzD0-U89.js +0 -1
  332. package/dist/docs/assets/reference_cli.md.BsgDqYPh.lean.js +0 -1
  333. package/dist/playground/assets/index-6BbTPnaT.css +0 -1
  334. package/dist/playground/assets/index-CI7FAmOP.js +0 -71
  335. /package/dist/docs/assets/{reference_skills.md.ClkMoQsV.lean.js → reference_skills.md.C0guGcH0.lean.js} +0 -0
@@ -0,0 +1,19 @@
1
+ /**
2
+ * The stop watch on one launched cloud agent, armed by `lib/watch.ts`. Every
3
+ * fire is host-only: it polls the agent and skips while the agent runs, so
4
+ * no model turn starts. The first fire that sees the agent stopped wakes the
5
+ * bound conversation once and ends the watch.
6
+ *
7
+ * A fire never throws, because a v1 host stops firing a reminder whose
8
+ * handler threw; every outcome is a skip or a stop.
9
+ */
10
+ import type { ReminderDefinition } from "../../../types.js";
11
+ /** How long a watch polls before it stops without a wake. */
12
+ export declare const WATCH_WINDOW_HOURS = 24;
13
+ export type WatchArgs = {
14
+ agentId: string;
15
+ deadline: string;
16
+ };
17
+ declare const watch: ReminderDefinition;
18
+ export default watch;
19
+ //# sourceMappingURL=cloud-agent-stop-watch.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"cloud-agent-stop-watch.d.ts","sourceRoot":"","sources":["../../../../src/extensions/cursor-cloud-agents/reminders/cloud-agent-stop-watch.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAMH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAG5D,6DAA6D;AAC7D,eAAO,MAAM,kBAAkB,KAAK,CAAC;AAGrC,MAAM,MAAM,SAAS,GAAG;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC;AAS9D,QAAA,MAAM,KAAK,EAAE,kBAiCX,CAAC;eAEY,KAAK"}
@@ -0,0 +1,71 @@
1
+ /**
2
+ * The stop watch on one launched cloud agent, armed by `lib/watch.ts`. Every
3
+ * fire is host-only: it polls the agent and skips while the agent runs, so
4
+ * no model turn starts. The first fire that sees the agent stopped wakes the
5
+ * bound conversation once and ends the watch.
6
+ *
7
+ * A fire never throws, because a v1 host stops firing a reminder whose
8
+ * handler threw; every outcome is a skip or a stop.
9
+ */
10
+ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
11
+ function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
12
+ return new (P || (P = Promise))(function (resolve, reject) {
13
+ function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
14
+ function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
15
+ function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
16
+ step((generator = generator.apply(thisArg, _arguments || [])).next());
17
+ });
18
+ };
19
+ import { z } from "zod";
20
+ import { CursorBackendError } from "../../../internal/cursor/backend-client.js";
21
+ import { describeError } from "../../../internal/describe-error.js";
22
+ import { defineReminder } from "../../../reminders.js";
23
+ import { cloudAgentsBackend } from "../lib/backend.js";
24
+ /** How long a watch polls before it stops without a wake. */
25
+ export const WATCH_WINDOW_HOURS = 24;
26
+ const watchArgs = z.object({
27
+ agentId: z.string().min(1),
28
+ deadline: z.string().datetime(),
29
+ });
30
+ const STOPPED = new Set(["finished", "error", "expired"]);
31
+ const watch = defineReminder({
32
+ run(_a) {
33
+ return __awaiter(this, arguments, void 0, function* ({ args, followup }) {
34
+ const parsed = watchArgs.safeParse(args);
35
+ if (!parsed.success) {
36
+ return { action: "stop" };
37
+ }
38
+ const { agentId, deadline } = parsed.data;
39
+ const pastDeadline = Date.now() >= Date.parse(deadline);
40
+ let info;
41
+ try {
42
+ info = yield cloudAgentsBackend().info(agentId);
43
+ }
44
+ catch (error) {
45
+ if (isPermanent(error)) {
46
+ console.warn(`[cursor-cloud-agents] stopped watching ${agentId}: ${describeError(error)}`);
47
+ return { action: "stop" };
48
+ }
49
+ return pastDeadline ? { action: "stop" } : { action: "skip" };
50
+ }
51
+ if (!STOPPED.has(info.status)) {
52
+ return pastDeadline ? { action: "stop" } : { action: "skip" };
53
+ }
54
+ // At most once: a wake that failed may already have started its turn.
55
+ try {
56
+ yield followup({
57
+ message: `[cloud agent stopped] ${agentId} is ${info.status}.\n${JSON.stringify(info)}`,
58
+ });
59
+ }
60
+ catch (error) {
61
+ console.warn(`[cursor-cloud-agents] could not wake the conversation watching ${agentId}: ${describeError(error)}`);
62
+ }
63
+ return { action: "stop" };
64
+ });
65
+ },
66
+ });
67
+ export default watch;
68
+ /** The agent is gone or out of the host key's reach; polling will not bring it back. */
69
+ function isPermanent(error) {
70
+ return error instanceof CursorBackendError && (error.status === 403 || error.status === 404);
71
+ }
@@ -1,5 +1,5 @@
1
1
  ---
2
- description: "Delegate coding work to Cursor cloud agents: when to hand off, how to write the prompt, and how to look an agent up by id, read what it did, reply, and cancel."
2
+ description: "Delegate coding work to Cursor cloud agents: when to hand off, how to write the prompt, what to do when the host wakes you because one stopped, and how to look an agent up by id, read what it did, reply, and cancel."
3
3
  ---
4
4
 
5
5
  # Cloud agent handoff
@@ -12,11 +12,15 @@ The tools below are this extension's; they appear under its mount namespace, as
12
12
 
13
13
  Call `launch` with a self-contained prompt: the goal, the repository or pull request, constraints (branch, files to leave alone), and what done looks like (tests pass, PR opened). Pass `starting_ref` or `pr_url` to pick a branch or pull request; `repo` must be one of the configured repositories.
14
14
 
15
- The result carries `agentId` (`bc-...`) and a `url`. Report both in full. Never truncate the id.
15
+ The result carries `agentId` (`bc-...`) and a `url`. Report both in full. Never truncate the id. With `watching: true`, the host watches the run and wakes this conversation once when it stops, so you do not need to poll it.
16
+
17
+ ## When an agent stops
18
+
19
+ The wake is a message that starts with `[cloud agent stopped]`, followed by the agent's details in the shape `get` returns; its `status` is `finished`, `error`, or `expired`. Read the report with `dump` before you tell anyone what the agent did, then share the pull request or the error. The host stops watching without a wake when the agent can no longer be read or is still running after a day; if you are asked about an agent you have not heard back from, look it up with `get`.
16
20
 
17
21
  ## Look an agent up by id
18
22
 
19
- Call `get` with the `agent_id`. It returns the agent's `status` (`creating`, `running`, `finished`, `error`, `expired`, or `unknown`), its `branch` and pull request `prUrl` once pushed, change counts, a `summary` when one exists, and an `error` when it failed. A run takes minutes: check when asked or when you need the result, not in a tight loop. The final report itself comes from `dump`.
23
+ Call `get` with the `agent_id`. It returns the agent's `status` (`creating`, `running`, `finished`, `error`, `expired`, or `unknown`), its `branch` and pull request `prUrl` once pushed, change counts, a `summary` when one exists, and an `error` when it failed. A run takes minutes: check when asked or when you need the result before the wake, not in a loop. The final report itself comes from `dump`.
20
24
 
21
25
  ## Read what it did
22
26
 
@@ -26,11 +30,11 @@ Use `finalMessage` as the agent's report. Read the returned transcript path when
26
30
 
27
31
  ## Reply
28
32
 
29
- Call `reply` with the `agent_id` and a prompt to steer an agent or ask for changes on its branch. The follow-up queues behind the current run and starts when it finishes; pass `interrupt: true` to stop the current step and deliver it now. Do not launch a second agent for follow-up work on the same branch.
33
+ Call `reply` with the `agent_id` and a prompt to steer an agent or ask for changes on its branch. The follow-up queues behind the current run and starts when it finishes; pass `interrupt: true` to stop the current step and deliver it now. The host does not watch a follow-up run; check it with `get` when you need its result. Do not launch a second agent for follow-up work on the same branch.
30
34
 
31
35
  ## Cancel
32
36
 
33
- Call `cancel` with the `agent_id` to stop the active run. The agent keeps its branch and conversation, so a `reply` can continue from where it stopped.
37
+ Call `cancel` with the `agent_id` to stop the active run; no stop wake follows. The agent keeps its branch and conversation, so a `reply` can continue from where it stopped.
34
38
 
35
39
  ## Fleet
36
40
 
@@ -1 +1 @@
1
- {"version":3,"file":"cancel.d.ts","sourceRoot":"","sources":["../../../../src/extensions/cursor-cloud-agents/tools/cancel.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAMxD,QAAA,MAAM,MAAM,EAAE,cAWZ,CAAC;eAEY,MAAM"}
1
+ {"version":3,"file":"cancel.d.ts","sourceRoot":"","sources":["../../../../src/extensions/cursor-cloud-agents/tools/cancel.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAOxD,QAAA,MAAM,MAAM,EAAE,cAYZ,CAAC;eAEY,MAAM"}
@@ -12,8 +12,9 @@ import { cloudAgentsBackend } from "../lib/backend.js";
12
12
  import { assertWriteChannel } from "../lib/channels.js";
13
13
  import { assertOwned } from "../lib/fleet.js";
14
14
  import { agentRef } from "../lib/inputs.js";
15
+ import { disarmWatches } from "../lib/watch.js";
15
16
  const cancel = defineTool({
16
- description: "Stop a cloud agent's active run. The agent keeps its branch and conversation; reply to it to continue.",
17
+ description: "Stop a cloud agent's active run; no stop wake follows. The agent keeps its branch and conversation; reply to it to continue.",
17
18
  effect: "write",
18
19
  inputSchema: agentRef,
19
20
  execute(input, ctx) {
@@ -21,6 +22,7 @@ const cancel = defineTool({
21
22
  assertWriteChannel(ctx);
22
23
  yield assertOwned(ctx, input.agent_id);
23
24
  yield cloudAgentsBackend().pause(input.agent_id);
25
+ yield disarmWatches(ctx, input.agent_id);
24
26
  return { agentId: input.agent_id, cancelled: true };
25
27
  });
26
28
  },
@@ -1 +1 @@
1
- {"version":3,"file":"launch.d.ts","sourceRoot":"","sources":["../../../../src/extensions/cursor-cloud-agents/tools/launch.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAOxD,QAAA,MAAM,MAAM,EAAE,cAkDZ,CAAC;eAEY,MAAM"}
1
+ {"version":3,"file":"launch.d.ts","sourceRoot":"","sources":["../../../../src/extensions/cursor-cloud-agents/tools/launch.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAQxD,QAAA,MAAM,MAAM,EAAE,cAkDZ,CAAC;eAEY,MAAM"}
@@ -14,8 +14,9 @@ import { cloudAgentsBackend } from "../lib/backend.js";
14
14
  import { assertWriteChannel } from "../lib/channels.js";
15
15
  import { recordLaunch } from "../lib/fleet.js";
16
16
  import { launchRepos } from "../lib/repos.js";
17
+ import { armWatch } from "../lib/watch.js";
17
18
  const launch = defineTool({
18
- description: "Launch a Cursor cloud agent on a repository with a self-contained task. Returns the agent id and URL; check on it with get, read what it did with dump.",
19
+ description: "Launch a Cursor cloud agent on a repository with a self-contained task. Returns the agent id and URL, and watching: true when this conversation will be woken once the agent stops; check on it with get, read what it did with dump.",
19
20
  effect: "write",
20
21
  needsApproval: () => extension.config.needsApproval,
21
22
  inputSchema: z.object({
@@ -54,7 +55,7 @@ const launch = defineTool({
54
55
  cloud: Object.assign(Object.assign({}, cloud), { repos: launchRepos({ repo: input.repo, ref: input.starting_ref, prUrl: input.pr_url }, cloud) }),
55
56
  });
56
57
  yield recordLaunch(ctx, launched.agentId, input.name);
57
- return launched;
58
+ return Object.assign(Object.assign({}, launched), { watching: yield armWatch(ctx, launched) });
58
59
  });
59
60
  },
60
61
  });
@@ -4,7 +4,7 @@
4
4
  * An extension is a directory laid out like `agent/`: `extension.ts`
5
5
  * declares it; `tools/`, `skills/`, `mcp-connections/`,
6
6
  * `host-connections/`, `hooks/`, `channels/`, `schedules/`,
7
- * `subagents/`, `instructions`, `artifacts.ts`, and
7
+ * `reminders/`, `subagents/`, `instructions`, `artifacts.ts`, and
8
8
  * `sandbox/workspace/` are its contributions. `lib/` holds
9
9
  * shared code.
10
10
  *
@@ -4,7 +4,7 @@
4
4
  * An extension is a directory laid out like `agent/`: `extension.ts`
5
5
  * declares it; `tools/`, `skills/`, `mcp-connections/`,
6
6
  * `host-connections/`, `hooks/`, `channels/`, `schedules/`,
7
- * `subagents/`, `instructions`, `artifacts.ts`, and
7
+ * `reminders/`, `subagents/`, `instructions`, `artifacts.ts`, and
8
8
  * `sandbox/workspace/` are its contributions. `lib/` holds
9
9
  * shared code.
10
10
  *
@@ -1,110 +1,51 @@
1
1
  /**
2
- * Cursor-managed durable files for hosted agents — the backend that puts
3
- * `ctx.host.files` bytes in an Agent Store on S3.
2
+ * Cursor-managed durable files for hosted agents.
4
3
  *
5
- * One credential throughout: the engine's pod `CURSOR_API_KEY`. It authorizes
6
- * every call, and the bytes then move between this process and presigned S3
7
- * URLs. File contents never transit the control plane, so a large artifact
8
- * costs S3 bandwidth rather than backend memory.
4
+ * Requests use the control-plane proxy and deployment pod credential, which
5
+ * scopes access to the deployment. Authors access these files through
6
+ * `ctx.host.files`; Cursor manages the storage bindings, so do not add their
7
+ * names to `hosting.secretNames`.
9
8
  *
10
- * By default everything goes through the public API under
11
- * `/v0/agent-serve-files`, the same surface any API-key holder gets — a
12
- * self-hosted deployment, a CI job, or a customer script can drive the same
13
- * store with the same requests. Cursor-managed v2 pods can instead be pinned
14
- * (per deployment, at task-time bind) onto the engine-facing factory store API
15
- * under `/internal/agentsdk/store`: same host, same credential, same stores
16
- * and S3 objects, but flush-shaped — one control-plane request settles a whole
17
- * `putMany` batch or a conditional delete, where `/v0` costs a presign POST
18
- * plus stat GETs and a delete POST. The pin fails safe: an absent or
19
- * unrecognized protocol value, or a source id that maps to neither deployment
20
- * store role, keeps `/v0`.
21
- *
22
- * Two things follow. There is no Agent Store token: a token narrows an identity
23
- * to one store and one capability, which is what a caller that cannot hold a
24
- * credential needs (an in-pod FUSE daemon). This process holds the credential
25
- * the token would be minted from, so a token bought a round trip, an expiry to
26
- * manage, and a second auth path, and no privilege reduction. And there is no
27
- * direct call to the store service: the API layer owns the policy, and the
28
- * engine never addresses it.
29
- *
30
- * There is also no store lookup. Every request names this deployment's file
31
- * store by the `agentStoreSourceId` the deploy pipeline pinned into the pod
32
- * env as `AGENT_SERVE_STORE_SOURCE_ID` — provisioning the store at the same
33
- * time, so by boot the store exists and the id resolves. The id is an
34
- * address, not a credential: the server maps it to a store and authorizes
35
- * every call against the deployment's own live service account, so holding
36
- * it grants nothing, and this process never learns a store id it could use
37
- * to ask for anyone else's.
38
- *
39
- * Locally, point `CURSOR_API_BASE_URL` at a backend that serves
40
- * `/v0/agent-serve-files` and use a deployment SA key; off hosting the
41
- * local-disk sink is the default instead.
42
- *
43
- * Writes are conditional. The store rejects unconditional writes, so every
44
- * `put` first learns the current etag: `new` for a path we believe is absent,
45
- * `etag` to replace what we last observed. A raced write comes back 412 and
46
- * surfaces as {@link FileConflictError}, which is why this backend reports
47
- * `etags: true` and `host.files.capabilities.conflictDetection` is honestly
48
- * true.
9
+ * Writes use conditional etags. A raced write surfaces as
10
+ * {@link FileConflictError}, and the backend reports
11
+ * `host.files.capabilities.conflictDetection`.
49
12
  */
50
13
  import { type FileSink, type FileSinkBody } from "../files.js";
51
14
  import { type CursorApiTransportOptions } from "../internal/cursor/cursor-api-transport.js";
52
15
  /**
53
- * Pinned by the deploy pipeline for every Cursor-managed deployment — which
54
- * provisions the file store it names in the same step — and reserved from
55
- * user secrets. Its presence is the signal that a durable store exists and
56
- * the hosted control plane is reachable; a deployment without one (no
57
- * service account yet) has no store, and this backend is not selected.
16
+ * Platform-managed identifier for the author-facing file store. Do not add
17
+ * it to `hosting.secretNames`.
58
18
  */
59
19
  export declare const AGENT_SERVE_STORE_SOURCE_ID_ENV_VAR = "AGENT_SERVE_STORE_SOURCE_ID";
60
20
  /**
61
- * The deployment's **framework-level** file store, distinct from the
62
- * user-level store above. The user store carries author-facing bytes
63
- * (`ctx.host.files`, skills, memory, artifacts) and is browsable and
64
- * mountable; the framework store carries engine-owned session state —
65
- * session records, event transcripts, hosted-execution run logs,
66
- * continuation index, and the SDK conversation mirror — and is never
67
- * exposed to authors or models.
68
- * Provisioned by the v2 deploy pipeline alongside the user store; v1
69
- * deployments have only the user store.
21
+ * Platform-managed identifier for framework-owned state. Authors and models
22
+ * cannot access this storage through `host.files` or `host.kv`.
70
23
  */
71
24
  export declare const AGENT_SERVE_FRAMEWORK_STORE_SOURCE_ID_ENV_VAR = "AGENT_SERVE_FRAMEWORK_STORE_SOURCE_ID";
72
25
  /**
73
26
  * True on Cursor-managed hosting with a provisioned file store.
74
27
  *
75
- * Keyed on the store source id alone, deliberately: the credential is not part
76
- * of the test. If it were, a missing or regressed `CURSOR_API_KEY` would
77
- * silently select pod-local disk on a hosted pod and accept writes that vanish
78
- * with the pod. Instead the store is detected, and a missing credential fails
79
- * loudly when the sink is used.
28
+ * Availability depends on the storage binding rather than the credential.
29
+ * A missing credential therefore fails loudly instead of selecting local
30
+ * storage for a managed deployment.
80
31
  */
81
32
  export declare function isCursorHostedFilesAvailable(env?: NodeJS.ProcessEnv): boolean;
82
33
  /**
83
- * Local `serve`/`run` with a personal `CURSOR_API_KEY` can address
84
- * `/v0/agent-serve-files/user`. Hosted deployments have a store source id
85
- * and must not take this path — they own the deployment store instead.
34
+ * True when local commands can use the signed-in user's file store. Managed
35
+ * deployments always use their deployment-scoped store instead.
86
36
  */
87
37
  export declare function isCursorUserStoreFilesAvailable(env?: NodeJS.ProcessEnv): boolean;
88
- /**
89
- * Base URL / credential / fetch resolution is the shared
90
- * {@link CursorApiTransportOptions} (`internal/cursor/cursor-api-transport.ts`),
91
- * so this sink and the domain-lane store API client resolve identically.
92
- */
93
38
  export interface CursorHostedFilesOptions extends CursorApiTransportOptions {
94
- /** File store to address (default: `AGENT_SERVE_STORE_SOURCE_ID`). */
39
+ /** File store to address. Defaults to the platform-managed deployment store. */
95
40
  storeSourceId?: string;
96
41
  /**
97
42
  * Lazy store source id, re-resolved on every call and preferred over
98
- * {@link storeSourceId} — freeze bind drops ids into `/run/cursor/secrets`
99
- * after serve start without restarting July.
43
+ * {@link storeSourceId}.
100
44
  */
101
45
  resolveStoreSourceId?: () => string | undefined;
102
46
  /**
103
- * Lazy store protocol pin (default: env, then the task-bound file). When it
104
- * enables the factory flush wire (`factory-flush-v1`, or the superset
105
- * domain-API pin `factory-api-v1`) and the source id maps to a deployment
106
- * store role, requests ride the factory store API instead of
107
- * `/v0/agent-serve-files`. Any other value keeps `/v0`.
47
+ * Lazy transport selection override. Unrecognized values use the
48
+ * compatibility transport.
108
49
  */
109
50
  resolveStoreProtocol?: () => string | undefined;
110
51
  }
@@ -117,9 +58,7 @@ type HostedFilesMethods = Omit<FileSink, "get" | "getMany"> & {
117
58
  /**
118
59
  * Cursor-hosted {@link FileSink}, selected on Cursor-managed hosting.
119
60
  *
120
- * Stateless apart from the etag cache below: every request names this
121
- * deployment's store by its pinned source id, so there is nothing to
122
- * resolve, hold, or invalidate.
61
+ * Stateless apart from its bounded etag cache.
123
62
  */
124
63
  export declare function cursorHostedFiles(options?: CursorHostedFilesOptions): HostedFilesMethods;
125
64
  export {};
@@ -1 +1 @@
1
- {"version":3,"file":"cursor-hosted.d.ts","sourceRoot":"","sources":["../../src/files-backends/cursor-hosted.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgDG;AAGH,OAAO,EAEL,KAAK,QAAQ,EACb,KAAK,YAAY,EAGlB,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,KAAK,yBAAyB,EAI/B,MAAM,4CAA4C,CAAC;AAqBpD;;;;;;GAMG;AACH,eAAO,MAAM,mCAAmC,gCAAgC,CAAC;AAEjF;;;;;;;;;;GAUG;AACH,eAAO,MAAM,6CAA6C,0CACjB,CAAC;AA6B1C;;;;;;;;GAQG;AACH,wBAAgB,4BAA4B,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,OAAO,CAE1F;AAED;;;;GAIG;AACH,wBAAgB,+BAA+B,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,OAAO,CAY7F;AAED;;;;GAIG;AACH,MAAM,WAAW,wBAAyB,SAAQ,yBAAyB;IACzE,sEAAsE;IACtE,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB;;;;OAIG;IACH,oBAAoB,CAAC,EAAE,MAAM,MAAM,GAAG,SAAS,CAAC;IAChD;;;;;;OAMG;IACH,oBAAoB,CAAC,EAAE,MAAM,MAAM,GAAG,SAAS,CAAC;CACjD;AA8DD,KAAK,kBAAkB,GAAG,IAAI,CAAC,QAAQ,EAAE,KAAK,GAAG,SAAS,CAAC,GAAG;IAC5D,gFAAgF;IAChF,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,GAAG,SAAS,CAAC,CAAC;IACpD,yFAAyF;IACzF,OAAO,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAAC,KAAK,CAAC,YAAY,GAAG,SAAS,CAAC,CAAC,CAAC;CAC5E,CAAC;AAEF;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,GAAE,wBAA6B,GAAG,kBAAkB,CA2uB5F"}
1
+ {"version":3,"file":"cursor-hosted.d.ts","sourceRoot":"","sources":["../../src/files-backends/cursor-hosted.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAGH,OAAO,EAEL,KAAK,QAAQ,EACb,KAAK,YAAY,EAGlB,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,KAAK,yBAAyB,EAI/B,MAAM,4CAA4C,CAAC;AAcpD;;;GAGG;AACH,eAAO,MAAM,mCAAmC,gCAAgC,CAAC;AAEjF;;;GAGG;AACH,eAAO,MAAM,6CAA6C,0CACjB,CAAC;AAoB1C;;;;;;GAMG;AACH,wBAAgB,4BAA4B,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,OAAO,CAE1F;AAED;;;GAGG;AACH,wBAAgB,+BAA+B,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,OAAO,CAU7F;AAED,MAAM,WAAW,wBAAyB,SAAQ,yBAAyB;IACzE,gFAAgF;IAChF,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB;;;OAGG;IACH,oBAAoB,CAAC,EAAE,MAAM,MAAM,GAAG,SAAS,CAAC;IAChD;;;OAGG;IACH,oBAAoB,CAAC,EAAE,MAAM,MAAM,GAAG,SAAS,CAAC;CACjD;AAoDD,KAAK,kBAAkB,GAAG,IAAI,CAAC,QAAQ,EAAE,KAAK,GAAG,SAAS,CAAC,GAAG;IAC5D,gFAAgF;IAChF,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,GAAG,SAAS,CAAC,CAAC;IACpD,yFAAyF;IACzF,OAAO,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAAC,KAAK,CAAC,YAAY,GAAG,SAAS,CAAC,CAAC,CAAC;CAC5E,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,GAAE,wBAA6B,GAAG,kBAAkB,CAwtB5F"}