@cursor/july 0.1.30 → 0.1.31

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 (392) hide show
  1. package/AGENTS.md +1 -1
  2. package/README.md +10 -5
  3. package/dist/bin/agent-serve.js +4 -4
  4. package/dist/channels/github/index.d.ts +1 -1
  5. package/dist/channels/github/index.js +1 -1
  6. package/dist/channels/slack/bot-mentions.d.ts +1 -1
  7. package/dist/channels/slack/bot-mentions.d.ts.map +1 -1
  8. package/dist/channels/slack/bot-mentions.js +1 -1
  9. package/dist/channels/slack/eval-directive.js +1 -1
  10. package/dist/channels/slack/external-policy.d.ts +1 -1
  11. package/dist/channels/slack/external-policy.js +1 -1
  12. package/dist/channels/slack/log.d.ts +1 -1
  13. package/dist/channels/slack/log.js +1 -1
  14. package/dist/channels/slack/setup.js +1 -1
  15. package/dist/channels/slack/socket-mode.js +1 -1
  16. package/dist/docs/404.html +3 -3
  17. package/dist/docs/ab.html +11 -11
  18. package/dist/docs/assets/{ab.md.BMCZ6Hd7.js → ab.md.DAQoJ-up.js} +6 -6
  19. package/dist/docs/assets/{ab.md.BMCZ6Hd7.lean.js → ab.md.DAQoJ-up.lean.js} +1 -1
  20. package/dist/docs/assets/{app.Cm4lsMc4.js → app.DigB_9cQ.js} +1 -1
  21. package/dist/docs/assets/building-with-agents.md.CnHqvYDd.js +13 -0
  22. package/dist/docs/assets/{building-with-agents.md.CJCtZCyi.lean.js → building-with-agents.md.CnHqvYDd.lean.js} +1 -1
  23. package/dist/docs/assets/chunks/@localSearchIndexroot.CnFFl07y.js +1 -0
  24. package/dist/docs/assets/chunks/{VPLocalSearchBox.CYUFXspH.js → VPLocalSearchBox.BCMX25Bv.js} +1 -1
  25. package/dist/docs/assets/chunks/{theme.CTjkX9vc.js → theme.BDDWeELx.js} +2 -2
  26. package/dist/docs/assets/concepts.md.DFaQEFkA.js +4 -0
  27. package/dist/docs/assets/concepts.md.DFaQEFkA.lean.js +1 -0
  28. package/dist/docs/assets/deployment.md.9MYBuKM1.js +55 -0
  29. package/dist/docs/assets/deployment.md.9MYBuKM1.lean.js +1 -0
  30. package/dist/docs/assets/{evals.md.DYOjkRCX.js → evals.md.BIUoVZ6X.js} +13 -13
  31. package/dist/docs/assets/evals.md.BIUoVZ6X.lean.js +1 -0
  32. package/dist/docs/assets/{example-agents_approval-buddy.md.DFGBYLcc.js → example-agents_approval-buddy.md.BhEfleVx.js} +4 -4
  33. package/dist/docs/assets/{example-agents_approval-buddy.md.DFGBYLcc.lean.js → example-agents_approval-buddy.md.BhEfleVx.lean.js} +1 -1
  34. package/dist/docs/assets/example-agents_benny.md.2Et1qa8f.js +7 -0
  35. package/dist/docs/assets/{example-agents_bugbot.md.DelIdhxB.js → example-agents_bugbot.md.ByUexi5i.js} +5 -5
  36. package/dist/docs/assets/{example-agents_codebase-wiki.md.DC6sgwn0.js → example-agents_codebase-wiki.md.B4y-7ZVW.js} +6 -6
  37. package/dist/docs/assets/{example-agents_codebase-wiki.md.DC6sgwn0.lean.js → example-agents_codebase-wiki.md.B4y-7ZVW.lean.js} +1 -1
  38. package/dist/docs/assets/{example-agents_codeowners-review.md.Ku_tG2RY.js → example-agents_codeowners-review.md.D6ay4nvf.js} +6 -6
  39. package/dist/docs/assets/{example-agents_codeowners-review.md.Ku_tG2RY.lean.js → example-agents_codeowners-review.md.D6ay4nvf.lean.js} +1 -1
  40. package/dist/docs/assets/{example-agents_concierge.md.4rQTSMXt.js → example-agents_concierge.md.lL8rhYlj.js} +7 -7
  41. package/dist/docs/assets/{example-agents_fsd.md.CzgUrDfi.js → example-agents_fsd.md.DfNKQTHz.js} +5 -5
  42. package/dist/docs/assets/example-agents_index.md.DgGBwckv.js +2 -0
  43. package/dist/docs/assets/example-agents_index.md.DgGBwckv.lean.js +1 -0
  44. package/dist/docs/assets/{example-agents_knowledge-base.md.BPJiVueF.js → example-agents_knowledge-base.md.CzyZ2DCr.js} +5 -5
  45. package/dist/docs/assets/{example-agents_knowledge-base.md.BPJiVueF.lean.js → example-agents_knowledge-base.md.CzyZ2DCr.lean.js} +1 -1
  46. package/dist/docs/assets/example-agents_oncall.md.wFFXXEyW.js +10 -0
  47. package/dist/docs/assets/{example-agents_security-reviewer.md.Dhj_m7_B.js → example-agents_security-reviewer.md.Dkf1gyo6.js} +8 -8
  48. package/dist/docs/assets/example-agents_slack-agent.md.DvgvT4nn.js +5 -0
  49. package/dist/docs/assets/example-agents_weather-agent.md.Dmrcphhl.js +24 -0
  50. package/dist/docs/assets/example-agents_weather-agent.md.Dmrcphhl.lean.js +1 -0
  51. package/dist/docs/assets/{guides_agent-to-agent.md.Bpzgq2Pq.js → guides_agent-to-agent.md.Bmbxy-FA.js} +4 -4
  52. package/dist/docs/assets/guides_cloud-runtime.md.BZ2GA7Es.js +9 -0
  53. package/dist/docs/assets/{guides_github.md.DOOCpqsW.js → guides_github.md.R2QlpR75.js} +5 -5
  54. package/dist/docs/assets/{guides_human-in-the-loop.md.DlUqsp1S.js → guides_human-in-the-loop.md.BWvT7UqY.js} +1 -1
  55. package/dist/docs/assets/{guides_mcp-oauth.md.Dd8EgSem.js → guides_mcp-oauth.md.C7G7IykG.js} +5 -5
  56. package/dist/docs/assets/guides_mcp-oauth.md.C7G7IykG.lean.js +1 -0
  57. package/dist/docs/assets/guides_slack.md.zriQpU_9.js +47 -0
  58. package/dist/docs/assets/guides_slack.md.zriQpU_9.lean.js +1 -0
  59. package/dist/docs/assets/{guides_webhooks.md.wSOYas3X.js → guides_webhooks.md.DiAwSR42.js} +1 -1
  60. package/dist/docs/assets/{hillclimbing.md.DHNast08.js → hillclimbing.md.D9Y1_bYh.js} +1 -1
  61. package/dist/docs/assets/index.md.CZqbBJPB.js +20 -0
  62. package/dist/docs/assets/index.md.CZqbBJPB.lean.js +1 -0
  63. package/dist/docs/assets/{quickstart.md.BU6Iwi_9.js → quickstart.md.TnEXYgYW.js} +12 -12
  64. package/dist/docs/assets/{reference_agent-config.md.DrW2JUM8.js → reference_agent-config.md.kuN6-OxK.js} +1 -1
  65. package/dist/docs/assets/reference_cli.md.sD-IUWjg.js +73 -0
  66. package/dist/docs/assets/{reference_cli.md.ccoKOoXt.lean.js → reference_cli.md.sD-IUWjg.lean.js} +1 -1
  67. package/dist/docs/assets/{reference_connections.md.B9Q3TOve.js → reference_connections.md.DGqAsFXb.js} +3 -3
  68. package/dist/docs/assets/reference_http-api.md.CfVM_ICa.js +11 -0
  69. package/dist/docs/assets/{reference_project-layout.md.Bd_CKtNS.js → reference_project-layout.md.D8E6ZmHJ.js} +4 -4
  70. package/dist/docs/assets/{reference_project-layout.md.Bd_CKtNS.lean.js → reference_project-layout.md.D8E6ZmHJ.lean.js} +1 -1
  71. package/dist/docs/assets/{reference_schedules.md.w_F2mXB6.js → reference_schedules.md.gmfYzf_I.js} +1 -1
  72. package/dist/docs/assets/{reference_sessions.md.DLd6mvbv.js → reference_sessions.md.C_ouF_uf.js} +3 -3
  73. package/dist/docs/assets/{reference_tools.md.BRSDnTbN.js → reference_tools.md.BswAQM41.js} +3 -3
  74. package/dist/docs/assets/{scaffolding-agents.md.C3pTrmoE.js → scaffolding-agents.md.Bsr9Pwzu.js} +1 -1
  75. package/dist/docs/assets/{scaffolding-agents.md.C3pTrmoE.lean.js → scaffolding-agents.md.Bsr9Pwzu.lean.js} +1 -1
  76. package/dist/docs/assets/{storage.md.DRTdnFvd.js → storage.md.xZoiGM58.js} +3 -3
  77. package/dist/docs/assets/storage.md.xZoiGM58.lean.js +1 -0
  78. package/dist/docs/assets/troubleshooting.md.B5RVX_tL.js +1 -0
  79. package/dist/docs/assets/{troubleshooting.md.CmQkmnzC.lean.js → troubleshooting.md.B5RVX_tL.lean.js} +1 -1
  80. package/dist/docs/building-with-agents.html +12 -12
  81. package/dist/docs/concepts.html +6 -6
  82. package/dist/docs/deployment.html +32 -32
  83. package/dist/docs/evals.html +19 -19
  84. package/dist/docs/example-agents/approval-buddy.html +9 -9
  85. package/dist/docs/example-agents/benny.html +11 -11
  86. package/dist/docs/example-agents/bugbot.html +10 -10
  87. package/dist/docs/example-agents/codebase-wiki.html +11 -11
  88. package/dist/docs/example-agents/codeowners-review.html +11 -11
  89. package/dist/docs/example-agents/concierge.html +12 -12
  90. package/dist/docs/example-agents/fsd.html +10 -10
  91. package/dist/docs/example-agents/index.html +7 -7
  92. package/dist/docs/example-agents/knowledge-base.html +10 -10
  93. package/dist/docs/example-agents/oncall.html +10 -10
  94. package/dist/docs/example-agents/security-reviewer.html +13 -13
  95. package/dist/docs/example-agents/slack-agent.html +10 -10
  96. package/dist/docs/example-agents/weather-agent.html +16 -16
  97. package/dist/docs/guides/agent-to-agent.html +9 -9
  98. package/dist/docs/guides/cloud-runtime.html +7 -7
  99. package/dist/docs/guides/github.html +10 -10
  100. package/dist/docs/guides/human-in-the-loop.html +7 -7
  101. package/dist/docs/guides/mcp-oauth.html +11 -11
  102. package/dist/docs/guides/slack.html +22 -17
  103. package/dist/docs/guides/webhooks.html +7 -7
  104. package/dist/docs/hashmap.json +1 -1
  105. package/dist/docs/hillclimbing.html +7 -7
  106. package/dist/docs/index.html +9 -9
  107. package/dist/docs/quickstart.html +17 -17
  108. package/dist/docs/reference/agent-config.html +7 -7
  109. package/dist/docs/reference/channels.html +5 -5
  110. package/dist/docs/reference/cli.html +56 -48
  111. package/dist/docs/reference/connections.html +9 -9
  112. package/dist/docs/reference/hooks.html +5 -5
  113. package/dist/docs/reference/http-api.html +7 -7
  114. package/dist/docs/reference/instructions.html +5 -5
  115. package/dist/docs/reference/playground.html +5 -5
  116. package/dist/docs/reference/project-layout.html +9 -9
  117. package/dist/docs/reference/prompt.html +5 -5
  118. package/dist/docs/reference/schedules.html +7 -7
  119. package/dist/docs/reference/sessions.html +8 -8
  120. package/dist/docs/reference/skills.html +5 -5
  121. package/dist/docs/reference/subagents.html +5 -5
  122. package/dist/docs/reference/tools.html +9 -9
  123. package/dist/docs/scaffolding-agents.html +6 -6
  124. package/dist/docs/storage.html +9 -9
  125. package/dist/docs/troubleshooting.html +6 -6
  126. package/dist/evals/reporters.d.ts +1 -1
  127. package/dist/evals/reporters.js +1 -1
  128. package/dist/evals.d.ts +2 -2
  129. package/dist/files-backends/agent-store-presigned-url.d.ts +100 -0
  130. package/dist/files-backends/agent-store-presigned-url.d.ts.map +1 -0
  131. package/dist/files-backends/agent-store-presigned-url.js +347 -0
  132. package/dist/files-backends/cursor-hosted.d.ts +87 -0
  133. package/dist/files-backends/cursor-hosted.d.ts.map +1 -0
  134. package/dist/files-backends/cursor-hosted.js +540 -0
  135. package/dist/files-backends/local-fs.d.ts +33 -0
  136. package/dist/files-backends/local-fs.d.ts.map +1 -0
  137. package/dist/files-backends/local-fs.js +199 -0
  138. package/dist/files.d.ts +139 -0
  139. package/dist/files.d.ts.map +1 -0
  140. package/dist/files.js +89 -0
  141. package/dist/internal/ab-collector.js +2 -2
  142. package/dist/internal/ab-fold.js +1 -1
  143. package/dist/internal/cli-ax.d.ts +2 -2
  144. package/dist/internal/cli-ax.js +2 -2
  145. package/dist/internal/cli-deploy.d.ts +1 -1
  146. package/dist/internal/cli-deploy.d.ts.map +1 -1
  147. package/dist/internal/cli-deploy.js +7 -2
  148. package/dist/internal/cli-docs.d.ts +1 -1
  149. package/dist/internal/cli-docs.js +1 -1
  150. package/dist/internal/cli-github.js +13 -13
  151. package/dist/internal/cli-mcp-oauth.d.ts +1 -1
  152. package/dist/internal/cli-mcp-oauth.js +2 -2
  153. package/dist/internal/cli-mcp.d.ts +3 -3
  154. package/dist/internal/cli-mcp.js +4 -4
  155. package/dist/internal/cli-skills.js +1 -1
  156. package/dist/internal/cloud-turn-cost.d.ts +9 -1
  157. package/dist/internal/cloud-turn-cost.d.ts.map +1 -1
  158. package/dist/internal/cloud-turn-cost.js +14 -4
  159. package/dist/internal/cursor/account-mcp.js +5 -5
  160. package/dist/internal/cursor/backend-client.js +1 -1
  161. package/dist/internal/cursor/github-credentials.js +3 -3
  162. package/dist/internal/cursor-account-mcp-auth.d.ts +1 -1
  163. package/dist/internal/cursor-account-mcp-auth.js +1 -1
  164. package/dist/internal/cursor-event-relay.js +1 -1
  165. package/dist/internal/cursor-relay-core.d.ts +1 -1
  166. package/dist/internal/cursor-relay-core.d.ts.map +1 -1
  167. package/dist/internal/cursor-slack-relay.js +1 -1
  168. package/dist/internal/deploy-client.d.ts +6 -1
  169. package/dist/internal/deploy-client.d.ts.map +1 -1
  170. package/dist/internal/deploy-client.js +3 -2
  171. package/dist/internal/deploy-source.d.ts +2 -2
  172. package/dist/internal/deploy-source.js +2 -2
  173. package/dist/internal/discovery.js +2 -2
  174. package/dist/internal/distribution.d.ts +5 -5
  175. package/dist/internal/distribution.d.ts.map +1 -1
  176. package/dist/internal/distribution.js +6 -6
  177. package/dist/internal/docs-site.js +5 -5
  178. package/dist/internal/eval-run-store.js +8 -8
  179. package/dist/internal/evals-client.d.ts +1 -1
  180. package/dist/internal/evals-client.js +1 -1
  181. package/dist/internal/github-fanout.js +2 -2
  182. package/dist/internal/host-files.d.ts +29 -0
  183. package/dist/internal/host-files.d.ts.map +1 -0
  184. package/dist/internal/host-files.js +283 -0
  185. package/dist/internal/host-platforms.js +5 -5
  186. package/dist/internal/hosting.d.ts +1 -1
  187. package/dist/internal/hosting.js +1 -1
  188. package/dist/internal/http-channel.d.ts.map +1 -1
  189. package/dist/internal/http-channel.js +26 -0
  190. package/dist/internal/install-cursor-skills.d.ts +1 -1
  191. package/dist/internal/install-cursor-skills.d.ts.map +1 -1
  192. package/dist/internal/install-cursor-skills.js +33 -4
  193. package/dist/internal/local-control-plane.js +2 -2
  194. package/dist/internal/logs-client.d.ts +2 -2
  195. package/dist/internal/logs-client.js +2 -2
  196. package/dist/internal/mcp-endpoint.js +1 -1
  197. package/dist/internal/mcp-oauth.js +2 -2
  198. package/dist/internal/platform-schedule-sync.js +2 -2
  199. package/dist/internal/playground/toolchain.js +6 -6
  200. package/dist/internal/reminder-runner.js +13 -13
  201. package/dist/internal/resolved-connections.js +6 -6
  202. package/dist/internal/schedule-runner.js +1 -1
  203. package/dist/internal/sdk-runner.js +5 -5
  204. package/dist/internal/server.js +16 -16
  205. package/dist/internal/session-cost.d.ts +3 -2
  206. package/dist/internal/session-cost.d.ts.map +1 -1
  207. package/dist/internal/session-cost.js +7 -6
  208. package/dist/internal/session-engine.d.ts +31 -1
  209. package/dist/internal/session-engine.d.ts.map +1 -1
  210. package/dist/internal/session-engine.js +119 -31
  211. package/dist/internal/slack-provision-client.js +1 -1
  212. package/dist/internal/storage-coordinator.js +7 -7
  213. package/dist/internal/trajectory.js +2 -2
  214. package/dist/internal/turn-cost.d.ts +27 -0
  215. package/dist/internal/turn-cost.d.ts.map +1 -0
  216. package/dist/internal/turn-cost.js +83 -0
  217. package/dist/internal/update-check.d.ts +3 -3
  218. package/dist/internal/update-check.d.ts.map +1 -1
  219. package/dist/internal/update-check.js +5 -5
  220. package/dist/memory.d.ts +1 -1
  221. package/dist/memory.js +1 -1
  222. package/dist/playground/assets/index-50PKeJlG.css +1 -0
  223. package/dist/playground/assets/index-C0f2Wl1q.js +85 -0
  224. package/dist/playground/index.html +2 -2
  225. package/dist/storage.d.ts +1 -1
  226. package/dist/storage.js +1 -1
  227. package/dist/types.d.ts +120 -16
  228. package/dist/types.d.ts.map +1 -1
  229. package/docs/README.md +23 -23
  230. package/docs/ab.md +12 -12
  231. package/docs/building-with-agents.md +9 -9
  232. package/docs/concepts.md +11 -11
  233. package/docs/deployment.md +55 -43
  234. package/docs/evals.md +20 -20
  235. package/docs/example-agents/approval-buddy.md +9 -9
  236. package/docs/example-agents/benny.md +13 -13
  237. package/docs/example-agents/bugbot.md +6 -6
  238. package/docs/example-agents/codebase-wiki.md +8 -8
  239. package/docs/example-agents/codeowners-review.md +8 -8
  240. package/docs/example-agents/concierge.md +10 -10
  241. package/docs/example-agents/fsd.md +7 -7
  242. package/docs/example-agents/index.md +8 -8
  243. package/docs/example-agents/knowledge-base.md +9 -9
  244. package/docs/example-agents/oncall.md +7 -7
  245. package/docs/example-agents/security-reviewer.md +12 -12
  246. package/docs/example-agents/slack-agent.md +10 -10
  247. package/docs/example-agents/weather-agent.md +30 -26
  248. package/docs/guides/agent-to-agent.md +4 -4
  249. package/docs/guides/cloud-runtime.md +3 -3
  250. package/docs/guides/github.md +6 -6
  251. package/docs/guides/human-in-the-loop.md +1 -1
  252. package/docs/guides/mcp-oauth.md +9 -9
  253. package/docs/guides/slack.md +94 -21
  254. package/docs/guides/webhooks.md +1 -1
  255. package/docs/hillclimbing.md +3 -3
  256. package/docs/quickstart.md +18 -18
  257. package/docs/reference/agent-config.md +1 -1
  258. package/docs/reference/cli.md +110 -79
  259. package/docs/reference/connections.md +3 -3
  260. package/docs/reference/http-api.md +2 -2
  261. package/docs/reference/project-layout.md +7 -7
  262. package/docs/reference/schedules.md +1 -1
  263. package/docs/reference/sessions.md +7 -7
  264. package/docs/reference/tools.md +3 -3
  265. package/docs/scaffolding-agents.md +2 -2
  266. package/docs/storage.md +5 -5
  267. package/docs/troubleshooting.md +11 -10
  268. package/package.json +3 -1
  269. package/skills/ab/SKILL.md +5 -5
  270. package/skills/create-agent/SKILL.md +17 -17
  271. package/skills/debug/SKILL.md +10 -10
  272. package/skills/evals/SKILL.md +13 -13
  273. package/skills/framework-map/SKILL.md +3 -3
  274. package/skills/github/SKILL.md +11 -11
  275. package/skills/hillclimb/SKILL.md +9 -9
  276. package/skills/mcp-auth/SKILL.md +11 -11
  277. package/skills/setup-slack/SKILL.md +28 -28
  278. package/src/bin/agent-serve.ts +4 -4
  279. package/src/channels/github/index.ts +1 -1
  280. package/src/channels/slack/bot-mentions.ts +1 -1
  281. package/src/channels/slack/eval-directive.ts +1 -1
  282. package/src/channels/slack/external-policy.ts +1 -1
  283. package/src/channels/slack/log.ts +1 -1
  284. package/src/channels/slack/setup.ts +1 -1
  285. package/src/channels/slack/socket-mode.ts +1 -1
  286. package/src/evals/reporters.ts +1 -1
  287. package/src/evals.ts +2 -2
  288. package/src/files-backends/agent-store-presigned-url.ts +402 -0
  289. package/src/files-backends/cursor-hosted.ts +698 -0
  290. package/src/files-backends/local-fs.ts +178 -0
  291. package/src/files.ts +195 -0
  292. package/src/internal/ab-collector.ts +2 -2
  293. package/src/internal/ab-fold.ts +1 -1
  294. package/src/internal/cli-ax.ts +2 -2
  295. package/src/internal/cli-deploy.ts +7 -2
  296. package/src/internal/cli-docs.ts +1 -1
  297. package/src/internal/cli-github.ts +13 -13
  298. package/src/internal/cli-mcp-oauth.ts +2 -2
  299. package/src/internal/cli-mcp.ts +4 -4
  300. package/src/internal/cli-skills.ts +1 -1
  301. package/src/internal/cloud-turn-cost.ts +20 -4
  302. package/src/internal/cursor/account-mcp.ts +5 -5
  303. package/src/internal/cursor/backend-client.ts +1 -1
  304. package/src/internal/cursor/github-credentials.ts +3 -3
  305. package/src/internal/cursor-account-mcp-auth.ts +1 -1
  306. package/src/internal/cursor-event-relay.ts +1 -1
  307. package/src/internal/cursor-relay-core.ts +1 -1
  308. package/src/internal/cursor-slack-relay.ts +1 -1
  309. package/src/internal/deploy-client.ts +8 -2
  310. package/src/internal/deploy-source.ts +2 -2
  311. package/src/internal/discovery.ts +2 -2
  312. package/src/internal/distribution.ts +6 -6
  313. package/src/internal/docs-site.ts +5 -5
  314. package/src/internal/eval-run-store.ts +8 -8
  315. package/src/internal/evals-client.ts +1 -1
  316. package/src/internal/github-fanout.ts +2 -2
  317. package/src/internal/host-files.ts +372 -0
  318. package/src/internal/host-platforms.ts +5 -5
  319. package/src/internal/hosting.ts +1 -1
  320. package/src/internal/http-channel.ts +30 -0
  321. package/src/internal/install-cursor-skills.ts +31 -3
  322. package/src/internal/local-control-plane.ts +2 -2
  323. package/src/internal/logs-client.ts +2 -2
  324. package/src/internal/mcp-endpoint.ts +1 -1
  325. package/src/internal/mcp-oauth.ts +2 -2
  326. package/src/internal/platform-schedule-sync.ts +2 -2
  327. package/src/internal/playground/toolchain.ts +6 -6
  328. package/src/internal/reminder-runner.ts +13 -13
  329. package/src/internal/resolved-connections.ts +6 -6
  330. package/src/internal/schedule-runner.ts +1 -1
  331. package/src/internal/sdk-runner.ts +5 -5
  332. package/src/internal/server.ts +16 -16
  333. package/src/internal/session-cost.ts +7 -6
  334. package/src/internal/session-engine.ts +141 -28
  335. package/src/internal/slack-provision-client.ts +1 -1
  336. package/src/internal/storage-coordinator.ts +7 -7
  337. package/src/internal/trajectory.ts +2 -2
  338. package/src/internal/turn-cost.ts +110 -0
  339. package/src/internal/update-check.ts +6 -6
  340. package/src/memory.ts +1 -1
  341. package/src/storage.ts +1 -1
  342. package/src/types.ts +148 -16
  343. package/dist/docs/assets/building-with-agents.md.CJCtZCyi.js +0 -13
  344. package/dist/docs/assets/chunks/@localSearchIndexroot.CbQshWFK.js +0 -1
  345. package/dist/docs/assets/concepts.md.Cfb9b-k1.js +0 -4
  346. package/dist/docs/assets/concepts.md.Cfb9b-k1.lean.js +0 -1
  347. package/dist/docs/assets/deployment.md.TecHo0_2.js +0 -55
  348. package/dist/docs/assets/deployment.md.TecHo0_2.lean.js +0 -1
  349. package/dist/docs/assets/evals.md.DYOjkRCX.lean.js +0 -1
  350. package/dist/docs/assets/example-agents_benny.md.B0gjhI-p.js +0 -7
  351. package/dist/docs/assets/example-agents_index.md.D2PEVSXl.js +0 -2
  352. package/dist/docs/assets/example-agents_index.md.D2PEVSXl.lean.js +0 -1
  353. package/dist/docs/assets/example-agents_oncall.md.BG_sUMly.js +0 -10
  354. package/dist/docs/assets/example-agents_slack-agent.md.buLbgvBf.js +0 -5
  355. package/dist/docs/assets/example-agents_weather-agent.md.C9Qv-W0o.js +0 -24
  356. package/dist/docs/assets/example-agents_weather-agent.md.C9Qv-W0o.lean.js +0 -1
  357. package/dist/docs/assets/guides_cloud-runtime.md.gVzabdQL.js +0 -9
  358. package/dist/docs/assets/guides_mcp-oauth.md.Dd8EgSem.lean.js +0 -1
  359. package/dist/docs/assets/guides_slack.md.CjmJSvZS.js +0 -42
  360. package/dist/docs/assets/guides_slack.md.CjmJSvZS.lean.js +0 -1
  361. package/dist/docs/assets/index.md.CH_s5uZe.js +0 -20
  362. package/dist/docs/assets/index.md.CH_s5uZe.lean.js +0 -1
  363. package/dist/docs/assets/reference_cli.md.ccoKOoXt.js +0 -65
  364. package/dist/docs/assets/reference_http-api.md.BncLd3PZ.js +0 -11
  365. package/dist/docs/assets/storage.md.DRTdnFvd.lean.js +0 -1
  366. package/dist/docs/assets/troubleshooting.md.CmQkmnzC.js +0 -1
  367. package/dist/internal/model-pricing.d.ts +0 -49
  368. package/dist/internal/model-pricing.d.ts.map +0 -1
  369. package/dist/internal/model-pricing.js +0 -377
  370. package/dist/playground/assets/index-CquRB-l0.js +0 -85
  371. package/dist/playground/assets/index-Dj0bWpkn.css +0 -1
  372. package/src/internal/model-pricing.ts +0 -426
  373. /package/dist/docs/assets/{example-agents_benny.md.B0gjhI-p.lean.js → example-agents_benny.md.2Et1qa8f.lean.js} +0 -0
  374. /package/dist/docs/assets/{example-agents_bugbot.md.DelIdhxB.lean.js → example-agents_bugbot.md.ByUexi5i.lean.js} +0 -0
  375. /package/dist/docs/assets/{example-agents_concierge.md.4rQTSMXt.lean.js → example-agents_concierge.md.lL8rhYlj.lean.js} +0 -0
  376. /package/dist/docs/assets/{example-agents_fsd.md.CzgUrDfi.lean.js → example-agents_fsd.md.DfNKQTHz.lean.js} +0 -0
  377. /package/dist/docs/assets/{example-agents_oncall.md.BG_sUMly.lean.js → example-agents_oncall.md.wFFXXEyW.lean.js} +0 -0
  378. /package/dist/docs/assets/{example-agents_security-reviewer.md.Dhj_m7_B.lean.js → example-agents_security-reviewer.md.Dkf1gyo6.lean.js} +0 -0
  379. /package/dist/docs/assets/{example-agents_slack-agent.md.buLbgvBf.lean.js → example-agents_slack-agent.md.DvgvT4nn.lean.js} +0 -0
  380. /package/dist/docs/assets/{guides_agent-to-agent.md.Bpzgq2Pq.lean.js → guides_agent-to-agent.md.Bmbxy-FA.lean.js} +0 -0
  381. /package/dist/docs/assets/{guides_cloud-runtime.md.gVzabdQL.lean.js → guides_cloud-runtime.md.BZ2GA7Es.lean.js} +0 -0
  382. /package/dist/docs/assets/{guides_github.md.DOOCpqsW.lean.js → guides_github.md.R2QlpR75.lean.js} +0 -0
  383. /package/dist/docs/assets/{guides_human-in-the-loop.md.DlUqsp1S.lean.js → guides_human-in-the-loop.md.BWvT7UqY.lean.js} +0 -0
  384. /package/dist/docs/assets/{guides_webhooks.md.wSOYas3X.lean.js → guides_webhooks.md.DiAwSR42.lean.js} +0 -0
  385. /package/dist/docs/assets/{hillclimbing.md.DHNast08.lean.js → hillclimbing.md.D9Y1_bYh.lean.js} +0 -0
  386. /package/dist/docs/assets/{quickstart.md.BU6Iwi_9.lean.js → quickstart.md.TnEXYgYW.lean.js} +0 -0
  387. /package/dist/docs/assets/{reference_agent-config.md.DrW2JUM8.lean.js → reference_agent-config.md.kuN6-OxK.lean.js} +0 -0
  388. /package/dist/docs/assets/{reference_connections.md.B9Q3TOve.lean.js → reference_connections.md.DGqAsFXb.lean.js} +0 -0
  389. /package/dist/docs/assets/{reference_http-api.md.BncLd3PZ.lean.js → reference_http-api.md.CfVM_ICa.lean.js} +0 -0
  390. /package/dist/docs/assets/{reference_schedules.md.w_F2mXB6.lean.js → reference_schedules.md.gmfYzf_I.lean.js} +0 -0
  391. /package/dist/docs/assets/{reference_sessions.md.DLd6mvbv.lean.js → reference_sessions.md.C_ouF_uf.lean.js} +0 -0
  392. /package/dist/docs/assets/{reference_tools.md.BRSDnTbN.lean.js → reference_tools.md.BswAQM41.lean.js} +0 -0
@@ -1,377 +0,0 @@
1
- /**
2
- * Best-effort dollar-cost estimation for agent turns.
3
- *
4
- * The Cursor harness streams token usage (`turn-ended`) but no dollar cost,
5
- * and server-billed cost is only queryable for cloud agents — so the
6
- * framework prices token usage against a built-in snapshot of Cursor's
7
- * published per-model API rates. Estimates are marked `source: "estimate"`
8
- * everywhere they surface (traces, playground, A/B metrics, CLI); the billed
9
- * amount on the Cursor dashboard remains the source of truth.
10
- *
11
- * Unknown models produce no estimate rather than a wrong one. Deployments
12
- * can extend or correct the table without a package upgrade via the
13
- * `AGENT_SERVE_MODEL_PRICING` environment variable (a JSON object merged
14
- * over the defaults, keyed by model id).
15
- */
16
- const M = 1000000;
17
- /**
18
- * Snapshot of Cursor API per-model token rates (USD per million tokens).
19
- * Keyed by normalized model id; family aliases (`sonnet`, `gpt`, …) point at
20
- * the model they currently resolve to.
21
- */
22
- export const DEFAULT_MODEL_PRICING = {
23
- // xAI / Cursor-served Grok
24
- "grok-4.5": {
25
- inputUsdPerMTok: 2,
26
- outputUsdPerMTok: 6,
27
- cacheReadUsdPerMTok: 0.5,
28
- fast: { inputUsdPerMTok: 4, outputUsdPerMTok: 18, cacheReadUsdPerMTok: 1 },
29
- },
30
- "grok-4.20": {
31
- inputUsdPerMTok: 2,
32
- outputUsdPerMTok: 6,
33
- cacheReadUsdPerMTok: 0.2,
34
- },
35
- "grok-4.3": {
36
- inputUsdPerMTok: 1.25,
37
- outputUsdPerMTok: 2.5,
38
- cacheReadUsdPerMTok: 0.125,
39
- },
40
- "grok-code": {
41
- inputUsdPerMTok: 0.2,
42
- outputUsdPerMTok: 1.5,
43
- cacheReadUsdPerMTok: 0.02,
44
- },
45
- // Anthropic
46
- "opus-5": {
47
- inputUsdPerMTok: 5,
48
- outputUsdPerMTok: 25,
49
- cacheReadUsdPerMTok: 0.5,
50
- cacheWriteUsdPerMTok: 6.25,
51
- fast: {
52
- inputUsdPerMTok: 10,
53
- outputUsdPerMTok: 50,
54
- cacheReadUsdPerMTok: 1,
55
- cacheWriteUsdPerMTok: 12.5,
56
- },
57
- },
58
- "opus-4.8": {
59
- inputUsdPerMTok: 5,
60
- outputUsdPerMTok: 25,
61
- cacheReadUsdPerMTok: 0.5,
62
- cacheWriteUsdPerMTok: 6.25,
63
- fast: {
64
- inputUsdPerMTok: 10,
65
- outputUsdPerMTok: 50,
66
- cacheReadUsdPerMTok: 1,
67
- cacheWriteUsdPerMTok: 12.5,
68
- },
69
- },
70
- "opus-4.7": {
71
- inputUsdPerMTok: 5,
72
- outputUsdPerMTok: 25,
73
- cacheReadUsdPerMTok: 0.5,
74
- cacheWriteUsdPerMTok: 6.25,
75
- fast: {
76
- inputUsdPerMTok: 30,
77
- outputUsdPerMTok: 150,
78
- cacheReadUsdPerMTok: 3,
79
- cacheWriteUsdPerMTok: 37.5,
80
- },
81
- },
82
- "opus-4.6": {
83
- inputUsdPerMTok: 5,
84
- outputUsdPerMTok: 25,
85
- cacheReadUsdPerMTok: 0.5,
86
- cacheWriteUsdPerMTok: 6.25,
87
- },
88
- "opus-4.5": {
89
- inputUsdPerMTok: 5,
90
- outputUsdPerMTok: 25,
91
- cacheReadUsdPerMTok: 0.5,
92
- cacheWriteUsdPerMTok: 6.25,
93
- },
94
- "sonnet-5": {
95
- inputUsdPerMTok: 3,
96
- outputUsdPerMTok: 15,
97
- cacheReadUsdPerMTok: 0.3,
98
- cacheWriteUsdPerMTok: 3.75,
99
- },
100
- "sonnet-4.6": {
101
- inputUsdPerMTok: 3,
102
- outputUsdPerMTok: 15,
103
- cacheReadUsdPerMTok: 0.3,
104
- cacheWriteUsdPerMTok: 3.75,
105
- },
106
- "sonnet-4.5": {
107
- inputUsdPerMTok: 3,
108
- outputUsdPerMTok: 15,
109
- cacheReadUsdPerMTok: 0.3,
110
- cacheWriteUsdPerMTok: 3.75,
111
- },
112
- "haiku-4.5": {
113
- inputUsdPerMTok: 1,
114
- outputUsdPerMTok: 5,
115
- cacheReadUsdPerMTok: 0.1,
116
- cacheWriteUsdPerMTok: 1.25,
117
- },
118
- "fable-5": {
119
- inputUsdPerMTok: 10,
120
- outputUsdPerMTok: 50,
121
- cacheReadUsdPerMTok: 1,
122
- cacheWriteUsdPerMTok: 12.5,
123
- },
124
- // OpenAI
125
- "gpt-5.6": {
126
- inputUsdPerMTok: 5,
127
- outputUsdPerMTok: 30,
128
- cacheReadUsdPerMTok: 0.5,
129
- cacheWriteUsdPerMTok: 6.25,
130
- fast: {
131
- inputUsdPerMTok: 10,
132
- outputUsdPerMTok: 60,
133
- cacheReadUsdPerMTok: 1,
134
- cacheWriteUsdPerMTok: 12.5,
135
- },
136
- },
137
- "gpt-5.5": {
138
- inputUsdPerMTok: 5,
139
- outputUsdPerMTok: 30,
140
- cacheReadUsdPerMTok: 0.5,
141
- },
142
- "gpt-5.4": {
143
- inputUsdPerMTok: 2.5,
144
- outputUsdPerMTok: 15,
145
- cacheReadUsdPerMTok: 0.25,
146
- },
147
- "gpt-5.2": {
148
- inputUsdPerMTok: 1.75,
149
- outputUsdPerMTok: 14,
150
- cacheReadUsdPerMTok: 0.175,
151
- },
152
- "gpt-mini": {
153
- inputUsdPerMTok: 0.75,
154
- outputUsdPerMTok: 4.5,
155
- cacheReadUsdPerMTok: 0.075,
156
- },
157
- "codex-5.3": {
158
- inputUsdPerMTok: 1.75,
159
- outputUsdPerMTok: 14,
160
- cacheReadUsdPerMTok: 0.175,
161
- },
162
- "codex-5.2": {
163
- inputUsdPerMTok: 1.75,
164
- outputUsdPerMTok: 14,
165
- cacheReadUsdPerMTok: 0.175,
166
- },
167
- // Google
168
- "gemini-3.1-pro": {
169
- inputUsdPerMTok: 2,
170
- outputUsdPerMTok: 12,
171
- cacheReadUsdPerMTok: 0.2,
172
- },
173
- "gemini-3-pro": {
174
- inputUsdPerMTok: 2,
175
- outputUsdPerMTok: 12,
176
- cacheReadUsdPerMTok: 0.2,
177
- },
178
- "gemini-3.6-flash": {
179
- inputUsdPerMTok: 1.5,
180
- outputUsdPerMTok: 7.5,
181
- cacheReadUsdPerMTok: 0.15,
182
- },
183
- "gemini-3.5-flash": {
184
- inputUsdPerMTok: 1.5,
185
- outputUsdPerMTok: 9,
186
- cacheReadUsdPerMTok: 0.15,
187
- },
188
- // Cursor Composer
189
- "composer-2.5": {
190
- inputUsdPerMTok: 0.5,
191
- outputUsdPerMTok: 2.5,
192
- cacheReadUsdPerMTok: 0.2,
193
- fast: {
194
- inputUsdPerMTok: 3,
195
- outputUsdPerMTok: 15,
196
- cacheReadUsdPerMTok: 0.5,
197
- },
198
- },
199
- "composer-2": {
200
- inputUsdPerMTok: 0.5,
201
- outputUsdPerMTok: 2.5,
202
- cacheReadUsdPerMTok: 0.2,
203
- },
204
- // Moonshot / Zhipu
205
- "kimi-k3": {
206
- inputUsdPerMTok: 3,
207
- outputUsdPerMTok: 15,
208
- cacheReadUsdPerMTok: 0.3,
209
- },
210
- "kimi-k2.7": {
211
- inputUsdPerMTok: 0.95,
212
- outputUsdPerMTok: 4,
213
- cacheReadUsdPerMTok: 0.19,
214
- },
215
- "kimi-k2.5": {
216
- inputUsdPerMTok: 0.6,
217
- outputUsdPerMTok: 3,
218
- cacheReadUsdPerMTok: 0.1,
219
- },
220
- "glm-5.2": {
221
- inputUsdPerMTok: 1.4,
222
- outputUsdPerMTok: 4.4,
223
- cacheReadUsdPerMTok: 0.26,
224
- },
225
- };
226
- /** Family aliases → the model id they currently resolve to. */
227
- const MODEL_ID_ALIASES = {
228
- grok: "grok-4.20",
229
- "grok-latest": "grok-4.3",
230
- "grok-code-latest": "grok-code",
231
- opus: "opus-5",
232
- "opus-latest": "opus-5",
233
- sonnet: "sonnet-4.6",
234
- "sonnet-latest": "sonnet-5",
235
- haiku: "haiku-4.5",
236
- "haiku-latest": "haiku-4.5",
237
- fable: "fable-5",
238
- gpt: "gpt-5.6",
239
- "gpt-latest": "gpt-5.6",
240
- "gpt-5-6-sol": "gpt-5.6",
241
- "gpt-5-5": "gpt-5.5",
242
- "gpt-mini-latest": "gpt-mini",
243
- codex: "codex-5.3",
244
- "codex-latest": "codex-5.3",
245
- gemini: "gemini-3.1-pro",
246
- "gemini-latest": "gemini-3.1-pro",
247
- "gemini-pro": "gemini-3.1-pro",
248
- "gemini-pro-latest": "gemini-3.1-pro",
249
- "gemini-flash": "gemini-3.6-flash",
250
- "gemini-flash-latest": "gemini-3.6-flash",
251
- composer: "composer-2.5",
252
- "composer-latest": "composer-2.5",
253
- "composer-2-5": "composer-2.5",
254
- kimi: "kimi-k2.7",
255
- "kimi-latest": "kimi-k2.7",
256
- };
257
- /** Env var holding a JSON pricing override merged over the defaults. */
258
- export const MODEL_PRICING_ENV_VAR = "AGENT_SERVE_MODEL_PRICING";
259
- let cachedEnvOverride;
260
- function envOverrideTable() {
261
- const raw = process.env[MODEL_PRICING_ENV_VAR];
262
- if (cachedEnvOverride !== undefined && cachedEnvOverride.raw === raw) {
263
- return cachedEnvOverride.table;
264
- }
265
- let table = {};
266
- if (raw !== undefined && raw.trim() !== "") {
267
- try {
268
- const parsed = JSON.parse(raw);
269
- if (typeof parsed === "object" && parsed !== null) {
270
- for (const [key, value] of Object.entries(parsed)) {
271
- const tier = parsePricing(value);
272
- if (tier !== undefined) {
273
- table[normalizeModelId(key)] = tier;
274
- }
275
- }
276
- }
277
- }
278
- catch (_a) {
279
- table = {};
280
- }
281
- }
282
- cachedEnvOverride = { raw, table };
283
- return table;
284
- }
285
- function parseTier(value) {
286
- if (typeof value !== "object" || value === null) {
287
- return undefined;
288
- }
289
- const row = value;
290
- const input = row.inputUsdPerMTok;
291
- const output = row.outputUsdPerMTok;
292
- const cacheRead = row.cacheReadUsdPerMTok;
293
- if (!isRate(input) ||
294
- !isRate(output) ||
295
- (cacheRead !== undefined && !isRate(cacheRead))) {
296
- return undefined;
297
- }
298
- const cacheWrite = row.cacheWriteUsdPerMTok;
299
- return {
300
- inputUsdPerMTok: input,
301
- outputUsdPerMTok: output,
302
- cacheReadUsdPerMTok: isRate(cacheRead) ? cacheRead : input,
303
- cacheWriteUsdPerMTok: isRate(cacheWrite) ? cacheWrite : undefined,
304
- };
305
- }
306
- function parsePricing(value) {
307
- const base = parseTier(value);
308
- if (base === undefined) {
309
- return undefined;
310
- }
311
- const fast = parseTier(value.fast);
312
- return Object.assign(Object.assign({}, base), { fast });
313
- }
314
- function isRate(value) {
315
- return typeof value === "number" && Number.isFinite(value) && value >= 0;
316
- }
317
- export function normalizeModelId(id) {
318
- return id.trim().toLowerCase();
319
- }
320
- function modelId(model) {
321
- return typeof model === "string" ? model : model.id;
322
- }
323
- function modelHasFastParam(model) {
324
- var _a;
325
- if (typeof model === "string") {
326
- return false;
327
- }
328
- return (((_a = model.params) === null || _a === void 0 ? void 0 : _a.some((param) => param.id === "fast" && param.value === "true")) === true);
329
- }
330
- /**
331
- * Rates for a model selection, honoring its `fast` parameter. `undefined`
332
- * when the model is not in the table (no estimate is better than a wrong
333
- * one).
334
- */
335
- export function resolveModelPricing(model) {
336
- var _a, _b, _c, _d;
337
- const overrides = envOverrideTable();
338
- const rawId = normalizeModelId(modelId(model));
339
- const canonicalId = (_a = MODEL_ID_ALIASES[rawId]) !== null && _a !== void 0 ? _a : rawId;
340
- const pricing = (_d = (_c = (_b = overrides[rawId]) !== null && _b !== void 0 ? _b : overrides[canonicalId]) !== null && _c !== void 0 ? _c : DEFAULT_MODEL_PRICING[rawId]) !== null && _d !== void 0 ? _d : DEFAULT_MODEL_PRICING[canonicalId];
341
- if (pricing === undefined) {
342
- return undefined;
343
- }
344
- if (modelHasFastParam(model) && pricing.fast !== undefined) {
345
- return pricing.fast;
346
- }
347
- return pricing;
348
- }
349
- /**
350
- * Estimate the dollar cost of one turn's token usage. `undefined` when the
351
- * model has no known rates.
352
- */
353
- export function estimateTurnCost(model, usage) {
354
- var _a;
355
- const tier = resolveModelPricing(model);
356
- if (tier === undefined) {
357
- return undefined;
358
- }
359
- const cacheWriteRate = (_a = tier.cacheWriteUsdPerMTok) !== null && _a !== void 0 ? _a : tier.inputUsdPerMTok;
360
- const inputUsd = (usage.inputTokens / M) * tier.inputUsdPerMTok;
361
- const outputUsd = (usage.outputTokens / M) * tier.outputUsdPerMTok;
362
- const cacheReadUsd = (usage.cacheReadTokens / M) * tier.cacheReadUsdPerMTok;
363
- const cacheWriteUsd = (usage.cacheWriteTokens / M) * cacheWriteRate;
364
- return {
365
- totalUsd: roundUsd(inputUsd + outputUsd + cacheReadUsd + cacheWriteUsd),
366
- inputUsd: roundUsd(inputUsd),
367
- outputUsd: roundUsd(outputUsd),
368
- cacheReadUsd: roundUsd(cacheReadUsd),
369
- cacheWriteUsd: roundUsd(cacheWriteUsd),
370
- model: normalizeModelId(modelId(model)),
371
- source: "estimate",
372
- };
373
- }
374
- /** Keep persisted estimates readable: micro-dollar precision. */
375
- function roundUsd(usd) {
376
- return Math.round(usd * 1e6) / 1e6;
377
- }